# 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

Usage:

    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).
-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 uniq 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 uniq 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 uniq values of input lines
-s step:
  The part size in linear units
-get_pos:
  Return linear referenced postion 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

Generated for GDAL by 1.7.1.