# acridgold/ooplabsnsu architecture

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

- Interactive diagram: https://gitdiagram.com/acridgold/ooplabsnsu
- Repository: https://github.com/acridgold/ooplabsnsu

## Overview

This repository is a collection of independent OOP C++ lab programs, not one integrated application. Its largest interactive workflow is the Game of Life: a user edits or loads a pattern, controls simulation, and sees the grid update. Other labs demonstrate namespaced modules, a bit-array type, WAV conversion, and CSV parsing. The README identifies these as completed labs; the sampled entry points support the WAV and CSV workflows, though their details are not all equally visible. Unsampled lab internals are represented only where the tree or README establishes a capability.

Main entry points: [`lab3/src/main.cpp`](https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/main.cpp) (Conversion CLI), [`lab0a/main.cpp`](https://github.com/acridgold/ooplabsnsu/blob/main/lab0a/main.cpp) (Module Demo), [`lab4/src/main.cpp`](https://github.com/acridgold/ooplabsnsu/blob/main/lab4/src/main.cpp) (CSV Demo), [`GameOfLife/src/main.cpp`](https://github.com/acridgold/ooplabsnsu/blob/main/GameOfLife/src/main.cpp) (Interactive App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_life["Game of Life"]
  node_life_app["Interactive App<br/>[main.cpp]"]
  node_life_sim["Simulation<br/>[Simulation.cpp]"]
  node_life_grid["Cell Grid<br/>[Grid.cpp]"]
end

subgraph group_intro["Intro Labs"]
  node_module_app["Module Demo<br/>[main.cpp]"]
  node_module_one["Module One<br/>[module1.cpp]"]
  node_module_two["Module Two<br/>[module2.cpp]"]
  node_lab0b_app["Lab 0b Program<br/>[main.cpp]"]
end

subgraph group_bits["Bit Array"]
  node_bit_array["Bit Array<br/>[BitArray.cpp]"]
end

subgraph group_audio["WAV Converter"]
  node_audio_app["Conversion CLI<br/>[main.cpp]"]
  node_audio_config["Config Parser<br/>[ConfigParser.cpp]"]
  node_audio_converter["Converter Factory<br/>[Converter.cpp]"]
  node_audio_wav["WAV Reader Writer<br/>[WavFile.cpp]"]
end

subgraph group_csv["CSV Parser"]
  node_csv_demo["CSV Demo<br/>[main.cpp]"]
  node_csv_parser["CSV Parser<br/>[CSVParser.h]"]
end

node_life_user(("Player"))
node_module_user(("Program User"))
node_bit_user(("Program User"))
node_audio_user(("CLI User"))
node_wav_input["Input WAVs"]
node_config_input["Converter Config"]
node_wav_output["Output WAV"]
node_csv_user(("Program User"))
node_csv_input["CSV Input"]

node_life_user -->|"controls"| node_life_app
node_life_app -->|"controls"| node_life_sim
node_life_sim -->|"uses"| node_life_grid
node_module_user -->|"runs"| node_module_app
node_module_app -->|"calls"| node_module_one
node_module_app -->|"calls"| node_module_two
node_module_user -.->|"runs"| node_lab0b_app
node_bit_user -->|"uses"| node_bit_array
node_audio_user -->|"runs"| node_audio_app
node_audio_app -->|"parses"| node_audio_config
node_audio_app -->|"creates and applies"| node_audio_converter
node_audio_app -->|"reads and writes"| node_audio_wav
node_wav_input -->|"provides samples"| node_audio_app
node_config_input -->|"provides settings"| node_audio_config
node_audio_app -->|"writes result"| node_wav_output
node_csv_user -->|"runs"| node_csv_demo
node_csv_demo -->|"iterates"| node_csv_parser
node_csv_input -->|"provides rows"| node_csv_demo

click node_life_app "https://github.com/acridgold/ooplabsnsu/blob/main/GameOfLife/src/main.cpp"
click node_life_sim "https://github.com/acridgold/ooplabsnsu/blob/main/GameOfLife/src/Simulation.cpp"
click node_life_grid "https://github.com/acridgold/ooplabsnsu/blob/main/GameOfLife/src/Grid.cpp"
click node_module_app "https://github.com/acridgold/ooplabsnsu/blob/main/lab0a/main.cpp"
click node_module_one "https://github.com/acridgold/ooplabsnsu/blob/main/lab0a/module1.cpp"
click node_module_two "https://github.com/acridgold/ooplabsnsu/blob/main/lab0a/module2.cpp"
click node_lab0b_app "https://github.com/acridgold/ooplabsnsu/blob/main/lab0b/main.cpp"
click node_bit_array "https://github.com/acridgold/ooplabsnsu/blob/main/lab1a/BitArray.cpp"
click node_audio_app "https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/main.cpp"
click node_audio_config "https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/ConfigParser.cpp"
click node_audio_converter "https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/Converter.cpp"
click node_audio_wav "https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/WavFile.cpp"
click node_csv_demo "https://github.com/acridgold/ooplabsnsu/blob/main/lab4/src/main.cpp"
click node_csv_parser "https://github.com/acridgold/ooplabsnsu/blob/main/lab4/src/CSVParser.h"

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_life_app,node_life_sim,node_life_grid,node_module_user,node_bit_user,node_audio_user,node_csv_user toneBlue
class node_module_app,node_module_one,node_module_two,node_lab0b_app toneAmber
class node_bit_array toneMint
class node_audio_app,node_audio_config,node_audio_converter,node_audio_wav toneRose
class node_csv_demo,node_csv_parser,node_life_user,node_wav_input,node_config_input,node_wav_output,node_csv_input toneIndigo
```

## Components

### Game of Life

- [Interactive App](https://github.com/acridgold/ooplabsnsu/blob/main/GameOfLife/src/main.cpp): `GameOfLife/src/main.cpp`
- [Simulation](https://github.com/acridgold/ooplabsnsu/blob/main/GameOfLife/src/Simulation.cpp): `GameOfLife/src/Simulation.cpp`
- [Cell Grid](https://github.com/acridgold/ooplabsnsu/blob/main/GameOfLife/src/Grid.cpp): `GameOfLife/src/Grid.cpp`

### Intro Labs

- [Module Demo](https://github.com/acridgold/ooplabsnsu/blob/main/lab0a/main.cpp): `lab0a/main.cpp`
- [Module One](https://github.com/acridgold/ooplabsnsu/blob/main/lab0a/module1.cpp): `lab0a/module1.cpp`
- [Module Two](https://github.com/acridgold/ooplabsnsu/blob/main/lab0a/module2.cpp): `lab0a/module2.cpp`
- [Lab 0b Program](https://github.com/acridgold/ooplabsnsu/blob/main/lab0b/main.cpp): `lab0b/main.cpp`

### Bit Array

- [Bit Array](https://github.com/acridgold/ooplabsnsu/blob/main/lab1a/BitArray.cpp): `lab1a/BitArray.cpp`

### WAV Converter

- [Conversion CLI](https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/main.cpp): `lab3/src/main.cpp`
- [Config Parser](https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/ConfigParser.cpp): `lab3/src/ConfigParser.cpp`
- [Converter Factory](https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/Converter.cpp): `lab3/src/Converter.cpp`
- [WAV Reader Writer](https://github.com/acridgold/ooplabsnsu/blob/main/lab3/src/WavFile.cpp): `lab3/src/WavFile.cpp`

### CSV Parser

- [CSV Demo](https://github.com/acridgold/ooplabsnsu/blob/main/lab4/src/main.cpp): `lab4/src/main.cpp`
- [CSV Parser](https://github.com/acridgold/ooplabsnsu/blob/main/lab4/src/CSVParser.h): `lab4/src/CSVParser.h`

### Other components

- **Player**
- **Program User**
- **Program User**
- **CLI User**
- **Input WAVs**
- **Converter Config**
- **Output WAV**
- **Program User**
- **CSV Input**

## Connections

- Player → Interactive App: controls (evidence: `GameOfLife/src/main.cpp`)
- Interactive App → Simulation: controls (evidence: `GameOfLife/src/main.cpp`)
- Simulation → Cell Grid: uses
- Program User → Module Demo: runs (evidence: `lab0a/main.cpp`)
- Module Demo → Module One: calls (evidence: `lab0a/main.cpp`)
- Module Demo → Module Two: calls (evidence: `lab0a/main.cpp`)
- Program User → Lab 0b Program: runs
- Program User → Bit Array: uses
- CLI User → Conversion CLI: runs (evidence: `lab3/src/main.cpp`)
- Conversion CLI → Config Parser: parses (evidence: `lab3/src/main.cpp`)
- Conversion CLI → Converter Factory: creates and applies (evidence: `lab3/src/main.cpp`)
- Conversion CLI → WAV Reader Writer: reads and writes (evidence: `lab3/src/main.cpp`)
- Input WAVs → Conversion CLI: provides samples (evidence: `lab3/src/main.cpp`)
- Converter Config → Config Parser: provides settings
- Conversion CLI → Output WAV: writes result (evidence: `lab3/src/main.cpp`)
- Program User → CSV Demo: runs (evidence: `lab4/src/main.cpp`)
- CSV Demo → CSV Parser: iterates (evidence: `lab4/src/main.cpp`)
- CSV Input → CSV Demo: provides rows (evidence: `lab4/src/main.cpp`)
