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

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

تولید نقشه شیب

آرگومان‌های موضعی (Positional arguments):
  \-i, \-\-input <INPUT>                                  مجموعه‌داده‌های رستری ورودی [الزامی] [در خطوط لوله در دسترس نیست]
  \-o, \-\-output <OUTPUT>                                مجموعه‌داده رستری خروجی [الزامی] [در خطوط لوله در دسترس نیست]

گزینه‌های عمومی (Common Options):
  \-h, \-\-help                                           نمایش پیام راهنما و خروج
  \-\-json\-usage                                         نمایش نحوه استفاده به صورت سند JSON و خروج
  \-\-config <KEY>=<VALUE>                               گزینه پیکربندی [تکرارپذیر]
  \-q, \-\-quiet                                          حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست]

گزینه‌ها (Options):
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  قالب خروجی (مجاز بودن \(dqGDALG\(dq) [در خطوط لوله در دسترس نیست]
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-overwrite                                          آیا بازنویسی روی مجموعه‌داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
                                                       ناسازگار با \-\-append
  \-\-append                                             الحاق به عنوان یک زیرمجموعه‌داده به خروجی موجود [در خطوط لوله در دسترس نیست]
                                                       ناسازگار با \-\-overwrite
  \-b, \-\-band <BAND>                                    باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: ۱)
  \-\-unit <UNIT>                                        واحد بیان شیب. UNIT=degree|percent (پیش‌فرض: degree)
  \-\-xscale <XSCALE>                                    نسبت واحدهای عمودی به واحدهای افقی محور X
  \-\-yscale <YSCALE>                                    نسبت واحدهای عمودی به واحدهای افقی محور Y
  \-\-gradient\-alg <GRADIENT\-ALG>                        الگوریتم مورد استفاده برای محاسبه گرادیان زمین. GRADIENT\-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn)
  \-\-no\-edges                                           تلاش نکردن برای میان‌یابی مقادیر در لبه‌های مجموعه‌داده یا نزدیک مقادیر nodata

گزینه‌های پیشرفته (Advanced Options):
  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster slope\fP یک نقشه شیب از هر
رستر ارتفاعی (DEM) پشتیبانی‌شده توسط GDAL تولید می‌کند.
.sp
این زیردستور همچنین به عنوان یک مرحله بالقوه از \fI\%gdal raster pipeline\fP در دسترس است.
.sp
این دستور یک رستر ممیز شناور ۳۲ بیتی (32-bit float) با مقادیر شیب تولید می‌کند. شما این امکان را دارید
که نوع مقدار شیب مورد نظر خود را تعیین کنید: درجه (degrees) یا درصد (percent slope). در مواردی
که واحدهای افقی با واحدهای عمودی تفاوت دارند، می‌توانید ضرایب مقیاس‌بندی را نیز
جهت لحاظ کردن تفاوت میان واحدهای عمودی و افقی ارائه دهید.
.sp
مقدار \fI\-9999\fP به عنوان مقدار nodata خروجی استفاده می‌شود. یک مقدار nodata در مجموعه‌داده مقصد
زمانی تولید خواهد شد که حداقل یک پیکسل تنظیم‌شده روی مقدار nodata در
پنجره ۳×۳ پیرامون هر پیکسل منبع یافت شود. به‌طور پیش‌فرض، الگوریتم مقادیر را
در لبه‌های تصویر یا در صورت یافتن یک مقدار nodata در پنجره ۳×۳، از طریق
میان‌یابی مقادیر گمشده محاسبه می‌کند، مگر اینکه \fI\%\-\-no\-edges\fP مشخص شده باشد،
که در این صورت یک حاشیه با ضخامت ۱ پیکسل در اطراف تصویر با مقدار nodata تنظیم خواهد شد.
.sp
به‌طور کلی، فرض بر این است که واحدهای x، y و z یکسان هستند. با این حال، اگر هیچ‌یک از
\fI\%\-\-xscale\fP و \fI\%\-\-yscale\fP مشخص نشده باشند و CRS یک
CRS جغرافیایی یا تصویرشده باشد، نسبت مناسب را به‌طور خودکار
بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط
\fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، در صورتی که
متر، فوت بین‌المللی یا فوت نقشه‌برداری ایالات متحده باشد) تعیین خواهد کرد. توجه داشته باشید که برای CRS جغرافیایی،
نتیجه برای مجموعه‌داده‌های منبع در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و نیاز به
بازتصویرسازی پیشین به یک تصویر قطبی با استفاده از \fI\%gdal raster reproject\fP باشد.
.sp
اگر واحدهای x (شرقی-غربی) و y (شمالی-جنوبی) یکسان باشند، اما واحدهای z (ارتفاع)
متفاوت باشند، می‌توان از \fI\%\-\-xscale\fP و \fI\%\-\-yscale\fP برای تنظیم
نسبت واحدهای عمودی به افقی استفاده کرد.
برای CRS جغرافیایی در نزدیکی استوا، که در آن واحدهای عرض و طول جغرافیایی
مشابه هستند، واحدهای ارتفاع (z) را می‌توان با استفاده از scale=370400 (اگر ارتفاع بر حسب فوت باشد)
یا scale=111120 (اگر ارتفاع بر حسب متر باشد) برای سازگاری تبدیل کرد. برای مناطقی که در نزدیکی استوا
نیستند، مقدار \fI\%\-\-xscale\fP را می‌توان برابر با مقدار \fI\%\-\-yscale\fP ضرب در کسینوس میانگین
عرض جغرافیایی رستر در نظر گرفت.
.SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی)"
.sp
این برنامه از سریالی‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند.
سپس فایل حاصل می‌تواند به عنوان یک مجموعه‌داده رستری با استفاده از درایور
\fI\%GDALG: GDAL Streamed Algorithm\fP باز شود و خط لوله تعیین‌شده را به صورت در لحظه /
جریانی اعمال کند.
.SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-b, \-\-band <BAND>
شاخص (با شروع از ۱) باندی که شیب باید برای آن محاسبه شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-gradient\-alg Horn|ZevenbergenThorne
الگوریتم مورد استفاده برای محاسبه گرادیان زمین. پیش‌فرض \fBHorn\fP است.
ادبیات علمی پیشنهاد می‌کند که روش Zevenbergen & Thorne برای مناظر هموارتر
مناسب‌تر است، در حالی که فرمول Horn عملکرد بهتری در زمین‌های ناهموارتر دارد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-edges
تلاش نکردن برای میان‌یابی مقادیر در لبه‌های مجموعه‌داده یا در نزدیکی مقادیر nodata.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-unit degree|percent
واحد بیان مقادیر شیب. پیش‌فرض \fBdegree\fP (درجه) است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-xscale <scale>
نسبت واحدهای عمودی به واحدهای افقی محور X. اگر واحد افقی DEM منبع درجه باشد (مانند تصویر Lat/Long WGS84)، می‌توانید در صورتی که واحدهای عمودی متر باشند از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400).
.sp
اگر هیچ‌یک از گزینه‌های \fI\%\-\-xscale\fP و \fI\%\-\-yscale\fP مشخص نشده باشند، و
CRS یک CRS جغرافیایی یا تصویرشده باشد،
دستور \fBgdal raster slope\fP نسبت مناسب را به‌طور خودکار بر اساس
واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط
\fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، در صورتی که
متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین خواهد کرد. توجه داشته باشید که برای CRS جغرافیایی،
نتیجه برای مجموعه‌داده‌های منبع در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و نیاز به
بازتصویرسازی پیشین به یک تصویر قطبی باشد.
.sp
اگر \fI\%\-\-xscale\fP مشخص شود، \fI\%\-\-yscale\fP نیز باید مشخص گردد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-yscale <scale>
نسبت واحدهای عمودی به واحدهای افقی محور Y. اگر واحد افقی DEM منبع درجه باشد (مانند تصویر Lat/Long WGS84)، می‌توانید در صورتی که واحدهای عمودی متر باشند از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400).
.sp
اگر هیچ‌یک از گزینه‌های \fI\%\-\-xscale\fP و \fI\%\-\-yscale\fP مشخص نشده باشند، و
CRS یک CRS جغرافیایی یا تصویرشده باشد،
دستور \fBgdal raster slope\fP نسبت مناسب را به‌طور خودکار بر اساس
واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط
\fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، در صورتی که
متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین خواهد کرد. توجه داشته باشید که برای CRS جغرافیایی،
نتیجه برای مجموعه‌داده‌های منبع در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و نیاز به
بازتصویرسازی پیشین به یک تصویر قطبی باشد.
.sp
اگر \fI\%\-\-yscale\fP مشخص شود، \fI\%\-\-xscale\fP نیز باید مشخص گردد.
.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 از گزینه‌های ایجاد برای کنترل فشرده‌سازی و
کاشی‌بندی شدن فایل پشتیبانی می‌کند.
.sp
تکرارپذیر است.
.sp
گزینه‌های ایجاد در دسترس بر اساس درایور قالب متغیر است و برخی
قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های
پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات قالب، مرجع نهایی
اطلاعات درباره گزینه‌های ایجاد درایور است.
برای مشاهده گزینه‌های ایجاد مجاز برای هر قالب، به مستندات مختص به قالب در
\fI\%Raster drivers\fP
مراجعه کنید.
.sp
تکرارپذیر است.
.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 مثال ۱: تولید نقشه شیب از یک فایل DTED0
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster slope n43.dt0 out.tif \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.