stripBoxplot {GCDkit}R Documentation

Statistics: Stripplot by groups - with boxplots

Description

Stripplot for selected variable, respecting the grouping. Each of the stripplots for the individual groups are underlain by a boxplot, so that the median, quartiles and range are immediately apparent. Optionally, the data points can be replaced by variously sized/coloured circles, depicting a distribution of a second variable.

Usage

    stripBoxplot(yaxis="", zaxis="0", ymin=NULL, ymax=NULL, pal="heat.colors", 
    transp=0, ident=FALSE, scaling.factor=NULL, boxplot.data=NULL, pch=NULL, 
    col=NULL, cex=NULL, sample.names=FALSE, labs=TRUE, horizontal=FALSE, 
    silent=TRUE, add=FALSE)

Arguments

yaxis

specification of the variable used for stripplots/boxplots.

zaxis

(optional) specification of the variable depicted by the circles.

ymin, ymax

minimum and maximum of the y axis.

pal

name of predefined palette.

transp

numeric, 0-1, transparency of the plotting colours.

ident

logical; should be the samples identified interactively after plotting?

scaling.factor

numeric; relative size of the plotted symbols.

boxplot.data

a list; data for the underlying boxplots (if different from those used for the stripplots). See Details.

pch

plotting symbols.

col

plotting colours.

cex

relative size of the plotting symbols.

sample.names

logical, should be each of the datapoints labeled by a sample name?

labs

logical, should each of the groups labeled by abbreviation of its name?

horizontal

logical, should be the plot arranged horizontally?

silent

logical, should be some of the above parameters chosen by the appropriate dialogues?

add

logical; should be the diagram added to a preexisting plot (rather than a new plotting window opened)?

Details

Stripplot shows 1D scatter plots for each of the groups, with some artificial noise (jitter) added to make the individual points better visible. Stripplots are a good alternative to boxplots when sample sizes are small.

If no variable is specified as an argument 'yaxis', and the function is invoked in interactive regime (silent = FALSE), the user can enter it using the function 'selectColumnLabel'.

If 'zaxis' is zero, assigned plotting symbols, colours and symbol sizes are used.

If 'zaxis' refers to a valid variable name, the data points are shown as circles, the size and colours of which correspond to this second variable. In the batch mode, the relative size of the circles plotted can be specified using the parameter scaling.factor.

stripBoxplot.png

In the specification of the variable(s) can be used also arithmetic expressions, see calcCore for the correct syntax.

The colour scheme can be specified by 'pal'. The legal colour schemes are: "grays","reds","blues",
"greens","cyans","violets","yellows","cm.colors","heat.colors","terrain.colors", "topo.colors","rainbow" and "jet.colors". Also user-defined palettes are supported, see the Examples.

Normally, the stripplots are underlain by boxplots portraying the statistical distribution of the same data, as used for construction of stripplots for each of the groups. However, with caution, one can specify via boxplot.data a list containing the alternative data to be shown on background. Clearly, the number of components in the list, as well as their order, needs to exactly match the individual groups (the levels).

Value

None.

Author(s)

Vojtěch Janoušek, vojtech.janousek@geology.cz

See Also

stripplot, boxplot, strip, plotWithCircles

Examples

    data(sazava)
    accessVar("sazava")
    groupsByLabel("Intrusion")
    
    stripBoxplot("(Na2O+K2O)/Al2O3",cex=2)
    
    my.palette<-colorRampPalette(c("black", "darkgreen", "red"),space = "rgb")
    stripBoxplot("(Na2O+K2O)/Al2O3","SiO2",pal="my.palette",transp=0.5,ymin=-0.01,ymax=0.5)

[Package GCDkit version 6.1 Index]