| GDAL-RASTER-EDIT(1) | GDAL | GDAL-RASTER-EDIT(1) |
نام (NAME)
gdal-raster-edit - ویرایش در‌جای مجموعه‌داده رستر
افزوده شده در نسخه 3.11.
خلاصه دستور (SYNOPSIS)
Usage: gdal raster edit [OPTIONS] <DATASET>
Edit a raster dataset.
Positional arguments:
--dataset <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 <KEY>=<VALUE> 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 <BAND> Active band (1-based index)
--crs <CRS> Override CRS (without reprojection)
--bbox <BBOX> Bounding box as xmin,ymin,xmax,ymax
--nodata <NODATA> Assign a specified nodata value to output bands ('none', numeric value, 'nan', 'inf', '-inf')
--color-interpretation <[all|<BAND>=]<COLOR-INTEPRETATION> Set band color interpretation [may be repeated]
--color-map <COLOR-MAP> Color map filename
Mutually exclusive with --unset-color-table
--scale <[<BAND>=]<SCALE> Override band scale factor [may be repeated]
--offset <[<BAND>=]<OFFSET> Override band offset constant [may be repeated]
--metadata <KEY>=<VALUE> 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 <KEY> Remove dataset metadata item(s) [may be repeated]
--unset-metadata-domain <DOMAIN> Remove dataset metadata domain(s) [may be repeated]
--gcp <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 <KEY>=<VALUE> Open options [may be repeated] [not available in pipelines]
توضیحات (DESCRIPTION)
دستور gdal raster edit می‌تواند برای ویرایش مجموعه‌داده‌های رستر استفاده شود.
این زیردستور همچنین به عنوان یک مرحله بالقوه در gdal raster pipeline در دسترس است.
گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)
- --approx-stats
- محاسبه
آمار
باندهای
رستر برای
تمام
باندها. این
آمار ممکن
است بر پایه
نمای کلی (overviews)
یا
زیرمجموعه‌ای
از تمام
تایل‌ها
محاسبه شود.
این گزینه
زمانی که
عجله دارید
و به آمار
دقیق نیازی
ندارید
مفید است.
نکته:
- --auxiliary
- اجبار به باز کردن مجموعه‌داده در حالت فقط‌خواندنی. برای درایورهایی که سازوکار متادیتای کمکی پایدار (PAM) را پیاده‌سازی کرده‌اند، تغییرات در یک فایل جانبی کمکی با پسوند .aux.xml ذخیره خواهد شد.
- -b, --band <BAND>
- افزوده شده
در نسخه 3.13.
نمایه (با شروع از 1) باندی که گزینه‌های زیر روی آن اعمال می‌شوند: --color-map، --unset-color-table. در صورت عدم تعیین، مقدار پیش‌فرض 1 است.
- --bbox <xmin>,<ymin>,<xmax>,<ymax>
- بازنویسی کادر محدودکننده مکانی، در واحدهای CRS، بدون بازتصویرسازی یا جداسازی زیرمجموعه. مقدار 'x' برای CRS جغرافیایی مقادیر طول جغرافیایی و برای CRS تصویرشده مختصات شرقی (easting) است. مقدار 'y' برای CRS جغرافیایی مقادیر عرض جغرافیایی و برای CRS تصویرشده مختصات شمالی (northing) است.
- --color-map <COLOR-MAP>
- افزوده شده
در نسخه 3.13.
نام فایل نقشه‌رنگ حاوی ارتباط میان مقادیر مختلف رستر و رنگ دلخواه متناظر جهت تنظیم روی باند اول، یا باندی که توسط --band مشخص شده است. این می‌تواند یک مجموعه‌داده GDAL با جدول رنگ متصل به باند اول آن، یا یک فایل پیکربندی رنگ متنی باشد.
فایل پیکربندی رنگ متنی معمولاً شامل ۴ ستون در هر خط است: مقدار رستر و مؤلفه‌های متناظر قرمز (Red)، سبز (Green) و آبی (Blue) (بین 0 تا 255). مقدار رستر باید یک عدد صحیح بین 0 تا 65535 باشد. مقدار رستر همچنین می‌تواند به‌صورت درصد بیان شود: 0% کمترین مقدار موجود در رستر و 100% بیشترین مقدار است.
یک ستون اضافی می‌تواند به‌صورت اختیاری برای مؤلفه آلفا اضافه شود. در صورت عدم تعیین، کدر بودن کامل (255) فرض می‌شود.
جداکننده‌های مختلف فیلد پذیرفته می‌شوند: کاما، تب، فاصله، ':'.
رنگ‌های متداول مورد استفاده در GRASS نیز می‌توانند با استفاده از نام آن‌ها به جای سه‌تایی RGB مشخص شوند. فهرست پشتیبانی‌شده عبارت است از: white، black، red، green، blue، yellow، magenta، cyan، aqua، grey/gray، orange، brown، purple/violet و indigo.
نکته: ساختار نوشتاری فایل پیکربندی رنگ از ابزار r.colors در GRASS برگرفته شده است. فایل‌های جدول رنگ ESRI HDR (.clr) نیز با این ساختار مطابقت دارند. مؤلفه آلفا و پشتیبانی از تب و کاما به عنوان جداکننده، افزونه‌های اختصاصی GDAL هستند.
برای مثال:
3500 white 2500 235:220:175 50% 190 185 135 700 240 250 150 0 50 180 50
- --crs <CRS>
- بازنویسی
CRS، بدون
بازتصویرسازی.
سیستم‌های مرجع مختصاتی که می‌توان مشخص کرد هر موردی است که توسط فراخوانی OGRSpatialReference::SetFromUserInput() پشتیبانی می‌شود، از جمله CRS تصویرشده، جغرافیایی یا ترکیبی EPSG (مانند EPSG:4296)، تعریف CRS به فرمت WKT (متن شناخته‌شده)، اعلان‌های PROJ.4، یا نام یک فایل .prj حاوی تعریف WKT CRS.
می‌توان از null یا none برای حذف CRS موجود استفاده کرد.
توجه داشته باشید که وسعت مکانی نیز دست‌نخورده باقی می‌ماند.
- --dataset <DATASET>
- نام مجموعه‌داده، برای به‌روزرسانی درجا، مگر اینکه --auxiliary تنظیم شده باشد. الزامی است.
- --gcp <GCP>
- افزوده شده
در نسخه 3.12.
تنظیم نقطه(های) کنترل زمینی (GCP)، جایگزین هرگونه GCP موجود. هر GCP باید به صورت رشته "pixel,line,easting,northing" یا "pixel,line,easting,northing,elevation" قالب‌بندی شود. هر GCP باید با یک آرگومان --gcp مشخص شود.
همچنین می‌توان یک آرگومان یکتای --gcp ارائه داد که مقدار آن نام فایل یک مجموعه‌داده برداری با پیشوند @ است. این مجموعه‌داده باید دارای یک لایه با فیلدهای الزامی column، line، x، y و به‌صورت اختیاری id، info و z باشد.
- --hist
- محاسبه
اطلاعات
هیستوگرام
برای تمام
باندها.
نکته:
- --color-interpretation [all|<BAND>=]<COLOR-INTERPRETATION>
- افزوده شده
در نسخه 3.13.
تنظیم تفسیر رنگ باند. می‌تواند تکرار شود.
مقدار <COLOR-INTERPRETATION> یکی از مقادیر red، green، blue، alpha، gray، undefined، pan، coastal، rededge، nir، swir، mwir یا lwir است.
چندین ساختار نوشتاری پشتیبانی می‌شوند:
- تعیین all=<COLOR-INTERPRETATION>: تنظیم تفسیر رنگ روی تمام باندها.
- تعیین به تعداد باندها <COLOR-INTERPRETATION>، از باند 1 تا آخرین باند.
- تعیین تفسیر رنگ روی زیرمجموعه‌ای از باندها با <BAND>=<COLOR-INTERPRETATION> که در آن band شماره باند با شروع از 1 است.
- --scale [<BAND>=]<SCALE>
- افزوده شده
در نسخه 3.13.
تنظیم ضریب مقیاس باند. می‌تواند تکرار شود.
چندین ساختار نوشتاری پشتیبانی می‌شوند:
- تعیین یک <SCALE> منفرد: تنظیم مقیاس روی تمام باندها.
- تعیین به تعداد باندها <SCALE>، از باند 1 تا آخرین باند.
- تعیین مقیاس روی زیرمجموعه‌ای از باندها با <BAND>=<SCALE> که در آن band شماره باند با شروع از 1 است.
- --offset [<BAND>=]<OFFSET>
- افزوده شده
در نسخه 3.13.
تنظیم ثابت آفست باند. می‌تواند تکرار شود.
چندین ساختار نوشتاری پشتیبانی می‌شوند:
- تعیین یک <OFFSET> منفرد: تنظیم آفست روی تمام باندها.
- تعیین به تعداد باندها <OFFSET>، از باند 1 تا آخرین باند.
- تعیین آفست روی زیرمجموعه‌ای از باندها با <BAND>=<OFFSET> که در آن band شماره باند با شروع از 1 است.
- --metadata <KEY>=<VALUE>
- افزودن/به‌روزرسانی آیتم متادیتا در سطح مجموعه‌داده. می‌تواند تکرار شود.
- --nodata <value>
- بازنویسی
مقدار nodata.
می‌توان از null یا none برای حذف مقدار nodata موجود استفاده کرد.
- --stats
- محاسبه آمار باندهای رستر برای تمام باندها.
- --unset-color-table
- افزوده شده
در نسخه 3.13.
حذف جدول رنگ متصل به باند اول، یا باندی که توسط --band مشخص شده است.
- --unset-metadata <KEY>
- حذف آیتم(های) متادیتا در سطح مجموعه‌داده. می‌تواند تکرار شود.
- --unset-metadata-domain <DOMAIN>
- افزوده شده
در نسخه 3.12.
حذف دامنه(های) متادیتا در سطح مجموعه‌داده. می‌تواند تکرار شود.
گزینه‌های استاندارد (STANDARD OPTIONS)
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعه‌داده
(وابسته به
فرمت).
می‌تواند تکرار شود.
کد وضعیت خروجی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق تلقی می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: بازنویسی (بدون بازتصویرسازی) CRS یک مجموعه‌داده
$ gdal raster edit --crs=EPSG:32632 my.tif
مثال ۲: بازنویسی (بدون بازتصویرسازی یا برش) کادر محدودکننده یک مجموعه‌داده
$ gdal raster edit --bbox=2,49,3,50 my.tif
مثال ۳: افزودن یک آیتم متادیتا
$ gdal raster edit --metadata AUTHOR=EvenR my.tif
مثال ۴: حذف یک آیتم متادیتا
$ gdal raster edit --unset-metadata AUTHOR my.tif
مثال ۵: افزودن ۲ نقطه کنترل زمینی (GCP) برای (column=0,line=0,X=2,Y=49) و (column=50,line=100,X=3,Y=48)
$ gdal raster edit --gcp 0,0,2,49 --gcp 50,100,3,48 my.tif
مثال ۶: افزودن نقاط کنترل زمینی (GCP) از فایل gcps.csv، که باید دارای فیلدهایی به نام‌های column، line، x و y باشد.
$ gdal raster edit --gcp @gcps.csv my.tif
مثال ۷: تنظیم تفسیر رنگ قرمز، سبز، آبی، مادون قرمز نزدیک (NIR) برای یک مجموعه‌داده ۴ بانده
$ gdal raster edit --color-interpretation red,green,blue,nir 4band.tif
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |