.\" 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 "GDALDEM" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdaldem \- ابزارهایی برای تحلیل و مصورسازی مدل‌های رقومی ارتفاع (DEM) .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem [\-\-help] [\-\-help\-general] .EE .UNINDENT .UNINDENT .sp از هر رستر ارتفاعی پشتیبانی‌شده در GDAL: .sp تولید یک نقشه سایه‌روشن برجستگی (shaded relief): .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem hillshade [\-z ] [[\-s ] | [\-xscale \-yscale ]] [\-az ] [\-alt ] [\-alg ZevenbergenThorne] [\-combined | \-multidirectional | \-igor] [\-compute_edges] [\-b ] [\-of ] [\-co =]... [\-q] .EE .UNINDENT .UNINDENT .sp تولید یک نقشه شیب (slope map): .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem slope [\-p] [[\-s ] | [\-xscale \-yscale ]] [\-alg ZevenbergenThorne] [\-compute_edges] [\-b ] [\-of ] [\-co =]... [\-q] .EE .UNINDENT .UNINDENT .sp تولید یک نقشه جهت شیب (aspect map)، یک رستر اعشاری ۳۲ بیتی با مقادیر پیکسل بین 0 تا 360 که نشان‌دهنده آزیموت است خروجی می‌دهد: .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem aspect [\-trigonometric] [\-zero_for_flat] [\-alg ZevenbergenThorne] [\-compute_edges] [\-b ] [\-of format] [\-co =]... [\-q] .EE .UNINDENT .UNINDENT .sp تولید یک نقشه رنگی برجستگی (color relief): .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem color\-relief [\-alpha] [\-exact_color_entry | \-nearest_color_entry] [\-b ] [\-of format] [\-co =]... [\-q] که در آن color_text_file شامل خطوطی با قالب \(dqelevation_value red green blue [alpha]\(dq است. در صورت وجود ستون alpha می‌توان آن را با \(aq\-alpha\(aq فعال کرد. .EE .UNINDENT .UNINDENT .sp تولید یک نقشه شاخص ناهمواری زمین (TRI): .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem TRI input_dem output_TRI_map [\-alg Wilson|Riley] [\-compute_edges] [\-b Band (default=1)] [\-of format] [\-q] .EE .UNINDENT .UNINDENT .sp تولید یک نقشه شاخص موقعیت توپوگرافی (TPI): .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem TPI [\-compute_edges] [\-b ] [\-of ] [\-co =]... [\-q] .EE .UNINDENT .UNINDENT .sp تولید یک نقشه زبری سطح (roughness map): .INDENT 0.0 .INDENT 3.5 .sp .EX gdaldem roughness [\-compute_edges] [\-b ] [\-of ] [\-co =]... [\-q] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdaldem\fP با استفاده از الگوریتم‌های مختلف برای تحلیل عوارض زمین، رسترهای خروجی تولید می‌کند. .sp به طور کلی، این ابزار فرض می‌کند که واحدهای x و y و z یکسان هستند. با این حال، برای محاسبه سایه‌روشن (hillshade) و شیب (slope)، از نگارش GDAL 3.11 به بعد، در صورتی که هیچ‌یک از گزینه‌های \fI\%\-scale\fP، \fI\%\-xscale\fP و \fI\%\-yscale\fP مشخص نشده باشند و CRS یک CRS جغرافیایی یا تصویرشده باشد، \fBgdaldem\fP به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، اگر متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه داده‌های ورودی در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک تصویر قطبی لازم باشد. .sp برای محاسبه سایه‌روشن و شیب، اگر واحدهای x (شرق\-غرب) و y (شمال\-جنوب) یکسان باشند اما واحدهای z (ارتفاع) متفاوت باشند، می‌توان از گزینه \fI\%\-scale\fP (یا \fI\%\-xscale\fP و \fI\%\-yscale\fP) برای تنظیم نسبت واحدهای عمودی به افقی استفاده کرد. برای سیستم‌های مختصات طول و عرض جغرافیایی (LatLong) در نزدیکی خط استوا، که در آن‌ها واحدهای عرض جغرافیایی و طول جغرافیایی مشابه هستند، واحدهای ارتفاع (z) را می‌توان با استفاده از scale=370400 (اگر ارتفاع بر حسب فوت باشد) یا scale=111120 (اگر ارتفاع بر حسب متر باشد) برای سازگاری تبدیل کرد. برای مکان‌هایی که نزدیک خط استوا نیستند، بهتر است پیش از استفاده از gdaldem، شبکه رستر خود را با استفاده از gdalwarp بازتصویرسازی کنید. .INDENT 0.0 .TP .B که در آن یکی از هفت حالت موجود است: .INDENT 7.0 .IP \(bu 2 \fBhillshade\fP .INDENT 2.0 .INDENT 3.5 تولید یک نقشه سایه‌روشن برجستگی از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL. .UNINDENT .UNINDENT .IP \(bu 2 \fBslope\fP .INDENT 2.0 .INDENT 3.5 تولید یک نقشه شیب از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL. .UNINDENT .UNINDENT .IP \(bu 2 \fBaspect\fP .INDENT 2.0 .INDENT 3.5 تولید یک نقشه جهت شیب از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL. .UNINDENT .UNINDENT .IP \(bu 2 \fBcolor\-relief\fP .INDENT 2.0 .INDENT 3.5 تولید یک نقشه رنگی برجستگی از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL. .UNINDENT .UNINDENT .IP \(bu 2 \fBTRI\fP .INDENT 2.0 .INDENT 3.5 تولید یک نقشه شاخص ناهمواری زمین (Terrain Ruggedness Index) از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL. .UNINDENT .UNINDENT .IP \(bu 2 \fBTPI\fP .INDENT 2.0 .INDENT 3.5 تولید یک نقشه شاخص موقعیت توپوگرافی (Topographic Position Index) از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL. .UNINDENT .UNINDENT .IP \(bu 2 \fBroughness\fP .INDENT 2.0 .INDENT 3.5 تولید یک نقشه زبری سطح از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL. .UNINDENT .UNINDENT .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 معادل‌ها در واسط خط فرمان جدید \(dqgdal\(dq: .INDENT 0.0 .IP \(bu 2 \fI\%gdal raster aspect\fP .IP \(bu 2 \fI\%gdal raster color\-map\fP .IP \(bu 2 \fI\%gdal raster hillshade\fP .IP \(bu 2 \fI\%gdal raster slope\fP .IP \(bu 2 \fI\%gdal raster tpi\fP .IP \(bu 2 \fI\%gdal raster tri\fP .UNINDENT .UNINDENT .UNINDENT .sp گزینه‌های عمومی زیر در دسترس هستند: .INDENT 0.0 .TP .B \-\-help نمایش این پیام راهنما و خروج. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-general نمایش یک پیام کاربرد مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج. .UNINDENT .INDENT 0.0 .TP .B رستر DEM ورودی که باید پردازش شود. .UNINDENT .INDENT 0.0 .TP .B رستر خروجی تولیدشده. .UNINDENT .INDENT 0.0 .TP .B \-of انتخاب قالب خروجی. .INDENT 7.0 .INDENT 3.5 در صورت عدم تعیین، قالب از پسوند حدس زده می‌شود (قبلاً \fI\%GTiff \-\- GeoTIFF File Format\fP بود). از نام کوتاه قالب استفاده کنید. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-compute_edges انجام محاسبات در لبه‌های رستر و نزدیک مقادیر nodata. .UNINDENT .INDENT 0.0 .TP .B \-b انتخاب یک باند ورودی برای پردازش. شماره‌گذاری باندها از 1 شروع می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-co = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و تعیین اینکه آیا فایل باید تایل‌بندی شود یا خیر پشتیبانی می‌کند. .sp گزینه‌های ایجاد موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-format\fP مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet حالت بی‌صدا؛ جلوگیری از نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا. .UNINDENT .sp برای تمام الگوریتم‌ها، به جز color\-relief، اگر حداقل یک پیکسل با مقدار nodata در پنجره 3x3 متمرکز بر هر پیکسل مبدأ یافت شود، یک مقدار nodata در مجموعه داده هدف درج خواهد شد. پیامد این امر این است که یک حاشیه 1 پیکسلی در اطراف هر تصویر با مقدار nodata تنظیم می‌شود. .INDENT 0.0 .INDENT 3.5 اگر \fI\%\-compute_edges\fP مشخص شده باشد، gdaldem مقادیر را در لبه‌های تصویر یا در صورت یافتن مقدار nodata در پنجره 3x3 با میان‌یابی مقادیر گمشده محاسبه می‌کند. .UNINDENT .UNINDENT .SH "حالت‌ها (MODES)" .SS hillshade .sp این دستور یک رستر 8 بیتی با جلوه سایه‌روشن برجستگی زیبا تولید می‌کند. این ابزار برای تجسم عوارض زمین بسیار مفید است. شما می‌توانید به صورت اختیاری آزیموت و زاویه ارتفاع منبع نور، ضریب اغراق عمودی و ضریب مقیاس‌بندی را برای در نظر گرفتن تفاوت بین واحدهای عمودی و افقی مشخص کنید. .sp مقدار 0 به عنوان مقدار nodata در خروجی استفاده می‌شود. .sp گزینه‌های اختصاصی زیر در دسترس هستند: .INDENT 0.0 .TP .B \-alg Horn|ZevenbergenThorne منابع علمی نشان می‌دهند که فرمول Zevenbergen & Thorne برای مناظر هموارتر مناسب‌تر است، در حالی که فرمول Horn روی عوارض ناهموارتر عملکرد بهتری دارد. .UNINDENT .INDENT 0.0 .TP .B \-z ضریب اغراق عمودی که برای پیش‌ضرب در ارتفاعات استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-s نسبت واحدهای عمودی به واحدهای افقی. اگر واحد افقی DEM مبدأ درجه باشد (مانند تصویر Lat/Long WGS84)، در صورتی که واحدهای عمودی متر باشند می‌توانید از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400). .sp از نگارش GDAL 3.11 به بعد، اگر هیچ‌یک از گزینه‌های \fI\%\-scale\fP، \fI\%\-xscale\fP و \fI\%\-yscale\fP مشخص نشده باشند و CRS از نوع جغرافیایی یا تصویرشده باشد، \fBgdaldem\fP به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، اگر متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه داده‌های مبدأ در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک تصویر قطبی لازم باشد. .sp اثر این گزینه مشابه مشخص کردن \fI\%\-xscale\fP و \fI\%\-yscale\fP با همان مقدار \fI\%\-scale\fP است. گزینه \fI\%\-scale\fP با گزینه‌های \fI\%\-xscale\fP و \fI\%\-yscale\fP ناسازگار است. .UNINDENT .INDENT 0.0 .TP .B \-xscale افزوده‌شده در نگارش 3.11. .sp نسبت واحدهای عمودی به واحدهای افقی محور X. اگر واحد افقی DEM مبدأ درجه باشد (مانند تصویر Lat/Long WGS84)، در صورتی که واحدهای عمودی متر باشند می‌توانید از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400). .sp از نگارش GDAL 3.11 به بعد، اگر هیچ‌یک از گزینه‌های \fI\%\-scale\fP، \fI\%\-xscale\fP و \fI\%\-yscale\fP مشخص نشده باشند و CRS از نوع جغرافیایی یا تصویرشده باشد، \fBgdaldem\fP به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، اگر متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه داده‌های مبدأ در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک تصویر قطبی لازم باشد. .sp اگر \fI\%\-xscale\fP مشخص شود، \fI\%\-yscale\fP نیز باید مشخص گردد. .UNINDENT .INDENT 0.0 .TP .B \-yscale افزوده‌شده در نگارش 3.11. .sp نسبت واحدهای عمودی به واحدهای افقی محور Y. اگر واحد افقی DEM مبدأ درجه باشد (مانند تصویر Lat/Long WGS84)، در صورتی که واحدهای عمودی متر باشند می‌توانید از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400). .sp از نگارش GDAL 3.11 به بعد، اگر هیچ‌یک از گزینه‌های \fI\%\-scale\fP، \fI\%\-xscale\fP و \fI\%\-yscale\fP مشخص نشده باشند و CRS از نوع جغرافیایی یا تصویرشده باشد، \fBgdaldem\fP به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، اگر متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه داده‌های مبدأ در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک تصویر قطبی لازم باشد. .sp اگر \fI\%\-yscale\fP مشخص شود، \fI\%\-xscale\fP نیز باید مشخص گردد. .UNINDENT .INDENT 0.0 .TP .B \-az زاویه آزیموت (سمت) تابش نور بر حسب درجه. مقدار 0 بدین معنی است که نور از بالای رستر می‌تابد، 90 از شرق و... مقدار پیش‌فرض، 315، به ندرت باید تغییر داده شود زیرا مقداری است که معمولاً برای تولید نقشه‌های سایه‌روشن استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-alt زاویه ارتفاع تابش نور بر حسب درجه. مقدار 90 بدین معنی است که نور از بالای سر DEM می‌تابد و 0 یعنی نور مماس (افقی) می‌تابد. .UNINDENT .INDENT 0.0 .TP .B \-combined سایه‌زنی ترکیبی، ترکیبی از شیب و سایه‌زنی مورب (oblique shading). .UNINDENT .INDENT 0.0 .TP .B \-multidirectional سایه‌زنی چندجهته، ترکیبی از سایه‌روشن‌های تابیده‌شده از آزیموت‌های 225 درجه، 270 درجه، 315 درجه و 360 درجه. .UNINDENT .INDENT 0.0 .TP .B \-igor سایه‌زنی که تلاش می‌کند اثرات منفی روی سایر عوارض نقشه در زیر لایه را به حداقل برساند. با گزینه \-alt قابل استفاده نیست. .sp افزوده‌شده در نگارش 3.0. .UNINDENT .sp سایه‌روشن چندجهته از فرمول ارائه‌شده در \X'tty: link http://pubs.usgs.gov/of/1992/of92-422/of92-422.pdf'\fI\%http://pubs.usgs.gov/of/1992/of92\-422/of92\-422.pdf\fP\X'tty: link'\& استفاده می‌کند. .sp سایه‌روشن Igor از فرمول Maperitive \X'tty: link http://maperitive.net/docs/Commands/GenerateReliefImageIgor.html'\fI\%http://maperitive.net/docs/Commands/GenerateReliefImageIgor.html\fP\X'tty: link'\& استفاده می‌کند. .SS slope .sp این دستور یک رستر DEM را دریافت کرده و یک رستر اعشاری ۳۲ بیتی با مقادیر شیب خروجی می‌دهد. شما این امکان را دارید که نوع مقدار شیب مورد نظر خود را مشخص کنید: درجه یا درصد شیب. در مواردی که واحدهای افقی با واحدهای عمودی متفاوت هستند، می‌توانید ضریب مقیاس‌بندی را نیز مشخص کنید. .sp مقدار \fI\-9999\fP به عنوان مقدار nodata خروجی استفاده می‌شود. .sp گزینه‌های اختصاصی زیر در دسترس هستند: .INDENT 0.0 .TP .B \-alg Horn|ZevenbergenThorne منابع علمی نشان می‌دهند که فرمول Zevenbergen & Thorne برای مناظر هموارتر مناسب‌تر است، در حالی که فرمول Horn روی عوارض ناهموارتر عملکرد بهتری دارد. .UNINDENT .INDENT 0.0 .TP .B \-p در صورت مشخص شدن، شیب بر حسب درصد بیان می‌شود. در غیر این صورت، بر حسب درجه محاسبه می‌گردد. .UNINDENT .INDENT 0.0 .TP .B \-s نسبت واحدهای عمودی به واحدهای افقی. اگر واحد افقی DEM مبدأ درجه باشد (مانند تصویر Lat/Long WGS84)، در صورتی که واحدهای عمودی متر باشند می‌توانید از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400). .sp از نگارش GDAL 3.11 به بعد، اگر هیچ‌یک از گزینه‌های \fI\%\-scale\fP، \fI\%\-xscale\fP و \fI\%\-yscale\fP مشخص نشده باشند و CRS از نوع جغرافیایی یا تصویرشده باشد، \fBgdaldem\fP به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، اگر متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه داده‌های مبدأ در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک تصویر قطبی لازم باشد. .sp اثر این گزینه مشابه مشخص کردن \fI\%\-xscale\fP و \fI\%\-yscale\fP با همان مقدار \fI\%\-scale\fP است. گزینه \fI\%\-scale\fP با گزینه‌های \fI\%\-xscale\fP و \fI\%\-yscale\fP ناسازگار است. .UNINDENT .INDENT 0.0 .TP .B \-xscale افزوده‌شده در نگارش 3.11. .sp نسبت واحدهای عمودی به واحدهای افقی محور X. اگر واحد افقی DEM مبدأ درجه باشد (مانند تصویر Lat/Long WGS84)، در صورتی که واحدهای عمودی متر باشند می‌توانید از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400). .sp از نگارش GDAL 3.11 به بعد، اگر هیچ‌یک از گزینه‌های \fI\%\-scale\fP، \fI\%\-xscale\fP و \fI\%\-yscale\fP مشخص نشده باشند و CRS از نوع جغرافیایی یا تصویرشده باشد، \fBgdaldem\fP به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، اگر متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه داده‌های مبدأ در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک تصویر قطبی لازم باشد. .sp اگر \fI\%\-xscale\fP مشخص شود، \fI\%\-yscale\fP نیز باید مشخص گردد. .UNINDENT .INDENT 0.0 .TP .B \-yscale افزوده‌شده در نگارش 3.11. .sp نسبت واحدهای عمودی به واحدهای افقی محور Y. اگر واحد افقی DEM مبدأ درجه باشد (مانند تصویر Lat/Long WGS84)، در صورتی که واحدهای عمودی متر باشند می‌توانید از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400). .sp از نگارش GDAL 3.11 به بعد، اگر هیچ‌یک از گزینه‌های \fI\%\-scale\fP، \fI\%\-xscale\fP و \fI\%\-yscale\fP مشخص نشده باشند و CRS از نوع جغرافیایی یا تصویرشده باشد، \fBgdaldem\fP به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، اگر متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه داده‌های مبدأ در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک تصویر قطبی لازم باشد. .sp اگر \fI\%\-yscale\fP مشخص شود، \fI\%\-xscale\fP نیز باید مشخص گردد. .UNINDENT .SS aspect .sp این دستور یک رستر اعشاری ۳۲ بیتی با مقادیری بین 0° تا 360° خروجی می‌دهد که نشان‌دهنده جهت (آزیموت) شیب‌ها است. تعریف آزیموت به این صورت است: 0° بدین معنی است که شیب رو به شمال است، 90° رو به شرق، 180° رو به جنوب و 270° رو به غرب (به شرطی که بالای رستر ورودی شما رو به شمال باشد). مقدار جهت شیب \-9999 به عنوان مقدار nodata برای نشان دادن جهت شیب تعریف‌نشده در مناطق مسطح با شیب صفر استفاده می‌شود. .sp گزینه‌های اختصاصی زیر در دسترس هستند: .INDENT 0.0 .TP .B \-alg Horn|ZevenbergenThorne منابع علمی نشان می‌دهند که فرمول Zevenbergen & Thorne برای مناظر هموارتر مناسب‌تر است، در حالی که فرمول Horn روی عوارض ناهموارتر عملکرد بهتری دارد. .UNINDENT .INDENT 0.0 .TP .B \-trigonometric بازگرداندن زاویه مثلثاتی به جای آزیموت. بنابراین 0° یعنی شرق، 90° شمال، 180° غرب و 270° جنوب. .UNINDENT .INDENT 0.0 .TP .B \-zero_for_flat بازگرداندن مقدار 0 برای مناطق مسطح با شیب صفر، به جای \-9999. .UNINDENT .sp با استفاده از این 2 گزینه، جهت شیب بازگردانده‌شده توسط gdaldem aspect با مقدار r.slope.aspect در سامانه GRASS یکسان خواهد بود. در غیر این صورت، با ابزار \fBaspect.cpp\fP اثر Matthew Perry یکسان است. .SS color\-relief .sp این دستور یک رستر ۳ بانده (RGB) یا ۴ بانده (RGBA) با مقادیری که از ارتفاع و یک فایل پیکربندی متنی رنگ محاسبه می‌شوند خروجی می‌دهد؛ این فایل حاوی نگاشت بین مقادیر مختلف ارتفاع و رنگ مورد نظر متناظر است. به طور پیش‌فرض، رنگ‌های بین مقادیر ارتفاع داده‌شده به آرامی ترکیب می‌شوند و نتیجه یک DEM رنگ‌آمیزی‌شده زیبا است. گزینه‌های \-exact_color_entry یا \-nearest_color_entry را می‌توان برای جلوگیری از میان‌یابی خطی برای مقادیری که با هیچ نمایه‌ای از فایل پیکربندی رنگ مطابقت ندارند استفاده کرد. .sp گزینه‌های اختصاصی زیر در دسترس هستند: .INDENT 0.0 .TP .B color_text_file فایل متنی پیکربندی رنگ. .UNINDENT .INDENT 0.0 .TP .B \-alpha افزودن یک کانال آلفا به رستر خروجی. .UNINDENT .INDENT 0.0 .TP .B \-exact_color_entry استفاده از تطابق دقیق هنگام جستجو در فایل پیکربندی رنگ. اگر هیچ ورودی رنگ منطبقی یافت نشود، از مقدار چهارتایی RGBA به صورت \(dq0,0,0,0\(dq استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-nearest_color_entry استفاده از مقدار چهارتایی RGBA متناظر با نزدیک‌ترین ورودی در فایل پیکربندی رنگ. .UNINDENT .sp حالت color\-relief تنها حالتی است که از VRT به عنوان قالب خروجی پشتیبانی می‌کند. در این حالت، فایل پیکربندی رنگ به عناصر مناسب جدول تطبیق رنگ (LUT) تبدیل می‌شود. توجه داشته باشید که ارتفاع‌های مشخص‌شده به صورت درصد به مقادیر مطلق ترجمه می‌شوند، که در صورت تفاوت آماری رستر مبدأ با آنچه در ساخت VRT استفاده شده است، باید مد نظر قرار گیرد. .sp فایل متنی پیکربندی رنگ عموماً شامل ۴ ستون در هر خط است: مقدار ارتفاع و مؤلفه‌های متناظر قرمز، سبز و آبی (بین 0 تا 255). مقدار ارتفاع می‌تواند هر عدد اعشاری، یا کلمه کلیدی nv برای مقدار nodata باشد. ارتفاع همچنین می‌تواند به صورت درصد بیان شود: 0% کمترین مقدار موجود در رستر و 100% بیشترین مقدار است. .sp جداکننده‌های مختلف فیلد پذیرفته می‌شوند: کاما، تب (tab)، فاصله و \(aq:\(aq. .sp رنگ‌های متداول مورد استفاده در GRASS را می‌توان به جای سه‌تایی RGB، با نام آن‌ها نیز مشخص کرد. فهرست پشتیبانی‌شده عبارت است از: white, black, red, green, blue, yellow, magenta, cyan, aqua, grey/gray, orange, brown, purple/violet و indigo. .INDENT 0.0 .INDENT 3.5 فایل‌های پالت GMT \fB\&.cpt\fP نیز پشتیبانی می‌شوند (فقط COLOR_MODEL = RGB). .UNINDENT .UNINDENT .sp نکته: ساختار دستوری فایل پیکربندی رنگ برگرفته از ساختار پشتیبانی‌شده توسط ابزار r.colors در GRASS است. فایل‌های جدول رنگ HDR شرکت ESRI با پسوند (.clr) نیز با این ساختار مطابقت دارند. مؤلفه آلفا و پشتیبانی از tab و کاما به عنوان جداکننده، گسترش‌های اختصاصی GDAL هستند. .sp برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX 3500 white 2500 235:220:175 50% 190 185 135 700 240 250 150 0 50 180 50 nv 0 0 0 0 .EE .UNINDENT .UNINDENT .sp برای پیاده‌سازی یک حالت گرد کردن به پایین، مقدار ارتفاع را می‌توان با مقداری جدید که کمی بالاتر از آستانه است تکرار کرد. برای نمونه برای داشتن قرمز در [0,10]، سبز در ]10,20] و آبی در ]20,30]: .INDENT 0.0 .INDENT 3.5 .sp .EX 0 red 10 red 10.001 green 20 green 20.001 blue 30 blue .EE .UNINDENT .UNINDENT .SS TRI .sp این دستور یک رستر تک‌بانده با مقادیر محاسبه‌شده از ارتفاع خروجی می‌دهد. \fITRI\fP مخفف شاخص ناهمواری زمین (Terrain Ruggedness Index) است که تفاوت بین یک پیکسل مرکزی و سلول‌های اطراف آن را اندازه‌گیری می‌کند. .sp مقدار \-9999 به عنوان مقدار nodata خروجی استفاده می‌شود. .sp گزینه زیر در دسترس است: .INDENT 0.0 .TP .B \-alg Wilson|Riley از نگارش GDAL 3.3 به بعد، الگوریتم Riley (رجوع کنید به 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) در دسترس بوده و مقدار پیش‌فرض جدید است. این الگوریتم از جذر مجموع مربعات اختلاف بین یک پیکسل مرکزی و سلول‌های اطراف آن استفاده می‌کند. این گزینه برای سناریوهای خشکی پیشنهاد می‌شود. .sp الگوریتم Wilson (رجوع کنید به Wilson et al 2007, Marine Geodesy 30:3\-35) از میانگین اختلاف بین یک پیکسل مرکزی و سلول‌های پیرامون آن استفاده می‌کند. این گزینه برای سناریوهای ژرفاسنجی پیشنهاد می‌شود. .UNINDENT .SS TPI .sp این دستور یک رستر تک‌بانده با مقادیر محاسبه‌شده از ارتفاع خروجی می‌دهد. \fITPI\fP مخفف شاخص موقعیت توپوگرافی (Topographic Position Index) است که به عنوان تفاوت بین یک پیکسل مرکزی و میانگین سلول‌های پیرامون آن تعریف می‌شود (رجوع کنید به Wilson et al 2007, Marine Geodesy 30:3\-35). .sp مقدار \-9999 به عنوان مقدار nodata خروجی استفاده می‌شود. .sp هیچ گزینه اختصاصی ندارد. .SS roughness .sp این دستور یک رستر تک‌بانده با مقادیر محاسبه‌شده از ارتفاع خروجی می‌دهد. زبری سطح (Roughness) بزرگ‌ترین اختلاف بین‌سلولی یک پیکسل مرکزی و سلول‌های پیرامون آن است، طبق تعریف Wilson et al (2007, Marine Geodesy 30:3\-35). .sp مقدار \-9999 به عنوان مقدار nodata خروجی استفاده می‌شود. .sp هیچ گزینه اختصاصی ندارد. .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "واسط برنامه‌نویسی C (C API)" .sp این ابزار از طریق C نیز با تابع \fI\%GDALDEMProcessing()\fP قابل فراخوانی است. .SH "نویسندگان (AUTHORS)" .sp Matthew Perry \X'tty: link mailto:perrygeo@gmail.com'\fI\%perrygeo@gmail.com\fP\X'tty: link', Even Rouault \X'tty: link mailto:even.rouault@spatialys.com'\fI\%even.rouault@spatialys.com\fP\X'tty: link', Howard Butler \X'tty: link mailto:hobu.inc@gmail.com'\fI\%hobu.inc@gmail.com\fP\X'tty: link', Chris Yesson \X'tty: link mailto:chris.yesson@ioz.ac.uk'\fI\%chris.yesson@ioz.ac.uk\fP\X'tty: link' .sp برگرفته از کدهای نوشته‌شده توسط Michael Shapiro, Olga Waupotitsch, Marjorie Larson, Jim Westervelt: U.S. Army CERL, 1993. GRASS 4.1 Reference Manual. U.S. Army Corps of Engineers, Construction Engineering Research Laboratories, Champaign, Illinois, 1\-425. .SH "همچنین ببینید (SEE ALSO)" .sp مستندات ابزارهای مرتبط در GRASS: .sp \X'tty: link https://grass.osgeo.org/grass84/manuals/r.slope.aspect.html'\fI\%https://grass.osgeo.org/grass84/manuals/r.slope.aspect.html\fP\X'tty: link' .sp \X'tty: link https://grass.osgeo.org/grass84/manuals/r.relief.html'\fI\%https://grass.osgeo.org/grass84/manuals/r.relief.html\fP\X'tty: link' .sp \X'tty: link https://grass.osgeo.org/grass84/manuals/r.colors.html'\fI\%https://grass.osgeo.org/grass84/manuals/r.colors.html\fP\X'tty: link' .SH "نویسنده (AUTHOR)" Matthew Perry , Even Rouault , Howard Butler , Chris Yesson .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .