Metadata-Version: 2.4
Name: aion-clinical
Version: 2.0.0
Summary: Formale Wissensrepräsentation klinischer Verläufe – §3–§22 (FM-3)
Author-email: Friedhelm Matten <licensing@iscad-it.de>
Maintainer-email: ISCaD GmbH <licensing@iscad-it.de>
License-Expression: EUPL-1.2
Project-URL: Homepage, https://codeberg.org/iscad/aion-clinical
Project-URL: Documentation, https://iscad-it.de/aion-clinical/docs
Project-URL: Repository, https://codeberg.org/iscad/aion-clinical
Project-URL: Bug Tracker, https://codeberg.org/iscad/aion-clinical/issues
Project-URL: Citation, https://doi.org/10.5281/zenodo.19548857
Project-URL: Changelog, https://codeberg.org/iscad/aion-clinical/src/branch/main/CHANGELOG.md
Keywords: clinical-informatics,HL7v2,FHIR,differential-privacy,causal-inference,AION,knowledge-representation,MDR,medical-decision-support,interoperability
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6.0
Provides-Extra: api
Requires-Dist: fastapi>=0.110; extra == "api"
Requires-Dist: uvicorn[standard]>=0.27; extra == "api"
Requires-Dist: pydantic>=2.6; extra == "api"
Requires-Dist: python-multipart>=0.0.9; extra == "api"
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.29; extra == "postgres"
Provides-Extra: mllp
Requires-Dist: redis>=5.0; extra == "mllp"
Provides-Extra: oidc
Requires-Dist: python-jose[cryptography]>=3.3; extra == "oidc"
Provides-Extra: monitoring
Requires-Dist: prometheus_client>=0.20; extra == "monitoring"
Provides-Extra: federation
Provides-Extra: fhir
Requires-Dist: fhir.resources>=7.1; extra == "fhir"
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.23; extra == "test"
Requires-Dist: httpx>=0.27; extra == "test"
Provides-Extra: full
Requires-Dist: aion-clinical[api,fhir,mllp,monitoring,oidc,postgres]; extra == "full"
Dynamic: license-file

# AION Clinical 2.0.0

**Formale Wissensrepräsentation klinischer Verläufe** – Referenzimplementierung der Abschnitte §3–§22 des Papers FM-3 ([10.5281/zenodo.19548857](https://doi.org/10.5281/zenodo.19548857)).

Copyright 2026 Friedhelm Matten / ISCaD GmbH – EUPL-1.2

## Installation

```bash
# Kern (stdlib-only, sehr leicht)
pip install aion-clinical

# Mit REST-API + PostgreSQL + Monitoring
pip install "aion-clinical[api,postgres,monitoring]"

# Komplettes Produktionspaket
pip install "aion-clinical[full]"
```

## Paper-Implementierung

| § | Modul | Beschreibung |
|---|-------|--------------|
| §11 | `aion.query.language` | Formale Abfragesprache (Kohortenformeln) |
| §15 | `aion.causal.pc_algorithm` | PC-Algorithmus + Bootstrap |
| §18 | `aion.schema_evolution`, `aion.schema_registry` | Schemaevolution |
| §20 | `aion.privacy.dp`, `aion.federation` | Differential Privacy + Föderierung |
| §21 | `aion.ai.components`, `aion.ai.trajectories` | KI-Komponenten (7 Schichten) |
| §22 | `aion.explain.shapley` | Erklärbarkeit (Shapley, kontrafaktisch, suffizient, beschränkt) |

## Schnellstart

```python
from aion.privacy.dp import LocalDP

# Lokale DP-Abfrage
dp = LocalDP(epsilon=1.0)
noisy_count = dp.release_local_count(true_count=42)
print(f"Noisy: {noisy_count:.1f}")
```

```python
from aion.causal.pc_algorithm import PCAlgorithm

# Kausalstruktur lernen
pc = PCAlgorithm(alpha=0.05)
graph = pc.fit(data)
print(graph.adjacency())
```

```python
from aion.explain.shapley import bounded_explanation

# Beschränkte Erklärung (§22.5)
result = bounded_explanation(events, feature_fn, model_fn, k_max=5)
print(result.selected_events)  # garantiert |S| ≤ 5
```

## REST-API starten

```bash
pip install "aion-clinical[full]"
aion  # → http://localhost:8000
```

## Zitation

```bibtex
@article{matten2026aion,
  title  = {Formale Wissensrepräsentation klinischer Verläufe},
  author = {Matten, Friedhelm},
  year   = {2026},
  doi    = {10.5281/zenodo.19548857},
  url    = {https://zenodo.org/records/19548857},
}
```

## Lizenz

EUPL-1.2 (European Union Public Licence). Siehe [LICENSE](LICENSE).
