| 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 به کار رود.
نکته:
گزینههای ویژه برنامه (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 |