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        GDAL-RASTER-SET-TYPE(1)