1d.vect.thematic(1)          GRASS GIS 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, ba‐
97           sic/box,  basic/circle,  basic/cross1,  basic/cross2, basic/cross3,
98           basic/diamond,  basic/hexagon,  basic/marker,  basic/octagon,   ba‐
99           sic/pin, basic/pin_dot, basic/point, basic/pushpin, basic/star, ba‐
100           sic/triangle, basic/x, demo/muchomurka, demo/smrk,  extra/4pt_star,
101           extra/adcp,   extra/airport,  extra/alpha_flag,  extra/bridge,  ex‐
102           tra/dim_arrow,  extra/dive_flag,  extra/fiducial,  extra/fish,  ex‐
103           tra/half-box,  extra/half-circle, extra/offbox_ne, extra/offbox_nw,
104           extra/offbox_se, extra/offbox_sw, extra/pentagon,  extra/ping,  ex‐
105           tra/ring, extra/simple_zia, extra/target, geology/circle_cross, ge‐
106           ology/half-arrow_left,       geology/half-arrow_right,        geol‐
107           ogy/strike_box, geology/strike_circle, geology/strike_cleavage, ge‐
108           ology/strike_half-bowtie, geology/strike_line,  geology/strike_par‐
109           allel,  geology/strike_triangle,  legend/area,  legend/area_curved,
110           legend/line,  legend/line_crooked,  n_arrows/basic_compass,   n_ar‐
111           rows/fancy_compass,  n_arrows/n_arrow1a,  n_arrows/n_arrow1b, n_ar‐
112           rows/n_arrow2, n_arrows/n_arrow3, n_arrows/n_arrow4, n_arrows/n_ar‐
113           row5,  n_arrows/n_arrow6,  n_arrows/n_arrow7a,  n_arrows/n_arrow7b,
114           n_arrows/n_arrow8a, n_arrows/n_arrow8b, n_arrows/n_arrow9
115           Default: basic/x
116
117       size=float
118           Symbol size
119           Default: 5
120
121       icon_line=string
122           Legend symbol for lines
123           Options: basic/arrow, basic/arrow1, basic/arrow2, basic/arrow3, ba‐
124           sic/box,  basic/circle,  basic/cross1,  basic/cross2, basic/cross3,
125           basic/diamond,  basic/hexagon,  basic/marker,  basic/octagon,   ba‐
126           sic/pin, basic/pin_dot, basic/point, basic/pushpin, basic/star, ba‐
127           sic/triangle, basic/x, demo/muchomurka, demo/smrk,  extra/4pt_star,
128           extra/adcp,   extra/airport,  extra/alpha_flag,  extra/bridge,  ex‐
129           tra/dim_arrow,  extra/dive_flag,  extra/fiducial,  extra/fish,  ex‐
130           tra/half-box,  extra/half-circle, extra/offbox_ne, extra/offbox_nw,
131           extra/offbox_se, extra/offbox_sw, extra/pentagon,  extra/ping,  ex‐
132           tra/ring, extra/simple_zia, extra/target, geology/circle_cross, ge‐
133           ology/half-arrow_left,       geology/half-arrow_right,        geol‐
134           ogy/strike_box, geology/strike_circle, geology/strike_cleavage, ge‐
135           ology/strike_half-bowtie, geology/strike_line,  geology/strike_par‐
136           allel,  geology/strike_triangle,  legend/area,  legend/area_curved,
137           legend/line,  legend/line_crooked,  n_arrows/basic_compass,   n_ar‐
138           rows/fancy_compass,  n_arrows/n_arrow1a,  n_arrows/n_arrow1b, n_ar‐
139           rows/n_arrow2, n_arrows/n_arrow3, n_arrows/n_arrow4, n_arrows/n_ar‐
140           row5,  n_arrows/n_arrow6,  n_arrows/n_arrow7a,  n_arrows/n_arrow7b,
141           n_arrows/n_arrow8a, n_arrows/n_arrow8b, n_arrows/n_arrow9
142           Default: legend/line
143
144       icon_area=string
145           Legend symbol for areas
146           Options: basic/arrow, basic/arrow1, basic/arrow2, basic/arrow3, ba‐
147           sic/box,  basic/circle,  basic/cross1,  basic/cross2, basic/cross3,
148           basic/diamond,  basic/hexagon,  basic/marker,  basic/octagon,   ba‐
149           sic/pin, basic/pin_dot, basic/point, basic/pushpin, basic/star, ba‐
150           sic/triangle, basic/x, demo/muchomurka, demo/smrk,  extra/4pt_star,
151           extra/adcp,   extra/airport,  extra/alpha_flag,  extra/bridge,  ex‐
152           tra/dim_arrow,  extra/dive_flag,  extra/fiducial,  extra/fish,  ex‐
153           tra/half-box,  extra/half-circle, extra/offbox_ne, extra/offbox_nw,
154           extra/offbox_se, extra/offbox_sw, extra/pentagon,  extra/ping,  ex‐
155           tra/ring, extra/simple_zia, extra/target, geology/circle_cross, ge‐
156           ology/half-arrow_left,       geology/half-arrow_right,        geol‐
157           ogy/strike_box, geology/strike_circle, geology/strike_cleavage, ge‐
158           ology/strike_half-bowtie, geology/strike_line,  geology/strike_par‐
159           allel,  geology/strike_triangle,  legend/area,  legend/area_curved,
160           legend/line,  legend/line_crooked,  n_arrows/basic_compass,   n_ar‐
161           rows/fancy_compass,  n_arrows/n_arrow1a,  n_arrows/n_arrow1b, n_ar‐
162           rows/n_arrow2, n_arrows/n_arrow3, n_arrows/n_arrow4, n_arrows/n_ar‐
163           row5,  n_arrows/n_arrow6,  n_arrows/n_arrow7a,  n_arrows/n_arrow7b,
164           n_arrows/n_arrow8a, n_arrows/n_arrow8b, n_arrows/n_arrow9
165           Default: legend/area
166
167       legend_title=string
168           Thematic map title
169
170       legendfile=name
171           [DEPRECATED] Output legend file
172

DESCRIPTION

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

NOTES

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

EXAMPLES

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

SEE ALSO

234        v.class, d.legend.vect, d.vect, d.graph, v.univar
235
236       Check also Python module from AddOns: d.vect.thematic2
237

AUTHOR

239       Moritz Lennert
240

SOURCE CODE

242       Available at: d.vect.thematic source code (history)
243
244       Accessed: Saturday Jan 21 21:14:16 2023
245
246       Main index | Display index | Topics index | Keywords index |  Graphical
247       index | Full index
248
249       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
250
251
252
253GRASS 8.2.1                                                 d.vect.thematic(1)
Impressum