1d.vect.thematic(1) Grass User's Manual d.vect.thematic(1)
2
6 d.vect.thematic - Displays thematic vectormap
7
9 display, legend
10
12 d.vect.thematic
13 d.vect.thematic help
14 d.vect.thematic [-glfusm] map=string type=string column=string theme‐
15 type=string themecalc=string [breakpoints=string] [layer=integer]
16 [icon=string] [size=float] [maxsize=float] [nint=integer] col‐
17 orscheme=string [pointcolor=string] [linecolor=string] [start‐
18 color=string] [endcolor=string] [monitor=string] [where=string]
19 [psmap=string] [group=string] [--verbose] [--quiet]
20 Flags:
22 -g
23 Save thematic map commands to group file for GIS Manager
24 -l
26 Create graphic legend in x11 display monitor
27 -f
29 Only draw fills (no outlines) for areas and points
30 -u
32 Update color values to GRASSRGB column in attribute table
33 -s
35 Output legend for GIS Manager (for scripting use only)
36 -m
38 Use math notation brackets in legend
39 --verbose
41 Verbose module output
42 --quiet
44 Quiet module output
45 Parameters:
47 map=string
48 Vector map to display thematically
49 type=string
51 Vector map type
52 Options: area,point,centroid,line,boundary
53 Default: area
54 column=string
56 Attribute column to use for thematic display (must be numeric)
57 themetype=string
59 Type of thematic display
60 Options: graduated_colors,graduated_points,graduated_lines
61 Default: graduated_colors
62 themecalc=string
64 Thematic divisions of data for display
65 Options: interval,std_deviation,quartiles,custom_breaks
66 Default: interval
67 breakpoints=string
69 Break points for custom breaks option. Separate values by spaces.
70 (0 10 20 30 ...)
71 layer=integer
73 Layer to use for thematic display
74 Default: 1
75 icon=string
77 Vector point icon for point data
78 Options: basic/box,basic/circle,basic/cross2,basic/dia‐
79 mond,basic/star,basic/cross1,basic/x
80 Default: basic/circle
81 size=float
83 Icon size for point data (minimum icon size/line width for gradu‐
84 ated points/lines)
85 Default: 5
86 maxsize=float
88 Maximum icon size/line width for graduated points and lines
89 Default: 20
90 nint=integer
92 Number of classes for interval theme (integer)
93 Default: 4
94 colorscheme=string
96 Color scheme for graduated color mapping (select 'single_color' for
97 graduated point/line display)
98 Options: blue-red,red-blue,green-red,red-green,blue-green,green-
99 blue,cyan-yellow,yellow-cyan,custom_gradient,single_color
100 Default: blue-red
101 pointcolor=string
103 Color for graduated points map (grass named color or R:G:B
104 triplet). Set color scheme to single color.
105 Default: 255:0:0
106 linecolor=string
108 Color for graduated lines or point/area outlines (grass named color
109 or R:G:B triplet). Set color scheme to single color.
110 Default: 0:0:0
111 startcolor=string
113 Beginning color for custom color gradient. Must be expressed as
114 R:G:B triplet.
115 Default: 255:0:0
116 endcolor=string
118 Ending color for custom color gradient. Must be expressed as R:G:B
119 triplet
120 Default: 0:0:255
121 monitor=string
123 Select x11 display monitor for legend
124 Options: x0,x1,x2,x3,x4,x5,x6,none
125 Default: x1
126 where=string
128 WHERE conditions of SQL statement without 'where' keyword
129 psmap=string
131 Root for the name of psmap instruction files to be in current
132 directory (if not set, no psmap instruction files will be created)
133 group=string
135 Name of group file where thematic map commands will be saved
136
138 d.vect.thematic - Creates thematic maps from vectors of all types and
139 numeric attributes (stored in the data table connected to a vector
140 map). Thematic maps can be displayed by either a graduated color scheme
141 (for all vector types), as graduated icon sizes (for point and centroid
142 types), or graduated line widths (for lines and boundaries with associ‐
143 ated attributes). The user selects the vector map to be mapped and
144 attribute column from which to derive mapping intervals, and (option‐
145 ally) the layer for attribute data.
146 In thematic maps, the color or point size changes for each range of
148 attribute values. Value ranges for thematic mapping can be set at regu‐
149 lar intervals, standard deviation units on either side of the mean,
150 quartiles, or delimited by user-defined breakpoints. User-defined
151 breakpoints also can be entered, or piped into d.vect.thematic from
152 standard input or other external source.
153 There are options to define the color scheme (graduated colors) and
155 range of point sizes (graduated points) for thematic maps. A simple
156 text legend is printed. Optionally, a graphic legend can be drawn in
157 the selected display monitor. Thematic colors can be uploaded to a
158 GRASSRGB column for later display, and thematic map display commands
159 can be saved to a group file (*.dm) that can be opened, edited, and
160 displayed in the GIS Manager.
161 When the psmap option is set to 'name', two psmap instruction files are
163 created (in the current directory if no path is given), one for the map
164 ('name.psmap') and one for the legend ('name_legend.psmap'). The map
165 file also contains 'label' commands which allow to create a legend
166 directly in the map by adding a 'vlegend' command. See the ps.map man
167 page for more details.
168 (GRASS Shell Script)
170
172 The algorithm currently uses the script v.univar.sh to calculate basic
173 descriptive statistics needed for thematic mapping (minimum, maximum,
174 mean, standard deviation, and quartiles).
175
177 Earthquake points with color gradient:
178 d.vect.thematic -l recent_earthquakes column=magnitude type=point
179 Earthquake points with different sizes:
182 d.vect.thematic -l recent_earthquakes column=magnitude type=point \
183 themetype=graduated_points maxsize=15
184 Spearfish: differences between 'elevation.10m' and 'elevation.dem':
187 # random sampling of elevation points:
188 g.region rast=elevation.10m -p
189 v.random random n=200
190 v.db.addtable random col="el10 double precision"
191 # transfer elevations to attribute table of random points map:
192 v.what.rast random rast=elevation.10m col=elev
193 v.db.select random
194 # comparative sampling of second map, incl. differences:
195 v.sample in=random col=el10 rast=elevation.dem out=elev_sample
196 v.db.select elev_sample
197 # thematic map:
198 d.mon x0
199 d.vect.thematic -l elev_sample column=diff type=point
200
203 d.vect, d.vect.chart, v.univar.sh
204
206 Michael Barton, Arizona State University, Daniel Cavelo Aros, Martin
207 Landa, and Jachym Cepicky.
208 Last changed: $Date: 2007-06-02 22:46:58 +0200 (Sat, 02 Jun 2007) $
210 Full index
212 © 2003-2008 GRASS Development Team
214GRASS 6.3.0 d.vect.thematic(1)