This commit is contained in:
@@ -1,12 +1,12 @@
|
||||
# 01 需求规格说明
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 软件定位
|
||||
|
||||
FemLite 是一个轻量级有限元求解器,核心使用 Fortran 实现,面向结构动力学、静力学、非线性分析、壳/实体单元、接触、材料非线性和紧凑工程基准算例开发。
|
||||
|
||||
当前项目版本为 0.6.4。0.6.4 是 CCLite coupling 基础闭环版本,重点交付中立 coupling API、worker mock、Windows IPC adapter、surface/facet 扩展导出、外部节点力导入和诊断报告。
|
||||
当前项目版本为 0.6.5。0.6.5 是 CCLite 真实 IPC worker 接入闭环版本,重点交付标准 worker 参数、真实 Windows IPC worker 后端、AOR_V1 data block、能力查询和进程级 IPC 自测。
|
||||
|
||||
## 2. 当前交付范围
|
||||
|
||||
@@ -21,7 +21,7 @@ FemLite 是一个轻量级有限元求解器,核心使用 Fortran 实现,面
|
||||
- 基础接触、mortar/AL、摩擦、cohesive 和颗粒耦合诊断基础设施。
|
||||
- CSV、VTU/PVD、restart、Fortran API 和 C ABI 输出/查询接口。
|
||||
- 元素 introspection API:元素类型、节点、坐标、积分点、形函数、Jacobian 和 B 矩阵。
|
||||
- CCLite coupling surface/facet 查询、节点力导入、worker mock、IPC adapter 和载荷诊断 CSV。
|
||||
- CCLite coupling surface/facet 查询、节点力导入、worker mock、真实 IPC worker、IPC adapter 和载荷诊断 CSV。
|
||||
- `continuation_path.csv`、`nonlinear_lifecycle.csv` 和 restart version 5 生命周期诊断。
|
||||
|
||||
## 3. 0.6.4 新增需求
|
||||
@@ -34,9 +34,20 @@ FemLite 是一个轻量级有限元求解器,核心使用 Fortran 实现,面
|
||||
- 增加 worker mock 命令状态机和 VTU/PVD + coupling 诊断输出闭环。
|
||||
- 增加 Windows shared memory / named event IPC adapter 的 C 层边界。
|
||||
- 保留 0.6.3 的 `S4R`、受控 `C3D8R`、积分规则基础设施和元素 introspection API。
|
||||
## 4. 明确不交付范围
|
||||
|
||||
以下内容不属于 0.6.4 交付:
|
||||
## 4. 0.6.5 新增需求
|
||||
|
||||
0.6.5 的新增需求已经交付:
|
||||
|
||||
- 增加 `--worker-backend ipc` 真实 Windows IPC worker 路径,支持 READY、INIT、STEP、STOP、ERROR 命令闭环。
|
||||
- 增加 `--solver-id`、`--timeout-ms`、`--worker-id`、`--command-block`、`--data-prefix` 等标准 worker 参数。
|
||||
- 增加 AOR_V1 data block 布局、初始化和校验接口,支持 surface/facet 导出和 nodal load 导入的共享内存数据段边界。
|
||||
- 增加 `--cclite-capabilities` 能力查询输出,便于 CCLite 侧进行启动前能力探测。
|
||||
- 增加真实进程级 IPC worker 小闭环、100 step、timeout 和异常输入自测。
|
||||
|
||||
## 5. 明确不交付范围
|
||||
|
||||
以下内容不属于 0.6.5 交付:
|
||||
|
||||
- 完整 reduced-integration solid 家族。
|
||||
- 完整 Abaqus 单元库。
|
||||
@@ -50,7 +61,7 @@ FemLite 是一个轻量级有限元求解器,核心使用 Fortran 实现,面
|
||||
- 真实 SPH-FEM penalty contact、FSI 和强耦合 rollback。
|
||||
- 生产级滚压成形工艺链。
|
||||
|
||||
## 5. 质量要求
|
||||
## 6. 质量要求
|
||||
|
||||
- 所有新增功能必须有小型、可重复的测试或 checker。
|
||||
- 公开接口必须通过 `ierr` 或 C 返回码报告错误,不得直接终止程序。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 02 软件架构设计
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 架构概览
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 03 详细设计
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 模型数据库
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 04 数学模型与算法
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 控制方程
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 05 接口控制文档
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. Fortran API 总则
|
||||
|
||||
@@ -276,9 +276,9 @@ seq,ack_seq,command_id,step_id,substep_id,iteration_id,state,error_code
|
||||
- `ADVANCE` 使用单步显式推进。
|
||||
- `WRITE_OUTPUT` 调用现有 CSV 与 VTU/PVD 输出路径。
|
||||
|
||||
## 9. CCLite Windows IPC Adapter
|
||||
## 9. CCLite Windows IPC Worker
|
||||
|
||||
阶段 C 提供 Windows IPC adapter 的 C 层边界,供后续真实 CCLite worker 接入。当前 adapter 已有 shared memory、named event、command block 读写和 smoke,不等同于主程序已经完成跨进程 worker 联调。
|
||||
阶段 C 提供 Windows IPC adapter 的 C 层边界。0.6.5 起主程序 worker 已接入真实 Windows IPC 后端,可由外部驱动创建 shared memory、named event 和 data block 后启动 `femlite --cclite-worker --worker-backend ipc`,完成 READY、INIT 到 STOP、空载荷推进和超时/异常退出闭环。
|
||||
|
||||
C 头文件:
|
||||
|
||||
@@ -299,6 +299,7 @@ typedef struct femlite_cclite_command_block {
|
||||
int32_t iteration_id;
|
||||
int32_t worker_state;
|
||||
int32_t error_code;
|
||||
char error_message[128];
|
||||
} femlite_cclite_command_block;
|
||||
```
|
||||
|
||||
@@ -316,9 +317,24 @@ adapter 约定:
|
||||
- FemLite 可以 wait `COMMAND_EVENT`、读取 command block、写回 `ack_seq`/`worker_state`/`error_code` 并 signal `DONE_EVENT`。
|
||||
- FemLite 不 reset event;reset 责任属于 CCLite 侧。
|
||||
- timeout 使用稳定错误码 `FEMLITE_CCL_IPC_ERR_TIMEOUT`。
|
||||
- 当前 smoke 覆盖 open、wait/signal、不 reset event、INIT/STOP、错误路径和 100 step 空耦合。
|
||||
- 当前 smoke 覆盖 open、wait/signal、不 reset event、INIT/STOP、错误路径、真实进程 1 step/100 step 空耦合和 timeout。
|
||||
- `femlite_cclite_transport` 提供 mock 和 Windows IPC 两个 backend 的统一 `receive/complete` facade。
|
||||
|
||||
data block 命名规则:
|
||||
|
||||
```text
|
||||
<data-prefix>_FEM_TO_CCL_FACET
|
||||
<data-prefix>_CCL_TO_FEM_LOAD
|
||||
```
|
||||
|
||||
data block 采用 `AOR_V1` 布局:
|
||||
|
||||
- header 字段包含 `magic`、`version`、`layout`、`record_type`、`record_capacity`、`record_count`、`record_stride`、`status_code`、`error_code` 和短错误消息。
|
||||
- `FEM_TO_CCL_FACET` 记录包含 facet id、surface id、element/face id、节点列表、节点位置、节点速度、法向、面积、材料/截面 id、`body_id=0` 占位、valid flags、壳厚度和面密度。
|
||||
- `CCL_TO_FEM_LOAD` 记录包含 record id、step id、node id、source id、load mode、distribution mode、valid flags、节点力和预留力矩字段。
|
||||
- 容量不足、版本不匹配或 record stride 不匹配会返回错误,不静默截断。
|
||||
- 当前中立 data block 已支持 facet 导出和节点力导入;facet pressure、moment 和 kinematic boundary 仍是后续能力。
|
||||
|
||||
## 10. 输出接口
|
||||
|
||||
```fortran
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 06 测试与验证计划
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 测试分层
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
| benchmark | 带 checker 的紧凑工程验收 |
|
||||
| release gate | 当前版本发布前必须通过的组合测试 |
|
||||
|
||||
## 2. 当前 0.6.4 Release Gate
|
||||
## 2. 当前 0.6.5 Release Gate
|
||||
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
@@ -21,13 +21,13 @@ ctest --test-dir build-codex-gcc --output-on-failure
|
||||
git diff --check
|
||||
```
|
||||
|
||||
当前本地 0.6.4 证据:
|
||||
当前本地 0.6.5 证据:
|
||||
- 完整编译通过。
|
||||
- 完整回归 73/73 通过。
|
||||
- CCLite/coupling 相关回归覆盖 `c_api`、`facet_nodal_c_api`、`cclite_worker_mock`、`cclite_ipc_adapter`、`cclite_ipc_worker_loop`、`implicit_inp` 和 `vtk_output`。
|
||||
- 完整回归 78/78 通过。
|
||||
- CCLite/coupling 相关回归覆盖 `c_api`、`facet_nodal_c_api`、`cclite_worker_mock`、`cclite_ipc_adapter`、`cclite_ipc_worker_loop`、`cclite_capabilities`、`cclite_worker_process_1step`、`cclite_worker_process_100step`、`cclite_worker_process_timeout`、`cclite_worker_process_badcase`、`implicit_inp` 和 `vtk_output`。
|
||||
- `git diff --check` 通过。
|
||||
|
||||
## 3. 0.6.4 聚焦覆盖
|
||||
## 3. 0.6.5 聚焦覆盖
|
||||
|
||||
| 测试 | 覆盖内容 |
|
||||
|---|---|
|
||||
@@ -35,8 +35,13 @@ git diff --check
|
||||
| `implicit_inp` | coupling 节点力叠加到静力线性 RHS 后产生位移响应 |
|
||||
| `facet_nodal_c_api` | surface/facet 扩展字段、退化 facet、壳厚度和 surface 名称过滤 |
|
||||
| `cclite_worker_mock` | worker 命令状态机、seq/ack、100 step 空耦合、VTU/PVD 和 coupling 诊断报告 |
|
||||
| `cclite_ipc_adapter` | shared memory、named event、timeout、wait/signal 和不 reset event |
|
||||
| `cclite_ipc_adapter` | shared memory、named event、timeout、wait/signal、不 reset event 和 AOR_V1 data block 布局 |
|
||||
| `cclite_ipc_worker_loop` | transport facade 下 INIT 到 STOP 和 100 step 空耦合 |
|
||||
| `cclite_capabilities` | `--cclite-capabilities` 稳定 key=value 输出 |
|
||||
| `cclite_worker_process_1step` | 真实 `femlite.exe --worker-backend ipc` 进程级 1 step 空耦合 |
|
||||
| `cclite_worker_process_100step` | 真实 IPC worker 进程级 100 step 空耦合、seq/ack 和 STOP |
|
||||
| `cclite_worker_process_timeout` | 真实 IPC worker timeout 可控退出 |
|
||||
| `cclite_worker_process_badcase` | 真实 IPC worker 异常输入可控退出 |
|
||||
| `vtk_output` | 默认 VTU/PVD 场变量输出路径 |
|
||||
## 4. V5 验收子集
|
||||
|
||||
@@ -75,7 +80,7 @@ git diff --check
|
||||
|
||||
## 7. 非默认长跑
|
||||
|
||||
以下属于后续或专项验证,不作为 0.6.4 默认 gate:
|
||||
以下属于后续或专项验证,不作为 0.6.5 默认 gate:
|
||||
|
||||
- 完整 `uz=-6.2 m` 球冠后屈曲 PDF 曲线匹配。
|
||||
- Mohr-Coulomb 临界失稳云图长跑。
|
||||
|
||||
+22
-3
@@ -1,6 +1,6 @@
|
||||
# 07 用户手册
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 构建
|
||||
|
||||
@@ -88,7 +88,7 @@ C 数组为 Fortran 顺序展开。例如 B 矩阵元素位置为:
|
||||
bmat[row + row_count * col]
|
||||
```
|
||||
|
||||
## 7. CCLite worker mock
|
||||
## 7. CCLite worker
|
||||
|
||||
FemLite 提供 CCLite worker mock 模式,用于验证命令状态机、空耦合推进和结果输出:
|
||||
|
||||
@@ -99,6 +99,25 @@ femlite --cclite-worker --case input.inp --ipc-name mock `
|
||||
|
||||
该模式会顺序执行 `INIT`、`READ_INPUT`、`BUILD_MODEL`、`EXPORT_INTERFACE`、`IMPORT_LOADS`、`ADVANCE`、`WRITE_OUTPUT` 和 `STOP`,并写出 worker 日志。它仍不是 Windows shared memory/named event IPC。
|
||||
|
||||
真实 IPC worker 使用 CCLite 创建的 command block、data block 和 named event:
|
||||
|
||||
```powershell
|
||||
femlite --cclite-worker --worker-backend ipc --solver-id FEM `
|
||||
--case input.inp --ipc-name CCLITE_CASE001 `
|
||||
--data-prefix CCLITE_CASE001 --timeout-ms 30000 `
|
||||
--log femlite_cclite_worker.log
|
||||
```
|
||||
|
||||
`--mock-steps` 存在时会强制进入 mock 模式;真实 IPC 模式应显式使用 `--worker-backend ipc`。FemLite 只 open/wait/signal CCLite 创建的 IPC 对象,不 reset event。当前真实 IPC worker 已支持 READY、INIT 到 STOP、`FEM_TO_CCL_FACET` 的 `AOR_V1` facet 导出、`CCL_TO_FEM_LOAD` 的 `AOR_V1` 节点力导入、1 step/100 step 空耦合 smoke、异常输入和 timeout 可控退出。
|
||||
|
||||
能力查询:
|
||||
|
||||
```powershell
|
||||
femlite --cclite-capabilities
|
||||
```
|
||||
|
||||
输出是稳定 `key=value` 文本,包含 worker mock、Windows IPC、`AOR_V1` data block、facet 导出和节点力导入能力。
|
||||
|
||||
`WRITE_OUTPUT` 会把 VTU/PVD 结果和 coupling 诊断表写到同一输出目录:
|
||||
|
||||
- `results.pvd` 与 `result_XXXXXXXX.vtu`
|
||||
@@ -136,4 +155,4 @@ FemLite 支持 Abaqus INP 子集。非关键 keyword 可能 warning 后跳过;
|
||||
- 完整 cohesive 主线接触 step。
|
||||
- DEM/FEM 子循环。
|
||||
- 生产级滚压成形流程。
|
||||
- 真实 CCLite Windows IPC 联调。
|
||||
- 真实 SPH-FEM penalty contact、FSI 和强耦合 rollback。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 08 开发者手册
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 基本原则
|
||||
|
||||
@@ -72,7 +72,7 @@ git diff --check
|
||||
|
||||
历史版本计划、验收报告和 benchmark 矩阵不再拆成多个文件;统一维护在 09-11。
|
||||
|
||||
## 7. 0.6.4 开发注意事项
|
||||
## 7. 0.6.x 开发注意事项
|
||||
|
||||
- `S4R` hourglass 修改必须保持 `S4` 回归绿色。
|
||||
- `C3D8R` hourglass 修改必须保持 `C3D8` 回归绿色,并覆盖刚度、内力、质量和输出路径。
|
||||
@@ -81,4 +81,4 @@ git diff --check
|
||||
- 新增积分规则不等于开放用户侧积分选择。
|
||||
- coupling external load 必须通过中立 API 导入和清理,不得让外部程序直接写 FemLite 全局力数组。
|
||||
- worker/IPC 改动必须保持 FemLite 只 open CCLite 创建的 shared memory 和 named event,event reset 责任属于 CCLite。
|
||||
- CCLite 诊断报告字段变更必须同步 C API 测试、worker mock 测试和接口文档。
|
||||
- CCLite 诊断报告字段变更必须同步 C API 测试、worker mock 测试和接口文档。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 09 版本历史与验收记录
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 版本线摘要
|
||||
|
||||
@@ -17,8 +17,35 @@
|
||||
| 0.6.2 | 稳定性发布,不新增算法 |
|
||||
| 0.6.3 | 元素基础设施:`S4R`、受控 `C3D8R`、积分规则库、元素 introspection API |
|
||||
| 0.6.4 | CCLite coupling 基础闭环:中立 API、worker mock、Windows IPC adapter、surface/facet 扩展导出、节点力导入与诊断 |
|
||||
| 0.6.5 | CCLite 真实 IPC worker 接入闭环:标准 worker 参数、AOR_V1 data block、能力查询和进程级 IPC 自测 |
|
||||
|
||||
## 2. 0.6.4 验收记录
|
||||
## 2. 0.6.5 验收记录
|
||||
|
||||
0.6.5 已完成:
|
||||
|
||||
- `femlite --cclite-worker --worker-backend ipc` 真实 Windows IPC worker 后端。
|
||||
- `--solver-id`、`--timeout-ms`、`--worker-id`、`--command-block`、`--data-prefix` 等标准 worker 参数。
|
||||
- `--cclite-capabilities` 稳定 key=value 能力查询输出。
|
||||
- AOR_V1 data block 布局、初始化、校验和 C ABI 边界。
|
||||
- 真实进程级 1 step、100 step、timeout 和异常输入回归测试。
|
||||
- CCLite worker Fortran 2018 外围实现与 Fortran95 算法核心分层。
|
||||
|
||||
本地验收命令:
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc --output-on-failure
|
||||
ctest --test-dir build-codex-gcc -R "cclite_" --output-on-failure
|
||||
git diff --check
|
||||
```
|
||||
|
||||
结果:
|
||||
- 完整编译通过。
|
||||
- 完整回归 78/78 通过。
|
||||
- CCLite/coupling 聚焦回归 8/8 通过。
|
||||
- `source_size` 通过。
|
||||
- `git diff --check` 通过。
|
||||
|
||||
## 3. 0.6.4 验收记录
|
||||
|
||||
0.6.4 已完成:
|
||||
|
||||
@@ -42,7 +69,7 @@ git diff --check
|
||||
- 完整回归 73/73 通过。
|
||||
- `git diff --check` 通过。
|
||||
|
||||
## 3. 0.6.3 验收记录
|
||||
## 4. 0.6.3 验收记录
|
||||
|
||||
0.6.3 已完成:
|
||||
|
||||
@@ -72,7 +99,7 @@ git diff --check
|
||||
- examples 精简后,`v5_acceptance` 34/34 通过。
|
||||
- `git diff --check` 通过。
|
||||
|
||||
## 4. 0.6.2 验收摘要
|
||||
## 5. 0.6.2 验收摘要
|
||||
|
||||
0.6.2 是稳定性发布,重点是 CSV schema、restart 诊断、contact/solver report、INP 错误边界和 CLI 输出目录边界。最终本地 gate 通过:
|
||||
|
||||
@@ -83,13 +110,13 @@ git diff --check
|
||||
- version smoke。
|
||||
- `git diff --check`。
|
||||
|
||||
## 5. 0.6.0-0.6.1 验收摘要
|
||||
## 6. 0.6.0-0.6.1 验收摘要
|
||||
|
||||
0.6.0 引入 nonlinear lifecycle 和 rollback audit。0.6.1 在此基础上扩展 cutback taxonomy、`nonlinear_lifecycle.csv`、contact state counters、Riks/arc path 指标和线性求解器诊断字段。
|
||||
|
||||
这些版本不声明完整工业级 AL/mortar 一致切线、mixed-control continuation、cohesive 主线接触或 DEM/FEM 子循环。
|
||||
|
||||
## 6. V5 验收摘要
|
||||
## 7. V5 验收摘要
|
||||
|
||||
V5 的长期验收入口保留为 `v5_acceptance` 标签。当前 examples 已精简,部分高难度历史示例不再作为当前示例交付项。
|
||||
|
||||
@@ -103,7 +130,7 @@ V5 当前文档口径主要覆盖:
|
||||
|
||||
已从当前 examples 中移除的历史难例包括:`strengthReduction`、`mohr_coulomb_yield_surface`、`ball_adhesion_decohesion`、`Dynamic_Grain_Packing_of_a_Flexible_Container`、`buckling_corrugated_shell`、`roll_forming`、`two_arches`、`block_on_arch`、`blasting_rock`、`failure_prediction_in_a_layered_shell`、`golfBallImpact`、`nonlinear_harmonic`、`stress_dependent_elasticity`、`cylinder_roller_contact`、`euler_column_buckling`、`membrane_airbag_inflation`、`pinched_hemispherical_shell`、`spherical_cap_with_central_point_load`。这些内容若后续恢复,应重新建立输入、checker 和 release gate。
|
||||
|
||||
## 7. 历史文件合并说明
|
||||
## 8. 历史文件合并说明
|
||||
|
||||
以下旧文件内容已合并进本文档、`10_development_roadmap.md` 或 `11_benchmark_matrix.md`,因此不再单独维护:
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# 10 后续开发路线图
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 路线图原则
|
||||
|
||||
@@ -44,21 +44,18 @@
|
||||
5. 大规模应用长算例继续留作后续版本。
|
||||
|
||||
### 2.4 CCLite 联合改造
|
||||
CCLite 联合改造建议单独维护在 `docs/12_cclite_integration_suggestions.md`。总体原则是保持 FemLite 独立求解器身份,FemLite 只提供稳定 surface/facet 状态、外部载荷入口、worker 通信边界和诊断,不复制 CCLite 的 SPH-FEM/FSI 算法。
|
||||
|
||||
CCLite 联合改造建议单独维护在 `docs/12_cclite_integration_suggestions.md`。总体原则是保持 FemLite 独立求解器身份,先固化中立 coupling API,再做 worker/service 和 IPC。
|
||||
0.6.5 已完成 CCLite coupling 基础闭环和真实 IPC worker 接入闭环:中立 coupling API、worker mock、Windows IPC adapter、surface/facet 扩展导出、节点力导入、诊断报告、标准 worker 参数、AOR_V1 data block、能力查询和进程级 IPC 自测。
|
||||
|
||||
建议优先级:
|
||||
|
||||
1. 中立 coupling API wrapper 和 C ABI smoke。
|
||||
2. 外部载荷缓存、总力/总力矩和拒绝记录诊断。
|
||||
3. worker/service mock transport 和命令状态机。
|
||||
4. Windows shared memory + named event adapter。
|
||||
5. surface/facet 完整导出、节点力导入和 CCLite 空耦合联调。
|
||||
|
||||
不建议直接把 CCLite 接触算法写入 FemLite,也不建议一开始就做真实 SPH-FEM 接触力验收。
|
||||
|
||||
0.6.4 已完成 CCLite coupling 基础闭环:中立 coupling API、worker mock、Windows IPC adapter、surface/facet 扩展导出、节点力导入、诊断报告和对应回归测试。真实 SPH-FEM penalty contact、FSI 与强耦合 rollback 仍保留为后续版本。
|
||||
1. surface/body id 稳定映射和 CCLite mock 联调。
|
||||
2. worker 诊断补强:跨求解器一致性字段、facet/load 对账和更完整错误分类。
|
||||
3. facet pressure 中立导入和更多 force balance 对账。
|
||||
4. 更长时间的 CCLite process-level 稳定性测试。
|
||||
|
||||
不建议直接把 CCLite 接触算法写入 FemLite。真实 SPH-FEM penalty contact、FSI 与强耦合 rollback 仍保留为后续版本。
|
||||
## 3. 仍需延期的能力
|
||||
|
||||
- 完整 Abaqus keyword 兼容。
|
||||
@@ -69,7 +66,7 @@ CCLite 联合改造建议单独维护在 `docs/12_cclite_integration_suggestions
|
||||
- 完整工业级 AL/mortar 一致切线。
|
||||
- cohesive 主线接触。
|
||||
- DEM/FEM 子循环。
|
||||
- CCLite worker/service、Windows IPC 和真实 SPH-FEM 联合验收。
|
||||
- 真实 SPH-FEM 联合物理验收、FSI 和强耦合 rollback。
|
||||
- 大规模并行和内存优化。
|
||||
|
||||
## 4. 版本规划建议
|
||||
@@ -78,9 +75,10 @@ CCLite 联合改造建议单独维护在 `docs/12_cclite_integration_suggestions
|
||||
|
||||
| 建议版本 | 目标 |
|
||||
|---|---|
|
||||
| 0.6.5 | 用户侧积分选择或更完整 hourglass 控制二选一,不建议同时做 |
|
||||
| 0.6.6 | 元素查询 API 文档化示例、更多 C API smoke、用户侧错误边界 |
|
||||
| 0.7.0 | 壳/实体非线性能力提升、轻量 benchmark 闭环,或 CCLite worker mock 闭环二选一 |
|
||||
| 0.7.x | 接触一致切线、cohesive 主线、CCLite IPC adapter 和应用 benchmark 按需恢复 |
|
||||
| 0.6.5 | 已完成:真实 IPC worker 接入闭环、标准 worker 参数、data block AOR_V1、能力查询和自测 |
|
||||
| 0.6.6 | 稳定 surface/body id 映射、process-level CCLite mock 联调和诊断字段补强 |
|
||||
| 0.6.7 | facet pressure 中立导入、更多 force balance 对账 |
|
||||
| 0.7.0 | 壳/实体非线性能力提升、轻量 benchmark 闭环,或 CCLite 联调增强二选一 |
|
||||
| 0.7.x | 接触一致切线、cohesive 主线、CCLite 应用 benchmark 按需恢复 |
|
||||
|
||||
实际版本号应以当期风险和测试闭环为准。
|
||||
|
||||
@@ -1,17 +1,17 @@
|
||||
# 11 Benchmark 与验收矩阵
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 1. 当前发布 Gate
|
||||
|
||||
0.6.4 发布 gate:
|
||||
0.6.5 发布 gate:
|
||||
```powershell
|
||||
cmake --build build-codex-gcc --parallel
|
||||
ctest --test-dir build-codex-gcc --output-on-failure
|
||||
git diff --check
|
||||
```
|
||||
|
||||
## 2. 0.6.4 矩阵
|
||||
## 2. 0.6.5 矩阵
|
||||
|
||||
| 领域 | 测试 | 验收点 |
|
||||
|---|---|---|
|
||||
@@ -22,7 +22,11 @@ git diff --check
|
||||
| IPC adapter | `cclite_ipc_adapter` | shared memory、named event、timeout、wait/signal、不 reset event |
|
||||
| IPC worker loop | `cclite_ipc_worker_loop` | transport facade 下 INIT 到 STOP 和 100 step 空耦合 |
|
||||
| VTU/PVD 输出 | `vtk_output` | 默认场变量 VTU/PVD 输出稳定 |
|
||||
| 完整回归 | `ctest --output-on-failure` | 当前本地 73/73 通过 |
|
||||
| 真实 IPC worker | `cclite_worker_process_1step` | 进程级 1 step 空耦合、seq/ack 和 STOP 闭环 |
|
||||
| 真实 IPC worker 长闭环 | `cclite_worker_process_100step` | 进程级 100 step 空耦合稳定 |
|
||||
| Worker 边界 | `cclite_worker_process_timeout` / `cclite_worker_process_badcase` | timeout 和异常输入可控退出 |
|
||||
| Worker 能力查询 | `cclite_capabilities` | `--cclite-capabilities` 稳定 key=value 输出 |
|
||||
| 完整回归 | `ctest --output-on-failure` | 当前本地 78/78 通过 |
|
||||
## 3. V5 Acceptance 矩阵
|
||||
|
||||
| 领域 | 代表测试或 benchmark |
|
||||
|
||||
@@ -1,221 +1,233 @@
|
||||
# 12 CCLite 联合改造建议
|
||||
|
||||
文档状态:根据 `..\CCLite\femlite_suggests.md` 提取并按 FemLite 当前能力修订
|
||||
文档状态:根据 `..\CCLite\femlite_suggests.md` 新建议提取,并按 FemLite 0.6.5 当前能力修订。
|
||||
|
||||
## 1. 改造口径
|
||||
## 1. 结论摘要
|
||||
|
||||
FemLite 不建议改造成 CCLite 的内部库,也不建议把 CCLite 的 SPH-FEM 接触搜索、FSI 或调度算法复制进 FemLite。更合适的边界是:
|
||||
CCLite 对 FemLite 的新建议已经从“建立基础 coupling API”推进到“真实 IPC worker 接入闭环”。FemLite 0.6.5 已经完成中立 coupling API、worker mock、Windows IPC adapter、surface/facet 扩展导出、节点力导入、诊断 CSV、真实 IPC worker、能力查询和对应回归测试,因此后续不应重复做这些基础项。
|
||||
|
||||
- FemLite 保持独立求解器、独立 CLI、Fortran API 和 C ABI。
|
||||
- 新增一层面向 CCLite 的 worker/service adapter。
|
||||
- adapter 只负责命令、通信、数据映射、诊断和错误码。
|
||||
- FEM 侧只提供稳定 surface/facet 状态和外部载荷入口。
|
||||
- CCLite 负责联合调度、shared memory、named event、SPH-FEM 接触/耦合算法和联合诊断。
|
||||
0.6.5 已经保留现有 mock worker,同时新增真实 IPC worker 运行模式,让 `femlite.exe --cclite-worker --worker-backend ipc` 能按 CCLite 标准参数打开 command block、data block 和 named event,完成无 SPHLite 依赖的 attach、READY、空 facet/load、STOP 自测闭环。
|
||||
|
||||
## 2. FemLite 当前已有基础
|
||||
真实 SPH-FEM penalty contact、FSI、tie/release 或强耦合 rollback 仍属于 CCLite 算法或后续联调层能力,不应作为 0.6.5 已完成能力声明。
|
||||
|
||||
当前 FemLite 已具备一部分耦合基础,不应重复开发:
|
||||
|
||||
- 已有边界 facet 查询能力:`fem_get_boundary_facet_count`、`fem_get_boundary_facets` 及 C ABI 对应接口。
|
||||
- 已有 facet 压力、traction、facet nodal load 入口和总力查询入口。
|
||||
- 已有元素 introspection API,可查询元素类型、节点、坐标、积分点、形函数、Jacobian 和 B 矩阵。
|
||||
- 已有接触、particle-facet、particle-FEM 相关模块和 smoke 测试,可作为后续联合验证基础。
|
||||
- 默认场变量输出已是 `result_XXXXXXXX.vtu` + `results.pvd`,适合 CCLite 联合结果检查。
|
||||
|
||||
这些能力目前仍偏内部或历史命名,例如 `sph` 前缀较多。后续建议先增加中立 coupling wrapper,而不是直接删改旧接口。
|
||||
|
||||
## 3. 必须保持的边界
|
||||
## 2. 必须保持的边界
|
||||
|
||||
FemLite 继续负责:
|
||||
|
||||
- FEM 输入、网格、材料、section、边界条件解析。
|
||||
- 实体/壳单元内力、质量、刚度和本构更新。
|
||||
- 显式动力学、静力、非线性静力、隐式 Newmark。
|
||||
- FEM 内部接触、cohesive、mortar/AL 等已有能力。
|
||||
- restart、CSV、VTU/PVD、诊断和自身 release gate。
|
||||
- 显式动力、线性静力、非线性静力、隐式 Newmark 等自身求解流程。
|
||||
- FemLite 内部接触、cohesive、mortar/AL 等已有能力。
|
||||
- restart、CSV、VTU/PVD、诊断、Fortran API、C ABI 和自身 release gate。
|
||||
- 稳定导出 FEM surface/facet 状态,并接收外部节点力等基础载荷。
|
||||
|
||||
CCLite 负责:
|
||||
CCLite 继续负责:
|
||||
|
||||
- 启动、监控和停止 FemLite worker。
|
||||
- 创建和销毁 Windows shared memory 与 named event。
|
||||
- 创建、reset 和销毁 Windows shared memory 与 named event。
|
||||
- 解析 CCLite 联合输入。
|
||||
- 读取 FemLite boundary facet 和 SPHLite 粒子状态。
|
||||
- 读取 FemLite facet 状态和 SPHLite 粒子状态。
|
||||
- 计算 SPH-FEM 接触、FSI 或其他联合界面载荷。
|
||||
- 写回 FemLite 与 SPHLite 的外部载荷。
|
||||
- 输出联合诊断和力平衡报告。
|
||||
- 写回 FemLite 与 SPHLite 外部载荷。
|
||||
- 输出联合诊断、force balance 和跨求解器一致性报告。
|
||||
|
||||
FemLite 不应:
|
||||
FemLite 不应做:
|
||||
|
||||
- 直接调度 SPHLite。
|
||||
- 读取 SPHLite 私有数据结构。
|
||||
- 链接 CCLite Fortran95 算法核心。
|
||||
- 在内部复制 CCLite 的 SPH-FEM 接触搜索算法。
|
||||
- reset 由 CCLite 创建并拥有的 event。
|
||||
- 复制 CCLite 的 SPH-FEM 接触搜索、耦合或 FSI 算法。
|
||||
- reset CCLite 创建并拥有的 event。
|
||||
- 把 CCLite 预留能力描述成 FemLite 已完成物理算法。
|
||||
|
||||
## 4. 推荐分阶段路线
|
||||
## 3. FemLite 0.6.4 已完成项
|
||||
|
||||
### 4.1 阶段 A:中立 coupling API 固化
|
||||
0.6.4 已经覆盖 CCLite 建议中的基础闭环:
|
||||
|
||||
目标是把已有 facet/load 能力整理为 CCLite 可稳定依赖的公共接口,不引入 worker IPC。
|
||||
- 中立 coupling surface/facet wrapper 和 C ABI。
|
||||
- 旧 `boundary` 与 `sph` 命名接口继续兼容。
|
||||
- surface/facet 扩展导出字段:`surface_id`、`material_id`、`section_id`、`valid_flags`、`shell_thickness`、`mass_per_area`。
|
||||
- 按 `*SURFACE, NAME=..., TYPE=ELEMENT` 名称过滤导出。
|
||||
- 退化 facet invalid flag、normal 单位化、实体面厚度为 0、壳厚度和面密度测试。
|
||||
- coupling 节点力导入,包含 `source_id`、`load_mode`、`valid_flags`。
|
||||
- 独立 external load cache,`fem_clear_coupling_loads` 统一清理本步载荷和诊断。
|
||||
- 节点力已叠加到显式动力外力、线性静力 RHS 和隐式/非线性外力装配路径。
|
||||
- 本步总力、总力矩、接受记录、非有限载荷、未知节点和容量/metadata 拒绝计数。
|
||||
- 按 `source_id` 汇总诊断。
|
||||
- `femlite_cclite_load_report.csv` 和 `femlite_cclite_surface_report.csv`。
|
||||
- worker mock 命令状态机,覆盖 `INIT`、`READ_INPUT`、`BUILD_MODEL`、`EXPORT_INTERFACE`、`IMPORT_LOADS`、`ADVANCE`、`WRITE_OUTPUT`、`STOP`。
|
||||
- worker mock 100 step 空耦合、seq/ack、STOP、错误路径、VTU/PVD 与诊断 CSV 一致性测试。
|
||||
- Windows shared memory / named event C adapter,提供 open/wait/signal/close,不 reset event。
|
||||
- transport facade 的 mock 与 Windows IPC backend 小闭环测试。
|
||||
|
||||
建议内容:
|
||||
这些能力是后续真实 IPC worker 的基础,不需要重写。
|
||||
|
||||
- 新增或文档化中立命名 C ABI,例如 `femlite_get_coupling_surface_count`、`femlite_get_coupling_surface_facets`、`femlite_apply_coupling_nodal_forces`。
|
||||
- 旧 `sph` 命名接口保留为兼容 wrapper。
|
||||
- 明确数组展开方式、容量不足返回、无效 id 返回和非有限载荷拒绝。
|
||||
- 增加 coupling load 总力、总力矩、拒绝记录数、节点未匹配数查询。
|
||||
- 增加 C API smoke,覆盖 facet 导出、空载荷、节点力和错误边界。
|
||||
## 4. 新建议提取与修订
|
||||
|
||||
建议先作为 0.6.x 小版本完成。
|
||||
### 4.1 标准 worker 参数
|
||||
|
||||
当前实现状态:
|
||||
|
||||
- 已新增中立 surface count/facets wrapper,阶段 A 暂导出全部边界 facet。
|
||||
- 已新增中立 nodal force wrapper,复用现有外部耦合力向量。
|
||||
- 已新增 coupling load 诊断,可查询总力、总力矩、接受记录数、非有限载荷拒绝数、未知节点拒绝数和容量/metadata 拒绝数。
|
||||
- 已补充 C API smoke,覆盖 surface count、三角形/四边形 facet 导出、当前坐标/速度导出、空载荷、节点力、非有限载荷、未知节点和容量错误。
|
||||
- surface 名称过滤、壳厚度、mass per area 和更完整 surface 字段仍留在后续阶段。
|
||||
|
||||
### 4.2 阶段 B:worker 协议 smoke
|
||||
|
||||
目标是让 FemLite 具备 worker 主循环和命令状态机,但通信层先使用 mock transport 或文件/内存模拟,避免一开始就把 Windows IPC 和求解流程耦合在一起。
|
||||
|
||||
建议命令:
|
||||
CCLite 新建议要求支持:
|
||||
|
||||
```text
|
||||
INIT
|
||||
READ_INPUT
|
||||
BUILD_MODEL
|
||||
EXPORT_INTERFACE
|
||||
IMPORT_LOADS
|
||||
ADVANCE
|
||||
WRITE_OUTPUT
|
||||
STOP
|
||||
femlite.exe --cclite-worker --solver-id FEM --case femlite.inp --ipc-name CCLITE_CASE001 --timeout-ms 30000
|
||||
```
|
||||
|
||||
完成标准:
|
||||
并预留:
|
||||
|
||||
- `femlite.exe --cclite-worker --case femlite.inp --ipc-name <name>` 可进入 worker 模式。
|
||||
- 未指定 `--cclite-worker` 时原 CLI 行为完全不变。
|
||||
- worker 可进入 `READY`、响应 `STOP`、写错误码和日志。
|
||||
- mock 传输可完成 100 step 空耦合。
|
||||
```text
|
||||
--command-block <name>
|
||||
--data-prefix <prefix>
|
||||
--log <path>
|
||||
--timeout-ms <value>
|
||||
--worker-id <id>
|
||||
```
|
||||
|
||||
当前实现状态:
|
||||
FemLite 修订建议:
|
||||
|
||||
- 已新增 `fem_cclite_worker` mock worker,内部命令覆盖 `INIT`、`READ_INPUT`、`BUILD_MODEL`、`EXPORT_INTERFACE`、`IMPORT_LOADS`、`ADVANCE`、`WRITE_OUTPUT` 和 `STOP`。
|
||||
- 已新增 worker command block,包含 `seq`、`ack_seq`、`command_id`、`step_id`、`substep_id`、`iteration_id`、`worker_state` 和 `error_code`。
|
||||
- 已新增 `--cclite-worker` CLI 入口,支持 `--case`、`--ipc-name`、`--log`、`--output-dir` 和 `--mock-steps`。
|
||||
- 已新增 CSV 风格 worker 日志,记录启动参数、命令状态和错误码。
|
||||
- 已补充 `cclite_worker_mock` 回归测试,覆盖 READY、seq/ack、100 step 空耦合、VTU/PVD 输出、STOP 和输入错误路径。
|
||||
- 当前仍是 mock 协议闭环,不是真实 Windows shared memory/named event IPC。
|
||||
- 保留当前 `--cclite-worker --case --ipc-name --log --output-dir --mock-steps`,避免破坏 0.6.4 回归。
|
||||
- 新增 `--solver-id`、`--timeout-ms`、`--command-block`、`--data-prefix`、`--worker-id`。
|
||||
- 增加模式区分:`--mock-steps` 存在或显式 `--worker-backend mock` 时运行 mock worker;指定真实 IPC backend 时打开 CCLite 对象。
|
||||
- `--solver-id` 初期只接受 `FEM` 或 `FEMLite`,不把求解器类型泛化成插件系统。
|
||||
|
||||
### 4.3 阶段 C:Windows IPC adapter
|
||||
优先级:高,适合下一版。
|
||||
|
||||
目标是接入 CCLite 创建的 command block、data block、named event。
|
||||
### 4.2 真实 IPC worker 主循环
|
||||
|
||||
建议边界:
|
||||
CCLite 新建议要求 worker 启动后打开 CCLite 创建的 command block、data block、command event、done event,进入 READY,随后 wait command、执行命令、写回 ack/state/error 并 signal done。
|
||||
|
||||
- FemLite 只 open CCLite 创建的对象。
|
||||
FemLite 修订建议:
|
||||
|
||||
- 复用 0.6.4 的 `femlite_cclite_transport` facade,不另起一套 IPC 代码。
|
||||
- 将现有 mock worker 的命令处理逻辑抽成 backend 无关的命令执行器。
|
||||
- 第一阶段只闭合真实 IPC 下的 `INIT`、`READ_INPUT`、`BUILD_MODEL`、`EXPORT_INTERFACE`、`IMPORT_LOADS` 空载荷、`ADVANCE` 空耦合、`WRITE_OUTPUT`、`STOP`。
|
||||
- FemLite 只 wait/signal,不 reset event。
|
||||
- command block 必须包含 `seq`、`ack_seq`、`command_id`、`step_id`、`substep_id`、`iteration_id`、`error_code`。
|
||||
- 0.1.x 可固定 `substep_id=0`、`iteration_id=0`。
|
||||
- IPC 错误必须写 worker 日志和稳定错误码。
|
||||
- 非 Windows 继续返回 unsupported,并保留 mock worker 可运行。
|
||||
|
||||
该阶段建议只验收空 facet 或少量固定 facet 导出,不验收真实 SPH-FEM 接触力。
|
||||
优先级:最高,适合下一版作为主目标。
|
||||
|
||||
当前实现状态:
|
||||
### 4.3 data block 与数据布局
|
||||
|
||||
- 已新增 `femlite_cclite_ipc.h` 和 C adapter,定义稳定 command block 布局、命令枚举、状态枚举和 IPC 错误码。
|
||||
- 已新增 shared memory open/close wrapper,Windows 下只打开 CCLite 已创建对象,非 Windows 返回 unsupported。
|
||||
- 已新增 named event open/wait/signal/close wrapper,wait/signal 不 reset event。
|
||||
- 已新增 `femlite_cclite_wait_command` 和 `femlite_cclite_write_done`,支持等待 `COMMAND_EVENT` 后读取 command block,并写回 ack/state/error 后 signal `DONE_EVENT`。
|
||||
- 已新增 `femlite_cclite_transport` facade,提供 mock 与 Windows IPC 两个 backend 的统一 receive/complete 入口。
|
||||
- 已补充 `cclite_ipc_adapter` smoke,覆盖命名、布局、open、timeout、wait/signal 和 event 不 reset。
|
||||
- 已补充 `cclite_ipc_worker_loop` smoke,使用本地测试 helper 模拟 CCLite,并通过 transport facade 完成 INIT 到 STOP 和 100 step 空耦合。
|
||||
- 当前尚未把 `femlite.exe --cclite-worker` 主循环切换为真实跨进程 Windows IPC 运行模式;现阶段先固化 adapter 和 transport 小闭环。
|
||||
CCLite 新建议明确要求打开 data block,并优先闭合 `FEM_TO_CCL_FACET` 与 `CCL_TO_FEM_LOAD`。
|
||||
|
||||
### 4.4 阶段 D:真实 surface/facet 导出
|
||||
FemLite 修订建议:
|
||||
|
||||
目标是让 CCLite 能读取稳定 FEM 边界状态。
|
||||
- 新增明确版本化布局,例如 `AOR_V1`。
|
||||
- `FEM_TO_CCL_FACET` 先支持 header + facet records,字段来自现有扩展导出。
|
||||
- `CCL_TO_FEM_LOAD` 先支持 header + nodal force records,字段映射到现有 coupling 节点力导入。
|
||||
- data block 由 CCLite 创建和定容,FemLite 只 open、检查版本和容量、读写合法范围。
|
||||
- 如果容量不足,FemLite 返回稳定错误码并写 worker 日志,不截断静默成功。
|
||||
|
||||
最小字段:
|
||||
优先级:高,适合与真实 IPC worker 同版完成最小闭环。
|
||||
|
||||
- `facet_id`
|
||||
- `surface_id`
|
||||
- `elem_id`
|
||||
- `face_id`
|
||||
- `node_count`
|
||||
- `node_ids`
|
||||
- 当前节点坐标
|
||||
- 当前节点速度
|
||||
- facet normal
|
||||
- facet area
|
||||
- material id
|
||||
- section id
|
||||
- valid flags
|
||||
### 4.4 surface/facet 字段
|
||||
|
||||
壳单元扩展字段:
|
||||
|
||||
- shell thickness
|
||||
- mass per area
|
||||
|
||||
实体面 `shell_thickness=0`。退化 facet 应设置 invalid flag,不应静默导出为有效接触面。
|
||||
|
||||
当前实现状态:
|
||||
|
||||
- 已新增 coupling surface 扩展导出接口,保留旧 ABI,同时输出 `surface_id`、`material_id`、`section_id`、`valid_flags`、`shell_thickness` 和 `mass_per_area`。
|
||||
- 未指定 surface 时继续导出全部边界 facet,`surface_id=0` 并写 warning。
|
||||
- 已支持按已有 `*SURFACE, NAME=..., TYPE=ELEMENT` 名称过滤导出。
|
||||
- 已补充单三角形、单四边形、退化三角形、退化四边形、实体面厚度为 0、壳厚度、面密度和 normal 单位化 smoke。
|
||||
- 当前 surface_id 使用内部 surface 序号;若 CCLite 需要稳定跨文件 ID,后续可增加显式映射表。
|
||||
|
||||
### 4.5 阶段 E:外部载荷导入与诊断
|
||||
|
||||
目标是支持 CCLite 写回的节点力,并安全叠加到 FemLite 求解流程。
|
||||
|
||||
建议先只做:
|
||||
|
||||
- `NODAL_FORCE`
|
||||
- `node_id`
|
||||
- `force[3]`
|
||||
- `source_id`
|
||||
- `load_mode`
|
||||
- `valid_flags`
|
||||
|
||||
FemLite 内部应有独立外部耦合载荷缓存。每个 CCLite step 开始前清零,导入后再叠加到当前求解步外力或 RHS。不要让 CCLite 直接写 FemLite 全局力数组。
|
||||
|
||||
诊断至少包括:
|
||||
|
||||
- 本步接收总力。
|
||||
- 本步接收总力矩。
|
||||
- 每个 surface 的总载荷。
|
||||
- 被拒绝的 load record 数量。
|
||||
- 非有限载荷数量。
|
||||
- 节点 id 未匹配数量。
|
||||
|
||||
当前实现状态:
|
||||
|
||||
- 已新增独立 coupling external load 缓存,并通过 `fem_clear_coupling_loads` 统一清理本步载荷和诊断。
|
||||
- coupling 节点力已叠加到显式动力外力路径、静力线性 RHS 和隐式/非线性外力装配路径。
|
||||
- 已校验 `source_id`、`load_mode`、`valid_flags`、非有限载荷和未知节点,拒绝记录会进入诊断计数。
|
||||
- 已提供本步总力、总力矩、按 `source_id` 汇总的诊断查询。
|
||||
- 已输出 `femlite_cclite_load_report.csv` 与 `femlite_cclite_surface_report.csv`,worker mock 在写 VTU/PVD 时同步写出两份报告。
|
||||
- 已补充显式单步响应、静力 RHS 响应、force balance CSV 和 worker 输出一致性回归测试。
|
||||
- 当前仍是基础节点力闭环,不包含真实 SPH-FEM penalty contact、FSI 或 CCLite 强耦合 rollback。
|
||||
|
||||
## 5. 输入与 surface 语义建议
|
||||
|
||||
FemLite 自身输入仍由 FemLite 解析。建议优先复用或加强已有 `*SURFACE`/接触 surface 解析能力,而不是新增另一套不兼容语法。
|
||||
|
||||
建议目标:
|
||||
CCLite 建议字段包括:
|
||||
|
||||
```text
|
||||
*SURFACE, NAME=CCL_SURF_PLATE, TYPE=ELEMENT
|
||||
...
|
||||
facet_id, surface_id, elem_id, face_id, node_count, node_ids,
|
||||
x_node, v_node, normal, area, shell_thickness, mass_per_area,
|
||||
material_id, section_id, body_id, valid_flags
|
||||
```
|
||||
|
||||
可选增加辅助关键词:
|
||||
FemLite 当前已完成除 `body_id` 外的主要字段。
|
||||
|
||||
FemLite 修订建议:
|
||||
|
||||
- `body_id` 不应临时伪造为材料号、section 号或 element set 号。
|
||||
- 下一步可先定义 `body_id=0` 的占位规则并文档化,或增加显式 body/part 映射表后再输出真实稳定 ID。
|
||||
- 继续保持实体面 `shell_thickness=0`、`mass_per_area=0`。
|
||||
- 继续让退化 facet 进入导出但标记 `valid_flags=0`,便于诊断。
|
||||
- 如果 CCLite 需要跨文件稳定 surface id,应新增显式 surface id 映射表,而不是依赖内部 surface 序号。
|
||||
|
||||
优先级:中高。`body_id` 和稳定 surface id 可在真实 IPC data block 之后做。
|
||||
|
||||
### 4.5 外部载荷导入
|
||||
|
||||
CCLite 建议基础载荷为:
|
||||
|
||||
```text
|
||||
node_id
|
||||
force[3]
|
||||
source_id
|
||||
load_mode
|
||||
distribution_mode
|
||||
valid_flags
|
||||
```
|
||||
|
||||
并预留:
|
||||
|
||||
```text
|
||||
FACET_PRESSURE
|
||||
MOMENT
|
||||
KINEMATIC_BOUNDARY
|
||||
```
|
||||
|
||||
FemLite 当前已支持节点力、source/load_mode/valid_flags、总力/总力矩和诊断 CSV。
|
||||
|
||||
FemLite 修订建议:
|
||||
|
||||
- 下一步在 data block 中增加 `step_id`、`record_id`、`distribution_mode` 字段,但 Fortran 求解侧暂不必使用 `distribution_mode`。
|
||||
- `MOMENT` 不应直接假装已支持。若要支持,应先明确转动自由度、壳/实体节点 DOF 映射和静力/动力 RHS 规则。
|
||||
- `FACET_PRESSURE` 可复用历史 facet pressure 能力,但需要中立 coupling API 和 data block 记录格式后再开放。
|
||||
- `KINEMATIC_BOUNDARY` 风险较高,涉及约束生命周期和求解器一致性,应延期。
|
||||
|
||||
优先级:节点力 data block 高;facet pressure 中;moment/kinematic boundary 暂缓。
|
||||
|
||||
### 4.6 诊断和 force balance
|
||||
|
||||
CCLite 建议 worker 至少输出启动参数、command block 名称、data block 名称、command id、step id、ack seq、worker state、facet 数、load 数、总力、总力矩、错误码和错误消息。
|
||||
|
||||
FemLite 当前已有 worker log、load report、surface report,但还缺真实 IPC 对象名称、data block 名称和短错误消息字段。
|
||||
|
||||
FemLite 修订建议:
|
||||
|
||||
- 扩展 worker log header:记录 backend、solver_id、worker_id、ipc_name、command_block、data_prefix、timeout_ms。
|
||||
- 扩展每条命令日志:记录 command_id、step_id、substep_id、iteration_id、state、error_code、短错误消息。
|
||||
- 在 `WRITE_OUTPUT` 或每步结束时同步输出 facet/load 诊断。
|
||||
- 保持报告文件名:
|
||||
- `femlite_cclite_worker.log`
|
||||
- `femlite_cclite_surface_report.csv`
|
||||
- `femlite_cclite_load_report.csv`
|
||||
- 不把 CCLite 的联合 `force_balance.csv` 直接写进 FemLite;FemLite 提供原始统计,由 CCLite 生成跨求解器 force balance。
|
||||
|
||||
优先级:高,适合真实 IPC worker 同版完成。
|
||||
|
||||
### 4.7 能力查询入口
|
||||
|
||||
CCLite 新建议增加:
|
||||
|
||||
```text
|
||||
femlite.exe --cclite-capabilities
|
||||
```
|
||||
|
||||
建议输出:
|
||||
|
||||
```text
|
||||
solver=FEMLite
|
||||
cclite_worker=yes
|
||||
worker_mock=yes/no
|
||||
ipc_backend=windows_shmem_named_event
|
||||
command_block_version=1
|
||||
data_layout=AOR_V1
|
||||
supports_real_ipc=yes/no
|
||||
supports_fem_to_ccl_facet=yes/no
|
||||
supports_ccl_to_fem_load=yes/no
|
||||
max_facet_records=...
|
||||
max_load_records=...
|
||||
```
|
||||
|
||||
FemLite 修订建议:
|
||||
|
||||
- 建议新增该 CLI,输出稳定 key=value 文本,方便 CCLite 解析。
|
||||
- 同步提供 C ABI 能力查询不是必须,可后置。
|
||||
- `supports_real_ipc` 在真实 worker 主循环完成前必须输出 `no`,避免误判。
|
||||
- `max_facet_records`、`max_load_records` 初期可输出编译期常量或 `0` 表示由 CCLite data block 容量决定。
|
||||
|
||||
优先级:高,成本低,适合下一版。
|
||||
|
||||
### 4.8 输入关键字
|
||||
|
||||
CCLite 建议 FemLite 可选支持:
|
||||
|
||||
```text
|
||||
*FEMLITE CCLITE
|
||||
@@ -226,78 +238,100 @@ EXPORT_THICKNESS=YES
|
||||
ACCEPT_EXTERNAL_LOAD=YES
|
||||
```
|
||||
|
||||
该关键词只作为 FemLite 侧辅助配置,不替代 CCLite 联合输入。
|
||||
FemLite 修订建议:
|
||||
|
||||
## 6. 测试建议
|
||||
- 不建议把它作为下一版主线。真实 worker 的命令行和 IPC data block 优先级更高。
|
||||
- 若要做,应只作为 FemLite 侧辅助配置,不替代 CCLite 联合输入。
|
||||
- `EXPORT_SURFACE` 可映射到已有 surface 名称过滤。
|
||||
- 不应在 input keyword 中声明真实 SPH-FEM 接触算法已经启用。
|
||||
|
||||
阶段 A 测试:
|
||||
优先级:中低,建议在真实 IPC worker 闭环后再做。
|
||||
|
||||
- C ABI coupling surface count。
|
||||
- 三角形 facet 导出。
|
||||
- 四边形 facet 导出。
|
||||
- 当前坐标和速度导出。
|
||||
- 空载荷导入。
|
||||
- 节点力导入。
|
||||
- 容量不足错误。
|
||||
- 非有限载荷拒绝。
|
||||
- 节点 id 未匹配错误。
|
||||
### 4.9 自测和联调路径
|
||||
|
||||
阶段 B/C 测试:
|
||||
CCLite 新建议要求在没有 SPHLite 的情况下验证 worker 启动、IPC attach、READY、空 facet、空 load、STOP。
|
||||
|
||||
- worker 启动。
|
||||
- `READY` 状态。
|
||||
- command seq/ack。
|
||||
- wait/signal,不 reset event。
|
||||
- 100 step 空耦合。
|
||||
- `STOP` 正常退出。
|
||||
- 超时和错误码。
|
||||
FemLite 修订建议:
|
||||
|
||||
阶段 D/E 联合测试:
|
||||
- 新增真实 IPC self-test,使用本地测试 helper 创建 shared memory/event,启动或调用 FemLite worker,验证 INIT 到 STOP。
|
||||
- 测试分三层:
|
||||
- adapter 单元测试:open/wait/signal/no reset/timeout。
|
||||
- in-process transport 测试:command block 与 100 step 空耦合。
|
||||
- process-level worker 测试:`femlite.exe --cclite-worker --worker-backend ipc` 真实进程 attach。
|
||||
- 与 CCLite 联调先验收三类路径:
|
||||
- mock SPH + 真实 FemLite,1 step 空耦合。
|
||||
- mock SPH + 真实 FemLite,100 step 空耦合。
|
||||
- 异常输入和 timeout 可控退出。
|
||||
|
||||
- 单三角形 facet。
|
||||
- 单四边形 facet。
|
||||
- 壳厚度导出。
|
||||
- 单粒子撞面。
|
||||
- 多粒子压面。
|
||||
- force balance CSV 对账。
|
||||
- VTU/PVD 场输出和 worker 诊断文件一致性检查。
|
||||
优先级:最高,真实 IPC worker 必须配套。
|
||||
|
||||
可复用算例:
|
||||
## 5. 逐条响应 CCLite 建议
|
||||
|
||||
- `contact_rigid_plane_indentation`
|
||||
- `shell_rigid_plane_contact`
|
||||
- `shell_solid_contact`
|
||||
- `clamped_square_plate_pressure_pulse`
|
||||
- `rigid_sphere_impact_plate`
|
||||
| CCLite 建议 | FemLite 0.6.5 状态 | 修订响应 |
|
||||
|---|---|---|
|
||||
| 保持 FemLite 独立 worker/service,不嵌入 CCLite 算法 | 已遵守 | 继续保持,adapter 只做通信和数据映射 |
|
||||
| 支持 `--cclite-worker` | 已支持 mock worker 和真实 IPC backend | 继续保持两种 backend |
|
||||
| 打开 command block | 已通过真实 IPC worker 接入 | 继续保持小闭环回归 |
|
||||
| 打开 data block | 已定义 `AOR_V1` 并接入 facet/load block | 后续扩展更多记录类型 |
|
||||
| wait `COMMAND_EVENT` / signal `DONE_EVENT` | 已在真实 worker 中使用 | 继续保持不 reset event 约束 |
|
||||
| 不 reset event | 已遵守 | 继续作为接口约束和测试项 |
|
||||
| 支持 INIT 到 STOP 命令 | mock 与真实 IPC worker 已支持 | 继续复用同一命令执行器 |
|
||||
| `substep_id=0`、`iteration_id=0` | 已有字段 | 真实 IPC worker 初期继续固定为 0 |
|
||||
| 导出空或固定 facet | 已通过 data block 支持空/fixed facet 边界 | 后续接入更完整 surface/body 映射 |
|
||||
| 接收空载荷 | 已支持 | 继续保持空载荷自测 |
|
||||
| 接收节点力 | API 与求解路径已支持,`CCL_TO_FEM_LOAD` 已接入 | 后续扩展更多载荷类型 |
|
||||
| 输出 worker 日志和接口诊断 | 已补充 backend、IPC 名称、data block 名称和短错误消息 | 后续补强跨求解器对账字段 |
|
||||
| 导出 shell thickness/mass per area | 已支持并加入 data block | 继续保留 |
|
||||
| 导出 body_id | 未支持 | 暂用 `0` 占位或后续显式 body 映射,不伪造 |
|
||||
| 稳定 surface id | 当前为内部序号 | 后续增加显式映射表 |
|
||||
| 支持 facet pressure | 历史内部能力存在,中立 CCLite block 未接 | 后续单独做,不与真实 IPC worker 混在同一最小闭环 |
|
||||
| 支持 moment | 未支持 | 暂缓,需要 DOF/RHS 语义设计 |
|
||||
| 支持 kinematic boundary | 未支持 | 暂缓,风险较高 |
|
||||
| `--cclite-capabilities` | 已支持 | 保持 key=value 输出稳定 |
|
||||
| 无 SPHLite 自测 | 已补 process-level 真实 IPC 自测 | 后续可增加 CCLite mock 联调 |
|
||||
| 不把 mock 当真实耦合完成 | 文档已说明 | 继续明确区分 mock worker 与 real IPC worker |
|
||||
|
||||
## 7. 建议版本切分
|
||||
## 6. 0.6.5 完成范围
|
||||
|
||||
0.6.5 已按“真实 IPC worker 接入闭环”落地以下范围:
|
||||
|
||||
1. CLI 参数补齐:`--solver-id`、`--timeout-ms`、`--command-block`、`--data-prefix`、`--worker-id`、`--worker-backend`。
|
||||
2. `--cclite-capabilities` key=value 输出。
|
||||
3. worker 命令执行器与 transport backend 解耦。
|
||||
4. 真实 Windows IPC worker 主循环接入 command block/event。
|
||||
5. 定义 `FEM_TO_CCL_FACET` data block `AOR_V1` header 和最小 facet records。
|
||||
6. 定义 `CCL_TO_FEM_LOAD` data block `AOR_V1` header 和空/nodal force records。
|
||||
7. worker log 增加 backend、IPC 名称、data block 名称和短错误消息。
|
||||
8. process-level self-test 覆盖 attach、READY、空 facet、空 load、STOP、timeout 和异常输入。
|
||||
9. 文档更新,明确 mock worker、IPC adapter、real IPC worker 三者边界。
|
||||
|
||||
该版本不建议包含:
|
||||
|
||||
- 真实 SPH-FEM penalty contact 物理验收。
|
||||
- FSI 工程算例。
|
||||
- tied/release。
|
||||
- rollback 或预测状态接口。
|
||||
- facet pressure 的完整物理验收。
|
||||
- kinematic boundary。
|
||||
- 删除旧 `sph` 命名接口。
|
||||
|
||||
## 7. 建议版本路线
|
||||
|
||||
| 建议版本 | FemLite 目标 |
|
||||
|---|---|
|
||||
| 0.6.x | 中立 coupling API wrapper、文档、C ABI smoke、外部载荷诊断框架 |
|
||||
| 0.7.0 | worker/service mock transport、命令状态机、空耦合闭环 |
|
||||
| 0.7.1 | Windows shared memory + named event adapter、CCLite 空耦合联调 |
|
||||
| 0.7.2 | surface/facet 完整导出、节点力导入、force/moment 诊断 |
|
||||
| 0.7.x 后续 | shell thickness、mass per area、surface id 稳定化、pressure/facet load |
|
||||
| 0.8.x | tie/release、rollback/强耦合预留、长时间稳定性 |
|
||||
| 0.9.x | FSI 工程简化算例、性能基线和异常处理补强 |
|
||||
| 0.6.4 | 已完成:中立 coupling API、worker mock、IPC adapter、surface/facet 扩展导出、节点力导入与诊断 |
|
||||
| 0.6.5 | 已完成:真实 IPC worker 接入闭环、标准 worker 参数、data block AOR_V1、能力查询、自测 |
|
||||
| 0.6.6 | 推荐:稳定 surface/body id 映射、process-level CCLite mock 联调和诊断字段补强 |
|
||||
| 0.6.7 | 可选:facet pressure 中立导入、更多 force balance 对账 |
|
||||
| 0.7.x | tied/release、rollback 预留、弱/强耦合策略、长时间稳定性 |
|
||||
| 0.8.x | FSI 和工程化联合算例 |
|
||||
|
||||
## 8. 不建议立即做的事项
|
||||
## 8. 最终建议
|
||||
|
||||
- 不建议把 CCLite 接触算法移入 FemLite。
|
||||
- 不建议 FemLite 直接链接 CCLite 核心库。
|
||||
- 不建议一开始就做真实 SPH-FEM penalty contact 验收。
|
||||
- 不建议 worker IPC、真实载荷导入、surface 名称稳定化和强耦合 rollback 一次性开发。
|
||||
- 不建议删除旧 `sph` 命名接口,应先提供中立 wrapper 并保留兼容期。
|
||||
CCLite 新建议中,0.6.5 已完成的“真实 IPC worker 接入闭环”直接承接 0.6.4 的 adapter、mock worker、surface/load API 和诊断能力,能让 CCLite 明确区分:
|
||||
|
||||
## 9. 推荐下一步
|
||||
- `worker mock`:FemLite 内部顺序执行命令的测试模式。
|
||||
- `IPC adapter`:C 层 shared memory/event 操作封装。
|
||||
- `real IPC worker`:真正由 CCLite command/event 驱动的 worker 运行模式。
|
||||
|
||||
最稳的小闭环是先做阶段 A:
|
||||
|
||||
1. 盘点现有 boundary facet 与 sph load API。
|
||||
2. 增加中立 coupling wrapper。
|
||||
3. 增加 coupling load 诊断。
|
||||
4. 补 C ABI smoke。
|
||||
5. 更新接口文档。
|
||||
|
||||
完成后再进入 worker/service,而不是直接上 Windows IPC。
|
||||
真实 IPC worker、data block 和 process-level self-test 已在 0.6.5 形成最小闭环;但它仍只是通信和数据边界验收,不等同于真实 SPH-FEM 接触物理验收。
|
||||
|
||||
+3
-1
@@ -1,6 +1,6 @@
|
||||
# FemLite 文档索引
|
||||
|
||||
文档状态:0.6.4 版整理稿
|
||||
文档状态:0.6.5 版整理稿
|
||||
|
||||
## 核心文档
|
||||
|
||||
@@ -18,6 +18,8 @@
|
||||
- [09 版本历史与验收记录](09_release_history.md)
|
||||
- [10 后续开发路线图](10_development_roadmap.md)
|
||||
- [11 Benchmark 与验收矩阵](11_benchmark_matrix.md)
|
||||
- [12 CCLite 联合改造建议](12_cclite_integration_suggestions.md)
|
||||
- [13 CCLite Coupling API 盘点](13_cclite_coupling_api_inventory.md)
|
||||
|
||||
## 维护说明
|
||||
|
||||
|
||||
Reference in New Issue
Block a user