Metadata-Version: 2.4
Name: napix-synthetic
Version: 1.0.0
Summary: Professional SDK for generating synthetic physiological data for AI training
Project-URL: Homepage, https://github.com/napix/napix-synthetic
Project-URL: Documentation, https://napix-synthetic.readthedocs.io
Project-URL: Repository, https://github.com/napix/napix-synthetic
License: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: numpy>=1.24
Requires-Dist: pandas>=2.0
Description-Content-Type: text/markdown

[![PyPI](https://img.shields.io/pypi/v/napix-synthetic)](https://pypi.org/project/napix-synthetic/)
[![Python](https://img.shields.io/pypi/pyversions/napix-synthetic)](https://pypi.org/project/napix-synthetic/)
[![License](https://img.shields.io/pypi/l/napix-synthetic)](https://github.com/napix/napix-synthetic/blob/main/LICENSE)

# NAPIX Synthetic Data Generator

A professional SDK for generating synthetic physiological data for AI training and simulation.

## Quick Start

```python
from napix_synthetic import SyntheticDataGenerator, ScenarioConfig

config = ScenarioConfig(
    organ="cardiovascular",
    severity=0.7,
    duration_minutes=30.0,
    dt=0.1
)

generator = SyntheticDataGenerator(config)
df = generator.generate()

print(df.head())
```

## Features

- **Severity‑Controlled Trends** — Deterioration rate scales with severity (0.0–1.0)
- **Physiological Realism** — MAP drops, HR rises, lactate climbs exponentially under shock
- **Shock State Progression** — compensated → decompensated → irreversible
- **Collapse Risk Metric** — 0–99% risk score aligned to trajectory
- **Configurable Duration & Resolution** — Control minutes and sampling interval

## Installation

```bash
pip install napix-synthetic
```

## Use Cases

- **AI Training** — Generate labelled shock trajectories for ML models
- **Simulation Testing** — Validate clinical decision support algorithms
- **Education** — Teach hemodynamic deterioration patterns
- **Benchmarking** — Compare predictor performance on controlled synthetic data

## License

MIT
