xpose4 (version 4.5.3)

basic.gof: Basic goodness-of-fit plots, for Xpose 4

Description

This is a compound plot consisting of plots of observations (DV) vs population predictions (PRED), observations (DV) vs individual predictions (IPRED), absolute individual weighted residuals (|IWRES|) vs IPRED, and weighted population residuals (CWRES) vs independent variable (IDV), a specific function in Xpose 4. WRES are also supported. It is a wrapper encapsulating arguments to the dv.vs.pred, dv.vs.ipred, absval.iwres.vs.ipred and wres.vs.idv functions.

Usage

basic.gof(object,
           force.wres=FALSE,
           main="Default",
           use.log = FALSE,
           ...)

Arguments

object

An xpose.data object.

force.wres

Should the plots use WRES? Values can be TRUE/FALSE. Otherwise the CWRES are used if present.

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.

use.log

Should we use log transformations in the plots?

…

Other arguments passed to xpose.plot.default.

Value

Returns a compound plot comprising plots of observations (DV) vs population predictions (PRED), DV vs individual predictions (IPRED), absolute individual weighted residuals (|IWRES|) vs IPRED, and weighted populations residuals (WRES) vs the independent variable (IDV).

Details

Four basic goodness-of-fit plots are presented side by side for comparison.

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.

basic.gof.cwres is just a wrapper for basic.gof with use.cwres=TRUE.

See Also

dv.vs.pred, dv.vs.ipred, absval.iwres.vs.ipred, wres.vs.idv, cwres.vs.idv, 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 run 1
## in the current working directory
xpdb <- xpose.data(1)


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

## A vanilla plot
basic.gof(xpdb)

## Custom colours and symbols, IDs of individuals in study
basic.gof(xpdb, cex=0.6, pch=8, col=1, ids=TRUE)