ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

my​PDDL

by Pold87 ST2/ST3

PDDL Syntax Highlighting, Snippets, Domain Visualization and more for Sublime Text

Details

  • 2018.04.13.17.28.48
  • github.​com
  • github.​com
  • 2 years ago
  • 1 hour ago
  • 6 years ago

Installs

  • Total 1K
  • Win 485
  • OS X 374
  • Linux 590
Nov 21 Nov 20 Nov 19 Nov 18 Nov 17 Nov 16 Nov 15 Nov 14 Nov 13 Nov 12 Nov 11 Nov 10 Nov 9 Nov 8 Nov 7 Nov 6 Nov 5 Nov 4 Nov 3 Nov 2 Nov 1 Oct 31 Oct 30 Oct 29 Oct 28 Oct 27 Oct 26 Oct 25 Oct 24 Oct 23 Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7
Windows 1 0 0 0 0 0 0 0 0 0 0 1 0 1 1 0 0 0 0 0 0 0 1 2 2 1 0 0 2 3 0 1 1 0 0 2 0 0 2 0 0 0 1 0 0 1
OS X 0 1 0 1 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1 0 1 2 0 0 0 0 0 0 0 0 1 0 1 0 0 0 2 1 0 0
Linux 0 1 1 0 1 0 0 2 0 1 1 0 0 0 0 0 0 0 0 0 0 1 1 0 1 0 0 2 5 1 0 1 0 1 0 3 1 0 0 0 0 1 1 0 0 1

Readme

Source
raw.​githubusercontent.​com

myPDDL - A Modular Knowledge Engineering Tool for PDDL

Join the chat at
https://gitter.im/Pold87/myPDDL

Download accompanying paper:

Planning in the Wild: Modeling Tools for PDDL. The final publication is available at Springer via http://dx.doi.org/10.1007/978-3-319-11206-0_27.

myPDDL is a highly customizable and extensible modular system, designed for supporting knowledge engineers in the process of writing, analyzing and expanding PDDL files and thereby promoting the collaboration between knowledge engineers and the use of PDDL in real-world applications. It consists of the following integral parts:

  • myPDDL-new: Create a myPDDL project folder structure with PDDL domain and problem skeletons.
  • myPDDL-syntax: A context-aware syntax highlighting feature.
  • myPDDL-snippet: Code snippets (templates), which can be inserted in myPDDL files.
  • myPDDL-distance: Automated distance calculation for PDDL locations, specified in a problem file.
  • myPDDL-diagram: A type diagram generator for analyzing the structure of myPDDL type hierarchies.
  • myPDDL-IDE: An integrated development environment for the use of myPDDL in Sublime Text.

Supported file types

  • .pddl

Installation

Requirements: - Graphviz (command line tool dot) - Java - …

Simply place this repository into your Sublime text packages folder (Preferences -> Browse Packages…). You have three possibilities to do so: - Via Sublime Text Package Control (search for myPDDL) (RECOMMENDED!) - git clone https://github.com/Pold87/myPDDL.git myPDDL - Download the ZIP and unzip it to your packages folder.

IMPORTANT

You have to take a few more steps to enjoy all functionalities of myPDDL. I assume you are using Linux:

  1. Go to the Sublime Text Packages folder (Preferences -> Browse Packages …) and change to the myPDDL folder.
  2. Ensure that the file myPDDL (inside the folder myPDDL) is executable (type chmod a+x myPDDL in your shell).
  3. Place the file myPDDL somewhere on your $PATH (e.g. ~/bin) or add the folder myPDDL to your $PATH (e.g. add export PATH=$PATH:~/.config/sublime-text-2/Packages/myPDDL to your .bashrc).

  4. Open the file myPDDL in a text editor and customize it: While most options are for advanced users can should set the variable “path” to match the corresponding myPDDL folder. The default is probably right for you: “~/.config/sublime-text-2/Packages/myPDDL”.

  5. Enjoy (in Sublime Text):

    1. Create new projects - open the command palette (ctrl+shift+p) and choose myPDDL-new. Specify the name for the project and press enter -> A new project structure with templates will be generated in your PDDL project directory (the project directory defaults to ~/Documents/myPDDL but you can choose a different folder by setting “pddl_project_folder”: “~/Documents/myPDDL/”. You should also customize the command for running Sublime Text (normally one of subl, sublime, sublime-text) “sublime_shell_cmd”: “subl”).
    2. Switch to PDDL syntax highlighting: View -> Syntax -> PDDL
    3. Use snippets: type domain and press tab -> a domain skeleton appears (you can find all snippets below)
    4. Display a PDDL type diagram: open the command palette (ctrl+shift+p and choose myPDDL-diagram)
    5. Calculate distances between PDDL predicates in a problem file specified by a predicate 'location' (you can choose a different name for this predicate in the myPDDL (NOT myPDDL.py) file in your $PATH).

Customization

You can customize almost anything. Use a different image viewer by changing the variable “viewer” in the myPDDL file on your $PATH or customize the templates for the domain files of myPDDL-new (in the folder templates).

Usage

You can also use myPDDL via a command-interface (type myPDDL in a shell to see further information).

Use Snippets

This package contains some often used PDDL constructs. Try one of the following, to see how they work:

  • template: domain, problem
  • types: t1, t2, t3, etc.
  • predicates: p1, p2, p3, etc.
  • functions: f1, f2, f3, etc.
  • action: action, durative-action

Examples

Create PDDL Projects (myPDDL-new)

Within the project folder, the domain file domain.pddl and the problem file p01.pddl (within the folder problems/) initially contain corresponding PDDL skeletons which can also be also customized. Additionally the project name is used as the domain name within the files domain.pddl and p01.pddl.

Syntax Highlighting (myPDDL-syntax)

alt
 text

A deliberately erroneous domain. Constructs not specified by PDDL are not highlighted.

Type Diagram Generation (myPDDL-diagram)

alt
 text

Automatically generated type diagram of the Hacker World

Every time myPDDL-diagram is invoked, the names of the saved files are extended by an ascending revision number. Thus, one cannot only identify associated PDDL and diagram files, but also use this feature for basic revision control.

Distance Calculation (myPDDL-distance)

Before using the calculator the problem file looks like this (p01.pddl):

(:init ...
       (location gary 4 2)
       (location pizza 2 3))

After the application, the distances have been added in a new file (p01-location.pddl):

(:init ...
       (location gary 4 2)
       (location pizza 2 3)
       (distance gary gary 0.0)
       (distance gary pizza 2.2361)
       (distance pizza gary 2.2361)
       (distance pizza pizza 0.0))

Volker Strobel - volker.strobel87@gmail.com - 2014