MyQueue
MyQueue is a tool for submitting and keeping track of tasks running on a cluster of computers. It uses SLURM, PBS or LSF as a backend and makes handling of tasks easy. It has a command-line interface called mq with a number of sub-commands and a Python interface for managing workflows. Simple to set up: no system administrator or database required.
Quick links:
Documentation: https://myqueue.readthedocs.io/
Chat: https://camd.zulipchat.com/ (#myqueue stream)
Examples
Submit Python script to 32 cores for 2 hours:
$ mq submit script.py -R 32:2h
Submit Python module abc.run in two folders:
$ mq submit abc.run F1/ F2/ -R 16:30m
Check results of tasks in current folder and its sub-folders:
$ mq list # or mq ls id folder name res. age state time error --- ------ --------- ------ ------- ------- ------- ------ 117 ./ script.py 32:2h 5:28:43 TIMEOUT 2:00:03 118 ./F1/ abc.run 16:30m 5:22:16 done 12:12 119 ./F2/ abc.run 16:30m 5:22:16 done 17:50 --- ------ --------- ------ ------- ------- ------- ------ done: 2, TIMEOUT: 1, total: 3
Resubmit with more resources (1 day):
$ mq resubmit -i 117 -R 32:1d
See more examples of use here:
Installation
MyQueue has only one dependency: Python version 3.6 or later.
Install MyQueue from PyPI with pip:
$ python3 -m pip install myqueue --user
Enable bash tab-completion for future terminal sessions like this:
$ mq completion >> ~/.profile
Run the tests:
$ mq test
and report any errors you get on our issue tracker. Now, configure your system as described here.
Release notes
See the release notes for a history of notable changes to MyQueue.
Help, support and feedback
If you need help, want to report a bug or suggest a new feature then you are very welcome to get in touch via MyQueue’s issue tracker or the #myqueue stream on Zulip.
Contributing
We welcome contributions to the code and documentation, preferably as merge-requests. More information here.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file myqueue-20.1.1.tar.gz.
File metadata
- Download URL: myqueue-20.1.1.tar.gz
- Upload date:
- Size: 47.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.1.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b114806786af93b40266d0935c1f9521fa54c17dd76bf4d15769ae6438845d0e
|
|
| MD5 |
3361d743a3e0481092c098beed82ac75
|
|
| BLAKE2b-256 |
828640dd7a666bb16f58474d0dae4f9683a3b3b341e81a2bf0bd837bc5a6a7de
|
File details
Details for the file myqueue-20.1.1-py3-none-any.whl.
File metadata
- Download URL: myqueue-20.1.1-py3-none-any.whl
- Upload date:
- Size: 56.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.1.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b109143a28496ee43478968bb3b034a166cd76820c6e173a79f9581699a8c23
|
|
| MD5 |
4d9bb48137f26870c34bd90052dbaa4e
|
|
| BLAKE2b-256 |
d518b9c3ccd62418459cb9662afbd8c5258835f4b128e7931a032c180488a140
|
