免费提供的计算分子生物学工具。
项目描述
Biopython README 文件
Biopython 项目是一个国际性的组织,致力于开发和提供免费 Python 工具,用于计算分子生物学。
本 README 文件主要面向对使用 Biopython 源代码感兴趣的人,无论是从https://biopython.pythonlang.cn 网站发布的版本,还是从我们的 GitHub 代码库https://github.com/biopython/biopython
我们的以用户为中心的文档,包括Biopython 教程和食谱,以及 API 文档,是由我们的代码库使用 Sphinx 生成的。
NEWS 文件总结了 Biopython 每个版本的更改,同时DEPRECATED 文件记录了 API 的中断。
Biopython 软件包是开源软件,以慷慨的条款提供。有关详细信息,请参阅LICENSE 文件。
如果您使用 Biopython 在工作中为科学出版物做出贡献,我们要求您引用我们的应用笔记(如下)或我们网站上列出的模块特定出版物之一
Cock, P.J.A. 等人。Biopython:用于计算分子生物学和生物信息学的免费 Python 工具。生物信息学 2009 年 6 月 1 日;25(11):1422-3 https://doi.org/10.1093/bioinformatics/btp163 pmid:19304878
对有耐心的人
Python 包含包管理系统 "pip",它应该允许您使用一条终端命令安装 Biopython(如果需要,还包括其依赖项 NumPy)、升级或卸载
pip install biopython pip install --upgrade biopython pip uninstall biopython
自 Biopython 1.70 版本以来,我们已在 PyPI 为 Linux、macOS 和 Windows 提供了预编译的二进制 wheel 软件包。这意味着 pip 安装应该很快,不需要编译器。
作为开发人员或潜在的贡献者,您可能希望自行下载、构建和安装 Biopython。以下将进行描述。
Python 要求
我们目前建议使用来自 https://pythonlang.cn 的 Python 3.11
Biopython 目前支持并测试以下 Python 实现
Python 3.9、3.10、3.11 和 3.12 – 请参阅 https://pythonlang.cn
PyPy3.9 v7.3.13 – 或更高版本,请参阅 https://pypy.pythonlang.cn
可选依赖项
Biopython 需要 NumPy(请参阅 https://numpy.com.cn),如果您使用 pip 安装 Biopython,它将自动安装(以下将说明如何自行编译 Biopython)。
根据您计划使用 Biopython 的哪些部分,还有一些其他可选的 Python 依赖项,如果需要,可以稍后安装
ReportLab,请参阅 http://www.reportlab.com/opensource/(可选)此软件包仅在 Bio.Graphics 中使用,因此如果您不需要此功能,则无需安装此软件包。
matplotlib,请参阅 https://matplotlib.net.cn/(可选)Bio.Phylo 使用此软件包绘制系统发育树。
networkx,请参阅 https://networkx.github.io/(可选)和 pygraphviz 或 pydot,请参阅 https://pygraphviz.github.io/ 和 http://code.google.com/p/pydot/(可选)这些软件包用于 Bio.Phylo 中的某些特定功能。
rdflib,请参阅 https://github.com/RDFLib/rdflib(可选)此软件包用于 Bio.Phylo 下的 CDAO 解析器。
psycopg2,请参阅 http://initd.org/psycopg/(可选)或 PyGreSQL(pgdb),请参阅 http://www.pygresql.org/(可选)这些软件包由 BioSQL 用于访问 PostgreSQL 数据库。
MySQL Connector/Python,请参阅 https://dev.mysqlserver.cn/downloads/connector/python/ 此软件包用于通过 BioSQL 访问 MySQL 数据库,并且也支持 PyPy。
mysqlclient,请参阅 https://github.com/PyMySQL/mysqlclient-python(可选)这是 MySQLdb 的一个分支,用于通过 BioSQL 访问 MySQL 数据库。它也支持 PyPy。
此外,还有一些第三方工具可能需要安装,例如独立的 NCBI BLAST、EMBOSS 或 ClustalW。
从源代码安装
我们建议使用 PyPI 上可用的预编译二进制 wheels。
pip install biopython
但是,如果您需要自己编译 Biopython,编译时需要以下内容
Python 包括开发头文件,如 python.h,在 Linux 上通常不默认安装(尝试查找并安装名为 python-dev 或 python-devel 的软件包以及 python 软件包)。
适用于您 Python 版本的适当 C 编译器,例如 Linux 上的 GCC,Windows 上的 MSVC。对于 Mac OS X 或现在称为 macOS 的操作系统,使用 Apple 的命令行工具,可以通过终端命令安装
xcode-select --install
这将提供安装 Apple 的 XCode 开发套件,但不是必需的,并且会占用大量磁盘空间。
然后,下载并解压缩我们的源代码,或者使用 git 获取。现在切换到 Biopython 源代码文件夹,并运行
pip install -e . python setup.py test sudo python setup.py install
如果需要,用您的特定版本替换 python,例如 python3 或 pypy3。
要排除需要互联网连接的测试(这些测试可能需要很长时间),请使用 --offline 选项
python setup.py test --offline
如果您需要进行额外的配置,例如更改安装目录前缀,请键入 python setup.py。
测试
Biopython 包含一系列回归测试,以检查是否一切运行正常。要运行测试,请转到 Biopython 源代码目录,并键入
pip install -e . python setup.py test
如果您想跳过在线测试(在重复测试时推荐这样做),请使用
python setup.py test --offline
如果您看到跳过测试的消息警告,请不要惊慌
test_DocSQL ... skipping. Install MySQLdb if you want to use Bio.DocSQL.
这通常意味着某个软件包未安装。如果它在您不打算使用的模块的测试中出现,您可以忽略它。如果您确实想使用该模块,请安装所需的依赖项并重新运行测试。
某些测试可能因网络问题而失败,这通常是由于偶然或服务中断。如果重新运行测试后问题仍未解决,您可以使用 --offline 选项。
有关更多信息,请参阅 Biopython 教程和食谱。
实验性代码
Biopython 1.61 引入了一个新的警告 Bio.BiopythonExperimentalWarning,它用于标记在稳定的 Biopython 版本中包含的任何实验性代码。这样的“beta”级别代码已准备好进行更广泛的测试,但仍然可能发生变化,并且应仅由早期采用者尝试,以便通过 biopython-dev 邮件列表提供反馈。
我们预计这样的实验性代码将在一到两个版本后达到稳定状态,届时我们将应用有关尝试保持向后兼容性的正常政策。
错误
虽然我们努力提供健壮的软件包,但问题仍然不可避免地会出现。如果您遇到的问题可能是由于Biopython中的错误引起的,它可能已经被识别。如果您还没有使用最新版本,请更新到最新版本并重试。如果问题仍然存在,请搜索我们的错误数据库和邮件列表,看看是否已经有人报告过(并希望已经修复),如果没有,请报告错误。我们无法修复我们不知道的问题;)
问题跟踪器: https://github.com/biopython/biopython/issues
如果您怀疑问题出在解析器中,那么很可能是数据格式已经改变,破坏了解析代码。(BLAST和GenBank文本格式似乎特别脆弱。)因此,Biopython中的解析代码有时更新速度比我们构建Biopython发布版本的速度要快。您可以通过从我们的git仓库中拉取相关文件(例如在Bio.SeqIO或Bio.Blast中的文件)来获取最新的解析器。但是,在这样做时请小心,因为github上的代码不如发布代码经过充分测试,并且可能包含新的依赖项。
在任何错误报告中,请告诉我们
您正在使用的操作系统和硬件(32位或64位)
Python版本
Biopython版本(或git提交/日期)
发生的跟踪回溯(完整的错误消息)
并且最好还提供
导致错误的示例代码
导致问题的数据文件
贡献,错误报告
Biopython由来自世界各地的志愿者运营,他们拥有许多不同的背景。我们一直在寻找有兴趣帮助代码开发、网站管理、编写文档、技术管理以及其他任何需要帮助的人。
如果您想做出贡献,请首先阅读CONTRIBUTING.rst,访问我们的网站https://biopython.pythonlang.cn并加入我们的邮件列表:https://biopython.pythonlang.cn/wiki/Mailing_lists
分发结构
README.rst – 此文件。
NEWS.rst – 发布说明和新闻。
LICENSE.rst – 您可以使用代码做什么。
CONTRIB.rst – 一份(不完整)的名单,列出了以某种方式帮助Biopython的人。
CONTRIBUTING.rst – 关于如何为Biopython做出贡献的概述。
DEPRECATED.rst – 包含关于Biopython中已删除或不再推荐使用的模块的信息,以及如何更新使用这些模块的代码。
MANIFEST.in – 配置要包含在发布中的文件。
setup.py – 安装文件。
Bio/ – 主要代码库。
BioSQL/ – 使用BioSQL数据库的代码。
Doc/ – 文档。
Scripts/ – 各种可能有用的小型独立脚本。
Tests/ – 回归测试代码,包括示例数据文件。
项目详情
下载文件
下载适合您平台的文件。如果您不确定该选择哪个,请了解有关安装包的更多信息。
源分发
构建分发
biopython-1.84.tar.gz 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 60fbe6f996e8a6866a42698c17e552127d99a9aab3259d6249fbaabd0e0cc7b4 |
|
MD5 | 92e639d2f3627759f12f0d000131c24d |
|
BLAKE2b-256 | 9e7feaca4de03f0ee06c9d578d2730fd55858a57cee3620c62d3bc17b5da5447 |
biopython-1.84-cp312-cp312-win_amd64.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | ecff2fcf5da29b600474c0bfcdbbac0f98b25e22fe60a853d0ee798c00f7396c |
|
MD5 | 1a72201772c299dd6a4c4f4e825ea829 |
|
BLAKE2b-256 | d15391d12cc254a804c797afaefec91ede04bc1f7cbd788a04ebbea9e31ee0cf |
biopython-1.84-cp312-cp312-win32.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 52b6098f47d6b90fc8a5e8579b81ee50047e9108f0976e69c891ae0c4817e42d |
|
MD5 | a2fae5789c1d911948c55c63efe5b72c |
|
BLAKE2b-256 | b2126c9d73cbb8c9d19ab4187aaf187f967de6e83738947b7180fdd8bc9211a2 |
biopython-1.84-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 61765b71f84814a1eeb55ab222f43330aa7ad3e55ab91e8b444706149c67a281 |
|
MD5 | 8ce75d3e2935829082c7e6fbe5e6eaab |
|
BLAKE2b-256 | 46377db2bcbb396edba3f767dd89ac23ef5adc35c7a92ef3912c06d1e71469e1 |
哈希值 用于 biopython-1.84-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 89ef3967f5a88b5bb6344bef75ae83386de53fed3966d5c8c334ad885f8db08a |
|
MD5 | 550b01dcfaedb71a3d7f61842d324bde |
|
BLAKE2b-256 | a2b2c7f2a0a151208c634ac1eaa5d6345899659b1d5a700a84ef2e4f2b0e80a9 |
哈希值 用于 biopython-1.84-cp312-cp312-macosx_11_0_arm64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | ee3566f6dc3acf20e238540daf896f0af20cff531521bf41fdf5143f73e209ae |
|
MD5 | c2b8d56c26ac5ef11dcf07097dbdf6da |
|
BLAKE2b-256 | e91a25c7df41987383070987f7b9842f48d3a33b0a78a85c2ca9d93ed810fa2a |
哈希值 用于 biopython-1.84-cp312-cp312-macosx_10_9_x86_64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | ba58a6d76288333c5f178a426116953fa68204bd0cfc401694087dd4f96d0059 |
|
MD5 | 2296549d1a73b86968bf8af049a3ffde |
|
BLAKE2b-256 | f7f6a61af0d2c8c04e446bce4727e8124797132858f518b6d6543d0e7213abed |
哈希值 用于 biopython-1.84-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 894ee7533cca7f5f9769e2595fbe7b0dba5018f39a2170753d101a13e7585ff4 |
|
MD5 | d47b8a1d0c5dc6fc66ba6c86773d02f9 |
|
BLAKE2b-256 | 4c3ccecf231afa65e7194ac06ba981631a9870515bb7a37a15cad1ab414325c4 |
哈希值 用于 biopython-1.84-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 507ac3956f3107e77fee362ecb048dafb5f97cbcf110012d091418430c3227c7 |
|
MD5 | e353d2a757f1c8d049e6af00b43e981b |
|
BLAKE2b-256 | b4d65aae16c1dd91284a40b769926cd69214ddbb986e710f6d44dbe1f6f20c34 |
哈希值 用于 biopython-1.84-cp311-cp311-macosx_11_0_arm64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | c792508988fc3ccf18eaae2a826c9cd97f1c27fb55bb87bdce6a101fee9f5a0c |
|
MD5 | 54fe09ad0c76ed1d522369470456699b |
|
BLAKE2b-256 | 5f49c9ffacca2e26259e28215e0ac599db21adf4070359d2aa9d006f3ecf1051 |
哈希值 用于 biopython-1.84-cp311-cp311-macosx_10_9_x86_64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 2d4ed30aebd96b4aadeb1f04adce92795c696f5bd56d1fd45517b89059918dd4 |
|
MD5 | d471893df22b6198924f48b96c5c86fc |
|
BLAKE2b-256 | c57bc1e9f66e23b01958ae0284a437a0e586ce20387fc6ea0382c21230ac59bc |
哈希值 用于 biopython-1.84-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 2dc2e77490725060330003f73b6b7d5172f8bc160f180de5877a2e899ad999d4 |
|
MD5 | af78716df05afd11a550d92faf647cf5 |
|
BLAKE2b-256 | 463aebabbce6d7356091152402543ba2e3b2270cd12dd8153d800e585fa88900 |
哈希值 用于 biopython-1.84-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | ca8d6a88b9a9718074b3f5b450f9ea5adf7112a7dbaed55d82d5b623f5859a01 |
|
MD5 | 7fb584b77d4408d2bcdb93479b213975 |
|
BLAKE2b-256 | 57fd99f06b60fd7a5de22b9f3ca279a25def5ce16a629025e453fbf53e4ec6d4 |
哈希值 用于 biopython-1.84-cp310-cp310-macosx_11_0_arm64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | b51ef31bfb79872a182a85b4113625e1b553c024bb1586c72ac98b479f8d8fe4 |
|
MD5 | 6819b274d250b5a9d4dea7bdf40bf77b |
|
BLAKE2b-256 | fbda90c7fa24b0369633fff3f17ff42630a7c5afb719262478ccdd8dc028914b |
哈希值 用于 biopython-1.84-cp310-cp310-macosx_10_9_x86_64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 3c8beded38884abae4c74cb6ce54142da670273fd0b2919bd0f84f6e34d3056b |
|
MD5 | 2d121260dc6acc5d0abbd5f9f32bc70a |
|
BLAKE2b-256 | 3c419ae8eedc878d0d605e0a0c125f802662ceb9e8d241560b6b719246abab63 |
哈希值 用于 biopython-1.84-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 7b69d59f9a762c5bb5f77ed03f197dad05ebd702c34d2cae7be98f1f30e04089 |
|
MD5 | a2bdc8f02dd45e6616b5385138d1b8ff |
|
BLAKE2b-256 | 56e1088b5d945df96904c4ef70f46f185fde475724d1de3b73645bc1527ca04e |
哈希值 用于 biopython-1.84-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 0c425a39871f652598f502671aa5f6b5125475a91333a368a47f9c611ca96db1 |
|
MD5 | a439a73a6b0a42142eda9451e2bb0731 |
|
BLAKE2b-256 | 1e356726725c8f4eeb0c1570a9721b1a9aea9e4d839cc3725bfabdee891a0955 |
哈希值 用于 biopython-1.84-cp39-cp39-macosx_11_0_arm64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 9fbd4b67d3e71b0d716a1712ab8b4e57981c6549ba17ce5626ffa8976d170da7 |
|
MD5 | 249a1c92cbed3a645cc17878564baacf |
|
BLAKE2b-256 | d60530d008e35c6809b293f5147006647efd322e99f66f4190d87fb3a5e73975 |
哈希值 用于 biopython-1.84-cp39-cp39-macosx_10_9_x86_64.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | f4c1c9ad7da9eaf8d8f4515bf931a7f6548a468e7ef29b8429e31aaff2d95f4c |
|
MD5 | 1e268eff35f32b7c0c829296a0527a45 |
|
BLAKE2b-256 | 32ec9ded80f10708aea56f3d71bed665d2018df4ec829fe4e876196dbb96ae09 |