v.lrs.segment - Creates points/segments from input lines, linear reference system and positions read from stdin or a file.

NAME  KEYWORDS  SYNOPSIS  Flags:  Parameters:  DESCRIPTION  NOTES  EXAMPLE  TODO  SEE ALSO  AUTHOR  SOURCE CODE 

---

NAME

v.lrs.segment − Creates points/segments from input lines, linear reference system and positions read from stdin or a file.

KEYWORDS

vector, linear reference system, network

SYNOPSIS

v.lrs.segment
v.lrs.segment −−help
v.lrs.segment input=name output=name [llayer=string] [rsdriver=string] [rsdatabase=string] rstable=string [file=name] [−−overwrite] [−−help] [−−verbose] [−−quiet] [−−ui]

Flags:

−−overwrite

Allow output files to overwrite existing files

−−help

Print usage summary

−−verbose

Verbose module output

−−quiet

Quiet module output

−−ui

Force launching GUI dialog

Parameters:

input=name [required]

Name of input vector map
Input vector map containing lines

output=name [required]

Output vector map where segments will be written

llayer=string

Layer number or name
Line layer
Default: 1

rsdriver=string

Driver name for reference system table
Options: dbf, mysql, odbc, ogr, pg, sqlite
Default: sqlite

rsdatabase=string

Database name for reference system table
Default: $GISDBASE/$LOCATION_NAME/$MAPSET/sqlite/sqlite.db

rstable=string [required]

Name of the reference system table

file=name

Name of file containing segment rules. If not given, read from stdin.

DESCRIPTION

v.lrs.segment creates points/segments from input lines, linear reference system and positions read from standard in or a file.

The format is as follows:

P <point_id> <line_id> <milepost>+<offset> [<side offset>]
L <segment_id> <line_id> <milepost>+<offset> <milepost>+<offset> [<side offset>]

NOTES

For more information and examples see the help page for v.lrs.segment’s sister module, v.segment.

EXAMPLE

This example is written for the Spearfish dataset (it continues the example from v.lrs.create).

In this example, the ’route_lrs’ shall be extended for a new position (point) along the LRS after bus stop 4:

# new point on LRS
echo "P 7 22 4+180" | v.lrs.segment route_lrs out=route_lrs_new rstable=route_lrs
g.region vector=route_lrs n=n+100 s=s−100 −p
d.erase
# existing LRS
d.vect route_lrs
d.vect busstops disp=attr attr=cat size=10 bg=white lcol=blue yref=bottom
d.vect busstops icon=basic/circle fcol=blue
db.select table=route_lrs
# show modified map
d.vect route_lrs_new col=red

TODO

Figure out how to merge result into existing LRS map and table.

SEE ALSO

v.lrs.create, v.lrs.where, v.lrs.label, v.segment

LRS tutorial,
Introducing the Linear Reference System in GRASS

AUTHOR

Radim Blazek

SOURCE CODE

Available at: v.lrs.segment source code (history)

Latest change: Tuesday Dec 17 20:17:20 2024 in commit: d962e90c026708a4815ea2b9f46c0e84c17de22d

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

© 2003−2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual

---