d.vect(1)

1d.vect(1)                     Grass User's Manual                    d.vect(1)
2
3
4

NAME

6       d.vect   - Displays GRASS vector data in the active frame on the graph‐
7       ics monitor.
8

KEYWORDS

10       display
11

SYNOPSIS

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]
23
24   Flags:
25       -v  Run verbosely
26
27       -a  Get colors from map table column (of form RRR:GGG:BBB)
28
29       -c  Random  colors  according  to  category  number (or layer number if
30           'layer=-1' is given)
31
32       -i  Use values from 'cats' option as line ID
33
34       -x  Don't add to list of vectors and commands in monitor (it  won't  be
35           drawn if the monitor is refreshed)
36
37   Parameters:
38       map=name
39           Name of input vector map
40
41       type=string[,string,...]
42           Type   Options:   point,line,boundary,centroid,area,face   Default:
43           point,line,boundary,centroid,area,face
44
45       display=string[,string,...]
46           Display Options: shape,cat,topo,dir,attr,zcoor Default: shape
47
48       attrcol=string
49           Name of column to be displayed
50
51       icon=string
52           Point         and         centroid         symbol          Options:
53           demo/smrk,demo/muchomurka,extra/half-circle,extra/air‐
54           port,extra/compass,extra/adcp,extra/fancy_com‐
55           pass,extra/4pt_star,extra/alpha_flag,extra/tar‐
56           get,extra/dive_flag,basic/circle,basic/triangle,basic/push‐
57           pin,basic/point,basic/marker,basic/cross1,basic/arrow2,basic/cross2,basic/arrow1,basic/octagon,basic/dia‐
58           mond,basic/star,basic/x,basic/box Default: basic/x
59
60       size=integer
61           Icon size Default: 8
62
63       layer=integer
64           Layer number. If -1, all layers are displayed.  Default: 1
65
66       cats=range
67           Category values Example: 1,3,7-9,13
68
69       where=sql_query
70           WHERE conditions of SQL statement without 'where'  keyword.  (exam‐
71           ple: income = 10000)
72
73       width=integer
74           Line width Default: 0
75
76       wcolumn=string
77           Name  of  column  for  line  widths (these values will be scaled by
78           wscale)
79
80       wscale=float
81           Scale factor for wcolumn Default: 1
82
83       color=string
84           Line color Default: black
85
86       fcolor=string
87           Area fill color Default: 200:200:200
88
89       rgb_column=string
90           Name of color definition column (for use  with  -a  flag)  Default:
91           GRASSRGB
92
93       llayer=integer
94           Layer for labels Default: 1
95
96       lcolor=string
97           Label color Default: red
98
99       bgcolor=string
100           Label background color Default: none
101
102       bcolor=string
103           Label border color Default: none
104
105       lsize=integer
106           Label size (pixels) Default: 8
107
108       font=string
109           Font           name          Options:          cyrilc,gothgbt,goth‐
110           grt,gothitt,greekc,greekcs,greekp,greeks,italicc,italiccs,ital‐
111           ict,romanc,romancs,romand,romans,romant,scriptc,scripts    Default:
112           romans
113
114       xref=string
115           Label horizontal justification Options: left,center,right  Default:
116           left
117
118       yref=string
119           Label  vertical  justification  Options: top,center,bottom Default:
120           center
121
122       minreg=float
123           Minimum region size (average from height and  width)  when  map  is
124           displayed
125
126       maxreg=float
127           Maximum  region  size  (average  from height and width) when map is
128           displayed
129

DESCRIPTION

131       d.vect displays GRASS vector data in the active frame on  the  graphics
132       monitor.
133

NOTES

135       d.vect  can  simply  be used typing d.vect map=vector_map.  There are a
136       large variety of optional parameters which allow the  user  to  specify
137       vector  type, colors, data fields, SQL queries, label size and justifi‐
138       cation, etc.
139
140       By default d.vect fills in holes in polygons (islands).   If  you  only
141       want  to  show  active  areas  limit  the  features with, e.g., "d.vect
142       cats=1-999999".
143
144       In order to display attributes in the map, display=attr must be  speci‐
145       fied in addition to the column name (attrcol parameter).
146
147       Colors  may  be specified in an attribute table column named 'GRASSRGB'
148       (which is a varchar(11) column containing RRR:GGG:BBB values), see  the
149       flag -a.
150
151       A table for a vector map might look like this:
152       echo "select * from testisola" | db.select
153       cat|label|GRASSRGB
154       0|no data|255:255:255
155       90|FRASSILONGO|23:245:67
156       104|LEVICO|23:145:67
157       139|PERGINE VALSUGANA|223:45:237
158       168|SANT'ORSOLA|223:45:67
159       190|TENNA|123:45:67
160
161
162       To add the GRASSRGB color column, use v.db.addcol:
163       v.db.addcol testisola col="GRASSRGB varchar(11)"
164
165
166       To add/change a color, use v.db.update:
167       v.db.update testisola col=GRASSRGB val="123:45:237" where="cat=139"
168
169
170       A  much  simpler  method  of color coding is by using the -c flag which
171       displays vector elements of like category number with a random color.
172
173       This module can use FreeType/TrueType fonts if they have  already  been
174       selected with d.font.freetype.
175

EXAMPLES

177       Spearfish examples:
178       # display roads with category numbers:
179       d.vect roads display=shape,cat lcolor=green
180       # display randomly colorized soils map with attributes
181       d.vect -c soils disp=attr attrcol=label
182       # display randomly colorized selected vectors from soils map
183       d.vect -c soils where="label='VBF'" display=shape,attr attrcol=label
184
185

AUTHOR

191       Radim Blazek, ITC-Irst, Trento, Italy
192
193       Last changed: $Date: 2007/04/25 20:34:17 $
194
195       Full index
196
197
198
199GRASS 6.2.2                                                          d.vect(1)