# artemkagh0st1k/diplom_work architecture

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

- Interactive diagram: https://gitdiagram.com/artemkagh0st1k/diplom_work
- Repository: https://github.com/artemkagh0st1k/diplom_work

## Overview

This repository is an optical lens-system modeling and optimization application. Its main workflow is to enter or load lens parameters in the desktop GUI, validate a dataset, compute wavelength-dependent focus and optimize lens heights, then inspect visualizations or ray-tracing results. It supports two- through five-lens optimizers, paraxial and real ray tracing, and comparison/visualization workflows. The README is empty; relationships below are limited to excerpted code and SOURCE INDEX references, so some unsampled feature connections are omitted.

Main entry points: [`optimizers/base.py`](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/base.py) (Base optimizer), [`data/dataset_helper.py`](https://github.com/artemkagh0st1k/diplom_work/blob/main/data/dataset_helper.py) (Dataset builder), [`optimizers/two_lens.py`](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/two_lens.py) (Two-lens optimizer), [`optimizers/three_lens.py`](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/three_lens.py) (Three-lens optimizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_gui["Desktop GUI<br/>[app.py]"]
  node_entry["CLI entry<br/>[main.py]"]
end

subgraph group_data["Optical data"]
  node_dataset_helper["Dataset builder<br/>[dataset_helper.py]"]
  node_default_sets["Default datasets<br/>[datasets.py]"]
end

subgraph group_optimization["Lens optimization"]
  node_base_optimizer["Base optimizer<br/>[base.py]"]
  node_two_lens["Two-lens optimizer<br/>[two_lens.py]"]
  node_three_lens["Three-lens optimizer<br/>[three_lens.py]"]
  node_four_lens["Four-lens optimizer<br/>[four_lens.py]"]
  node_five_lens["Five-lens optimizer<br/>[five_lens.py]"]
  node_quick_opt["Quick optimization<br/>[quick_optimize.py]"]
end

subgraph group_analysis["Tracing and analysis"]
  node_combined_opt["Optimize and trace"]
  node_real_trace["Real ray tracing<br/>[real_tracing.py]"]
  node_advanced_trace["Advanced tracing"]
  node_method_compare["Method comparison"]
  node_full_analysis["Comprehensive analysis"]
  node_wavelength_view["Wavelength visualization"]
end

subgraph group_shared["Shared foundations"]
  node_validator["Input validator<br/>[input_validator.py]"]
  node_units["Units and conversion<br/>[unit.py]"]
  node_keys["Typed data keys<br/>[keys.py]"]
  node_converter["Value converter<br/>[converter.py]"]
end

node_user(("Engineer"))

node_user -->|"enters parameters"| node_gui
node_gui -->|"builds dataset"| node_dataset_helper
node_gui -->|"calculates focus"| node_base_optimizer
node_gui -->|"runs optimization"| node_two_lens
node_gui -->|"runs optimization"| node_three_lens
node_gui -->|"runs optimization"| node_four_lens
node_entry -->|"starts workflow"| node_combined_opt
node_entry -->|"starts workflow"| node_quick_opt
node_entry -->|"starts tracing"| node_real_trace
node_dataset_helper -->|"validates dataset"| node_validator
node_dataset_helper -->|"sets units"| node_units
node_dataset_helper -->|"uses keys"| node_keys
node_default_sets -->|"defines units"| node_units
node_base_optimizer -->|"creates defaults"| node_dataset_helper
node_base_optimizer -->|"uses datasets"| node_default_sets
node_base_optimizer -->|"validates inputs"| node_validator
node_base_optimizer -->|"scales values"| node_units
node_base_optimizer -->|"converts values"| node_converter
node_base_optimizer -->|"uses keys"| node_keys
node_two_lens -->|"delegates calculations"| node_base_optimizer
node_three_lens -->|"delegates calculations"| node_base_optimizer
node_four_lens -->|"delegates calculations"| node_base_optimizer
node_five_lens -->|"extends optimizer"| node_base_optimizer
node_quick_opt -->|"uses optimizer"| node_base_optimizer
node_quick_opt -->|"uses optimizer"| node_two_lens
node_quick_opt -->|"uses optimizer"| node_three_lens
node_combined_opt -->|"uses optimizer"| node_two_lens
node_combined_opt -->|"uses optimizer"| node_three_lens
node_combined_opt -->|"uses optimizer"| node_four_lens
node_combined_opt -->|"builds datasets"| node_dataset_helper
node_real_trace -->|"uses datasets"| node_default_sets
node_real_trace -->|"builds dataset"| node_dataset_helper
node_advanced_trace -->|"uses tracer"| node_real_trace
node_advanced_trace -->|"builds dataset"| node_dataset_helper
node_method_compare -->|"compares methods"| node_two_lens
node_method_compare -->|"compares methods"| node_three_lens
node_method_compare -->|"compares methods"| node_four_lens
node_method_compare -->|"compares methods"| node_five_lens
node_method_compare -->|"compares tracing"| node_real_trace
node_method_compare -->|"compares tracing"| node_advanced_trace
node_full_analysis -->|"uses optimizer"| node_two_lens
node_full_analysis -->|"uses optimizer"| node_three_lens
node_full_analysis -->|"uses optimizer"| node_four_lens
node_full_analysis -->|"uses optimizer"| node_five_lens
node_full_analysis -->|"uses tracing"| node_real_trace
node_wavelength_view -->|"visualizes results"| node_two_lens
node_wavelength_view -->|"visualizes results"| node_three_lens
node_wavelength_view -->|"visualizes results"| node_four_lens

click node_gui "https://github.com/artemkagh0st1k/diplom_work/blob/main/gui/app.py"
click node_entry "https://github.com/artemkagh0st1k/diplom_work/blob/main/main.py"
click node_dataset_helper "https://github.com/artemkagh0st1k/diplom_work/blob/main/data/dataset_helper.py"
click node_default_sets "https://github.com/artemkagh0st1k/diplom_work/blob/main/data/datasets.py"
click node_validator "https://github.com/artemkagh0st1k/diplom_work/blob/main/validators/input_validator.py"
click node_units "https://github.com/artemkagh0st1k/diplom_work/blob/main/utils/unit.py"
click node_keys "https://github.com/artemkagh0st1k/diplom_work/blob/main/utils/keys.py"
click node_converter "https://github.com/artemkagh0st1k/diplom_work/blob/main/utils/converter.py"
click node_base_optimizer "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/base.py"
click node_two_lens "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/two_lens.py"
click node_three_lens "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/three_lens.py"
click node_four_lens "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/four_lens.py"
click node_five_lens "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/five_lens.py"
click node_quick_opt "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/tracing_and_paraxial/quick_optimize.py"
click node_combined_opt "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/tracing_and_paraxial/optimize_and_trace.py"
click node_real_trace "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/real_tracing.py"
click node_advanced_trace "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/advanced_real_tracing.py"
click node_method_compare "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/compare_optimization_methods.py"
click node_full_analysis "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/comprehensive_optimization.py"
click node_wavelength_view "https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/wavelength_focus_visualization.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_gui,node_entry toneBlue
class node_dataset_helper,node_default_sets toneAmber
class node_base_optimizer,node_two_lens,node_three_lens,node_four_lens,node_five_lens,node_quick_opt toneMint
class node_combined_opt,node_real_trace,node_advanced_trace,node_method_compare,node_full_analysis,node_wavelength_view toneRose
class node_validator,node_units,node_keys,node_converter,node_user toneIndigo
```

## Components

### Desktop interface

- [Desktop GUI](https://github.com/artemkagh0st1k/diplom_work/blob/main/gui/app.py): `gui/app.py`
- [CLI entry](https://github.com/artemkagh0st1k/diplom_work/blob/main/main.py): `main.py`

### Optical data

- [Dataset builder](https://github.com/artemkagh0st1k/diplom_work/blob/main/data/dataset_helper.py): `data/dataset_helper.py`
- [Default datasets](https://github.com/artemkagh0st1k/diplom_work/blob/main/data/datasets.py): `data/datasets.py`

### Lens optimization

- [Base optimizer](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/base.py): `optimizers/base.py`
- [Two-lens optimizer](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/two_lens.py): `optimizers/two_lens.py`
- [Three-lens optimizer](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/three_lens.py): `optimizers/three_lens.py`
- [Four-lens optimizer](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/four_lens.py): `optimizers/four_lens.py`
- [Five-lens optimizer](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/five_lens.py): `optimizers/five_lens.py`
- [Quick optimization](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/tracing_and_paraxial/quick_optimize.py): `optimizers/tracing_and_paraxial/quick_optimize.py`

### Tracing and analysis

- [Optimize and trace](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/tracing_and_paraxial/optimize_and_trace.py): `optimizers/tracing_and_paraxial/optimize_and_trace.py`
- [Real ray tracing](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/real_tracing.py): `optimizers/real_tracing.py`
- [Advanced tracing](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/advanced_real_tracing.py): `optimizers/advanced_real_tracing.py`
- [Method comparison](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/compare_optimization_methods.py): `optimizers/compare_optimization_methods.py`
- [Comprehensive analysis](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/comprehensive_optimization.py): `optimizers/comprehensive_optimization.py`
- [Wavelength visualization](https://github.com/artemkagh0st1k/diplom_work/blob/main/optimizers/wavelength_focus_visualization.py): `optimizers/wavelength_focus_visualization.py`

### Shared foundations

- [Input validator](https://github.com/artemkagh0st1k/diplom_work/blob/main/validators/input_validator.py): `validators/input_validator.py`
- [Units and conversion](https://github.com/artemkagh0st1k/diplom_work/blob/main/utils/unit.py): `utils/unit.py`
- [Typed data keys](https://github.com/artemkagh0st1k/diplom_work/blob/main/utils/keys.py): `utils/keys.py`
- [Value converter](https://github.com/artemkagh0st1k/diplom_work/blob/main/utils/converter.py): `utils/converter.py`

### Other components

- **Engineer**

## Connections

- Engineer → Desktop GUI: enters parameters (evidence: `gui/app.py`)
- Desktop GUI → Dataset builder: builds dataset (evidence: `gui/app.py`)
- Desktop GUI → Base optimizer: calculates focus (evidence: `gui/app.py`)
- Desktop GUI → Two-lens optimizer: runs optimization (evidence: `gui/app.py`)
- Desktop GUI → Three-lens optimizer: runs optimization (evidence: `gui/app.py`)
- Desktop GUI → Four-lens optimizer: runs optimization (evidence: `gui/app.py`)
- CLI entry → Optimize and trace: starts workflow (evidence: `main.py`)
- CLI entry → Quick optimization: starts workflow (evidence: `main.py`)
- CLI entry → Real ray tracing: starts tracing (evidence: `main.py`)
- Dataset builder → Input validator: validates dataset (evidence: `data/dataset_helper.py`)
- Dataset builder → Units and conversion: sets units (evidence: `data/dataset_helper.py`)
- Dataset builder → Typed data keys: uses keys (evidence: `data/dataset_helper.py`)
- Default datasets → Units and conversion: defines units (evidence: `data/datasets.py`)
- Base optimizer → Dataset builder: creates defaults (evidence: `optimizers/base.py`)
- Base optimizer → Default datasets: uses datasets (evidence: `optimizers/base.py`)
- Base optimizer → Input validator: validates inputs (evidence: `optimizers/base.py`)
- Base optimizer → Units and conversion: scales values (evidence: `optimizers/base.py`)
- Base optimizer → Value converter: converts values (evidence: `optimizers/base.py`)
- Base optimizer → Typed data keys: uses keys (evidence: `optimizers/base.py`)
- Two-lens optimizer → Base optimizer: delegates calculations (evidence: `optimizers/two_lens.py`)
- Three-lens optimizer → Base optimizer: delegates calculations (evidence: `optimizers/three_lens.py`)
- Four-lens optimizer → Base optimizer: delegates calculations (evidence: `optimizers/four_lens.py`)
- Five-lens optimizer → Base optimizer: extends optimizer (evidence: `optimizers/five_lens.py`)
- Quick optimization → Base optimizer: uses optimizer (evidence: `optimizers/tracing_and_paraxial/quick_optimize.py`)
- Quick optimization → Two-lens optimizer: uses optimizer (evidence: `optimizers/tracing_and_paraxial/quick_optimize.py`)
- Quick optimization → Three-lens optimizer: uses optimizer (evidence: `optimizers/tracing_and_paraxial/quick_optimize.py`)
- Optimize and trace → Two-lens optimizer: uses optimizer (evidence: `optimizers/tracing_and_paraxial/optimize_and_trace.py`)
- Optimize and trace → Three-lens optimizer: uses optimizer (evidence: `optimizers/tracing_and_paraxial/optimize_and_trace.py`)
- Optimize and trace → Four-lens optimizer: uses optimizer (evidence: `optimizers/tracing_and_paraxial/optimize_and_trace.py`)
- Optimize and trace → Dataset builder: builds datasets (evidence: `optimizers/tracing_and_paraxial/optimize_and_trace.py`)
- Real ray tracing → Default datasets: uses datasets (evidence: `optimizers/real_tracing.py`)
- Real ray tracing → Dataset builder: builds dataset (evidence: `optimizers/real_tracing.py`)
- Advanced tracing → Real ray tracing: uses tracer (evidence: `optimizers/advanced_real_tracing.py`)
- Advanced tracing → Dataset builder: builds dataset (evidence: `optimizers/advanced_real_tracing.py`)
- Method comparison → Two-lens optimizer: compares methods (evidence: `optimizers/compare_optimization_methods.py`)
- Method comparison → Three-lens optimizer: compares methods (evidence: `optimizers/compare_optimization_methods.py`)
- Method comparison → Four-lens optimizer: compares methods (evidence: `optimizers/compare_optimization_methods.py`)
- Method comparison → Five-lens optimizer: compares methods (evidence: `optimizers/compare_optimization_methods.py`)
- Method comparison → Real ray tracing: compares tracing (evidence: `optimizers/compare_optimization_methods.py`)
- Method comparison → Advanced tracing: compares tracing (evidence: `optimizers/compare_optimization_methods.py`)
- Comprehensive analysis → Two-lens optimizer: uses optimizer (evidence: `optimizers/comprehensive_optimization.py`)
- Comprehensive analysis → Three-lens optimizer: uses optimizer (evidence: `optimizers/comprehensive_optimization.py`)
- Comprehensive analysis → Four-lens optimizer: uses optimizer (evidence: `optimizers/comprehensive_optimization.py`)
- Comprehensive analysis → Five-lens optimizer: uses optimizer (evidence: `optimizers/comprehensive_optimization.py`)
- Comprehensive analysis → Real ray tracing: uses tracing (evidence: `optimizers/comprehensive_optimization.py`)
- Wavelength visualization → Two-lens optimizer: visualizes results (evidence: `optimizers/wavelength_focus_visualization.py`)
- Wavelength visualization → Three-lens optimizer: visualizes results (evidence: `optimizers/wavelength_focus_visualization.py`)
- Wavelength visualization → Four-lens optimizer: visualizes results (evidence: `optimizers/wavelength_focus_visualization.py`)
