Metadata-Version: 2.4
Name: psi-continuum-statespace
Version: 0.1.0
Summary: Macroscopic state-space diagnostics for late-time cosmic expansion
Author: Dmitry V. Klimov
License-Expression: MIT
Project-URL: Homepage, https://github.com/dmitrylife/psi-continuum-statespace
Project-URL: Documentation, https://psi-continuum.org/docs/v5/
Project-URL: Project, https://psi-continuum.org/theory.html
Project-URL: Source, https://github.com/dmitrylife/psi-continuum-statespace
Project-URL: Issues, https://github.com/dmitrylife/psi-continuum-statespace/issues
Keywords: cosmology,state-space diagnostics,late-time acceleration,dark energy,LCDM,phenomenological cosmology,observational cosmology
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.22
Requires-Dist: matplotlib>=3.6
Requires-Dist: psi-continuum-v2>=0.2.3
Dynamic: license-file

# Psi–Continuum State-Space Diagnostics

This repository hosts diagnostic tools for the Psi–Continuum cosmology
framework, providing a macroscopic state-space representation of
late-time cosmic expansion.

The state-space construction is implemented as a derived diagnostic
based on a fixed background-level implementation,
consistent with Psi–Continuum Cosmology v2.

---

## Scope

This package implements **diagnostic state-space analysis only**.

It does not introduce new cosmological models, modify gravitational
dynamics, alter the Psi–Continuum v2 API, or perform parameter fitting.
All results are derived exclusively from background expansion histories
provided by the frozen v2 implementation.

The package is designed to support transparent and fully reproducible
state-space diagnostics at the background level.

---

## Current status

- Core state-space diagnostic framework implemented
- Interactive command-line interface available
- Reproducible numerical metrics and publication-ready figures supported

---

## Repository Structure

```text
psi-continuum-statespace
├── CITATION.cff
├── LICENSE
├── psi_continuum_statespace
│   ├── cli.py
│   ├── consistency.py
│   ├── diagnostics.py
│   ├── __init__.py
│   ├── plotting.py
│   └── psi.py
├── publication
│   ├── fig1_state_space.png
│   └── README.md
├── pyproject.toml
├── README.md
└── requirements.txt
```

## Usage

The package provides a command-line interface for exploratory and
diagnostic use. All files generated by the CLI are runtime artefacts and
do not represent published results.

Example usage (interactive shell):

```bash
psi-statespace interactive
```

---

### Installation from source (clone repository)

```bash
git clone https://github.com/dmitrylife/psi-continuum-statespace.git
cd psi-continuum-statespace
python3 -m venv sci_venv
source sci_venv/bin/activate
```

### (Optional) Install the package as editable

```bash
pip install -e .
```

---

## Relation to the publication

This repository serves as a companion diagnostic implementation for the
article:

“Psi–Continuum Cosmology v5:
A Macroscopic State–Space Response Framework for Late–Time Cosmic Expansion”

The finalized figures used in the article are provided separately in the
`publication/` directory for reference.

## License

This project is licensed under the terms of the MIT License.
See the **LICENSE** file for details.

---

## Citation

If you use this software or the associated state-space diagnostics in
academic work, please cite the corresponding article:


```
Dmitry Vasilevich Klimov (2025).
Psi–Continuum Cosmology v5:
A Macroscopic State–Space Response Framework
for Late–Time Cosmic Expansion.
Zenodo preprint. DOI: 10.5281/zenodo.18088720
```

---

## Contact

 - Email: d.klimov.psi@gmail.com
 - Website: https://psi-continuum.org
