Workflomics Benchmarker is a library designed for executing and benchmarking workflows provided in Common Workflow Language (CWL) within the Workflomics ecosystem.
Detailed user documentation is available on readthedocs.
| Description | Badge |
|---|---|
| Packages and Releases |   |
| DOI |  |
| License |  |
| OS Support |    |
| Requirements |  |
- Python 3.10 or higher
- Docker or Singularity
NOTE: Workflomics Benchmarker is will run on Linux and macOS without any additional configuration. However, Windows users need to use Windows Subsystem for Linux (WSL) to run the tool (see MS Windows users).
Optional:
- Poetry (if you want to build the package from source)
Create a virtual environment and install the required packages:
python3 -m venv workflomics-env # Create a virtual environment named 'env' in the current directory
source workflomics-env/bin/activate # Activate environment before installing `workflomics`Install workflomics-benchmarker from PyPI using pip:
pip install workflomics-benchmarker Alternatively, you clone the repository and can install it using Poetry by running:
git clone https://github.com/workflomics/workflomics-benchmarker.git
cd workflomics-benchmarker
poetry install - Install Windows Subsystem for Linux 2 and Docker Desktop.
- Install Debian from the Microsoft Store.
- Set Debian as your default WSL 2 distro:
wsl --set-default debian. - Return to the Docker Desktop, choose
Settings→Resources→WSL Integrationand under "Enable integration with additional distros" select "Debian", - Reboot if you have not yet already.
- Launch Debian and follow the Linux instructions above (
pip install workflomics-benchmarker)
Network problems from within WSL2? Try these instructions <https://github.com/microsoft/WSL/issues/4731#issuecomment-702176954>_ followed by wsl --shutdown.
Ensure Docker or Singularity is running before executing workflows. Here are the commands for both services:
workflomics benchmark tests/data/ Or directly with Python:
python src/benchmarker/workflomics.py benchmark tests/data/ The results will be saved in the ./tests/data directory.
To use Singularity, ensure it's installed and append the --singularity flag:
python src/benchmarker/workflomics.py benchmark tests/data/ --singularity Run the following command to execute tests:
poetry run pytest This command runs a workflow and benchmarks it, assuming Docker is operational. Results are stored in the ./tests/data directory.