نام (NAME)

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

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

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

کاربرد: gdal raster unscale [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
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                      قالب‌های ورودی [تکرارپذیر] [در خط‌لوله موجود نیست]
  --oo, --open-option <KEY>=<VALUE>                        گزینه‌های باز کردن [تکرارپذیر] [در خط‌لوله موجود نیست]

توضیحات (DESCRIPTION)

دستور gdal raster unscale فراداده‌های scale/offset باندها را اعمال می‌کند تا مقادیر مقیاس‌بندی‌شده را به مقادیر بدون مقیاس تبدیل کند.

اگر نوع داده باند ورودی Byte، Int8، UInt16، Int16، UInt32، Int32، Int64، UInt64، Float16 یا Float32 باشد، نوع داده خروجی پیش‌فرض Float32 خواهد بود. اگر نوع داده باند ورودی Float64 باشد، به عنوان نوع داده خروجی پیش‌فرض حفظ خواهد شد. اگر نوع داده باند ورودی CInt16، CFloat16 یا CFloat32 باشد، نوع داده خروجی پیش‌فرض Float32 خواهد بود. اگر نوع داده باند ورودی CFloat64 باشد، به عنوان نوع داده خروجی پیش‌فرض حفظ خواهد شد.

مقدار بدون مقیاس با استفاده از رابطه زیر از مقدار خام مقیاس‌بندی‌شده محاسبه می‌شود:

{unscaled\_value} = {scaled\_value} * {scale} + {offset}

اگر یکی از باندهای ورودی فاقد فراداده scale/offset باشد، مقادیر آن دست‌نخورده باقی می‌مانند.

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

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

خروجی GDALG (مجموعه‌داده در لحظه / جریانی - ON-THE-FLY / STREAMED DATASET)

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

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

--append: الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به یک فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند؛ مانند 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>: گزینه باز کردن مجموعه‌داده (مختص قالب).
می‌تواند تکرار شود.

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

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

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

وضعیت خروج (EXIT STATUS)

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

مثال‌ها (EXAMPLES)

مثال ۱: تبدیل یک رستر مقیاس‌بندی‌شده به رستری بدون مقیاس از نوع Float32

$ gdal raster unscale scaled_byte.tif unscaled_float32.tif --overwrite

نویسندگان (AUTHORS)

Even Rouault <even.rouault@spatialys.com>

کپی‌رایت و تکثیر (COPYRIGHT)

1998-2026