| GDAL_EDIT(1) | GDAL | GDAL_EDIT(1) |
نام (NAME)
gdal_edit - ویرایش درجا و مستقیم اطلاعات گوناگون یک مجموعه داده GDAL موجود
خلاصه دستور (SYNOPSIS)
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>
توضیحات (DESCRIPTION)
دستور gdal_edit می‌تواند برای ویرایش درجا و بدون بازنویسی کامل اطلاعات گوناگون یک مجموعه داده GDAL موجود (سیستم مختصات، تبدیل جغرافیایی، مقادیر بدون داده و متادیتا) استفاده شود.
این ابزار فقط با فرمت‌های شطرنجی (رستر) که از دسترسی به‌روزرسانی برای داده‌های موجود پشتیبانی می‌کنند کار می‌کند.
هشدار:
نکته:
نکته کاربردی:
به gdal raster edit مراجعه کنید.
- --help
- نمایش پیام راهنما و خروج.
- --help-general
- نمایش پیام کوتاه نحوه استفاده برای گزینه‌های عمومی خط فرمان GDAL و خروج.
- -ro
- باز کردن مجموعه داده در حالت فقط‌خواندنی. این گزینه برای درایورهایی که از باز کردن داده در حالت به‌روزرسانی (update-mode) خودداری می‌کنند مفید است. در این حالت، اطلاعات به‌روزرسانی‌شده در فایل‌های PAM .aux.xml ذخیره می‌شوند.
- -a_srs <srs_def>
- تعریف سیستم مختصات مرجع هدف. این سیستم مختصات در مجموعه داده نوشته خواهد شد. اگر رشته خالی یا None مشخص شود، سیستم مختصات موجود حذف خواهد شد (برای TIFF/GeoTIFF ممکن است فراتر از آن به خوبی پشتیبانی نشود).
- -a_coord_epoch <epoch>
- تخصیص یا
جایگزینی
مبدأ زمانی
مختصات (epoch)
برای
مجموعه
داده به
صورت سال
اعشاری
(مانند 2021.3).
در نسخه 3.9 اضافه شد.
- -unsetepoch
- حذف مبدأ
زمانی
مختصات از
مجموعه
داده.
در نسخه 3.9 اضافه شد.
- -a_ullr <ulx> <uly> <lrx> <lry>
- تخصیص یا جایگزینی محدوده‌های ارجاع جغرافیایی (مختصات گوشه بالا-چپ و پایین-راست) مجموعه داده.
- -a_ulurll <ulx> <uly> <urx> <ury> <llx> <lly>
- تخصیص یا
جایگزینی
محدوده‌های
ارجاع
جغرافیایی
مجموعه
داده از
طریق سه
نقطه:
بالا-چپ،
بالا-راست و
پایین-چپ.
بر خلاف -a_ullr،
این گزینه
از
مجموعه‌های
داده
چرخانده‌شده
(لبه‌هایی
که موازی
محورهای
مختصات
نیستند) نیز
پشتیبانی
می‌کند.
در نسخه 3.1 اضافه شد.
- -tr <xres> <yres>
- تنظیم وضوح تفکیک‌پذیری هدف. مقادیر باید بر حسب واحدهای ارجاع جغرافیایی بیان شوند. هر دو مقدار باید مثبت باشند.
- -unsetgt
- حذف اطلاعات ارجاع جغرافیایی (georeference).
- -unsetrpc
- حذف اطلاعات RPC.
- -unsetstats
- حذف اطلاعات آمار باندهای رستر.
- -stats
- محاسبه و ذخیره آمار باندهای رستر.
- -setstats <min> <max> <mean> <stddev>
- ذخیره مقادیر سفارشی کاربر برای آمار باندها (حداقل، حداکثر، میانگین و انحراف معیار). اگر هر یک از مقادیر برابر با None قرار داده شود، آماره‌های واقعی از فایل محاسبه شده و مقدار محاسبه‌شده جایگزین مقدار None می‌شود.
- -approx_stats
- محاسبه و ذخیره آمار تقریبی باندها.
- -a_nodata <value>
- تخصیص یک مقدار مشخص به عنوان مقدار بدون داده (nodata) برای باندهای خروجی.
- -unsetnodata
- حذف مقادیر بدون داده (nodata) موجود.
- -scale <value>
- تخصیص یک
مقدار
مقیاس (scale)
مشخص به
باندهای
خروجی. اگر
یک مقدار
تکی مشخص
شود، برای
تمامی
باندها
اعمال
می‌گردد.
همچنین
می‌توان
برای هر
باند یک
مقدار مشخص
تعیین کرد
که در این
صورت تعداد
مقادیر
باید با
تعداد
باندها
مطابقت
داشته باشد.
در صورت عدم
نیاز به
مقیاس،
توصیه
می‌شود
مقدار آن
برابر با 1
قرار گیرد.
مقیاس و
جابه‌جایی
(Offset) معمولاً
با هم
استفاده
می‌شوند. به
عنوان
مثال،
مقیاس و
جابه‌جایی
ممکن است
برای ذخیره
مقادیر
ارتفاع در
یک فایل عدد
صحیح 16 بیتی
بدون علامت
با دقت 0.1 و
شروع از -100
استفاده
شوند.
مقادیر
واقعی به
این صورت
محاسبه
می‌شوند: true_value =
(pixel_value * scale) + offset
نکته:
- -offset <value>
- تخصیص یک مقدار جابه‌جایی (offset) مشخص به باندهای خروجی. اگر یک مقدار تکی مشخص شود، برای تمامی باندها اعمال خواهد شد. همچنین می‌توان برای هر باند یک مقدار تعیین کرد که در این صورت تعداد مقادیر باید با تعداد باندها همخوانی داشته باشد. در صورت عدم نیاز به جابه‌جایی، توصیه می‌شود مقدار 0 تنظیم گردد. برای جزئیات بیشتر به گزینه scale مراجعه فرمایید.
- -units <value>
- تخصیص یک
واحد سنجش
به
باند(های)
خروجی.
در نسخه 3.1 اضافه شد.
- -colorinterp_<X> {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...}
- تغییر تفسیر رنگ باند X (که در آن X یک شماره باند معتبر از 1 به بالا است).
- -gcp pixel <line> <easting> <northing> [<elevation>]
- افزودن نقطه کنترل زمینی (GCP) مشخص‌شده به مجموعه داده. این گزینه می‌تواند چندین بار برای افزودن مجموعه‌ای از GCPها تکرار شود.
- -unsetmd
- حذف متادیتای موجود (در دامنه متادیتای پیش‌فرض). می‌تواند همراه با -mo استفاده شود.
- -mo <META-TAG>=<VALUE>
- ارسال یک کلید و مقدار متادیتا جهت تنظیم روی مجموعه داده در صورت امکان. این متادیتا به موارد متادیتای موجود اضافه می‌گردد، مگر اینکه گزینه -unsetmd نیز مشخص شده باشد.
- -oo <NAME>=<VALUE>
- گزینه باز کردن (مختص فرمت).
گزینه‌های -a_ullr، -a_ulurll، -tr و -unsetgt ناسازگار با یکدیگر (مانعةالجمع) هستند.
گزینه -unsetstats با هر یک از گزینه‌های -stats یا -approx_stats ناسازگار است.
کد وضعیت خروجی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: جایگزینی محدوده‌های مکانی یک مجموعه داده و تخصیص مقادیر متادیتا
gdal_edit -mo DATUM=WGS84 -mo PROJ=GEODETIC -a_ullr 7 47 8 46 test.ecw
مثال ۲: تخصیص مقادیر مقیاس و جابه‌جایی به مجموعه داده
gdal_edit -scale 1e3 1e4 -offset 0 10 twoBand.tif
مقادیر در فایل GeoTIFF تغییر داده نمی‌شوند.
نویسندگان (AUTHORS)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |