浏览器
分析第一个分子
解析 SMILES,并在无需后端的情况下查看结构和基本性质。
步骤
- 打开浏览器演示。
- 输入乙醇的 SMILES:CCO,然后运行分析。
- 对照结构图、分子式和分子量。
检查结果页面会显示乙醇的 2D 结构和性质数值。
遇到问题时如果结构为空,请检查 SMILES,并再次尝试 CCO。
CCO查看指南 入门 · 5–15 分钟
通过构建小型实用的化学工具来学习 chematic。每个教程都有明确的起点、可运行代码和下一步。
浏览器
解析 SMILES,并在无需后端的情况下查看结构和基本性质。
检查结果页面会显示乙醇的 2D 结构和性质数值。
遇到问题时如果结构为空,请检查 SMILES,并再次尝试 CCO。
CCO查看指南 Python
安装软件包,在 notebook 中解析分子。
检查结果分子对象在 notebook 中返回,不需要将结构发送到外部服务器。
遇到问题时安装前先激活虚拟环境;如果无法导入,请检查软件包名称。
mol = chematic.from_smiles("CCO")查看指南 Python
生成指纹,并使用 Tanimoto 相似度比较分子。
检查结果相同分子的得分为 1.0;结构差异越大,得分通常越低。
遇到问题时比较前请确保所有分子使用相同的指纹设置。
mol.ecfp4()查看指南 Python
从单分子分析扩展到 CSV 或 SDF 批处理。
检查结果每个输入行都有可追踪的结果,失败的行也可以检查。
遇到问题时不要丢弃原始字符串,这样可以轻松检查并重试失败的行。
for smiles in rows:查看指南 Rust
将 chematic 加入 Rust 项目,在同一进程中运行化学逻辑。
检查结果程序可以在本地构建,并对相同输入产生可重复的结果。
遇到问题时如果编译时间或二进制大小重要,可以先只启用需要的功能。
cargo add chematic --features "smiles,perception,chem,3d,fp"查看指南 AI 代理
先使用本地 stdio MCP 服务器;只有客户端无法启动进程时才使用自行托管的 HTTP。
检查结果客户端可以调用化学工具并接收结构化响应,无需托管服务。
遇到问题时只有客户端无法启动本地进程时才使用回环 HTTP 适配器。
chematic-mcp查看指南 浏览器
将 SMILES 转换为可缩放的结构图 SVG,并在浏览器中本地检查。
检查结果应显示放大后仍清晰的阿司匹林 2D 结构。
遇到问题时请使用完整且有效的 SMILES;SVG 绘制不需要后端。
CC(=O)OC1=CC=CC=C1C(=O)O查看指南 Python
解析一个分子,计算早期筛选常用的理化描述符。
检查结果三个值都会针对同一个已解析分子在本地返回。
遇到问题时描述符是计算值,不应视为实验测量或临床预测。
mol = chematic.from_smiles("CCO")
mol.mw
mol.logp
mol.tpsa查看指南 浏览器
检查分子是否包含官能团模式,并查看匹配的原子。
检查结果结果会报告匹配并高亮相应原子。
遇到问题时SMARTS 表示模式,不一定是完整分子;先从小模式开始。
C(=O)O查看指南 浏览器
载入结构文件,检查行数据,然后完全在浏览器中筛选或导出。
检查结果文件可在浏览器中处理,不需要专用分析后端。
遇到问题时保留源文件,并先用小样本确认 SMILES 列或 SDF 字段。
compounds.sdf查看指南 浏览器
在绘制结构或计算性质前,为无效分子字符串返回明确错误。
检查结果有效输入会显示结构,不完整语法会显示错误。
遇到问题时解析错误表示语法问题,并不是对化学安全性或实验有效性的判断。
有效:CCO
无效:C1CC查看指南 浏览器
在本地比较两个结构,并将输入与可重复的 Tanimoto 分数一起保留。
检查结果相同输入和指纹设置会得到相同的本地分数。
遇到问题时相似度分数不能单独判断活性、安全性或合成可行性。
阿司匹林
水杨酸
ECFP4查看指南 浏览器
检查一个已解析分子的计算描述符和显示的 Lipinski 结果。
检查结果结果面板会显示已解析分子的性质指标。
遇到问题时这些是计算指标,并不是对有效性、安全性或临床适用性的结论。
CC(=O)OC1=CC=CC=C1C(=O)O查看指南 Python
在计算紧凑性质报告时保留源行号和解析错误。
检查结果每个非空输入行都有明确的 status。
遇到问题时bulk.descriptors 会跳过无效 SMILES,因此要先验证与源表核对的报告。
chematic.from_smiles(smiles)查看指南 Python
验证候选库后,运行一对多本地 Tanimoto 搜索。
检查结果同样的有效输入会得到同样的排序。
遇到问题时bulk API 会跳过无效条目,可能破坏与原始数据行号的对应。
bulk.tanimoto_search(query, library)查看指南 Python
筛选本地列表中的官能团模式,并按输入顺序保留命中。
检查结果匹配字符串保持原始输入顺序。
遇到问题时该 API 会将无效 SMILES 视为未匹配;需要解释阴性时请先验证。
bulk.substructure_search(pattern, smiles)查看指南 Rust
创建一个原生 CLI,解析 CCO 并报告原子数、分子量和 TPSA。
检查结果CCO 会输出 atoms=3、mw=46.07 和 tpsa=20.23。
遇到问题时请为实际工作流选择有文档说明的最小功能集。
cargo add chematic --features "smiles,perception,chem"查看指南 AI 代理
在注册到客户端之前,将 JSON-RPC 解析请求发送给本地 MCP 服务器。
检查结果响应包含 valid=true、atoms=6、bonds=6 和 mol_weight=78.114。
遇到问题时这是本地 stdio 进程,不是托管 MCP URL。
tools/call: parse_smiles查看指南 Python
解析一个 SMILES,并将两个基本计算值保留在原始输入旁边。
检查结果CCO 返回 C2H6O 和约 46.07 g/mol 的分子量。
遇到问题时分子式不能唯一识别结构,此处的分子量是计算值而不是实验测量值。
mol = chematic.from_smiles("CCO")
mol.formula
mol.mw查看指南 浏览器
无需打包工具即可加载已发布的 WebAssembly 软件包,并在浏览器中计算阿司匹林分子量。
检查结果固定版本模块初始化后,阿司匹林会输出 180.16。
遇到问题时不要使用 @latest,也不要依赖 file URL 加载 ES 模块。
import init, { parse_smiles } from ".../chematic_wasm.js"
await init()查看指南 AI 代理
通过本地 MCP 在 PubChem 查询阿司匹林,并保留返回的 SMILES 和来源。
检查结果阿司匹林会返回带 PubChem 来源的异构 SMILES。
遇到问题时这是唯一会将输入发送到网络服务的 MCP 工具。
tools/call: name_to_smiles
name: aspirin查看指南 AI 代理
在本地获取 chematic 的规范 SMILES,并与输入和软件版本一起保留。
检查结果响应中包含规范 SMILES 字符串,且没有网络请求。
遇到问题时未经验证时,不要把不同库或发布版本的规范字符串视为可互换。
tools/call: canonical_smiles
smiles: C1=CC=CC=C1查看指南 Python
保留每个 CSV 行,并根据 chematic 的规范 SMILES 标记本地重复候选。
检查结果CCO 和 OCC 都得到 C(C)O,后一个行会作为重复候选标记。
遇到问题时规范字符串不是通用身份的证据;保留原始行和版本信息。
chematic.from_smiles(smiles).smiles查看指南 Python
保留提交的 SMILES,并为含盐记录创建独立且有明确策略的复核表示。
检查结果用最大片段复核时,醋酸钠和醋酸都会得到 CC(O)=O。
遇到问题时不要用复核表示取代提交的盐形式或立体化学记录。
mol.standardize(largest_fragment_only=True)查看指南 Python
在批量 API 跳过无效行之前,先分类每个源值。
检查结果CCO 和 OCC 会 accepted;未完成的 C1CC 在 input_index 1 仍为 rejected。
遇到问题时语法 accepted 不能证明化学身份、盐策略、安全性或实验有效性。
canonicalize_smiles_batch_json(source_smiles)查看指南 Python
在本地创建可缩放的二维结构成果物,同时保留精确源 SMILES。
检查结果aspirin.svg 可作为可缩放的二维结构图打开。
遇到问题时SVG 描绘不能证明化学身份、立体化学、安全性或实验有效性。
Path("aspirin.svg").write_text(mol.svg())查看指南 Python
从一个明确的反应 SMILES 在本地创建可缩放反应图。
检查结果esterification.svg 可作为含反应物、箭头和产物的反应图打开。
遇到问题时反应 SVG 不能证明原子映射、收支、条件、收率、化学身份、安全性或实验有效性。
Path("esterification.svg").write_text(chematic.reaction_svg(...))查看指南 Python
创建本地 SDF 记录,并将结构名和精确源 SMILES 保留为 SD 数据。
检查结果ethanol.sdf 包含乙醇、source_smiles: CCO 和 $$$$ 终止符。
遇到问题时SDF 记录和自动生成的二维坐标不能证明化学身份、材料来源、安全性或实验有效性。
with chematic.SDWriter("ethanol.sdf") as writer:
writer.write(mol)查看指南 Python
将有效 CSV 行写为本地 SDF 记录,并在报告中保留全部源行。
检查结果有效行会写入 SDF,C1CC 会在报告中保留为 invalid_smiles。
遇到问题时SDF 输出不能证明化学身份、材料来源、安全性或实验有效性。
chematic.SDWriter("molecules.sdf")查看指南