The International Planning Competition is organized in the context of the International Conference on Planning and Scheduling (ICAPS). It empirically evaluates state-of-the-art planning systems on a number of benchmark problems. The goals of the IPC are to promote planning research, highlight challenges in the planning community and provide new and interesting problems as benchmarks for future research.
Since 2004, probabilistic tracks have been part of the IPC under different names (as the International Probabilistic Planning competition or as part of the uncertainty tracks). After 2004, 2006, 2008, 2011 and 2014, the 6th edition of the IPC probabilistic tracks will be held in 2018 and conclude together with ICAPS, in June 2018, in Delft (Netherlands). This time it is organized by Thomas Keller, Scott Sanner and Buser Say.
The deterministic part of IPC is organized by Florian Pommerening and Alvaro Torralba. You can find information about it on ipc2018-classical.bitbucket.io.
The temporal part of IPC is organized by Andrew Coles, Amanda Coles and Moises Martinez. You can find information about it on ipc2018-temporal.bitbucket.io.
To stay up-to-date with the probabilistic tracks, register for the mailing list at https://groups.google.com/forum/#!forum/ipc2018-probabilistic
|Call for domains / expression of interest||July 14, 2017|
|Domain submission deadline||November 30, 2017|
|Demo problems provided||January 17, 2018|
|Expression of interest||February 4, 2018|
|Initial planner submission||April 5, 2018|
|Final planner submission||May 3, 2018|
|Planner abstract submission deadline||May 20, 2018|
|Contest run||May-June, 2018|
|Results announced||June, 2018|
The competition is run in the tracks discrete MDP, continuous MDP and discrete SSP. These tracks focus on the maximization of the expected reward in a discrete or continuous environment (discrete and continuous MDP tracks) or on the minimization of the expected cost to reach a goal (discrete SSP track).
Additionally, there are the novel discrete data-based MDP and continuous data-based MDP tracks, which are versions of the discrete and continuous MDP tracks where a set of sample traces is provided as input rather than a declarative model of the MDP.
Updates: The data-based tracks as well as the discrete SSP track have been cancelled due to a lack of participants. The continuous MDP track has been postponed to 2019. Please contact Scott Sanner if you wish to stay up-to-date.
otherwise, where is the highest average accumulate reward of all participants.
Unlike in IPC 2011 and 2014, competitors do not run their planners themselves. This time, the competitors must submit the source code of their planners, and the organizers will run all planners on the actual competition domains/problems, unknown to the competitors until this time. This way, no fine-tuning of the planners will be possible.
All competitors must submit an abstract (max. 300 words) and a 4-page paper describing their planners. After the competition we encourage the participants to analyze the results of their planner and submit an extended version of their abstract. An important requirement for IPC 2018 competitors is to give the organizers the right to post their paper and the source code of their planners on the official IPC 2018 web site.
There are three important dates for the registration of planners (the deadlines are only important for the discrete tracks; information on deadlines for the continuous MDP track will follow later). This starts with an expression of interest in participation in one or more tracks, which is due February 4, 2018. Please let us know which tracks you are interested in and which input language you are planning to use by sending a mail to firstname.lastname@example.org.
We will use the container technology "Singularity" this year to promote reproducibility and help with compilation issues that have caused problems in the past.
The second step is to register your planner until April 5, 2018. To do so, send an email to email@example.com and let us know if you wish to use a mercurial or a git repository and provide us your bitbucket user names. We will then set up your repository on bitbucket, give you write access and let you know that you can submit your code to the repository. To do so, create one branch per track you want to participate in and name it according to the following list:
We will build all planners once a day and run them on a number of test cases. You can see the results for your planner on the build status page. Test your Singularity file locally (see below) and make sure it passes our automated tests. Please note that the test runs are shorter than the actual competition runs (only 10 iterations instead of 75, and tighter time constraints). The quality of your planner's results is not important at this point, so don't worry if the time limit seems unreasonably small.
A planner is officially registered in a track if it has a green box for that track on the build status page on April 5. You can still make any code changes you want until the final submission deadline on May 3. The build status on the website will update (once a day) when you push new changes the registered branches.
On the final submission deadline on May 3, 2018, we will change your access rights to the repository (or repositories) from write access to read access. If you find any bugs in your code afterwards, you can still fork the repository, fix the bug in the fork and create a pull request for the ipc2018-probabilistic-bot. If we detect any bugs while running your code, we'll let you know and you are also allowed to provide a bug fix. However, only bug fixes will be accepted after the deadline (in particular, we will not accept patches modifying behavior or tuning parameters).
In an effort to increase reproducibility and reduce the effort of running future IPCs, we are using software containers that contain the submitted planner and everything required to run it. We are using Singularity which is an alternative to the well-known Docker. Singularity (in contrast to Docker) is specifically designed for scientific experiments on HPC clusters and has low overhead.
Singularity containers can be viewed as light-weight alternatives to virtual machines that carry a program and all parts of the OS that are necessary to run it. They can be based on any docker image. We created an example submission (Singularity file) that uses the latest Ubuntu as a basis and uses apt-get to install required packages for Prost. It then builds the planner from the files that are next to the Singularity file in the repository.
In the following, we collect and answer frequently asked questions about Singularity. We'll update this section as we get more questions. If you run into problems using Singularity and your problem is not answered here, let us know.
You can install Singularity locally with the following commands (See the Singularity quick start guide for more details):
sudo apt install automake git clone https://github.com/singularityware/singularity.git cd singularity git checkout 2.4 ./autogen.sh ./configure --prefix=/usr/local make sudo make install
To test your Singularity script, please install Singularity (see above) and rddlsim, start rddlsim on the provided demo instances and run the following commands (replacing our demo submission with your repository):
hg clone https://bitbucket.org/ipc2018-probabilistic/demo-submission -r ipc2018-disc-mdp sudo singularity build planner.img demo-submission/Singularity mkdir rundir RUNDIR="$(pwd)/rundir" singularity run -C -H $RUNDIR planner.img recon_demo_inst_mdp__1 2323
The last command also shows how we will call the container during the competition: the parameter "-H" mounts the user's home directory. The parameter "-C" then isolates the container from the rest of the system. Only files written to the mounted directory will be stored permanently. Other created files (for example in /tmp) only persist for the current session and are cleaned up afterwards. When running the container on two instances at the same time, their run directories and sessions will be different, so the two runs cannot interact. The container itself is read-only after its creation.
We will also build your code about once per day and show the results for all planners on the build status page
, but files written there will be deleted after the run and there is a limit on the amount of data you are allowed to write to
. If possible, you should write to your home directory instead. See the question above for how to set up Singularity in this way for testing.
Please contact us if your license does not permit you to package the library into the container.
If we can acquire a license, we will mount the
installation files for the library while building
the container. You can then copy the installation
file into the container in the
step and install it in the
%setupsection will copy the files from the correct branch into the container. In the
%postsection you can then build your planner in the directory /planner.
Bootstrap: dockeris then parsed as
Bootstrap: docker\rand not recognized. Using Linux-style line endings should fix the issue.
To estimate the quality of the computed policies, we execute the policies 75 times and use the average as a metric for the policy's quality. We do so by having your planner interact as a client with the rddlsim server. Detailed information on the protocol that is used to exchange messages between client and server can be found in the file PROTOCOL.txt in the root directory of rddlsim.
Here, we just discuss the changes for IPC 2018:
If you want to test your planner locally, please update to the latest version of rddlsim, recompile and start the server with the command
./run rddl.competition.Server PROBLEM_DIR PORT 75 1 1 1800 ./ 1
where PORT is the port where the client can connect
(by default, this is 2323) and where 1800 is the
allowed time in seconds (this will differ from
instance to instance at IPC 2018).
PROBLEM_DIR is a directory that contains two subdirectories "client" and "server". The "client" directory contains the rddl or pddl files that are sent to your planner as part of the session-init message, and the "server" subdirectory contains matching rddl files that are used by the server. Even though it is still possible to set PROBLEM_DIR to a directory that contains rddl files that are shared by client and server, the tarballs that provide the demo domains and instances all contain separate client and server files.
5 different planners and 7 planner variants participated
in the probabilistic discrete MDP track of IPC 2018. The
source code of all entries is publicly available on bitbucket.
To build the planners, follow the instructions provided
in the FAQ on Singularity.
Note that some planners require the LP solver Gurobi to compile. To
build these planners, acquire a Gurobi license (a free
academic license can be obtained on request), download
the installation files, and move both to the directory
/third-party or change that path in the
Some planners still had bugs in the final runs of the competition, but we encourage competitors to provide bug free versions in the repositories. The revision at the tip of the track's branch (ipc2018-disc-mdp) includes all fixes. We recommend to use this version in all experiments. To see the changes compared to the competition, compare to the tag ipc2018-disc-mdp-competition. If this tag does not exist, no bug fixes were provided.
The eight domains that were used in the competition exist in four different yet equivalent versions:
Based on the Academic Advising IPC 2014 domain by Libby Ferland and Scott Sanner.
In this domain, a student may take courses at a given cost and passes the course with a probability determined by how many of the prerequisites they have successfully passed. A student also receives a penalty at each time step if they have not yet graduated from their program (i.e., completed all required courses). We allow multiple courses to be taken in a semester in some instances. Furthermore, instances differ in the depth of the course dependency DAG, the number of courses, in the cost of taking or retaking a course, in the number of program requirements and in the horizon.
Instances were created such that a policy that ignores all dependencies between courses and takes each course that is a program requirement until it succeeds is better than a policy that does nothing at all. The expected reward of this policy is reported in the instance files.
Chromatic Dice is a variant of the popular dice game Yahtzee (also known as Kniffel). The most important difference is that dice show colored values upon rolling, where the color is independent from the value (e.g., the same die can come up with a blue 6 and a red 6 in two consecutive steps).
The colors allow for some additional categories in a new middle section (one for each color where the sum of all values with a certain color count) and five new categories in the lower section (color versions of three and four of a kind, full house, flush and rainbow).
Like the "upper" section (with categories ones, twos, etc), the new middle section allows for a bonus if the assigned dice meet certain criteria. Since this domain is modelled without integer-valued variables, we cannot encode a condition for the bonus that relies on the sum of all entries in the section (each entry is directly converted into immediate reward which cannot be accessed later). Instead, we take a probabilistic approach, where we keep track of levels that define a probability that the bonus is received. If four or five dice count towards one of the categories, the level increases, and if one or two dice count it is decreased. There is such a level both for the upper and middle section, and both boni are granted (or not) at the end of a run.
Even though the optimal policy in the MDP version of Chromatic Dice that is considered here is not optimal in a version of the original problem (i.e., a game with one or more adversaries), it is close enough to make for a challenging player that is non-trivial to defeat.
Based on the Recon IPC 2011 domain by Tom Walsh.
In the Cooperative Recon domain, the planner controls one or more planetary rovers that examine objects of interest in order to detect life and take a picture of it. As in the Recon domain of IPC 2011, first has to be detected before life is detected, and negative results (one for life, two for water) contaminate the object of interest such that no life can be detected.
The main changes compared to the IPC 2011 Recon domain that have been realized are as follows:
Based on the paper "An Experimental Comparison of Classical, FOND and Probabilistic Planning" by Andreas Hertle, Christian Dornhege, Thomas Keller, Robert Mattmüller, Manuela Ortlieb, and Bernhard Nebel (KI 2014).
The Earth Observation domain models a satellite orbiting Earth. It can take pictures of the landscape below with a camera. The landscape is subdivided into square regions of interest forming a grid wrapped around a cylindrical projection of the Earth surface. The camera focuses on one region at a time and can be shifted north or south. It can take a picture of the region currently in focus. The focus may not be shifted while taking a picture.
Regardless whether the focus is shifted or a picture is taken, the satellite moves eastward around Earth, shifting the focus one grid cell to the east in addition to the other effects in each step. The objective is to take pictures of certain regions in a limited timeframe with as few shifts and as quick as possible. Taking a picture of a region does not guarantee good image quality: the worse the weather, the lower the chance of success.
Over time the visibility in each region can change probabilistically. Changes between similar levels of visibility are more likely than vast changes.
In this domain, the agent manages a manufacturing company that buys goods to use them in the production of other goods. The relationship between the various goods (i.e., which good is required in the production of which other good) takes the form of a directed acyclic graph.
Prizes of goods are determined stochastically by being drawn towards a long-term trend price level with higher probability than moving away from it. The accumulated reward encodes the bank account of the company, i.e., all monetary costs in the domain incur a negative reward while selling goods yields a positive reward.
This domain is modular in the sense that additional options are available in more challenging instances, all of which have in common that the agent has to take an immediate cost for an increased long-term reward. This is already true for the basic concept of buying goods (cost) to produce another good that can be sold for more than the sum of the costs. The following modules (that can be mixed) are available:
Push Your Luck
As the name suggest, Push Your Luck is an artificial version of a "push your luck" game like, for instance, Can't Stop. The main challenge of push your luck games is to determine the optimal moment to stop a repeated stochastic process.
In case of the Push Your Luck domain, the player may roll one or more dice repeatedly. Each rolled face is marked if it hasn't been marked before, and all numbers are unmarked if the player chooses to cash out its reward, if a number is rolled that is already marked or if two rolled dice come up the same face.
The reward the player obtaines upon cashing out corresponds to the product over the value of all marked faces, so it grows exponentially in the number of consecutive die rolls (by default, the value of the face of a 6-sided die equals half the number shown on the die, and the default value of a 10- or 20-sided die is 0.25 plus a quarter of the shown die value. On the other hand, the probability to hit a previously rolled number increases with the number of consecutive die rolls.
Created in collaboration with Iadine Chades, based on the paper "Finding the best management policy to eradicate invasive species from spatial ecological networks with simultaneous actions" by Sam Nicol, Regis Sabbadin, Nathalie Peyrard and Iadine Chades (Journal of Applied Ecology 2017).
Red-finned blue-eye (Scaturiginichthys vermeilipinnis) are a species of fish that are endemic to seven artesian springs in the Edgbaston Reserve in Central Queensland, Australia. The species is critically endangered due to competition by the invasive eastern mosquitofish (Gambusia holbrooki).
The Red-finned Blue-eye domain tackles the problem of eradicating the invasive Gambusia from the habitat of the red-finned blue-eye. The springs are disconnected during the dry season, but get connected in the rain season which allows the Gambusia population to spread from spring to spring and replace the red-finned blue-eyes.
To prevent the extinction of the red-finned blue-eye species, springs with Gambusia population can be poisened (with a high success probability but a penalty for using poison), the Gambusia population can be removed manually (with a lower probability of success and more required effort, but without incurring a penalty) or red-finned blue-eyes can be translocated to a spring without any fish population (which takes so much effort that it can only be done once every few years).
Created in collaboration with Fei Fang and Thanh Hong Nguyen, based on the papers "When Security Games Go Green: Designing Defender Strategies to Prevent Poaching and Illegal Fishing" by Fei Fang, Peter Stone and Milind Tambe (IJCAI 2015) and "Analyzing the Effectiveness of Adversary Modeling in Security Games" by Thanh H. Nguyen, Rong Yang, Amos Azaria, Sarit Kraus and Milind Tambe (AAAI 2013).
The aim of the Wildlife Preserve domain is to protect a wildlife preserve from poachers by sending available ranger to areas. Poachers attack parts of the preserve depending on their preferences and an expectation where rangers will likely show up. This expectation is computed by exploiting the assumption typically taken in Stackelberg Security Games that the defender’s (i.e., rangers) mixed strategy is fully observed by the attacker, and memorized for a predefined number of steps.
In each step, the planner obtains a reward for each area that has not been attacked undefended, and a penalty for each area that has. The challenge is to predict where poachers will attack with high probability and to lure the poachers that observe each step of the rangers into attacking an area where they are caught. A poacher that has been caught does not attack in the next step.
The results were presented at the 28th International Conference on Automated Planning and Scheduling on June 29 in Delft (presentation slides). Per domain scores and the total score of each participating planner in the discrete MDP probabilistic track of IPC 2018 are summarized in the following table:
|Score||Academic Advising||Chromatic Dice||Cooperative Recon||Earth Observation||Manufacturer||Push Your Luck||Red‑finned Blue-eye||Wildlife Preserve||SUM|
Based on these results, we are proudly presenting the following awards for the discrete MDP probabilistic track of IPC 2018: