ogrlineref Man page

ogrlineref General Commands Manual ogrlineref

NAME

ogrlineref – ogrlineref 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

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 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 writed 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 uniq 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 uniq 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 uniq 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 Tue Apr 5 2016 ogrlineref