NAME

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