GDAL-RASTER-ROUGHNESS(1) GDAL GDAL-RASTER-ROUGHNESS(1)

gdal-raster-roughness - تولید نقشه زبری

در نسخه 3.11 اضافه شد.

Usage: gdal raster roughness [OPTIONS] <INPUT> <OUTPUT>
Generate a roughness map
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
  -b, --band <BAND>                                    Input band (1-based index) (default: 1)
  --no-edges                                           Do not try to interpolate values at dataset edges or close to nodata values
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 roughness یک رستر تک‌بانده با مقادیری که از روی ارتفاع (elevation) محاسبه می‌شوند تولید می‌کند. زبری (Roughness) بزرگ‌ترین اختلاف بین‌سلولی میان یک پیکسل مرکزی و سلول‌های اطراف آن است، همان‌گونه که در ویلسون و همکاران (2007, Marine Geodesy 30:3-35) تعریف شده است.

این زیردستور همچنین به عنوان یک مرحله بالقوه در gdal raster pipeline در دسترس است.

مقدار زبری -9999 به عنوان مقدار nodata استفاده می‌شود.

همچنین اگر دست‌کم یک پیکسل با مقدار nodata در پنجره 3x3 در اطراف هر پیکسل مبدأ یافت شود، یک مقدار nodata در مجموعه‌داده هدف درج خواهد شد. به‌طور پیش‌فرض، الگوریتم مقادیر را در لبه‌های تصویر یا در صورت یافتن مقدار nodata در پنجره 3x3، با درون‌یابی مقادیر مفقود محاسبه می‌کند؛ مگر اینکه گزینه --no-edges مشخص شده باشد که در این صورت یک حاشیه با ضخامت ۱ پیکسل در اطراف تصویر با مقدار nodata پر خواهد شد.

این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. فایل حاصل را می‌توان سپس با استفاده از درایور GDALG: GDAL Streamed Algorithm به عنوان یک مجموعه‌داده رستر باز کرد و پایپ‌لاین مشخص‌شده را به صورت در لحظه (on-the-fly) / جریانی (streamed) اِعمال نمود.

اندیس باندی (شروع از ۱) که زبری باید برای آن محاسبه شود.
برای درون‌یابی مقادیر در لبه‌های مجموعه‌داده یا در نزدیکی مقادیر nodata تلاشی صورت نگیرد.

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

ممکن است تکرار شود.

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

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

ممکن است تکرار شود.

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

ممکن است تکرار شود.

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

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

$ gdal raster roughness n43.dt0 out.tif --overwrite

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026