.\" 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-LAYER-ALGEBRA" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-layer-algebra \- اجرای عملیات جبری میان ۲ لایه برداری .sp افزوده شده در نسخه 3.12. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal vector layer\-algebra [گزینه‌ها] اجرای عملیات جبری میان ۲ لایه برداری. آرگومان‌های موضعی: \-\-operation عملیات مورد نظر برای اجرا. OPERATION=union|intersection|sym\-difference|identity|update|clip|erase [الزامی] \-i, \-\-input مجموعه‌داده برداری ورودی [الزامی] \-\-method مجموعه‌داده برداری متد [الزامی] \-o, \-\-output مجموعه‌داده برداری خروجی [الزامی] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش شیوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (عدم نمایش نوار پیشرفت یا پیام‌های هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی \-\-co, \-\-creation\-option = گزینه ایجاد مجموعه‌داده [تکرارپذیر] \-\-lco, \-\-layer\-creation\-option = گزینه ایجاد لایه [تکرارپذیر] \-\-overwrite آیا رونویسی روی مجموعه‌داده خروجی موجود مجاز است \-\-update آیا مجموعه‌داده موجود در حالت به‌روزرسانی باز شود \-\-overwrite\-layer آیا رونویسی روی لایه خروجی موجود مجاز است \-\-append آیا الحاق به لایه موجود مجاز است \-\-input\-layer نام لایه ورودی \-\-method\-layer نام لایه متد \-\-output\-layer نام لایه خروجی \-\-geometry\-type نوع هندسه (Geometry type) گزینه‌های پیشرفته: \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] \-\-input\-prefix پیشوند برای فیلدهای مربوط به لایه ورودی \-\-input\-field فیلد(های) ورودی برای افزودن به لایه خروجی [تکرارپذیر] ناسازگار با \-\-no\-input\-field، \-\-all\-input\-field \-\-no\-input\-field عدم افزودن هیچ فیلد ورودی به لایه خروجی ناسازگار با \-\-input\-field، \-\-all\-input\-field \-\-all\-input\-field افزودن تمام فیلدهای ورودی به لایه خروجی ناسازگار با \-\-input\-field، \-\-no\-input\-field \-\-method\-prefix پیشوند برای فیلدهای مربوط به لایه متد \-\-method\-field فیلد(های) متد برای افزودن به لایه خروجی [تکرارپذیر] ناسازگار با \-\-no\-method\-field، \-\-all\-method\-field \-\-no\-method\-field عدم افزودن هیچ فیلد متد به لایه خروجی ناسازگار با \-\-method\-field، \-\-all\-method\-field \-\-all\-method\-field افزودن تمام فیلدهای متد به لایه خروجی ناسازگار با \-\-method\-field، \-\-no\-method\-field .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal vector layer\-algebra\fP عملیات مختلف جبر لایه برداری را انجام می‌دهد. این دستور یک منبع برداری ورودی و یک منبع متد (روش) دریافت کرده و خروجی عملیات را در فایل خروجی مشخص‌شده تولید می‌کند. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-geometry\-type تغییر نوع هندسه به یکی از مقادیر زیر: \fBGEOMETRY\fP، \fBPOINT\fP، \fBLINESTRING\fP، \fBPOLYGON\fP، \fBMULTIPOINT\fP، \fBMULTILINESTRING\fP، \fBMULTIPOLYGON\fP، \fBGEOMETRYCOLLECTION\fP، \fBCURVE\fP، \fBCIRCULARSTRING\fP، \fBCOMPOUNDCURVE\fP، \fBSURFACE\fP، \fBCURVEPOLYGON\fP، \fBMULTICURVE\fP، \fBMULTISURFACE\fP، \fBPOLYHEDRALSURFACE\fP یا \fBTIN\fP\&. پسوندهای \fBZ\fP، \fBM\fP یا \fBZM\fP را می‌توان به مقادیر فوق اضافه کرد تا بعد فضایی مشخص شود. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-layer نام لایه برداری ورودی. .UNINDENT .INDENT 0.0 .TP .B \-\-operation union|intersection|sym\-difference|identity|update|clip|erase انتخاب عملیات مورد نظر از میان موارد زیر: .INDENT 7.0 .IP \(bu 2 \fBunion\fP .INDENT 2.0 .INDENT 3.5 اجتماع (Union) مجموعه‌ای از عوارض است که مساحت‌های موجود در هر یک از لایه‌های عملوند را نمایش می‌دهد. این عملیات متقارن است و جای لایه‌های ورودی و متد می‌تواند با یکدیگر عوض شود. [image] .UNINDENT .UNINDENT .IP \(bu 2 \fBintersection\fP .INDENT 2.0 .INDENT 3.5 اشتراک (Intersection) مجموعه‌ای از عوارض است که مساحت‌های مشترک میان دو لایه را نمایش می‌دهد. این عملیات متقارن است و جای لایه‌های ورودی و متد می‌تواند با یکدیگر عوض شود. [image] .UNINDENT .UNINDENT .IP \(bu 2 \fBsym\-difference\fP .INDENT 2.0 .INDENT 3.5 تفاضل متقارن (Symmetric difference) مجموعه‌ای از عوارض است که مساحت‌های موجود در لایه‌های عملوند را که با یکدیگر هم‌پوشانی ندارند نمایش می‌دهد. این عملیات متقارن است و جای لایه‌های ورودی و متد می‌تواند با یکدیگر عوض شود. [image] .UNINDENT .UNINDENT .IP \(bu 2 \fBidentity\fP .INDENT 2.0 .INDENT 3.5 روش همانی (Identity) عوارض موجود در لایه ورودی را با عوارض موجود در لایه متد شناسایی می‌کند و در صورت نیاز ممکن است عوارض را به چند عارضه تقسیم کند. به طور پیش‌فرض، لایه نتیجه دارای ویژگی‌ها (Attributeها) از هر دو لایه عملوند است. [image] .UNINDENT .UNINDENT .IP \(bu 2 \fBupdate\fP .INDENT 2.0 .INDENT 3.5 روش به‌روزرسانی (Update) لایه‌ای ایجاد می‌کند که عوارض لایه متد را به لایه ورودی اضافه کرده و در صورت نیاز ممکن است عوارض لایه ورودی را برش دهد. به طور پیش‌فرض، لایه حاصل فقط دارای ویژگی‌های لایه ورودی خواهد بود. [image] .UNINDENT .UNINDENT .IP \(bu 2 \fBclip\fP .INDENT 2.0 .INDENT 3.5 روش برش (Clip) لایه‌ای ایجاد می‌کند که عوارض لایه ورودی را به مساحت عوارض موجود در لایه متد برش می‌دهد. به طور پیش‌فرض، لایه نتیجه ویژگی‌های لایه ورودی را حفظ می‌کند. [image] .UNINDENT .UNINDENT .IP \(bu 2 \fBerase\fP .INDENT 2.0 .INDENT 3.5 روش پاک کردن (Erase) لایه‌ای ایجاد می‌کند که عوارض لایه ورودی را در مناطقی که با عوارض لایه متد هم‌پوشانی دارند پاک می‌کند. به طور پیش‌فرض، لایه حاصل ویژگی‌های لایه ورودی را دارد. [image] .UNINDENT .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-method\-layer نام لایه برداری متد. .UNINDENT .SS "گزینه‌های پیشرفته (Advanced options)" .INDENT 0.0 .TP .B \-\-all\-input\-field افزودن تمام فیلدهای ورودی به لایه خروجی. ناسازگار با \fI\%\-\-input\-field\fP و \fI\%\-\-no\-input\-field\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-all\-method\-field افزودن تمام فیلدهای متد به لایه خروجی. ناسازگار با \fI\%\-\-method\-field\fP و \fI\%\-\-no\-method\-field\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-field فیلد(های) ورودی برای افزودن به لایه خروجی [تکرارپذیر] ناسازگار با \fI\%\-\-no\-input\-field\fP و \fI\%\-\-all\-input\-field\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-prefix پیشوند برای فیلدهای مربوط به لایه ورودی. اگر هر دو فیلدهای ورودی و متد وجود داشته باشند پیش‌فرض \fBinput_\fP است، در غیر این صورت رشته خالی است. .UNINDENT .INDENT 0.0 .TP .B \-\-method\-field فیلد(های) متد برای افزودن به لایه خروجی [تکرارپذیر] ناسازگار با \fI\%\-\-no\-method\-field\fP و \fI\%\-\-all\-method\-field\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-method\-prefix پیشوند برای فیلدهای مربوط به لایه متد. اگر هر دو فیلدهای ورودی و متد وجود داشته باشند پیش‌فرض \fBmethod_\fP است، در غیر این صورت رشته خالی است. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-input\-field عدم افزودن هیچ فیلد ورودی به لایه خروجی. ناسازگار با \fI\%\-\-input\-field\fP و \fI\%\-\-all\-input\-field\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-method\-field عدم افزودن هیچ فیلد متد به لایه خروجی. ناسازگار با \fI\%\-\-method\-field\fP و \fI\%\-\-all\-method\-field\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 \-\-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\-layer نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته خواهند شد. در صورت عدم مشخص شدن، نام لایه‌های خروجی مشابه نام لایه‌های ورودی خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite اجازه دادن به برنامه برای رونویسی روی فایل یا مجموعه‌داده مقصد موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite\-layer تعیین اینکه آیا رونویسی روی لایه برداری خروجی موجود مجاز است یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-update تعیین اینکه آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی (Update) باز شود یا خیر. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: اجرای اجتماع میان هر دو لایه ورودی و متد. .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector layer\-algebra union input.shp method.shp output.shp .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .