概览
PubChemPy 提供了一个用于访问 PubChem PUG REST API 的 Python 接口。它的作用是将 Python 化学数据工作流与 PubChem 搜索及化合物信息连接起来，而不是提供单独的化学数据库或预测模型。README 介绍了按化学名称、子结构和相似性进行搜索，以及化学标准化、文件格式转换、结构绘制和属性检索。
所提供的示例展示了两种入口：通过 PubChem 化合物标识符（CID）检索化合物，以及按名称搜索。CID 查询会生成一个化合物对象，其属性可提供 SMILES 和 IUPAC 名称等信息。名称搜索示例会返回一组化合物结果，并读取首个结果的 SMILES 和分子量。这些示例展示了如何在 Python 中将标识符或名称转换为可访问的结构化信息。
在数据准备工作流中，PubChemPy 可作为化学查询列表与后续处理之间的检索层。建议评估的用途包括为记录补充 PubChem 属性，或检查按名称搜索得到的结果是否对应预期化合物。这些应用需要核查返回的记录；README 中使用首个搜索结果只是一个示例，并不能证明每个名称都能唯一且恰当地解析。
项目元数据声明支持 Python >=3.10，且没有必需的包依赖。来源摘录无法确认服务可用性、检索吞吐量、数据库覆盖范围或返回记录是否经过科学验证。摘录还列出了更广泛的操作，但未展示其详细输入和输出，因此规划这些工作流时，适合进一步查阅所链接的指南和 API 参考。
主要功能
- 按名称、子结构和相似性搜索 PubChem 化学物质。
- 通过 `Compound.from_cid` 按 CID 检索化合物记录。
- 文档示例展示了可访问的化合物属性，包括 SMILES、IUPAC 名称和分子量。
- 通过其 PubChem 接口支持化学标准化。
- 提供 README 所述的化学文件格式转换和结构绘制功能。
使用场景
- 建议评估：为含有 PubChem CID 的化学品清单补充 SMILES 和 IUPAC 名称，并核对检索记录是否对应预期物质。
- 建议评估：将化学名称解析为候选 PubChem 记录，并在下游数据准备中使用分子量之前检查结果选择。
- 建议评估：考察文档所述的子结构或相似性搜索，判断其是否适合为化学信息学工作流构建候选化合物集合。
- 建议评估：使用有代表性的化学输入，依据 API 文档考察标准化、格式转换或结构绘制工作流。
使用方式
- 从仓库 README入手，选择 CID 检索、名称搜索或其他已描述的操作。在选择示例之前，先明确工作流所需的化合物属性。
- 查阅安装指南，并确认其声明的 Python >=3.10 要求。README 提供了 pip 和 conda 安装选项；请按照文档中的说明操作，不要添加未说明的标志。
- 按照入门指南进行操作。初步评估时，可重现 README 中的 CID 1423 查询或 Aspirin 名称搜索，并检查返回的属性。
- 使用API 参考了解子结构搜索、相似性搜索、标准化、转换或结构绘制的输入和输出。来源摘录未包含这些操作的详细步骤。
- 在将检索集成到更大的工作流之前，评估有代表性的记录。检查化合物身份和所需字段，记录未能解析的查询；调查意外行为时，可查阅问题跟踪器。