.\" 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-CLEAN-COVERAGE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-clean-coverage \- حذف فاصله‌ها (شکاف‌ها) و هم‌پوشانی‌ها از یک مجموعه‌داده چندضلعی .sp در نسخه 3.12 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector clean\-coverage [OPTIONS] تغییر مرزهای چندضلعی‌ها برای یکسان‌سازی لبه‌های مشترک و حذف فاصله‌ها و هم‌پوشانی‌ها آرگومان‌های موضعی (Positional arguments): \-i, \-\-input مجموعه‌داده‌های برداری ورودی [الزامی] [در خطوط لوله در دسترس نیست] \-o, \-\-output مجموعه‌داده برداری خروجی [الزامی] [در خطوط لوله در دسترس نیست] گزینه‌های عمومی (Common Options): \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها (Options): \-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 تعیین لایه فعال (در صورت عدم تعیین، همه) \-\-snapping\-distance میزان رواداری فاصله برای چسباندن (Snap) گره‌ها \-\-merge\-strategy الگوریتم اختصاص هم‌پوشانی‌ها به چندضلعی‌های همسایه. MERGE\-STRATEGY=longest\-border|max\-area|min\-area|min\-index \-\-maximum\-gap\-width حداکثر پهنای فاصله (شکاف) جهت بسته شدن گزینه‌های پیشرفته (Advanced Options): \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-upsert درج یا به‌روزرسانی (Upsert) عوارض (شامل \(aqappend\(aq) [در خطوط لوله در دسترس نیست] ناسازگار با \-\-append .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal vector clean\-coverage\fP مرزهای یک مجموعه‌داده چندضلعی را به نحوی اصلاح می‌کند که فاصله‌ها و هم‌پوشانی‌های میان عوارض حذف شده و لبه‌های مشترک با استفاده از رأس‌های یکسان تعریف شوند. مجموعه‌داده حاصل یک پوشش چندضلعی (Polygonal Coverage) را تشکیل می‌دهد که می‌تواند با \fI\%gdal vector simplify\-coverage\fP استفاده شود. .sp این دستور همچنین می‌تواند به عنوان مرحله‌ای از \fI\%gdal vector pipeline\fP به کار رود، هرچند نیازمند بارگذاری کل مجموعه‌داده در حافظه به صورت یکجا است. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 این دستور نیازمند ساخت GDAL به همراه کتابخانه GEOS (نسخه 3.14 یا بالاتر) است. .UNINDENT .UNINDENT .SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی)" .sp این برنامه از سریالی‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند به عنوان یک مجموعه‌داده برداری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز شود و خط لوله تعیین‌شده را به صورت در لحظه / جریانی اعمال کند. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال، این الگوریتم ذاتاً با پخش جریانی سازگار نیست. در نتیجه یک مجموعه‌داده موقت درون‌حافظه‌ای ایجاد خواهد شد که ممکن است زمان پردازش قابل‌توجهی را هنگام باز کردن ایجاد کند. .UNINDENT .UNINDENT .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-input\-layer نام لایه مورد پردازش را مشخص می‌کند. به‌طور پیش‌فرض، تمام لایه‌ها پردازش خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-maximum\-gap\-width بزرگ‌ترین مساحتی را که باید به عنوان یک \(dqفاصله/شکاف\(dq در نظر گرفته شده و با یک چندضلعی مجاور ادغام شود تعیین می‌کند. فاصله‌ها ادغام خواهند شد مگر اینکه دایره‌ای با شعاع بزرگ‌تر از رواداری مشخص‌شده بتواند درون آن فاصله محاط شود. حداکثر پهنای پیش‌فرض فاصله صفر است، به این معنی که فاصله‌ها بسته نمی‌شوند. .INDENT 7.0 .INDENT 2.5 [تصویر] مجموعه‌داده چندضلعی پیش از پاک‌سازی (چپ)، پس از پاک‌سازی با پارامترهای پیش‌فرض (وسط)، و پس از پاک‌سازی با \fB\-\-maximum\-gap\-width 1\fP (راست). .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-merge\-strategy روشی که بر اساس آن هم‌پوشانی‌ها یا شکاف‌ها باید به چندضلعی‌های مجاور اضافه شوند. گزینه‌ها شامل موارد زیر است: .INDENT 7.0 .IP \(bu 2 longest\-border (پیش‌فرض): افزودن مساحت‌ها به چندضلعی‌ای که طولانی‌ترین مرز مشترک را با آن دارد .IP \(bu 2 max\-area: افزودن مساحت‌ها به بزرگ‌ترین چندضلعی مجاور .IP \(bu 2 min\-area: افزودن مساحت‌ها به کوچک‌ترین چندضلعی مجاور .IP \(bu 2 min\-index: افزودن مساحت‌ها به چندضلعی مجاوری که ابتدا خوانده شده است .UNINDENT .INDENT 7.0 .INDENT 2.5 [تصویر] مجموعه‌داده چندضلعی پیش از پاک‌سازی (چپ)، پس از پاک‌سازی با راهبرد ادغام \(dqlongest\-border\(dq (وسط) و \fB\-\-merge\-strategy max\-area\fP (راست). .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته می‌شوند. به‌طور پیش‌فرض، نام‌های لایه‌های خروجی مشابه نام‌های لایه‌های ورودی خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-\-snapping\-distance مرحله چسباندن گره‌ها (Node Snapping) را هنگام چسبیدن رأس‌های نزدیک به هم کنترل می‌کند. به‌طور پیش‌فرض، یک فاصله چسباندن خودکار بر اساس تحلیل ورودی تعیین می‌شود. برای خاموش کردن هرگونه چسباندن گره‌ها، آن را برابر صفر قرار دهید. .INDENT 7.0 .INDENT 2.5 [تصویر] مجموعه‌داده چندضلعی پیش از پاک‌سازی (چپ)، پس از پاک‌سازی با فاصله چسباندن پیش‌فرض (وسط)، و فاصله سخت‌گیرانه‌تر \fB\-\-snapping\-distance 0.2\fP (راست). به جابجایی رخ‌داده در گوشه بالا سمت چپ چندضلعی در سمت راست توجه کنید. .UNINDENT .UNINDENT .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 \-\-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\-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::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 وجود داشته باشد که کلید اصلی عددی صحیح نباشد، امکان انجام upsert برای عوارضی که FID آن‌ها تنظیم نشده یا فاقد اهمیت است نیز وجود دارد (گزینه \fB\-\-unset\-fid\fP در \fI\%gdal vector edit\fP می‌تواند برای نادیده گرفتن FID عارضه منبع استفاده شود). .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: ایجاد و سپس ساده‌سازی یک پوشش چندضلعی .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector pipeline read ne_10m_admin_0_countries.shp ! \e make\-valid ! \e clean\-coverage ! \e simplify\-coverage \-\-tolerance 1 ! \e write countries.shp .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Dan Baston .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .