.\" 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-CHECK-GEOMETRY" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-check-geometry \- بررسی یک مجموعه‌داده از نظر هندسه‌های نامعتبر یا غیرساده .sp افزوده شده در نسخه 3.12. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector check\-geometry [OPTIONS] Check a dataset for invalid geometries Positional arguments: \-i, \-\-input Input vector datasets [required] [not available in pipelines] \-o, \-\-output Output vector dataset [required] [not available in pipelines] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-l, \-\-layer, \-\-input\-layer Input layer name(s) [may be repeated] [not available in pipelines] \-f, \-\-of, \-\-format, \-\-output\-format Output format (\(dqGDALG\(dq allowed) [not available in pipelines] \-\-co, \-\-creation\-option = Creation option [may be repeated] [not available in pipelines] \-\-lco, \-\-layer\-creation\-option = Layer creation option [may be repeated] [not available in pipelines] \-\-overwrite Whether overwriting existing output dataset is allowed [not available in pipelines] \-\-update Whether to open existing dataset in update mode [not available in pipelines] \-\-overwrite\-layer Whether overwriting existing output layer is allowed [not available in pipelines] \-\-append Whether appending to existing layer is allowed [not available in pipelines] Mutually exclusive with \-\-upsert \-\-output\-layer Output layer name [not available in pipelines] \-\-skip\-errors Skip errors when writing features [not available in pipelines] \-\-no\-create\-empty\-layers Avoid creating layers to which no features will be written [not available in pipelines] \-\-include\-field Fields from input layer to include in output (special values: ALL and NONE) (default: NONE) [may be repeated] \-\-include\-valid Include valid inputs in output, with empty geometry \-\-geometry\-field Name of geometry field to check Advanced Options: \-\-if, \-\-input\-format Input formats [may be repeated] [not available in pipelines] \-\-oo, \-\-open\-option = Open options [may be repeated] [not available in pipelines] \-\-output\-oo, \-\-output\-open\-option = Output open options [may be repeated] [not available in pipelines] \-\-upsert Upsert features (implies \(aqappend\(aq) [not available in pipelines] Mutually exclusive with \-\-append .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal vector check\-geometry\fP بررسی می‌کند که آیا عناصر مجزای یک مجموعه‌داده طبق استاندارد عوارض ساده \fI\%OGC\fP معتبر و ساده هستند یا خیر. برای هر عارضه نامعتبر یا غیرساده، شرحی از خطا و در بیشتر موارد، موقعیت نقطه‌ای خطا را در خروجی ارائه می‌دهد. .sp بسته به نوع هندسه ورودی، بررسی‌های زیر انجام می‌شود: .INDENT 0.0 .IP \(bu 2 چندضلعی‌ها (Polygon) و چندچندضلعی‌ها (MultiPolygon) از نظر معتبر بودن بررسی می‌شوند. حتی اگر چندین علت برای نامعتبر بودن وجود داشته باشد، یک نقطه خطای تکی گزارش خواهد شد. .IP \(bu 2 رشته‌خط‌ها (LineString) و چندرشته‌خط‌ها (MultiLineString) از نظر ساده بودن بررسی می‌شوند. اگر GDAL با نسخه 3.14 یا بالاتر کتابخانه GEOS ساخته شده باشد، تمام نقاط خودهم‌پوشانی (self\-intersection) گزارش می‌شوند. در نسخه‌های قدیمی‌تر، مکان‌های خودهم‌پوشانی گزارش نمی‌شوند. .IP \(bu 2 مجموعه‌های هندسی (GeometryCollection) بررسی می‌شوند تا عناصر مجزای آن‌ها معتبر / ساده باشند. حتی اگر چندین علت برای نامعتبر بودن وجود داشته باشد، یک نقطه خطای تکی گزارش خواهد شد. .IP \(bu 2 سایر انواع هندسه بررسی نمی‌شوند. .UNINDENT .sp بررسی اعتبار/سادگی توسط کتابخانه GEOS انجام می‌شود و باید با نتایج نرم‌افزارهایی چون PostGIS، QGIS و shapely که از این کتابخانه استفاده می‌کنند سازگار باشد. GEOS نقاط تکراری را علتی برای نامعتبر بودن یا غیرساده بودن در نظر نمی‌گیرد. برای اطلاعات بیشتر درباره آزمون اعتبار انجام‌شده توسط \fBgdal vector check\-geometry\fP و نمونه‌هایی از خطاهای گزارش‌شده، \fI\%Geometry Validity\fP را ببینید\&. .INDENT 0.0 .INDENT 2.5 [تصویر] مکان‌های خطای گزارش‌شده توسط \fBgdal vector check\-geometry\fP برای ورودی‌های Polygon، MultiPolygon و LineString. .UNINDENT .UNINDENT .sp \fBهشدار:\fP .INDENT 0.0 .INDENT 3.5 هندسه‌های منحنی پیش از تبدیل به GEOS خطی‌سازی (linearize) می‌شوند. هندسه‌های خطی‌شده ممکن است در جایی که هندسه‌های اصلی نامعتبر هستند، معتبر/ساده باشند و برعکس. .UNINDENT .UNINDENT .SH "خروجی GDALG (مجموعه‌داده درلحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان به صورت یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به‌عنوان یک مجموعه‌داده برداری باز شود و خط لوله مشخص‌شده را به‌صورت درلحظه (on\-the\-fly) / جریانی (streamed) اعمال کند. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال، این الگوریتم به‌صورت ذاتی با جریان‌دهی سازگار نیست. در نتیجه یک مجموعه‌داده موقت در حافظه ایجاد خواهد شد که ممکن است زمان پردازش قابل‌توجهی هنگام باز شدن ایجاد کند. .UNINDENT .UNINDENT .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-geometry\-field برای لایه‌هایی که چندین فیلد هندسه دارند، نام فیلد هندسه مورد نظر برای آزمون را مشخص می‌کند. به‌طور پیش‌فرض از نخستین فیلد هندسه استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-include\-field افزوده شده در نسخه 3.12.1. .sp فیلد(های) اختیاری برای کپی شدن از عوارض ورودی به خروجی. از نسخه GDAL 3.13 به بعد، مقدار \fBALL\fP می‌تواند برای گنجاندن تمام فیلدها از لایه مبدا استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-include\-valid گنجاندن عوارض مربوط به هندسه‌های معتبر/ساده در خروجی، با حفظ تناظر یک‌به‌یک (1:1) بین عوارض ورودی و خروجی. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-layer نام یک یا چند لایه را برای پردازش مشخص می‌کند. به‌طور پیش‌فرض، تمام لایه‌ها پردازش خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نام لایه‌ای را که عوارض در آن نوشته خواهند شد مشخص می‌کند. اگر مشخص نشود و تنها یک لایه ورودی وجود داشته باشد، از نام \(dqerror_location\(dq استفاده خواهد شد. اگر مشخص نشود و چندین لایه ورودی وجود داشته باشد، عوارض مربوط به هر لایه ورودی در یک لایه خروجی جداگانه با قالب \(dqerror_location_{INPUT_LAYER}\(dq نوشته خواهند شد. .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 از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت لایه موجود بسته به درایور قالب متغیر است و برخی قالب‌های ساده هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات قالب، منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. مستندات اختصاصی قالب \fI\%Vector drivers\fP را برای گزینه‌های ساخت مجاز هر قالب ببینید. .sp توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه‌داده تفاوت دارند. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-create\-empty\-layers افزوده شده در نسخه 3.13. .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 وجود داشته باشد که کلید اصلی عدد صحیح (integer primary key) نباشد. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp برنامه در صورت موفقیت، کد وضعیت 0 و در صورت بروز خطا، کدی غیر از صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند به‌عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: چاپ مکان‌های نامعتبر در کنسول" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector check\-geometry ne_10m_admin_0_countries.shp \e \-\-quiet \e \-f CSV \e \-\-lco GEOMETRY=AS_XY \e \-\-lco SEPARATOR=TAB \e /vsistdout/ # X Y error # 35.6210871060001 23.1392929140001 Ring Self\-intersection .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Dan Baston .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .