Skip to main content
$$ % Define your custom commands here \newcommand{\bmat}[1]{\begin{bmatrix}#1\end{bmatrix}} \newcommand{\E}{\mathbb{E}} \newcommand{\P}{\mathbb{P}} \newcommand{\S}{\mathbb{S}} \newcommand{\R}{\mathbb{R}} \newcommand{\S}{\mathbb{S}} \newcommand{\norm}[2]{\|{#1}\|_{{}_{#2}}} \newcommand{\pd}[2]{\frac{\partial #1}{\partial #2}} \newcommand{\pdd}[2]{\frac{\partial^2 #1}{\partial #2^2}} \newcommand{\vectornorm}[1]{\left|\left|#1\right|\right|} \newcommand{\abs}[1]{\left|{#1}\right|} \newcommand{\mbf}[1]{\mathbf{#1}} \newcommand{\mc}[1]{\mathcal{#1}} \newcommand{\bm}[1]{\boldsymbol{#1}} \newcommand{\nicefrac}[2]{{}^{#1}\!/_{\!#2}} \newcommand{\argmin}{\operatorname*{arg\,min}} \newcommand{\argmax}{\operatorname*{arg\,max}} \newcommand{\dd}{\operatorname{d}\!} $$

5. The waist tape

The scale sees fat mass only through the energy density of what is lost, which is weak evidence, so step 4’s fat estimate ended almost as uncertain as it began, and centered on whatever body fat the config said. A tape measure responds to fat directly. This step fits the same episode without and with its 18 weekly waist readings, once with the configured body fat right (30 %) and once 5 points low (25 %). The waist model is in The waist tape and its update in The waist update.

uv run python walkthrough/05_waist.py
The script
"""Step 5: the tape measure as a second sensor.

The scale sees fat mass only through the energy density of what is lost, so
step 4's fat estimate kept most of its starting uncertainty, and its starting
point was the body-fat fraction in the config. Fit the same episode without
and with its weekly waist readings, once with the configured body fat right
(30 %) and once with it 5 points low, and compare fat mass against the truth.
"""

import dataclasses

import jax.numpy as jnp

from wdm.config import Config, Preferences, Safety, Subject
from wdm.estimation import fit_joint, identify_noise
from wdm.models import NoiseModel, Params
from wdm.models.observation import waist_prior
from wdm.synthetic import SyntheticSpec, make_episode

subj = Subject(sex="male", age_years=40, height_cm=175.0, body_fat_frac=0.30)
c0, c1 = subj.expenditure_prior(100.0)
true = Params(
    rmr_intercept=jnp.asarray(c0 * 1.18),
    rmr_slope=jnp.asarray(c1 * 0.90),
    at_gain=jnp.asarray(0.22),
    at_tau=jnp.asarray(11.0),
    gly_gain=jnp.asarray(0.0042),
    gly_tau=jnp.asarray(2.0),
    na_gain=jnp.asarray(2.5e-4),
    na_tau=jnp.asarray(1.0),
    partition_kappa=jnp.asarray(0.06),
)
carb_ref, sodium_ref = subj.habitual_intake()
spec = SyntheticSpec(
    n_days=120, waist_every_days=7, habitual_carb_g=carb_ref, habitual_sodium_mg=sodium_ref
)
ep, truth = make_episode(spec, true, name="current", start_date="2026-06-01", seed=7)

ni = identify_noise([ep])  # phase 1 uses weigh-ins only, so it is the same either way
noise = dataclasses.replace(NoiseModel.default(), obs_sd=jnp.asarray(ni.obs_sd))

w0 = ep.first_weight_kg()
a0, b0, sd_a = waist_prior(subj.sex, subj.age_years, 0.30 * w0, w0)
print(f"waist prior at 30 % fat: offset {a0:.1f} +- {sd_a:.1f} cm, slope {b0:.3f} cm/kg (+-20 %)")
print(
    f"waist truth: offset {spec.waist_offset_cm:.1f} cm, slope {spec.waist_slope_cm_per_kg:.3f}"
    f" cm/kg; {ep.n_waist} readings, sd {spec.waist_sd_cm} cm"
)
print(f"true fat mass: day 0 {truth['fat_kg'][0]:.2f} kg, day 119 {truth['fat_kg'][-1]:.2f} kg")
print()

print("configured   data          fat day 0         fat day 119      error day 119")
fits = {}
for bf in (0.30, 0.25):
    cfg = Config(
        subject=dataclasses.replace(subj, body_fat_frac=bf),
        goal=None,
        safety=Safety(),
        preferences=Preferences(),
    )
    for label, data in (("scale only", dataclasses.replace(ep, waist_cm=None)), ("with waist", ep)):
        fit = fit_joint([data], cfg, noise)
        fits[bf, label] = fit
        e = fit.episodes[0]
        f, s = e.fat_kg(), e.state_sd()[:, 1]
        err = f[-1] - truth["fat_kg"][-1]
        print(
            f"  {bf:.0%} fat    {label}   {f[0]:5.2f} +- {s[0]:4.2f}     "
            f"{f[-1]:5.2f} +- {s[-1]:4.2f}     {err:+5.2f} kg ({err / s[-1]:+.2f} sd)"
        )
print()

print("waist calibration with 30 % configured: posterior median and 90% interval")
for s in fits[0.30, "with waist"].waist_summaries():
    print(f"  {s.name:22s} {s.median:7.3f}  [{s.q05:.3f}, {s.q95:.3f}]  shift {s.shrinkage:+.1%}")
waist prior at 30 % fat: offset 64.8 +- 7.2 cm, slope 1.241 cm/kg (+-20 %)
waist truth: offset 75.0 cm, slope 1.200 cm/kg; 18 readings, sd 1.5 cm
true fat mass: day 0 29.43 kg, day 119 22.02 kg

configured   data          fat day 0         fat day 119      error day 119
  30% fat    scale only   29.19 +- 3.99     22.02 +- 3.80     -0.00 kg (-0.00 sd)
  30% fat    with waist   30.59 +- 3.56     23.46 +- 3.39     +1.43 kg (+0.42 sd)
  25% fat    scale only   24.32 +- 3.98     17.58 +- 3.69     -4.45 kg (-1.20 sd)
  25% fat    with waist   27.30 +- 3.46     20.51 +- 3.25     -1.51 kg (-0.46 sd)

waist calibration with 30 % configured: posterior median and 90% interval
  waist_offset_cm         69.808  [61.410, 78.132]  shift +7.7%
  waist_slope_cm_per_kg    1.308  [1.023, 1.680]  shift +5.4%

What to notice

  • The tape narrows the fat interval by about a tenth. The day-119 standard deviation falls from 3.80 to 3.39 kg at 30 % configured, and from 3.69 to 3.25 kg at 25 %. The tape sees the product of a personal slope, known only to ±20 %, and the fat change, so it cannot pin fat mass down; it adds the population waist-to-fat relation as a second, independent anchor.
  • A wrong starting guess is where the tape earns its keep. With 25 % configured, the scale-only fit cannot correct the starting fat level and ends −4.45 kg off (−1.20 standard deviations). With the tape, day 0 moves to 27.30 kg and the day-119 error shrinks to −1.51 kg.
  • With a right guess, the tape adds a little bias. The prior line predicts 64.8 + 1.241 × 30 = 102.0 cm on day 0; the subject’s true line gives 75.0 + 1.2 × 29.43 = 110.3 cm. The filter splits that 8 cm between a larger offset (69.8 cm) and more fat (30.59 kg on day 0 instead of 29.19), so day 119 is off by +1.43 kg. Offset and fat level trade off, and only the ±7.2 cm prior on the offset decides the split.
  • The true subject is unusual for the prior: the true offset is (75.0 − 64.8) / 7.2 = 1.4 prior standard deviations above the population line. Both true waist values sit inside their posterior intervals.
  • Every error here is inside 1.645 standard deviations. The tape makes the intervals narrower without making them dishonest.

The code

What Where (under wdm)
The waist prior (Lean, Han and Deurenberg 1996) and the predicted waist models.observation: waist_prior, predict_waist
The waist block in the fit, added only when readings exist estimation.joint.fit_joint
The scalar unscented update for the tape filters.ukf.UnscentedResult.aux_innovation
The posterior of offset and slope estimation.joint.JointFit.waist_summaries
The configured body fat as the fat prior estimation.joint.initial_body_fat_fraction

Try this

  • Make the subject typical: set waist_offset_cm=70.0 in the spec. With 30 % configured, the with-waist fit’s day-119 fat mass then comes out at 22.69 kg (+0.67 kg), about half the bias above.
  • Read the tape daily (waist_every_days=1) and see how far the fat interval narrows when the slope uncertainty, not the reading noise, is the limit.
  • Configure 35 % body fat (5 points high). The tape cannot help here: this subject’s high true offset makes the readings look like extra fat, which is the direction of the error already made. The day-119 fat estimate barely moves, 26.58 kg from the scale alone and 26.63 kg with the tape, against a truth of 22.02; only the interval narrows.