Metadata-Version: 2.4
Name: methane-hydrates-utac
Version: 1.0.0
Summary: Real methane hydrate destabilization science (Ruppel & Kessler 2017, Hong et al. 2017) -- slow centuries-scale carbon store, explicitly NOT clathrate-gun alarmism, no UTAC/CREP bridge
Project-URL: Homepage, https://github.com/GenesisAeon/methane-hydrates-utac
Project-URL: Repository, https://github.com/GenesisAeon/methane-hydrates-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

# methane-hydrates-utac

[![GenesisAeon](https://img.shields.io/badge/GenesisAeon-P92-blue)](https://github.com/GenesisAeon)
[![CI](https://github.com/GenesisAeon/methane-hydrates-utac/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/methane-hydrates-utac/actions/workflows/ci.yml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

GenesisAeon Package 92 — real methane hydrate destabilization science.
**Deliberately has no UTAC/CREP/AFET bridge, and explicitly rejects the
"clathrate gun" scenario** — see [DISCLAIMER.md](DISCLAIMER.md).

## What's real here

- Ruppel & Kessler (2017, *Reviews of Geophysics*): global hydrate carbon
  inventory ~1800 GtC; only ~3.5% (~63 GtC, shallow marine) can respond
  to warming even on a centennial timescale.
- Hong et al. (2017, *Nature Communications*): direct field evidence that
  short-term ocean warming has limited impact on hydrate stability.
- Explicitly **NOT** the "clathrate gun hypothesis" — see
  [DISCLAIMER.md](DISCLAIMER.md).

## Quickstart

```bash
pip install methane-hydrates-utac
```

```python
from methane_hydrates_utac import is_plausible_release_timescale

print(is_plausible_release_timescale(20))   # False -- too fast, not supported by evidence
print(is_plausible_release_timescale(150))  # True -- centennial-scale, consistent with the literature
```

## 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).
