Loon: An Interactive Statistical Visualization Toolkit

Note that this page provides installation instructions for R. If you want to install loon for Tcl then follow the instructions here.

Important

Further Notes

Installation

Installing the loon package

The loon package is on CRAN available. To install the package start your R and run

install.packages('loon')

You can also install the latest development release directly from GitHub with the following R code

devtools::install_github("waddella/loon", subdir="R")

Packages used for Examples and Demos

The following packages are used in loon's examples and demos. Note that these packages are not needed to install loon, they are just nice to have to run all the examples and demos. You can skip this step and check if your loon installation was successful.

We split the code to install the suggested packages into four sections as not all the packages are easy to install.

First, these packages from CRAN should install without any issues

install.packages(c('maps','sp','RColorBrewer',
    'RnavGraphImageData','rworldmap', 'scales'))

The following packages on Biocoductor should also install without any issues

source("https://bioconductor.org/biocLite.R")
biocLite(c('graph', 'RDRToolbox', 'Rgraphviz'),
    suppressUpdates=TRUE, suppressAutoUpdate=TRUE)

The following packages on CRAN have dependencies that might need need special care

install.packages(c('dplyr', 'rgl', 'PairViz', 'scagnostics', 'kernlab',
    'testthat', 'knitr', 'rmarkdown'))

Check if your Installation was Successful

In R enter

library(loon)

p <- with(iris, l_plot(x=Sepal.Length, y=Sepal.Width, color=Species))

If this creates a scatterplot and an inspector loon was correctly installed. Follow the steps in the UI section and the Learn section to learn how to use loon.

Fast Image Resizing for Image Point Glyphs

On Linux and OS X it is advisable to install the ImageScale Tcl extension for fast image resizing. loon will use the compiled C code for image resizing when available.

The TEA setup of ImageScale for Windows does currently not work. If you know how to change the makefile.vc in the win folder so that the ImageScale package also compiles under Windows then please contact me.

More Important Notes

Note that only part of loon's functionality is documented on this webpage. However, most of loon's features are used in the R documentation manuals, R package demos and R package vignettes.

Manual

To get an index of all help entries run

help(package = "loon")

Package Demos

To get a listing of all of loon's demos enter

demo(package="loon")

Run a particular demo as follows

demo("l_timeseries")

To get the location of the source code of a particular demo (e.g. l_timeseries) use

system.file("demo", "l_timeseries.R", package = "loon")

Package Vignettes

To get a list of all package vignettes run

vignette(package = "loon")

To open the minority vignette run

vignette('minority', package = "loon")

Good to know