36 lines
1.2 KiB
Markdown
36 lines
1.2 KiB
Markdown
# 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
|
||
|
||
作为内部库使用：
|
||
|
||
```toml
|
||
[dependencies]
|
||
common = { path = "../crates/common" }
|
||
```
|
||
|
||
### 运行测试
|
||
```bash
|
||
cargo test -p common
|
||
```
|