ASP planning tools for PDDL (local mirror of https://github.com/potassco/plasp for development purposes) https://potassco.org/

Patrick Lühne 7c02b46f7c
Version bump after release 3.1.0.
4 days ago
app Version bump after release 3.1.0. 4 days ago
doc Added PDDL 3.1 feature support documentation. 4 days ago
encodings Excluding derived variables from inertia. 4 days ago
include/plasp Made form of variables within values consistent. 2 weeks ago
instances Moved IPC 2000 Elevator example instances to instance directory. 1 year ago
lib Updated cxxopts to 2.0.0. 5 days ago
src Made form of variables within values consistent. 2 weeks ago
tests Added tests for derived predicate numbering. 5 days ago
.gitattributes Hiding example instances from Linguist. 1 year ago
.gitignore Initial commit. 1 year ago
.gitmodules Updated Catch to 2.0.1. 2 weeks ago
.travis.yml Removed Boost packages from Travis configuration. 3 weeks ago
CHANGELOG.md Version bump after release 3.1.0. 4 days ago
CMakeLists.txt Made option group parsing more uniform. 1 month ago
KNOWN-ISSUES.md Updated documentation to new output format. 4 days ago
LICENSE.md Changed license to Markdown format. 1 year ago
README.md Added PDDL 3.1 feature support documentation. 4 days ago

README.md

plasp GitHub Release Build Status Build Status

ASP planning tools for PDDL

Overview

plasp is a tool collection for planning in answer set programming. plasp 3 supports the input languages PDDL 3.1 (except for advanced features such as durative actions, numerical fluents, and preferences) and SAS (full support of SAS 3), which is used by Fast Downward.

The most notable tool provided by plasp is plasp translate, which translates PDDL descriptions to ASP facts.

Translating PDDL to ASP Facts

PDDL instances are translated to ASP facts as follows:

plasp translate domain.pddl problem.pddl

Alternatively, PDDL instances may first be translated to SAS, the output format of Fast Downward.

./fast-downward.py --translate --build=release64 domain.pddl problem.pddl

This creates a file called output.sas, which may now be translated by plasp as well.

plasp translate output.sas

Solving the Translated Instance

The translated instance can finally be solved with clingo and a meta encoding, for instance, sequential-horizon.lp:

plasp translate domain.pddl problem.pddl > instance.lp
clingo encodings/sequential-horizon.lp -c horizon=10 instance.lp

Translator Output Format

plasp translate provides a uniform output format for SAS and PDDL input problems. See output format for more details.

If you want to write your own meta encoding for plasp translate’s output, this simple example encoding gets you started.

Provided Tools

plasp <command> [<option>...] [<input file>...]

Aside from translating PDDL to ASP facts, plasp provides the following commands:

command description
translate Translate PDDL and SAS to ASP facts
normalize Normalize PDDL to plasp’s custom PDDL format
check-syntax Check the syntax of PDDL specifications
beautify Cleanly format PDDL specifications
help Display help message
version Display version information

plasp help shows a list of all commands provided by plasp. To list all available options of a command, call plasp <command> --help or plasp help <command>.

plasp automatically detects the language (PDDL or SAS) of the input descriptions.

Building

plasp is built with CMake and a C++ compiler. See building for more details.

PDDL Feature Support

plasp supports a subset of PDDL 3.1. See PDDL feature support for a list of supported and unsupported PDDL 3.1 features.

Contributors

Earlier Versions

  • René Knaebel
  • Murat Knecht