olam 1.0.0__tar.gz

olam-1.0.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Leonardo Lamanna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

olam-1.0.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: olam
+Version: 1.0.0
+Summary: Online Learning of Action Models (OLAM).
+Maintainer-email: Leonardo Lamanna <llamanna@fbk.eu>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/LamannaLeonardo/OLAM
+Project-URL: Documentation, https://github.com/LamannaLeonardo/OLAM
+Project-URL: Repository, https://github.com/LamannaLeonardo/OLAM
+Project-URL: Bug Tracker, https://github.com/LamannaLeonardo/OLAM/issues
+Keywords: action model learning,domain model learning,action model acquisition
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: unified-planning==1.3.0
+Requires-Dist: up-fast-downward==0.5.2
+Requires-Dist: clingo==5.8.0
+Requires-Dist: amlgym==1.0.7
+Requires-Dist: ruff
+Requires-Dist: pytest
+Requires-Dist: pandas
+Requires-Dist: gymnasium
+Dynamic: license-file
+
+# Online Learning of Action Models for PDDL Planning
+<div style="display: flex; gap: 10px;">
+   
+  <a href="https://opensource.org/licenses/MIT" target="_blank">
+    <img src="https://img.shields.io/badge/License-MIT-green.svg" height="20"/></a>
+    
+  <a href="https://pypi.python.org/pypi/olam" target="_blank">
+    <img src="https://badge.fury.io/py/olam.svg" height="20"/></a>
+    
+[//]: # (  <a href="https://amlgym.readthedocs.io/en/latest/" target="_blank">)
+
+[//]: # (    <img src="https://readthedocs.org/projects/amlgym/badge/?version=latest" height="20"/></a>)
+
+</div>
+
+This repository contains the *refactored* code of the 
+Online Learning of Action Models (OLAM) algorithm presented at IJCAI 2021, 
+for details about the method please see 
+the [paper](https://www.ijcai.org/proceedings/2021/0566.pdf). The previous code used 
+for the paper experiments is available at this 
+[link](https://github.com/LamannaLeonardo/OLAM/tree/ijcai-2021).
+
+
+## Example Usage
+```python
+import unified_planning
+from unified_planning.io import PDDLReader
+from unified_planning.shortcuts import SequentialSimulator
+from amlgym.util.util import empty_domain
+from olam.OLAM import OLAM
+
+# Disable printing of planning engine credits
+unified_planning.shortcuts.get_environment().credits_stream = None
+
+domain_ref_path = "olam/benchmarks/domains/blocksworld.pddl"
+problem_path = "olam/benchmarks/problems/blocksworld/1_p00_blocksworld_gen.pddl"
+empty_domain_path = empty_domain(domain_ref_path) # remove preconditions/effects
+olam = OLAM(empty_domain_path)
+
+sim_problem = PDDLReader().parse_problem(domain_ref_path,
+                                         problem_path)
+simulator = SequentialSimulator(sim_problem)
+learned_domain_str, trajectory = olam.run(simulator, max_steps=100)
+
+print(f"Generated a trajectory with {len(trajectory.observations)} states")
+print(f"Domain learned: {learned_domain_str}")
+```
+
+## Installation for developers
+
+Clone this repository and install in developer mode:
+
+```
+pip install -e .
+```
+
+
+## Citations
+```
+@inproceedings{ijcai2021-566,
+  title     = {Online Learning of Action Models for PDDL Planning},
+  author    = {Lamanna, Leonardo and Saetti, Alessandro and Serafini, Luciano and Gerevini, Alfonso and Traverso, Paolo},
+  booktitle = {Proceedings of the Thirtieth International Joint Conference on
+               Artificial Intelligence, {IJCAI-21}},
+  publisher = {International Joint Conferences on Artificial Intelligence Organization},
+  pages     = {4112--4118},
+  year      = {2021},
+  doi       = {10.24963/ijcai.2021/566},
+}
+```
+
+## License
+This project is licensed under the MIT License - see the [LICENSE](/LICENSE.md) file for details.
+
+## Acknowledgements
+This code has been refactored with the help of [Ejdis Gjinika](https://github.com/ejdisgjinika)

olam-1.0.0/README.md

@@ -0,0 +1,76 @@
+# Online Learning of Action Models for PDDL Planning
+<div style="display: flex; gap: 10px;">
+   
+  <a href="https://opensource.org/licenses/MIT" target="_blank">
+    <img src="https://img.shields.io/badge/License-MIT-green.svg" height="20"/></a>
+    
+  <a href="https://pypi.python.org/pypi/olam" target="_blank">
+    <img src="https://badge.fury.io/py/olam.svg" height="20"/></a>
+    
+[//]: # (  <a href="https://amlgym.readthedocs.io/en/latest/" target="_blank">)
+
+[//]: # (    <img src="https://readthedocs.org/projects/amlgym/badge/?version=latest" height="20"/></a>)
+
+</div>
+
+This repository contains the *refactored* code of the 
+Online Learning of Action Models (OLAM) algorithm presented at IJCAI 2021, 
+for details about the method please see 
+the [paper](https://www.ijcai.org/proceedings/2021/0566.pdf). The previous code used 
+for the paper experiments is available at this 
+[link](https://github.com/LamannaLeonardo/OLAM/tree/ijcai-2021).
+
+
+## Example Usage
+```python
+import unified_planning
+from unified_planning.io import PDDLReader
+from unified_planning.shortcuts import SequentialSimulator
+from amlgym.util.util import empty_domain
+from olam.OLAM import OLAM
+
+# Disable printing of planning engine credits
+unified_planning.shortcuts.get_environment().credits_stream = None
+
+domain_ref_path = "olam/benchmarks/domains/blocksworld.pddl"
+problem_path = "olam/benchmarks/problems/blocksworld/1_p00_blocksworld_gen.pddl"
+empty_domain_path = empty_domain(domain_ref_path) # remove preconditions/effects
+olam = OLAM(empty_domain_path)
+
+sim_problem = PDDLReader().parse_problem(domain_ref_path,
+                                         problem_path)
+simulator = SequentialSimulator(sim_problem)
+learned_domain_str, trajectory = olam.run(simulator, max_steps=100)
+
+print(f"Generated a trajectory with {len(trajectory.observations)} states")
+print(f"Domain learned: {learned_domain_str}")
+```
+
+## Installation for developers
+
+Clone this repository and install in developer mode:
+
+```
+pip install -e .
+```
+
+
+## Citations
+```
+@inproceedings{ijcai2021-566,
+  title     = {Online Learning of Action Models for PDDL Planning},
+  author    = {Lamanna, Leonardo and Saetti, Alessandro and Serafini, Luciano and Gerevini, Alfonso and Traverso, Paolo},
+  booktitle = {Proceedings of the Thirtieth International Joint Conference on
+               Artificial Intelligence, {IJCAI-21}},
+  publisher = {International Joint Conferences on Artificial Intelligence Organization},
+  pages     = {4112--4118},
+  year      = {2021},
+  doi       = {10.24963/ijcai.2021/566},
+}
+```
+
+## License
+This project is licensed under the MIT License - see the [LICENSE](/LICENSE.md) file for details.
+
+## Acknowledgements
+This code has been refactored with the help of [Ejdis Gjinika](https://github.com/ejdisgjinika)