24 KiB
CCLite 0.2.x 开发计划
Coupling & Contact Lite for SPHLite and FEMLite
文件名:v2.x_development_plan.md
适用版本:CCLite 0.2.x
文档依据:01_requirements.md 到 06_test_and_verification_plan.md
实现基线:CCLite 0.1.10 主控、通信、mock worker、AoR v1 和真实 worker 能力审计
核心目标:基础 SPH 粒子-FEM facet penalty contact 首次实现
第一阶段平台:Windows / gfortran / 本机共享内存
输入格式:Abaqus 风格 .inp
编码要求:中文,UTF-8 without BOM
1. 文档目的
本文档定义 CCLite 0.2.x 的开发目标、版本节奏、工作包、测试算例、验收清单和风险控制。
0.2.x 的核心目标是从 0.1.x 的通信空耦合进入基础物理接触:
- 解析
*CCLITE SURFACE INTERACTION和*CCLITE CONTACT PAIR; - 建立 SPH particle view 和 FEM facet view;
- 实现基础几何 primitive、AABB、宽相搜索和窄相最近点;
- 实现 SPH 粒子到 FEM 三角形 facet 的基础法向 penalty contact;
- 支持法向阻尼的最小可用路径;
- 将接触力写回
CCL_TO_SPH_FORCE和CCL_TO_FEM_LOAD; - 输出 contact report、force balance 和几何诊断;
- 通过
V020_GEOMETRY_PRIMITIVES、V020_SINGLE_PARTICLE_WALL和V020_MULTI_PARTICLE_PLANE; - 至少完成一条单真实 worker 集成 gate,若协议 adapter 尚未完成,则必须形成明确的受控缺口报告。
0.2.x 的成功标准不是工程级接触库,而是让 CCLite 第一次具备可验证的 SPH-FEM 基础接触力闭环。
2. 当前基线
0.1.10 已完成:
- CCLite 独立主控程序;
- Windows shared memory 与 named event 薄封装;
- command block、seq/ack、heartbeat 和 timeout;
- data block header 与 AoR v1 record;
SPH_TO_CCL_PARTICLE、FEM_TO_CCL_FACET、CCL_TO_SPH_FORCE、CCL_TO_FEM_LOAD的基础布局;- mock SPH/FEM worker service 模式;
- 1 step 与 100 step 空耦合;
run.log、ipc_report.csv、force_balance.csv;- Python checker;
- SPHLite/FEMLite 外部包能力审计。
当前真实 worker 状态:
EXTERNAL_WORKERS_READY_CCLITE_PROTOCOL_ADAPTER_REQUIRED
含义是 SPHLite/FEMLite 已报告真实 IPC 能力,但 CCLite 仍需要完成协议/命名 adapter 或统一外部二进制契约,才能声明真实外部进程联调完成。
3. 版本边界
3.1 0.2.x 必须完成
0.2.x 必须完成以下能力:
*CCLITE SURFACE INTERACTION支持NORMAL=PENALTY;*CCLITE CONTACT PAIR支持TYPE=SPH_PARTICLE_TO_FEM_FACE;- CCLite case model 保存 interaction、contact pair 和接触输出配置;
- SPH particle view 读取
external_id、internal_index、status、contact_radius、x、v; - FEM facet view 读取
facet_id、node_count、node_ids、area、thickness、normal、x、v; - 几何基础:Vec3、AABB、point-segment、point-triangle;
- 四边形 facet 可采用拆三角形的最小实现,复杂四边形一致性补强进入 0.3.x;
- uniform hash grid 宽相搜索;
- SPH 粒子到 FEM facet 的候选对生成;
- 法向间隙
g、穿透量d和局部法向n; - 法向 penalty 力和基础法向阻尼;
- FEM 节点力按 barycentric/shape weight 分配;
- SPH force record 写回;
- FEM nodal force load record 写回;
- 接触数量、最大穿透、总力、总力矩和力平衡误差诊断;
- Python checker 验证几何、接触方向和力平衡;
- 0.2.x 验证算例进入回归集合。
3.2 0.2.x 可做但不作为硬验收
以下能力可作为实现便利或实验性能力,但不得作为 0.2.x 完成定义的必要条件:
- point-edge helper;
- 平面四边形拆三角形接触;
- 单真实 worker + 单 mock worker 的调试性联调;
- 外部 worker 协议 adapter 原型;
- 接触快照 CSV;
- 简单性能计时。
3.3 0.2.x 不完成
0.2.x 不完成以下能力:
- Coulomb 摩擦;
- 接触 persistence 和历史切向变量;
- 完整 edge fallback 验收;
- 复杂壳边缘、非平面四边形和壳厚度高级接触;
- tied coupling 和 release;
- pressure projection、boundary/ghost particle 和 FSI;
- 异步子循环和强耦合迭代;
- 自动 penalty 参数推荐;
- SoA v2 性能布局;
- Linux/MPI 生产后端;
- 工程级水下爆炸或船体局部破坏算例。
4. 与 0.3.x 和 0.4.x 的分界
0.2.x 只做基础接触首次实现。
0.3.x 负责:
- 壳厚度补强;
- edge fallback 完整验收;
- 四边形接触一致性;
- contact persistence 初步;
- 接触状态连续性诊断。
0.4.x 负责:
- Coulomb 摩擦;
- 接触历史;
- penalty 参数估计;
- 接触稳定时间步;
- 接触能量耗散诊断。
0.2.x 可以保留字段和枚举,但不能把这些后续能力写成已完成。
5. 推荐 patch 版本节奏
0.2.x 内部 patch 版本建议如下。实际开发可合并相邻 patch,但不得跳过对应验收目标。
| 版本 | 主题 | 主要交付 |
|---|---|---|
| 0.2.0 | 0.2.x 入口和协议前置 | 本计划、0.2 case skeleton、真实 worker protocol adapter 设计和审计 gate |
| 0.2.1 | 接触输入与 case model | SURFACE INTERACTION、CONTACT PAIR、interaction/pair 校验 |
| 0.2.2 | 接口 view 和 load buffer | SPH particle view、FEM facet view、非空 force/load block 写回 |
| 0.2.3 | 几何 primitive | Vec3、AABB、point-segment、point-triangle、基础退化诊断 |
| 0.2.4 | 宽相搜索 | uniform hash grid、candidate pair、去重和容量保护 |
| 0.2.5 | 窄相接触 | gap、penetration、normal、shape weight、contact pair 输出 |
| 0.2.6 | penalty force | 法向 penalty、基础阻尼、FEM 节点力分配、SPH/FEM 载荷写回 |
| 0.2.7 | 诊断与 checker | contact_report.csv、force_balance.csv 增强、V020 checker |
| 0.2.8 | 验证算例 | 单粒子撞面、多粒子压面、几何/搜索/力平衡回归 |
| 0.2.9 | 单真实 worker gate | 至少完成一侧真实 worker 集成,或形成协议 adapter 受控缺口 |
| 0.2.10 | 发布候选 | 全量 0.1.x/0.2.x 回归、文档一致性、UTF-8 without BOM 检查 |
6. 交付物
6.1 程序交付物
0.2.x 应交付:
cclite.exe,支持基础 contact run;- mock SPH/FEM worker,可生成可控粒子和 facet;
- 接触算法模块;
- 几何和搜索模块;
- contact diagnostics;
- Python checker;
- 0.2.x 验证算例。
6.2 源码交付物
建议新增或补强以下目录:
src/
geometry/
contact/
search/
transfer/
verification_support/
若不新增目录,也必须在现有模块边界中保持职责清晰:
| 职责 | 建议模块 |
|---|---|
| Vec3/AABB/最近点 | src/geometry/ |
| hash grid/candidate | src/search/ |
| contact pair/penalty force | src/contact/ |
| SPH force/FEM load 写回 | src/transfer/ |
| contact report | src/diagnostics/ |
| checker | Python/checkers/ |
0.2.x 不应把接触算法写入 SPHLite 或 FEMLite 内部。
6.3 文档交付物
0.2.x 结束时应更新:
README.md;docs/03_detailed_design.md,若模块结构或数据结构变化;docs/04_mathematical_model_and_algorithms.md,若公式、伪代码或版本映射变化;docs/05_interface_control_document.md,若 block 字段、record stride、命名规则或 adapter 变化;docs/06_test_and_verification_plan.md,若新增验收算例或 checker;docs/07_real_worker_access_audit.md,若真实 worker gate 状态变化;- 本开发计划;
docs/0.2.x_release_notes.md,在发布候选阶段新增。
6.4 测试交付物
0.2.x 测试交付物包括:
- 几何单元测试;
- hash grid 单元测试;
- contact pair 单元测试;
- penalty force 单元测试;
- load buffer 单元测试;
V020_GEOMETRY_PRIMITIVES;V020_SINGLE_PARTICLE_WALL;V020_MULTI_PARTICLE_PLANE;V020_FORCE_BALANCE;V020_SINGLE_REAL_WORKER_SMOKE或受控缺口报告。
7. 工作包分解
7.1 WP00:0.1.10 到 0.2.x 交接
目标:
确认 0.1.x 通信闭环可作为 0.2.x 开发地基,并处理真实 worker 协议前置风险。
任务:
- 保留
V010_EMPTY_COUPLING为 0.2.x 回归前置; - 保留
real_worker_gap_report.json; - 梳理 SPHLite/FEMLite 当前 IPC 结构、命名规则和能力查询;
- 决定 0.2.x 是否先采用 mock worker 完成 A 层物理算法验收;
- 若做真实 worker,先实现 CCLite 侧协议 adapter 或统一外部协议;
- 记录 adapter 选择到 05 号文档。
完成标准:
- 0.1.x 全量测试通过;
- 真实 worker 状态不被误判为物理接触完成;
- 0.2.x 的 A 层 mock 算例可独立于真实 worker 运行。
7.2 WP01:接触输入与 case model
目标:
解析 0.2.x 接触输入关键词并建立内部 case model。
必须支持:
*CCLITE SURFACE INTERACTION, NAME=PENALTY_1
NORMAL=PENALTY, KN=..., CN=...
*CCLITE CONTACT PAIR, NAME=PAIR_1
INTERFACE=...
INTERACTION=...
TYPE=SPH_PARTICLE_TO_FEM_FACE
任务:
- 扩展 parser 支持 interaction 和 contact pair;
- 保存
normal_model、kn、cn和friction字段; - 0.2.x 中若
FRICTION非 0,应报错或 warning 并忽略; - 校验
CONTACT PAIR引用的 interface 与 interaction; - 校验
TYPE=SPH_PARTICLE_TO_FEM_FACE; - 输出 check summary;
- 添加非法输入测试。
完成标准:
- 合法 contact
.inp可通过cclite check; - 缺少
KN、非法NORMAL、未知 pair 引用能给出行号和错误; - 0.2.x 不把摩擦写成已启用能力。
7.3 WP02:SPH/FEM 接口 view 与 load buffer
目标:
把 AoR v1 payload 转成接触算法可用的只读 view,并把接触力写回 load block。
SPH particle view 至少包含:
external_id
internal_index
status
contact_radius
x[3]
v[3]
mass
valid_flags
FEM facet view 至少包含:
facet_id
node_count
node_ids[8]
area
thickness
normal[3]
x[8,3]
v[8,3]
valid_flags
任务:
- 建立 SPH particle view;
- 建立 FEM facet view;
- 检查有效字段、非有限值、容量和 record stride;
- 建立 SPH force accumulator;
- 建立 FEM nodal load accumulator;
- 写
CCL_TO_SPH_FORCE; - 写
CCL_TO_FEM_LOAD; - 对同一粒子或同一节点多条载荷做合并;
- 输出导入/导出计数。
完成标准:
- 空 block 仍可合法通过;
- 固定粒子和固定 facet 可生成非空 view;
- 非有限输入不进入接触力计算;
- 写回 block 可由 mock worker 消费;
- force/load record 的 step id 与 command step 匹配。
7.4 WP03:几何 primitive
目标:
实现 04 号文档第 4 章要求的 0.2.x 几何基础。
任务:
- Vec3 dot/cross/norm/normalize;
- AABB 初始化、扩展、重叠测试;
- SPH particle AABB;
- FEM facet AABB;
- point-segment closest point;
- point-triangle closest point;
- barycentric/shape weight;
- point-quad split 为两个 triangle;
- 退化边、退化三角形和非法 normal 诊断;
- 单元测试覆盖内部、边、顶点和退化输入。
完成标准:
- 点到三角形最近点误差在容差内;
- barycentric 权重和为 1;
- 退化几何不产生非有限结果;
V020_GEOMETRY_PRIMITIVES通过。
7.5 WP04:宽相搜索
目标:
实现 uniform hash grid,从 SPH particle view 和 FEM facet view 生成 candidate pair。
任务:
- 定义 grid cell size;
- facet AABB 插入 grid;
- particle AABB 查询邻近 cell;
- candidate pair 去重;
- candidate 容量保护;
- 输出 candidate 统计;
- 添加小规模和边界单元测试。
完成标准:
- 单 facet、单粒子可生成候选;
- 不接触的远距离粒子不生成候选;
- 跨 cell 边界的候选不漏检;
- 重复 facet 不导致重复 candidate;
- candidate overflow 有明确错误码。
7.6 WP05:窄相 contact pair
目标:
从 candidate pair 生成真实 contact pair。
任务:
- 对每个 candidate 计算最近点;
- 计算局部法向;
- 计算 gap;
- 计算有效接触距离;
- 计算 penetration;
- 生成 contact pair;
- 保存 shape weight 和 node_count;
- 保存 contact state;
- 记录退化和跳过原因;
- 输出
contact_report.csv。
完成标准:
- 粒子在面外无接触;
- 粒子穿透面时生成接触;
- 接触法向方向与设计一致;
penetration = r_c - g;- shape weight 可用于节点力分配;
- 退化 facet 不产生接触力。
7.7 WP06:Penalty force 与节点分配
目标:
实现基础法向 penalty damping 接触力,并写回 SPH/FEM 载荷。
0.2.x 力模型:
f_i = (k_n d + c_n max(0, -v_n)) n
FEM 节点力:
F_A = N_A (-f_i)
任务:
- 读取
KN和CN; - 计算 FEM 最近点速度;
- 计算法向相对速度;
- 计算 penalty 力;
- 计算阻尼力;
- 分配 FEM 节点力;
- 合并 SPH 粒子力;
- 合并 FEM 节点力;
- 检查非有限力;
- 输出力和力矩诊断。
完成标准:
- 无穿透时接触力为 0;
- 穿透时接触力方向正确;
- 闭合速度时阻尼力非负;
- 分配节点力合力等于 facet 反力;
- SPH/FEM 总力平衡误差小于容差;
- 非有限力被拒绝并终止当前 step。
7.8 WP07:Controller 接触 run 流程
目标:
在 0.1.x step loop 中插入真实接触计算。
0.2.x run 流程:
for each step:
send EXPORT_INTERFACE to SPH/FEM
read SPH particle block
read FEM facet block
build interface views
build broad-phase candidates
run narrow-phase contact
compute penalty loads
write CCL_TO_SPH_FORCE
write CCL_TO_FEM_LOAD
send IMPORT_LOADS
send ADVANCE
write diagnostics
任务:
- 区分 dry-run 和 contact run;
- contact run 要求 contact pair 已定义;
- 每步清零 contact/force/load accumulator;
- 读取 interface block 后执行接触;
- 写非空 load block;
- 调用
IMPORT_LOADS; - 记录 step 级诊断;
- 异常时停止两个 worker 并释放资源。
完成标准:
- 空接触 case 仍可运行;
- 单粒子撞面 case 可产生载荷;
- 接触算法错误不会造成 worker 残留;
run.log可定位输入、接口、几何或力计算错误。
7.9 WP08:诊断输出
目标:
形成可自动检查的接触诊断。
建议输出:
contact_report.csv
candidate_report.csv
force_balance.csv
ipc_report.csv
run.log
verification_report.json
contact_report.csv 建议字段:
step_id,pair_id,sph_id,facet_id,contact_type,gap,penetration,
normal_x,normal_y,normal_z,force_x,force_y,force_z,node_count
force_balance.csv 在 0.2.x 增加:
num_contacts,max_penetration,total_contact_force_norm,
moment_balance_error,nonfinite_contact_count,skipped_degenerate_count
完成标准:
- 每个 contact step 有诊断;
- 无接触时诊断仍写 0 值;
- checker 可读取并判定方向、力平衡和最大穿透;
- CSV 表头变化会触发回归失败。
7.10 WP09:Python Checker 和算例生成
目标:
使用 Python/ 支持 0.2.x 自动验收和可控算例生成。
任务:
- 新增
check_v020_geometry_primitives.py; - 新增
check_v020_contact.py; - 新增公共 contact CSV 读取工具;
- 可选新增 case generator;
- 对单粒子撞面计算参考力;
- 对多粒子压面检查总力方向和数量级;
- 生成
verification_report.json; - 返回明确退出码。
完成标准:
- checker 不依赖 CCLite 内部 Fortran 模块;
- 失败报告包含 step、pair、字段和期望/实际值;
- Python 只用于测试、算例和报告,不参与核心算法。
7.11 WP10:真实 worker adapter gate
目标:
0.2.x 起逐步接入真实 SPHLite/FEMLite worker,不让 mock 算法验收掩盖真实接口问题。
任务:
- 明确 CCLite 采用统一通用 block 还是求解器专用 adapter;
- 为 SPHLite 建立命名/结构 adapter 或要求其支持 CCLite 通用 block;
- 为 FEMLite 建立命名/结构 adapter 或要求其支持 CCLite 通用 block;
- 建立单真实 worker 1 step 空耦合;
- 建立单真实 worker 100 step 空耦合;
- 建立真实 worker payload 读取 smoke;
- 将 worker 能力查询写入验证报告;
- 若无法完成,输出
CONTROLLED_PROTOCOL_GAP,不阻塞 A 层算法验证。
完成标准:
- 至少一条单真实 worker 集成路径通过,或缺口清晰记录;
- 真实 worker 数据经过与 mock 数据相同的 header 和 payload 校验;
- 不把
supports_real_ipc=yes写成真实接触物理验收完成。
8. 0.2.x 输入样例
** CCLite 0.2.x single particle wall contact case.
*CCLITE CONTROL, NAME=V020_SINGLE_PARTICLE_WALL, MODE=RUN
VERSION=0.2
*CCLITE SOLVER, ID=SPH, KIND=SPHLITE
EXECUTABLE=mock_sph_worker.exe
INPUT=mock_sph_contact.inp
*CCLITE SOLVER, ID=FEM, KIND=FEMLITE
EXECUTABLE=mock_fem_worker.exe
INPUT=mock_fem_wall.inp
*CCLITE IPC, TYPE=WINDOWS_SHMEM
NAME_PREFIX=CCLITE_V020
BUFFER=DOUBLE
TIMEOUT_MS=5000
*CCLITE TIME
START=0.0
END=1.0e-6
DT=1.0e-6
*CCLITE INTERFACE, NAME=WALL_CONTACT
SPH_REGION=SPH_CONTACT_REGION
FEM_SURFACE=FEM_WALL
*CCLITE SURFACE INTERACTION, NAME=PENALTY_1
NORMAL=PENALTY, KN=1.0e6, CN=0.0
FRICTION=0.0
*CCLITE CONTACT PAIR, NAME=PAIR_1
INTERFACE=WALL_CONTACT
INTERACTION=PENALTY_1
TYPE=SPH_PARTICLE_TO_FEM_FACE
*CCLITE OUTPUT
DIRECTORY=output/v020_single_particle_wall
CONTACT=YES
IPC=YES
FORCE_BALANCE=YES
9. 验证算例
9.1 V020_GEOMETRY_PRIMITIVES
目标:
验证 Vec3、AABB、point-segment、point-triangle 和基础 point-quad split。
通过判据:
- 最近点位置误差小于容差;
- 权重和为 1;
- 退化几何被拒绝;
- 无非有限值输出。
9.2 V020_SINGLE_PARTICLE_WALL
目标:
验证单 SPH 粒子撞 FEM 平面 facet 的接触方向和接触力。
通过判据:
- 无穿透时接触数为 0;
- 穿透时接触数为 1;
- 法向方向正确;
- 接触力大小等于
KN * penetration,若CN=0; - FEM 节点力合力等于 SPH 反力;
- force balance error 小于容差。
9.3 V020_MULTI_PARTICLE_PLANE
目标:
验证多个 SPH 粒子同时接触同一 FEM 平面。
通过判据:
- 接触数量等于预期;
- 总 SPH 力与总 FEM 力平衡;
- 最大穿透量与输入几何一致;
- 无重复 contact pair;
- candidate 数量可复核。
9.4 V020_FORCE_BALANCE
目标:
专门验证力和力矩诊断。
通过判据:
sum_force_sph + sum_force_fem小于容差;- 力矩误差有界且非有限计数为 0;
- CSV 中每步都有 force balance 记录。
9.5 V020_SINGLE_REAL_WORKER_SMOKE
目标:
验证 CCLite 与至少一个真实 worker 的 0.2.x 接口路径。
通过判据:
- worker 能启动;
- worker 能导出非空或可控空 interface block;
- CCLite 能写回空或可控 load block;
- worker 能响应
IMPORT_LOADS、ADVANCE和STOP; - 若协议 adapter 未完成,报告必须明确写出缺口和下一步。
10. 测试计划
10.1 单元测试
0.2.x 单元测试至少覆盖:
- contact keyword parser;
- interaction/pair 引用校验;
- Vec3;
- AABB;
- point-segment;
- point-triangle;
- barycentric weight;
- hash grid;
- candidate 去重;
- contact pair;
- penalty force;
- FEM 节点分配;
- force/load block 写回;
- 非有限输入保护。
10.2 接口测试
0.2.x 接口测试至少覆盖:
SPH_TO_CCL_PARTICLE非空 payload;FEM_TO_CCL_FACET非空 payload;CCL_TO_SPH_FORCE非空 payload;CCL_TO_FEM_LOAD非空 payload;- payload record stride;
valid_flags;- step id 匹配;
- capacity overflow;
- block state 转换;
- worker 消费非空载荷。
10.3 集成测试
0.2.x 集成测试至少覆盖:
- CCLite + 双 mock workers 单粒子撞面;
- CCLite + 双 mock workers 多粒子压面;
- CCLite + 单真实 SPHLite worker + mock FEM worker,若 adapter 可用;
- CCLite + mock SPH worker + 单真实 FEMLite worker,若 adapter 可用;
- 接触输入错误;
- worker 超时;
- 非有限粒子;
- 退化 facet;
- force balance 回归;
- 0.1.x 空耦合回归。
11. 验收清单
0.2.x 发布候选必须满足:
- 0.1.x 全量回归通过;
cclite --version输出 0.2.x;cclite check支持 contact 输入;- 几何单元测试通过;
- 搜索单元测试通过;
- penalty force 单元测试通过;
- 非空 force/load block 测试通过;
V020_GEOMETRY_PRIMITIVES通过;V020_SINGLE_PARTICLE_WALL通过;V020_MULTI_PARTICLE_PLANE通过;V020_FORCE_BALANCE通过;- 至少一条单真实 worker gate 通过,或形成受控协议缺口报告;
- 接触报告、力平衡报告和验证报告完整;
- 文档与实现一致;
- UTF-8 without BOM 检查通过;
- 不声明摩擦、tied/release、FSI 或工程算例已完成。
12. 质量门禁
每个 0.2.x patch 合入前应满足:
- 构建通过;
- 新增算法有单元测试;
- 0.1.x 回归不退化;
- 新增 CSV 表头同步 checker;
- 新增
.inp样例可由cclite check解析; - 非有限输入有明确错误码;
- 接触力方向有测试;
- force balance 有测试;
- 文档为 UTF-8 without BOM;
- 不修改已冻结接口字段,除非同步更新 05 号文档。
13. 风险与对策
13.1 真实 worker 协议未对齐
风险:
SPHLite/FEMLite 已报告真实 IPC 能力,但二进制结构和命名规则与 CCLite 0.1.x 当前通用 block 不完全一致。
对策:
- 0.2.x A 层算法验收继续使用 mock worker;
- 单真实 worker gate 独立推进;
- adapter 状态写入
07_real_worker_access_audit.md; - 不把真实 worker 缺口阻塞基础 contact 算法单元测试。
13.2 接触力方向错误
风险:
法向方向、gap 符号或 SPH/FEM 反力符号错误,会导致单粒子算例看似有力但物理方向错误。
对策:
- 单粒子撞面必须有手算参考;
- force balance 必须检查作用-反作用;
- contact report 输出 normal、gap、penetration 和 force;
- 测试包含粒子在 facet 两侧的情况。
13.3 退化几何导致非有限值
风险:
退化 facet、零长度边、非法 normal 会污染接触力。
对策:
- 几何函数统一返回错误码;
- 退化候选不产生接触力;
- 诊断记录 skipped_degenerate_count;
- checker 检查非有限计数为 0。
13.4 penalty 参数过大导致数值不稳定
风险:
过大 KN 或 CN 可产生非有限力或过大速度增量。
对策:
- 0.2.x 先使用手算小算例;
- 检查力是否有限;
- 输出最大接触力和最大穿透;
- 自动 penalty 参数和稳定时间步放入 0.4.x。
13.5 范围膨胀
风险:
过早加入摩擦、tie、FSI、工程算例会拖慢基础 contact 验收。
对策:
- 0.2.x 只做基础法向 penalty contact;
- 摩擦字段可解析但不启用;
- tie 和 FSI 只保留接口字段;
- 工程算例进入 0.9.x。
14. Backlog
以下事项不进入 0.2.x 硬验收:
- 完整 edge fallback;
- 四边形双线性投影;
- 壳厚度高级几何;
- contact persistence;
- Coulomb 摩擦;
- 自动 penalty 参数;
- 接触稳定时间步;
- 接触能量诊断;
- tied/release;
- pressure projection;
- boundary/ghost particle;
- Riemann FSI;
- SoA v2;
- Linux/MPI;
- 工程简化算例。
15. 完成定义
CCLite 0.2.x 完成的定义:
- CCLite 保持独立主控程序身份;
- 0.1.x 通信和空耦合能力不退化;
- CCLite
.inp可定义基础 penalty contact; - SPH particle view 和 FEM facet view 可参与接触计算;
- 几何 primitive、宽相搜索和窄相检测通过单元测试;
- 单粒子撞面能产生方向正确的接触力;
- 多粒子压面能产生可复核的总力;
- SPH/FEM 作用-反作用误差可控;
CCL_TO_SPH_FORCE和CCL_TO_FEM_LOAD可写入非空载荷;- contact report 和 force balance 可由 checker 自动验收;
- 至少一个真实 worker 集成路径完成或形成明确协议缺口;
- 0.2.x 不宣称摩擦、tied/release、FSI 或工程级应用完成。
0.2.x 的成功标准是一条从界面数据、几何搜索、接触力计算、载荷写回到自动验收的最小物理闭环。该闭环稳定后,0.3.x 才适合继续处理壳、边缘、四边形和接触连续性。