# bellkilo/pai2d_mdp_languages architecture

> Architecture diagram of the GitHub repository bellkilo/pai2d_mdp_languages, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bellkilo/pai2d_mdp_languages
- Repository: https://github.com/bellkilo/pai2d_mdp_languages

## Overview

This package parses a supported subset of JANI and JANI-R into discrete-time Markov chain or MDP data, then builds Marmote objects; it can also export JANI-R and benchmark Marmote or MDPToolbox solvers. The principal flow is model input → reader/parser → model exploration and property selection → normalized MDP data → solver-ready object. The README documents these capabilities, while sampled source excerpts confirm key calls and conversions; some subsidiary parser behavior and benchmark internals are only partially shown.

Main entry points: [`janiParser/reader/reader.py`](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/reader.py) (JANI readers), [`janiParser/reader/model.py`](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/model.py) (Model exploration), [`janiParser/utils.py`](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/utils.py) (Benchmark runner), [`janiParser/dataMarmote.py`](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/dataMarmote.py) (Marmote adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_parsing["Parsing and model input"]
  node_reader["JANI readers<br/>[reader.py]"]
  node_errors["Parser errors<br/>[exception.py]"]
end

subgraph group_semantics["Model semantics"]
  node_model["Model exploration<br/>[model.py]"]
  node_automata["Automata edges<br/>[automata.py]"]
  node_expression["Expressions<br/>[expression.py]"]
  node_variable["Types and variables<br/>[variable.py]"]
  node_state["Runtime states<br/>[state.py]"]
  node_function["Functions<br/>[function.py]"]
  node_property["MDP properties<br/>[property.py]"]
end

subgraph group_conversion["MDP conversion"]
  node_mdpdata["MDP data<br/>[model.py]"]
  node_marmote["Marmote adapter<br/>[dataMarmote.py]"]
  node_jani_r["JANI-R export<br/>[dataMarmote.py]"]
end

subgraph group_benchmarking["Benchmarking"]
  node_marmote_solver["Marmote solver"]
  node_toolbox_solver["MDPToolbox solver"]
  node_benchmark["Benchmark runner<br/>[utils.py]"]
end

node_user(("Engineer"))
node_jani["JANI input"]

node_user -->|"selects model"| node_jani
node_jani -->|"parses input"| node_reader
node_reader -->|"builds model"| node_model
node_reader -->|"parses automata"| node_automata
node_reader -->|"parses expressions"| node_expression
node_reader -->|"parses variables"| node_variable
node_reader -->|"parses functions"| node_function
node_reader -->|"parses properties"| node_property
node_reader -->|"raises errors"| node_errors
node_model -->|"synchronizes edges"| node_automata
node_model -->|"explores states"| node_state
node_model -->|"evaluates guards"| node_expression
node_model -->|"uses variable types"| node_variable
node_model -->|"builds MDP data"| node_mdpdata
node_mdpdata -->|"converts data"| node_marmote
node_marmote -->|"creates solver model"| node_marmote_solver
node_marmote -->|"writes JANI-R"| node_jani_r
node_user -->|"requests timings"| node_benchmark
node_benchmark -->|"builds benchmark models"| node_reader
node_benchmark -->|"loads model data"| node_marmote
node_benchmark -->|"times solver"| node_marmote_solver
node_benchmark -->|"times solver"| node_toolbox_solver

click node_reader "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/reader.py"
click node_model "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/model.py"
click node_automata "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/automata.py"
click node_expression "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/expression.py"
click node_variable "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/variable.py"
click node_state "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/state.py"
click node_function "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/function.py"
click node_property "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/property.py"
click node_errors "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/exception.py"
click node_mdpdata "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/model.py"
click node_marmote "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/dataMarmote.py"
click node_benchmark "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/utils.py"
click node_jani_r "https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/dataMarmote.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_reader,node_errors toneBlue
class node_model,node_automata,node_expression,node_variable,node_state,node_function,node_property toneAmber
class node_mdpdata,node_marmote,node_jani_r toneMint
class node_marmote_solver,node_toolbox_solver,node_benchmark toneRose
class node_user,node_jani toneIndigo
```

## Components

### Parsing and model input

- [JANI readers](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/reader.py): `janiParser/reader/reader.py`
- [Parser errors](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/exception.py): `janiParser/exception.py`

### Model semantics

- [Model exploration](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/model.py): `janiParser/reader/model.py`
- [Automata edges](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/automata.py): `janiParser/reader/automata.py`
- [Expressions](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/expression.py): `janiParser/reader/expression.py`
- [Types and variables](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/variable.py): `janiParser/reader/variable.py`
- [Runtime states](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/state.py): `janiParser/reader/state.py`
- [Functions](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/function.py): `janiParser/reader/function.py`
- [MDP properties](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/property.py): `janiParser/reader/property.py`

### MDP conversion

- [MDP data](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/reader/model.py): `janiParser/reader/model.py`
- [Marmote adapter](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/dataMarmote.py): `janiParser/dataMarmote.py`
- [JANI-R export](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/dataMarmote.py): `janiParser/dataMarmote.py`

### Benchmarking

- **Marmote solver**
- **MDPToolbox solver**
- [Benchmark runner](https://github.com/bellkilo/pai2d_mdp_languages/blob/main/janiParser/utils.py): `janiParser/utils.py`

### Other components

- **Engineer**
- **JANI input**

## Connections

- Engineer → JANI input: selects model (evidence: `README.md`)
- JANI input → JANI readers: parses input (evidence: `README.md`)
- JANI readers → Model exploration: builds model (evidence: `janiParser/reader/reader.py`)
- JANI readers → Automata edges: parses automata (evidence: `janiParser/reader/reader.py`)
- JANI readers → Expressions: parses expressions (evidence: `janiParser/reader/reader.py`)
- JANI readers → Types and variables: parses variables (evidence: `janiParser/reader/reader.py`)
- JANI readers → Functions: parses functions (evidence: `janiParser/reader/reader.py`)
- JANI readers → MDP properties: parses properties (evidence: `janiParser/reader/reader.py`)
- JANI readers → Parser errors: raises errors (evidence: `janiParser/reader/reader.py`)
- Model exploration → Automata edges: synchronizes edges (evidence: `janiParser/reader/model.py`)
- Model exploration → Runtime states: explores states (evidence: `janiParser/reader/model.py`)
- Model exploration → Expressions: evaluates guards (evidence: `janiParser/reader/model.py`)
- Model exploration → Types and variables: uses variable types (evidence: `janiParser/reader/model.py`)
- Model exploration → MDP data: builds MDP data (evidence: `janiParser/reader/model.py`)
- MDP data → Marmote adapter: converts data (evidence: `README.md`)
- Marmote adapter → Marmote solver: creates solver model (evidence: `janiParser/dataMarmote.py`)
- Marmote adapter → JANI-R export: writes JANI-R (evidence: `janiParser/dataMarmote.py`)
- Engineer → Benchmark runner: requests timings (evidence: `README.md`)
- Benchmark runner → JANI readers: builds benchmark models (evidence: `janiParser/utils.py`)
- Benchmark runner → Marmote adapter: loads model data (evidence: `janiParser/utils.py`)
- Benchmark runner → Marmote solver: times solver (evidence: `janiParser/utils.py`)
- Benchmark runner → MDPToolbox solver: times solver (evidence: `janiParser/utils.py`)
