Extensive list of options for “running” the triangulation program
Please see here for the
complete documentation of the package. The “triangulation.zip” package contains all the files necessary to reproduce the results published in
V. Pierlot and M. Van Droogenbroeck
, A New Three Object Triangulation Algorithm for Mobile Robot Positioning, IEEE Transactions on Robotics, vol. 30, 2014
[1].
1 Options when you run the program
The program provides 8 test modes (from 0 to 7). You can choose the test mode with
option (default=5). Type
for the complete list of options. There are default values for each option, so that you can try easily each test mode. All angles are entered and displayed in degrees, in order to ease the interpretation.
1.1 Common options
Some options are common to all tests. There are the beacon coordinates and the triangulation method to use:
triangulation method to use (default=1, our algorithm).
beacon 1 X coordinate (default=0.0).
beacon 1 Y coordinate (default=1.0).
beacon 2 X coordinate (default=-0.866).
beacon 2 Y coordinate (default=-0.5).
beacon 3 X coordinate (default=+0.866).
beacon 3 Y coordinate (default=+0.5).
1.2 Test 0
Computes and displays the three angles from the input robot pose (position and orientation). The additional options are:
robot X coordinate (default=0.0).
robot Y coordinate (default=0.0).
robot orientation (deg) (default=0.0).
1.3 Test 1
Triangulates and displays the robot pose (position and orientation) from the three input angles. The additional options are:
angle of beacon 1 (deg) (default=+90.0).
angle of beacon 2 (deg) (default=-150.0).
angle of beacon 3 (deg) (default=-30.0).
1.4 Test 2
Computes the three angles from the input robot pose (position and orientation) and triangulates from the computed angles. The additional options are the same as for the test 0.
1.5 Test 3
Measures and displays the execution time of “n” runs of the triangulation method “m”. The additional options are:
number of time to execute the triangulation method.
1.6 Test 4
Runs the angle sensitivity analysis for a given robot pose. It analyzes how the computed robot pose is affected by noisy angles. The robot pose is entered like for the test 0. The additional options are:
number of time to execute the triangulation method (default=100), in order to compute the mean and variance.
the standard deviation of the Gaussian noise applied to angles (deg) (default=0.01).
select the result to display: 1=std. dev. of position error, 2=std. dev. of orientation error, 3=mean of error measure (default=1).
1.7 Test 5
Runs the angle sensitivity analysis in the square grid [ − S, E] × [ − S, E]. It analyzes how the computed robot pose is affected by noisy angles. This test creates a p × p PGM image, and the corresponding scale PGM image in the current directory. The additional options are the same as for the test 4, plus:
start X and Y coordinates of the grid (default=-2.0).
end X and Y coordinates of the grid (default=+2.0).
number of points in each direction (default=201).
select the mapping mode used to create the PGM images (default=2).
1.8 Test 6
Runs the beacon positions sensitivity analysis for a given robot pose. It analyzes how the computed robot pose is affected by noisy beacon coordinates. The options are the same as for the test 4, except that
represents the standard deviation of the Gaussian noise applied to beacon coordinates.
1.9 Test 7
Runs the beacon positions sensitivity analysis in the square grid [ − S, E] × [ − S, E]. It analyzes how the computed robot pose is affected by noisy beacon coordinates. This test creates a p × p PGM image, and the corresponding scale PGM image in the current directory. The additional options are the same as for the test 5.
2 Simulations
To reproduce the figures given in the paper, run the command with the arguments as mentioned under each corresponding figure:
3 Copyrights and license
All rights reserved by Vincent Pierlot and Marc Van Droogenbroeck.
You are allowed to use the programs and the source code for educational purposes and for your own usage only.
Distribution or any form of commercial usage is strictly prohibited. Please contact the authors if you want to use the program or source code outside the scope of the authorized usage.
References
[1] V. Pierlot, M. Van Droogenbroeck. A New Three Object Triangulation Algorithm for Mobile Robot Positioning. IEEE Transactions on Robotics, 30(3):566-577, 2014. URL http://dx.doi.org/10.1109/TRO.2013.2294061.