# wu-jackie/unary-sparse-polynomial-calculator architecture

> Architecture diagram of the GitHub repository wu-jackie/unary-sparse-polynomial-calculator, 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/wu-jackie/unary-sparse-polynomial-calculator
- Repository: https://github.com/wu-jackie/unary-sparse-polynomial-calculator

## Overview

This is a Qt desktop unary sparse-polynomial calculator. The user enters two polynomials, requests addition or subtraction, and can evaluate the resulting polynomial at an integer x; the app also provides an About window. The graph separates the Qt interface, calculation stages, and application startup. Source excerpts show the principal calls; the UI-form links are based on the sampled window setup code. The README documents the capabilities but provides no additional implementation detail.

Main entry points: [`window.cpp`](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/window.cpp) (Main window), [`calculator.cpp`](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp) (Term storage), [`information.cpp`](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/information.cpp) (About dialog), [`calculator.h`](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.h) (Calculator state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Qt interface"]
  node_window["Main window<br/>[window.cpp]"]
  node_main_ui["Main form<br/>[window.ui]"]
  node_about["About dialog<br/>[information.cpp]"]
  node_about_ui["About form<br/>[information.ui]"]
end

subgraph group_engine["Polynomial engine"]
  node_calculator["Calculator state<br/>[calculator.h]"]
  node_validation["Input validation<br/>[calculator.cpp]"]
  node_polynomial_build["Polynomial building<br/>[calculator.cpp]"]
  node_term_storage["Term storage<br/>[calculator.cpp]"]
  node_normalization["Combine and order terms<br/>[calculator.cpp]"]
  node_arithmetic["Addition and subtraction<br/>[calculator.cpp]"]
  node_formatting["Polynomial formatting<br/>[calculator.cpp]"]
  node_evaluation["Evaluate at x<br/>[calculator.cpp]"]
end

subgraph group_application["Application"]
  node_startup["Qt startup<br/>[main.cpp]"]
end

node_user(("User"))

node_user -->|"enters and requests"| node_window
node_startup -->|"creates and shows"| node_window
node_window -->|"sets up"| node_main_ui
node_window -->|"validates inputs"| node_validation
node_window -->|"builds inputs"| node_polynomial_build
node_window -->|"requests operation"| node_arithmetic
node_window -->|"requests evaluation"| node_evaluation
node_window -->|"opens"| node_about
node_about -->|"sets up"| node_about_ui
node_calculator -->|"owns term lists"| node_term_storage
node_polynomial_build -->|"adds terms"| node_term_storage
node_polynomial_build -->|"normalizes"| node_normalization
node_normalization -->|"merges and orders"| node_term_storage
node_arithmetic -->|"copies terms"| node_term_storage
node_arithmetic -->|"normalizes result"| node_normalization
node_arithmetic -->|"formats result"| node_formatting
node_evaluation -->|"reads terms"| node_term_storage

click node_window "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/window.cpp"
click node_main_ui "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/window.ui"
click node_about "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/information.cpp"
click node_about_ui "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/information.ui"
click node_calculator "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.h"
click node_validation "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp"
click node_polynomial_build "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp"
click node_term_storage "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp"
click node_normalization "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp"
click node_arithmetic "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp"
click node_formatting "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp"
click node_evaluation "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp"
click node_startup "https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/main.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_window,node_main_ui,node_about,node_about_ui,node_user toneBlue
class node_calculator,node_validation,node_polynomial_build,node_term_storage,node_normalization,node_arithmetic,node_formatting,node_evaluation toneAmber
class node_startup toneMint
```

## Components

### Qt interface

- [Main window](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/window.cpp): `window.cpp`
- [Main form](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/window.ui): `window.ui`
- [About dialog](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/information.cpp): `information.cpp`
- [About form](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/information.ui): `information.ui`

### Polynomial engine

- [Calculator state](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.h): `calculator.h`
- [Input validation](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp): `calculator.cpp`
- [Polynomial building](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp): `calculator.cpp`
- [Term storage](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp): `calculator.cpp`
- [Combine and order terms](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp): `calculator.cpp`
- [Addition and subtraction](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp): `calculator.cpp`
- [Polynomial formatting](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp): `calculator.cpp`
- [Evaluate at x](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/calculator.cpp): `calculator.cpp`

### Application

- [Qt startup](https://github.com/wu-jackie/unary-sparse-polynomial-calculator/blob/main/main.cpp): `main.cpp`

### Other components

- **User**

## Connections

- User → Main window: enters and requests (evidence: `window.cpp`)
- Qt startup → Main window: creates and shows (evidence: `main.cpp`)
- Main window → Main form: sets up (evidence: `window.cpp`)
- Main window → Input validation: validates inputs (evidence: `window.cpp`)
- Main window → Polynomial building: builds inputs (evidence: `window.cpp`)
- Main window → Addition and subtraction: requests operation (evidence: `window.cpp`)
- Main window → Evaluate at x: requests evaluation (evidence: `window.cpp`)
- Main window → About dialog: opens (evidence: `window.cpp`)
- About dialog → About form: sets up (evidence: `information.cpp`)
- Calculator state → Term storage: owns term lists (evidence: `calculator.h`)
- Polynomial building → Term storage: adds terms (evidence: `calculator.cpp`)
- Polynomial building → Combine and order terms: normalizes (evidence: `calculator.cpp`)
- Combine and order terms → Term storage: merges and orders (evidence: `calculator.cpp`)
- Addition and subtraction → Term storage: copies terms (evidence: `calculator.cpp`)
- Addition and subtraction → Combine and order terms: normalizes result (evidence: `calculator.cpp`)
- Addition and subtraction → Polynomial formatting: formats result (evidence: `calculator.cpp`)
- Evaluate at x → Term storage: reads terms (evidence: `calculator.cpp`)
