Skip to content

Commit e292a9e

Browse files
authored
Update README.md
1 parent d26378f commit e292a9e

1 file changed

Lines changed: 42 additions & 21 deletions

File tree

README.md

Lines changed: 42 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,54 @@
1+
<div align="center">
2+
3+
<img src="https://svgshare.com/i/TGq.svg" alt="Logo" width="580" height="400">
4+
5+
</div>
6+
7+
<div align="center">
8+
9+
# Python PDDL
10+
11+
✨ A Python wrapper using JuliaPy for the PDDL.jl parser package and implementing its own planners. ✨
12+
13+
</div>
14+
15+
<div align="center">
16+
117
![tests](https://github.com/APLA-Toolbox/PythonPDDL/workflows/tests/badge.svg?branch=main)
218
![build](https://github.com/APLA-Toolbox/PythonPDDL/workflows/build/badge.svg?branch=main)
319
[![codecov](https://codecov.io/gh/APLA-Toolbox/PythonPDDL/branch/main/graph/badge.svg?token=63GHA9JUND)](https://codecov.io/gh/APLA-Toolbox/PythonPDDL)
420
[![CodeFactor](https://www.codefactor.io/repository/github/apla-toolbox/pythonpddl/badge)](https://www.codefactor.io/repository/github/apla-toolbox/pythonpddl)
521
[![Percentage of issues still open](http://isitmaintained.com/badge/open/APLA-Toolbox/PythonPDDL.svg)](http://isitmaintained.com/project/APLA-Toolbox/PythonPDDL "Percentage of issues still open")
622
[![GitHub license](https://img.shields.io/github/license/Apla-Toolbox/PythonPDDL.svg)](https://github.com/Apla-Toolbox/PythonPDDL/blob/master/LICENSE)
723
[![GitHub contributors](https://img.shields.io/github/contributors/Apla-Toolbox/PythonPDDL.svg)](https://GitHub.com/Apla-Toolbox/PythonPDDL/graphs/contributors/)
24+
![PipPerMonths](https://img.shields.io/pypi/dm/jupyddl.svg)
25+
[![Pip version fury.io](https://badge.fury.io/py/jupyddl.svg)](https://pypi.python.org/pypi/jupyddl/)
826

27+
</div>
928

29+
<div align="center">
30+
31+
[Report Bug](https://github.com/APLA-Toolbox/PythonPDDL/issues) · [Request Feature](https://github.com/APLA-Toolbox/PythonPDDL/issues)
1032

11-
# PyJulia PDDL Planner
33+
Loved the project? Please consider [donating](https://www.buymeacoffee.com/dq01aOE) to help it improve!
1234

13-
A Python wrapper using JuliaPy for the PDDL.jl parser package and implementing its own planners.
35+
</div>
1436

15-
## Features
37+
## Features 🌱
1638

17-
- Easy to use API for exploring new states
18-
- Depth First Search
19-
- Breadth First Search
20-
- Dijkstra
21-
- A*
22-
- Goal Count Heuristic
23-
- Delete Relaxation Heuristics (Hmax, Hadd)
24-
- Critical Path Heuristic
39+
- ✨ Built to be expanded: easy to add new planners
40+
- 🖥️ Supported on MacOS and Ubuntu
41+
- 🎌 Built with Julia and Python
42+
- 🔎 Uninformed Planners (DFS, BFS)
43+
- 🧭 Informed Planners (Dijkstra, A*, Greedy Best First)
44+
- 📊 Several general purpose heuristics (Goal Count, Delete Relaxation [Hmax, Hadd], Relaxed Critical Path [H1, H2, H3])
45+
- 🍻 Maintained (Incoming: Critical Path, Landmarks Heuristics...)
2546

26-
## Docker
47+
## Docker 🐋
2748

2849
You can also use the project in a docker container using [docker-pythonpddl](https://github.com/APLA-Toolbox/docker-pythonpddl)
2950

30-
## Dependencies
51+
## Install 💾
3152

3253
- Install Python (3.7.5 is the tested version)
3354

@@ -54,7 +75,7 @@ $ python3 -m pip install --upgrade pip
5475
$ python3 -m pip install jupyddl
5576
```
5677

57-
## IPC Script
78+
## IPC Script ⚔️
5879

5980
- Clone the project :
6081
```shell
@@ -72,7 +93,7 @@ $ python ipc.py "path_to_domain.pddl" "path_to_problem.pddl" "path_to_desired_ou
7293
7394
The output file will show the path with a list of state, the path with a list of action and the metrics proposed by IPC2018.
7495
75-
## Library Usage
96+
## Basic Usage 📑
7697
7798
If using the jupyddl pip package:
7899
@@ -89,7 +110,7 @@ $ git submodule update --init
89110
90111
You should have a `pddl-examples` folder containing PDDL instances.
91112
92-
### [AutomatedPlanner]
113+
### AutomatedPlanner Class 🗺️
93114
94115
```python
95116
from jupyddl import AutomatedPlanner # takes some time because it has to instantiate the Julia interface
@@ -119,7 +140,7 @@ print(apl.get_actions_from_path(path))
119140
[<PyCall.jlwrap flip_row(r1)>, <PyCall.jlwrap flip_row(r3)>, <PyCall.jlwrap flip_column(c2)>]
120141
```
121142
122-
### [Data Analyst]
143+
### DataAnalyst (more like Viz) Class 📈
123144
124145
Make sure you have a pddl-examples folder where you run your environment that contains independent folders with "domain.pddl" and "problem.pddl" files, with those standard names. ( if you didn't generate with git submodule update )
125146
@@ -146,11 +167,11 @@ da.comparative_data_plot(collect_new_data=False) # uses data.json to plot the da
146167
da.comparative_astar_heuristic_plot() # compare results of astar with all available heuristics
147168
```
148169
149-
## Contribute
150-
151-
Open an issue to state clearly the contribution you want to make. Upon aproval send in a PR with the Issue referenced. (Implement Issue #No / Fix Issue #No).
170+
## Contribute 🆘
152171
153-
## Maintainers
172+
Please see `docs/CONTRIBUTING.md` for more details on contributing!
173+
174+
## Maintainers Ⓜ️
154175
155176
- Erwin Lejeune
156177
- Sampreet Sarkar

0 commit comments

Comments
 (0)