Embedded Motion Control 2019 Group 5: Difference between revisions

From Control Systems Technology Group
Jump to navigation Jump to search
 
(252 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Welcome to the Wiki Page for Group 5 in the Embedded Motion Control Course (4SC020) 2019. This page contains the design plans and other details of our work in this course.
<div style="font-family: 'Roboto','q_serif', Georgia, Times, 'Times New Roman', serif; font-size: 15px;">


=Introduction=
Welcome to the Wiki Page for Group 5 in the Embedded Motion Control Course (4SC020) 2019!
==Group members==
 
= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Group Members</div>=


{| border="1" cellpadding="5" cellspacing="1" style="float:left, right-margin=20px;"
{| border="1" cellpadding="5" cellspacing="1" style="float:left, right-margin=20px;"
Line 27: Line 28:
|}
|}


==Introduction==
= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Introduction</div>=
The world around us is changing rapidly. The new technological possibilities triggers new ways of life. These innovations, like self driving cars, could make life easier but also safer. In this course we have programmed a robot to assist in the hospital, instead of a self driving car. However, autonomous robots in a hospital environment could decrease the amount of mistakes in a hospital. If the robot is programmed correctly, it could deliver the right medicines to the right patient. Also, since a robot never sleeps, patients could get their medicine at night, if they need something for the pain for example. In our challenge we had program a robot (PICO) which is able to drive to different cabinets (hence patients), recognize the different cabinets and recognize it has arrived (hence delivering the medicine.)<br />
== Overview of Wiki ==
The wiki will cover the main topics regarding our project. Several functions which are crucial for the program are discussed in detail. Furthermore the challenges are described in detail, the strategy applied is covered, the results are covered and also some thoughts for improvements are given.
 
= Task Requirements =
In the following section the task requirements of the PICO are given.
== Generic ==
The following performance requirements are expected to be met for the:
 
# PICO should be able to leave the room from any initial position.
# PICO should not hit the wall of the room, the corridor or (dynamic/static) objects under any condition.
# PICO should not remain idle for more 30 seconds.
# PICO should be able to move translational with a speed of 0.5 m/s and rotational with a speed of 1.2 rad/s.
# Only one executable has to be called in order to start.
 
== Escape Room Challenge ==
The following performance requirements are expected to be met for the Escape room challenge:


# The rear wheels of PICO have to pass the finish line
[[File:Gostai-Jazz-500x500.jpg|right|thumb|425px|The star of 4SC020: Pico]]
# PICO should complete the task within 5 minutes.


== Hospital Challenge ==
The world around us is changing rapidly. New technological possibilities trigger new ways of life and innovations like self driving cars, medical robots, are prime examples of how technology can not only make life easier but also safer. In this course we look at the development embedded software of autonomous robots, with a focus on semantically modelling real world perception into the robot's functionality to make it robust to environmental variations that are common in real world applications.
The following performance requirements are expected to be met for the hospital challenge:


# PICO should determine its position with respect to its surroundings (walls, obstacles, etc.)
In this year's edition of the Embedded Motion Control course, we are required to use Pico, a mobile telepresence robot with a fixed range of sensors and actuators, to complete two challenges: the Escape Room Challenge and the Hospital Challenge. Our aim was to develop a software structure that gives Pico basic functionality in a manner that could be easily adapted to both these challenges. The following sections in this page detail out the structure and ideas we used in the development of Pico's software, the strategies designed to tackle the given tasks, and our results from both challenges. <br/>
# PICO should determine its position on the global map in the world model.
# When PICO visits a cabinet, it should give a clear sound of which cabinet it is visiting (i.e.,“I have visited the cabinet zero”).
# PICO has to make a snapshot of the map once a cabinet is reached.
# PICO should reach all the cabinets in a correct order.
# PICO should be able to detect the obstacles.
# PICO should not hit any walls and objects except for slightly touching.
# PICO should try to detect the static and dynamic objects and present them in its own world model.
# PICO should complete the task within 10 minutes.


= Hardware Description =
== Pico ==


PICO has several components which are:  
To aptly mirror the structure and operation of a robot deployed in a real-life environment this course uses the Pico robot, a telepresence robot from Aldebaran Robotics. With a fixed hardware platform to work on, all focus can be turned to the software development for the robot. Pico has the following hardware components:  
* Sensors:  
* Sensors/Inputs:  
#  Proximity measurement with Laser Range Finder (LRF)  
#  Proximity measurement with Laser Range Finder (LRF)  
#  Motion measurement with Wheel encoders (Odometer)  
#  Motion measurement with Wheel encoders (Odometer)  
#  Control Effort Sensor  
#  Control Effort Sensor  
* Actuators:  
#  170-degree wide-angle camera (not used in this course)
#  Holonomic Base - Omni wheels that facilitate 2D translation and rotation  
* Actuators/Outputs:  
#  Holonomic Base - Omni wheels that facilitate 2D translation and rotation
#  5" LCD SCreen
#  Audio Speaker
* Computer:  
* Computer:  
#  Intel i7 Processor  
#  Intel i7 Processor  
#  OS: Ubuntu 16.04
#  OS: Ubuntu 16.04
* Interaction
# PICO has the ability to produce sound through a speaker in its body
# PICO has a display, mounted on top of the robot


= Software Architecture =
= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Functional Requirements for Pico</div>=
 
A description of the expected functionality of robot is the first step to defining its implementation in software in a structured manner. With the given hardware on Pico we were able to define the following functionality for Pico to be able to sufficiently operate in any environment it is placed in:
=== Generic Requirements ===
 
# Pico should be capable of '''Interpreting''' (giving real-world meaning) to raw data acquired from its sensors.
# Pico should be capable of '''Mapping''' its environment and '''Localising''' itself within the mapped environment.
# Pico should be capable of '''Planning''' motion trajectories around its environment.
# Pico must adhere to performance and environmental '''Constraints''', such as maximum velocities, maximum idle time while operating, restricted regions, avoiding obstacles, etc.
# Pico should be capable of '''Providing Information''' about its operating state and internal process whenever required through the available interfaces.
 
In addition to these, the following task-specific requirements were defined for Pico (descriptions of the challenges can be found in later sections):
 
=== Escape Room Challenge Requirements ===
 
# Pico should be capable of identifying an exit and leaving the room from any initial position.
# Pico should use the quickest strategy to exit the room.
# Pico must drive all the way through the exit corridor till the end (past the finish line) to complete the challenge.
 
=== Hospital Challenge Requirements ===
 
# Pico must be able to accept a dynamic set of objectives (cabinets to visit).
# When Pico visits a cabinet, it should give a clear sound of which cabinet it is visiting (i.e.,“I have visited the cabinet zero”).
# PICO has to make a snapshot of the map once a cabinet is reached.
# PICO should be capable of identifying and working around obstacles and closed doorways while planning its trajectory.
 
= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Software Architecture</div>=
 
With the knowledge of the available hardware and the operational requirements for the given tasks, software development can take a well structured and modular developmental approach, thus making it feasible to alter designs and add new functionality at later stages of development. Our software architecture can be split into two parts: the World Model which represents the information system of the robot and the Software Functions which covers all the block that use data from the World Model to give Pico its functionality. While in theory it is encouraged to have a definition of the Information Architecture of system before heading into the Functional Architecture, our software started with the development of a primitive World Model which was later expanded alongside the development of the Software Functions.


== World Model ==
== World Model ==
[[File:team5_2019_world_model.png | 440 px | right | thumb | Figure 1: Pico's World Model]]
The World Model represents all the data captured and processed by Pico during its operation, and is designed to serve as Pico's real-world semantic "understanding" of its environment. It is created such that software modules only have access to the data required by their respective functions. The data in the World Model can be classified into two sections:
* Environmental Data
# Raw LRF Data
# Interpreted Basic Measurement Information (eg: center, left, right distances; closest and farthest points)
# Detected corner points
# Detected exits
# Processed LRF data in the form of an integer gridmap
# Global Map in the form of an integer gridmap
# Cabinet Locations
* Robot Data
# Operating state
# Localised position
# Desired trajectory
# Odometer readings and offset data
As seen in Figure 1 (click on image to zoom), all parts of Pico's software functions (explained in the next section) interact with the World Model to access data that is specific to their respective operations. To avoid creating multiple copies of the same values and thus optimize on memory usage, each software module accesses its data using references to the World Model, thus asserting one common data location for the entire system.


== Functions ==
== Functions ==
This section describes the part of the software architecture that "gives life" to Pico and enables it to perform tasks according to the set requirements. Our software is modularised into four main sections: Measurement, Mapping, Planning and Actuation. As seen from their titles, each section is meant to cover a specific set of robot functions, similar to the organs in a living organism, which when put together with the World Model provide for a completely functional robot. In comparison with the paradigms stated in the course, this structure can be seen as a slightly modified version of the Perception, Monitoring, Planning and Control activities; the functions of Perception are covered by the Measurement and Mapping modules, and Monitoring and Control is covered within the Actuation module. Regardless of these differences, both structure provide the same end result in terms of robot functionality and in terms of being sufficiently modularised. The following sections describes each one of these sections and their corresponding functions, along with a list of some common shared functions at the end.


=== Measurement ===
=== Measurement ===
[[File:team5_2019_measurement.png | 300 px | thumb | right | Figure 2: Measurement Module and World Model]]


In the function part named 'measurement', different return values are designed to determine states of reading the data received by PICO, including laser data and odometry data. Then, the middle interval of the whole scanning range of PICO is defined as its front center index and the direction of the interval pointed by 90°/-90° with respect to the front center index is defined as left/right index. The farthest distance and the nearest distance which could be detected are recorded and updated in the model 'getMaxMinDist'. In addition, environment states (existing obstacles or not) of three directions (front, left and right direction of PICO) are also processed and updated in this model. In the model 'sectorClear', four return values are defined to express different states faced by PICO directly which show the distance between PICO and obstacles. The next model in measurement is 'alignedToWall', compare the distance ***. Moreover, angle increment, maximal angle and minimal angle are also recorded in this function.
The Measurement module is Pico's "sense organs" division. Here, Pico can read raw data from its available sensors and process some basic information from the acquired data. Figure 2 shows the information interface between the World Model and the Measurement model. The following functions constitute the Measurement Module:
 
==== measure() ====
 
'''''Reads and processes sensors data into basic measured information'''''
 
Apart from the standard library functions to read raw data from Pico's LRF and Odometry sensors, the measure() function also interprets and records some primitive information from the obtained LRF data such as the farthest and nearest distances in Pico's current range, the distances at the right, center and left points of the robot, boolean flags indicating whether the right, center or left sectors (sectors are determined by a fixed angular deviation from a given mid point) of Pico's visible range are clear of any obstacles/walls (Figure 3). All these are stored in the World Model to be processed by any other functions that may need this data. Additionally, the measure() function also returns a status check to its parent function, which would indicate whether it was able to successfully acquire data from all sensors, or if not, which sensors failed to deliver any measurements. This would signal Pico to act accordingly in the event of consistent unavailability of data from its sensors. The measure function is the first function to be called in Pico's execution loop.
 
[[File:team5_2019_pico_sectors.png | thumb | 300 px | right | Figure 3: Pico's Sector Clear Check]]
 
==== sectorClear() ====
 
'''''Indicates the presence of obstacles/walls in the vicinity of a given heading angle'''''
 
This function is used to check whether there are any obstacles in a given direction of the robot. While Pico's path planning module is responsible for determining a path devoid of any obstacles, it cannot be guaranteed that Pico would respond exactly according to the planned path or that obstacles around it would stay static while it navigates around them. In this case the sectorClear() function can be fed with Pico's heading angle and thus be used to determine whether the coast is clear of if Pico needs to operate with caution on the current planned trajectory.
 
==== alignedToWall() ====
 
'''''Determines the deviation of Pico's current heading with respect to a straight wall on the right, left or front of Pico'''''
 
The alignedToWall() function measures the deviation of Pico's right, left or center LRF values from an expected parallel wall. This function is mainly used while localising Pico, to ensure Pico is oriented in a specific pre-determined orientation to obtain its position with respect to a given map. The animation in Figure 4 shows how this is used to rotate Pico till it is aligned to wall on its left; the white vertical lines on the right and left of Pico are used as a reference to compute the alignment difference.
 
[[File:team5_2019_align_to_wall.gif | frame | 400 px | center | Figure 4: Pico aligning itself to a wall on the left]]


=== Mapping ===
=== Mapping ===
[[File:team5_2019_mapping.png | thumb | 300 px | right | Figure 5: Mapping Module and World Model]]
Mapping of Pico's environment can be handled in two mutually exclusive scenarios: one where no global map is provided and Pico thus needs to understand its surroundings all by itself, and one where Pico has a global map and can compare its sensed data with the information provided on the map. The Mapping module therefore has two primary functions named identify() and localise() which are responsible for giving Pico a clear understanding of its environment and thus help it determine its actions based on this understanding. The Mapping module also includes several other functions that allow Pico to read and interpret provided maps, generate mapped grid spaces out of the provided map and its sensor data to be used by localise() and other path planning functions, and create visualizations on its screen of processed sensor data. As was with the Measurement module, the Mapping module also interacts with the World Model as its data bank as shown in Figure 5.
==== identify() ====
'''''Identifies significant points such as corners and exits in Pico's vicinity'''''
This function uses the acquired LRF data and processes it to identify significant features such as corners, and exits. While this operation is mainly used in situations where Pico does not have access to a global map, this function is also utilised to identify Pico's environment at the start of its run time in order to perform an initial "offset localisation" (explained in the Hospital Challenge section) before it can continue localising with the localise() function. The identify function uses a modified averaging comparison technique to smoothen the obtained noisy LRF data and subsequently compare the averaged data with the original LRF sequence to identify corners.  This method also helps it distinguish between convex (red circle) and concave corners (blue circle) as seen in the animation in Figure 4. As several adjacent LRF points would satisfy the condition for identifying corners, all identified corner points are then clustered into single corner points by means of comparing their positions within the LRF sequence. Furthermore, by comparing the distance between two convex corners and the LRF values of distances between those two corners, this method can also identify an exit/entry point (magenta circle) within a room.
==== localise() ====
'''''Identifies Pico's current location within a given global map'''''
The localise() function uses a minimum difference based cost comparison technique to compare Pico's local map with the global map and thus obtain its position on the global map. This method however relies on an approximate knowledge of Pico's whereabouts on its global map, around which it performs its cost comparison. This approximate position is typically obtained after processing information from the identify() function at Pico's startup or from a combination of Pico's previously localised position, its odometry readings and any error offsets at any stage in execution after the startup. This reliance helps avoid requiring to compare Pico's local map with all possible positions on the global map, thus allowing for a local optimization of possible positions which saves on computation time.
The cost function is computed by assuming the robot to be at a given position on the global map, projecting the LRF points with respect to this position onto the global map and calculating the summation of distances of all LRF points from the closest corresponding point on the global map. The identify() function computes the cost function of several deviations with respect to the approximate location of the robot and thus obtains the position with the least cost as the actual position of the robot on the global map. To further optimize on computation time, the function can also be tuned to project intervals of LRF points onto the global map instead of all available points thus reducing the total number of distance comparisons to be made. A sample of Pico moving around and localising itself is shown in Figure 7.
This method also works in the presence of real-world objects that are not found on the global map, as such points corresponding to obstacles would result in a uniform increase in cost function across all considered position deviations in the optimization process. Additionally, the identify() function evaluates the persistence of these obstacles, and subsequently adds any persistent differences between the local and global map onto the global map which helps in planning paths around closed doors (Figure 8) and also improves the localisation performance as Pico moves through its environment. More results of localisation can be seen in the animations provided in the Hospital Challenge section.
[[File:team5_2019_localise.gif | frame | center | Figure 7: Pico Localising itself within a given map]]
[[File:team5_2019_localise_with_obst.gif | frame | center | Figure 8: Pico Localising itself within a map with obstacles]]
==== genWeightedMap() ====
[[File:team5_2019_binary_vs_weighted_map.png | right | thumb | 450 px | Figure 7: Binary grid map (left), Weighted grid map (right)]]
'''''Converts the standard binary global grid map into a weighted integer grid map'''''
Our solution to navigate around a pre-mapped environment is implemented through the A* Path Planning algorithm which uses a grid map to plan a trajectory between two points on the given grid. With a given global map that has all significant points and walls defined, generating a binary gridmap is a straightforward process. However, the A* algorithm, which tends to select the quickest path available, would generate path that would tend to stick quite close to the walls. Considering that the cell size of the grid map is far smaller compared to Pico's physical dimensions, this would lead to several clashes between any obstacle avoiding functions and the provided path from the path planner. To avoid this, the global grid map is converted from its binary form into a weighted integer form, where the cells with walls and other objects take the highest weights and cells surrounding these have linearly decreasing weights as you go further away from the objects. This additionally allows the path planner to generate paths that drive Pico away from such objects, even if it starts close to them. Figure 8 shows an example of such a conversion, and Figure 9 shows the difference in paths generated with and without the weighted grid map.
[[File:team5_2019_astar_binary_vs_weighted.png | thumb | center | 600 px | Figure 8: A* Path Planning on Binary grid map vs on Weighted grid map]]


=== Planning ===
=== Planning ===
[[File:team5_2019_planning.png | thumb | 300 px | right | Figure 9: Planning Module and World Model]]
Planning forms the core of Pico's decision making abilities. This module is the main control center of all of Pico's activities, and it governs the way all other modules operate. It comprises one primary function named plan() that essentially operates in the form of a finite state machine. Based on the given task, several operating states are defined, and Pico is made to track its current operations through a state variable. The plan() function uses the information processed by the Measurement and Mapping modules and any previous pieces of information to determine Pico's actions based on the operating state, and delivers this data into the World Model. The most typical actions generated by the plan() function are desired velocity profiles which can be used by the actuation module in the next stage of the operating loop. Figure 9 shows the interaction between the Planning module and the World Model.
Since Pico's operations are dependent on the task it has to perform, Planning is the only module that needs to change to accommodate the differences in functionality requirements between the Escape Room Challenge and the Hospital Challenge. Thus, the states and functions within each state of the planning block are described in the sections specific to each challenge.


=== Actuation ===
=== Actuation ===


=== Additional Functions ===
[[File:actuation.png | thumb | right | 300 px | Figure 10: Actuation Module and World Model]]
{| border="1" cellpadding="5" cellspacing="0" align="center" style="margin: 1em auto 1em auto;"
 
!
The final module of the software architecture is the Actuation Module. This module is concerned with the physical control and monitoring of Pico based on instructions received from the previous modules through the World Model as shown in Figure 10.
! style="font-weight: bold;" | Function
 
! style="font-weight: bold;" | Description
====Actuation::actuate()====
|-
 
| rowspan="9" | Data logging
'''''Governs the actuation of Pico's Holonomic Base using desired velocity profiles and sensing data'''''
| The function helps to store the LRF data during the simulation process which could be used to understand how PICO sees the area around itself.
 
|-
This function takes in inputs in the form of desired translational and rotational velocity profiles, and simply actuates Pico's motors based on these values. To allow for smooth motion profiles, the actuate() function also tracks Pico's current velocity and incrementally adjusts it match the desired velocity from the world model. Additionally, the actuate function also employs obstacle avoidance by computing Pico's heading based on the desired velocity vectors and adjusts its actual velocity to either move away or to move slowly if it finds an obstacle in the vicinity of its heading.
|}


= Escape Room Challenge =
=== Additional Functions and Software Features===


== Link to Challenge Description ==
The above modules cover the main functionality of Pico to complete the task at hand. These modules are further supplemented by some additional common resources and software features that either aid in the operation of the primary functions or are useful for debugging of the software.
The detailed description for the '''Escape Room Competition''' could be found [[Embedded Motion Control#Escape Room Competition | here]].


== Challenge Strategy ==
# Json to Binary map: This function generates a binary map grid map from the provided global map in JSON format, with room and cabinet walls represented by a 1 and  empty spaces represented by 0s.
Initial stage in the strategy is to scan the room and search for the exit. If the exit is not found PICO will continue to rotate until it manages to find an exit. If still the exit is not detected then PICO will move approximately to the center of the room and rescan the room for an exit.  
# Performance Variables: As stated in the requirements, Pico must adhere certain performance constraints. These are listed out in the form of Performance structure that contains information such the maximum and minimum permissible velocities, minimum permissible distance, minimum measurable distance, etc.
Once the exit is found Pico will move towards the center of the exit. As soon as the exit is reached, PICO will start to follow the corridor.
# Data Logging: Through this logging feature, Pico is able to log all important processed information based on its operating state into files that can be analysed for performance later. Each module manages its own separate log, and log messages can also be displayed on a console in real-time while Pico operates.
# Module Enable Flags: An additional testing and debugging feature is a set of enable flags that allow the user to temporarily switch off one of the modules. This, for example, is useful in instances where the user may want to manually control Pico for testing purposes while it continues to measure and map its environment.


== End Result and Future Improvements ==
= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Escape Room Challenge</div>=


In the first attempt PICO slightly bumped into the wall while entering the corridor due to oscillatory movement and high velocity during diagonal movement. In the second round the maximum transnational velocity was reduced which helped it to enter the corridor smoothly. The challenge was completed in 40 seconds.
The first competition in this course was the Hospital Challenge. The main objective of this challenge is for Pico to be able to locate the exit of a room whose dimensions are not known before hand (no map provided) from any starting position within the room and subsequently exit the room as quickly as possible. A detailed description of this challenge can be found [[Embedded Motion Control#Escape Room Competition | here]].
Eventually our group managed to win the completion and we got some beers at the end of the final competition for the same!


== Challenge Strategy ==


[[File:Team5_2019_escape_room_state_diagram.jpg | right | thumb | 370 px | Figure 11: Escape Room State Diagram]]


[[File:EMC_Team5_C1.gif]]
Two strategies were experimented with to complete this challenge: following the walls till and exit is located, and searching for the exit and driving towards it. While the former sounded easier to implement at the initial stages of discussion (as seen in our Initial Design Document), it was clear that the latter was the faster strategy of the two. In the end a combination of the two strategies was implemented to serve as a fail safe mechanism in case Pico was not able to find an exit within a fixed number of attempts. This section describes the implementation of these two strategies in the Planning Module, while all other modules remain the same.


= Hospital Challenge =
=== Primary Strategy: Scan For Exit ===


'''Hospital Competition''' is the second part of the course Embedded Motion Control. In this competition, PICO could determine the cabinet in each room and face towards all the cabinets in the right region marked previously for the given start area. When PICO visits a cabinet, it should give a clear sound of which cabinet it is visiting (i.e., “I have visited the cabinet zero”) and reach all the cabinets with a correct order. PICO could detect the obstacles in this competition not only static objects but also dynamic ones (Such as the walking actor in the hallway) and not hit any walls and objects except for slightly touching. PICO should also try to detect the static and dynamic objects and present them in its own world model. Finally, PICO should complete the task within 10 minutes and must not remain idle for more than 30 seconds. This is a brief presentation slide with a basic introduction of Hospital Competition, which could be found [https://tuenl-my.sharepoint.com/:p:/r/personal/r_m_h_rompelberg_student_tue_nl/_layouts/15/Doc.aspx?sourcedoc=%7BDD7A341A-637C-4957-B2FD-F37C2E7010A5%7D&file=Presentation1.pptx&action=edit&mobileredirect=true&cid=fc36fe7e-18c3-426f-9b35-990013f12505 here]
In this strategy, Pico makes use of the corner and exit detection features in it Mapping Module to be able to determine whether or not it sees an exit in its current field of view. If an exit is currently not visible, Pico starts to rotate through a fixed angle, while still looking for an exit. If at the end of this rotation maneuver Pico is still unable to find the exit, it is probably in a corner of the room where a clear view of the exit is obscured from its sensing range. In this case, Pico translates forward for a fixed length and continues to look for an exit during this motion too. At the end of this motion if an exit is still not found, Pico repeats the rotate and translate for a maximum of four tries, after which it indicates that it is unable to find the exit through this strategy and subsequently switches to the Wall Following strategy. In tests with different exit positions and robot initial positions, it was found that Pico never needed to switch to the Wall Following startegy and was always able to find the exit within three iterations of rotating and translating. On encountering an exit during any of these previously mentioned operations, Pico switches its operational state to face and drive towards the exit. Upon reaching the exit, Pico then orients itself to be parallel to the exit corridor and goes on to perform a corridor/wall follow maneuver till it has left the corridor. All these operations are described in the state diagram shown in Figure 11.
== Link to Challenge Description ==
The detailed description for the '''Hospital Competition''' could be found [http://cstwiki.wtb.tue.nl/index.php?title=Embedded_Motion_Control#Hospital_Competition  here].


== Challenge Strategy ==
=== Secondary Strategy: Wall Following ===


== State Diagram ==
In this backup strategy, Pico uses the walls of the room as a guide to eventually reach the exit. Pico would begin by locating the nearest wall to itself, driving towards it and aligning itself to be parallel to the wall. After this it runs in a continuous loop of driving parallel to the wall until it detects that it is at a corner (wall ahead of it) or till it detects the exit (large change in distance measured) on the side that it was following the wall. In the event of detecting a corner, it would perform a 90 degree turn in the direction of the corner, align itself to the wall and continue following it as before. If it detects an exit it would instead turn towards the exit and carry out a corridor/wall follow maneuver till it has left the corridor.


== End Result and Future Improvements ==
== End Result and Future Improvements ==


= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Initial Design of Escape Room Competition</div>=
In the first attempt at the Escape Room Competition (Figure 12), Pico performed as expected by looking around for the exit, driving forward on not seeing it initially, eventually detecting the exit and heading towards it. However it seemed to drift sideways while arriving at and while subsequently entering the exit corridor. This caused it to slightly bump into the exit wall at the start of the exit, but it eventually corrected itself and crossed the exit corridor. To temporarily avoid this bumping its maximum translational velocity was lowered for the second attempt, wherein it exhibited the same sideways drifting behaviour, but was able to stop short of bumping into the wall. With this we were able to complete the challenge in the quickest time of about 40 seconds and thus rank first in this competition!


A brief summary of embedded software functions design is described in the following chapters.
On inspecting the code later, a logical bug in the actuation module was found to be responsible for the sideways drift. This was fixed to achieve an output as seen in the simulation in Figure 13.


== Design Document ==
Another small aspect that could have further lowered the time Pico took to complete the challenge was the pauses between each operational state. In order to observe Pico's actions and comprehend them while they were taking place, a one second delay was added to Pico's operation every time it switched form one state to another. Eliminating this delay could have lowered the overall operational time by 6 seconds.


The '''Initial Design Plan''' for the '''Escape Room Competition''' and the '''Hospital Competition''' with PICO could be found [[Media:Group_5_Design_Document.pdf | here]].
[[File:EMC_Team5_C1.gif | center | frame | Figure 12: Escape Room Challenge first attempt]]
 
== Functions ==
{| border="1" cellpadding="5" cellspacing="0" align="center" style="margin: 1em auto 1em auto;"
!
! style="font-weight: bold;" | Function
! style="font-weight: bold;" | Description
|-
| rowspan="9" | High-level
| Detect Wall
| Set a safe distance between wall and PICO. If there are too closer with each other, PICO would execute corresponding movements.
|-
| Detect Corner
| Detect the number of corners of the room.
|-
| Startup
| Identity the initial angle of PICO in the start position. And then, compute an angle -- &theta;.
|-
| Scan for Exit
| Rotate PICO to detect all the distances between wall and robot in order to find the exact position of the corridor.
|-
| Move to Max
| If PICO do not detect enough walls in the room, it will move to the direction of the maximal distance and detect walls again.
|-
| Face Exit
| Let PICO face to the exit corridor straightly but not perfectly. PICO would not rotate itself in a defined error range.
|-
| Drive to Exit
| PICO moves to the exit.
|-
| Enter Exit Corridor
| Enter the exit corridor with a safe range between the walls of the corridor and PICO itself.
|-
| Follow Corridor
| Follow the walls of the corridor with a safe range until PICO crosses the finish line.
|-
| rowspan="10" | Low-level
| Initialize
| Initialize actuators
|-
| Read Data of Sensors
| Read the odometer and laser data
|-
| Drive Forward
| Move straightly
|-
| Drive Backward
| Move back
|-
| Drive Left
| Move left
|-
| Drive Right
| Move right
|-
| Turn Left
| Turn 90°left
|-
| Turn Right
| Turn 90°right
|-
| Turn Around
| Rotate
|-
| Stop Movement
| Stop current movement.
|}


== Interfaces ==
[[File:team5_2019_ER_sim.gif | center | frame| Figure 13: Escape Room Simulation]]


= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Escape Room Challenge Execution</div> =  
= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Hospital Challenge</div>=


*''Introductions about functions of code. Explain each mode more or less in order to let readers know what happened in our PICO. Just like what Winston did in Tuesday evening. -- YI ''


== Startup ==
This mode involves computing the required angle for PICO to complete a full 360 degree view if needed. Once the angle has been determined the state switches to SCAN_FOR_EXIT.


== Scan for exit ==
This mode searches for an exit in its available field of view which is around 230 degrees. If it does not manage to find an exit in this field of view, it uses the angle computed in the STARTUP to complete to rotate until it manages to find the exit. If it happens to be the case that it still did not manage to find any exit it switches to a state MOVE_TO_MAX. This scenario is generally encountered if PICO is initially put in a corner adjacent to the exit wall.


== Move to max ==
The Hospital Competition is the second part of this course. In this competition, Pico must navigate around a fixed hospital environment with help from a provided global map, with the aim of visiting specific sites (cabinets) while avoiding any static or dynamic obstacles and closed doors. A detailed description of the Hospital Challenge can be found [[Embedded Motion Control#Hospital Competition | here]].


== Face exit ==
== Challenge Strategy ==


== Exit undetectable ==
Our solution to the Hospital Challenge used a relatively smaller strategy as compared to the Escape Room Challenge. Pico begins operation by accepting a list of cabinet numbers that it should visit. Before it can attempt to move anywhere, it must first localise itself within the provided global map. To do this, Pico makes use of the known features of the room such as the exit and the room corners detected by the identify() function of the Mapping Module. It starts by aligning itself parallel to the left wall of the room and then comparing the position of the detected exit with their corresponding positions on the global map to obtain its starting position. From here on, Pico gets the first/next cabinet in the previously acquired list of cabinets, plans a trajectory from its current position till the cabinet using the A* Path Planning algorithm and goes on to follow this trajectory, while updating the global map with any differences from its sensed local map. On reaching a cabinet, Pico performs a fixed routine of orienting itself to face the cabinet, taking a snapshot of its current LRF data and finally announcing its arrival at that cabinet via its speaker. It then proceeds to get the next available cabinet on the list in the same manner as above and continues this process till all the cabinets in its list have been visited. Figure 13 shows the state diagram of the Planning module to carry out the above series of operations.


== Orient to exit wall ==
[[File:state_diagram_Hosp.PNG | frame | center | Figure 13: Hospital Challenge State Diagram]]


== Drive to exit ==
== End Results and Future Improvements ==


== Enter exit corridor ==
Unfortunately, the Hospital Challenge competition did not go as expected (Figures 14 and 15). In the first attempt, Pico drove towards the exit of the room, but deviated from its path midway and collided with the left wall of the room. In the second attempt, Pico had a similar result wherein it immediately drove towards the left wall. On examining the log files from both runs and attempting to run Pico again once the competition was over, we were able to find that an error in the localisation made Pico believe that it was instead facing the right side of the room consequently leading it to believe that the entire map was rotated by 90 degrees in the counterclockwise direction, thus resulting in the drive towards the left wall. This was later fixed and the results of the same are shown in the simulations in Figures 16 and 17.


== Exit corridor follow ==
[[File:team5_2019_HC_first_attempt.gif | frame | center | Figure 14: Hospital Challenge Competition - First Attempt]]


== Stop ==
[[File:team5_2019_HC_second_attempt.gif | frame | center | Figure 15: Hospital Challenge Competition - Second Attempt]]


==Results==
[[File:team5_2019_HC_sim1.gif | frame | center | Figure 16: Hospital Challenge Competition - Simulation 1]]
During the escape room challenge we were able to escape the room and won the first prize. The first try our robot bumped into the wall, so we had to lower the speed of the robot. The second time the robot reached the exit without bumping into the wall. This lead to an improved code for the actuation of the robot.


= <div class="center" style="width: auto; margin-left: auto; margin-right: auto;">Hospital Competition</div> =
[[File:team5_2019_HC_sim2.gif | frame | center | Figure 17: Hospital Challenge Competition - Simulation 2]]


The  main objective  for PICO  is to "deliver" the  medicines from one cabinet to another which will be defined by the judges just before the challenge starts. The PICO will be operating under an environment amidst static and dynamic obstacles.
[[File:team5_2019_snapshot1.png | frame | center | Figure 18: Hospital Challenge - snapshot at cabinet 0]]


[[Media:Design_document_Hospital_group5.pdf | here]]
[[File:team5_2019_snapshot2.png | frame | center | Figure 19: Hospital Challenge - snapshot at cabinet 2]]


==Software architecture==
= Final Code =
The main components of our architecture are the world model, the planning, the mapping, the measurement and actuation parts. The world model contains all the data of the environment and data like the position of the robot. The mapping module ensures the world model is updated and a map is provided. The planning ensures a path is planned from the current position of the robot towards a certain goal. The measurement part feeds data and some basic information into the word model and the actuation ensures the robot actually moves. These components will be worked out in more detail below.


===World model===
All of the software developed for our work in this course can be found on the Team 5 Gitlab Repository. The following are a few snippets of the code form each module:
The world model contains all the data of the environment and the robot like its position. From the world model information is sent towards the other blocks, which process them and provide new information to the world map.
====State machine====


===Measurement===
=== Measurement ===
For the measurements the laser range finder present on the PICO is used. This data is received in an array, where the indices contribute to some angle and the value of the second column present the distance to the nearest point in that direction. For calculating the angle the range of the PICO is determined during the configuration state. Once this is done, the total angle is divided by the angle increment of the PICO to determine the length of the array and multiplied again to know the angle. From the angle and the radial distance a set of Cartesian coordinates can be calculated which are used in the localization and planning parts.
[https://gitlab.tue.nl/EMC2019/group5/snippets/164 measure()]


===Planning===
[https://gitlab.tue.nl/EMC2019/group5/snippets/163 alignedToWall()]
To be able to plan a path the A* algorithm is used.


===Mapping===
=== Mapping ===
we create two types of map <br/>
[https://gitlab.tue.nl/EMC2019/group5/snippets/165 Corner Detection]
1.Global map.<br/>
2.Local Map <br/>


====Global Map====
[https://gitlab.tue.nl/EMC2019/group5/snippets/166 Mapping::localise()]
In order to implement the A* path planning algorithm, the given map, which is in the form of a json file, is converted into a binary map. The objects of the map is given based on points with x and y coordinates. The walls and cabinets are described with lines, where the lines are defined by the start point and end point. <br/>
The first step to build the binary map is to find the range of the map. Therefore, <br/>


[https://gitlab.tue.nl/EMC2019/group5/snippets/167 Mapping::makeLocalGridmap()]


This is created using the Json file , which contains the x,y coordinates of the points which make up the wall and cabinates. <br/>
=== Planning ===
Using the x,y coordinates of the points we create the binary map made up of 1's and 0's where 1's represent any sort of obstacle such as walls or cabinates.
[https://gitlab.tue.nl/EMC2019/group5/snippets/168 Planning::goToDestination()]


====Local Map====
=== Actuation ===
This is created from the laser data provided the LRF .<br/>
[https://gitlab.tue.nl/EMC2019/group5/snippets/162 actuate()]
We convert the LRF data to cartesian cordinates which in turn is used to convert it to binary map made up of 1's and 0's.<br/>
This map is used to identify any sorts of unknown structure which can be added to the global map for path planning.<br/>


===Actuation===
=== Additional Code Snippets ===
[https://gitlab.tue.nl/EMC2019/group5/snippets/169 Main Loop]


==Results==
[[File:final_challange.gif]]


==Improvements==
[[File:team5_2019.jpg | center | thumb | 800 px | Team 5 2019 - Winners of the Escape Room Competition]]
During the project the implementation ideas changed a lot. It is advisable to come to an agreement of the final implementation as soon as possible.

Latest revision as of 22:57, 21 June 2019

Welcome to the Wiki Page for Group 5 in the Embedded Motion Control Course (4SC020) 2019!

Group Members

Name TU/e Number
Winston Mendonca 1369237
Muliang Du 1279874
Yi Qin 1328441
Shubham Ghatge 1316982
Robert Rompelberg 0905720
Mayukh Samanta 1327720

Introduction

The star of 4SC020: Pico

The world around us is changing rapidly. New technological possibilities trigger new ways of life and innovations like self driving cars, medical robots, are prime examples of how technology can not only make life easier but also safer. In this course we look at the development embedded software of autonomous robots, with a focus on semantically modelling real world perception into the robot's functionality to make it robust to environmental variations that are common in real world applications.

In this year's edition of the Embedded Motion Control course, we are required to use Pico, a mobile telepresence robot with a fixed range of sensors and actuators, to complete two challenges: the Escape Room Challenge and the Hospital Challenge. Our aim was to develop a software structure that gives Pico basic functionality in a manner that could be easily adapted to both these challenges. The following sections in this page detail out the structure and ideas we used in the development of Pico's software, the strategies designed to tackle the given tasks, and our results from both challenges.

Pico

To aptly mirror the structure and operation of a robot deployed in a real-life environment this course uses the Pico robot, a telepresence robot from Aldebaran Robotics. With a fixed hardware platform to work on, all focus can be turned to the software development for the robot. Pico has the following hardware components:

  • Sensors/Inputs:
  1. Proximity measurement with Laser Range Finder (LRF)
  2. Motion measurement with Wheel encoders (Odometer)
  3. Control Effort Sensor
  4. 170-degree wide-angle camera (not used in this course)
  • Actuators/Outputs:
  1. Holonomic Base - Omni wheels that facilitate 2D translation and rotation
  2. 5" LCD SCreen
  3. Audio Speaker
  • Computer:
  1. Intel i7 Processor
  2. OS: Ubuntu 16.04

Functional Requirements for Pico

A description of the expected functionality of robot is the first step to defining its implementation in software in a structured manner. With the given hardware on Pico we were able to define the following functionality for Pico to be able to sufficiently operate in any environment it is placed in:

Generic Requirements

  1. Pico should be capable of Interpreting (giving real-world meaning) to raw data acquired from its sensors.
  2. Pico should be capable of Mapping its environment and Localising itself within the mapped environment.
  3. Pico should be capable of Planning motion trajectories around its environment.
  4. Pico must adhere to performance and environmental Constraints, such as maximum velocities, maximum idle time while operating, restricted regions, avoiding obstacles, etc.
  5. Pico should be capable of Providing Information about its operating state and internal process whenever required through the available interfaces.

In addition to these, the following task-specific requirements were defined for Pico (descriptions of the challenges can be found in later sections):

Escape Room Challenge Requirements

  1. Pico should be capable of identifying an exit and leaving the room from any initial position.
  2. Pico should use the quickest strategy to exit the room.
  3. Pico must drive all the way through the exit corridor till the end (past the finish line) to complete the challenge.

Hospital Challenge Requirements

  1. Pico must be able to accept a dynamic set of objectives (cabinets to visit).
  2. When Pico visits a cabinet, it should give a clear sound of which cabinet it is visiting (i.e.,“I have visited the cabinet zero”).
  3. PICO has to make a snapshot of the map once a cabinet is reached.
  4. PICO should be capable of identifying and working around obstacles and closed doorways while planning its trajectory.

Software Architecture

With the knowledge of the available hardware and the operational requirements for the given tasks, software development can take a well structured and modular developmental approach, thus making it feasible to alter designs and add new functionality at later stages of development. Our software architecture can be split into two parts: the World Model which represents the information system of the robot and the Software Functions which covers all the block that use data from the World Model to give Pico its functionality. While in theory it is encouraged to have a definition of the Information Architecture of system before heading into the Functional Architecture, our software started with the development of a primitive World Model which was later expanded alongside the development of the Software Functions.

World Model

Figure 1: Pico's World Model

The World Model represents all the data captured and processed by Pico during its operation, and is designed to serve as Pico's real-world semantic "understanding" of its environment. It is created such that software modules only have access to the data required by their respective functions. The data in the World Model can be classified into two sections:

  • Environmental Data
  1. Raw LRF Data
  2. Interpreted Basic Measurement Information (eg: center, left, right distances; closest and farthest points)
  3. Detected corner points
  4. Detected exits
  5. Processed LRF data in the form of an integer gridmap
  6. Global Map in the form of an integer gridmap
  7. Cabinet Locations
  • Robot Data
  1. Operating state
  2. Localised position
  3. Desired trajectory
  4. Odometer readings and offset data

As seen in Figure 1 (click on image to zoom), all parts of Pico's software functions (explained in the next section) interact with the World Model to access data that is specific to their respective operations. To avoid creating multiple copies of the same values and thus optimize on memory usage, each software module accesses its data using references to the World Model, thus asserting one common data location for the entire system.

Functions

This section describes the part of the software architecture that "gives life" to Pico and enables it to perform tasks according to the set requirements. Our software is modularised into four main sections: Measurement, Mapping, Planning and Actuation. As seen from their titles, each section is meant to cover a specific set of robot functions, similar to the organs in a living organism, which when put together with the World Model provide for a completely functional robot. In comparison with the paradigms stated in the course, this structure can be seen as a slightly modified version of the Perception, Monitoring, Planning and Control activities; the functions of Perception are covered by the Measurement and Mapping modules, and Monitoring and Control is covered within the Actuation module. Regardless of these differences, both structure provide the same end result in terms of robot functionality and in terms of being sufficiently modularised. The following sections describes each one of these sections and their corresponding functions, along with a list of some common shared functions at the end.

Measurement

Figure 2: Measurement Module and World Model

The Measurement module is Pico's "sense organs" division. Here, Pico can read raw data from its available sensors and process some basic information from the acquired data. Figure 2 shows the information interface between the World Model and the Measurement model. The following functions constitute the Measurement Module:

measure()

Reads and processes sensors data into basic measured information

Apart from the standard library functions to read raw data from Pico's LRF and Odometry sensors, the measure() function also interprets and records some primitive information from the obtained LRF data such as the farthest and nearest distances in Pico's current range, the distances at the right, center and left points of the robot, boolean flags indicating whether the right, center or left sectors (sectors are determined by a fixed angular deviation from a given mid point) of Pico's visible range are clear of any obstacles/walls (Figure 3). All these are stored in the World Model to be processed by any other functions that may need this data. Additionally, the measure() function also returns a status check to its parent function, which would indicate whether it was able to successfully acquire data from all sensors, or if not, which sensors failed to deliver any measurements. This would signal Pico to act accordingly in the event of consistent unavailability of data from its sensors. The measure function is the first function to be called in Pico's execution loop.

Figure 3: Pico's Sector Clear Check

sectorClear()

Indicates the presence of obstacles/walls in the vicinity of a given heading angle

This function is used to check whether there are any obstacles in a given direction of the robot. While Pico's path planning module is responsible for determining a path devoid of any obstacles, it cannot be guaranteed that Pico would respond exactly according to the planned path or that obstacles around it would stay static while it navigates around them. In this case the sectorClear() function can be fed with Pico's heading angle and thus be used to determine whether the coast is clear of if Pico needs to operate with caution on the current planned trajectory.

alignedToWall()

Determines the deviation of Pico's current heading with respect to a straight wall on the right, left or front of Pico

The alignedToWall() function measures the deviation of Pico's right, left or center LRF values from an expected parallel wall. This function is mainly used while localising Pico, to ensure Pico is oriented in a specific pre-determined orientation to obtain its position with respect to a given map. The animation in Figure 4 shows how this is used to rotate Pico till it is aligned to wall on its left; the white vertical lines on the right and left of Pico are used as a reference to compute the alignment difference.

Figure 4: Pico aligning itself to a wall on the left

Mapping

Figure 5: Mapping Module and World Model

Mapping of Pico's environment can be handled in two mutually exclusive scenarios: one where no global map is provided and Pico thus needs to understand its surroundings all by itself, and one where Pico has a global map and can compare its sensed data with the information provided on the map. The Mapping module therefore has two primary functions named identify() and localise() which are responsible for giving Pico a clear understanding of its environment and thus help it determine its actions based on this understanding. The Mapping module also includes several other functions that allow Pico to read and interpret provided maps, generate mapped grid spaces out of the provided map and its sensor data to be used by localise() and other path planning functions, and create visualizations on its screen of processed sensor data. As was with the Measurement module, the Mapping module also interacts with the World Model as its data bank as shown in Figure 5.

identify()

Identifies significant points such as corners and exits in Pico's vicinity

This function uses the acquired LRF data and processes it to identify significant features such as corners, and exits. While this operation is mainly used in situations where Pico does not have access to a global map, this function is also utilised to identify Pico's environment at the start of its run time in order to perform an initial "offset localisation" (explained in the Hospital Challenge section) before it can continue localising with the localise() function. The identify function uses a modified averaging comparison technique to smoothen the obtained noisy LRF data and subsequently compare the averaged data with the original LRF sequence to identify corners. This method also helps it distinguish between convex (red circle) and concave corners (blue circle) as seen in the animation in Figure 4. As several adjacent LRF points would satisfy the condition for identifying corners, all identified corner points are then clustered into single corner points by means of comparing their positions within the LRF sequence. Furthermore, by comparing the distance between two convex corners and the LRF values of distances between those two corners, this method can also identify an exit/entry point (magenta circle) within a room.

localise()

Identifies Pico's current location within a given global map

The localise() function uses a minimum difference based cost comparison technique to compare Pico's local map with the global map and thus obtain its position on the global map. This method however relies on an approximate knowledge of Pico's whereabouts on its global map, around which it performs its cost comparison. This approximate position is typically obtained after processing information from the identify() function at Pico's startup or from a combination of Pico's previously localised position, its odometry readings and any error offsets at any stage in execution after the startup. This reliance helps avoid requiring to compare Pico's local map with all possible positions on the global map, thus allowing for a local optimization of possible positions which saves on computation time.

The cost function is computed by assuming the robot to be at a given position on the global map, projecting the LRF points with respect to this position onto the global map and calculating the summation of distances of all LRF points from the closest corresponding point on the global map. The identify() function computes the cost function of several deviations with respect to the approximate location of the robot and thus obtains the position with the least cost as the actual position of the robot on the global map. To further optimize on computation time, the function can also be tuned to project intervals of LRF points onto the global map instead of all available points thus reducing the total number of distance comparisons to be made. A sample of Pico moving around and localising itself is shown in Figure 7.

This method also works in the presence of real-world objects that are not found on the global map, as such points corresponding to obstacles would result in a uniform increase in cost function across all considered position deviations in the optimization process. Additionally, the identify() function evaluates the persistence of these obstacles, and subsequently adds any persistent differences between the local and global map onto the global map which helps in planning paths around closed doors (Figure 8) and also improves the localisation performance as Pico moves through its environment. More results of localisation can be seen in the animations provided in the Hospital Challenge section.

Figure 7: Pico Localising itself within a given map
Figure 8: Pico Localising itself within a map with obstacles

genWeightedMap()

Figure 7: Binary grid map (left), Weighted grid map (right)

Converts the standard binary global grid map into a weighted integer grid map

Our solution to navigate around a pre-mapped environment is implemented through the A* Path Planning algorithm which uses a grid map to plan a trajectory between two points on the given grid. With a given global map that has all significant points and walls defined, generating a binary gridmap is a straightforward process. However, the A* algorithm, which tends to select the quickest path available, would generate path that would tend to stick quite close to the walls. Considering that the cell size of the grid map is far smaller compared to Pico's physical dimensions, this would lead to several clashes between any obstacle avoiding functions and the provided path from the path planner. To avoid this, the global grid map is converted from its binary form into a weighted integer form, where the cells with walls and other objects take the highest weights and cells surrounding these have linearly decreasing weights as you go further away from the objects. This additionally allows the path planner to generate paths that drive Pico away from such objects, even if it starts close to them. Figure 8 shows an example of such a conversion, and Figure 9 shows the difference in paths generated with and without the weighted grid map.

Figure 8: A* Path Planning on Binary grid map vs on Weighted grid map

Planning

Figure 9: Planning Module and World Model

Planning forms the core of Pico's decision making abilities. This module is the main control center of all of Pico's activities, and it governs the way all other modules operate. It comprises one primary function named plan() that essentially operates in the form of a finite state machine. Based on the given task, several operating states are defined, and Pico is made to track its current operations through a state variable. The plan() function uses the information processed by the Measurement and Mapping modules and any previous pieces of information to determine Pico's actions based on the operating state, and delivers this data into the World Model. The most typical actions generated by the plan() function are desired velocity profiles which can be used by the actuation module in the next stage of the operating loop. Figure 9 shows the interaction between the Planning module and the World Model.

Since Pico's operations are dependent on the task it has to perform, Planning is the only module that needs to change to accommodate the differences in functionality requirements between the Escape Room Challenge and the Hospital Challenge. Thus, the states and functions within each state of the planning block are described in the sections specific to each challenge.

Actuation

Figure 10: Actuation Module and World Model

The final module of the software architecture is the Actuation Module. This module is concerned with the physical control and monitoring of Pico based on instructions received from the previous modules through the World Model as shown in Figure 10.

Actuation::actuate()

Governs the actuation of Pico's Holonomic Base using desired velocity profiles and sensing data

This function takes in inputs in the form of desired translational and rotational velocity profiles, and simply actuates Pico's motors based on these values. To allow for smooth motion profiles, the actuate() function also tracks Pico's current velocity and incrementally adjusts it match the desired velocity from the world model. Additionally, the actuate function also employs obstacle avoidance by computing Pico's heading based on the desired velocity vectors and adjusts its actual velocity to either move away or to move slowly if it finds an obstacle in the vicinity of its heading.

Additional Functions and Software Features

The above modules cover the main functionality of Pico to complete the task at hand. These modules are further supplemented by some additional common resources and software features that either aid in the operation of the primary functions or are useful for debugging of the software.

  1. Json to Binary map: This function generates a binary map grid map from the provided global map in JSON format, with room and cabinet walls represented by a 1 and empty spaces represented by 0s.
  2. Performance Variables: As stated in the requirements, Pico must adhere certain performance constraints. These are listed out in the form of Performance structure that contains information such the maximum and minimum permissible velocities, minimum permissible distance, minimum measurable distance, etc.
  3. Data Logging: Through this logging feature, Pico is able to log all important processed information based on its operating state into files that can be analysed for performance later. Each module manages its own separate log, and log messages can also be displayed on a console in real-time while Pico operates.
  4. Module Enable Flags: An additional testing and debugging feature is a set of enable flags that allow the user to temporarily switch off one of the modules. This, for example, is useful in instances where the user may want to manually control Pico for testing purposes while it continues to measure and map its environment.

Escape Room Challenge

The first competition in this course was the Hospital Challenge. The main objective of this challenge is for Pico to be able to locate the exit of a room whose dimensions are not known before hand (no map provided) from any starting position within the room and subsequently exit the room as quickly as possible. A detailed description of this challenge can be found here.

Challenge Strategy

Figure 11: Escape Room State Diagram

Two strategies were experimented with to complete this challenge: following the walls till and exit is located, and searching for the exit and driving towards it. While the former sounded easier to implement at the initial stages of discussion (as seen in our Initial Design Document), it was clear that the latter was the faster strategy of the two. In the end a combination of the two strategies was implemented to serve as a fail safe mechanism in case Pico was not able to find an exit within a fixed number of attempts. This section describes the implementation of these two strategies in the Planning Module, while all other modules remain the same.

Primary Strategy: Scan For Exit

In this strategy, Pico makes use of the corner and exit detection features in it Mapping Module to be able to determine whether or not it sees an exit in its current field of view. If an exit is currently not visible, Pico starts to rotate through a fixed angle, while still looking for an exit. If at the end of this rotation maneuver Pico is still unable to find the exit, it is probably in a corner of the room where a clear view of the exit is obscured from its sensing range. In this case, Pico translates forward for a fixed length and continues to look for an exit during this motion too. At the end of this motion if an exit is still not found, Pico repeats the rotate and translate for a maximum of four tries, after which it indicates that it is unable to find the exit through this strategy and subsequently switches to the Wall Following strategy. In tests with different exit positions and robot initial positions, it was found that Pico never needed to switch to the Wall Following startegy and was always able to find the exit within three iterations of rotating and translating. On encountering an exit during any of these previously mentioned operations, Pico switches its operational state to face and drive towards the exit. Upon reaching the exit, Pico then orients itself to be parallel to the exit corridor and goes on to perform a corridor/wall follow maneuver till it has left the corridor. All these operations are described in the state diagram shown in Figure 11.

Secondary Strategy: Wall Following

In this backup strategy, Pico uses the walls of the room as a guide to eventually reach the exit. Pico would begin by locating the nearest wall to itself, driving towards it and aligning itself to be parallel to the wall. After this it runs in a continuous loop of driving parallel to the wall until it detects that it is at a corner (wall ahead of it) or till it detects the exit (large change in distance measured) on the side that it was following the wall. In the event of detecting a corner, it would perform a 90 degree turn in the direction of the corner, align itself to the wall and continue following it as before. If it detects an exit it would instead turn towards the exit and carry out a corridor/wall follow maneuver till it has left the corridor.

End Result and Future Improvements

In the first attempt at the Escape Room Competition (Figure 12), Pico performed as expected by looking around for the exit, driving forward on not seeing it initially, eventually detecting the exit and heading towards it. However it seemed to drift sideways while arriving at and while subsequently entering the exit corridor. This caused it to slightly bump into the exit wall at the start of the exit, but it eventually corrected itself and crossed the exit corridor. To temporarily avoid this bumping its maximum translational velocity was lowered for the second attempt, wherein it exhibited the same sideways drifting behaviour, but was able to stop short of bumping into the wall. With this we were able to complete the challenge in the quickest time of about 40 seconds and thus rank first in this competition!

On inspecting the code later, a logical bug in the actuation module was found to be responsible for the sideways drift. This was fixed to achieve an output as seen in the simulation in Figure 13.

Another small aspect that could have further lowered the time Pico took to complete the challenge was the pauses between each operational state. In order to observe Pico's actions and comprehend them while they were taking place, a one second delay was added to Pico's operation every time it switched form one state to another. Eliminating this delay could have lowered the overall operational time by 6 seconds.

Figure 12: Escape Room Challenge first attempt
Figure 13: Escape Room Simulation

Hospital Challenge

The Hospital Competition is the second part of this course. In this competition, Pico must navigate around a fixed hospital environment with help from a provided global map, with the aim of visiting specific sites (cabinets) while avoiding any static or dynamic obstacles and closed doors. A detailed description of the Hospital Challenge can be found here.

Challenge Strategy

Our solution to the Hospital Challenge used a relatively smaller strategy as compared to the Escape Room Challenge. Pico begins operation by accepting a list of cabinet numbers that it should visit. Before it can attempt to move anywhere, it must first localise itself within the provided global map. To do this, Pico makes use of the known features of the room such as the exit and the room corners detected by the identify() function of the Mapping Module. It starts by aligning itself parallel to the left wall of the room and then comparing the position of the detected exit with their corresponding positions on the global map to obtain its starting position. From here on, Pico gets the first/next cabinet in the previously acquired list of cabinets, plans a trajectory from its current position till the cabinet using the A* Path Planning algorithm and goes on to follow this trajectory, while updating the global map with any differences from its sensed local map. On reaching a cabinet, Pico performs a fixed routine of orienting itself to face the cabinet, taking a snapshot of its current LRF data and finally announcing its arrival at that cabinet via its speaker. It then proceeds to get the next available cabinet on the list in the same manner as above and continues this process till all the cabinets in its list have been visited. Figure 13 shows the state diagram of the Planning module to carry out the above series of operations.

Figure 13: Hospital Challenge State Diagram

End Results and Future Improvements

Unfortunately, the Hospital Challenge competition did not go as expected (Figures 14 and 15). In the first attempt, Pico drove towards the exit of the room, but deviated from its path midway and collided with the left wall of the room. In the second attempt, Pico had a similar result wherein it immediately drove towards the left wall. On examining the log files from both runs and attempting to run Pico again once the competition was over, we were able to find that an error in the localisation made Pico believe that it was instead facing the right side of the room consequently leading it to believe that the entire map was rotated by 90 degrees in the counterclockwise direction, thus resulting in the drive towards the left wall. This was later fixed and the results of the same are shown in the simulations in Figures 16 and 17.

Figure 14: Hospital Challenge Competition - First Attempt
Figure 15: Hospital Challenge Competition - Second Attempt
Figure 16: Hospital Challenge Competition - Simulation 1
Figure 17: Hospital Challenge Competition - Simulation 2
Figure 18: Hospital Challenge - snapshot at cabinet 0
Figure 19: Hospital Challenge - snapshot at cabinet 2

Final Code

All of the software developed for our work in this course can be found on the Team 5 Gitlab Repository. The following are a few snippets of the code form each module:

Measurement

measure()

alignedToWall()

Mapping

Corner Detection

Mapping::localise()

Mapping::makeLocalGridmap()

Planning

Planning::goToDestination()

Actuation

actuate()

Additional Code Snippets

Main Loop


Team 5 2019 - Winners of the Escape Room Competition