.TH d.thematic.area 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBd.thematic.area\fR\fR  - Displays a thematic vector area map in the active frame on the graphics monitor.
.SH KEYWORDS
display, cartography
.SH SYNOPSIS
\fBd.thematic.area\fR
.br
\fBd.thematic.area help\fR
.br
\fBd.thematic.area\fR [\-\fBlen\fR] \fBmap\fR=\fIname\fR \fBcolumn\fR=\fIstring\fR  [\fBbreaks\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBalgorithm\fR=\fIstring\fR]   [\fBnbclasses\fR=\fIinteger\fR]  \fBcolors\fR=\fIstring\fR[,\fIstring\fR,...]  [\fBlayer\fR=\fIinteger\fR]   [\fBwhere\fR=\fIsql_query\fR]   [\fBbwidth\fR=\fIinteger\fR]   [\fBbcolor\fR=\fIstring\fR]   [\fBrender\fR=\fIstring\fR]   [\fBlegendfile\fR=\fIname\fR]   [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-l\fR" 4m
.br
Create legend information and send to stdout
.IP "\fB\-e\fR" 4m
.br
When printing legend info , include extended statistical info from classification algorithm
.IP "\fB\-n\fR" 4m
.br
Do not draw map, only output the legend
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBmap\fR=\fIname\fR" 4m
.br
Name of input vector map
.IP "\fBcolumn\fR=\fIstring\fR" 4m
.br
Data to be classified: column name or expression
.IP "\fBbreaks\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Class breaks, without minimum and maximum
.IP "\fBalgorithm\fR=\fIstring\fR" 4m
.br
Algorithm to use for classification
.br
Options: \fIint,std,qua,equ,dis\fR
.br
\fBint\fR: simple intervals
.br
\fBstd\fR: standard deviations
.br
\fBqua\fR: quantiles
.br
\fBequ\fR: equiprobable (normal distribution)
.IP "\fBnbclasses\fR=\fIinteger\fR" 4m
.br
Number of classes to define
.IP "\fBcolors\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Colors (one per class).
.IP "\fBlayer\fR=\fIinteger\fR" 4m
.br
Layer number
.br
Layer number. If -1, all layers are displayed.
.br
Default: \fI1\fR
.IP "\fBwhere\fR=\fIsql_query\fR" 4m
.br
WHERE conditions of SQL statement without 'where' keyword
.br
Example: income = 10000
.IP "\fBbwidth\fR=\fIinteger\fR" 4m
.br
Boundary width
.br
Default: \fI0\fR
.IP "\fBbcolor\fR=\fIstring\fR" 4m
.br
Boundary color
.br
Default: \fIblack\fR
.IP "\fBrender\fR=\fIstring\fR" 4m
.br
Rendering method for filled polygons
.br
Options: \fId,c,l\fR
.br
Default: \fIl\fR
.br
\fBd\fR: use the display library basic functions (features: polylines)
.br
\fBc\fR: use the display library clipping functions (features: clipping)
.br
\fBl\fR: use the display library culling functions (features: culling, polylines)
.IP "\fBlegendfile\fR=\fIname\fR" 4m
.br
File in which to save d.graph instructions for legend display
.PP
.SH DESCRIPTION
\fId.thematic.area\fR draws thematic coropleth vector maps based on an attribute column or an expression involving several columns. It takes a number of class breaks (excluding the minimum and maximum values) and a list of colors to apply to the classes (has to be the number of class breaks + 1).
The \fI-l\fR flag instructs the module to print legend information (class min | class max | number of observations in class | color) to standard output for futher use in graphical software. When given this flag with the \fI-n\fR flag, the module will only print the legend information without drawing the map.
One can used \fIv.class\fR to supply class breaks for d.thematic.area (see example below);
.SH EXAMPLE
\fC
.DS
.br
d.thematic.area \-l map=communes3 data=pop breaks=111393.250000,222785.500000,334177.750000 colors=255:0:0,0:255:0,0:0:255,0,0,0
.br
.DE
\fR
The following example uses a calculated attribute (density = pop/area) and v.class to calculate class breaks and feed them directly into d.thematic.area:
\fC
.DS
.br
d.thematic.area \-l map=communes2 data=pop/area breaks=\(gav.class \-g map=communes2 column=pop/area algo=std nbcla=5\(ga colors=0:0:255,50:100:255,255:100:50,255:0:0,156:0:0
.br
.DE
\fR
.SH SEE ALSO
\fIv.class\fR
\fId.vect\fR
\fIv.univar\fR
.SH AUTHOR
Moritz Lennert
.PP
Full index
.PP
© 2003-2014 GRASS Development Team