.\" 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-AS-FEATURES" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-as-features \- ایجاد عارضه‌هایی برای نمایش پیکسل‌های یک رستر .sp در نگارش 3.12 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster as\-features [OPTIONS] Create features from pixels of a raster dataset 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] 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] \-\-update Whether to open existing dataset in update mode [not available in pipelines] \-\-overwrite\-layer Whether overwriting existing output layer is allowed [not available in pipelines] \-\-append Whether appending to existing layer is allowed [not available in pipelines] \-\-output\-layer Output layer name [not available in pipelines] \-b, \-\-band Input band(s) (1\-based index) [may be repeated] \-\-geometry\-type Geometry type. GEOMETRY\-TYPE=none|point|polygon (default: none) \-\-skip\-nodata Omit NoData pixels from the result \-\-include\-xy Include fields for cell center coordinates \-\-include\-row\-col Include columns for row and column 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 as\-features\fP عارضه‌هایی ایجاد می‌کند که بیانگر پیکسل‌ها در یک مجموعه‌داده رستر هستند. عارضه‌ها می‌توانند به صورت چندضلعی (polygon)، نقطه (point) یا بدون هیچ هندسه‌ای ایجاد شوند. برخلاف \fI\%gdal raster polygonize\fP، پیکسل‌های مجاور با مقادیر یکسان با یکدیگر ترکیب نمی‌شوند. .sp این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP باشد. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-b, \-\-band باندهایی را تعیین می‌کند که مقادیر پیکسل آن‌ها باید به عنوان فیلدهای عارضه‌های ایجادشده اضافه شوند. به طور پیش‌فرض، مقادیر برای تمام باندها اضافه خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-geometry\-type نوع هندسه عارضه‌های ایجادشده را تعیین می‌کند. گزینه‌های دردسترس عبارتند از \(dqnone\(dq (پیش‌فرض)، \(dqpoint\(dq، یا \(dqpolygon\(dq. .UNINDENT .INDENT 0.0 .TP .B \-\-include\-row\-col در صورت تنظیم، فیلدهای \fBROW\fP و \fBCOL\fP همراه با موقعیت سلول‌ها اضافه خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-include\-xy در صورت تنظیم، فیلدهای \fBCENTER_X\fP و \fBCENTER_Y\fP همراه با مختصات مرکز هر پیکسل اضافه خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نامی برای لایه برداری خروجی تعیین می‌کند. مقدار پیش‌فرض \(dqpixels\(dq است. .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-nodata در صورت تنظیم، هیچ عارضه‌ای برای پیکسل‌های دارای مقدار NoData ایجاد نخواهد شد. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append تعیین می‌کند که آیا افزودن عارضه‌ها به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین مجموعه‌داده خروجی را در صورتی که هنوز وجود نداشته باشد، ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی بودن یا نبودن فایل پشتیبانی می‌کند. .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 \-f, \-\-of, \-\-format, \-\-output\-format تعیین فرمت برداری خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep vector | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-output\-open\-option, \-\-output\-oo = در نگارش 3.12 اضافه شد. .sp گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (مخصوص هر فرمت). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از پیش وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite\-layer تعیین می‌کند که آیا بازنویسی لایه برداری خروجی موجود مجاز است یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-update تعیین می‌کند که آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیر مسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: ایجاد نقاط در مرکز پیکسل‌هایی با مقدار کمتر از ۱۵۰" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal pipeline read input.tif ! reclassify \-m \(dq[\-inf, 150)=1; DEFAULT=NO_DATA\(dq ! as\-features \-\-geometry\-type point \-\-skip\-nodata ! write out.shp .EE .UNINDENT .UNINDENT .SS "مثال ۲: ایجاد یک شبکه چندضلعی که کره زمین را به بخش‌های ۱ درجه‌ای تقسیم می‌کند" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal pipeline create \-\-bbox \-180,\-90,180,90 \-\-size 360,180 ! as\-features \-\-geometry\-type polygon ! write grid.shp .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Dan Baston .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .