GDAL-VECTOR-SORT(1)                  GDAL                  GDAL-VECTOR-SORT(1)

نام (NAME)
       gdal-vector-sort - مرتب‌سازی مکانی یک مجموعه داده برداری

       در نسخه 3.13 اضافه شد.


خلاصه دستور (SYNOPSIS)

          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>  قالب خروجی (مقدار "GDALG" مجاز است) [در خطوط لوله در دسترس نیست]
            --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                                             به‌روزرسانی یا درج عوارض (به معنای 'append' است) [در خطوط لوله در دسترس نیست]
                                                                  ناسازگار با --append

توضیحات (DESCRIPTION)
       دستور gdal vector sort عوارض موجود در یک مجموعه داده برداری را بر اساس
       موقعیت هندسه‌شان مرتب می‌کند. روش مرتب‌سازی را می‌توان از طریق --method
       تعیین کرد که شامل الگوریتم‌های هیلبرت (Hilbert) و Sort-Tile-Recursive
       (STRTree) است.

       عوارضی که هندسه تهی یا نامعتبر دارند، در انتهای مجموعه داده مرتب‌شده
       قرار خواهند گرفت.

       این دستور همچنین می‌تواند به عنوان یک مرحله در gdal vector pipeline به
       کار رود.

       نکته:
          استفاده از الگوریتم STRtree نیازمند بیلد GDAL همراه با کتابخانه GEOS
          است.

گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)

       --geometry-field <GEOMETRY-FIELD>
              نام فیلد هندسه‌ای که عوارض باید بر اساس آن مرتب شوند.

       --method <METHOD>
              روش مرتب‌سازی را تعیین می‌کند. گزینه‌های موجود عبارتند از:

              • hilbert : روش پیش‌فرض. هندسه‌ها بر اساس کد هیلبرت نقطه مرکزی
                کادر احاطه‌کننده (bounding box) آنها مرتب می‌شوند.

              • strtree : هندسه‌ها با ساختن یک درخت sort-tile-recursive با
                استفاده از کتابخانه GEOS و اجرای پیمایش اول‌عمق (depth-first)
                مرتب می‌شوند.

       --use-tempfile
              نوشتن عوارض ورودی در یک فایل موقت تا بتوان آنها را به ترتیب
              مرتب‌شده خواند. این گزینه از نیاز به بارگذاری کامل لایه ورودی در
              حافظه رم جلوگیری می‌کند.

کد وضعیت خروج (RETURN STATUS CODE)
       این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر را
       برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار ارسال می‌شوند، به
       عنوان اجرای موفق در نظر گرفته می‌شوند).

مثال‌ها (EXAMPLES)
   مثال ۱: ساخت یک Shapefile بهینه‌شده برای ابر (Cloud-Optimized)

          $ gdal vector sort in.gpkg out.shp --method hilbert --lco SPATIAL_INDEX=YES

نویسندگان (AUTHORS)
       Dan Baston <dbaston@gmail.com>

حق نشر (COPYRIGHT)
       1998-2026

                                August 18, 2026            GDAL-VECTOR-SORT(1)