ctb

化学工具箱核心库。目前提供：

• balance(equation) — 化学方程式配平（支持离子）
• mass(name, mode=1) — 相对原子 / 分子质量计算

安装

pip install ctb

用法

配平方程式

from ctb import balance

balance("H2+O2=H2O")                 # '2H2+O2=2H2O'
balance("Fe2O3+CO=Fe+CO2")           # 'Fe2O3+3CO=2Fe+3CO2'
balance("H^1++OH^1-=H2O")            # 'H^1++OH^1-=H2O'
balance("CO3^2-+H^1+=HCO3^1-")       # 'CO3^2-+H^1+=HCO3^1-'

计算相对原子 / 分子质量

from ctb import mass

# mode=1（默认）：精确值
mass("H")               # 1.008
mass("Ag")              # 107.87
mass("CO2")             # 44.009
mass("Fe2(SO4)3")       # 399.858

# mode=2：近似值（四舍五入，氯除外为 35.5）
mass("H", 2)            # 1.0
mass("CO2", 2)          # 44.0
mass("NaCl", 2)         # 58.5   ← 氯按 35.5 处理
mass("Fe2(SO4)3", 2)    # 400.0

输入格式

API

balance(equation: str) -> str

返回配平后的方程式字符串（不含空格）。失败抛 ValueError。

mass(name: str, mode: int = 1) -> float

返回相对原子质量 / 相对分子质量（float，保留 4 位小数）。

• mode=1：精确值
• mode=2：近似值（四舍五入到整数，Cl 固定为 35.5）

失败抛 ValueError（无效化学式 / 非法 mode）或 KeyError（未知元素）。

更新日志

v0.2.0

• 新增 mass(name, mode=1) 函数
• 相对原子质量改用 IUPAC 精确值

v0.1.0

• 首个版本，提供 balance(equation)

许可证

MIT © 2026 123IOPjklbnm