| GDAL-VECTOR-CREATE(1) | GDAL | GDAL-VECTOR-CREATE(1) |
نام (NAME)
gdal-vector-create - ساخت یک مجموعه داده برداری
در نگارش 3.13 اضافه شد.
خلاصه دستور (SYNOPSIS)
کاربرد: 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> قالب خروجی (مقدار "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> گزینه‌های باز کردن خروجی [می‌تواند تکرار شود] [در خط‌لوله‌ها در دسترس نیست]
توضیحات (DESCRIPTION)
دستور gdal vector create یک یا چند لایه برداری ایجاد می‌کند؛ در صورتی که مجموعه داده وجود نداشته باشد آن را می‌سازد یا اگر قالب زیرین پشتیبانی کند، لایه‌هایی را به یک مجموعه داده موجود اضافه می‌نماید.
فیلدهای لایه، نوع هندسه و سیستم مرجع مختصات را می‌توان یا با ارائه یک مجموعه داده موجود یا یک فایل/JSON طرح‌واره OGR_SCHEMA به عنوان الگو، یا با مشخص کردن صریح مؤلفه‌های گوناگون تعریف کرد.
دستور gdal vector create می‌تواند به عنوان گام نخست یک خط‌لوله (pipeline) به کار رود.
گزینه‌های زیر در دسترس هستند:
گزینه‌های خاص برنامه (PROGRAM-SPECIFIC OPTIONS)
- --output-layer <OUTPUT-LAYER>
- نام لایه
خروجی.
تنها هنگام ایجاد یک مجموعه داده تک‌لایه معنادار است. این گزینه امکان تعریف یا جایگزینی نام لایه ایجادشده را فراهم می‌کند.
- -i, --like, --input <TEMPLATE-DATASET>
- مجموعه
داده
برداری
برای
استفاده به
عنوان الگو
جهت مجموعه
داده
ایجادشده.
اگر مجموعه داده الگو شامل چندین لایه باشد و قالب مقصد از چند لایه پشتیبانی نکند، برنامه با خطا خارج خواهد شد مگر اینکه از --input-layer برای مشخص کردن لایه تکی مورد استفاده از مجموعه داده ورودی به عنوان الگو استفاده شود.
مانعه‌الجمع با --schema و با --field، --geometry-type، --geometry-field و --crs.
- --layer, --input-layer <INPUT-LAYER>
- لایه(های)
مجموعه
داده ورودی
جهت
استفاده به
عنوان الگو
برای لایه
ایجادشده.
این گزینه می‌تواند برای تعیین چندین لایه بارها تکرار شود.
این گزینه تنها زمانی معنادار است که --like یا --schema همراه با یک مجموعه داده ورودی شامل چندین لایه استفاده شوند.
- --schema <OGR_SCHEMA>
- فایل یا
رشته JSON شامل
OGR_SCHEMA برای
لایه جهت
ایجاد.
این مقدار می‌تواند یک نام فایل، نشانی اینترنتی (URL) یا یک رشته JSON منطبق بر طرح‌واره ogr_fields_override.schema.json باشد.
اگر OGR_SCHEMA شامل چندین لایه باشد و قالب مقصد از چند لایه پشتیبانی نکند، برنامه با خطا خارج خواهد شد مگر اینکه از --input-layer برای مشخص کردن اینکه کدام لایه تکی از OGR_SCHEMA باید انتخاب شود استفاده گردد.
مانعه‌الجمع با --like و با --field، --geometry-type، --geometry-field و --crs.
- --crs <CRS>
- سیستم مرجع
مختصات
لایه
ایجادشده
را تعریف
می‌کند.
سیستم‌های مرجع مختصاتی که می‌توانند ارسال شوند هر موردی است که توسط فراخوانی OGRSpatialReference::SetFromUserInput() پشتیبانی می‌شود، که شامل CRS تصویری، جغرافیایی یا ترکیبی EPSG (مانند EPSG:4296)، یک تعریف متنی شناخته‌شده (WKT) از CRS، اعلان‌های PROJ.4 یا نام یک فایل .prj حاوی تعریف WKT CRS است.
مانعه‌الجمع با --schema و با --like.
- --geometry-field <GEOMETRY-FIELD>
- نام فیلد هندسه برای ایجاد (در صورت پشتیبانی توسط قالب خروجی) (پیش‌فرض: geom).
- --geometry-type <GEOMETRY-TYPE>
- نوع هندسه
لایه
ایجادشده
را تعریف
می‌کند.
نوع هندسه لایه باید یکی از مقادیر زیر باشد: GEOMETRY، POINT، LINESTRING، POLYGON، MULTIPOINT، MULTILINESTRING، MULTIPOLYGON، GEOMETRYCOLLECTION، CURVE، CIRCULARSTRING، COMPOUNDCURVE، SURFACE، CURVEPOLYGON، MULTICURVE، MULTISURFACE، POLYHEDRALSURFACE یا TIN. پسوندهای Z، M یا ZM را می‌توان برای مشخص کردن ابعاد به مقادیر بالا پیوست کرد.
مانعه‌الجمع با --schema و با --like.
- --field <NAME>:<TYPE>[(,<WIDTH>[,<PRECISION>])]
- فیلدی را
برای ایجاد
در لایه
تعریف
می‌کند.
این گزینه می‌تواند برای ایجاد چندین فیلد بارها تکرار شود.
نوع فیلد می‌تواند یکی از موارد INTEGER، INTEGER64، REAL، STRING، DATE، TIME، DATETIME، BINARY، INTEGERLIST، REALLIST، STRINGLIST، INTEGER64LIST باشد.
عرض و دقت را می‌توان برای انواع فیلد INTEGER، INTEGER64، REAL و STRING مشخص کرد. برای نمونه، --field population:INTEGER(10,5) یا --field name:STRING(255)
مانعه‌الجمع با --schema و با --like.
- --fid <FID>
- نام ستون
شناسه
عارضه (FID) را
برای
گرداننده‌هایی
که از تنظیم
آن
پشتیبانی
می‌کنند
تعریف
می‌کند
(آن‌هایی که
گزینه ساخت
لایه FID را
اعلان
می‌کنند).
مانعه‌الجمع با --schema و با --like.
گزینه‌های استاندارد (STANDARD OPTIONS)
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعه
داده (مخصوص
قالب).
می‌تواند تکرار شود.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند به منزله اجرای موفق در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: ایجاد یک لایه POINT با نام names و یک فیلد متنی با نام name در یک مجموعه داده برداری جدید
gdal vector create --geometry-type point --crs EPSG:4326 --field name:string --output-layer names points.gpkg
مثال ۲: افزودن یک لایه POINT با نام names2 و یک فیلد متنی با نام name به یک مجموعه داده برداری موجود
gdal vector create --update --geometry-type point --crs EPSG:4326 --field name:string --output-layer names2 points.gpkg
مثال ۳: ایجاد یک مجموعه داده برداری جدید با یک لایه به نام countries_new بر اساس لایه countries از یک مجموعه داده موجود
gdal vector create --like ../data/poly.gpkg --input-layer poly --output-layer areas_new areas.gpkg
نویسندگان (AUTHORS)
Alessandro Pasotti <elpaso@itopen.it>
کپی‌رایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |