# anjolaolubusi/junioris architecture

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

- Interactive diagram: https://gitdiagram.com/anjolaolubusi/junioris
- Repository: https://github.com/anjolaolubusi/junioris

## Overview

JuniorIS is a graphical Max-Min Ant System (MMAS) simulator. The sample workflow configures a start, end, and graph, then runs a window loop where controls start or pause ant exploration, the MMAS controller coordinates path selection and pheromone updates, and the graph and ants are rendered. The implementation is sampled; README documentation is limited to build dependencies and run instructions, so broader capabilities are not assumed.

Main entry points: [`src/MMAS.cpp`](https://github.com/anjolaolubusi/junioris/blob/master/src/MMAS.cpp) (MMAS Controller), [`src/GraphMap.cpp`](https://github.com/anjolaolubusi/junioris/blob/master/src/GraphMap.cpp) (Graph & Walkability), [`src/Ant.cpp`](https://github.com/anjolaolubusi/junioris/blob/master/src/Ant.cpp) (Ant Agents), [`src/PheroKey.cpp`](https://github.com/anjolaolubusi/junioris/blob/master/src/PheroKey.cpp) (Edge State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Simulator"]
  node_entry["Sample Setup<br/>[main.cpp]"]
  node_controller["MMAS Controller<br/>[MMAS.cpp]"]
  node_controls["Simulation Controls<br/>[MMAS.cpp]"]
  node_visuals["Graph Rendering<br/>[MMAS.cpp]"]
end

subgraph group_search["Path Search"]
  node_ants["Ant Agents<br/>[Ant.cpp]"]
end

subgraph group_graph["Graph Model"]
  node_graphmap["Graph &amp; Walkability<br/>[GraphMap.cpp]"]
  node_pheromones["Pheromone Updates<br/>[GraphMap.cpp]"]
  node_edge["Edge State<br/>[PheroKey.cpp]"]
end

node_user(("User"))
node_framework["SFML / ImGui"]

node_user -.->|"operates"| node_controls
node_entry -->|"configures and runs"| node_controller
node_controller -->|"updates"| node_controls
node_controller -->|"moves and resets"| node_ants
node_controller -->|"configures graph"| node_graphmap
node_controller -->|"updates paths"| node_pheromones
node_controller -->|"renders"| node_visuals
node_controls -->|"sets parameters"| node_graphmap
node_ants -->|"queries edges"| node_graphmap
node_graphmap -->|"stores and updates"| node_edge
node_pheromones -->|"changes values"| node_edge
node_visuals -->|"draws agents"| node_ants
node_controller -->|"uses window and UI"| node_framework

click node_entry "https://github.com/anjolaolubusi/junioris/blob/master/src/main.cpp"
click node_controller "https://github.com/anjolaolubusi/junioris/blob/master/src/MMAS.cpp"
click node_controls "https://github.com/anjolaolubusi/junioris/blob/master/src/MMAS.cpp"
click node_visuals "https://github.com/anjolaolubusi/junioris/blob/master/src/MMAS.cpp"
click node_ants "https://github.com/anjolaolubusi/junioris/blob/master/src/Ant.cpp"
click node_graphmap "https://github.com/anjolaolubusi/junioris/blob/master/src/GraphMap.cpp"
click node_pheromones "https://github.com/anjolaolubusi/junioris/blob/master/src/GraphMap.cpp"
click node_edge "https://github.com/anjolaolubusi/junioris/blob/master/src/PheroKey.cpp"

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_entry,node_controller,node_controls,node_visuals,node_user,node_framework toneBlue
class node_ants toneAmber
class node_graphmap,node_pheromones,node_edge toneMint
```

## Components

### Simulator

- [Sample Setup](https://github.com/anjolaolubusi/junioris/blob/master/src/main.cpp): `src/main.cpp`
- [MMAS Controller](https://github.com/anjolaolubusi/junioris/blob/master/src/MMAS.cpp): `src/MMAS.cpp`
- [Simulation Controls](https://github.com/anjolaolubusi/junioris/blob/master/src/MMAS.cpp): `src/MMAS.cpp`
- [Graph Rendering](https://github.com/anjolaolubusi/junioris/blob/master/src/MMAS.cpp): `src/MMAS.cpp`

### Path Search

- [Ant Agents](https://github.com/anjolaolubusi/junioris/blob/master/src/Ant.cpp): `src/Ant.cpp`

### Graph Model

- [Graph & Walkability](https://github.com/anjolaolubusi/junioris/blob/master/src/GraphMap.cpp): `src/GraphMap.cpp`
- [Pheromone Updates](https://github.com/anjolaolubusi/junioris/blob/master/src/GraphMap.cpp): `src/GraphMap.cpp`
- [Edge State](https://github.com/anjolaolubusi/junioris/blob/master/src/PheroKey.cpp): `src/PheroKey.cpp`

### Other components

- **User**
- **SFML / ImGui**

## Connections

- User → Simulation Controls: operates
- Sample Setup → MMAS Controller: configures and runs (evidence: `src/main.cpp`)
- MMAS Controller → Simulation Controls: updates (evidence: `src/MMAS.cpp`)
- MMAS Controller → Ant Agents: moves and resets (evidence: `src/MMAS.cpp`)
- MMAS Controller → Graph & Walkability: configures graph (evidence: `src/MMAS.cpp`)
- MMAS Controller → Pheromone Updates: updates paths (evidence: `src/MMAS.cpp`)
- MMAS Controller → Graph Rendering: renders (evidence: `src/MMAS.cpp`)
- Simulation Controls → Graph & Walkability: sets parameters (evidence: `src/MMAS.cpp`)
- Ant Agents → Graph & Walkability: queries edges (evidence: `src/Ant.cpp`)
- Graph & Walkability → Edge State: stores and updates (evidence: `src/GraphMap.cpp`)
- Pheromone Updates → Edge State: changes values (evidence: `src/GraphMap.cpp`)
- Graph Rendering → Ant Agents: draws agents (evidence: `src/MMAS.cpp`)
- MMAS Controller → SFML / ImGui: uses window and UI (evidence: `src/MMAS.cpp`)
