d.vect(1) - Linux man page

Name

d.vect - Displays GRASS vector data in the active frame on the graphics monitor.

Keywords

display

Synopsis

d.vect
d.vect help
d.vect [-vacix] map=name [type=string[,string,...]] [display=string[,string,...]] [attrcol=string] [icon=string] [size=integer] [layer=integer] [cats=range] [where=sql_query] [width=integer] [wcolumn=string] [wscale=float] [color=string] [fcolor=string] [rgb_column=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 line 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
type=string[,string,...]: Type
Feature type(s)
Options: point,line,boundary,centroid,area,face
Default: point,line,boundary,centroid,area,face
display=string[,string,...]: Display
Options: shape,cat,topo,dir,attr,zcoor
Default: shape
attrcol=string: Name of column to be displayed
icon=string: Point and centroid symbol
Options: demo/muchomurka,demo/smrk,basic/arrow1,basic/arrow2,basic/box,basic/circle,basic/cross1,basic/cross2,basic/diamond,basic/marker,basic/octagon,basic/point,basic/pushpin,basic/star,basic/triangle,basic/x,extra/4pt_star,extra/adcp,extra/airport,extra/alpha_flag,extra/bridge,extra/compass,extra/dive_flag,extra/fancy_compass,extra/half-circle,extra/n_arrow1,extra/offbox_ne,extra/offbox_nw,extra/offbox_se,extra/offbox_sw,extra/pentagon,extra/target
Default: basic/x
size=integer: Symbol size
Default: 5
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 = 10000
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
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
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.

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

Author

Radim Blazek, ITC-Irst, Trento, Italy

Last changed: $Date: 2007-04-25 22:34:17 +0200 (Wed, 25 Apr 2007) $

Full index