Calibration
Camera Calibration
For the calibration of the profiler to be conducted, the camera itself needs to be calibrated.
Preparation:
- Open DV.
- Select
Connect to
→Remote runtime
and enter the IP address of the DVL-5000. The port is4040
.- If the DVL-5000 is connected to a DNS, you can enter
dvl-5000
instead of the IP address.
- If the DVL-5000 is connected to a DNS, you can enter
- Open the DV configurations downloaded from the release site: .tar.gz or .zip.
- Select
File
→Open project
and select the path to the folder to which you extracted the downloaded archive containing the DV configurations. - Select the DV configuration named
dvl-5000-camera-calibration.xml
.
- Select
- Plug in the DVL-5000.
- Mount the DVL-5000 to the place of its intended use.
- Print out the Siemens Star and the camera calibration pattern.
- Start all of the modules, and switch to the
Output
tab in DV. - Focus the lens using the printed Siemens Star.
- Open up the aperture completely using the lens' ring that says
open
andclose
. - Adjust the field of view to cover the desired measurement range using the lens' ring that says
near
andfar
. - Focus of view using the lens' ring that says
tele
andwide
. When the lens is perfectly in focus, the centre of the Siemens Star is visible without any shade.
- Open up the aperture completely using the lens' ring that says
- Lock all of the rings on the lens using the screws in them.
Execution:
- Move around the camera calibration pattern in front of the DVL-5000.
- Once the calibration pattern is detected, the area in which it was detected will gradually be covered in a green overlay. Try to cover as much of the frame in green as possible.
- Once enough calibration points have been collected, they will be displayed again for review. They can be accepted or rejected by clicking
keep
ordiscard
, respectively. - After the collected images have been reviewed, the calibration is calculated, and the results are displayed in the runtime log.
- If the reprojection error is in an acceptable range, the calibration results are stored in
/home/ubuntu/calibration_camera.xml
.
For more in-depth information on the camera calibration, please refer to the camera calibration tutorial.
Profiler Calibration
After the camera is calibrated, the profiler can be calibrated.
- As described above, the DVL-5000 should already be mounted to the place of its intended use.
- Place the calibration object in front of the DVL-5000.
- The laser line should be visible on all levels of the calibration piece.
- The pictures below show how the DVL-5000 and the calibration object should be positioned.
- Make sure the laser is focused for its intended measurement range.
- Open DV.
- Select
Connect to
→Remote runtime
and enter the IP address of the DVL-5000. The port is4040
.- If the DVL-5000 is connected to a DNS, you can enter
dvl-5000
instead of the IP address.
- If the DVL-5000 is connected to a DNS, you can enter
- Open the DV configurations downloaded from the release site: .tar.gz or .zip.
- Select
File
→Open project
and select the path to the folder to which you extracted the downloaded archive containing the DV configurations. - Select the DV configuration named
dvl-5000-profiler-calibration.xml
.
- Select
- Start all of the modules, and switch to the
Output
tab in DV. - Click "Collect" in order to collect calibration data.
- The "Collect" button is highlighted in the figure below.
- Click "Calibrate" in order to conduct the calibration.
- The "Calibrate" button is highlighted in the figure below.
The figures below show an example physical setup for the calibration and the resulting output in DV.
The figure below shows the highlighted buttons for the calibration and testing.
The DVL-5000 should be running automatically. If it is not running, enable the DVL-5000 by checking the box "Enable signal generator" under the external input configuration.
Testing the Calibration Results
The calibration results can be tested with an object of constant height that covers the whole DV sensor. It is also possible to test with the DVL-5000 pointed on the ground plane (i.e. the test height being 0).
The test is conducted as follows:
- Point the DVL-5000 at the ground plane.
- Open DV.
- Select
Connect to
→Remote runtime
and enter the IP address of the DVL-5000. The port is4040
.- If the DVL-5000 is connected to a DNS, you can enter
dvl-5000
instead of the IP address.
- If the DVL-5000 is connected to a DNS, you can enter
- Open the DV configurations downloaded from the release site: .tar.gz or .zip.
- Select
File
→Open project
and select the path to the folder to which you extracted the downloaded archive containing the DV configurations. - Select the DV configuration named
dvl-5000-profiler-calibration.xml
.
- Select
- Start all of the modules, and switch to the
Output
tab in DV. - Click "Collect" in order to collect calibration data.
- The "Collect" button is highlighted in the figure below.
- Click "Test" in order to conduct the test.
- The "Test" button is highlighted in the figure below.
The figure below shows the highlighted buttons for the calibration and testing.
Once the test is finished, a visualization of the error distribution of will be displayed, as shown below. The collected data are colour coded based on their measurement error, with a colourbar displayed on the right.
Advanced Calibration targeted at Specific Object Sizes and Measurement Ranges
While the calibration piece provided is targeted at a very wide measurement range, it may be useful to calibrate for a smaller or larger range. The dv-profiler-calibration
module allows for any calibration object to be used, provided there are more than three different levels of height, the difference in these levels being constant. For example you use a stair with five steps, as long as the step heights is the same for all steps.
The advanced configuration options for the profiler calibration module are shown in the image below. In order to use a custom calibration object suited specifically for your application, you can modify the step height (in mm
) and the number of steps.