OGRLINEREF(1)                        GDAL                        OGRLINEREF(1)

نام (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

                                August 18, 2026                  OGRLINEREF(1)