# theoszpn/szpmath architecture

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

- Interactive diagram: https://gitdiagram.com/theoszpn/szpmath
- Repository: https://github.com/theoszpn/szpmath

## Overview

SZPMath is a local PySide6 educational math application. A student opens the dashboard, selects a subject, works in its tabbed tools, and receives calculations, explanations, or visualizations in the selected page. The graph preserves the documented algebra, calculus, statistics, and probability capabilities. The sampled files show application routing and several module dispatches; other feature-level links rely on explicit imports in the SOURCE INDEX. Individual computation details not shown in excerpts are not inferred.

Main entry points: [`modules/algebra/algebra_main.py`](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/algebra_main.py) (Algebra tabs), [`modules/statisitcs/statistics_main.py`](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/statistics_main.py) (Statistics tabs), [`main.py`](https://github.com/theoszpn/szpmath/blob/main/main.py) (Application shell), [`modules/calculus/calculus_main.py`](https://github.com/theoszpn/szpmath/blob/main/modules/calculus/calculus_main.py) (Calculus tabs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_shell["Application shell<br/>[main.py]"]
  node_dashboard["Subject dashboard<br/>[dashboard.py]"]
end

subgraph group_algebra["Linear Algebra"]
  node_algebra_ui["Algebra tabs<br/>[algebra_main.py]"]
  node_matrix["Matrix operations<br/>[matrix_calc.py]"]
  node_gauss["Gauss solver<br/>[system_gauss.py]"]
  node_cramer["Cramer solver<br/>[cramer_solver.py]"]
  node_vectors["Vector spaces<br/>[vector_spaces.py]"]
  node_diagonal["Diagonalization<br/>[diagonalisation.py]"]
  node_visual2d["2D visualization"]
  node_visual3d["3D visualization"]
end

subgraph group_calculus["Calculus"]
  node_calculus_ui["Calculus tabs<br/>[calculus_main.py]"]
  node_plotter["Function plotting"]
  node_limits["Limits and continuity"]
  node_derivatives["Derivatives<br/>[derivatives.py]"]
  node_integrals["Integrals<br/>[integrals.py]"]
end

subgraph group_stats["Statistics"]
  node_statistics_ui["Statistics tabs<br/>[statistics_main.py]"]
  node_descriptives["Descriptive statistics<br/>[descriptives.py]"]
  node_estimations["Estimations<br/>[estimations.py]"]
  node_normality["Normality tests<br/>[testnormalite.py]"]
  node_independence["Independence tests"]
  node_homogeneity["Homogeneity tests"]
  node_adequacy["Adequacy tests<br/>[test_adequation.py]"]
  node_correlation["Correlation tests"]
end

subgraph group_probas["Probabilities"]
  node_probability_ui["Probability tabs"]
  node_combinations["Arrangements"]
  node_discrete["Discrete laws<br/>[discrete_laws.py]"]
  node_continuous["Continuous laws<br/>[continuous_laws.py]"]
end

node_student(("Student"))

node_student -->|"selects subject"| node_dashboard
node_student -->|"opens app"| node_shell
node_shell -->|"shows"| node_dashboard
node_dashboard -->|"signals selection"| node_shell
node_shell -->|"routes to"| node_algebra_ui
node_shell -->|"routes to"| node_statistics_ui
node_shell -->|"routes to"| node_probability_ui
node_shell -->|"routes to"| node_calculus_ui
node_algebra_ui -->|"creates page"| node_matrix
node_algebra_ui -->|"creates page"| node_gauss
node_algebra_ui -->|"creates page"| node_cramer
node_algebra_ui -->|"creates page"| node_vectors
node_algebra_ui -->|"creates page"| node_diagonal
node_algebra_ui -->|"creates page"| node_visual2d
node_algebra_ui -->|"creates page"| node_visual3d
node_algebra_ui -->|"copies matrix"| node_visual3d
node_calculus_ui -->|"creates page"| node_plotter
node_calculus_ui -->|"creates page"| node_limits
node_calculus_ui -->|"creates page"| node_derivatives
node_calculus_ui -->|"creates page"| node_integrals
node_statistics_ui -->|"creates page"| node_descriptives
node_statistics_ui -->|"creates page"| node_estimations
node_statistics_ui -->|"creates page"| node_normality
node_statistics_ui -->|"creates page"| node_independence
node_statistics_ui -->|"creates page"| node_homogeneity
node_statistics_ui -->|"creates page"| node_adequacy
node_statistics_ui -->|"creates page"| node_correlation
node_probability_ui -->|"creates page"| node_combinations
node_probability_ui -->|"creates page"| node_discrete
node_probability_ui -->|"creates page"| node_continuous

click node_shell "https://github.com/theoszpn/szpmath/blob/main/main.py"
click node_dashboard "https://github.com/theoszpn/szpmath/blob/main/modules/dashboard.py"
click node_algebra_ui "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/algebra_main.py"
click node_matrix "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/matrix_calc.py"
click node_gauss "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/system_gauss.py"
click node_cramer "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/cramer_solver.py"
click node_vectors "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/vector_spaces.py"
click node_diagonal "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/diagonalisation.py"
click node_visual2d "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/visualisation_2d.py"
click node_visual3d "https://github.com/theoszpn/szpmath/blob/main/modules/algebra/visualisation_3d.py"
click node_calculus_ui "https://github.com/theoszpn/szpmath/blob/main/modules/calculus/calculus_main.py"
click node_plotter "https://github.com/theoszpn/szpmath/blob/main/modules/calculus/function_plotter.py"
click node_limits "https://github.com/theoszpn/szpmath/blob/main/modules/calculus/limits_continuity.py"
click node_derivatives "https://github.com/theoszpn/szpmath/blob/main/modules/calculus/derivatives.py"
click node_integrals "https://github.com/theoszpn/szpmath/blob/main/modules/calculus/integrals.py"
click node_statistics_ui "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/statistics_main.py"
click node_descriptives "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/descriptives.py"
click node_estimations "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/estimations.py"
click node_normality "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/testnormalite.py"
click node_independence "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_independance.py"
click node_homogeneity "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_homogeneite.py"
click node_adequacy "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_adequation.py"
click node_correlation "https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_correlation.py"
click node_probability_ui "https://github.com/theoszpn/szpmath/blob/main/modules/probas/probabilities_main.py"
click node_combinations "https://github.com/theoszpn/szpmath/blob/main/modules/probas/anal_combinaison.py"
click node_discrete "https://github.com/theoszpn/szpmath/blob/main/modules/probas/discrete_laws.py"
click node_continuous "https://github.com/theoszpn/szpmath/blob/main/modules/probas/continuous_laws.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_shell,node_dashboard toneBlue
class node_algebra_ui,node_matrix,node_gauss,node_cramer,node_vectors,node_diagonal,node_visual2d,node_visual3d toneAmber
class node_calculus_ui,node_plotter,node_limits,node_derivatives,node_integrals toneMint
class node_statistics_ui,node_descriptives,node_estimations,node_normality,node_independence,node_homogeneity,node_adequacy,node_correlation toneRose
class node_probability_ui,node_combinations,node_discrete,node_continuous,node_student toneIndigo
```

## Components

### Application UI

- [Application shell](https://github.com/theoszpn/szpmath/blob/main/main.py): `main.py`
- [Subject dashboard](https://github.com/theoszpn/szpmath/blob/main/modules/dashboard.py): `modules/dashboard.py`

### Linear Algebra

- [Algebra tabs](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/algebra_main.py): `modules/algebra/algebra_main.py`
- [Matrix operations](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/matrix_calc.py): `modules/algebra/matrix_calc.py`
- [Gauss solver](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/system_gauss.py): `modules/algebra/system_gauss.py`
- [Cramer solver](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/cramer_solver.py): `modules/algebra/cramer_solver.py`
- [Vector spaces](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/vector_spaces.py): `modules/algebra/vector_spaces.py`
- [Diagonalization](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/diagonalisation.py): `modules/algebra/diagonalisation.py`
- [2D visualization](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/visualisation_2d.py): `modules/algebra/visualisation_2d.py`
- [3D visualization](https://github.com/theoszpn/szpmath/blob/main/modules/algebra/visualisation_3d.py): `modules/algebra/visualisation_3d.py`

### Calculus

- [Calculus tabs](https://github.com/theoszpn/szpmath/blob/main/modules/calculus/calculus_main.py): `modules/calculus/calculus_main.py`
- [Function plotting](https://github.com/theoszpn/szpmath/blob/main/modules/calculus/function_plotter.py): `modules/calculus/function_plotter.py`
- [Limits and continuity](https://github.com/theoszpn/szpmath/blob/main/modules/calculus/limits_continuity.py): `modules/calculus/limits_continuity.py`
- [Derivatives](https://github.com/theoszpn/szpmath/blob/main/modules/calculus/derivatives.py): `modules/calculus/derivatives.py`
- [Integrals](https://github.com/theoszpn/szpmath/blob/main/modules/calculus/integrals.py): `modules/calculus/integrals.py`

### Statistics

- [Statistics tabs](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/statistics_main.py): `modules/statisitcs/statistics_main.py`
- [Descriptive statistics](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/descriptives.py): `modules/statisitcs/descriptives.py`
- [Estimations](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/estimations.py): `modules/statisitcs/estimations.py`
- [Normality tests](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/testnormalite.py): `modules/statisitcs/testnormalite.py`
- [Independence tests](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_independance.py): `modules/statisitcs/test_independance.py`
- [Homogeneity tests](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_homogeneite.py): `modules/statisitcs/test_homogeneite.py`
- [Adequacy tests](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_adequation.py): `modules/statisitcs/test_adequation.py`
- [Correlation tests](https://github.com/theoszpn/szpmath/blob/main/modules/statisitcs/test_correlation.py): `modules/statisitcs/test_correlation.py`

### Probabilities

- [Probability tabs](https://github.com/theoszpn/szpmath/blob/main/modules/probas/probabilities_main.py): `modules/probas/probabilities_main.py`
- [Arrangements](https://github.com/theoszpn/szpmath/blob/main/modules/probas/anal_combinaison.py): `modules/probas/anal_combinaison.py`
- [Discrete laws](https://github.com/theoszpn/szpmath/blob/main/modules/probas/discrete_laws.py): `modules/probas/discrete_laws.py`
- [Continuous laws](https://github.com/theoszpn/szpmath/blob/main/modules/probas/continuous_laws.py): `modules/probas/continuous_laws.py`

### Other components

- **Student**

## Connections

- Student → Subject dashboard: selects subject (evidence: `modules/dashboard.py`)
- Student → Application shell: opens app (evidence: `README.md`)
- Application shell → Subject dashboard: shows (evidence: `main.py`)
- Subject dashboard → Application shell: signals selection (evidence: `main.py`)
- Application shell → Algebra tabs: routes to (evidence: `main.py`)
- Application shell → Statistics tabs: routes to (evidence: `main.py`)
- Application shell → Probability tabs: routes to (evidence: `main.py`)
- Application shell → Calculus tabs: routes to (evidence: `main.py`)
- Algebra tabs → Matrix operations: creates page (evidence: `modules/algebra/algebra_main.py`)
- Algebra tabs → Gauss solver: creates page (evidence: `modules/algebra/algebra_main.py`)
- Algebra tabs → Cramer solver: creates page (evidence: `modules/algebra/algebra_main.py`)
- Algebra tabs → Vector spaces: creates page (evidence: `modules/algebra/algebra_main.py`)
- Algebra tabs → Diagonalization: creates page (evidence: `modules/algebra/algebra_main.py`)
- Algebra tabs → 2D visualization: creates page (evidence: `modules/algebra/algebra_main.py`)
- Algebra tabs → 3D visualization: creates page (evidence: `modules/algebra/algebra_main.py`)
- Algebra tabs → 3D visualization: copies matrix (evidence: `modules/algebra/algebra_main.py`)
- Calculus tabs → Function plotting: creates page (evidence: `modules/calculus/calculus_main.py`)
- Calculus tabs → Limits and continuity: creates page (evidence: `modules/calculus/calculus_main.py`)
- Calculus tabs → Derivatives: creates page (evidence: `modules/calculus/calculus_main.py`)
- Calculus tabs → Integrals: creates page (evidence: `modules/calculus/calculus_main.py`)
- Statistics tabs → Descriptive statistics: creates page (evidence: `modules/statisitcs/statistics_main.py`)
- Statistics tabs → Estimations: creates page (evidence: `modules/statisitcs/statistics_main.py`)
- Statistics tabs → Normality tests: creates page (evidence: `modules/statisitcs/statistics_main.py`)
- Statistics tabs → Independence tests: creates page (evidence: `modules/statisitcs/statistics_main.py`)
- Statistics tabs → Homogeneity tests: creates page (evidence: `modules/statisitcs/statistics_main.py`)
- Statistics tabs → Adequacy tests: creates page (evidence: `modules/statisitcs/statistics_main.py`)
- Statistics tabs → Correlation tests: creates page (evidence: `modules/statisitcs/statistics_main.py`)
- Probability tabs → Arrangements: creates page (evidence: `modules/probas/probabilities_main.py`)
- Probability tabs → Discrete laws: creates page (evidence: `modules/probas/probabilities_main.py`)
- Probability tabs → Continuous laws: creates page (evidence: `modules/probas/probabilities_main.py`)
