1d.vect.thematic(1)            Grass User's Manual           d.vect.thematic(1)
2
3
4

NAME

6       d.vect.thematic   - Displays a thematic vector map in the active graph‐
7       ics frame.
8

KEYWORDS

10       display, cartography, choropleth map, legend
11

SYNOPSIS

13       d.vect.thematic
14       d.vect.thematic --help
15       d.vect.thematic   [-lnes]   map=name     [layer=string]     column=name
16       [breaks=string[,string,...]]    [algorithm=string]   [nclasses=integer]
17       colors=string[,string,...]   [where=sql_query]    [boundary_width=inte‐
18       ger]       [boundary_color=name]       [icon=string]       [size=float]
19       [icon_line=string]   [icon_area=string]   [legend_title=string]   [leg‐
20       endfile=name]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]
21
22   Flags:
23       -l
24           Create legend information and send to stdout
25
26       -n
27           Do not draw map, only output the legend information
28
29       -e
30           [DEPRECATED]  When printing legend info, include extended statisti‐
31           cal info from classification algorithm
32
33       -s
34           Do not show this layer in vector legend
35
36       --overwrite
37           Allow output files to overwrite existing files
38
39       --help
40           Print usage summary
41
42       --verbose
43           Verbose module output
44
45       --quiet
46           Quiet module output
47
48       --ui
49           Force launching GUI dialog
50
51   Parameters:
52       map=name [required]
53           Name of vector map
54           Or data source for direct OGR access
55
56       layer=string
57           Layer number or name
58           Layer number. If -1, all layers are displayed.
59           Default: 1
60
61       column=name [required]
62           Name of attribute column to be classified
63
64       breaks=string[,string,...]
65           Class breaks, without minimum and maximum
66
67       algorithm=string
68           Algorithm to use for classification
69           Options: int, std, qua, equ, dis
70           int: simple intervals
71           std: standard deviations
72           qua: quantiles
73           equ: equiprobable (normal distribution)
74
75       nclasses=integer
76           Number of classes to define
77
78       colors=string[,string,...] [required]
79           Colors (one per class)
80
81       where=sql_query
82           WHERE conditions of SQL statement without ’where’ keyword
83           Example: income < 1000 and population >= 10000
84
85       boundary_width=integer
86           Boundary width
87           Default: 1
88
89       boundary_color=name
90           Boundary color
91           Either a standard color name, R:G:B triplet, or "none"
92           Default: black
93
94       icon=string
95           Point and centroid symbol
96           Options:  basic/arrow,  basic/arrow1,  basic/arrow2,  basic/arrow3,
97           basic/box,  basic/circle, basic/cross1, basic/cross2, basic/cross3,
98           basic/diamond,    basic/hexagon,    basic/marker,    basic/octagon,
99           basic/pin,  basic/pin_dot,  basic/point, basic/pushpin, basic/star,
100           basic/triangle,      basic/x,      demo/muchomurka,      demo/smrk,
101           extra/4pt_star,    extra/adcp,   extra/airport,   extra/alpha_flag,
102           extra/bridge,  extra/dim_arrow,  extra/dive_flag,   extra/fiducial,
103           extra/fish,   extra/half-box,  extra/half-circle,  extra/offbox_ne,
104           extra/offbox_nw, extra/offbox_se, extra/offbox_sw,  extra/pentagon,
105           extra/ping,   extra/ring,   extra/simple_zia,  extra/target,  geol‐
106           ogy/circle_cross,          geology/half-arrow_left,           geol‐
107           ogy/half-arrow_right,   geology/strike_box,  geology/strike_circle,
108           geology/strike_cleavage,     geology/strike_half-bowtie,      geol‐
109           ogy/strike_line,  geology/strike_parallel, geology/strike_triangle,
110           legend/area, legend/area_curved, legend/line,  legend/line_crooked,
111           n_arrows/basic_compass, n_arrows/fancy_compass, n_arrows/n_arrow1a,
112           n_arrows/n_arrow1b,      n_arrows/n_arrow2,      n_arrows/n_arrow3,
113           n_arrows/n_arrow4,       n_arrows/n_arrow5,      n_arrows/n_arrow6,
114           n_arrows/n_arrow7a,     n_arrows/n_arrow7b,     n_arrows/n_arrow8a,
115           n_arrows/n_arrow8b, n_arrows/n_arrow9
116           Default: basic/x
117
118       size=float
119           Symbol size
120           Default: 5
121
122       icon_line=string
123           Legend symbol for lines
124           Options:  basic/arrow,  basic/arrow1,  basic/arrow2,  basic/arrow3,
125           basic/box, basic/circle, basic/cross1, basic/cross2,  basic/cross3,
126           basic/diamond,    basic/hexagon,    basic/marker,    basic/octagon,
127           basic/pin, basic/pin_dot, basic/point,  basic/pushpin,  basic/star,
128           basic/triangle,      basic/x,      demo/muchomurka,      demo/smrk,
129           extra/4pt_star,   extra/adcp,   extra/airport,    extra/alpha_flag,
130           extra/bridge,   extra/dim_arrow,  extra/dive_flag,  extra/fiducial,
131           extra/fish,  extra/half-box,  extra/half-circle,   extra/offbox_ne,
132           extra/offbox_nw,  extra/offbox_se, extra/offbox_sw, extra/pentagon,
133           extra/ping,  extra/ring,  extra/simple_zia,   extra/target,   geol‐
134           ogy/circle_cross,           geology/half-arrow_left,          geol‐
135           ogy/half-arrow_right,  geology/strike_box,   geology/strike_circle,
136           geology/strike_cleavage,      geology/strike_half-bowtie,     geol‐
137           ogy/strike_line, geology/strike_parallel,  geology/strike_triangle,
138           legend/area,  legend/area_curved, legend/line, legend/line_crooked,
139           n_arrows/basic_compass, n_arrows/fancy_compass, n_arrows/n_arrow1a,
140           n_arrows/n_arrow1b,      n_arrows/n_arrow2,      n_arrows/n_arrow3,
141           n_arrows/n_arrow4,      n_arrows/n_arrow5,       n_arrows/n_arrow6,
142           n_arrows/n_arrow7a,     n_arrows/n_arrow7b,     n_arrows/n_arrow8a,
143           n_arrows/n_arrow8b, n_arrows/n_arrow9
144           Default: legend/line
145
146       icon_area=string
147           Legend symbol for areas
148           Options:  basic/arrow,  basic/arrow1,  basic/arrow2,  basic/arrow3,
149           basic/box,  basic/circle, basic/cross1, basic/cross2, basic/cross3,
150           basic/diamond,    basic/hexagon,    basic/marker,    basic/octagon,
151           basic/pin,  basic/pin_dot,  basic/point, basic/pushpin, basic/star,
152           basic/triangle,      basic/x,      demo/muchomurka,      demo/smrk,
153           extra/4pt_star,    extra/adcp,   extra/airport,   extra/alpha_flag,
154           extra/bridge,  extra/dim_arrow,  extra/dive_flag,   extra/fiducial,
155           extra/fish,   extra/half-box,  extra/half-circle,  extra/offbox_ne,
156           extra/offbox_nw, extra/offbox_se, extra/offbox_sw,  extra/pentagon,
157           extra/ping,   extra/ring,   extra/simple_zia,  extra/target,  geol‐
158           ogy/circle_cross,          geology/half-arrow_left,           geol‐
159           ogy/half-arrow_right,   geology/strike_box,  geology/strike_circle,
160           geology/strike_cleavage,     geology/strike_half-bowtie,      geol‐
161           ogy/strike_line,  geology/strike_parallel, geology/strike_triangle,
162           legend/area, legend/area_curved, legend/line,  legend/line_crooked,
163           n_arrows/basic_compass, n_arrows/fancy_compass, n_arrows/n_arrow1a,
164           n_arrows/n_arrow1b,      n_arrows/n_arrow2,      n_arrows/n_arrow3,
165           n_arrows/n_arrow4,       n_arrows/n_arrow5,      n_arrows/n_arrow6,
166           n_arrows/n_arrow7a,     n_arrows/n_arrow7b,     n_arrows/n_arrow8a,
167           n_arrows/n_arrow8b, n_arrows/n_arrow9
168           Default: legend/area
169
170       legend_title=string
171           Thematic map title
172
173       legendfile=name
174           [DEPRECATED] Output legend file
175

DESCRIPTION

177       d.vect.thematic  draws  thematic  choropleth  vector  maps  based on an
178       attribute column or an expression involving several columns.  It  takes
179       a list of class breaks (excluding the minimum and maximum values) and a
180       list of colors to apply to the classes (has to be the number  of  class
181       breaks + 1).
182
183       Instead  of a list of class breaks, the user can also chose a classifi‐
184       cation algorithm and a number of classes (nbclasses). See  the  v.class
185       for more information on these different algorithms.
186

NOTES

188       The  -l flag instructs the module to print legend information in vector
189       legend format as described in d.legend.vect to standard output for fur‐
190       ther  use  in graphical software.  When combined with the verbose flag,
191       the legend information will be extended with some additional  statisti‐
192       cal  information. If the -n flag is set, the module will only print the
193       legend information without drawing the map.
194
195       Option legendfile, is deprecated,  instead  use  the  GRASS_LEGEND_FILE
196       environmental  variable (see d.legend.vect) to save legend into a file.
197       Flag -e is deprecated, instead use verbose flag.
198

EXAMPLES

200   Thematic map with classes
201       d.vect.thematic -l map=communes3 column=pop \
202         breaks=111393.250000,222785.500000,334177.750000 \
203         colors="255:0:0,0:255:0,0:0:255,0,0,0"
204
205   Thematic map with calculated class breaks
206       The following example uses a calculated attribute (density =  pop/area)
207       and  the  standard  deviation algorithm to calculate class breaks for 5
208       classes:
209       d.vect.thematic -l map=communes2 column=pop/area algorithm=std \
210         nbclasses=5 colors="0:0:255,50:100:255,255:100:50,255:0:0,156:0:0"
211
212   Thematic map with legend
213       Example for the North Carolina sample dataset, colorizing  basin  poly‐
214       gons by average elevation and displaying school capacity:
215       # create watersheds from elevation map
216       g.region raster=elevation
217       r.watershed elevation=elevation threshold=10000 basin=basins_10k
218       # convert raster to vector
219       r.to.vect input=basins_10k output=basins_10k type=area column=basin_num
220       # upload raster statistics to each polygon in vector map
221       v.rast.stats map=basins_10k raster=elevation column_prefix=elev
222       # open a graphical display
223       d.mon wx0
224       # draw thematic polygons and specify legend title
225       d.vect.thematic map=basins_10k column=elev_average algorithm=int \
226         nclasses=5 colors=0:195:176,39:255:0,251:253:0,242:127:11,193:126:60 \
227         legend_title="Average elevation (m)"
228       # draw thematic points and specify legend title
229       d.vect.thematic map=schools_wake@PERMANENT column=CORECAPACI algorithm=std \
230         nclasses=3 colors=149:203:255,45:143:240,0:81:161 icon=basic/circle size=15 \
231         legend_title="School capacity"
232       # and finally draw legend
233       d.legend.vect -b at=2,80 font=Sans symbol_size=25
234       Thematic map of average elevation and school capacity
235

SEE ALSO

237        v.class, d.legend.vect, d.vect, d.graph, v.univar
238
239       Check also Python module from AddOns: d.vect.thematic2
240

AUTHOR

242       Moritz Lennert
243
244       Last changed: $Date: 2017-11-11 19:59:24 +0100 (Sat, 11 Nov 2017) $
245

SOURCE CODE

247       Available at: d.vect.thematic source code (history)
248
249       Main  index | Display index | Topics index | Keywords index | Graphical
250       index | Full index
251
252       © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
253
254
255
256GRASS 7.4.4                                                 d.vect.thematic(1)
Impressum