.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GDAL-VECTOR-SWAP-XY" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vector-swap-xy \- جابه‌جایی مختصات X و Y در هندسه‌های یک مجموعه‌داده برداری
.sp
اضافه‌شده در نسخه 3.12.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
کاربرد: 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>  فرمت خروجی (\(dqGDALG\(dq مجاز است) [در خط‌لوله‌ها در دسترس نیست]
  \-\-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) (مستلزم \(aqappend\(aq) [در خط‌لوله‌ها در دسترس نیست]
                                                       مانعة‌الجمع با \-\-append
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vector swap\-xy\fP مختصات X و Y هندسه‌ها را جابه‌جا می‌کند،
که معمولاً برای برطرف کردن مشکلات مربوط به ترتیب محورها در سامانه‌های مرجع مختصات به کار می‌رود.
.sp
این دستور همچنین می‌تواند به‌عنوان یک مرحله از \fI\%gdal vector pipeline\fP استفاده شود\&.
.SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))"
.sp
این برنامه از سریال‌سازی خط فرمان به‌صورت یک فایل JSON با استفاده از فرمت خروجی \fBGDALG\fP پشتیبانی می‌کند.
سپس می‌توان فایل حاصل را با استفاده از درایور
\fI\%GDALG: GDAL Streamed Algorithm\fP به‌عنوان یک مجموعه‌داده برداری باز کرد، و خط‌لوله مشخص‌شده را به‌صورت در لحظه (on\-the\-fly) /
جریانی اعمال نمود.
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-active\-geometry <ACTIVE\-GEOMETRY>
تنظیم فیلد هندسه فعال با استفاده از نام آن. هنگامی که این گزینه مشخص شود، تنها
فیلد هندسه تعیین‌شده تحت پردازش قرار می‌گیرد. سایر فیلدهای هندسه
تغییر نخواهند کرد.
اگر این گزینه مشخص نشود، تمام فیلدهای هندسه تحت پردازش
قرار خواهند گرفت.
این گزینه می‌تواند همراه با \fI\%\-\-active\-layer\fP استفاده شود\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-active\-layer <ACTIVE\-LAYER>
تنظیم لایه فعال. هنگامی که این گزینه مشخص شود، تنها لایه‌ای که با
نام آن تعیین شده است تحت پردازش قرار می‌گیرد. سایر لایه‌ها تغییر
نخواهند کرد.
اگر این گزینه مشخص نشود، تمام لایه‌ها تحت پردازش
قرار خواهند گرفت.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-append
مجاز بودن الحاق عوارض به لایه(های) موجود.
همچنین در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
بسیاری از فرمت‌ها دارای یک یا چند گزینه اختیاری ساخت مجموعه‌داده هستند که می‌توانند
برای کنترل جزئیات فایل ایجادشده به کار روند. برای نمونه،
درایور GeoPackage از گزینه‌های ساختی برای کنترل نسخه پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ساخت مجموعه‌داده در دسترس، بسته به درایور فرمت متفاوت است و برخی
فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های
پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان فرمت، مرجع
نهایی اطلاعات درباره گزینه‌های ساخت درایور است.
برای گزینه‌های ساخت مجاز برای هر فرمت، مستندات خاص هر فرمت در \fI\%Vector drivers\fP را
ببینید.
.sp
توجه داشته باشید که گزینه‌های ساخت مجموعه‌داده با گزینه‌های ساخت لایه متفاوت هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
نام فرمت/درایوری که برای باز کردن فایل(های) ورودی امتحان می‌شود. معمولاً
نیازی به تعیین آن نیست، اما در مواردی که تشخیص خودکار درایور در انتخاب
درایور مناسب ناموفق باشد، می‌تواند برای نادیده‌گرفتن تشخیص خودکار استفاده شود.
این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود.
توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به‌ویژه،
برخی درایورها الزاماتی در مورد پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-input\-layer <INPUT\-LAYER>
نام یک یا چند لایه را برای پردازش مشخص می‌کند. به‌طور پیش‌فرض، تمام لایه‌ها پردازش خواهند شد. برای خواندن و نوشتن تمام لایه‌ها اما فقط
پردازش زیرمجموعه‌ای از آن‌ها، از \fI\%\-\-active\-layer\fP استفاده کنید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
بسیاری از فرمت‌ها دارای یک یا چند گزینه اختیاری ساخت لایه هستند که می‌توانند
برای کنترل جزئیات لایه ایجادشده به کار روند. برای نمونه،
درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه
یا نام ستون هندسه، تنظیم شناسه یا
توضیحات و غیره پشتیبانی می‌کند.
.sp
می‌تواند تکرار شود.
.sp
گزینه‌های ساخت لایه در دسترس، بسته به درایور فرمت متفاوت است و برخی
فرمت‌های ساده اصلاً هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های
پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان
\fI\%\-\-formats\fP
مشاهده کرد، اما مستندات مربوط به همان فرمت، مرجع
نهایی اطلاعات درباره گزینه‌های ساخت درایور است.
برای گزینه‌های ساخت مجاز برای هر فرمت، مستندات خاص هر فرمت در \fI\%Vector drivers\fP را
ببینید.
.sp
توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه‌داده متفاوت هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
کدام فرمت برداری خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر
به دست آورد:
\fBgdal \-\-formats | grep vector | grep rw | sort\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-layer <NAME>
نام لایه‌ای را که عوارض در آن نوشته خواهند شد مشخص می‌کند. در صورت عدم
تعیین، نام لایه‌های خروجی همانند نام لایه‌های ورودی خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-open\-option, \-\-output\-oo <NAME>=<VALUE>
اضافه‌شده در نسخه 3.12.

.sp
گزینه باز کردن مجموعه‌داده برای مجموعه‌داده خروجی (مخصوص هر فرمت).
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite
به برنامه اجازه می‌دهد تا فایل یا مجموعه‌داده مقصد موجود را بازنویسی کند.
در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده مقصد از قبل
وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite\-layer
مجاز بودن رونویسی لایه برداری خروجی موجود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-skip\-errors
اضافه‌شده در نسخه 3.12.

.sp
نادیده‌گرفتن خطاها در هنگام نوشتن عارضه(ها). توجه داشته باشید که این گزینه
اندازه واحد تراکنش را به یک عارضه در هر زمان تنظیم می‌کند، که ممکن است
هنگام درج در پایگاه‌های داده باعث کندی شدید شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-update
باز کردن یک مجموعه‌داده خروجی موجود در حالت به‌روزرسانی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-upsert
اضافه‌شده در نسخه 3.12.

.sp
گونه‌ای از \fI\%\-\-append\fP که در آن از عملیات \fI\%OGRLayer::UpsertFeature()\fP
برای درج یا به‌روزرسانی عوارض به‌جای الحاق با
\fI\%OGRLayer::CreateFeature()\fP استفاده می‌شود\&.
.sp
این قابلیت در حال حاضر تنها در چند درایور پیاده‌سازی شده است:
\fI\%GPKG \-\- GeoPackage vector\fP، \fI\%Elasticsearch: Geographically Encoded Objects for Elasticsearch\fP و \fI\%MongoDBv3\fP
(درایورهایی که upsert را پیاده‌سازی کرده‌اند، قابلیت \fI\%GDAL_DCAP_UPSERT\fP
را ارائه می‌دهند).
.sp
عملیات upsert از FID عارضه ورودی (در صورتی که تنظیم شده باشد
و نام ستون FID یک رشته خالی نباشد)
به‌عنوان کلید برای به‌روزرسانی عوارض موجود استفاده می‌کند. بسیار حیاتی است که اطمینان حاصل شود
FID در لایه‌های مبدأ و مقصد سازگار است.
.sp
برای درایور GPKG، همچنین امکان درج یا به‌روزرسانی (upsert) عوارضی که FID آن‌ها تنظیم نشده
یا فاقد اهمیت است وجود دارد (می‌توان از گزینه \fB\-\-unset\-fid\fP در \fI\%gdal vector edit\fP
برای نادیده‌گرفتن FID از عارضه مبدأ استفاده کرد)، مشروط بر اینکه یک ستون
UNIQUE وجود داشته باشد که کلید اصلی عدد صحیح (integer primary key) نباشد.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت، کد وضعیت 0 و در صورت بروز خطا،
مقدار غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند،
به‌عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: استفاده پایه
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal vector swap\-xy in.gpkg out.gpkg \-\-overwrite
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.