# naveens007/slalom architecture

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

- Interactive diagram: https://gitdiagram.com/naveens007/slalom
- Repository: https://github.com/naveens007/slalom

## Overview

SLALOM is a fixed-time radiosity benchmark: it reads box and optical properties, subdivides the box into patches, builds and solves the radiosity system, writes patch radiosities, and reports timing and operation counts. The frozen C reference is accompanied by Python, Java, and TypeScript ports; the optional C++ scaffold does not yet run the benchmark. The Java timing orchestrator and several of its calls are visible in the excerpts. Other language-level connections are limited to README documentation and the SOURCE INDEX, so the graph avoids guessing at their internal call flow.

Main entry points: [`src/java/Meter.java`](https://github.com/naveens007/slalom/blob/master/src/java/Meter.java) (Benchmark meter), [`src/java/Geometry.java`](https://github.com/naveens007/slalom/blob/master/src/java/Geometry.java) (Patch geometry), [`src/slalom.c`](https://github.com/naveens007/slalom/blob/master/src/slalom.c) (C benchmark), [`src/java/Slalom.java`](https://github.com/naveens007/slalom/blob/master/src/java/Slalom.java) (Java entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_reference["C reference"]
  node_c_driver["C driver<br/>[sl-driver.c]"]
  node_c_core["C benchmark<br/>[slalom.c]"]
  node_machine_c["Machine report<br/>[system_info.c]"]
end

subgraph group_java["Java port"]
  node_java_entry["Java entry<br/>[Slalom.java]"]
  node_java_meter["Benchmark meter<br/>[Meter.java]"]
  node_problem["Problem reader<br/>[Problem.java]"]
  node_geometry["Patch geometry<br/>[Geometry.java]"]
  node_face["Box faces<br/>[Face.java]"]
  node_patch["Surface patches<br/>[Patch.java]"]
  node_radiosity["Radiosity solver"]
  node_storer["Answer writer<br/>[Storer.java]"]
  node_java_machine["Machine report<br/>[MachineReport.java]"]
end

subgraph group_other["Other implementations"]
  node_python["Python benchmark<br/>[slalom.py]"]
  node_ts_entry["TypeScript entry<br/>[Slalom.ts]"]
  node_ts_driver["TypeScript driver<br/>[driver.ts]"]
  node_ts_benchmark["TypeScript benchmark<br/>[benchmark.ts]"]
  node_ts_geometry["TypeScript geometry<br/>[geometry.ts]"]
  node_ts_solver["TypeScript solver<br/>[solver.ts]"]
  node_ts_machine["Machine report<br/>[machineInfo.ts]"]
  node_cpp["C++ scaffold<br/>[slalom-cxx.cpp]"]
end

subgraph group_data["Benchmark data"]
  node_geom_file["geom input"]
  node_answer_file["answer output"]
end

node_user(("Benchmark user"))

node_user -->|"runs benchmark"| node_c_driver
node_user -->|"runs port"| node_python
node_user -->|"runs port"| node_java_entry
node_user -->|"runs port"| node_ts_entry
node_user -.->|"builds scaffold"| node_cpp
node_c_driver -.->|"starts benchmark"| node_c_core
node_c_core -->|"reads geometry"| node_geom_file
node_c_core -->|"writes results"| node_answer_file
node_java_entry -->|"runs measurement"| node_java_meter
node_java_entry -->|"reports machine"| node_java_machine
node_java_meter -->|"reads problem"| node_problem
node_java_meter -->|"decomposes patches"| node_geometry
node_java_meter -->|"builds and solves"| node_radiosity
node_java_meter -->|"stores result"| node_storer
node_java_meter -->|"writes answer"| node_answer_file
node_problem -->|"reads geometry"| node_geom_file
node_geometry -->|"creates faces"| node_face
node_geometry -->|"creates patches"| node_patch
node_radiosity -->|"uses geometry"| node_geometry
node_storer -->|"writes patch layout"| node_geometry
node_ts_entry -->|"delegates to"| node_ts_driver
node_ts_driver -->|"uses benchmark"| node_ts_benchmark
node_ts_driver -->|"uses report"| node_ts_machine
node_ts_solver -->|"uses geometry"| node_ts_geometry
node_python -->|"reads geometry"| node_geom_file
node_python -->|"writes results"| node_answer_file
node_java_entry -->|"produces results"| node_answer_file
node_ts_entry -->|"produces results"| node_answer_file
node_c_core -->|"uses system report"| node_machine_c

click node_c_driver "https://github.com/naveens007/slalom/blob/master/src/sl-driver.c"
click node_c_core "https://github.com/naveens007/slalom/blob/master/src/slalom.c"
click node_machine_c "https://github.com/naveens007/slalom/blob/master/src/system_info.c"
click node_java_entry "https://github.com/naveens007/slalom/blob/master/src/java/Slalom.java"
click node_java_meter "https://github.com/naveens007/slalom/blob/master/src/java/Meter.java"
click node_problem "https://github.com/naveens007/slalom/blob/master/src/java/Problem.java"
click node_geometry "https://github.com/naveens007/slalom/blob/master/src/java/Geometry.java"
click node_face "https://github.com/naveens007/slalom/blob/master/src/java/Face.java"
click node_patch "https://github.com/naveens007/slalom/blob/master/src/java/Patch.java"
click node_radiosity "https://github.com/naveens007/slalom/blob/master/src/java/RadiositySystem.java"
click node_storer "https://github.com/naveens007/slalom/blob/master/src/java/Storer.java"
click node_java_machine "https://github.com/naveens007/slalom/blob/master/src/java/MachineReport.java"
click node_python "https://github.com/naveens007/slalom/blob/master/src/slalom.py"
click node_ts_entry "https://github.com/naveens007/slalom/blob/master/src/ts/Slalom.ts"
click node_ts_driver "https://github.com/naveens007/slalom/blob/master/src/ts/driver.ts"
click node_ts_benchmark "https://github.com/naveens007/slalom/blob/master/src/ts/benchmark.ts"
click node_ts_geometry "https://github.com/naveens007/slalom/blob/master/src/ts/geometry.ts"
click node_ts_solver "https://github.com/naveens007/slalom/blob/master/src/ts/solver.ts"
click node_ts_machine "https://github.com/naveens007/slalom/blob/master/src/ts/machineInfo.ts"
click node_cpp "https://github.com/naveens007/slalom/blob/master/src/cpp/slalom-cxx.cpp"
click node_geom_file "https://github.com/naveens007/slalom/blob/master/src/geom"

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_c_driver,node_c_core,node_machine_c,node_user toneBlue
class node_java_entry,node_java_meter,node_problem,node_geometry,node_face,node_patch,node_radiosity,node_storer,node_java_machine toneAmber
class node_python,node_ts_entry,node_ts_driver,node_ts_benchmark,node_ts_geometry,node_ts_solver,node_ts_machine,node_cpp toneMint
class node_geom_file,node_answer_file toneRose
```

## Components

### C reference

- [C driver](https://github.com/naveens007/slalom/blob/master/src/sl-driver.c): `src/sl-driver.c`
- [C benchmark](https://github.com/naveens007/slalom/blob/master/src/slalom.c): `src/slalom.c`
- [Machine report](https://github.com/naveens007/slalom/blob/master/src/system_info.c): `src/system_info.c`

### Java port

- [Java entry](https://github.com/naveens007/slalom/blob/master/src/java/Slalom.java): `src/java/Slalom.java`
- [Benchmark meter](https://github.com/naveens007/slalom/blob/master/src/java/Meter.java): `src/java/Meter.java`
- [Problem reader](https://github.com/naveens007/slalom/blob/master/src/java/Problem.java): `src/java/Problem.java`
- [Patch geometry](https://github.com/naveens007/slalom/blob/master/src/java/Geometry.java): `src/java/Geometry.java`
- [Box faces](https://github.com/naveens007/slalom/blob/master/src/java/Face.java): `src/java/Face.java`
- [Surface patches](https://github.com/naveens007/slalom/blob/master/src/java/Patch.java): `src/java/Patch.java`
- [Radiosity solver](https://github.com/naveens007/slalom/blob/master/src/java/RadiositySystem.java): `src/java/RadiositySystem.java`
- [Answer writer](https://github.com/naveens007/slalom/blob/master/src/java/Storer.java): `src/java/Storer.java`
- [Machine report](https://github.com/naveens007/slalom/blob/master/src/java/MachineReport.java): `src/java/MachineReport.java`

### Other implementations

- [Python benchmark](https://github.com/naveens007/slalom/blob/master/src/slalom.py): `src/slalom.py`
- [TypeScript entry](https://github.com/naveens007/slalom/blob/master/src/ts/Slalom.ts): `src/ts/Slalom.ts`
- [TypeScript driver](https://github.com/naveens007/slalom/blob/master/src/ts/driver.ts): `src/ts/driver.ts`
- [TypeScript benchmark](https://github.com/naveens007/slalom/blob/master/src/ts/benchmark.ts): `src/ts/benchmark.ts`
- [TypeScript geometry](https://github.com/naveens007/slalom/blob/master/src/ts/geometry.ts): `src/ts/geometry.ts`
- [TypeScript solver](https://github.com/naveens007/slalom/blob/master/src/ts/solver.ts): `src/ts/solver.ts`
- [Machine report](https://github.com/naveens007/slalom/blob/master/src/ts/machineInfo.ts): `src/ts/machineInfo.ts`
- [C++ scaffold](https://github.com/naveens007/slalom/blob/master/src/cpp/slalom-cxx.cpp): `src/cpp/slalom-cxx.cpp`

### Benchmark data

- [geom input](https://github.com/naveens007/slalom/blob/master/src/geom): `src/geom`
- **answer output**

### Other components

- **Benchmark user**

## Connections

- Benchmark user → C driver: runs benchmark (evidence: `README.md`)
- Benchmark user → Python benchmark: runs port (evidence: `README.md`)
- Benchmark user → Java entry: runs port (evidence: `README.md`)
- Benchmark user → TypeScript entry: runs port (evidence: `README.md`)
- Benchmark user → C++ scaffold: builds scaffold (evidence: `README.md`)
- C driver → C benchmark: starts benchmark
- C benchmark → geom input: reads geometry (evidence: `README.md`)
- C benchmark → answer output: writes results (evidence: `README.md`)
- Java entry → Benchmark meter: runs measurement (evidence: `src/java/Slalom.java`)
- Java entry → Machine report: reports machine (evidence: `src/java/Slalom.java`)
- Benchmark meter → Problem reader: reads problem (evidence: `src/java/Meter.java`)
- Benchmark meter → Patch geometry: decomposes patches (evidence: `src/java/Meter.java`)
- Benchmark meter → Radiosity solver: builds and solves (evidence: `src/java/Meter.java`)
- Benchmark meter → Answer writer: stores result (evidence: `src/java/Meter.java`)
- Benchmark meter → answer output: writes answer
- Problem reader → geom input: reads geometry (evidence: `src/java/Problem.java`)
- Patch geometry → Box faces: creates faces (evidence: `src/java/Geometry.java`)
- Patch geometry → Surface patches: creates patches (evidence: `src/java/Geometry.java`)
- Radiosity solver → Patch geometry: uses geometry (evidence: `src/java/RadiositySystem.java`)
- Answer writer → Patch geometry: writes patch layout (evidence: `src/java/Storer.java`)
- TypeScript entry → TypeScript driver: delegates to (evidence: `src/ts/Slalom.ts`)
- TypeScript driver → TypeScript benchmark: uses benchmark (evidence: `src/ts/driver.ts`)
- TypeScript driver → Machine report: uses report (evidence: `src/ts/driver.ts`)
- TypeScript solver → TypeScript geometry: uses geometry (evidence: `src/ts/solver.ts`)
- Python benchmark → geom input: reads geometry (evidence: `README.md`)
- Python benchmark → answer output: writes results (evidence: `README.md`)
- Java entry → answer output: produces results (evidence: `README.md`)
- TypeScript entry → answer output: produces results (evidence: `README.md`)
- C benchmark → Machine report: uses system report (evidence: `src/slalom.c`)
