# nikaron4ik/engineercalculator architecture

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

- Interactive diagram: https://gitdiagram.com/nikaron4ik/engineercalculator
- Repository: https://github.com/nikaron4ik/engineercalculator

## Overview

This is a JavaFX engineering calculator. Users enter expressions with buttons or the keyboard, choose degree or radian mode, and evaluate; the controller sends the expression to the model, which normalizes symbols and runs lexical analysis, shunting-yard conversion, and evaluation. The README is empty, so capabilities are based on sampled source. The FXML view is present in the tree, but its bindings were not sampled; the graph therefore avoids claiming its specific wiring.

Main entry points: [`src/main/java/uni/gsu/calculator/model/CalculatorModel.java`](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/CalculatorModel.java) (Calculation model), [`src/main/java/uni/gsu/calculator/model/parser/Token.java`](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/parser/Token.java) (Token representation), [`src/main/java/uni/gsu/calculator/CalculatorApplication.java`](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/CalculatorApplication.java) (JavaFX application), [`src/main/java/uni/gsu/calculator/controller/CalculatorController.java`](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/controller/CalculatorController.java) (Input and results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Calculator UI"]
  node_launcher["Launcher<br/>[Launcher.java]"]
  node_application["JavaFX application"]
  node_view["Calculator view<br/>[Calculator.fxml]"]
  node_controller["Input and results"]
end

subgraph group_calc["Expression calculation"]
  node_model["Calculation model"]
  node_lexer["Expression lexer<br/>[Lexer.java]"]
  node_token["Token representation<br/>[Token.java]"]
  node_parser["RPN parser<br/>[Parser.java]"]
  node_evaluator["Expression evaluator<br/>[Evaluator.java]"]
end

node_user(("Calculator user"))

node_user -->|"enters expression"| node_controller
node_launcher -->|"launches"| node_application
node_application -->|"loads"| node_view
node_controller -->|"calculates"| node_model
node_model -->|"tokenizes"| node_lexer
node_lexer -->|"creates tokens"| node_token
node_model -->|"converts tokens"| node_parser
node_parser -->|"reads tokens"| node_token
node_model -->|"evaluates RPN"| node_evaluator
node_evaluator -->|"reads tokens"| node_token

click node_launcher "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/Launcher.java"
click node_application "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/CalculatorApplication.java"
click node_view "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/resources/uni/gsu/calculator/view/Calculator.fxml"
click node_controller "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/controller/CalculatorController.java"
click node_model "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/CalculatorModel.java"
click node_lexer "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/parser/Lexer.java"
click node_token "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/parser/Token.java"
click node_parser "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/parser/Parser.java"
click node_evaluator "https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/evaluator/Evaluator.java"

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_launcher,node_application,node_view,node_controller,node_user toneBlue
class node_model,node_lexer,node_token,node_parser,node_evaluator toneAmber
```

## Components

### Calculator UI

- [Launcher](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/Launcher.java): `src/main/java/uni/gsu/calculator/Launcher.java`
- [JavaFX application](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/CalculatorApplication.java): `src/main/java/uni/gsu/calculator/CalculatorApplication.java`
- [Calculator view](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/resources/uni/gsu/calculator/view/Calculator.fxml): `src/main/resources/uni/gsu/calculator/view/Calculator.fxml`
- [Input and results](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/controller/CalculatorController.java): `src/main/java/uni/gsu/calculator/controller/CalculatorController.java`

### Expression calculation

- [Calculation model](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/CalculatorModel.java): `src/main/java/uni/gsu/calculator/model/CalculatorModel.java`
- [Expression lexer](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/parser/Lexer.java): `src/main/java/uni/gsu/calculator/model/parser/Lexer.java`
- [Token representation](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/parser/Token.java): `src/main/java/uni/gsu/calculator/model/parser/Token.java`
- [RPN parser](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/parser/Parser.java): `src/main/java/uni/gsu/calculator/model/parser/Parser.java`
- [Expression evaluator](https://github.com/nikaron4ik/engineercalculator/blob/main/src/main/java/uni/gsu/calculator/model/evaluator/Evaluator.java): `src/main/java/uni/gsu/calculator/model/evaluator/Evaluator.java`

### Other components

- **Calculator user**

## Connections

- Calculator user → Input and results: enters expression (evidence: `src/main/java/uni/gsu/calculator/controller/CalculatorController.java`)
- Launcher → JavaFX application: launches (evidence: `src/main/java/uni/gsu/calculator/Launcher.java`)
- JavaFX application → Calculator view: loads (evidence: `src/main/java/uni/gsu/calculator/CalculatorApplication.java`)
- Input and results → Calculation model: calculates (evidence: `src/main/java/uni/gsu/calculator/controller/CalculatorController.java`)
- Calculation model → Expression lexer: tokenizes (evidence: `src/main/java/uni/gsu/calculator/model/CalculatorModel.java`)
- Expression lexer → Token representation: creates tokens (evidence: `src/main/java/uni/gsu/calculator/model/parser/Lexer.java`)
- Calculation model → RPN parser: converts tokens (evidence: `src/main/java/uni/gsu/calculator/model/CalculatorModel.java`)
- RPN parser → Token representation: reads tokens (evidence: `src/main/java/uni/gsu/calculator/model/parser/Parser.java`)
- Calculation model → Expression evaluator: evaluates RPN (evidence: `src/main/java/uni/gsu/calculator/model/CalculatorModel.java`)
- Expression evaluator → Token representation: reads tokens (evidence: `src/main/java/uni/gsu/calculator/model/evaluator/Evaluator.java`)
