Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Biomolecular simulation remote job submission tool.

Project Description

Longbow

Longbow is an automated simulation submission and monitoring tool. Longbow is designed to reproduce the look and feel of using software on the users local computer with the difference that the heavy lifting is done by a supercomputer.

Longbow will automatically generate the necessary submit files and handle all initial file transfer, monitor jobs, transfer files at configurable intervals and perform final file transfer and cleanup.

Longbow can be used to launch one-off jobs, generate ensembles of similar jobs or even run many different jobs over many different supercomputers.

Out of the box, Longbow is currently supporting the PBS/Torque, LSF, SGE, Slurm, SoGE schedulers and ships with application plugins for commonly used bio-molecular simulation softwares AMBER, CHARMM, GROMACS, LAMMPS, NAMD. Longbow is however highly configurable and will function normally with generic software without plugins, however plugins can easily be made to extend Longbow to fully support applications and schedulers that do not ship out of the box.

Using Longbow can be as simple as the following example:

local: executable -a arg1 -b arg2 -c arg3

remote: longbow executable -a arg1 -b arg2 -c arg3

Longbow is also available to developers of applications which require support for automating job submission. Longbow is available as a convenient and light-weight python API that can be integrated in a number of different way.

Licensing

Longbow is released under the BSD 3-clause license. A copy of this license is provided when Longbow is downloaded and installed.

Citing

If you make use of Longbow in your own code or in production simulations that result in publishable output, then please reference our paper:

Gebbie-Rayet, J, Shannon, G, Loeffler, H H and Laughton, C A 2016 Longbow: A Lightweight Remote Job Submission Tool. Journal of Open Research Software, 4: e1, DOI: http://dx.doi.org/10.5334/jors.95

Installation

Releases can be installed either via pip or can be installed manually, to install via pip:

pip install longbow

or to install manually (see docs) Longbow can be downloaded here:

http://www.hecbiosim.ac.uk/longbow

and then extract and run the setup.py script to install.

Documentation

Documentation for Longbow users can be found here:

http://www.hecbiosim.ac.uk/longbow-docs

Documentation for developers interested in integrating Longbow into other software can be found here:

http://www.hecbiosim.ac.uk/longbow-devdocs

Examples

Example files can be installed either through the Longbow command-line or by downloading from the HECBioSim website manually:

longbow –examples

http://www.hecbiosim.ac.uk/longbow-examples

Support

Support for any issues arising from using Longbow, whether these are questions, to report a bug or to suggest new ideas. You should use the Longbow forums here:

http://www.hecbiosim.ac.uk/longbow-support

Developers

Developers that wish to contribute to Longbow are welcome. We do ask that if you wish to contribute to the Longbow base code that you contact us first.

The following resources are available to developers:

Code repository: https://github.com/hecbiosim/longbow

Unit testing: https://travis-ci.org/HECBioSim/Longbow

Code coverage: https://coveralls.io/github/HECBioSim/Longbow

Code quality: https://landscape.io/github/HECBioSim/Longbow

Release History

Release History

This version
History Node

1.5.0

History Node

1.4.0

History Node

1.3.2

History Node

1.3.1

History Node

1.3.0

History Node

1.2.1

History Node

1.2.0

History Node

1.1.6

History Node

1.1.5

History Node

1.01.004

History Node

1.01.003

History Node

1.01.001

History Node

1.01.000

History Node

1.00.002

History Node

1.00.001

History Node

1.0.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Longbow-1.5.0.tar.gz (40.2 kB) Copy SHA256 Checksum SHA256 Source Jul 7, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting