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
174 lines
6.7 KiB
Markdown
174 lines
6.7 KiB
Markdown
<!-- WEHUB_ZH_README -->
|
||
> [!NOTE]
|
||
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
|
||
> [English](./README.en.md) · [原始项目](https://github.com/mpmath/mpmath) · [上游 README](https://github.com/mpmath/mpmath/blob/HEAD/README.rst)
|
||
> 原作者、版权与许可证归属以原始项目及本仓库 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 文件）下发布的自由软件。
|
||
|
||
0. 历史与致谢
|
||
----------------------
|
||
|
||
以下人员（以及其他人员）为 mpmath 贡献了重要补丁或新功能：
|
||
|
||
* Pearu Peterson <pearu.peterson@gmail.com>
|
||
* Mario Pernici <mario.pernici@mi.infn.it>
|
||
* Ondrej Certik <ondrej@certik.cz>
|
||
* Vinzent Steinberg <vinzent.steinberg@gmail.com>
|
||
* Nimish Telang <ntelang@gmail.com>
|
||
* Mike Taschuk <mtaschuk@ece.ualberta.ca>
|
||
* Case Van Horsen <casevh@gmail.com>
|
||
* Jorn Baayen <jorn.baayen@gmail.com>
|
||
* Chris Smith <smichr@gmail.com>
|
||
* Juan Arias de Reyna <arias@us.es>
|
||
* Ioannis Tziakos <itziakos@gmail.com>
|
||
* Aaron Meurer <asmeurer@gmail.com>
|
||
* Stefan Krastanov <krastanov.stefan@gmail.com>
|
||
* Ken Allen <ken.allen@sbcglobal.net>
|
||
* Timo Hartmann <thartmann15@gmail.com>
|
||
* Sergey B Kirpichev <skirpichev@gmail.com>
|
||
* Kris Kuhlman <kristopher.kuhlman@gmail.com>
|
||
* Paul Masson <paulmasson@analyticphysics.com>
|
||
* Michael Kagalenko <michael.kagalenko@gmail.com>
|
||
* Jonathan Warner <warnerjon12@gmail.com>
|
||
* Max Gaukler <max.gaukler@fau.de>
|
||
* Guillermo Navas-Palencia <g.navas.palencia@gmail.com>
|
||
* Nike Dattani <nike@hpqc.org>
|
||
* Tim Peters <tim.peters@gmail.com>
|
||
* Javier Garcia <javier.garcia.tw@hotmail.com>
|
||
|
||
还有许多其他人通过报告 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 & Stegun；Gradshteyn & 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 获取
|
||
|
||
更详细的说明请参阅主文档。
|
||
|
||
2. 文档
|
||
----------------
|
||
|
||
reStructuredText 格式的文档包含在源码包附带的 docs 目录中。这些文件
|
||
可直接阅读，但也可使用
|
||
`Sphinx <https://www.sphinx-doc.org/>`_ 编译为更美观的 HTML。
|
||
|
||
最新文档也以 HTML 格式提供：
|
||
|
||
https://mpmath.readthedocs.io/
|
||
|
||
3. 运行测试
|
||
----------------
|
||
|
||
mpmath/tests/ 中的单元测试可使用 `pytest
|
||
<https://pytest.org/>`_ 运行，详见主文档。
|
||
|
||
你也可以查看 demo 目录中的演示脚本。
|
||
|
||
master 分支会在 Github Actions 上自动测试。
|
||
|
||
4. 已知问题
|
||
-----------------
|
||
|
||
Mpmath 仍在持续开发中。主要问题包括：
|
||
|
||
* 当参数极大或非常接近奇点时，某些函数可能返回不正确的值。
|
||
|
||
* 有向舍入（directed rounding）适用于算术运算。对于其他运算，它是启发式实现的，其结果在最后一位（unit in the last place）上可能偏差一两个单位（即使其他方面是准确的）。
|
||
|
||
* 部分 IEEE 754 特性不可用。无穷大（Inifinities）和 NaN 仅得到部分支持，没有有符号零（signed zero）；非规格化舍入（denormal rounding）完全不可用。
|
||
|
||
* 切换精度和舍入方式的接口尚未定稿。
|
||
当前方法不是线程安全的（threadsafe）。
|
||
|
||
5. 帮助与 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>`_。
|