Tutorials › Pharmacometric Workflows and Reproducible Modeling › Objective-Function and Parameter Convergence Tolerances

Initial Estimates and Estimation Settings · Tutorial 116 of 399

Objective-Function and Parameter Convergence Tolerances

You will interpret objective and parameter stopping thresholds, calculate them from hypothetical iterations, and diagnose when a small change does not mean the estimates are reliable.

Advanced 12 min read

What You'll Learn

  • Distinguish objective-change tolerance from parameter-change tolerance.
  • Interpret absolute and relative stopping thresholds in their stated scales.
  • Relate objective changes to local curvature and parameter movement.
  • Work through cases where one convergence criterion passes and another does not.
  • Identify flat directions, scaling effects, and other reasons tolerance checks can mislead.
  • Separate numerical stopping thresholds from statistical evidence or uncertainty.

Why Two Kinds of Tolerance?

An estimation algorithm can make very different kinds of progress from one iteration to the next. The objective function may barely change while one or more parameter estimates are still moving. Conversely, parameter estimates may move only slightly while a steep region of the likelihood surface produces a noticeable objective change. Objective-function and parameter-change tolerances monitor these different features of the optimization path.

In pharmacometric estimation, the objective is often a negative log-likelihood or a scaled form such as minus twice the log-likelihood. The optimizer seeks a parameter vector that minimizes the chosen objective. For FOCE or Laplace estimation, that objective may be based on an approximation to the likelihood; for stochastic methods, its evaluation may also have Monte Carlo variability. The tolerance is therefore a numerical stopping setting, not a statistical significance threshold.

Definition: Let \(Q(\theta)\) be the objective evaluated at parameter vector \(\theta\), and let \(\theta_k\) denote the vector at iteration \(k\). An objective-change tolerance specifies how small a change in \(Q(\theta_k)\) must become to satisfy an objective-based stopping check. A parameter-change tolerance specifies how small the change from \(\theta_k\) to \(\theta_{k+1}\) must become to satisfy a parameter-based check. The exact formula, scaling, and requirement for consecutive iterations depend on the estimation software.

For a minimization, the signed objective change is \(Q(\theta_{k+1})-Q(\theta_k)\), usually negative when the objective decreases. Convergence checks commonly use its absolute value, its decrease, or a relative change. Parameter checks may likewise use absolute changes, relative changes, or a scaled norm across parameters. These definitions are not interchangeable: a tolerance value is interpretable only after identifying the software's formula and the units or scaling it uses.

How the Likelihood Surface Connects the Checks

Near a smooth local minimum, the objective can be approximated by a quadratic function. In one dimension, if the minimum is at \(\theta^*\) and local curvature is \(H>0\), then for a small displacement \(\delta=\theta-\theta^*\),

$$ Q(\theta^*+\delta)\approx Q(\theta^*)+\frac{1}{2}H\delta^2. $$

This approximation explains why the same parameter movement can correspond to different objective changes in different regions. If curvature \(H\) is large, a small displacement can noticeably change the objective. If \(H\) is small, even a larger displacement may produce little change. For a vector of parameters, the corresponding quadratic term involves the local curvature matrix and the direction of the displacement: movement along a flat direction can have little objective effect even when its coordinates change substantially.

A short consequence follows for a one-dimensional quadratic objective. Suppose a proposed stopping rule requires \(Q(\theta)-Q(\theta^*)\leq \varepsilon\). Under the quadratic approximation,

$$ \frac{1}{2}H(\theta-\theta^*)^2\leq\varepsilon \quad\Longrightarrow\quad |\theta-\theta^*|\leq\sqrt{\frac{2\varepsilon}{H}}. $$

Thus an objective tolerance corresponds to a parameter distance only if the local curvature is known and the quadratic approximation is adequate. A flat surface permits a larger distance for the same objective tolerance; a steep surface permits a smaller one. An objective-change check between two iterations is even less direct: both points may be far from the minimum while the objective changes little along a nearly flat path.

Worked Example: Objective Check Passes, Parameter Check Fails

Suppose a hypothetical estimation run minimizes \(Q\), and the software reports the following two successive estimates. The objective-change rule passes when the absolute change is at most \(0.005\). A separate parameter rule requires every relative parameter change to be at most \(0.5\%\).

QuantityIteration \(k\)Iteration \(k+1\)
\(Q\)128.400128.397
Clearance, CL (L/h)4.004.03
Volume, V (L)32.032.1

The absolute objective change is

$$ |128.397-128.400|=0.003\leq 0.005. $$

So this iteration passes the stated objective-change check. The relative change in clearance, using the value at iteration \(k\) as the denominator, is

$$ \frac{|4.03-4.00|}{4.00}\times100\%=0.75\%. $$

For volume it is

$$ \frac{|32.1-32.0|}{32.0}\times100\%=0.3125\%. $$

Because the clearance change exceeds \(0.5\%\), the all-parameters rule fails, even though the objective rule passes. The objective has become stable by this criterion, but clearance is still changing more than the specified relative amount. Neither result alone establishes that the estimates are statistically precise or that the model is adequate.

Worked Cases Where the Checks Disagree

Worked Example: Parameter Check Passes, Objective Check Fails

Consider a hypothetical one-parameter objective

$$ Q(\theta)=50+\frac{1}{2}\left(\frac{\theta-2}{0.1}\right)^2. $$

The estimated parameter changes from \(\theta_k=2.020\) to \(\theta_{k+1}=2.019\). Suppose the relative parameter tolerance is \(0.1\%\), and the objective-change tolerance is \(0.001\).

The relative parameter change is

$$ \frac{|2.019-2.020|}{2.020}\times100\% =\frac{0.001}{2.020}\times100\% \approx0.04950\%. $$

This is below \(0.1\%\), so the parameter-change check passes. The objective values are

$$ Q(2.020)=50+\frac{1}{2}(0.20)^2=50.020, \qquad Q(2.019)=50+\frac{1}{2}(0.19)^2=50.01805. $$

The absolute objective change is \(50.020-50.01805=0.00195\), which exceeds \(0.001\). The objective check therefore fails. In this steep local region, a small parameter movement still produces an objective change larger than the requested threshold. A small relative change in \(\theta\) is not a substitute for checking objective stabilization.

Worked Example: Objective Check Passes Along a Relatively Flat Surface

For a hypothetical two-parameter model, suppose the local objective is

$$ Q(\mathrm{CL},\mathrm{V})= 70+\frac{1}{2}\left(\frac{\mathrm{CL}-5}{2}\right)^2 +\frac{1}{2}\left(\frac{\mathrm{V}-40}{20}\right)^2. $$

An iteration moves from \((\mathrm{CL},\mathrm{V})=(4.8\ \mathrm{L/h},38\ \mathrm{L})\) to \((4.9\ \mathrm{L/h},39\ \mathrm{L})\). Take an absolute objective tolerance of \(0.01\), and a relative parameter tolerance of \(1\%\) for each parameter.

At the first point, the standardized deviations from the minimum are \(-0.1\) and \(-0.1\), so

$$ Q(4.8,38)=70+\frac{1}{2}(0.1)^2+\frac{1}{2}(0.1)^2=70.010. $$

At the second point, the deviations are \(-0.05\) and \(-0.05\), giving

$$ Q(4.9,39)=70+\frac{1}{2}(0.05)^2+\frac{1}{2}(0.05)^2=70.0025. $$

The objective decrease is \(70.010-70.0025=0.0075\), below the tolerance \(0.01\), so the objective check passes. But the relative parameter changes are

$$ \frac{0.1}{4.8}\times100\%\approx2.083\%, \qquad \frac{1}{38}\times100\%\approx2.632\%. $$

Both exceed \(1\%\), so the parameter check fails. In this example, the objective surface is shallow in the parameter units used: appreciable changes in clearance and volume have a modest objective effect. This does not prove that the estimates are unimportant, nor that they are poorly identified; it shows why an objective-change tolerance does not by itself bound parameter movement.

Choosing and Interpreting Tolerances

A tolerance should be evaluated in the scale on which the optimizer applies it. An absolute objective threshold is expressed in objective units. A relative threshold is dimensionless but depends on the denominator convention, especially when the objective is near zero. Parameter tolerances may be in the original parameter units or on a transformed scale. For example, a change of \(0.01\) on a log-transformed parameter does not mean the same thing as a change of \(0.01\) in clearance measured in L/h.

For parameters with different units and magnitudes, a single raw absolute-change threshold can be misleading. A change of \(0.1\) may be negligible for a parameter measured in thousands and substantial for one near \(0.2\). Relative changes help with scale differences, but can become unstable for parameters near zero. A norm-based check can also conceal a large change in one coordinate if changes in other coordinates are small. Inspecting individual parameter changes, with their units, is useful even when the software reports a combined criterion.

The tolerance settings should be understood alongside the method and objective being evaluated. A noisy stochastic objective can fluctuate between evaluations, so an apparent failure of a very tight objective-change check may reflect simulation noise rather than meaningful movement. Conversely, an approximate likelihood evaluation can stabilize at its own numerical accuracy without matching a more accurate likelihood evaluation. A tolerance cannot compensate for insufficient precision in the objective computation.

Objective values also depend on the definition and scaling of the objective. A threshold suitable for one dataset size or objective convention may not transfer directly to another. In particular, a small numerical objective difference is not automatically a likelihood-ratio test result, a p-value, or evidence that two models are statistically equivalent. Such interpretations require their own assumptions and procedures.

Diagnostics, Alternatives, and Limitations

When a run reports convergence, review what condition was actually met: objective change, parameter change, both, or another software-specific combination. Check whether it had to hold for one iteration or several consecutive iterations. Examine the trace over multiple iterations rather than relying only on the final status message. Unexpected oscillation, alternating changes, or a criterion that passes intermittently can indicate that the reported threshold is not capturing stable progress.

A parameter can appear stable because it is constrained at a bound or because its transformed representation changes very little. This is not by itself evidence that the unconstrained likelihood surface has a well-behaved optimum. Likewise, an objective that barely changes may reflect a flat direction, poor scaling, noisy evaluation, or limited numerical resolution. Tolerance checks are stopping rules, not complete diagnostics of model identifiability, uncertainty, or fit.

The main alternative convergence check is based on the gradient: it asks whether the objective has a sufficiently small local slope, rather than whether successive objective values or parameter vectors changed little. These criteria answer different questions. A parameter-change check can pass while the objective still has a material slope, and an objective-change check can pass along a flat path without showing that the optimizer has reached a stationary point. A gradient check provides complementary information but is also subject to scaling and numerical accuracy.

In practice, objective-change and parameter-change tolerances are most informative when interpreted together with the iteration trace, parameter scales, estimation method, and other convergence diagnostics. They do not establish that the chosen local solution is the best solution, that uncertainty estimates are reliable, or that the pharmacometric model is scientifically adequate. Those questions require additional assessment.

Key takeaway: Objective-change tolerance monitors movement in objective units; parameter-change tolerance monitors movement in parameter units or a scaled parameter norm. Curvature connects the two, but neither criterion alone guarantees a reliable optimum.

Check Your Understanding

Answer each question using the stated scales and assumptions. Solutions follow the questions.

  1. A minimization run has \(Q_k=84.200\) and \(Q_{k+1}=84.197\). If the absolute objective-change tolerance is \(0.004\), does this check pass?
  2. A parameter changes from \(10.0\) to \(10.2\). What is its relative change using the starting value in the denominator? Would it satisfy a \(1.5\%\) threshold?
  3. In the quadratic approximation \(Q(\theta)-Q(\theta^*)\approx \frac{1}{2}H(\theta-\theta^*)^2\), what happens to the parameter distance allowed by a fixed objective tolerance when \(H\) becomes four times larger?
  4. Why can an objective-change check pass while parameter estimates still move substantially?
  5. Is passing an objective tolerance evidence that the null hypothesis is true or that two models are statistically equivalent? Explain.

Solutions. (1) The absolute change is \(|84.197-84.200|=0.003\), which is at most \(0.004\); the check passes. (2) The relative change is \(|10.2-10.0|/10.0\times100\%=2.0\%\), so it does not satisfy \(1.5\%\). (3) The distance bound is \(\sqrt{2\varepsilon/H}\). Replacing \(H\) by \(4H\) halves the allowed distance. (4) A flat direction or low local curvature can produce little objective change despite appreciable parameter movement. (5) No. It is a numerical stopping result, not a hypothesis test or an equivalence procedure.

Clinical Biostats