.\" 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-CLIP" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-clip \- برش مجموعه‌داده برداری .sp در نگارش 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal vector clip [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 \-\-output\-layer نام لایه خروجی [در خط‌لوله‌ها در دسترس نیست] \-\-skip\-errors رد کردن خطاها هنگام نوشتن عوارض [در خط‌لوله‌ها در دسترس نیست] \-\-active\-layer تنظیم لایه فعال (اگر مشخص نشود، همه) \-\-bbox جعبه محصورکننده برش به صورت xmin,ymin,xmax,ymax مانعة‌الجمع با \-\-geometry و \-\-like \-\-bbox\-crs سامانه مرجع مختصات (CRS) جعبه محصورکننده برش \-\-geometry هندسه برش (WKT یا GeoJSON) مانعة‌الجمع با \-\-bbox و \-\-like \-\-geometry\-crs سامانه مرجع مختصات (CRS) هندسه برش \-\-like مجموعه‌داده برای استفاده به عنوان الگو جهت محدوده‌ها مانعة‌الجمع با \-\-bbox و \-\-geometry \-\-like\-sql دستور SELECT برای اجرا روی مجموعه‌داده \(aqlike\(aq مانعة‌الجمع با \-\-like\-where \-\-like\-layer نام لایه در مجموعه‌داده \(aqlike\(aq \-\-like\-where بند WHERE در SQL برای اجرا روی مجموعه‌داده \(aqlike\(aq مانعة‌الجمع با \-\-like\-sql گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست] \-\-upsert درج یا به‌روزرسانی (Upsert) عوارض (مستلزم \(aqappend\(aq) [در خط‌لوله‌ها در دسترس نیست] مانعة‌الجمع با \-\-append .EE .UNINDENT .UNINDENT.SH "توضیحات (DESCRIPTION)" .sp می‌توان از \fBgdal vector clip\fP برای برش دادن یک مجموعه داده برداری با استفاده از مختصات زمین‌مرجع استفاده کرد. .sp باید حتماً یکی از گزینه‌های \fI\%\-\-bbox\fP، \fI\%\-\-geometry\fP یا \fI\%\-\-like\fP مشخص شود. .sp همچنین می‌توان از \fBclip\fP به عنوان یک مرحله در \fI\%gdal vector pipeline\fP استفاده کرد\&. .sp عملیات برش گاهی منجر به تولید هندسه‌هایی می‌شود که با نوع هندسه لایه سازگار نیستند. این برنامه برای لایه‌هایی که از یک نوع هندسی تکی هستند (مانند point،‏ linestring یا polygon)، چند‌هندسه‌ها (multi\-geometries) یا مجموعه‌های هندسی را به بخش‌های تشکیل‌دهنده‌شان تفکیک کرده و تنها بخش‌هایی را که از همان نوع هستند نگه می‌دارد. همچنین انواع هندسی تکی (مانند polygons) را به انواع چند‌هندسی (مانند multi\-polygons) ارتقا می‌دهد. اگر کاربر نیاز به حفظ هر نوع اشتراکی داشته باشد، لایه باید از نوع \fBwkbUnknown\fP (هر نوع هندسه) استفاده کند. .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-bbox ,,, مرزهایی که مجموعه داده بر اساس آن‌ها برش داده می‌شود. فرض بر این است که این مقادیر در CRS مجموعه داده ورودی هستند، مگر اینکه \fI\%\-\-bbox\-crs\fP مشخص شده باشد. محورهای X و Y از نوع \(dqسازگار با GIS\(dq هستند؛ بدین صورت که X نشان‌دهنده طول جغرافیایی یا جهت خاوری (easting) و Y نشان‌دهنده عرض جغرافیایی یا جهت شمالی (northing) است. امکان استفاده هم‌زمان با \fI\%\-\-like\fP و \fI\%\-\-geometry\fP وجود ندارد\&. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox\-crs سامانه مرجع مختصاتی (CRS) که مقادیر ,,, در گزینه \fI\%\-\-bbox\fP بر حسب آن بیان شده‌اند. اگر تعیین نشود، فرض می‌شود که همان CRS مجموعه داده ورودی است. توجه داشته باشید که تعیین \-\-bbox\-crs شامل انجام بازتصویرسازی برداری نمی‌شود؛ بلکه مرزها از bbox\-crs به CRS مجموعه داده ورودی بازتصویر می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-geometry هندسه به صورت یک رشته با ساختار WKT یا GeoJSON که مجموعه داده بر اساس آن برش داده می‌شود. اگر هندسه ورودی GeoJSON باشد، CRS آن WGS84 فرض می‌شود، مگر اینکه یک CRS درون هندسه GeoJSON تعریف شده باشد یا گزینه \fI\%\-\-geometry\-crs\fP مشخص گردد. اگر هندسه ورودی WKT باشد، CRS آن همان CRS مجموعه داده ورودی لحاظ می‌شود، مگر اینکه \fI\%\-\-geometry\-crs\fP مشخص شده باشد. محورهای X و Y از نوع \(dqسازگار با GIS\(dq هستند؛ یعنی X طول جغرافیایی یا جهت خاوری (easting) و Y عرض جغرافیایی یا جهت شمالی (northing) است. امکان استفاده هم‌زمان با \fI\%\-\-bbox\fP و \fI\%\-\-like\fP وجود ندارد\&. .UNINDENT .INDENT 0.0 .TP .B \-\-geometry\-crs سامانه مرجع مختصاتی (CRS) که مقادیر مختصات \fI\%\-\-geometry\fP بر حسب آن بیان شده‌اند. اگر تعیین نشود، فرض می‌شود که همان CRS مجموعه داده ورودی است. توجه داشته باشید که تعیین \-\-geometry\-crs شامل انجام بازتصویرسازی برداری نمی‌شود؛ بلکه مرزها از geometry\-crs به CRS مجموعه داده ورودی بازتصویر می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-like مجموعه داده برداری یا شطرنجی (رستری) برای استفاده به عنوان الگو جهت تعیین مرزها. اگر مجموعه داده تعیین‌شده رستر باشد، مرزهای مستطیلی آن به عنوان هندسه برش استفاده خواهد شد. اگر مجموعه داده تعیین‌شده برداری باشد، هندسه‌های چندضلعی آن با یکدیگر ادغام (اجتماع) می‌شوند تا هندسه برش تشکیل شود (دقت داشته باشید در صورت وجود شکاف میان عوارض چندضلعی مجزا، اجتماع حاصل ممکن است کاملاً یکپارچه نباشد). در صورت وجود چندین لایه، باید \fI\%\-\-like\-sql\fP یا \fI\%\-\-like\-layer\fP مشخص گردد. امکان استفاده هم‌زمان با \fI\%\-\-bbox\fP و \fI\%\-\-geometry\fP وجود ندارد\&. .UNINDENT .INDENT 0.0 .TP .B \-\-like\-layer انتخاب لایه نام‌برده از مجموعه داده برداری برش. امکان استفاده هم‌زمان با \fI\%\-\-like\-sql\fP وجود ندارد\&. .UNINDENT .INDENT 0.0 .TP .B \-\-like\-sql انتخاب هندسه‌های مورد نظر از مجموعه داده برداری برش با استفاده از یک پرس‌وجوی SQL. برای نمونه: \fBSELECT geom FROM my_layer WHERE country = \(aqFrance\(aq\fP\&. امکان استفاده هم‌زمان با \fI\%\-\-like\-layer\fP و \fI\%\-\-like\-where\fP وجود ندارد\&. .UNINDENT .INDENT 0.0 .TP .B \-\-like\-where محدود کردن هندسه‌های مورد نظر از لایه مجموعه داده برداری برش بر پایه یک پرس‌وجوی توصیفی (ویژگی). برای نمونه: \fBcountry = \(aqFrance\(aq\fP\&. .UNINDENT.SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-active\-layer لایه فعال را تنظیم می‌کند. هنگامی که این گزینه مشخص شود، تنها لایه‌ای که با نام مشخص شده است پردازش خواهد شد. سایر لایه‌ها دست‌نخورده باقی می‌مانند. اگر این گزینه مشخص نشود، تمام لایه‌ها پردازش خواهند شد. .UNINDENT .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 نام یک یا چند لایه را برای پردازش مشخص می‌کند. به‌طور پیش‌فرض، تمام لایه‌ها پردازش خواهند شد. برای خواندن و نوشتن تمام لایه‌ها اما پردازش تنها یک زیرمجموعه، از \fI\%\-\-active\-layer\fP\& استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توان از آن‌ها برای کنترل جزئیات لایه ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .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 \-\-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 "وضعیت خروج (EXIT STATUS)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا، مقداری غیرصفر بازمی‌گرداند (خطاهای غیرمسدودکننده‌ای که به‌صورت هشدار اعلام می‌شوند، اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: برش یک فایل GeoPackage به کادر احاطه‌کننده از طول جغرافیایی 2، عرض جغرافیایی 49 تا طول جغرافیایی 3، عرض جغرافیایی 50 در WGS 84 .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector clip \-\-bbox=2,49,3,50 \-\-bbox\-crs=EPSG:4326 in.gpkg out.gpkg \-\-overwrite .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .