Provided by: grass-doc_6.4.3-3_all 
NAME
d.vect.thematic - Displays thematic vector map
KEYWORDS
display, vector, thematic, legend
SYNOPSIS
d.vect.thematic
d.vect.thematic help
d.vect.thematic [-glfusm] map=string type=string column=string themetype=string
themecalc=string [breakpoints=string] [layer=integer] [icon=string] [size=float]
[maxsize=float] [nint=integer] colorscheme=string [pointcolor=string]
[linecolor=string] [startcolor=string] [endcolor=string] [monitor=string]
[where=string] [psmap=string] [group=string] [--verbose] [--quiet]
Flags:
-g
Save thematic map commands to group file for GIS Manager
-l
Create graphic legend in x11 display monitor
-f
Only draw fills (no outlines) for areas and points
-u
Update color values to GRASSRGB column in attribute table
-s
Output legend for GIS Manager (for scripting use only)
-m
Use math notation brackets in legend
--verbose
Verbose module output
--quiet
Quiet module output
Parameters:
map=string
Name of vector map
type=string
Feature type
Options: area,point,centroid,line,boundary
Default: area
column=string
Name of attribute column to use for thematic display (must be numeric)
themetype=string
Type of thematic display
Options: graduated_colors,graduated_points,graduated_lines
Default: graduated_colors
themecalc=string
Thematic divisions of data for display
Options: interval,std_deviation,quartiles,custom_breaks
Default: interval
breakpoints=string
Break points for custom breaks option
Separate values by spaces (0 10 20 30 ...)
layer=integer
Layer number
Default: 1
icon=string
Vector point icon for point data
Options:
basic/box,basic/circle,basic/cross2,basic/diamond,basic/star,basic/cross1,basic/x
Default: basic/circle
size=float
Icon size for point data
Minimum icon size/line width for graduated points/lines)
Default: 5
maxsize=float
Maximum icon size/line width for graduated points and lines
Default: 20
nint=integer
Number of classes for interval theme (integer)
Default: 4
colorscheme=string
Color scheme for graduated color mapping
Select 'single_color' for graduated point/line display
Options: blue-red,red-blue,green-red,red-green,blue-green,green-blue,cyan-
yellow,yellow-cyan,custom_gradient,single_color
Default: blue-red
pointcolor=string
Color for graduated points map
GRASS named color or R:G:B triplet. Set color scheme to single color
Default: 255:0:0
linecolor=string
Color for graduated lines or point/area outlines
GRASS named color or R:G:B triplet. Set color scheme to single color.
Default: 0:0:0
startcolor=string
Beginning color for custom color gradient
Must be expressed as R:G:B triplet
Default: 255:0:0
endcolor=string
Ending color for custom color gradient
Must be expressed as R:G:B triplet
Default: 0:0:255
monitor=string
Select x11 display monitor for legend
Options: x0,x1,x2,x3,x4,x5,x6,none
Default: x1
where=string
WHERE conditions of SQL statement without 'where' keyword
psmap=string
Root for the name of psmap instruction files to be in current directory
If not set, no psmap instruction files will be created)
group=string
Name of group file where thematic map commands will be saved
DESCRIPTION
d.vect.thematic creates thematic maps from vectors of all types and numeric attributes
(stored in the data table connected to a vector map). Thematic maps can be displayed by
either a graduated color scheme (for all vector types), as graduated icon sizes (for point
and centroid types), or graduated line widths (for lines and boundaries with associated
attributes). The user selects the vector map to be mapped and attribute column from which
to derive mapping intervals, and (optionally) the layer for attribute data.
In thematic maps, the color or point size changes for each range of attribute values.
Value ranges for thematic mapping can be set at regular intervals, standard deviation
units on either side of the mean, quartiles, or delimited by user-defined breakpoints.
User-defined breakpoints also can be entered, or piped into d.vect.thematic from standard
input or other external source.
There are options to define the color scheme (graduated colors) and range of point sizes
(graduated points) for thematic maps. A simple text legend is printed. Optionally, a
graphic legend can be drawn in the selected display monitor. Thematic colors can be
uploaded to a GRASSRGB column for later display, and thematic map display commands can be
saved to a group file (*.dm) that can be opened, edited, and displayed in the GIS Manager.
When the psmap option is set to 'name', two psmap instruction files are created (in the
current directory if no path is given), one for the map ('name.psmap') and one for the
legend ('name_legend.psmap'). The map file also contains 'label' commands which allow to
create a legend directly in the map by adding a 'vlegend' command. See the ps.map man page
for more details.
NOTES
The algorithm currently uses the v.univar.sh to calculate basic descriptive statistics
needed for thematic mapping (minimum, maximum, mean, standard deviation, and quartiles).
EXAMPLES
Earthquake points with color gradient:
d.vect.thematic -l recent_earthquakes column=magnitude type=point
Earthquake points with different sizes:
d.vect.thematic -l recent_earthquakes column=magnitude type=point \
themetype=graduated_points maxsize=15
Spearfish: differences between 'elevation.10m' and 'elevation.dem':
# random sampling of elevation points:
g.region rast=elevation.10m -p
v.random random n=200
v.db.addtable random col="el10 double precision"
# transfer elevations to attribute table of random points map:
v.what.rast random rast=elevation.10m col=el10
v.db.select random
# comparative sampling of second map, incl. differences:
v.sample in=random col=el10 rast=elevation.dem out=elev_sample
v.db.select elev_sample
# thematic map:
d.mon x0
d.vect.thematic -l elev_sample column=diff type=point
North Carolina data set example:
g.region vect=nc_state
d.vect.thematic -l precip_30ynormals column=annual type=point
SEE ALSO
d.vect, d.vect.chart, v.univar.sh
AUTHORS
Michael Barton, Arizona State University, Daniel Cavelo Aros, Martin Landa, and Jachym
Cepicky.
Last changed: $Date: 2008-08-15 08:16:42 +0200 (Fri, 15 Aug 2008)$
Full index
© 2003-2013 GRASS Development Team