Parameters & Constants¶

EohParams¶

Module: hours_eoh/params.py

EohParams is a mutable parameter container with change tracking. All core/ functions accept an optional p: EohParams argument.

from hours_eoh.params import EohParams

p = EohParams()                              # default values
p.set("suff_levy_rate", 0.03, reason="...")  # calibration-path change (recorded in history)

with p.temporary(suff_levy_rate=0.03):       # sweep code — restores state on exit, no history
    result = eoh_to_teh_pipeline(0.40, p=p)

Key methods¶

Method	Description
`p.set(key, value, reason=...)`	Persist a parameter change; records in change history
`p.temporary(**overrides)`	Context manager for sweep code — restores state on exit
`p.diff()`	Show all active overrides relative to defaults
`p.reset()`	Clear all overrides

Rule: Use p.set() for calibration-path changes. Use p.temporary() in sweep/scenario code — it restores state on exit and adds no history entries.

data.py — Named Constants¶

Module: hours_eoh/data.py

Single source of truth for all named constants. No anonymous numeric literals anywhere in domain logic. Every calibrated value must be a named constant here before use.

Key constant groups¶

EOH Generation

Constant	Value	Description
`CANONICAL_CAPITAL_STOCK_BASE`	—	Base capital stock on canonical arc
`CANONICAL_ECOSYSTEM_HEALTH_BASE`	—	Baseline ecosystem health index
`CANONICAL_KNOWLEDGE_BASE_SIZE`	—	Baseline knowledge units
`PERSONAL_EOH_BASE`	—	Per-person biological entropy obligation

Fiscal

Constant	Description
`DEFAULT_LEVY_RATE`	Default labor levy rate
`SUFFICIENCY_TEH_FLOOR`	Nominal TEH floor for sufficiency guarantee
`ACCUMULATION_CEILING_MULTIPLIER`	TEH accumulation cap multiplier

GUF / Land

Constant	Description
`GUF_PSI_A`	Ψ(ε) shape parameter a = 0.8
`GUF_PSI_B`	Ψ(ε) shape parameter b = 1.2
`GUF_PSI_FLOOR`	Ψ(ε) floor = 0.02
`GUF_ALPHA_FLOOR`	α(ε) floor = 0.05
`GUF_SOIL_CREDIT_RATE`	c_soil credit rate = 0.05
`GUF_WRITEDOWN_AMORTIZATION_YEARS`	Y_r = 50 years
`GUF_EOH_ACCUMULATION_THRESHOLD`	Warning threshold = 0.30

Conditions

Constant	Description
`MULTIPLIER_BAND_TARGET`	Target population-weighted multiplier = 2.1
`MULTIPLIER_BAND_MIN`	Lower band = 1.8
`MULTIPLIER_BAND_MAX`	Upper band (design) = 2.1
`MULTIPLIER_MAX`	Individual cap = 6.0
`COMPETENCY_RESERVE_THRESHOLD`	Condition IV minimum = 0.155 (15.5%)

Add new constants to data.py before using them anywhere in the codebase. Use the CANONICAL_ prefix for canonical trajectory constants.