GDAL-RASTER-SET-TYPE(1) GDAL GDAL-RASTER-SET-TYPE(1)

gdal-raster-set-type - تغییر نوع داده باندهای یک مجموعه داده رستر

افزوده شده در نسخه 3.11.

Usage: gdal raster set-type [OPTIONS] <INPUT> <OUTPUT>
Modify the data type of bands of a raster dataset.
Positional arguments:
  -i, --input <INPUT>                                      Input raster datasets [required] [not available in pipelines]
  -o, --output <OUTPUT>                                    Output raster dataset [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:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>      Output format ("GDALG" allowed) [not available in pipelines]
  --co, --creation-option <KEY>=<VALUE>                    Creation option [may be repeated] [not available in pipelines]
  --overwrite                                              Whether overwriting existing output dataset is allowed [not available in pipelines]
                                                           Mutually exclusive with --append
  --append                                                 Append as a subdataset to existing output [not available in pipelines]
                                                           Mutually exclusive with --overwrite
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  Output data type. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 [required]
Advanced Options:
  --if, --input-format <INPUT-FORMAT>                      Input formats [may be repeated] [not available in pipelines]
  --oo, --open-option <KEY>=<VALUE>                        Open options [may be repeated] [not available in pipelines]

دستور gdal raster set-type می‌تواند برای اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص استفاده شود. اگر نوع داده خروجی "کوچک‌تر" از نوع داده ورودی باشد، مقادیر ممکن است کوتاه (truncate) یا گرد شوند.

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

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

نوع داده خروجی از میان Byte, Int8, UInt16, Int16, UInt32, Int32, UInt64, Int64, CInt16, CInt32, Float32, Float64, CFloat32, CFloat64.

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

می‌تواند تکرار شود.

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

کدام فرمت رستر خروجی استفاده شود. مقادیر مجاز را می‌توان از طریق دستور زیر به دست آورد:
gdal --formats | grep raster | grep rw | sort
به برنامه اجازه می‌دهد فایل یا مجموعه داده مقصد موجود را بازنویسی کند. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، gdal خطا می‌دهد.

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

$ gdal raster set-type --datatype Float32 byte.tif float32.tif --overwrite

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026