http://cstwiki.wtb.tue.nl/index.php?title=Special:Contributions&feed=atom&target=S128756Control Systems Technology Group - User contributions [en]2022-01-24T03:21:58ZFrom Control Systems Technology GroupMediaWiki 1.15.3http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:56:53Z<p>S128756: /* Design decisions */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|250px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if - CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). <br />
In other words, '''our focus is on finishing the maze challenge rather than implementing the most complex algorithm'''. Right after the corridor challenge the world model could not yet detect walls, only nodes. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focused on recognizing doors, while the path finding teams focused on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it can be concluded that most decisions were well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
Making the two parts not dependent on each other has the benefit that the two parts could be developed completely independent of each other. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole more robust, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely. Note that with the current world model, this extension can easily be made. However, if the world model does not function very well and for example mis places a corner node, you have a big problem. We experienced this during the corridor challenge, where a small bug in the world model code resulted in driving past the corridor. Fortunately, Pico still found the corridor due to the fact that the repulsion pushed him toward the gap in the wall.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm however makes it very suitable for this project due to the time available. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help each other when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. Unfortunately we didn’t win the corridor challenge, but the world model was already way more advanced then needed by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on each other and that agreements are reached on which part delivers what.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:53:19Z<p>S128756: /* Conclusion and recommendation */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|250px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if - CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it can be concluded that most decisions were well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
Making the two parts not dependent on each other has the benefit that the two parts could be developed completely independent of each other. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole more robust, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely. Note that with the current world model, this extension can easily be made. However, if the world model does not function very well and for example mis places a corner node, you have a big problem. We experienced this during the corridor challenge, where a small bug in the world model code resulted in driving past the corridor. Fortunately, Pico still found the corridor due to the fact that the repulsion pushed him toward the gap in the wall.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm however makes it very suitable for this project due to the time available. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help each other when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. Unfortunately we didn’t win the corridor challenge, but the world model was already way more advanced then needed by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on each other and that agreements are reached on which part delivers what.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:36:06Z<p>S128756: /* World model */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|250px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if - CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:35:50Z<p>S128756: /* World model */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|250px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:35:37Z<p>S128756: /* World model */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -1*CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:35:05Z<p>S128756: /* World model */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:34:49Z<p>S128756: /* World model */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if - CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=File:Formule1b.pngFile:Formule1b.png2017-06-21T12:21:12Z<p>S128756: uploaded a new version of "File:Formule1b.png"</p>
<hr />
<div></div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:19:13Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered for the repulsion in a certain direction and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, only laser data in front of Pico is used from index N2+1 to N3. All the other laser data is used for the calculation of Fy, the force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:17:02Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N1, N2, N3 and N4 mark the indexes of the laser data vector that determine which data considered is considered and <math>\phi_i</math> is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:13:36Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:13:26Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|600px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:13:15Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|500px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:13:09Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|100px]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:12:31Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|upright=1.5]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:12:23Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center|upright=1.1]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-21T12:10:29Z<p>S128756: /* Space recognition */</p>
<hr />
<div>== Initial design report & Final design presentation ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
= '''Initial design''' =<br />
== Introduction ==<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
== Requirements and specifications ==<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Carry out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
<br />
== Components ==<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
== Functions ==<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
== Interfaces ==<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
= '''Corridor Challenge''' =<br />
== Repulsion & Angle correction ==<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
[[File:formule1b.png|center]]<br />
<!-- <math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math> --><br />
<!-- <math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math>--><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, Fx, <br />
only laser data in front of Pico is used from N2+1 to N3. All the other laser data is used for the calculation of Fy, force in sideward direction. This is also shown in figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller than 0.01 meter are set to 10 meter. <br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
== Actuation ==<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
[[File:formule2.png|center]]<br />
<br />
<!-- ::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<!-- ::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br> --><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
[[File:formule3.png|center]]<br />
<!-- ::<math>\omega = sign(\omega) \cdot \omega_{max}</math> --><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
== World model ==<br />
<br />
[[File:corner_node_recognition.png|thumb|left|200px|Visualisation of the 90-degree test used to recognize corner nodes. The node is a corner node if -CORNERNODENORM < (a2 + b2 - c2) < CORNERNODENORM.]]<br />
[[File:define_axis.png|thumb|right|400px|The way the coordinate system is defined in the Location data type. The axis are relative to PICO.]]<br />
<br />
Two types of nodes are detected by the ''scanNodes'' function and returned as a vector. The two types are: <br />
<br />
* End nodes: These nodes are recognized using the SPIKE algorithm. When the difference between a previous data point and the next data point of the LRF data is above a certain threshold the node is stored.<br />
* Corner nodes: The current data-point is a corner node if it passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set number of data points from the current data point, and a next data-point that also lies at a set number of points from the current data-point. Using the cosine rule, angles and distances to the three points, the distance between the previous and next data point can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees.<br />
<br />
The nodes are then used to in order to recognize the corridor and take the turn. The Node class (data type) is defined as follows:<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically.<br />
<br />
== Making the turn ==<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as half the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After travelling b/2 meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning again before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Taking a corner]]<br />
<br />
== Result ==<br />
<br />
In the end the corridor challenge was completed successfully. PICO seemed to miss the exit at first, but after some time the corner was recognized and PICO could take the turn. Because of the repulsion away from the wall pico moved towards the center of the corridor without bumping into the wall. In the end the corner node was not recognized because of a mistake in tuning. Nodes are recognized, but cannot overlap. A parameter governing the overlap radius was set to 0.5 meters. However by mistake a node was also set on PICOs' own position. This meant that when PICO approached the corner the node disappeared. When PICO moved sufficiently far past the corner the node was recognized again and the turn was made. Tuning the parameter to a 0.1 meter radius and testing again resulted in a direct and fast turn which could be executed in a robust manner.<br />
<br />
The most important conclusion for us during the challenge was that we needed time to tune our parameters and remove small bugs from our code. This realization resulted in a discussion which drove our further design into a simpler direction in order to have enough time to robustly test the system. <br />
<br />
[[File:Corridor_group4_2.gif|thumb|center|800px|Attempt 1 of the corridor challenge]]<br />
<br />
= '''Final design''' =<br />
== Design decisions ==<br />
To make a functioning robot, decisions have to be made with regard to maze solving algorithms. This chapter will focus on why and how the decisions are made. Three options were considered; the Pledge algorithm, Trémaux’s algorithm and the random mouse algorithm. <br />
<br />
The Pledge algorithm lets the robot follow the wall either at its right-hand side or left-hand side (decided on forehand). Whilst following the wall, it counts the amount of corners taken. The counter is updated by adding 1 for a right turn and subtracting 1 for a left turn. If the robot is in its preferred direction (the counter is 0), the robot will not follow the wall. Instead, it continues driving straight forward until it sees a wall in front of it. It will then follow the newly encountered wall. The benefit of the Pledge algorithm is that the robot should always finish the maze in a finite time without keeping track of a world map. A downside is that this is not necessarily the fastest way to solve the maze. The robot may for instance drive past the finish just because it does not look at what is at its left side. Another downside is that it is quite sensitive for errors. The whole Pledge depends on the counter, if the counter gets mixed up, it may be possible that the robot will have to travel a lot of extra distance.<br />
<br />
Trémaux’s algorithm, in contradiction to the Pledge algorithm, does require to keep track of a world map, which makes it a lot more complicated immediately. By marking the points that have already been visited, decisions can be made such that it is guaranteed to find the exit of the maze. This does not necessarily have to be faster than the Pledge algorithm. However, during the maze challenge, each group has two attempts. During the first attempt, Trémaux’s algorithm can be used to explore the maze and to find a way to the exit. In the second attempt, Pico can directly drive to the exit, because it already knows what path to follow, assuming that the first attempt was successful.<br />
<br />
The final option we considered is the random mouse algorithm. This algorithm makes a random decision at each junction. Therefore the robot will eventually always find the exit of the maze, but this can take a lot of time.<br />
<br />
Eventually, the decision has been made to use the Pledge algorithm. The main reason to do this is the fact that the complexity is limited, while it is still an efficient way to solve the maze. During the corridor challenge we experienced that it is very important to tune the configuration parameters on the actual robot instead of the simulator. Therefore the decision has been made to create a robust realization of a relatively simple algorithm (Pledge) instead of a complex algorithm (Trémaux). In other words, our focus is on finishing the maze challenge rather than implementing the most complex algorithm. Right after the corridor challenge the world model could not yet detect walls. Together with a possible redefinition of nodes we thought it would be wise to choose Pledge in order to avoid making a map, which would be finished at the last second or not at all. Therefore the world model team focussed on recognizing doors, while the path finding teams focussed on implementing Pledge.<br />
<br />
After choosing the Pledge algorithm, a decision had to be made on how to take turns. We considered two options:<br />
<br />
1. Rotate while standing still<br />
<br />
2. Keep driving while rotating<br />
<br />
Both methods have their advantages and disadvantages. The advantage of the first one is its simplicity. We can just create a state for taking corners in which Pico drives forward, rotates 90 degrees using odometry data and drives forward again. Each time when we call the state, we can update the Pledge counter. When using the second approach, it is less straightforward to detect when the corner has been taken. Regarding the robustness of the Pledge counter, this might form a problem. However, for Pico to find the exit as fast as possible, it is not favorable to stand still while cornering. In that sense, option 2 would be better. We decided to try both methods and choose the one that works best in practice. In the end, option 1 resulted in the most robust Pledge counter, which is needed for solving the maze. Therefore we continued with that strategy.<br />
<br />
Another important design decision is about the use of a world map. Although this is not necessary when using the pledge algorithm, it can still be beneficial. Basically, all we need to do is follow the wall on Pico’s right if the pledge counter is unequal to zero. This can be done using a space recognition algorithm, which will be discussed later. On the other hand, using a world model, we can implement feature detection to recognize junctions and base our decisions on that. However, during the corridor challenge we experienced that a small error in detecting corners can already have a large impact on the behavior of Pico. You completely base the decisions on corner nodes that appear on certain locations, which is risky if the robustness of these nodes is not fully reliable yet. The design decision has been made to only use a world map for door detection. Driving using the pledge algorithm will be done with the space recognition algorithm. In this manner, we aim at a robust way to solve the maze.<br />
<br />
== Interface ==<br />
[[File:Softwaredesignv3.png|thumb|right|900px|Software architecture]]<br />
After the corridor challenge, the software architecture was changed a bit. The software still consists of five main parts: actuation, skill, sensing, worldmodel and taskmanager. These different software parts with their corresponding in- and outputs are depicted in the figure to the right. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force struct from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
<br />
'''Sensing'''<br />
<br />
In the sensing part, the odometry and LRF data are obtained. The LRF data is directly used in several functions. For the odometry data, the difference between the previous and the current odometry data is calculated, this way the angle is unwrapped and the relative rotation can be calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF data. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When PICO is in a door area the Boolean 'door detected' will be true. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will update the direction and desired state based on the Pledge algorithm.<br />
<br />
'''Visualization'''<br />
<br />
The visualization is not a functional part of PICO, but it is used to visualize what happens in real time. The input is a vector with nodes, which are transformed to dots, lines and numbers in the visualization. It is mainly used to check if the "node detection" and "door recognition" are working correctly.<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|right|500px|Figure 3:Space recognition]] <br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to radians and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function needs the scan information from the LRF as an input and will output the variables space_left, space_top and space_right.<br />
<br />
'''Code'''<br />
<br />
This relatively simple functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
== Maze solving algorithm == <br />
<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A left turn counts as -1 and a right turn as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & space_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using only 5 degrees of LRF-data.<br />
[[File:spring.png|thumb|right|upright=0.7]]<br />
<br />
'''Code'''<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
== Repulsion & wall following ==<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== Taking turns ==<br />
<br />
'''Turning right'''<br />
<br />
Taking a turn isn't so easy as it sounds. When following a wall PICO stays nicely aligned and close to it. When PICO detects space it wants to turn right to follow the wall (assuming the Pledge counter is not 0). However, if PICO turns too soon he would be very close to the corner. This would result in repulsion helping PICO to stay away from the corner, but not in a nicely made turn. Therefore PICO drives a small distance forward before rotating 90 degrees. After that the robot indeed makes the turn of 90 degrees. It does a 90 degree turn by measuring odometry data. After PICO is rotated, we do not want to measure immediately after that, for that would result in an open space to the right of PICO and it will again rotate to the right. Therefore PICO first looks for an obstacle to his right, seeing an obstacle here means that he indeed is far enough that he indeed made the turn. Now PICO can remain following the wall. The desired state is set to 'straight' again.<br />
<br />
[[File:turn_right.gif|thumb|center|792px|Taking a right turn]] <br />
<br />
'''Deadlock prevention'''<br />
<br />
It could happen that PICO thinks there is space to his right, while it is actually not. PICO could either be too far away from the wall, or it could be very close to a wall which has a small gap. In both scenarios a faulty space_right would be detected, making PICO turn right. What will happen is that PICO will turn right and search for an object to his right. After the turn, PICO is facing the wall in front of him and he wants to go forward. However, repulsion will keep PICO from bumping into the wall. To avoid a deadlock situation, a counter keeps track of the time. After 10 seconds of trying to find an obstacle to the right of PICO, it will take a left turn again in order to follow the wall again. This indeed prevents deadlock, it was even shown in the maze competition in the fast configuration.<br />
<br />
[[File:false_right.gif|thumb|center|500px|False space_right detected]] <br />
<br />
'''Turning left & 180 degrees'''<br />
<br />
Unlike turning right, turning left is fairly easy. When PICO detects an obstacle to the right and in front of him, the only option is to go left. After turning left 90 degrees, PICO can immediately start following the wall again. When turning 180 degrees it is exactly the same case, except that PICO will turn 180 degrees immediately.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corner" nodes. The world model library provides a function which can be used to detect nodes in the landscape.<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
/*!<br />
\brief scanNodes Scan for nodes and return a vector of the detected nodes.<br />
\param scan A scan of the environment containing angle and distance data of the LRF.<br />
\return Vector containing nodes detected during the scan.<br />
*/<br />
std::vector<Node> scanNodes(emc::LaserData scan);<br />
</pre><br />
<br />
The resulting node vector in this case is then used to recognize door areas using the ''doorCheck'' function, which returns true when a door area is detected and PICO is located there.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. The axis are defined the same way as during the corridor challenge.<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. The recognition was modified slightly to set the previous and next data point based on distance, and not on a number of data-points as was done during the corridor challenge. The result is a more intuitive parameter to tune the corner node recognition.<br />
<br />
<!-- <math> x_r </math> --><br />
[[File:formule4.png|center]]<br />
<!-- <br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br> --><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition, which mostly deal with margins associated to the ways nodes are recognized. For example, a tunable parameter exists for the minimum distance two nodes need to be apart in order for the data point to be considered an endnode. A complete list with description is also available in ''worldmodel.h''.<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
The doors are recognized based on the end- and cornernodes. It is known in advance that the node numbers are ordered depending on the angle of the LRF. The first node lies at the lowest recognizable angle, the last node at the highest recognizable angle. Based on this we can do several checks to see if a door should be recognized. The door check is done with a for-loop over the first to the fourth last nodes. This is because four nodes are required to check if it is a door. Let’s consider a certain node that needs to be checked, then the three following nodes are also considered to determine whether these four nodes make a door. <br />
<br />
The first check, is a simple check that checks the absolute distances between the four nodes. Let’s consider four nodes that lie after eachother. The distance between the first two nodes has to be at least 0.3 meter according to the given requirements. Then the distance between the second and third node has to be at least 0.5 meter, but can at a maximum be 1.5 meter. The distance between the third and fourth node should once again be at least 0.3 meter. On each of these distances, margins are added to increase robustness. If a node passes this test, then it proceeds to the second check. If it does not pass this test, then it can’t be a door by definition and thus it not necessary to do the other tests.<br />
<br />
The second check determines if the first and fourth node are on the same side of the line through node 2 and node 3. This is to check if it is actually a corridor and not a S-curve. An example of this is shown in the figure below. The left ‘door’ would pass this test whilst the right one would not. To check if the nodes 1 and 4 lie on the same side, the following equation is used:<br />
<br />
<!-- <br><br />
<math> D = (x-x1)(y2-y1)-(y-y1)(x2-x1) </math><br />
<br> --><br />
[[File:Doorcheck2.png|thumb|right|700px|Difference between door and S-curve]]<br />
[[File:formule5.png|center]]<br />
<br />
In this equation are x and y are the relative coordinates with respect to the robot of the points that do not lie on the direct edge of the door (in the figure above these are nodes 1 and 4). x1, y1, x2 and y2 are the coordinates of the nodes that lie on the sides of the doors (thus node 2 and 3 in the figure above). This means that variable <br />
D needs to be computed twice, once for node 1 and once for node 4. If the sign of these two variables becomes the same, then these points lie on the same side of the door and the following check can be done.<br />
<br />
The third check makes sure that the nodes are of the correct type. As stated before, we have two node types; endnodes and cornernodes. Nodes two and three should by definition be cornersnodes. If the two nodes are both cornersnodes then these two nodes are connected and thus it could be a door. The other two nodes can either be endnodes or cornernodes.<br />
<br />
The fourth check calculates the angles of the two cornernodes. This needs to be done to make sure that the third and fourth, and first and second node are connected. This check is simply done using the same algorithm that was used for corner detection. <br />
<br />
The fifth and last check, creates a door area based on the location of the door. The robot needs to be within this door area before it may ring the bell. Officially this should be a separate check since it does not belong to checking whether it is a door or not. However, it would not be useful to check whether a door is recognized, but not to check if the robot is within the door area. For this reason and the reason of simplicity, this check is done within the door recognition.<br />
<br />
=== Code ===<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Maze challenge''' =<br />
An epic video of our maze challenge can be found on [https://www.youtube.com/watch?v=6da4ZbJlphw Youtube]. In this attempt, everything was executed flawlessly by PICO. Our code was robust enough to solve the maze, and it was even the fastest time (2:34) of all groups that completed the maze.<br />
<br />
The maze has also been solved in simulation, the safe version completed the maze in 2:17 and the fast version in 1:36.<br />
<br />
The safe version was our main focus and the fast version was therefore not tested extensively. This resulted in an error in the Pledge counter during the maze challenge. PICO was still able to complete the maze, but because of the error it would be slower than the safe version.<br />
<br />
The a-maze-ing attempt made us the proud winners of the maze challenge!<br />
<br />
[[File:thumb_youtube.jpg|right|400px|link=https://www.youtube.com/watch?v=6da4ZbJlphw]]<br />
<br />
[[File:thumb_youtube_sim.jpg|right|400px|link=https://www.youtube.com/watch?v=bDl0qktHtv4]]<br />
<br />
[[File:champions.jpg|thumb|center|600px|The Champions]]<br />
<br />
PICO, you will be missed.<br />
<br />
= '''Code we're proud of''' =<br />
These codes are already mentioned at the relevant chapters, but here's a recap of the codes we are proud of.<br />
<br />
The detect spaces functionality is neatly implemented as can be seen in [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-spacerecognition-cpp this code snippet]. The code is simple, understandable, has a clear purpose and can be tuned fully from the config file.<br />
<br />
The Pledge algorithm is implemented [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-pledge-cpp as a function] that needs the current counter and all the spaces. It will output the updated counter and the desired state to be in. Since the interpretation of the spaces is straightforward, the Pledge algorithm can be implemented in a straightforward manner. By thinking out the algorithm first, the right hand follower was implemented with no problems at all. The function also gives feedback to the programmer in which state PICO currently is. This Pledge function is another piece of code that represents our neat and straightforward manner of coding, with which we made a very robust maze solver.<br />
<br />
The code of the Worldmodel can be found [https://gist.github.com/melvindewildt/004dc7235188192771760da17a5a1766#file-worldmodel-cpp here]. This masterpiece consists of multiple functions which can be called very easily. It takes care of a complex task, namely recognizing nodes and door areas. It is nicely structured and executes complex tasks.<br />
<br />
= '''Conclusion and recommendation''' =<br />
<br />
As mentioned before, the maze challenge was won by our group. This is proves that the decisions made, were good decisions. <br />
<br />
Looking back on the project, it could be concluded that most decisions were very well chosen. Deciding that the wall-following algorithm and Pledge should not depend on the world model was a good way to split up the work without making groups dependent on each other. Because of this, small groups of two people could work together and were responsible for a certain part of the code.<br />
<br />
The Pledge algorithm itself worked as desired, but it is of course not the fastest way to solve a maze. The simplicity of this algorithm is however very suitable for the time available for this project. If more time was available after the maze challenge (there would be a third challenge or something), then more difficult algorithms could be considered. <br />
<br />
One thing was both fortunate and unfortunate. This was that the algorithms did not depend on the world model. Making the two parts not depending on each other has the benefit that the two parts could be developed completely independent of eachother. The downside is that the world model has a less important role in solving the maze. Making the algorithm dependent on the world model could make the whole, since the world model only uses select data to reconstruct the maze. For instance, a small gap between two walls could now have given quite a problem. If the wall-follower would depend on the world model, then two nodes were simple connected which would then be seen as a wall. If there would be a small gap, the robot would ignore this completely.<br />
<br />
There are really not many things that we would change if we could start over. We strongly recommend to make appointments on when to work on the project. For instance, our group worked on Monday two hours together, as well as four hours on Friday. Programming together gives the option to discuss things quickly when a problem arises, to help eachother when there is a problem and most importantly; to communicate about how parts of the code work and what they should output. <br />
<br />
The Pledge algorithm was the best choice for the given time, a more complex algorithm would probably have decreased the robustness and more errors could have occurred during the maze challenge. In the beginning of the project it seems like there is quite some time available, but the last week is almost completely spent on bringing the various parts together and on tuning PICO to its best performing configuration. <br />
<br />
Another decision that was well made, was not to focus on the corridor challenge too much, but mainly on the maze challenge. The corridor challenge was simply a check in the middle of the project to see how well our code worked so far. We didn’t win the corridor challenge, but this was also because we didn’t focus too much on this. For instance, the world model was already way more advanced by the time the corridor challenge was done. This was because the world model was created for the maze challenge and not directly for the corridor challenge. Also the wall-follower algorithm was made especially for the maze. During the corridor challenge it was ‘tested’ and we found some small bugs which we could fix. The corridor challenge was also a good test to think about how to take a corner, which is harder than it seems at the start of the project. <br />
<br />
Doing this project was a great introduction into the world of creating software. Besides learning how to program in C++, work in Qt creator and working with Linux, it was especially interesting to see that the initial software design/architecture is very important during the rest of the project. If this architecture is not well thought about, this will lead to problems halfway the project. It should be clear which part does what. Also it should be clear which parts depend on eachother and that appointments are made on which part delivers what. More was learned about how a robot could be programmed for a maze challenge. Besides Pledge there are of course way more algorithms.</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=File:Taking_the_corner.pngFile:Taking the corner.png2017-06-16T10:29:35Z<p>S128756: uploaded a new version of "File:Taking the corner.png"</p>
<hr />
<div></div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-16T10:22:51Z<p>S128756: /* Making the turn */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After traveling <math>\frac{b}{2}</math> meters, Pico stops and rotates 90 degrees. Then a distance of <math>c+e </math> is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning gain before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|1300px|Taking a corner]]<br />
<br />
<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. Now the software consists of five main parts: Actuation, skill, sensing, worldmodel and Taskmanager. These different software parts with their corresponding in- and outputs are depicted in Figure 2. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force vector from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
Sensing<br />
In the sensing part, the odometry and LRF data is obtained. This LRF data goes straight to different parts. By calculating the difference between the previous and the current data, the wrapping of the data is corrected and the relative rotation is calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When a Pico is in a door area the Boolean door detected will be ‘true’. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will calculate the direction and desired state using the Pledge algorithm.<br />
<br />
<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to degrees and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function will need the scan information from the LRF as an input and will output variables space_left, space_top and space_right.<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corned" nodes. The world model library provides two public functions which can be used in order to check whether doors are present:<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
header function with comments of scanNode and doorCheck<br />
</pre><br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''<br />
<br />
= Maze challenge =<br />
[[File:champions.jpg|thumb|center|800px|Figure 88:Champions]]</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-16T10:22:30Z<p>S128756: /* Making the turn */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in the figure below, is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with the number 2 in the figure below) is taken as the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After traveling <math>\frac{b}{2}</math> meters, Pico stops and rotates 90 degrees. Then a distance of <math>c+e </math> is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning gain before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|1300px|Figure 2: Software architecture]]<br />
<br />
<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. Now the software consists of five main parts: Actuation, skill, sensing, worldmodel and Taskmanager. These different software parts with their corresponding in- and outputs are depicted in Figure 2. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force vector from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
Sensing<br />
In the sensing part, the odometry and LRF data is obtained. This LRF data goes straight to different parts. By calculating the difference between the previous and the current data, the wrapping of the data is corrected and the relative rotation is calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When a Pico is in a door area the Boolean door detected will be ‘true’. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will calculate the direction and desired state using the Pledge algorithm.<br />
<br />
<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to degrees and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function will need the scan information from the LRF as an input and will output variables space_left, space_top and space_right.<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corned" nodes. The world model library provides two public functions which can be used in order to check whether doors are present:<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
header function with comments of scanNode and doorCheck<br />
</pre><br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''<br />
<br />
= Maze challenge =<br />
[[File:champions.jpg|thumb|center|800px|Figure 88:Champions]]</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-16T10:21:33Z<p>S128756: /* Making the turn */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in figure NUMBER is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with number 2 in the figure below) is taken as the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After traveling <math>\frac{b}{2}</math> meters, Pico stops and rotates 90 degrees.<br />
Then a distance of <math>c+e </math> is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. <br />
This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning gain before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|1000px|Figure 2: Software architecture]]<br />
<br />
<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. Now the software consists of five main parts: Actuation, skill, sensing, worldmodel and Taskmanager. These different software parts with their corresponding in- and outputs are depicted in Figure 2. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force vector from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
Sensing<br />
In the sensing part, the odometry and LRF data is obtained. This LRF data goes straight to different parts. By calculating the difference between the previous and the current data, the wrapping of the data is corrected and the relative rotation is calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When a Pico is in a door area the Boolean door detected will be ‘true’. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will calculate the direction and desired state using the Pledge algorithm.<br />
<br />
<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to degrees and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function will need the scan information from the LRF as an input and will output variables space_left, space_top and space_right.<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corned" nodes. The world model library provides two public functions which can be used in order to check whether doors are present:<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
header function with comments of scanNode and doorCheck<br />
</pre><br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''<br />
<br />
= Maze challenge =<br />
[[File:champions.jpg|thumb|center|800px|Figure 88:Champions]]</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=File:Taking_the_corner.pngFile:Taking the corner.png2017-06-16T10:20:36Z<p>S128756: </p>
<hr />
<div></div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-16T10:20:23Z<p>S128756: /* Making the turn */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
[[File:final design presentation.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. We search for a corner node at the right and left of Pico (light purple area the figure below). If such a corner is found, and the distance to this corner node checked to see if the distance is reasonable (0.1m – 1.5m). Consider a corridor with the exit at the right, then the corner node will recognized at the right. The distance to the closest corner node present in the light green area in figure NUMBER is used to calculate the width of the corridor using the cosine rule.<br />
If no other corner node is recognized in the light green area or the recognized corner node is too far away, the distance to the first corner node (denoted with number 2 in the figure below) is taken as the corridor distance. <br />
<br />
To take the corner, half of the corridor distance b is driven forward, during which the repulsion in forward direction is not used. After traveling <math>\frac{b}{2}</math> meters, Pico stops and rotates 90 degrees. Then a distance of c+e is driven forward, where c is the distance as shown in the figure below, and e is a variable that can be used for tuning. This distance is driven forward to prevent Pico from recognizing corner node 2 again at his right and starts turning gain before the corner is completely taken.<br />
For a corridor at the left, the exact same approach is used.<br />
<br />
<br />
[[File:taking_the_corner.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. Now the software consists of five main parts: Actuation, skill, sensing, worldmodel and Taskmanager. These different software parts with their corresponding in- and outputs are depicted in Figure 2. The software architecture is globally explained in this section. The important parts are further explained in the following sections.<br />
<br />
'''Taskmanager'''<br />
<br />
The taskmanager is the top part, which controls the whole software. Data comes in via the skill and sensing part, and data is sent to the strategy and actuation part. Based on the data from the other parts, the task manager makes decisions on what to do. First, it calls the variable ‘door detected’ to check whether Pico is in a door area. Then it will go to the initial state ‘start’ in which the startup procedure is implemented. It checks if there is a wall on the right side of Pico, and Pico will be aligned to this wall. When Pico is aligned to this wall, it will go to the following state ‘straight_pref’. In this state, Pico drives in its preferred direction and calls the boolean vector from the space recognition skill. This information is sent to the strategy skill, which sends the direction and state back. Based on this information it will stay in the case ‘straight_pref’ or switch to the state ‘straight’, ‘turn_left’, ‘turn_right’ or ‘turn_180’. When it stays in the same case, it will call the force vector from the repulsion skill. After that, the actuation vector is sent to the actuation part. When it switches to a state ‘straight’, the same is implemented as in the state ‘straight_pref’, but now the distance to the wall is added. This is implemented as a virtual spring, which will be further explained in the Maze solving algorithm section. In the states ‘turn_left’ and ‘turn_right’, the odometry data is used to check whether Pico has rotated enough.<br />
<br />
'''Actuation'''<br />
<br />
The input of the actuation part is an actuation vector, which contains the horizontal, vertical and angular velocity or a door request. The actuation part consists of four sub parts: move, stop, rotate and opendoor. The taskmanager decides which part is called. In the actuation part, the velocity is scaled, such that it does not exceed the maximum velocity. When the normalized velocity is calculated, this is sent to the actuators. When opendoor is called, an ‘opendoorrequest’ is sent to the actuator such that it will ring a bell.<br />
Sensing<br />
In the sensing part, the odometry and LRF data is obtained. This LRF data goes straight to different parts. By calculating the difference between the previous and the current data, the wrapping of the data is corrected and the relative rotation is calculated.<br />
<br />
'''World Model'''<br />
<br />
The world model is a function that detects nodes using the LRF. Using various algorithms, the data from the LRF can be filtered and the most important data points are saved as nodes. Important nodes concern mostly nodes that lie on the end of walls or that are corners. Using these nodes, the current world that PICO sees can be made. These nodes can also be used to recognize doors. <br />
<br />
'''Skill'''<br />
<br />
The skill part contains the skills of Pico, which are the calculation of the repulsion, the space recognition, the door recognition and the strategy. In the repulsion part, the repulsion forces are calculated using the LRF data. In the space recognition part, it is checked whether there is space to the left, right or front using the LRF data. In the door recognition, the door areas are calculated using the nodes from the World Model. When a Pico is in a door area the Boolean door detected will be ‘true’. The strategy part gets the boolean vector of the spaces from the task manager. Based on this spaces boolean vector, the strategy part will calculate the direction and desired state using the Pledge algorithm.<br />
<br />
<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
This function determines whether there is space or an obstacle to the left, right and top of Pico. In the config file, the beam width is determined in degrees. This value is converted to degrees and used to determine which LRF data points should be checked.<br />
As can be seen in the figure, there are 3 beams to be measured: left of Pico, above and to the right of Pico. By default, all spaces are defined true. If one measured LRF point is below the threshold value, indicated with an orange circle, the space_x variable will be set false.<br />
The threshold for the forward distance can be tuned independently of the others. The forward distance is slightly smaller than the other distances. This means that Pico will detect an obstacle in front of him later and will react later to this. This way a better wallfollowing can be realized.<br />
The function will need the scan information from the LRF as an input and will output variables space_left, space_top and space_right.<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties which are collectively defined as either "end" nodes or "corned" nodes. The world model library provides two public functions which can be used in order to check whether doors are present:<br />
<br />
<pre style="white-space:pre-wrap; width:100%;"><br />
header function with comments of scanNode and doorCheck<br />
</pre><br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
In order to recognize whether nodes are connected the LRF index of the subsequent nodes in is checked in order to see whether nodes are set at subsequent indexes of the LRF data. Two nodes can only have subsequent LRF indexes when the are separated by a large distance because of both the SPIKE check which compares distances, and a tunable parameter which determines the allowed overlap of nodes. Thus the nodes are not connected when the check is true.<br />
<br />
Each node is checked in sequence. A connection is thus always added "backwards", connecting the node checked to the previous one by modifying the ''Connections'' variable of both.<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''<br />
<br />
= Maze challenge =<br />
[[File:champions.jpg|thumb|center|800px|Figure 88:Champions]]</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-15T19:56:18Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure 2. The resulting netto forces are used as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. If a corner node is recognized at the right or left of Pico (approximately 90 degrees) and if the distance to this corner node is reasonable, the distance to the closest next corner node is used to calculate the width of the corridor using the cosine rule. If no other corner node is recognized or this corner node is to far away, the distance the the first corner node (which is in this case seen at the right of pico) is taken as the corridor distance.<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. The different software parts with their corresponding in- and outputs are depicted in Figure 2.<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-15T19:55:02Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i. Variable a is a correction factor for the width of pico that can also be used during the finetuning.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure 2. The resulting netto forces as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. If a corner node is recognized at the right or left of Pico (approximately 90 degrees) and if the distance to this corner node is reasonable, the distance to the closest next corner node is used to calculate the width of the corridor using the cosine rule. If no other corner node is recognized or this corner node is to far away, the distance the the first corner node (which is in this case seen at the right of pico) is taken as the corridor distance.<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. The different software parts with their corresponding in- and outputs are depicted in Figure 2.<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-15T13:32:36Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Figure 3: Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure 2. The resulting netto forces as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico and is visualized in figure 3.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. If a corner node is recognized at the right or left of Pico (approximately 90 degrees) and if the distance to this corner node is reasonable, the distance to the closest next corner node is used to calculate the width of the corridor using the cosine rule. If no other corner node is recognized or this corner node is to far away, the distance the the first corner node (which is in this case seen at the right of pico) is taken as the corridor distance.<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. The different software parts with their corresponding in- and outputs are depicted in Figure 2.<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-15T13:31:16Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that the finish line has been crossed and that Pico can stop searching for the exit. The main script can be terminated.<br />
:''Input: World model, Output: -''<br />
* '''Strategy:''' Gives a general direction based on the maze solving algorithm that is chosen.<br />
:''Input: World model data, LRF data. Output: Target point.''<br />
* '''Path planning:''' Uses an Artificial Potential Field to output a direction vector considering the target point outputted by the strategy function and the LRF data.<br />
:''Input: Target point, LRF data. Output: Direction vector''<br />
<br />
=== Interfaces ===<br />
The software functions have multiple inputs and outputs and can be grouped by functionality. If data from the sensing component is used by a function from the skill component, the data is transferred between these components, this is referred to as an interface. A rough overview<br />
of the interfaces is shown in Figure 1. The dashed line represents that the actions of the robot will influence what the sensors measure.<br />
[[File:Software_design.png|thumb|center|500px|Figure 1: Rough overview<br />
of the interfaces]]<br />
<br />
== Corridor Challenge ==<br />
=== Repulsion & Angle correction ===<br />
[[File:repulsion_allown.png|thumb|right|upright=0.7|Figure 2:Artificial potential field]]<br />
[[File:angle_correction.png|thumb|right|upright=0.7|Angle correction]]<br />
The first thing that was considered for the corridor challenge was some kind of repulsion from the walls to make sure Pico does not bump into anything. For the repulsion a simple version of an Artificial Potential Field is considered, which is given by the formula <br />
<br />
<math> F_x = \frac{1}{b} \frac{1}{N_1} \sum_{i=1}^{N_1} \frac{1}{(r_i-a)^3} cos(\phi _i) </math><br />
<math> F_y = \frac{1}{b} \frac{1}{N_2} \sum_{i=1}^{N_2} \frac{1}{(r_i-a)^3} sin(\phi _i) </math><br />
<br />
where b is a scaling variable that can be used for finetuning, N is the length of the considered laser data vector and \phi_i is the angle corresponding to measured distance distance r_i.<br />
<br />
For the calculation of the force in the forward direction, <math> F_x </math>, <br />
only laser data in front of Pico is used. Al the other laser data is used for the calculation of <math> F_y </math>,<br />
force in side ward direction. This is also shown in the figure The resulting netto forces as an input for the actuation function which is further explained below. Note that if the laser sees something at a very large distance or does not see anything at all, the returned distance is very small or even negative. Therefore all distances smaller then 0.01 meter are set to 10 meter. <br />
<br />
<br />
For the angle correction all the laser data at the right side of Pico is considered. The smallest distance to the wall and the corresponding angle are found using a for-loop. After subtraction of 90 degrees, the resulting angle is used as input for the desired rotation speed. This approach can be interpreted as a torsional spring connected to Pico.<br />
<br />
=== Actuation ===<br />
[[File:velocityscaling.png|thumb|right|upright=1.2|Velocity scaling explained]]<br />
The main functionality of the actuation script is to scale velocity signals that are sent to Pico in such a way that the constraints on maximum velocities are respected. Besides, effects of angle wrapping are compensated to create useful odometry data to rotate with a certain angle. Scaling of the translational speeds in x and y direction is done using <br><br />
<br />
::<math>\vec V_x = \vec F_x \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
::<math>\vec V_y = \vec F_y \sqrt{\frac{V_{max}^2}{\vec F_x^2 + \vec F_y^2}}</math><br><br />
<br />
in which Fx and Fy are the force signals from the repulsion script sent to the actuation script. This is clarified in the figure on the right. If an angular velocity exceeds the maximum value, the angular velocity simply gets scaled back to the maximum angular velocity using<br />
<br />
::<math>\omega = sign(\omega) \cdot \omega_{max}</math><br />
<br />
such that it makes sure that Pico will still turn in the right direction. <br />
<br />
When using the actuation script to rotate with a certain angle, the script will in each iteration return a relative rotation angle. The script in which the actuation script is called then has to integrate this relative angle until the desired angle has been rotated. However, the angle from the odometry data can jump from –π to π of vice-versa. If this happens, the relative angle will not be correct and has to be adjusted by adding or subtracting 2π.<br />
<br />
=== World model ===<br />
<br />
=== Making the turn ===<br />
Driving between two walls can be easily done using the the actuation, repulsion and angle correction code. To actually make a turn at the right moment to drive into the corridor, the corridor has to be recognized. From the world model, corner nodes and end nodes are received. If a corner node is recognized at the right or left of Pico (approximately 90 degrees) and if the distance to this corner node is reasonable, the distance to the closest next corner node is used to calculate the width of the corridor using the cosine rule. If no other corner node is recognized or this corner node is to far away, the distance the the first corner node (which is in this case seen at the right of pico) is taken as the corridor distance.<br />
[[File:Corridor_group4_2.gif]]<br />
<br />
= Final design =<br />
== Interface ==<br />
After the corridor challenge, the software architecture is changed a bit. The different software parts with their corresponding in- and outputs are depicted in Figure 2.<br />
[[File:Final_software_design.png|thumb|center|800px|Figure 2: Software architecture]]<br />
<br />
== Space recognition ==<br />
[[File:space_recognition_v2.png|thumb|center|800px|Figure 2:Space recognition]]<br />
<br />
== Maze solving algorithm == <br />
[[File:space.png|thumb|right|upright=1.2|Figure 3: Space around Pico]]<br />
The Pledge algorithm is chosen to solve te maze. The pledge algorithm has a preferred direction and counts the corners the robot takes. A corner left counts as -1 and a corner right as +1. When the counter is 0, the robot goes in its preferred direction. The pledge algorithm is implemented in the following manner:<br />
<br />
* If Pico is driving in preferred direction: <br />
** if space_top = true: Go straight in preferred direction<br />
** if space_top = false & space_left = true: rotate 90 degrees left<br />
** if space top = false & spacel_left = false & space_right = false: rotate 180 degrees left <br />
* Else<br />
** if space_right = true: rotate 90 degrees right<br />
** if space right = false & space top = true: go straight<br />
** if space_right = false & space_top = false & space_left = true: rotate 90 degrees left<br />
** if space_right = false & space_top = false & space_left = false: rotate 180 degrees left<br />
<br />
In Figure 3 Pico is depicted with three beams: space_left, space_right and space_top. All beams are using the 10 degrees of lrf-data.<br />
<br />
== Repulsion & wall following ==<br />
[[File:spring.png|thumb|right|upright=0.6]]<br />
How the repulsion and angle correction are working is already explained in the section Corridor challenge. The final repulsion and angle correction are not changed very much in the final design, only some values are tuned. The wall follower is added in the final design, which makes sure Pico stays at a desired distance from the wall. The wall follower is implemented as a virtual spring. When Pico is too close to the wall, the repulsion becomes very high and Pico will be pushed from the wall. When Pico is too far from the wall, the virtual spring will give a force. Therefore, Pico will be pulled to the wall. Between the repulsion and virtual spring is some threshold, such that the forces are zero in that area. This makes sure that Pico does not correct itself the whole time.<br />
<br />
== World model ==<br />
<br />
In order to recognize door areas a world model is constructed which uses landmark detection. Landmarks are defined as nodes, which are points in the LRF-data with certain properties.<br />
<br />
=== Node class ===<br />
<br />
The Node class (data type) is defined as follows:<br />
[[File:nodeclass.png|thumb|right|upright=2.0|Overview of the Node Class used in the world model.]]<br />
<br />
* ID (int): The ID of the nodes are set from right to left (in the scanning direction of the LRF) starting at ID 0. <br />
* Type (int): The types are defined in the header file of the world model library ''worldmodel.h''. Two types are currently in use: Cornernodes and Endnodes.<br />
* Location (location): For each node the ''Location'' class is used to track the position in both carthesian and radial coordinates relative to PICO. When the location class is updated using the radial coordinates the carthesian coordinates are updated automatically. '''VOEG FIGUUR TOE ASSENSTELSELS'''<br />
* Connections (std::vector<int>): A vector of node IDs. For each connected node the ID is stored in this vector. Thus it is possible to determine which nodes are connected by walls and which are not using the Node class.<br />
* LRFindex (int): Index in the LRF scan of the particular data point corresponding to the current node. It is mainly used to determine the connection vector.<br />
<br />
=== Node Recognition ===<br />
'''ADD PIECE OF CODE'''<br />
<br />
The world model is based on two types of nodes: endnodes and cornernodes. Finding nodes is done with the following checks over all data-points:<br />
<br />
* The current data-point is a cornernode if the distance between the current data-point and the next data-point is larger than a given value. <br />
* The current data-point is a cornernode if is passes the 90-degrees-test. This is a test that considers a previous data-point that lies at a set distance from the current data-point, and a next data-point that also lies at a set distance from the current data-point. Using the cosine rule, angles and distances to the three points, the actual distance between the previous and next datapoint can be compared to the distance between these points when applying Pythagoras. Pythagoras only holds if the angle is 90 degrees, so if the two values are equal, then Pythagoras is applicable and thus the corner is 90 degrees. <math> x_r </math> <br />
<br><br />
<math> A = \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} </math><br />
<math> B = \sqrt{(x_3-x_1)^2+(y_3-y_1)^2} </math><br />
<br><br />
<br />
* The current data-point is an endnode if the distance between the current data-point and the next data-point is smaller than a given value. <br />
* A data-point that lies at the maximum range or at the maximum angles is considered an endnode.<br />
<br />
The visualization of the corner nodes and the end nodes serves to debug and tune the object recognition.<br />
<br />
[[File:noderecogviz.png|thumb|right|upright=2.0|Visualization of the node recognition. Corner nodes are shown in white and end nodes are shown in red. PICO is the red block in the middle.]]<br />
Several tunable parameters are associated with the node recognition:<br />
<br />
=== Wall Recognition ===<br />
<br />
=== Door Recognition ===<br />
'''SHOW SIMULATION'''</div>S128756http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control_2017_Group_4Embedded Motion Control 2017 Group 42017-06-15T13:30:39Z<p>S128756: /* Repulsion & Angle correction */</p>
<hr />
<div>== Reports ==<br />
[[File:report1.pdf]]<br />
<br />
==Group 4 ==<br />
{| class="wikitable"<br />
|-<br />
| M.R.M. Beurskens || 0843080<br />
|-<br />
| N.H.J. Janssen || 0842075 <br />
|-<br />
| M.C.W. Schouten || 0869793<br />
|-<br />
| J.A.E. Verest || 0844791<br />
|-<br />
| M.S. de Wildt || 0776941<br />
|-<br />
| R.H.M. Winters || 0854048<br />
|}<br />
<br />
== Initial design ==<br />
=== Introduction ===<br />
In this design chapter, the initial design of a maze solving robot is specified in terms of<br />
requirements, specifications, components, functions and interfaces. It is implemented on the<br />
PICO hardware platform. A task-skill-motion framework is used in order to describe the<br />
robot behaviour. This will also be implemented in C++.<br />
<br />
=== Requirements and specifications ===<br />
PICO is required to autonomously navigate through a maze and find the exit without bumping into any of the walls. A door will be present in the maze, and must be opened by "ringing the bell" in a suitable location whilst standing still. Open spaces might be present, and the walls are approximately axis aligned. The maze might also feature loops. Therefore PICO is required to do the following:<br />
* Recognize walls and corridors in a robust manner. The walls are axis aligned, however not perfectly. PICO should allow for an alignment error. It also has to stay away from the walls with a sufficient margin (e.g. 10 cm between robot and wall). Bumping into a wall will count as a failed attempt.<br />
* Identify possible "door areas" in a robust manner. "The door will be situated at a dead end, a dead end being defined as a piece of wall with minimum length 0.5 meter and maximum length 1.5 meter with side-walls of at least 0.3 meter length". Alignment errors again need to be taken into account.<br />
* Map the maze to determine whether the area has been visited and to build a world model. Odometry and a Laser Range Finder (LRF) are used to build a world map and determine the location in the world. The odometry and LRF data should be synchronized to avoid drift in world location and mapping (SLAM).<br />
* Recognize corners as nodes in order to build an abstract and simplified maze representation consisting of nodes and lines.<br />
* Cary out a maze solving strategy based on its world model and solve and execute corresponding routing. The solving routine and the routing should be able to handle loops and open spaces and are based on the simplified maze representation. This enables more general strategy composition and faster computation.<br />
* Open doors by ringing a bell in the door area. No part of PICO should be located outside the 1.3 meter range of the door and PICO should be standing still whilst ringing the bell. The door opens completely within 5 seconds after PICOs request. Once the door is completely open, PICO needs to pass the open doorway to find the exit of the maze.<br />
* The software should be easy to set up and deploy, i.e. using git pull and with a single executable.<br />
* Clear the maze as soon as possible, with a total available time of seven minutes for two attempts. A maximum speed of 0.5 m/s translational and 1.2 rad/s rotational is given.<br />
* Do not stand still for more than thirty seconds when inside the maze.<br />
* Recognize when the maze is solved.<br />
<br />
=== Components ===<br />
Pico features a Laser Range Finder (LRF) to detect surrounding obstacles and wheel encoders to measure odometry data. The wheel base is holonomic, enabling it to turn on the spot and drive in any direction. An emergency button is present on the remote. PICO runs on batteries and should always be charging when not driving around.<br />
<br />
The software runs on an Intel i7 processor running Ubuntu 14.04 LTS. The Robotic Operating System (ROS) is used as a framework for PICOs software. However, an intermediate software layer is provided which can be used to access sensor data and actuate the robot. Our own software layer is divided into five main components: actuation, sensing, world model, task manager and skill.<br />
<br />
=== Functions ===<br />
'''Configuration file'''<br />
* '''Configuration:''' Defines a number of parameters. This is a header file so no inputs or outputs.<br />
<br />
'''Actuation'''<br />
* '''Move:''' This function calculates the translational velocity in x and y direction and the rotational velocity corresponding to the direction vector and net velocity outputted by the path planning function. The calculated velocities are sent tot the base actuators.<br />
:''Input: Direction vector, total velocity, Output: -.''<br />
* '''Stop:''' Stops the robot by sending the base velocities of magnitude zero.<br />
:''Input:-, Output:-.''<br />
* '''Rotate:''' Rotates the robot 90 or 180 degrees. First checks the robot has enough space to rotate without hitting the wall. If this is not the case, first a call to Move is made to move the robot away from the wall.<br />
* '''Open door:''' Makes sure the robot stands still, rings the bell to open the door and waits until the door is opened. <br />
:''Input: LRF data, Output: -.''<br />
<br />
'''Sensing'''<br />
* '''Get LRF data:''' Gets the data from the laser range finder.<br />
:''Input: -, Output: LRF data''<br />
* '''Get odometry data:''' Gets position data from omni-wheels.<br />
:''Input: -, Output: odometry data''<br />
<br />
'''World Model'''<br />
* '''SLAM:''' Simultaneous Localization And Mapping, this updates the position of PICO in the world model using new sensor data.<br />
:''Input: LRF data, Odometry data, Output: World model''<br />
* '''Object recognition:''' This function will estimate which objects there are in the World Model using the geometries of the environment.<br />
:''Input: World model, Output: Objects with their coordinates.''<br />
<br />
'''Task Manager'''<br />
* '''Task monitor:''' Determines which piece of code will be executed next.<br />
:''Input: -, Output: -''<br />
<br />
'''Skill'''<br />
* '''Filter data:''' Moving average filter to minimize noise.<br />
:''Input: noisy data, Output: averaged data.''<br />
* '''Finish:''' Recognizes that t