نام (NAME)

gdal-raster-slope - تولید نقشه شیب (Slope Map)

در نسخه 3.11 اضافه شد.

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

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>  قالب خروجی (مجاز بودن "GDALG") [در خطوط لوله در دسترس نیست]
  --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>                    گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]

توضیحات (DESCRIPTION)

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

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

این دستور یک رستر ممیز شناور ۳۲ بیتی (32-bit float) با مقادیر شیب تولید می‌کند. شما این امکان را دارید که نوع مقدار شیب مورد نظر خود را تعیین کنید: درجه (degrees) یا درصد (percent slope). در مواردی که واحدهای افقی با واحدهای عمودی تفاوت دارند، می‌توانید ضرایب مقیاس‌بندی را نیز جهت لحاظ کردن تفاوت میان واحدهای عمودی و افقی ارائه دهید.

مقدار -9999 به عنوان مقدار nodata خروجی استفاده می‌شود. یک مقدار nodata در مجموعه‌داده مقصد زمانی تولید خواهد شد که حداقل یک پیکسل تنظیم‌شده روی مقدار nodata در پنجره ۳×۳ پیرامون هر پیکسل منبع یافت شود. به‌طور پیش‌فرض، الگوریتم مقادیر را در لبه‌های تصویر یا در صورت یافتن یک مقدار nodata در پنجره ۳×۳، از طریق میان‌یابی مقادیر گمشده محاسبه می‌کند، مگر اینکه --no-edges مشخص شده باشد، که در این صورت یک حاشیه با ضخامت ۱ پیکسل در اطراف تصویر با مقدار nodata تنظیم خواهد شد.

به‌طور کلی، فرض بر این است که واحدهای x، y و z یکسان هستند. با این حال، اگر هیچ‌یک از --xscale و --yscale مشخص نشده باشند و CRS یک CRS جغرافیایی یا تصویرشده باشد، نسبت مناسب را به‌طور خودکار بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط GDALRasterBand::GetUnitType() برگردانده می‌شود، در صورتی که متر، فوت بین‌المللی یا فوت نقشه‌برداری ایالات متحده باشد) تعیین خواهد کرد. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه‌داده‌های منبع در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و نیاز به بازتصویرسازی پیشین به یک تصویر قطبی با استفاده از gdal raster reproject باشد.

اگر واحدهای x (شرقی-غربی) و y (شمالی-جنوبی) یکسان باشند، اما واحدهای z (ارتفاع) متفاوت باشند، می‌توان از --xscale و --yscale برای تنظیم نسبت واحدهای عمودی به افقی استفاده کرد. برای CRS جغرافیایی در نزدیکی استوا، که در آن واحدهای عرض و طول جغرافیایی مشابه هستند، واحدهای ارتفاع (z) را می‌توان با استفاده از scale=370400 (اگر ارتفاع بر حسب فوت باشد) یا scale=111120 (اگر ارتفاع بر حسب متر باشد) برای سازگاری تبدیل کرد. برای مناطقی که در نزدیکی استوا نیستند، مقدار --xscale را می‌توان برابر با مقدار --yscale ضرب در کسینوس میانگین عرض جغرافیایی رستر در نظر گرفت.

خروجی GDALG (مجموعه‌داده در لحظه / جریانی)

این برنامه از سریالی‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی می‌کند. سپس فایل حاصل می‌تواند به عنوان یک مجموعه‌داده رستری با استفاده از درایور GDALG: GDAL Streamed Algorithm باز شود و خط لوله تعیین‌شده را به صورت در لحظه / جریانی اعمال کند.

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

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

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

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

--unit degree|percent: واحد بیان مقادیر شیب. پیش‌فرض degree (درجه) است.

--xscale <scale>

نسبت واحدهای عمودی به واحدهای افقی محور X. اگر واحد افقی DEM منبع درجه باشد (مانند تصویر Lat/Long WGS84)، می‌توانید در صورتی که واحدهای عمودی متر باشند از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400).

اگر هیچ‌یک از گزینه‌های --xscale و --yscale مشخص نشده باشند، و CRS یک CRS جغرافیایی یا تصویرشده باشد، دستور gdal raster slope نسبت مناسب را به‌طور خودکار بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط GDALRasterBand::GetUnitType() برگردانده می‌شود، در صورتی که متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین خواهد کرد. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه‌داده‌های منبع در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و نیاز به بازتصویرسازی پیشین به یک تصویر قطبی باشد.

اگر --xscale مشخص شود، --yscale نیز باید مشخص گردد.

--yscale <scale>

نسبت واحدهای عمودی به واحدهای افقی محور Y. اگر واحد افقی DEM منبع درجه باشد (مانند تصویر Lat/Long WGS84)، می‌توانید در صورتی که واحدهای عمودی متر باشند از scale=111120 استفاده کنید (یا اگر بر حسب فوت باشند از scale=370400).

اگر هیچ‌یک از گزینه‌های --xscale و --yscale مشخص نشده باشند، و CRS یک CRS جغرافیایی یا تصویرشده باشد، دستور gdal raster slope نسبت مناسب را به‌طور خودکار بر اساس واحدهای CRS و همچنین مقدار احتمالی واحدهای باند رستر (که توسط GDALRasterBand::GetUnitType() برگردانده می‌شود، در صورتی که متر، فوت بین‌المللی یا فوت نقشه‌برداری آمریکا باشد) تعیین خواهد کرد. توجه داشته باشید که برای CRS جغرافیایی، نتیجه برای مجموعه‌داده‌های منبع در عرض‌های جغرافیایی بالا ممکن است نادرست باشد و نیاز به بازتصویرسازی پیشین به یک تصویر قطبی باشد.

اگر --yscale مشخص شود، --xscale نیز باید مشخص گردد.

گزینه‌های استاندارد (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 slope n43.dt0 out.tif --overwrite

نویسنده (AUTHOR)

Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)

1998-2026