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

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal raster roughness [OPTIONS] <INPUT> <OUTPUT>

Generate a roughness 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 roughness\fP یک رستر تک‌بانده با مقادیری که از روی ارتفاع (elevation) محاسبه می‌شوند تولید می‌کند. زبری (Roughness) بزرگ‌ترین اختلاف بین‌سلولی میان یک پیکسل مرکزی و سلول‌های اطراف آن است، همان‌گونه که در ویلسون و همکاران (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 به عنوان یک مجموعه‌داده رستر باز کرد و پایپ‌لاین مشخص‌شده را به صورت در لحظه (on\-the\-fly) / جریانی (streamed) اِعمال نمود.
.SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-b, \-\-band <BAND>
اندیس باندی (شروع از ۱) که زبری باید برای آن محاسبه شود.
.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 "وضعیت خروج (EXIT STATUS)"
.sp
برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به شکل هشدار ارسال می‌شوند، یک اجرای موفقیت‌آمیز تلقی می‌گردند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: تولید یک نقشه زبری از یک فایل DTED0.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster roughness 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.
.