.\" 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-CREATE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-vector-create \- ساخت یک مجموعه داده برداری
.sp
در نگارش 3.13 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
کاربرد: gdal vector create [OPTIONS] <OUTPUT>

ساخت یک مجموعه داده برداری.

آرگومان‌های موضعی:
  \-o, \-\-output <OUTPUT>                                مجموعه داده برداری خروجی [الزامی] [در خط‌لوله‌ها در دسترس نیست]

گزینه‌های عمومی:
  \-h, \-\-help                                           نمایش پیام راهنما و خروج
  \-\-json\-usage                                         نمایش شیوه کاربرد به صورت سند JSON و خروج
  \-\-config <KEY>=<VALUE>                               گزینه پیکربندی [می‌تواند تکرار شود]

گزینه‌ها:
  \-i, \-\-like, \-\-input <TEMPLATE\-DATASET>               مجموعه داده‌های برداری ورودی [در خط‌لوله‌ها در دسترس نیست]
                                                       مانعه‌الجمع با \-\-schema، \-\-field
  \-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                                    مجاز بودن رونویسی لایه خروجی موجود [در خط‌لوله‌ها در دسترس نیست]
  \-\-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>      گزینه‌های باز کردن خروجی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal vector create\fP یک یا چند لایه برداری ایجاد می‌کند؛ در صورتی که مجموعه داده وجود نداشته باشد آن را می‌سازد یا اگر قالب زیرین پشتیبانی کند، لایه‌هایی را به یک مجموعه داده موجود اضافه می‌نماید.
.sp
فیلدهای لایه، نوع هندسه و سیستم مرجع مختصات را می‌توان یا با ارائه یک مجموعه داده موجود یا یک فایل/JSON طرح‌واره OGR_SCHEMA به عنوان الگو، یا با مشخص کردن صریح مؤلفه‌های گوناگون تعریف کرد.
.sp
دستور \fBgdal vector create\fP می‌تواند به عنوان گام نخست یک خط‌لوله (pipeline) به کار رود.
.sp
گزینه‌های زیر در دسترس هستند:
.SH "گزینه‌های خاص برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-output\-layer <OUTPUT\-LAYER>
نام لایه خروجی.
.sp
تنها هنگام ایجاد یک مجموعه داده تک‌لایه معنادار است. این گزینه امکان تعریف یا جایگزینی نام لایه ایجادشده را فراهم می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-i, \-\-like, \-\-input <TEMPLATE\-DATASET>
مجموعه داده برداری برای استفاده به عنوان الگو جهت مجموعه داده ایجادشده.
.sp
اگر مجموعه داده الگو شامل چندین لایه باشد و قالب مقصد از چند لایه پشتیبانی نکند، برنامه با خطا خارج خواهد شد مگر اینکه از \fI\%\-\-input\-layer\fP برای مشخص کردن لایه تکی مورد استفاده از مجموعه داده ورودی به عنوان الگو استفاده شود.
.sp
مانعه‌الجمع با \fI\%\-\-schema\fP و با \fI\%\-\-field\fP، \fI\%\-\-geometry\-type\fP،
\fI\%\-\-geometry\-field\fP و \fI\%\-\-crs\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-layer, \-\-input\-layer <INPUT\-LAYER>
لایه(های) مجموعه داده ورودی جهت استفاده به عنوان الگو برای لایه ایجادشده.
.sp
این گزینه می‌تواند برای تعیین چندین لایه بارها تکرار شود.
.sp
این گزینه تنها زمانی معنادار است که \fI\%\-\-like\fP یا \fI\%\-\-schema\fP همراه با یک مجموعه داده ورودی شامل چندین لایه استفاده شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-schema <OGR_SCHEMA>
فایل یا رشته JSON شامل OGR_SCHEMA برای لایه جهت ایجاد.
.sp
این مقدار می‌تواند یک نام فایل، نشانی اینترنتی (URL) یا یک رشته JSON منطبق بر
\X'tty: link https://raw.githubusercontent.com/OSGeo/gdal/refs/heads/master/ogr/data/ogr_fields_override.schema.json'\fI\%طرح‌واره ogr_fields_override.schema.json\fP\X'tty: link'
باشد.
.sp
اگر OGR_SCHEMA شامل چندین لایه باشد و قالب مقصد از چند لایه پشتیبانی نکند، برنامه با خطا خارج خواهد شد مگر اینکه از \fI\%\-\-input\-layer\fP برای مشخص کردن اینکه کدام لایه تکی از OGR_SCHEMA باید انتخاب شود استفاده گردد.
.sp
مانعه‌الجمع با \fI\%\-\-like\fP و با \fI\%\-\-field\fP، \fI\%\-\-geometry\-type\fP، \fI\%\-\-geometry\-field\fP و \fI\%\-\-crs\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-crs <CRS>
سیستم مرجع مختصات لایه ایجادشده را تعریف می‌کند.
.sp
سیستم‌های مرجع مختصاتی که می‌توانند ارسال شوند هر موردی است که توسط فراخوانی
\fI\%OGRSpatialReference::SetFromUserInput()\fP پشتیبانی می‌شود، که شامل CRS تصویری،
جغرافیایی یا ترکیبی EPSG (مانند EPSG:4296)، یک تعریف متنی شناخته‌شده (WKT) از CRS،
اعلان‌های PROJ.4 یا نام یک فایل .prj حاوی تعریف WKT CRS است.
.sp
مانعه‌الجمع با \fI\%\-\-schema\fP و با \fI\%\-\-like\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-geometry\-field <GEOMETRY\-FIELD>
نام فیلد هندسه برای ایجاد (در صورت پشتیبانی توسط قالب خروجی) (پیش‌فرض: geom).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-geometry\-type <GEOMETRY\-TYPE>
نوع هندسه لایه ایجادشده را تعریف می‌کند.
.sp
نوع هندسه لایه باید یکی از مقادیر زیر باشد:
\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 را می‌توان برای مشخص کردن ابعاد به مقادیر بالا پیوست کرد.
.sp
مانعه‌الجمع با \fI\%\-\-schema\fP و با \fI\%\-\-like\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-field <NAME>:<TYPE>[(,<WIDTH>[,<PRECISION>])]
فیلدی را برای ایجاد در لایه تعریف می‌کند.
.sp
این گزینه می‌تواند برای ایجاد چندین فیلد بارها تکرار شود.
.sp
نوع فیلد می‌تواند یکی از موارد
\fBINTEGER\fP، \fBINTEGER64\fP، \fBREAL\fP، \fBSTRING\fP، \fBDATE\fP، \fBTIME\fP،
\fBDATETIME\fP، \fBBINARY\fP، \fBINTEGERLIST\fP، \fBREALLIST\fP، \fBSTRINGLIST\fP، \fBINTEGER64LIST\fP
باشد.
.sp
عرض و دقت را می‌توان برای انواع فیلد \fBINTEGER\fP، \fBINTEGER64\fP، \fBREAL\fP و \fBSTRING\fP مشخص کرد.
برای نمونه، \fB\-\-field population:INTEGER(10,5)\fP یا \fB\-\-field name:STRING(255)\fP
.sp
مانعه‌الجمع با \fI\%\-\-schema\fP و با \fI\%\-\-like\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-fid <FID>
نام ستون شناسه عارضه (FID) را برای گرداننده‌هایی که از تنظیم آن پشتیبانی می‌کنند تعریف می‌کند
(آن‌هایی که گزینه ساخت لایه \fBFID\fP را اعلان می‌کنند).
.sp
مانعه‌الجمع با \fI\%\-\-schema\fP و با \fI\%\-\-like\fP\&.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه داده (مخصوص قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به منزله اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: ایجاد یک لایه POINT با نام names و یک فیلد متنی با نام name در یک مجموعه داده برداری جدید
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector create \-\-geometry\-type point  \-\-crs EPSG:4326 \-\-field name:string \-\-output\-layer names points.gpkg
.EE
.UNINDENT
.UNINDENT
.SS مثال ۲: افزودن یک لایه POINT با نام names2 و یک فیلد متنی با نام name به یک مجموعه داده برداری موجود
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector create \-\-update \-\-geometry\-type point \-\-crs EPSG:4326 \-\-field name:string \-\-output\-layer names2 points.gpkg
.EE
.UNINDENT
.UNINDENT
.SS مثال ۳: ایجاد یک مجموعه داده برداری جدید با یک لایه به نام countries_new بر اساس لایه countries از یک مجموعه داده موجود
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal vector create \-\-like ../data/poly.gpkg \-\-input\-layer poly \-\-output\-layer areas_new areas.gpkg
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Alessandro Pasotti <elpaso@itopen.it>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.