GDAL-RASTER-TPI(1)                   GDAL                   GDAL-RASTER-TPI(1)

نام (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)

       -b, --band <BAND>
              اندیس باندی (با شروع از ۱) که TPI باید برای آن محاسبه شود.

       --no-edges
              تلاش نکردن برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک
              مقادیر nodata.

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

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

       --co, --creation-option <NAME>=<VALUE>
              بسیاری از فرمت‌ها یک یا چند گزینه اختیاری ایجاد (creation option)
              دارند که می‌توان برای کنترل ویژگی‌های مربوط به فایل ایجادشده از
              آن‌ها استفاده کرد. برای مثال، درایور GeoTIFF از گزینه‌های ایجاد
              برای کنترل فشرده‌سازی و اینکه آیا فایل به صورت موزاییکی (tiled)
              باشد پشتیبانی می‌کند.

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

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

       --if, --input-format <format>
              نام فرمت/درایور برای تلاش جهت باز کردن فایل (یا فایل‌های) ورودی.
              معمولاً نیازی به تعیین آن نیست، اما می‌تواند برای رد کردن تشخیص
              خودکار درایور هنگام عدم موفقیت در انتخاب درایور مناسب استفاده
              شود.  این گزینه می‌تواند چندین بار برای مشخص کردن چندین درایور
              نامزد تکرار شود.  توجه داشته باشید که این کار آن درایورها را
              مجبور به باز کردن مجموعه داده نمی‌کند؛ به‌ویژه برخی درایورها
              نیازمندی‌هایی روی پسوند فایل دارند.

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

       --oo, --open-option <NAME>=<VALUE>
              گزینه باز کردن مجموعه داده (مختص به فرمت).

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

       -f, --of, --format, --output-format <OUTPUT-FORMAT>
              فرمت رستری خروجی مورد استفاده. مقادیر مجاز با اجرای دستور زیر
              قابل مشاهده است: gdal --formats | grep raster | grep rw | sort

       --overwrite
              اجازه دادن به برنامه برای بازنویسی روی فایل یا مجموعه داده مقصدِ
              موجود.  در غیر این صورت، به صورت پیش‌فرض اگر فایل یا مجموعه داده
              مقصد از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

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

مثال‌ها (EXAMPLES)
   مثال ۱: تولید یک نقشه شاخص موقعیت توپوگرافی (TPI) از یک فایل DTED0

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

نویسندگان (AUTHORS)
       Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)
       1998-2026

                                August 18, 2026             GDAL-RASTER-TPI(1)