xpose4 (version 4.5.3)

dv.vs.ipred.by.cov: Dependent variable vs individual predictions, conditioned on covariates, for Xpose 4

Description

This is a plot of dependent variable (DV) vs individual predictions (IPRED) 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

dv.vs.ipred.by.cov(object,
           abline = c(0,1),
           smooth = TRUE,
           main="Default",
           ...)

Arguments

object

An xpose.data object.

abline

Vector of arguments to the panel.abline function. No abline is drawn if NULL.

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 DV vs IPRED, 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.

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

See Also

dv.vs.ipred, xpose.plot.default, xpose.panel.default, xyplot, xpose.prefs-class, xpose.data-class

Examples

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

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

## A vanilla plot
dv.vs.ipred.by.cov(xpdb)

## Custom axis labels
dv.vs.ipred.by.cov(xpdb, ylb="DV", xlb="PRED")

## Custom colours and symbols, IDs
dv.vs.ipred.by.cov(xpdb, cex=0.6, pch=3, col=1, ids=TRUE)