GDAL-RASTER-CONVERT(1) GDAL GDAL-RASTER-CONVERT(1)

gdal-raster-convert - تبدیل یک مجموعه‌داده رستر

در نگارش 3.11 اضافه شد.

Usage: gdal raster convert [OPTIONS] <INPUT> <OUTPUT>
Convert 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
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 convert می‌توان برای تبدیل داده‌های رَستِر (شطرنجی) بین فرمت‌های مختلف استفاده کرد.

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

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

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

نام فرمت/درایور که باید برای باز کردن فایل(های) ورودی امتحان شود. عموماً تعیین آن ضروری نیست، اما می‌تواند برای صرف‌نظر از تشخیص خودکار درایور، در هنگامی که در انتخاب درایور مناسب ناموفق است، استفاده شود. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را به باز کردن مجموعه‌داده مجبور نمی‌کند. به‌ویژه، برخی از درایورها الزاماتی برای پسوند فایل دارند.

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

گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت).

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

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

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

$ gdal raster convert --format=COG --co COMPRESS=JPEG utm.tif utm_cog.tif

$ gdal raster convert utm.tif utm.gpkg

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026