1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
==============
MPI for Python
==============
.. image:: https://github.com/mpi4py/mpi4py/workflows/ci/badge.svg?branch=master
:target: https://github.com/mpi4py/mpi4py/actions/
.. image:: https://readthedocs.org/projects/mpi4py/badge/?version=latest
:target: https://mpi4py.readthedocs.io/en/latest/
.. image:: https://dev.azure.com/mpi4py/mpi4py/_apis/build/status/ci?branchName=master&label=azure
:target: https://dev.azure.com/mpi4py/mpi4py/_build
.. image:: https://ci.appveyor.com/api/projects/status/whh5xovp217h0f7n?svg=true
:target: https://ci.appveyor.com/project/mpi4py/mpi4py
.. image:: https://circleci.com/gh/mpi4py/mpi4py.svg?style=shield
:target: https://circleci.com/gh/mpi4py/mpi4py
.. image:: https://codecov.io/gh/mpi4py/mpi4py/branch/master/graph/badge.svg
:target: https://codecov.io/gh/mpi4py/mpi4py
.. image:: https://scan.coverity.com/projects/mpi4py-mpi4py/badge.svg
:target: https://scan.coverity.com/projects/mpi4py-mpi4py
| |pypy| |mpi4py| |conda-forge| |anaconda|
| |homebrew| |fedora| |ubuntu| |debian| |archlinux|
.. |pypy| image:: https://img.shields.io/pypi/v/mpi4py?logo=pypi
:target: https://pypi.org/project/mpi4py/
.. |mpi4py| image:: https://img.shields.io/conda/vn/mpi4py/mpi4py?logo=pypi
:target: https://anaconda.org/conda-forge/mpi4py
.. |conda-forge| image:: https://img.shields.io/conda/vn/conda-forge/mpi4py?logo=anaconda
:target: https://anaconda.org/conda-forge/mpi4py
.. |anaconda| image:: https://img.shields.io/conda/vn/anaconda/mpi4py?logo=anaconda
:target: https://anaconda.org/anaconda/mpi4py
.. |homebrew| image:: https://img.shields.io/homebrew/v/mpi4py?logo=homebrew
:target: https://formulae.brew.sh/formula/mpi4py
.. |fedora| image:: https://img.shields.io/fedora/v/mpi4py-common?logo=fedora
:target: https://packages.fedoraproject.org/pkgs/mpi4py/
.. |ubuntu| image:: https://img.shields.io/ubuntu/v/mpi4py/noble?logo=ubuntu
:target: https://packages.ubuntu.com/source/noble/mpi4py
.. |debian| image:: https://img.shields.io/debian/v/mpi4py/stable?logo=debian
:target: https://packages.debian.org/source/stable/mpi4py
.. |archlinux| image:: https://img.shields.io/archlinux/v/extra/x86_64/python-mpi4py?logo=archlinux
:target: https://archlinux.org/packages/extra/x86_64/python-mpi4py/
Overview
--------
This package provides Python bindings for the *Message Passing
Interface* (`MPI <https://www.mpi-forum.org/>`_) standard. It is
implemented on top of the MPI specification and exposes an API which
grounds on the standard MPI-2 C++ bindings.
Prerequisites
-------------
* `Python <https://www.python.org/>`_ 3.6 or above,
or `PyPy <https://www.pypy.org/>`_ 7.2 or above.
* An MPI implementation like `MPICH <https://www.mpich.org/>`_ or
`Open MPI <https://www.open-mpi.org/>`_ built with shared/dynamic
libraries.
Documentation
-------------
* Read the Docs: https://mpi4py.readthedocs.io/
* GitHub Pages: https://mpi4py.github.io/
Support
-------
* Mailing List: mpi4py@googlegroups.com
* Google Groups: https://groups.google.com/g/mpi4py
* GitHub Discussions: https://github.com/mpi4py/mpi4py/discussions
Testsuite
---------
The testsuite is run periodically on
* `GitHub Actions <https://github.com/mpi4py/mpi4py/actions/>`_
* `Read the Docs <https://readthedocs.org/projects/mpi4py/builds/>`_
* `Azure Pipelines <https://dev.azure.com/mpi4py/mpi4py>`_
* `AppVeyor <https://ci.appveyor.com/project/mpi4py/mpi4py>`_
* `Circle CI <https://circleci.com/gh/mpi4py/mpi4py>`_
* `Codecov <https://app.codecov.io/gh/mpi4py/mpi4py>`_
Citation
--------
+ L. Dalcin and Y.-L. L. Fang,
*mpi4py: Status Update After 12 Years of Development*,
Computing in Science & Engineering, 23(4):47-54, 2021.
https://doi.org/10.1109/MCSE.2021.3083216
* M. Rogowski, S. Aseeri, D. Keyes, and L. Dalcin,
*mpi4py.futures: MPI-Based Asynchronous Task Execution for Python*,
IEEE Transactions on Parallel and Distributed Systems, 34(2):611-622, 2023.
https://doi.org/10.1109/TPDS.2022.3225481
|
