1ogrlineref(1) General Commands Manual ogrlineref(1)
2
3
4
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
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
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
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
134 Dmitry Baryshnikov polimax@mail.ru
135
136
137
138GDAL Wed Oct 3 2018 ogrlineref(1)