NAME

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

KEYWORDS

       display, cartography

SYNOPSIS

       d.vect.chart
       d.vect.chart help
       d.vect.chart [-cl] map=name  [type=string[,string,...]]   [layer=integer]   [ctype=string]
       columns=string[,string,...]      [sizecol=string]       [size=integer]       [scale=float]
       [ocolor=string]   [colors=string[,string,...]]   [max_ref=float[,float,...]]   [--verbose]
       [--quiet]

   Flags:
       -c
           Center the bar chart around a data point

       -l
           Create legend information and send to stdout

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       map=name
           Name of input vector map

       type=string[,string,...]
           Feature type
           Options: point,line,boundary,centroid,area
           Default: point,line,boundary,centroid

       layer=integer
           Layer number
           A  single  vector  map  can  be  connected  to  multiple  database tables. This number
           determines which table to use.
           Default: 1

       ctype=string
           Chart type
           Options: pie,bar
           Default: pie

       columns=string[,string,...]
           Attribute columns containing data

       sizecol=string
           Column used for pie chart size

       size=integer
           Size of chart (diameter for pie, total width for bar)
           Default: 40

       scale=float
           Scale for size (to get size in pixels)
           Default: 1

       ocolor=string
           Outline color
           Default: black

       colors=string[,string,...]
           Colors used to fill charts

       max_ref=float[,float,...]
           Maximum value used for bar plot reference

DESCRIPTION

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

NOTES

       The charts are positioned as follows:

                      vector points: on point position

                      vector lines: on line centers

                      vector areas: on area centroids
       Bar  charts are placed with their lower edge starting from the y-coordinate of the feature
       being symbolized, and centered with respect to the x-coordinate. The -c flag can  be  used
       to center the bar chart in both x and y directions.
       The 'sizecol' parameter is proportionate to the radius.
       The  optional  max_ref parameter accepts a list of values that represent the maximum value
       for each column listed in the values for the parameter columns. These values are  used  to
       create a framed bar plot if ctype is bar (See Example 2).

EXAMPLES

   Example 1

       d.vect.chart map=vectmap columns=cens51,cens61,cens71,cens81

   Example 2
       Create framed bar graphs of an erodibiliy index from the SPEARFISH dataset.
       r.to.vect -s -v in=erode.index out=erode_index feature=area
       v.extract in=erode_index out=erode_index_ctrds type=centroid
       d.rast aspect
       d.vect.chart map=erode_index_ctrds ctype=bar columns=cat \
                    size=10 max_ref=12 scale=1.5 colors=yellow
       d.vect erode_index_ctrds icon=basic/circle fcol=black col=black size=5
        Example screenshot (zoomed):

SEE ALSO

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

AUTHOR

       Radim Blazek, ITC-Irst, Trento, Italy

       Last changed: $Date: 2011-11-08 01:42:51 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team