aboutsummaryrefslogtreecommitdiff
path: root/docs/user_guide/aruco_markers_pipeline
diff options
context:
space:
mode:
authorThéo de la Hogue2023-09-27 09:58:43 +0200
committerThéo de la Hogue2023-09-27 09:58:43 +0200
commit1a0dc73d98fdbe0d45523ca3ac914928b0ae775a (patch)
tree2179e2ef0dfa4a998611e731533b906ce376171f /docs/user_guide/aruco_markers_pipeline
parent3b523bb755d706ce945e3b9d93416909021f8e58 (diff)
downloadargaze-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.md39
-rw-r--r--docs/user_guide/aruco_markers_pipeline/introduction.md2
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)