googleVis (version 0.2.12)

gvisLineChart: Google Line Chart with R

Description

The gvisLineChart 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

gvisLineChart(data, xvar = "", yvar = "", options = list(), chartid)

Arguments

data

a data.frame to be displayed as a line chart

xvar

name of the character column which contains the category labels for the x-axes.

yvar

a vector of column names of the numerical variables to be plotted. Each column is displayed as a separate line.

options

list of configuration options for Google Line Chart. [object Object] Further possible components are, taken from http://code.google.com/apis/visualization/documentation/gallery/linechart.html#Configuration_Options: [object Objec

chartid

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

Value

• gvisLineChart returns list of class "gvis" and "list". An object of class "gvis" is a list containing at least the following components:
• type
  Google visualisation type, here 'LineChart'
• chartid
  character id of the chart object. Unique chart ids are required to place several charts on the same page.
• html
  a list with the building blocks for a page [object Object],[object Object],[object Object],[object Object]

Warning

Google Visualisation API: You cannot load both linechart and corechart packages at the same time on the same page.

References

Google Line Chart API: http://code.google.com/apis/chart/interactive/docs/gallery/linechart.html

Follow the link for Google's data policy.

See Also

See also print.gvis, plot.gvis for printing and plotting methods

Examples

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

df <- data.frame(country=c("US", "GB", "BR"), val1=c(1,3,4), val2=c(23,12,32))

## Line chart
Line1 <- gvisLineChart(df, xvar="country", yvar=c("val1", "val2"))
plot(Line1)


## Add a customised title and smoothed curve
Line2 <- gvisLineChart(df, xvar="country", yvar=c("val1", "val2"),
             options=list(title="Hello World",
                          titleTextStyle="{color:'red',fontName:'Courier',fontSize:16}",
                          curveType='function'))
plot(Line2)

## Change y-axis to percentages
Line3 <- gvisLineChart(df, xvar="country", yvar=c("val1", "val2"),
                       options=list(vAxis="{format:'#,###%'}"))
plot(Line3)

## Create a chart with two y-axis:
Line4 <-  gvisLineChart(df, "country", c("val1","val2"),
                        options=list(series="[{targetAxisIndex: 0},
                                              {targetAxisIndex:1}]",
                          vAxes="[{title:'val1'}, {title:'val2'}]"
                          ))
plot(Line4)

## Line chart with edit button
Line5 <- gvisLineChart(df, xvar="country", yvar=c("val1", "val2"),
                       options=list(gvis.editor="Edit me!"))
plot(Line5)