Skip to main content

No project description provided

Project description

# DeepMind Lab2D

A learning environment written in C++ and Lua for the creation of grid worlds.

<div align=”center”> <img src=”docs/screenshot.png” alt=”DeepMind Lab2D screenshot”> </div>

## About

DeepMind Lab2D is a system for the creation of 2D environments for machine learning. The main goals of the system are ease of use and performance: The environments are “grid worlds”, which are defined with a combination of simple text-based maps for the layout of the world, and Lua code for its behaviour. Machine learning agents interact with these environments through one of two APIs, the Python [dm_env](https://github.com/deepmind/dm_env) API or a custom C API (which is also used by [DeepMind Lab](https://github.com/deepmind/lab)). Multiple agents are supported.

If you use DeepMind Lab2D in your research and would like to cite it, we suggest you cite the [accompanying whitepaper](https://arxiv.org/abs/2011.07027).

## Getting started

We provide an example “random” agent in python/random_agent, which performs random actions. This can be used as a base for creating your own agents, and as a simple tool to preview an environment.

`sh bazel run -c opt dmlab2d/random_agent -- --level_name=clean_up `

## External dependencies, prerequisites and porting notes

DeepMind Lab2D currently ships as source code only. It depends on a few external software libraries, which we ship in several different ways:

  • The dm_env, eigen, luajit, lua5.1, lua5.2, luajit, png and zlib libraries are referenced as external Bazel sources, and Bazel BUILD files are provided. The dependent code itself should be fairly portable, but the BUILD rules we ship are specific to Linux on x86. To build on a different platform you will most likely have to edit those BUILD files.

  • A “generic reinforcement learning API” is included in [//third_party/rl_api](third_party/rl_api).

  • Several additional libraries are required but are not shipped in any form; they must be present on your system:

    • Python 3.6 or above with NumPy, PyGame, and packaging.

The build rules are using a few compiler settings that are specific to GCC/Clang. If some flags are not recognized by your compiler (typically those would be specific warning suppressions), you may have to edit those flags.

## Disclaimer

This is not an official Google product.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

dmlab2d-1.0.0_dev.8-cp39-cp39-manylinux_2_35_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.35+ x86-64

Supported by

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