<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS: d.vect.thematic</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>d.vect.thematic</b></em> - Displays thematic vectormap
<h2>KEYWORDS</h2>
display, legend
<h2>SYNOPSIS</h2>
<b>d.vect.thematic</b><br>
<b>d.vect.thematic help</b><br>
<b>d.vect.thematic</b> [-<b>glfusm</b>] <b>map</b>=<em>string</em> <b>type</b>=<em>string</em> <b>column</b>=<em>string</em> <b>themetype</b>=<em>string</em> <b>themecalc</b>=<em>string</em> [<b>breakpoints</b>=<em>string</em>] [<b>layer</b>=<em>integer</em>] [<b>icon</b>=<em>string</em>] [<b>size</b>=<em>float</em>] [<b>maxsize</b>=<em>float</em>] [<b>nint</b>=<em>integer</em>] <b>colorscheme</b>=<em>string</em> [<b>pointcolor</b>=<em>string</em>] [<b>linecolor</b>=<em>string</em>] [<b>startcolor</b>=<em>string</em>] [<b>endcolor</b>=<em>string</em>] [<b>monitor</b>=<em>string</em>] [<b>where</b>=<em>string</em>] [<b>psmap</b>=<em>string</em>] [<b>group</b>=<em>string</em>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>-g</b></DT>
<DD>Save thematic map commands to group file for GIS Manager</DD>
<DT><b>-l</b></DT>
<DD>Create graphic legend in x11 display monitor</DD>
<DT><b>-f</b></DT>
<DD>Only draw fills (no outlines) for areas and points</DD>
<DT><b>-u</b></DT>
<DD>Update color values to GRASSRGB column in attribute table</DD>
<DT><b>-s</b></DT>
<DD>Output legend for GIS Manager (for scripting use only)</DD>
<DT><b>-m</b></DT>
<DD>Use math notation brackets in legend</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>map</b>=<em>string</em></DT>
<DD>Vector map to display thematically</DD>
<DT><b>type</b>=<em>string</em></DT>
<DD>Vector map type</DD>
<DD>Options: <em>area,point,centroid,line,boundary</em></DD>
<DD>Default: <em>area</em></DD>
<DT><b>column</b>=<em>string</em></DT>
<DD>Attribute column to use for thematic display (must be numeric)</DD>
<DT><b>themetype</b>=<em>string</em></DT>
<DD>Type of thematic display</DD>
<DD>Options: <em>graduated_colors,graduated_points,graduated_lines</em></DD>
<DD>Default: <em>graduated_colors</em></DD>
<DT><b>themecalc</b>=<em>string</em></DT>
<DD>Thematic divisions of data for display</DD>
<DD>Options: <em>interval,std_deviation,quartiles,custom_breaks</em></DD>
<DD>Default: <em>interval</em></DD>
<DT><b>breakpoints</b>=<em>string</em></DT>
<DD>Break points for custom breaks option. Separate values by spaces. (0 10 20 30 ...)</DD>
<DT><b>layer</b>=<em>integer</em></DT>
<DD>Layer to use for thematic display</DD>
<DD>Default: <em>1</em></DD>
<DT><b>icon</b>=<em>string</em></DT>
<DD>Vector point icon for point data</DD>
<DD>Options: <em>basic/box,basic/circle,basic/cross2,basic/diamond,basic/star,basic/cross1,basic/x</em></DD>
<DD>Default: <em>basic/circle</em></DD>
<DT><b>size</b>=<em>float</em></DT>
<DD>Icon size for point data (minimum icon size/line width for graduated points/lines)</DD>
<DD>Default: <em>5</em></DD>
<DT><b>maxsize</b>=<em>float</em></DT>
<DD>Maximum icon size/line width for graduated points and lines</DD>
<DD>Default: <em>20</em></DD>
<DT><b>nint</b>=<em>integer</em></DT>
<DD>Number of classes for interval theme (integer)</DD>
<DD>Default: <em>4</em></DD>
<DT><b>colorscheme</b>=<em>string</em></DT>
<DD>Color scheme for graduated color mapping (select 'single_color' for graduated point/line display)</DD>
<DD>Options: <em>blue-red,red-blue,green-red,red-green,blue-green,green-blue,cyan-yellow,yellow-cyan,custom_gradient,single_color</em></DD>
<DD>Default: <em>blue-red</em></DD>
<DT><b>pointcolor</b>=<em>string</em></DT>
<DD>Color for graduated points map (grass named color or R:G:B triplet). Set color scheme to single color.</DD>
<DD>Default: <em>255:0:0</em></DD>
<DT><b>linecolor</b>=<em>string</em></DT>
<DD>Color for graduated lines or point/area outlines (grass named color or R:G:B triplet). Set color scheme to single color.</DD>
<DD>Default: <em>0:0:0</em></DD>
<DT><b>startcolor</b>=<em>string</em></DT>
<DD>Beginning color for custom color gradient. Must be expressed as R:G:B triplet.</DD>
<DD>Default: <em>255:0:0</em></DD>
<DT><b>endcolor</b>=<em>string</em></DT>
<DD>Ending color for custom color gradient. Must be expressed as R:G:B triplet</DD>
<DD>Default: <em>0:0:255</em></DD>
<DT><b>monitor</b>=<em>string</em></DT>
<DD>Select x11 display monitor for legend</DD>
<DD>Options: <em>x0,x1,x2,x3,x4,x5,x6,none</em></DD>
<DD>Default: <em>x1</em></DD>
<DT><b>where</b>=<em>string</em></DT>
<DD>WHERE conditions of SQL statement without 'where' keyword</DD>
<DT><b>psmap</b>=<em>string</em></DT>
<DD>Root for the name of psmap instruction files to be in current directory (if not set, no psmap instruction files will be created)</DD>
<DT><b>group</b>=<em>string</em></DT>
<DD>Name of group file where thematic map commands will be saved</DD>
</DL>
<h2>DESCRIPTION</h2>
<p><em><b>d.vect.thematic</b></em> - 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. </p>
<p>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. </p>
<p>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.</p>
<p>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 <em><a href="ps.map">ps.map</a></em> man page for more details.</p>
<p><em>(GRASS Shell Script)</em></p>
<h2>ATTENTION</h2>
The algorithm currently uses the script <em><a href="v.univar.sh.html">v.univar.sh</a></em>
to calculate basic descriptive statistics needed for thematic mapping (minimum,
maximum, mean, standard deviation, and quartiles).
<h2>EXAMPLES</h2>
Earthquake points with color gradient:
<div class="code"><pre>
d.vect.thematic -l recent_earthquakes column=magnitude type=point
</pre></div>
<p>
Earthquake points with different sizes:
<div class="code"><pre>
d.vect.thematic -l recent_earthquakes column=magnitude type=point \
themetype=graduated_points maxsize=15
</pre></div>
<p>
Spearfish: differences between 'elevation.10m' and 'elevation.dem':
<div class="code"><pre>
# 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=elev
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
</pre></div>
<h2>SEE ALSO</h2>
<em>
<a href="d.vect.html">d.vect</a>,
<a href="d.vect.chart.html">d.vect.chart</a>,
<a href="v.univar.sh.html">v.univar.sh</a></em>
<h2>AUTHORS</h2>
Michael Barton, Arizona State University, Daniel Cavelo Aros,
Martin Landa, and Jachym Cepicky.
<p><i>Last changed: $Date: 2007-06-02 22:46:58 +0200 (Sat, 02 Jun 2007) $</i></p>
<HR>
<P><a href="index.html">Main index</a> - <a href="display.html">display index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2008 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
