Appearance
MMPROPS — 物性引擎
面向能源系统与流程模拟的独立物性引擎：水/蒸汽（IF97）、制冷剂、二元混合物 （GERG），提供状态点物性、饱和态、闪蒸、VLE 泡/露点与 T-x-y 相包络。命令行 输出支持 text / csv / json（SI 值，带单位）。
能力
| 子命令 | 作用 |
|---|---|
props | T,p 状态点：rho / h / s / cp / cv / w / m |
sat | 饱和态：psat / rho_l / rho_v / hfg（按温度） |
flash | 闪蒸：p,h 或 p,s |
vle | 二元 VLE 泡点/露点（固定 T） |
envelope | T-x-y 相包络（固定 T） |
db | 物性注册表与数据包身份 |
输入数值可带单位：K / C / F、Pa / kPa / MPa / bar / atm、 J/kg / kJ/kg、J/(kg·K) / kJ/(kg·K)；纯数字按 SI 解释。
下载与安装
从 最新发布 下载学术版（Linux x86_64）：
bash
tar -xzf mmprops-academic-0.6.0-linux-x86_64.tar.gz
export MMPROPS_HOME="$PWD/mmprops-academic-0.6.0-linux-x86_64"
"$MMPROPS_HOME/mmprops" --version客户端用 MMPROPS_BIN 指向这个二进制即可。
快速开始
bash
"$MMPROPS_HOME/mmprops" props --fluid water --t "300 K" --p "1 bar" --format json
"$MMPROPS_HOME/mmprops" sat --fluid water --t "373.15 K" --format json
"$MMPROPS_HOME/mmprops" flash --fluid water --spec ph --p "1 bar" \
--h "1000 kJ/kg" --format json
"$MMPROPS_HOME/mmprops" vle --kind bubble --components methane,ethane \
--x 0.5,0.5 --t "220 K" --format json参考值：水在 300 K / 1 bar 的 rho = 996.556338 kg/m3；373.15 K 的 psat = 101417.996368 Pa；甲烷/乙烷 220 K、x1=0.5 的泡点 p = 3993218.99 Pa、 y1 = 0.847911。完整步骤见 水蒸汽与相包络教程。
Python 与 Julia
bash
pip install git+https://github.com/ai4energy/mmprops-python@v0.1.0python
from mmprops import props, sat
water = props("water", "300 K", "1 bar")
print(water.values["rho"], water.units["rho"])
print(sat("water", "373.15 K").values["psat"])julia
using Pkg
Pkg.add(url = "https://github.com/ai4energy/MMProps.jl", rev = "v0.1.0")julia
using MMProps
water = props("water", "300 K", "1 bar")
println(water.values["rho"], " ", water.units["rho"])客户端均为 MIT；每次调用一个进程，不保留状态。
数据包
默认使用内嵌基线。自定义数据包用 --data DIR 或 MMPROPS_DATA：
bash
"$MMPROPS_HOME/mmprops" db pack # 当前 pack_id@version#sha256
"$MMPROPS_HOME/mmprops" db props # 注册的物性函数显式给出坏数据包会响亮失败，不会退回内嵌基线。
学术版与商业版
功能相同，共用同一二进制；区别在授权范围：学术/教学/个人非商业免费， 商业用途需取得商业许可。未收敛或超出范围会响亮失败，不返回替代值。
教程与文档
许可
MMPROPS 引擎是商业软件（不是 MIT）。学术/教学/个人非商业用途免费；商业用途需取得 商业许可 —— mingtao.li@gmail.com。客户端（Python / Julia）为 MIT。 完整条款见 ai4energy/mmprops 的 LICENSE.md。