# verysvs/wam-calculator architecture

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

- Interactive diagram: https://gitdiagram.com/verysvs/wam-calculator
- Repository: https://github.com/verysvs/wam-calculator

## Overview

A small command-line calculator reads a user-created marks.csv, computes a weighted average mark (WAM), and then offers subject-grade summaries or an estimated GPA. The runtime is implemented in one file, so components share main.py. The README documents the input format and calculation caveats; edges reflect the shown calls and documented file input.

Main entry points: [`main.py`](https://github.com/verysvs/wam-calculator/blob/main/main.py) (Program flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_marks_csv["Marks CSV"]
node_main_flow["Program flow<br/>[main.py]"]
node_csv_loader["CSV loader<br/>[main.py]"]
node_wam_calculation["WAM calculation<br/>[main.py]"]
node_grade_classifier["Grade classifier<br/>[main.py]"]
node_extra_menu["Options menu<br/>[main.py]"]
node_subject_summary["Subject summary<br/>[main.py]"]
node_gpa_estimator["GPA estimator<br/>[main.py]"]

node_user -->|"provides marks"| node_marks_csv
node_marks_csv -->|"supplies input"| node_csv_loader
node_user -->|"runs program"| node_main_flow
node_main_flow -->|"loads marks"| node_csv_loader
node_csv_loader -->|"returns inventory"| node_wam_calculation
node_main_flow -->|"calculates WAM"| node_wam_calculation
node_main_flow -->|"classifies WAM"| node_grade_classifier
node_main_flow -->|"opens options"| node_extra_menu
node_extra_menu -->|"shows subjects"| node_subject_summary
node_extra_menu -->|"estimates GPA"| node_gpa_estimator
node_subject_summary -->|"classifies marks"| node_grade_classifier
node_gpa_estimator -->|"classifies marks"| node_grade_classifier

click node_main_flow "https://github.com/verysvs/wam-calculator/blob/main/main.py"
click node_csv_loader "https://github.com/verysvs/wam-calculator/blob/main/main.py"
click node_wam_calculation "https://github.com/verysvs/wam-calculator/blob/main/main.py"
click node_grade_classifier "https://github.com/verysvs/wam-calculator/blob/main/main.py"
click node_extra_menu "https://github.com/verysvs/wam-calculator/blob/main/main.py"
click node_subject_summary "https://github.com/verysvs/wam-calculator/blob/main/main.py"
click node_gpa_estimator "https://github.com/verysvs/wam-calculator/blob/main/main.py"

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_user toneBlue
class node_marks_csv toneIndigo
class node_main_flow,node_csv_loader,node_wam_calculation,node_grade_classifier,node_extra_menu,node_subject_summary,node_gpa_estimator toneTeal
```

## Components

### Other components

- **User**
- **Marks CSV**
- [Program flow](https://github.com/verysvs/wam-calculator/blob/main/main.py): `main.py`
- [CSV loader](https://github.com/verysvs/wam-calculator/blob/main/main.py): `main.py`
- [WAM calculation](https://github.com/verysvs/wam-calculator/blob/main/main.py): `main.py`
- [Grade classifier](https://github.com/verysvs/wam-calculator/blob/main/main.py): `main.py`
- [Options menu](https://github.com/verysvs/wam-calculator/blob/main/main.py): `main.py`
- [Subject summary](https://github.com/verysvs/wam-calculator/blob/main/main.py): `main.py`
- [GPA estimator](https://github.com/verysvs/wam-calculator/blob/main/main.py): `main.py`

## Connections

- User → Marks CSV: provides marks (evidence: `README.md`)
- Marks CSV → CSV loader: supplies input (evidence: `README.md`)
- User → Program flow: runs program (evidence: `README.md`)
- Program flow → CSV loader: loads marks (evidence: `main.py`)
- CSV loader → WAM calculation: returns inventory (evidence: `main.py`)
- Program flow → WAM calculation: calculates WAM (evidence: `main.py`)
- Program flow → Grade classifier: classifies WAM (evidence: `main.py`)
- Program flow → Options menu: opens options (evidence: `main.py`)
- Options menu → Subject summary: shows subjects (evidence: `main.py`)
- Options menu → GPA estimator: estimates GPA (evidence: `main.py`)
- Subject summary → Grade classifier: classifies marks (evidence: `main.py`)
- GPA estimator → Grade classifier: classifies marks (evidence: `main.py`)
