GDAL-RASTER-TRI(1) GDAL GDAL-RASTER-TRI(1)

gdal-raster-tri - تولید نقشه شاخص ناهمواری زمین (TRI)

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

Usage: gdal raster tri [OPTIONS] <INPUT> <OUTPUT>
Generate a Terrain Ruggedness Index (TRI) 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)
  --algorithm <ALGORITHM>                              Algorithm to compute TRI. ALGORITHM=Riley|Wilson (default: Riley)
  --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 tri یک رستر تک‌باند با مقادیر محاسبه‌شده از ارتفاع تولید می‌کند. TRI مخفف Terrain Ruggedness Index (شاخص ناهمواری زمین) است که تفاوت بین یک پیکسل مرکزی و سلول‌های اطراف آن را می‌سنجد.

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

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

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

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

انتخاب الگوریتم مورد استفاده:
  • Riley، حالت پیش‌فرض، از جذر مجموع مربعات اختلاف بین یک پیکسل مرکزی و سلول‌های اطراف آن استفاده می‌کند. این روش برای کاربردهای خشکی و عوارض زمینی توصیه می‌شود. این الگوریتم بر اساس منبع زیر پیاده‌سازی شده است: Riley, S.J., De Gloria, S.D., Elliot, R. (1999): A Terrain Ruggedness that Quantifies Topographic Heterogeneity. Intermountain Journal of Science, Vol.5, No.1-4, pp.23-27
  • Wilson از میانگین اختلاف بین یک پیکسل مرکزی و سلول‌های اطراف آن استفاده می‌کند. این روش برای کاربردهای ژرفاسنجی (bathymetric) توصیه می‌شود. این الگوریتم بر اساس منبع زیر پیاده‌سازی شده است: Wilson et al. 2007, Marine Geodesy 30:3-35.
اندیس باندی (شروع از ۱) که TRI باید برای آن محاسبه شود.
تلاشی برای درون‌یابی مقادیر در لبه‌های مجموعه‌داده یا نزدیک به مقادیر nodata انجام ندهد.

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

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

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

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

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

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

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

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

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

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

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026