1ogrlineref(1)               General Commands Manual              ogrlineref(1)
2
3
4

NAME

6       ogrlinerefThe utility can be used for:
7
8       · create linear reference file from input data
9
10       · return the 'linear referenced' distance for the projection of the
11         input coordinates (point) on the path
12
13       · return the coordinates (point) on the path according to the 'linear
14         referenced' distance
15
16       · return the portion of the path according to the 'linear referenced'
17         begin and end distances
18

SYNOPSIS

20       ogrlineref [--help-general] [-progress] [-quiet]
21                  [-f format_name] [[-dsco NAME=VALUE] ...] [[-lco NAME=VALUE]...]
22                  [-create]
23                  [-l src_line_datasource_name] [-ln layer_name] [-lf field_name]
24                  [-p src_repers_datasource_name] [-pn layer_name] [-pm pos_field_name] [-pf field_name]
25                  [-r src_parts_datasource_name] [-rn layer_name]
26                  [-o dst_datasource_name] [-on layer_name]  [-of field_name] [-s step]
27                  [-get_pos] [-x long] [-y lat]
28                  [-get_coord] [-m position]
29                  [-get_subline] [-mb position] [-me position]
30

DESCRIPTION

32       The ogrlineref program can be used to create a linear reference - a
33       file containing a segments of special length (e.g. 1 km in reference
34       units) and get coordinates, linear referenced distances or sublines
35       (subpaths) from this file. The utility not required the M or Z values
36       in geometry. The results can be stored in any OGR supported format.
37       Also some information is written to the stdout.
38
39       --help-general:
40           Show the usage.
41
42       -progress:
43           Show progress.
44
45       -quiet:
46           Suppress all messages except errors and results.
47
48       -f format_name:
49           Select an output format name. The default is to create a shapefile.
50
51       -dsco NAME=VALUE:
52           Dataset creation option (format specific)
53
54       -lco NAME=VALUE:
55           Layer creation option (format specific)
56
57       -create:
58           Create the linear reference file (linestring of parts).
59
60       -lsrc_line_datasource_name:
61           The path to input linestring datasource (e.g. the road)
62
63       -lnlayer_name:
64           The layer name in datasource
65
66       -lffield_name:
67           The field name of unique values to separate the input lines (e.g.
68           the set of roads)
69
70       -psrc_repers_datasource_name:
71           The path to linear references points (e.g. the road mile-stones)
72
73       -pnlayer_name:
74           The layer name in datasource
75
76       -pmpos_field_name:
77           The field name of distances along path (e.g. mile-stones values)
78
79       -pffield_name:
80           The field name of unique values to map input reference points to
81           lines
82
83       -rsrc_parts_datasource_name:
84           The path to linear reference file
85
86       -rnlayer_name:
87           The layer name in datasource
88
89       -odst_datasource_name:
90           The path to output linear reference file (linestring datasource)
91
92       -onlayer_name:
93           The layer name in datasource
94
95       -offield_name:
96           The field name for storing the unique values of input lines
97
98       -sstep:
99           The part size in linear units
100
101       -get_pos:
102           Return linear referenced position for input X, Y
103
104       -xlong:
105           Input X coordinate
106
107       -ylat:
108           Input Y coordinate
109
110       -get_coord:
111           Return point on path for input linear distance
112
113       -mposition:
114           The input linear distance
115
116       -get_subline:
117           Return the portion of the input path from and to input linear
118           positions
119
120       -mbposition:
121           The input begin linear distance
122
123       -meposition:
124           The input end linear distance
125

EXAMPLE

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

AUTHORS

134       Dmitry Baryshnikov polimax@mail.ru
135
136
137
138GDAL                            Mon Feb 11 2019                  ogrlineref(1)