ogrlineref(1)ogrlineref(1)NAMEogrlineref - The utility can be used for:
· create linear reference file from input data
· return the 'linear referenced' distance for the projection of the
input coordinates (point) on the path
· return the coordinates (point) on the path according to the 'linear
referenced' distance
· return the portion of the path according to the 'linear referenced'
begin and end distances
SYNOPSISogrlineref [--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
The ogrlineref program can be used to create a linear reference - a
file containing a segments of special length (e.g. 1 km in reference
units) and get coordinates, linear referenced distances or sublines
(subpaths) from this file. The utility not required the M or Z values
in geometry. The results can be stored in any OGR supported format.
Also some information is written to the stdout.
--help-general:
Show the usage.
-progress:
Show progress.
-quiet:
Suppress all messages except errors and results.
-f format_name:
Select an output format name. The default is to create a shapefile.
-dsco NAME=VALUE:
Dataset creation option (format specific)
-lco NAME=VALUE:
Layer creation option (format specific)
-create:
Create the linear reference file (linestring of parts).
-lsrc_line_datasource_name:
The path to input linestring datasource (e.g. the road)
-lnlayer_name:
The layer name in datasource
-lffield_name:
The field name of unique values to separate the input lines (e.g.
the set of roads)
-psrc_repers_datasource_name:
The path to linear references points (e.g. the road mile-stones)
-pnlayer_name:
The layer name in datasource
-pmpos_field_name:
The field name of distances along path (e.g. mile-stones values)
-pffield_name:
The field name of unique values to map input reference points to
lines
-rsrc_parts_datasource_name:
The path to linear reference file
-rnlayer_name:
The layer name in datasource
-odst_datasource_name:
The path to output linear reference file (linestring datasource)
-onlayer_name:
The layer name in datasource
-offield_name:
The field name for storing the unique values of input lines
-sstep:
The part size in linear units
-get_pos:
Return linear referenced position for input X, Y
-xlong:
Input X coordinate
-ylat:
Input Y coordinate
-get_coord:
Return point on path for input linear distance
-mposition:
The input linear distance
-get_subline:
Return the portion of the input path from and to input linear
positions
-mbposition:
The input begin linear distance
-meposition:
The input end linear distance
EXAMPLE
This example would create a shapefile (parts.shp) containing a data
needed for linear referencing (1 km parts):
% ogrlineref-create -l roads.shp -p references.shp -pm dist -o parts.shp -s 1000 -progress
AUTHORS
Dmitry Baryshnikov polimax@mail.ru
GDAL Sun Dec 17 2017 ogrlineref(1)
