Files
wehub-resource-sync 78eaa56d49
test / tests (false, false, 3.13) (push) Blocked by required conditions
test / tests (false, false, 3.14) (push) Blocked by required conditions
test / tests (false, false, 3.14t) (push) Blocked by required conditions
Publish on PyPI / Build distributions (push) Waiting to run
Publish on PyPI / Publish distributions to PyPI (push) Blocked by required conditions
test / frozen-version (push) Waiting to run
test / tests (false, false, 3.10) (push) Blocked by required conditions
test / tests (false, false, 3.11) (push) Blocked by required conditions
test / tests (false, false, 3.12) (push) Blocked by required conditions
test / tests (false, false, 3.15) (push) Blocked by required conditions
test / tests (false, false, 3.15t) (push) Blocked by required conditions
test / tests (true, pypy3.11) (push) Blocked by required conditions
test / linter (push) Failing after 1s
test / coverage (push) Failing after 0s
test / tests (true, 3.x) (push) Blocked by required conditions
test / docs (push) Failing after 0s
docs: make Chinese README the default
2026-07-13 10:23:11 +00:00

6.7 KiB
Raw Permalink Blame History

Note

本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

mpmath

|pypi version| |Build status| |Zenodo Badge|

.. |pypi version| image:: https://img.shields.io/pypi/v/mpmath.svg :target: https://pypi.python.org/pypi/mpmath .. |Build status| image:: https://github.com/mpmath/mpmath/workflows/test/badge.svg :target: https://github.com/mpmath/mpmath/actions?workflow=test .. |Zenodo Badge| image:: https://zenodo.org/badge/2934512.svg :target: https://zenodo.org/badge/latestdoi/2934512

用于任意精度(arbitrary-precision)浮点运算的 Python 库。

网站:https://mpmath.org/ 主要作者:Fredrik Johansson fredrik.johansson@gmail.com

Mpmath 是在 New BSD License(详见 LICENSE 文件)下发布的自由软件。

  1. 历史与致谢

以下人员(以及其他人员)为 mpmath 贡献了重要补丁或新功能:

还有许多其他人通过报告 bug、请求新功能或提出文档改进建议做出了贡献。

有关详细变更日志(包括个人贡献),请参阅 CHANGES 文件。

Fredrik 在 2008 年夏季对 mpmath 的工作由 Google 赞助,作为 Google Summer of Code 计划的一部分。

Fredrik 在 2009 年夏季对 mpmath 的工作由美国数学研究所(American Institute of Mathematics)赞助,并受到美国国家科学基金会(National Science Foundation)第 0757627 号拨款(FRG: L-functions and Modular Forms)的支持。

本材料中表达的任何观点、发现、结论或建议均属于作者,不一定反映赞助方的观点。

还应感谢:

  • GMP 库及其 Python 封装 gmpy 的作者,使 mpmath 在高精度下运行得更快
  • MPFR、pari/gp、MPFUN 及其他任意精度库的作者,其文档对实现 mpmath 中的许多算法很有帮助
  • Wikipedia 贡献者;Abramowitz & StegunGradshteyn & Ryzhik Wolfram Research 提供的 MathWorld 和 Wolfram Functions 网站。 这些是特殊函数实现所使用的主要参考资料。
  • George Brandl 开发了用于构建 mpmath 文档的 Sphinx 文档工具

发布历史:

  • Version 1.4.1 released on March 15, 2026
  • Version 1.4.0 released on February 23, 2026
  • Version 1.3.0 released on March 7, 2023
  • Version 1.2.1 released on February 9, 2021
  • Version 1.2.0 released on February 1, 2021
  • 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
  1. 下载与安装

Mpmath 需要 Python 3.10 或更高版本。已在 CPython 3.10 至 3.15 以及 PyPy 3.11 上完成测试。

mpmath 的最新版本可从 mpmath 网站以及 https://github.com/mpmath/mpmath/releases 下载。

它也应可在 Python Package Index 获取,地址为 https://pypi.python.org/pypi/mpmath

要使用 pip 安装 Mpmath 最新版本,只需运行

pip install mpmath

或从源码树安装

pip install .

最新开发代码可从 https://github.com/mpmath/mpmath 获取

更详细的说明请参阅主文档。

  1. 文档

reStructuredText 格式的文档包含在源码包附带的 docs 目录中。这些文件 可直接阅读,但也可使用 Sphinx <https://www.sphinx-doc.org/>_ 编译为更美观的 HTML。

最新文档也以 HTML 格式提供:

https://mpmath.readthedocs.io/

  1. 运行测试

mpmath/tests/ 中的单元测试可使用 pytest <https://pytest.org/>_ 运行,详见主文档。

你也可以查看 demo 目录中的演示脚本。

master 分支会在 Github Actions 上自动测试。

  1. 已知问题

Mpmath 仍在持续开发中。主要问题包括:

  • 当参数极大或非常接近奇点时,某些函数可能返回不正确的值。

  • 有向舍入(directed rounding)适用于算术运算。对于其他运算,它是启发式实现的,其结果在最后一位(unit in the last place)上可能偏差一两个单位(即使其他方面是准确的)。

  • 部分 IEEE 754 特性不可用。无穷大(Inifinities)和 NaN 仅得到部分支持,没有有符号零(signed zero);非规格化舍入(denormal rounding)完全不可用。

  • 切换精度和舍入方式的接口尚未定稿。 当前方法不是线程安全的(threadsafe)。

  1. 帮助与 bug 报告

一般问题和评论可 sent <mailto:mpmath@googlegroups.com>_ 发送至 mpmath mailinglist <https://groups.google.com/g/mpmath>_。

你也可以向 mpmath 问题跟踪器 https://github.com/mpmath/mpmath/issues 报告 bug 并提交补丁。

另请参阅我们的 contributing guidelines <https://github.com/mpmath/mpmath/blob/master/.github/CONTRIBUTING.rst>_。