diff --git a/CMakeLists.txt b/CMakeLists.txt index 40cefda..01f0441 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(CCLite VERSION 0.2.0 LANGUAGES C Fortran) +project(CCLite VERSION 0.2.10 LANGUAGES C Fortran) set(CMAKE_Fortran_STANDARD 2018) set(CMAKE_Fortran_STANDARD_REQUIRED ON) diff --git a/README.md b/README.md index c12ed8a..4fe7cc5 100644 --- a/README.md +++ b/README.md @@ -17,19 +17,40 @@ CCLite、SPHLite、FEMLite 均保持独立主控程序形态。CCLite 作为联 CCLite 不替代 SPHLite 或 FEMLite,不负责 SPH/FEM 内部求解、材料本构、网格生成或粒子生成。 -## 第一阶段目标 +## 当前状态 -第一版优先支持: +当前发布候选:`0.2.10`。 + +0.2.x 已完成基础 SPH 粒子到 FEM facet 的法向 penalty contact 最小闭环: 1. Windows / gfortran / 本机共享内存; 2. CCLite Controller + SPHLite/FEMLite 独立进程; 3. 大数据共享内存交换,小命令控制 IPC; -4. 三文件 `.inp` 输入体系; -5. 显式-显式同步 SPH-FEM 接触; -6. SPH 粒子到 FEM 面/壳面的 penalty damping 接触; -7. 接触报告、通信报告、时间步报告和力平衡报告。 +4. Abaqus 风格 `.inp` 输入; +5. `*CCLITE SURFACE INTERACTION` 和 `*CCLITE CONTACT PAIR`; +6. SPH particle view、FEM facet view 和 AoR v1 payload; +7. Vec3、AABB、point-segment、point-triangle 和四边形拆三角形最小路径; +8. uniform hash grid 宽相、窄相 gap/penetration/normal/shape weight; +9. 法向 penalty force、基础法向阻尼和 FEM 节点力分配; +10. `CCL_TO_SPH_FORCE` 与 `CCL_TO_FEM_LOAD` 非空写回; +11. `contact_report.csv`、`candidate_report.csv`、`force_balance.csv` 和 `ipc_report.csv`; +12. Python checker 自动验收几何、接触方向、力平衡和真实 worker gate。 -Linux 共享内存、MPI、显隐耦合、强耦合、tied coupling 和 FSI 高级能力作为后续版本预留。 +真实 SPHLite/FEMLite worker 已进入受控 gate:当前 worker 能力查询和真实 IPC attach 探测可用,但 CCLite 侧协议/命名 adapter 尚未完成进程级联调,因此状态为 `CONTROLLED_PROTOCOL_GAP`。这不等价于真实 SPH-FEM 外部进程物理联调完成。 + +Linux 共享内存、MPI、显隐耦合、强耦合、Coulomb 摩擦、tied/release、FSI、SoA v2 和工程级应用算例均作为后续版本预留。 + +## 构建和验证 + +常用本地构建: + +```powershell +cmake -S . -B build-codex-gcc +cmake --build build-codex-gcc --config Debug +ctest --test-dir build-codex-gcc -C Debug --output-on-failure +``` + +0.2.10 发布候选应通过 0.1.x 空耦合回归、0.2.x 几何/搜索/接触/力写回验证、真实 worker gate 报告检查和 UTF-8 without BOM 检查。 ## 文档 @@ -43,13 +64,10 @@ Linux 共享内存、MPI、显隐耦合、强耦合、tied coupling 和 FSI 高 6. `06_test_and_verification_plan.md`:测试与验证计划; 7. `07_real_worker_access_audit.md`:真实 worker 最小接入审计; 8. `v1.x_development_plan.md`:0.1.x 开发计划; -9. `0.1.x_interface_constants.md`:0.1.x 接口常量冻结记录; -10. `0.1.x_release_notes.md`:0.1.x 发布说明。 - -辅助讨论文档: - -1. `data_femlite_sphlite.md`:SPHLite/FEMLite 独立程序之间的数据交换与通信建议; -2. `suggests.md`:CCLite 定位、边界和版本路线建议。 +9. `v2.x_development_plan.md`:0.2.x 开发计划; +10. `0.1.x_interface_constants.md`:0.1.x 接口常量冻结记录; +11. `0.1.x_release_notes.md`:0.1.x 发布说明; +12. `0.2.x_release_notes.md`:0.2.x 发布说明。 ## 编码要求 diff --git a/docs/0.2.x_release_notes.md b/docs/0.2.x_release_notes.md new file mode 100644 index 0000000..89b110c --- /dev/null +++ b/docs/0.2.x_release_notes.md @@ -0,0 +1,104 @@ +# CCLite 0.2.x 发布说明 + +## 1. 版本定位 + +0.2.x 是 CCLite 的基础 SPH 粒子-FEM facet penalty contact 版本。该版本在 0.1.x 主控、IPC、mock worker、AoR v1 和空耦合闭环基础上,首次形成可自动验收的接触力闭环。 + +发布候选号: + +```text +CCLite 0.2.10 +``` + +## 2. 已完成功能 + +0.2.x 完成以下能力: + +1. `.inp` 支持 `*CCLITE SURFACE INTERACTION`,并支持 `NORMAL=PENALTY`、`KN`、`CN`、`FRICTION=0`; +2. `.inp` 支持 `*CCLITE CONTACT PAIR`,并支持 `TYPE=SPH_PARTICLE_TO_FEM_FACE`; +3. SPH particle view 可从 AoR v1 `SPH_TO_CCL_PARTICLE` payload 构建; +4. FEM facet view 可从 AoR v1 `FEM_TO_CCL_FACET` payload 构建; +5. Vec3、AABB、point-segment、point-triangle 和四边形拆三角形最小路径已进入测试; +6. uniform hash grid 可生成并去重 SPH particle-FEM facet 候选对; +7. 窄相可生成 gap、penetration、normal、shape weight 和跳过原因计数; +8. 法向 penalty force 和基础法向阻尼可生成 SPH 接触力; +9. FEM 节点反力按 shape weight 分配,满足作用-反作用合力平衡; +10. `CCL_TO_SPH_FORCE` 和 `CCL_TO_FEM_LOAD` 可写入非空载荷并被 mock worker 消费; +11. `contact_report.csv`、`candidate_report.csv`、`force_balance.csv` 和 `ipc_report.csv` 可由 checker 自动检查; +12. `V020_GEOMETRY_PRIMITIVES`、`V020_SINGLE_PARTICLE_WALL`、`V020_MULTI_PARTICLE_PLANE`、`V020_FORCE_BALANCE` 已进入回归; +13. `V020_SINGLE_REAL_WORKER_SMOKE` 已形成真实 worker gate 报告,当前状态为 `CONTROLLED_PROTOCOL_GAP`。 + +## 3. 验证状态 + +0.2.10 发布候选验证范围: + +1. 0.1.x smoke、parser、IPC、command/data block 和空耦合回归; +2. 0.2.x contact parser、interface view、geometry、broad phase、narrow phase、penalty force 单元测试; +3. 双 mock worker 的接触 controller 集成测试; +4. 单粒子撞面、多粒子压面、force balance 算例; +5. 真实 worker 能力查询、attach 探测和 gate 报告检查; +6. UTF-8 without BOM 检查; +7. 干净构建目录重建与全量测试。 + +当前自动测试集合包含 37 个 CTest 测试项。0.2.10 发布候选提交前已执行: + +```text +build-codex-gcc: 37/37 PASS +build-codex-gcc-clean-0210-unix: 37/37 PASS +cclite --version: CCLite 0.2.10 +``` + +## 4. 真实 Worker Gate + +真实 worker gate 编号: + +```text +V020_SINGLE_REAL_WORKER_SMOKE +``` + +当前结论: + +```text +EXTERNAL_WORKERS_READY_CCLITE_PROTOCOL_ADAPTER_REQUIRED +gate_status: CONTROLLED_PROTOCOL_GAP +``` + +含义: + +1. SPHLite 和 FEMLite 均可报告 CCLite worker 能力; +2. 两侧均报告 Windows shared memory/named event 的真实 IPC 后端能力; +3. 两侧 worker CLI 均能进入真实 IPC attach 尝试; +4. CCLite 与真实 worker 的命名、command block 和 data header 仍需要 adapter; +5. 0.2.x 不声明真实 SPHLite/FEMLite 外部进程物理联调完成。 + +详细记录见 `docs/07_real_worker_access_audit.md`。 + +## 5. 未完成能力 + +以下能力不属于 0.2.x 已完成范围: + +1. Coulomb 摩擦; +2. 完整 edge fallback; +3. 四边形双线性投影; +4. 壳厚度高级接触; +5. contact persistence; +6. 自动 penalty 参数估计; +7. 接触稳定时间步; +8. 接触能量诊断; +9. tied coupling 和 release; +10. pressure projection、boundary/ghost particle 和 Riemann FSI; +11. SoA v2 性能布局; +12. Linux/MPI 生产后端; +13. 工程级水下爆炸或船体局部破坏算例。 + +## 6. 后续 0.3.x 入口条件 + +0.3.x 建议从以下方向开始: + +1. 完整 edge fallback 验收; +2. 四边形接触一致性补强; +3. 壳厚度几何和接触距离补强; +4. contact persistence 初步; +5. 真实 SPHLite/FEMLite adapter 的 1 step 和 100 step 空耦合 gate。 + +0.3.x 开发不得把 0.2.x 的 `CONTROLLED_PROTOCOL_GAP` 解释为真实外部物理联调已经完成。 diff --git a/docs/03_detailed_design.md b/docs/03_detailed_design.md index 8dfa13b..7261dae 100644 --- a/docs/03_detailed_design.md +++ b/docs/03_detailed_design.md @@ -45,6 +45,8 @@ CCLite 负责 SPHLite 与 FEMLite 之间的数据交换、接触/耦合算法和 ## 2.1 源码目录 +本节给出长期推荐结构。0.2.10 当前实现已按职责拆分,但目录名以现有仓库为准,见 2.3。 + ```text CCLite/ ├── Makefile @@ -115,7 +117,30 @@ CCLite/ └── docs/ ``` -## 2.2 命名约定 +## 2.2 0.2.10 当前实现目录 + +0.2.10 发布候选中的实际源码边界为: + +```text +src/ + app/ cclite 主程序入口 + common/ 版本、错误码和日志 + case/ .inp 解析、case model 和校验 + controller/ worker 调度、step loop、接触流程和诊断调用 + diagnostics/ run.log、ipc、candidate、contact 和 force balance 输出 + geometry/ Vec3、AABB、最近点和基础几何 + search/ uniform hash grid 和候选对 + contact/ 窄相接触和 penalty force + transfer/ SPH/FEM interface view 与 load buffer + interface_data/ command block、data block 和 AoR v1 record + ipc/ Windows shared memory 和 named event + platform/ worker 进程启动、等待和终止 + mock_workers/ mock SPH/FEM worker service +``` + +0.2.10 不把接触算法写入 SPHLite 或 FEMLite 内部;真实 worker 接入仍由 `docs/07_real_worker_access_audit.md` 中的 adapter gate 管理。 + +## 2.3 命名约定 ```text ccl_ Fortran procedure/module 前缀 @@ -1103,4 +1128,3 @@ Windows API、句柄、事件、共享内存映射只在 IPC 层出现。接触 # 18. 总结 CCLite 详细设计以三独立进程和本机共享内存为核心:CCLite 负责主控与接触算法,SPHLite/FEMLite 负责各自求解。Fortran95 保持算法核心简洁稳定,Fortran2018 与 C/C++ 薄层承担共享内存和 IPC。第一版交付重点是 `.inp` 主控、Windows/gfortran 通信闭环、显式同步 SPH-FEM penalty 接触和完整诊断。 - diff --git a/docs/05_interface_control_document.md b/docs/05_interface_control_document.md index 2924e36..ef78bc4 100644 --- a/docs/05_interface_control_document.md +++ b/docs/05_interface_control_document.md @@ -113,8 +113,8 @@ CCLite 负责创建和销毁所有共享内存和 named event。求解器 worker 示例: ```text -CCLITE_CASE001_COMMAND_SPH -CCLITE_CASE001_COMMAND_FEM +CCLITE_CASE001_CCL_COMMAND_SPH +CCLITE_CASE001_CCL_COMMAND_FEM CCLITE_CASE001_SPH_TO_CCL_PARTICLE CCLITE_CASE001_FEM_TO_CCL_FACET CCLITE_CASE001_CCL_TO_SPH_FORCE @@ -149,6 +149,13 @@ femlite.exe --cclite-worker --solver-id FEM --case femlite.inp --ipc-name CCLITE | `--workdir` | 否 | worker 工作目录 | | `--timeout-ms` | 否 | worker 默认等待超时 | +0.2.10 实现状态: + +1. CCLite mock worker 已按本文档 generic command/data block 完成 0.1.x 空耦合和 0.2.x 基础接触验收; +2. 真实 SPHLite/FEMLite worker 已可进行能力查询和真实 IPC attach 探测; +3. 真实 worker 与 CCLite generic block 之间仍需 solver-specific adapter; +4. `V020_SINGLE_REAL_WORKER_SMOKE` 当前结果为 `CONTROLLED_PROTOCOL_GAP`,不得解释为真实外部进程物理联调完成。 + ## 3.2 worker 行为 worker 模式下,求解器不得自行完整运行到结束,而是等待 CCLite 命令。 diff --git a/docs/06_test_and_verification_plan.md b/docs/06_test_and_verification_plan.md index 8842630..3e6121e 100644 --- a/docs/06_test_and_verification_plan.md +++ b/docs/06_test_and_verification_plan.md @@ -1849,7 +1849,9 @@ FSI 算例应优先使用小规模、可解释模型,避免过早使用复杂 3. 单粒子撞刚性面; 4. 多粒子压平面; 5. 力平衡测试; -6. CCLite + 至少一个真实 worker 集成测试。 +6. `V020_SINGLE_REAL_WORKER_SMOKE`:至少一条真实 worker 路径通过,或输出包含阻塞字段的 `CONTROLLED_PROTOCOL_GAP` 报告。 + +0.2.x 的 A 层算法验收以 mock worker 为主。真实 worker gate 用于防止接口风险被隐藏;在 adapter 通过前,不把 `supports_real_ipc=yes` 解释为真实 SPH-FEM 外部物理联调完成。 ## 11.3 0.3.x 壳、边缘与四边形接触 diff --git a/docs/07_real_worker_access_audit.md b/docs/07_real_worker_access_audit.md index a1233f8..49e92ed 100644 --- a/docs/07_real_worker_access_audit.md +++ b/docs/07_real_worker_access_audit.md @@ -2,7 +2,7 @@ ## 1. 审计结论 -CCLite 0.2.9 将真实 worker 审计提升为 `V020_SINGLE_REAL_WORKER_SMOKE` gate。该 gate 的目的不是声明真实 SPHLite/FEMLite 外部进程物理联调完成,而是确认当前 worker 能力、统一入口、协议差异和后续 adapter 缺口。 +CCLite 0.2.9 将真实 worker 审计提升为 `V020_SINGLE_REAL_WORKER_SMOKE` gate。0.2.10 发布候选继续复用该 gate 作为真实 worker 接入边界。该 gate 的目的不是声明真实 SPHLite/FEMLite 外部进程物理联调完成,而是确认当前 worker 能力、统一入口、协议差异和后续 adapter 缺口。 当前结论为: diff --git a/src/common/ccl_version.f90 b/src/common/ccl_version.f90 index 1fb59b8..ef4c7ee 100644 --- a/src/common/ccl_version.f90 +++ b/src/common/ccl_version.f90 @@ -3,8 +3,8 @@ module ccl_version integer, parameter :: CCL_VERSION_MAJOR = 0 integer, parameter :: CCL_VERSION_MINOR = 2 - integer, parameter :: CCL_VERSION_PATCH = 0 - character(len=*), parameter :: CCL_VERSION_LABEL = "0.2.0-dev" + integer, parameter :: CCL_VERSION_PATCH = 10 + character(len=*), parameter :: CCL_VERSION_LABEL = "0.2.10" contains diff --git a/tests/verification/README.md b/tests/verification/README.md index 17cb757..bae2b89 100644 --- a/tests/verification/README.md +++ b/tests/verification/README.md @@ -10,8 +10,9 @@ Verification tests, including `V010_EMPTY_COUPLING`. 4. `V020_FORCE_BALANCE`; 5. `V020_SINGLE_REAL_WORKER_SMOKE`. -0.2.8 已接入: +0.2.10 已接入: 1. `v020_geometry_primitives.csv`:几何 primitive checker 输入; 2. `check_v020_geometry_primitives.py`:几何验证报告生成; -3. `check_v020_contact.py`:读取 contact、candidate、force balance 和 IPC 报告,生成接触验证报告。 +3. `check_v020_contact.py`:读取 contact、candidate、force balance 和 IPC 报告,生成接触验证报告; +4. `check_v020_real_worker_gate.py`:读取真实 worker 审计报告,确认 pass 或受控协议缺口报告完整。 diff --git a/todo.md b/todo.md index cf6d054..f141875 100644 --- a/todo.md +++ b/todo.md @@ -415,57 +415,57 @@ 目标:收束 0.2.x,确认基础接触力闭环、回归、文档和发布说明一致。 -- [ ] T0210-01 执行 0.1.x 全量回归。 +- [x] T0210-01 执行 0.1.x 全量回归。 完成判据:0.1.x 空耦合、IPC、parser 和诊断测试不退化。 -- [ ] T0210-02 执行 0.2.x 单元测试。 +- [x] T0210-02 执行 0.2.x 单元测试。 完成判据:contact parser、geometry、search、narrow phase、penalty force 和 load buffer 测试全部通过。 -- [ ] T0210-03 执行 0.2.x 集成测试。 +- [x] T0210-03 执行 0.2.x 集成测试。 完成判据:双 mock workers 的单粒子撞面、多粒子压面和 force balance 算例通过。 -- [ ] T0210-04 执行真实 worker gate 测试。 +- [x] T0210-04 执行真实 worker gate 测试。 完成判据:至少一条单真实 worker 路径通过,或受控协议缺口报告完整。 -- [ ] T0210-05 执行 UTF-8 without BOM 检查。 +- [x] T0210-05 执行 UTF-8 without BOM 检查。 完成判据:新增文档、`.inp` 样例和 Python 文本文件均无 BOM。 -- [ ] T0210-06 检查文档与接口一致性。 +- [x] T0210-06 检查文档与接口一致性。 完成判据:03、04、05、06、07 号文档与实现字段、命令、输出和限制一致。 -- [ ] T0210-07 整理 `docs/0.2.x_release_notes.md`。 +- [x] T0210-07 整理 `docs/0.2.x_release_notes.md`。 完成判据:列出完成能力、未完成能力、真实 worker gate 状态和后续 0.3.x 入口条件。 -- [ ] T0210-08 更新 README 的 0.2.x 状态。 +- [x] T0210-08 更新 README 的 0.2.x 状态。 完成判据:README 准确描述基础 penalty contact、平台边界和未启用能力。 -- [ ] T0210-09 将版本输出切到发布候选号。 +- [x] T0210-09 将版本输出切到发布候选号。 完成判据:`cclite --version` 输出 `0.2.10` 或约定的 0.2.x 发布候选号。 -- [ ] T0210-10 执行干净环境重建。 +- [x] T0210-10 执行干净环境重建。 完成判据:从干净构建目录可完成构建、smoke、0.1.x 回归和 0.2.x 验证。 -- [ ] T0210-11 检查 0.2.x 不越界声明。 +- [x] T0210-11 检查 0.2.x 不越界声明。 完成判据:文档和日志不宣称摩擦、tied/release、FSI、SoA v2、Linux/MPI 或工程级应用已完成。 -- [ ] T0210-12 完成 0.2.x 发布提交。 +- [x] T0210-12 完成 0.2.x 发布提交。 完成判据:所有 0.2.x 变更已提交,工作区无非预期未跟踪文件。 # 13. 0.2.x 总体验收清单 -- [ ] A0201 CCLite 保持独立主控程序身份。 -- [ ] A0202 0.1.x 通信和空耦合能力不退化。 -- [ ] A0203 `.inp` 可定义基础 `NORMAL=PENALTY` 接触。 -- [ ] A0204 `CONTACT PAIR` 可绑定 interface 与 interaction。 -- [ ] A0205 SPH particle view 可从 AoR v1 payload 构建。 -- [ ] A0206 FEM facet view 可从 AoR v1 payload 构建。 -- [ ] A0207 Vec3、AABB、point-segment 和 point-triangle 通过测试。 -- [ ] A0208 uniform hash grid 可生成去重候选对。 -- [ ] A0209 窄相可生成 gap、penetration、normal 和 shape weight。 -- [ ] A0210 法向 penalty force 方向和大小可由手算算例验证。 -- [ ] A0211 FEM 节点力分配满足作用-反作用平衡。 -- [ ] A0212 `CCL_TO_SPH_FORCE` 可写入非空载荷。 -- [ ] A0213 `CCL_TO_FEM_LOAD` 可写入非空载荷。 +- [x] A0201 CCLite 保持独立主控程序身份。 +- [x] A0202 0.1.x 通信和空耦合能力不退化。 +- [x] A0203 `.inp` 可定义基础 `NORMAL=PENALTY` 接触。 +- [x] A0204 `CONTACT PAIR` 可绑定 interface 与 interaction。 +- [x] A0205 SPH particle view 可从 AoR v1 payload 构建。 +- [x] A0206 FEM facet view 可从 AoR v1 payload 构建。 +- [x] A0207 Vec3、AABB、point-segment 和 point-triangle 通过测试。 +- [x] A0208 uniform hash grid 可生成去重候选对。 +- [x] A0209 窄相可生成 gap、penetration、normal 和 shape weight。 +- [x] A0210 法向 penalty force 方向和大小可由手算算例验证。 +- [x] A0211 FEM 节点力分配满足作用-反作用平衡。 +- [x] A0212 `CCL_TO_SPH_FORCE` 可写入非空载荷。 +- [x] A0213 `CCL_TO_FEM_LOAD` 可写入非空载荷。 - [x] A0214 `contact_report.csv` 可被 checker 自动检查。 - [x] A0215 `force_balance.csv` 包含接触力和力矩诊断。 - [x] A0216 `V020_GEOMETRY_PRIMITIVES` 通过。 @@ -473,8 +473,8 @@ - [x] A0218 `V020_MULTI_PARTICLE_PLANE` 通过。 - [x] A0219 `V020_FORCE_BALANCE` 通过。 - [x] A0220 单真实 worker gate 通过或形成受控协议缺口。 -- [ ] A0221 所有新增文档和样例为 UTF-8 without BOM。 -- [ ] A0222 0.2.x 不声明超出版本边界的能力。 +- [x] A0221 所有新增文档和样例为 UTF-8 without BOM。 +- [x] A0222 0.2.x 不声明超出版本边界的能力。 # 14. 暂不进入 0.2.x 的事项