Repository navigation
Releases: ai4energy/esml
Release list
ESML 学术版 v1.9.0（Linux x86_64）
ESML 学术版 v1.9.0（Linux x86_64）
本版把“结果可用”再推进一步：成功有契约，失败也有契约；结果不只带单位，
还带求解质量；商业版常驻会话与一次性调用对齐；IEEE 300 的 4,604 个值补齐单位。
- 失败也是契约（
esml.error/v1）：带--json的命令失败时，stdout 仍为空，
stderr 末行是机器可读信封：稳定code（license.size/license.dtil/
io.read/solve.failed/model.parse/model.structure/usage/
engine.error）、message、hint、docHash、engineVersion。Python / Julia
客户端抛EsmlError并带.code/.hint/.doc_hash。 - 求解质量：
solve --json的meta增加iterations、residual
（接受解的残差 ∞-范数）与residualTolerance；正常结果满足
residual <= residualTolerance。 - 会话启动失败也是协议错误：
esml session在打开阶段失败（学术版 DTIL、
文件不可读等）也在 stdout 返回一行esml.session/v1错误信封（code/
hint），客户端不再只看到 EOF。 - DTIL 会话对齐：
esml.session/v1的 solve 每个值带unit，并返回
units与meta；simulate / predict 同样；open / info 带sourceHash。 - IEEE 300 单位补全：
Vm/P/Q（标幺）与Va（弧度）声明为无量纲，
4,604 个值从unit: null变为unit: "1"、unitCoverage.complete = true，
数值不变。
字段、错误码、失败语义与 Python / Julia 映射见
https://docs.ai4energy.cn/esml/results；JSON Schema：
https://docs.ai4energy.cn/schema/esml-result-v1.json。
学术、教学、个人非商业用途免费。模型限制为展平未知量 ≤ 16,384；
覆盖到 IEEE 300 节点（4,604 未知量），IEEE 2869 / 1354 / 9241 等更大规模需要商业版；
超限在求解前响亮报错。学术版只开放引擎核心（solve / simulate / import /
check），不包含常驻数字孪生（DTIL）会话。
包内容（解包后的顶层目录与压缩包同名，按 README 直接使用即可）：
esml引擎二进制（学术版）libesml_mmprops_ffi.so物性后端- 标准模型库
library/ - Python / Julia 一次性调用快速上手脚本
- 许可条款
客户端（均为 MIT，单独下载）：
- Python：https://github.com/ai4energy/esml-python（v0.3.0）
- Julia：https://github.com/ai4energy/ESML.jl（v0.3.0）
商业授权（无规模限制，含 DTIL）：mingtao.li@gmail.com
运行前请用随附的 .sha256 校验下载。
ESML 学术版 v1.8.1（Linux x86_64）
ESML 学术版 v1.8.1（Linux x86_64）
本版把一次性结果做成可直接消费的契约：solve --json / simulate --json
不只返回数值，还返回单位、收敛状态、引擎版本、源文件指纹与耗时。
- 单位：每个值带
unit（一致 SI 单位下的量纲表达式；无量纲为"1"；
模型未声明单位为null，引擎不猜）。 - 可追溯：
meta.docHash是源文件逐字节 SHA-256，可作缓存/归档键；
meta.engineVersion标识产生结果的引擎版本。 - 可判断：
meta.converged在成功信封中恒为true；未收敛、结构错误、
超限或调用 DTIL 一律非零退出，stdout 不输出半个结果。 - 单位覆盖率：
meta.unitCoverage {known,total,complete}让调用方一眼判断
结果能否直接进入带单位的后处理。 - 时域：
simulate新增points、units（列名 → SI 量纲）与meta。
字段、失败语义与 Python / Julia 映射见
https://docs.ai4energy.cn/esml/results。
学术、教学、个人非商业用途免费。模型限制为展平未知量 ≤ 16,384；
覆盖到 IEEE 300 节点（4,604 未知量），IEEE 2869 / 1354 / 9241 等更大规模需要商业版；
超限在求解前响亮报错。学术版只开放引擎核心（solve / simulate / import /
check），不包含常驻数字孪生（DTIL）会话。
包内容（解包后的顶层目录与压缩包同名，按 README 直接使用即可）：
esml引擎二进制（学术版）libesml_mmprops_ffi.so物性后端- 标准模型库
library/ - Python / Julia 一次性调用快速上手脚本
- 许可条款
客户端（均为 MIT，单独下载）：
商业授权（无规模限制，含 DTIL）：mingtao.li@gmail.com
运行前请用随附的 .sha256 校验下载。
ESML 学术版 v1.8.0（Linux x86_64）
ESML 学术版 v1.8.0（Linux x86_64）
学术、教学、个人非商业用途免费。模型限制为展平未知量 ≤ 16,384；
覆盖到 IEEE 300 节点（4,604 未知量），IEEE 2869 / 1354 / 9241 等更大规模需要商业版；
超限在求解前响亮报错。学术版只开放引擎核心（solve / simulate / import /
check），不包含常驻数字孪生（DTIL）会话。
包内容：
esml引擎二进制（学术版）libesml_mmprops_ffi.so物性后端- 标准模型库
library/ - Python / Julia 一次性调用快速上手脚本
- 许可条款
客户端（均为 MIT，单独下载）：
商业授权（无规模限制，含 DTIL）：mingtao.li@gmail.com
运行前请用随附的 .sha256 校验下载。