Breeze HySpex Recorder Guide

Introduction to Breeze Record Software Guide

Welcome to the guide on connecting and using Hyspex cameras with Breeze Record software by Prediktera. This guide provides clear instructions for setting up and optimizing your Hyspex camera with Breeze Record.

You'll learn how to:

1. Install and Connect your Hyspex camera to your computer.

2. Configure Breeze Record for optimal use.

3. Capture high-quality hyperspectral images.

4. Manage and analyze your data efficiently.

Follow these steps to enhance your hyperspectral imaging projects with ease. Let's get started!

Table of contents

Breeze Record installation guide

Install Breeze

Select HySpex camera in supplier list in the installation wizard for Windows

Connect to HySpex camera

Start Breeze the start menu should look like this

Open setting by pressing the settings button

Under “Cameras” and “First camera” open the drop-down menu and select “HySpex SDK”.

After you have selected the HySpex SDK, you need to find the HySpex Ground folder. Press the “Browse” button to the right of the “Settings folder”.

Locate the HySpex Ground folder. If you have purchased a computer from HySpex with the camera setup the folder is usually located on the desktop of the computer. When you have located the folder press “Open”.

Wait until the camera has been found. You should then see the name of your camera under “Type” (If you have more then one camera turned on and connected you can press the drop-down menu to see the different cameras).

In “Lens” you can select which type of lens you have attached to the camera.

Choose the “Calibrated reflectance target” that you are using with the white reference

When you have selected the right camera and lens and “Calibrated reflectance target”,
then Press the “Connect” button.

If you connected successfully you should see the camera information.

Connecting scanner table

Under “Selected Sample Mover” press the drop-down menu and select “HySpex Stepper table”

Press “Connect”.

Set different locations on the table.

• Focus location - Position of a focus paper (Optional)

• White reference location - Location of the white reference on the table

• White reference scan length - How long you should measure the white reference in mm (Recommended around 50 mm)

• Scan start location - Where Breeze Recorder should start the data acquisition on the table

• Return location - The location where the table moves back to after recording (We recommended using the same for start and return location)

If you press the “Move to” buttons the table will move to the set location.

Connection troubles

If you have trouble connecting to either the cameras or the table, start by making sure all cables are firmly connected and the power is on. Close “HySpex Ground” program and restart Breeze.

If you still have a problem connecting the camera. Close Breeze and start “HySpex Ground”. If you can't connect to the cameras in HySpex Ground contact HySpex support: hyspexsupport@neo.no

If you can connect to the cameras and tables in HySpex Ground but not Breeze contact us at: support@prediktera.com

Start and run Breeze Record after the first set up

Configuration of devices

Start Breeze with the shortcut created after installation.
The Breeze start screen should look like this:

Breeze is organized into different views depending on the task at hand. Each view has a specific purpose as noted below each button.

Enter the Settings view by pressing the “Settings” button

Hardware

Select “Cameras”

Select Camera

Set the camera you would like to use in the “First camera” drop down

Expand “Advanced” to see optional settings available for your camera (optional)

Under “Type” select your camera type

Expand advanced again to see updated options for your connected camera.
Set “Frame rate”. The number of frames per second.

Camera information is presented. In this example the “Offline Simulator Camera” is connected:

Sample Mover

Set the Sample Mover that you want to use in the “Selected Sample Mover” drop-down

Select “Serial port” (Optional)

Sample mover locations

Press “Connect”

Focus

It’s important that the focus is set correctly for the lens before data acquisition. Make sure that the focus strip position is at the same height as the highest point of the sample you will analyze.

“Field of view” is the width of the image you can see in focus, specified in millimeters.

Turn on the lamps.

Press “Camera” and press “Focus grid”

You can make use of the “Focus rate” value to get the best focus. Adjust manually the lens and until you reach the highest focus rate and the lines are sharp.

The “Line plot” can also help you to set the focus. Vertical lines will indicate a sharp image.

Press “Scan” and measure a round object to make sure that the “Field of view” is correctly set.

Integration Time

Press the integration time button on the left side panel

Adjust the “Integration Time” so that the highest value is between 80-90% (the background color changes to green) of the camera max signal, shown in the “Saturation ratio”.

Make sure the “Camera” button is selected.

Press the “White reference” button. The table will move to the position that we set as the white reference location.

Place your reference target on the table. Adjust the frame period and integration time to give the correct intensity for your reference target.

You can move “Position” slider to show white reference values on other pixels

Press “Min and max” to show minimum and maximum overall pixels

If “Integration Time” is set to high the white reference image will be saturated, which means that some signal data can be lost.

Test scan

Press the “Test scan” button. Here you do a test image of your samples that will not be saved on the hard drive. This is done to make sure your camera settings are providing good results.

Set “Measurement Length”.

This is how long the image scan will be in millimeters, frames or seconds.

Press “Scan” to start data acquisition of your samples.

There are buttons to select different visualization of your test set. Press the Saturation button to view the signal intensity of your image. White areas indicate over saturated pictures.

References

Press References button on the left side panel.

In the “Reference frames” field write how many frames that will be used for the references.

The “White Reference scan length” is how many mm it will scan when taking the white reference.

Breeze can store “White reference” and “Dark reference” images in memory during the Breeze session. The time that the references are stored is specified in the two input fields. When the time specified has expired Breeze will automatically take new references. If the values are 0 (default), it will take a new white and dark reference for every new scan.

For dark reference we recommend taking a new dark reference for every scan.

Example below, the white reference will be stored for two hour before it will take a new reference.

Sensor

Press the “Camera” switch. Shows bad or dead pixels

You have now completed the camera and sample mover setup! Switch to record mode to start scanning your samples.

Breeze Recorder

Start Breeze and click on the “New Project” button on the left hand side.

Open Breeze Recorder using the “Recorder” button.

Set Measurement length and write your file name.

Press the Record button to start the data acquisition.

The dark reference will be taken first and again at the end.

The table will move to your set white reference location and take the white reference.

The image will then be taken.

The selected cameras and sample mover will automatically connect.

Change to Saturation to identify over saturated areas (white color).

Press “Explore” button to plot spectrum from selected pixel areas. You can view the spectra as raw spectra, reflectance and absorbance.

Click on Model (PCA) → Create, to create a PCA modes.

Select Cluster in “Variance scatter” and see what pixels it corresponds to in your image.

Press New button to record another measurement

Press Remove button to delete current measurement

Press Done to go back to previous window

Now the image will be shown in horizontal direction.

When recording is done press “Done” button to return to the Analyzer and view the recordings in the table

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.