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         GDAL-RASTER-CONTOUR(1)