Runtime Classification of nuts
In this tutorial, you will learn how to use Breeze Runtime to run a workflow created in Breeze. To do this you will use the workflow from the “Classification of nuts tutorial”.
Before doing this tutorial, first do the tutorial: Classification of nuts step 1
Your goal is to learn how to export a workflow from Breeze, predict with Breeze Runtime, and visualize results in Breeze Client
Steps included in tutorial | |||
Play | Breeze Runtime | Breeze Client | |
![](../__attachments/564429701/image-20220322-145210.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Export workflow to Breeze Runtime
In this tutorial, you will use the same images as in the tutorial Classification of nuts step 1
Start Breeze and go into Play. Select the “Nuts_Classification” workflow
![image-20240527-142039.png](../__attachments/564429701/image-20240527-142039.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Choose “Export” tab, select “Export to Breeze Runtime” and press “Apply” button
![image-20240527-142105.png](../__attachments/564429701/image-20240527-142105.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Enter a new file name or use default (“Nuts_Classification.xml”).
The Workflow is now exported into the Breeze “Runtime” folder
Press “Next”.
![image-20240527-142127.png](../__attachments/564429701/image-20240527-142127.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
OPTIONAL Set Name and Description on Breeze Runtime workflow and select Segmentation and Type, i.e parallel or sequential object identification
Press Finish and close Breeze
![image-20240527-142320.png](../__attachments/564429701/image-20240527-142320.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Breeze Runtime folder location:[Workspace Folder]\Data\Runtime
Includes XML files for Breeze Runtime
Prediktera Simulator Camera setup
With Prediktera Simulator Camera you can simulate a realistic scenario running predictions with Breeze Runtime
Start Breeze Client and choose “Settings”
![image-20240527-142452.png](../__attachments/564429701/image-20240527-142452.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Select “Hardware” on the left side menu.
![image-20240527-142521.png](../__attachments/564429701/image-20240527-142521.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Select “Prediktera Simulator Camera” under “Selected Camera”
Uncheck the “Use directory measurements”
Browse or write the location to the image file that we are going to analyze, “Raw file”, and the “Dark Reference file” and “White reference file” (if you have one)
In this example we are using the files located in the following folder:[Workspace folder]\Record\Nuts_Classification\Test\Mix
Press “Connect” button
The camera should now be connected and you can see the information about the camera specifications.
![image-20240527-142542.png](../__attachments/564429701/image-20240527-142542.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
To test that it is now connected, choose Focus and start the camera by pressing the “Camera” switch. Press the switch again to stop.
![image-20240527-142556.png](../__attachments/564429701/image-20240527-142556.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Starting Breeze Runtime
You can start Breeze Runtime in a few different ways:
Using Breeze Client
C:\Program Files\Prediktera\Breeze\BreezeClient.exe
Using Breeze Runtime Demo application
C:\Program Files\Prediktera\Breeze\BreezeRuntimeDemo.exe
Manually from Breeze Runtime folder
C:\Program Files\Prediktera\Breeze\Runtime\BreezeRuntime.exe
To start BreezeRuntime manually, run the BreezeRuntime.exe file and then start Breeze Client or Breeze Runtime Demo application
Start Breeze Runtime with Breeze Client
In the “BreezeClient” press the “Connect” button
![image-20240527-142619.png](../__attachments/564429701/image-20240527-142619.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Choose Workflow and press “Open”
![image-20240527-142637.png](../__attachments/564429701/image-20240527-142637.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Press Start button to start the prediction
![image-20240527-142730.png](../__attachments/564429701/image-20240527-142730.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
View real-time Predictions under “Realtime” tab.
You can set the predicted parameter in the menu located over the image
![image-20240527-142800.png](../__attachments/564429701/image-20240527-142800.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
View latest white and dark ref. taken with Breeze Runtime under the “References” tab
![image-20240527-142813.png](../__attachments/564429701/image-20240527-142813.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
References are stored under [Workspace Folder]\Data\Runtime\References
View Breeze Runtime status under the “Status” tab
![image-20240527-142823.png](../__attachments/564429701/image-20240527-142823.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Record raw data during Prediction by switching the “Record raw data” switch (this saves the full spectral data). Press the switch again to stop recording raw data.
![image-20240527-142846.png](../__attachments/564429701/image-20240527-142846.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
The recorded raw data is stored under [Workspace Folder]\Data\Runtime\Measurements
. The "Save Object Only" option will only save the data for the pixels belonging to the identified objects (and not the background).
Save diagnostics for a time period from the Diagnostic tab. Press Start to begin logging diagnostic data and then Stop to generate a data.csv
file containing log and performance information. This information is also shown in plots that are generated in the output folder.
![image-20240527-142915.png](../__attachments/564429701/image-20240527-142915.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
For more information see Developers reference guide
Start Breeze Runtime with Breeze Runtime Demo
Breeze Runtime can be started separately by running “BreezeRuntimeDemo.exe”. This application simulates the scenario of having a “Customer Software Client” integration. The “Customer Software” will be master of Breeze Runtime which means that the Breeze Client cannot load workflow or start/stop prediction and will only be used to view the current prediction. If you close down Breeze Client then Breeze Runtime will continue to run predictions and you can start the Breeze Client again.
Close down the Breeze Client. Start BreezeRuntimeDemo.exe (C:\Program Files\Prediktera\Breeze\BreezeRuntimeDemo.exe
)
Click “LoadWorkflow” and Select workflow from list
![](../__attachments/564429701/att_8_for_564429701.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
TIP If you need to take new white and dark references (not required for this tutorial since these were already selected using the Breeze Client). Click the following buttons sequence:
“Close Shutter”
“Take Dark Reference”
“Open Shutter”
“Take White Reference”
Click “Start Predict”
Open Breeze Client and press “Connect” button. Breeze Client should automatically load the selected Workflow and show the Predictions under the “Realtime” tab.
![](../__attachments/564429701/att_14_for_564429701.png?inst-v=e71a6908-8716-4067-a364-accde5eac1f1)
Since Breeze Runtime is started before Breeze Client, the “Start” or “Stop” buttons are not visible.
If you have questions about Breeze Runtime and how to run your application in an industrial real-time environment.
Please contact support@prediktera.com