Lab and Downward Lab
====================
**Lab** is a Python package for evaluating solvers on benchmark sets.
Experiments can run on a single machine or on a computer cluster. The
package also contains code for parsing results and creating reports.
The **Downward Lab** Python package facilitates running experiments for
the `Fast Downward <http://www.fast-downward.org>`_ planning system. It
uses the generic experimentation package **Lab**. Currently, Lab and
Downward Lab are distributed together.
**Code**: https://github.com/aibasel/lab
**Documentation**: https://lab.readthedocs.io
**Cite**: please cite Downward Lab by using
::
@Misc{seipp-et-al-zenodo2017,
author = "Jendrik Seipp and Florian Pommerening and
Silvan Sievers and Malte Helmert",
title = "{Downward} {Lab}",
publisher = "Zenodo",
year = "2017",
howpublished = "\url{https://doi.org/10.5281/zenodo.790461}"
}
Install Lab
-----------
Lab requires Python 3.7+ and Linux (e.g., Ubuntu). We recommend installing
Lab in a `Python virtual environment
<https://docs.python.org/3/tutorial/venv.html>`_. 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 a new directory for your experiments.
mkdir experiments-for-my-paper
cd experiments-for-my-paper
# If PYTHONPATH is set, unset it to obtain a clean environment.
unset PYTHONPATH
# Create and activate a Python virtual environment for Lab.
python3 -m venv --prompt my-paper .venv
source .venv/bin/activate
# Install Lab in the virtual environment.
pip install -U pip wheel
pip install lab # or preferably a specific version with lab==x.y
# Store installed packages and exact versions for reproducibility.
# Ignore pkg-resources package (https://github.com/pypa/pip/issues/4022).
pip freeze | grep -v "pkg-resources" > requirements.txt
Please note that before running an experiment script you need to
activate the virtual environment with::
source .venv/bin/activate
We recommend clearing the ``PYTHONPATH`` variable before activating the
virtual environment.
Raw data
{
"_id": null,
"home_page": "https://github.com/aibasel/lab",
"name": "lab",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "benchmarks cluster grid",
"author": "Jendrik Seipp",
"author_email": "jendrikseipp@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/5a/95/9537795651d68c4b16285fde52bd176ee038a3dccb5f0e16afe212e52ca3/lab-8.1.tar.gz",
"platform": null,
"description": "Lab and Downward Lab\n====================\n\n**Lab** is a Python package for evaluating solvers on benchmark sets.\nExperiments can run on a single machine or on a computer cluster. The\npackage also contains code for parsing results and creating reports.\n\nThe **Downward Lab** Python package facilitates running experiments for\nthe `Fast Downward <http://www.fast-downward.org>`_ planning system. It\nuses the generic experimentation package **Lab**. Currently, Lab and\nDownward Lab are distributed together.\n\n**Code**: https://github.com/aibasel/lab\n\n**Documentation**: https://lab.readthedocs.io\n\n**Cite**: please cite Downward Lab by using\n\n::\n\n @Misc{seipp-et-al-zenodo2017,\n author = \"Jendrik Seipp and Florian Pommerening and\n Silvan Sievers and Malte Helmert\",\n title = \"{Downward} {Lab}\",\n publisher = \"Zenodo\",\n year = \"2017\",\n howpublished = \"\\url{https://doi.org/10.5281/zenodo.790461}\"\n }\n\n\nInstall Lab\n-----------\n\nLab requires Python 3.7+ and Linux (e.g., Ubuntu). We recommend installing\nLab in a `Python virtual environment\n<https://docs.python.org/3/tutorial/venv.html>`_. This has the advantage\nthat there are no modifications to the system-wide configuration, and that\nyou can create multiple environments with different Lab versions (e.g.,\nfor different papers) without conflicts::\n\n # Install required packages, including virtualenv.\n sudo apt install python3 python3-venv\n\n # Create a new directory for your experiments.\n mkdir experiments-for-my-paper\n cd experiments-for-my-paper\n\n # If PYTHONPATH is set, unset it to obtain a clean environment.\n unset PYTHONPATH\n\n # Create and activate a Python virtual environment for Lab.\n python3 -m venv --prompt my-paper .venv\n source .venv/bin/activate\n\n # Install Lab in the virtual environment.\n pip install -U pip wheel\n pip install lab # or preferably a specific version with lab==x.y\n\n # Store installed packages and exact versions for reproducibility.\n # Ignore pkg-resources package (https://github.com/pypa/pip/issues/4022).\n pip freeze | grep -v \"pkg-resources\" > requirements.txt\n\nPlease note that before running an experiment script you need to\nactivate the virtual environment with::\n\n source .venv/bin/activate\n\nWe recommend clearing the ``PYTHONPATH`` variable before activating the\nvirtual environment.\n",
"bugtrack_url": null,
"license": "GPL3+",
"summary": "Benchmark your code",
"version": "8.1",
"project_urls": {
"Homepage": "https://github.com/aibasel/lab"
},
"split_keywords": [
"benchmarks",
"cluster",
"grid"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c0c688552518e6cefdb10bb66d5406caa5464bb08d5a839b9207a6f1d74a5097",
"md5": "af0acb9d794be40f1dc69b336a10ee50",
"sha256": "1b2dd006b9ec899039c88e3e749f366abf23d6cfb86fe916a2c84ac81096010d"
},
"downloads": -1,
"filename": "lab-8.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "af0acb9d794be40f1dc69b336a10ee50",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 99366,
"upload_time": "2024-02-28T07:29:48",
"upload_time_iso_8601": "2024-02-28T07:29:48.906644Z",
"url": "https://files.pythonhosted.org/packages/c0/c6/88552518e6cefdb10bb66d5406caa5464bb08d5a839b9207a6f1d74a5097/lab-8.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5a959537795651d68c4b16285fde52bd176ee038a3dccb5f0e16afe212e52ca3",
"md5": "40acbeca07dd2dd27dce6d6b7e162e05",
"sha256": "e783f53d1fae03c9a54340b21a49ce91bfdae718e804bf7516f1daa5bbd1f6d1"
},
"downloads": -1,
"filename": "lab-8.1.tar.gz",
"has_sig": false,
"md5_digest": "40acbeca07dd2dd27dce6d6b7e162e05",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 84173,
"upload_time": "2024-02-28T07:29:52",
"upload_time_iso_8601": "2024-02-28T07:29:52.136580Z",
"url": "https://files.pythonhosted.org/packages/5a/95/9537795651d68c4b16285fde52bd176ee038a3dccb5f0e16afe212e52ca3/lab-8.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-28 07:29:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aibasel",
"github_project": "lab",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "lab"
}