| GDAL-RASTER-SET-TYPE(1) | GDAL | GDAL-RASTER-SET-TYPE(1) |
نام (NAME)
gdal-raster-set-type - تغییر نوع داده باندهای یک مجموعه داده رستر
افزوده شده در نسخه 3.11.
خلاصه دستور (SYNOPSIS)
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]
توضیحات (DESCRIPTION)
دستور gdal raster set-type میتواند برای اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص استفاده شود. اگر نوع داده خروجی "کوچکتر" از نوع داده ورودی باشد، مقادیر ممکن است کوتاه (truncate) یا گرد شوند.
این زیردستور همچنین به عنوان یک مرحله بالقوه از gdal raster pipeline در دسترس است.
خروجی GDALG (مجموعه داده در لحظه / جریانی)
این برنامه از سریالسازی خط فرمان به عنوان یک فایل JSON با استفاده از فرمت خروجی GDALG پشتیبانی میکند. فایل حاصل را میتوان سپس به عنوان یک مجموعه داده رستر با استفاده از درایور GDALG: GDAL Streamed Algorithm باز کرد و خط لوله مشخصشده را به صورت در لحظه (on-the-fly) / جریانی اعمال نمود.
گزینههای اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)
- --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>
- نوع داده خروجی از میان Byte, Int8, UInt16, Int16, UInt32, Int32, UInt64, Int64, CInt16, CInt32, Float32, Float64, CFloat32, CFloat64.
گزینههای استاندارد (STANDARD OPTIONS)
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
فرمتها
دارای یک یا
چند گزینه
ساخت
اختیاری
هستند که
میتوانند
برای کنترل
جزئیات
فایل
ایجادشده
استفاده
شوند. به
عنوان
مثال،
درایور GeoTIFF از
گزینههای
ساخت برای
کنترل
فشردهسازی
و
کاشیبندی
(tiled) بودن فایل
پشتیبانی
میکند.
میتواند تکرار شود.
گزینههای ساخت در دسترس بسته به درایور فرمت متفاوت هستند و برخی از فرمتهای ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینههای پشتیبانیشده برای یک فرمت را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان فرمت مرجع اصلی اطلاعات درباره گزینههای ساخت درایور است. برای مشاهده گزینههای ساخت مجاز برای هر فرمت، مستندات اختصاصی Raster drivers را ببینید.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- کدام فرمت
رستر خروجی
استفاده
شود. مقادیر
مجاز را
میتوان از
طریق دستور
زیر به دست
آورد:
gdal --formats | grep raster | grep rw | sort
- --overwrite
- به برنامه اجازه میدهد فایل یا مجموعه داده مقصد موجود را بازنویسی کند. در غیر این صورت، به طور پیشفرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، gdal خطا میدهد.
کد وضعیت خروجی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر برمیگرداند (خطاهای غیر مسدودکننده که به عنوان هشدار صادر میشوند به عنوان اجرای موفق در نظر گرفته میشوند).
مثالها (EXAMPLES)
مثال ۱: تبدیل به نوع داده Float32
$ gdal raster set-type --datatype Float32 byte.tif float32.tif --overwrite
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |