# scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics architecture

> Architecture diagram of the GitHub repository scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics
- Repository: https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics

## Overview

This repository contains two related microsimulation products: a seven-state cardiac-lineage model and a nine-state model that also represents two absorbing off-lineage outcomes. In each, Bayesian optimization proposes transition probabilities and state durations; repeated single-cell simulations become six-day population compositions, which the objective compares with experimental Excel data. The sampled source supports the simulation and data-loading calls shown below. The model READMEs document the differing state structures; unsampled implementation details are not inferred.

Main entry points: [`7C-MCM/run_bo_simulation_20260803.py`](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/run_bo_simulation_20260803.py) (Optimize and score), [`9C-MCM/run_bo_simulation_20260803.py`](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/run_bo_simulation_20260803.py) (Optimize and score), [`7C-MCM/simulate_population_mar3.py`](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/simulate_population_mar3.py) (Population sampling), [`9C-MCM/simulate_population_mar3.py`](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/simulate_population_mar3.py) (Population sampling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model7["7C lineage model"]
  node_bo7["Optimize and score"]
  node_population7["Population sampling"]
  node_engine7["Cell state simulation"]
  node_occupancy7["Daily occupancy"]
  node_loader7["Excel preprocessing<br/>[utils_mar3.py]"]
end

subgraph group_model9["9C branched model"]
  node_bo9["Optimize and score"]
  node_population9["Population sampling"]
  node_engine9["Cell state simulation"]
  node_occupancy9["Daily occupancy"]
  node_loader9["Excel preprocessing<br/>[utils_mar3.py]"]
end

subgraph group_inputs["Experimental data"]
  node_data7["7C experimental sheets"]
  node_data9["9C experimental sheets"]
end

node_gpyopt["GPyOpt"]

node_bo7 -->|"simulates candidates"| node_population7
node_bo7 -->|"loads measurements"| node_loader7
node_population7 -->|"simulates each cell"| node_engine7
node_population7 -->|"converts records"| node_occupancy7
node_loader7 -->|"reads sheets"| node_data7
node_bo7 -->|"configures optimizer"| node_gpyopt
node_bo9 -->|"simulates candidates"| node_population9
node_bo9 -->|"loads measurements"| node_loader9
node_population9 -->|"simulates each cell"| node_engine9
node_population9 -->|"converts records"| node_occupancy9
node_loader9 -->|"reads sheets"| node_data9
node_bo9 -->|"configures optimizer"| node_gpyopt

click node_bo7 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/run_bo_simulation_20260803.py"
click node_population7 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/simulate_population_mar3.py"
click node_engine7 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/simulation_engine_mar3.py"
click node_occupancy7 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/post_process_mar3.py"
click node_loader7 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/utils_mar3.py"
click node_bo9 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/run_bo_simulation_20260803.py"
click node_population9 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/simulate_population_mar3.py"
click node_engine9 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/simulation_engine_mar3.py"
click node_occupancy9 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/post_process_mar3.py"
click node_loader9 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/utils_mar3.py"
click node_data7 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/tree/main/7C-MCM/data"
click node_data9 "https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/tree/main/9C-MCM/data"

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_bo7,node_population7,node_engine7,node_occupancy7,node_loader7 toneBlue
class node_bo9,node_population9,node_engine9,node_occupancy9,node_loader9 toneAmber
class node_data7,node_data9 toneMint
class node_gpyopt toneIndigo
```

## Components

### 7C lineage model

- [Optimize and score](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/run_bo_simulation_20260803.py): `7C-MCM/run_bo_simulation_20260803.py`
- [Population sampling](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/simulate_population_mar3.py): `7C-MCM/simulate_population_mar3.py`
- [Cell state simulation](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/simulation_engine_mar3.py): `7C-MCM/simulation_engine_mar3.py`
- [Daily occupancy](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/post_process_mar3.py): `7C-MCM/post_process_mar3.py`
- [Excel preprocessing](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/7C-MCM/utils_mar3.py): `7C-MCM/utils_mar3.py`

### 9C branched model

- [Optimize and score](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/run_bo_simulation_20260803.py): `9C-MCM/run_bo_simulation_20260803.py`
- [Population sampling](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/simulate_population_mar3.py): `9C-MCM/simulate_population_mar3.py`
- [Cell state simulation](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/simulation_engine_mar3.py): `9C-MCM/simulation_engine_mar3.py`
- [Daily occupancy](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/post_process_mar3.py): `9C-MCM/post_process_mar3.py`
- [Excel preprocessing](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/blob/main/9C-MCM/utils_mar3.py): `9C-MCM/utils_mar3.py`

### Experimental data

- [7C experimental sheets](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/tree/main/7C-MCM/data): `7C-MCM/data`
- [9C experimental sheets](https://github.com/scremaschi-research-group/a-markov-chain-microsimulation-model-for-predicting-cell-type-population-dynamics/tree/main/9C-MCM/data): `9C-MCM/data`

### Other components

- **GPyOpt**

## Connections

- Optimize and score → Population sampling: simulates candidates (evidence: `7C-MCM/run_bo_simulation_20260803.py`)
- Optimize and score → Excel preprocessing: loads measurements (evidence: `7C-MCM/run_bo_simulation_20260803.py`)
- Population sampling → Cell state simulation: simulates each cell (evidence: `7C-MCM/simulate_population_mar3.py`)
- Population sampling → Daily occupancy: converts records (evidence: `7C-MCM/simulate_population_mar3.py`)
- Excel preprocessing → 7C experimental sheets: reads sheets (evidence: `7C-MCM/utils_mar3.py`)
- Optimize and score → GPyOpt: configures optimizer (evidence: `7C-MCM/run_bo_simulation_20260803.py`)
- Optimize and score → Population sampling: simulates candidates (evidence: `9C-MCM/run_bo_simulation_20260803.py`)
- Optimize and score → Excel preprocessing: loads measurements (evidence: `9C-MCM/run_bo_simulation_20260803.py`)
- Population sampling → Cell state simulation: simulates each cell (evidence: `9C-MCM/simulate_population_mar3.py`)
- Population sampling → Daily occupancy: converts records (evidence: `9C-MCM/simulate_population_mar3.py`)
- Excel preprocessing → 9C experimental sheets: reads sheets (evidence: `9C-MCM/utils_mar3.py`)
- Optimize and score → GPyOpt: configures optimizer (evidence: `9C-MCM/run_bo_simulation_20260803.py`)
