plot.nlmixr2FitData: Plot a nlmixr2 data object

In nlmixr2plot: Nonlinear Mixed Effects Models in Population PK/PD, Plot Functions

Plot a nlmixr2 data object

Description

Plot some standard goodness of fit plots for the focei fitted object. When the model has between-subject variability (BSV), the returned collection also includes a nested "bsv" element (inside each data/compartment group) with QQ plots for each BSV parameter, BSV-BSV correlation plots (when more than one BSV parameter is present) and, when covariate is supplied, BSV-by-covariate plots.

Usage

## S3 method for class 'nlmixr2FitData'
plot(x, covariate = NULL, ...)

Arguments

x	a focei fit object
covariate	Optional character vector of covariate column names (from the model input data) to plot against each between-subject variability (BSV) parameter. Default NULL (no covariate plots). The first row per individual is used, so covariates are assumed time-invariant (a time-varying covariate is represented by its baseline value).
...	additional arguments (currently ignored)

Value

A named, nested ggtibble::gglist object (a list of ggplot2 objects with easier plotting of all of them at the same time)

Author(s)

Wenping Wang & Matthew Fidler

Examples

library(nlmixr2est)
one.compartment <- function() {
  ini({
    tka <- 0.45
    tcl <- 1
    tv <- 3.45
    eta.ka ~ 0.6
    eta.cl ~ 0.3
    eta.v ~ 0.1
    add.sd <- 0.7
  })
  model({
    ka <- exp(tka + eta.ka)
    cl <- exp(tcl + eta.cl)
    v <- exp(tv + eta.v)
    d/dt(depot) = -ka * depot
    d/dt(center) = ka * depot - cl / v * center
    cp = center / v
    cp ~ add(add.sd)
  })
}

## The fit is performed by the function nlmixr/nlmix2 specifying the model, data and estimate
fit <- nlmixr2(one.compartment, theo_sd,  est="saem", saemControl(print=0, nBurn = 10, nEm = 20))

# This shows many goodness of fit plots
plot(fit)

nlmixr2plot documentation built on Sept. 23, 2026, 1:07 a.m.