.\" 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-EDIT" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-edit \- ویرایش متاداده‌های یک مجموعه داده برداری .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal vector edit [OPTIONS] ویرایش متاداده‌های یک مجموعه داده برداری. آرگومان‌های مکانی: \-i, \-\-input مجموعه داده‌های برداری ورودی [الزامی] [در خط لوله‌ها در دسترس نیست] \-o, \-\-output مجموعه داده برداری خروجی [الزامی] [در خط لوله‌ها در دسترس نیست] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [قابل تکرار] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خط لوله‌ها در دسترس نیست] گزینه‌ها: \-l, \-\-layer, \-\-input\-layer نام لایه(های) ورودی [قابل تکرار] [در خط لوله‌ها در دسترس نیست] \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مقدار \(dqGDALG\(dq مجاز است) [در خط لوله‌ها در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ساخت مجموعه داده [قابل تکرار] [در خط لوله‌ها در دسترس نیست] \-\-lco, \-\-layer\-creation\-option = گزینه ساخت لایه [قابل تکرار] [در خط لوله‌ها در دسترس نیست] \-\-overwrite آیا رونویسی مجموعه داده خروجی موجود مجاز است [در خط لوله‌ها در دسترس نیست] \-\-update آیا مجموعه داده موجود در حالت به‌روزرسانی باز شود [در خط لوله‌ها در دسترس نیست] \-\-overwrite\-layer آیا رونویسی لایه خروجی موجود مجاز است [در خط لوله‌ها در دسترس نیست] \-\-append آیا الحاق به لایه موجود مجاز است [در خط لوله‌ها در دسترس نیست] ناسازگار با \-\-upsert \-\-output\-layer نام لایه خروجی \-\-skip\-errors نادیده گرفتن خطاها هنگام نوشتن عوارض [در خط لوله‌ها در دسترس نیست] \-\-active\-layer تنظیم لایه فعال (در صورت مشخص نشدن، تمام لایه‌ها) \-\-geometry\-type نوع هندسه لایه \-\-crs بازنویسی CRS (بدون تغییر پیش‌افکDefault) \-\-metadata = افزودن/به‌روزرسانی آیتم متاداده مجموعه داده [قابل تکرار] \-\-unset\-metadata حذف آیتم متاداده مجموعه داده [قابل تکرار] \-\-layer\-metadata = افزودن/به‌روزرسانی آیتم متاداده لایه [قابل تکرار] \-\-unset\-layer\-metadata حذف آیتم متاداده لایه [قابل تکرار] \-\-unset\-fid حذف شناسه هر عارضه و نام ستون FID گزینه‌های پیشرفته: \-\-if, \-\-input\-format قالب‌های ورودی [قابل تکرار] [در خط لوله‌ها در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [قابل تکرار] [در خط لوله‌ها در دسترس نیست] \-\-output\-oo, \-\-output\-open\-option = گزینه‌های باز کردن خروجی [قابل تکرار] [در خط لوله‌ها در دسترس نیست] \-\-upsert به‌روزرسانی یا درج (Upsert) عوارض (شامل \(aqappend\(aq) [در خط لوله‌ها در دسترس نیست] ناسازگار با \-\-append .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp از \fBgdal vector edit\fP می‌توان برای ویرایش متاداده‌های یک مجموعه داده برداری استفاده کرد: سیستم مرجع مختصات (CRS)، نوع هندسه لایه، متاداده‌های مجموعه داده و لایه. .sp از \fBedit\fP همچنین می‌توان به عنوان یک مرحله از \fI\%gdal vector pipeline\fP استفاده نمود. .sp عوارض (features) دست‌نخورده باقی می‌مانند و تغییری نمی‌کنند. .SH "خروجی GDALG (مجموعه داده برخط / استریم‌شده) (GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET))" .sp این برنامه از سریالی‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس با درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه داده برداری باز کرد و خط لوله مشخص‌شده را به صورت برخط / استریم‌شده اعمال نمود. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-crs بازنویسی سیستم مرجع مختصات (CRS)، بدون بازپروژکت کردن عوارض. .sp سیستم‌های مرجع مختصاتی که می‌توان وارد کرد شامل هر موردی است که توسط فراخوانی \fI\%OGRSpatialReference::SetFromUserInput()\fP پشتیبانی می‌شود؛ از جمله CRS پیش‌افکنده EPSG، جغرافیایی یا مرکب (مانند EPSG:4296)، تعریف متنی WKT از CRS، اعلان‌های PROJ.4، یا نام یک فایل .prj حاوی تعریف WKT CRS. .sp می‌توان \fBnull\fP یا \fBnone\fP را برای حذف CRS موجود مشخص کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-geometry\-type تغییر نوع هندسه لایه به یکی از مقادیر زیر: \fBGEOMETRY\fP، \fBPOINT\fP، \fBLINESTRING\fP، \fBPOLYGON\fP، \fBMULTIPOINT\fP، \fBMULTILINESTRING\fP، \fBMULTIPOLYGON\fP، \fBGEOMETRYCOLLECTION\fP، \fBCURVE\fP، \fBCIRCULARSTRING\fP، \fBCOMPOUNDCURVE\fP، \fBSURFACE\fP، \fBCURVEPOLYGON\fP، \fBMULTICURVE\fP، \fBMULTISURFACE\fP، \fBPOLYHEDRALSURFACE\fP یا \fBTIN\fP\&. پسوندهای \fBZ\fP، \fBM\fP یا \fBZM\fP را می‌توان به مقادیر فوق اضافه کرد تا بعد فضایی مشخص شود. توجه داشته باشید که هندسه خود عوارض تغییر داده نمی‌شود. بنابراین این گزینه می‌تواند برای اصلاح نوع هندسه نامناسب در سطح لایه استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-layer\-metadata = افزودن/به‌روزرسانی آیتم متاداده در سطح لایه. .UNINDENT .INDENT 0.0 .TP .B \-\-metadata = افزودن/به‌روزرسانی آیتم متاداده در سطح مجموعه داده. .UNINDENT .INDENT 0.0 .TP .B \-\-unset\-fid در نسخه 3.12 اضافه شد. .sp می‌توان مشخص کرد تا از استفاده مجدد نام ستون FID و شناسه‌های عوارض منبع برای لایه مقصد جلوگیری شود. این گزینه برای مثال هنگام انتخاب عوارض منبع با عبارت ORDER BY می‌تواند مفید باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-unset\-metadata حذف آیتم متاداده در سطح مجموعه داده. .UNINDENT .INDENT 0.0 .TP .B \-\-unset\-layer\-metadata حذف آیتم متاداده در سطح لایه. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-active\-layer تنظیم لایه فعال. وقتی مشخص شود، تنها لایه‌ای که با نامش مشخص شده تحت پردازش قرار می‌گیرد و سایر لایه‌ها تغییر نخواهند کرد. اگر این گزینه مشخص نشود، تمامی لایه‌ها پردازش خواهند شد. .UNINDENT .INDENT 0.0 .TP .B \-\-append مجاز بودن الحاق عوارض به لایه(های) موجود. همچنین اگر مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری برای ساخت مجموعه داده دارند که می‌توان برای کنترل جزئیات فایل ایجادشده از آن‌ها استفاده کرد. برای مثال، درایور GeoPackage از گزینه‌های ساخت برای کنترل نسخه پشتیبانی می‌کند. .sp قابل تکرار است. .sp گزینه‌های ساخت مجموعه داده در دسترس بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به همان قالب منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر قالب به مستندات اختصاصی قالب \fI\%Vector drivers\fP مراجعه کنید. .sp توجه داشته باشید که گزینه‌های ساخت مجموعه داده با گزینه‌های ساخت لایه متفاوت هستند. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایور برای تلاش در باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن آن نیست، اما در صورتی که تشخیص خودکار درایور نتواند درایور مناسب را انتخاب کند، می‌توان از این گزینه برای دور زدن تشخیص خودکار استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور نامزد تکرار شود. توجه داشته باشید که این کار درایورها را مجبور به باز کردن مجموعه داده نمی‌کند؛ به‌ویژه برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp قابل تکرار است. .UNINDENT .INDENT 0.0 .TP .B \-\-input\-layer نام یک یا چند لایه را برای پردازش مشخص می‌کند. به طور پیش‌فرض، همه لایه‌ها پردازش می‌شوند. برای خواندن و نوشتن تمام لایه‌ها اما پردازش تنها یک زیرمجموعه، از \fI\%\-\-active\-layer\fP استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ساخت لایه دارند که می‌توان از آن‌ها برای کنترل جزئیات لایه ایجادشده استفاده کرد. برای مثال، درایور GeoPackage از گزینه‌های ساخت لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp قابل تکرار است. .sp گزینه‌های ساخت لایه موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساخت لایه‌ای ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP فهرست کرد، اما مستندات همان قالب منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های مجاز ساخت هر قالب به مستندات اختصاصی قالب \fI\%Vector drivers\fP مراجعه کنید. .sp توجه داشته باشید که گزینه‌های ساخت لایه با گزینه‌های ساخت مجموعه داده تفاوت دارند. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (مختص هر قالب). .sp قابل تکرار است. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format تعیین قالب برداری خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر دریافت کرد: \fBgdal \-\-formats | grep vector | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-output\-layer نام لایه‌ای را مشخص می‌کند که عوارض در آن نوشته خواهند شد. در صورت عدم تعیین، نام لایه‌های خروجی مشابه نام لایه‌های ورودی خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-open\-option, \-\-output\-oo = در نسخه 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 وجود داشته باشد که کلید اصلی عدد صحیح نباشد. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر از صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: تغییر CRS یک فایل GeoPackage (بدون بازپروژکت کردن آن) و نوع هندسه آن" .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector edit \-\-crs=EPSG:4326 \-\-geometry\-type=POLYGONZM in.gpkg out.gpkg \-\-overwrite .EE .UNINDENT .UNINDENT .SS "مثال ۲: اعمال یک CRS به یک Shapefile" .sp اگر یک Shapefile فایل \fB\&.prj\fP مرتبط خود را نداشته باشد، می‌توان آن را به صورت زیر ایجاد کرد: .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal vector edit \-\-crs=EPSG:3857 in.shp out.shp .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .