Metadata-Version: 2.5
Name: black-carbon-albedo-utac
Version: 1.0.1
Summary: Black carbon / light-absorbing-particle albedo feedback on glaciers -- Kang et al. 2020's mechanism review, Li et al. 2017's Central Tibetan Plateau melt-enhancement case, and Yang/Kang/Chen et al. 2025's plateau-wide solid-water-storage decline study -- a new atmospheric-deposition lens on the P99-P104 series, contrasting aerosol-masking-utac's global cooling effect, no UTAC/CREP bridge
Project-URL: Homepage, https://github.com/GenesisAeon/black-carbon-albedo-utac
Project-URL: Repository, https://github.com/GenesisAeon/black-carbon-albedo-utac
Author: Römer, Johann
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Description-Content-Type: text/markdown

# black-carbon-albedo-utac

GenesisAeon Package 105 — black carbon / light-absorbing-particle
albedo feedback on glaciers. A new lens on the P99–P104 series:
atmospheric deposition physics, not water balance, geophysics, or
governance. **Deliberately has no UTAC/CREP/AFET bridge** — see
[DISCLAIMER.md](DISCLAIMER.md).

For a plain-language explanation of the same topic (German, no jargon,
written for general audiences), see [WHITEPAPER.md](WHITEPAPER.md).

## The core idea

Soot and other light-absorbing particles deposited on snow/ice reduce
albedo, increase absorbed solar radiation, and directly accelerate
melt — a mechanism independent of, and additional to, greenhouse-gas
warming. It's also a **positive feedback**: as darkened ice melts, the
black carbon within it concentrates at the surface exactly where melt
is already happening, further darkening it.

A deliberate, honest contrast to this ecosystem's
[aerosol-masking-utac](https://github.com/GenesisAeon/aerosol-masking-utac):
there, aerosols mask warming globally (a cooling effect, from reduced
shipping-fuel sulfate). Here, aerosols deposited on the cryosphere
accelerate melt locally (a warming effect, from black carbon). Same
broad class of atmospheric particles, opposite climate role depending
on where they end up.

## What's real here

- **Kang, Zhang, Qian & Wang (2020, *Earth-Science Reviews*)** — the
  foundational synthesis review of the mechanism: BC concentrations in
  glacier ablation-zone aged snow/ice are commonly 1–3 orders of
  magnitude higher than in accumulation-zone fresh snow, as the
  darkening/melt/re-concentration cycle self-reinforces.
- **Li et al. (2017, *Science of the Total Environment*)** — a real,
  measured case: light-absorbing impurities enhanced summer melt on
  the Xiao Dongkemadi Glacier, central Tibetan Plateau, by **~15%**
  (2014–2015 field seasons).
- **Yang, Kang, Chen et al. (2025, *Communications Earth &
  Environment*)** — a real, decade-long (2007–2016), plateau-wide
  study separating BC's direct effect (albedo → melt, **+7.5%**) from
  its indirect effect (BC-suppressed precipitation → **+6.1%**
  additional mass loss), against a total observed solid-water-storage
  decline of **33.7%** — explicitly **not** the same number as BC's
  own combined contribution (13.6 percentage points, about 40% of the
  total decline). See `bc_attributable_fraction_of_total_decline()`.

## Quickstart

```bash
pip install black-carbon-albedo-utac
```

```python
from black_carbon_albedo_utac import (
    is_positive_feedback,
    ablation_zone_enrichment_range,
    XIAO_DONGKEMADI_2017,
    TIBETAN_PLATEAU_2025,
    bc_total_effect_pct,
    bc_attributable_fraction_of_total_decline,
)

print(is_positive_feedback())              # True
print(ablation_zone_enrichment_range())    # (1, 3)
print(XIAO_DONGKEMADI_2017.melt_enhancement_pct)  # 15.0
print(TIBETAN_PLATEAU_2025.total_storage_decline_pct)  # 33.7
print(bc_total_effect_pct())               # 13.6 -- NOT the 33.7% total
print(bc_attributable_fraction_of_total_decline())  # ~0.40
```

## Development

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

## Citation

See [CITATION.cff](CITATION.cff) and [.zenodo.json](.zenodo.json).
