'\" t .\" 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-RASTER-RECLASSIFY" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-reclassify \- بازطبقه‌بندی یک مجموعه‌داده رستر .sp افزوده شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster reclassify [OPTIONS] Reclassify values in a raster dataset Positional arguments: \-i, \-\-input Input raster datasets [required] [not available in pipelines] \-o, \-\-output Output raster dataset [required] [not available in pipelines] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-f, \-\-of, \-\-format, \-\-output\-format Output format (\(dqGDALG\(dq allowed) [not available in pipelines] \-\-co, \-\-creation\-option = Creation option [may be repeated] [not available in pipelines] \-\-overwrite Whether overwriting existing output dataset is allowed [not available in pipelines] Mutually exclusive with \-\-append \-\-append Append as a subdataset to existing output [not available in pipelines] Mutually exclusive with \-\-overwrite \-m, \-\-mapping Reclassification mappings (or specify a @ to point to a file containing mappings [required] \-\-ot, \-\-datatype, \-\-output\-data\-type Output data type. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 Advanced Options: \-\-if, \-\-input\-format Input formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster reclassify\fP مقادیر موجود در یک مجموعه‌داده ورودی را بازطبقه‌بندی می‌کند. یک فایل (یا رشته متنی) نگاشت مقادیر یا بازه‌های پیکسلی ورودی به فایل‌های خروجی را مشخص می‌کند. .sp بازه‌های مقادیر را می‌توان با استفاده از براکت‌ها مشخص کرد: .TS box center; l|l. T{ نشانه‌گذاری T} T{ مفهوم T} _ T{ \fB[a,b]\fP T} T{ بازه بسته؛ شامل هر دو مقدار \fBa\fP و \fBb\fP T} _ T{ \fB[a,b)\fP T} T{ چپ‌بسته، راست‌باز؛ شامل \fBa\fP اما بدون \fBb\fP T} _ T{ \fB(a,b]\fP T} T{ چپ‌باز، راست‌بسته؛ بدون \fBa\fP اما شامل \fBb\fP T} _ T{ \fB(a,b)\fP T} T{ بازه باز؛ بدون هر دو مقدار \fBa\fP و \fBb\fP T} .TE .sp یک نمونه فایل در زیر نمایش داده شده است. .INDENT 0.0 .INDENT 3.5 .sp .EX # remap land cover types 0 = 10 # land [2,4] = 20 # freshwater 1 = 40 # ocean (4,6] = 50 # forest (excludes 4, includes 5 and 6) NO_DATA = NO_DATA # leave NoData pixels unmodified .EE .UNINDENT .UNINDENT .sp نویسه \fB#\fP نشان‌دهنده کامنت (توضیح) است که توسط مفسر نادیده گرفته می‌شود اما خواندن فایل را آسان‌تر می‌کند. در این حالت: .INDENT 0.0 .IP \(bu 2 مقادیر ورودی 0 در خروجی به 10 تبدیل می‌شوند .IP \(bu 2 مقادیر ورودی بین 2 و 4 (شامل خود آن‌ها) در خروجی به 20 تبدیل می‌شوند .IP \(bu 2 مقادیر ورودی 1 در خروجی به 40 تبدیل می‌شوند .IP \(bu 2 مقادیر ورودی بین 5 و 6 در خروجی به 50 تبدیل می‌شوند (4 شامل نمی‌شود) .IP \(bu 2 مقادیر NoData به عنوان NoData حفظ می‌شوند .UNINDENT .sp وجود هرگونه مقدار دیگری در ورودی موجب بروز خطا خواهد شد. اگر این رفتار مطلوب نیست، می‌توان از بازه ورودی \fBDEFAULT\fP برای مشخص کردن یک مقدار خروجی برای پیکسل‌هایی که تحت پوشش هیچ بازه ورودی دیگری نیستند استفاده کرد. این پیکسل‌ها می‌توانند به NoData تبدیل شوند (\fBDEFAULT = NO_DATA\fP)، به یک مقدار ثابت دیگر تبدیل شوند (مثلاً \fBDEFAULT = 50\fP)، یا بدون تغییر باقی بمانند (\fBDEFAULT = PASS_THROUGH\fP). .INDENT 0.0 .INDENT 2.5 [تصویر] مجموعه‌داده رستر قبل (چپ) و بعد (راست) از بازطبقه‌بندی با \fBgdal raster reclassify \-\-mapping \(dq[1,3]= 101; [4, 5)= 102; 7=102; NO_DATA=103; DEFAULT=NO_DATA\(dq\fP\&. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 دستور \fBgdal raster reclassify\fP از نوشتن در فرمت VRT پشتیبانی می‌کند؛ با این حال، فایل‌های VRT تولیدشده به این روش تنها با GDAL نسخه 3.11 یا بالاتر قابل باز شدن هستند. .UNINDENT .UNINDENT .SH "خروجی GDALG (مجموعه‌داده برخط / جریانی) (GDALG OUTPUT)" .sp این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از فرمت خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه‌داده رستر با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط لوله (pipeline) مشخص‌شده را به صورت برخط / جریانی اعمال نمود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-m, \-\-mapping تعریف نگاشت‌ها میان مقادیر پیکسلی ورودی و خروجی، مطابق آنچه در بالا شرح داده شد. نگاشت‌ها می‌توانند به صورت متن (که هر مدخل با یک نقطه-ویرگول جدا شده است) ارائه شوند، یا می‌توان آن‌ها را با استفاده از \fB@filename.txt\fP از یک فایل خواند. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده (subdataset) جدید به یک فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP\&. این گزینه همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت جهت کنترل فشرده‌سازی و تایل‌بندی فایل پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت است و برخی از فرمت‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به آن فرمت، مرجع اصلی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز برای هر فرمت، مستندات اختصاصی فرمت \fI\%Raster drivers\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام فرمت/درایور برای باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن آن نیست، اما زمانی که تشخیص خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌توان از آن برای صرف‌نظر از تشخیص خودکار استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به ویژه، برخی از درایورها الزاماتی روی پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format مشخص می‌کند از کدام فرمت رستر خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep raster | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-ot, \-\-datatype, \-\-output\-data\-type نوع داده خروجی از میان \fBByte\fP، \fBInt8\fP، \fBUInt16\fP، \fBInt16\fP، \fBUInt32\fP، \fBInt32\fP، \fBUInt64\fP، \fBInt64\fP، \fBCInt16\fP، \fBCInt32\fP، \fBFloat32\fP، \fBFloat64\fP، \fBCFloat32\fP و \fBCFloat64\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، \fBgdal\fP خطا می‌دهد. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster reclassify \-m \(dq0=10; [2,4]=20; 1=40\(dq \-i wbm.tif \-o typ.tif .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Dan Baston .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .