# parikshit75/appbench architecture

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

- Interactive diagram: https://gitdiagram.com/parikshit75/appbench
- Repository: https://github.com/parikshit75/appbench

## Overview

This repository packages a BabelStream benchmark workflow: run a benchmark through a harness, capture run provenance, turn its output into records, then aggregate records into reports. The README also identifies JUBE, source builds, Spack, and post-processing as product capabilities. Their exact paths are shown, but the harness and build recipes were not sampled, so their runtime connections are left out. The sampled Python code supports the CLI-to-processing relationships shown below.

Main entry points: [`babelstream/babelbench/src/babelbench/cli.py`](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/cli.py) (babelbench CLI), [`babelstream/babelbench/src/babelbench/context.py`](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/context.py) (Provenance capture), [`babelstream/babelbench/src/babelbench/record.py`](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/record.py) (Record builder), [`babelstream/babelbench/src/babelbench/report.py`](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/report.py) (Report generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_benchmark["Benchmark setup"]
  node_babelstream["BabelStream"]
  node_jube["JUBE harness"]
  node_sourcebuild["Source build"]
  node_spackbuild["Spack build<br/>[build.spack.yaml]"]
end

subgraph group_capture["Run capture"]
  node_cli["babelbench CLI<br/>[cli.py]"]
  node_context["Provenance capture<br/>[context.py]"]
  node_metadata["Version metadata<br/>[metadata.py]"]
end

subgraph group_processing["Record processing"]
  node_record["Record builder<br/>[record.py]"]
  node_parse["Output parser<br/>[parse.py]"]
  node_artifacts["Run artifacts"]
end

subgraph group_reporting["Reporting"]
  node_report["Report generator<br/>[report.py]"]
  node_results["Result artifacts"]
end

node_user(("Benchmark operator"))

node_user -->|"invokes"| node_cli
node_cli -->|"captures context"| node_context
node_cli -->|"builds records"| node_record
node_cli -->|"generates reports"| node_report
node_context -->|"reads version"| node_metadata
node_cli -->|"reads version"| node_metadata
node_record -->|"parses output"| node_parse
node_cli -->|"writes records"| node_artifacts
node_report -->|"writes reports"| node_results

click node_babelstream "https://github.com/parikshit75/appbench/tree/main/babelstream"
click node_jube "https://github.com/parikshit75/appbench/tree/main/babelstream/jube"
click node_sourcebuild "https://github.com/parikshit75/appbench/blob/main/babelstream/jube/build.easybuild.yaml"
click node_spackbuild "https://github.com/parikshit75/appbench/blob/main/babelstream/jube/build.spack.yaml"
click node_cli "https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/cli.py"
click node_context "https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/context.py"
click node_metadata "https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/metadata.py"
click node_record "https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/record.py"
click node_parse "https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/parse.py"
click node_artifacts "https://github.com/parikshit75/appbench/tree/main/babelstream/babelbench"
click node_report "https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/report.py"
click node_results "https://github.com/parikshit75/appbench/tree/main/results/babelstreams/2026-09-23"

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_babelstream,node_jube,node_sourcebuild,node_spackbuild toneBlue
class node_cli,node_context,node_metadata toneAmber
class node_record,node_parse,node_artifacts toneMint
class node_report,node_results toneRose
class node_user toneIndigo
```

## Components

### Benchmark setup

- [BabelStream](https://github.com/parikshit75/appbench/tree/main/babelstream): `babelstream`
- [JUBE harness](https://github.com/parikshit75/appbench/tree/main/babelstream/jube): `babelstream/jube`
- [Source build](https://github.com/parikshit75/appbench/blob/main/babelstream/jube/build.easybuild.yaml): `babelstream/jube/build.easybuild.yaml`
- [Spack build](https://github.com/parikshit75/appbench/blob/main/babelstream/jube/build.spack.yaml): `babelstream/jube/build.spack.yaml`

### Run capture

- [babelbench CLI](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/cli.py): `babelstream/babelbench/src/babelbench/cli.py`
- [Provenance capture](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/context.py): `babelstream/babelbench/src/babelbench/context.py`
- [Version metadata](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/metadata.py): `babelstream/babelbench/src/babelbench/metadata.py`

### Record processing

- [Record builder](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/record.py): `babelstream/babelbench/src/babelbench/record.py`
- [Output parser](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/parse.py): `babelstream/babelbench/src/babelbench/parse.py`
- [Run artifacts](https://github.com/parikshit75/appbench/tree/main/babelstream/babelbench): `babelstream/babelbench`

### Reporting

- [Report generator](https://github.com/parikshit75/appbench/blob/main/babelstream/babelbench/src/babelbench/report.py): `babelstream/babelbench/src/babelbench/report.py`
- [Result artifacts](https://github.com/parikshit75/appbench/tree/main/results/babelstreams/2026-09-23): `results/babelstreams/2026-09-23`

### Other components

- **Benchmark operator**

## Connections

- Benchmark operator → babelbench CLI: invokes (evidence: `babelstream/babelbench/src/babelbench/cli.py`)
- babelbench CLI → Provenance capture: captures context (evidence: `babelstream/babelbench/src/babelbench/cli.py`)
- babelbench CLI → Record builder: builds records (evidence: `babelstream/babelbench/src/babelbench/cli.py`)
- babelbench CLI → Report generator: generates reports (evidence: `babelstream/babelbench/src/babelbench/cli.py`)
- Provenance capture → Version metadata: reads version (evidence: `babelstream/babelbench/src/babelbench/context.py`)
- babelbench CLI → Version metadata: reads version (evidence: `babelstream/babelbench/src/babelbench/cli.py`)
- Record builder → Output parser: parses output (evidence: `babelstream/babelbench/src/babelbench/record.py`)
- babelbench CLI → Run artifacts: writes records (evidence: `babelstream/babelbench/src/babelbench/cli.py`)
- Report generator → Result artifacts: writes reports (evidence: `babelstream/babelbench/src/babelbench/report.py`)
