aion-clinical 1.0.1

AION — Algebraic Interval Ontology for Clinical Networks. Formal mathematical model for clinical information systems.

AION — Algebraic Interval Ontology for Clinical Networks

Formal structure for consistent, time-aware clinical data.

---

Why AION?

Clinical data systems often produce inconsistent results.

Not because of missing interfaces —
but because time, semantics and causality are not modelled consistently.

Typical consequences:

• inconsistent analytics across systems
• manual correction logic in every project
• limited reliability for AI applications

AION solves this.

It provides a formal, executable model to:

• represent clinical events over time
• define and validate relationships between them
• ensure consistent interpretation across systems

---

Quick Start

pip install aion

from aion.core import Interval, classify
import datetime

dt = lambda h: datetime.datetime(2024, 1, 1, h, 0)

anaesthesia = Interval(dt(7), dt(12))
operation   = Interval(dt(8), dt(11))

print(classify(anaesthesia, operation))
# → AllenRelation.CONTAINS

👉 AION models relations between events, not just events themselves.

---

What makes AION different?

Most systems model clinical data as isolated events.

AION models:

• intervals instead of points
• relations instead of implicit assumptions
• causal structures instead of static data

This enables:

• consistent temporal reasoning
• reproducible analytics
• verifiable data models

---

Core Capabilities

Temporal Model

• Complete Allen interval algebra (13 relations)
• Fuzzy intervals with probabilistic reasoning

Data Model

• Universal clinical event model (6-tuple)
• Type system with hierarchy and schema evolution

Query & Analytics

• Cohort algebra
• temporal pattern languages

Causal Inference

• causal graphs
• do-operator
• structure learning

AI Integration

• formal AI component model
• explainability (Shapley, counterfactuals)

Privacy

• differential privacy (Laplace / Gaussian)
• federated computation

Interoperability

• FHIR mapping via structural homomorphism

---

Architecture Overview

aion/
├── core        Temporal algebra, event model
├── abstraction Episodes and trajectories
├── query       Cohort algebra
├── causal      Causal inference
├── privacy     Differential privacy
├── ai          AI model integration
├── explain     Explainability
├── schema      Schema evolution
└── adapters    FHIR mapping

---

Test Suite

pytest aion/tests/
# 326 tests, ~2s runtime

---

Positioning

AION is not:

• a data format
• a data warehouse
• a FHIR replacement

AION is:

the structural layer beneath clinical data systems

---

License & Citation

EUPL-1.2 — open source
Commercial licensing: [e-mail]

@software{aion2025,
  title  = {AION: Algebraic Interval Ontology for Clinical Networks},
  author = {Matten, Friedhelm},
  year   = {2025},
  url    = {https://codeberg.org/fm2-project/aion}
}

© Friedhelm Matten, ISCaD GmbH