.\" 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-PIPELINE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-pipeline \- پردازش یک مجموعه داده رستری با اعمال چندین مرحله .sp افزوده‌شده در نسخه 3.11. .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster pipeline\fP می‌تواند برای پردازش یک مجموعه داده رستری و اجرای مراحل مختلف پردازشی که داده‌های رستری را دریافت کرده و داده‌های رستری تولید می‌کنند، به کار رود. .sp برای خط‌لوله‌هایی که داده‌های رستری و برداری را با هم ترکیب می‌کنند، به \fI\%gdal pipeline\fP\& مراجعه کنید. .sp بیشتر مراحل، ارزیابی بلوک‌های رستری را به صورت درخواستی (on\-demand) انجام می‌دهند (مگر اینکه در مستندات آن‌ها خلاف این بیان شده باشد)، بدون اینکه مجموعه داده نهایی حاصل از عملیات هر مرحله را بر روی دیسک ذخیره و مادی‌سازی (materialize) کنند. گاهی اوقات ممکن است برای اهداف کارایی و سرعت پردازش، مادی‌سازی یک مجموعه داده میانی بر روی دیسک با استفاده از \fI\%gdal raster materialize\fP\& مطلوب باشد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster pipeline [OPTIONS] پردازش یک مجموعه داده رستری با اعمال چندین مرحله. گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [قابل تکرار] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا هشدار) [در خط‌لوله‌ها در دسترس نیست] الگوی : read|mosaic|stack [READ\-OPTIONS] ( ! [STEP\-OPTIONS] )* ! info|compare|tile|write [WRITE\-OPTIONS] .EE .UNINDENT .UNINDENT .sp یک خط‌لوله چندین مرحله را که با نویسه \fI!\fP (علامت تعجب) از یکدیگر جدا شده‌اند، به هم زنجیر می‌کند. نخستین مرحله باید \fBread\fP، \fBcalc\fP، \fBcreate\fP، \fBmosaic\fP یا \fBstack\fP باشد، و آخرین مرحله باید \fBwrite\fP، \fBinfo\fP یا \fBtile\fP\& باشد. هر مرحله آرگومان‌های مکانی یا غیرمکانی ویژه خود را دارد. به غیر از \fBread\fP، \fBcalc\fP، \fBmosaic\fP، \fBstack\fP، \fBcompare\fP، \fBinfo\fP، \fBtile\fP و \fBwrite\fP، تمام مراحل دیگر می‌توانند به طور بالقوه چندین بار در یک خط‌لوله استفاده شوند. .SH "مراحل (STEPS)" .INDENT 0.0 .IP \(bu 2 \fI\%aspect\fP .IP \(bu 2 \fI\%blend\fP .IP \(bu 2 \fI\%calc\fP .IP \(bu 2 \fI\%clip\fP .IP \(bu 2 \fI\%color\-map\fP .IP \(bu 2 \fI\%compare\fP .IP \(bu 2 \fI\%create\fP .IP \(bu 2 \fI\%edit\fP .IP \(bu 2 \fI\%external\fP .IP \(bu 2 \fI\%fill\-nodata\fP .IP \(bu 2 \fI\%hillshade\fP .IP \(bu 2 \fI\%info\fP .IP \(bu 2 \fI\%materialize\fP .IP \(bu 2 \fI\%mosaic\fP .IP \(bu 2 \fI\%neighbors\fP .IP \(bu 2 \fI\%nodata\-to\-alpha\fP .IP \(bu 2 \fI\%overview\fP .IP \(bu 2 \fI\%pansharpen\fP .IP \(bu 2 \fI\%proximity\fP .IP \(bu 2 \fI\%read\fP .IP \(bu 2 \fI\%reclassify\fP .IP \(bu 2 \fI\%reproject\fP .IP \(bu 2 \fI\%resize\fP .IP \(bu 2 \fI\%rgb\-to\-palette\fP .IP \(bu 2 \fI\%roughness\fP .IP \(bu 2 \fI\%scale\fP .IP \(bu 2 \fI\%select\fP .IP \(bu 2 \fI\%set\-type\fP .IP \(bu 2 \fI\%sieve\fP .IP \(bu 2 \fI\%slope\fP .IP \(bu 2 \fI\%stack\fP .IP \(bu 2 \fI\%tee\fP .IP \(bu 2 \fI\%tile\fP .IP \(bu 2 \fI\%tpi\fP .IP \(bu 2 \fI\%tri\fP .IP \(bu 2 \fI\%unscale\fP .IP \(bu 2 \fI\%update\fP .IP \(bu 2 \fI\%viewshed\fP .IP \(bu 2 \fI\%write\fP .UNINDENT .SS aspect .INDENT 0.0 .INDENT 3.5 .sp .EX * aspect [OPTIONS] ------------------ تولید نقشه جهت شیب (Aspect) گزینه‌ها: -b, --band باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) --convention قاعده زوایای خروجی. CONVENTION=azimuth|trigonometric-angle (پیش‌فرض: azimuth) --gradient-alg الگوریتم مورد استفاده برای محاسبه گرادیان زمین. GRADIENT-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn) --zero-for-flat تولید صفر برای مناطق مسطح --no-edges عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster aspect\fP\& قابل مشاهده است. .SS blend .INDENT 0.0 .INDENT 3.5 .sp .EX * blend [OPTIONS] --------------------------- ترکیب/آمیختن دو مجموعه داده رستری آرگومان‌های مکانی: --overlay مجموعه داده هم‌پوشان (Overlay) [الزامی] گزینه‌ها: --operator عملگر ترکیب. OPERATOR=src-over|hsv-value|multiply|screen|overlay|hard-light|darken|lighten|color-dodge|color-burn (پیش‌فرض: src-over) --opacity درصد شفافیت اعمال‌شده بر مجموعه داده هم‌پوشان (0=کاملاً شفاف، 100=استفاده کامل از شفافیت تصویر هم‌پوشان) (پیش‌فرض: 100) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster blend\fP\& قابل مشاهده است. .SS calc .INDENT 0.0 .INDENT 3.5 .sp .EX * calc [OPTIONS] ... ---------------------------- انجام محاسبات جبر رستری آرگومان‌های مکانی: -i, --input مجموعه‌های داده رستری ورودی [۱ یا چند مقدار] [الزامی] گزینه‌ها: --ot, --datatype, --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 عبارت(های) محاسباتی جهت ارزیابی [۱ یا چند مقدار] [الزامی] --dialect گویش عبارت محاسباتی. DIALECT=muparser|builtin (پیش‌فرض: muparser) --flatten تولید یک رستر خروجی تک‌باندی به ازای هر عبارت، حتی اگر داده‌های ورودی چندباندی باشند --nodata اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf') گزینه‌های پیشرفته: --if, --input-format قالب‌های ورودی [قابل تکرار] --oo, --open-option = گزینه‌های باز کردن [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster calc\fP\& قابل مشاهده است. .SS clip .INDENT 0.0 .INDENT 3.5 .sp .EX * clip [OPTIONS] ---------------- برش یک مجموعه داده رستری. گزینه‌ها: --bbox کادر محصورکننده برش به صورت xmin,ymin,xmax,ymax ناسازگار با --window، --geometry، --like --bbox-crs سامانه مرجع مختصات (CRS) کادر محصورکننده برش --window پنجره رستر به صورت col,line,width,height بر حسب پیکسل ناسازگار با --bbox، --geometry، --like --geometry هندسه برش (WKT یا GeoJSON) ناسازگار با --bbox، --window، --like --geometry-crs سامانه مرجع مختصات (CRS) هندسه برش --like مجموعه داده به عنوان الگو برای محدوده‌ها ناسازگار با --bbox، --window، --geometry --like-sql عبارت SELECT برای اجرا روی مجموعه داده 'like' ناسازگار با --like-where --like-layer نام لایه مجموعه داده 'like' --like-where عبارت شرطی WHERE در SQL برای اجرا روی مجموعه داده 'like' ناسازگار با --like-sql --only-bbox برای 'geometry' و 'like'، صرفاً کادر محصورکننده آن‌ها در نظر گرفته شود --allow-bbox-outside-source اجازه به کادر برش برای دربرگرفتن پیکسل‌های خارج از مجموعه داده ورودی --add-alpha افزودن باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد. .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster clip\fP\& قابل مشاهده است. .SS color-map .INDENT 0.0 .INDENT 3.5 .sp .EX * color-map [OPTIONS] --------------------- تولید مجموعه داده RGB یا RGBA از یک تک‌باند با استفاده از نقشه‌رنگ گزینه‌ها: -b, --band باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) --color-map نام فایل نقشه‌رنگ --add-alpha افزودن باند ماسک آلفا به مقصد. --color-selection نحوه محاسبه رنگ‌های خروجی از مقادیر ورودی. COLOR-SELECTION=interpolate|exact|nearest (پیش‌فرض: interpolate) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster color-map\fP\& قابل مشاهده است. .SS compare .sp افزوده‌شده در نسخه 3.12. .INDENT 0.0 .INDENT 3.5 .sp .EX * compare [OPTIONS] ------------------------------- مقایسه دو مجموعه داده رستری. آرگومان‌های مکانی: --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) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster compare\fP\& قابل مشاهده است. .SS create .INDENT 0.0 .INDENT 3.5 .sp .EX * create [OPTIONS] ------------------ ایجاد یک مجموعه داده رستری جدید. گزینه‌ها: -i, --like, --input مجموعه داده رستری الگو --size , اندازه خروجی بر حسب پیکسل --band-count تعداد باندها (پیش‌فرض: 1) --ot, --datatype, --output-data-type نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 (پیش‌فرض: Byte) --nodata اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf') --burn مقدار درج/حک کردن [قابل تکرار] --crs تنظیم سامانه مرجع مختصات (CRS) --bbox کادر محصورکننده به صورت xmin,ymin,xmax,ymax --metadata = افزودن مورد فراداده [قابل تکرار] --copy-metadata کپی کردن فراداده از مجموعه داده ورودی وابسته به --input --copy-overviews ایجاد سطوح نمای کلی مشابه با مجموعه داده ورودی وابسته به --input گزینه‌های پیشرفته: --if, --input-format قالب‌های ورودی [قابل تکرار] --oo, --open-option = گزینه‌های باز کردن [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster create\fP\& قابل مشاهده است. .SS edit .INDENT 0.0 .INDENT 3.5 .sp .EX * edit [OPTIONS] ---------------- ویرایش یک مجموعه داده رستری. گزینه‌ها: -b, --band باند فعال (شاخص با شروع از ۱) --crs بازنویسی سامانه مرجع مختصات (بدون بازپروژکشن) --bbox کادر محصورکننده به صورت xmin,ymin,xmax,ymax --nodata اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf') --color-interpretation <[all|=] تنظیم تفسیر رنگ باند [قابل تکرار] --color-map نام فایل نقشه‌رنگ ناسازگار با --unset-color-table --scale <[=] بازنویسی ضریب مقیاس باند [قابل تکرار] --offset <[=] بازنویسی ثابت آفست باند [قابل تکرار] --metadata = افزودن/به‌روزرسانی مورد فراداده مجموعه داده [قابل تکرار] --unset-color-table حذف جدول رنگ روی باند ۱ یا باند مشخص‌شده با --band ناسازگار با --color-map --unset-metadata حذف مورد(های) فراداده مجموعه داده [قابل تکرار] --unset-metadata-domain حذف دامنه(های) فراداده مجموعه داده [قابل تکرار] --gcp افزودن نقطه کنترل زمینی به قالب pixel,line,easting,northing[,elevation] یا @filename [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster edit\fP\& قابل مشاهده است. .SS external .INDENT 0.0 .INDENT 3.5 .sp .EX * external [OPTIONS] ------------------------------ اجرای یک برنامه خارجی به عنوان مرحله‌ای از خط‌لوله آرگومان‌های مکانی: --command دستور خارجی، اختیاری همراه با متغیرهای جانگهدارنده و/یا یا [الزامی] گزینه‌ها: -f, --of, --format, --output-format قالب خروجی گزینه‌های پیشرفته: --if, --input-format قالب‌های ورودی .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal external\fP\& قابل مشاهده است. .SS fill-nodata .INDENT 0.0 .INDENT 3.5 .sp .EX * fill-nodata [OPTIONS] ----------------------- پر کردن نواحی NoData در رستر با درون‌یابی از لبه‌ها. گزینه‌ها: -b, --band باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) -d, --max-distance حداکثر فاصله (بر حسب پیکسل) برای جستجوی مقادیر جهت درون‌یابی توسط الگوریتم (پیش‌فرض: 100) -s, --smoothing-iterations تعداد دفعات تکرار صاف‌سازی فیلتر میانگین 3x3 پس از درون‌یابی جهت تعدیل مصنوعات و نویزها (پیش‌فرض: 0) --mask استفاده از باند اول فایل مشخص‌شده به عنوان ماسک اعتبار (صفر نامعتبر، غیرصفر معتبر). --strategy به طور پیش‌فرض پیکسل‌ها با وزن‌دهی معکوس فاصله (invdist) درون‌یابی می‌شوند. انتخاب راهبرد نزدیک‌ترین همسایه (nearest) نیز ممکن است. STRATEGY=invdist|nearest (پیش‌فرض: invdist) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster fill-nodata\fP\& قابل مشاهده است. .SS hillshade .INDENT 0.0 .INDENT 3.5 .sp .EX * hillshade [OPTIONS] --------------------- تولید نقشه سایه‌روشن ناهمواری‌ها (Hillshade) گزینه‌ها: -b, --band باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) -z, --zfactor ضریب اغراق عمودی برای پیش‌ضرب در ارتفاعات --xscale نسبت واحدهای عمودی به واحدهای افقی محور X --yscale نسبت واحدهای عمودی به واحدهای افقی محور Y --azimuth زاویه افقی (آزیموت) نور بر حسب درجه (پیش‌فرض: 315) --altitude زاویه ارتفاع نور بر حسب درجه (پیش‌فرض: 45) --gradient-alg الگوریتم محاسبه گرادیان زمین. GRADIENT-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn) --variant گونه الگوریتم سایه‌روشن. VARIANT=regular|combined|multidirectional|Igor (پیش‌فرض: regular) --no-edges عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster hillshade\fP\& قابل مشاهده است. .SS info .sp افزوده‌شده در نسخه 3.12. .INDENT 0.0 .INDENT 3.5 .sp .EX * info [OPTIONS] ---------------- بازگرداندن اطلاعات یک مجموعه داده رستری. گزینه‌ها: -f, --of, --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 گزارش فراداده برای دامنه مشخص‌شده. از 'all' می‌توان برای گزارش فراداده در همه دامنه‌ها استفاده کرد گزینه‌های خاص: --no-nodata عدم دریافت مقدار NoData --no-mask عدم نمایش اطلاعات باند ماسک --subdataset استفاده از زیرمجموعه داده با شاخص مشخص (شروع از ۱) به جای خود مجموعه داده اصلی --crs-format قالب مورد استفاده برای گزارش CRS. CRS-FORMAT=AUTO|WKT2|PROJJSON (پیش‌فرض: AUTO) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster info\fP\& قابل مشاهده است. .SS materialize .INDENT 0.0 .INDENT 3.5 .sp .EX * materialize [OPTIONS] ----------------------- مادی‌سازی (ذخیره روی دیسک) یک مجموعه داده لوله‌کشی‌شده برای افزایش کارایی مراحل بعدی. گزینه‌ها: -o, --output نام مجموعه داده مادی‌سازی‌شده (ایجادشده توسط الگوریتم) -f, --of, --format, --output-format قالب خروجی --co, --creation-option = گزینه ایجاد [قابل تکرار] --overwrite آیا بازنویسی مجموعه داده خروجی موجود مجاز است یا خیر .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster materialize\fP\& قابل مشاهده است. .SS mosaic .INDENT 0.0 .INDENT 3.5 .sp .EX * mosaic [OPTIONS] ... ------------------------------ ساخت یک موزاییک، به صورت مجازی (VRT) یا مادی‌سازی‌شده. آرگومان‌های مکانی: -i, --input مجموعه‌های داده رستری ورودی (یا تعیین @ برای اشاره به فایل حاوی نام‌ها) [۱ یا چند مقدار] [الزامی] گزینه‌ها: -b, --band باند(های) ورودی (شاخص با شروع از ۱) [قابل تکرار] --absolute-path ذخیره مسیر مجموعه‌های داده ورودی به عنوان مسیر مطلق --resolution ,|same|average|common|highest|lowest> تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد) (پیش‌فرض: same) --bbox کادر محصورکننده هدف به صورت xmin,ymin,xmax,ymax (بر حسب واحدهای CRS مقصد) --target-aligned-pixels گرد کردن گستره هدف به تفکیک‌پذیری هدف --input-nodata تنظیم مقادیر NoData برای باندهای ورودی. [۱ یا چند مقدار] --output-nodata تنظیم مقادیر NoData در سطح باند مقصد. [۱ یا چند مقدار] --hide-nodata عدم گزارش مقدار NoData توسط باند مقصد. --add-alpha افزودن باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد. --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 = تعیین آرگومان(ها) برای ارسال به تابع پیکسلی [قابل تکرار] گزینه‌های پیشرفته: --if, --input-format قالب‌های ورودی [قابل تکرار] --oo, --open-option = گزینه‌های باز کردن [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster mosaic\fP\& قابل مشاهده است. .SS neighbors .INDENT 0.0 .INDENT 3.5 .sp .EX * neighbors [OPTIONS] --------------------- محاسبه مقدار هر پیکسل از روی همسایگان آن (آماره‌های کانونی / Focal Statistics) گزینه‌ها: -b, --band باند ورودی (شاخص با شروع از ۱) --method روش ترکیب پیکسل‌های وزن‌دار مبدأ. METHOD=mean|sum|min|max|stddev|median|mode [قابل تکرار] --size اندازه همسایگی --kernel هسته(های) کانولوشن برای اعمال [۱ یا چند مقدار] [الزامی] --ot, --datatype, --output-data-type نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 (پیش‌فرض: Float64) --nodata اختصاص مقدار NoData مشخص به باندهای خروجی ('none'، مقدار عددی، 'nan'، 'inf'، '-inf') .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster neighbors\fP\& قابل مشاهده است. .SS nodata-to-alpha .INDENT 0.0 .INDENT 3.5 .sp .EX * nodata-to-alpha [OPTIONS] --------------------------- جایگزینی مقدار(های) NoData با یک باند آلفا. گزینه‌ها: --nodata بازنویسی مقدار NoData در باند(های) ورودی (مقدار عددی، 'nan'، 'inf'، '-inf') [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster nodata-to-alpha\fP\& قابل مشاهده است. .SS overview .INDENT 0.0 .INDENT 3.5 .sp .EX * overview [OPTIONS] ------------------------------ که در آن یکی از موارد زیر است: - add: افزودن نماهای کلی (overviews). .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster overview\fP\& قابل مشاهده است. .SS pansharpen .INDENT 0.0 .INDENT 3.5 .sp .EX * pansharpen [OPTIONS] ... ------------------------------------ انجام عملیات پان‌شارپنینگ (افزایش وضوح تصویر با باند پانکروماتیک). آرگومان‌های مکانی: --spectral مجموعه داده باندهای طیفی ورودی [۱ یا چند مقدار] [الزامی] گزینه‌ها: -r, --resampling الگوریتم بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average (پیش‌فرض: cubic) --weights وزن برای هر باند طیفی ورودی [قابل تکرار] --nodata بازنویسی مقدار NoData برای باندهای ورودی --bit-depth بازنویسی عمق بیتی باندهای ورودی --spatial-extent-adjustment انتخاب رفتار هنگام متفاوت بودن گستره مکانی باندها. SPATIAL-EXTENT-ADJUSTMENT=union|intersection|none|none-without-warning (پیش‌فرض: union) -j, --num-threads تعداد کارها (یا ALL_CPUS) (پیش‌فرض: ALL_CPUS) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster pansharpen\fP\& قابل مشاهده است. .SS proximity .INDENT 0.0 .INDENT 3.5 .sp .EX * proximity [OPTIONS] --------------------- تولید یک نقشه مجاورت/فاصله رستری. گزینه‌ها: --ot, --datatype, --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 باند ورودی (شاخص با شروع از ۱) --target-values مقادیر پیکسلی هدف [قابل تکرار] --distance-units واحدهای فاصله. DISTANCE-UNITS=pixel|geo (پیش‌فرض: pixel) --max-distance حداکثر فاصله. مقدار NoData برای پیکسل‌های فراتر از این فاصله استفاده خواهد شد (پیش‌فرض: 0) --fixed-value مقدار ثابت برای پیکسل‌هایی که در محدوده حداکثر فاصله قرار دارند (به جای فاصله واقعی) (پیش‌فرض: 0) --nodata تعیین یک مقدار NoData برای استفاده در پیکسل‌های فراتر از حداکثر فاصله .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster proximity\fP\& قابل مشاهده است. .SS read .INDENT 0.0 .INDENT 3.5 .sp .EX * read [OPTIONS] ------------------------ خواندن یک مجموعه داده رستری. آرگومان‌های مکانی: -i, --input مجموعه‌های داده رستری ورودی [الزامی] گزینه‌های پیشرفته: --if, --input-format قالب‌های ورودی [قابل تکرار] --oo, --open-option = گزینه‌های باز کردن [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster pipeline read\fP\& قابل مشاهده است. .SS reclassify .INDENT 0.0 .INDENT 3.5 .sp .EX * reclassify [OPTIONS] ---------------------- بازطبقه‌بندی مقادیر در یک مجموعه داده رستری گزینه‌ها: -m, --mapping نگاشت‌های بازطبقه‌بندی (یا تعیین @ برای اشاره به فایلی شامل نگاشت‌ها) [الزامی] --ot, --datatype, --output-data-type نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster reclassify\fP\& قابل مشاهده است. .SS reproject .INDENT 0.0 .INDENT 3.5 .sp .EX * reproject [OPTIONS] --------------------- تغییر تصویر (بازپروژکشن) یک مجموعه داده رستری. گزینه‌ها: -s, --input-crs سامانه مرجع مختصات (CRS) ورودی --like مجموعه داده به عنوان الگو برای محدوده‌های هدف، CRS، اندازه و NoData -d, --output-crs سامانه مرجع مختصات (CRS) خروجی -r, --resampling روش بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (پیش‌فرض: nearest) --resolution , تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد) ناسازگار با --size --size , اندازه هدف بر حسب پیکسل ناسازگار با --resolution --bbox کادر محصورکننده هدف (بر حسب واحدهای CRS مقصد) --bbox-crs سامانه مرجع مختصات (CRS) کادر محصورکننده هدف -j, --num-threads تعداد کارها (یا ALL_CPUS) (پیش‌فرض: ALL_CPUS) گزینه‌های پیشرفته: --target-aligned-pixels گرد کردن گستره هدف به تفکیک‌پذیری هدف --input-nodata تنظیم مقادیر NoData برای باندهای ورودی ('None' برای حذف). [۱ یا چند مقدار] --output-nodata تنظیم مقادیر NoData برای باندهای خروجی ('None' برای حذف). [۱ یا چند مقدار] --add-alpha افزودن باند ماسک آلفا به مقصد در صورتی که رستر مبدأ فاقد آن باشد. --wo, --warp-option = گزینه(های) انحنا/تغییر شکل (Warping) [قابل تکرار] --to, --transform-option = گزینه(های) تبدیل (Transform) [قابل تکرار] --et, --error-threshold آستانه خطا .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster reproject\fP\& قابل مشاهده است. .SS resize .INDENT 0.0 .INDENT 3.5 .sp .EX * resize [OPTIONS] ------------------ تغییر اندازه یک مجموعه داده رستری بدون تغییر در گستره‌های زمین‌مرجع‌شده. گزینه‌ها: --resolution , تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد) ناسازگار با --size --size , اندازه هدف بر حسب پیکسل (یا درصد در صورت استفاده از پسوند '%') [الزامی] ناسازگار با --resolution -r, --resampling روش بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|mode (پیش‌فرض: nearest) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster resize\fP\& قابل مشاهده است. .SS rgb-to-palette .INDENT 0.0 .INDENT 3.5 .sp .EX * rgb-to-palette [OPTIONS] -------------------------- تبدیل یک تصویر RGB به یک تصویر رنگ کاذب / پالت‌دار. گزینه‌ها: --color-count انتخاب تعداد رنگ‌ها در جدول رنگ تولیدشده (پیش‌فرض: 256) --color-map نام فایل نقشه‌رنگ --output-nodata مقدار NoData خروجی --no-dither غیرفعال‌سازی دیترینگ فلوید-اشتاینبرگ (Floyd-Steinberg) --bit-depth عمق بیتی مؤلفه پالت رنگ (۸ بیت زمان محاسبات را طولانی‌تر می‌کند). BIT-DEPTH=5|8 (پیش‌فرض: 5) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster rgb-to-palette\fP\& قابل مشاهده است. .SS roughness .INDENT 0.0 .INDENT 3.5 .sp .EX * roughness [OPTIONS] --------------------- تولید نقشه زبری ناهمواری‌ها (Roughness) گزینه‌ها: -b, --band باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) --no-edges عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster roughness\fP\& قابل مشاهده است. .SS scale .INDENT 0.0 .INDENT 3.5 .sp .EX * scale [OPTIONS] ----------------- مقیاس‌بندی مقادیر باندهای یک مجموعه داده رستری. گزینه‌ها: --ot, --datatype, --output-data-type نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 -b, --band انتخاب باند جهت محدود کردن مقیاس‌بندی (شاخص با شروع از ۱) --input-min حداقل مقدار محدوده مبدأ وابسته به --input-max --input-max حداکثر مقدار محدوده مبدأ وابسته به --input-min --output-min حداقل مقدار محدوده مقصد وابسته به --output-max --output-max حداکثر مقدار محدوده مقصد وابسته به --output-min --exponent نما برای اعمال مقیاس‌بندی غیرخطی با یک تابع توانی --no-clip عدم محدودسازی و برش مقادیر ورودی به بازه [input-min, input-max] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster scale\fP\& قابل مشاهده است. .SS select .INDENT 0.0 .INDENT 3.5 .sp .EX * select [OPTIONS] ------------------------- انتخاب زیرمجموعه‌ای از باندها از یک مجموعه داده رستری. آرگومان‌های مکانی: -b, --band باند(ها) (شاخص با شروع از ۱، 'mask'، 'mask:' یا تفسیر رنگ نظیر 'red') [۱ یا چند مقدار] [الزامی] گزینه‌ها: --exclude مستثنی‌کردن باندهای مشخص‌شده --mask باند ماسک (شاخص با شروع از ۱، 'mask'، 'mask:' یا 'none') .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster select\fP\& قابل مشاهده است. .SS set-type .INDENT 0.0 .INDENT 3.5 .sp .EX * set-type [OPTIONS] -------------------- تغییر نوع داده باندهای یک مجموعه داده رستری. گزینه‌ها: --ot, --datatype, --output-data-type نوع داده خروجی. OUTPUT-DATA-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 [الزامی] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster set-type\fP\& قابل مشاهده است. .SS sieve .INDENT 0.0 .INDENT 3.5 .sp .EX * sieve [OPTIONS] ----------------- حذف چندضلعی‌های کوچک از یک مجموعه داده رستری. گزینه‌ها: --mask استفاده از نخستین باند فایل مشخص‌شده به عنوان ماسک اعتبار (تمام پیکسل‌های با مقداری غیر از صفر مناسب برای گنجانده شدن در چندضلعی‌ها در نظر گرفته می‌شوند) -b, --band باند ورودی (شاخص با شروع از ۱) -s, --size-threshold حداقل اندازه چندضلعی‌ها برای نگه‌داری (پیش‌فرض: 2) -c, --connect-diagonal-pixels متصل در نظر گرفتن پیکسل‌های مورب/قطری .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster sieve\fP\& قابل مشاهده است. .SS slope .INDENT 0.0 .INDENT 3.5 .sp .EX * slope [OPTIONS] ----------------- تولید یک نقشه شیب (Slope) گزینه‌ها: -b, --band باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) --unit واحد بیان شیب. UNIT=degree|percent (پیش‌فرض: degree) --xscale نسبت واحدهای عمودی به واحدهای افقی محور X --yscale نسبت واحدهای عمودی به واحدهای افقی محور Y --gradient-alg الگوریتم محاسبه گرادیان زمین. GRADIENT-ALG=Horn|ZevenbergenThorne (پیش‌فرض: Horn) --no-edges عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster slope\fP\& قابل مشاهده است. .SS stack .INDENT 0.0 .INDENT 3.5 .sp .EX * stack [OPTIONS] ... ----------------------------- ترکیب باندهای ورودی در یک خروجی چندباندی، به صورت مجازی (VRT) یا مادی‌سازی‌شده. آرگومان‌های مکانی: -i, --input مجموعه‌های داده رستری ورودی (یا تعیین @ برای اشاره به فایل حاوی نام‌ها) [۱ یا چند مقدار] [الزامی] گزینه‌ها: -b, --band باند(های) ورودی (شاخص با شروع از ۱) [قابل تکرار] --absolute-path ذخیره مسیر مجموعه‌های داده ورودی به عنوان مسیر مطلق --resolution ,|same|average|common|highest|lowest> تفکیک‌پذیری هدف (بر حسب واحدهای CRS مقصد) (پیش‌فرض: same) --bbox کادر محصورکننده هدف به صورت xmin,ymin,xmax,ymax (بر حسب واحدهای CRS مقصد) --target-aligned-pixels گرد کردن گستره هدف به تفکیک‌پذیری هدف --input-nodata تنظیم مقادیر NoData برای باندهای ورودی. [۱ یا چند مقدار] --output-nodata تنظیم مقادیر NoData در سطح باند مقصد. [۱ یا چند مقدار] --hide-nodata عدم گزارش مقدار NoData توسط باند مقصد. گزینه‌های پیشرفته: --if, --input-format قالب‌های ورودی [قابل تکرار] --oo, --open-option = گزینه‌های باز کردن [قابل تکرار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster stack\fP\& قابل مشاهده است. .SS tee .INDENT 0.0 .INDENT 3.5 .sp .EX * tee [OPTIONS] [...] ------------------------------- هدایت ورودی به جریان خروجی و خط‌لوله‌های تودرتوی جانبی. آرگومان‌های مکانی: --tee-pipeline خط‌لوله تودرتو [۱ یا چند مقدار] .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در بخش \fI\%خط‌لوله‌های تودرتوی خروجی\fP قابل مشاهده است. .SS tile .sp افزوده‌شده در نسخه 3.12. .INDENT 0.0 .INDENT 3.5 .sp .EX * tile [OPTIONS] ------------------------- تولید کاشی‌ها (Tiles) در فایل‌های جداگانه از یک مجموعه داده رستری. آرگومان‌های مکانی: -o, --output دایرکتوری خروجی [الزامی] گزینه‌ها: -f, --of, --format, --output-format قالب خروجی (پیش‌فرض: PNG) --co, --creation-option = گزینه ایجاد [قابل تکرار] --tiling-scheme طرح‌واره کاشی‌بندی. TILING-SCHEME=raster|WebMercatorQuad|WorldCRS84Quad|WorldMercatorWGS84Quad|GoogleCRS84Quad|PseudoTMS_GlobalMercator|GlobalGeodeticOriginLat270|LINZAntarticaMapTilegrid|APSTILE|CBMTILE|NZTM2000 (پیش‌فرض: WebMercatorQuad) --min-zoom حداقل سطح بزرگ‌نمایی --max-zoom حداکثر سطح بزرگ‌نمایی --min-x حداقل مختصات X کاشی --max-x حداکثر مختصات X کاشی --min-y حداقل مختصات Y کاشی --max-y حداکثر مختصات Y کاشی --no-intersection-ok عدم تقاطع گستره مجموعه داده با ماتریس کاشی صرفاً یک هشدار باشد -r, --resampling روش بازنمونه‌برداری برای حداکثر زوم. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (پیش‌فرض: cubic) --overview-resampling روش بازنمونه‌برداری برای نماهای کلی. OVERVIEW-RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum --convention قاعده شماره‌گذاری کاشی‌ها: xyz (از بالا) یا tms (از پایین). CONVENTION=xyz|tms (پیش‌فرض: xyz) --tile-size بازنویسی اندازه پیش‌فرض کاشی --add-alpha اجبار به افزودن کانال آلفا ناسازگار با --no-alpha --no-alpha غیرفعال‌سازی افزودن کانال آلفا ناسازگار با --add-alpha --output-nodata مقدار NoData خروجی --skip-blank عدم تولید کاشی‌های خالی --metadata = افزودن مورد فراداده به کاشی‌های خروجی [قابل تکرار] --copy-src-metadata کپی فراداده از مجموعه داده مبدأ --aux-xml تولید فایل‌های جانبی .aux.xml در صورت نیاز --kml تولید فایل‌های KML --resume تولید تنها فایل‌های ناموجود -j, --num-threads تعداد کارها (یا ALL_CPUS) (پیش‌فرض: ALL_CPUS) --parallel-method روش موازی‌سازی (thread, spawn, fork). PARALLEL-METHOD=thread|spawn|fork گزینه‌های پیشرفته بازنمونه‌برداری: --excluded-values چندتایی‌های مقادیر (مانند ,, یا (,,),(,,)) که باید هنگام بازنمونه‌برداری (میانگین) به عنوان پیکسل‌های مبدأ نادیده گرفته شوند --excluded-values-pct-threshold حداقل درصد پیکسل‌های مبدأ که باید روی یکی از --excluded-values تنظیم شده باشند تا مقدار مستثنی‌شده به عنوان مقدار پیکسل هدف استفاده شود (پیش‌فرض: 50) --nodata-values-pct-threshold حداقل درصد پیکسل‌های مبدأ که باید روی مقدار NoData (یا alpha=0 یا هر روش بیان شفافیت) تنظیم شده باشند تا پیکسل هدف شفاف شود (پیش‌فرض: 100) گزینه‌های انتشار: --webviewer نمایشگر وبی که تولید می‌شود. WEBVIEWER=none|all|leaflet|openlayers|mapml|stac (پیش‌فرض: all) [قابل تکرار] --url نشانی URL جایی که کاشی‌های تولیدشده منتشر خواهند شد --title عنوان نقشه --copyright <COPYRIGHT> حق نشر نقشه --mapml-template <MAPML-TEMPLATE> نام فایل الگوی mapml که متغیرها در آن جایگزین خواهند شد .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster tile\fP\& قابل مشاهده است. .SS tpi .INDENT 0.0 .INDENT 3.5 .sp .EX * tpi [OPTIONS] --------------- تولید نقشه شاخص موقعیت توپوگرافی (TPI) گزینه‌ها: -b, --band <BAND> باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) --no-edges عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster tpi\fP\& قابل مشاهده است. .SS tri .INDENT 0.0 .INDENT 3.5 .sp .EX * tri [OPTIONS] --------------- تولید نقشه شاخص ناهمواری زمین (TRI) گزینه‌ها: -b, --band <BAND> باند ورودی (شاخص با شروع از ۱) (پیش‌فرض: 1) --algorithm <ALGORITHM> الگوریتم محاسبه TRI. ALGORITHM=Riley|Wilson (پیش‌فرض: Riley) --no-edges عدم تلاش برای درون‌یابی مقادیر در لبه‌های مجموعه داده یا نزدیک مقادیر NoData .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster tri\fP\& قابل مشاهده است. .SS unscale .INDENT 0.0 .INDENT 3.5 .sp .EX * 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 .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster unscale\fP\& قابل مشاهده است. .SS update .INDENT 0.0 .INDENT 3.5 .sp .EX * 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> آستانه خطا .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster update\fP\& قابل مشاهده است. .SS viewshed .INDENT 0.0 .INDENT 3.5 .sp .EX * 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) .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster viewshed\fP\& قابل مشاهده است. .SS write .INDENT 0.0 .INDENT 3.5 .sp .EX * write [OPTIONS] <OUTPUT> -------------------------- نوشتن یک مجموعه داده رستری. آرگومان‌های مکانی: -o, --output <OUTPUT> مجموعه داده رستری خروجی [الزامی] گزینه‌ها: -f, --of, --format, --output-format <OUTPUT-FORMAT> قالب خروجی (مقدار "GDALG" نیز مجاز است) --co, --creation-option <KEY>=<VALUE> گزینه ایجاد [قابل تکرار] --overwrite آیا بازنویسی مجموعه داده خروجی موجود مجاز است یا خیر ناسازگار با --append --append الحاق به عنوان زیرمجموعه داده به خروجی موجود ناسازگار با --overwrite .EE .UNINDENT .UNINDENT .sp جزئیات گزینه‌ها در \fI\%gdal raster pipeline write\fP\& قابل مشاهده است. .SH "خروجی GDALG (مجموعه داده برخط / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp یک خط‌لوله می‌تواند با استفاده از قالب خروجی \fBGDALG\fP به صورت یک فایل JSON ذخیره (سریال‌سازی) شود. سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه داده رستری باز شده و خط‌لوله مشخص‌شده را به صورت برخط و جریانی (streamed / on\-the\-fly) اعمال کند. .sp عضو \fBcommand_line\fP در فایل JSON معمولاً کل خط فرمان بدون مرحله پایانی \fBwrite\fP است، و همان چیزی است که توسط دستور زیر تولید می‌شود: \fBgdal raster pipeline ! .... ! write out.gdalg.json\fP\&. .INDENT 0.0 .INDENT 3.5 .sp .EX { "type": "gdal_streamed_alg", "command_line": "gdal raster pipeline ! read in.tif ! reproject --output-crs=EPSG:32632" } .EE .UNINDENT .UNINDENT .sp مرحله نهایی \fBwrite\fP را نیز می‌توان افزود، اما در این صورت باید صراحتاً قالب خروجی \fBstream\fP و یک نام مجموعه داده خروجی صوری مشخص گردد. .INDENT 0.0 .INDENT 3.5 .sp .EX { "type": "gdal_streamed_alg", "command_line": "gdal raster pipeline ! read in.tif ! reproject --output-crs=EPSG:32632 ! write --output-format=streamed streamed_dataset" } .EE .UNINDENT .UNINDENT .SH "جایگزینی‌ها (SUBSTITUTIONS)" .sp افزوده‌شده در نسخه 3.12. .sp این امکان وجود دارد که با استفاده از \fBgdal pipeline\fP از یک خط‌لوله که قبلاً در یک فایل .gdal.json سریال‌سازی شده استفاده کرد و مراحل موجود آن را سفارشی نمود؛ معمولاً تغییر نام فایل ورودی، مشخص کردن نام فایل خروجی، یا افزودن و تغییر آرگومان‌های مراحل. .sp ببینید: \fI\%Substitutions\fP\&. .SH "خط‌لوله‌های تودرتو (NESTED PIPELINE)" .sp افزوده‌شده در نسخه 3.12. .sp امکان ایجاد «خط‌لوله‌های تودرتو» (nested pipelines)، یعنی خط‌لوله‌هایی در داخل خط‌لوله‌های دیگر وجود دارد. .sp یک خط‌لوله تودرتو با براکت‌های مربعی (\fB[\fP و \fB]\fP) که با یک نویسه فاصله احاطه شده‌اند، متمایز و مشخص می‌شود. .sp دو گونه خط‌لوله تودرتو وجود دارد: .INDENT 0.0 .IP \(bu 2 خط‌لوله‌های تودرتوی ورودی: که در آن مجموعه داده نتیجه خط‌لوله تودرتو به عنوان مجموعه داده ورودی برای یک آرگومان از خط‌لوله اصلی به کار می‌رود. .IP \(bu 2 خط‌لوله‌های تودرتوی خروجی: که در آن خروجی یک مرحله از خط‌لوله اصلی به عنوان ورودی خط‌لوله تودرتو در مرحله بعدی به کار می‌رود. خط‌لوله‌های تودرتوی خروجی فقط می‌توانند همراه با مرحله \fBtee\fP استفاده شوند. .UNINDENT .sp ببینید: \fI\%Nested pipeline\fP\&. .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت اجرای موفقیت‌آمیز کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار منتشر می‌شوند، به عنوان اجرای موفقیت‌آمیز تلقی می‌گردند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: تغییر تصویر یک فایل GeoTIFF به CRS با شناسه EPSG:32632 ("WGS 84 / UTM zone 32N") و افزودن یک مورد فراداده .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster pipeline ! read in.tif ! reproject --output-crs=EPSG:32632 ! edit --metadata AUTHOR=EvenR ! write out.tif --overwrite .EE .UNINDENT .UNINDENT .SS مثال ۲: سریال‌سازی دستور تغییر تصویر یک فایل GeoTIFF در یک فایل GDALG، و خواندن بعدی آن .INDENT 0.0 .INDENT 3.5 .sp .EX $ 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 .EE .UNINDENT .UNINDENT .SS مثال ۳: موزاییک‌سازی برخط چندین فایل ورودی و کاشی‌بندی آن موزاییک. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster pipeline ! mosaic input*.tif ! tile output_folder .EE .UNINDENT .UNINDENT .SS مثال ۴: بازطبقه‌بندی GeoTIFF و رندر آن به عنوان تصویر RGB. .INDENT 0.0 .INDENT 3.5 .sp .EX $ 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 .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault <even.rouault@spatialys.com> .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .