1d.vect(1) GRASS GIS User's Manual d.vect(1)
2
6 d.vect - Displays user-specified vector map in the active graphics
7 frame.
8
10 display, graphics, vector, level1
11
13 d.vect
14 d.vect --help
15 d.vect [-cirs] map=name [layer=string] display=string[,string,...]
16 [type=string[,string,...]] [cats=range] [where=sql_query]
17 [color=name] [fill_color=name] [rgb_column=name] [zcolor=style]
18 [width=integer] [width_column=name] [width_scale=float]
19 [icon=string] [size=float] [size_column=name] [rotation_col‐
20 umn=name] [icon_area=string] [icon_line=string] [legend_la‐
21 bel=string] [label_layer=string] [attribute_column=name] [la‐
22 bel_color=name] [label_bgcolor=name] [label_bcolor=name] [la‐
23 bel_size=integer] [font=string] [encoding=string] [xref=string]
24 [yref=string] [minreg=float] [maxreg=float] [--help] [--verbose]
25 [--quiet] [--ui]
26 Flags:
28 -c
29 Random colors according to category number (or layer number if
30 ’layer=-1’ is given)
31 -i
33 Use values from ’cats’ option as feature id
34 -r
36 Use square root of the value of size_column
37 This makes circle areas proportionate to the size_column values in‐
38 stead of circle radius
39 -s
41 Do not show this layer in vector legend
42 --help
44 Print usage summary
45 --verbose
47 Verbose module output
48 --quiet
50 Quiet module output
51 --ui
53 Force launching GUI dialog
54 Parameters:
56 map=name [required]
57 Name of vector map
58 Or data source for direct OGR access
59 layer=string
61 Layer number or name (’-1’ for all layers)
62 A single vector map can be connected to multiple database tables.
63 This number determines which table to use. When used with direct
64 OGR access this is the layer name.
65 Default: 1
66 display=string[,string,...]Â [required]
68 Display
69 Options: shape, cat, topo, vert, dir, zcoor
70 Default: shape
71 shape: Display geometry of features
72 cat: Display category numbers of features
73 topo: Display topology information (nodes, edges)
74 vert: Display vertices of features
75 dir: Display direction of linear features
76 zcoor: Display z-coordinate of features (only for 3D vector maps)
77 type=string[,string,...]
79 Input feature type
80 Options: point, line, boundary, centroid, area, face
81 Default: point,line,area,face
82 cats=range
84 Category values
85 Example: 1,3,7-9,13
86 where=sql_query
88 WHERE conditions of SQL statement without ’where’ keyword
89 Example: income < 1000 and population >= 10000
90 color=name
92 Feature color
93 Either a standard color name, R:G:B triplet, or "none"
94 Default: 0:29:57
95 fill_color=name
97 Area fill color
98 Either a standard color name, R:G:B triplet, or "none"
99 Default: 0:103:204
100 rgb_column=name
102 Colorize features according to color definition column
103 Color definition in R:G:B form
104 zcolor=style
106 Colorize point or area features according to z-coordinate
107 Options: aspect, aspectcolr, bcyr, bgyr, blues, byg, byr, celsius,
108 corine, curvature, differences, elevation, etopo2, evi, fahrenheit,
109 forest_cover, gdd, grass, greens, grey, grey.eq, grey.log, grey1.0,
110 grey255, gyr, haxby, inferno, kelvin, magma, ndvi, ndwi, nlcd, or‐
111 anges, plasma, population, population_dens, precipitation, precipi‐
112 tation_daily, precipitation_monthly, rainbow, ramp, random, reds,
113 roygbiv, rstcurv, ryb, ryg, sepia, slope, soilmoisture, srtm,
114 srtm_plus, terrain, viridis, water, wave
115 aspect: aspect oriented grey colors [range: map values]
116 aspectcolr: aspect oriented rainbow colors [range: 0 to 360]
117 bcyr: blue through cyan through yellow to red [range: map values]
118 bgyr: blue through green through yellow to red [range: map values]
119 blues: white to blue [range: map values]
120 byg: blue through yellow to green [range: map values]
121 byr: blue through yellow to red [range: map values]
122 celsius: blue to red for degree Celsius temperature [range: -80 to
123 80]
124 corine: EU Corine land cover colors [range: 111 to 995]
125 curvature: for terrain curvatures (from v.surf.rst and r.slope.as‐
126 pect) [range: map values]
127 differences: differences oriented colors [range: map values]
128 elevation: maps relative ranges of raster values to elevation
129 color ramp [range: map values]
130 etopo2: colors for ETOPO2 worldwide bathymetry/topography [range:
131 -11000 to 8850]
132 evi: enhanced vegetative index colors [range: -1 to 1]
133 fahrenheit: blue to red for Fahrenheit temperature [range: -112 to
134 176]
135 forest_cover: percentage of forest cover [range: 0 to 100]
136 gdd: accumulated growing degree days [range: 0 to 6000]
137 grass: GRASS GIS green (perceptually uniform) [range: map values]
138 greens: white to green [range: map values]
139 grey: grey scale [range: map values]
140 grey.eq: histogram-equalized grey scale [range: map values]
141 grey.log: histogram logarithmic transformed grey scale [range: map
142 values]
143 grey1.0: grey scale for raster values between 0.0-1.0 [range: 0 to
144 1]
145 grey255: grey scale for raster values between 0-255 [range: 0 to
146 255]
147 gyr: green through yellow to red [range: map values]
148 haxby: relative colors for bathymetry or topography [range: map
149 values]
150 inferno: perceptually uniform sequential color table inferno
151 [range: map values]
152 kelvin: blue to red for temperature in Kelvin scale [range: 193.15
153 to 353.15]
154 magma: perceptually uniform sequential color table magma [range:
155 map values]
156 ndvi: Normalized Difference Vegetation Index colors [range: -1 to
157 1]
158 ndwi: Normalized Difference Water Index colors [range: -200 to
159 200]
160 nlcd: US National Land Cover Dataset colors [range: 0 to 95]
161 oranges: white to orange [range: map values]
162 plasma: perceptually uniform sequential color table plasma [range:
163 map values]
164 population: color table covering human population classification
165 breaks [range: 0 to 2e+09]
166 population_dens: color table covering human population density
167 classification breaks [range: 0 to 1e+09]
168 precipitation: precipitation color table (0..2000mm) [range: 0 to
169 7000]
170 precipitation_daily: precipitation color table (0..1000mm) [range:
171 0 to 10000]
172 precipitation_monthly: precipitation color table (0..1000mm)
173 [range: 0 to 1000]
174 rainbow: rainbow color table [range: map values]
175 ramp: color ramp [range: map values]
176 random: random color table [range: map values]
177 reds: white to red [range: map values]
178 roygbiv: [range: map values]
179 rstcurv: terrain curvature (from r.resamp.rst) [range: map values]
180 ryb: red through yellow to blue [range: map values]
181 ryg: red through yellow to green [range: map values]
182 sepia: yellowish-brown through to white [range: map values]
183 slope: r.slope.aspect-type slope colors for raster values 0-90
184 [range: 0 to 90]
185 soilmoisture: soilmoisture color table (0.0-1.0) [range: 0 to 1]
186 srtm: color palette for Shuttle Radar Topography Mission elevation
187 [range: -11000 to 8850]
188 srtm_plus: color palette for Shuttle Radar Topography Mission ele‐
189 vation (with seafloor colors) [range: -11000 to 8850]
190 terrain: global elevation color table covering -11000 to +8850m
191 [range: -11000 to 8850]
192 viridis: perceptually uniform sequential color table viridis
193 [range: map values]
194 water: water depth [range: map values]
195 wave: color wave [range: map values]
196 width=integer
198 Line width
199 Default: 0
200 width_column=name
202 Name of numeric column containing line width
203 These values will be scaled by width_scale
204 width_scale=float
206 Scale factor for width_column
207 Default: 1
208 icon=string
210 Point and centroid symbol
211 Options: basic/arrow, basic/arrow1, basic/arrow2, basic/arrow3, ba‐
212 sic/box, basic/circle, basic/cross1, basic/cross2, basic/cross3,
213 basic/diamond, basic/hexagon, basic/marker, basic/octagon, ba‐
214 sic/pin, basic/pin_dot, basic/point, basic/pushpin, basic/star, ba‐
215 sic/triangle, basic/x, demo/muchomurka, demo/smrk, extra/4pt_star,
216 extra/adcp, extra/airport, extra/alpha_flag, extra/bridge, ex‐
217 tra/dim_arrow, extra/dive_flag, extra/fiducial, extra/fish, ex‐
218 tra/half-box, extra/half-circle, extra/offbox_ne, extra/offbox_nw,
219 extra/offbox_se, extra/offbox_sw, extra/pentagon, extra/ping, ex‐
220 tra/ring, extra/simple_zia, extra/target, geology/circle_cross, ge‐
221 ology/half-arrow_left, geology/half-arrow_right, geol‐
222 ogy/strike_box, geology/strike_circle, geology/strike_cleavage, ge‐
223 ology/strike_half-bowtie, geology/strike_line, geology/strike_par‐
224 allel, geology/strike_triangle, legend/area, legend/area_curved,
225 legend/line, legend/line_crooked, n_arrows/basic_compass, n_ar‐
226 rows/fancy_compass, n_arrows/n_arrow1a, n_arrows/n_arrow1b, n_ar‐
227 rows/n_arrow2, n_arrows/n_arrow3, n_arrows/n_arrow4, n_arrows/n_ar‐
228 row5, n_arrows/n_arrow6, n_arrows/n_arrow7a, n_arrows/n_arrow7b,
229 n_arrows/n_arrow8a, n_arrows/n_arrow8b, n_arrows/n_arrow9
230 Default: basic/x
231 size=float
233 Symbol size
234 When used with the size_column option this becomes the scale factor
235 Default: 5
236 size_column=name
238 Name of numeric column containing symbol size
239 rotation_column=name
241 Name of numeric column containing symbol rotation angle
242 Measured in degrees CCW from east
243 icon_area=string
245 Area/boundary symbol for legend
246 Options: basic/arrow, basic/arrow1, basic/arrow2, basic/arrow3, ba‐
247 sic/box, basic/circle, basic/cross1, basic/cross2, basic/cross3,
248 basic/diamond, basic/hexagon, basic/marker, basic/octagon, ba‐
249 sic/pin, basic/pin_dot, basic/point, basic/pushpin, basic/star, ba‐
250 sic/triangle, basic/x, demo/muchomurka, demo/smrk, extra/4pt_star,
251 extra/adcp, extra/airport, extra/alpha_flag, extra/bridge, ex‐
252 tra/dim_arrow, extra/dive_flag, extra/fiducial, extra/fish, ex‐
253 tra/half-box, extra/half-circle, extra/offbox_ne, extra/offbox_nw,
254 extra/offbox_se, extra/offbox_sw, extra/pentagon, extra/ping, ex‐
255 tra/ring, extra/simple_zia, extra/target, geology/circle_cross, ge‐
256 ology/half-arrow_left, geology/half-arrow_right, geol‐
257 ogy/strike_box, geology/strike_circle, geology/strike_cleavage, ge‐
258 ology/strike_half-bowtie, geology/strike_line, geology/strike_par‐
259 allel, geology/strike_triangle, legend/area, legend/area_curved,
260 legend/line, legend/line_crooked, n_arrows/basic_compass, n_ar‐
261 rows/fancy_compass, n_arrows/n_arrow1a, n_arrows/n_arrow1b, n_ar‐
262 rows/n_arrow2, n_arrows/n_arrow3, n_arrows/n_arrow4, n_arrows/n_ar‐
263 row5, n_arrows/n_arrow6, n_arrows/n_arrow7a, n_arrows/n_arrow7b,
264 n_arrows/n_arrow8a, n_arrows/n_arrow8b, n_arrows/n_arrow9
265 Default: legend/area
266 icon_line=string
268 Line symbol for legend
269 Options: basic/arrow, basic/arrow1, basic/arrow2, basic/arrow3, ba‐
270 sic/box, basic/circle, basic/cross1, basic/cross2, basic/cross3,
271 basic/diamond, basic/hexagon, basic/marker, basic/octagon, ba‐
272 sic/pin, basic/pin_dot, basic/point, basic/pushpin, basic/star, ba‐
273 sic/triangle, basic/x, demo/muchomurka, demo/smrk, extra/4pt_star,
274 extra/adcp, extra/airport, extra/alpha_flag, extra/bridge, ex‐
275 tra/dim_arrow, extra/dive_flag, extra/fiducial, extra/fish, ex‐
276 tra/half-box, extra/half-circle, extra/offbox_ne, extra/offbox_nw,
277 extra/offbox_se, extra/offbox_sw, extra/pentagon, extra/ping, ex‐
278 tra/ring, extra/simple_zia, extra/target, geology/circle_cross, ge‐
279 ology/half-arrow_left, geology/half-arrow_right, geol‐
280 ogy/strike_box, geology/strike_circle, geology/strike_cleavage, ge‐
281 ology/strike_half-bowtie, geology/strike_line, geology/strike_par‐
282 allel, geology/strike_triangle, legend/area, legend/area_curved,
283 legend/line, legend/line_crooked, n_arrows/basic_compass, n_ar‐
284 rows/fancy_compass, n_arrows/n_arrow1a, n_arrows/n_arrow1b, n_ar‐
285 rows/n_arrow2, n_arrows/n_arrow3, n_arrows/n_arrow4, n_arrows/n_ar‐
286 row5, n_arrows/n_arrow6, n_arrows/n_arrow7a, n_arrows/n_arrow7b,
287 n_arrows/n_arrow8a, n_arrows/n_arrow8b, n_arrows/n_arrow9
288 Default: legend/line
289 legend_label=string
291 Label to display after symbol in vector legend
292 label_layer=string
294 Layer number for labels (default: the given layer number)
295 Vector features can have category values in different layers. This
296 number determines which layer to use. When used with direct OGR ac‐
297 cess this is the layer name.
298 Default: 1
299 attribute_column=name
301 Name of column to be displayed as a label
302 label_color=name
304 Label color
305 Either a standard color name or R:G:B triplet
306 Default: red
307 label_bgcolor=name
309 Label background color
310 Either a standard color name, R:G:B triplet, or "none"
311 Default: none
312 label_bcolor=name
314 Label border color
315 Either a standard color name, R:G:B triplet, or "none"
316 Default: none
317 label_size=integer
319 Label size (pixels)
320 Default: 8
321 font=string
323 Font name
324 encoding=string
326 Text encoding
327 xref=string
329 Label horizontal justification
330 Options: left, center, right
331 Default: left
332 yref=string
334 Label vertical justification
335 Options: top, center, bottom
336 Default: center
337 minreg=float
339 Minimum region size (average from height and width) when map is
340 displayed
341 maxreg=float
343 Maximum region size (average from height and width) when map is
344 displayed
345
347 d.vect displays vector maps in the active frame on the graphics moni‐
348 tor.
349
351 d.vect can simply be used typing d.vect map=vector_map. There are a
352 large variety of optional parameters which allow the user to specify
353 vector type, colors, data fields, SQL queries, label size and justifi‐
354 cation, etc.
355 By default d.vect areas are filled with fill_color and outlined with
357 color. Area outlines can be suppressed with
358 d.vect map=vector_map color=none
359 and areas can be made transparent with
360 d.vect map=vector_map fill_color=none
361 In order to display attributes in the map, attribute_column must be
363 specified.
364 Feature colors may be specified by v.colors in a form of color table or
366 in an attribute table column containing RRR:GGG:BBB values.
367 A table for a vector map might look like this:
369 db.select sql="select * from testisola"
370 cat|label|GRASSRGB
371 0|no data|255:255:255
372 90|FRASSILONGO|23:245:67
373 104|LEVICO|23:145:67
374 139|PERGINE VALSUGANA|223:45:237
375 168|SANT’ORSOLA|223:45:67
376 190|TENNA|123:45:67
377 To add the GRASSRGB color column, use v.db.addcolumn:
379 v.db.addcolumn map=testisola columns="GRASSRGB varchar(11)"
380 To add/change a color, use v.db.update:
382 v.db.update map=testisola column=GRASSRGB value="123:45:237" where="cat=139"
383 A much simpler method of color coding is by using the -c flag which
385 displays vector elements of like category number with a random color.
386 This module can use FreeType/TrueType fonts if they have already been
388 selected with d.font.
389 Parameter width is set by default to ’0’. XDRIVER specifies the precise
391 behaviour for non-zero line width, but drivers have some freedom as to
392 how zero-width lines are handled, so they can use the hardware’s "thin
393 line" drawing primitive, if it has one. A width of zero can potentially
394 result in significantly faster operation. On drivers where there is no
395 such thing as a "thin" line, the driver will use a sensible default
396 (which might not be the same as ’1’).
397
399 Spearfish examples:
400 # display roads with category numbers:
401 d.vect map=roads display=shape,cat label_color=green
402 # display randomly colorized soils map with attributes
403 d.vect -c map=soils attribute_column=label
404 # display randomly colorized selected vectors from soils map
405 d.vect -c map=soils where="label=’VBF’" display=shape attribute_column=label
406 3D points, 3D lines and 3D polygons colorized according to z height
408 (for 3D lines and polygons a z height is computed by a midpoint of
409 line/area bounding box):
410 g.region raster=elevation.10m
411 r.random input=elevation.10m n=5000 vector=random3d -d
412 d.mon start=x0
413 # display as black points
414 d.vect map=random3d
415 # display 3D points colorized according to z height
416 d.vect map=random3d zcolor=gyr
417 # 3D contour lines
418 r.contour input=elevation.10m output=contour20m step=20
419 d.vect map=contour20m zcolor=gyr
420 # generate 3D triangles
421 v.delaunay input=random3d output=random3d_del
422 # display 3D polygons colorized according to z height
423 d.vect map=random3d_del type=area zcolor=gyr
424
426 v.colors, d.erase, d.rast, v.colors, v.db.addcolumn, v.db.update
427 GRASS SQL interface
429
431 CERL
432 Radim Blazek, ITC-Irst, Trento, Italy
433 Support for color tables by Martin Landa, Czech Technical University in
434 Prague (8/2011)
435 and many other GRASS developers
436
438 Available at: d.vect source code (history)
439 Accessed: Mon Jun 20 16:45:49 2022
441 Main index | Display index | Topics index | Keywords index | Graphical
443 index | Full index
444 © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
446GRASS 8.2.0 d.vect(1)