1v.profile(1) GRASS GIS User's Manual v.profile(1)
2
6 v.profile - Vector map profiling tool
7
9 vector, profile, transect
10
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 Flags:
22 -c
23 Do not print column names
24 -z
26 Do not print 3D vector data (z values)
27 Only affects 3D vectors
28 --overwrite
30 Allow output files to overwrite existing files
31 --help
33 Print usage summary
34 --verbose
36 Verbose module output
37 --quiet
39 Quiet module output
40 --ui
42 Force launching GUI dialog
43 Parameters:
45 input=name [required]
46 Name of input vector map
47 Or data source for direct OGR access
48 type=string[,string,...]
50 Input feature type
51 Options: point, line
52 Default: point,line
53 where=sql_query
55 WHERE conditions of SQL statement without ’where’ keyword
56 Example: income < 1000 and population >= 10000
57 layer=string
59 Layer number or name
60 Use features only from specified layer
61 Default: 1
62 output=string
64 Path to output text file or - for stdout
65 Default: -
66 separator=character
68 Field separator
69 Special characters: pipe, comma, space, tab, newline
70 Default: pipe
71 dp=integer
73 Number of significant digits
74 Options: 0-32
75 Default: 2
76 buffer=float [required]
78 Buffer (tolerance) for points in map units
79 How far points can be from sampling line
80 Default: 10
81 map_output=name
83 Name for profile line and buffer output map
84 Profile line and buffer around it will be written
85 coordinates=east,north[,east,north,...]
87 Coordinates for profiling line nodes
88 Specify profiling line vertexes and nodes
89 profile_map=name
91 Profiling line map
92 Vector map containing profiling line
93 profile_where=sql_query
95 WHERE conditions for input profile line map
96 Use to select only one line from profiling line map
97 profile_layer=integer
99 Profiling line map layer
100 Default: 1
101
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 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
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 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
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 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
159 Strings are enclosed in double quotes ", still quotes within string are
160 not escaped.
161 Output does not contain Vector CAT values. Only way how to get CAT
163 value is from the attribute table.
164 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
171 r.profile, Linear Referencing System
172
174 Maris Nartiss
175
177 Available at: v.profile source code (history)
178 Accessed: Saturday Oct 28 18:18:45 2023
180 Main index | Vector index | Topics index | Keywords index | Graphical
182 index | Full index
183 © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
185GRASS 8.3.1 v.profile(1)