Skip to content

zaps166/SpectrometerUI

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
android
android
 
 
icons
icons
 
 
qml
qml
 
 
screenshots
screenshots
 
 
tests
tests
 
 
.gitignore
.gitignore
 
 
AGENTS.md
AGENTS.md
 
 
Application.cpp
Application.cpp
 
 
Application.hpp
Application.hpp
 
 
BlackBody.cpp
BlackBody.cpp
 
 
BlackBody.hpp
BlackBody.hpp
 
 
BlackBodyWorker.cpp
BlackBodyWorker.cpp
 
 
BlackBodyWorker.hpp
BlackBodyWorker.hpp
 
 
BlueLightHazardData.cpp
BlueLightHazardData.cpp
 
 
BlueLightHazardData.hpp
BlueLightHazardData.hpp
 
 
CH341Uart.cpp
CH341Uart.cpp
 
 
CH341Uart.hpp
CH341Uart.hpp
 
 
CMF10deg.inc
CMF10deg.inc
 
 
CMakeLists.txt
CMakeLists.txt
 
 
CieDIlluminantData.cpp
CieDIlluminantData.cpp
 
 
CieDIlluminantData.hpp
CieDIlluminantData.hpp
 
 
CieXyz1931TwoDegData.cpp
CieXyz1931TwoDegData.cpp
 
 
CieXyz1931TwoDegData.hpp
CieXyz1931TwoDegData.hpp
 
 
CieXyz1964TenDegData.cpp
CieXyz1964TenDegData.cpp
 
 
CieXyz1964TenDegData.hpp
CieXyz1964TenDegData.hpp
 
 
Cri.cpp
Cri.cpp
 
 
Cri.hpp
Cri.hpp
 
 
CriData.cpp
CriData.cpp
 
 
CriData.hpp
CriData.hpp
 
 
CriGraph.cpp
CriGraph.cpp
 
 
CriGraph.hpp
CriGraph.hpp
 
 
DataSeqIterp.hpp
DataSeqIterp.hpp
 
 
DaylightWorker.cpp
DaylightWorker.cpp
 
 
DaylightWorker.hpp
DaylightWorker.hpp
 
 
DuvGraph.cpp
DuvGraph.cpp
 
 
DuvGraph.hpp
DuvGraph.hpp
 
 
ErythemalActionData.cpp
ErythemalActionData.cpp
 
 
ErythemalActionData.hpp
ErythemalActionData.hpp
 
 
Exposure.hpp
Exposure.hpp
 
 
FileWorker.cpp
FileWorker.cpp
 
 
FileWorker.hpp
FileWorker.hpp
 
 
Headers.hpp
Headers.hpp
 
 
Helpers.cpp
Helpers.cpp
 
 
Helpers.hpp
Helpers.hpp
 
 
LICENSE
LICENSE
 
 
LuminousEfficiencyData.cpp
LuminousEfficiencyData.cpp
 
 
LuminousEfficiencyData.hpp
LuminousEfficiencyData.hpp
 
 
MacAdamEllipse.cpp
MacAdamEllipse.cpp
 
 
MacAdamEllipse.hpp
MacAdamEllipse.hpp
 
 
MelanopicActionData.cpp
MelanopicActionData.cpp
 
 
MelanopicActionData.hpp
MelanopicActionData.hpp
 
 
Ohno2013.cpp
Ohno2013.cpp
 
 
Ohno2013.hpp
Ohno2013.hpp
 
 
README.md
README.md
 
 
ScotopicEfficiencyData.cpp
ScotopicEfficiencyData.cpp
 
 
ScotopicEfficiencyData.hpp
ScotopicEfficiencyData.hpp
 
 
SpdData.hpp
SpdData.hpp
 
 
SpectrometerBridge.cpp
SpectrometerBridge.cpp
 
 
SpectrometerBridge.hpp
SpectrometerBridge.hpp
 
 
SpectrometerWorker.cpp
SpectrometerWorker.cpp
 
 
SpectrometerWorker.hpp
SpectrometerWorker.hpp
 
 
Spectrum.cpp
Spectrum.cpp
 
 
Spectrum.hpp
Spectrum.hpp
 
 
Tm30.cpp
Tm30.cpp
 
 
Tm30.hpp
Tm30.hpp
 
 
Tm30Data.cpp
Tm30Data.cpp
 
 
Tm30Data.hpp
Tm30Data.hpp
 
 
Tm30Graph.cpp
Tm30Graph.cpp
 
 
Tm30Graph.hpp
Tm30Graph.hpp
 
 
TorchBearerDevice.cpp
TorchBearerDevice.cpp
 
 
TorchBearerDevice.hpp
TorchBearerDevice.hpp
 
 
TorchBearerWorker.cpp
TorchBearerWorker.cpp
 
 
TorchBearerWorker.hpp
TorchBearerWorker.hpp
 
 
VitaminDActionData.cpp
VitaminDActionData.cpp
 
 
VitaminDActionData.hpp
VitaminDActionData.hpp
 
 

Repository files navigation

Spectrometer UI

A small desktop application (C++23 and QML) providing a user interface for spectrometer measurements. The project can communicate with devices either via Qt's QSerialPort or directly through libusb. It computes TM-30 and CRI colour rendering metrics, among others.

Screenshot

Requirements

  • C++23 compiler
  • CMake >= 3.31
  • Qt 6.11 (QuickControls2, ShaderTools)
  • Ninja (recommended generator)
  • pkg-config and libusb-1.0 development package (if you intend to build with libusb)

Default Release Build (Linux)

These commands create a Release build in build/release (no tests):

  • Using Qt QSerialPort (default):
  cmake -B build/release -S . -G Ninja -DCMAKE_BUILD_TYPE=Release
  cmake --build build/release
  • Using libusb:
  cmake -B build/release -S . -G Ninja -DCMAKE_BUILD_TYPE=Release -DUSE_QT_SERIAL_PORT=OFF
  cmake --build build/release

Notes

  • By default the project builds with QSerialPort support (CMake option USE_QT_SERIAL_PORT is ON). If you choose libusb, ensure libusb-1.0 development files are installed and available to CMake/pkg-config.
  • Tests are not built by default. To build tests enable -DBUILD_TESTS=ON at configure time.
  • AddressSanitizer can be enabled at configure time with -DUSE_ASAN=ON (useful for memory debugging).

Supported Devices

  • Currently the only supported spectrometer is the Torchbearer device identified as "Y21B7W10034CCPD".
  • The application can also analyze spectral power distribution (SPD) data from CSV files without a connected spectrometer.

Acknowledgements

  • The UI design is inspired by the Flameeye software.
  • Special thanks to the Torch-Bearer-Tools project for reverse-engineering work on the communication protocol used by the Torchbearer device.

Platform Status

The program is intended to run on Android, desktop Linux, Windows, macOS. The codebase has not been compiled or validated on Windows or macOS yet.

AI Contributions

The following parts of the program were in large part written by AI and validated by comparing their outputs against the Python colour-science library:

  • CH341 libusb UART driver
  • Robertson (CCT)
  • Ohno 2013 (CCT)
  • MacAdam (SDCM)
  • Duv (including graph with shader)
  • CRI (partially including bars graph)
  • TM-30 (including bars graph)
  • Dominant wavelength
  • Tests
  • Markdown files

About

Spectrometer measurements

Resources

Readme

License

BSD-3-Clause license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 2

v1.0.1 Latest
Jun 9, 2026
+ 1 release

Contributors

Languages