gvisGauge: Google Gauge with R

Description

The gvisGauge function reads a data.frame and creates text output referring to the Google Visualisation API which can be included into a web page, or as a stand-alone page. The actual chart is rendered by the web browser using SVG or VML.

Usage

gvisGauge(data, labelvar = "", numvar = "", options = list(), chartid)

Arguments

data

a data.frame to be displayed as a gauge

labelvar

name of the character column which contains the category labels for the slice labels.

numvar

a vector of column names of the numerical variables of the slice values.

options

list of configuration options for Google Gauge. The possible components are, taken from http://code.google.com/apis/visualization/documentation/gallery/gauge.html#Configuration_Options: [object Object],[object Object],[object Object

chartid

character. If missing (default) a random chart id will be generated based on chart type and tempfile

Value

gvisGauge returns list of class "gvis" and "list". An object of class "gvis" is a list containing at least the following components:
typeGoogle visualisation type, here 'Gauge'
chartidcharacter id of the chart object. Unique chart ids are required to place several charts on the same page.
htmla list with the building blocks for a page [object Object],[object Object],[object Object],[object Object]

References

Google Gauge API: http://code.google.com/apis/chart/interactive/docs/gallery/gauge.html

Follow the link for Google's data policy.

Examples

Run this code

## Please note that by default the googleVis plot command
## will open a browser window and requires an internet
## connection to display the visualisation.

Gauge1 <- gvisGauge(CityPopularity, options=list(min=0, max=800, greenFrom=500,
                    greenTo=800, yellowFrom=300, yellowTo=500,
                    redFrom=0, redTo=300))

plot(Gauge1)