.\" 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-EDIT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-edit \- ویرایش در‌جای مجموعه‌داده رستر .sp افزوده شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster edit [OPTIONS] Edit a raster dataset. Positional arguments: \-\-dataset Dataset (to be updated in\-place, unless \-\-auxiliary) [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: \-\-auxiliary Ask for an auxiliary .aux.xml file to be edited [not available in pipelines] \-b, \-\-band Active band (1\-based index) \-\-crs Override CRS (without reprojection) \-\-bbox Bounding box as xmin,ymin,xmax,ymax \-\-nodata Assign a specified nodata value to output bands (\(aqnone\(aq, numeric value, \(aqnan\(aq, \(aqinf\(aq, \(aq\-inf\(aq) \-\-color\-interpretation <[all|=] Set band color interpretation [may be repeated] \-\-color\-map Color map filename Mutually exclusive with \-\-unset\-color\-table \-\-scale <[=] Override band scale factor [may be repeated] \-\-offset <[=] Override band offset constant [may be repeated] \-\-metadata = Add/update dataset metadata item [may be repeated] \-\-unset\-color\-table Unset color table on 1st band or the one specified with \-\-band Mutually exclusive with \-\-color\-map \-\-unset\-metadata Remove dataset metadata item(s) [may be repeated] \-\-unset\-metadata\-domain Remove dataset metadata domain(s) [may be repeated] \-\-gcp Add ground control point, formatted as pixel,line,easting,northing[,elevation], or @filename [may be repeated] \-\-stats Compute statistics, using all pixels Mutually exclusive with \-\-approx\-stats \-\-approx\-stats Compute statistics, using a subset of pixels Mutually exclusive with \-\-stats \-\-hist Compute histogram Advanced Options: \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster edit\fP می‌تواند برای ویرایش مجموعه‌داده‌های رستر استفاده شود. .sp این زیردستور همچنین به عنوان یک مرحله بالقوه در \fI\%gdal raster pipeline\fP در دسترس است. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-approx\-stats محاسبه آمار باندهای رستر برای تمام باندها. این آمار ممکن است بر پایه نمای کلی (overviews) یا زیرمجموعه‌ای از تمام تایل‌ها محاسبه شود. این گزینه زمانی که عجله دارید و به آمار دقیق نیازی ندارید مفید است. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 این گزینه زمانی که دستور بخشی از یک خط لوله (pipeline) باشد در دسترس نیست. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-auxiliary اجبار به باز کردن مجموعه‌داده در حالت فقط‌خواندنی. برای درایورهایی که سازوکار متادیتای کمکی پایدار (PAM) را پیاده‌سازی کرده‌اند، تغییرات در یک فایل جانبی کمکی با پسوند \fB\&.aux.xml\fP ذخیره خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-band افزوده شده در نسخه 3.13. .sp نمایه (با شروع از 1) باندی که گزینه‌های زیر روی آن اعمال می‌شوند: \fI\%\-\-color\-map\fP، \fI\%\-\-unset\-color\-table\fP. در صورت عدم تعیین، مقدار پیش‌فرض 1 است. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox ,,, بازنویسی کادر محدودکننده مکانی، در واحدهای CRS، بدون بازتصویرسازی یا جداسازی زیرمجموعه. مقدار \(aqx\(aq برای CRS جغرافیایی مقادیر طول جغرافیایی و برای CRS تصویرشده مختصات شرقی (easting) است. مقدار \(aqy\(aq برای CRS جغرافیایی مقادیر عرض جغرافیایی و برای CRS تصویرشده مختصات شمالی (northing) است. .UNINDENT .INDENT 0.0 .TP .B \-\-color\-map افزوده شده در نسخه 3.13. .sp نام فایل نقشه‌رنگ حاوی ارتباط میان مقادیر مختلف رستر و رنگ دلخواه متناظر جهت تنظیم روی باند اول، یا باندی که توسط \fI\%\-\-band\fP مشخص شده است. این می‌تواند یک مجموعه‌داده GDAL با جدول رنگ متصل به باند اول آن، یا یک فایل پیکربندی رنگ متنی باشد. .sp فایل پیکربندی رنگ متنی معمولاً شامل ۴ ستون در هر خط است: مقدار رستر و مؤلفه‌های متناظر قرمز (Red)، سبز (Green) و آبی (Blue) (بین 0 تا 255). مقدار رستر باید یک عدد صحیح بین 0 تا 65535 باشد. مقدار رستر همچنین می‌تواند به‌صورت درصد بیان شود: 0% کمترین مقدار موجود در رستر و 100% بیشترین مقدار است. .sp یک ستون اضافی می‌تواند به‌صورت اختیاری برای مؤلفه آلفا اضافه شود. در صورت عدم تعیین، کدر بودن کامل (255) فرض می‌شود. .sp جداکننده‌های مختلف فیلد پذیرفته می‌شوند: کاما، تب، فاصله، \(aq:\(aq. .sp رنگ‌های متداول مورد استفاده در GRASS نیز می‌توانند با استفاده از نام آن‌ها به جای سه‌تایی RGB مشخص شوند. فهرست پشتیبانی‌شده عبارت است از: white، black، red، green، blue، yellow، magenta، cyan، aqua، grey/gray، orange، brown، purple/violet و indigo. .INDENT 7.0 .INDENT 3.5 فایل‌های پالت GMT \fB\&.cpt\fP نیز پشتیبانی می‌شوند (فقط COLOR_MODEL = RGB). .UNINDENT .UNINDENT .sp نکته: ساختار نوشتاری فایل پیکربندی رنگ از ابزار r.colors در GRASS برگرفته شده است. فایل‌های جدول رنگ ESRI HDR (.clr) نیز با این ساختار مطابقت دارند. مؤلفه آلفا و پشتیبانی از تب و کاما به عنوان جداکننده، افزونه‌های اختصاصی GDAL هستند. .sp برای مثال: .INDENT 7.0 .INDENT 3.5 .sp .EX 3500 white 2500 235:220:175 50% 190 185 135 700 240 250 150 0 50 180 50 .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-crs بازنویسی CRS، بدون بازتصویرسازی. .sp سیستم‌های مرجع مختصاتی که می‌توان مشخص کرد هر موردی است که توسط فراخوانی \fI\%OGRSpatialReference::SetFromUserInput()\fP پشتیبانی می‌شود، از جمله CRS تصویرشده، جغرافیایی یا ترکیبی EPSG (مانند EPSG:4296)، تعریف CRS به فرمت WKT (متن شناخته‌شده)، اعلان‌های PROJ.4، یا نام یک فایل .prj حاوی تعریف WKT CRS. .sp می‌توان از \fBnull\fP یا \fBnone\fP برای حذف CRS موجود استفاده کرد. .sp توجه داشته باشید که وسعت مکانی نیز دست‌نخورده باقی می‌ماند. .UNINDENT .INDENT 0.0 .TP .B \-\-dataset نام مجموعه‌داده، برای به‌روزرسانی درجا، مگر اینکه \fI\%\-\-auxiliary\fP تنظیم شده باشد. الزامی است. .UNINDENT .INDENT 0.0 .TP .B \-\-gcp افزوده شده در نسخه 3.12. .sp تنظیم نقطه(های) کنترل زمینی (GCP)، جایگزین هرگونه GCP موجود. هر GCP باید به صورت رشته \(dqpixel,line,easting,northing\(dq یا \(dqpixel,line,easting,northing,elevation\(dq قالب‌بندی شود. هر GCP باید با یک آرگومان \fB\-\-gcp\fP مشخص شود. .sp همچنین می‌توان یک آرگومان یکتای \fB\-\-gcp\fP ارائه داد که مقدار آن نام فایل یک مجموعه‌داده برداری با پیشوند \fI@\fP است. این مجموعه‌داده باید دارای یک لایه با فیلدهای الزامی \fBcolumn\fP، \fBline\fP، \fBx\fP، \fBy\fP و به‌صورت اختیاری \fBid\fP، \fBinfo\fP و \fBz\fP باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-hist محاسبه اطلاعات هیستوگرام برای تمام باندها. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 این گزینه زمانی که دستور بخشی از یک خط لوله باشد در دسترس نیست. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-color\-interpretation [all|=] افزوده شده در نسخه 3.13. .sp تنظیم تفسیر رنگ باند. می‌تواند تکرار شود. .sp مقدار \fB\fP یکی از مقادیر \fBred\fP، \fBgreen\fP، \fBblue\fP، \fBalpha\fP، \fBgray\fP، \fBundefined\fP، \fBpan\fP، \fBcoastal\fP، \fBrededge\fP، \fBnir\fP، \fBswir\fP، \fBmwir\fP یا \fBlwir\fP است. .sp چندین ساختار نوشتاری پشتیبانی می‌شوند: .INDENT 7.0 .IP \(bu 2 تعیین \fBall=\fP: تنظیم تفسیر رنگ روی تمام باندها. .IP \(bu 2 تعیین به تعداد باندها \fB\fP، از باند 1 تا آخرین باند. .IP \(bu 2 تعیین تفسیر رنگ روی زیرمجموعه‌ای از باندها با \fB=\fP که در آن band شماره باند با شروع از 1 است. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-scale [=] افزوده شده در نسخه 3.13. .sp تنظیم ضریب مقیاس باند. می‌تواند تکرار شود. .sp چندین ساختار نوشتاری پشتیبانی می‌شوند: .INDENT 7.0 .IP \(bu 2 تعیین یک \fB\fP منفرد: تنظیم مقیاس روی تمام باندها. .IP \(bu 2 تعیین به تعداد باندها \fB\fP، از باند 1 تا آخرین باند. .IP \(bu 2 تعیین مقیاس روی زیرمجموعه‌ای از باندها با \fB=\fP که در آن band شماره باند با شروع از 1 است. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-offset [=] افزوده شده در نسخه 3.13. .sp تنظیم ثابت آفست باند. می‌تواند تکرار شود. .sp چندین ساختار نوشتاری پشتیبانی می‌شوند: .INDENT 7.0 .IP \(bu 2 تعیین یک \fB\fP منفرد: تنظیم آفست روی تمام باندها. .IP \(bu 2 تعیین به تعداد باندها \fB\fP، از باند 1 تا آخرین باند. .IP \(bu 2 تعیین آفست روی زیرمجموعه‌ای از باندها با \fB=\fP که در آن band شماره باند با شروع از 1 است. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-metadata = افزودن/به‌روزرسانی آیتم متادیتا در سطح مجموعه‌داده. می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata بازنویسی مقدار nodata. .sp می‌توان از \fBnull\fP یا \fBnone\fP برای حذف مقدار nodata موجود استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-stats محاسبه آمار باندهای رستر برای تمام باندها. .UNINDENT .INDENT 0.0 .TP .B \-\-unset\-color\-table افزوده شده در نسخه 3.13. .sp حذف جدول رنگ متصل به باند اول، یا باندی که توسط \fI\%\-\-band\fP مشخص شده است. .UNINDENT .INDENT 0.0 .TP .B \-\-unset\-metadata حذف آیتم(های) متادیتا در سطح مجموعه‌داده. می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-unset\-metadata\-domain افزوده شده در نسخه 3.12. .sp حذف دامنه(های) متادیتا در سطح مجموعه‌داده. می‌تواند تکرار شود. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (وابسته به فرمت). .sp می‌تواند تکرار شود. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق تلقی می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: بازنویسی (بدون بازتصویرسازی) CRS یک مجموعه‌داده .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster edit \-\-crs=EPSG:32632 my.tif .EE .UNINDENT .UNINDENT .SS مثال ۲: بازنویسی (بدون بازتصویرسازی یا برش) کادر محدودکننده یک مجموعه‌داده .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster edit \-\-bbox=2,49,3,50 my.tif .EE .UNINDENT .UNINDENT .SS مثال ۳: افزودن یک آیتم متادیتا .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster edit \-\-metadata AUTHOR=EvenR my.tif .EE .UNINDENT .UNINDENT .SS مثال ۴: حذف یک آیتم متادیتا .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster edit \-\-unset\-metadata AUTHOR my.tif .EE .UNINDENT .UNINDENT .SS مثال ۵: افزودن ۲ نقطه کنترل زمینی (GCP) برای (column=0,line=0,X=2,Y=49) و (column=50,line=100,X=3,Y=48) .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster edit \-\-gcp 0,0,2,49 \-\-gcp 50,100,3,48 my.tif .EE .UNINDENT .UNINDENT .SS مثال ۶: افزودن نقاط کنترل زمینی (GCP) از فایل gcps.csv، که باید دارای فیلدهایی به نام‌های column، line، x و y باشد. .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster edit \-\-gcp @gcps.csv my.tif .EE .UNINDENT .UNINDENT .SS مثال ۷: تنظیم تفسیر رنگ قرمز، سبز، آبی، مادون قرمز نزدیک (NIR) برای یک مجموعه‌داده ۴ بانده .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster edit \-\-color\-interpretation red,green,blue,nir 4band.tif .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .