xpose4 (version 4.5.3)

absval.delta.model.comp: Model comparison plots, of absolute differences in goodness-of-fit predictors against covariates, for Xpose 4

Description

These functions plot absolute differences in PRED, IPRED, WRES, CWRES and IWRES against covariates for the two specified model fits.

Usage

absval.dpred.vs.cov.model.comp(object,
           object.ref = NULL,
           type = NULL,
           ylb=expression(paste("|", Delta, "PRED|")),
           main="Default",
           ...)
           
absval.dipred.vs.cov.model.comp(object,
           object.ref = NULL,
           type = NULL,
           ylb=expression(paste("|", Delta, "IPRED|")),
           main="Default",
           ...)
           
absval.dcwres.vs.cov.model.comp(object,
           object.ref = NULL,
           type = NULL,
           ylb=expression(paste("|", Delta, "CWRES|")),
           main="Default",
           ...)
           
absval.dwres.vs.cov.model.comp(object,
           object.ref = NULL,
           type = NULL,
           ylb=expression(paste("|", Delta, "WRES|")),
           main="Default",
           ...)
           
absval.diwres.vs.cov.model.comp(object,
           object.ref = NULL,
           type = NULL,
           ylb=expression(paste("|", Delta, "IWRES|")),
           main="Default",
           ...)

Arguments

object

An xpose.data object.

object.ref

An xpose.data object. If not supplied, the user will be prompted.

type

1-character string giving the type of plot desired. The following values are possible, for details, see 'plot': '"p"' for points, '"l"' for lines, '"o"' for overplotted points and lines, '"b"', '"c"') for (empty if '"c"') points joined by lines, '"s"' and '"S"' for stair steps and '"h"' for histogram-like vertical lines. Finally, '"n"' does not produce any points or lines.

ylb

A string giving the label for the y-axis. NULL if none.

main

The title of the plot. If "Default" then a default title is plotted. Otherwise the value should be a string like "my title" or NULL for no plot title. For "Default" the function xpose.multiple.plot.title is used.

…

Other arguments passed to link{xpose.plot.default}.

Value

Returns a stack of plots comprising comparisons of PRED, IPRED, WRES (or CWRES) and IWRES for the two specified runs.

Details

These functions produce plots of the absolute difference in population predictions (absval.dpred.vs.cov.model.comp), individual predictions (absval.dipred.vs.cov.model.comp), weighted population residuals (absval.dwres.vs.cov.model.comp), conditional weighted population residuals (absval.dcwres.vs.cov.model.comp) and individual predictions (absval.diwres.vs.cov.model.comp).

Conditional weighted residuals (CWRES) require some extra steps to calculate. See compute.cwres for details.

A wide array of extra options controlling xyplots are available. See xpose.plot.default for details.

See Also

xpose.plot.default, xpose.panel.default, xyplot, compute.cwres, xpose.prefs-class, xpose.data-class

Examples

## We expect to find the required NONMEM run and table files for runs
## 5 and 6 in the current working directory
xpdb5 <- xpose.data(5)
xpdb6 <- xpose.data(6)

## A basic dWRES plot, without prompts
absval.dwres.vs.cov.model.comp(xpdb5, xpdb6)

## Custom colours and symbols, no user IDs
absval.dpred.vs.cov.model.comp(xpdb5, xpdb6, cex=0.6, pch=8, col=1, ids=NULL)