1OGRLINEREF(1)                        GDAL                        OGRLINEREF(1)
2
3
4

NAME

6       ogrlineref  - Create linear reference and provide some calculations us‐
7       ing it.
8

SYNOPSIS

10          ogrlineref [--help-general] [-progress] [-quiet]
11                 [-f format_name] [[-dsco NAME=VALUE] ...] [[-lco NAME=VALUE]...]
12                 [-create]
13                 [-l src_line_datasource_name] [-ln layer_name] [-lf field_name]
14                 [-p src_repers_datasource_name] [-pn layer_name] [-pm pos_field_name] [-pf field_name]
15                 [-r src_parts_datasource_name] [-rn layer_name]
16                 [-o dst_datasource_name] [-on layer_name]  [-of field_name] [-s step]
17                 [-get_pos] [-x long] [-y lat]
18                 [-get_coord] [-m position]
19                 [-get_subline] [-mb position] [-me position]
20

DESCRIPTION

22       The ogrlineref program can be used for:
23
24       • create linear reference file from input data
25
26       • return the "linear referenced" distance for the projection of the in‐
27         put coordinates (point) on the path
28
29       • return  the  coordinates (point) on the path according to the "linear
30         referenced" distance
31
32       • return the portion of the path according to the  "linear  referenced"
33         begin and end distances
34
35       The  ogrlineref  creates  a linear reference - a file containing a seg‐
36       ments of special length (e.g. 1 km in reference units) and get  coordi‐
37       nates,  linear  referenced  distances  or sublines (subpaths) from this
38       file.  The utility not required the M or Z values in geometry.  The re‐
39       sults can be stored in any OGR supported format.  Also some information
40       is written to the stdout.
41
42       --help-general
43              Show the usage.
44
45       -progress
46              Show progress.
47
48       -quiet Suppress all messages except errors and results.
49
50       -f <format_name>
51              Select an output format name. The default is to create a  shape‐
52              file.
53
54       -dsco <NAME=VALUE>
55              Dataset creation option (format specific)
56
57       -lco <NAME=VALUE>
58              Layer creation option (format specific).
59
60       -create
61              Create the linear reference file (linestring of parts).
62
63       -l <src_line_datasource_name>
64              The path to input linestring datasource (e.g. the road)
65
66       -ln <layer_name>
67              The layer name in datasource
68
69       -lf <field_name>
70              The  field  name  of  unique  values to separate the input lines
71              (e.g.  the set of roads).
72
73       -p <src_repers_datasource_name>
74              The path to linear references points (e.g. the road mile-stones)
75
76       -pn <layer_name>
77              The layer name in datasource
78
79       -pm <pos_field_name>
80              The field name of distances along path (e.g. mile-stones values)
81
82       -pf <field_name>
83              The field name of unique values to map input reference points to
84              lines.
85
86       -r <src_parts_datasource_name>
87              The path to linear reference file.
88
89       -rn <layer_name>
90              The layer name in datasource
91
92       -o <dst_datasource_name>
93              The path to output linear reference file (linestring datasource)
94
95       -on <layer_name>
96              The layer name in datasource
97
98       -of <field_name>
99              The field name for storing the unique values of input lines
100
101       -s <step>
102              The part size in linear units
103
104       -get_pos
105              Return linear referenced position for input X, Y
106
107       -x <long>
108              Input X coordinate
109
110       -y <lat>
111              Input Y coordinate
112
113       -get_coord
114              Return point on path for input linear distance
115
116       -m <position>
117              The input linear distance
118
119       -get_subline
120              Return  the  portion  of the input path from and to input linear
121              positions.
122
123       -mb <position>
124              The input begin linear distance
125
126       -me <position>
127              The input end linear distance
128

EXAMPLE

130       This example would create a shapefile  (parts.shp)  containing  a  data
131       needed for linear referencing (1 km parts):
132
133          ogrlineref -create -l roads.shp -p references.shp -pm dist -o parts.shp -s 1000 -progress
134

AUTHOR

136       Dmitry Baryshnikov <polimax@mail.ru>
137
139       1998-2023
140
141
142
143
144                                 Oct 30, 2023                    OGRLINEREF(1)
Impressum