This repo is intended to be a lightweight, multi-agent, gridworld environment. It was originally based on this multigrid environment, but has since been heavily modified and developed beyond the scope of the original environment. Please cite this respository as well as the original repository if you use this environment in any of your projects:
@misc{multigrid,
title = {Tran Research Group Gridworld Environment},
year = {2023},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/Tran-Research-Group/trg-multigrid}},
}
To modify or contribute to this project, install gym-multigrid from source. This repo uses poetry library dependency management. To install the dependencies for this project run:
git clone https://github.com/Tran-Research-Group/gym-multigrid.git
cd gym-multigrid
poetry install
| Attribute | Description |
|---|---|
| Action Space | Discrete(4) |
| Observation Space | np.array of shape grid.width x grid.height |
| Observation Encoding | (OBJECT_IDX, COLOR_IDX, STATE) |
| Reward | (0, 1) |
| Number of Agents | 2 |
| Termination Condition | None |
| Truncation Steps | 50 |
| Creation | gymnasium.make("multigrid-collect-respawn-clustered-v0") |
Agents move around the grid to collect objects. The object respawns in a random location after being collected.
Please see this guide for creating a custom multigrid environment. See CONTRIBUTING.md for our code guidelines if you are interested in adding your environment to this repo.