OGRLINEREF(1) GDAL OGRLINEREF(1)
NAME
ogrlineref - Create linear reference and provide some calculations us-
ing it.
SYNOPSIS
ogrlineref [--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 for:
• create linear reference file from input data
• return the "linear referenced" distance for the projection of the in-
put 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
The ogrlineref creates a linear reference - a file containing a seg-
ments of special length (e.g. 1 km in reference units) and get coordi-
nates, linear referenced distances or sublines (subpaths) from this
file. The utility not required the M or Z values in geometry. The re-
sults 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 shape-
file.
-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).
-l <src_line_datasource_name>
The path to input linestring datasource (e.g. the road)
-ln <layer_name>
The layer name in datasource
-lf <field_name>
The field name of unique values to separate the input lines
(e.g. the set of roads).
-p <src_repers_datasource_name>
The path to linear references points (e.g. the road mile-stones)
-pn <layer_name>
The layer name in datasource
-pm <pos_field_name>
The field name of distances along path (e.g. mile-stones values)
-pf <field_name>
The field name of unique values to map input reference points to
lines.
-r <src_parts_datasource_name>
The path to linear reference file.
-rn <layer_name>
The layer name in datasource
-o <dst_datasource_name>
The path to output linear reference file (linestring datasource)
-on <layer_name>
The layer name in datasource
-of <field_name>
The field name for storing the unique values of input lines
-s <step>
The part size in linear units
-get_pos
Return linear referenced position for input X, Y
-x <long>
Input X coordinate
-y <lat>
Input Y coordinate
-get_coord
Return point on path for input linear distance
-m <position>
The input linear distance
-get_subline
Return the portion of the input path from and to input linear
positions.
-mb <position>
The input begin linear distance
-me <position>
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
AUTHOR
Dmitry Baryshnikov <polimax@mail.ru>
COPYRIGHT
1998-2021
Dec 27, 2021 OGRLINEREF(1)
Generated by dwww version 1.14 on Fri Jan 24 09:44:45 CET 2025.