From 99a67dcd2dcb34c66be30e8f008f4c8576366c83 Mon Sep 17 00:00:00 2001
From: Théo de la Hogue
Date: Wed, 7 Jun 2023 20:57:17 +0200
Subject: Adding utils section and removing useless utils README.md file.

---
 docs/user_guide/utils/ready-made_scripts.md | 35 +++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 docs/user_guide/utils/ready-made_scripts.md

(limited to 'docs/user_guide/utils/ready-made_scripts.md')

diff --git a/docs/user_guide/utils/ready-made_scripts.md b/docs/user_guide/utils/ready-made_scripts.md
new file mode 100644
index 0000000..82039c5
--- /dev/null
+++ b/docs/user_guide/utils/ready-made_scripts.md
@@ -0,0 +1,35 @@
+Ready-made scripts
+==================
+
+Collection of command-line scripts to provide useful features.
+
+!!! note
+      *Consider that all inline commands below have to be executed at the root of ArGaze package folder.*
+
+!!! note
+      *Use -h option to get command arguments documentation.*
+
+## ArUco Markers factory
+
+Export all markers from *DICT_APRILTAG_16h5* dictionary as 5 cm pictures with 300 dpi resolution into an *./src/argaze/utils/_export/markers* folder:
+
+```shell
+python ./src/argaze/utils/aruco_markers_dictionary_export.py DICT_APRILTAG_16h5 -s 5 -r 300 -o ./src/argaze/utils/_export/markers
+```
+
+Export a 7 columns and 5 rows calibration board made of 5cm squares with 3cm markers from *DICT_APRILTAG_16h5* dictionary at 300 dpi into an *./src/argaze/utils/_export* folder:
+
+```shell
+python ./src/argaze/utils/aruco_calibration_board_export.py 7 5 5 3 DICT_APRILTAG_16h5 -r 300 -o ./src/argaze/utils/_export
+```
+
+## Camera calibration
+
+Calibrate a camera device (-d DEVICE) using a 7 columns and 5 rows calibration board made of 5cm squares with 3cm markers from *DICT_APRILTAG_16h5* dictionary. Then, export its optical parameters into an *calibration.json* file into *./src/argaze/utils/demo_environment/* folder:
+
+```shell
+python ./src/argaze/utils/camera_calibrate.py 7 5 5 3 DICT_APRILTAG_16h5 -d DEVICE -o ./src/argaze/utils/demo_environment
+```
+
+!!! note
+      Use **A3_DICT_APRILTAG_16h5_3cm_35cmx25cm.pdf** file located in *./src/argaze/ArUcoMarkers/utils/* folder ready to be printed on A3 paper sheet.
-- 
cgit v1.1