نام (NAME)

gdal-raster-aspect - تولید نقشه جهت شیب (Aspect map)

افزوده‌شده در نگارش 3.11.

خلاصه دستور (SYNOPSIS)

کاربرد: gdal raster aspect [گزینه‌ها] <INPUT> <OUTPUT>
تولید نقشه جهت شیب
آرگومان‌های موضعی:
  -i, --input <INPUT>                                  مجموعه داده‌های رستر ورودی [الزامی] [در خطوط لوله در دسترس نیست]
  -o, --output <OUTPUT>                                مجموعه داده رستر خروجی [الزامی] [در خطوط لوله در دسترس نیست]
گزینه‌های عمومی:
  -h, --help                                           نمایش پیام راهنما و خروج
  --json-usage                                         نمایش شیوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>                               گزینه پیکربندی [تکرارپذیر]
  -q, --quiet                                          حالت بی‌صدا (عدم نمایش نوار پیشرفت یا پیام‌های هشدار) [در خطوط لوله در دسترس نیست]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی (مقدار "GDALG" مجاز است) [در خطوط لوله در دسترس نیست]
  --co, --creation-option <KEY>=<VALUE>                گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  --overwrite                                          آیا رونویسی روی مجموعه داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
                                                       ناسازگار با --append
  --append                                             افزودن به عنوان زیرمجموعه‌داده به خروجی موجود [در خطوط لوله در دسترس نیست]
                                                       ناسازگار با --overwrite
  -b, --band <BAND>                                    باند ورودی (اندیس مبتنی بر 1) (پیش‌فرض: 1)
  --convention <CONVENTION>                            قرارداد برای زاویه‌های خروجی. CONVENTION=azimuth|trigonometric-angle (پیش‌فرض: azimuth)
  --gradient-alg <GRADIENT-ALG>                        الگوریتم مورداستفاده برای محاسبه گرادیان عوارض زمین. GRADIENT-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn)
  --zero-for-flat                                      تعیین اینکه آیا برای مناطق مسطح مقدار صفر خروجی داده شود
  --no-edges                                           عدم تلاش برای میان‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک به مقادیر nodata
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  --oo, --open-option <KEY>=<VALUE>                    گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]

توضیحات (DESCRIPTION)

دستور gdal raster aspect یک نقشه جهت شیب را از هر رستر ارتفاعی پشتیبانی‌شده توسط GDAL تولید می‌کند.

این زیردستور همچنین به عنوان یک مرحله بالقوه از gdal raster pipeline در دسترس است.

این ابزار یک رستر اعشاری ۳۲ بیتی (32-bit float) با مقادیری بین 0° تا 360° تولید می‌کند که سمت (azimuth) شیب‌ها را نشان می‌دهد. تعریف آزیموت به این صورت است: - 0° بدین معنی است که شیب رو به شمال است، - 90° رو به شرق است، - 180° رو به جنوب است، - و 270° رو به غرب است (به شرطی که بالای رستر ورودی شما رو به شمال باشد).

مقدار جهت شیب -9999 به عنوان مقدار nodata برای نشان دادن جهت شیب تعریف‌نشده در مناطق مسطح با شیب 0 استفاده می‌شود.

همچنین اگر حداقل یک پیکسل با مقدار nodata در پنجره 3x3 متمرکز بر هر پیکسل مبدأ یافت شود، یک مقدار nodata در مجموعه داده هدف ثبت خواهد شد. به طور پیش‌فرض، الگوریتم مقادیر را در لبه‌های تصویر یا در صورت یافتن مقدار nodata در پنجره 3x3 با میان‌یابی مقادیر گمشده محاسبه می‌کند، مگر اینکه --no-edges مشخص شده باشد که در آن صورت یک حاشیه 1 پیکسلی در اطراف تصویر با مقدار nodata تنظیم می‌شود.

خروجی GDALG (مجموعه داده درجا / جریانی)

این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. فایل حاصل می‌تواند با استفاده از درایور GDALG: GDAL Streamed Algorithm به عنوان یک مجموعه داده رستر باز شود و خط لوله مشخص‌شده را به صورت درجا (on-the-fly) یا جریانی (streamed) اعمال کند.

گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)

-b, --band <BAND>: اندیس باند (شروع از 1) که جهت شیب باید برای آن محاسبه شود.

--convention azimuth|trigonometric-angle

قرارداد برای زاویه‌های خروجی.

پیش‌فرض azimuth است، یعنی: - 0° بدین معنی است که شیب رو به شمال است، - 90° رو به شرق است، - 180° رو به جنوب است، - و 270° رو به غرب است (به شرطی که بالای رستر ورودی شما رو به شمال باشد).

اگر روی trigonometric-angle تنظیم شود: - 0° بدین معنی است که شیب رو به شرق است، - 90° رو به شمال است، - 180° رو به غرب است، - و 270° رو به جنوب است.

--gradient-alg Horn|ZevenbergenThorne: الگوریتم مورد استفاده برای محاسبه گرادیان عوارض زمین. مقدار پیش‌فرض Horn است. منابع علمی نشان می‌دهند که فرمول Zevenbergen & Thorne برای مناطق هموارتر و طبیعی مناسب‌تر است، در حالی که فرمول Horn روی عوارض ناهموارتر و خشن‌تر عملکرد بهتری دارد.

--no-edges: عدم تلاش برای میان‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک به مقادیر nodata.

--zero-for-flat: تعیین اینکه آیا برای مناطق مسطح مقدار صفر خروجی داده شود یا خیر. به طور پیش‌فرض، به مناطق مسطحی که شیب آن‌ها صفر است یک مقدار nodata (-9999) اختصاص داده می‌شود. با تنظیم این گزینه، این مناطق روی 0 تنظیم می‌شوند.

گزینه‌های استاندارد (STANDARD OPTIONS)

--append: الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به فایل خروجی موجود. فقط با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده پشتیبانی می‌کنند، مانند GTiff -- GeoTIFF File Format و GPKG -- GeoPackage raster. این گزینه همچنین در صورتی که مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.

--co, --creation-option <NAME>=<VALUE>

بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و تعیین اینکه آیا فایل باید تایل‌بندی شود یا خیر پشتیبانی می‌کند.

می‌تواند تکرار شود.

گزینه‌های ایجاد موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان قالب مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در Raster drivers مراجعه کنید.

--if, --input-format <format>: نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن آن نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور در مواردی که در انتخاب درایور مناسب ناموفق است استفاده کرد. این گزینه می‌تواند چندین بار تکرار شود تا چند درایور نامزد مشخص گردند. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی درایورها نیازمندی‌هایی درباره پسوند فایل دارند.
می‌تواند تکرار شود.

--oo, --open-option <NAME>=<VALUE>: گزینه باز کردن مجموعه داده (مختص هر قالب).
می‌تواند تکرار شود.

-f, --of, --format, --output-format <OUTPUT-FORMAT>: تعیین قالب رستر خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep raster | grep rw | sort

--overwrite: اجازه دادن به برنامه برای رونویسی روی فایل یا مجموعه داده مقصد موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه داده مقصد از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

کد وضعیت بازگشتی (RETURN STATUS CODE)

برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).

مثال‌ها (EXAMPLES)

مثال ۱: تولید یک نقشه جهت شیب از یک فایل DTED0.

$ gdal raster aspect n43.dt0 out.tif --overwrite

نویسندگان (AUTHORS)

Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)

1998-2026