.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "GDAL-RASTER-CONTOUR" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-contour \- ایجاد خطوط کانتور (تراز) برداری از مدل رقومی ارتفاعی رستر (DEM) .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster contour [OPTIONS] Creates a vector contour from a raster elevation model (DEM). Positional arguments: \-i, \-\-input Input raster datasets [required] [not available in pipelines] \-o, \-\-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 = 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 (\(dqGDALG\(dq allowed) [not available in pipelines] \-\-co, \-\-creation\-option = Creation option [may be repeated] [not available in pipelines] \-\-lco, \-\-layer\-creation\-option = 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 name \-b, \-\-band Input band (1\-based index) (default: 1) \-\-elevation\-name Name of the elevation field \-\-min\-name Name of the minimum elevation field \-\-max\-name Name of the maximum elevation field \-\-3d Force production of 3D vectors instead of 2D \-\-input\-nodata Input pixel value to treat as \(aqnodata\(aq \-\-interval Elevation interval between contours Mutually exclusive with \-\-levels, \-\-exp\-base \-\-levels List of contour levels [may be repeated] Mutually exclusive with \-\-interval, \-\-exp\-base \-e, \-\-exp\-base Base for exponential contour level generation Mutually exclusive with \-\-interval, \-\-levels \-\-off, \-\-offset Offset to apply to contour levels \-p, \-\-polygonize Create polygons instead of lines \-\-group\-transactions Group n features per transaction (default 100 000) Advanced Options: \-\-if, \-\-input\-format Input formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] \-\-output\-oo, \-\-output\-open\-option = Output open options [may be repeated] [not available in pipelines] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster contour\fP خطوط کانتور (تراز) برداری را از یک مدل رقومی ارتفاعی رستر (DEM) ایجاد می‌کند. .sp از نسخه 3.12 در GDAL، این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP باشد. .sp در نسخه 3.12 اضافه شد. .SH "خروجی GDALG (مجموعه‌داده درلحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس می‌توان فایل حاصل را با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه‌داده برداری باز کرد و خط لوله مشخص‌شده را به صورت درلحظه / جریانی (on\-the\-fly / streamed) اعمال نمود. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال، این الگوریتم به صورت بومی با پردازش جریانی سازگار نیست. در نتیجه یک مجموعه‌داده موقت در حافظه ایجاد خواهد شد که ممکن است باعث صرف زمان پردازش قابل‌توجهی در هنگام باز کردن شود. .UNINDENT .UNINDENT .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-3d تولید بردارهای سه‌بعدی به جای دوبعدی را اجباری می‌کند. ارتفاع را در هر رأس شامل می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-b, \-\-band باند مشخصی را برای دریافت DEM انتخاب می‌کند. مقدار پیش‌فرض باند 1 است. .UNINDENT .INDENT 0.0 .TP .B \-\-elevation\-name نامی برای ویژگی‌ای (attribute) که ارتفاع در آن قرار می‌گیرد ارائه می‌دهد. در صورت عدم ارائه، هیچ ویژگی ارتفاعی متصل نخواهد شد. در حالت کانتور چندضلعی (\-p) نادیده گرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-e, \-\-exp\-base تولید سطوح بر پایه مقیاس نمایی: پایه ^ k، که در آن k یک عدد صحیح است. با \fI\%\-\-interval\fP و \fI\%\-\-levels\fP مانعة‌الجمع است. .UNINDENT .INDENT 0.0 .TP .B \-\-group\-transactions گروه‌بندی n عارضه در هر تراکنش (پیش‌فرض 100 000). .UNINDENT .INDENT 0.0 .TP .B \-\-interval فاصله ارتفاعی بین خطوط کانتور. با \fI\%\-\-levels\fP و \fI\%\-\-exp\-base\fP مانعة‌الجمع است. اولین کانتور در اولین مضرب از \fBINTERVAL\fP که بزرگتر از کمینه مقدار رستر باشد تولید خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-levels فهرست سطوح کانتور. مقادیر \fIMIN\fP و \fIMAX\fP مقادیر ویژه‌ای هستند که کمترین و بیشترین مقدار رستر را نشان می‌دهند. هنگامی که \fI\-\-polygonize\fP استفاده می‌شود، مقادیر مشخص‌شده به عنوان مرزهای چندضلعی‌های تولیدشده به کار می‌روند. با \fI\%\-\-interval\fP و \fI\%\-\-exp\-base\fP مانعة‌الجمع است. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-name نامی برای ویژگی‌ای که حداکثر ارتفاع در آن قرار می‌گیرد ارائه می‌دهد. در صورت عدم ارائه، هیچ ویژگی بیشینه ارتفاعی پیوست نمی‌شود. در حالت کانتور چندضلعی (\-p) نادیده گرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-name نامی برای ویژگی‌ای که حداقل ارتفاع در آن قرار می‌گیرد ارائه می‌دهد. در صورت عدم ارائه، هیچ ویژگی کمینه ارتفاعی پیوست نمی‌شود. در حالت کانتور چندضلعی (\-p) نادیده گرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-off, \-\-offset فاصله انحراف (آفسِت) از صفر که فواصل نسبت به آن تفسیر می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-nln, \-\-output\-layer نامی برای لایه برداری خروجی تعیین می‌کند. مقدار پیش‌فرض \(dqcontour\(dq است. .UNINDENT .INDENT 0.0 .TP .B \-p, \-\-polygonize ایجاد چندضلعی‌ها به‌جای خطوط. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-nodata مقدار پیکسل ورودی که باید به عنوان \(aqnodata\(aq در نظر گرفته شود. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توانند برای کنترل جزئیات فایل ایجادشده استفاده شوند. برای مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و این‌که آیا فایل باید کاشی‌بندی (tiled) شود یا خیر پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت موجود بسته به درایور قالب متغیر هستند، و برخی قالب‌های ساده اصلاً گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به قالب، منبع نهایی اطلاعات در مورد گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب \fI\%Raster drivers\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایور که برای تلاش جهت باز کردن فایل(های) ورودی استفاده می‌شود. به طور کلی نیازی به مشخص کردن آن نیست، اما در صورتی که تشخیص خودکار درایور نتواند درایور مناسب را انتخاب کند، می‌تواند برای دور زدن تشخیص خودکار درایور استفاده شود. این گزینه می‌تواند چندین بار برای تعیین چندین درایور نامزد تکرار شود. توجه داشته باشید که این گزینه آن درایورها را به باز کردن مجموعه‌داده مجبور نمی‌کند؛ به ویژه، برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت لایه دارند که می‌توان از آن‌ها برای کنترل جزئیات لایه ایجادشده استفاده کرد. برای مثال، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت لایه بسته به درایور قالب متغیر است، و برخی از قالب‌های ساده اصلاً گزینه ساخت لایه ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات قالب، منبع اصلی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب، مستندات اختصاصی قالب \fI\%Vector drivers\fP را ببینید. .sp توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه‌داده متفاوت هستند. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مخصوص هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-open\-option, \-\-output\-oo = در نسخه 3.12 اضافه شد. .sp گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (مخصوص هر قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format کدام قالب برداری خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep vector | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیر صفر را بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: ایجاد خطوط کانتور از مدل رقومی ارتفاعی رستر" .INDENT 0.0 .INDENT 3.5 مثال زیر خطوط کانتور (تراز) را از یک مدل رقومی ارتفاعی رستر ایجاد می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster contour \-\-interval 100 elevation.tif contour.shp .EE .UNINDENT .UNINDENT .sp این کار یک shapefile به نام \fBcontour.shp\fP با خطوط کانتور در فواصل ۱۰۰ متری ایجاد می‌کند. .UNINDENT .UNINDENT .SS "مثال ۲: ایجاد چندضلعی‌های کانتور از مدل رقومی ارتفاعی رستر با ویژگی‌های سفارشی و سطوح ثابت" .INDENT 0.0 .INDENT 3.5 مثال زیر چندضلعی‌های کانتور را از یک مدل رقومی ارتفاعی رستر با ویژگی‌های سفارشی و سطوح ثابت ایجاد می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster contour \-\-levels MIN,100,200,MAX \-\-polygonize \-\-min\-name MIN \-\-max\-name MAX elevation.tif contour.shp .EE .UNINDENT .UNINDENT .sp این دستور یک shapefile به نام \fBcontour.shp\fP شامل چندضلعی‌های کانتور از کمینه مقدار رستر تا 100، از 100 تا 200 و از 200 تا بیشینه مقدار رستر، و با ویژگی‌های \fBMIN\fP و \fBMAX\fP ایجاد خواهد کرد. .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Alessandro Pasotti .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .