Recorder

Recorder is the component in Breeze used to capture data from cameras to disk or to test-run workflows with real-time data.

Recorder features

This is how the Recorder window looks:

image-20260318-142333.png

Here’s what you can do in Recorder: (if you prefer, scroll down to the step-by-step Recorder guide)

  • If you have more than one camera, select the camera to use. Using multiple cameras

  • Set frame rate and integration time and other hardware settings

  • Specify the name and size of the measurement

  • Click the Record-button to start recording

  • During, or after recording, use the top toolbar to switch visualizations of the recording to give you an idea of the quality of the recorded data:

    • RGB - use data from three wavelengths from the hyperspectral data to create a pseudo-RGB image. These wavelengths are typically configured in the camera settings.

    • Square root of RGB - same as RGB but by using the square root it can become easier to see smaller differences

    • Gray - view data for a single band/wavelength. Change band using a slider.

    • Intensity - maximum intensity (0 to 100%) in any band for each pixel. Can be used to find saturated pixels. Tip: toggle the legend with the toolbar button image-20260318-143922.png . Also see the Saturated pixels descriptor.

    • Saturation - percentage of saturated wavelength bands for each pixel. Pixels without saturation will be displayed a gray-scale image of the middle wavelength. Also see the Saturated pixels descriptor.

    • The dropdown, to the left of the buttons shows

  • After a recording of a measurement completes:

    • Launch Spectral Viewer to investigate all hyperspectral data in the image

    • Optionally Remove the recorded measurement, and/or use New to record another one.

    • Exit Recorder by clicking Done

In addition to recording fixed-length data as described here, Recorder can be used in a Continuous mode where data from the camera is sent in real-time through the Analysis Tree and visualized. This usage is described in the Tutorials and can be seen as an introduction to the more advanced applications of the Breeze Runtime, described in Breeze system overview.

Recorder guide

This step-by-step description describes how to use Recorder:

Start Breeze and click on New Project to the left to create a new project to record in.

image-20251128-094755.png

Open Breeze Recorder using the “Recorder” button.

image-20240604-115604.png

You are now in the data acquisition view

On the left side you have a panel to enter information and adjust the settings that will be used for recording a new image. You will see the cameras and scanners that Breeze Recorder is connected to.

Set Measurement length (how long the scan will be)

Write your file name (optional: add comments that will be save as meta info with the image file)

Reference information: Configure if you want to take an automatic white reference or not (“Disable”).

Adjust camera and scanner settings that you want to use for frame period and integration time.

image-20251124-084934.png

Press the red Record button on the upper left side of the screen to start the data acquisition.

The dark reference will be taken first and again at the end after the image has been captured.

If you have configured to capture a new white reference, the table will move to your set white reference location and take the white reference.

The image will then be taken and stored.

Dark and white references will be taken for each recording.

image-20240604-115939.png

The default view is a pseudo RGB image

Change to “Intensity” to identify oversaturated areas (white color). The “Saturation” image will show the % of bands that are saturated.

Tip If you have saturated pixels on your samples, lower the integration time and record the image again.

image-20251124-091039.png

Option: You can change direction of the visualization from vertical to horizontal scanning with the Options button / settings / Visualization

image-20240604-120317.png

Press “Spectrum viewer” button to view the captured image spectra

If you move the mouse cursor around in the pseudo RGB image it will update the spectral plot and show the spectrum for each pixel. If you hold down left mouse button, you can select areas and view and compare the average spectrum for each area.

On the left side of the screen there is a tool bar with tools for selecting areas and adding spectral plots.

You can also select to view the spectra as raw spectra or converted to radiance, reflectance and absorbance (if there is a white ref).

image-20251124-093441.png

If you are happy with your captured image you can then close the spectrum viewer and then

Press “New” button to record another image (the previous image has already been saved)

image-20240604-122011.png

Press “Remove” button to delete the current measurement (if you do not want to keep it)

image-20240604-121909.png

Press “Done” to leave the data capturing view and go to the Analyzer view

Here you can see all the images you have recorded in your project.

image-20240604-121936.png
image-20240826-062629.png

The recorded images are located on disk under the workspace folder:
{workspace folder}\Record\{project name}\{group name}

image-20251124-095901.png

You can have make several workspaces and switch between them depending on where you want to store our data.

Right click on the measurement select “Open in File Browser” to access the file
or choose Export “Spectral pixel data” to export raw, reflectance or absorbance

You can export your work by pressing the “Import/Export” button. Then press the spectral pixel data to get the spectral pixel data (hypercube) from the selected sample segmentation in Raw, Mat or image format.

export.png

Great job completing the guide! We hope you've enjoyed using the software.