.\" 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_EDIT" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal_edit \- ویرایش درجا و مستقیم اطلاعات گوناگون یک مجموعه داده GDAL موجود
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_edit [\-\-help] [\-\-help\-general] [\-ro] [\-a_srs <srs_def>]
        [\-a_ullr <ulx> <uly> <lrx> <lry>] [\-a_ulurll <ulx> <uly> <urx> <ury> <llx> <lly>]
        [\-tr <xres> <yres>] [\-unsetgt] [\-unsetrpc] [\-a_nodata <value>] [\-unsetnodata]
        [\-a_coord_epoch <epoch>] [\-unsetepoch]
        [\-unsetstats] [\-stats] [\-approx_stats]
        [\-setstats <min> <max> <mean> <stddev>]
        [\-scale <value>] [\-offset <value>] [\-units <value>]
        [\-colorinterp_<X> {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...}]...
        [\-gcp <pixel> <line> <easting> <northing> [<elevation>]]...
        [\-unsetmd] [\-oo <NAME>=<VALUE>]... [\-mo <META\-TAG>=<VALUE>]...
        <datasetname>
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal_edit\fP می‌تواند برای ویرایش درجا و بدون بازنویسی کامل اطلاعات گوناگون یک مجموعه داده GDAL موجود (سیستم مختصات، تبدیل جغرافیایی، مقادیر بدون داده و متادیتا) استفاده شود.
.sp
این ابزار فقط با فرمت‌های شطرنجی (رستر) که از دسترسی به‌روزرسانی برای داده‌های موجود پشتیبانی می‌کنند کار می‌کند.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
بسته به فرمت فایل، ممکن است مقادیر قدیمی‌تر اطلاعات به‌روزرسانی‌شده همچنان در قالب حالت «شبح» (ghost) در فایل باقی بمانند، حتی اگر دیگر از طریق رابط برنامه‌نویسی GDAL قابل دسترسی نباشند. این مورد به عنوان مثال در فرمت \fI\%GTiff \-\- GeoTIFF File Format\fP رخ می‌دهد (این یک لیست جامع نیست).
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار gdal_edit یک ابزار پایتونی است و تنها در صورتی در دسترس خواهد بود که اتصالات پایتون GDAL نصب و موجود باشند.
.UNINDENT
.UNINDENT
.sp
\fBنکته کاربردی:\fP
.INDENT 0.0
.INDENT 3.5
معادل این دستور در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
به \fI\%gdal raster edit\fP مراجعه کنید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش پیام کوتاه نحوه استفاده برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-ro
باز کردن مجموعه داده در حالت فقط‌خواندنی. این گزینه برای درایورهایی که از باز کردن داده در حالت به‌روزرسانی (update-mode) خودداری می‌کنند مفید است. در این حالت، اطلاعات به‌روزرسانی‌شده در فایل‌های PAM \fB\&.aux.xml\fP ذخیره می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-a_srs <srs_def>
تعریف سیستم مختصات مرجع هدف.
این سیستم مختصات در مجموعه داده نوشته خواهد شد.
اگر رشته خالی یا None مشخص شود، سیستم مختصات موجود حذف خواهد شد (برای TIFF/GeoTIFF ممکن است فراتر از آن به خوبی پشتیبانی نشود).
.UNINDENT
.INDENT 0.0
.TP
.B \-a_coord_epoch <epoch>
تخصیص یا جایگزینی مبدأ زمانی مختصات (epoch) برای مجموعه داده به صورت سال اعشاری (مانند 2021.3).
.sp
در نسخه 3.9 اضافه شد.

.UNINDENT
.INDENT 0.0
.TP
.B \-unsetepoch
حذف مبدأ زمانی مختصات از مجموعه داده.
.sp
در نسخه 3.9 اضافه شد.

.UNINDENT
.INDENT 0.0
.TP
.B \-a_ullr  <ulx> <uly> <lrx> <lry>
تخصیص یا جایگزینی محدوده‌های ارجاع جغرافیایی (مختصات گوشه بالا-چپ و پایین-راست) مجموعه داده.
.UNINDENT
.INDENT 0.0
.TP
.B \-a_ulurll <ulx> <uly> <urx> <ury> <llx> <lly>
تخصیص یا جایگزینی محدوده‌های ارجاع جغرافیایی مجموعه داده از طریق سه نقطه: بالا-چپ، بالا-راست و پایین-چپ. بر خلاف \fI\%\-a_ullr\fP، این گزینه از مجموعه‌های داده چرخانده‌شده (لبه‌هایی که موازی محورهای مختصات نیستند) نیز پشتیبانی می‌کند.
.sp
در نسخه 3.1 اضافه شد.

.UNINDENT
.INDENT 0.0
.TP
.B \-tr <xres> <yres>
تنظیم وضوح تفکیک‌پذیری هدف. مقادیر باید بر حسب واحدهای ارجاع جغرافیایی بیان شوند. هر دو مقدار باید مثبت باشند.
.UNINDENT
.INDENT 0.0
.TP
.B \-unsetgt
حذف اطلاعات ارجاع جغرافیایی (georeference).
.UNINDENT
.INDENT 0.0
.TP
.B \-unsetrpc
حذف اطلاعات RPC.
.UNINDENT
.INDENT 0.0
.TP
.B \-unsetstats
حذف اطلاعات آمار باندهای رستر.
.UNINDENT
.INDENT 0.0
.TP
.B \-stats
محاسبه و ذخیره آمار باندهای رستر.
.UNINDENT
.INDENT 0.0
.TP
.B \-setstats <min> <max> <mean> <stddev>
ذخیره مقادیر سفارشی کاربر برای آمار باندها (حداقل، حداکثر، میانگین و انحراف معیار). اگر هر یک از مقادیر برابر با None قرار داده شود، آماره‌های واقعی از فایل محاسبه شده و مقدار محاسبه‌شده جایگزین مقدار None می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-approx_stats
محاسبه و ذخیره آمار تقریبی باندها.
.UNINDENT
.INDENT 0.0
.TP
.B \-a_nodata <value>
تخصیص یک مقدار مشخص به عنوان مقدار بدون داده (nodata) برای باندهای خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-unsetnodata
حذف مقادیر بدون داده (nodata) موجود.
.UNINDENT
.INDENT 0.0
.TP
.B \-scale <value>
تخصیص یک مقدار مقیاس (scale) مشخص به باندهای خروجی.
اگر یک مقدار تکی مشخص شود، برای تمامی باندها اعمال می‌گردد.
همچنین می‌توان برای هر باند یک مقدار مشخص تعیین کرد که در این صورت تعداد مقادیر باید با تعداد باندها مطابقت داشته باشد.
در صورت عدم نیاز به مقیاس، توصیه می‌شود مقدار آن برابر با 1 قرار گیرد.
مقیاس و جابه‌جایی (Offset) معمولاً با هم استفاده می‌شوند. به عنوان مثال، مقیاس و جابه‌جایی ممکن است برای ذخیره مقادیر ارتفاع در یک فایل عدد صحیح 16 بیتی بدون علامت با دقت 0.1 و شروع از \-100 استفاده شوند. مقادیر واقعی به این صورت محاسبه می‌شوند: true_value = (pixel_value * scale) + offset
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
این مقادیر را می‌توان با استفاده از گزینه \-unscale در طول اجرای \fBgdal_translate\fP اعمال کرد.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-offset <value>
تخصیص یک مقدار جابه‌جایی (offset) مشخص به باندهای خروجی.
اگر یک مقدار تکی مشخص شود، برای تمامی باندها اعمال خواهد شد.
همچنین می‌توان برای هر باند یک مقدار تعیین کرد که در این صورت تعداد مقادیر باید با تعداد باندها همخوانی داشته باشد.
در صورت عدم نیاز به جابه‌جایی، توصیه می‌شود مقدار 0 تنظیم گردد.
برای جزئیات بیشتر به گزینه scale مراجعه فرمایید.
.UNINDENT
.INDENT 0.0
.TP
.B \-units <value>
تخصیص یک واحد سنجش به باند(های) خروجی.
.sp
در نسخه 3.1 اضافه شد.

.UNINDENT
.INDENT 0.0
.TP
.B \-colorinterp_<X> {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...}
تغییر تفسیر رنگ باند X (که در آن X یک شماره باند معتبر از 1 به بالا است).
.UNINDENT
.INDENT 0.0
.TP
.B \-gcp pixel <line> <easting> <northing> [<elevation>]
افزودن نقطه کنترل زمینی (GCP) مشخص‌شده به مجموعه داده.
این گزینه می‌تواند چندین بار برای افزودن مجموعه‌ای از GCPها تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-unsetmd
حذف متادیتای موجود (در دامنه متادیتای پیش‌فرض).
می‌تواند همراه با \fI\%\-mo\fP استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-mo <META\-TAG>=<VALUE>
ارسال یک کلید و مقدار متادیتا جهت تنظیم روی مجموعه داده در صورت امکان.
این متادیتا به موارد متادیتای موجود اضافه می‌گردد، مگر اینکه گزینه \fI\%\-unsetmd\fP نیز مشخص شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-oo <NAME>=<VALUE>
گزینه باز کردن (مختص فرمت).
.UNINDENT
.sp
گزینه‌های \fI\%\-a_ullr\fP، \fI\%\-a_ulurll\fP، \fI\%\-tr\fP و \fI\%\-unsetgt\fP ناسازگار با یکدیگر (مانعةالجمع) هستند.
.sp
گزینه \fI\%\-unsetstats\fP با هر یک از گزینه‌های \fI\%\-stats\fP یا \fI\%\-approx_stats\fP ناسازگار است.
.SH "کد وضعیت خروجی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: جایگزینی محدوده‌های مکانی یک مجموعه داده و تخصیص مقادیر متادیتا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_edit \-mo DATUM=WGS84 \-mo PROJ=GEODETIC \-a_ullr 7 47 8 46 test.ecw
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: تخصیص مقادیر مقیاس و جابه‌جایی به مجموعه داده
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal_edit \-scale 1e3 1e4 \-offset 0 10 twoBand.tif
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر در فایل GeoTIFF تغییر داده نمی‌شوند.
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.