SpectraLab v0.8.1

SpectraLab v0.8.1 Release Notes

Measurement Workflow and Reproducible Examples

SpectraLab v0.8.1 completes the bounded Spotread one-shot workflow for the
X-Rite i1Pro2 and adds traceable pair-spectrum analyses plus curated,
release-ready examples.

Highlights

• Bounded automatic calibration and measurement without a persistent
  ENTER-controlled Spotread process.
• Controlled recalibration and one retry when calibration has expired.
• Optional, physically verified i1Pro2 high-resolution mode.
• Physical instrument serial-number provenance in new archives and reports.
• ANL-009 Spectral Mean with a reusable, traceable derived MAT archive.
• ANL-010 Spectral Difference for signed light-source stability diagnostics.
• Categorized measure_*, calculate_*_report, plot_*, interactive_*
  and list_* examples.
• Three synthetic, non-identifying SLAB-MAT example archives.

Spotread and i1Pro2

Automatic mode runs one bounded Spotread process for calibration and one for
measurement. SpectraLab waits for an explicit ready state, rejects incomplete
or dark signals and creates an archive only after console and .sp spectral
data agree.

The default trigger uses separate modal placement confirmations. The physical
i1Pro2 switch remains available through AutomaticTrigger="instrument".
The previously verified interactive workflow remains supported.

Measurement feedback uses one tone frequency:

• one beep when an operation starts;
• two beeps after success;
• five beeps after failure.

Derived spectral analyses

ANL-009 calculates the pointwise mean of two source archives. Its derived
archive records both source filenames, UUIDs, content hashes, roles and the
registered analysis definition.

ANL-010 calculates the signed difference A - B. It is intentionally
diagnostic and produces PDF and PNG outputs without saving a derived MAT
archive.

Release examples

Run startup from the project root. The categorized examples then provide:

measure_spectrum
measure_spectrum_series_5
calculate_cri_report
calculate_spectral_mean_report
calculate_spectral_difference_report
calculate_statusA_iso_visual_density_report
calculate_statusM_iso_visual_density_report
plot_spectrum
plot_transmission
list_archive_folder

Generated example outputs are written below examples/output/ and are never
overwritten.

Compatibility

• The SLAB-MAT archive format remains version 0.6.
• Archives released by v0.8.0 remain readable.
• The interactive Spotread workflow remains available.
• CSV and text exports remain supported.
• Standard spectral resolution remains the default.

Verification

• MATLAB R2025b on macOS.
• Python 3.12.13, pexpect 4.9.0 and ptyprocess 0.7.0.
• ArgyllCMS 3.5.0 and /usr/local/bin/spotread.
• Physical X-Rite i1Pro2 single-measurement workflow: passed.
• Physical five-measurement series: passed with five MAT, PDF and PNG sets.
• All non-hardware release workflows: passed in a temporary clean tree.
• Full regression: 73 test files, 465 test cases, 0 failed, 0 incomplete.

SpectraLab v0.8.0

SpectraLab v0.8.0 Release Notes

Analysis and Reporting

SpectraLab v0.8.0 adds a verified scientific analysis and reporting layer
to the established measurement and archive platform.

Highlights

• Spectral transmission and optical-density analysis.
• White, Status A, ISO visual and Status M density analysis.
• CIE XYZ, xyY and CIELAB analysis.
• CIE 13.3 colour-rendering analysis.
• Versioned standard spectral-filter and CIE test-sample data.
• Deterministic A4 PDF reports.
• Full-resolution PNG export for analyses with figures.
• A canonical analysis registry for every reportable analysis.
• Public analysis discovery with spectralab.report.listAnalyses and
  spectralab.report.describeAnalysis.

Plotting and Reports

• Standard plots begin at y = 0.
• Plot axes identify wavelength and the reported quantity.
• Measured-spectrum and CRI report figures include the measurement
  summary and legend.
• Report figures are embedded in PDF output and exported separately as
  PNG where the analysis defines a figure.
• OpenPDF=true opens the completed report in the system PDF viewer.

Registered analyses with figures:

• ANL-SPECTRUM - measured spectrum
• ANL-CRI - measured spectrum used for CIE 13.3 analysis
• ANL-001 - spectral transmission
• ANL-002 - spectral optical density

Registered analyses without figures:

• ANL-004 - white density
• ANL-005 - Status A density
• ANL-007 - ISO visual density
• ANL-008 - Status M density

Figureless reports are intentional: their registered results are scalar or
channel-based result tables rather than spectral curves.

Compatibility

• The established measurement and archive workflows remain supported.
• CSV and text export remain available.
• Released archive formats remain readable.
• The verified instrument workflow uses ArgyllCMS spotread with the
  X-Rite i1Pro2.

Verification

• 65 test files and 434 test cases passed in the final release suite.
• The interactive calibration and measurement workflow was verified with
  an X-Rite i1Pro2.
• All eight registered report analyses passed visual PDF review.
• The packaged release passed startup and the complete regression suite
  after extraction into a clean directory.

SpectraLab v0.7.0

Full Changelog: v0.6.0...v0.7.0