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

NAME

6       v.profile  - Vector map profiling tool
7

KEYWORDS

9       vector, profile, transect
10

SYNOPSIS

12       v.profile
13       v.profile --help
14       v.profile       [-cz]       input=name       [type=string[,string,...]]
15       [where=sql_query]   [layer=string]   [output=string]   [separator=char‐
16       acter]     [dp=integer]    buffer=float   [map_output=name]    [coordi‐
17       nates=east,north[,east,north,...]]       [profile_map=name]       [pro‐
18       file_where=sql_query]       [profile_layer=integer]       [--overwrite]
19       [--help]  [--verbose]  [--quiet]  [--ui]
20
21   Flags:
22       -c
23           Do not print column names
24
25       -z
26           Do not print 3D vector data (z values)
27           Only affects 3D vectors
28
29       --overwrite
30           Allow output files to overwrite existing files
31
32       --help
33           Print usage summary
34
35       --verbose
36           Verbose module output
37
38       --quiet
39           Quiet module output
40
41       --ui
42           Force launching GUI dialog
43
44   Parameters:
45       input=name [required]
46           Name of input vector map
47           Or data source for direct OGR access
48
49       type=string[,string,...]
50           Input feature type
51           Options: point, line
52           Default: point,line
53
54       where=sql_query
55           WHERE conditions of SQL statement without ’where’ keyword
56           Example: income < 1000 and population >= 10000
57
58       layer=string
59           Layer number or name
60           Use features only from specified layer
61           Default: 1
62
63       output=string
64           Path to output text file or - for stdout
65           Default: -
66
67       separator=character
68           Field separator
69           Special characters: pipe, comma, space, tab, newline
70           Default: pipe
71
72       dp=integer
73           Number of significant digits
74           Options: 0-32
75           Default: 2
76
77       buffer=float [required]
78           Buffer (tolerance) for points in map units
79           How far points can be from sampling line
80           Default: 10
81
82       map_output=name
83           Name for profile line and buffer output map
84           Profile line and buffer around it will be written
85
86       coordinates=east,north[,east,north,...]
87           Coordinates for profiling line nodes
88           Specify profiling line vertexes and nodes
89
90       profile_map=name
91           Profiling line map
92           Vector map containing profiling line
93
94       profile_where=sql_query
95           WHERE conditions for input profile line map
96           Use to select only one line from profiling line map
97
98       profile_layer=integer
99           Profiling line map layer
100           Default: 1
101

DESCRIPTION

103       v.profile prints out distance and attributes of  points/lines  along  a
104       profiling  line.  Distance  is calculated from the first profiling line
105       coordinate pair or from the beginning of vector line.
106       The buffer (tolerance) parameter sets how far point can be located from
107       a profiling line and still be included in the output data set.
108       The  output  map  option can be used to visually check which points are
109       profiled. The buffer (tolerance) setting does not affect lines.   Lines
110       are sampled at their crossing point with profiling line.
111
112       By  default Z values are printed if input vector is a 3D map. It can be
113       disabled with the -z flag.
114       The profiling line can be provided as N,E coordinate pairs or  from  an
115       input  vector  map. As a profiling line must be a single line, the user
116       should use the profile_where parameter to select a single line  from  a
117       profile input map if it contains multiple vector features.
118

NOTES

120       Currently  the  module  can profile only points and lines (including 3D
121       ones).  Areas and other complex features are not supported. If  in  fu‐
122       ture  users  can  provide  reasonable examples how area sampling should
123       work and why it is important, area (or any other feature type) sampling
124       can be added.
125
126       Due  to  bugs in GRASS native buffering algorithms, this module for now
127       depends on GEOS and will not function  if  GRASS  is  compiled  without
128       GEOS.   This restriction will be removed as soon as GRASS native buffer
129       generation is fixed.
130

EXAMPLES

132       List all geonames along part of road NC-96  (NC  Basic  dataset).   The
133       output  will be stored in a file for later usage.  We will use comma as
134       delimiter and three numbers after decimal separator for distance.  Out‐
135       put  file will contain data for all points, that are within 500 m range
136       to profiling line.
137       v.profile input=geonames@PERMANENT output=/home/user/NC_96_geonames.csv\
138         separator=comma dp=3 buffer=500 profile_map=roadsmajor@PERMANENT profile_where=cat=56
139       # Now lets see the output:
140       cat NC_96_geonames.csv
141       Number,Distance,cat,GEONAMEID,NAME,ASCIINAME,ALTERNATEN,FEATURECLA,FEATURECOD,COUNTRYCOD,CC2,ADMIN1,POPULATION,ELEVATION,GTOPO30,TIMEZONE,MODIFICATI,PPLKEY,SRC_ID,MAINT_ID
142       1,360.719,26881,4482019,"New Zebulon Elementary School","New Zebulon Elementary School","","S","SCH","US","","NC",0,106,91,"America/Iqaluit","2006-01-15 00:00:00",0,0,0
143       2,846.806,22026,4476596,"Little River, Township of","Little River, Township of","","A","ADMD","US","","NC",0,0,91,"America/Iqaluit","2006-01-15 00:00:00",0,0,0
144       3,2027.918,16681,4470608,"Hendricks Pond","Hendricks Pond","","H","RSV","US","","NC",0,0,91,"America/Iqaluit","2006-01-15 00:00:00",0,0,0
145       4,2027.918,16690,4470622,"Hendricks Dam","Hendricks Dam","","S","DAM","US","","NC",0,0,91,"America/Iqaluit","2006-01-15 00:00:00",0,0,0
146       5,2999.214,39338,4496159,"Union Chapel","Union Chapel","","","","US","","NC",0,0,96,"America/Iqaluit","2006-01-15 00:00:00",0,0,0
147       6,3784.992,43034,4500325,"Zebulon Airport","Zebulon Airport","","S","AIRP","US","","NC",0,108,98,"America/Iqaluit","2006-01-15 00:00:00",0,0,0
148
149       Create river valley crossection and  provide  river  marker  (Spearfish
150       dataset):
151       # Take elevation samples
152       r.profile input=elevation.dem@PERMANENT output=/home/user/elevation.profile \
153         profile=600570.27364,4920613.41838,600348.034348,4920840.38617
154       # Now get distance to place where river marker should be set
155       v.profile input=streams@PERMANENT output=/home/user/river_profile.csv \
156         east_north=600570.27364,4920613.41838,600348.034348,4920840.38617
157

BUGS

159       Strings are enclosed in double quotes ", still quotes within string are
160       not escaped.
161
162       Output does not contain Vector CAT values. Only  way  how  to  get  CAT
163       value is from the attribute table.
164
165       If  sampled  feature  (point, line) contains multiple attribute entries
166       (has multiple CAT values), only the first one is reported. If this is a
167       limitation  in  some practical use case, a feature request in GRASS GIS
168       issue tracker should be opened.
169

SEE ALSO

171        r.profile, Linear Referencing System
172

AUTHOR

174       Maris Nartiss
175

SOURCE CODE

177       Available at: v.profile source code (history)
178
179       Accessed: Saturday Oct 28 18:18:45 2023
180
181       Main index | Vector index | Topics index | Keywords index  |  Graphical
182       index | Full index
183
184       © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
185
186
187
188GRASS 8.3.1                                                       v.profile(1)
Impressum