plot.wblr: S3 'wblr' Object Plotting on pretty canvax
In WeibullR: Weibull Analysis for Reliability Engineering

plot.wblr

R Documentation

S3 `wblr` Object Plotting on pretty canvax

Description

This function adds the .wblr method to plot.default from the graphics package.

Currently, the function plots the (life-)time observations, fits (if any) and confidence bounds for B-lives (if any) of an wblr object or a list of wblr objects on Weibull or Lognormal probability paper.

For each fit in the (list of) wblr object(s), legends are added to the plot, displaying the fit parameters and (if available) goodness-of-fit indicators and confidence information.

Usage

## S3 method for class 'wblr'
plot(x, ...)

Arguments

`x`	Object of class `"wblr"` or a list of `wblr` objects.
`...`	Options for plotting the `wblr` object; see section "Details".

Details

The ... argument can be any graphical parameter that can be supplied to plot.default, and any option that can be set by the function options.wblr. The options set in this way are applied to all graphical elements of the plot, overriding any previously supplied options.

One can pass a list of wblr objects to plot.wblr; in that case it is mandatory to use the full method name: plot.wblr(...) and not plot(...).

The calculated Weibull or Lognormal distribution fits are plotted on Weibull probability paper by default, but by passing the argument canvas = "lognormal" to the function, Lognormal paper is used.

When a list of wblr objects is passed, the plot window is generated with the options of the first wblr object in the list.

Graphical controls typically used with plot or plot.wblr:

canvas: The plotting canvas to be used. This does not necessarily have to match the fit distribution. Only "weibull" (default) or "lognormal" are recognized.
mar: Margins defaults to c(5.1,4.1,5.1,2.1),.
main: Title, defaults to "Probability Plot".
main.contour: Contour plot title defaults to "Contour Plot".
sub: Subtitle defaults to NULL.
sub.contour: Contour subtitle defaults to NULL.
xlim: Plot x limits override to be presented as a vector c(lo,hi), default NULL.
ylim: Plot y limits override to be presented as a vector c(lo,hi), default NULL.
xlab: X axis label defaults to "Time To Failure".
ylab: Y axis label defaults to "Unreliability [%]".
coordinate.text.size: default 0.7.
signif: Used to control display of numbers in Legend, default 4.
col.grid: Color for chart gridlines defaults "grey".
is.plot.grid: default TRUE.
is.plot.fit: default TRUE.
is.plot.pp: default TRUE.
is.plot.ppcoordinates: default FALSE.
is.plot.legend: default TRUE.
legend.position: default "bottomright". See legend Details.
legend.inset: default c(0,0). legend inset values are fractions of graph width and height.
legend.text.size: default 0.7.
label: defaults to "".
in.legend: default TRUE.
in.legend.blives: default TRUE.
in.legend.gof: default TRUE.
is.plot.cb: default TRUE.
persistent: default TRUE.

Value

Currently, the function returns no value.

References

Jurgen Symynck, Filip De Bal, Weibull analysis using R, in a nutshell (New Technologies and Products in Machine Manufacturing Technology, Stefan cel Mare University of Suceava, 2010).

Jurgen Symynck, Filip De Bal, Monte Carlo pivotal confidence bounds for Weibull analysis, with implementations in R (New Technologies and Products in Machine Manufacturing Technology, Stefan cel Mare University of Suceava, 2011).

Examples

options.wblr(blives=0.1) # make the legend boxes a bit shorter...
da2 <- wblr.conf(wblr.fit(wblr(runif(5,10,100),col="red")))
da3 <- wblr.conf(wblr.fit(wblr(rweibull(5,2,1000),col="green4",pch=3)))
da4 <- wblr.conf(wblr.fit(wblr(rlnorm(5,log(500),log(2)),col="blue3",pch=8),
    dist="lognormal"))

## Not run: 
plot.wblr(list(da2,da3,da4),xlim=c(1,1e6),
    main="Uniformly distributed observations")

## End(Not run)

WeibullR documentation built on June 26, 2022, 3 a.m.