Skip to main content

Convert a Numeric PDDL domain into an Gymnasium environment

Project description

Numeric PDDLGym

Python Version Code style: black

A framework for automatically translating Numeric PDDL domains with the Gymnasium API. This allows Numeric PDDL planning problems to be solved using standard RL algorithms (e.g., PPO via RLlib).

The environment converts states, actions, and goals from Numeric PDDL into fixed-size numeric vectors, enabling direct integration with deep RL libraries.

Features

  • Supports Numeric PDDL domains and problems
  • Automatic grounding and vectorization of:
    • Predicates
    • Numeric fluents
    • Goal conditions
  • Compatible with the Gymnasium API
  • Designed for RLlib (Ray) integration
  • Works with standard deep RL algorithms (e.g., PPO)

Usage

How to Run Your First Agent

pyton rl_agents/ppo_pddl_rllib_agent.py

Limitations

  1. Can't encode complex goal conditions.
  2. Agents must be retrained if the problem has a different number of fluents, predicates, or goal conditions.
  3. Currently does not support manual interaction with the environment.
  4. Designed for fixed-structure problems (no variable-sized domains).
  5. Enabling action applicability checking leads to slow runtime in large-scale problems.

Citations

Coming soon

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

numeric_pddl_gym-1.0.1.tar.gz (108.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

numeric_pddl_gym-1.0.1-py3-none-any.whl (17.8 kB view details)

Uploaded Python 3

File details

Details for the file numeric_pddl_gym-1.0.1.tar.gz.

File metadata

  • Download URL: numeric_pddl_gym-1.0.1.tar.gz
  • Upload date:
  • Size: 108.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for numeric_pddl_gym-1.0.1.tar.gz
Algorithm Hash digest
SHA256 5a08e1443149b09b816db731fd3470759ac50bfdf5f69cef226ad1ec0c6e76ea
MD5 af90ea9bb6d2f4c710109c6fdc4e8529
BLAKE2b-256 6ae104ba5580f85cbbdaa8e9c237f3b8f9645bc11e2464f05d6eb7777b1a9d7c

See more details on using hashes here.

File details

Details for the file numeric_pddl_gym-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for numeric_pddl_gym-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c86772b72a964cf0ff96f99917f4827e86d76d4049a24b0bdd3f423216b030e8
MD5 fab931dcaf1c466546d11acca8ca3184
BLAKE2b-256 24243fb71780cff504b1775447d8233c7f944728d28ff4a0b1d79ea3aaeb9fa5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page