1d.vect.thematic(1) Grass User's Manual d.vect.thematic(1)
2
6 d.vect.thematic - Displays a thematic vector map in the active graph‐
7 ics frame.
8
10 display, cartography, choropleth map, legend
11
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 Flags:
23 -l
24 Create legend information and send to stdout
25 -n
27 Do not draw map, only output the legend information
28 -e
30 [DEPRECATED] When printing legend info, include extended statisti‐
31 cal info from classification algorithm
32 -s
34 Do not show this layer in vector legend
35 --overwrite
37 Allow output files to overwrite existing files
38 --help
40 Print usage summary
41 --verbose
43 Verbose module output
44 --quiet
46 Quiet module output
47 --ui
49 Force launching GUI dialog
50 Parameters:
52 map=name [required]
53 Name of vector map
54 Or data source for direct OGR access
55 layer=string
57 Layer number or name
58 Layer number. If -1, all layers are displayed.
59 Default: 1
60 column=name [required]
62 Name of attribute column to be classified
63 breaks=string[,string,...]
65 Class breaks, without minimum and maximum
66 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 nclasses=integer
76 Number of classes to define
77 colors=string[,string,...] [required]
79 Colors (one per class)
80 where=sql_query
82 WHERE conditions of SQL statement without ’where’ keyword
83 Example: income < 1000 and population >= 10000
84 boundary_width=integer
86 Boundary width
87 Default: 1
88 boundary_color=name
90 Boundary color
91 Either a standard color name, R:G:B triplet, or "none"
92 Default: black
93 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 size=float
119 Symbol size
120 Default: 5
121 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 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 legend_title=string
171 Thematic map title
172 legendfile=name
174 [DEPRECATED] Output legend file
175
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 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
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 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
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 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 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
237 v.class, d.legend.vect, d.vect, d.graph, v.univar
238 Check also Python module from AddOns: d.vect.thematic2
240
242 Moritz Lennert
243 Last changed: $Date: 2017-11-11 19:59:24 +0100 (Sat, 11 Nov 2017) $
245
247 Available at: d.vect.thematic source code (history)
248 Main index | Display index | Topics index | Keywords index | Graphical
250 index | Full index
251 © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
253GRASS 7.6.0 d.vect.thematic(1)