.\" 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-HILLSHADE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-hillshade \- تولید نقشه برجسته‌نما (سایه‌روشن) .sp افزوده‌شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal raster hillshade [OPTIONS] تولید یک نقشه برجسته‌نما (سایه‌روشن) آرگومان‌های موقعیتی: \-i, \-\-input مجموعه‌داده‌های رستر ورودی [الزامی] [در خط‌لوله‌ها در دسترس نیست] \-o, \-\-output مجموعه‌داده رستر خروجی [الزامی] [در خط‌لوله‌ها در دسترس نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده در قالب یک سند JSON و خروج \-\-config = گزینه پیکربندی [می‌تواند تکرار شود] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خط‌لوله‌ها در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ساخت [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-overwrite آیا رونویسی مجموعه‌داده خروجی موجود مجاز است [در خط‌لوله‌ها در دسترس نیست] ناسازگار با \-\-append \-\-append الحاق به عنوان یک زیرمجموعه‌داده به خروجی موجود [در خط‌لوله‌ها در دسترس نیست] ناسازگار با \-\-overwrite \-b, \-\-band باند ورودی (شاخص مبتنی بر ۱) (پیش‌فرض: 1) \-z, \-\-zfactor بزرگ‌نمایی عمودی برای پیش‌ضرب در مقادیر ارتفاع \-\-xscale نسبت واحدهای عمودی به واحدهای افقی محور X \-\-yscale نسبت واحدهای عمودی به واحدهای افقی محور Y \-\-azimuth زاویه سمت (آزیموت) نور به درجه (پیش‌فرض: 315) \-\-altitude زاویه ارتفاع نور به درجه (پیش‌فرض: 45) \-\-gradient\-alg الگوریتم مورد استفاده برای محاسبه گرادیان زمین. GRADIENT\-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn) \-\-variant گونه الگوریتم سایه‌روشن. VARIANT=regular|combined|multidirectional|Igor (پیش‌فرض: regular) \-\-no\-edges عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه‌داده یا نزدیک به مقادیر nodata گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster hillshade\fP از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL، یک نقشه برجسته‌نما (سایه‌روشن) تولید می‌کند. .sp این زیردستور همچنین به عنوان یک مرحله بالقوه در \fI\%gdal raster pipeline\fP در دسترس است. .sp این دستور یک رستر ۸ بیتی با جلوه سایه‌روشن برجستگی زیبا ایجاد می‌کند. این ابزار برای بصری‌سازی عوارض زمین بسیار مفید است. شما می‌توانید به صورت اختیاری زاویه سمت و زاویه ارتفاع منبع نور، ضریب بزرگ‌نمایی عمودی، و ضرایب مقیاس‌بندی را برای لحاظ کردن تفاوت بین واحدهای عمودی و افقی مشخص کنید. .sp مقدار 0 به عنوان مقدار nodata خروجی استفاده می‌شود. اگر حداقل یک پیکسل با مقدار nodata در پنجره 3x3 متمرکز بر هر پیکسل مبدأ یافت شود، یک مقدار nodata در مجموعه‌داده مقصد صادر خواهد شد. به طور پیش‌فرض، الگوریتم با درون‌یابی مقادیر ناموجود، مقادیر را در لبه‌های تصویر یا در صورت یافت شدن یک مقدار nodata در پنجره 3x3 محاسبه می‌کند، مگر اینکه \fI\%\-\-no\-edges\fP مشخص شده باشد؛ در این حالت یک حاشیه به ضخامت ۱ پیکسل در اطراف تصویر با مقدار nodata تنظیم خواهد شد. .sp به طور کلی، فرض بر این است که واحدهای x، y و z یکسان هستند. با این حال، اگر هیچ‌کدام از \fI\%\-\-xscale\fP و \fI\%\-\-yscale\fP مشخص نشده باشند، و سامانه مرجع مختصات (CRS) یک CRS جغرافیایی یا تصویرشده باشد، به طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (آن‌طور که توسط \fI\%GDALRasterBand::GetUnitType()\fP برگردانده می‌شود، در صورتی که metre،‏ foot international یا US survey foot باشد) تعیین می‌کند. توجه داشته باشید که برای 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 (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس می‌توان فایل حاصل را به عنوان یک مجموعه‌داده رَستری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط‌لوله (pipeline) مشخص‌شده را به صورت در لحظه / جریانی اعمال نمود. .SH "گزینه‌های ویژه‌ی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-altitude ارتفاع زاویه‌ای تابش نور بر حسب درجه. مقدار ۹۰ برای نوری که مستقیم از بالای DEM می‌تابد، و ۰ در صورت تابش مایل افقی. مقدار پیش‌فرض ۴۵ درجه است. .sp این گزینه با \fB\-\-variant=Igor\fP\& مانعة‌الجمع است و نمی‌توانند هم‌زمان استفاده شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-azimuth سمت (آزیموت) تابش نور بر حسب درجه. مقدار ۰ برای تابش از بالای رَستر، ۹۰ از شرق، و... مقدار پیش‌فرض ۳۱۵ است که به‌ندرت نیاز به تغییر دارد، زیرا مقداری است که معمولاً برای تولید نقشه‌های سایه‌روشن به‌کار می‌رود. .sp این گزینه با \fB\-\-variant=multidirectional\fP\& مانعة‌الجمع است. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-band اندیس باندی (شروع از ۱) که سایه‌روشن (hillshade) باید برای آن محاسبه شود. .UNINDENT .INDENT 0.0 .TP .B \-\-gradient\-alg Horn|ZevenbergenThorne الگوریتم مورد استفاده برای محاسبه گرادیان ناهمواری. مقدار پیش‌فرض \fBHorn\fP\& است. مطالعات نشان می‌دهند که فرمول Zevenbergen & Thorne برای چشم‌اندازهای هموارتر مناسب‌تر است، در حالی که فرمول Horn\(aq عملکرد بهتری روی ناهمواری‌های خشن‌تر دارد. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-edges برای درون‌یابی مقادیر در لبه‌های مجموعه‌داده یا در نزدیکی مقادیر nodata تلاشی نکن. .UNINDENT .INDENT 0.0 .TP .B \-\-variant regular|combined|multidirectional|Igor گونه‌ی الگوریتم سایه‌روشن (hillshade): .INDENT 7.0 .IP \(bu 2 \fBregular\fP: مقادیر سایه‌روشن، شیب محاسبه‌شده را با سمت و ارتفاع زاویه‌ای تابش بر اساس فرمول زیر ترکیب می‌کند: .INDENT 2.0 .INDENT 3.5 .sp .ce {Hillshade} = 1 + 254.0 * ((\esin(altitude) * cos(slope)) + (cos(altitude) * sin(slope) * cos(azimuth \- \efrac{\epi}{2} \- aspect))) .ce 0 .UNINDENT .UNINDENT .IP \(bu 2 \fBcombined\fP: سایه‌زنی ترکیبی؛ ترکیبی از شیب و سایه‌زنی مایل. .IP \(bu 2 \fBmultidirectional\fP: سایه‌زنی چندجهته؛ ترکیبی از سایه‌روشن ناشی از تابش از سمت‌های ۲۲۵ درجه، ۲۷۰ درجه، ۳۱۵ درجه و ۳۶۰ درجه. فرمول این مرجع را اعمال می‌کند: \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' .IP \(bu 2 \fBIgor\fP: سایه‌زنی که تلاش می‌کند اثرات منفی روی سایر عوارض نقشه در لایه‌های زیرین را به حداقل برساند. سایه‌روشن Igor\(aq از فرمول Maperitive استفاده می‌کند: \X'tty: link http://maperitive.net/docs/Commands/GenerateReliefImageIgor.html'\fI\%http://maperitive.net/docs/Commands/GenerateReliefImageIgor.html\fP\X'tty: link' .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-xscale در نسخه 3.11 اضافه شد. .sp نسبت واحدهای عمودی به واحدهای افقی محور X. اگر واحد افقی DEM مبدأ درجه باشد (مانند سیستم تصویر Lat/Long WGS84)، در صورتی که واحدهای عمودی متر باشند می‌توانید از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400). .sp اگر هیچ‌یک از گزینه‌های \fI\%\-\-xscale\fP و \fI\%\-\-yscale\fP مشخص نشده باشند و CRS یک CRS جغرافیایی یا تصویرشده باشد، دستور \fBgdal raster hillshade\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 اگر هیچ‌یک از گزینه‌های \fI\%\-\-xscale\fP و \fI\%\-\-yscale\fP مشخص نشده باشند و CRS یک CRS جغرافیایی یا تصویرشده باشد، دستور \fBgdal raster hillshade\fP به‌طور خودکار نسبت مناسب را بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رَستر (که توسط \fI\%GDALRasterBand::GetUnitType()\fP بازگردانده می‌شود، در صورتی که متر، فوت بین‌المللی یا فوت نقشه‌برداری ایالات متحده باشد) تعیین می‌کند. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه‌داده‌های مبدأ در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و ممکن است بازتصویرسازی پیشین به یک سیستم تصویر قطبی لازم باشد. .sp اگر \fI\%\-\-yscale\fP مشخص شود، \fI\%\-\-xscale\fP نیز باید مشخص گردد. .UNINDENT .INDENT 0.0 .TP .B \-z, \-\-zfactor ضریب بزرگ‌نمایی عمودی که برای پیش‌ضرب در مقادیر ارتفاعی استفاده می‌شود. .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 = بسیاری از فرمت‌ها یک یا چند گزینه اختیاری ساخت دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل (tiled) پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت است و برخی از فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به فرمت، مرجع اصلی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر فرمت، مستندات اختصاصی هر فرمت را در \fI\%Raster drivers\fP ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام فرمت/درایور برای باز کردن فایل(های) ورودی. معمولاً تعیین آن ضروری نیست، اما در مواردی که شناسایی خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌تواند برای نادیده گرفتن تشخیص خودکار استفاده شود. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را به باز کردن مجموعه‌داده وادار نمی‌کند. به‌ویژه، برخی از درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-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 با استفاده از ضریب اغراق عمودی 30. .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster hillshade \-\-zfactor=30 n43.dt0 out.tif \-\-overwrite .EE .UNINDENT .UNINDENT .SS مثال ۲: ترکیب خروجی نقشه برجسته‌نمایی سایه‌روشن و رندرینگ هایپسومتریک بر روی یک DEM برای ایجاد نقشه برجسته‌نمایی سایه‌روشن رنگی. .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal pipeline read n43.tif ! \e color\-map \-\-color\-map color_file.txt ! \e blend \-\-operator=hsv\-value \-\-overlay \e [ read n43.tif ! hillshade \-z 30 ] ! \e write out.tif \-\-overwrite .EE .UNINDENT .UNINDENT.SH "نویسنده (AUTHOR)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .