Skip to main content

Benchmark your code

Project description

Lab is a Python package for running code on a large set of benchmarks. Experiments can be conducted on a single machine or on a cluster. The package also contains code for parsing results and creating reports. Currently, Lab and Downward Lab are distributed together.

The Downward Lab Python package facilitates running experiments for the Fast Downward planning system. It uses the generic experimentation package Lab.



Cite: please cite Downward Lab by using

  author =       "Jendrik Seipp and Florian Pommerening and
                  Silvan Sievers and Malte Helmert",
  title =        "{Downward} {Lab}",
  year =         "2017",
  doi =          "10.5281/zenodo.790461",
  url =          "",
  howpublished = "\url{}"

Install Lab

Lab supports Python 2.7 (deprecated) or Python >= 3.5. We recommend installing Lab in a Python virtual environment. This has the advantage that there are no modifications to the system-wide configuration, and that you can create multiple environments with different Lab versions (e.g., for different papers) without conflicts:

# Install required packages, including virtualenv.
sudo apt install python3 python3-venv

# Create and activate a Python 3 virtual environment for Lab.
python3 -m venv lab-venv  # or any other path instead of lab-venv
source lab-venv/bin/activate

# Install Lab in the virtual environment.
pip install lab  # or a specific version with lab==x.y

If you want to install the latest development version and/or need to change Lab itself, you can clone the Lab repo and install it in the virtual environment:

git clone /path/to/lab
pip install --editable /path/to/lab

The --editable flag installs the project in “editable mode”, which makes any changes under /path/to/lab appear immediately in the installed package.

Please note that before running an experiment script you need to activate the virtual environment with:

source lab-venv/bin/activate

We recommend clearing the PYTHONPATH variable before activating the virtual environment.

Project details

Download files

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

Files for lab, version 5.4
Filename, size File type Python version Upload date Hashes
Filename, size lab-5.4-py2.py3-none-any.whl (102.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size lab-5.4.tar.gz (65.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page