نام (NAME)

ogrlineref - ایجاد مراجع خطی و انجام محاسبات با استفاده از آن

خلاصه دستور (SYNOPSIS)

ogrlineref [--help] [--help-general] [-progress] [-quiet]
           [-f <format_name>] [-dsco <NAME>=<VALUE>]... [-lco <NAME>=<VALUE>]...
           [-create]
           [-l <src_line_datasource_name>] [-ln <layer_name>] [-lf <field_name>]
           [-p <src_repers_datasource_name>] [-pn <layer_name>] [-pm <pos_field_name>] [-pf <field_name>]
           [-r <src_parts_datasource_name>] [-rn <layer_name>]
           [-o <dst_datasource_name>] [-on <layer_name>] [-of <field_name>] [-s <step>]
           [-get_pos] [-x <long>] [-y <lat>]
           [-get_coord] [-m <position>]
           [-get_subline] [-mb <position>] [-me <position>]

توضیحات (DESCRIPTION)

برنامه ogrlineref می‌تواند برای موارد زیر استفاده شود:

ایجاد یک فایل مرجع خطی از داده‌های ورودی
بازگرداندن فاصله "مرجع خطی شده" برای تصویر مختصات ورودی (نقطه) روی مسیر
بازگرداندن مختصات (نقطه) روی مسیر بر اساس فاصله "مرجع خطی شده"
بازگرداندن بخشی از مسیر بر اساس فاصله‌های شروع و پایان "مرجع خطی شده"

ابزار ogrlineref یک مرجع خطی ایجاد می‌کند - فایلی شامل قطعاتی با طول مشخص (برای نمونه ۱ کیلومتر بر حسب واحدهای مرجع). کاربر می‌تواند مختصات، فاصله‌های مرجع خطی یا زیرخط‌ها (زیرمسیرها) را از این فایل دریافت کند. این ابزار نیازی به مؤلفه‌های M یا Z در هندسه ندارد. نتایج را می‌توان در هر قالبی که توسط OGR پشتیبانی می‌شود ذخیره کرد. همچنین برخی اطلاعات در خروجی استاندارد نوشته می‌شوند.

گزینه‌ها (OPTIONS)

--help: نمایش این پیام راهنما و خروج

--help-general: نمایش پیام کوتاه راهنما برای گزینه‌های عمومی خط فرمان GDAL و خروج.

-progress: نمایش درصد پیشرفت.

-q, --quiet: عدم نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.

-f <format_name>: انتخاب نام قالب خروجی. مقدار پیش‌فرض ایجاد یک shapefile است.

-dsco <NAME>=<VALUE>: گزینه ایجاد مجموعه داده (مختص به هر قالب)

-lco <NAME>=<VALUE>: گزینه ایجاد لایه (مختص به هر قالب).

-create: ایجاد فایل مرجع خطی (رشته خطی از قطعات).

-l <src_line_datasource_name>: مسیر منبع داده رشته‌خط ورودی (مانند جاده)

-ln <layer_name>: نام لایه در منبع داده

-lf <field_name>: نام فیلد مقادیر یکتا جهت تفکیک خطوط ورودی (مانند مجموعه جاده‌ها).

-p <src_repers_datasource_name>: مسیر نقاط مراجع خطی (مانند نشانگرهای مایل یا کیلومتر جاده)

-pn <layer_name>: نام لایه در منبع داده

-pm <pos_field_name>: نام فیلد فاصله‌ها در طول مسیر (مانند مقادیر سنگ‌نشان‌ها)

-pf <field_name>: نام فیلد مقادیر یکتا برای نگاشت نقاط مرجع ورودی به خطوط.

-r <src_parts_datasource_name>: مسیر فایل مرجع خطی.

-rn <layer_name>: نام لایه در منبع داده

-o <dst_datasource_name>: مسیر فایل مرجع خطی خروجی (منبع داده رشته‌خط)

-on <layer_name>: نام لایه در منبع داده

-of <field_name>: نام فیلد جهت ذخیره مقادیر یکتای خطوط ورودی

-s <step>: اندازه قطعه بر حسب واحدهای خطی

-get_pos: بازگرداندن موقعیت مرجع خطی برای مختصات ورودی X و Y

-x <long>: مختصات طول جغرافیایی ورودی (X)

-y <lat>: مختصات عرض جغرافیایی ورودی (Y)

-get_coord: بازگرداندن نقطه روی مسیر برای فاصله خطی ورودی

-m <position>: فاصله خطی ورودی

-get_subline: بازگرداندن بخشی از مسیر ورودی از و تا موقعیت‌های خطی ورودی.

-mb <position>: فاصله خطی شروع ورودی

-me <position>: فاصله خطی پایان ورودی

کد وضعیت بازگشتی (RETURN STATUS CODE)

این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند به‌عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).

مثال‌ها (EXAMPLES)

مثال ۱

این مثال یک shapefile (parts.shp) حاوی داده‌های لازم برای ارجاع خطی (قطعات ۱ کیلومتری) ایجاد می‌کند:

ogrlineref -create -l roads.shp -p references.shp -pm dist -o parts.shp -s 1000 -progress

نویسنده (AUTHOR)

Dmitry Baryshnikov <polimax@mail.ru>

حق نشر (COPYRIGHT)

1998-2026