.\" 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-SORT" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vector-sort \- مرتب‌سازی مکانی یک مجموعه داده برداری
.sp
در نسخه 3.13 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal vector sort [OPTIONS] <INPUT> <OUTPUT>

مرتب‌سازی مکانی عوارض در یک لایه

آرگومان‌های موقعیتی:
  \-i, \-\-input <INPUT>                                  مجموعه داده‌های برداری ورودی [الزامی] [در خطوط لوله در دسترس نیست]
  \-o, \-\-output <OUTPUT>                                مجموعه داده برداری خروجی [الزامی] [در خطوط لوله در دسترس نیست]

گزینه‌های عمومی:
  \-h, \-\-help                                           نمایش پیام راهنما و خروج
  \-\-json\-usage                                         نمایش نحوه استفاده به صورت سند JSON و خروج
  \-\-config <KEY>=<VALUE>                               گزینه پیکربندی [قابل تکرار]
  \-q, \-\-quiet                                          حالت ساکت (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست]

گزینه‌ها:
  \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>             نام لایه(های) ورودی [قابل تکرار] [در خطوط لوله در دسترس نیست]
  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خطوط لوله در دسترس نیست]
  \-\-co, \-\-creation\-option <KEY>=<VALUE>                گزینه ایجاد [قابل تکرار] [در خطوط لوله در دسترس نیست]
  \-\-lco, \-\-layer\-creation\-option <KEY>=<VALUE>         گزینه ایجاد لایه [قابل تکرار] [در خطوط لوله در دسترس نیست]
  \-\-overwrite                                          آیا بازنویسی روی مجموعه داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
  \-\-update                                             آیا باز کردن مجموعه داده موجود در حالت به‌روزرسانی مجاز است [در خطوط لوله در دسترس نیست]
  \-\-overwrite\-layer                                    آیا بازنویسی روی لایه خروجی موجود مجاز است [در خطوط لوله در دسترس نیست]
  \-\-append                                             آیا الحاق به لایه موجود مجاز است [در خطوط لوله در دسترس نیست]
                                                        ناسازگار با \-\-upsert
  \-\-output\-layer <OUTPUT\-LAYER>                        نام لایه خروجی [در خطوط لوله در دسترس نیست]
  \-\-skip\-errors                                        نادیده گرفتن خطاها هنگام نوشتن عوارض [در خطوط لوله در دسترس نیست]
  \-\-geometry\-field <GEOMETRY\-FIELD>                    نام فیلد هندسه برای استفاده در مرتب‌سازی
  \-\-method <METHOD>                                    الگوریتم مرتب‌سازی هندسه. METHOD=hilbert|strtree (پیش‌فرض: hilbert)
  \-\-use\-tempfile                                       نوشتن عوارض در یک فایل موقت برای جلوگیری از بارگذاری کل مجموعه داده ورودی در حافظه

گزینه‌های پیشرفته:
  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  قالب‌های ورودی [قابل تکرار] [در خطوط لوله در دسترس نیست]
  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    گزینه‌های باز کردن [قابل تکرار] [در خطوط لوله در دسترس نیست]
  \-\-output\-oo, \-\-output\-open\-option <KEY>=<VALUE>      گزینه‌های باز کردن خروجی [قابل تکرار] [در خطوط لوله در دسترس نیست]
  \-\-upsert                                             به‌روزرسانی یا درج عوارض (به معنای \(aqappend\(aq است) [در خطوط لوله در دسترس نیست]
                                                        ناسازگار با \-\-append
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vector sort\fP عوارض موجود در یک مجموعه داده برداری را بر اساس موقعیت هندسه‌شان مرتب می‌کند. روش مرتب‌سازی را می‌توان از طریق \fI\%\-\-method\fP تعیین کرد که شامل الگوریتم‌های هیلبرت (Hilbert) و Sort\-Tile\-Recursive (STRTree) است.
.sp
عوارضی که هندسه تهی یا نامعتبر دارند، در انتهای مجموعه داده مرتب‌شده قرار خواهند گرفت.
.sp
این دستور همچنین می‌تواند به عنوان یک مرحله در \fI\%gdal vector pipeline\fP به کار رود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
استفاده از الگوریتم STRtree نیازمند بیلد GDAL همراه با کتابخانه GEOS است.
.UNINDENT
.UNINDENT
.SH "گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-geometry\-field <GEOMETRY\-FIELD>
نام فیلد هندسه‌ای که عوارض باید بر اساس آن مرتب شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-method <METHOD>
روش مرتب‌سازی را تعیین می‌کند. گزینه‌های موجود عبارتند از:
.INDENT 7.0
.IP \(bu 2
hilbert : روش پیش‌فرض. هندسه‌ها بر اساس کد هیلبرت نقطه مرکزی کادر احاطه‌کننده (bounding box) آنها مرتب می‌شوند.
.IP \(bu 2
strtree : هندسه‌ها با ساختن یک درخت sort\-tile\-recursive با استفاده از کتابخانه GEOS و اجرای پیمایش اول‌عمق (depth\-first) مرتب می‌شوند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-use\-tempfile
نوشتن عوارض ورودی در یک فایل موقت تا بتوان آنها را به ترتیب مرتب‌شده خواند. این گزینه از نیاز به بارگذاری کامل لایه ورودی در حافظه رم جلوگیری می‌کند.
.UNINDENT
.SH "کد وضعیت خروج (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: ساخت یک Shapefile بهینه‌شده برای ابر (Cloud-Optimized)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vector sort in.gpkg out.shp \-\-method hilbert \-\-lco SPATIAL_INDEX=YES
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Dan Baston <dbaston@gmail.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.