R Graphical Manual

Browse All

Last data update: 2014.03.03

R: Dependent variable vs individual predictions, conditioned on...

dv.vs.ipred.by.cov

R Documentation

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}`.

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.

Value

Returns a stack of xyplots of DV vs IPRED, conditioned on covariates.

Author(s)

E. Niclas Jonsson, Mats Karlsson, Andrew Hooker & Justin Wilkins

Examples

## Not run: 
## 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)

## End(Not run)