plot.inference: Plot Inference Results

In relevance: Calculate Relevance and Significance Measures

Plot Inference Results

Description

Plot confidence or relevance interval(s) for one or several items

Usage

## S3 method for class 'inference'
plot(x, pos = NULL, overlap = FALSE, 
  refline = c(0,1,-1), xlab = "relevance", ...)
## S3 method for class 'termeffects'
plot(x, pos = NULL, single=FALSE,
  overlap = TRUE, termeffects.gap = 0.2, refline = c(0, 1, -1),
  xlim=NULL, ylim=NULL, xlab = "relevance", mar=NA,
  labellength=getOption("labellength"), ...)

Arguments

x	a vector or matrix of class inference.
pos	positions of the bars in vertical direction
overlap	logical: should shortened intervals be shown to show significance of differences? see Details

refline	values for vertical reference lines
single	logical: should terms with a single degree of freedom be plotted?
termeffects.gap	gap between blocks corresponding to terms
xlim, ylim	limits of plotting area, as usual
xlab	label for horizontal axis
mar	plot margins. If NULL (default), the left side margin will be adjusted to accomodate the labels of effects of factor levels
labellength	maximum number of characters for label strings
...	further arguments to the call of plot.inference (forplot.termeffects) and plot

Details

The overlap interval allows for a graphical assessment of the significance of the test for zero difference(s), akin the notches in the box plots: The difference between a pair of groups is siginificant if their overlap intervals do not overlap. For equal standard errors of the groups, the standard error of the difference between two of them is larger by the factor sqrt(2). Therefore, the intervals should be shortened by this factor, or multiplied by 1/sqrt(2), which is the default for overlapfactor. If only two groups are to be shown, the factor is adjusted to unequal standard errors.

The graphical options are:

• lwdline widths for: [1] the interval, [2] middle mark, [3] end marks, [4] overlap interval marks, [5] vertical line marking the relevance threshold

• markheightdetermines the length of the middle mark, the end marks and the marks for the overlap interval as a multiplier of the default length

• extendextension of the vertical axis beyond the range

• framecolcolor to be used for the framing lines: axis and vertical lines at relevances 0 and 1

Value

none

Note

plot.inference displays termtable objects, too, since they inherit from class inference.

Author(s)

Werner A. Stahel

See Also

plconfint

Examples

## --- regression
data(swiss)
rr <- lm(Fertility ~ . , data = swiss)
rt <- termtable(rr)
plot(rt)

## --- termeffects
data(d.blast)
rlm <- lm(log10(tremor)~location+log10(distance)+log10(charge), data=d.blast)
rte <- termeffects(rlm)
plot(rte, single=TRUE)

relevance documentation built on May 1, 2023, 5:20 p.m.