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

NAME

6       v.lrs.where   -  Finds  line  id and real km+offset for given points in
7       vector map using linear reference system.
8

KEYWORDS

10       vector, linear reference system, network
11

SYNOPSIS

13       v.lrs.where
14       v.lrs.where --help
15       v.lrs.where lines=name points=name   [llayer=string]    [player=string]
16       [rsdriver=string]     [rsdatabase=string]    rstable=string    [thresh‐
17       old=float]   [--help]  [--verbose]  [--quiet]  [--ui]
18
19   Flags:
20       --help
21           Print usage summary
22
23       --verbose
24           Verbose module output
25
26       --quiet
27           Quiet module output
28
29       --ui
30           Force launching GUI dialog
31
32   Parameters:
33       lines=name [required]
34           Name of input vector map
35           Input vector map containing lines
36
37       points=name [required]
38           Name of input vector map
39           Input vector map containing points
40
41       llayer=string
42           Layer number or name
43           Line layer
44           Default: 1
45
46       player=string
47           Layer number or name
48           Point layer
49           Default: 1
50
51       rsdriver=string
52           Driver name for reference system table
53           Options: dbf, mesql, mysql, odbc, ogr, pg, sqlite
54           Default: sqlite
55
56       rsdatabase=string
57           Database name for reference system table
58           Default: $GISDBASE/$LOCATION_NAME/$MAPSET/sqlite/sqlite.db
59
60       rstable=string [required]
61           Name of the reference system table
62
63       threshold=float
64           Maximum distance to nearest line
65           Default: 1000
66

DESCRIPTION

68       v.lrs.where identifies line id and real milepost+offset for  points  in
69       vector map using linear reference system.
70

EXAMPLE

72       This example is written for the Spearfish dataset (it continues the ex‐
73       ample from v.lrs.create).
74
75       In this example, the ’route_lrs’ shall be queried for unknown positions
76       (points, stored in the map newpoints) along the LRS:
77       # generate query points
78       echo "590866.15|4926737.0
79       590933|4927133" | v.in.ascii out=newpoints
80       v.lrs.where lines=route_lrs points=newpoints rstable=route_lrs
81       pcat|lid|mpost|offset
82       pcat|lid|mpost|offset
83       1|22|4.000000+212.091461
84       2|22|6.000000+188.112093
85       # verification
86       g.region vector=route_lrs n=n+100 s=s-100 -p
87       d.erase
88       d.vect route_lrs
89       d.vect busstops disp=attr attr=cat size=10 bg=white lcol=blue yref=bottom
90       d.vect busstops icon=basic/circle fcol=blue
91       d.vect newpoints col=red
92       # measure distance to previous bus stop:
93       # use measuring tool in graphical user interface
94

SEE ALSO

96        v.lrs.where, v.lrs.segment, v.lrs.label
97
98        LRS tutorial,
99       Introducing the Linear Reference System in GRASS
100

AUTHORS

102       Radim Blazek, ITC-irst/MPA Solutions
103       Documentation  update  (based  on  above  journal article and available
104       fragments): Markus Neteler
105

SOURCE CODE

107       Available at: v.lrs.where source code (history)
108
109       Accessed: Mon Jun 20 16:47:06 2022
110
111       Main index | Vector index | Topics index | Keywords index  |  Graphical
112       index | Full index
113
114       © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
115
116
117
118GRASS 8.2.0                                                     v.lrs.where(1)