Conditional Weighted residuals (CWRES) plotted against covariates, for Xpose 4
Description
This creates a stack of plots of conditional weighted residuals (CWRES) plotted
against covariates, and is a specific function in Xpose 4. It is a
wrapper encapsulating arguments to the xpose.plot.default and
xpose.plot.histogram functions. Most of the options take their
default values from xpose.data object but may be overridden by supplying
them as arguments.
A string giving the label for the y-axis. NULL if none.
smooth
A NULL value indicates that no superposed line
should be added to the graph. If TRUE then a smooth of the data will
be superimposed.
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.
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} or
link{xpose.plot.histogram}.
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.
Conditional weighted residuals (CWRES) require some extra steps to
calculate. See compute.cwres for details.
A wide array of extra options controlling xyplots and histograms are
available. See xpose.plot.default and
xpose.plot.histogram for details.
Value
Returns a stack of xyplots and histograms of CWRES versus covariates.
Author(s)
E. Niclas Jonsson, Mats Karlsson, Andrew Hooker & Justin Wilkins
## 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
cwres.vs.cov(xpdb)
## Custom colours and symbols, IDs
cwres.vs.cov(xpdb, cex=0.6, pch=3, col=1, ids=TRUE)
## End(Not run)