ROPEN: Robot Optimal Planner with ENvironmental-learning
1 Department of Electrical and Computer Engineering, Boston University, Boston, USA, Email: firstname.lastname@example.org
2 Faculty of Informatics, Masaryk University, Brno, Czech Republic, Email: email@example.com
3 Division of System Engineering, Boston University, Boston, USA, Email: firstname.lastname@example.org
4 Department of Mechanical Engineering, Boston University, Boston, USA, Email: email@example.com
Robot Optimal Planner with ENvironmental-learning (ROPEN) is a software package for optimal path planning for a robot moving in a partitioned environment with partially unknown, stochastically changing elements. Specifically, we consider an indoor-like environment where the regions in the environment might be separated by doors, which are modeled as Markov Chains. We assume that the robot does not know the door models, on the other hand, it can observe the statuses of the doors (i.e., open or closed) at each time instance. The robot is equipped with a set of motion primitives and modeled as a game transition system. The robot needs to accomplish a persistent surveillance type of mission (e.g., keep monitoring room 1 and room 2 and gathering information, after gathering enough information, go back to base and upload the information, etc). ROPEN runs an online algorithm, which learns the door behavior models and synthesizes control policy for the robot to accomplish the mission. As the door models are incrementally learned, the performance of the robot keeps being improved and it will converge to the optimal one when the door models are fully learned. ROPEN is an implementation of the computational framework proposed in:
 Yushan Chen, Jana Tumova, and Calin Belta. "LTL Robot Motion Control based on Automata Learning of Environmental Dynamics", in IEEE International Conference on Robotics and Automation (ICRA), St. Paul, USA, 2011
 Yushan Chen, Jana Tumova, Alphan Ulusoy, and Calin Belta. "Temporal Logic Robot Control based on Automata Learning of Environmental Dynamics", IJRR
ROPEN contains a mission editor which allows the user to input the robot mission in a more convenient way. ROPEN utilizes the ltl2dstar tool  to generate the Deterministic Rabin Automaton from the LTL formula. In addition, ROPEN includes a simulator (implemented in Objective-C), which can be used to demonstrate runs of the robot.
Ropen Mission Editor:
Our implementation also includes a graphical user interface, which can be used to define different missions with ease.
Fig 1: ROPEN Mission Editor Main Window
A typical use of the ROPEN mission editor is as follows:
- the user defines which propositions are satisfied at each region in the environment
- then, the user defines the robot tasks:
- finally, the user saves the mission specification in a file, which is an input to our Matlab implementation.
Fig 2: ROPEN GUI: Proposition Input Window
Fig 3: ROPEN GUI: Optimizing Task Input Window
Fig 4: ROPEN GUI: Repetitive Tasks Input Window
Fig 5: ROPEN GUI: Additional Requirements Input Window
Fig 6: ROPEN GUI: Request-Response Requirements Input Window
How to define new environment:
We must note that ROPEN mission editor is not limited to the environment that we consider in our paper. The mission editor can easily accommodate different environments as long as the corresponding environment definition files are provided. Locations and contents of these files are as follows:
data/env_def.png: A bird-eye view of the environment.
data/env_def.txt: Definition of each region in the environment. Each line defines a rectangular region in the environment and the format of the lines is: REGION_NAME LOWER_LEFT_X_COORD LOWER_LEFT_Y_COORD UPPER_RIGHT_X_COORD UPPER_RIGHT_Y_COORD.
How to Run:
- Extract the contents of the archive (ropen_mission_editor.zip & Ropen_implementation.zip) to a directory and navigate to that directory in Matlab
- Run the mission editor by typing "main_window" and hitting enter
- Define the mission following the steps defined in the GUI (Please see the sample video for defining the specification that we used in our IJRR paper)
- Click "Export Mission" when done (the output files that can be used by our ROPEN implementation is now generated, these files are phi.ltl: Mission specification in prefix notation, data/phi_infix.ltl: Mission specification in infix notation, and data/region_assignments.txt: Assignment of propositions to regions)
- Define the game transition system and the door models in an M-file
- Run "main.m" script in the ROPEN Implementation (Matlab), which imports the M-files and the text file described above and then executes the algorithms online to generate the control policy.
- The output of the "run_parser.m" script can be used to define the robot trajectories to be run in the Simulator or in the robotic test-bed (currently hardcoded in robot.m).
You can download the source code of ROPEN along with the Xcode simulator if you want to examine and/or modify the code. ROPEN is a Matlab implementation of the algorithms present in , . Make sure that your system meets the requirements given below before attempting to run any of the programs.
- Mac OS X 10.6 or higher,
- For Xcode projects: Xcode 4
The algorithms implemented in Matlab requires:
Matlab 2010a or later
 Yushan Chen, Jana Tumova, and Calin Belta. " LTL Robot Motion Control based on Automata Learning of Environmental Dynamics ", in IEEE International Conference on Robotics and Automation (ICRA), St. Paul, USA, 2011
 Yushan Chen, Jana Tumova, and Calin Belta. " Temporal Logic Robot Control based on Automata Learning of Environmental Dynamics " (Conditionally Accepted by IJRR)