.TH d.vect 1grass "" "GRASS 6.4.2" "Grass User's Manual"
.SH NAME
\fI\fBd.vect\fR\fR  - Displays user-specified vector map in the active graphics frame.
.SH KEYWORDS
display, vector
.SH SYNOPSIS
\fBd.vect\fR
.br
\fBd.vect help\fR
.br
\fBd.vect\fR [-\fBvacixz\fR] \fBmap\fR=\fIname\fR \fBdisplay\fR=\fIstring\fR[,\fIstring\fR,...]  [\fBtype\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBlayer\fR=\fIinteger\fR]   [\fBcats\fR=\fIrange\fR]   [\fBwhere\fR=\fIsql_query\fR]   [\fBcolor\fR=\fIstring\fR]   [\fBfcolor\fR=\fIstring\fR]   [\fBrgb_column\fR=\fIname\fR]   [\fBzcolor\fR=\fIstyle\fR]   [\fBwidth\fR=\fIinteger\fR]   [\fBwcolumn\fR=\fIname\fR]   [\fBwscale\fR=\fIfloat\fR]   [\fBicon\fR=\fIstring\fR]   [\fBsize\fR=\fIfloat\fR]   [\fBsize_column\fR=\fIname\fR]   [\fBrot_column\fR=\fIname\fR]   [\fBllayer\fR=\fIinteger\fR]   [\fBattrcol\fR=\fIname\fR]   [\fBlcolor\fR=\fIstring\fR]   [\fBbgcolor\fR=\fIstring\fR]   [\fBbcolor\fR=\fIstring\fR]   [\fBlsize\fR=\fIinteger\fR]   [\fBfont\fR=\fIstring\fR]   [\fBxref\fR=\fIstring\fR]   [\fByref\fR=\fIstring\fR]   [\fBminreg\fR=\fIfloat\fR]   [\fBmaxreg\fR=\fIfloat\fR]   [\fBrender\fR=\fIstring\fR]   [--\fBverbose\fR]  [--\fBquiet\fR] 
.SS Flags:
.IP "\fB-v\fR" 4m
.br
Run verbosely
.IP "\fB-a\fR" 4m
.br
Get colors from map table column (of form RRR:GGG:BBB)
.IP "\fB-c\fR" 4m
.br
Random colors according to category number (or layer number if 'layer=-1' is given)
.IP "\fB-i\fR" 4m
.br
Use values from 'cats' option as feature id
.IP "\fB-x\fR" 4m
.br
Don't add to list of vectors and commands in monitor (it won't be drawn if the monitor is refreshed)
.IP "\fB-z\fR" 4m
.br
Colorize polygons according to z height
.IP "\fB--verbose\fR" 4m
.br
Verbose module output
.IP "\fB--quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of input vector map
.IP "\fBdisplay\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Display
.br
Options: \fIshape,cat,topo,dir,attr,zcoor\fR
.br
Default: \fIshape\fR
.br
\fBshape\fR: Display geometry of features
.br
\fBcat\fR: Display category numbers of features
.br
\fBtopo\fR: Display topology information (nodes, edges)
.br
\fBdir\fR: Display direction of linear features
.br
\fBattr\fR: Display selected attribute based on 'attrcol'
.br
\fBzcoor\fR: Display z-coordinate of features (only for 3D vector maps)
.IP "\fBtype\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Feature type
.br
Options: \fIpoint,line,boundary,centroid,area,face\fR
.br
Default: \fIpoint,line,boundary,centroid,area,face\fR
.IP "\fBlayer\fR=\fIinteger\fR" 4m
.br
Layer number (if -1, all layers are displayed)
.br
A single vector map can be connected to multiple database tables. This number determines which table to use.
.br
Default: \fI1\fR
.IP "\fBcats\fR=\fIrange\fR" 4m
.br
Category values
.br
Example: 1,3,7-9,13
.IP "\fBwhere\fR=\fIsql_query\fR" 4m
.br
WHERE conditions of SQL statement without 'where' keyword
.br
Example: income = 10000
.IP "\fBcolor\fR=\fIstring\fR" 4m
.br
Feature color
.br
Either a standard GRASS color, R:G:B triplet, or "none"
.br
Default: \fIblack\fR
.IP "\fBfcolor\fR=\fIstring\fR" 4m
.br
Area fill color
.br
Either a standard GRASS color, R:G:B triplet, or "none"
.br
Default: \fI200:200:200\fR
.IP "\fBrgb_column\fR=\fIname\fR" 4m
.br
Name of color definition column (for use with -a flag)
.br
Default: \fIGRASSRGB\fR
.IP "\fBzcolor\fR=\fIstyle\fR" 4m
.br
Type of color table (for use with -z flag)
.br
Default: \fIterrain\fR
.IP "\fBwidth\fR=\fIinteger\fR" 4m
.br
Line width
.br
Default: \fI0\fR
.IP "\fBwcolumn\fR=\fIname\fR" 4m
.br
Name of column for line widths (these values will be scaled by wscale)
.IP "\fBwscale\fR=\fIfloat\fR" 4m
.br
Scale factor for wcolumn
.br
Default: \fI1\fR
.IP "\fBicon\fR=\fIstring\fR" 4m
.br
Point and centroid symbol
.br
Options: \fIdemo/smrk,demo/muchomurka,basic/x,basic/box,basic/star,basic/pushpin,basic/diamond,basic/triangle,basic/point,basic/arrow1,basic/arrow2,basic/circle,basic/cross1,basic/cross2,basic/marker,basic/octagon,extra/adcp,extra/fish,extra/ping,extra/ring,extra/compass,extra/fiducial,extra/4pt_star,extra/dive_flag,extra/half-box,extra/bridge,extra/offbox_ne,extra/offbox_nw,extra/offbox_se,extra/offbox_sw,extra/fancy_compass,extra/n_arrow1,extra/n_arrow2,extra/n_arrow3,extra/target,extra/airport,extra/alpha_flag,extra/pentagon,extra/half-circle,geology/half-arrow_left,geology/strike_line,geology/half-arrow_right,geology/strike_box,geology/strike_circle,geology/strike_half-bowtie,geology/strike_triangle\fR
.br
Default: \fIbasic/x\fR
.IP "\fBsize\fR=\fIfloat\fR" 4m
.br
Symbol size
.br
When used with the size_column option this becomes the scale factor
.br
Default: \fI5\fR
.IP "\fBsize_column\fR=\fIname\fR" 4m
.br
Name of numeric column containing symbol size
.IP "\fBrot_column\fR=\fIname\fR" 4m
.br
Name of numeric column containing symbol rotation angle
.br
Measured in degrees CCW from east
.IP "\fBllayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
Layer number for labels (default: the given layer number)
.br
Default: \fI1\fR
.IP "\fBattrcol\fR=\fIname\fR" 4m
.br
Name of column to be displayed
.IP "\fBlcolor\fR=\fIstring\fR" 4m
.br
Label color
.br
Either a standard color name or R:G:B triplet
.br
Default: \fIred\fR
.IP "\fBbgcolor\fR=\fIstring\fR" 4m
.br
Label background color
.br
Either a standard GRASS color, R:G:B triplet, or "none"
.br
Default: \fInone\fR
.IP "\fBbcolor\fR=\fIstring\fR" 4m
.br
Label border color
.br
Either a standard GRASS color, R:G:B triplet, or "none"
.br
Default: \fInone\fR
.IP "\fBlsize\fR=\fIinteger\fR" 4m
.br
Label size (pixels)
.br
Default: \fI8\fR
.IP "\fBfont\fR=\fIstring\fR" 4m
.br
Font name
.IP "\fBxref\fR=\fIstring\fR" 4m
.br
Label horizontal justification
.br
Options: \fIleft,center,right\fR
.br
Default: \fIleft\fR
.IP "\fByref\fR=\fIstring\fR" 4m
.br
Label vertical justification
.br
Options: \fItop,center,bottom\fR
.br
Default: \fIcenter\fR
.IP "\fBminreg\fR=\fIfloat\fR" 4m
.br
Minimum region size (average from height and width) when map is displayed
.IP "\fBmaxreg\fR=\fIfloat\fR" 4m
.br
Maximum region size (average from height and width) when map is displayed
.IP "\fBrender\fR=\fIstring\fR" 4m
.br
Rendering method for filled polygons
.br
Options: \fIg,r,d,c,l\fR
.br
Default: \fIc\fR
.br
\fBg\fR: use the libgis render functions (features: clipping)
.br
\fBr\fR: use the raster graphics library functions (features: polylines)
.br
\fBd\fR: use the display library basic functions (features: polylines)
.br
\fBc\fR: use the display library clipping functions (features: clipping)
.br
\fBl\fR: use the display library culling functions (features: culling, polylines)
.PP
.SH DESCRIPTION
\fId.vect\fR displays GRASS vector data in the active frame on the graphics 
monitor.
.SH NOTES
\fId.vect\fR 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.
.PP
By default \fId.vect\fR fills in holes in polygons (islands).  If
you only want to show active areas limit the features with, e.g.,
\fC
.DS
.br
d.vect map=vector_map cats=1-999999
.br
.DE
\fR
.PP
In order to display attributes in the map, display=attr must be
specified in addition to the column name (\fBattrcol\fR parameter).
.PP
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 \fB-a\fR.
.PP
A table for a vector map might look like this:
\fC
.DS
.br
db.select sql="select * from testisola"
.br
cat|label|GRASSRGB
.br
0|no data|255:255:255
.br
90|FRASSILONGO|23:245:67
.br
104|LEVICO|23:145:67
.br
139|PERGINE VALSUGANA|223:45:237
.br
168|SANT'ORSOLA|223:45:67
.br
190|TENNA|123:45:67
.br
.DE
\fR
.PP
To add the GRASSRGB color column, use \fIv.db.addcol\fR:
\fC
.DS
.br
v.db.addcol map=testisola columns="GRASSRGB varchar(11)"
.br
.DE
\fR
.PP
To add/change a color, use \fIv.db.update\fR:
\fC
.DS
.br
v.db.update map=testisola column=GRASSRGB value="123:45:237" where="cat=139"
.br
.DE
\fR
.PP
A much simpler method of color coding is by using the \fB-c\fR flag
which displays vector elements of like category number with a random
color.
.PP
This module can use FreeType/TrueType fonts if they have already been selected with
\fId.font\fR.
.PP
Parameter \fBwidth\fR is set by default to '0'. XDRIVER specifies the
precise behaviour for non-zero line width, but drivers have some
freedom as to how zero-width lines are handled, so they can use the
hardware's "thin line" drawing primitive, if it has one. A
width of zero can potentially result in significantly faster operation. On
drivers where there is no such thing as a "thin" line, the driver will
use a sensible default (which might not be the same as '1').
.SH EXAMPLES
Spearfish examples:
\fC
.DS
.br
# display roads with category numbers:
.br
d.vect map=roads display=shape,cat lcolor=green
.br
.br
# display randomly colorized soils map with attributes
.br
d.vect -c map=soils display=attr attrcol=label
.br
.br
# display randomly colorized selected vectors from soils map
.br
d.vect -c map=soils where="label='VBF'" display=shape,attr attrcol=label
.br
.DE
\fR
.PP
3D points, 3D lines and 3D polygons colorized according to z height:
\fC
.DS
.br
g.region rast=elevation.10m
.br
r.random input=elevation.10m n=5000 vector=random3d -d
.br
d.mon start=x0
.br
# display as black points
.br
d.vect map=random3d
.br
# display 3D points colorized according to z height
.br
d.vect -z map=random3d zcolor=gyr
.br
.br
# 3D contour lines
.br
r.contour input=elevation.10m output=contour20m step=20
.br
d.vect -z map=contour20m zcolor=gyr
.br
.br
# generate 3D triangles
.br
v.delaunay input=random3d output=random3d_del
.br
# display 3D polygons colorized according to z height
.br
d.vect -z map=random3d_del type=area zcolor=gyr
.br
.DE
\fR
.SH SEE ALSO
\fI
d.erase,
d.what.vect,
d.rast,
d.font.freetype,
v.colors,
v.db.addcol,
v.db.update
.br
GRASS SQL interface
\fR
.SH AUTHORS
CERL
.br
Radim Blazek, ITC-Irst, Trento, Italy
.br
other GRASS developers
.PP
\fILast changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $\fR
.PP
Full index
.PP
© 2003-2011 GRASS Development Team