GDAL-RASTER-AS-FEATURES(1) GDAL GDAL-RASTER-AS-FEATURES(1)

gdal-raster-as-features - ایجاد عارضه‌هایی برای نمایش پیکسل‌های یک رستر

در نگارش 3.12 اضافه شد.

Usage: gdal raster as-features [OPTIONS] <INPUT> <OUTPUT>
Create features from pixels of a raster dataset
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]
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]
  --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>                        Output layer name [not available in pipelines]
  -b, --band <BAND>                                    Input band(s) (1-based index) [may be repeated]
  --geometry-type <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-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 as-features عارضه‌هایی ایجاد می‌کند که بیانگر پیکسل‌ها در یک مجموعه‌داده رستر هستند. عارضه‌ها می‌توانند به صورت چندضلعی (polygon)، نقطه (point) یا بدون هیچ هندسه‌ای ایجاد شوند. برخلاف gdal raster polygonize، پیکسل‌های مجاور با مقادیر یکسان با یکدیگر ترکیب نمی‌شوند.

این الگوریتم می‌تواند بخشی از یک gdal pipeline باشد.

باندهایی را تعیین می‌کند که مقادیر پیکسل آن‌ها باید به عنوان فیلدهای عارضه‌های ایجادشده اضافه شوند. به طور پیش‌فرض، مقادیر برای تمام باندها اضافه خواهند شد.
نوع هندسه عارضه‌های ایجادشده را تعیین می‌کند. گزینه‌های دردسترس عبارتند از "none" (پیش‌فرض)، "point"، یا "polygon".
در صورت تنظیم، فیلدهای ROW و COL همراه با موقعیت سلول‌ها اضافه خواهند شد.
در صورت تنظیم، فیلدهای CENTER_X و CENTER_Y همراه با مختصات مرکز هر پیکسل اضافه خواهند شد.
نامی برای لایه برداری خروجی تعیین می‌کند. مقدار پیش‌فرض "pixels" است.
در صورت تنظیم، هیچ عارضه‌ای برای پیکسل‌های دارای مقدار NoData ایجاد نخواهد شد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از پیش وجود داشته باشد، gdal با خطا متوقف می‌شود.
--overwrite-layer
تعیین می‌کند که آیا بازنویسی لایه برداری خروجی موجود مجاز است یا خیر.
تعیین می‌کند که آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر.

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

gdal pipeline read input.tif !
         reclassify -m "[-inf, 150)=1; DEFAULT=NO_DATA" !
         as-features --geometry-type point --skip-nodata !
         write out.shp

gdal pipeline create --bbox -180,-90,180,90 --size 360,180 !
         as-features --geometry-type polygon !
         write grid.shp

Dan Baston <dbaston@gmail.com>

1998-2026

August 18, 2026