GRASS logo

Note: A new GRASS GIS stable version has been released: GRASS GIS 7.4, available here.
Updated manual page: here


d.vect - Displays user-specified vector map in the active graphics frame.


display, graphics, vector


d.vect --help
d.vect [-cir] map=name [layer=string] display=string[,string,...] [type=string[,string,...]] [cats=range] [where=sql_query] [color=name] [fill_color=name] [rgb_column=name] [zcolor=style] [width=integer] [width_column=name] [width_scale=float] [icon=string] [size=float] [size_column=name] [rotation_column=name] [label_layer=string] [attribute_column=name] [label_color=name] [label_bgcolor=name] [label_bcolor=name] [label_size=integer] [font=string] [encoding=string] [xref=string] [yref=string] [minreg=float] [maxreg=float] [--help] [--verbose] [--quiet] [--ui]


Random colors according to category number (or layer number if 'layer=-1' is given)
Use values from 'cats' option as feature id
Use square root of the value of size_column
This makes circle areas proportionate to the size_column values instead of circle radius
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


map=name [required]
Name of vector map
Or data source for direct OGR access
Layer number or name ('-1' for all layers)
A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
Default: 1
display=string[,string,...] [required]
Options: shape, cat, topo, vert, dir, zcoor
Default: shape
shape: Display geometry of features
cat: Display category numbers of features
topo: Display topology information (nodes, edges)
vert: Display vertices of features
dir: Display direction of linear features
zcoor: Display z-coordinate of features (only for 3D vector maps)
Input feature type
Options: point, line, boundary, centroid, area, face
Default: point,line,boundary,area,face
Category values
Example: 1,3,7-9,13
WHERE conditions of SQL statement without 'where' keyword
Example: income < 1000 and inhab >= 10000
Feature color
Either a standard color name, R:G:B triplet, or "none"
Default: black
Area fill color
Either a standard color name, R:G:B triplet, or "none"
Default: 200:200:200
Colorize features according color definition column
Color definition in R:G:B form
Colorize point or area features according to z-coordinate
Options: aspect, aspectcolr, bcyr, bgyr, blues, byg, byr, celsius, corine, curvature, differences, elevation, etopo2, evi, fahrenheit, gdd, greens, grey, grey.eq, grey.log, grey1.0, grey255, gyr, haxby, kelvin, ndvi, ndwi, oranges, population, population_dens, precipitation, precipitation_daily, precipitation_monthly, rainbow, ramp, random, reds, rstcurv, ryb, ryg, sepia, slope, srtm, srtm_plus, terrain, wave
aspectaspect: aspect oriented grey colors
aspectcolraspectcolr: aspect oriented rainbow colors
bcyrbcyr: blue through cyan through yellow to red
bgyrbgyr: blue through green through yellow to red
bluesblues: white to blue
bygbyg: blue through yellow to green
byrbyr: blue through yellow to red
celsiuscelsius: blue to red for degree Celsius temperature
corinecorine: EU Corine land cover colors
curvaturecurvature: for terrain curvatures (from and r.slope.aspect)
differencesdifferences: differences oriented colors
elevationelevation: maps relative ranges of raster values to elevation color ramp
etopo2etopo2: colors for ETOPO2 worldwide bathymetry/topography
evievi: enhanced vegetative index colors
fahrenheitfahrenheit: blue to red for Fahrenheit temperature
gddgdd: accumulated growing degree days
greensgreens: white to green
greygrey: grey scale
grey.eqgrey.eq: histogram-equalized grey scale
grey.loggrey.log: histogram logarithmic transformed grey scale
grey1.0grey1.0: grey scale for raster values between 0.0-1.0
grey255grey255: grey scale for raster values between 0-255
gyrgyr: green through yellow to red
haxbyhaxby: relative colors for bathymetry or topography
kelvinkelvin: blue to red for temperature in Kelvin scale
ndvindvi: Normalized Difference Vegetation Index colors
ndwindwi: Normalized Difference Water Index colors
orangesoranges: white to orange
populationpopulation: color table covering human population classification breaks
population_denspopulation_dens: color table covering human population density classification breaks
precipitationprecipitation: precipitation color table (0..2000mm)
precipitation_dailyprecipitation_daily: precipitation color table (0..1000mm)
precipitation_monthlyprecipitation_monthly: precipitation color table (0..1000mm)
rainbowrainbow: rainbow color table
rampramp: color ramp
randomrandom: random color table
redsreds: white to red
rstcurvrstcurv: terrain curvature (from r.resamp.rst)
rybryb: red through yellow to blue
rygryg: red through yellow to green
sepiasepia: yellowish-brown through to white
slopeslope: r.slope.aspect-type slope colors for raster values 0-90
srtmsrtm: color palette for Shuttle Radar Topography Mission elevation
srtm_plussrtm_plus: color palette for Shuttle Radar Topography Mission elevation (with seafloor colors)
terrainterrain: global elevation color table covering -11000 to +8850m
wavewave: color wave
Line width
Default: 0
Name of numeric column containing line width
These values will be scaled by width_scale
Scale factor for width_column
Default: 1
Point and centroid symbol
Options: basic/arrow1, basic/arrow2, basic/arrow3, basic/box, basic/circle, basic/cross1, basic/cross2, basic/cross3, basic/diamond, basic/marker, basic/octagon, basic/point, basic/pushpin, basic/star, basic/triangle, basic/x, demo/muchomurka, demo/smrk, extra/4pt_star, extra/adcp, extra/airport, extra/alpha_flag, extra/bridge, extra/dim_arrow, extra/dive_flag, extra/fiducial, extra/fish, extra/half-box, extra/half-circle, extra/offbox_ne, extra/offbox_nw, extra/offbox_se, extra/offbox_sw, extra/pentagon, extra/ping, extra/ring, extra/simple_zia, extra/target, geology/circle_cross, geology/half-arrow_left, geology/half-arrow_right, geology/strike_box, geology/strike_circle, geology/strike_cleavage, geology/strike_half-bowtie, geology/strike_line, geology/strike_parallel, geology/strike_triangle, n_arrows/basic_compass, n_arrows/fancy_compass, n_arrows/n_arrow1a, n_arrows/n_arrow1b, n_arrows/n_arrow2, n_arrows/n_arrow3, n_arrows/n_arrow4, n_arrows/n_arrow5, n_arrows/n_arrow6, n_arrows/n_arrow7a, n_arrows/n_arrow7b, n_arrows/n_arrow8a, n_arrows/n_arrow8b, n_arrows/n_arrow9
Default: basic/x
Symbol size
When used with the size_column option this becomes the scale factor
Default: 5
Name of numeric column containing symbol size
Name of numeric column containing symbol rotation angle
Measured in degrees CCW from east
Layer number for labels (default: the given layer number)
Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
Default: 1
Name of column to be displayed as a label
Label color
Either a standard color name or R:G:B triplet
Default: red
Label background color
Either a standard color name, R:G:B triplet, or "none"
Default: none
Label border color
Either a standard color name, R:G:B triplet, or "none"
Default: none
Label size (pixels)
Default: 8
Font name
Text encoding
Label horizontal justification
Options: left, center, right
Default: left
Label vertical justification
Options: top, center, bottom
Default: center
Minimum region size (average from height and width) when map is displayed
Maximum region size (average from height and width) when map is displayed

Table of contents


d.vect displays vector maps in the active frame on the graphics monitor.


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 areas are filled with fill_color and outlined with color. Area outlines can be suppressed with

d.vect map=vector_map color=none
and areas can be made transparent with
d.vect map=vector_map fill_color=none

In order to display attributes in the map, attribute_column must be specified.

Feature colors may be specified by v.colors in a form of color table or in an attribute table column containing RRR:GGG:BBB values.

A table for a vector map might look like this: sql="select * from testisola"
0|no data|255:255:255
139|PERGINE VALSUGANA|223:45:237

To add the GRASSRGB color column, use v.db.addcolumn:

v.db.addcolumn map=testisola columns="GRASSRGB varchar(11)"

To add/change a color, use v.db.update:

v.db.update map=testisola column=GRASSRGB value="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.

Parameter width 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').


Spearfish examples:
# display roads with category numbers:
d.vect map=roads display=shape,cat label_color=green

# display randomly colorized soils map with attributes
d.vect -c map=soils attribute_column=label

# display randomly colorized selected vectors from soils map
d.vect -c map=soils where="label='VBF'" display=shape attribute_column=label

3D points, 3D lines and 3D polygons colorized according to z height:

g.region raster=elevation.10m
r.random input=elevation.10m n=5000 vector=random3d -d
d.mon start=x0
# display as black points
d.vect map=random3d
# display 3D points colorized according to z height
d.vect map=random3d zcolor=gyr

# 3D contour lines
r.contour input=elevation.10m output=contour20m step=20
d.vect map=contour20m zcolor=gyr

# generate 3D triangles
v.delaunay input=random3d output=random3d_del
# display 3D polygons colorized according to z height
d.vect map=random3d_del type=area zcolor=gyr


v.colors, d.erase, d.rast, v.colors, v.db.addcolumn, v.db.update

GRASS SQL interface


Radim Blazek, ITC-Irst, Trento, Italy
Support for color tables by Martin Landa, Czech Technical University in Prague (8/2011)
and many other GRASS developers

Last changed: $Date: 2014-12-19 13:55:37 -0800 (Fri, 19 Dec 2014) $


Available at: d.vect source code (history)

Note: A new GRASS GIS stable version has been released: GRASS GIS 7.4, available here.
Updated manual page: here

Main index | Display index | Topics index | Keywords index | Full index

© 2003-2018 GRASS Development Team, GRASS GIS 7.0.7svn Reference Manual