GDAL-RASTER-PIPELINE(1) GDAL GDAL-RASTER-PIPELINE(1)

gdal-raster-pipeline - پردازش یک مجموعه داده رستری با اعمال چندین مرحله

افزوده‌شده در نسخه 3.11.

دستور gdal raster pipeline می‌تواند برای پردازش یک مجموعه داده رستری و اجرای مراحل مختلف پردازشی که داده‌های رستری را دریافت کرده و داده‌های رستری تولید می‌کنند، به کار رود.

برای خط‌لوله‌هایی که داده‌های رستری و برداری را با هم ترکیب می‌کنند، به gdal pipeline مراجعه کنید.

بیشتر مراحل، ارزیابی بلوک‌های رستری را به صورت درخواستی (on-demand) انجام می‌دهند (مگر اینکه در مستندات آن‌ها خلاف این بیان شده باشد)، بدون اینکه مجموعه داده نهایی حاصل از عملیات هر مرحله را بر روی دیسک ذخیره و مادی‌سازی (materialize) کنند. گاهی اوقات ممکن است برای اهداف کارایی و سرعت پردازش، مادی‌سازی یک مجموعه داده میانی بر روی دیسک با استفاده از gdal raster materialize مطلوب باشد.

Usage: gdal raster pipeline [OPTIONS] <PIPELINE>
پردازش یک مجموعه داده رستری با اعمال چندین مرحله.
گزینه‌های عمومی:
  -h, --help              نمایش پیام راهنما و خروج
  --json-usage            نمایش نحوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>  گزینه پیکربندی [قابل تکرار]
  -q, --quiet             حالت بی‌صدا (بدون نوار پیشرفت یا هشدار) [در خط‌لوله‌ها در دسترس نیست]
الگوی <PIPELINE>:
  read|mosaic|stack [READ-OPTIONS] ( ! <STEP-NAME> [STEP-OPTIONS] )* ! info|compare|tile|write [WRITE-OPTIONS]

یک خط‌لوله چندین مرحله را که با نویسه ! (علامت تعجب) از یکدیگر جدا شده‌اند، به هم زنجیر می‌کند. نخستین مرحله باید read، calc، create، mosaic یا stack باشد، و آخرین مرحله باید write، info یا tile باشد. هر مرحله آرگومان‌های مکانی یا غیرمکانی ویژه خود را دارد. به غیر از read، calc، mosaic، stack، compare، info، tile و write، تمام مراحل دیگر می‌توانند به طور بالقوه چندین بار در یک خط‌لوله استفاده شوند.

  • aspect
  • blend
  • calc
  • clip
  • color-map
  • compare
  • create
  • edit
  • external
  • fill-nodata
  • hillshade
  • info
  • materialize
  • mosaic
  • neighbors
  • nodata-to-alpha
  • overview
  • pansharpen
  • proximity
  • read
  • reclassify
  • reproject
  • resize
  • rgb-to-palette
  • roughness
  • scale
  • select
  • set-type
  • sieve
  • slope
  • stack
  • tee
  • tile
  • tpi
  • tri
  • unscale
  • update
  • viewshed
  • write

* aspect [OPTIONS]
------------------
تولید نقشه جهت شیب (Aspect)
گزینه‌ها:
  -b, --band <BAND>              باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  --convention <CONVENTION>      قاعده زوایای خروجی. CONVENTION=azimuth|trigonometric-angle (پیش‌فرض: azimuth)
  --gradient-alg <GRADIENT-ALG>  الگوریتم مورد استفاده برای محاسبه گرادیان زمین. GRADIENT-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn)
  --zero-for-flat                تولید صفر برای مناطق مسطح
  --no-edges                     عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData

جزئیات گزینه‌ها در gdal raster aspect قابل مشاهده است.

* blend [OPTIONS] <OVERLAY>
---------------------------
ترکیب/آمیختن دو مجموعه داده رستری
آرگومان‌های مکانی:
  --overlay <OVERLAY>     مجموعه داده هم‌پوشان (Overlay) [الزامی]
گزینه‌ها:
  --operator <OPERATOR>   عملگر ترکیب. OPERATOR=src-over|hsv-value|multiply|screen|overlay|hard-light|darken|lighten|color-dodge|color-burn (پیش‌فرض: src-over)
  --opacity <OPACITY>     درصد شفافیت اعمال‌شده بر مجموعه داده هم‌پوشان (0=کاملاً شفاف، 100=استفاده کامل از شفافیت تصویر هم‌پوشان) (پیش‌فرض: 100)

جزئیات گزینه‌ها در gdal raster blend قابل مشاهده است.

* calc [OPTIONS] <INPUTS>...
----------------------------
انجام محاسبات جبر رستری
آرگومان‌های مکانی:
  -i, --input <INPUTS>                                     مجموعه‌های داده رستری ورودی [۱ یا چند مقدار] [الزامی]
گزینه‌ها:
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64
  --no-check-crs                                           عدم بررسی سازگاری سامانه‌های مرجع مختصات ورودی
  --no-check-extent                                        عدم بررسی سازگاری گستره‌های مکانی ورودی
  --propagate-nodata                                       تنظیم پیکسل‌ها به مقدار خروجی NoData در صورت NoData بودن هر یک از پیکسل‌های ورودی
  --calc <CALC>                                            عبارت(های) محاسباتی جهت ارزیابی [۱ یا چند مقدار] [الزامی]
  --dialect <DIALECT>                                      گویش عبارت محاسباتی. DIALECT=muparser|builtin (پیش‌فرض: muparser)
  --flatten                                                تولید یک رستر خروجی تک‌باندی به ازای هر عبارت، حتی اگر داده‌های ورودی چندباندی باشند
  --nodata <NODATA>                                        اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf')
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                      قالب‌های ورودی [قابل تکرار]
  --oo, --open-option <KEY>=<VALUE>                        گزینه‌های باز کردن [قابل تکرار]

جزئیات گزینه‌ها در gdal raster calc قابل مشاهده است.

* clip [OPTIONS]
----------------
برش یک مجموعه داده رستری.
گزینه‌ها:
  --bbox <BBOX>                    کادر محصورکننده برش به صورت xmin,ymin,xmax,ymax
                                   ناسازگار با --window، --geometry، --like
  --bbox-crs <BBOX-CRS>            سامانه مرجع مختصات (CRS) کادر محصورکننده برش
  --window <WINDOW>                پنجره رستر به صورت col,line,width,height بر حسب پیکسل
                                   ناسازگار با --bbox، --geometry، --like
  --geometry <GEOMETRY>            هندسه برش (WKT یا GeoJSON)
                                   ناسازگار با --bbox، --window، --like
  --geometry-crs <GEOMETRY-CRS>    سامانه مرجع مختصات (CRS) هندسه برش
  --like <DATASET>                 مجموعه داده به عنوان الگو برای محدوده‌ها
                                   ناسازگار با --bbox، --window، --geometry
  --like-sql <SELECT-STATEMENT>    عبارت SELECT برای اجرا روی مجموعه داده 'like'
                                   ناسازگار با --like-where
  --like-layer <LAYER-NAME>        نام لایه مجموعه داده 'like'
  --like-where <WHERE-EXPRESSION>  عبارت شرطی WHERE در SQL برای اجرا روی مجموعه داده 'like'
                                   ناسازگار با --like-sql
  --only-bbox                      برای 'geometry' و 'like'، صرفاً کادر محصورکننده آن‌ها در نظر گرفته شود
  --allow-bbox-outside-source      اجازه به کادر برش برای دربرگرفتن پیکسل‌های خارج از مجموعه داده ورودی
  --add-alpha                      افزودن باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد.

جزئیات گزینه‌ها در gdal raster clip قابل مشاهده است.

* color-map [OPTIONS]
---------------------
تولید مجموعه داده RGB یا RGBA از یک تک‌باند با استفاده از نقشه‌رنگ
گزینه‌ها:
  -b, --band <BAND>                    باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  --color-map <COLOR-MAP>              نام فایل نقشه‌رنگ
  --add-alpha                          افزودن باند ماسک آلفا به مقصد.
  --color-selection <COLOR-SELECTION>  نحوه محاسبه رنگ‌های خروجی از مقادیر ورودی. COLOR-SELECTION=interpolate|exact|nearest (پیش‌فرض: interpolate)

جزئیات گزینه‌ها در gdal raster color-map قابل مشاهده است.

افزوده‌شده در نسخه 3.12.

* compare [OPTIONS] <REFERENCE>
-------------------------------
مقایسه دو مجموعه داده رستری.
آرگومان‌های مکانی:
  --reference <REFERENCE>  مجموعه داده مرجع [الزامی]
گزینه‌ها:
  --skip-all-optional      صرف‌نظر از تمامی مقایسه‌های اختیاری
  --skip-binary            صرف‌نظر از مقایسه فایل باینری
  --skip-crs               صرف‌نظر از مقایسه سامانه مرجع مختصات (CRS)
  --skip-geotransform      صرف‌نظر از مقایسه تبدیل زمین‌مرجع (geotransform)
  --skip-overview          صرف‌نظر از مقایسه نماهای کلی (overviews)
  --skip-metadata          صرف‌نظر از مقایسه فراداده‌ها
  --skip-rpc               صرف‌نظر از مقایسه فراداده‌های RPC
  --skip-geolocation       صرف‌نظر از مقایسه فراداده‌های موقعیت مکانی (Geolocation)
  --skip-subdataset        صرف‌نظر از مقایسه زیرمجموعه‌های داده (subdatasets)

جزئیات گزینه‌ها در gdal raster compare قابل مشاهده است.

* create [OPTIONS]
------------------
ایجاد یک مجموعه داده رستری جدید.
گزینه‌ها:
  -i, --like, --input <TEMPLATE-DATASET>                   مجموعه داده رستری الگو
  --size <width>,<height>                                  اندازه خروجی بر حسب پیکسل
  --band-count <BAND-COUNT>                                تعداد باندها (پیش‌فرض: 1)
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 (پیش‌فرض: Byte)
  --nodata <NODATA>                                        اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf')
  --burn <BURN>                                            مقدار درج/حک کردن [قابل تکرار]
  --crs <CRS>                                              تنظیم سامانه مرجع مختصات (CRS)
  --bbox <BBOX>                                            کادر محصورکننده به صورت xmin,ymin,xmax,ymax
  --metadata <KEY>=<VALUE>                                 افزودن مورد فراداده [قابل تکرار]
  --copy-metadata                                          کپی کردن فراداده از مجموعه داده ورودی
                                                           وابسته به --input
  --copy-overviews                                         ایجاد سطوح نمای کلی مشابه با مجموعه داده ورودی
                                                           وابسته به --input
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                      قالب‌های ورودی [قابل تکرار]
  --oo, --open-option <KEY>=<VALUE>                        گزینه‌های باز کردن [قابل تکرار]

جزئیات گزینه‌ها در gdal raster create قابل مشاهده است.

* edit [OPTIONS]
----------------
ویرایش یک مجموعه داده رستری.
گزینه‌ها:
  -b, --band <BAND>                                           باند فعال (شاخص با شروع از ۱)
  --crs <CRS>                                                 بازنویسی سامانه مرجع مختصات (بدون بازپروژکشن)
  --bbox <BBOX>                                               کادر محصورکننده به صورت xmin,ymin,xmax,ymax
  --nodata <NODATA>                                           اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf')
  --color-interpretation <[all|<BAND>=]<COLOR-INTEPRETATION>  تنظیم تفسیر رنگ باند [قابل تکرار]
  --color-map <COLOR-MAP>                                     نام فایل نقشه‌رنگ
                                                              ناسازگار با --unset-color-table
  --scale <[<BAND>=]<SCALE>                                   بازنویسی ضریب مقیاس باند [قابل تکرار]
  --offset <[<BAND>=]<OFFSET>                                 بازنویسی ثابت آفست باند [قابل تکرار]
  --metadata <KEY>=<VALUE>                                    افزودن/به‌روزرسانی مورد فراداده مجموعه داده [قابل تکرار]
  --unset-color-table                                         حذف جدول رنگ روی باند ۱ یا باند مشخص‌شده با --band
                                                              ناسازگار با --color-map
  --unset-metadata <KEY>                                      حذف مورد(های) فراداده مجموعه داده [قابل تکرار]
  --unset-metadata-domain <DOMAIN>                            حذف دامنه(های) فراداده مجموعه داده [قابل تکرار]
  --gcp <GCP>                                                 افزودن نقطه کنترل زمینی به قالب pixel,line,easting,northing[,elevation] یا @filename [قابل تکرار]

جزئیات گزینه‌ها در gdal raster edit قابل مشاهده است.

* external [OPTIONS] <COMMAND>
------------------------------
اجرای یک برنامه خارجی به عنوان مرحله‌ای از خط‌لوله
آرگومان‌های مکانی:
  --command <COMMAND>                                  دستور خارجی، اختیاری همراه با متغیرهای جانگهدارنده <INPUT> و/یا <OUTPUT> یا <INPUT-OUTPUT> [الزامی]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  قالب‌های ورودی

جزئیات گزینه‌ها در gdal external قابل مشاهده است.

* fill-nodata [OPTIONS]
-----------------------
پر کردن نواحی NoData در رستر با درون‌یابی از لبه‌ها.
گزینه‌ها:
  -b, --band <BAND>                                  باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  -d, --max-distance <MAX_DISTANCE>                  حداکثر فاصله (بر حسب پیکسل) برای جستجوی مقادیر جهت درون‌یابی توسط الگوریتم (پیش‌فرض: 100)
  -s, --smoothing-iterations <SMOOTHING_ITERATIONS>  تعداد دفعات تکرار صاف‌سازی فیلتر میانگین 3x3 پس از درون‌یابی جهت تعدیل مصنوعات و نویزها (پیش‌فرض: 0)
  --mask <MASK>                                      استفاده از باند اول فایل مشخص‌شده به عنوان ماسک اعتبار (صفر نامعتبر، غیرصفر معتبر).
  --strategy <STRATEGY>                              به طور پیش‌فرض پیکسل‌ها با وزن‌دهی معکوس فاصله (invdist) درون‌یابی می‌شوند. انتخاب راهبرد نزدیک‌ترین همسایه (nearest) نیز ممکن است. STRATEGY=invdist|nearest (پیش‌فرض: invdist)

جزئیات گزینه‌ها در gdal raster fill-nodata قابل مشاهده است.

* hillshade [OPTIONS]
---------------------
تولید نقشه سایه‌روشن ناهمواری‌ها (Hillshade)
گزینه‌ها:
  -b, --band <BAND>              باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  -z, --zfactor <ZFACTOR>        ضریب اغراق عمودی برای پیش‌ضرب در ارتفاعات
  --xscale <XSCALE>              نسبت واحدهای عمودی به واحدهای افقی محور X
  --yscale <YSCALE>              نسبت واحدهای عمودی به واحدهای افقی محور Y
  --azimuth <AZIMUTH>            زاویه افقی (آزیموت) نور بر حسب درجه (پیش‌فرض: 315)
  --altitude <ALTITUDE>          زاویه ارتفاع نور بر حسب درجه (پیش‌فرض: 45)
  --gradient-alg <GRADIENT-ALG>  الگوریتم محاسبه گرادیان زمین. GRADIENT-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn)
  --variant <VARIANT>            گونه الگوریتم سایه‌روشن. VARIANT=regular|combined|multidirectional|Igor (پیش‌فرض: regular)
  --no-edges                     عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData

جزئیات گزینه‌ها در gdal raster hillshade قابل مشاهده است.

افزوده‌شده در نسخه 3.12.

* info [OPTIONS]
----------------
بازگرداندن اطلاعات یک مجموعه داده رستری.
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی. OUTPUT-FORMAT=json|text
  --mm, --min-max                                      محاسبه حداقل و حداکثر مقادیر
  --stats                                              دریافت یا محاسبه آمارها با استفاده از تمام پیکسل‌ها
                                                       ناسازگار با --approx-stats
  --approx-stats                                       دریافت یا محاسبه آمارها با استفاده از زیرمجموعه‌ای از پیکسل‌ها
                                                       ناسازگار با --stats
  --hist                                               دریافت یا محاسبه هیستوگرام
گزینه‌های پیشرفته:
  --no-gcp                                             عدم چاپ فهرست نقاط کنترل زمینی
  --no-md                                              عدم چاپ فراداده‌ها
  --no-ct                                              عدم چاپ جدول رنگ
  --no-fl                                              عدم چاپ فهرست فایل‌ها
  --checksum                                           محاسبه چکسام پیکسل‌ها
  --list-metadata-domains, --list-mdd                  فهرست کردن تمام دامنه‌های فراداده موجود برای مجموعه داده
  --mdd, --metadata-domain <METADATA-DOMAIN>           گزارش فراداده برای دامنه مشخص‌شده. از 'all' می‌توان برای گزارش فراداده در همه دامنه‌ها استفاده کرد
گزینه‌های خاص:
  --no-nodata                                          عدم دریافت مقدار NoData
  --no-mask                                            عدم نمایش اطلاعات باند ماسک
  --subdataset <SUBDATASET>                            استفاده از زیرمجموعه داده با شاخص مشخص (شروع از ۱) به جای خود مجموعه داده اصلی
  --crs-format <CRS-FORMAT>                            قالب مورد استفاده برای گزارش CRS. CRS-FORMAT=AUTO|WKT2|PROJJSON (پیش‌فرض: AUTO)

جزئیات گزینه‌ها در gdal raster info قابل مشاهده است.

* materialize [OPTIONS]
-----------------------
مادی‌سازی (ذخیره روی دیسک) یک مجموعه داده لوله‌کشی‌شده برای افزایش کارایی مراحل بعدی.
گزینه‌ها:
  -o, --output <OUTPUT>                                نام مجموعه داده مادی‌سازی‌شده (ایجادشده توسط الگوریتم)
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی
  --co, --creation-option <KEY>=<VALUE>                گزینه ایجاد [قابل تکرار]
  --overwrite                                          آیا بازنویسی مجموعه داده خروجی موجود مجاز است یا خیر

جزئیات گزینه‌ها در gdal raster materialize قابل مشاهده است.

* mosaic [OPTIONS] <INPUTS>...
------------------------------
ساخت یک موزاییک، به صورت مجازی (VRT) یا مادی‌سازی‌شده.
آرگومان‌های مکانی:
  -i, --input <INPUTS>                                            مجموعه‌های داده رستری ورودی (یا تعیین @<filename> برای اشاره به فایل حاوی نام‌ها) [۱ یا چند مقدار] [الزامی]
گزینه‌ها:
  -b, --band <BAND>                                               باند(های) ورودی (شاخص با شروع از ۱) [قابل تکرار]
  --absolute-path                                                 ذخیره مسیر مجموعه‌های داده ورودی به عنوان مسیر مطلق
  --resolution <xres>,<yres>|same|average|common|highest|lowest>  تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد) (پیش‌فرض: same)
  --bbox <BBOX>                                                   کادر محصورکننده هدف به صورت xmin,ymin,xmax,ymax (بر حسب واحدهای CRS مقصد)
  --target-aligned-pixels                                         گرد کردن گستره هدف به تفکیک‌پذیری هدف
  --input-nodata <INPUT-NODATA>                                   تنظیم مقادیر NoData برای باندهای ورودی. [۱ یا چند مقدار]
  --output-nodata <OUTPUT-NODATA>                                 تنظیم مقادیر NoData در سطح باند مقصد. [۱ یا چند مقدار]
  --hide-nodata                                                   عدم گزارش مقدار NoData توسط باند مقصد.
  --add-alpha                                                     افزودن باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد.
  --pixel-function <PIXEL-FUNCTION>                               تعیین یک تابع پیکسلی برای محاسبه مقدار خروجی از ورودی‌های هم‌پوشان. PIXEL-FUNCTION=area|argmax|argmin|cmul|complex|conj|dB|dB2amp|dB2pow|diff|div|exp|expression|geometric_mean|harmonic_mean|imag|intensity|interpolate_exp|interpolate_linear|inv|log10|max|mean|median|min|mod|mode|mul|norm_diff|phase|polar|pow|quantile|real|reclassify|replace_nodata|round|scale|sqrt|sum
  --pixel-function-arg <NAME>=<VALUE>                             تعیین آرگومان(ها) برای ارسال به تابع پیکسلی [قابل تکرار]
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                             قالب‌های ورودی [قابل تکرار]
  --oo, --open-option <KEY>=<VALUE>                               گزینه‌های باز کردن [قابل تکرار]

جزئیات گزینه‌ها در gdal raster mosaic قابل مشاهده است.

* neighbors [OPTIONS]
---------------------
محاسبه مقدار هر پیکسل از روی همسایگان آن (آماره‌های کانونی / Focal Statistics)
گزینه‌ها:
  -b, --band <BAND>                                        باند ورودی (شاخص با شروع از ۱)
  --method <METHOD>                                        روش ترکیب پیکسل‌های وزن‌دار مبدأ. METHOD=mean|sum|min|max|stddev|median|mode [قابل تکرار]
  --size <SIZE>                                            اندازه همسایگی
  --kernel <KERNEL>                                        هسته(های) کانولوشن برای اعمال [۱ یا چند مقدار] [الزامی]
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 (پیش‌فرض: Float64)
  --nodata <NODATA>                                        اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf')

جزئیات گزینه‌ها در gdal raster neighbors قابل مشاهده است.

* nodata-to-alpha [OPTIONS]
---------------------------
جایگزینی مقدار(های) NoData با یک باند آلفا.
گزینه‌ها:
  --nodata <NODATA>       بازنویسی مقدار NoData در باند(های) ورودی (مقدار عددی، 'nan'، 'inf'، '-inf') [قابل تکرار]

جزئیات گزینه‌ها در gdal raster nodata-to-alpha قابل مشاهده است.

* overview <COMMAND> [OPTIONS]
------------------------------
که در آن <COMMAND> یکی از موارد زیر است:
  - add: افزودن نماهای کلی (overviews).

جزئیات گزینه‌ها در gdal raster overview قابل مشاهده است.

* pansharpen [OPTIONS] <SPECTRAL>...
------------------------------------
انجام عملیات پان‌شارپنینگ (افزایش وضوح تصویر با باند پانکروماتیک).
آرگومان‌های مکانی:
  --spectral <SPECTRAL>                                    مجموعه داده باندهای طیفی ورودی [۱ یا چند مقدار] [الزامی]
گزینه‌ها:
  -r, --resampling <RESAMPLING>                            الگوریتم بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average (پیش‌فرض: cubic)
  --weights <WEIGHTS>                                      وزن برای هر باند طیفی ورودی [قابل تکرار]
  --nodata <NODATA>                                        بازنویسی مقدار NoData برای باندهای ورودی
  --bit-depth <BIT-DEPTH>                                  بازنویسی عمق بیتی باندهای ورودی
  --spatial-extent-adjustment <SPATIAL-EXTENT-ADJUSTMENT>  انتخاب رفتار هنگام متفاوت بودن گستره مکانی باندها. SPATIAL-EXTENT-ADJUSTMENT=union|intersection|none|none-without-warning (پیش‌فرض: union)
  -j, --num-threads <NUM-THREADS>                          تعداد کارها (یا ALL_CPUS) (پیش‌فرض: ALL_CPUS)

جزئیات گزینه‌ها در gdal raster pansharpen قابل مشاهده است.

* proximity [OPTIONS]
---------------------
تولید یک نقشه مجاورت/فاصله رستری.
گزینه‌ها:
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64|Byte|UInt16|Int16|UInt32|Int32|Float32|Float64 (پیش‌فرض: Float32)
  -b, --band <BAND>                                        باند ورودی (شاخص با شروع از ۱)
  --target-values <TARGET-VALUES>                          مقادیر پیکسلی هدف [قابل تکرار]
  --distance-units <DISTANCE-UNITS>                        واحدهای فاصله. DISTANCE-UNITS=pixel|geo (پیش‌فرض: pixel)
  --max-distance <MAX-DISTANCE>                            حداکثر فاصله. مقدار NoData برای پیکسل‌های فراتر از این فاصله استفاده خواهد شد (پیش‌فرض: 0)
  --fixed-value <FIXED-VALUE>                              مقدار ثابت برای پیکسل‌هایی که در محدوده حداکثر فاصله قرار دارند (به جای فاصله واقعی) (پیش‌فرض: 0)
  --nodata <NODATA>                                        تعیین یک مقدار NoData برای استفاده در پیکسل‌های فراتر از حداکثر فاصله

جزئیات گزینه‌ها در gdal raster proximity قابل مشاهده است.

* read [OPTIONS] <INPUT>
------------------------
خواندن یک مجموعه داده رستری.
آرگومان‌های مکانی:
  -i, --input <INPUT>                  مجموعه‌های داده رستری ورودی [الزامی]
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>  قالب‌های ورودی [قابل تکرار]
  --oo, --open-option <KEY>=<VALUE>    گزینه‌های باز کردن [قابل تکرار]

جزئیات گزینه‌ها در gdal raster pipeline read قابل مشاهده است.

* reclassify [OPTIONS]
----------------------
بازطبقه‌بندی مقادیر در یک مجموعه داده رستری
گزینه‌ها:
  -m, --mapping <MAPPING>                                  نگاشت‌های بازطبقه‌بندی (یا تعیین @<filename> برای اشاره به فایلی شامل نگاشت‌ها) [الزامی]
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64

جزئیات گزینه‌ها در gdal raster reclassify قابل مشاهده است.

* reproject [OPTIONS]
---------------------
تغییر تصویر (بازپروژکشن) یک مجموعه داده رستری.
گزینه‌ها:
  -s, --input-crs <INPUT-CRS>                سامانه مرجع مختصات (CRS) ورودی
  --like <DATASET>                           مجموعه داده به عنوان الگو برای محدوده‌های هدف، CRS، اندازه و NoData
  -d, --output-crs <OUTPUT-CRS>              سامانه مرجع مختصات (CRS) خروجی
  -r, --resampling <RESAMPLING>              روش بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (پیش‌فرض: nearest)
  --resolution <xres>,<yres>                 تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد)
                                             ناسازگار با --size
  --size <width>,<height>                    اندازه هدف بر حسب پیکسل
                                             ناسازگار با --resolution
  --bbox <BBOX>                              کادر محصورکننده هدف (بر حسب واحدهای CRS مقصد)
  --bbox-crs <BBOX-CRS>                      سامانه مرجع مختصات (CRS) کادر محصورکننده هدف
  -j, --num-threads <NUM-THREADS>            تعداد کارها (یا ALL_CPUS) (پیش‌فرض: ALL_CPUS)
گزینه‌های پیشرفته:
  --target-aligned-pixels                    گرد کردن گستره هدف به تفکیک‌پذیری هدف
  --input-nodata <INPUT-NODATA>              تنظیم مقادیر NoData برای باندهای ورودی ('None' برای حذف). [۱ یا چند مقدار]
  --output-nodata <OUTPUT-NODATA>            تنظیم مقادیر NoData برای باندهای خروجی ('None' برای حذف). [۱ یا چند مقدار]
  --add-alpha                                افزودن باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد.
  --wo, --warp-option <NAME>=<VALUE>         گزینه(های) انحنا/تغییر شکل (Warping) [قابل تکرار]
  --to, --transform-option <NAME>=<VALUE>    گزینه(های) تبدیل (Transform) [قابل تکرار]
  --et, --error-threshold <ERROR-THRESHOLD>  آستانه خطا

جزئیات گزینه‌ها در gdal raster reproject قابل مشاهده است.

* resize [OPTIONS]
------------------
تغییر اندازه یک مجموعه داده رستری بدون تغییر در گستره‌های زمین‌مرجع‌شده.
گزینه‌ها:
  --resolution <xres>,<yres>     تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد)
                                 ناسازگار با --size
  --size <width[%]>,<height[%]>  اندازه هدف بر حسب پیکسل (یا درصد در صورت استفاده از پسوند '%') [الزامی]
                                 ناسازگار با --resolution
  -r, --resampling <RESAMPLING>  روش بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|mode (پیش‌فرض: nearest)

جزئیات گزینه‌ها در gdal raster resize قابل مشاهده است.

* rgb-to-palette [OPTIONS]
--------------------------
تبدیل یک تصویر RGB به یک تصویر رنگ کاذب / پالت‌دار.
گزینه‌ها:
  --color-count <COLOR-COUNT>      انتخاب تعداد رنگ‌ها در جدول رنگ تولیدشده (پیش‌فرض: 256)
  --color-map <COLOR-MAP>          نام فایل نقشه‌رنگ
  --output-nodata <OUTPUT-NODATA>  مقدار NoData خروجی
  --no-dither                      غیرفعال‌سازی دیترینگ فلوید-اشتاینبرگ (Floyd-Steinberg)
  --bit-depth <BIT-DEPTH>          عمق بیتی مؤلفه پالت رنگ (۸ بیت زمان محاسبات را طولانی‌تر می‌کند). BIT-DEPTH=5|8 (پیش‌فرض: 5)

جزئیات گزینه‌ها در gdal raster rgb-to-palette قابل مشاهده است.

* roughness [OPTIONS]
---------------------
تولید نقشه زبری ناهمواری‌ها (Roughness)
گزینه‌ها:
  -b, --band <BAND>       باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  --no-edges              عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData

جزئیات گزینه‌ها در gdal raster roughness قابل مشاهده است.

* scale [OPTIONS]
-----------------
مقیاس‌بندی مقادیر باندهای یک مجموعه داده رستری.
گزینه‌ها:
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64
  -b, --band <BAND>                                        انتخاب باند جهت محدود کردن مقیاس‌بندی (شاخص با شروع از ۱)
  --input-min <INPUT-MIN>                                  حداقل مقدار محدوده مبدأ
                                                           وابسته به --input-max
  --input-max <INPUT-MAX>                                  حداکثر مقدار محدوده مبدأ
                                                           وابسته به --input-min
  --output-min <OUTPUT-MIN>                                حداقل مقدار محدوده مقصد
                                                           وابسته به --output-max
  --output-max <OUTPUT-MAX>                                حداکثر مقدار محدوده مقصد
                                                           وابسته به --output-min
  --exponent <EXPONENT>                                    نما برای اعمال مقیاس‌بندی غیرخطی با یک تابع توانی
  --no-clip                                                عدم محدودسازی و برش مقادیر ورودی به بازه [input-min, input-max]

جزئیات گزینه‌ها در gdal raster scale قابل مشاهده است.

* select [OPTIONS] <BAND>
-------------------------
انتخاب زیرمجموعه‌ای از باندها از یک مجموعه داده رستری.
آرگومان‌های مکانی:
  -b, --band <BAND>       باند(ها) (شاخص با شروع از ۱، 'mask'، 'mask:<band>' یا تفسیر رنگ نظیر 'red') [۱ یا چند مقدار] [الزامی]
گزینه‌ها:
  --exclude               مستثنی‌کردن باندهای مشخص‌شده
  --mask <MASK>           باند ماسک (شاخص با شروع از ۱، 'mask'، 'mask:<band>' یا 'none')

جزئیات گزینه‌ها در gdal raster select قابل مشاهده است.

* set-type [OPTIONS]
--------------------
تغییر نوع داده باندهای یک مجموعه داده رستری.
گزینه‌ها:
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 [الزامی]

جزئیات گزینه‌ها در gdal raster set-type قابل مشاهده است.

* sieve [OPTIONS]
-----------------
حذف چندضلعی‌های کوچک از یک مجموعه داده رستری.
گزینه‌ها:
  --mask <MASK>                          استفاده از نخستین باند فایل مشخص‌شده به عنوان ماسک اعتبار (تمام پیکسل‌های با مقداری غیر از صفر مناسب برای گنجانده شدن در چندضلعی‌ها در نظر گرفته می‌شوند)
  -b, --band <BAND>                      باند ورودی (شاخص با شروع از ۱)
  -s, --size-threshold <SIZE-THRESHOLD>  حداقل اندازه چندضلعی‌ها برای نگه‌داری (پیش‌فرض: 2)
  -c, --connect-diagonal-pixels          متصل در نظر گرفتن پیکسل‌های مورب/قطری

جزئیات گزینه‌ها در gdal raster sieve قابل مشاهده است.

* slope [OPTIONS]
-----------------
تولید یک نقشه شیب (Slope)
گزینه‌ها:
  -b, --band <BAND>              باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  --unit <UNIT>                  واحد بیان شیب. UNIT=degree|percent (پیش‌فرض: degree)
  --xscale <XSCALE>              نسبت واحدهای عمودی به واحدهای افقی محور X
  --yscale <YSCALE>              نسبت واحدهای عمودی به واحدهای افقی محور Y
  --gradient-alg <GRADIENT-ALG>  الگوریتم محاسبه گرادیان زمین. GRADIENT-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn)
  --no-edges                     عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData

جزئیات گزینه‌ها در gdal raster slope قابل مشاهده است.

* stack [OPTIONS] <INPUTS>...
-----------------------------
ترکیب باندهای ورودی در یک خروجی چندباندی، به صورت مجازی (VRT) یا مادی‌سازی‌شده.
آرگومان‌های مکانی:
  -i, --input <INPUTS>                                            مجموعه‌های داده رستری ورودی (یا تعیین @<filename> برای اشاره به فایل حاوی نام‌ها) [۱ یا چند مقدار] [الزامی]
گزینه‌ها:
  -b, --band <BAND>                                               باند(های) ورودی (شاخص با شروع از ۱) [قابل تکرار]
  --absolute-path                                                 ذخیره مسیر مجموعه‌های داده ورودی به عنوان مسیر مطلق
  --resolution <xres>,<yres>|same|average|common|highest|lowest>  تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد) (پیش‌فرض: same)
  --bbox <BBOX>                                                   کادر محصورکننده هدف به صورت xmin,ymin,xmax,ymax (بر حسب واحدهای CRS مقصد)
  --target-aligned-pixels                                         گرد کردن گستره هدف به تفکیک‌پذیری هدف
  --input-nodata <INPUT-NODATA>                                   تنظیم مقادیر NoData برای باندهای ورودی. [۱ یا چند مقدار]
  --output-nodata <OUTPUT-NODATA>                                 تنظیم مقادیر NoData در سطح باند مقصد. [۱ یا چند مقدار]
  --hide-nodata                                                   عدم گزارش مقدار NoData توسط باند مقصد.
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                             قالب‌های ورودی [قابل تکرار]
  --oo, --open-option <KEY>=<VALUE>                               گزینه‌های باز کردن [قابل تکرار]

جزئیات گزینه‌ها در gdal raster stack قابل مشاهده است.

* tee [OPTIONS] [<PIPELINE>...]
-------------------------------
هدایت ورودی به جریان خروجی و خط‌لوله‌های تودرتوی جانبی.
آرگومان‌های مکانی:
  --tee-pipeline <PIPELINE>  خط‌لوله تودرتو [۱ یا چند مقدار]

جزئیات گزینه‌ها در بخش خط‌لوله‌های تودرتوی خروجی قابل مشاهده است.

افزوده‌شده در نسخه 3.12.

* tile [OPTIONS] <OUTPUT>
-------------------------
تولید کاشی‌ها (Tiles) در فایل‌های جداگانه از یک مجموعه داده رستری.
آرگومان‌های مکانی:
  -o, --output <OUTPUT>                                            دایرکتوری خروجی [الزامی]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>              قالب خروجی (پیش‌فرض: PNG)
  --co, --creation-option <KEY>=<VALUE>                            گزینه ایجاد [قابل تکرار]
  --tiling-scheme <TILING-SCHEME>                                  طرح‌واره کاشی‌بندی. TILING-SCHEME=raster|WebMercatorQuad|WorldCRS84Quad|WorldMercatorWGS84Quad|GoogleCRS84Quad|PseudoTMS_GlobalMercator|GlobalGeodeticOriginLat270|LINZAntarticaMapTilegrid|APSTILE|CBMTILE|NZTM2000 (پیش‌فرض: WebMercatorQuad)
  --min-zoom <MIN-ZOOM>                                            حداقل سطح بزرگ‌نمایی
  --max-zoom <MAX-ZOOM>                                            حداکثر سطح بزرگ‌نمایی
  --min-x <MIN-X>                                                  حداقل مختصات X کاشی
  --max-x <MAX-X>                                                  حداکثر مختصات X کاشی
  --min-y <MIN-Y>                                                  حداقل مختصات Y کاشی
  --max-y <MAX-Y>                                                  حداکثر مختصات Y کاشی
  --no-intersection-ok                                             عدم تقاطع گستره مجموعه داده با ماتریس کاشی صرفاً یک هشدار باشد
  -r, --resampling <RESAMPLING>                                    روش بازنمونه‌برداری برای حداکثر زوم. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (پیش‌فرض: cubic)
  --overview-resampling <OVERVIEW-RESAMPLING>                      روش بازنمونه‌برداری برای نماهای کلی. OVERVIEW-RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum
  --convention <CONVENTION>                                        قاعده شماره‌گذاری کاشی‌ها: xyz (از بالا) یا tms (از پایین). CONVENTION=xyz|tms (پیش‌فرض: xyz)
  --tile-size <TILE-SIZE>                                          بازنویسی اندازه پیش‌فرض کاشی
  --add-alpha                                                      اجبار به افزودن کانال آلفا
                                                                   ناسازگار با --no-alpha
  --no-alpha                                                       غیرفعال‌سازی افزودن کانال آلفا
                                                                   ناسازگار با --add-alpha
  --output-nodata <OUTPUT-NODATA>                                  مقدار NoData خروجی
  --skip-blank                                                     عدم تولید کاشی‌های خالی
  --metadata <KEY>=<VALUE>                                         افزودن مورد فراداده به کاشی‌های خروجی [قابل تکرار]
  --copy-src-metadata                                              کپی فراداده از مجموعه داده مبدأ
  --aux-xml                                                        تولید فایل‌های جانبی .aux.xml در صورت نیاز
  --kml                                                            تولید فایل‌های KML
  --resume                                                         تولید تنها فایل‌های ناموجود
  -j, --num-threads <NUM-THREADS>                                  تعداد کارها (یا ALL_CPUS) (پیش‌فرض: ALL_CPUS)
  --parallel-method <PARALLEL-METHOD>                              روش موازی‌سازی (thread, spawn, fork). PARALLEL-METHOD=thread|spawn|fork
گزینه‌های پیشرفته بازنمونه‌برداری:
  --excluded-values <EXCLUDED-VALUES>                              چندتایی‌های مقادیر (مانند <R>,<G>,<B> یا (<R1>,<G1>,<B1>),(<R2>,<G2>,<B2>)) که باید هنگام بازنمونه‌برداری (میانگین) به عنوان پیکسل‌های مبدأ نادیده گرفته شوند
  --excluded-values-pct-threshold <EXCLUDED-VALUES-PCT-THRESHOLD>  حداقل درصد پیکسل‌های مبدأ که باید روی یکی از --excluded-values تنظیم شده باشند تا مقدار مستثنی‌شده به عنوان مقدار پیکسل هدف استفاده شود (پیش‌فرض: 50)
  --nodata-values-pct-threshold <NODATA-VALUES-PCT-THRESHOLD>      حداقل درصد پیکسل‌های مبدأ که باید روی مقدار NoData (یا alpha=0 یا هر روش بیان شفافیت) تنظیم شده باشند تا پیکسل هدف شفاف شود (پیش‌فرض: 100)
گزینه‌های انتشار:
  --webviewer <WEBVIEWER>                                          نمایشگر وبی که تولید می‌شود. WEBVIEWER=none|all|leaflet|openlayers|mapml|stac (پیش‌فرض: all) [قابل تکرار]
  --url <URL>                                                      نشانی URL جایی که کاشی‌های تولیدشده منتشر خواهند شد
  --title <TITLE>                                                  عنوان نقشه
  --copyright <COPYRIGHT>                                          حق نشر نقشه
  --mapml-template <MAPML-TEMPLATE>                                نام فایل الگوی mapml که متغیرها در آن جایگزین خواهند شد

جزئیات گزینه‌ها در gdal raster tile قابل مشاهده است.

* tpi [OPTIONS]
---------------
تولید نقشه شاخص موقعیت توپوگرافی (TPI)
گزینه‌ها:
  -b, --band <BAND>       باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  --no-edges              عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData

جزئیات گزینه‌ها در gdal raster tpi قابل مشاهده است.

* tri [OPTIONS]
---------------
تولید نقشه شاخص ناهمواری زمین (TRI)
گزینه‌ها:
  -b, --band <BAND>        باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  --algorithm <ALGORITHM>  الگوریتم محاسبه TRI. ALGORITHM=Riley|Wilson (پیش‌فرض: Riley)
  --no-edges               عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData

جزئیات گزینه‌ها در gdal raster tri قابل مشاهده است.

* unscale [OPTIONS]
-------------------
تبدیل مقادیر مقیاس‌بندی‌شده یک مجموعه داده رستری به مقادیر بدون مقیاس.
گزینه‌ها:
  --ot, --datatype, --output-data-type <OUTPUT-DATA-TYPE>  نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64

جزئیات گزینه‌ها در gdal raster unscale قابل مشاهده است.

* update [OPTIONS] <OUTPUT>
---------------------------
به‌روزرسانی رستر مقصد با محتوای رستر ورودی.
آرگومان‌های مکانی:
  -o, --output <OUTPUT>                      مجموعه داده رستری خروجی [الزامی]
گزینه‌ها:
  --geometry <GEOMETRY>                      هندسه برش (WKT یا GeoJSON)
  --geometry-crs <GEOMETRY-CRS>              سامانه مرجع مختصات (CRS) هندسه برش
  -r, --resampling <RESAMPLING>              روش بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (پیش‌فرض: nearest)
  --no-update-overviews                      عدم به‌روزرسانی نماهای کلی موجود
گزینه‌های پیشرفته:
  --wo, --warp-option <NAME>=<VALUE>         گزینه(های) انحنا/تغییر شکل (Warping) [قابل تکرار]
  --to, --transform-option <NAME>=<VALUE>    گزینه(های) تبدیل (Transform) [قابل تکرار]
  --et, --error-threshold <ERROR-THRESHOLD>  آستانه خطا

جزئیات گزینه‌ها در gdal raster update قابل مشاهده است.

* viewshed [OPTIONS]
--------------------
محاسبه حوزه دید (Viewshed) یک مجموعه داده رستری.
گزینه‌ها:
  -p, --pos, --position <X,Y> or <X,Y,H>           موقعیت ناظر [۲ تا ۳ مقدار]
  -z, --height <HEIGHT>                            ارتفاع ناظر
  --sd-filename <SD-FILENAME>                      نام فایل رستر انحراف معیار
  --target-height <TARGET-HEIGHT>                  ارتفاع هدف بالای سطح DEM بر حسب واحد ارتفاع DEM (پیش‌فرض: 0)
  --mode <MODE>                                    تعیین نوع اطلاعات خروجی. MODE=normal|DEM|ground|cumulative (پیش‌فرض: normal)
  --max-distance <MAX-DISTANCE>                    حداکثر فاصله از ناظر برای محاسبه دیده‌شدن. همچنین برای تحدید گستره رستر خروجی استفاده می‌شود.
  --min-distance <MIN-DISTANCE>                    ماسک کردن تمام سلول‌های با فاصله کمتر از این مقدار از ناظر. باید کمتر از 'max-distance' باشد.
  --start-angle <START-ANGLE>                      ماسک کردن تمام سلول‌های خارج از کمان ('start-angle', 'end-angle'). زاویه در جهت عقربه‌های ساعت از شمال. همچنین برای تحدید گستره رستر خروجی استفاده می‌شود.
  --end-angle <END-ANGLE>                          ماسک کردن تمام سلول‌های خارج از کمان ('start-angle', 'end-angle'). زاویه در جهت عقربه‌های ساعت از شمال. همچنین برای تحدید گستره رستر خروجی استفاده می‌شود.
  --high-pitch <HIGH-PITCH>                        علامت‌گذاری سلول‌های خارج از محدوده که در آن‌ها ارتفاع قابل مشاهده بالاتر از زاویه 'high-pitch' نسبت به ناظر است. درجات نسبت به افق - مثبت رو به بالا. باید بزرگ‌تر از 'low-pitch' باشد.
  --low-pitch <LOW-PITCH>                          محدود کردن ارتفاع قابل مشاهده به طوری که پایین‌تر از زاویه 'low-pitch' از ناظر نباشد. درجات نسبت به افق - مثبت رو به بالا. باید کمتر از 'high-pitch' باشد.
  --curvature-coefficient <CURVATURE-COEFFICIENT>  ضریب محاسبه اثر انحنای زمین و شکست نور.
  -b, --band <BAND>                                باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1)
  --visible-value <VISIBLE-VALUE>                  مقدار پیکسلی برای نواحی مرئی (پیش‌فرض: 255)
  --invisible-value <INVISIBLE-VALUE>              مقدار پیکسلی برای نواحی نامرئی (پیش‌فرض: 0)
  --maybe-visible-value <MAYBE-VISIBLE-VALUE>      مقدار پیکسلی برای نواحی بالقوه مرئی (پیش‌فرض: 2)
  --out-of-range-value <OUT-OF-RANGE-VALUE>        مقدار پیکسلی برای سلول‌هایی که خارج از محدوده مشخص‌شده توسط موقعیت ناظر و حداکثر فاصله قرار می‌گیرند (پیش‌فرض: 0)
  --output-nodata <OUTPUT-NODATA>                  مقداری که برای سلول‌های فاقد داده در رستر خروجی تنظیم می‌شود.
  --observer-spacing <OBSERVER-SPACING>            فاصله سلولی بین ناظرها (پیش‌فرض: 10)
  -j, --num-threads <NUM-THREADS>                  تعداد کارها (یا ALL_CPUS) (پیش‌فرض: 3)

جزئیات گزینه‌ها در gdal raster viewshed قابل مشاهده است.

* write [OPTIONS] <OUTPUT>
--------------------------
نوشتن یک مجموعه داده رستری.
آرگومان‌های مکانی:
  -o, --output <OUTPUT>                                مجموعه داده رستری خروجی [الزامی]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی (مقدار "GDALG" نیز مجاز است)
  --co, --creation-option <KEY>=<VALUE>                گزینه ایجاد [قابل تکرار]
  --overwrite                                          آیا بازنویسی مجموعه داده خروجی موجود مجاز است یا خیر
                                                       ناسازگار با --append
  --append                                             الحاق به عنوان زیرمجموعه داده به خروجی موجود
                                                       ناسازگار با --overwrite

جزئیات گزینه‌ها در gdal raster pipeline write قابل مشاهده است.

یک خط‌لوله می‌تواند با استفاده از قالب خروجی GDALG به صورت یک فایل JSON ذخیره (سریال‌سازی) شود. سپس فایل حاصل می‌تواند با استفاده از درایور GDALG: GDAL Streamed Algorithm به عنوان یک مجموعه داده رستری باز شده و خط‌لوله مشخص‌شده را به صورت برخط و جریانی (streamed / on-the-fly) اعمال کند.

عضو command_line در فایل JSON معمولاً کل خط فرمان بدون مرحله پایانی write است، و همان چیزی است که توسط دستور زیر تولید می‌شود: gdal raster pipeline ! .... ! write out.gdalg.json.

{
    "type": "gdal_streamed_alg",
    "command_line": "gdal raster pipeline ! read in.tif ! reproject --output-crs=EPSG:32632"
}

مرحله نهایی write را نیز می‌توان افزود، اما در این صورت باید صراحتاً قالب خروجی stream و یک نام مجموعه داده خروجی صوری مشخص گردد.

{
    "type": "gdal_streamed_alg",
    "command_line": "gdal raster pipeline ! read in.tif ! reproject --output-crs=EPSG:32632 ! write --output-format=streamed streamed_dataset"
}

افزوده‌شده در نسخه 3.12.

این امکان وجود دارد که با استفاده از gdal pipeline از یک خط‌لوله که قبلاً در یک فایل .gdal.json سریال‌سازی شده استفاده کرد و مراحل موجود آن را سفارشی نمود؛ معمولاً تغییر نام فایل ورودی، مشخص کردن نام فایل خروجی، یا افزودن و تغییر آرگومان‌های مراحل.

ببینید: Substitutions.

افزوده‌شده در نسخه 3.12.

امکان ایجاد «خط‌لوله‌های تودرتو» (nested pipelines)، یعنی خط‌لوله‌هایی در داخل خط‌لوله‌های دیگر وجود دارد.

یک خط‌لوله تودرتو با براکت‌های مربعی ([ و ]) که با یک نویسه فاصله احاطه شده‌اند، متمایز و مشخص می‌شود.

دو گونه خط‌لوله تودرتو وجود دارد:

  • خط‌لوله‌های تودرتوی ورودی: که در آن مجموعه داده نتیجه خط‌لوله تودرتو به عنوان مجموعه داده ورودی برای یک آرگومان از خط‌لوله اصلی به کار می‌رود.
  • خط‌لوله‌های تودرتوی خروجی: که در آن خروجی یک مرحله از خط‌لوله اصلی به عنوان ورودی خط‌لوله تودرتو در مرحله بعدی به کار می‌رود. خط‌لوله‌های تودرتوی خروجی فقط می‌توانند همراه با مرحله tee استفاده شوند.

ببینید: Nested pipeline.

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

$ gdal raster pipeline ! read in.tif ! reproject --output-crs=EPSG:32632 ! edit --metadata AUTHOR=EvenR ! write out.tif --overwrite

$ gdal raster pipeline ! read in.tif ! reproject --output-crs=EPSG:32632 ! write in_epsg_32632.gdalg.json --overwrite
$ gdal raster info in_epsg_32632.gdalg.json

gdal raster pipeline ! mosaic input*.tif ! tile output_folder

$ gdal raster pipeline ! read in.tif ! reproject -m "[1,10]=1; [11,20]=2; [21,30]=3; DEFAULT=NO_DATA" --ot=Byte ! color-map --color-map=color_map.txt --color-selection=exact --add-alpha ! write -f WEBP rendered.webp

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026