Skip to content

Commit 68f5642

Browse files
committed
added files path
1 parent 2915a38 commit 68f5642

1 file changed

Lines changed: 12 additions & 12 deletions

File tree

README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ This repo is the accumulation of many scripts needed in order to calibrate and v
33
The python scripts are :
44
- [ExtractRawData](#extractRawData)
55
- [Parser](#parser)
6-
- [Send_parameters](#send_parameters)
7-
- [Visualisation](#visualisation)
6+
- [Send_angle_params](#send_angle_params)
7+
- [Visualization](#visualization)
88
- [Validate](#validate)
99

1010
## Installation
@@ -28,7 +28,7 @@ This script enables the user to extract the raw DW1000 data from the HiveBoard/B
2828
- 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.
2929
- The laser mount should be calibrated periodicly to ensure its position and accuracy,
3030
#### 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`
3232
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.
3333

3434
#### Adjustable parameters
@@ -51,9 +51,9 @@ Once these parameters have been adjusted, the file can be run. The *TurningStati
5151
#### Note
5252
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.
5353
## 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.
5555
#### 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`
5757
#### Adjustable parameters
5858
`dataFolderPath` : folder path where the extracted raw data CSV produced by [ExtractRawData](#pxtractRawData) has been save.<br />
5959
`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
7474
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**.
7575
A validation of these files can be done using the `testRead` function from the `Exporter` class.<br />
7676

77-
## Send_parameters
77+
## Send_angle_params
7878
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 />
7979
#### 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`
8181
#### Adjustable parameters
8282
`HIVEBOARD_ID` : the identification number of the Hiveboard. Can be found either in the flash memory or written on the RJ45 connector. <br />
8383
`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
9090

9191
#### Note
9292
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
9494
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.
9595

9696
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.
101101

102102
Next, start the mobile HiveBoard/BeeBoards assembly.
103103

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
105105
use the com port `/dev/ttyACM0`. To edit this value, edit the `COM_PORT` variable in `DataUpdater.py`.
106106

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
108108
mobile HiveBoard assemblies will show as coloured circles and their position will be updated at regular intervals. Specific
109109
neighbors can be hidden by unchecking the 'visible' check box in the table underneath the graph.
110110

@@ -115,7 +115,7 @@ Communication with the HiveBoard is done using the pheromones submodule. If comm
115115
## Validate
116116
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.
117117
#### 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 />
119119
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.
120120
#### Hardware setup
121121
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
141141
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:
142142
- A representation of the acquired angles for each position.
143143
- 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 />
145145
To select which file to analyze, edit :
146146
```python
147147
analyze_validation("../data/validation_hb6.csv")

0 commit comments

Comments
 (0)