You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,8 +3,8 @@ This repo is the accumulation of many scripts needed in order to calibrate and v
3
3
The python scripts are :
4
4
-[ExtractRawData](#extractRawData)
5
5
-[Parser](#parser)
6
-
-[Send_parameters](#send_parameters)
7
-
-[Visualisation](#visualisation)
6
+
-[Send_angle_params](#send_angle_params)
7
+
-[Visualization](#visualization)
8
8
-[Validate](#validate)
9
9
10
10
## Installation
@@ -28,7 +28,7 @@ This script enables the user to extract the raw DW1000 data from the HiveBoard/B
28
28
- To align the receiver with the emmiter, use the laser pointer. Each laser should point to the alignment target of the other laser assembly. This position ensures a 0 degree relative orientation between the two radio setup.
29
29
- The laser mount should be calibrated periodicly to ensure its position and accuracy,
30
30
#### Runnning the script
31
-
The script can be run from the following file (**insert file path**)
31
+
The script can be run from `/src/extractRawData`
32
32
Requires the [TestBench-Arduino](https://swarmus.github.io/SwarmUS-doc/) code to be installed on the test-bench's Arduino in order to be interfaced.
33
33
34
34
#### Adjustable parameters
@@ -51,9 +51,9 @@ Once these parameters have been adjusted, the file can be run. The *TurningStati
51
51
#### Note
52
52
Communication with the HiveBoard is done using the pheromones submodule. If communication problem occur, ensure that the version used by the script is the same as on the HiveBoard.
53
53
## Parser
54
-
Parses and presents the PDOA values from the previously acquired raw data (from control). The user will be prompted 2 clickable interfaces to firstly offset the data to a common reference and secondly to extract the slopes of each antenna pair.
54
+
Parses and presents the PDOA values from the previously acquired raw data (from [ExtractRawData](#pxtractRawData)). The user will be prompted 2 clickable interfaces to firstly offset the data to a common reference and secondly to extract the slopes of each antenna pair.
55
55
#### Runnning the script
56
-
The script can be run from the following file (**insert file path**)
56
+
The script can be run from `src/parser`
57
57
#### Adjustable parameters
58
58
`dataFolderPath` : folder path where the extracted raw data CSV produced by [ExtractRawData](#pxtractRawData) has been save.<br />
59
59
`dataName` : name of the file to parse the data from.<br />
@@ -74,10 +74,10 @@ The second set of plots is the extraction of the slopes caracteristics. This set
74
74
The saved data will appear in the `dataFolderPath/angleParameters`. Each antenna pair has its own pickle file. These files will also be refered as the **calibration**.
75
75
A validation of these files can be done using the `testRead` function from the `Exporter` class.<br />
76
76
77
-
## Send_parameters
77
+
## Send_angle_params
78
78
Communicates to the Hiveboard the slope and caracteristics of the antenna pairs. Uses the pickle files created by [Parser](#parser). These files need to be placed in the calibration folder using the `hb_{HIVEBOARD_ID}` notation.<br />
79
79
#### Runnning the script
80
-
The script can be run from the following file (**insert file path**)
80
+
The script can be run from `/src/send_angle_params`
81
81
#### Adjustable parameters
82
82
`HIVEBOARD_ID` : the identification number of the Hiveboard. Can be found either in the flash memory or written on the RJ45 connector. <br />
83
83
`MOUNT_ORIENTATION_OFFSET` : the rotation offest, in degrees, applied to the Beeboard assembly between the Test-bench setup at which the calibration was made, and the orientation on the robot or final installation.<br />
@@ -90,7 +90,7 @@ When the script is ran, the parameters in the calibration folder will be sent to
90
90
91
91
#### Note
92
92
Communication with the HiveBoard is done using the pheromones submodule. If communication problem occur, ensure that the version used by the script is the same as on the HiveBoard.
93
-
## Visualisation
93
+
## Visualization
94
94
When a calibration has been completly transfered to the correspondant Hiveboard, this tool can be used to manually and visually confirm the effectiveness of the calibration. Using a emmiter, the user can move around the calibrated Hiveboard/BeeBoards assembly and see a marker representing the emmiter move around.
95
95
96
96
To use the tool, you will need one stationary HiveBoard with its BeeBoards and at least one mobile
@@ -101,10 +101,10 @@ computer for the serial connection.
101
101
102
102
Next, start the mobile HiveBoard/BeeBoards assembly.
103
103
104
-
To start the tool, start the `main.py` file under `src/visualisation_tool`. By default, the visualisation tool will
104
+
To start the tool, start `src/visualisation_tool`. By default, the visualization tool will
105
105
use the com port `/dev/ttyACM0`. To edit this value, edit the `COM_PORT` variable in `DataUpdater.py`.
106
106
107
-
The visualisation tool will open a window with an orange dot at the center, representing the stationary HiveBoard. The
107
+
The visualization tool will open a window with an orange dot at the center, representing the stationary HiveBoard. The
108
108
mobile HiveBoard assemblies will show as coloured circles and their position will be updated at regular intervals. Specific
109
109
neighbors can be hidden by unchecking the 'visible' check box in the table underneath the graph.
110
110
@@ -115,7 +115,7 @@ Communication with the HiveBoard is done using the pheromones submodule. If comm
115
115
## Validate
116
116
This is a method to test the whole angles system of the interlocalisation. Using the exact same hardware setup as the calibration it is possible to extract the angle value result from the whole acquisition, linearisation and certitude algorithm. Using the test-bench assembly will automate this procedure.
117
117
#### Runnning the script
118
-
The script can be run from the following file (**insert file path**)<br />
118
+
The script can be run from `src/validate_interloc`<br />
119
119
Requires the [TestBench-Arduino](https://swarmus.github.io/SwarmUS-doc/) code to be installed on the test-bench's Arduino in order to be interfaced.
120
120
#### Hardware setup
121
121
Refer to the [ExtractRawData](#extractRawData) hardware setup section for the protocol to ensure precise data acquisition.
@@ -141,7 +141,7 @@ Similarly to [ExtractRawData](#extractRawData), the *TurningStation* will turn b
141
141
The saved data is found in the `/src/data` folder. Each CSV is timestamped and named using the "validation_" prefix. For a visual analysis of the data, 3 plots have already been created. Running `src/analysis/analyze_interloc_validation` will produce:
142
142
- A representation of the acquired angles for each position.
143
143
- The error between the calculated angle and the actual orientation of the emmiter.
144
-
- The standard deviation of the angles calculated at each position.
144
+
- The standard deviation of the angles calculated at each position.<br />
0 commit comments