dckiller51/bodymiscale 2026.4.4

on GitHub

2026.4.4

⚠️ IMPORTANT: Scientific Engine Overhaul

This version replaces the experimental Lukaski-based equations with a more robust clinical model specifically optimized for S400 dual-frequency hardware. Users may notice slight shifts in their metrics as we move towards higher physiological accuracy and better medical alignment.

🚀 S400 Dual-Frequency Enhancements

• Full Engine Replacement: Replaced experimental Lukaski core with a clinical-grade multi-frequency suite:

  • LBM: New hardware-calibrated equation utilizing $Z_{lf}$ (50 kHz) to eliminate the "over-fat" bias common in consumer foot-to-foot scales.
  • TBW (Total Body Water): Implemented Deurenberg et al. (1995) utilizing $Z_{hf}$ (250 kHz), offering superior validation against isotope dilution.
  • ECW (Extracellular Water): Introduced De Lorenzo et al. (1997) for precise fluid partitioning.
  • BMR: Replaced statistical models with Katch-McArdle (1996) (370 + 21.6 × LBM). This prioritizes actual measured Lean Body Mass, providing much higher accuracy for athletic or overweight users.
  • Metabolic Age: Now calculated using a BMR-relative ratio, reflecting actual metabolic health based on measured cellular activity.

• New Exclusive Metrics: Unlocked 5 clinical sensors for dual-frequency mode:

  • extracellular_water (ECW) & intracellular_water (ICW).
  • ecw_tbw_ratio: Key indicator for hydration and nutritional status (Normal: 37–39%).
  • body_cell_mass (BCM): The metabolically active compartment of your body.
  • skeletal_muscle_mass (SMM): Janssen et al. (2000) equation, validated against MRI.

🧪 Science & Global Changes

• BMR (Science Mode): Standardized to the Schofield (WHO) equation for all non-dual
  devices, ensuring alignment with international health standards.
• Water (Science Mode): Now uses the Pace & Rathbun (1945) constant (73% of lean mass)
  instead of the Xiaomi 70% factor, for better physiological accuracy.
• Protein Calculation: Shifted to the Wang et al. (1999) molecular compartment model.
  Proteins are now calculated as a stable 19.5% fraction of LBM for better cross-metric
  consistency (applies to both Science and S400 modes).
• Body Score: Minimum score clamped to 10 (previously 0) to distinguish a
  low-but-measurable result from an unavailable metric.
• Home Assistant Integration: New sensor entities for the 5 S400 metrics are created
  automatically when impedance_mode: dual is detected.