1d.vect.thematic(1)            Grass User's Manual           d.vect.thematic(1)
2
3
4

NAME

6       d.vect.thematic  - Displays thematic vectormap
7

KEYWORDS

9       display, legend
10

SYNOPSIS

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

DESCRIPTION

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

ATTENTION

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

EXAMPLES

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

SEE ALSO

163        d.vect, d.vect.chart, v.univar.sh
164

AUTHORS

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)
Impressum