diff --git a/calibrators/docs/tutorials/mapping_based_calibrator.md b/calibrators/docs/tutorials/mapping_based_calibrator.md index 360f3896..55656b59 100644 --- a/calibrators/docs/tutorials/mapping_based_calibrator.md +++ b/calibrators/docs/tutorials/mapping_based_calibrator.md @@ -149,11 +149,11 @@ The image below displays the vehicle within the pointcloud, allowing for a compa - Why does the calibration fail? - - Most of the cases are because the mapping fails. Possible error messages are listed below, which should be displayed in the console. For these cases, restart the experiment and drive more stably and slowly. + - In most cases, the failure is due to mapping issues. The possible error messages are listed below and should be displayed in the console. For these cases, restart the experiment and drive more stably and slowly. - Mapping failed. Angle between keyframes is too high. - Mapping failed. Interpolation error is too high. - Mapping failed. Acceleration is too high. - - Check the rviz to see if any number on the path (keyframe number) is red (normally it is white). If it is red, there is a chance that the motion of the vehicle is not smooth. We recommend the user calibrate with more stable movement again. + - Check the rviz to see if any keyframe number on the path is red (normally it is white). If it is red, there is a chance that the motion of the vehicle is not smooth. We recommend the user calibrate with more stable movement again. - If it is not feasible to restart the experiment, the user could tune the parameters in the `Calibration criteria parameters` described in the [documentation](../../mapping_based_calibrator/README.md). However, keep in mind that if the user sets the threshold too high, the accuracy of the calibration result will also decrease. - Check whether all of the lidars apply time synchronization. - Make sure that the environment is rich in natural landmarks suitable for registration-based mapping in all directions. This will help the lidar capture sufficient details beyond simple features like lane surfaces or walls. diff --git a/calibrators/mapping_based_calibrator/README.md b/calibrators/mapping_based_calibrator/README.md index ccec1aa6..9bcea588 100644 --- a/calibrators/mapping_based_calibrator/README.md +++ b/calibrators/mapping_based_calibrator/README.md @@ -79,19 +79,19 @@ The transformation between the lidar and the ground pose is calculated by utiliz ### Output -| Name | Type | Description | -| --------------------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| `output_map` | `sensor_msgs::msg::PointCloud2` | Output map constructed from the `mapping_pointcloud`, providing visualization in rviz. | -| `frame_path` | `nav_msgs::msg::Path` | The actual path of the `mapping_pointcloud`, providing visualization in rviz. | -| `frame_predicted_path` | `nav_msgs::msg::Path` | The predicted path of the`mapping_pointcloud`, providing visualization in rviz. | -| `keyframe_path` | `nav_msgs::msg::Path` | The keyframe path of the `mapping_pointcloud`, providing visualization in rviz. | -| `keyframe_markers` | `visualization_msgs::msg::MarkerArray` | Markers for keyframes, providing visualization in rviz. | -| `initial_source_aligned_map` | `sensor_msgs::msg::PointCloud2` | Initial map from calibration lidars, providing visualization in rviz. | -| `calibrated_source_aligned_map` | `sensor_msgs::msg::PointCloud2` | Calibrated map from calibration lidars, providing visualization in rviz. | -| `target_map` | `sensor_msgs::msg::PointCloud2` | Target map from `mapping lidar`, used for comparing with the `calibrated_source_aligned_map` and `target_map`, providing visualization in rviz. | -| `target_markers` | `visualization_msgs::msg::MarkerArray` | Markers for camera calibrator (currently not used) | -| `base_lidar_augmented_pointcloud` | `sensor_msgs::msg::PointCloud2` | Ground pointcloud from augmented pointcloud. | -| `ground_pointcloud` | `sensor_msgs::msg::PointCloud2` | Ground pointcloud from calibrated pointcloud. | +| Name | Type | Description | +| --------------------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------- | +| `output_map` | `sensor_msgs::msg::PointCloud2` | Output map constructed from the `mapping_pointcloud`. | +| `frame_path` | `nav_msgs::msg::Path` | The actual path of the `mapping_pointcloud`. | +| `frame_predicted_path` | `nav_msgs::msg::Path` | The predicted path of the`mapping_pointcloud`. | +| `keyframe_path` | `nav_msgs::msg::Path` | The keyframe path of the `mapping_pointcloud`. | +| `keyframe_markers` | `visualization_msgs::msg::MarkerArray` | Markers for keyframes. | +| `initial_source_aligned_map` | `sensor_msgs::msg::PointCloud2` | Initial map from calibration lidars. | +| `calibrated_source_aligned_map` | `sensor_msgs::msg::PointCloud2` | Calibrated map from calibration lidars. | +| `target_map` | `sensor_msgs::msg::PointCloud2` | Target map from `mapping lidar`, used for comparing with the `calibrated_source_aligned_map` and `target_map`. | +| `target_markers` | `visualization_msgs::msg::MarkerArray` | Markers for camera calibrator (currently not used) | +| `base_lidar_augmented_pointcloud` | `sensor_msgs::msg::PointCloud2` | Ground pointcloud from augmented pointcloud. | +| `ground_pointcloud` | `sensor_msgs::msg::PointCloud2` | Ground pointcloud from calibrated pointcloud. | ### Services diff --git a/calibrators/marker_radar_lidar_calibrator/README.md b/calibrators/marker_radar_lidar_calibrator/README.md index 72b1af6c..32ae1284 100644 --- a/calibrators/marker_radar_lidar_calibrator/README.md +++ b/calibrators/marker_radar_lidar_calibrator/README.md @@ -67,7 +67,7 @@ Below, you can see how the algorithm is implemented in the `marker_radar_lidar_c | Name | Type | Description | | ------------------------ | ------------------------------- | ------------------------------------------------------- | | `input_lidar_pointcloud` | `sensor_msgs::msg::PointCloud2` | The topic of the lidar pointcloud used for calibration. | -| `input_radar_msg` | `radar_msgs::msg::RadarTracks` | The topic of the radar objects used for calibration. | +| `input_radar_msg` | `radar_msgs::msg::RadarTracks` | The topic of radar objects used for calibration. | ### Output