| GDAL-RASTER-CONTOUR(1) | GDAL | GDAL-RASTER-CONTOUR(1) |
نام (NAME)
gdal-raster-contour - ایجاد خطوط کانتور (تراز) برداری از مدل رقومی ارتفاعی رستر (DEM)
در نسخه 3.11 اضافه شد.
خلاصه دستور (SYNOPSIS)
Usage: gdal raster contour [OPTIONS] <INPUT> <OUTPUT>
Creates a vector contour from a raster elevation model (DEM).
Positional arguments:
-i, --input <INPUT> Input raster datasets [required] [not available in pipelines]
-o, --output <OUTPUT> Output vector dataset [required] [not available in pipelines]
Common Options:
-h, --help Display help message and exit
--json-usage Display usage as JSON document and exit
--config <KEY>=<VALUE> Configuration option [may be repeated]
-q, --quiet Quiet mode (no progress bar or warning message) [not available in pipelines]
Options:
-f, --of, --format, --output-format <OUTPUT-FORMAT> Output format ("GDALG" allowed) [not available in pipelines]
--co, --creation-option <KEY>=<VALUE> Creation option [may be repeated] [not available in pipelines]
--lco, --layer-creation-option <KEY>=<VALUE> Layer creation option [may be repeated] [not available in pipelines]
--overwrite Whether overwriting existing output dataset is allowed [not available in pipelines]
--output-layer <OUTPUT-LAYER> Output layer name
-b, --band <BAND> Input band (1-based index) (default: 1)
--elevation-name <ELEVATION-NAME> Name of the elevation field
--min-name <MIN-NAME> Name of the minimum elevation field
--max-name <MAX-NAME> Name of the maximum elevation field
--3d Force production of 3D vectors instead of 2D
--input-nodata <INPUT-NODATA> Input pixel value to treat as 'nodata'
--interval <INTERVAL> Elevation interval between contours
Mutually exclusive with --levels, --exp-base
--levels <LEVELS> List of contour levels [may be repeated]
Mutually exclusive with --interval, --exp-base
-e, --exp-base <EXP-BASE> Base for exponential contour level generation
Mutually exclusive with --interval, --levels
--off, --offset <OFFSET> Offset to apply to contour levels
-p, --polygonize Create polygons instead of lines
--group-transactions <GROUP-TRANSACTIONS> Group n features per transaction (default 100 000)
Advanced Options:
--if, --input-format <INPUT-FORMAT> Input formats [may be repeated] [not available in pipelines]
--oo, --open-option <KEY>=<VALUE> Open options [may be repeated] [not available in pipelines]
--output-oo, --output-open-option <KEY>=<VALUE> Output open options [may be repeated] [not available in pipelines]
توضیحات (DESCRIPTION)
دستور gdal raster contour خطوط کانتور (تراز) برداری را از یک مدل رقومی ارتفاعی رستر (DEM) ایجاد میکند.
از نسخه 3.12 در GDAL، این الگوریتم میتواند بخشی از یک gdal pipeline باشد.
در نسخه 3.12 اضافه شد.
خروجی GDALG (مجموعهداده درلحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))
این برنامه از سریالسازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی GDALG پشتیبانی میکند. سپس میتوان فایل حاصل را با استفاده از درایور GDALG: GDAL Streamed Algorithm به عنوان یک مجموعهداده برداری باز کرد و خط لوله مشخصشده را به صورت درلحظه / جریانی (on-the-fly / streamed) اعمال نمود.
نکته:
گزینههای ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)
- --3d
- تولید بردارهای سهبعدی به جای دوبعدی را اجباری میکند. ارتفاع را در هر رأس شامل میشود.
- -b, --band <BAND>
- باند مشخصی را برای دریافت DEM انتخاب میکند. مقدار پیشفرض باند 1 است.
- --elevation-name <ELEVATION-NAME>
- نامی برای ویژگیای (attribute) که ارتفاع در آن قرار میگیرد ارائه میدهد. در صورت عدم ارائه، هیچ ویژگی ارتفاعی متصل نخواهد شد. در حالت کانتور چندضلعی (-p) نادیده گرفته میشود.
- -e, --exp-base <EXP-BASE>
- تولید سطوح بر پایه مقیاس نمایی: پایه ^ k، که در آن k یک عدد صحیح است. با --interval و --levels مانعةالجمع است.
- --group-transactions <GROUP-TRANSACTIONS>
- گروهبندی n عارضه در هر تراکنش (پیشفرض 100 000).
- --interval <INTERVAL>
- فاصله ارتفاعی بین خطوط کانتور. با --levels و --exp-base مانعةالجمع است. اولین کانتور در اولین مضرب از INTERVAL که بزرگتر از کمینه مقدار رستر باشد تولید خواهد شد.
- --levels <LEVELS>
- فهرست سطوح کانتور. مقادیر MIN و MAX مقادیر ویژهای هستند که کمترین و بیشترین مقدار رستر را نشان میدهند. هنگامی که --polygonize استفاده میشود، مقادیر مشخصشده به عنوان مرزهای چندضلعیهای تولیدشده به کار میروند. با --interval و --exp-base مانعةالجمع است.
- --max-name <MAX-NAME>
- نامی برای ویژگیای که حداکثر ارتفاع در آن قرار میگیرد ارائه میدهد. در صورت عدم ارائه، هیچ ویژگی بیشینه ارتفاعی پیوست نمیشود. در حالت کانتور چندضلعی (-p) نادیده گرفته میشود.
- --min-name <MIN-NAME>
- نامی برای ویژگیای که حداقل ارتفاع در آن قرار میگیرد ارائه میدهد. در صورت عدم ارائه، هیچ ویژگی کمینه ارتفاعی پیوست نمیشود. در حالت کانتور چندضلعی (-p) نادیده گرفته میشود.
- --off, --offset <OFFSET>
- فاصله انحراف (آفسِت) از صفر که فواصل نسبت به آن تفسیر میشوند.
- --nln, --output-layer <OUTPUT-LAYER>
- نامی برای لایه برداری خروجی تعیین میکند. مقدار پیشفرض "contour" است.
- -p, --polygonize
- ایجاد چندضلعیها بهجای خطوط.
- --input-nodata <INPUT-NODATA>
- مقدار پیکسل ورودی که باید به عنوان 'nodata' در نظر گرفته شود.
گزینههای استاندارد (STANDARD OPTIONS)
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
قالبها یک
یا چند
گزینه ساخت
اختیاری
دارند که
میتوانند
برای کنترل
جزئیات
فایل
ایجادشده
استفاده
شوند. برای
مثال،
درایور GeoTIFF از
گزینههای
ساخت برای
کنترل
فشردهسازی
و اینکه
آیا فایل
باید
کاشیبندی
(tiled) شود یا خیر
پشتیبانی
میکند.
میتواند تکرار شود.
گزینههای ساخت موجود بسته به درایور قالب متغیر هستند، و برخی قالبهای ساده اصلاً گزینه ساختی ندارند. فهرستی از گزینههای پشتیبانیشده برای یک قالب را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به قالب، منبع نهایی اطلاعات در مورد گزینههای ساخت درایور است. برای گزینههای ساخت مجاز هر قالب، مستندات اختصاصی قالب Raster drivers را ببینید.
- --if, --input-format <format>
- نام
قالب/درایور
که برای
تلاش جهت
باز کردن
فایل(های)
ورودی
استفاده
میشود. به
طور کلی
نیازی به
مشخص کردن
آن نیست،
اما در
صورتی که
تشخیص
خودکار
درایور
نتواند
درایور
مناسب را
انتخاب
کند،
میتواند
برای دور
زدن تشخیص
خودکار
درایور
استفاده
شود. این
گزینه
میتواند
چندین بار
برای تعیین
چندین
درایور
نامزد
تکرار شود.
توجه داشته
باشید که
این گزینه
آن
درایورها
را به باز
کردن
مجموعهداده
مجبور
نمیکند؛
به ویژه،
برخی
درایورها
نیازمندیهایی
برای پسوند
فایل دارند.
میتواند تکرار شود.
- --lco, --layer-creation-option <NAME>=<VALUE>
- بسیاری از
قالبها یک
یا چند
گزینه
اختیاری
ساخت لایه
دارند که
میتوان از
آنها برای
کنترل
جزئیات
لایه
ایجادشده
استفاده
کرد. برای
مثال،
درایور GeoPackage
از
گزینههای
ساخت لایه
برای کنترل
شناسه
عارضه یا
نام ستون
هندسه،
تنظیم
شناسه یا
توضیحات و
غیره
پشتیبانی
میکند.
میتواند تکرار شود.
گزینههای ساخت لایه بسته به درایور قالب متغیر است، و برخی از قالبهای ساده اصلاً گزینه ساخت لایه ندارند. فهرستی از گزینههای پشتیبانیشده برای یک قالب را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات قالب، منبع اصلی اطلاعات درباره گزینههای ساخت درایور است. برای گزینههای ساخت مجاز هر قالب، مستندات اختصاصی قالب Vector drivers را ببینید.
توجه داشته باشید که گزینههای ساخت لایه با گزینههای ساخت مجموعهداده متفاوت هستند.
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعهداده
(مخصوص هر
قالب).
میتواند تکرار شود.
- --output-open-option, --output-oo <NAME>=<VALUE>
- در نسخه 3.12
اضافه شد.
گزینه باز کردن مجموعهداده برای مجموعهداده خروجی (مخصوص هر قالب).
میتواند تکرار شود.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- کدام قالب برداری خروجی استفاده شود. مقادیر مجاز را میتوان با دستور زیر به دست آورد: gdal --formats | grep vector | grep rw | sort
- --overwrite
- به برنامه اجازه میدهد تا فایل یا مجموعهداده مقصد موجود را بازنویسی کند. در غیر این صورت، بهطور پیشفرض، اگر فایل یا مجموعهداده مقصد از قبل وجود داشته باشد، gdal با خطا متوقف میشود.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیر صفر را بازمیگرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر میشوند به عنوان اجرای موفقیتآمیز در نظر گرفته میشوند).
مثالها (EXAMPLES)
مثال ۱: ایجاد خطوط کانتور از مدل رقومی ارتفاعی رستر
gdal raster contour --interval 100 elevation.tif contour.shp
این کار یک shapefile به نام contour.shp با خطوط کانتور در فواصل ۱۰۰ متری ایجاد میکند.
مثال ۲: ایجاد چندضلعیهای کانتور از مدل رقومی ارتفاعی رستر با ویژگیهای سفارشی و سطوح ثابت
gdal raster contour --levels MIN,100,200,MAX --polygonize --min-name MIN --max-name MAX elevation.tif contour.shp
این دستور یک shapefile به نام contour.shp شامل چندضلعیهای کانتور از کمینه مقدار رستر تا 100، از 100 تا 200 و از 200 تا بیشینه مقدار رستر، و با ویژگیهای MIN و MAX ایجاد خواهد کرد.
نویسندگان (AUTHORS)
Alessandro Pasotti <elpaso@itopen.it>
کپیرایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |