compare_etaShrinkageNlme: Compare original and filtered ETA shrinkage

In Certara.Xpose.NLME: Enhances 'xpose' Diagnostics for Pharmacometric Models from 'Certara.RsNLME' and Phoenix NLME

Compare original and filtered ETA shrinkage

Description

Computes filtered overall ETA shrinkage from the stored subject-by-ETA data and returns a comparison table without modifying the xpdb object.

Usage

compare_etaShrinkageNlme(
  xpdb,
  threshold = 1e-06,
  eta_threshold = NULL,
  eta_name = NULL,
  .problem = 1
)

Arguments

xpdb	An xpose_data object created by xposeNlme or xposeNlmeModel.
threshold	Global default threshold applied to all ETAs (default 1e-6). A subject/ETA row is removed when its variance-form shrinkage \ge (1 - \text{threshold})^2.
eta_threshold	Optional named numeric vector overriding threshold for specific ETAs, e.g. c(nV = 1e-6, nCl = 0.05).
eta_name	Optional character vector selecting a subset of ETAs to recompute. ETAs not listed keep their current summary values.
.problem	Problem number (default 1).

Value

A tibble with one row per processed ETA containing:

Eta

ETA name

n_total

Total number of subjects for this ETA

n_kept

Number of subjects kept after filtering

n_removed

Number of subjects removed

threshold_applied

Resolved threshold used for this ETA

original_shrinkage

Shrinkage computed from all subjects

filtered_shrinkage

Shrinkage computed after filtering

omega_sd

Population omega standard deviation for this ETA

Certara.Xpose.NLME documentation built on Oct. 1, 2026, 1:08 a.m.