ogrlineref (1) Linux Manual Page

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:

Supress 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 postion 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 [at] mail.ru

Index