Parsl - Parallel Scripting Library
|licence| |build-status| |docs| |NSF-1550588| |NSF-1550476| |NSF-1550562| |NSF-1550528|
Parsl is a parallel programming library for Python. Parsl augments Python with simple, scalable, and flexible constructs for encoding parallelism. Developers annotate Python functions to specify opportunities for concurrent execution. These annotated functions, called apps, may represent pure Python functions or calls to external applications, whether sequential, multicore (e.g., CPU, GPU, accelerator), or multi-node MPI. Parsl further allows these calls to these apps, called tasks, to be connected by shared input/output data (e.g., Python objects or files) via which Parsl can construct a dynamic dependency graph of tasks.
Parsl includes a flexible and scalable runtime that allows it to efficiently execute Python programs in parallel. Parsl scripts are portable and can be easily moved between different execution resources: from laptops to supercomputers to clouds. When executing a Parsl program, developers first define a simple Python-based configuration that outlines where and how to execute tasks. Parsl supports various target resources including clouds (e.g., Amazon Web Services and Google Cloud), clusters (e.g., using Slurm, Torque/PBS, HTCondor, Cobalt), and container orchestration systems (e.g., Kubernetes). Parsl scripts can scale from a single core on a single computer through to hundreds of thousands of cores across many thousands of nodes on a supercomputer.
Parsl can be used to implement various parallel computing paradigms:
The latest Parsl version available on PyPi is v1.0.0.
.. |licence| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg :target: https://github.com/Parsl/parsl/blob/master/LICENSE :alt: Apache Licence V2.0 .. |build-status| image:: https://travis-ci.com/Parsl/parsl.svg?branch=master :target: https://travis-ci.com/Parsl/parsl :alt: Build status .. |docs| image:: https://readthedocs.org/projects/parsl/badge/?version=stable :target: http://parsl.readthedocs.io/en/stable/?badge=stable :alt: Documentation Status .. |NSF-1550588| image:: https://img.shields.io/badge/NSF-1550588-blue.svg :target: https://nsf.gov/awardsearch/showAward?AWDID=1550588 :alt: NSF award info .. |NSF-1550476| image:: https://img.shields.io/badge/NSF-1550476-blue.svg :target: https://nsf.gov/awardsearch/showAward?AWDID=1550476 :alt: NSF award info .. |NSF-1550562| image:: https://img.shields.io/badge/NSF-1550562-blue.svg :target: https://nsf.gov/awardsearch/showAward?AWDID=1550562 :alt: NSF award info .. |NSF-1550528| image:: https://img.shields.io/badge/NSF-1550528-blue.svg :target: https://nsf.gov/awardsearch/showAward?AWDID=1550528 :alt: NSF award info
Parsl is now available on PyPI, but first make sure you have Python3.6+ ::
$ python3 --version
Install Parsl using pip::
$ pip3 install parsl
To run the Parsl tutorial notebooks you will need to install Jupyter::
$ pip3 install jupyter
Detailed information about setting up Jupyter with Python is available
here_
Note: Parsl uses an opt-in model to collect anonymous usage statistics for reporting and improvement purposes. To understand what stats are collected and enable collection please refer to the
usage tracking guide__
The complete parsl documentation is hosted
here_.
The Parsl tutorial is hosted on live Jupyter notebooks
here_
Download Parsl::
$ git clone https://github.com/Parsl/parsl
Build and Test::
$ make # show all available makefile targets $ make virtualenv # create a virtual environment $ source .venv/bin/activate # activate the virtual environment $ make deps # install python dependencies from test-requirements.txt $ make test # make (all) tests. Run "make configlocaltest" for a faster, smaller test set. $ make clean # remove virtualenv and all test and build artifacts
Install::
$ cd parsl $ python3 setup.py install
Use Parsl!
Parsl is supported in Python 3.6+. Requirements can be found
here. Requirements for running tests can be found
here.
Parsl seeks to foster an open and welcoming environment - Please see the
Parsl Code of Conduct_ for more details.
We welcome contributions from the community. Please see our
contributing guide_.