Biplots {BiplotGUI}R Documentation

Interactive Biplots in R

Description

Initialises a GUI with which users can construct and interact with biplots.

Usage

Biplots(Data, groups = rep(1, nrow(Data)), PointLabels = rownames(Data), AxisLabels = colnames(Data), excel = NULL, ExcelGroupsCol = 0)

Arguments

Data A matrix or data frame of numerical data. Its n samples (observations) will be represented as points in the biplots; its p variables will be represented as calibrated biplot axes.
groups A vector or factor of length n specifying the group membership of samples. By default, all samples are taken to be from a single group. The group labels are taken from this argument, deprecated to 14 characters each.
PointLabels A vector of length n specifying the point labels. By default, the point labels are taken to be the row names of Data.
AxisLabels A vector of length p specifying the axis labels. By default, the axis labels are taken to be the column names of Data, deprecated to 14 characters each.
excel If the data are to be extracted from an Excel 1997–2003 file, the path to and name of the file. If provided, Data is ignored.
ExcelGroupsCol If the argument excel is used and there are multiple groups, the column number of the worksheet column in which the group specifications are given. If sample names are provided in the first column of the worksheet, this column is not counted. If provided, groups is ignored.

Details

Biplots is the sole function of the BiplotGUI package. The function initialises the GUI for a particular data set. All further options are available from within the GUI. The GUI features themselves are documented in a separate manual available from the Help menu of the GUI. The file can also be found in the ‘doc’ subdirectory of the package installation directory.

The import of data from Excel is rudimentary. If provided, Biplots simply passes the file name and path, excel, to the read.xls function of the xlsReadWrite package. Therefore the data should be in the first worksheet of the Excel file. Variable names must be provided in the first row. These are taken to be the axis labels. Sample names may optionally be provided in the first column. These should be textual, not numerical. If provided, the sample names are taken to be the point labels. If sample names are provided, cell A1 should be left blank. Excel 2007 ‘.xlsx’ files are not supported.

At present, BiplotGUI is written to run under Windows. The GUI runs better when R is in SDI mode rather than MDI mode.

Author(s)

Author and maintainer: Anthony la Grange <amlg at sun.ac.za>, <http://biplotgui.r-forge.r-project.org/>

References

Gower JC, Hand DJ (1996). Biplots. Monographs on Statistics and Applied Probability. Chapman & Hall, London, UK.

Examples

data(Countries)
# Paste the following into an interactive R session (without the ##):
## Biplots(Data = Countries)

data(AntiqueFurniture)
# Paste the following into an interactive R session (without the ##):
## Biplots(Data = AntiqueFurniture[, -1], groups = AntiqueFurniture[, 1])

data(FighterAircraft)
# Paste the following into an interactive R session (without the ##):
## Biplots(Data = FighterAircraft)

[Package BiplotGUI version 0.0-2 Index]