1d.vect.chart(1)             GRASS GIS User's Manual            d.vect.chart(1)
2
3
4

NAME

6       d.vect.chart   -  Displays charts of vector data in the active frame on
7       the graphics monitor.
8

KEYWORDS

10       display, cartography, chart maps
11

SYNOPSIS

13       d.vect.chart
14       d.vect.chart --help
15       d.vect.chart      [-cl3]      map=name       [type=string[,string,...]]
16       [layer=string]        [chart_type=string]       columns=name[,name,...]
17       [size_column=name]       [size=integer]       [scale=float]       [out‐
18       line_color=name]                               [colors=name[,name,...]]
19       [max_ref=float[,float,...]]   [--help]  [--verbose]  [--quiet]  [--ui]
20
21   Flags:
22       -c
23           Center the bar chart around a data point
24
25       -l
26           Create legend information and send to stdout
27
28       -3
29           Create 3D charts
30
31       --help
32           Print usage summary
33
34       --verbose
35           Verbose module output
36
37       --quiet
38           Quiet module output
39
40       --ui
41           Force launching GUI dialog
42
43   Parameters:
44       map=name [required]
45           Name of vector map
46           Or data source for direct OGR access
47
48       type=string[,string,...]
49           Input feature type
50           Options: point, line, boundary, centroid, area
51           Default: point,line,boundary,centroid
52
53       layer=string
54           Layer number or name
55           Vector features can have category values in different layers.  This
56           number  determines  which  layer  to use. When used with direct OGR
57           access this is the layer name.
58           Default: 1
59
60       chart_type=string
61           Chart type
62           Options: pie, bar
63           Default: pie
64
65       columns=name[,name,...] [required]
66           Attribute columns containing data
67
68       size_column=name
69           Column used for pie chart size
70
71       size=integer
72           Size of chart (diameter for pie, total width for bar)
73           Default: 40
74
75       scale=float
76           Scale for size (to get size in pixels)
77           Default: 1
78
79       outline_color=name
80           Outline color
81           Either a standard color name or R:G:B triplet
82           Default: black
83
84       colors=name[,name,...]
85           Colors used to fill charts
86           Either a standard color name or R:G:B triplet
87           Default: black
88
89       max_ref=float[,float,...]
90           Maximum value used for bar plot reference
91

DESCRIPTION

93       d.vect.chart displays charts for GRASS vector data in the active  frame
94       on the graphics monitor.
95

NOTES

97       The charts are positioned as follows:
98
99           ·   vector points: on point position,
100
101           ·   vector lines: on line centers,
102
103           ·   vector areas: on area centroids.
104       Bar charts are placed with their lower edge starting from the y-coordi‐
105       nate of the feature being symbolized, and centered with respect to  the
106       x-coordinate.   The -c flag can be used to center the bar chart in both
107       x and y directions.
108
109       The ’sizecol’ parameter is proportionate to the radius.
110
111       The optional max_ref parameter accepts a list of values that  represent
112       the  maximum value for each column listed in the values for the parame‐
113       ter columns. These values are used to  create  a  framed  bar  plot  if
114       chart_type is bar (See Example 2).
115

EXAMPLES

117   Example 1
118       Pie-charts  of  monthly  winter  precipitation  (North  Carolina sample
119       dataset):
120       g.region vector=nc_state -p
121       d.vect nc_state
122       d.vect.chart precip_30ynormals chart_type=pie columns=nov,dec,jan,feb -l
123       # show pie chart as 3D
124       d.erase
125       d.vect nc_state
126       d.vect.chart precip_30ynormals chart_type=pie columns=nov,dec,jan,feb -l -3
127       2D pie-chart of monthly winter precipitation in North Carolina
128
129       3D pie-chart of monthly winter precipitation in North Carolina
130
131   Example 2
132       Bar-chart of different census map values:
133       d.vect.chart map=vectmap columns=cens51,cens61,cens71,cens81 chart_type=bar
134
135   Example 3
136       Creation of framed bar charts of an erodibiliy index from the Spearfish
137       sample dataset:
138       g.region raster=erode.index -p
139       r.to.vect -s input=erode.index output=erode_index type=area
140       v.extract input=erode_index output=erode_index_ctrds type=centroid
141       d.rast aspect
142       d.vect.chart map=erode_index_ctrds chart_type=bar columns=cat \
143                    size=10 max_ref=12 scale=0.05 colors=yellow
144       d.vect erode_index_ctrds icon=basic/circle fcol=black col=black size=5
145       Bar charts of an erodibiliy index (spatial subset)
146

SEE ALSO

148        d.erase, d.vect, d.vect.thematic, d.what.vect, d.rast
149

AUTHOR

151       Radim Blazek, ITC-Irst, Trento, Italy
152

SOURCE CODE

154       Available at: d.vect.chart source code (history)
155
156       Main  index | Display index | Topics index | Keywords index | Graphical
157       index | Full index
158
159       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
160
161
162
163GRASS 7.8.5                                                    d.vect.chart(1)
Impressum