GDAL-VECTOR-SWAP-XY(1)

GDAL

GDAL-VECTOR-SWAP-XY(1)

نام (NAME)

gdal-vector-swap-xy - جابه‌جایی مختصات X و Y در هندسه‌های یک مجموعه‌داده برداری

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

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

کاربرد: gdal vector swap-xy [OPTIONS] <INPUT> <OUTPUT>
جابه‌جایی مختصات X و Y در هندسه‌های یک مجموعه‌داده برداری.
آرگومان‌های موقعیتی:
  -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                                        نادیده‌گرفتن خطاها هنگام نوشتن عوارض [در خط‌لوله‌ها در دسترس نیست]
  --active-layer <ACTIVE-LAYER>                        تنظیم لایه فعال (در صورت عدم تعیین، همه)
  --active-geometry <ACTIVE-GEOMETRY>                  نام فیلد هندسه برای محدود کردن پردازش به آن (در صورت عدم تعیین، همه)
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  فرمت‌های ورودی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
  --oo, --open-option <KEY>=<VALUE>                    گزینه‌های باز کردن [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
  --output-oo, --output-open-option <KEY>=<VALUE>      گزینه‌های باز کردن خروجی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
  --upsert                                             درج یا به‌روزرسانی عوارض (upsert) (مستلزم 'append') [در خط‌لوله‌ها در دسترس نیست]
                                                       مانعة‌الجمع با --append

توضیحات (DESCRIPTION)

دستور gdal vector swap-xy مختصات X و Y هندسه‌ها را جابه‌جا می‌کند، که معمولاً برای برطرف کردن مشکلات مربوط به ترتیب محورها در سامانه‌های مرجع مختصات به کار می‌رود.

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

خروجی GDALG (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))

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

گزینه‌های استاندارد (STANDARD OPTIONS)

--active-geometry <ACTIVE-GEOMETRY>: تنظیم فیلد هندسه فعال با استفاده از نام آن. هنگامی که این گزینه مشخص شود، تنها فیلد هندسه تعیین‌شده تحت پردازش قرار می‌گیرد. سایر فیلدهای هندسه تغییر نخواهند کرد. اگر این گزینه مشخص نشود، تمام فیلدهای هندسه تحت پردازش قرار خواهند گرفت. این گزینه می‌تواند همراه با --active-layer استفاده شود.

--active-layer <ACTIVE-LAYER>: تنظیم لایه فعال. هنگامی که این گزینه مشخص شود، تنها لایه‌ای که با نام آن تعیین شده است تحت پردازش قرار می‌گیرد. سایر لایه‌ها تغییر نخواهند کرد. اگر این گزینه مشخص نشود، تمام لایه‌ها تحت پردازش قرار خواهند گرفت.

--append: مجاز بودن الحاق عوارض به لایه(های) موجود. همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.

--co, --creation-option <NAME>=<VALUE>

بسیاری از فرمت‌ها دارای یک یا چند گزینه اختیاری ساخت مجموعه‌داده هستند که می‌توانند برای کنترل جزئیات فایل ایجادشده به کار روند. برای نمونه، درایور GeoPackage از گزینه‌های ساختی برای کنترل نسخه پشتیبانی می‌کند.

می‌تواند تکرار شود.

گزینه‌های ساخت مجموعه‌داده در دسترس، بسته به درایور فرمت متفاوت است و برخی فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان فرمت، مرجع نهایی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز برای هر فرمت، مستندات خاص هر فرمت در Vector drivers را ببینید.

توجه داشته باشید که گزینه‌های ساخت مجموعه‌داده با گزینه‌های ساخت لایه متفاوت هستند.

--if, --input-format <format>: نام فرمت/درایوری که برای باز کردن فایل(های) ورودی امتحان می‌شود. معمولاً نیازی به تعیین آن نیست، اما در مواردی که تشخیص خودکار درایور در انتخاب درایور مناسب ناموفق باشد، می‌تواند برای نادیده‌گرفتن تشخیص خودکار استفاده شود. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به‌ویژه، برخی درایورها الزاماتی در مورد پسوند فایل دارند.
می‌تواند تکرار شود.

--input-layer <INPUT-LAYER>: نام یک یا چند لایه را برای پردازش مشخص می‌کند. به‌طور پیش‌فرض، تمام لایه‌ها پردازش خواهند شد. برای خواندن و نوشتن تمام لایه‌ها اما فقط پردازش زیرمجموعه‌ای از آن‌ها، از --active-layer استفاده کنید.

--lco, --layer-creation-option <NAME>=<VALUE>

بسیاری از فرمت‌ها دارای یک یا چند گزینه اختیاری ساخت لایه هستند که می‌توانند برای کنترل جزئیات لایه ایجادشده به کار روند. برای نمونه، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند.

می‌تواند تکرار شود.

گزینه‌های ساخت لایه در دسترس، بسته به درایور فرمت متفاوت است و برخی فرمت‌های ساده اصلاً هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به همان فرمت، مرجع نهایی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز برای هر فرمت، مستندات خاص هر فرمت در Vector drivers را ببینید.

توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه‌داده متفاوت هستند.

--oo, --open-option <NAME>=<VALUE>: گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت).
می‌تواند تکرار شود.

-f, --of, --format, --output-format <OUTPUT-FORMAT>: کدام فرمت برداری خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: gdal --formats | grep vector | grep rw | sort

--output-layer <NAME>: نام لایه‌ای را که عوارض در آن نوشته خواهند شد مشخص می‌کند. در صورت عدم تعیین، نام لایه‌های خروجی همانند نام لایه‌های ورودی خواهد بود.

--output-open-option, --output-oo <NAME>=<VALUE>

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

گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (مخصوص هر فرمت).

می‌تواند تکرار شود.

--overwrite: به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل وجود داشته باشد، gdal با خطا متوقف می‌شود.

--overwrite-layer: مجاز بودن رونویسی لایه برداری خروجی موجود.

--skip-errors: اضافه‌شده در نسخه 3.12.
نادیده‌گرفتن خطاها در هنگام نوشتن عارضه(ها). توجه داشته باشید که این گزینه اندازه واحد تراکنش را به یک عارضه در هر زمان تنظیم می‌کند، که ممکن است هنگام درج در پایگاه‌های داده باعث کندی شدید شود.

--update: باز کردن یک مجموعه‌داده خروجی موجود در حالت به‌روزرسانی.

--upsert

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

گونه‌ای از --append که در آن از عملیات OGRLayer::UpsertFeature() برای درج یا به‌روزرسانی عوارض به‌جای الحاق با OGRLayer::CreateFeature() استفاده می‌شود.

این قابلیت در حال حاضر تنها در چند درایور پیاده‌سازی شده است: GPKG -- GeoPackage vector، Elasticsearch: Geographically Encoded Objects for Elasticsearch و MongoDBv3 (درایورهایی که upsert را پیاده‌سازی کرده‌اند، قابلیت GDAL_DCAP_UPSERT را ارائه می‌دهند).

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

برای درایور GPKG، همچنین امکان درج یا به‌روزرسانی (upsert) عوارضی که FID آن‌ها تنظیم نشده یا فاقد اهمیت است وجود دارد (می‌توان از گزینه --unset-fid در gdal vector edit برای نادیده‌گرفتن FID از عارضه مبدأ استفاده کرد)، مشروط بر اینکه یک ستون UNIQUE وجود داشته باشد که کلید اصلی عدد صحیح (integer primary key) نباشد.

وضعیت خروج (EXIT STATUS)

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

مثال‌ها (EXAMPLES)

مثال ۱: استفاده پایه

$ gdal vector swap-xy in.gpkg out.gpkg --overwrite

نویسندگان (AUTHORS)

Even Rouault <even.rouault@spatialys.com>

کپی‌رایت و تکثیر (COPYRIGHT)

1998-2026

August 18, 2026