diff options
author | Théo de la Hogue | 2023-09-27 09:58:43 +0200 |
---|---|---|
committer | Théo de la Hogue | 2023-09-27 09:58:43 +0200 |
commit | 1a0dc73d98fdbe0d45523ca3ac914928b0ae775a (patch) | |
tree | 2179e2ef0dfa4a998611e731533b906ce376171f /docs/user_guide/aruco_markers_pipeline | |
parent | 3b523bb755d706ce945e3b9d93416909021f8e58 (diff) | |
download | argaze-1a0dc73d98fdbe0d45523ca3ac914928b0ae775a.zip argaze-1a0dc73d98fdbe0d45523ca3ac914928b0ae775a.tar.gz argaze-1a0dc73d98fdbe0d45523ca3ac914928b0ae775a.tar.bz2 argaze-1a0dc73d98fdbe0d45523ca3ac914928b0ae775a.tar.xz |
Adding new chapter to explain how to configure ArUco marker detection.
Diffstat (limited to 'docs/user_guide/aruco_markers_pipeline')
-rw-r--r-- | docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md | 39 | ||||
-rw-r--r-- | docs/user_guide/aruco_markers_pipeline/introduction.md | 2 |
2 files changed, 40 insertions, 1 deletions
diff --git a/docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md b/docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md new file mode 100644 index 0000000..98b0841 --- /dev/null +++ b/docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md @@ -0,0 +1,39 @@ +Improve ArUco markers detection +=============================== + +As explain in [OpenCV ArUco documentation](https://docs.opencv.org/4.x/d1/dcd/structcv_1_1aruco_1_1DetectorParameters.html), ArUco markers detection is highly configurable. + +## Load ArUcoDetector parameters + +[ArUcoCamera.detector.parameters](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoDetector.Parameters) can be loaded thanks to a dedicated JSON entry. + +Here is an extract from the JSON [ArUcoCamera](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoCamera) configuration file with ArUco detector parameters: + +```json +{ + "name": "My FullHD camera", + "size": [1920, 1080], + "aruco_detector": { + "dictionary": "DICT_APRILTAG_16h5", + "marker_size": 5, + "parameters": { + "cornerRefinementMethod": 3, + "aprilTagQuadSigma": 2, + "aprilTagDeglitch": 1 + } + }, + ... +``` + +## Print ArUcoDetector parameters + +```python +# Assuming ArUcoCamera is loaded +... + +# Print all ArUcoDetector parameters +print(aruco_camera.aruco_detector.parameters) + +# Print only modified ArUcoDetector parameters +print(f'{aruco_camera.aruco_detector.parameters:modified}') +``` diff --git a/docs/user_guide/aruco_markers_pipeline/introduction.md b/docs/user_guide/aruco_markers_pipeline/introduction.md index f5bba18..5a07b49 100644 --- a/docs/user_guide/aruco_markers_pipeline/introduction.md +++ b/docs/user_guide/aruco_markers_pipeline/introduction.md @@ -26,4 +26,4 @@ More advanced features are also explained like: * [How to script ArUco markers pipeline](advanced_topics/scripting.md) * [How to calibrate optic parameters](advanced_topics/optic_parameters_calibration.md) -<!-- * [How to improve ArUco markers detection](advanced_topics/aruco_detector_configuration.md) --> +* [How to improve ArUco markers detection](advanced_topics/aruco_detector_configuration.md) |