OGRLINEREF(1)                        GDAL                        OGRLINEREF(1)

NAME
       ogrlineref - Create linear reference and provide some calculations
       using it.

SYNOPSIS

          ogrlineref [--help] [--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:

       o create a linear reference file from input data

       o return the "linear referenced" distance for the projection of the
         input coordinates (point) on the path

       o return the coordinates (point) on the path according to the "linear
         referenced" distance

       o 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
       segments of special length (e.g. 1 km in reference units) and gets
       coordinates, linear referenced distances or sublines (subpaths) from
       this file.  The utility does not require the M or Z components in the
       geometry.  The results can be stored in any OGR supported format.  Also
       some information is written to the stdout.

       --help Show this help message and exit

       --help-general
              Gives a brief usage message for the generic GDAL commandline
              options and exit.

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

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

                                 April 2, 2024                   OGRLINEREF(1)