1d.vect.thematic(1) GRASS GIS 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, 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 size=float
118 Symbol size
119 Default: 5
120 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 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 legend_title=string
168 Thematic map title
169 legendfile=name
171 [DEPRECATED] Output legend file
172
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 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
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 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
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 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 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
234 v.class, d.legend.vect, d.vect, d.graph, v.univar
235 Check also Python module from AddOns: d.vect.thematic2
237
239 Moritz Lennert
240
242 Available at: d.vect.thematic source code (history)
243 Accessed: Saturday Jan 21 21:14:16 2023
245 Main index | Display index | Topics index | Keywords index | Graphical
247 index | Full index
248 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
250GRASS 8.2.1 d.vect.thematic(1)