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:
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
. 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
-
Raw / Reflectance / Absorbance / Radiance which can be used to switch between those to see the effect of Dark and White References references and theSpectral imaging modes.
-
Descriptors used in the Analysis Tree. They can visualize data in real-time during the recording. Learn more about Workflow Analysis Tree and applying changes
-
-
-
-
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.
Open Breeze Recorder using the “Recorder” button.
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.
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.
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.
Option: You can change direction of the visualization from vertical to horizontal scanning with the Options button / settings / Visualization
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).
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)
Press “Remove” button to delete the current measurement (if you do not want to keep it)
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.
The recorded images are located on disk under the workspace folder:
{workspace folder}\Record\{project name}\{group name}
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.
Great job completing the guide! We hope you've enjoyed using the software.