Overview: Deepen Calibrate is a software tool that makes the critical task of sensor data calibration simple and quick.
- This page allows the users to create, list, launch and delete calibration datasets. Admins can manage user's access to these datasets on this page.
- Click on ‘New Calibration’ to create a new calibration dataset.
- Upon clicking the ‘New Calibration’ button, the user can make a selection from the different calibrations. Select ‘Radar-Camera Calibration’ to create a new radar-camera calibration dataset.
- Upon selecting ‘Radar-Camera Calibration’, the user is welcomed to the instructions page
- Click on ‘Get started’ after finishing with the instructions. A pop-up is displayed that asks for:
- 1.Dataset name
- 2.Edge length of the reflector
- 3.Configuration of the checkerboard
The user must fill in all the mandatory fields and click on ‘Set Details’ to proceed ahead.
The user can also choose to add the configuration by uploading a JSON file if required. Please check the Steps to upload the configuration by JSON file section for more details.
Radar-Camera Calibration consists of two stages:
- Radar Camera setup: Add camera details, files, and reflector coordinates.
- Detect corners: Detect the checkerboard corners in each image.
- Calibrate: Run the calibration algorithm and visualise the results.
A few other details
- 1.The user can choose to hit the ‘Save changes’ option at any stage to prevent loss of work.
- 2.The user can navigate between the stages and update the details as per convenience.
- 3.Download the results by using the ‘Export’ option.
- 4.Click on the ‘Help Center’ button ( the top right corner) to get your doubts answered related to the calibration.
This stage is broadly categorised into three steps:
- Setup Camera Intrinsics: Add/upload your camera’s intrinsic parameters. The user can click on ‘Get intrinsic parameters’ to calibrate the camera.
- Add files: Upload the files captured using the camera.
- Add reflector coordinates: Enter the coordinates of the reflector captured using radar.
To move on to the calibration stage, complete the radar-camera setup and then click on continue.
Users can click on the 'Detect corners' button. We try to auto-detect most of the corners, if the checkerboard corners detection fails user can add four border markers to detect all the inner checkerboard corners.
Users can select four boundary marker points in the order (top-left, top-right, bottom-left, bottom-right). And then click on the 'Detect corners' button, to get the remaining inner corners of the checkerboard.
The user can review the files and camera intrinsics here before hitting the ‘calibrate’ button. This may take up to 1-2 minutes for us to get accurate results, depending on the quality and number of image files.
Validate the results in Visualize mode and mark the calibration process as complete. These extrinsic, camera intrinsics and error parameters can be exported by using the ‘Export’ option.
Please note that :
- 1.The visualization renders calibration results both in 2D and 3D.
- 2.The reprojection error rate gives the mean distance error between points in 2D.
- 3.The translational error rate gives the mean distance error between points in 3D.
5. Extrinsic Calibration Output:
- roll, pitch, yaw, px, py, pz are the extrinsic parameters downloaded from the calibration tool.
- reflectorPointsInRadar is the 3d coordinates of the reflector in the radar coordinate system.
- reflectorPointsInCamera is the 3d coordinates of the reflector in the camera coordinate system.
- 1.Click on get started.
- 2.Click on the import config button in the top right corner of the modal.
- 3.Upload the JSON config file.
Getting started modal showing upload config option in the top right corner.
We process the config file and give users the option to select all or specific configs. Once the user clicks on done, the config is saved with us and the user doesn’t have to type anything else.
Parsed uploaded JSON config data
The only user input remaining now will be uploading images.
Important note: While uploading images, please keep in mind that the file name must be exactly the same as that mentioned in the JSON config file, else the user won’t see radar positions in the UI, and the user has to manually enter the radar positions.
If user want to skip some parent keys ["name", "type", "approach", "version", "sensors", "targets", "data"] they can skip it. Eg: if, user want to just enter radar position, then they can just add data section and skip all other keys. Keep in mind that you can only skip parent level keys and not nested keys.
JSON config with Description
// Name of the calibration datasets.
"name": "radar camera",
// Type of the calibration.
// Calibration approach type.
// Config version, defaults to 1.
// List of sensors.
// Type of sensor: [camera, radar]
// Name of sensor
// Camera lens type: pinhole/fisheye,
"name": "5mm radar"
// List of targets used in the calibration
// Any misc. data
// File specific data
// Uploaded file name
// Radar position