ogrlineref: ogrlineref

In gearslaboratory/gdalUtils: Wrappers for the Geospatial Data Abstraction Library (GDAL) Utilities

Description

R wrapper for ogrlineref: create a linear reference

Usage

ogrlineref(
  help_general,
  progress,
  quiet,
  f,
  dsco,
  lco,
  create,
  l,
  ln,
  lf,
  p,
  pn,
  pm,
  pf,
  r,
  rn,
  o,
  on,
  of,
  s,
  get_pos,
  x,
  y,
  get_coord,
  m,
  get_subline,
  mb,
  me,
  ignore.full_scan = TRUE,
  verbose = FALSE
)

Arguments

help_general	Logical. Show the usage.
progress	Logical. Show progress.
quiet	Logical. Suppress all messages except errors and results.
f	Character. format_name. Select an output format name. The default is to create a shapefile.
dsco	Character. "NAME=VALUE". Dataset creation option (format specific).
lco	Character. "NAME=VALUE". Layer creation option (format specific).
create	Logical. Create the linear reference file (linestring of parts).
l	Character. src_line_datasource_name. The path to input linestring datasource (e.g. the road)
ln	Character. layer_name. The layer name in datasource
lf	Character. field_name. The field name of uniq values to separate the input lines (e.g. the set of roads)
p	Character. src_repers_datasource_name. The path to linear references points (e.g. the road mile-stones)
pn	Character. layer_name. The layer name in datasource.
pm	Character. pos_field_name.The field name of distances along path (e.g. mile-stones values)
pf	Character. field_name. The field name of uniq values to map input reference points to lines
r	Character. src_parts_datasource_name. The path to linear reference file
rn	Character. layer_name. The layer name in datasource.
o	Character. dst_datasource_name. The path to output linear reference file (linestring datasource)
on	Character. layer_name. The layer name in datasource.
of	Character. field_name. The field name for storing the uniq values of input lines
s	Numeric. step. The part size in linear units.
get_pos	Logical. Return linear referenced postion for input X, Y
x	Numeric. long. Input X coordinate
y	Numeric. lat. Input Y coordinate
get_coord	Logical. Return point on path for input linear distance.
m	Numeric. position. The input linear distance
get_subline	Logical. Return the portion of the input path from and to input linear positions
mb	Numeric. position. The input begin linear distance.
me	Numeric. position. The input end linear distance
ignore.full_scan	Logical. If FALSE, perform a brute-force scan if other installs are not found. Default is TRUE.
verbose	Logical. Enable verbose execution? Default is FALSE.

Details

This is an R wrapper for the 'ogrlineref' function that is part of the Geospatial Data Abstraction Library (GDAL). It follows the parameter naming conventions of the original function, with some modifications to allow for more R-like parameters. For all parameters, the user can use a single character string following, precisely, the gdalinfo format (http://gdal.org/ogrlineref.html), or, in some cases, can use R vectors to achieve the same end.

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

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.

This function assumes the user has a working GDAL on their system. If the "gdalUtils_gdalPath" option has been set (usually by gdal_setInstallation), the GDAL found in that path will be used. If nothing is found, gdal_setInstallation will be executed to attempt to find a working GDAL.

Author(s)

Jonathan A. Greenberg ([e-mail]) (wrapper) and Frank Warmerdam (GDAL lead developer).

References

http://www.gdal.org/ogrlineref.html

Examples

# No examples ATM for this function.

gearslaboratory/gdalUtils documentation built on Feb. 17, 2020, 8:09 a.m.