Metadata-Version: 2.4
Name: vrig-cosmological
Version: 1.0.0
Summary: v_RIG cosmological velocity scale: c/(alpha_inv*Phi) approx 1352 km/s -- GenesisAeon Package 31
Project-URL: Homepage, https://github.com/GenesisAeon/vrig-cosmological
Project-URL: Repository, https://github.com/GenesisAeon/vrig-cosmological
Project-URL: Zenodo, https://doi.org/10.5281/zenodo.17472834
Author: GenesisAeon
License-Expression: GPL-3.0-or-later
License-File: LICENSE
License-File: LICENSE-CODE
License-File: LICENSE-DOCS
Keywords: CREP,Fisher-Rao,UTAC,cosmology,fine-structure-constant,golden-ratio,information-geometry,peculiar-velocity,v_RIG
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.11
Requires-Dist: numpy>=1.26
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7.0
Requires-Dist: typer>=0.12.0
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'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
Description-Content-Type: text/markdown

# vrig-cosmological

**v_RIG cosmological velocity scale** — `v_RIG = c / (α⁻¹ · Φ) ≈ 1352 km/s`

[![CI](https://github.com/GenesisAeon/vrig-cosmological/actions/workflows/ci.yml/badge.svg)](https://github.com/GenesisAeon/vrig-cosmological/actions/workflows/ci.yml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org)
[![License: GPLv3-or-later](https://img.shields.io/badge/code-GPLv3--or--later-blue.svg)](LICENSE-CODE)
[![Docs License: CC BY 4.0](https://img.shields.io/badge/docs-CC%20BY%204.0-lightgrey.svg)](LICENSE-DOCS)

A falsifiable cosmological velocity scale derived from the fine-structure
constant α and the golden ratio Φ. Implements the Fisher-Rao information-
geometric interpretation, ERA5-style spike detection, and cosmological
survey comparisons. GenesisAeon Package 31.

## Installation

```bash
pip install vrig-cosmological
```

## Usage

```python
from vrig_cosmological import VRIGCosmological

sys = VRIGCosmological()
result = sys.run_cycle(duration_years=83.0)

print(sys.v_rig_value())   # ≈ 1352.118... km/s
print(sys.spike_times())   # detected v_RIG spike years
print(sys.get_crep_state())
print(sys.to_zenodo_record())
```

Or use the calculator directly:

```python
from vrig_cosmological import compute_vrig

result = compute_vrig()
print(result.v_rig_km_s, result.uncertainty_km_s)
```

A CLI is also available — see [docs/cli.md](docs/cli.md).

## Role in the GenesisAeon Ecosystem

`vrig-cosmological` is **P31** in the GenesisAeon ecosystem, covering the
**information geometry / cosmological velocity** domain. It implements the
standard GenesisAeon Diamond Interface (`run_cycle`, `get_crep_state`,
`get_utac_state`, `get_phase_events`, `to_zenodo_record`) so it can be
orchestrated alongside other ecosystem packages (CREP coupling, UTAC
state tracking, Zenodo-ready records).

## Development

```bash
git clone https://github.com/GenesisAeon/vrig-cosmological.git
cd vrig-cosmological
pip install -e ".[dev]"
pytest --cov=src
ruff check src tests
mypy src
```

## Citation

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.PLACEHOLDER.svg)](https://doi.org/10.5281/zenodo.PLACEHOLDER)

DOI will be assigned automatically on first GitHub Release once
Zenodo–GitHub integration is enabled for this repo.

## License

Dual-licensed:
- **Code**: [GNU GPLv3-or-later](LICENSE-CODE)
- **Documentation** (README, `docs/`): [CC BY 4.0](LICENSE-DOCS)

See [LICENSE](LICENSE) for details.
