Imaging#
- class Imaging(becExp)#
Bases:
BecAnalysisImagingcompute photon counts and saturation parameter statistics.Converts ROI data to mean light/dark counts and saturation parameter \(s = (\hbar\omega/I_\mathrm{sat}) (I_\mathrm{light}-I_\mathrm{dark}) / t\) with efficiency corrections, plots 1D error bars or 2D maps, and tracks a propagation version accounting for atom/light averaging.
- Associated Charts:
Chart(1): “Imaging analysis” - Saturation parameter and photon count plots
- Constructor Summary
- Property Summary
- DarkMean double#
Mean dark photon counts over ROI per run [counts]
- ImagingMethod string = "Absorption"#
Imaging technique: “Absorption”, “Dispersive”, “Fluorescence”, etc.
- ImagingStage string = "LF"#
Magnetic field stage: “LF” (low-field), “HF” (high-field), “NI” (non-interacting)
- ImagingTime double = []#
Imaging pulse exposure time per run [time units]
- ImagingTimeUnit string#
Unit string for imaging time from variable settings
- LightMean double#
Mean light photon counts over ROI per run [counts]
- QuantumEfficiency double = 1#
Camera quantum efficiency at imaging wavelength [dimensionless]
- SaturationParameterMean double#
Saturation parameter \(s = I/I_\mathrm{sat}\) averaged over ROI per run
- SaturationParameterMeanOverall double#
Overall saturation parameter \(\langle s \rangle\) averaged over ROI and all runs
- SaturationParameterPropagation#
Spatially-resolved saturation parameter \(s(y,x) = (s_\mathrm{atom} + s_\mathrm{light})/2\) per run
- Transmission double = 1#
Overall optical system transmission factor [dimensionless]
- Method Summary
- initialize()#
Initialize plots and precompute constants for imaging analysis.
Sets up dual subplot layout for saturation parameter and photon counts, initializes data storage arrays, and configures plot properties. Get Imaging time variable name
- refresh()#
Recompute imaging metrics for all runs and refresh visualization.
Reloads all ROI data, recalculates photon counts and saturation parameters, updates the spatially-resolved saturation map, and refreshes the display plots.
- updateData(runIdx)#
Compute imaging metrics for a given run.
Calculates mean photon counts (corrected for quantum efficiency and transmission), saturation parameter, and spatially-resolved saturation map for downstream absorption density analysis.
- Parameters:
runIdx (
double) – Run index to process
- updateFigure(~)#
Update figure for 1D or 2D scans based on current data. Check if we have the figure handle
- updateFigure1D(fig)#
Update 1D plots with errorbar series for photon counts and saturation.
Displays light/dark photon counts and saturation parameter as error bar plots versus the scanned parameter.
- Parameters:
fig (
matlab.ui.Figure) – Figure handle
Parameters
- updateFigure2D(fig)#
Update 2D plots with heatmaps for saturation and photon differences.
Creates density plots showing saturation parameter and light-dark difference across the two-dimensional parameter space.
- Parameters:
fig (
matlab.ui.Figure) – Figure handle