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

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

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

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

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

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

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

نکته:

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

نام فیلد هندسه‌ای که عوارض باید بر اساس آن مرتب شوند.
روش مرتب‌سازی را تعیین می‌کند. گزینه‌های موجود عبارتند از:
  • hilbert : روش پیش‌فرض. هندسه‌ها بر اساس کد هیلبرت نقطه مرکزی کادر احاطه‌کننده (bounding box) آنها مرتب می‌شوند.
  • strtree : هندسه‌ها با ساختن یک درخت sort-tile-recursive با استفاده از کتابخانه GEOS و اجرای پیمایش اول‌عمق (depth-first) مرتب می‌شوند.
نوشتن عوارض ورودی در یک فایل موقت تا بتوان آنها را به ترتیب مرتب‌شده خواند. این گزینه از نیاز به بارگذاری کامل لایه ورودی در حافظه رم جلوگیری می‌کند.

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

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

Dan Baston <dbaston@gmail.com>

1998-2026

August 18, 2026