soil-moisture-utac 1.0.0

Real critical soil moisture threshold science (Fu et al. 2024, Qiao et al. 2023) -- land-atmosphere feedback tipping parameter, no UTAC/CREP bridge

soil-moisture-utac

GenesisAeon Package 90 — real critical soil moisture threshold science. Deliberately has no UTAC/CREP/AFET bridge — see DISCLAIMER.md.

What's real here

• Fu et al. (2024, Nature Communications): global mean critical soil moisture (CSM) threshold of 0.19 m³/m³, ranging from 0.12 m³/m³ (arid) to 0.26 m³/m³ (humid) ecosystems.
• Qiao et al. (2023, Nature Communications): soil-moisture-atmosphere coupling contributes an estimated 0.68±0.38°C to end-of-century global land warming, with regional hotspots up to 2.4°C.
• Explicitly not framed as a bistable tipping element like AMOC or the Amazon — see DISCLAIMER.md.

Quickstart

pip install soil-moisture-utac

from soil_moisture_utac import is_water_limited, GLOBAL_MEAN_CSM_M3_M3

print(f"Global mean critical soil moisture: {GLOBAL_MEAN_CSM_M3_M3} m3/m3")
print(f"Water-limited at 0.10 m3/m3? {is_water_limited(0.10)}")

Development

pip install -e ".[dev]"
pre-commit install
ruff check src tests
mypy src
pytest

Citation

See CITATION.cff and .zenodo.json.