نام (NAME)

gdal-raster-scale - مقیاس‌بندی مقادیر باندهای یک مجموعه‌داده رستری

در نسخه 3.11 اضافه شد.

خلاصه دستور (SYNOPSIS)

Usage: gdal raster scale [OPTIONS] <INPUT> <OUTPUT>
مقیاس‌بندی مقادیر باندهای یک مجموعه‌داده رستری.
آرگومان‌های مکانی:
  -i, --input <INPUT>                                      مجموعه‌داده‌های رستری ورودی [الزامی] [در خط‌لوله‌ها در دسترس نیست]
  -o, --output <OUTPUT>                                    مجموعه‌داده رستری خروجی [الزامی] [در خط‌لوله‌ها در دسترس نیست]
گزینه‌های عمومی:
  -h, --help                                               نمایش پیام راهنما و خروج
  --json-usage                                             نمایش نحوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>                                   گزینه پیکربندی [قابل تکرار]
  -q, --quiet                                              حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>      فرمت خروجی (مقدار "GDALG" مجاز است) [در خط‌لوله‌ها در دسترس نیست]
  --co, --creation-option <KEY>=<VALUE>                    گزینه ساخت مجموعه‌داده [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست]
  --overwrite                                              تعیین اینکه آیا رونویسی مجموعه‌داده خروجی موجود مجاز است [در خط‌لوله‌ها در دسترس نیست]
                                                            ناسازگار با --append
  --append                                                 الحاق به عنوان یک زیرمجموعه‌داده به خروجی موجود [در خط‌لوله‌ها در دسترس نیست]
                                                            ناسازگار با --overwrite
  --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
  -b, --band <BAND>                                        انتخاب باند برای محدود کردن مقیاس‌بندی (شاخص با شروع از ۱)
  --input-min <INPUT-MIN>                                  حداقل مقدار محدوده منبع
                                                            وابسته به --input-max
  --input-max <INPUT-MAX>                                  حداکثر مقدار محدوده منبع
                                                            وابسته به --input-min
  --output-min <OUTPUT-MIN>                                حداقل مقدار محدوده مقصد
                                                            وابسته به --output-max
  --output-max <OUTPUT-MAX>                                حداکثر مقدار محدوده مقصد
                                                            وابسته به --output-min
  --exponent <EXPONENT>                                    نما برای اعمال مقیاس‌بندی غیرخطی با یک تابع توانی
  --no-clip                                                برش نزدن مقادیر ورودی به [input-min, input-max]
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                      فرمت‌های ورودی [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست]
  --oo, --open-option <KEY>=<VALUE>                        گزینه‌های باز کردن [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست]

توضیحات (DESCRIPTION)

دستور gdal raster scale می‌تواند برای تغییر مقیاس (rescale) مقادیر پیکسل‌های ورودی از محدوده --input-min تا --input-max به محدوده --output-min تا --output-max به کار رود. همچنین اغلب لازم است که نوع داده خروجی با سوئیچ --ot بازنشانی شود. در صورت عدم تعیین، محدوده خروجی از حداقل مقدار تا حداکثر مقدار مجاز برای انواع داده عدد صحیح (برای مثال از 0 تا 255 برای خروجی Byte) یا از 0 تا 1 برای انواع داده ممیز شناور در نظر گرفته می‌شود. در صورت عدم تعیین، محدوده ورودی به طور خودکار از مجموعه‌داده منبع محاسبه می‌شود. این ممکن است یک عملیات کند روی یک مجموعه‌داده منبع بزرگ باشد، و اگر چندین بار برای فراخوانی‌های متعدد gdal_translate استفاده شود، فراخوانی قبلی gdal raster edit --stats {source_dataset} برای پیش‌محاسبه آمارها در فرمت‌هایی که از ذخیره‌سازی محاسبات آماری پشتیبانی می‌کنند (GeoTIFF، VRT و...) می‌تواند سودمند باشد. مقادیر منبع به محدوده تعریف‌شده توسط srcmin و srcmax برش (clip) داده می‌شوند، مگر اینکه --no-clip تنظیم شده باشد.

به طور پیش‌فرض، مقیاس‌بندی روی تمامی باندها اعمال می‌شود. با استفاده از --band می‌توان آن را به یک باند منفرد محدود کرد و مقادیر سایر باندها را دست‌نخورده باقی گذاشت.

این دستور عملیات معکوس gdal raster unscale است.

این زیردستور همچنین به عنوان یک مرحله بالقوه در gdal raster pipeline در دسترس است.

خروجی GDALG (مجموعه داده برخط / استریم‌شده) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))

این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از فرمت خروجی GDALG پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه‌داده رستری با استفاده از درایور GDALG: GDAL Streamed Algorithm باز کرد و پایپ‌لاین مشخص‌شده را به صورت بلادرنگ / جریانی (on-the-fly / streamed) اعمال نمود.

گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)

-b, --band <BAND>: شاخص (با شروع از 1) باندی که مقیاس‌بندی باید تنها بر روی آن اعمال شود.

--exponent <EXPONENT>

اعمال مقیاس‌بندی غیرخطی با یک تابع توانی. exp_val نمای تابع توانی است (باید مثبت باشد). این گزینه باید همراه با گزینه‌های --input-min / --input-max / --output-min / --output-max استفاده شود.

مقدار مقیاس‌بندی‌شده Dst از مقدار منبع Src با فرمول زیر محاسبه می‌شود:

{Dst} = \left( {Dst}_{max} - {Dst}_{min} \right) \times \operatorname{max} \left( 0, \operatorname{min} \left( 1, \left( \frac{{Src} - {Src}_{min}}{{Src}_{max}-{Src}_{min}} \right)^{exp\_val} \right) \right) + {Dst}_{min}

نکته:

دستور gdal raster unscale مقیاس‌بندی خطی را فرض می‌کند و این کار نمی‌تواند مقادیر را به مقادیر اصلی بازگرداند.

--input-max <MAX>: حداکثر مقدار محدوده منبع. در صورت عدم تعیین، از مجموعه‌داده منبع محاسبه خواهد شد. این گزینه باید همراه با --input-min استفاده شود.

--input-min <MIN>: حداقل مقدار محدوده منبع. در صورت عدم تعیین، از مجموعه‌داده ورودی محاسبه خواهد شد. این گزینه باید همراه با --input-max استفاده شود.

--output-max <MAX>: حداکثر مقدار محدوده خروجی. این گزینه باید همراه با --output-min استفاده شود.

--output-min <MIN>: حداقل مقدار محدوده خروجی. این گزینه باید همراه با --output-max استفاده شود.

--no-clip: غیرفعال کردن برش مقادیر ورودی به محدوده منبع. توجه داشته باشید که استفاده از این گزینه همراه با مقیاس‌بندی غیرخطی با یک نمای غیرصحیح باعث می‌شود مقادیر ورودی کمتر از حداقل مقدار محدوده منبع به صورت مقدار تعریف‌نشده (not-a-number) نگاشت شوند.

گزینه‌های استاندارد (STANDARD OPTIONS)

--append: الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده (subdataset) جدید به فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. این گزینه همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.

--co, --creation-option <NAME>=<VALUE>

بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و تعیین کاشی‌بندی (tiled) بودن فایل پشتیبانی می‌کند.

قابل تکرار است.

گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت هستند و برخی فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات خود فرمت مرجع نهایی اطلاعات مربوط به گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر فرمت، مستندات اختصاصی Raster drivers را ببینید.

--if, --input-format <format>: نام فرمت/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی به تعیین آن نیست، اما می‌توان از آن برای صرف‌نظر از تشخیص خودکار درایور در مواقعی که درایور مناسب انتخاب نمی‌شود استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چند درایور نامزد تکرار شود. توجه داشته باشید که این گزینه درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه برخی درایورها الزامات خاصی برای پسوند فایل دارند.
قابل تکرار است.

--oo, --open-option <NAME>=<VALUE>: گزینه باز کردن مجموعه‌داده (مخصوص فرمت).
قابل تکرار است.

-f, --of, --format, --output-format <OUTPUT-FORMAT>: فرمت رستری خروجی مورد استفاده. مقادیر مجاز با اجرای دستور زیر مشخص می‌شوند: gdal --formats | grep raster | grep rw | sort

--ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>: نوع داده خروجی از میان Byte، Int8، UInt16، Int16، UInt32، Int32، UInt64، Int64، CInt16، CInt32، Float32، Float64، CFloat32 و CFloat64.

--overwrite: به برنامه اجازه می‌دهد فایل یا مجموعه‌داده هدف موجود را رونویسی کند. در غیر این صورت، به طور پیش‌فرض، در صورتی که فایل یا مجموعه‌داده هدف از قبل موجود باشد، gdal با خطا متوقف می‌شود.

کد وضعیت خروجی (RETURN STATUS CODE)

این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند).

مثال‌ها (EXAMPLES)

مثال ۱: مقیاس‌بندی خطی مقادیر یک مجموعه‌داده UInt16 از [0,4095] به یک مجموعه‌داده Byte [0,255]

$ gdal raster scale --datatype Byte --input-min 0 --input-max 4095 uint16.tif byte.tif --overwrite

نویسنده (AUTHOR)

Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)

1998-2026