.\" 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 "OGRMERGE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
ogrmerge \- ادغام چندین مجموعه داده برداری در یک مجموعه داده واحد
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ogrmerge [\-\-help] [\-\-help\-general]
            \-o <out_dsname> <src_dsname> [<src_dsname>]...
            [\-f format] [\-single] [\-nln <layer_name_template>]
            [\-update | \-overwrite_ds] [\-append | \-overwrite_layer]
            [\-src_geom_type <geom_type_name>[,<geom_type_name>]...]
            [\-dsco <NAME>=<VALUE>]... [\-lco <NAME>=<VALUE>]...
            [\-s_srs <srs_def>] [\-t_srs <srs_def> | \-a_srs <srs_def>]
            [\-progress] [\-skipfailures] [\-\-help\-general]
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های مختص گزینهٔ \fI\%\-single\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[\-field_strategy FirstLayer|Union|Intersection]
[\-src_layer_field_name <name>]
[\-src_layer_field_content <layer_name_template>]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBogrmerge\fP چندین مجموعه داده برداری را که هر کدام شامل یک یا چند لایه برداری هستند به عنوان ورودی دریافت کرده و آن‌ها را در یک مجموعه داده مقصد کپی می‌کند.
.sp
اساساً دو حالت کاری وجود دارد:
.INDENT 0.0
.IP \(bu 2
حالت پیش‌فرض، که در آن هر لایه برداری ورودی به صورت یک لایه مجزا در مجموعه داده مقصد کپی می‌شود.
.IP \(bu 2
حالت دیگر، که با سوییچ \-single فعال می‌شود و محتوای تمام لایه‌های برداری ورودی را به یک لایه مقصد واحد الحاق می‌کند. این حالت فرض می‌کند که ساختار (schema) آن لایه‌های برداری کم‌وبیش یکسان است.
.UNINDENT
.sp
به صورت درونی، این دستور یک فایل \fI\%VRT \-\- OGR Virtual Format\fP تولید می‌کند، و اگر قالب خروجی VRT نباشد، تبدیل نهایی با \fBogr2ogr\fP یا \fBgdal.VectorTranslate()\fP انجام می‌شود. بنابراین برای کاربردهای پیشرفته، می‌توان خروجی را در قالب VRT گرفت، در صورت نیاز آن را به صورت دستی ویرایش کرد و سپس \fBogr2ogr\fP را اجرا نمود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار ogrmerge یک ابزار پایتونی است و تنها در صورتی که بایندرهای پایتون GDAL در دسترس باشند کار می‌کند.
.UNINDENT
.UNINDENT
.sp
\fBراهنمایی:\fP
.INDENT 0.0
.INDENT 3.5
معادل در رابط خط فرمان جدید \(dqgdal\(dq:
.sp
دستور \fI\%gdal vector concat\fP را ببینید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش پیام راهنمای مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-o <out_dsname>
نام مجموعه داده خروجی. الزامی است.
.UNINDENT
.INDENT 0.0
.TP
.B <src_dsname>
یک یا چند مجموعه داده برداری ورودی. الزامی است.
.UNINDENT
.INDENT 0.0
.TP
.B \-f <format>
انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل تشخیص داده می‌شود (پیش‌تر ESRI Shapefile بود). از نام کوتاه قالب استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-single
در صورت تعیین، تمام لایه‌های برداری ورودی در یک لایه واحد ادغام می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-nln <layer_name_template>
نام لایه برداری خروجی (در حالت single، که پیش‌فرض آن \(dqmerged\(dq است)، یا الگویی برای نام‌گذاری لایه‌های برداری خروجی در حالت پیش‌فرض (مقدار پیش‌فرض \fB{AUTO_NAME}\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: اندیس مجموعه داده منبع
.IP \(bu 2
\fB{LAYER_NAME}\fP: نام لایه منبع
.IP \(bu 2
\fB{LAYER_INDEX}\fP: اندیس لایه منبع
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-update
باز کردن یک مجموعه داده موجود در حالت به‌روزرسانی (update).
.UNINDENT
.INDENT 0.0
.TP
.B \-overwrite_ds
بازنویسی مجموعه داده موجود در صورت وجود (برای مجموعه‌های داده مبتنی بر فایل).
.UNINDENT
.INDENT 0.0
.TP
.B \-append
باز کردن یک مجموعه داده موجود در حالت به‌روزرسانی، و در صورتی که لایه‌های خروجی از قبل وجود داشته باشند، الحاق محتوای لایه‌های ورودی به آن‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B \-overwrite_layer
باز کردن یک مجموعه داده موجود در حالت به‌روزرسانی، و در صورتی که لایه‌های خروجی از قبل وجود داشته باشند، جایگزینی محتوای آن‌ها با محتوای لایه ورودی.
.UNINDENT
.INDENT 0.0
.TP
.B \-src_geom_type <geom_type_name>[,<geom_type_name>]...
فقط در نظر گرفتن لایه‌های ورودی که نوع هندسه (geometry) آن‌ها با نوع یا انواع مشخص‌شده مطابقت دارد. مقادیر معتبر برای geom_type_name عبارتند از: GEOMETRY، POINT، LINESTRING، POLYGON، MULTIPOINT، MULTILINESTRING، MULTIPOLYGON، GEOMETRYCOLLECTION، CIRCULARSTRING، CURVEPOLYGON، MULTICURVE، MULTISURFACE، CURVE، SURFACE، TRIANGLE، POLYHEDRALSURFACE و TIN.
.UNINDENT
.INDENT 0.0
.TP
.B \-dsco <NAME>=<VALUE>
گزینه ایجاد مجموعه داده (مختص قالب).
.UNINDENT
.INDENT 0.0
.TP
.B \-lco <NAME>=<VALUE>
گزینه ایجاد لایه (مختص قالب).
.UNINDENT
.INDENT 0.0
.TP
.B \-a_srs <srs_def>
انتساب یک سامانه مرجع مکانی (SRS) به خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-t_srs <srs_def>
بازتصویر/تبدیل مختصات به این SRS در خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-s_srs <srs_def>
بازنویسی و نادیده گرفتن SRS منبع.
.UNINDENT
.INDENT 0.0
.TP
.B \-progress
نمایش درصد پیشرفت در ترمینال. تنها در صورتی کار می‌کند که لایه‌های ورودی قابلیت \(dqfast feature count\(dq را داشته باشند.
.UNINDENT
.INDENT 0.0
.TP
.B \-skipfailures
ادامه عملیات پس از بروز خطا، با نادیده گرفتن عارضه (feature) با خطا مواجه‌شده.
.UNINDENT
.INDENT 0.0
.TP
.B \-field_strategy FirstLayer|Union|Intersection
تنها همراه با \fI\%\-single\fP استفاده می‌شود. تعیین می‌کند که ساختار (schema) لایه مقصد چگونه از ساختارهای لایه‌های ورودی ساخته شود. می‌تواند FirstLayer برای استفاده از فیلدهای نخستین لایه یافت‌شده، Union برای استفاده از اجتماع تمام فیلدهای همه لایه‌های منبع، یا Intersection برای استفاده از اشتراک فیلدهای مشترک همه لایه‌های منبع باشد. مقدار پیش‌فرض Union است.
.UNINDENT
.INDENT 0.0
.TP
.B \-src_layer_field_name <name>
تنها همراه با \fI\%\-single\fP استفاده می‌شود. در صورت تعیین، ساختار لایه مقصد با یک فیلد جدید به نام \(aqname\(aq گسترش می‌یابد که محتوای آن توسط \-src_layer_field_content مشخص می‌شود. بخش \fI\%مثال ۳\fP را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-src_layer_field_content <layer_name_template>
تنها همراه با \fI\%\-single\fP استفاده می‌شود. در صورت تعیین، ساختار لایه مقصد با یک فیلد جدید گسترش می‌یابد (که نام آن با \fI\%\-src_layer_field_name\fP، یا در غیر این صورت با \(aqsource_ds_lyr\(aq تعیین می‌شود) و محتوای آن توسط \fBlayer_name_template\fP مشخص می‌گردد. نحوِ نگارش \fBlayer_name_template\fP همانند \fI\%\-nln\fP است.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده‌ای که به صورت هشدار صادر می‌شوند به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: ساخت یک VRT با یک لایه به ازای هر shapefile ورودی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ogrmerge \-o merged.vrt *.shp
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: ساخت یک GeoPackage با یک لایه به ازای هر shapefile ورودی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ogrmerge \-o merged.gpkg *.shp
.EE
.UNINDENT
.UNINDENT
.SS مثال ۳: افزودن یک فیلد برای مشخص کردن لایه منبع
.sp
الحاق محتوای \fBfrance.shp\fP و \fBgermany.shp\fP در \fBmerged.shp\fP، و افزودن یک فیلد \(aqcountry\(aq به هر عارضه که مقدار آن بر اساس لایه منبع \(aqfrance\(aq یا \(aqgermany\(aq خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ogrmerge \-single \-o merged.shp france.shp germany.shp \-src_layer_field_name country
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.