'\" 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-VECTOR-COMBINE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vector-combine \- ترکیب هندسه‌ها در مجموعه‌های هندسی (Geometry Collections)
.sp
در نسخه 3.13 اضافه شد.

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

ترکیب عوارض در مجموعه‌ها (Collections)

آرگومان‌های موضعی (Positional arguments):
  \-i, \-\-input <INPUT>                                  مجموعه‌داده‌های برداری ورودی [الزامی] [در خطوط لوله در دسترس نیست]
  \-o, \-\-output <OUTPUT>                                مجموعه‌داده برداری خروجی [الزامی] [در خطوط لوله در دسترس نیست]

گزینه‌های عمومی (Common Options):
  \-h, \-\-help                                           نمایش پیام راهنما و خروج
  \-\-json\-usage                                         نمایش نحوه استفاده به صورت سند JSON و خروج
  \-\-config <KEY>=<VALUE>                               گزینه پیکربندی [تکرارپذیر]
  \-q, \-\-quiet                                          حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست]

گزینه‌ها (Options):
  \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>             نام لایه(های) ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  قالب خروجی (مجاز بودن \(dqGDALG\(dq) [در خطوط لوله در دسترس نیست]
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-lco, \-\-layer\-creation\-option <KEY>=<VALUE>         گزینه ایجاد لایه [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-overwrite                                          آیا بازنویسی روی مجموعه‌داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
  \-\-update                                             آیا مجموعه‌داده موجود در حالت به‌روزرسانی باز شود [در خطوط لوله در دسترس نیست]
  \-\-overwrite\-layer                                    آیا بازنویسی روی لایه خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
  \-\-append                                             آیا الحاق به لایه موجود مجاز است [در خطوط لوله در دسترس نیست]
                                                       ناسازگار با \-\-upsert
  \-\-output\-layer <OUTPUT\-LAYER>                        نام لایه خروجی [در خطوط لوله در دسترس نیست]
  \-\-skip\-errors                                        چشم‌پوشی از خطاها هنگام نوشتن عوارض [در خطوط لوله در دسترس نیست]
  \-\-group\-by <GROUP\-BY>                                نام فیلد(هایی) که ورودی‌ها باید بر اساس آن‌ها گروه‌بندی شوند [تکرارپذیر]
  \-\-keep\-nested                                        جلوگیری از ترکیب اجزای هندسه‌های چندبخشی
  \-\-add\-extra\-fields <ADD\-EXTRA\-FIELDS>                افزودن فیلدهای اضافی بر اساس اینکه آیا در هر گروه دارای مقادیر یکسان هستند یا خیر. ADD\-EXTRA\-FIELDS=no|sometimes\-identical|always\-identical (پیش‌فرض: no)

گزینه‌های پیشرفته (Advanced Options):
  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-output\-oo, \-\-output\-open\-option <KEY>=<VALUE>      گزینه‌های باز کردن خروجی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  \-\-upsert                                             درج یا به‌روزرسانی (Upsert) عوارض (شامل \(aqappend\(aq) [در خطوط لوله در دسترس نیست]
                                                       ناسازگار با \-\-append
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vector combine\fP هندسه‌ها را در مجموعه‌های هندسی (Geometry Collections) ترکیب می‌کند.
.sp
از آرگومان \fI\%\-\-group\-by\fP می‌توان برای تعیین اینکه کدام عوارض با یکدیگر ترکیب شوند استفاده کرد.
.sp
به‌طور پیش‌فرض، بخش‌های هندسه‌های چندبخشی (Multipart Geometries) در یک مجموعه غیرتو‌در‌تو از خاص‌ترین نوع ممکن ترکیب می‌شوند (به عنوان مثال، \fBMultiPolygon\fP به‌جای \fBGeometryCollection\fP). برای مثال، یک Polygon و یک MultiPolygon دو‌بخشی در یک MultiPolygon سه‌بخشی ترکیب خواهند شد. این کار به این دلیل انجام می‌شود که بسیاری از قالب‌های فایل GIS و بسته‌های نرم‌افزاری انواع GeometryCollection تودرتو را پشتیبانی نمی‌کنند. اگر نمایش تودرتو به شیوه \fBST_Collect\fP در PostGIS ترجیح داده شود (یک GeometryCollection دو مؤلفه‌ای شامل Polygon و MultiPolygon)، می‌توان از \fI\%\-\-keep\-nested\fP استفاده کرد.
.sp
دستور \fBcombine\fP می‌تواند به عنوان یک مرحله از \fI\%gdal vector pipeline\fP استفاده شود.
.SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-group\-by <FIELD_NAMES>
نام فیلدهایی که مقادیر یکتای آن‌ها برای جمع‌آوری هندسه‌های ورودی استفاده می‌شود. هر فیلدی که در \fI\%\-\-group\-by\fP ذکر نشده باشد از لایه منبع حذف خواهد شد. در صورت حذف \fI\%\-\-group\-by\fP، کل لایه در یک عارضه منفرد ترکیب می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keep\-nested
اگر هندسه‌های ورودی چندبخشی باشند، آن‌ها را در یک GeometryCollection از هندسه‌های ورودی ترکیب می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-add\-extra\-fields no|sometimes\-identical|always\-identical
تعیین اینکه آیا فیلدهایی از عوارض منبع که در میان عوارض متعلق به یک گروه مقدار یکسانی دارند، به عارضه خروجی متناظر کپی شوند یا خیر.
.sp
به‌طور پیش‌فرض، \fBno\fP، تنها فیلدهای فهرست‌شده در \fI\%\-\-group\-by\fP به لایه خروجی کپی می‌شوند.
.sp
هنگام مشخص کردن \fBsometimes\-identical\fP، فیلدهایی که برای تمام عوارض ورودی در حداقل یک گروه خروجی مقدار یکسانی دارند، به اسکیمای لایه خروجی کپی خواهند شد. مقدار فیلد برابر با مقداری است که برای تمام عوارض ورودی یک گروه مشترک است. اگر عوارض ورودی در یک گروه یکسان نباشند، مقدار فیلد در خروجی برای این گروه برابر با null قرار داده می‌شود.
.sp
هنگام مشخص کردن \fBalways\-identical\fP، فیلدهایی که برای تمام عوارض ورودی در یک گروه خروجی داده‌شده مقدار یکسانی دارند به لایه خروجی کپی می‌شوند، به شرطی که این شرایط برای تمام گروه‌های خروجی برقرار باشد.
.sp
برای مثال، فرض کنیم چهار عارضه ورودی با محتوای زیر داریم و آن‌ها را بر اساس \fBcountry\fP گروه‌بندی می‌کنیم:
.SH "عوارض ورودی (INPUT FEATURES)"
.TS
box center;
l|l|l|l.
T{
name
T}	T{
country
T}	T{
country_fr
T}	T{
type
T}
_
T{
Mainland France
T}	T{
France
T}	T{
France
T}	T{
continental
T}
_
T{
Corsica
T}	T{
France
T}	T{
France
T}	T{
island
T}
_
T{
Mainland USA
T}	T{
USA
T}	T{
Etats\-Unis d\(aqAmérique
T}	T{
continental
T}
_
T{
Alaska
T}	T{
USA
T}	T{
Etats\-Unis d\(aqAmérique
T}	T{
continental
T}
.TE
.sp
با مقدار \fBsometimes\-identical\fP، خروجی به صورت زیر خواهد بود:
.SH "خروجی با SOMETIMES-IDENTICAL (OUTPUT WITH SOMETIMES-IDENTICAL)"
.TS
box center;
l|l|l.
T{
country
T}	T{
country_fr
T}	T{
type
T}
_
T{
France
T}	T{
France
T}	T{
T}
_
T{
USA
T}	T{
Etats\-Unis d\(aqAmérique
T}	T{
continental
T}
.TE
.sp
فیلد \fBname\fP حذف شده است زیرا برای هر عارضه ورودی متمایز است. فیلد \fBtype\fP به عنوان یک فیلد خروجی ظاهر می‌شود، زیرا حداقل برای USA، دو عارضه ورودی گروه‌بندی‌شده مقدار یکسانی دارند. برای France، مقدار آن روی null تنظیم می‌شود، زیرا مقدار آن در دو عارضه ورودی متفاوت است.
.sp
با مقدار \fBalways\-identical\fP، خروجی به صورت زیر خواهد بود:
.SH "خروجی با ALWAYS-IDENTICAL (OUTPUT WITH ALWAYS-IDENTICAL)"
.TS
box center;
l|l.
T{
country
T}	T{
country_fr
T}
_
T{
France
T}	T{
France
T}
_
T{
USA
T}	T{
Etats\-Unis d\(aqAmérique
T}
.TE
.sp
فیلد \fBtype\fP حذف شده است زیرا مقدار آن در دو عارضه ورودی مربوط به France متفاوت است.
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.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\-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، در صورتی که یک ستون با قید UNIQUE وجود داشته باشد که کلید اصلی عددی صحیح (Integer Primary Key) نباشد، امکان انجام upsert برای عوارضی که FID آن‌ها تنظیم نشده یا فاقد اهمیت است نیز وجود دارد (گزینه \fB\-\-unset\-fid\fP در \fI\%gdal vector edit\fP می‌تواند برای نادیده گرفتن FID عارضه منبع استفاده شود).
.UNINDENT
.SH "نویسنده (AUTHOR)"
Dan Baston <dbaston@gmail.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.