DCTS/crates/common/README.md

common

DCTS 核心物理引擎与底层工具库。

---

📦 模块概览

common 包含了 DCTS 系统的物理逻辑实现，负责将网格点参数转换为 TLUSTY/SYNSPEC 可识别的物理输入文件，启动并监控子进程运行，判定物理收敛性，并计算种子拟合度。

核心子模块说明

• config.rs：物理网格与节点/服务端配置 YAML 解析。
• gen_input5.rs / fort55_writer.rs / nst_writer.rs：TLUSTY fort.5 / fort.55 / nst.dat 输入流构造器。
• conv_check.rs：解析 TLUSTY 输出日志（fort.6），判定物理迭代是否达到收敛标准。
• runner.rs：异步带超时的子进程（tlusty / synspec）启动器与现场隔离回收管理。
• seed_finder.rs：基于加权欧氏距离的最近邻收敛种子匹配算法。
• embedded.rs：计算节点自动 Bootstrap 预热与二进制文件校验。
• logging.rs：基于 tracing-appender 的按天日志轮转器。

---

🛠️ Usage & Setup

作为内部库使用：

[dependencies]
common = { path = "../crates/common" }

运行测试

cargo test -p common