Metadata-Version: 2.4
Name: prophesy-cib
Version: 2.0.0
Summary: Cross-Impact Balances analysis with succession, perturbation, and sensitivity analysis
Author: Norman M. Kearney
License: GPL-3.0-or-later
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Python: >=3.11
Requires-Dist: numpy>=1.26
Requires-Dist: tqdm>=4.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# Prophesy
[![DOI](https://zenodo.org/badge/1179792781.svg)](https://doi.org/10.5281/zenodo.18986525)

Prophesy is a Python package for Cross-Impact Balance (CIB) analysis, supporting scenario generation, succession analysis, perturbation testing, and pathway exploration across multiple model variants.

## Installation

```bash
pip install prophesy-cib
```

Requires Python >= 3.11.

## Features

- Succession analysis
- Scenario analysis
- Perturbation analysis and leverage point identification
- Pathway analysis
- Sensitivity analysis across model variants
- Discrete Maximin experimental designs
- Descriptive statistics and diagnostics

## Usage

```python
from prophesy_cib import Project, ScenarioConfig

# Create a project and load a cross-impact matrix
project = Project("my_analysis")
project.load_base_model("impacts.csv")

# Run scenario analysis
project.configure_scenario(ScenarioConfig())
results = project.run_scenario_analysis()
```

See the [Quick Start guide](docs/QUICK_START.md) for a full walkthrough, or the [manual](docs/Prophesy_Manual.pdf) for complete reference documentation.

## Citation

If you use Prophesy, please cite the Zenodo DOI.

## License

GPL-3.0-or-later. See [LICENSE](LICENSE).

## Author

Norman M. Kearney

## Acknowledgements

The Python version of Prohpesy (v2.0.0) was developed with assistance from Claude Code (Anthropic AI).