# susesh10/evaclab architecture

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

- Interactive diagram: https://gitdiagram.com/susesh10/evaclab
- Repository: https://github.com/susesh10/evaclab

## Overview

EvacLab is a browser-based evacuation simulator. A user starts or edits a floor plan, then watches occupants route toward open exits; exit closures and spreading fire can change routes or leave occupants trapped. The app also compares open-exit and blocked-exit runs. The graph separates the browser interface from simulation state, routing, and layout processing. The README documents the editor and fire behavior; sampled app.js and simulation.js excerpts show the principal calls and simulation logic.

Main entry points: [`simulation.js`](https://github.com/susesh10/evaclab/blob/main/simulation.js) (Simulation state), [`app.js`](https://github.com/susesh10/evaclab/blob/main/app.js) (App controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Browser interface"]
  node_browser_app["App controls<br/>[app.js]"]
  node_map_view["Map rendering<br/>[app.js]"]
  node_editor["Floor-plan editor<br/>[app.js]"]
end

subgraph group_simulation["Evacuation simulation"]
  node_sim_state["Simulation state<br/>[simulation.js]"]
  node_route_search["Exit routing<br/>[simulation.js]"]
  node_fire_spread["Fire spread<br/>[simulation.js]"]
  node_movement["Occupant movement<br/>[simulation.js]"]
end

subgraph group_layouts["Floor plans and analysis"]
  node_metrics["Run metrics<br/>[simulation.js]"]
  node_comparison["Scenario comparison<br/>[simulation.js]"]
  node_layout_conversion["Grid conversion<br/>[simulation.js]"]
  node_layout_validation["Layout validation<br/>[simulation.js]"]
end

node_user(("User"))

node_user -->|"operates"| node_browser_app
node_browser_app -->|"renders"| node_map_view
node_browser_app -->|"creates and advances"| node_sim_state
node_browser_app -->|"blocks exits"| node_sim_state
node_sim_state -->|"computes routes"| node_route_search
node_sim_state -->|"spreads fire"| node_fire_spread
node_sim_state -->|"moves occupants"| node_movement
node_browser_app -->|"reads status"| node_metrics
node_browser_app -->|"requests scenarios"| node_comparison
node_comparison -->|"creates runs"| node_sim_state
node_comparison -->|"collects results"| node_metrics
node_editor -->|"converts grid"| node_layout_conversion
node_editor -->|"validates layout"| node_layout_validation
node_layout_validation -->|"checks reachability"| node_sim_state
node_layout_validation -->|"checks waiting occupants"| node_metrics
node_browser_app -->|"loads layout"| node_sim_state

click node_browser_app "https://github.com/susesh10/evaclab/blob/main/app.js"
click node_map_view "https://github.com/susesh10/evaclab/blob/main/app.js"
click node_editor "https://github.com/susesh10/evaclab/blob/main/app.js"
click node_sim_state "https://github.com/susesh10/evaclab/blob/main/simulation.js"
click node_route_search "https://github.com/susesh10/evaclab/blob/main/simulation.js"
click node_fire_spread "https://github.com/susesh10/evaclab/blob/main/simulation.js"
click node_movement "https://github.com/susesh10/evaclab/blob/main/simulation.js"
click node_metrics "https://github.com/susesh10/evaclab/blob/main/simulation.js"
click node_comparison "https://github.com/susesh10/evaclab/blob/main/simulation.js"
click node_layout_conversion "https://github.com/susesh10/evaclab/blob/main/simulation.js"
click node_layout_validation "https://github.com/susesh10/evaclab/blob/main/simulation.js"

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_browser_app,node_map_view,node_editor,node_user toneBlue
class node_sim_state,node_route_search,node_fire_spread,node_movement toneAmber
class node_metrics,node_comparison,node_layout_conversion,node_layout_validation toneMint
```

## Components

### Browser interface

- [App controls](https://github.com/susesh10/evaclab/blob/main/app.js): `app.js`
- [Map rendering](https://github.com/susesh10/evaclab/blob/main/app.js): `app.js`
- [Floor-plan editor](https://github.com/susesh10/evaclab/blob/main/app.js): `app.js`

### Evacuation simulation

- [Simulation state](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`
- [Exit routing](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`
- [Fire spread](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`
- [Occupant movement](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`

### Floor plans and analysis

- [Run metrics](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`
- [Scenario comparison](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`
- [Grid conversion](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`
- [Layout validation](https://github.com/susesh10/evaclab/blob/main/simulation.js): `simulation.js`

### Other components

- **User**

## Connections

- User → App controls: operates (evidence: `README.md`)
- App controls → Map rendering: renders (evidence: `app.js`)
- App controls → Simulation state: creates and advances (evidence: `app.js`)
- App controls → Simulation state: blocks exits (evidence: `app.js`)
- Simulation state → Exit routing: computes routes (evidence: `simulation.js`)
- Simulation state → Fire spread: spreads fire (evidence: `simulation.js`)
- Simulation state → Occupant movement: moves occupants (evidence: `simulation.js`)
- App controls → Run metrics: reads status (evidence: `app.js`)
- App controls → Scenario comparison: requests scenarios (evidence: `app.js`)
- Scenario comparison → Simulation state: creates runs (evidence: `simulation.js`)
- Scenario comparison → Run metrics: collects results (evidence: `simulation.js`)
- Floor-plan editor → Grid conversion: converts grid (evidence: `app.js`)
- Floor-plan editor → Layout validation: validates layout (evidence: `app.js`)
- Layout validation → Simulation state: checks reachability (evidence: `simulation.js`)
- Layout validation → Run metrics: checks waiting occupants (evidence: `simulation.js`)
- App controls → Simulation state: loads layout (evidence: `app.js`)
