| GDAL-VECTOR-MAKE-POINT(1) | GDAL | GDAL-VECTOR-MAKE-POINT(1) |
نام (NAME)
gdal-vector-make-point - ایجاد عوارض نقطه‌ای از فیلدهای توصیفی
افزوده‌شده در نسخه 3.12.
خلاصه دستور (SYNOPSIS)
Usage: gdal vector make-point [OPTIONS] <INPUT> <OUTPUT>
Create point geometries from attribute fields
Positional arguments:
-i, --input <INPUT> Input vector datasets [required] [not available in pipelines]
-o, --output <OUTPUT> Output vector dataset [required] [not available in pipelines]
Common Options:
-h, --help Display help message and exit
--json-usage Display usage as JSON document and exit
--config <KEY>=<VALUE> Configuration option [may be repeated]
-q, --quiet Quiet mode (no progress bar or warning message) [not available in pipelines]
Options:
-l, --layer, --input-layer <INPUT-LAYER> Input layer name(s) [may be repeated] [not available in pipelines]
-f, --of, --format, --output-format <OUTPUT-FORMAT> Output format ("GDALG" allowed) [not available in pipelines]
--co, --creation-option <KEY>=<VALUE> Creation option [may be repeated] [not available in pipelines]
--lco, --layer-creation-option <KEY>=<VALUE> Layer creation option [may be repeated] [not available in pipelines]
--overwrite Whether overwriting existing output dataset is allowed [not available in pipelines]
--update Whether to open existing dataset in update mode [not available in pipelines]
--overwrite-layer Whether overwriting existing output layer is allowed [not available in pipelines]
--append Whether appending to existing layer is allowed [not available in pipelines]
Mutually exclusive with --upsert
--output-layer <OUTPUT-LAYER> Output layer name [not available in pipelines]
--skip-errors Skip errors when writing features [not available in pipelines]
--x <X> Field from which X coordinate should be read [required]
--y <Y> Field from which Y coordinate should be read [required]
--z <Z> Optional field from which Z coordinate should be read
--m <M> Optional field from which M coordinate should be read
--output-crs <OUTPUT-CRS> Output CRS
Advanced Options:
--if, --input-format <INPUT-FORMAT> Input formats [may be repeated] [not available in pipelines]
--oo, --open-option <KEY>=<VALUE> Open options [may be repeated] [not available in pipelines]
--output-oo, --output-open-option <KEY>=<VALUE> Output open options [may be repeated] [not available in pipelines]
--upsert Upsert features (implies 'append') [not available in pipelines]
Mutually exclusive with --append
توضیحات (DESCRIPTION)
دستور gdal vector make-point از فیلدهای توصیفیِ حاوی مختصات، هندسه‌های نقطه‌ای می‌سازد.
گزینه‌های ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)
- --output-crs <CRS>
- سیستم مرجع مختصات (CRS) اختیاری برای انتساب به نقطه‌های ایجادشده. سیستم‌های مرجع مختصاتی که می‌توان مشخص کرد شامل هر موردی است که توسط فراخوانی OGRSpatialReference::SetFromUserInput() پشتیبانی می‌شود؛ از جمله CRSهای تصویرشده، جغرافیایی یا مرکب EPSG (مانند EPSG:4296)، تعریف CRS در قالب متن شناخته‌شده (WKT)، اعلانات PROJ.4، یا نام یک فایل .prj حاوی تعریف WKT CRS.
- --m <FIELD_NAME>
- نام فیلد اختیاری حاوی مقادیر مختصات M
- --x <FIELD_NAME>
- نام فیلد حاوی مقادیر مختصات X
- --y <FIELD_NAME>
- نام فیلد حاوی مقادیر مختصات Y
- --z <FIELD_NAME>
- نام فیلد اختیاری حاوی مقادیر مختصات Z
گزینه‌های استاندارد (STANDARD OPTIONS)
- --append
- مشخص می‌کند که آیا افزودن عوارض به لایه(های) موجود مجاز است یا خیر. این گزینه همچنین در صورتی که مجموعه داده خروجی هنوز وجود نداشته باشد، آن را ایجاد می‌کند.
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
فرمت‌ها یک
یا چند
گزینه
اختیاری
ساخت
مجموعه
داده دارند
که
می‌توانند
برای کنترل
جزئیات
فایل
ایجادشده
استفاده
شوند. به
عنوان
مثال،
درایور GeoPackage
از
گزینه‌های
ساخت برای
کنترل نسخه
پشتیبانی
می‌کند.
می‌تواند تکرار شود.
گزینه‌های در دسترس برای ساخت مجموعه داده بسته به درایور فرمت متفاوت است و برخی فرمت‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات مربوط به فرمت منبع موثق اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز هر فرمت، مستندات اختصاصی مربوط به Vector drivers را ببینید.
توجه داشته باشید که گزینه‌های ساخت مجموعه داده با گزینه‌های ساخت لایه متفاوت هستند.
- --if, --input-format <format>
- نام
فرمت/درایوری
که برای باز
کردن
فایل(های)
ورودی
امتحان
می‌شود.
به‌طور کلی
نیازی به
تعیین آن
نیست، اما
می‌توان از
آن برای
نادیده
گرفتن
تشخیص
خودکار
درایور، در
مواردی که
در انتخاب
درایور
مناسب
ناموفق
است،
استفاده
کرد. این
گزینه
می‌تواند
چندین بار
برای تعیین
چند درایور
کاندید
تکرار شود.
توجه داشته
باشید که
این گزینه
آن
درایورها
را به باز
کردن
مجموعه
داده وادار
نمی‌کند.
به‌ویژه،
برخی
درایورها
الزامات
خاصی روی
پسوند
فایل‌ها
دارند.
می‌تواند تکرار شود.
- --input-layer <INPUT-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 وجود داشته باشد که کلید اصلی عددی نباشد.
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند (خطاهای غیرمسدودکننده که به شکل هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
نویسندگان (AUTHORS)
Dan Baston <dbaston@gmail.com>
کپی‌رایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |