Skip to content

mastrogiorgis/vPlanSim

Repository files navigation

vPlanSim

An Open Source Graphical Interface for the Visualisation and Simulation of AI Systems

Requirements

Python3.7 +

VTK8.2 +

PyQt5 +

Use GPU dedicated graphics when running the tool to reduce memory usage

Features of vPlanSim

The user defines the 3D geometry of the scene by adjusting the external and internal walls.

The tool offers several viewing angles and viewing helper functions such as the axis and origin of the 3D visual space, a continuous grid annotating the ground, the coordinates of the walls and the floor within the walls.

The user can delete the entire scene or specific blocks from the walls and can also add obstacles on the floor. Also, the geometry can be adjusted using the following menu to undo/redo wall creation, obstacles insertion or block deletion.

The planning menu holds the generation of PDDL based on a particular domain and using the above geometry. The user can select the coordinates of goals, entries and elements, name the problem, then generate and preview the PDDL problem file.

Finally, the user can visually simulate step-by-step the plan (after solving the PDDL problem).

Guide for new domains

Users can create their own generated PDDL problems by modifying the two given examples (sokoban.py and derived_drone.py). The generatePDDLproblem should be modified to reflect the new domain.

Then define the parameters in the example problem:

into the python script:

Examples

Sokoban domain

Using domain found in https://github.com/AI-Planning/classical-domains/tree/master/classical/sokoban-opt08-strips (p01.pddl)

Required files to run the demo can be found under domain folder

Drone domain

Using a bespoke drone domain

Required files to run the demo can be found under domain folder

Citation

Please cite our work if you use vPlanSim

@inproceedings{f285037a2054446b8435ef7e4b48c9df,
title = "vPlanSim: An Open Source Graphical Interface for the Visualisation and Simulation of AI Systems",
author = "Jamie Roberts and Georgios Mastorakis and Brad Lazaruk and {Franco Aixela}, Santiago and Adam Stokes and Sara Bernardini",
year = "2021",
month = feb,
day = "16",
language = "English",
booktitle = "The 31st International Conference on Automated Planning and Scheduling (ICAPS 2021)",
}

About

An Open Source Graphical Interface for the Visualisation and Simulation of AI Systems

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published