1d.vect.thematic(1) Grass User's Manual d.vect.thematic(1)
2
3
4
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 [-fulsmg] 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] [group=string]
19 [where=string] [psmap=string]
20
21 Flags:
22 -f Only draw fills (no outlines) for areas and points
23
24 -u Update color values to GRASSRGB column in attribute table
25
26 -l Create graphic legend in x11 display monitor
27
28 -s Use with GIS Manager (special legend and display output)
29
30 -m Use math notation brackets in legend
31
32 -g Save thematic map commands to group file for GIS Manager
33
34 Parameters:
35 map=string
36 Vector map to display thematically
37
38 type=string
39 Vector map type Options: area,point,centroid,line,boundary Default:
40 area
41
42 column=string
43 Attribute column to use for thematic display (must be numeric)
44
45 themetype=string
46 Type of thematic display Options: graduated_colors,gradu‐
47 ated_points,graduated_lines Default: graduated_colors
48
49 themecalc=string
50 Thematic divisions of data for display Options: interval,std_devia‐
51 tion,quartiles,custom_breaks Default: interval
52
53 breakpoints=string
54 Break points for custom breaks option. Separate values by spaces.
55 (0 10 20 30 ...)
56
57 layer=integer
58 Layer to use for thematic display Default: 1
59
60 icon=string
61 Vector point icon for point data Options: basic/box,basic/cir‐
62 cle,basic/cross2,basic/diamond,basic/star,basic/cross1,basic/x
63 Default: basic/circle
64
65 size=float
66 Icon size for point data (minimum icon size/line width for gradu‐
67 ated points/lines) Default: 5
68
69 maxsize=float
70 Maximum icon size/line width for graduated points and lines
71 Default: 20
72
73 nint=integer
74 Number of classes for interval theme (integer) Default: 4
75
76 colorscheme=string
77 Color scheme for graduated color mapping (select 'single_color' for
78 graduated point/line display) Options: blue-red,red-blue,green-
79 red,red-green,blue-green,green-blue,cyan-yellow,yellow-cyan,cus‐
80 tom_gradient,single_color Default: blue-red
81
82 pointcolor=string
83 Color for graduated points map (grass named color or R:G:B
84 triplet). Set color scheme to single color. Default: 255:0:0
85
86 linecolor=string
87 Color for graduated lines or point/area outlines (grass named color
88 or R:G:B triplet). Set color scheme to single color. Default:
89 0:0:0
90
91 startcolor=string
92 Beginning color for custom color gradient. Must be expressed as
93 R:G:B triplet. Default: 255:0:0
94
95 endcolor=string
96 Ending color for custom color gradient. Must be expressed as R:G:B
97 triplet Default: 0:0:255
98
99 monitor=string
100 Select x11 display monitor for legend Options:
101 x0,x1,x2,x3,x4,x5,x6,none Default: x1
102
103 group=string
104 Name of group file where thematic map commands will be saved
105
106 where=string
107 WHERE conditions of SQL statement without 'where' keyword
108
109 psmap=string
110 Root for the name of psmap instruction files to be in current
111 directory (if not set, no psmap instruction files will be created)
112
114 d.vect.thematic - Creates thematic maps from vectors of all types and
115 numeric attributes (stored in the data table connected to a vector
116 map). Thematic maps can be displayed by either a graduated color scheme
117 (for all vector types), as graduated icon sizes (for point and centroid
118 types), or graduated line widths (for lines and boundaries with associ‐
119 ated attributes). The user selects the vector map to be mapped and
120 attribute column from which to derive mapping intervals, and (option‐
121 ally) the layer for attribute data.
122
123 In thematic maps, the color or point size changes for each range of
124 attribute values. Value ranges for thematic mapping can be set at regu‐
125 lar intervals, standard deviation units on either side of the mean,
126 quartiles, or delimited by user-defined breakpoints. User-defined
127 breakpoints also can be entered, or piped into d.vect.thematic from
128 standard input or other external source.
129
130 There are options to define the color scheme (graduated colors) and
131 range of point sizes (graduated points) for thematic maps. A simple
132 text legend is printed. Optionally, a graphic legend can be drawn in
133 the selected display monitor. Thematic colors can be uploaded to a
134 GRASSRGB column for later display, and thematic map display commands
135 can be saved to a group file (*.dm) that can be opened, edited, and
136 displayed in the GIS Manager.
137
138 When the psmap option is set to 'name', two psmap instruction files are
139 created (in the current directory if no path is given), one for the map
140 ('name.psmap') and one for the legend ('name_legend.psmap'). The map
141 file also contains 'label' commands which allow to create a legend
142 directly in the map by adding a 'vlegend' command. See the ps.map man
143 page for more details.
144
145 (GRASS Shell Script)
146
148 The algorithm currently uses the script v.univar.sh to calculate basic
149 descriptive statistics needed for thematic mapping (minimum, maximum,
150 mean, standard deviation, and quartiles).
151
153 Earthquake points with color gradient:
154 d.vect.thematic -l recent_earthquakes column=magnitude type=point
155
156
157 Earthquake points with different sizes:
158 d.vect.thematic -l recent_earthquakes column=magnitude type=point \
159 themetype=graduated_points maxsize=15
160
161
163 d.vect, d.vect.chart, v.univar.sh
164
166 Michael Barton, Arizona State University, Daniel Cavelo Aros, Martin
167 Landa, and Jachym Cepicky.
168
169 Last changed: $Date: 2007/06/02 20:47:26 $
170
171 Full index
172
173
174
175GRASS 6.2.2 d.vect.thematic(1)