# isitadvait/multi-function-spectrometer architecture

> Architecture diagram of the GitHub repository isitadvait/multi-function-spectrometer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/isitadvait/multi-function-spectrometer
- Repository: https://github.com/isitadvait/multi-function-spectrometer

## Overview

This is a desktop optical spectrometer analyzer. Its main workflow is to acquire live spectra, capture Baseline/Standard/Sample measurements in R₀, R₆₀, or transmission modes, then inspect, process, and export the measurements; its Nd/Nk tools fit thin-film properties. A separate small entry point, main.py, provides a real-time plotting view. The user guide documents the UI/worker architecture and analysis capabilities; sampled excerpts do not expose all internal call sites, so edges for documented workflows cite the guide.

Main entry points: [`app.py`](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py) (Analyzer Window), [`hardware.py`](https://github.com/isitadvait/multi-function-spectrometer/blob/main/hardware.py) (Acquisition Worker), [`main.py`](https://github.com/isitadvait/multi-function-spectrometer/blob/main/main.py) (Realtime Entry Point), [`thin_film.py`](https://github.com/isitadvait/multi-function-spectrometer/blob/main/thin_film.py) (Thin-Film Fits)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Analyzer UI"]
  node_analyzer["Analyzer Window<br/>[app.py]"]
  node_measurement["Mode Captures<br/>[app.py]"]
  node_capture_data[("Capture Data<br/>[app.py]")]
  node_live_display["Live Plot<br/>[app.py]"]
end

subgraph group_acquisition["Spectral Acquisition"]
  node_worker["Acquisition Worker<br/>[hardware.py]"]
  node_mock["Mock Spectrometer<br/>[hardware.py]"]
end

subgraph group_analysis["Spectral Analysis"]
  node_post_process["Post-Process Viewer<br/>[app.py]"]
  node_conditioning["Spectral Conditioning<br/>[app.py]"]
  node_data_export["CSV and Images<br/>[app.py]"]
  node_ndnk["Nd/Nk Fitting UI<br/>[app.py]"]
  node_film_physics["Thin-Film Fits<br/>[thin_film.py]"]
end

subgraph group_alternate["Realtime Viewer"]
  node_realtime_app["Realtime Entry Point<br/>[main.py]"]
  node_realtime_plot["Realtime Plot<br/>[main.py]"]
end

node_user(("Lab User"))
node_spectrometer["Ocean Optics Device"]

node_user -->|"operates"| node_analyzer
node_analyzer -->|"controls"| node_worker
node_worker -->|"acquires from"| node_spectrometer
node_worker -->|"falls back to"| node_mock
node_worker -->|"emits spectra to"| node_live_display
node_analyzer -->|"selects captures"| node_measurement
node_measurement -->|"stores spectra"| node_capture_data
node_capture_data -->|"overlays captures"| node_live_display
node_analyzer -->|"opens"| node_post_process
node_post_process -->|"conditions spectra"| node_conditioning
node_post_process -->|"exports results"| node_data_export
node_analyzer -->|"provides fitting tools"| node_ndnk
node_ndnk -->|"uses fit calculations"| node_film_physics
node_user -->|"opens"| node_realtime_app
node_realtime_app -->|"reads spectra"| node_spectrometer
node_realtime_app -->|"updates"| node_realtime_plot

click node_analyzer "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_measurement "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_capture_data "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_live_display "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_post_process "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_conditioning "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_data_export "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_ndnk "https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py"
click node_film_physics "https://github.com/isitadvait/multi-function-spectrometer/blob/main/thin_film.py"
click node_worker "https://github.com/isitadvait/multi-function-spectrometer/blob/main/hardware.py"
click node_mock "https://github.com/isitadvait/multi-function-spectrometer/blob/main/hardware.py"
click node_realtime_app "https://github.com/isitadvait/multi-function-spectrometer/blob/main/main.py"
click node_realtime_plot "https://github.com/isitadvait/multi-function-spectrometer/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_analyzer,node_measurement,node_capture_data,node_live_display,node_user toneBlue
class node_worker,node_mock toneAmber
class node_post_process,node_conditioning,node_data_export,node_ndnk,node_film_physics toneMint
class node_realtime_app,node_realtime_plot toneRose
class node_spectrometer toneIndigo
```

## Components

### Analyzer UI

- [Analyzer Window](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`
- [Mode Captures](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`
- [Capture Data](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`
- [Live Plot](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`

### Spectral Acquisition

- [Acquisition Worker](https://github.com/isitadvait/multi-function-spectrometer/blob/main/hardware.py): `hardware.py`
- [Mock Spectrometer](https://github.com/isitadvait/multi-function-spectrometer/blob/main/hardware.py): `hardware.py`

### Spectral Analysis

- [Post-Process Viewer](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`
- [Spectral Conditioning](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`
- [CSV and Images](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`
- [Nd/Nk Fitting UI](https://github.com/isitadvait/multi-function-spectrometer/blob/main/app.py): `app.py`
- [Thin-Film Fits](https://github.com/isitadvait/multi-function-spectrometer/blob/main/thin_film.py): `thin_film.py`

### Realtime Viewer

- [Realtime Entry Point](https://github.com/isitadvait/multi-function-spectrometer/blob/main/main.py): `main.py`
- [Realtime Plot](https://github.com/isitadvait/multi-function-spectrometer/blob/main/main.py): `main.py`

### Other components

- **Lab User**
- **Ocean Optics Device**

## Connections

- Lab User → Analyzer Window: operates
- Analyzer Window → Acquisition Worker: controls (evidence: `app.py`)
- Acquisition Worker → Ocean Optics Device: acquires from
- Acquisition Worker → Mock Spectrometer: falls back to (evidence: `hardware.py`)
- Acquisition Worker → Live Plot: emits spectra to (evidence: `app.py`)
- Analyzer Window → Mode Captures: selects captures (evidence: `app.py`)
- Mode Captures → Capture Data: stores spectra (evidence: `app.py`)
- Capture Data → Live Plot: overlays captures (evidence: `app.py`)
- Analyzer Window → Post-Process Viewer: opens (evidence: `app.py`)
- Post-Process Viewer → Spectral Conditioning: conditions spectra (evidence: `app.py`)
- Post-Process Viewer → CSV and Images: exports results (evidence: `app.py`)
- Analyzer Window → Nd/Nk Fitting UI: provides fitting tools (evidence: `app.py`)
- Nd/Nk Fitting UI → Thin-Film Fits: uses fit calculations (evidence: `app.py`)
- Lab User → Realtime Entry Point: opens (evidence: `main.py`)
- Realtime Entry Point → Ocean Optics Device: reads spectra (evidence: `main.py`)
- Realtime Entry Point → Realtime Plot: updates (evidence: `main.py`)
