.\" 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_CONTOUR" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal_contour \- ایجاد خطوط کانتور برداری از مدل رقومی ارتفاع رستری .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_contour [\-\-help] [\-\-help\-general] [\-b ] [\-a ] [\-amin ] [\-amax ] [\-3d] [\-inodata] [\-snodata ] [\-f ] [\-i ] [\-dsco =]... [\-lco =]... [\-off ] [\-fl ...] [\-e ] [\-nln ] [\-q] [\-p] [\-gt |unlimited] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal_contour\fP یک فایل کانتور برداری را از یک مدل رقومی ارتفاع (DEM) رستری ورودی تولید می‌کند. .sp رشته‌خط‌های (line\-strings) کانتور با جهت‌گیری پیوسته و یکپارچه تولید می‌شوند و سمت مرتفع در سمت راست قرار خواهد گرفت، یعنی رشته‌خط به صورت ساعت‌گرد به دور یک قله گردش می‌کند. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 معادل در رابط خط فرمان جدید \(dqgdal\(dq: .sp \fI\%gdal raster contour\fP را ببینید. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-help نمایش این پیام راهنما و خروج .UNINDENT .INDENT 0.0 .TP .B \-\-help\-general نمایش یک پیام کوتاه درباره نحوه استفاده از گزینه‌های عمومی خط فرمان GDAL و خروج. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet سرکوب پیام‌های پیشرفت و سایر خروجی‌های غیر از خطا. .UNINDENT .INDENT 0.0 .TP .B \-b انتخاب باند خاصی که DEM از آن دریافت شود. پیش‌فرض باند 1 است. .UNINDENT .INDENT 0.0 .TP .B \-a تعیین نام برای مشخصه‌ای (صفت) که ارتفاع در آن قرار می‌گیرد. در صورت عدم تعیین، هیچ مشخصه ارتفاعی متصل نخواهد شد. در حالت کانتور چندضلعی (\fI\%\-p\fP) نادیده گرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-amin تعیین نام برای مشخصه‌ای که حداقل ارتفاع چندضلعی کانتور در آن قرار می‌گیرد. در صورت عدم تعیین، هیچ مشخصه حداقل ارتفاعی پیوست نمی‌شود. در حالت پیش‌فرض کانتور خطی نادیده گرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-amax تعیین نام برای مشخصه‌ای که حداکثر ارتفاع چندضلعی کانتور در آن قرار می‌گیرد. در صورت عدم تعیین، هیچ مشخصه حداکثر ارتفاعی پیوست نمی‌شود. در حالت پیش‌فرض کانتور خطی نادیده گرفته می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-3d اجبار به تولید برداری‌های سه‌بعدی به جای دوبعدی. شامل ارتفاع در تک‌تک رأس‌ها (vertices). .UNINDENT .INDENT 0.0 .TP .B \-inodata نادیده گرفتن هر مقدار بدون داده (nodata) تعیین‌شده در مجموعه‌داده \- تمامی مقادیر معتبر تلقی می‌شوند. همراه با \fI\%\-snodata\fP قابل استفاده نیست. .UNINDENT .INDENT 0.0 .TP .B \-snodata مقدار پیکسل ورودی که باید به عنوان \(dqnodata\(dq تلقی شود. همراه با \fI\%\-inodata\fP قابل استفاده نیست. .UNINDENT .INDENT 0.0 .TP .B \-f ایجاد خروجی در یک فرمت خاص. .INDENT 7.0 .INDENT 3.5 در صورت عدم تعیین، فرمت از روی پسوند فایل حدس زده می‌شود (پیش‌تر ESRI Shapefile بود). .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-dsco = گزینه ساخت مجموعه‌داده (مخصوص فرمت) .UNINDENT .INDENT 0.0 .TP .B \-lco = گزینه ساخت لایه (مخصوص فرمت) .UNINDENT .INDENT 0.0 .TP .B \-i فاصله ارتفاعی بین منحنی‌های کانتور (فاصله‌خطوط تراز). باید یکی از گزینه‌های \fI\%\-i\fP یا \fI\%\-fl\fP یا \fI\%\-e\fP مشخص شود. اولین کانتور در نخستین مضرب \fBinterval\fP که بزرگتر از حداقل مقدار رستر باشد تولید خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-off میزان جابه‌جایی (آفست) از صفر که فواصل تراز نسبت به آن تفسیر می‌شوند. .sp برای نمونه، \fI\-i 100\fP کانتورهایی را در ...، ۱۰۰-، ۰، ۱۰۰، ... درخواست می‌کند. افزودن بیشتر \fI\-off 25\fP این درخواست را به ...، ۷۵-، ۲۵، ۱۲۵، ... تغییر می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-fl تعیین یک یا چند \(dqسطح ثابت\(dq (تراز مشخص) برای استخراج، به ترتیب صعودی و با فاصله جداشده. .UNINDENT .INDENT 0.0 .TP .B \-e تولید ترازها بر روی مقیاس نمایی: \fIbase ^ k\fP، برای عدد صحیح \fIk\fP\&. باید یکی از \-i یا \-fl یا \-e مشخص شود. .UNINDENT .INDENT 0.0 .TP .B \-nln تعیین نام برای لایه برداری خروجی. پیش‌فرض \(dqcontour\(dq است. .UNINDENT .INDENT 0.0 .TP .B \-p تولید چندضلعی‌های (پلی‌گون‌های) کانتور به جای خطوط کانتور. .sp هنگامی که این حالت انتخاب شود، چندضلعی‌ها برای مقادیر بین هر سطح مشخص‌شده توسط \fI\%\-i\fP یا \fI\%\-fl\fP یا \fI\%\-e\fP ایجاد می‌شوند؛ در حالتی که \fI\%\-fl\fP به تنهایی استفاده شود حداقل دو سطح ثابت باید مشخص گردد. .sp حداقل و حداکثر مقادیر موجود در رستر به طور خودکار به فهرست سطوح ثابت اضافه نمی‌شوند، اما مقادیر ویژه \fBMIN\fP و \fBMAX\fP (بدون حساسیت به حروف بزرگ و کوچک) می‌توانند برای گنجاندن آن‌ها استفاده شوند. .UNINDENT .INDENT 0.0 .TP .B \-gt گروه‌بندی n عارضه در هر تراکنش (پیش‌فرض 100 000). برای عملکرد بهتر هنگام نوشتن در درایورهای DBMS که دارای پشتیبانی از تراکنش هستند، این مقدار را افزایش دهید. \fBn\fP می‌تواند روی unlimited تنظیم شود تا داده‌ها در یک تراکنش منفرد بارگذاری شوند. در صورت تنظیم روی 0، هیچ تراکنش صریحی انجام نمی‌شود. .sp در نسخه 3.10 اضافه شد. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "رابط C (C API)" .sp قابلیت‌های این ابزار از زبان C با تابع \fI\%GDALContourGenerate()\fP قابل دستیابی است. .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱" .INDENT 0.0 .TP .B عنوان ایجاد خطوط کانتور از یک DEM .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_contour \-a elev dem.tif contour.shp \-i 10.0 .EE .UNINDENT .UNINDENT .sp این دستور خطوط کانتور ۱۰ متری را از داده‌های DEM در \fBdem.tif\fP ایجاد کرده و یک shapefile در \fBcontour.shp|shx|dbf\fP با ارتفاع‌های کانتور در صفت \fBelev\fP تولید می‌کند. .SS "مثال ۲" .INDENT 0.0 .TP .B عنوان ایجاد کانتورهای چندضلعی از یک DEM .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX $ cat test.asc ncols 2 nrows 2 xllcorner 0 yllcorner 0 cellsize 1 4 15 25 36 $ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-i 10 \-p \-amin min \-amax max .EE .UNINDENT .UNINDENT .sp این دستور کانتورهای چندضلعی ۱۰ متری را از داده‌های DEM در \fBtest.asc\fP تولید کرده و یک خروجی GeoJSON با حداقل و حداکثر ارتفاع کانتور در صفت‌های \fBmin\fP و \fBmax\fP ایجاد می‌کند، شامل حداقل و حداکثر مقادیر موجود در رستر. .INDENT 0.0 .INDENT 3.5 .sp .EX { \(dqtype\(dq: \(dqFeatureCollection\(dq, \(dqname\(dq: \(dqcontour\(dq, \(dqfeatures\(dq: [ { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 0, \(dqmin\(dq: 4.0, \(dqmax\(dq: 10.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 0.5, 1.214285714285714 ], [ 1.045454545454545, 1.5 ], [ 1.045454545454545, 2.0 ], [ 1.0, 2.0 ], [ 0.5, 2.0 ], [ 0.0, 2.0 ], [ 0.0, 1.5 ], [ 0.0, 1.214285714285714 ], [ 0.5, 1.214285714285714 ] ] ] ] } }, { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 1, \(dqmin\(dq: 10.0, \(dqmax\(dq: 20.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 1.5, 1.261904761904762 ], [ 2.0, 1.261904761904762 ], [ 2.0, 1.5 ], [ 2.0, 2.0 ], [ 1.5, 2.0 ], [ 1.045454545454545, 2.0 ], [ 1.045454545454545, 1.5 ], [ 0.5, 1.214285714285714 ], [ 0.0, 1.214285714285714 ], [ 0.0, 1.0 ], [ 0.0, 0.738095238095238 ], [ 0.5, 0.738095238095238 ], [ 1.5, 1.261904761904762 ] ] ] ] } }, { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 2, \(dqmin\(dq: 20.0, \(dqmax\(dq: 30.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 0.954545454545455, 0.0 ], [ 0.954545454545455, 0.5 ], [ 1.5, 0.785714285714286 ], [ 2.0, 0.785714285714286 ], [ 2.0, 1.0 ], [ 2.0, 1.261904761904762 ], [ 1.5, 1.261904761904762 ], [ 0.5, 0.738095238095238 ], [ 0.0, 0.738095238095238 ], [ 0.0, 0.5 ], [ 0.0, 0.0 ], [ 0.5, 0.0 ], [ 0.954545454545455, 0.0 ] ] ] ] } }, { \(dqtype\(dq: \(dqFeature\(dq, \(dqproperties\(dq: { \(dqID\(dq: 3, \(dqmin\(dq: 30.0, \(dqmax\(dq: 36.0 }, \(dqgeometry\(dq: { \(dqtype\(dq: \(dqMultiPolygon\(dq, \(dqcoordinates\(dq: [ [ [ [ 1.499999909090926, 0.0 ], [ 1.0, 0.0 ], [ 0.954545454545455, 0.0 ], [ 0.954545454545455, 0.5 ], [ 1.5, 0.785714285714286 ], [ 2.0, 0.785714285714286 ], [ 2.0, 0.500000047619043 ], [ 1.5, 0.500000047619043 ], [ 1.499999909090926, 0.5 ], [ 1.499999909090926, 0.0 ] ] ] ] } } ] } .EE .UNINDENT .UNINDENT .SS "مثال ۳" .INDENT 0.0 .TP .B عنوان ایجاد کانتور از یک DEM با سطوح ثابت .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX $ cat test.asc ncols 2 nrows 2 xllcorner 0 yllcorner 0 cellsize 1 4 15 25 36 $ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-fl 10 20 \-p \-amin min \-amax max .EE .UNINDENT .UNINDENT .sp این دستور یک کانتور چندضلعی منفرد بین ۱۰ و ۲۰ متر از داده‌های DEM در \fBtest.asc\fP تولید کرده و یک خروجی GeoJSON با حداقل و حداکثر ارتفاع کانتور در صفت‌های \fBmin\fP و \fBmax\fP ایجاد می‌کند. .sp در صورتی که حداقل و حداکثر مقادیر موجود در رستر مورد نظر باشند، مقادیر ویژه \fBMIN\fP و \fBMAX\fP (بدون حساسیت به بزرگی و کوچکی حروف) قابل استفاده خواهند بود: .INDENT 0.0 .INDENT 3.5 .sp .EX $ cat test.asc ncols 2 nrows 2 xllcorner 0 yllcorner 0 cellsize 1 4 15 25 36 $ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-fl MIN 10 20 MAX \-p \-amin min \-amax max .EE .UNINDENT .UNINDENT .sp این دستور سه کانتور چندضلعی از داده‌های DEM در \fBtest.asc\fP تولید کرده و خروجی GeoJSON با حداقل و حداکثر ارتفاع کانتور در صفت‌های \fBmin\fP و \fBmax\fP ایجاد می‌کند؛ مقادیر این فیلدها برابر خواهند بود با: (4.0, 10.0)، (10, 20.0) و (20.0, 36.0). .SS "مثال ۴" .INDENT 0.0 .TP .B عنوان ایجاد کانتور از یک DEM با تعیین فاصله و سطوح ثابت به صورت همزمان .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX $ cat test.asc ncols 2 nrows 2 xllcorner 0 yllcorner 0 cellsize 1 4 15 25 36 $ gdal_contour test.asc \-f GeoJSON /vsistdout/ \-i 10 \-fl 15 \-p \-amin min \-amax max .EE .UNINDENT .UNINDENT .sp کانتورها را در فواصل منظم ۱۰ متری ایجاد می‌کند و یک کانتور اضافی برای سطح ثابت ۱۵ متری می‌افزاید. در نهایت نواحی بین خطوط کانتور را به چندضلعی‌هایی تبدیل می‌کند که حداقل و حداکثر ارتفاع کانتور را در صفت‌های \fBmin\fP و \fBmax\fP دارند؛ مقادیر این فیلدها برابر خواهند بود با: (4.0, 10.0)، (10, 15.0)، (15, 20.0)، (20.0, 30.0) و (30.0, 36.0). .SH "نویسندگان (AUTHORS)" Frank Warmerdam , Silke Reimer .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .