| GDAL-RASTER-AS-FEATURES(1) | GDAL | GDAL-RASTER-AS-FEATURES(1) |
نام (NAME)
gdal-raster-as-features - ایجاد عارضههایی برای نمایش پیکسلهای یک رستر
در نگارش 3.12 اضافه شد.
خلاصه دستور (SYNOPSIS)
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]
توضیحات (DESCRIPTION)
دستور gdal raster as-features عارضههایی ایجاد میکند که بیانگر پیکسلها در یک مجموعهداده رستر هستند. عارضهها میتوانند به صورت چندضلعی (polygon)، نقطه (point) یا بدون هیچ هندسهای ایجاد شوند. برخلاف gdal raster polygonize، پیکسلهای مجاور با مقادیر یکسان با یکدیگر ترکیب نمیشوند.
این الگوریتم میتواند بخشی از یک gdal pipeline باشد.
گزینههای اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)
- -b, --band <band>
- باندهایی را تعیین میکند که مقادیر پیکسل آنها باید به عنوان فیلدهای عارضههای ایجادشده اضافه شوند. به طور پیشفرض، مقادیر برای تمام باندها اضافه خواهند شد.
- --geometry-type
- نوع هندسه عارضههای ایجادشده را تعیین میکند. گزینههای دردسترس عبارتند از "none" (پیشفرض)، "point"، یا "polygon".
- --include-row-col
- در صورت تنظیم، فیلدهای ROW و COL همراه با موقعیت سلولها اضافه خواهند شد.
- --include-xy
- در صورت تنظیم، فیلدهای CENTER_X و CENTER_Y همراه با مختصات مرکز هر پیکسل اضافه خواهند شد.
- --output-layer
- نامی برای لایه برداری خروجی تعیین میکند. مقدار پیشفرض "pixels" است.
- --skip-nodata
- در صورت تنظیم، هیچ عارضهای برای پیکسلهای دارای مقدار NoData ایجاد نخواهد شد.
گزینههای استاندارد (STANDARD OPTIONS)
- --append
- تعیین میکند که آیا افزودن عارضهها به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین مجموعهداده خروجی را در صورتی که هنوز وجود نداشته باشد، ایجاد میکند.
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
فرمتها یک
یا چند
گزینه ساخت
اختیاری
دارند که
میتوان از
آنها برای
کنترل
جزئیات
فایل
ایجادشده
استفاده
کرد. برای
نمونه،
درایور GeoTIFF از
گزینههای
ساخت برای
کنترل
فشردهسازی
و
کاشیبندی
بودن یا
نبودن فایل
پشتیبانی
میکند.
میتواند تکرار شود.
گزینههای ساخت موجود بسته به درایور فرمت متفاوت هستند و برخی فرمتهای ساده اصلاً گزینه ساختی ندارند. فهرستی از گزینههای پشتیبانیشده برای یک فرمت را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات همان فرمت منبع قطعی اطلاعات درباره گزینههای ساخت درایور است. برای مشاهده گزینههای ساخت مجاز هر فرمت، به مستندات اختصاصی فرمت Raster drivers مراجعه کنید.
- --if, --input-format <format>
- نام
فرمت/درایور
برای تلاش
جهت باز
کردن
فایل(های)
ورودی.
معمولاً
نیازی به
مشخص کردن
آن نیست،
اما در
مواردی که
تشخیص
خودکار
درایور در
انتخاب
درایور
مناسب
ناموفق
باشد،
میتوان از
آن برای
نادیده
گرفتن
تشخیص
خودکار
استفاده
کرد. این
گزینه
میتواند
چندین بار
برای تعیین
چندین
درایور
کاندید
تکرار شود.
توجه داشته
باشید که
این گزینه
درایورها
را مجبور به
باز کردن
مجموعهداده
نمیکند؛
بهویژه،
برخی
درایورها
الزاماتی
برای پسوند
فایل دارند.
میتواند تکرار شود.
- --lco, --layer-creation-option <NAME>=<VALUE>
- بسیاری از
فرمتها یک
یا چند
گزینه
اختیاری
ساخت لایه
دارند که
میتوان از
آنها برای
کنترل
جزئیات
لایه
ایجادشده
استفاده
کرد. برای
نمونه،
درایور GeoPackage
از
گزینههای
ساخت لایه
برای کنترل
شناسه
عارضه یا
نام ستون
هندسه،
تنظیم
شناسه یا
توضیحات و
غیره
پشتیبانی
میکند.
میتواند تکرار شود.
گزینههای ساخت لایه موجود بسته به درایور فرمت متفاوت هستند و برخی فرمتهای ساده اصلاً هیچ گزینه ساخت لایهای ندارند. فهرستی از گزینههای پشتیبانیشده برای یک فرمت را میتوان با گزینه خط فرمان --formats فهرست کرد، اما مستندات همان فرمت منبع قطعی اطلاعات درباره گزینههای ساخت درایور است. برای گزینههای ساخت مجاز هر فرمت، به مستندات اختصاصی فرمت Vector drivers مراجعه کنید.
توجه داشته باشید که گزینههای ساخت لایه با گزینههای ساخت مجموعهداده متفاوت هستند.
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعهداده
(مخصوص هر
فرمت).
میتواند تکرار شود.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- تعیین فرمت برداری خروجی مورد استفاده. مقادیر مجاز را میتوان با دستور زیر به دست آورد: gdal --formats | grep vector | grep rw | sort
- --output-open-option, --output-oo <NAME>=<VALUE>
- در نگارش 3.12
اضافه شد.
گزینه باز کردن مجموعهداده برای مجموعهداده خروجی (مخصوص هر فرمت).
میتواند تکرار شود.
- --overwrite
- به برنامه اجازه میدهد تا فایل یا مجموعهداده مقصد موجود را بازنویسی کند. در غیر این صورت، بهطور پیشفرض، اگر فایل یا مجموعهداده مقصد از پیش وجود داشته باشد، gdal با خطا متوقف میشود.
- --overwrite-layer
- تعیین میکند که آیا بازنویسی لایه برداری خروجی موجود مجاز است یا خیر.
- --update
- تعیین میکند که آیا مجموعهداده خروجی موجود در حالت بهروزرسانی باز شود یا خیر.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمیگرداند (خطاهای غیر مسدودکننده که به صورت هشدار صادر میشوند به عنوان اجرای موفق در نظر گرفته میشوند).
مثالها (EXAMPLES)
مثال ۱: ایجاد نقاط در مرکز پیکسلهایی با مقدار کمتر از ۱۵۰
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
نویسندگان (AUTHORS)
Dan Baston <dbaston@gmail.com>
کپیرایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |