xpose4 (version 4.5.3)

absval.cwres.vs.pred.by.cov: Absolute value of the conditional weighted residuals vs. population predictions, conditioned on covariates, for Xpose 4

Description

This is a plot of absolute population conditional weighted residuals (|CWRES|) vs population predictions (PRED) conditioned by covariates, a specific function in Xpose 4. It is a wrapper encapsulating arguments to the xpose.plot.default function. Most of the options take their default values from xpose.data object but may be overridden by supplying them as arguments.

Usage

absval.cwres.vs.pred.by.cov(object,
           ylb  = "|CWRES|",
           type="p",
           smooth=TRUE,
           idsdir="up",
           main="Default",
           ...)

Arguments

object

An xpose.data object.

ylb

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

idsdir

Direction for displaying point labels. The default is "up", since we are displaying absolute values.

type

Type of plot. The default is points only ("p"), but lines ("l") and both ("b") are also available.

smooth

Logical value indicating whether an x-y smooth should be superimposed. The default is TRUE.

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 xyplots of |CWRES| vs PRED, conditioned on covariates.

Details

Each of the covariates in the Xpose data object, as specified in object@Prefs@Xvardef$Covariates, is evaluated in turn, creating a stack of plots.

The main argument is not supported owing to the multiple plots generated by the function.

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

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

Examples

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

## Here we load the example xpose database 
data(simpraz.xpdb)
xpdb <- simpraz.xpdb

## A vanilla plot
absval.cwres.vs.pred.by.cov(xpdb)

## Custom axis labels
absval.cwres.vs.pred.by.cov(xpdb, ylb="|CWRES|", xlb="PRED")

## Custom colours and symbols, no IDs
absval.cwres.vs.pred.by.cov(xpdb, cex=0.6, pch=3, col=1, ids=FALSE)