| Name | experiment-lab JSON |
| Version |
1.1.8
JSON |
| download |
| home_page | None |
| Summary | A suite of flexible experiments of a variety of different tasks. |
| upload_time | 2024-05-11 16:58:16 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | None |
| keywords |
experiment
suite
lab
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ExperimentLab
A suite of flexible experiments of a variety of different tasks.
## Installation
To create a conda environment for this package use the following commands to do so
```bash
conda create -n experiment_lab python=3.11 -y
conda activate experiment_lab
```
Install the version of pytorch that is compatible with your hardware using the pip or conda command from their [website](https://pytorch.org/get-started/locally/).
To just install the experiment runner framework in one command:
```bash
pip install experiment-lab
```
or
```bash
pip install git+https://github.com/rishavb123/ExperimentLab.git
```
For specific optional dependencies use:
```bash
pip install -e "experiment-lab[{name}]"
```
where `{name}` can be `all`, `ml`, `rl`, `rl-vid`, or `dev`.
To test this installation, try this command (after logging into wandb with `wandb login`):
```bash
run_mc --config-name estimate_pi
```
which should run a monte carlo experiment to estimate the value of pi. See the experiments project in wandb to view the results of this experiment.
To install this package directly from the github reposity use the following commands:
```bash
git clone https://github.com/rishavb123/ExperimentLab.git
cd ExperimentLab
pip install -e .
```
As a test, try running the following script:
```bash
python experiment_lab/experiments/examples/random_waits.py n_runs=20 n_run_method=parallel seed=0
```
For specific optional dependencies use:
```bash
pip install -e ".[{name}]"
```
where `{name}` can be `all`, `ml`, `rl`, `rl-vid`, or `dev`.
### Debugging Tips
#### Recording Videos on RL experiments
The video recording wrapper from the stable baselines library requires a few dependencies that must be installed before it can be used.
1. Install moviepy to your python environment. This can be done using through this package via:
```bash
pip install "experiment_lab[rl-vid]"
```
or directly using,
```bash
pip install moviepy
```
2. Install ffmpeg on your system using the following command (depending on your OS):
- Ubuntu: `sudo apt install ffmpeg`
- Mac: `brew instlal ffmpeg`
- Windows: Follow the instructions [here](https://phoenixnap.com/kb/ffmpeg-windows). Note that I did not write or review this instructions.
3. Make sure to set the location of the ffmpeg binary to the `$IMAGEIO_F
Also, it should be noted that there are some issues with using the multiprocessing vector environment with the video recorder. Ensure that the start_method set in the RL config is "spawn" (which is the default if it is left as None) for best results. On MacOS, see [this](https://stackoverflow.com/questions/50168647/multiprocessing-causes-python-to-crash-and-gives-an-error-may-have-been-in-progr) page for potential problems with using "fork".
Raw data
{
"_id": null,
"home_page": null,
"name": "experiment-lab",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "experiment, suite, lab",
"author": null,
"author_email": "Rishav Bhagat <rishavbhagat.cs@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/2d/05/bddc6e6171a4d55af6c84ef98cd900bd1c142ec30b6fc13bd7b2e7daab29/experiment_lab-1.1.8.tar.gz",
"platform": null,
"description": "# ExperimentLab\n\nA suite of flexible experiments of a variety of different tasks.\n\n## Installation\n\nTo create a conda environment for this package use the following commands to do so\n\n```bash\nconda create -n experiment_lab python=3.11 -y\nconda activate experiment_lab\n```\n\nInstall the version of pytorch that is compatible with your hardware using the pip or conda command from their [website](https://pytorch.org/get-started/locally/).\n\nTo just install the experiment runner framework in one command:\n\n```bash\npip install experiment-lab\n```\n\nor\n\n```bash\npip install git+https://github.com/rishavb123/ExperimentLab.git\n```\n\nFor specific optional dependencies use:\n\n```bash\npip install -e \"experiment-lab[{name}]\"\n```\n\nwhere `{name}` can be `all`, `ml`, `rl`, `rl-vid`, or `dev`.\n\nTo test this installation, try this command (after logging into wandb with `wandb login`):\n\n```bash\nrun_mc --config-name estimate_pi\n```\n\nwhich should run a monte carlo experiment to estimate the value of pi. See the experiments project in wandb to view the results of this experiment.\n\nTo install this package directly from the github reposity use the following commands:\n\n```bash\ngit clone https://github.com/rishavb123/ExperimentLab.git\ncd ExperimentLab\npip install -e .\n```\n\nAs a test, try running the following script:\n\n```bash\npython experiment_lab/experiments/examples/random_waits.py n_runs=20 n_run_method=parallel seed=0\n```\n\nFor specific optional dependencies use:\n\n```bash\npip install -e \".[{name}]\"\n```\n\nwhere `{name}` can be `all`, `ml`, `rl`, `rl-vid`, or `dev`.\n\n### Debugging Tips\n\n#### Recording Videos on RL experiments\n\nThe video recording wrapper from the stable baselines library requires a few dependencies that must be installed before it can be used.\n1. Install moviepy to your python environment. This can be done using through this package via:\n```bash\npip install \"experiment_lab[rl-vid]\"\n```\nor directly using,\n```bash\npip install moviepy\n```\n2. Install ffmpeg on your system using the following command (depending on your OS):\n- Ubuntu: `sudo apt install ffmpeg` \n- Mac: `brew instlal ffmpeg`\n- Windows: Follow the instructions [here](https://phoenixnap.com/kb/ffmpeg-windows). Note that I did not write or review this instructions.\n3. Make sure to set the location of the ffmpeg binary to the `$IMAGEIO_F\n\nAlso, it should be noted that there are some issues with using the multiprocessing vector environment with the video recorder. Ensure that the start_method set in the RL config is \"spawn\" (which is the default if it is left as None) for best results. On MacOS, see [this](https://stackoverflow.com/questions/50168647/multiprocessing-causes-python-to-crash-and-gives-an-error-may-have-been-in-progr) page for potential problems with using \"fork\".\n",
"bugtrack_url": null,
"license": null,
"summary": "A suite of flexible experiments of a variety of different tasks.",
"version": "1.1.8",
"project_urls": {
"Repository": "https://github.com/rishavb123/ExperimentLab"
},
"split_keywords": [
"experiment",
" suite",
" lab"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2fa0d00c9063a62ccce55fd2d11d11853dee2e960d427a66ee503d75211b6119",
"md5": "4ebe204a370240773dff97ad59c560d7",
"sha256": "4510e791da897ba5cec4b90c319088aaa9d7fa02c4c2643614907b26772e9880"
},
"downloads": -1,
"filename": "experiment_lab-1.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4ebe204a370240773dff97ad59c560d7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 40761,
"upload_time": "2024-05-11T16:58:15",
"upload_time_iso_8601": "2024-05-11T16:58:15.100831Z",
"url": "https://files.pythonhosted.org/packages/2f/a0/d00c9063a62ccce55fd2d11d11853dee2e960d427a66ee503d75211b6119/experiment_lab-1.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2d05bddc6e6171a4d55af6c84ef98cd900bd1c142ec30b6fc13bd7b2e7daab29",
"md5": "84e3c281c6f24527e7532e3b341a0cee",
"sha256": "c7aa7f91ebaff6fb0d14244f539ca9c324d0c155d0aaa8112ab8b9eb1b491c45"
},
"downloads": -1,
"filename": "experiment_lab-1.1.8.tar.gz",
"has_sig": false,
"md5_digest": "84e3c281c6f24527e7532e3b341a0cee",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 27889,
"upload_time": "2024-05-11T16:58:16",
"upload_time_iso_8601": "2024-05-11T16:58:16.977517Z",
"url": "https://files.pythonhosted.org/packages/2d/05/bddc6e6171a4d55af6c84ef98cd900bd1c142ec30b6fc13bd7b2e7daab29/experiment_lab-1.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-11 16:58:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rishavb123",
"github_project": "ExperimentLab",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "experiment-lab"
}
