A Python library for arbitrary-precision floating-point arithmetic.
Website: http://mpmath.org/ Main author: Fredrik Johansson <[email protected]>
Mpmath is free software released under the New BSD License (see the LICENSE file for details)
The following people (among others) have contributed major patches or new features to mpmath:
- Pearu Peterson <[email protected]>
- Mario Pernici <[email protected]>
- Ondrej Certik <[email protected]>
- Vinzent Steinberg <[email protected]>
- Nimish Telang <[email protected]>
- Mike Taschuk <[email protected]>
- Case Van Horsen <[email protected]>
- Jorn Baayen <[email protected]>
- Chris Smith <[email protected]>
- Juan Arias de Reyna <[email protected]>
- Ioannis Tziakos <[email protected]>
- Aaron Meurer <[email protected]>
- Stefan Krastanov <[email protected]>
- Ken Allen <[email protected]>
- Timo Hartmann <[email protected]>
- Sergey B Kirpichev <[email protected]>
- Kris Kuhlman <[email protected]>
- Paul Masson <[email protected]>
- Michael Kagalenko <[email protected]>
- Jonathan Warner <[email protected]>
- Max Gaukler <[email protected]>
Numerous other people have contributed by reporting bugs, requesting new features, or suggesting improvements to the documentation.
For a detailed changelog, including individual contributions, see the CHANGES file.
Fredrik's work on mpmath during summer 2008 was sponsored by Google as part of the Google Summer of Code program.
Fredrik's work on mpmath during summer 2009 was sponsored by the American Institute of Mathematics under the support of the National Science Foundation Grant No. 0757627 (FRG: L-functions and Modular Forms).
Any opinions, findings, and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the sponsors.
Credit also goes to:
- The authors of the GMP library and the Python wrapper gmpy, enabling mpmath to become much faster at high precision
- The authors of MPFR, pari/gp, MPFUN, and other arbitrary- precision libraries, whose documentation has been helpful for implementing many of the algorithms in mpmath
- Wikipedia contributors; Abramowitz & Stegun; Gradshteyn & Ryzhik; Wolfram Research for MathWorld and the Wolfram Functions site. These are the main references used for special functions implementations.
- George Brandl for developing the Sphinx documentation tool used to build mpmath's documentation
Release history:
- Version 1.1.0 released on December 11, 2018
- Version 1.0.0 released on September 27, 2017
- Version 0.19 released on June 10, 2014
- Version 0.18 released on December 31, 2013
- Version 0.17 released on February 1, 2011
- Version 0.16 released on September 24, 2010
- Version 0.15 released on June 6, 2010
- Version 0.14 released on February 5, 2010
- Version 0.13 released on August 13, 2009
- Version 0.12 released on June 9, 2009
- Version 0.11 released on January 26, 2009
- Version 0.10 released on October 15, 2008
- Version 0.9 released on August 23, 2008
- Version 0.8 released on April 20, 2008
- Version 0.7 released on March 12, 2008
- Version 0.6 released on January 13, 2008
- Version 0.5 released on November 24, 2007
- Version 0.4 released on November 3, 2007
- Version 0.3 released on October 5, 2007
- Version 0.2 released on October 2, 2007
- Version 0.1 released on September 27, 2007
Mpmath requires Python 2.7 or 3.5 (or later versions). It has been tested with CPython 2.7, 3.5 through 3.7 and for PyPy.
The latest release of mpmath can be downloaded from the mpmath website and from https://github.com/fredrik-johansson/mpmath/releases
It should also be available in the Python Package Index at https://pypi.python.org/pypi/mpmath
To install latest release of Mpmath with pip, simply run
pip install mpmath
Or unpack the mpmath archive and run
python setup.py install
Mpmath can also be installed using
python -m easy_install mpmath
The latest development code is available from https://github.com/fredrik-johansson/mpmath
See the main documentation for more detailed instructions.
The unit tests in mpmath/tests/ can be run via the script runtests.py, but it is recommended to run them with py.test (https://pytest.org/), especially to generate more useful reports in case there are failures.
You may also want to check out the demo scripts in the demo directory.
The master branch is automatically tested by Travis CI.
Documentation in reStructuredText format is available in the doc directory included with the source package. These files are human-readable, but can be compiled to prettier HTML using the build.py script (requires Sphinx, http://sphinx.pocoo.org/).
See setup.txt in the documentation for more information.
The most recent documentation is also available in HTML format:
http://mpmath.org/doc/current/
Mpmath is a work in progress. Major issues include:
- Some functions may return incorrect values when given extremely large arguments or arguments very close to singularities.
- Directed rounding works for arithmetic operations. It is implemented heuristically for other operations, and their results may be off by one or two units in the last place (even if otherwise accurate).
- Some IEEE 754 features are not available. Inifinities and NaN are partially supported; denormal rounding is currently not available at all.
- The interface for switching precision and rounding is not finalized. The current method is not threadsafe.
General questions and comments can be sent to the mpmath mailinglist, [email protected]
You can also report bugs and send patches to the mpmath issue tracker, https://github.com/fredrik-johansson/mpmath/issues