.\" 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-TRI" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-tri \- تولید نقشه شاخص ناهمواری زمین (TRI)
.sp
در نسخه 3.11 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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 (\(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)
  \-\-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]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster tri\fP یک رستر تک‌باند با مقادیر محاسبه‌شده از ارتفاع تولید می‌کند.
TRI مخفف Terrain Ruggedness Index (شاخص ناهمواری زمین) است که تفاوت بین یک پیکسل مرکزی و سلول‌های اطراف آن را می‌سنجد.
.sp
این زیردستور همچنین به عنوان یک مرحله بالقوه از \fI\%gdal raster pipeline\fP در دسترس است.
.sp
مقدار \-9999 به عنوان مقدار nodata استفاده می‌شود.
.sp
اگر حداقل یک پیکسل با مقدار nodata در پنجره 3x3 متمرکز بر هر پیکسل مبدأ یافت شود، یک مقدار nodata نیز در مجموعه‌داده مقصد صادر خواهد شد.
به‌طور پیش‌فرض، الگوریتم مقادیر را در لبه‌های تصویر یا در صورت یافتن مقدار nodata در پنجره 3x3، با درون‌یابی مقادیر ناموجود محاسبه می‌کند؛ مگر اینکه \fI\%\-\-no\-edges\fP مشخص شده باشد، که در این صورت یک حاشیه ۱ پیکسلی در اطراف تصویر با مقدار nodata تنظیم می‌شود.
.SH "خروجی GDALG (مجموعه‌داده در لحظه / جاری) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))"
.sp
این برنامه از سریالی‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند.
سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه‌داده رستر باز شود و خط لوله (pipeline) مشخص‌شده را به صورت بلادرنگ / جاری (streamed) اعمال کند.
.SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-algorithm Riley|Wilson
انتخاب الگوریتم مورد استفاده:
.INDENT 7.0
.IP \(bu 2
\fBRiley\fP، حالت پیش‌فرض، از جذر مجموع مربعات اختلاف بین یک پیکسل مرکزی و سلول‌های اطراف آن استفاده می‌کند.
این روش برای کاربردهای خشکی و عوارض زمینی توصیه می‌شود.
این الگوریتم بر اساس منبع زیر پیاده‌سازی شده است:
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
.IP \(bu 2
\fBWilson\fP از میانگین اختلاف بین یک پیکسل مرکزی و سلول‌های اطراف آن استفاده می‌کند.
این روش برای کاربردهای ژرفاسنجی (bathymetric) توصیه می‌شود.
این الگوریتم بر اساس منبع زیر پیاده‌سازی شده است:
Wilson et al. 2007, Marine Geodesy 30:3\-35.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-b, \-\-band <BAND>
اندیس باندی (شروع از ۱) که TRI باید برای آن محاسبه شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-edges
تلاشی برای درون‌یابی مقادیر در لبه‌های مجموعه‌داده یا نزدیک به مقادیر nodata انجام ندهد.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-append
الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به یک فایل خروجی موجود.
تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند
\fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP.
همچنین اگر مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای نمونه، درایور 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 "وضعیت خروج (EXIT STATUS)"
.sp
برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: تولید نقشه شاخص ناهمواری زمین (TRI) از یک فایل DTED0.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster tri 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.
.