.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-RASTER-TPI" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-tpi \- تولید نقشه شاخص موقعیت توپوگرافی (TPI)
.sp
افزوده شده در نسخه 3.11.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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 (\(dqGDALG\(dq 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]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster tpi\fP یک رستر تک‌باندی با مقادیر محاسبه‌شده از روی داده‌های ارتفاعی تولید می‌کند. شاخص TPI مخفف Topographic Position Index (شاخص موقعیت توپوگرافی) است که به صورت اختلاف میان یک پیکسل مرکزی و میانگین سلول‌های پیرامون آن تعریف می‌شود (ببینید Wilson et al 2007, Marine Geodesy 30:3\-35).
.sp
این زیردستور همچنین به عنوان یک مرحله بالقوه در \fI\%gdal raster pipeline\fP در دسترس است.
.sp
مقدار \-9999 به عنوان مقدار داده نامعتبر (nodata) استفاده می‌شود.
.sp
همچنین اگر حداقل یک پیکسل با مقدار nodata در پنجره 3x3 متمرکز بر هر پیکسل منبع یافت شود، در مجموعه داده هدف یک مقدار nodata تولید خواهد شد. به طور پیش‌فرض، الگوریتم با درون‌یابی مقادیر از دست رفته، مقادیر را در لبه‌های تصویر یا در صورت یافتن مقدار nodata در پنجره 3x3 محاسبه می‌کند؛ مگر اینکه \fI\%\-\-no\-edges\fP مشخص شده باشد که در این صورت یک حاشیه ۱ پیکسلی در اطراف تصویر با مقدار nodata تنظیم خواهد شد.
.SH "خروجی GDALG (مجموعه داده جریانی / برخط)"
.sp
این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از فرمت خروجی \fBGDALG\fP پشتیبانی می‌کند.
سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه داده رستری باز شده و خط لوله (pipeline) مشخص‌شده را به صورت برخط و جریانی اعمال کند.
.SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-b, \-\-band <BAND>
اندیس باندی (با شروع از ۱) که TPI باید برای آن محاسبه شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-edges
تلاش نکردن برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر nodata.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-append
الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده (subdataset) جدید به یک فایل خروجی موجود.
تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند؛ مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP.
همچنین اگر مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از فرمت‌ها یک یا چند گزینه اختیاری ایجاد (creation option) دارند که می‌توان برای کنترل ویژگی‌های مربوط به فایل ایجادشده از آن‌ها استفاده کرد. برای مثال، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و اینکه آیا فایل به صورت موزاییکی (tiled) باشد پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ایجادِ در دسترس، بسته به درایور فرمت متفاوت هستند و برخی از فرمت‌های ساده اصلاً گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان فرمت، منبع معتبر و نهایی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر فرمت، به مستندات اختصاصی فرمت در \fI\%Raster drivers\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
نام فرمت/درایور برای تلاش جهت باز کردن فایل (یا فایل‌های) ورودی. معمولاً نیازی به تعیین آن نیست، اما می‌تواند برای رد کردن تشخیص خودکار درایور هنگام عدم موفقیت در انتخاب درایور مناسب استفاده شود.
این گزینه می‌تواند چندین بار برای مشخص کردن چندین درایور نامزد تکرار شود.
توجه داشته باشید که این کار آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند؛ به‌ویژه برخی درایورها نیازمندی‌هایی روی پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه داده (مختص به فرمت).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
فرمت رستری خروجی مورد استفاده. مقادیر مجاز با اجرای دستور زیر قابل مشاهده است:
\fBgdal \-\-formats | grep raster | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
اجازه دادن به برنامه برای بازنویسی روی فایل یا مجموعه داده مقصدِ موجود.
در غیر این صورت، به صورت پیش‌فرض اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود.
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار اعلام می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: تولید یک نقشه شاخص موقعیت توپوگرافی (TPI) از یک فایل DTED0"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster tpi n43.dt0 out.tif \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.