SymPy

作者列表请参见 AUTHORS 文件。

此外，还有许多人在 SymPy 邮件列表上提供了帮助，报告了 bug， 参与组织 SymPy 在 Google Summer of Code、Google Highly Open Participation Contest、Google Code-In 中的活动，撰写了有关 SymPy 的文章和博客...

许可证：新的 BSD 许可证（详情请参见 LICENSE 文件）涵盖了 sympy 仓库中的所有文件，除非另有说明。

我们的邮件列表地址是： https://groups.google.com/forum/?fromgroups#!forum/sympy。

我们有一个社区聊天室，位于 Gitter。 欢迎随时向我们提问。我们有一个非常友好且乐于助人的社区。

推荐的安装方法是通过 Anaconda， https://www.anaconda.com/products/distribution

您也可以从以下网址获取最新版本的 SymPy： https://pypi.python.org/pypi/sympy/

要获取 git 版本，请执行：

$ git clone https://github.com/sympy/sympy.git

其他选项（tarballs、debs 等）请参见 https://docs.sympy.org/dev/install.html。

有关安装和构建文档的详细说明，请参见 SymPy 文档风格指南。

所有内容都在：

https://docs.sympy.org/

您可以通过以下方式在 SymPy 的本地副本中生成以上网站的所有内容：

$ cd doc
$ make html

然后文档将在 _build/html 目录下。如果您不想阅读这些内容，这里有一个简单的用法示例：

从该目录启动 Python 并执行：

>>> from sympy import Symbol, cos
>>> x = Symbol('x')
>>> e = 1/cos(x)
>>> print(e.series(x, 0, 10))
1 + x**2/2 + 5*x**4/24 + 61*x**6/720 + 277*x**8/8064 + O(x**10)

SymPy 还带有一个控制台，它是经典 Python 控制台（或 IPython，如可用）的一个简单封装，该控制台加载 SymPy 命名空间并为您执行一些常用命令。

要启动它，请在以下位置执行：

$ bin/isympy

在此目录中，如果 SymPy 未安装，或者直接执行：

$ isympy

如果 SymPy 已安装。

要使用 PyPI 安装 SymPy，请运行以下命令：

$ pip install sympy

要使用 Anaconda 安装 SymPy，请运行以下命令：

$ conda install -c anaconda sympy

要从 GitHub 源代码安装 SymPy، 请先使用 git 克隆 SymPy：

$ git clone https://github.com/sympy/sympy.git

然后，在您克隆的 sympy 仓库中，只需运行：

$ pip install .

有关更多信息，请参见 https://docs.sympy.org/dev/install.html。

我们欢迎任何人的贡献，即使您是开源新手。请阅读我们的 贡献入门指南 和 SymPy 文档风格指南。如果您是新手并正在寻找贡献方式，一个好的起点是查看标记为 易于修复 的问题。

请注意，本项目的所有参与者都应遵守我们的行为准则。参与本项目即表示您同意遵守其条款。请参见 CODE_OF_CONDUCT.md。

要执行所有测试，请在当前目录中运行：

./setup.py test

在当前目录中。

要更精细地运行测试或 doctests，请分别使用 bin/test 或 bin/doctest。主分支由 GitHub Actions 自动测试。

要测试 pull requests，请使用 sympy-bot。

解析器和词法分析器使用 ANTLR4 工具链在 sympy/parsing/latex/_antlr 中生成并已提交到仓库。 目前，大多数用户不需要重新生成这些文件，但如果您打算在此功能上工作，您将需要 antlr4 命令行工具（并且您必须确保它在您的 PATH 中）。 一种获取方法是：

$ conda install -c conda-forge antlr=4.11.1

或者，按照 ANTLR 网站上的说明下载 antlr-4.11.1-complete.jar。然后按照指示导出 CLASSPATH，并创建一个名为 antlr4 的可执行文件，内容如下，而不是创建一个别名：

#!/bin/bash
java -jar /usr/local/lib/antlr-4.11.1-complete.jar "$@"

在对 sympy/parsing/latex/LaTeX.g4 进行更改后，运行：

$ ./setup.py antlr

要清理所有内容（从而获得与仓库中相同的树）：

$ git clean -Xdf

这将清理所有被 .gitignore 忽略的文件，然后：

$ git clean -df

清理所有未跟踪的文件。您可以通过以下方式撤销 git 中的最新更改：

$ git reset --hard

警告：上述命令都将清除您可能已做的更改，并且您将永远丢失它们。在执行任何 这些操作之前，请务必使用 git status、git diff、git clean -Xn 和 git clean -n 检查内容。

我们的问题跟踪器位于 https://github.com/sympy/sympy/issues。请 报告您发现的所有 bug。或者，更好的是，在 GitHub 上 fork 该仓库并创建一个 pull request。我们欢迎所有更改，无论大小，如果您是 git 新手，我们会帮助您完成 pull request（只需在我们的邮件列表或 Gitter Channel 上提问）。如果您还有其他疑问，您可以在 Stack Overflow 上使用 sympy 标签查找答案。

SymPy 由 Ondřej Čertík 于 2005 年启动，他写了一些代码并在 2006 年夏天又写了一些。2007 年 2 月，Fabian Pedregosa 加入了该项目，帮助修复了许多问题， 贡献了文档，并使其重新焕发生机。5 名学生（Mateusz Paprocki、Brian Jorgensen、Jason Gedge、Robert Schwarz 和 Chris Wu）在 2007 年夏天作为 Google Summer of Code 的一部分极大地改进了 SymPy。Pearu Peterson 于 2007 年夏天加入了开发，他通过从头重写核心代码，使 SymPy 的性能提高了 10 到 100 倍，变得更具竞争力。Jurjen N.E. Bos 贡献了 pretty-printing 和其他补丁。Fredrik Johansson 编写了 mpmath 并贡献了大量补丁。

SymPy 自 2007 年以来一直参加 Google Summer of Code。您可以在 https://github.com/sympy/sympy/wiki#google-summer-of-code 上查看 详细信息。每年的改进都使 SymPy 取得了长足的进步。SymPy 的大部分开发都来自于 Google Summer of Code 的学生。

2011 年，Ondřej Čertík 卸任首席开发人员，由 Aaron Meurer（他也是通过 Google Summer of Code 开始的）接任。Ondřej Čertík 仍然活跃在社区中，但由于工作和家庭原因，无法担任首席开发角色。

此后，更多的人加入了开发团队，也有人离开了。您可以在 doc/src/aboutus.rst 文件中找到完整的列表，或者在线查看：

https://docs.sympy.org/dev/aboutus.html#sympy-development-team

git 历史记录可以追溯到 2007 年，当时开发从 svn 迁移到了 hg。 要查看之前的历史记录，请参见 https://github.com/sympy/sympy-old。

您可以使用 git 查看最大的贡献者。命令：

$ git shortlog -ns

将显示每个贡献者，并按提交到项目的次数排序。命令：

$ git shortlog -ns --since="1 year"

将显示最近一年的顶尖贡献者。

在出版物中引用 SymPy，请使用：

Meurer A, Smith CP, Paprocki M, Čertík O, Kirpichev SB, Rocklin M, Kumar A, Ivanov S, Moore JK, Singh S, Rathnayake T, Vig S, Granger BE, Muller RP, Bonazzi F, Gupta H, Vats S, Johansson F, Pedregosa F, Curry MJ, Terrel AR, Roučka Š, Saboo A, Fernando I, Kulal S, Cimrman R, Scopatz A. (2017) SymPy: symbolic computing in Python. PeerJ Computer Science 3:e103 https://doi.org/10.7717/peerj-cs.103

LaTeX 用户可用的 BibTeX 条目是：

@article{10.7717/peerj-cs.103,
 title = {SymPy: symbolic computing in Python},
 author = {Meurer, Aaron and Smith, Christopher P. and Paprocki, Mateusz and \v{C}ert\'{i}k, Ond\v{r}ej and Kirpichev, Sergey B. and Rocklin, Matthew and Kumar, Amit and Ivanov, Sergiu and Moore, Jason K. and Singh, Sartaj and Rathnayake, Thilina and Vig, Sean and Granger, Brian E. and Muller, Richard P. and Bonazzi, Francesco and Gupta, Harsh and Vats, Shivam and Johansson, Fredrik and Pedregosa, Fabian and Curry, Matthew J. and Terrel, Andy R. and Rou\v{c}ka, \v{S}t\v{e}p\'{a}n and Saboo, Ashutosh and Fernando, Isuru and Kulal, Sumith and Cimrman, Robert and Scopatz, Anthony},
 year = 2017,
 month = Jan,
 keywords = {Python, Computer algebra system, Symbolics},
 abstract = {
            SymPy is an open-source computer algebra system written in pure Python. It is built with a focus on extensibility and ease of use, through both interactive and programmatic applications. These characteristics have led SymPy to become a popular symbolic library for the scientific Python ecosystem. This paper presents the architecture of SymPy, a description of its features, and a discussion of select submodules. The supplementary material provides additional examples and further outlines details of the architecture and features of SymPy.
         },
 volume = 3,
 pages = {e103},
 journal = {PeerJ Computer Science},
 issn = {2376-5992},
 url = {https://doi.org/10.7717/peerj-cs.103},
 doi = {10.7717/peerj-cs.103}
}

SymPy 是 BSD 许可的，因此您可以随意使用它，无论是学术用途、商业用途，还是创建分支或衍生产品，只要您在重新分发时复制 BSD 声明（详情请参见 LICENSE 文件）。尽管如此，虽然 SymPy 许可证不要求这样做，但如果方便，请在您的工作中引用 SymPy，并考虑将您的所有更改贡献回来，以便我们能够整合它们，最终让大家受益。