| GDAL-RASTER-CONVERT(1) | GDAL | GDAL-RASTER-CONVERT(1) |
نام (NAME)
gdal-raster-convert - تبدیل یک مجموعهداده رستر
در نگارش 3.11 اضافه شد.
خلاصه دستور (SYNOPSIS)
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]
توضیحات (DESCRIPTION)
از gdal raster convert میتوان برای تبدیل دادههای رَستِر (شطرنجی) بین فرمتهای مختلف استفاده کرد.
گزینههای استاندارد (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>
- گزینه باز
کردن
مجموعهداده
(مخصوص هر
فرمت).
میتواند تکرار شود.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- تعیین اینکه کدام فرمت رستر خروجی استفاده شود. مقادیر مجاز را میتوان با دستور زیر مشاهده کرد: gdal --formats | grep raster | grep rw | sort
- --overwrite
- اجازه دادن به برنامه برای بازنویسی روی فایل یا مجموعهداده هدف موجود. در غیر این صورت، بهطور پیشفرض، اگر فایل یا مجموعهداده هدف از قبل وجود داشته باشد، gdal با خطا متوقف میشود.
- -q, --quiet
- غیرفعال کردن نوار پیشرفت و برخی پیامهای هشدار.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر را برمیگرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر میشوند به عنوان اجرای موفقیتآمیز در نظر گرفته میشوند).
مثالها (EXAMPLES)
مثال ۱: تبدیل فایل utm.tif به یک GeoTIFF بهینهشده برای ابر با استفاده از فشردهسازی JPEG
$ gdal raster convert --format=COG --co COMPRESS=JPEG utm.tif utm_cog.tif
مثال ۲: تبدیل فایل utm.tif به رستر GeoPackage
$ gdal raster convert utm.tif utm.gpkg
نویسندگان (AUTHORS)
Even Rouault <even.rouault@spatialys.com>
کپیرایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |