.\" 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 "OGRLINEREF" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
ogrlineref \- ایجاد مراجع خطی و انجام محاسبات با استفاده از آن
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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>]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBogrlineref\fP می‌تواند برای موارد زیر استفاده شود:
.INDENT 0.0
.IP \(bu 2
ایجاد یک فایل مرجع خطی از داده‌های ورودی
.IP \(bu 2
بازگرداندن فاصله \(dqمرجع خطی شده\(dq برای تصویر مختصات ورودی (نقطه) روی مسیر
.IP \(bu 2
بازگرداندن مختصات (نقطه) روی مسیر بر اساس فاصله \(dqمرجع خطی شده\(dq
.IP \(bu 2
بازگرداندن بخشی از مسیر بر اساس فاصله‌های شروع و پایان \(dqمرجع خطی شده\(dq
.UNINDENT
.sp
ابزار \fBogrlineref\fP یک مرجع خطی ایجاد می‌کند \- فایلی شامل قطعاتی با طول مشخص (برای نمونه ۱ کیلومتر بر حسب واحدهای مرجع). کاربر می‌تواند مختصات، فاصله‌های مرجع خطی یا زیرخط‌ها (زیرمسیرها) را از این فایل دریافت کند.
این ابزار نیازی به مؤلفه‌های \fBM\fP یا \fBZ\fP در هندسه ندارد.
نتایج را می‌توان در هر قالبی که توسط OGR پشتیبانی می‌شود ذخیره کرد.
همچنین برخی اطلاعات در خروجی استاندارد نوشته می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-help
نمایش این پیام راهنما و خروج
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-general
نمایش پیام کوتاه راهنما برای گزینه‌های عمومی خط فرمان GDAL و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-progress
نمایش درصد پیشرفت.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
عدم نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.
.UNINDENT
.INDENT 0.0
.TP
.B \-f <format_name>
انتخاب نام قالب خروجی. مقدار پیش‌فرض ایجاد یک shapefile است.
.UNINDENT
.INDENT 0.0
.TP
.B \-dsco <NAME>=<VALUE>
گزینه ایجاد مجموعه داده (مختص به هر قالب)
.UNINDENT
.INDENT 0.0
.TP
.B \-lco <NAME>=<VALUE>
گزینه ایجاد لایه (مختص به هر قالب).
.UNINDENT
.INDENT 0.0
.TP
.B \-create
ایجاد فایل مرجع خطی (رشته خطی از قطعات).
.UNINDENT
.INDENT 0.0
.TP
.B \-l <src_line_datasource_name>
مسیر منبع داده رشته‌خط ورودی (مانند جاده)
.UNINDENT
.INDENT 0.0
.TP
.B \-ln <layer_name>
نام لایه در منبع داده
.UNINDENT
.INDENT 0.0
.TP
.B \-lf <field_name>
نام فیلد مقادیر یکتا جهت تفکیک خطوط ورودی (مانند مجموعه جاده‌ها).
.UNINDENT
.INDENT 0.0
.TP
.B \-p <src_repers_datasource_name>
مسیر نقاط مراجع خطی (مانند نشانگرهای مایل یا کیلومتر جاده)
.UNINDENT
.INDENT 0.0
.TP
.B \-pn <layer_name>
نام لایه در منبع داده
.UNINDENT
.INDENT 0.0
.TP
.B \-pm <pos_field_name>
نام فیلد فاصله‌ها در طول مسیر (مانند مقادیر سنگ‌نشان‌ها)
.UNINDENT
.INDENT 0.0
.TP
.B \-pf <field_name>
نام فیلد مقادیر یکتا برای نگاشت نقاط مرجع ورودی به خطوط.
.UNINDENT
.INDENT 0.0
.TP
.B \-r <src_parts_datasource_name>
مسیر فایل مرجع خطی.
.UNINDENT
.INDENT 0.0
.TP
.B \-rn <layer_name>
نام لایه در منبع داده
.UNINDENT
.INDENT 0.0
.TP
.B \-o <dst_datasource_name>
مسیر فایل مرجع خطی خروجی (منبع داده رشته‌خط)
.UNINDENT
.INDENT 0.0
.TP
.B \-on <layer_name>
نام لایه در منبع داده
.UNINDENT
.INDENT 0.0
.TP
.B \-of <field_name>
نام فیلد جهت ذخیره مقادیر یکتای خطوط ورودی
.UNINDENT
.INDENT 0.0
.TP
.B \-s <step>
اندازه قطعه بر حسب واحدهای خطی
.UNINDENT
.INDENT 0.0
.TP
.B \-get_pos
بازگرداندن موقعیت مرجع خطی برای مختصات ورودی X و Y
.UNINDENT
.INDENT 0.0
.TP
.B \-x <long>
مختصات طول جغرافیایی ورودی (X)
.UNINDENT
.INDENT 0.0
.TP
.B \-y <lat>
مختصات عرض جغرافیایی ورودی (Y)
.UNINDENT
.INDENT 0.0
.TP
.B \-get_coord
بازگرداندن نقطه روی مسیر برای فاصله خطی ورودی
.UNINDENT
.INDENT 0.0
.TP
.B \-m <position>
فاصله خطی ورودی
.UNINDENT
.INDENT 0.0
.TP
.B \-get_subline
بازگرداندن بخشی از مسیر ورودی از و تا موقعیت‌های خطی ورودی.
.UNINDENT
.INDENT 0.0
.TP
.B \-mb <position>
فاصله خطی شروع ورودی
.UNINDENT
.INDENT 0.0
.TP
.B \-me <position>
فاصله خطی پایان ورودی
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به‌صورت هشدار صادر می‌شوند به‌عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱"
.sp
این مثال یک shapefile (\fBparts.shp\fP) حاوی داده‌های لازم برای ارجاع خطی (قطعات ۱ کیلومتری) ایجاد می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ogrlineref \-create \-l roads.shp \-p references.shp \-pm dist \-o parts.shp \-s 1000 \-progress
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Dmitry Baryshnikov <polimax@mail.ru>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.