plot.stbVCA {STB}

Plot Objects of Class 'stbVCA'.

Description

Standard plotting method for objects of Class 'stbVCA'.

Usage

## S3 method for class 'stbVCA'
plot(x, orient = 1, pick = FALSE, type = NULL, ...)

Arguments

x

(object) of class 'STB' as generated by function getSTB

orient

(integer) in 'type=1' plots, 1 = expected vs. observed values, 2 = observed vs. expected values

pick

(logical, integer) TRUE = triggers function identify for identification of points using the mouse. Stop interactive identification by pressing 'Esc' or "Right-Mousclick –> Stop". If 'TRUE' and 'type=3', identified points will be added to the residual plot with STI automatically. If 'pick=1', only in the QQ-plot identification will be toggled, and if 'pick=2' only in the residual plot identification will be possible.

type

(integer) 1 = plot simultaneous tolerance band (STB), 2 = plot simultaneous tolerance interval (STI), 3 = plot STB and STI

...

additional arguments changing the visual appearance of the plot, e.g. 'pch', 'pch.out', 'col', 'col.out', 'stb.col', 'stb.main', "'sti.main', 'legend', ... in fact all elements of 'x'

Details

This function plots objects of class 'stbVCA' as generated by function stb.VCA. Objects of S3-class 'stbVCA' are list-type objects storing all the information needed to plot QQ-plots with simultaneous tolerance bounds. Additionally to the information contained in ordinary 'STB' objects, a copy of the 'VCA' object is stored as well as the type of random variate and the mode, i.e. the type of transformation applied.

One can specify additional parameters for changing the appearance of the plot(s). Any of the following parameters can be set to a value different from the default:

legend	...	(logical) TRUE = will add legend to plot(s) (is default)
pch	...	plotting symbol for non-outlying points (default=16)
col	...	point color for non-outlying points (default="black")
col.out	...	point color for outlying points (default="red")
pch.out	...	plotting symbold for outlying points (default=16)
stb.col	...	color of the STB in the QQ-plot (default="#0000FF40")
stb.lpos	...	position placement as done in function 'legend', or, character string "title" indicating
		that legend information should be displayed as (sub-main) title (default="title")
stb.main	...	character string used as main title in the QQ-plot with STB
sti.lty	...	line type for STI-bounds in the residual plot (default=2)
sti.lwd	...	line width for STI-bounds (default=1)
sti.col	...	line color for STI bounds (default="red")
sti.ylab	...	character string specifying the Y-axis label in the resiudal plot with STI
sti.lpos	...	position placement as done in function 'legend' (default="topright")
sti.main	...	character string used as main title in the residual plot with STI

Value

(stbVCA) object is invisibly returned, any additional compution results are added

Author(s)

Andre Schuetzenmeister [e-mail]

See Also

stb.VCA

Examples

## Not run: 
library(VCA)
data(dataEP05A2_1)
fit <- anovaVCA(y~day/run, dataEP05A2_1)
fit

# use studentized conditional residuals
stb.obj1 <- stb.VCA(fit, term="cond", mode="student", N=1000)

# plot it again
plot(stb.obj1)

# use random effects "day" and apply standardization
stb.obj2 <- stb.VCA(fit, term="day", mode="stand", N=1000)

# plot it again
plot(stb.obj2)

# initially, request QQ-plot with STB
stb.obj3 <- stb.VCA(fit, term="day", mode="stand", N=1000, type=1)

# now request plotting of the residual plot as well
# catch computation result which are invisibly returned
stb.obj4 <- plot(stb.obj3, type=3)

# individualize the appearance of the plot
plot(stb.obj4, sti.lpos="top", col="darkblue", out.pch=17, out.col="green") 

## End(Not run)