.\" 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-SEGMENTIZE" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-segmentize \- قطعه‌بندی هندسه‌های یک مجموعه‌داده برداری .sp اضافه‌شده در نسخهٔ 3.12. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector segmentize [OPTIONS] Segmentize geometries of a vector dataset. Positional arguments: \-i, \-\-input Input vector datasets [required] [not available in pipelines] \-o, \-\-output Output vector dataset [required] [not available in pipelines] \-\-max\-length Maximum length of a segment [required] 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] \-\-active\-layer Set active layer (if not specified, all) \-\-active\-geometry Geometry field name to which to restrict the processing (if not specified, all) 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 segmentize\fP با درج نقاط میانی، تضمین می‌کند که قطعه‌های LineString یا حلقه‌های Polygon طولی بیشتر از حداکثر طول مشخص‌شده نداشته باشند. .sp این دستور عملیات \fI\%OGRGeometry::segmentize()\fP را اجرا می‌کند. .sp همچنین می‌تواند به عنوان مرحله‌ای از \fI\%gdal vector pipeline\fP استفاده شود. .SH "خروجی GDALG (مجموعه‌داده در لحظه / جاری) (GDALG OUTPUT (ON-FLY / STREAMED DATASET))" .sp این برنامه از سریال‌سازی خط فرمان در قالب یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه‌داده برداری باز شود و خط‌لوله (pipeline) مشخص‌شده را به صورت بلادرنگ (on\-the\-fly) یا جاری (streamed) اعمال نماید. .SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-max\-length مقدار مشخص‌شده برای این گزینه، حداکثر فاصله بین دو نقطه متوالی از هندسه خروجی پیش از افزودن نقاط میانی است. واحد این فاصله، واحدهای زمین‌مرجع‌شده (georeferenced) لایه منبع است. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-active\-geometry تنظیم فیلد هندسی فعال از روی نام آن. هنگامی که این گزینه مشخص شود، تنها فیلد هندسی مشخص‌شده تحت پردازش قرار خواهد گرفت. سایر فیلدهای هندسی تغییر نخواهند کرد. اگر این گزینه مشخص نشود، تمامی فیلدهای هندسی پردازش خواهند شد. این گزینه می‌تواند همراه با \fI\%\-\-active\-layer\fP ترکیب شود. .UNINDENT .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 مشخص می‌کند که آیا مجموعه‌داده خروجی موجود در حالت به‌روزرسانی (update mode) باز شود یا خیر. .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 "مثال ۱: اطمینان از اینکه قطعه‌های هندسه‌ها طولی بیش از یک کیلومتر نداشته باشند (با فرض اینکه CRS بر حسب متر است)" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector segmentize \-\-max\-length=1000 in.gpkg out.gpkg \-\-overwrite .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .