Linux Certif

Toute la documentation sur la certification Linux LPI

d.vect.1grass

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 [-vacixz] map=name [display=string[,string,...]] [type=string[,string,...]] [layer=integer] [cats=range] [where=sql_query] [color=string] [fcolor=string] [rgb_column=name] [zcolor=style] [width=integer] [wcolumn=name] [wscale=float] [icon=string] [size=integer] [llayer=integer] [attrcol=name] [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)

-z

Colorize polygons according to z height

--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,...]

Feature type
Options: point,line,boundary,centroid,area,face
Default: point,line,boundary,centroid,area,face

layer=integer

Layer number (if -1, all layers are displayed)
A single vector map can be connected to multiple database tables. This number determines which table to use.
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

color=string

Line color
Either a standard GRASS color, R:G:B triplet, or "none"
Default: black

fcolor=string

Area fill color
Either a standard GRASS color, R:G:B triplet, or "none"
Default: 200:200:200

rgb_column=name

Name of color definition column (for use with -a flag)
Default: GRASSRGB

zcolor=style

Type of color table (for use with -z flag)
Default: terrain

width=integer

Line width
Default: 0

wcolumn=name

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,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/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/target,extra/airport,extra/alpha_flag,extra/pentagon,extra/half-circle,geology/strike_line,geology/strike_box,geology/strike_circle,geology/strike_triangle
Default: basic/x

size=integer

Symbol size
Default: 5

llayer=integer

Layer number
Layer number for labels (default: the given layer number)
Default: 1

attrcol=name

Name of column to be displayed

lcolor=string

Label color
Either a standard color name or R:G:B triplet
Default: red

bgcolor=string

Label background color
Either a standard GRASS color, R:G:B triplet, or "none"
Default: none

bcolor=string

Label border color
Either a standard GRASS color, R:G:B triplet, or "none"
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

3D points, 3D lines and 3D polygons colorized according to z height:
g.region rast=elevation.10m
r.random elevation.10m n=5000 vector=random3d -d
d.mon x0
# display as black points
d.vect random3d
# display 3D points colorized according to z height
d.vect -z random3d zcol=gyr

# 3D contour lines
r.contour elevation.10m out=contour20m step=20
d.vect -z contour20m zcol=gyr

# generate 3D triangles
v.delaunay random3d out=random3d_del
# display 3D polygons colorized according to z height
d.vect -z random3d_del type=area zcol=gyr

SEE ALSO

d.erase, d.what.vect, d.rast, d.font.freetype, v.colors, v.db.addcol, v.db.update
GRASS SQL interface

AUTHORS

CERL
Radim Blazek, ITC-Irst, Trento, Italy
other GRASS developers

Last changed: $Date: 2008-12-07 04:52:45 +0100 (Sun, 07 Dec 2008) $

Full index

© 2003-2009 GRASS Development Team