GDAL-RASTER-WRITE(1) GDAL GDAL-RASTER-WRITE(1)

gdal-raster-write - نوشتن یک مجموعه‌داده رستر (فقط در پایپ‌لاین)

افزوده‌شده در نگارش 3.11.

عملیات write فقط برای استفاده در یک gdal pipeline است و یک مجموعه‌داده رستر را می‌نویسد. این آخرین مرحله از یک پایپ‌لاین است.

برای نوشتن یک مجموعه‌داده موقت در میانهٔ یک پایپ‌لاین، از gdal raster materialize استفاده کنید.

* write [OPTIONS] <OUTPUT>
--------------------------
نوشتن یک مجموعه‌داده رستر.
آرگومان‌های موقعیتی:
  -o, --output <OUTPUT>                                مجموعه‌داده رستر خروجی [الزامی]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی ("GDALG" مجاز است)
  --co, --creation-option <KEY>=<VALUE>                گزینه ساخت [امکان تکرار دارد]
  --overwrite                                          تعیین این‌که آیا بازنویسی مجموعه‌داده خروجی موجود مجاز است یا خیر
                                                       مانعة‌الجمع با --append
  --append                                             الحاق به عنوان زیرمجموعه‌داده به خروجی موجود
                                                       مانعة‌الجمع با --overwrite

قالب رستر خروجی برای استفاده را مشخص می‌کند. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort
بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساختی برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌کاری‌شده (tiled) باشد یا خیر، پشتیبانی می‌کند.

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

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

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

$ gdal raster pipeline ... [other commands here] ... ! write out.tif --overwrite

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026