| GDAL-RASTER-WRITE(1) | GDAL | GDAL-RASTER-WRITE(1) |
نام (NAME)
gdal-raster-write - نوشتن یک مجموعهداده رستر (فقط در پایپلاین)
افزودهشده در نگارش 3.11.
توضیحات (DESCRIPTION)
عملیات write فقط برای استفاده در یک gdal pipeline است و یک مجموعهداده رستر را مینویسد. این آخرین مرحله از یک پایپلاین است.
برای نوشتن یک مجموعهداده موقت در میانهٔ یک پایپلاین، از gdal raster materialize استفاده کنید.
خلاصه دستور (SYNOPSIS)
* write [OPTIONS] <OUTPUT>
--------------------------
نوشتن یک مجموعهداده رستر.
آرگومانهای موقعیتی:
-o, --output <OUTPUT> مجموعهداده رستر خروجی [الزامی]
گزینهها:
-f, --of, --format, --output-format <OUTPUT-FORMAT> قالب خروجی ("GDALG" مجاز است)
--co, --creation-option <KEY>=<VALUE> گزینه ساخت [امکان تکرار دارد]
--overwrite تعیین اینکه آیا بازنویسی مجموعهداده خروجی موجود مجاز است یا خیر
مانعةالجمع با --append
--append الحاق به عنوان زیرمجموعهداده به خروجی موجود
مانعةالجمع با --overwrite
گزینههای استاندارد (STANDARD OPTIONS)
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- قالب رستر خروجی برای استفاده را مشخص میکند. مقادیر مجاز را میتوان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
قالبها یک
یا چند
گزینه ساخت
اختیاری
دارند که
میتوان از
آنها برای
کنترل
جزئیات
فایل
ایجادشده
استفاده
کرد. برای
نمونه،
درایور GeoTIFF از
گزینههای
ساختی برای
کنترل
فشردهسازی
و اینکه
آیا فایل
باید
کاشیکاریشده
(tiled) باشد یا
خیر،
پشتیبانی
میکند.
میتواند تکرار شود.
گزینههای ساخت موجود بسته به درایور قالب متفاوت است و برخی قالبهای ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینههای پشتیبانیشده برای یک قالب را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات قالب، مرجع قطعی اطلاعات درباره گزینههای ساخت درایور است. برای گزینههای ساخت مجاز هر قالب، مستندات اختصاصی قالب Raster drivers را ببینید.
- --overwrite
- به برنامه اجازه میدهد فایل یا مجموعهداده مقصد موجود را بازنویسی کند. در غیر این صورت، بهطور پیشفرض، اگر فایل یا مجموعهداده مقصد از قبل وجود داشته باشد، gdal با خطا متوقف میشود.
- --append
- رستر ورودی را به عنوان یک زیرمجموعهداده جدید به فایل خروجی موجود الحاق میکند. فقط با درایورهایی کار میکند که از افزودن زیرمجموعهداده پشتیبانی میکنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. این گزینه همچنین مجموعهداده خروجی را در صورتی که هنوز وجود نداشته باشد، ایجاد میکند.
مثالها (EXAMPLES)
مثال ۱: نوشتن یک فایل GeoTIFF
$ gdal raster pipeline ... [other commands here] ... ! write out.tif --overwrite
نویسندگان (AUTHORS)
Even Rouault <even.rouault@spatialys.com>
کپیرایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |