Software + Fixed Rate
This topic introduces the workflow of using software to trigger a round of data acquisition and triggering each line scan at a fixed rate.
Prerequisites
In order to use the software + fixed rate method to trigger data acquisition, the following prerequisites must be satisfied:
-
Improve the quality of the profiles:
The intensity image, depth map, and point cloud are made of multiple profiles. Therefore, the quality of the profiles determines the quality of the intensity image, depth map, and point cloud.
Please refer to Profile Mode to adjust the parameters in the profile mode, in order to improve the quality of the profiles.
Workflow
The laser profiler supports three acquisition methods: triggering a single round of data acquisition, automatically triggering multiple rounds of data acquisition, and continuous scanning. Their workflows are different.
Triggering a Single Round of Data Acquisition
When using this method, after triggering a round of data acquisition, the laser profiler scans a fixed length on the object’s surface, generates an intensity image and a depth map, and then automatically exits the acquisition ready status.
To trigger a single round of data acquisition, follow these steps:
-
Set parameters: Configure the parameters as shown in the table below, and adjust other parameters as needed.
Mech-Eye Viewer
-
Set Data Acquisition Method to Frame-Based.
-
Set the Data Acquisition Trigger Source parameter to Software.
-
Set Line Scan Trigger Source to Fixed rate.
Mech-Eye API
-
Set DataAcquisitionMethod to Frame_Based.
-
Set DataAcquisitionTriggerSource to Software.
-
Set LineScanTriggerSource to FixedRate.
GenICam client
-
Set AcquisitionMode to SingleFrame.
-
Set TriggerMode to On, and set DataAcquisitionTriggerSource to Software.
-
Set LineScanTriggerSource to FixedRate.
-
-
Enter the laser profiler to the acquisition ready status: The laser profiler can only respond to software signals after it enters the acquisition ready status.
-
Mech-Eye Viewer: In the scan mode, click the
button. -
Mech-Eye API: Call the
startAcquisition()method. -
GenICam client: Send the
AcquisitionStart()command to the laser profiler.
-
-
Trigger a round of data acquisition:
-
Mech-Eye Viewer: After entering the acquisition ready status in step 2, the laser profiler automatically triggers a round of data acquisition.
-
Mech-Eye API: Call the
triggerSoftware()method. -
GenICam client: Send the
TriggerSoftware()command to the laser profiler.
After the current round of data acquisition has been started, the laser profiler starts line scans at the set rate.
-
-
End the current round of data acquisition:
Set an appropriate value for the Scan Line Count parameter. The current round of data acquisition ends automatically when the set number of lines has been scanned.
-
Exit the acquisition ready status: Exiting the acquisition status when you do not need to acquire data can avoid triggering data acquisition by mistake.
-
Mech-Eye Viewer:
-
In the scan mode, click the
button. -
The laser profiler will automatically exit the acquisition ready status after scanning the set scan line count.
-
-
Mech-Eye API: Call the
stopAcquisition()method. -
GenICam client:
-
Send the
AcquisitionStop()command to the laser profiler. -
The laser profiler will automatically exit the acquisition ready status after scanning the set scan line count.
-
-
Triggering Multiple Rounds of Data Acquisition
When using this method, after triggering a round of data acquisition, the laser profiler scans a fixed length on the object’s surface, and generates an intensity image and a depth map. After a round of data acquisition, the laser profiler remains in the acquisition ready status.
To trigger multiple rounds of data acquisition, follow these steps:
-
Set parameters: Configure the parameters as shown in the table below, and adjust other parameters as needed.
Mech-Eye Viewer
-
Set Data Acquisition Method to Frame-Based.
-
Set the Data Acquisition Trigger Source parameter to Software.
-
Set Line Scan Trigger Source to Fixed rate.
Mech-Eye API
-
Set DataAcquisitionMethod to Frame_Based.
-
Set DataAcquisitionTriggerSource to Software.
-
Set LineScanTriggerSource to FixedRate.
GenICam client
-
Set AcquisitionMode to Continuous.
-
Set TriggerMode to On, and set DataAcquisitionTriggerSource to Software.
-
Set LineScanTriggerSource to FixedRate.
-
-
Enter the laser profiler to the acquisition ready status: The laser profiler can only respond to software signals after it enters the acquisition ready status.
-
Mech-Eye Viewer: In the scan mode, click the
button. -
Mech-Eye API: Call the
startAcquisition()method. -
GenICam client: Send the
AcquisitionStart()command to the laser profiler.
-
-
Trigger a round of data acquisition:
-
Mech-Eye Viewer: After entering the acquisition ready status in step 2, the laser profiler automatically triggers a round of data acquisition.
-
Mech-Eye API: Call the
triggerSoftware()method. -
GenICam client: Send the
TriggerSoftware()command to the laser profiler.
After the current round of data acquisition has been started, the laser profiler starts line scans at the set rate.
-
-
End the current round of data acquisition: Set an appropriate value for the Scan Line Count parameter. The current round of data acquisition ends automatically when the set number of lines has been scanned.
-
Start a new round of data acquisition:
-
Mech-Eye Viewer: After the last round of data acquisition ends, the laser profiler automatically starts a new round of data acquisition.
-
Mech-Eye API: Repeat step 3.
-
GenICam client: Repeat step 3.
-
-
Exit the acquisition ready status: Exiting the acquisition status when you do not need to acquire data can avoid triggering data acquisition by mistake.
-
Mech-Eye Viewer: In the scan mode, click the
button. -
Mech-Eye API: Call the
stopAcquisition()method. -
GenICam client: Send the
AcquisitionStop()command to the laser profiler.
-
Continuous Scanning
When using this method, after triggering a round of data acquisition, the laser profiler continuously scans the target object and returns fixed-length data segments. After a round of data acquisition, the laser profiler remains in the acquisition ready status.
To continuously scan the target object, follow these steps:
-
Set parameters: Configure the parameters as shown in the table below, and adjust other parameters as needed.
Mech-Eye Viewer
-
Set Data Acquisition Method to Nonstop.
-
Set the Data Acquisition Trigger Source parameter to Software.
-
Set Line Scan Trigger Source to Fixed rate.
Mech-Eye API
-
Set DataAcquisitionMethod to Nonstop.
-
Set DataAcquisitionTriggerSource to Software.
-
Set LineScanTriggerSource to FixedRate.
GenICam client
-
Set AcquisitionMode to Continuous.
-
Set TriggerMode to Off, and set DataAcquisitionTriggerSource to Software.
-
Set LineScanTriggerSource to FixedRate.
-
-
Trigger data acquisition:
-
Mech-Eye Viewer: In the scan mode, click the
button. -
Mech-Eye API: Call the
startAcquisition()methodto enter the laser profiler to the acquisition ready status. Then call thetriggerSoftware()method to trigger data acquisition. -
GenICam client: Send the
AcquisitionStart()command to the laser profiler.
After data acquisition has been started, the laser profiler starts line scans at the set rate.
-
-
Stop data acquisition:
-
Mech-Eye Viewer: In the scan mode, click the
button. -
Mech-Eye API: Call the
stopAcquisition()method. -
GenICam client: Send the
AcquisitionStop()command to the laser profiler.
-
-
Start the next round of data acquisition: Repeat step 2.