.\" 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-CONCAT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-concat \- الحاق و پیوند زدن مجموعه‌داده‌های برداری .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector concat [OPTIONS] ... الحاق مجموعه‌داده‌های برداری. آرگومان‌های مکانی: \-i, \-\-input مجموعه‌داده‌های برداری ورودی [۱ یا چند مقدار] [الزامی] [در خط‌لوله‌ها در دسترس نیست] \-o, \-\-output مجموعه‌داده برداری خروجی [الزامی] [در خط‌لوله‌ها در دسترس نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [قابل تکرار] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست] گزینه‌ها: \-l, \-\-layer, \-\-input\-layer نام لایه(های) ورودی [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] \-f, \-\-of, \-\-format, \-\-output\-format فرمت خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خط‌لوله‌ها در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ساخت مجموعه‌داده [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] \-\-lco, \-\-layer\-creation\-option = گزینه ساخت لایه [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] \-\-overwrite تعیین اینکه آیا رونویسی مجموعه‌داده خروجی موجود مجاز است [در خط‌لوله‌ها در دسترس نیست] \-\-update تعیین اینکه آیا مجموعه‌داده موجود در حالت به‌روزرسانی باز شود [در خط‌لوله‌ها در دسترس نیست] \-\-overwrite\-layer تعیین اینکه آیا رونویسی لایه خروجی موجود مجاز است [در خط‌لوله‌ها در دسترس نیست] \-\-append تعیین اینکه آیا الحاق به لایه موجود مجاز است [در خط‌لوله‌ها در دسترس نیست] ناسازگار با \-\-upsert \-\-skip\-errors نادیده گرفتن خطاها هنگام نوشتن عوارض [در خط‌لوله‌ها در دسترس نیست] \-\-mode تعیین راهبرد ایجاد لایه‌های خروجی از لایه‌های منبع. MODE=merge\-per\-layer\-name|stack|single (پیش‌فرض: merge\-per\-layer\-name) \-\-output\-layer نام لایه برداری خروجی (در حالت single)، یا الگوی نام‌گذاری لایه‌های برداری خروجی (در حالت stack) \-\-source\-layer\-field\-name نام فیلد جدید جهت افزودن برای شناسایی لایه منبع، با مقداری که توسط \(aqsource\-layer\-field\-content\(aq تعیین می‌شود \-\-source\-layer\-field\-content یک رشته، احتمالاً با استفاده از {AUTO_NAME}، {DS_NAME}، {DS_BASENAME}، {DS_INDEX}، {LAYER_NAME}، {LAYER_INDEX} \-\-field\-strategy نحوه تعیین فیلدهای هدف از فیلدهای منبع. FIELD\-STRATEGY=union|intersection (پیش‌فرض: union) \-s, \-\-input\-crs سیستم مرجع مختصات (CRS) ورودی \-d, \-\-output\-crs سیستم مرجع مختصات (CRS) خروجی گزینه‌های پیشرفته: \-\-if, \-\-input\-format فرمت‌های ورودی [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [قابل تکرار] [در خط‌لوله‌ها در دسترس نیست] \-\-upsert درج یا به‌روزرسانی عوارض (upsert) (شامل \(aqappend\(aq) [در خط‌لوله‌ها در دسترس نیست] ناسازگار با \-\-append .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal vector concat\fP چندین مجموعه‌داده منبع را به یکدیگر الحاق می‌کند. .sp این دستور دارای ۳ حالت اصلی است: .INDENT 0.0 .IP \(bu 2 \fI\%\-\-mode\fP = \fBmerge\-per\-layer\-name\fP (پیش‌فرض). مجموعه‌داده خروجی تولیدشده توسط این دستور به همان تعداد نام‌های لایه متفاوت در مجموعه‌داده‌های منبع، لایه خواهد داشت. برای مثال اگر ۲ مجموعه‌داده وجود داشته باشد، یکی دارای لایه‌های \fIa\fP و \fIb\fP، و دیگری دارای لایه‌های \fIb\fP و \fIc\fP، ۳ لایه خروجی ایجاد خواهد شد: \fIa\fP، \fIb\fP (ادغام ۲ لایه منبع) و \fIc\fP\&. .IP \(bu 2 \fI\%\-\-mode\fP = \fBstack\fP\&. مجموعه‌داده خروجی تولیدشده توسط این دستور به همان تعداد لایه‌های موجود در مجموعه‌داده‌های منبع، لایه خواهد داشت. برای مثال اگر ۲ مجموعه‌داده \fBds1\fP (با لایه‌های \fIa\fP و \fIb\fP) و \fBds2\fP (با لایه‌های \fIb\fP و \fIc\fP) وجود داشته باشد، ۴ لایه خروجی ایجاد خواهد شد: \fBds1_a\fP، \fBds1_b\fP، \fBds2_b\fP و \fBds2_c\fP\&. .IP \(bu 2 \fI\%\-\-mode\fP = \fBsingle\fP\&. مجموعه‌داده خروجی تولیدشده توسط این دستور شامل یک لایه منفرد خواهد بود که تمامی لایه‌های موجود در مجموعه‌داده‌های منبع را در هم ادغام می‌کند. .UNINDENT .sp هنگامی که یک لایه خروجی چندین لایه منبع را ادغام می‌کند، به طور پیش‌فرض طرح‌واره (schema) حاصل شامل اجتماع (union) تمامی فیلدهای منبع خواهد بود. با تنظیم گزینه \fI\%\-\-field\-strategy\fP بر روی \fBintersection\fP می‌توان تنها اشتراک فیلدها را انتخاب کرد. در رابطه با CRS حاصل، به طور پیش‌فرض CRS لایه منبع به عنوان CRS هدف استفاده خواهد شد، و عوارض سایر لایه‌های منبع که با این CRS مطابقت ندارند، به آن بازپروژکت (reproject) خواهند شد. از \fI\%\-\-output\-crs\fP می‌توان برای انتخاب یک CRS مقصد مشخص استفاده کرد. .sp این دستور همچنین می‌تواند به عنوان مرحله نخست در \fI\%gdal vector pipeline\fP به کار رود. .SH "خروجی GDALG (مجموعه داده برخط / استریم‌شده) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از فرمت خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس به عنوان یک مجموعه‌داده برداری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز کرد و خط لوله مشخص‌شده را به صورت بلادرنگ / جریانی (on\-the\-fly / streamed) اعمال نمود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-field\-strategy union|intersection تعیین می‌کند که طرح‌واره (schema) لایه هدف چگونه از طرح‌واره‌های لایه‌های ورودی ساخته شود: .INDENT 7.0 .IP \(bu 2 \fBunion\fP (پیش‌فرض) برای استفاده از ابرمجموعه (super\-set) تمامی فیلدها از همه لایه‌های منبع. .IP \(bu 2 \fBintersection\fP برای استفاده از زیرمجموعه (sub\-set) تمامی فیلدهای مشترک از همه لایه‌های منبع. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-input\-crs, \-s تنظیم (بازنویسی) سیستم مرجع مختصات ورودی. در صورت عدم تعیین، از SRS موجود در مجموعه‌داده ورودی استفاده خواهد شد. .sp سیستم‌های مرجع مختصات قابل ارسال شامل هر موردی است که توسط فراخوانی OGRSpatialReference.SetFromUserInput() پشتیبانی می‌شود، از جمله CRS تصویری، جغرافیایی یا ترکیبی EPSG (مانند EPSG:4296)، یک تعریف متنی CRS به فرمت WKT، تعاریف PROJ.4، یا نام یک فایل .prj حاوی تعریف WKT CRS. .sp اگر SRS دارای یک مبنای قائم (vertical datum) صریح باشد که به یک شبکه ژئوئید (geoid grid) اشاره دارد، و مجموعه‌داده ورودی تک‌بانده باشد، تصحیح عمودی بر مقادیر مجموعه‌داده اعمال خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-mode merge\-per\-layer\-name|stack|single راهبرد ایجاد لایه‌های خروجی از لایه‌های منبع را تعیین می‌کند. برای جزئیات بیشتر به بخش توضیحات مقدماتی مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-crs, \-d تنظیم سیستم مرجع مختصات خروجی. در صورت نیاز، ورودی‌ها به این CRS بازپروژکت خواهند شد. .sp سیستم‌های مرجع مختصات قابل ارسال شامل هر موردی است که توسط فراخوانی OGRSpatialReference.SetFromUserInput() پشتیبانی می‌شود، از جمله CRS تصویری، جغرافیایی یا ترکیبی EPSG (مانند EPSG:4296)، یک تعریف متنی CRS به فرمت WKT، تعاریف PROJ.4، یا نام یک فایل .prj حاوی تعریف WKT CRS. .sp اگر SRS دارای یک مبنای قائم صریح باشد که به یک شبکه ژئوئید اشاره دارد، و مجموعه‌داده ورودی تک‌بانده باشد، تصحیح عمودی بر مقادیر مجموعه‌داده اعمال خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نام لایه برداری خروجی (در حالت \fBsingle\fP، که مقدار پیش‌فرض آن \(dqmerged\(dq است)، یا الگوی نام‌گذاری لایه‌های برداری خروجی در حالت \fBstack\fP (مقدار پیش‌فرض \fB{AUTO_NAME}\fP است). در حالت \fBmerge\-per\-layer\-name\fP مجاز نیست. .sp الگو در حالت \fBstack\fP می‌تواند رشته‌ای حاوی متغیرهای زیر باشد که با مقدار محاسبه‌شده از لایه ورودی در حال پردازش جایگزین خواهند شد: .INDENT 7.0 .IP \(bu 2 \fB{AUTO_NAME}\fP: معادل با \fB{DS_BASENAME}_{LAYER_NAME}\fP در صورتی که هر دو مقدار متفاوت باشند، یا \fB{LAYER_NAME}\fP هنگامی که یکسان باشند (مانند حالت shapefile). .IP \(bu 2 \fB{DS_NAME}\fP: نام مجموعه‌داده منبع .IP \(bu 2 \fB{DS_BASENAME}\fP: نام پایه (base name) مجموعه‌داده منبع .IP \(bu 2 \fB{DS_INDEX}\fP: نمایه (index) مجموعه‌داده منبع .IP \(bu 2 \fB{LAYER_NAME}\fP: نام لایه منبع .IP \(bu 2 \fB{LAYER_INDEX}\fP: نمایه لایه منبع .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-source\-layer\-field\-content در صورت تعیین، طرح‌واره لایه هدف با یک فیلد جدید گسترش خواهد یافت (که نام آن توسط \fI\%\-\-source\-layer\-field\-name\fP، یا در غیر این صورت \fBsource_ds_lyr\fP مشخص می‌شود)، که محتوای آن توسط الگوی مشخص‌شده تعیین می‌گردد (متغیرهای قابل استفاده را در \fI\%\-\-output\-layer\fP ببینید). .UNINDENT .INDENT 0.0 .TP .B \-\-source\-layer\-field\-name در صورت تعیین، طرح‌واره لایه هدف با فیلدی گسترش می‌یابد که نام آن برابر با مقدار این گزینه بوده و محتوای آن توسط \fI\%\-\-source\-layer\-field\-content\fP تعیین می‌شود. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append تعیین می‌کند که آیا الحاق عوارض به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ساخت برای کنترل نسخه پشتیبانی می‌کند. .sp قابل تکرار است. .sp گزینه‌های ساخت موجود بسته به درایور فرمت متفاوت هستند، و برخی فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات خود فرمت مرجع نهایی اطلاعات مربوط به گزینه‌های ساخت درایور است. برای مشاهده گزینه‌های ساخت مجاز هر فرمت، مستندات اختصاصی \fI\%Vector drivers\fP را ببینید. .sp توجه داشته باشید که گزینه‌های ساخت مجموعه‌داده با گزینه‌های ساخت لایه تفاوت دارند. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام فرمت/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی به تعیین آن نیست، اما می‌توان از آن برای صرف‌نظر از تشخیص خودکار درایور در مواقعی که درایور مناسب انتخاب نمی‌شود استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چند درایور نامزد تکرار شود. توجه داشته باشید که این گزینه درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند؛ به‌ویژه برخی درایورها الزاماتی روی پسوند فایل دارند. .sp قابل تکرار است. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-layer نام یک یا چند لایه را برای پردازش مشخص می‌کند. به طور پیش‌فرض، تمامی لایه‌ها پردازش خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه ساخت لایه اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات لایه ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه (feature identifier) یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp قابل تکرار است. .sp گزینه‌های ساخت لایه موجود بسته به درایور فرمت متفاوت است و برخی فرمت‌های ساده اصلاً هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات فرمت مرجع نهایی اطلاعات گزینه‌های ساخت درایور است. مستندات اختصاصی فرمت \fI\%Vector drivers\fP را برای گزینه‌های ساخت مجاز هر فرمت ببینید. .sp توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه‌داده تفاوت دارند. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مخصوص فرمت). .sp قابل تکرار است. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format فرمت برداری خروجی مورد استفاده. مقادیر مجاز با اجرای دستور زیر قابل مشاهده هستند: \fBgdal \-\-formats | grep vector | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-output\-open\-option, \-\-output\-oo = در نسخه 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::CreateFeature()\fP، از عملیات \fI\%OGRLayer::UpsertFeature()\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، همچنین امکان upsert عوارضی که FID آن‌ها تنظیم نشده یا نامعتبر است (گزینه \fB\-\-unset\-fid\fP از \fI\%gdal vector edit\fP می‌تواند برای نادیده گرفتن FID از عارضه منبع استفاده شود) وجود دارد، به شرط آنکه یک ستون UNIQUE وجود داشته باشد که کلید اصلی عدد صحیح نباشد. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: ایجاد یک GeoPackage و قرار دادن تمام Shapefileهای ورودی در لایه‌های مجزا (حالت stack)" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector concat \-\-mode=stack *.shp out.gpkg .EE .UNINDENT .UNINDENT .SS "مثال ۲: افزودن فیلدی برای مشخص کردن لایه منبع و بازپروژکت کردن به یک CRS واحد" .sp الحاق محتوای \fBfrance.shp\fP و \fBgermany.shp\fP در \fBmerged.shp\fP، بازپروژکت کردن آن‌ها به ETRS89، و افزودن یک فیلد \(aqcountry\(aq به هر عارضه که مقدار آن بسته به منبع عارضه برابر با \(aqfrance\(aq یا \(aqgermany\(aq باشد: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector concat \-\-mode=single \-\-source\-layer\-field\-name=country \-\-output\-crs=EPSG:4258 france.shp germany.shp merged.shp .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .