Longbow


NameLongbow JSON
Version 1.5.4 PyPI version JSON
download
home_pageNone
SummaryBiomolecular simulation remote job submission tool.
upload_time2025-08-04 11:21:36
maintainerNone
docs_urlNone
authorNone
requires_python>=3.4
licenseNone
keywords aiida plugin gromacs aiida-gromacs
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![ci](https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml/badge.svg)](https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml)
![PyPI - Version](https://img.shields.io/pypi/v/longbow?logo=pypi&logoColor=white)
![PyPI - Status](https://img.shields.io/pypi/status/longbow?logo=pypi&logoColor=white)
![PyPI - Downloads](https://img.shields.io/pypi/dm/longbow?logo=pypi&logoColor=white)
![Pepy Total Downloads](https://img.shields.io/pepy/dt/longbow?logo=pypi&logoColor=white&color=blue)
[![Coverage Status](https://coveralls.io/repos/github/HECBioSim/Longbow/badge.svg?branch=main)](https://coveralls.io/github/HECBioSim/Longbow?branch=main)
[![Docs - Status](https://readthedocs.org/projects/longbow/badge/?version=latest)](https://longbow.readthedocs.io)

# 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


## Documentation

Documentation for Longbow users can be found here:

https://longbow.readthedocs.io/


## Examples

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

longbow --examples

or

https://www.hecbiosim.ac.uk/file-store/longbow-examples.zip


## 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:

https://github.com/HECBioSim/Longbow/issues


## 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://github.com/HECBioSim/Longbow/actions

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

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "Longbow",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.4",
    "maintainer_email": null,
    "keywords": "aiida, plugin, gromacs, aiida-gromacs",
    "author": null,
    "author_email": "James Gebbie-Rayet <james.gebbie@stfc.ac.uk>",
    "download_url": "https://files.pythonhosted.org/packages/3d/d1/c31ea7d0de052bd7aa6066209630fb4578f191b8c605284b42753dd57e60/longbow-1.5.4.tar.gz",
    "platform": null,
    "description": "[![ci](https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml/badge.svg)](https://github.com/HECBioSim/Longbow/actions/workflows/ci.yaml)\n![PyPI - Version](https://img.shields.io/pypi/v/longbow?logo=pypi&logoColor=white)\n![PyPI - Status](https://img.shields.io/pypi/status/longbow?logo=pypi&logoColor=white)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/longbow?logo=pypi&logoColor=white)\n![Pepy Total Downloads](https://img.shields.io/pepy/dt/longbow?logo=pypi&logoColor=white&color=blue)\n[![Coverage Status](https://coveralls.io/repos/github/HECBioSim/Longbow/badge.svg?branch=main)](https://coveralls.io/github/HECBioSim/Longbow?branch=main)\n[![Docs - Status](https://readthedocs.org/projects/longbow/badge/?version=latest)](https://longbow.readthedocs.io)\n\n# Longbow\n\nLongbow is an automated simulation submission and monitoring tool. Longbow\nis designed to reproduce the look and feel of using software on the users\nlocal computer with the difference that the heavy lifting is done by a\nsupercomputer.\n\nLongbow will automatically generate the necessary submit files and handle all\ninitial file transfer, monitor jobs, transfer files at configurable\nintervals and perform final file transfer and cleanup.\n\nLongbow can be used to launch one-off jobs, generate ensembles of similar jobs\nor even run many different jobs over many different supercomputers.\n\nOut of the box, Longbow is currently supporting the PBS/Torque, LSF, SGE,\nSlurm, SoGE schedulers and ships with application plugins for commonly used\nbio-molecular simulation softwares AMBER, CHARMM, GROMACS, LAMMPS, NAMD.\nLongbow is however highly configurable and will function normally with generic\nsoftware without plugins, however plugins can easily be made to extend Longbow\nto fully support applications and schedulers that do not ship out of the box.\n\nUsing Longbow can be as simple as the following example:\n\nlocal: executable -a arg1 -b arg2 -c arg3\n\nremote: longbow executable -a arg1 -b arg2 -c arg3\n\nLongbow is also available to developers of applications which require support\nfor automating job submission. Longbow is available as a convenient and\nlight-weight python API that can be integrated in a number of different way.\n\n\n## Licensing\n\nLongbow is released under the BSD 3-clause license. A copy of this license is\nprovided when Longbow is downloaded and installed.\n\n\n## Citing\n\nIf you make use of Longbow in your own code or in production simulations that\nresult in publishable output, then please reference our paper:\n\nGebbie-Rayet, J, Shannon, G, Loeffler, H H and Laughton, C A 2016 Longbow: \nA Lightweight Remote Job Submission Tool. Journal of Open Research Software, \n4: e1, DOI: http://dx.doi.org/10.5334/jors.95\n\n\n## Installation\n\nReleases can be installed either via pip or can be installed manually, to\ninstall via pip:\n\npip install longbow\n\n\n## Documentation\n\nDocumentation for Longbow users can be found here:\n\nhttps://longbow.readthedocs.io/\n\n\n## Examples\n\nExample files can be installed either through the Longbow command-line or by\ndownloading from the HECBioSim website manually:\n\nlongbow --examples\n\nor\n\nhttps://www.hecbiosim.ac.uk/file-store/longbow-examples.zip\n\n\n## Support\n\nSupport for any issues arising from using Longbow, whether these are questions,\nto report a bug or to suggest new ideas. You should use the Longbow forums\nhere:\n\nhttps://github.com/HECBioSim/Longbow/issues\n\n\n## Developers\n\nDevelopers that wish to contribute to Longbow are welcome. We do ask that if\nyou wish to contribute to the Longbow base code that you contact us first.\n\nThe following resources are available to developers:\n\nCode repository: https://github.com/hecbiosim/longbow\n\nUnit testing: https://github.com/HECBioSim/Longbow/actions\n\nCode coverage: https://coveralls.io/github/HECBioSim/Longbow\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Biomolecular simulation remote job submission tool.",
    "version": "1.5.4",
    "project_urls": {
        "Source": "https://github.com/HECBioSim/Longbow"
    },
    "split_keywords": [
        "aiida",
        " plugin",
        " gromacs",
        " aiida-gromacs"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cbc4faac1283b93aec1cccb4bc22610985308bb2a768d2c15f8ceafbaca20e6d",
                "md5": "b2f9bfbc07fe37519720d4301f618377",
                "sha256": "699eed262f0f55a478e77bee61a63f88f2cdd10891f79843bee0ffcc4287a413"
            },
            "downloads": -1,
            "filename": "longbow-1.5.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b2f9bfbc07fe37519720d4301f618377",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.4",
            "size": 78469,
            "upload_time": "2025-08-04T11:21:34",
            "upload_time_iso_8601": "2025-08-04T11:21:34.798246Z",
            "url": "https://files.pythonhosted.org/packages/cb/c4/faac1283b93aec1cccb4bc22610985308bb2a768d2c15f8ceafbaca20e6d/longbow-1.5.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "3dd1c31ea7d0de052bd7aa6066209630fb4578f191b8c605284b42753dd57e60",
                "md5": "d4f6ae18480bf9071e7d756f49bbb4c0",
                "sha256": "5c30891e27954d44ff8b6ac2b7b6200e3debbc182ce249cd92d3f1a19a7b3bc8"
            },
            "downloads": -1,
            "filename": "longbow-1.5.4.tar.gz",
            "has_sig": false,
            "md5_digest": "d4f6ae18480bf9071e7d756f49bbb4c0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.4",
            "size": 18882006,
            "upload_time": "2025-08-04T11:21:36",
            "upload_time_iso_8601": "2025-08-04T11:21:36.211090Z",
            "url": "https://files.pythonhosted.org/packages/3d/d1/c31ea7d0de052bd7aa6066209630fb4578f191b8c605284b42753dd57e60/longbow-1.5.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-04 11:21:36",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "HECBioSim",
    "github_project": "Longbow",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "longbow"
}
        
Elapsed time: 0.85470s