focepControl: Control options for the focep (FOCE+) estimation method

In nlmixr2est: Nonlinear Mixed Effects Models in Population PK/PD, Estimation Routines

Control options for the focep (FOCE+) estimation method

Description

This is the first order conditional estimation without eta/residual interaction, but keeping the live conditional residual variance R (the 'foce = "foce+"' option of [foceiControl()]). It is the 'foce' method with 'foce = "foce+"' forced; use 'foce' (est = "foce") for the NONMEM-matching frozen-R behavior.

Usage

focepControl(sigdig = 3, ..., interaction = FALSE, foce = "foce+")

Arguments

sigdig	Optimization significant digits. One value drives, with a single consistent formula, the inner/outer optimizer convergence tolerance (10^-sigdig), the boundary check tolerance (5*10^(-sigdig+1)), and the ODE solver tolerances: the rtol exponent IS sigdig and atol sits three orders below, so rtol = 10^-sigdig, atol = 10^(-sigdig-3) for every solver (stiff, non-stiff or auto-switching). The sensitivity (atolSens/rtolSens) tolerances match the main solve (the outer gradient and covariance are built from them); the steady-state (ssAtol/ssRtol) tolerances run one order looser. Keying the optimizer to the same 10^-sigdig means it converges to exactly the precision the solve supports. At the default sigdig = 3 this is atol = 1e-6, rtol = 1e-3.
...	Parameters used in the default 'foceiControl()'
interaction	Interaction term for the model, in this case the default is 'FALSE'; it cannot be changed, use 'focei' instead
foce	FOCE residual-variance mode; for 'focepControl()' this is always '"foce+"' and cannot be changed – use 'foceControl()' for '"nonmem"'

Value

focepControl object

Author(s)

Matthew L. Fidler

Examples

focepControl()

nlmixr2est documentation built on Aug. 5, 2026, 1:11 a.m.