.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL_CALC" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal_calc \- ماشین‌حساب رستری خط فرمان با نحو numpy.
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc [\-\-help] [\-\-help\-general]
             \-\-calc=expression \-\-outfile=<out_filename> [\-A <filename>]
             [\-\-A_band=<n>] [\-B...\-Z <filename>] [<other_options>]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
ماشین‌حساب رستری خط فرمان با نحو numpy. از هرگونه محاسبات
حسابی پایه‌ای که توسط آرایه‌های numpy پشتیبانی می‌شود مانند \fB+\fP، \fB\-\fP، \fB*\fP و
\fB/\fP به همراه عملگرهای منطقی مانند \fB>\fP\& استفاده کنید.
توجه داشته باشید که تمام فایل‌ها باید ابعاد یکسانی داشته باشند (مگر اینکه از گزینهٔ \fI\%\-\-extent\fP استفاده شود)،
اما هیچ‌گونه بررسی سیستم تصویر انجام نمی‌شود (مگر اینکه از گزینهٔ \fI\%\-\-projectionCheck\fP استفاده شود).
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
gdal_calc یک ابزار Python است و تنها در صورتی در دسترس است که بایندینگ‌های GDAL Python در دسترس باشند.
.UNINDENT
.UNINDENT
.sp
\fBراهنمایی:\fP
.INDENT 0.0
.INDENT 3.5
معادل در واسط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور \fI\%gdal raster calc\fP\& را ببینید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
یک پیام کاربرد کوتاه برای گزینه‌های عمومی خط فرمان GDAL نمایش می‌دهد و خارج می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-calc=<expression>
محاسبه با نحو numpy با استفاده از \fB+\fP، \fB\-\fP، \fB/\fP، \fB*\fP یا هر یک از توابع آرایه numpy (مانند \fBlog10()\fP).
می‌توان چندین گزینهٔ \fI\%\-\-calc\fP را برای تولید یک فایل چندبانده مشخص کرد (GDAL >= 3.2).
\fI\%Example 10\fP\& را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-A <filename>
فایل رستری ورودی GDAL؛ می‌توانید از هر حرفی (a\-z, A\-Z) استفاده کنید. (حروف کوچک از GDAL 3.3 پشتیبانی می‌شوند)
.sp
یک حرف می‌تواند تکرار شود، یا چندین مقدار (جداشده با فاصله) ارائه شود (GDAL >= 3.3).
نتیجه این کار ایجاد یک آرایهٔ سه‌بعدی numpy خواهد بود.
از GDAL 3.5 به بعد، کاراکترهای عام (با استفاده از ?, *) برای تمام پوسته‌ها/پلتفرم‌ها پشتیبانی می‌شوند.
در چنین حالتی، فرمول محاسباتی باید از این ورودی به عنوان یک آرایهٔ سه‌بعدی استفاده کند و باید یک آرایهٔ دوبعدی برگرداند (\fI\%Example 3\fP را ببینید).
اگر محاسبه یک آرایهٔ دوبعدی برنگرداند، یک خطا تولید خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-A_band=<n>
شماره باند رستر برای فایل A (پیش‌فرض 1).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-outfile=<filename>
فایل خروجی برای تولید یا پر کردن.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-NoDataValue=<value>
مقدار NoDataValue خروجی (پیش‌فرض: مقدار مشخصهٔ نوع داده).
برای مشخص کردن تنظیم نکردن NoDataValue از \-\-NoDataValue=none استفاده کنید (GDAL >= 3.3)
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
در استفاده از API پایتون:
مقدار \fBNone\fP نشان‌دهندهٔ مقدار پیش‌فرض مختص به نوع داده خواهد بود.
مقدار \fB\(aqnone\(aq\fP نشان‌دهندهٔ عدم تنظیم NoDataValue خواهد بود.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-hideNoData
در نسخهٔ 3.3 اضافه شد.

.sp
مقدار NoDataValue باندهای ورودی را نادیده می‌گیرد.
به‌طور پیش‌فرض، مقدار NoDataValue باندهای ورودی در محاسبه شرکت داده نمی‌شوند.
با تنظیم این گزینه \- هیچ رفتار خاصی روی NoDataValue ورودی انجام نخواهد شد و آن‌ها مانند هر مقدار دیگری در محاسبه شرکت خواهند کرد.
خروجی دارای NoDataValue تنظیم‌شده نخواهد بود، مگر اینکه صراحتاً با تنظیم \-\-NoDataValue=<value> یک مقدار مشخص را تعیین کرده باشید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-type=<datatype>
نوع دادهٔ خروجی، باید یکی از [\fBByte\fP, \fBInt8\fP, \fBUInt16\fP, \fBInt16\fP, \fBUInt32\fP, \fBInt32\fP, \fBUInt64\fP, \fBInt64\fP, \fBFloat64\fP, \fBFloat32\fP, \fBCInt16\fP, \fBCInt32\fP, \fBCFloat64\fP, \fBCFloat32\fP] باشد.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
صرف‌نظر از نوع دادهٔ تعیین‌شده با استفاده از \fB\-\-type\fP، هنگام انجام عملیات حسابی میانی با استفاده از عملوندهای دارای نوع دادهٔ یکسان، نتیجهٔ عملیات نوع دادهٔ اصلی را حفظ خواهد کرد. این امر ممکن است منجر به نتایج غیرمنتظره در خروجی نهایی شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
انواع دادهٔ UInt64، Int64، CInt16، CInt32، CFloat32 و CFloat64 در GDAL 3.5.3 اضافه شده‌اند.
Int8 در GDAL 3.7 اضافه شده است.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-format=<gdal_format>
قالب GDAL برای فایل خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-color\-table=<filename>
امکان مشخص کردن نام فایل یک جدول رنگ (یا یک شیء ColorTable) (با تفسیر نمایهٔ پالت) را برای استفاده در رستر خروجی فراهم می‌کند.
قالب‌های پشتیبانی‌شده: txt (یعنی مانند gdaldem، اما نام‌های رنگ پشتیبانی نمی‌شوند)، qlr، qml (یعنی صادرشده از QGIS).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-extent=<option>
در نسخهٔ 3.3 اضافه شد.

.sp
این گزینه نحوهٔ مدیریت رسترهایی با محدوده‌های متفاوت را تعیین می‌کند.
این گزینه با گزینهٔ \fIprojwin\fP که برای ارائهٔ یک محدودهٔ سفارشی استفاده می‌شود، ناسازگار و مانعة‌الجمع است.
.sp
برای تمام گزینه‌های زیر، اندازهٔ پیکسل (تفکیک‌پذیری) و SRS (سامانهٔ مرجع مکانی) تمام رسترهای ورودی باید یکسان باشد.
.sp
\fBignore\fP (پیش‌فرض) \- فقط ابعاد رسترها مقایسه می‌شوند. اگر ابعاد مطابقت نداشته باشند، عملیات ناموفق خواهد بود.
.sp
\fBfail\fP \- ابعاد و محدوده (مرزهای) رسترها باید مطابقت داشته باشند، در غیر این صورت عملیات با شکست مواجه می‌شود.
.sp
\fBunion\fP \- محدوده (مرزهای) خروجی، کوچک‌ترین مستطیلی خواهد بود که تمام محدوده‌های ورودی را در بر می‌گیرد.
.sp
\fBintersect\fP \- محدوده (مرزهای) خروجی، بزرگ‌ترین مستطیلی خواهد بود که در تمام محدوده‌های ورودی گنجانده شده است.
.UNINDENT
.INDENT 0.0.TP
.B \-\-projwin <ulx> <uly> <lrx> <lry>
در نسخه 3.3 اضافه شد.

.sp
این گزینه یک محدوده (extent) سفارشی برای خروجی مشخص می‌کند؛ استفاده هم‌زمان از آن با گزینه \fIextent\fP مجاز نیست.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-projectionCheck
در نسخه 3.3 اضافه شد.

.sp
به‌طور پیش‌فرض، هیچ بررسی روی سیستم تصویر انجام نخواهد شد.
با فعال کردن این گزینه، در صورتی که سیستم تصویر برای تمامی باندها یکسان نباشد، عملیات ناموفق خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-creation\-option=<option>
یک گزینه ساخت (creation option) را به درایور قالب خروجی ارسال می‌کند. می‌توان
چندین گزینه را مشخص کرد. برای گزینه‌های ساخت مجاز مربوط به هر قالب، مستندات اختصاصی
آن قالب را بررسی کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co=<option>
مشابه با \fI\%creation\-option\fP\& است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-allBands=[a\-z, A\-Z]
اعمال عبارت بر روی تمام باندهای یک رستر مشخص. زمانی که از
\fI\%\-\-allBands\fP استفاده می‌شود، \fI\%\-\-calc\fP تنها یک‌بار می‌تواند مشخص شود.
به \fI\%Example 11\fP و \fI\%Example 12\fP\& نگاه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
بازنویسی فایل خروجی در صورتی که از قبل موجود باشد. بازنویسی در اینجا باید
به معنای حذف و ساخت مجدد فایل از ابتدا در نظر گرفته شود. توجه داشته باشید که اگر
این گزینه مشخص \fIنشده باشد\fP و فایل خروجی از قبل موجود باشد، به‌صورت درجا (in place)
به‌روزرسانی خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-debug
چاپ اطلاعات اشکال‌زدایی (debugging).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-quiet
عدم نمایش پیام‌های پیشرفت.
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت 0، و در صورت بروز خطا مقداری غیر صفر
برمی‌گرداند (خطاهای غیر مسدودکننده که به صورت هشدار ارسال می‌شوند، به عنوان یک اجرای
موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "گزینه‌های پایتون (PYTHON OPTIONS)"
.sp
در نسخه 3.3 اضافه شد.

.sp
گزینه‌های زیر با استفاده از رابط پایتون \fBgdal_calc\fP\& در دسترس هستند.
این گزینه‌ها از طریق خط فرمان در دسترس نیستند.
.INDENT 0.0
.TP
.B user_namespace
یک دیکشنری از توابع سفارشی یا نام‌های دیگر جهت استفاده در عبارت محاسباتی Calc.
.UNINDENT
.INDENT 0.0
.TP
.B return_ds
در صورت فعال بودن، مجموعه‌داده خروجی از تابع بازگردانده شده و بسته نخواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B color_table
امکان مشخص کردن یک شیء ColorTable (با تفسیر Palette Index) را جهت استفاده در رستر خروجی فراهم می‌کند.
.UNINDENT.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: میانگین دو فایل
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input1.tif \-B input2.tif \-\-outfile=result.tif \-\-calc=\(dq(A+B)/2\(dq
.EE
.UNINDENT
.UNINDENT
.sp
\fBاحتیاط:\fP
.INDENT 0.0
.INDENT 3.5
اگر هر دو ورودی A و B دارای نوع داده عدد صحیح باشند، تقسیم صحیح انجام
خواهد شد. برای جلوگیری از این کار، می‌توانید پیش از عملیات تقسیم، یکی از
عملوندها را به نوع ممیز شناور تبدیل کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input.tif \-B input2.tif \-\-outfile=result.tif \-\-calc=\(dq(A.astype(numpy.float64) + B) / 2\(dq
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS مثال ۲: جمع سه فایل
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input1.tif \-B input2.tif \-C input3.tif \-\-outfile=result.tif \-\-calc=\(dqA+B+C\(dq
.EE
.UNINDENT
.UNINDENT
.SS مثال ۳: ترکیب سه فایل در یک آرایه سه‌بعدی و جمع آن‌ها
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input1.tif \-A input2.tif \-A input3.tif \-\-outfile=result.tif \-\-calc=\(dqnumpy.sum(A,axis=0)\(dq.
.EE
.UNINDENT
.UNINDENT
.SS مثال ۴: میانگین سه فایل
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input1.tif \-B input2.tif \-C input3.tif \-\-outfile=result.tif \-\-calc=\(dq(A+B+C)/3\(dq
.EE
.UNINDENT
.UNINDENT
.SS مثال ۵: میانگین سه فایل با استفاده از آرایه سه‌بعدی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input1.tif input2.tif input3.tif \-\-outfile=result.tif \-\-calc=\(dqnumpy.average(a,axis=0)\(dq.
.EE
.UNINDENT
.UNINDENT
.SS مثال ۶: بیشینه سه فایل
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input1.tif \-B input2.tif \-C input3.tif \-\-outfile=result.tif \-\-calc=\(dqnumpy.max((A,B,C),axis=0)\(dq
.EE
.UNINDENT
.UNINDENT
.SS مثال ۷: بیشینه سه فایل با استفاده از یک آرایه سه‌بعدی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input1.tif input2.tif input3.tif \-\-outfile=result.tif \-\-calc=\(dqnumpy.max(A,axis=0)\(dq
.EE
.UNINDENT
.UNINDENT.SS مثال ۸: تنظیم مقادیر صفر و کمتر به NODATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input.tif \-\-outfile=result.tif \-\-calc=\(dqA*(A>0)\(dq \-\-NoDataValue=0
.EE
.UNINDENT
.UNINDENT
.SS مثال ۹: استفاده از عملگر منطقی برای نگه‌داشتن بازه‌ای از مقادیر ورودی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input.tif \-\-outfile=result.tif \-\-calc=\(dqA*logical_and(A>100,A<150)\(dq
.EE
.UNINDENT
.UNINDENT
.SS مثال ۱۰: انجام دو محاسبه و ذخیره نتایج در باندهای مجزا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A input.tif \-\-A_band=1 \-B input.tif \-\-B_band=2 \e
  \-\-outfile=result.tif \-\-calc=\(dq(A+B)/2\(dq \-\-calc=\(dqB*logical_and(A>100,A<150)\(dq
.EE
.UNINDENT
.UNINDENT
.SS مثال ۱۱: افزودن یک رستر به هر باند در یک رستر سه‌بانده
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A 3band.tif \-B 1band.tif \-\-outfile result.tif \-\-calc \(dqA+B\(dq \-\-allBands A
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه دارای سه باند خواهد بود، به‌طوری که هر باند شامل مقادیر \fB1band.tif\fP
افزوده‌شده به باند متناظر در \fB3band.tif\fP است\&.
.SS مثال ۱۲: جمع دو رستر سه‌بانده
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_calc \-A 3band_a.tif \-B 3band_b.tif \-\-outfile result.tif \-\-calc \(dqA+B\(dq \-\-allBands A \-\-allBands B
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه دارای سه باند خواهد بود، به‌طوری که هر باند شامل مقادیر باند متناظر
از \fB3band_a.tif\fP افزوده‌شده به باند متناظر از \fB3band_b.tif\fP است\&.
.SH "نویسندگان (AUTHORS)"
Chris Yesson <chris dot yesson at ioz dot ac dot uk>, Etienne Tourigny <etourigny dot dev at gmail dot com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.