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": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "benchmarks cluster grid",
"author": "Jendrik Seipp",
"author_email": "jendrikseipp@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d3/56/07005fe06a01656adb42190e8838ecef54ecba8d69f136a22ae6e0a051b6/lab-8.3.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.3",
"project_urls": {
"Homepage": "https://github.com/aibasel/lab"
},
"split_keywords": [
"benchmarks",
"cluster",
"grid"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "39ce187ba057aeda496473b15e8f1f693d5ea62b15a887fee311f04d07370082",
"md5": "718097597c1146c302a40a6c1924b363",
"sha256": "80e2b8ac968cf24a575e597c95ef49f98ec92636130c768550aff31f49f9ee16"
},
"downloads": -1,
"filename": "lab-8.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "718097597c1146c302a40a6c1924b363",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 99442,
"upload_time": "2024-10-22T08:52:57",
"upload_time_iso_8601": "2024-10-22T08:52:57.431168Z",
"url": "https://files.pythonhosted.org/packages/39/ce/187ba057aeda496473b15e8f1f693d5ea62b15a887fee311f04d07370082/lab-8.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d35607005fe06a01656adb42190e8838ecef54ecba8d69f136a22ae6e0a051b6",
"md5": "69e507d4aa520864913858a77a67801c",
"sha256": "0defb95e8ec5e961c3128b1b601099729de10189a46bc499be0fb0ad6febdefb"
},
"downloads": -1,
"filename": "lab-8.3.tar.gz",
"has_sig": false,
"md5_digest": "69e507d4aa520864913858a77a67801c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 84576,
"upload_time": "2024-10-22T08:52:59",
"upload_time_iso_8601": "2024-10-22T08:52:59.686249Z",
"url": "https://files.pythonhosted.org/packages/d3/56/07005fe06a01656adb42190e8838ecef54ecba8d69f136a22ae6e0a051b6/lab-8.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-22 08:52:59",
"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"
}
JSON
