# dashing-dev/multi-hop-baseline-model architecture

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

- Interactive diagram: https://gitdiagram.com/dashing-dev/multi-hop-baseline-model
- Repository: https://github.com/dashing-dev/multi-hop-baseline-model

## Overview

This is a reproducible research package for an idealized multi-hop wireless energy model. Its main workflow runs a baseline and parameter-sweep experiments, records validation and numerical results, and produces figures and a run manifest. The standalone `model_v1.py` also implements and reports the model. The excerpts show experiment orchestration and output writing, but omit some internal calls; the graph avoids inferring those links.

Main entry points: [`model_v1_experiments.py`](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py) (Experiment driver), [`v1_results`](https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results) (Timestamped results), [`v1_results/run_20260820T045617Z`](https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results/run_20260820T045617Z) (Numerical CSVs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model["Energy model"]
  node_standalone["Standalone model<br/>[model_v1.py]"]
end

subgraph group_experiments["Experiment runs"]
  node_experiment_driver["Experiment driver"]
  node_scenario_config["Scenario config"]
  node_sweep_runner["Sweep runner"]
  node_validation["Scaling validation"]
  node_summary["Result summaries"]
  node_figures["Baseline figures"]
end

subgraph group_records["Run records"]
  node_run_store[("Timestamped results")]
  node_csv_records["Numerical CSVs"]
  node_run_metadata["Run metadata"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs"| node_experiment_driver
node_experiment_driver -->|"uses baseline"| node_scenario_config
node_experiment_driver -->|"runs sweeps"| node_sweep_runner
node_experiment_driver -->|"records validation"| node_validation
node_experiment_driver -->|"creates figures"| node_figures
node_experiment_driver -->|"creates run"| node_run_store
node_experiment_driver -->|"writes tables"| node_csv_records
node_experiment_driver -->|"writes manifest"| node_run_metadata
node_experiment_driver -->|"summarizes results"| node_summary

click node_standalone "https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1.py"
click node_experiment_driver "https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py"
click node_scenario_config "https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py"
click node_sweep_runner "https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py"
click node_validation "https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py"
click node_summary "https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py"
click node_figures "https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py"
click node_run_store "https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results"
click node_csv_records "https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results/run_20260820T045617Z"
click node_run_metadata "https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results/run_20260820T045617Z"

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_standalone toneBlue
class node_experiment_driver,node_scenario_config,node_sweep_runner,node_validation,node_summary,node_figures toneAmber
class node_run_store,node_csv_records,node_run_metadata toneMint
class node_researcher toneIndigo
```

## Components

### Energy model

- [Standalone model](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1.py): `model_v1.py`

### Experiment runs

- [Experiment driver](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py): `model_v1_experiments.py`
- [Scenario config](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py): `model_v1_experiments.py`
- [Sweep runner](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py): `model_v1_experiments.py`
- [Scaling validation](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py): `model_v1_experiments.py`
- [Result summaries](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py): `model_v1_experiments.py`
- [Baseline figures](https://github.com/dashing-dev/multi-hop-baseline-model/blob/main/model_v1_experiments.py): `model_v1_experiments.py`

### Run records

- [Timestamped results](https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results): `v1_results`
- [Numerical CSVs](https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results/run_20260820T045617Z): `v1_results/run_20260820T045617Z`
- [Run metadata](https://github.com/dashing-dev/multi-hop-baseline-model/tree/main/v1_results/run_20260820T045617Z): `v1_results/run_20260820T045617Z`

### Other components

- **Researcher**

## Connections

- Researcher → Experiment driver: runs (evidence: `README.md`)
- Experiment driver → Scenario config: uses baseline (evidence: `model_v1_experiments.py`)
- Experiment driver → Sweep runner: runs sweeps (evidence: `model_v1_experiments.py`)
- Experiment driver → Scaling validation: records validation (evidence: `model_v1_experiments.py`)
- Experiment driver → Baseline figures: creates figures (evidence: `model_v1_experiments.py`)
- Experiment driver → Timestamped results: creates run (evidence: `model_v1_experiments.py`)
- Experiment driver → Numerical CSVs: writes tables (evidence: `model_v1_experiments.py`)
- Experiment driver → Run metadata: writes manifest (evidence: `model_v1_experiments.py`)
- Experiment driver → Result summaries: summarizes results (evidence: `model_v1_experiments.py`)
