نام (NAME)

gdal-raster-tpi - تولید نقشه شاخص موقعیت توپوگرافی (TPI)

افزوده شده در نسخه 3.11.

خلاصه دستور (SYNOPSIS)

Usage: gdal raster tpi [OPTIONS] <INPUT> <OUTPUT>
Generate a Topographic Position Index (TPI) 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]

توضیحات (DESCRIPTION)

دستور gdal raster tpi یک رستر تک‌باندی با مقادیر محاسبه‌شده از روی داده‌های ارتفاعی تولید می‌کند. شاخص TPI مخفف Topographic Position Index (شاخص موقعیت توپوگرافی) است که به صورت اختلاف میان یک پیکسل مرکزی و میانگین سلول‌های پیرامون آن تعریف می‌شود (ببینید Wilson et al 2007, Marine Geodesy 30:3-35).

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

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

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

خروجی GDALG (مجموعه داده جریانی / برخط)

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

گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)

گزینه‌های استاندارد (STANDARD OPTIONS)

کد وضعیت بازگشتی (RETURN STATUS CODE)

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

مثال‌ها (EXAMPLES)

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

نویسندگان (AUTHORS)

Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)

1998-2026