profileModel: plot.profileModel – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

plot.profileModel

Plot methods for ‘profileModel’ objects

Description

plot.profileModel plots the profiles contained in the profiled object. pairs.profileModel is a diagnostic tool that plots pairwise profile traces.

Usage

## S3 method for class 'profileModel'
plot(x, cis = NULL, signed = FALSE, interpolate = TRUE,
                  n.interpolations = 100, print.grid.points = FALSE,
                  title = NULL, ...)

## S3 method for class 'profileModel'
pairs(x, colours = 2:3, title=NULL, ...)

Arguments

`x`	a `"profileModel"` object.
`cis`	the confidence intervals resulted from `profConfint(prof)`. The default is `NULL` where no intervals are plotted. Only used in `plot.profileModel`.
`signed`	if `TRUE` the signed square roots of the values of the profiled objective are plotted. The default is `FALSE`. Available only in `plot.profileModel`.
`interpolate`	if `TRUE` spline interpolation is used in order to get a smooth plot of the profiled objective. If `FALSE` the points that are contained in the `"profileModel"` object are simply joint by segments. The default is `TRUE`. Available only in `plot.profileModel`.
`n.interpolations`	The number of interpolations to take place in the profile range of each parameter. The default value is 100. It is only used when `interpolate=TRUE`. Available only in `plot.profileModel`.
`print.grid.points`	logical indicating whether the points contained in the `"profileModel"` object should be printed along with the objective. The default is `FALSE`. Available only in `plot.profileModel`.
`colours`	A vector of two elements indicating the colours to be used for plotting pairwise profile traces. Available only in `pairs.profileModel`.
`title`	A character string to be displayed at the top of the resultant plotting device. The default is `NULL` where nothing is printed.
`...`	further arguments passed to or from other methods.

Details

pairs.profileModel is a minor modification of pairs.profile in MASS library. The modification was done under the GPL licence 2 or greater and after the permission of the authors, in order to comply with objects of class "profileModel". As in the description of pairs.profile in Venables and Ripley (2002b), pairs.profileModel shows the lines that would join up the points where the contours have horizontal and vertical tangents, respectively, and the fine ‘hairs’ cutting the lines in the pairs plot are an indication of those tangents.

The pair plots should only be used for diagnostic purposes.

Author(s)

Ioannis Kosmidis <email: ioannis.kosmidis@warwick.ac.uk>

References

Venables, W. N. and Ripley, B. D. (2002a). Modern applied statistics with S (4th Edition). Springer.

Venables, W. N. and Ripley, B. D. (2002b). Statistics complements to modern applied statistics with S (4th Edition).
http://www.stats.ox.ac.uk/pub/MASS4/VR4stat.pdf.

Chambers, J. M. and Hastie, T. J. (1992) Statistical Models in S. Chapman \& Hall/CRC.

Examples

# see example in 'confintModel'.

profileModel

Profiling Inference Functions for Various Model Classes

v0.6.1

GPL (>= 2)

Authors

Ioannis Kosmidis [aut, cre] (<https://orcid.org/0000-0003-1556-0302>)

Initial release