1d.vect(1) Grass User's Manual d.vect(1)
2
6 d.vect - Displays GRASS vector data in the active frame on the graph‐
7 ics monitor.
8
10 display
11
13 d.vect
14 d.vect help
15 d.vect [-vacix] map=name [type=string[,string,...]] [dis‐
16 play=string[,string,...]] [attrcol=string] [icon=string]
17 [size=integer] [layer=integer] [cats=range] [where=sql_query]
18 [width=integer] [wcolumn=string] [wscale=float] [color=string]
19 [fcolor=string] [rgb_column=string] [llayer=integer]
20 [lcolor=string] [bgcolor=string] [bcolor=string] [lsize=integer]
21 [font=string] [xref=string] [yref=string] [minreg=float]
22 [maxreg=float] [render=string] [--verbose] [--quiet]
23 Flags:
25 -v
26 Run verbosely
27 -a
29 Get colors from map table column (of form RRR:GGG:BBB)
30 -c
32 Random colors according to category number (or layer number if
33 'layer=-1' is given)
34 -i
36 Use values from 'cats' option as line ID
37 -x
39 Don't add to list of vectors and commands in monitor (it won't be
40 drawn if the monitor is refreshed)
41 --verbose
43 Verbose module output
44 --quiet
46 Quiet module output
47 Parameters:
49 map=name
50 Name of input vector map
51 type=string[,string,...]
53 Type
54 Feature type(s)
55 Options: point,line,boundary,centroid,area,face
56 Default: point,line,boundary,centroid,area,face
57 display=string[,string,...]
59 Display
60 Options: shape,cat,topo,dir,attr,zcoor
61 Default: shape
62 attrcol=string
64 Name of column to be displayed
65 icon=string
67 Point and centroid symbol
68 Options: demo/smrk,demo/muchomurka,extra/4pt_star,extra/tar‐
69 get,extra/offbox_sw,extra/half-circle,extra/airport,extra/penta‐
70 gon,extra/adcp,extra/dive_flag,extra/off‐
71 box_ne,extra/alpha_flag,extra/off‐
72 box_se,extra/bridge,extra/n_arrow1,extra/fancy_compass,extra/com‐
73 pass,extra/off‐
74 box_nw,basic/cross1,basic/point,basic/octagon,basic/cir‐
75 cle,basic/trian‐
76 gle,basic/star,basic/cross2,basic/arrow2,basic/x,basic/box,basic/dia‐
77 mond,basic/marker,basic/arrow1,basic/pushpin
78 Default: basic/x
79 size=integer
81 Symbol size
82 Default: 5
83 layer=integer
85 Layer number
86 Layer number. If -1, all layers are displayed.
87 Default: 1
88 cats=range
90 Category values
91 Example: 1,3,7-9,13
92 where=sql_query
94 WHERE conditions of SQL statement without 'where' keyword
95 Example: income = 10000
96 width=integer
98 Line width
99 Default: 0
100 wcolumn=string
102 Name of column for line widths (these values will be scaled by
103 wscale)
104 wscale=float
106 Scale factor for wcolumn
107 Default: 1
108 color=string
110 Line color
111 Default: black
112 fcolor=string
114 Area fill color
115 Default: 200:200:200
116 rgb_column=string
118 Name of color definition column (for use with -a flag)
119 Default: GRASSRGB
120 llayer=integer
122 Layer for labels (default: the given layer number)
123 lcolor=string
125 Label color
126 Default: red
127 bgcolor=string
129 Label background color
130 Default: none
131 bcolor=string
133 Label border color
134 Default: none
135 lsize=integer
137 Label size (pixels)
138 Default: 8
139 font=string
141 Font name
142 xref=string
144 Label horizontal justification
145 Options: left,center,right
146 Default: left
147 yref=string
149 Label vertical justification
150 Options: top,center,bottom
151 Default: center
152 minreg=float
154 Minimum region size (average from height and width) when map is
155 displayed
156 maxreg=float
158 Maximum region size (average from height and width) when map is
159 displayed
160 render=string
162 Rendering method for filled polygons
163 Options: g,r,d,c,l
164 Default: c
165 g: use the libgis render functions (features: clipping)
166 r: use the raster graphics library functions (features: polylines)
167 d: use the display library basic functions (features: polylines)
168 c: use the display library clipping functions (features: clipping)
169 l: use the display library culling functions (features: culling,
170 polylines)
171
173 d.vect displays GRASS vector data in the active frame on the graphics
174 monitor.
175
177 d.vect can simply be used typing d.vect map=vector_map. There are a
178 large variety of optional parameters which allow the user to specify
179 vector type, colors, data fields, SQL queries, label size and justifi‐
180 cation, etc.
181 By default d.vect fills in holes in polygons (islands). If you only
183 want to show active areas limit the features with, e.g., "d.vect
184 cats=1-999999".
185 In order to display attributes in the map, display=attr must be speci‐
187 fied in addition to the column name (attrcol parameter).
188 Colors may be specified in an attribute table column named 'GRASSRGB'
190 (which is a varchar(11) column containing RRR:GGG:BBB values), see the
191 flag -a.
192 A table for a vector map might look like this:
194 echo "select * from testisola" | db.select
195 cat|label|GRASSRGB
196 0|no data|255:255:255
197 90|FRASSILONGO|23:245:67
198 104|LEVICO|23:145:67
199 139|PERGINE VALSUGANA|223:45:237
200 168|SANT'ORSOLA|223:45:67
201 190|TENNA|123:45:67
202 To add the GRASSRGB color column, use v.db.addcol:
205 v.db.addcol testisola col="GRASSRGB varchar(11)"
206 To add/change a color, use v.db.update:
209 v.db.update testisola col=GRASSRGB val="123:45:237" where="cat=139"
210 A much simpler method of color coding is by using the -c flag which
213 displays vector elements of like category number with a random color.
214 This module can use FreeType/TrueType fonts if they have already been
216 selected with d.font.freetype.
217
219 Spearfish examples:
220 # display roads with category numbers:
221 d.vect roads display=shape,cat lcolor=green
222 # display randomly colorized soils map with attributes
223 d.vect -c soils disp=attr attrcol=label
224 # display randomly colorized selected vectors from soils map
225 d.vect -c soils where="label='VBF'" display=shape,attr attrcol=label
226
229 d.erase, d.what.vect, d.rast, d.font.freetype v.db.addcol v.db.update
230 GRASS SQL interface
231
233 Radim Blazek, ITC-Irst, Trento, Italy
234 Last changed: $Date: 2007-04-25 22:34:17 +0200 (Wed, 25 Apr 2007) $
236 Full index
238 © 2003-2008 GRASS Development Team
240GRASS 6.3.0 d.vect(1)