'\" t
.\" 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-ZONAL-STATS" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-zonal-stats \- محاسبه آمارهای منطقه‌ای رستر
.sp
در نسخه 3.12 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal raster zonal\-stats [OPTIONS] <INPUT> <OUTPUT>

Calculate raster zonal statistics

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]
  \-q, \-\-quiet                                          Quiet mode (no progress bar or warning message) [not available in pipelines]

Options:
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  Output format (\(dqGDALG\(dq 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]
                                                       Mutually exclusive with \-\-upsert
  \-\-output\-layer <OUTPUT\-LAYER>                        Output layer name [not available in pipelines]
  \-\-skip\-errors                                        Skip errors when writing features [not available in pipelines]
  \-b, \-\-band <BAND>                                    Input band(s) (1\-based index) [may be repeated]
  \-\-zones <ZONES>                                      Dataset containing zone definitions [required]
  \-\-zones\-band <ZONES\-BAND>                            Band from which zones should be read
                                                       Mutually exclusive with \-\-zones\-layer
  \-\-zones\-layer <ZONES\-LAYER>                          Layer from which zones should be read
                                                       Mutually exclusive with \-\-zones\-band
  \-\-weights <WEIGHTS>                                  Weighting raster dataset
  \-\-weights\-band <WEIGHTS\-BAND>                        Band from which weights should be read (default: 1)
  \-\-pixels <PIXELS>                                    Method to determine which pixels are included in stat calculation.. PIXELS=default|fractional|all\-touched
  \-\-stat <STAT>                                        Statistic(s) to compute for each zone. STAT=center_x|center_y|count|coverage|frac|max|max_center_x|max_center_y|mean|median|min|minority|min_center_x|min_center_y|mode|stdev|sum|unique|values|variance|variety|weighted_mean|weighted_stdev|weighted_sum|weighted_variance|weights [may be repeated] [required]
  \-\-include\-field <INCLUDE\-FIELD>                      Fields from polygon zones to include in output [may be repeated]
  \-\-include\-geom                                       Include polygon zone geometry in the output
  \-\-strategy <STRATEGY>                                For polygon zones, whether to iterate over input features or raster chunks. STRATEGY=feature|raster (default: feature)
  \-\-chunk\-size <CHUNK\-SIZE>                            Maximum size of raster chunks read into memory (default: 5%)

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]
  \-\-upsert                                             Upsert features (implies \(aqappend\(aq) [not available in pipelines]
                                                       Mutually exclusive with \-\-append
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster zonal\-stats\fP آمارهای منطقه‌ای رستر (Zonal Statistics) را محاسبه می‌کند \-\- خلاصه‌ای از مقادیر پیکسل‌ها درون منطقه‌هایی که با عوارض چندضلعی (پلی‌گون) یا یک رستر دسته‌بندی‌شده (Categorical) مشخص شده‌اند.
.INDENT 0.0
.INDENT 2.5
[تصویر]
میانگین ارتفاع محاسبه‌شده برای هر چندضلعی از یک رستر ارتفاعی..UNINDENT
.UNINDENT
.sp
می‌توان علاوه بر رستر مبدا، یک رستر وزن‌دهی نیز تعیین کرد که امکان محاسبه آمارهایی مانند میانگین شرایط آب‌وهوایی وزن‌دهی‌شده با جمعیت را فراهم می‌کند.
.sp
تمامی ورودی‌ها باید در یک سیستم مرجع مکانی (CRS) یکسان ارائه شوند. اگر رسترهای ورودی دارای تفکیک‌پذیری‌های متفاوتی باشند، با استفاده از بازنمونه‌برداری میانگین به یک تفکیک‌پذیری یکپارچه تغییر مقیاس می‌یابند. با این حال، هیچ بازتصویرسازی (Reprojection) انجام نمی‌شود.
.SS "دربرگیری پیکسل‌ها و وزن‌دهی (Pixel inclusion and weighting)"
.sp
هنگامی که منطقه‌ها با استفاده از چندضلعی‌ها تعریف می‌شوند، سه روش برای تعیین اینکه کدام پیکسل‌ها در محاسبه لحاظ شوند در دسترس است.
به‌طور پیش‌فرض، هندسه‌ها با استفاده از پارامترهای پیش‌فرض رسترایز (پیکسلی) می‌شوند و پیکسل‌های موجود در رسترایز با وزن یکسان در محاسبه به کار می‌روند.
با استفاده از \fB\-\-pixels all\-touched\fP، تمامی پیکسل‌هایی که با چندضلعی تماس دارند در محاسبه لحاظ می‌شوند، باز هم با وزن یکسان.
اگر از \fB\-\-pixels fractional\fP استفاده شود، کسری از هر پیکسل که توسط چندضلعی پوشش داده شده است محاسبه می‌شود و پیکسل‌ها بر اساس این کسر وزن‌دهی می‌شوند.
این گزینه نیازمند این است که GDAL با نسخه 3.14 یا بالاتر از کتابخانه GEOS ساخته شده باشد.
.SS "آمارهای پشتیبانی‌شده (Supported stats)"
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
center_x
T}	T{
آرایه‌ای شامل مختصات x مرکز سلول برای هر سلولی که با چندضلعی تقاطع دارد. مرکز هر سلول ممکن است درون چندضلعی باشد یا نباشد.
T}
_
T{
center_y
T}	T{
آرایه‌ای شامل مختصات y مرکز سلول برای هر سلولی که با چندضلعی تقاطع دارد. مرکز هر سلول ممکن است درون چندضلعی باشد یا نباشد.
T}
_
T{
count
T}	T{
مجموع تمامی کسرهای پوشش سلول‌ها.
T}
_
T{
coverage
T}	T{
آرایه‌ای شامل کسر پوشش هر سلولی که با چندضلعی تقاطع دارد.
T}
_
T{
frac
T}	T{
کسری از سلول‌های پوشش‌داده‌شده که توسط هر مقدار متمایز رستر اشغال شده‌اند، همان‌طور که توسط \fBunique\fP ارائه می‌شود.
T}
_
T{
max
T}	T{
بیشترین مقدار سلول‌هایی که با چندضلعی تقاطع دارند، بدون در نظر گرفتن کسرهای پوشش یا مقادیر رستر وزن‌دهی.
T}
_
T{
max_center_x
T}	T{
مختصات x مرکز سلول برای سلول حاوی بیشترین مقدار که با چندضلعی تقاطع دارد. مرکز این سلول ممکن است درون چندضلعی باشد یا نباشد.
T}
_
T{
max_center_y
T}	T{
مختصات y مرکز سلول برای سلول حاوی بیشترین مقدار که با چندضلعی تقاطع دارد. مرکز این سلول ممکن است درون چندضلعی باشد یا نباشد.
T}
_
T{
mean
T}	T{
مقدار میانگین سلول‌هایی که با چندضلعی تقاطع دارند، وزن‌دهی‌شده بر اساس درصد پوشش هر سلول.
T}
_
T{
min
T}	T{
کمترین مقدار سلول‌هایی که با چندضلعی تقاطع دارند، بدون در نظر گرفتن کسرهای پوشش یا مقادیر رستر وزن‌دهی.
T}
_
T{
min_center_x
T}	T{
مختصات x مرکز سلول برای سلول حاوی کمترین مقدار که با چندضلعی تقاطع دارد. مرکز این سلول ممکن است درون چندضلعی باشد یا نباشد.
T}
_
T{
min_center_y
T}	T{
مختصات y مرکز سلول برای سلول حاوی کمترین مقدار که با چندضلعی تقاطع دارد. مرکز این سلول ممکن است درون چندضلعی باشد یا نباشد.
T}
_
T{
minority
T}	T{
مقدار رستری که کمترین تعداد سلول را اشغال کرده است، با در نظر گرفتن کسرهای پوشش سلول اما بدون لحاظ مقادیر رستر وزن‌دهی.
T}
_
T{
mode
T}	T{
مقدار رستری که بیشترین تعداد سلول را اشغال کرده است (مد/نما)، با در نظر گرفتن کسرهای پوشش سلول اما بدون لحاظ مقادیر رستر وزن‌دهی.
T}
_
T{
stdev
T}	T{
انحراف معیار جامعه برای مقادیر سلول‌هایی که با چندضلعی تقاطع دارند، با در نظر گرفتن کسر پوشش.
T}
_
T{
sum
T}	T{
مجموع مقادیر سلول‌های رستر که با چندضلعی تقاطع دارند، که در آن هر مقدار رستر بر اساس کسر پوشش خود وزن‌دهی می‌شود.
T}
_
T{
unique
T}	T{
آرایه‌ای از مقادیر یکتای رستر برای سلول‌هایی که با چندضلعی تقاطع دارند.
T}
_
T{
values
T}	T{
آرایه‌ای از مقادیر رستر برای هر سلولی که با چندضلعی تقاطع دارد.
T}
_
T{
variance
T}	T{
واریانس جامعه برای مقادیر سلول‌هایی که با چندضلعی تقاطع دارند، با در نظر گرفتن کسر پوشش.
T}
_
T{
variety
T}	T{
تعداد مقادیر متمایز رستر در سلول‌هایی که به‌طور کامل یا جزئی توسط چندضلعی پوشش داده شده‌اند.
T}
_
T{
weighted_frac
T}	T{
کسری از سلول‌های پوشش‌داده‌شده که توسط هر مقدار متمایز رستر اشغال شده‌اند، وزن‌دهی‌شده با مقدار رستر وزن‌دهی دوم. ترتیب با مقادیر بازگردانده‌شده توسط \fBunique\fP مطابقت دارد.
T}
_
T{
weighted_mean
T}	T{
مقدار میانگین سلول‌هایی که با چندضلعی تقاطع دارند، وزن‌دهی‌شده با حاصل‌ضرب کسر پوشش و رستر وزن‌دهی.
T}
_
T{
weighted_stdev
T}	T{
نسخه وزن‌دهی‌شده \fBstdev\fP\&.
T}
_
T{
weighted_variance
T}	T{
نسخه وزن‌دهی‌شده \fBvariance\fP
T}
_
T{
weights
T}	T{
آرایه‌ای از مقادیر وزن برای هر سلولی که با چندضلعی تقاطع دارد.
T}
.TE
.sp
این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP باشد.
.SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-band, \-b <BAND>
باند(های) ورودی برای پردازش.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-chunk\-size <MEMORY>
حداکثر اندازه تکه‌های (Chunk) رستر را برای خواندن در حافظه مشخص می‌کند. می‌تواند به‌صورت مقدار حافظه (500 MB، 2 GB و غیره) یا به‌صورت درصدی از حافظه رم در دسترس (مثلاً 10%) بیان شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-include\-field <INCLUDE\-FIELD>
یک یا چند فیلد از منطقه‌ها را برای کپی شدن در خروجی مشخص می‌کند. فقط هنگام استفاده از منطقه‌های برداری در دسترس است. از نسخه GDAL 3.13، می‌توان از مقادیر ویژه \(dqALL\(dq و \(dqNONE\(dq استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-include\-geom
هندسه منطقه را در عارضه خروجی می‌گنجاند. فقط هنگام استفاده از منطقه‌های برداری در دسترس است.
.sp
در نسخه 3.13 اضافه شد.

.UNINDENT
.INDENT 0.0
.TP
.B \-\-pixels <PIXELS>
روش تعیین اینکه کدام پیکسل‌ها باید در محاسبه لحاظ شوند: \fBdefault\fP، \fBall\-touched\fP یا \fBfractional\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stat <STAT>
یک یا چند مورد از \fI\%آمارهای پشتیبانی‌شده\fP را برای محاسبه در هر منطقه مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strategy <STRATEGY>
راهبرد پردازش (\fBraster\fP یا \fBfeature\fP) را هنگام استفاده از منطقه‌های برداری مشخص می‌کند.
در راهبرد پیش‌فرض (\fB\-\-strategy feature\fP)، GDAL روی عوارض موجود در مجموعه‌داده منطقه پیمایش می‌کند، پیکسل‌های متناظر را از رستر می‌خواند و آمارهای آن عارضه را می‌نویسد. این کار مانع از نیاز به بارگذاری کل مجموعه‌داده عارضه به‌طور هم‌زمان در حافظه می‌شود، اما اگر عوارض چندضلعی بزرگ باشند یا از نظر مکانی مرتب نباشند، ممکن است باعث خواندن چندباره پیکسل‌های یکسان شود. اگر از \fB\-\-strategy raster\fP استفاده شود، GDAL روی تکه‌های مجموعه‌داده رستر پیمایش می‌کند، منطقه‌های چندضلعی متناظر را می‌یابد و آمار آن عوارض را به‌روزرسانی می‌کند. (اندازه تکه‌های رستر را می‌توان با استفاده از \fB\-\-chunk\-size\fP کنترل کرد.) این تضمین می‌کند که پیکسل‌های رستر فقط یک بار خوانده شوند، اما ممکن است باعث پردازش چندباره عوارض یکسان شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-weights <WEIGHTS>
مسیر اختیاری به مجموعه‌داده‌ای که برای وزن‌دهی استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-weights\-band <WEIGHTS\-BAND>
باند رستری را که وزن‌ها می‌توانند از آن خوانده شوند مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-zones <ZONES>
مسیر به مجموعه‌داده‌ای که منطقه‌ها را تعریف می‌کند. اگر مجموعه‌داده دارای بیش از ۱ باند رستر یا لایه عارضه باشد، باید \fI\%\-\-zones\-band\fP یا \fI\%\-\-zones\-layer\fP مشخص شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-zones\-band <ZONES\-BAND>
باند رستری را که منطقه‌ها می‌توانند از آن خوانده شوند مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-zones\-layer <ZONES\-LAYER>
لایه عارضه‌ای را که منطقه‌ها می‌توانند از آن خوانده شوند مشخص می‌کند.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-append
تعیین اینکه آیا الحاق عوارض به لایه(های) موجود مجاز است یا خیر.
این گزینه در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد مجموعه‌داده دارند که می‌توان از آن‌ها برای
کنترل ویژگی‌های مربوط به فایل ایجادشده استفاده کرد. برای مثال،
درایور GeoPackage از گزینه‌های ایجاد برای کنترل نسخه پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ایجاد مجموعه‌داده بسته به درایور قالب متفاوت هستند، و برخی
قالب‌های ساده اصلاً هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های
پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات خود قالب منبع
اصلی اطلاعات درباره گزینه‌های ایجاد درایور است.
برای گزینه‌های مجاز ایجاد هر قالب، مستندات اختصاصی قالب \fI\%Vector drivers\fP را ببینید.
.sp
توجه داشته باشید که گزینه‌های ایجاد مجموعه‌داده با گزینه‌های ایجاد لایه متفاوت هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی
به تعیین آن نیست، اما زمانی که تشخیص خودکار درایور در انتخاب
درایور مناسب ناموفق باشد، می‌توان از آن برای چشم‌پوشی از تشخیص خودکار استفاده کرد.
این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود.
توجه داشته باشید که این گزینه درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛
به‌ویژه برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توان از آن‌ها برای
کنترل ویژگی‌های مربوط به لایه ایجادشده استفاده کرد. برای مثال،
درایور GeoPackage از گزینه‌های ایجاد لایه برای کنترل
شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا
توضیحات و غیره پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ایجاد لایه بسته به درایور قالب متفاوت هستند، و برخی
قالب‌های ساده اصلاً هیچ گزینه ایجاد لایه‌ای ندارند. فهرستی از گزینه‌های
پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات آن قالب منبع
اصلی اطلاعات درباره گزینه‌های ایجاد لایه درایور است.
برای گزینه‌های مجاز ایجاد لایه در هر قالب، مستندات اختصاصی قالب \fI\%Vector drivers\fP را ببینید.
.sp
توجه داشته باشید که گزینه‌های ایجاد لایه با گزینه‌های ایجاد مجموعه‌داده متفاوت هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه‌داده (مختص هر قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
تعیین اینکه کدام قالب برداری خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد:
\fBgdal \-\-formats | grep vector | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-layer <NAME>
نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته خواهند شد. در صورت عدم
تعیین، نام‌های لایه خروجی همانند نام‌های لایه ورودی خواهند بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-open\-option, \-\-output\-oo <NAME>=<VALUE>
در نسخه 3.12 اضافه شد.

.sp
گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (مختص قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
به برنامه اجازه می‌دهد تا روی فایل یا مجموعه‌داده مقصد موجود بازنویسی کند.
در غیر این صورت، به‌طور پیش‌فرض اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد،
\fBgdal\fP با خطا مواجه می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite\-layer
تعیین اینکه آیا بازنویسی روی لایه برداری خروجی موجود مجاز است یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-skip\-errors
در نسخه 3.12 اضافه شد.

.sp
تعیین اینکه آیا باید از خطاهای نوشتن عارضه(ها) چشم‌پوشی شود یا خیر. توجه داشته باشید که این گزینه
اندازه واحد تراکنش را به یک عارضه در هر بار تنظیم می‌کند، که ممکن است
هنگام درج در پایگاه‌های داده باعث کاهش شدید سرعت شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-update
تعیین اینکه آیا یک مجموعه‌داده خروجی موجود در حالت به‌روزرسانی باز شود یا خیر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-upsert
در نسخه 3.12 اضافه شد.

.sp
گونه‌ای از \fI\%\-\-append\fP که در آن عملیات \fI\%OGRLayer::UpsertFeature()\fP
برای درج یا به‌روزرسانی عوارض به‌جای الحاق با
\fI\%OGRLayer::CreateFeature()\fP استفاده می‌شود\&.
.sp
این قابلیت در حال حاضر تنها در چند درایور پیاده‌سازی شده است:
\fI\%GPKG \-\- GeoPackage vector\fP، \fI\%Elasticsearch: Geographically Encoded Objects for Elasticsearch\fP و \fI\%MongoDBv3\fP
(درایورهایی که upsert را پیاده‌سازی کرده‌اند، قابلیت \fI\%GDAL_DCAP_UPSERT\fP
را ارائه می‌دهند).
.sp
عملیات درج/به‌روزرسانی (upsert) از FID عارضه ورودی، هنگامی که تنظیم شده باشد
(و نام ستون FID یک رشته خالی نباشد)،
به عنوان کلید به‌روزرسانی عوارض موجود استفاده می‌کند. بسیار حیاتی است که اطمینان حاصل شود
مقادیر FID در لایه‌های مبدا و مقصد با یکدیگر سازگار هستند.
.sp
برای درایور GPKG، همچنین امکان درج/به‌روزرسانی عوارضی که FID آن‌ها تنظیم نشده یا فاقد اهمیت است
(گزینه \fB\-\-unset\-fid\fP در \fI\%gdal vector edit\fP می‌تواند برای نادیده گرفتن FID از عارضه منبع استفاده شود)
وجود دارد، مشروط بر اینکه یک ستون یکتا (UNIQUE) که کلید اصلی عدد صحیح نیست وجود داشته باشد.
.UNINDENT
.SH "کد وضعیت خروجی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: خلاصه‌سازی میانگین ارتفاع در فاصله ۲۰۰ متری از نقاط مورد نظر"
.sp
استفاده از یک خط لوله تو در تو برای مجموعه‌داده منطقه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
  gdal pipeline read dem.tif ! \e
      zonal\-stats \e
        \-\-zones [ read points.geojson ! buffer 200 ] \e
        \-\-stat mean ! \e
      write \e
        \-\-output\-format CSV \e
        \-\-output /vsistdout/

یا استفاده از مجموعه‌داده برداری منطقه به‌عنوان مجموعه‌داده منتقل‌شده با لوله با نام جایگزین \(ga\(ga_PIPE_\(ga\(ga:
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal pipeline read points.geojson ! \e
    buffer 200 ! \e
    zonal\-stats \e
      \-\-input dem.tif
      \-\-zones _PIPE_ \e
      \-\-stat mean ! \e
    write \e
      \-\-output\-format CSV \e
      \-\-output /vsistdout/
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۲: ایجاد یک لایه با مرتفع‌ترین نقاط در هر حوزه آبخیز"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal pipeline read dem.tif !
    zonal\-stats \e
      \-\-zones watersheds.shp \e
      \-\-stat max_center_x \e
      \-\-stat max_center_y ! \e
    make\-point \e
      \-\-x max_center_x \e
      \-\-y max_center_y \e
      \-\-output\-crs EPSG:4326 ! \e
    write out.geojson
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Dan Baston <dbaston@gmail.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.