GDAL-RASTER-CONTOUR(1) GDAL GDAL-RASTER-CONTOUR(1)

gdal-raster-contour - ایجاد خطوط کانتور (تراز) برداری از مدل رقومی ارتفاعی رستر (DEM)

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

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]

دستور gdal raster contour خطوط کانتور (تراز) برداری را از یک مدل رقومی ارتفاعی رستر (DEM) ایجاد می‌کند.

از نسخه 3.12 در GDAL، این الگوریتم می‌تواند بخشی از یک gdal pipeline باشد.

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

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

نکته:

با این حال، این الگوریتم به صورت بومی با پردازش جریانی سازگار نیست. در نتیجه یک مجموعه‌داده موقت در حافظه ایجاد خواهد شد که ممکن است باعث صرف زمان پردازش قابل‌توجهی در هنگام باز کردن شود.

--3d
تولید بردارهای سه‌بعدی به جای دوبعدی را اجباری می‌کند. ارتفاع را در هر رأس شامل می‌شود.
باند مشخصی را برای دریافت DEM انتخاب می‌کند. مقدار پیش‌فرض باند 1 است.
نامی برای ویژگی‌ای (attribute) که ارتفاع در آن قرار می‌گیرد ارائه می‌دهد. در صورت عدم ارائه، هیچ ویژگی ارتفاعی متصل نخواهد شد. در حالت کانتور چندضلعی (-p) نادیده گرفته می‌شود.
تولید سطوح بر پایه مقیاس نمایی: پایه ^ k، که در آن k یک عدد صحیح است. با --interval و --levels مانعة‌الجمع است.
گروه‌بندی n عارضه در هر تراکنش (پیش‌فرض 100 000).
فاصله ارتفاعی بین خطوط کانتور. با --levels و --exp-base مانعة‌الجمع است. اولین کانتور در اولین مضرب از INTERVAL که بزرگتر از کمینه مقدار رستر باشد تولید خواهد شد.
فهرست سطوح کانتور. مقادیر MIN و MAX مقادیر ویژه‌ای هستند که کمترین و بیشترین مقدار رستر را نشان می‌دهند. هنگامی که --polygonize استفاده می‌شود، مقادیر مشخص‌شده به عنوان مرزهای چندضلعی‌های تولیدشده به کار می‌روند. با --interval و --exp-base مانعة‌الجمع است.
نامی برای ویژگی‌ای که حداکثر ارتفاع در آن قرار می‌گیرد ارائه می‌دهد. در صورت عدم ارائه، هیچ ویژگی بیشینه ارتفاعی پیوست نمی‌شود. در حالت کانتور چندضلعی (-p) نادیده گرفته می‌شود.
نامی برای ویژگی‌ای که حداقل ارتفاع در آن قرار می‌گیرد ارائه می‌دهد. در صورت عدم ارائه، هیچ ویژگی کمینه ارتفاعی پیوست نمی‌شود. در حالت کانتور چندضلعی (-p) نادیده گرفته می‌شود.
فاصله انحراف (آفسِت) از صفر که فواصل نسبت به آن تفسیر می‌شوند.
نامی برای لایه برداری خروجی تعیین می‌کند. مقدار پیش‌فرض "contour" است.
ایجاد چندضلعی‌ها به‌جای خطوط.
مقدار پیکسل ورودی که باید به عنوان 'nodata' در نظر گرفته شود.

بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌بندی (tiled) شود یا خیر پشتیبانی می‌کند.

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

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

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

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

بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت لایه دارند که می‌توان از آن‌ها برای کنترل جزئیات لایه ایجادشده استفاده کرد. برای مثال، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند.

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

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

توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه‌داده متفاوت هستند.

گزینه باز کردن مجموعه‌داده (مخصوص هر قالب).

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

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

گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (مخصوص هر قالب).

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

کدام قالب برداری خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep vector | grep rw | sort
به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

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

مثال زیر خطوط کانتور (تراز) را از یک مدل رقومی ارتفاعی رستر ایجاد می‌کند:
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 ایجاد خواهد کرد.

Alessandro Pasotti <elpaso@itopen.it>

1998-2026

August 18, 2026