readme.md

GraphToPDDL - MitPlan (Generation of PDDL Based on CPGs)

Sections

• Requirements
• Installation
• Documentation
• Execute GraphToPDDL
• Structure Overview
• Python GraphToPDDL environment

Requirements

• Python 3.9.X
• Graphviz (python api library & graphviz package)
  • api
  • Graphviz
• NetworkX (python library)
  • library
  • source
• pydot dependency for NetworkX
  • library
  • source
• pdoc
  • library
  • source

Installation

Graphhviz can be installed from Graphviz

Use the package manager pip to install requirements.

pip install -r requirements.txt

Documentation

• graphviz python api
  • Source
• NetworkX
• pydot
• pdoc
• GraphToPDDL

Build the documentation

Build the documentation using the included script.

./build-docs.sh

The documentation can be found at index.html

Execute GraphToPDDL

More info: See

Arguments

The current implementation required an actionnable graph, a revision operators json file and a patient values json file.

Actionnable Graph

More info: Actionable graph

Revision Operators

More info: Revision operators

Patient Values

More info: Patient values

Docker Container for Optic

More info: Build Docker image

Structure Overview

│ CONSTANT.py
│ └─── All the various constants used
│ DotGraphCreator.py
│ └─── Graphical output class
│ input_output_graph.py
│ └─── Create a graph from a dot structure
│ input_RO.py
│ └─── Revision Operators reader functions
│ problem.pddl
│ └─── PDDL output of the problem (When generated)
│ problem.png
│ └─── Graphical output of the problem (When generated)
│ readme.md
│ └─── This file
│ script.py
│ └─── Main program to lauch GraphToPDDL
│ test.ipynb
│ └─── Jupyter Notebook use for experimentation
│ test-problem.pddl
│ └─── Used by the test case
│ test_problem_file.py
│ └─── PyTest unit test case
│ utils.py
│ └─── Modules used by the automation
│ write_pddl.py
│ └─── Functions used to create and write a PDDL output
│ build-docs.sh
│ └─── Script to build code documentation
│ init.py
│ └─── Module

Python GraphToPDDL environment

Creating Python environment

python -m venv .graphToPDDL

Activating the Python graphToPDDL environment

.\.graphToPDDL\Scripts\activate

Installing requirements

py -m pip install -r requirements.txt

Deactivating the Python graphToPDDL environment

deactivate