GDAL-VECTOR-PIPELINE(1) GDAL GDAL-VECTOR-PIPELINE(1)

gdal-vector-pipeline - پردازش یک مجموعه‌داده برداری با اعمال چندین مرحله

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

دستور gdal vector pipeline می‌تواند برای پردازش یک مجموعه‌داده برداری و اجرای مراحل مختلف پردازشی که ورودی و خروجی برداری دارند استفاده شود.

برای خط‌لوله‌هایی که رستر و بردار را با هم ترکیب می‌کنند، به gdal pipeline مراجعه کنید.

بیشتر مراحل، عوارض (features) را برحسب‌تقاضا (on-demand) ارزیابی می‌کنند، مگر آن‌که در مستندات آن‌ها خلاف این قید شده باشد، بدون آن‌که مجموعه‌داده حاصل از عملیات هر مرحله «ملموس‌سازی» ("materializing") شود. با این حال ممکن است گاهی برای بهبود کارایی، ملموس‌سازی یک مجموعه‌داده میانی روی دیسک با استفاده از gdal vector materialize مطلوب باشد.

کاربرد: gdal vector pipeline [OPTIONS] <PIPELINE>
پردازش یک مجموعه‌داده برداری با اعمال چندین مرحله.
آرگومان‌های مکانی:
گزینه‌های عمومی:
  -h, --help              نمایش پیام راهنما و خروج
  --json-usage            نمایش نحوه استفاده به‌صورت سند JSON و خروج
  --config <KEY>=<VALUE>  گزینه پیکربندی [تکرارپذیر]
  -q, --quiet             حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط‌لوله‌ها در دسترس نیست]
گزینه‌ها:
  --skip-errors           نادیده گرفتن خطاها هنگام نوشتن عوارض [در خط‌لوله‌ها در دسترس نیست]
<PIPELINE> به این صورت است: read|concat [READ-OPTIONS] ( ! <STEP-NAME> [STEP-OPTIONS] )* ! write|info [WRITE-OPTIONS]

یک خط‌لوله چندین مرحله را که با نویسه ! (علامت تعجب) از هم جدا می‌شوند، به یکدیگر زنجیر می‌کند. مرحله نخست باید read یا concat باشد و مرحله پایانی باید info، partition یا write باشد. هر مرحله آرگومان‌های مکانی یا غیرمکانی مخصوص به خود را دارد. به‌جز read، concat، info، partition و write، تمام مراحل دیگر می‌توانند بالقوه چندین بار در یک خط‌لوله استفاده شوند.

  • buffer
  • check-coverage
  • check-geometry
  • clean-coverage
  • clip
  • combine
  • concave-hull
  • concat
  • convex-hull
  • create
  • dissolve
  • edit
  • explode-collections
  • export-schema
  • external
  • filter
  • info
  • limit
  • make-point
  • make-valid
  • materialize
  • partition
  • read
  • rename-layer
  • reproject
  • segmentize
  • select
  • set-field-type
  • set-geom-type
  • simplify
  • simplify-coverage
  • sort
  • sql
  • swap-xy
  • tee
  • update
  • write
* buffer [OPTIONS] <DISTANCE>
-----------------------------
محاسبه بافر در اطراف هندسه‌های یک مجموعه داده برداری.
آرگومان‌های موضعی:
  --distance <DISTANCE>                    فاصله‌ای که هندسه باید تا آن گسترش یابد. [الزامی]
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>            تنظیم لایه فعال (در صورت مشخص نشدن، همه لایه‌ها)
  --active-geometry <ACTIVE-GEOMETRY>      نام فیلد هندسه برای محدود کردن پردازش به آن (در صورت مشخص نشدن، همه فیلدها)
  --endcap-style <ENDCAP-STYLE>            سبک سرپوش انتهایی.. ENDCAP-STYLE=round|flat|square (پیش‌فرض: round)
  --join-style <JOIN-STYLE>                سبک اتصال.. JOIN-STYLE=round|mitre|bevel (پیش‌فرض: round)
  --mitre-limit <MITRE-LIMIT>              حد نسبت فارسی‌بُر (تنها بر سبک اتصال mitered اثر می‌گذارد). (پیش‌فرض: 5)
  --quadrant-segments <QUADRANT-SEGMENTS>  تعداد پاره‌خط‌های مورد استفاده برای تقریب یک ربع دایره. (پیش‌فرض: 8)
  --side <SIDE>                            تعیین یک‌طرفه بودن یا نبودن بافر محاسبه‌شده.. SIDE=both|left|right (پیش‌فرض: both)

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector buffer یافت.

* check-coverage [OPTIONS]
--------------------------
بررسی یک پوشش چندضلعی از نظر معتبر بودن
گزینه‌ها:
  --include-valid                          گنجاندن ورودی‌های معتبر در خروجی، با هندسه خالی
  --geometry-field <GEOMETRY-FIELD>        نام فیلد هندسه برای بررسی
  --maximum-gap-width <MAXIMUM-GAP-WIDTH>  حداکثر عرض یک شکاف برای علامت‌گذاری شدن

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector check-coverage یافت.

* check-geometry [OPTIONS]
--------------------------
بررسی یک مجموعه داده از نظر وجود هندسه‌های نامعتبر
گزینه‌ها:
  --include-field <INCLUDE-FIELD>    فیلدهایی از لایه ورودی برای گنجاندن در خروجی (مقادیر ویژه: ALL و NONE) (پیش‌فرض: NONE) [می‌تواند تکرار شود]
  --include-valid                    گنجاندن ورودی‌های معتبر در خروجی، با هندسه خالی
  --geometry-field <GEOMETRY-FIELD>  نام فیلد هندسه برای بررسی

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector check-geometry یافت.

* clean-coverage [OPTIONS]
--------------------------
تغییر مرزهای چندضلعی برای یکسان‌سازی لبه‌های مشترک، و حذف شکاف‌ها و همپوشانی‌ها
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>            تنظیم لایه فعال (در صورت مشخص نشدن، همه لایه‌ها)
  --snapping-distance <SNAPPING-DISTANCE>  میزان رواداری فاصله برای چسباندن (snapping) گره‌ها
  --merge-strategy <MERGE-STRATEGY>        الگوریتم انتساب همپوشانی‌ها به چندضلعی‌های مجاور. MERGE-STRATEGY=longest-border|max-area|min-area|min-index
  --maximum-gap-width <MAXIMUM-GAP-WIDTH>  حداکثر عرض یک شکاف برای بسته شدن

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector clean-coverage یافت.

* clip [OPTIONS]
----------------
بُرش یک مجموعه داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>    تنظیم لایه فعال (در صورت مشخص نشدن، همه لایه‌ها)
  --bbox <BBOX>                    کادر احاطه‌کننده بُرش به‌صورت xmin,ymin,xmax,ymax
                                   غیرقابل استفاده هم‌زمان با --geometry، --like
  --bbox-crs <BBOX-CRS>            سامانه مرجع مختصات (CRS) کادر احاطه‌کننده بُرش
  --geometry <GEOMETRY>            هندسه بُرش (WKT یا GeoJSON)
                                   غیرقابل استفاده هم‌زمان با --bbox، --like
  --geometry-crs <GEOMETRY-CRS>    سامانه مرجع مختصات (CRS) هندسه بُرش
  --like <DATASET>                 مجموعه داده برای استفاده به‌عنوان الگو جهت محدوده‌ها
                                   غیرقابل استفاده هم‌زمان با --bbox، --geometry
  --like-sql <SELECT-STATEMENT>    دستور SELECT برای اجرا روی مجموعه داده 'like'
                                   غیرقابل استفاده هم‌زمان با --like-where
  --like-layer <LAYER-NAME>        نام لایه در مجموعه داده 'like'
  --like-where <WHERE-EXPRESSION>  بند WHERE در SQL برای اجرا روی مجموعه داده 'like'
                                   غیرقابل استفاده هم‌زمان با --like-sql

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector clip یافت.

* combine [OPTIONS]
-------------------
ترکیب عوارض در مجموعه‌ها
گزینه‌ها:
  --group-by <GROUP-BY>                  نام فیلد(هایی) که ورودی‌ها باید بر اساس آن‌ها گروه‌بندی شوند [می‌تواند تکرار شود]
  --keep-nested                          جلوگیری از ترکیب اجزای هندسه‌های چندبخشی
  --add-extra-fields <ADD-EXTRA-FIELDS>  افزودن فیلدهای اضافی بسته به داشتن مقادیر یکسان در هر گروه. ADD-EXTRA-FIELDS=no|sometimes-identical|always-identical (پیش‌فرض: no)

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector combine یافت..SS concave-hull

* concave-hull [OPTIONS]
------------------------
محاسبه پوسته مقعر هندسه‌های یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه)
  --ratio <RATIO>                      نسبت کنترل‌کننده تقعر [الزامی]
  --allow-holes                        مجاز بودن ایجاد حفره‌ها در چندضلعی خروجی
  --tight                              الزام پوسته به پیروی از مرزهای بیرونی چندضلعی‌های ورودی

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector concave-hull یافت.

* concat [OPTIONS] <INPUTS>...
------------------------------
الحاق مجموعه‌داده‌های برداری.
آرگومان‌های موضعی:
  -i, --input <INPUTS>                                       مجموعه‌داده‌های برداری ورودی [1.. values] [الزامی]
گزینه‌ها:
  -l, --layer, --input-layer <INPUT-LAYER>                   نام لایه(های) ورودی [قابل تکرار]
  --mode <MODE>                                              تعیین راهبرد ایجاد لایه‌های خروجی از لایه‌های مبدأ. MODE=merge-per-layer-name|stack|single (پیش‌فرض: merge-per-layer-name)
  --output-layer <OUTPUT-LAYER>                              نام لایه برداری خروجی (حالت single)، یا الگو جهت نام‌گذاری لایه‌های برداری خروجی (حالت stack)
  --source-layer-field-name <SOURCE-LAYER-FIELD-NAME>        نام فیلد جدید جهت افزودن برای نگهداری شناسه لایه مبدأ، با مقدار تعیین‌شده از 'source-layer-field-content'
  --source-layer-field-content <SOURCE-LAYER-FIELD-CONTENT>  یک رشته، احتمالاً با استفاده از {AUTO_NAME}، {DS_NAME}، {DS_BASENAME}، {DS_INDEX}، {LAYER_NAME}، {LAYER_INDEX}
  --field-strategy <FIELD-STRATEGY>                          نحوه تعیین فیلدهای مقصد از فیلدهای مبدأ. FIELD-STRATEGY=union|intersection (پیش‌فرض: union)
  -s, --input-crs <INPUT-CRS>                                CRS ورودی
  -d, --output-crs <OUTPUT-CRS>                              CRS خروجی
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                        قالب‌های ورودی [قابل تکرار]
  --oo, --open-option <KEY>=<VALUE>                          گزینه‌های باز کردن [قابل تکرار]

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector concat یافت.

* convex-hull [OPTIONS]
-----------------------
محاسبه پوش محدب هندسه‌های یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه)

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector convex-hull یافت.

* create [OPTIONS] <OUTPUT>
---------------------------
ایجاد یک مجموعه‌داده برداری.
آرگومان‌های موضعی:
  -o, --output <OUTPUT>                                مجموعه‌داده برداری خروجی [الزامی]
گزینه‌ها:
  -i, --like, --input <TEMPLATE-DATASET>               مجموعه‌داده‌های برداری ورودی
                                                       مانعة‌الجمع با --schema و --field
  -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                                    مجاز بودن بازنویسی لایه خروجی موجود
  --output-layer <OUTPUT-LAYER>                        نام لایه خروجی
  --geometry-type <GEOMETRY-TYPE>                      نوع هندسه لایه
  --geometry-field <GEOMETRY-FIELD>                    نام فیلد هندسه جهت ایجاد (در صورت پشتیبانی قالب خروجی) (پیش‌فرض: geom)
  --crs <CRS>                                          تنظیم CRS
  --fid <FID>                                          نام ستون FID
  --schema <SCHEMA_JSON>                               خواندن OGR_SCHEMA و مقداردهی تعاریف فیلد از روی آن
                                                       مانعة‌الجمع با --input و --field
  --field <NAME>:<TYPE>[(,<WIDTH>[,<PRECISION>])]>     افزودن تعریف یک فیلد به لایه خروجی [قابل تکرار]
                                                       مانعة‌الجمع با --input و --schema
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  قالب‌های ورودی [قابل تکرار]
  --oo, --open-option <KEY>=<VALUE>                    گزینه‌های باز کردن [قابل تکرار]
  --output-oo, --output-open-option <KEY>=<VALUE>      گزینه‌های باز کردن خروجی [قابل تکرار]

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector create یافت.

* dissolve [OPTIONS]
--------------------
ادغام عوارض چندبخشی
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه)

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector dissolve یافت..SS edit

* edit [OPTIONS]
----------------
ویرایش متاداده یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>    تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --output-layer <OUTPUT-LAYER>    نام لایه خروجی
  --geometry-type <GEOMETRY-TYPE>  نوع هندسه لایه
  --crs <CRS>                      بازنویسی CRS (بدون بازپروژکشن)
  --metadata <KEY>=<VALUE>         افزودن/به‌روزرسانی مورد متاداده مجموعه‌داده [قابل تکرار]
  --unset-metadata <KEY>           حذف مورد متاداده مجموعه‌داده [قابل تکرار]
  --layer-metadata <KEY>=<VALUE>   افزودن/به‌روزرسانی مورد متاداده لایه [قابل تکرار]
  --unset-layer-metadata <KEY>     حذف مورد متاداده لایه [قابل تکرار]
  --unset-fid                      حذف شناسه هر عارضه و نام ستون FID

جزئیات گزینه‌ها را می‌توانید در gdal vector edit بیابید.

* explode-collections [OPTIONS]
-------------------------------
تفکیک هندسه‌های نوع مجموعه (collection) در یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش به آن (در صورت عدم تعیین، همه)
  --geometry-type <GEOMETRY-TYPE>      نوع هندسه
  --skip-on-type-mismatch              نادیده گرفتن عارضه در صورت شکست در تغییر نوع هندسه عارضه

جزئیات گزینه‌ها را می‌توانید در gdal vector explode-collections بیابید.

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

* export-schema [OPTIONS]
-------------------------
برون‌بری OGR_SCHEMA از یک مجموعه‌داده برداری.
آرگومان‌های موقعیتی:
گزینه‌ها:
  -l, --layer, --input-layer <INPUT-LAYER>  نام لایه ورودی [قابل تکرار]

جزئیات گزینه‌ها را می‌توانید در gdal vector export-schema بیابید.

* external [OPTIONS] <COMMAND>
------------------------------
اجرای یک برنامه خارجی به عنوان مرحله‌ای از یک خط‌لوله (pipeline)
آرگومان‌های موقعیتی:
  --command <COMMAND>                                  دستور خارجی، اختیاری با جایگزین‌های <INPUT> و/یا <OUTPUT> یا <INPUT-OUTPUT> [الزامی]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  قالب‌های ورودی

جزئیات گزینه‌ها را می‌توانید در gdal external بیابید.

* filter [OPTIONS]
------------------
پالایش یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>  تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --bbox <BBOX>                  کادر محدودکننده به صورت xmin,ymin,xmax,ymax
  --where <WHERE>|@<filename>    پرس‌وجوی توصیفی در قالبی محدود از پرس‌وجوهای استفاده‌شده در عبارت SQL WHERE
  --update-extent                به‌روزرسانی محدوده لایه جهت اعمال فیلتر

جزئیات گزینه‌ها را می‌توانید در gdal vector filter بیابید.

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

* info [OPTIONS]
----------------
بازگرداندن اطلاعات مربوط به یک مجموعه‌داده برداری.
آرگومان‌های موقعیتی:
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی. OUTPUT-FORMAT=json|text
  -l, --layer, --input-layer <INPUT-LAYER>             نام لایه ورودی [قابل تکرار]
                                                       غیرقابل استفاده هم‌زمان با --sql، --fid
  --features                                           فهرست کردن تمام عوارض (مراقب مصرف RAM در لایه‌های بزرگ باشید)
                                                       غیرقابل استفاده هم‌زمان با --summary
  --summary                                            فهرست کردن نام‌های لایه‌ها و نوع هندسه
                                                       غیرقابل استفاده هم‌زمان با --features
  --limit <FEATURE-COUNT>                              محدود کردن تعداد عوارض در هر لایه (مستلزم --features)
  --sql <statement>|@<filename>                        اجرای عبارت SQL مشخص‌شده و بازگرداندن نتیجه
                                                       غیرقابل استفاده هم‌زمان با --input-layer، --fid
  --where <WHERE>|@<filename>                          پرس‌وجوی توصیفی در قالبی محدود از پرس‌وجوهای مورد استفاده در عبارت SQL WHERE
  --fid <FID>                                          شناسه عارضه
                                                       غیرقابل استفاده هم‌زمان با --input-layer، --sql
  --dialect <DIALECT>                                  گویش SQL
گزینه‌های تخصصی:
  --crs-format <CRS-FORMAT>                            قالب مورد استفاده برای گزارش CRS. CRS-FORMAT=AUTO|WKT2|PROJJSON (پیش‌فرض: AUTO)

جزئیات گزینه‌ها را می‌توانید در gdal vector info بیابید..SS limit

* limit [OPTIONS] <LIMIT>
-------------------------
محدود کردن یک مجموعه‌داده برداری به حداکثر تعداد مشخصی از عوارض.
آرگومان‌های مکانی:
  --limit <LIMIT>                محدود کردن تعداد عوارض برای خواندن در هر لایه [اجباری]
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>  تنظیم لایه فعال (در صورت عدم تعیین، همه)

* make-point [OPTIONS]
----------------------
ایجاد هندسه‌های نقطه‌ای از فیلدهای توصیفی
گزینه‌ها:
  --x <X>                    فیلدی که مختصات X باید از آن خوانده شود [اجباری]
  --y <Y>                    فیلدی که مختصات Y باید از آن خوانده شود [اجباری]
  --z <Z>                    فیلد اختیاری که مختصات Z باید از آن خوانده شود
  --m <M>                    فیلد اختیاری که مختصات M باید از آن خوانده شود
  --output-crs <OUTPUT-CRS>  سامانه مرجع مختصات (CRS) خروجی

جزئیات مربوط به گزینه‌ها را می‌توانید در gdal vector make-point بیابید.

* make-valid [OPTIONS]
----------------------
اصلاح اعتبار هندسه‌های یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش به آن (در صورت عدم تعیین، همه)
  --method <METHOD>                    الگوریتم مورد استفاده هنگام بازسازی هندسه‌های نامعتبر.. METHOD=linework|structure (پیش‌فرض: linework)
  --keep-lower-dim                     نگه‌داشتن مؤلفه‌های با بُعد پایین‌تر پس از MakeValid()

جزئیات مربوط به گزینه‌ها را می‌توانید در gdal vector make-valid بیابید.

* materialize [OPTIONS]
-----------------------
مادی‌سازی یک مجموعه‌داده پایپ‌شده بر روی دیسک برای افزایش کارایی مراحل بعدی.
گزینه‌ها:
  -o, --output <OUTPUT>                                نام مجموعه‌داده مادی‌سازی‌شده (ایجادشده توسط الگوریتم)
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی
  --co, --creation-option <KEY>=<VALUE>                گزینه ساخت [می‌تواند تکرار شود]
  --lco, --layer-creation-option <KEY>=<VALUE>         گزینه ساخت لایه [می‌تواند تکرار شود]
  --overwrite                                          آیا رونویسی مجموعه‌داده خروجی موجود مجاز است

جزئیات مربوط به گزینه‌ها را می‌توانید در gdal vector materialize بیابید.

در نسخه 3.12 افزوده شد.

* partition [OPTIONS] <OUTPUT>
------------------------------
افرازش یک مجموعه‌داده برداری به چند فایل.
آرگومان‌های مکانی:
  -o, --output <OUTPUT>                                پوشه خروجی [اجباری]
گزینه‌ها:
  --overwrite                                          آیا رونویسی مجموعه‌داده خروجی موجود مجاز است
                                                       مانعة‌الجمع با --append
  --append                                             آیا الحاق به لایه موجود مجاز است
                                                       مانعة‌الجمع با --overwrite
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی
  --co, --creation-option <KEY>=<VALUE>                گزینه ساخت [می‌تواند تکرار شود]
  --lco, --layer-creation-option <KEY>=<VALUE>         گزینه ساخت لایه [می‌تواند تکرار شود]
  --field <FIELD>                                      فیلد(های) توصیفی یا هندسی برای افرازش بر پایه آن [می‌تواند تکرار شود]
  --scheme <SCHEME>                                    طرح افرازش. SCHEME=hive|flat (پیش‌فرض: hive)
  --pattern <PATTERN>                                  الگوی نام فایل ('part_%010d' برای scheme=hive، و '{LAYER_NAME}_{FIELD_VALUE}_%010d' برای scheme=flat)
  --feature-limit <FEATURE-LIMIT>                      حداکثر تعداد عوارض در هر فایل
  --max-file-size <MAX-FILE-SIZE>                      حداکثر اندازه فایل (می‌توان از پسوند MB یا GB استفاده کرد)
  --omit-partitioned-field                             آیا فیلدهای افرازش‌شده از تعریف لایه مقصد حذف شوند یا خیر
  --skip-errors                                        نادیده گرفتن خطاها هنگام نوشتن عوارض

جزئیات مربوط به گزینه‌ها را می‌توانید در gdal vector partition بیابید.

* read [OPTIONS] <INPUT>
------------------------
خواندن یک مجموعه‌داده برداری.
آرگومان‌های مکانی:
  -i, --input <INPUT>                       مجموعه‌داده‌های برداری ورودی [اجباری]
گزینه‌ها:
  -l, --layer, --input-layer <INPUT-LAYER>  نام لایه‌(های) ورودی [می‌تواند تکرار شود]
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>       قالب‌های ورودی [می‌تواند تکرار شود]
  --oo, --open-option <KEY>=<VALUE>         گزینه‌های باز کردن [می‌تواند تکرار شود]

جزئیات مربوط به گزینه‌ها را می‌توانید در gdal vector pipeline read بیابید..SS rename-layer

* rename-layer [OPTIONS]
------------------------
تغییر نام لایه(های) یک مجموعه‌داده برداری.
گزینه‌ها:
  -l, --input-layer <INPUT-LAYER>                  نام لایه ورودی
  --output-layer <OUTPUT-LAYER>                    نام لایه خروجی
  --ascii                                          اجبار نام‌ها به نویسه‌های ASCII
  --lower-case                                     اجبار نام‌ها به حروف کوچک (تنها روی نویسه‌های ASCII)
  --filename-compatible                            اجبار نام‌ها به امکان استفاده به عنوان نام فایل
  --reserved-characters <RESERVED-CHARACTERS>      نویسه(های) رزروشده برای حذف
  --replacement-character <REPLACEMENT-CHARACTER>  نویسه جایگزین در صورت عدم امکان تبدیل به ASCII
  --max-length <MAX-LENGTH>                        حداکثر طول نام لایه‌ها

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector rename-layer یافت.

* reproject [OPTIONS]
---------------------
بازپروژکت کردن یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>  تنظیم لایه فعال (در صورت عدم تعیین، همه)
  -s, --input-crs <INPUT-CRS>    CRS ورودی
  -d, --output-crs <OUTPUT-CRS>  CRS خروجی [الزامی]

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector reproject یافت.

* segmentize [OPTIONS] <MAX-LENGTH>
-----------------------------------
قطعه‌بندی هندسه‌های یک مجموعه‌داده برداری.
آرگومان‌های موقعیتی:
  --max-length <MAX-LENGTH>            حداکثر طول یک قطعه [الزامی]
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه)

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector segmentize یافت.

* select [OPTIONS] <FIELDS>
---------------------------
انتخاب زیرمجموعه‌ای از فیلدها از یک مجموعه‌داده برداری.
آرگومان‌های موقعیتی:
  --fields <FIELDS>              فیلدها برای انتخاب (یا مستثنی کردن در صورت --exclude) [قابل تکرار] [الزامی]
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>  تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --output-layer <OUTPUT-LAYER>  نام لایه خروجی
  --exclude                      مستثنی کردن فیلدهای مشخص‌شده
                                 غیرقابل استفاده هم‌زمان با --ignore-missing-fields
  --ignore-missing-fields        نادیده گرفتن فیلدهای ناموجود
                                 غیرقابل استفاده هم‌زمان با --exclude

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector select یافت.

* set-field-type [OPTIONS]
--------------------------
تغییر نوع یک فیلد از یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>                   تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --field-name <FIELD-NAME>                       نام فیلد [الزامی]
                                                  غیرقابل استفاده هم‌زمان با --input-field-type
  --input-field-type <INPUT-FIELD-TYPE>           نوع یا زیرنوع فیلد مبدأ [الزامی]
                                                  غیرقابل استفاده هم‌زمان با --field-name
  --output-field-type, --field-type <FIELD-TYPE>  نوع یا زیرنوع فیلد مقصد [الزامی]

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector set-field-type یافت.

* set-geom-type [OPTIONS]
-------------------------
تغییر نوع هندسه یک مجموعه‌داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش (در صورت عدم تعیین، همه)
  --layer-only                         تنها تغییر نوع هندسه لایه
                                       غیرقابل استفاده هم‌زمان با --feature-only
  --feature-only                       تنها تغییر نوع هندسه عوارض
                                       غیرقابل استفاده هم‌زمان با --layer-only
  --geometry-type <GEOMETRY-TYPE>      نوع هندسه
  --multi                              اجبار هندسه‌ها به انواع هندسی MULTI
                                       غیرقابل استفاده هم‌زمان با --single
  --single                             اجبار هندسه‌ها به انواع هندسی غیر MULTI
                                       غیرقابل استفاده هم‌زمان با --multi
  --linear                             تبدیل هندسه‌های منحنی به انواع خطی
                                       غیرقابل استفاده هم‌زمان با --curve
  --curve                              تبدیل هندسه‌های خطی به انواع منحنی
                                       غیرقابل استفاده هم‌زمان با --linear
  --dim <DIM>                          اجبار هندسه‌ها به بعد تعیین‌شده. DIM=XY|XYZ|XYM|XYZM
  --skip                               رد کردن عارضه در صورت عدم موفقیت تغییر نوع هندسه آن

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector set-geom-type یافت..SS simplify

* simplify [OPTIONS] <TOLERANCE>
--------------------------------
ساده‌سازی هندسه‌های یک مجموعه داده برداری.
آرگومان‌های موقعیتی:
  --tolerance <TOLERANCE>              تلرانس فاصله برای ساده‌سازی. [الزامی]
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت تعیین نشدن، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش (در صورت تعیین نشدن، همه)

جزئیات گزینه‌ها را می‌توانید در gdal vector simplify بیابید.

* simplify-coverage [OPTIONS] <TOLERANCE>
-----------------------------------------
ساده‌سازی مرزهای مشترک یک مجموعه داده برداری چندضلعی.
آرگومان‌های موقعیتی:
  --tolerance <TOLERANCE>        تلرانس فاصله برای ساده‌سازی. [الزامی]
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>  تنظیم لایه فعال (در صورت تعیین نشدن، همه)
  --preserve-boundary            تعیین این‌که آیا مرز بیرونی باید حفظ شود یا خیر.

جزئیات گزینه‌ها را می‌توانید در gdal vector simplify-coverage بیابید.

* sort [OPTIONS]
---------------
مرتب‌سازی مکانی عوارض در یک لایه
گزینه‌ها:
  --geometry-field <GEOMETRY-FIELD>  نام فیلد هندسه جهت استفاده در مرتب‌سازی
  --method <METHOD>                  الگوریتم مرتب‌سازی هندسه. METHOD=hilbert|strtree (پیش‌فرض: hilbert)
  --use-tempfile                     نوشتن عوارض در یک فایل موقت برای جلوگیری از خواندن کل مجموعه داده ورودی در حافظه

جزئیات گزینه‌ها را می‌توانید در gdal vector sort بیابید.

* sql [OPTIONS] <statement>|@<filename>
--------------------------------------
اعمال دستور(ات) SQL بر روی یک مجموعه داده.
آرگومان‌های موقعیتی:
  --sql <statement>|@<filename>      دستور(ات) SQL [قابل تکرار] [الزامی]
گزینه‌ها:
  -l, --output-layer <OUTPUT-LAYER>  نام لایه(های) خروجی [قابل تکرار]
  --dialect <DIALECT>                گویش SQL (مانند OGRSQL, SQLITE)

جزئیات گزینه‌ها را می‌توانید در gdal vector sql بیابید.

* swap-xy [OPTIONS]
-------------------
جابه‌جایی مختصات X و Y در هندسه‌های یک مجموعه داده برداری.
گزینه‌ها:
  --active-layer <ACTIVE-LAYER>        تنظیم لایه فعال (در صورت تعیین نشدن، همه)
  --active-geometry <ACTIVE-GEOMETRY>  نام فیلد هندسه برای محدود کردن پردازش (در صورت تعیین نشدن، همه)

جزئیات گزینه‌ها را می‌توانید در gdal vector swap-xy بیابید.

* tee [OPTIONS] [<PIPELINE>...]
-------------------------------
هدایت ورودی به جریان خروجی و خط‌لوله‌های تودرتوی جانبی.
آرگومان‌های موقعیتی:
  --tee-pipeline <PIPELINE>  خط‌لوله تودرتو [1.. values]

جزئیات گزینه‌ها را می‌توانید در Output nested pipeline بیابید.

* update [OPTIONS] <OUTPUT>
---------------------------
به‌روزرسانی یک مجموعه داده برداری موجود با یک مجموعه داده برداری ورودی.
آرگومان‌های موقعیتی:
  -o, --output <OUTPUT>                            مجموعه داده برداری خروجی [الزامی]
گزینه‌ها:
  --input-layer <INPUT-LAYER>                      نام لایه ورودی
  --output-layer <OUTPUT-LAYER>                    نام لایه خروجی
  --mode <MODE>                                    تنظیم حالت به‌روزرسانی. MODE=merge|update-only|append-only (پیش‌فرض: merge)
  --key <KEY>                                      فیلد(های) مورد استفاده به‌عنوان کلید برای شناسایی عوارض [قابل تکرار]
گزینه‌های پیشرفته:
  --output-oo, --output-open-option <KEY>=<VALUE>  گزینه‌های باز کردن خروجی [قابل تکرار]

جزئیات گزینه‌ها را می‌توانید در gdal vector update بیابید..SS write

* write [OPTIONS] <OUTPUT>
--------------------------
نوشتن یک مجموعه داده برداری.
آرگومان‌های موضعی:
  -o, --output <OUTPUT>                                مجموعه داده برداری خروجی [الزامی]
گزینه‌ها:
  -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
  -l, --output-layer <OUTPUT-LAYER>                    نام لایه خروجی
  --skip-errors                                        نادیده گرفتن خطاها هنگام نوشتن عوارض
  --no-create-empty-layers                             خودداری از ساخت لایه‌هایی که هیچ عارضه‌ای در آن‌ها نوشته نخواهد شد
گزینه‌های پیشرفته:
  --output-oo, --output-open-option <KEY>=<VALUE>      گزینه‌های باز کردن خروجی [می‌تواند تکرار شود]
  --upsert                                             درج یا به‌روزرسانی (Upsert) عوارض (مستلزم 'append' است)
                                                       ناسازگار با --append

جزئیات مربوط به گزینه‌ها را می‌توان در gdal vector pipeline write یافت.

یک خط لوله (pipeline) را می‌توان با استفاده از قالب خروجی GDALG به صورت یک فایل JSON سریال‌سازی کرد. سپس فایل حاصل می‌تواند به عنوان یک مجموعه داده برداری با استفاده از درایور GDALG: GDAL Streamed Algorithm باز شود و خط لوله مشخص‌شده را به صورت حین اجرا / جریانی اعمال کند.

عضو command_line در فایل JSON قاعدتاً باید کل خط فرمان بدون مرحله پایانی write باشد، و این همان چیزی است که توسط gdal vector pipeline ! .... ! write out.gdalg.json تولید می‌شود.

{
    "type": "gdal_streamed_alg",
    "command_line": "gdal vector pipeline ! read in.gpkg ! reproject --output-crs=EPSG:32632"
}

مرحله پایانی write را می‌توان اضافه کرد، اما در این صورت باید صراحتاً قالب خروجی stream و یک نام بی‌اهمیت برای مجموعه داده خروجی را مشخص کند.

{
    "type": "gdal_streamed_alg",
    "command_line": "gdal vector pipeline ! read in.gpkg ! reproject --output-crs=EPSG:32632 ! write --output-format=streamed streamed_dataset"
}

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

امکان استفاده از gdal pipeline برای به‌کارگیری خط لوله‌ای که قبلاً در یک فایل .gdal.json سریال‌سازی شده است وجود دارد، و می‌توان مراحل موجود آن را سفارشی‌سازی کرد؛ به طور معمول تغییر نام یک فایل ورودی، مشخص کردن نام فایل خروجی، یا افزودن/تغییر آرگومان‌های مراحل.

بخش Substitutions را ببینید.

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

امکان ایجاد "خطوط لوله تو در تو" وجود دارد، یعنی خطوط لوله‌ای در داخل خطوط لوله دیگر.

یک خط لوله تو در تو با براکت‌های چهارگوش ([ و ]) که با یک نویسه فاصله احاطه شده‌اند، محدود می‌شود.

دو نوع خط لوله تو در تو وجود دارد:

  • خطوط لوله تو در توی ورودی: جایی که مجموعه داده نتیجه خط لوله تو در تو به عنوان مجموعه داده ورودی برای یک آرگومان از خط لوله اصلی استفاده می‌شود.
  • خطوط لوله تو در توی خروجی: جایی که خروجی مرحله‌ای از خط لوله اصلی به عنوان ورودی خط لوله تو در تو در مرحله بعدی استفاده می‌شود. خطوط لوله تو در توی خروجی تنها می‌توانند با مرحله tee استفاده شوند.

بخش Nested pipeline را ببینید.

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

$ gdal vector pipeline ! read in.gpkg ! reproject --output-crs=EPSG:32632 ! write out.gpkg --overwrite

$ gdal vector pipeline ! read in.gpkg ! reproject --output-crs=EPSG:32632 ! write in_epsg_32632.gdalg.json --overwrite
$ gdal vector info in_epsg_32632.gdalg.json
$ gdal vector pipeline ! concat --single --output-crs=EPSG:32632 france.shp belgium.shp ! filter --where "pop > 1e6" ! write out.gpkg --overwrite

هنگام استفاده از select برای محدود کردن فیلدهای خروجی، اطمینان حاصل کنید که وقتی عبارت فیلتر به فیلدها ارجاع می‌دهد، این دستور در خط لوله (pipeline) بعد از مرحلهٔ filter قرار گیرد. اگر یک فیلد مورد نیاز فیلتر توسط select حذف شود، در دسترس نخواهد بود و دستور با این خطا شکست می‌خورد: ERROR 1: "worldcity" not recognised as an available field.

اگر می‌خواهید خروجی حاوی داده‌های مکانی باشد، باید فیلد هندسه (geometry) را نیز در میان فیلدهای انتخاب‌شده قرار دهید. در این مثال، مجموعه داده مبدأ فاقد ستون هندسه با نام مشخص است. در چنین مواردی می‌توان از فیلد ویژهٔ _ogr_geometry_ برای ارجاع به هندسه استفاده کرد. اگر هیچ فیلد هندسه‌ای گنجانده نشود، بازتصویر با این خطا شکست خواهد خورد: ERROR 1: reproject: Layer 'ne_110m_populated_places_simple' has no spatial reference system.

در نهایت، اطمینان حاصل کنید که بین نام فیلدها در فهرست هیچ فاصله‌ای وجود نداشته باشد. برای مثال: "_ogr_geometry_, name" خطای زیر را ایجاد خواهد کرد: ERROR 1: Field ' name' does not exist in layer 'ne_110m_populated_places_simple'. Bash

gdal vector pipeline \
    ! read natural_earth_vector.gpkg --layer ne_110m_populated_places_simple \
    ! filter --where "worldcity = 1" \
    ! select --fields "_ogr_geometry_,name" \
    ! reproject --output-crs=ESRI:53009 \
    ! write worldcity_53009.geojson --overwrite
PowerShell 
gdal vector pipeline `
    ! read natural_earth_vector.gpkg --layer ne_110m_populated_places_simple `
    ! filter --where "worldcity = 1" `
    ! select --fields "_ogr_geometry_,name" `
    ! reproject --output-crs=ESRI:53009 `
    ! write worldcity_53009.geojson --overwrite
[تصویر]

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026