
NAME
d.vect - Displays vector data in the active frame on the graphics monitor.
KEYWORDS
display, vector
SYNOPSIS
d.vect
d.vect help
d.vect [-vacix] map=name [display=string[,string,...]] [type=string[,string,...]] [layer=integer] [cats=range] [where=sql_query] [color=string] [fcolor=string] [rgb_column=string] [width=integer] [wcolumn=string] [wscale=float] [icon=string] [size=integer] [attrcol=string] [llayer=integer] [lcolor=string] [bgcolor=string] [bcolor=string] [lsize=integer] [font=string] [xref=string] [yref=string] [minreg=float] [maxreg=float] [render=string] [--verbose] [--quiet]
Flags:
- -v
- Run verbosely
- -a
- Get colors from map table column (of form RRR:GGG:BBB)
- -c
- Random colors according to category number (or layer number if 'layer=-1' is given)
- -i
- Use values from 'cats' option as feature id
- -x
- Don't add to list of vectors and commands in monitor (it won't be drawn if the monitor is refreshed)
- --verbose
- Verbose module output
- --quiet
- Quiet module output
Parameters:
- map=name
- Name of input vector map
- display=string[,string,...]
- Display
- Options: shape,cat,topo,dir,attr,zcoor
- Default: shape
- type=string[,string,...]
- Type
- Feature type(s)
- Options: point,line,boundary,centroid,area,face
- Default: point,line,boundary,centroid,area,face
- layer=integer
- Layer number
- Layer number. If -1, all layers are displayed.
- Default: 1
- cats=range
- Category values
- Example: 1,3,7-9,13
- where=sql_query
- WHERE conditions of SQL statement without 'where' keyword
- Example: income < 1000 and inhab >= 10000
- color=string
- Line color
- Default: black
- fcolor=string
- Area fill color
- Default: 200:200:200
- rgb_column=string
- Name of color definition column (for use with -a flag)
- Default: GRASSRGB
- width=integer
- Line width
- Default: 0
- wcolumn=string
- Name of column for line widths (these values will be scaled by wscale)
- wscale=float
- Scale factor for wcolumn
- Default: 1
- icon=string
- Point and centroid symbol
- Options: demo/smrk,demo/muchomurka,extra/dive_flag,extra/fiducial,extra/compass,extra/n_arrow1,extra/4pt_star,extra/offbox_sw,extra/offbox_nw,extra/half-circle,extra/airport,extra/alpha_flag,extra/target,extra/bridge,extra/offbox_se,extra/offbox_ne,extra/adcp,extra/fancy_compass,extra/pentagon,basic/cross2,basic/triangle,basic/point,basic/octagon,basic/box,basic/arrow1,basic/marker,basic/star,basic/arrow2,basic/x,basic/cross1,basic/circle,basic/pushpin,basic/diamond
- Default: basic/x
- size=integer
- Symbol size
- Default: 5
- attrcol=string
- Name of column to be displayed
- llayer=integer
- Layer for labels (default: the given layer number)
- lcolor=string
- Label color
- Default: red
- bgcolor=string
- Label background color
- Default: none
- bcolor=string
- Label border color
- Default: none
- lsize=integer
- Label size (pixels)
- Default: 8
- font=string
- Font name
- xref=string
- Label horizontal justification
- Options: left,center,right
- Default: left
- yref=string
- Label vertical justification
- Options: top,center,bottom
- Default: center
- minreg=float
- Minimum region size (average from height and width) when map is displayed
- maxreg=float
- Maximum region size (average from height and width) when map is displayed
- render=string
- Rendering method for filled polygons
- Options: g,r,d,c,l
- Default: c
- g: use the libgis render functions (features: clipping)
- r: use the raster graphics library functions (features: polylines)
- d: use the display library basic functions (features: polylines)
- c: use the display library clipping functions (features: clipping)
- l: use the display library culling functions (features: culling, polylines)
DESCRIPTION
d.vect displays GRASS vector data in the active frame on the graphics
monitor.
NOTES
d.vect can simply be used typing d.vect map=vector_map.
There are a large variety of optional parameters which allow the user to
specify vector type, colors, data fields, SQL queries, label size and
justification, etc.
By default d.vect fills in holes in polygons (islands).
If you only want to show active areas limit the features with, e.g.,
"d.vect cats=1-999999".
In order to display attributes in the map, display=attr must be
specified in addition to the column name (attrcol parameter).
Colors may be specified in an attribute table column
named 'GRASSRGB' (which is a varchar(11) column containing RRR:GGG:BBB values),
see the flag -a.
A table for a vector map might look like this:
echo "select * from testisola" | db.select
cat|label|GRASSRGB
0|no data|255:255:255
90|FRASSILONGO|23:245:67
104|LEVICO|23:145:67
139|PERGINE VALSUGANA|223:45:237
168|SANT'ORSOLA|223:45:67
190|TENNA|123:45:67
To add the GRASSRGB color column, use v.db.addcol:
v.db.addcol testisola col="GRASSRGB varchar(11)"
To add/change a color, use v.db.update:
v.db.update testisola col=GRASSRGB val="123:45:237" where="cat=139"
A much simpler method of color coding is by using the -c flag which
displays vector elements of like category number with a random color.
This module can use FreeType/TrueType fonts if they have already been selected with
d.font.freetype.
EXAMPLES
Spearfish examples:
# display roads with category numbers:
d.vect roads display=shape,cat lcolor=green
# display randomly colorized soils map with attributes
d.vect -c soils disp=attr attrcol=label
# display randomly colorized selected vectors from soils map
d.vect -c soils where="label='VBF'" display=shape,attr attrcol=label
SEE ALSO
d.erase,
d.what.vect,
d.rast,
d.font.freetype
v.db.addcol
v.db.update
GRASS SQL interface
AUTHOR
Radim Blazek, ITC-Irst, Trento, Italy
Last changed: $Date: 2007-04-25 13:34:17 -0700 (Wed, 25 Apr 2007) $
Main index - display index - Full index
© 2003-2008 GRASS Development Team