1v.lrs.segment(1)            GRASS GIS User's Manual           v.lrs.segment(1)
2
3
4

NAME

6       v.lrs.segment   - Creates points/segments from input lines, linear ref‐
7       erence system and positions read from stdin or a file.
8

KEYWORDS

10       vector, linear reference system, network
11

SYNOPSIS

13       v.lrs.segment
14       v.lrs.segment --help
15       v.lrs.segment   input=name    output=name     [llayer=string]      [rs‐
16       driver=string]     [rsdatabase=string]    rstable=string    [file=name]
17       [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]
18
19   Flags:
20       --overwrite
21           Allow output files to overwrite existing files
22
23       --help
24           Print usage summary
25
26       --verbose
27           Verbose module output
28
29       --quiet
30           Quiet module output
31
32       --ui
33           Force launching GUI dialog
34
35   Parameters:
36       input=name [required]
37           Name of input vector map
38           Input vector map containing lines
39
40       output=name [required]
41           Output vector map where segments will be written
42
43       llayer=string
44           Layer number or name
45           Line layer
46           Default: 1
47
48       rsdriver=string
49           Driver name for reference system table
50           Options: dbf, mesql, mysql, odbc, ogr, pg, sqlite
51           Default: sqlite
52
53       rsdatabase=string
54           Database name for reference system table
55           Default: $GISDBASE/$LOCATION_NAME/$MAPSET/sqlite/sqlite.db
56
57       rstable=string [required]
58           Name of the reference system table
59
60       file=name
61           Name of file containing segment rules.  If  not  given,  read  from
62           stdin.
63

DESCRIPTION

65       v.lrs.segment  creates  points/segments from input lines, linear refer‐
66       ence system and positions read from standard in or a file.
67
68       The format is as follows:
69       P <point_id> <line_id> <milepost>+<offset> [<side offset>]
70       L <segment_id> <line_id> <milepost>+<offset> <milepost>+<offset> [<side offset>]
71

NOTES

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

EXAMPLE

77       This example is written for the Spearfish dataset (it continues the ex‐
78       ample from v.lrs.create).
79
80       In this example, the ’route_lrs’ shall be extended for a  new  position
81       (point) along the LRS after bus stop 4:
82       # new point on LRS
83       echo "P 7 22 4+180" | v.lrs.segment route_lrs out=route_lrs_new rstable=route_lrs
84       g.region vector=route_lrs n=n+100 s=s-100 -p
85       d.erase
86       # existing LRS
87       d.vect route_lrs
88       d.vect busstops disp=attr attr=cat size=10 bg=white lcol=blue yref=bottom
89       d.vect busstops icon=basic/circle fcol=blue
90       db.select table=route_lrs
91       # show modified map
92       d.vect route_lrs_new col=red
93

TODO

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

SEE ALSO

98        v.lrs.create, v.lrs.where, v.lrs.label, v.segment
99
100        LRS tutorial,
101       Introducing the Linear Reference System in GRASS
102

AUTHOR

104       Radim Blazek
105

SOURCE CODE

107       Available at: v.lrs.segment source code (history)
108
109       Accessed: Saturday Oct 28 18:18:37 2023
110
111       Main  index  | Vector index | Topics index | Keywords index | Graphical
112       index | Full index
113
114       © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
115
116
117
118GRASS 8.3.1                                                   v.lrs.segment(1)
Impressum