# CCLite 数学模型与算法说明书 ## Coupling & Contact Lite for SPHLite and FEMLite **文档版本**:V0.2 草案 **软件名称**:CCLite **文档定位**:全开发周期数学模型与算法总纲 **实现基线**:Fortran95 算法核心 + Fortran2018/C IPC 数据通信层 **输入基线**:Abaqus 风格 `.inp` **第一阶段平台**:Windows / gfortran / 本机共享内存 --- # 1. 文档定位与算法边界 ## 1.1 文档目的 本文档定义 CCLite 在整个开发周期内采用的数学模型、算法边界、符号体系、几何模型、接触模型、耦合模型、时间耦合框架、稳定性控制和诊断量。 本文档是 CCLite 的算法理论总纲,不是单一版本实现清单。具体实现结构、通信接口和测试验收分别由 03、05、06 号文档进一步约束。 ## 1.2 算法责任 CCLite 只处理 SPHLite 与 FEMLite 之间的跨域界面问题,包括: 1. SPH 粒子/边界粒子与 FEM 边界面之间的几何搜索; 2. SPH-FEM 接触检测; 3. SPH-FEM 接触力、界面力、压力、牵引和冲量传递; 4. SPH-FEM tied coupling、release 和 tie-to-contact 转换; 5. SPH-FEM FSI 界面压力、速度和边界状态传递; 6. 时间耦合、子循环、松弛和强耦合迭代框架; 7. 界面守恒、能量、动量、接触和通信诊断。 CCLite 不处理: 1. SPH 内部控制方程、EOS、本构和邻域求和; 2. FEM 单元刚度、质量、内力、本构和内部接触; 3. SPHLite/FEMLite 的网格、粒子和几何前处理; 4. SPHLite/FEMLite 私有状态更新。 ## 1.3 引用与自洽规则 第 4 章和第 5 章会直接影响软件架构,必须遵守以下规则: 1. 采用成熟算法时,正文给出引用标号,并在第 13 章列出出处; 2. 没有明确出处时,必须补充完整公式、变量定义和伪代码; 3. CCLite 自行规定的算法写为“CCLite 工程约定”; 4. 未进入当前实现周期的算法必须明确标注实现版本; 5. 引用、公式、伪代码和实现状态必须能被 05 号接口文档和 06 号测试文档追踪。 --- # 2. 符号、坐标与单位约定 ## 2.1 基本符号 | 符号 | 含义 | | --- | --- | | `i` | SPH 粒子编号 | | `a` | FEM facet 编号 | | `A` | FEM 节点编号 | | `x_i` | SPH 粒子当前位置 | | `v_i` | SPH 粒子速度 | | `a_i` | SPH 粒子加速度 | | `m_i` | SPH 粒子质量 | | `rho_i` | SPH 粒子密度 | | `p_i` | SPH 粒子压力 | | `h_i` | SPH 粒子光滑长度 | | `r_i` | SPH 粒子接触半径 | | `x_A` | FEM 节点当前位置 | | `v_A` | FEM 节点速度 | | `n_a` | FEM facet 单位法向 | | `A_a` | FEM facet 面积 | | `t_a` | FEM 壳厚度 | | `N_A` | facet 最近点处节点权重 | | `x_c` | SPH 粒子到 FEM facet 的最近点 | | `v_c` | 最近点处 FEM 速度 | | `g` | 法向间隙 | | `d` | 穿透量 | | `f_i` | CCLite 作用于 SPH 粒子的界面力 | | `F_A` | CCLite 作用于 FEM 节点的界面力 | | `dt` | CCLite 耦合时间步 | ## 2.2 坐标和法向 CCLite 采用全局笛卡尔坐标系。向量默认按三维列向量理解。 FEM facet 法向 `n_a` 优先由 FEMLite 导出。CCLite 可在单个接触对内部构造修正法向 `n`,但不得修改 FEMLite 原始 facet 法向。 法向正负约定: ```text n 由 FEM 最近点 x_c 指向 SPH 粒子 x_i ``` 若 FEMLite 导出的 `n_a` 与该方向相反,则接触对局部采用: ```text n = -n_a ``` ## 2.3 单位 CCLite 不强制单位体系。SPHLite、FEMLite 和 CCLite 输入必须使用一致单位。CCLite 输出不做单位换算。 --- # 3. 界面数据抽象 ## 3.1 SPH 侧数学对象 SPH 粒子数学状态记为: ```text P_i = { id_i, phase_i, status_i, material_i, section_i, m_i, rho_i, p_i, h_i, r_i, x_i, v_i, a_i } ``` SPH 侧 region 是粒子集合: ```text R_s = { P_i | i in I_s } ``` 后续版本可引入 SPH 壳粒子、boundary particle、ghost particle 和 SPH facet proxy。它们均视为 SPH 侧公开界面对象,不视为 CCLite 私有求解状态。 ## 3.2 FEM 侧数学对象 FEM facet 数学状态记为: ```text S_a = { facet_id_a, node_ids_a, x_A, v_A, n_a, A_a, t_a } ``` FEM surface 是 facet 集合: ```text S_f = { S_a | a in I_f } ``` FEM facet 上任意点的坐标和速度由节点插值得到: ```text x(u,v) = sum_A N_A(u,v) x_A v(u,v) = sum_A N_A(u,v) v_A ``` ## 3.3 界面对象 CCLite 界面对象为: ```text I = { R_s, S_f, M } ``` 其中 `M` 是界面算法族,例如 contact、tie、pressure projection 或 Riemann FSI。 --- # 4. 几何搜索与接触检测模型 ## 4.1 本章定位 本章定义 CCLite 所有接触与耦合算法共用的几何基础。宽相搜索、最近点、壳厚度、边缘 fallback 等算法直接决定 05 号文档中的数据字段和后续 Fortran 数据结构。 本章中通用碰撞检测、AABB、最近点和层次包围体概念参考计算几何和实时碰撞检测资料 [Ericson2005]。BVH/OBBTree 作为后续预留时参考 [Gottschalk1996]。uniform spatial hashing 作为动态点-面宽相搜索方案时参考 [Teschner2003]。 ## 4.2 几何 primitive ### 4.2.1 SPH 粒子 primitive 第一阶段将 SPH 粒子建模为球形接触 primitive: ```text B_i = { x | ||x - x_i|| <= r_i } ``` 其中 `x_i` 是粒子中心,`r_i` 是接触半径。 CCLite 工程约定: 1. 若 SPHLite 显式导出 `r_i`,则直接使用; 2. 若 SPHLite 只导出 `h_i`,则允许通过输入参数 `alpha_r` 定义 `r_i = alpha_r h_i`; 3. `alpha_r` 必须写入 `cclite.inp` 或采用文档化默认值; 4. 该半径只用于跨域接触,不改变 SPHLite 内部光滑核。 ### 4.2.2 FEM facet primitive FEM 三角形 facet: ```text T_a = { x_1, x_2, x_3, n_a, A_a, t_a } ``` FEM 四边形 facet: ```text Q_a = { x_1, x_2, x_3, x_4, n_a, A_a, t_a } ``` 四边形第一阶段采用三角形拆分: ```text Q_a -> T_a^1 = (x_1, x_2, x_3) Q_a -> T_a^2 = (x_1, x_3, x_4) ``` 该方案是 CCLite 工程约定。优点是实现简单、可复用 point-triangle 算法;局限是非平面四边形的最近点会依赖拆分对角线。后续版本可增加双线性四边形投影。 ### 4.2.3 FEM 壳 primitive FEM 壳面采用中面 + 厚度模型: ```text S_a^shell = { mid-surface facet S_a, thickness t_a } ``` CCLite 不在几何层重构壳截面;壳厚度只进入接触距离和诊断。 ## 4.3 AABB 与包围盒扩展 SPH 粒子的 AABB: ```text AABB_i.min = x_i - (r_i + delta_s) [1,1,1] AABB_i.max = x_i + (r_i + delta_s) [1,1,1] ``` 其中 `delta_s` 是搜索裕量。 FEM facet 的 AABB: ```text AABB_a.min_k = min_A x_Ak - (0.5 t_a + delta_s) AABB_a.max_k = max_A x_Ak + (0.5 t_a + delta_s) ``` 对于实体 facet,`t_a = 0`。 ## 4.4 宽相搜索 第一阶段采用 uniform hash grid。其目标是从 SPH 粒子集合 `R_s` 和 FEM facet 集合 `S_f` 中生成候选对集合: ```text C = { (i,a) | AABB_i intersects AABB_a } ``` cell size 取: ```text l_cell = beta_cell * max(r_i + 0.5 t_a + delta_s) ``` 第一阶段默认 `beta_cell >= 1`。若局部粒径差异很大,应在 0.8.x 后引入多层 grid 或 BVH。 宽相伪代码: ```text build_fem_grid(fem_facets): clear grid for each facet a: box_a = expanded_aabb(a) cells = cells_overlapped_by(box_a) for each cell c in cells: insert a into grid[c] query_candidates(sph_particles): candidates = empty for each particle i: box_i = particle_aabb(i) cells = cells_overlapped_by(box_i) for each cell c in cells: for each facet a in grid[c]: if aabb_overlap(box_i, box_a): add candidate(i, a) sort candidates by (i, a) remove duplicate candidates ``` 该流程参考 spatial hashing 的基本思想 [Teschner2003]。CCLite 对 cell size、去重和每步 rebuild 的具体选择属于工程实现。 ## 4.5 窄相最近点 ### 4.5.1 点到线段 线段端点为 `x_0`、`x_1`,粒子点为 `x_i`: ```text e = x_1 - x_0 s = dot(x_i - x_0, e) / dot(e, e) s_bar = min(1, max(0, s)) x_e = x_0 + s_bar e ``` 若 `dot(e,e)` 小于退化阈值,则该边退化为点,取 `x_e = x_0`。 ### 4.5.2 点到三角形 三角形顶点为 `x_1, x_2, x_3`。最近点可按 Voronoi 区域分区计算 [Ericson2005]。 CCLite 文档采用等价工程伪代码描述: ```text closest_point_triangle(p, a, b, c): compute barycentric coordinates of projection on triangle plane if barycentric all inside [0,1]: return projected point and weights q_ab = closest_point_segment(p, a, b) q_bc = closest_point_segment(p, b, c) q_ca = closest_point_segment(p, c, a) return q with minimum distance among q_ab, q_bc, q_ca ``` 投影在三角形内部时: ```text x_c = lambda_1 x_1 + lambda_2 x_2 + lambda_3 x_3 lambda_1 + lambda_2 + lambda_3 = 1 lambda_A >= 0 ``` 节点权重取: ```text N_A = lambda_A ``` 若最近点在边上,边端点权重由线段参数 `s_bar` 给出,第三点权重为 0。 ### 4.5.3 点到四边形 第一阶段四边形拆为两个三角形: ```text T1 = (x_1, x_2, x_3) T2 = (x_1, x_3, x_4) ``` 分别计算 `x_c^1`、`x_c^2`,取距离更小者。 为避免同一四边形两半产生重复接触,最终仍只生成一个 `(i,a)` contact pair。 ## 4.6 法向间隙、壳厚度和穿透量 最近点为 `x_c`,初始 facet 法向为 `n_a`。 CCLite 接触对局部法向: ```text if dot(x_i - x_c, n_a) >= 0: n = n_a else: n = -n_a ``` 法向间隙: ```text g = dot(x_i - x_c, n) ``` 有效接触距离: ```text r_c = r_i + 0.5 t_a ``` 穿透量: ```text d = r_c - g ``` 接触判定: ```text contact if d > 0 ``` 这是 CCLite 工程约定。它适用于 SPH 粒子与 FEM facet 的离散点-面接触。对于真实厚壳截面、非平面壳、复杂边界曲率和大滑移,该模型只是近似。 ## 4.7 Edge fallback 点到面检测可能漏掉 facet 边缘附近的接触。CCLite 在以下情况下执行 edge fallback: 1. 最近点落在三角形/四边形边界区域; 2. point-face 未接触,但粒子 AABB 与 facet AABB 重叠; 3. 输入要求启用边缘增强检测。 边缘接触流程: ```text edge_fallback(particle i, facet a): best_dist = infinity for each edge e of facet a: x_e = closest_point_segment(x_i, edge.start, edge.end) dist = norm(x_i - x_e) if dist < best_dist: best_dist = dist best_point = x_e best_edge = e if best_dist < r_c: n = normalize(x_i - best_point) d = r_c - best_dist create edge contact ``` 若 `norm(x_i - best_point)` 小于阈值,法向退化。此时优先使用 facet 法向;若 facet 法向也无效,则丢弃该候选并计入诊断。 ## 4.8 退化和异常几何 必须诊断以下情况: 1. facet 面积小于阈值; 2. facet 法向非有限或长度接近零; 3. edge 长度接近零; 4. 四边形拆分后三角形退化; 5. 最近点权重非有限; 6. AABB min/max 非有限。 退化候选不得产生接触力。 ## 4.9 第 4 章算法实现版本 | 算法项 | 首次实现 | 完整/补强版本 | | --- | --- | --- | | SPH 粒子球形 primitive | 0.2.x | 0.4.x | | FEM 三角形/四边形 facet primitive | 0.2.x | 0.3.x | | FEM 壳中面 + 厚度 | 0.3.x | 0.4.x | | uniform hash grid | 0.2.x | 0.8.x | | point-triangle 最近点 | 0.2.x | 0.3.x | | point-quad 拆三角形 | 0.2.x | 0.3.x | | point-edge fallback | 0.3.x | 0.4.x | | BVH/AABB tree | 预留 | 0.8.x 或以后 | | SPH 壳粒子 primitive | 0.5.x | 0.7.x | | SPH facet proxy | 0.6.x | 0.7.x | --- # 5. 接触力与摩擦模型 ## 5.1 本章定位 本章定义 SPH-FEM 接触力模型。接触力模型以接触力学中的单侧接触约束和 penalty 正则化思想为基础 [Wriggers2006, Laursen2002]。第一阶段采用显式友好的 penalty damping 接触;摩擦和接触历史在后续版本补齐。 ## 5.2 单侧接触约束 理想无粘接法向接触满足 Signorini 条件: ```text g >= 0 p_n >= 0 g p_n = 0 ``` 其中 `g` 是真实间隙,`p_n` 是法向接触压力或等效法向接触反力。 离散 SPH-FEM 接触中,CCLite 使用穿透量 `d`: ```text d = max(0, r_c - g) ``` 若 `d = 0`,不产生法向接触力。 ## 5.3 Penalty 法向力 法向 penalty 力: ```text f_n = k_n d n ``` 其中: | 符号 | 含义 | | --- | --- | | `k_n` | 法向 penalty 刚度 | | `d` | 穿透量 | | `n` | 从 FEM 最近点指向 SPH 粒子的局部法向 | CCLite 施加给 SPH 粒子的法向力为: ```text f_i^n = f_n ``` 施加给 FEM facet 的合力为: ```text F_a^n = -f_i^n ``` ## 5.4 法向阻尼 最近点 FEM 速度: ```text v_c = sum_A N_A v_A ``` 法向相对速度: ```text v_n = dot(v_i - v_c, n) ``` 只在闭合速度时加入阻尼: ```text f_d = c_n max(0, -v_n) n ``` 法向总力: ```text f_i = (k_n d + c_n max(0, -v_n)) n ``` 这是 CCLite 的显式接触工程模型。它是 penalty contact 在跨求解器点-面接触上的离散形式。 ## 5.5 FEM 节点力分配 FEM facet 反力: ```text F_a = -f_i ``` 分配到节点: ```text F_A = N_A F_a ``` 节点力平衡: ```text sum_A F_A = F_a ``` 若使用三角形权重,`N_A` 为 barycentric 权重;若接触来自 edge fallback,边上两个节点使用线段权重,其余节点权重为 0。 ## 5.6 接触力矩一致性 关于参考点 `x_ref` 的 SPH 侧力矩: ```text M_s = (x_i - x_ref) cross f_i ``` FEM 侧节点力矩: ```text M_f = sum_A (x_A - x_ref) cross F_A ``` 离散分配导致的力矩误差: ```text e_M = || M_s + M_f || ``` `e_M` 必须输出诊断。第一阶段不强制力矩完全一致,但不允许非有限或无界增长。 ## 5.7 Coulomb 摩擦模型 切向相对速度: ```text v_t = (v_i - v_c) - v_n n ``` 切向单位方向: ```text if ||v_t|| > eps_v: t = -v_t / ||v_t|| else: t = 0 ``` 滑动摩擦力: ```text f_t = mu ||f_n|| t ``` 为避免速度接近零时不连续,后续版本采用正则化: ```text f_t = mu ||f_n|| min(1, ||v_t|| / v_reg) t ``` 摩擦模型参考计算接触力学中的 Coulomb 摩擦处理 [Wriggers2006, Laursen2002]。第一阶段仅预留,不进入 0.2.x 验收;0.4.x 进入工程可用接触模型。 ## 5.8 Penalty 参数估计 ### 5.8.1 基于时间步的刚度 给定等效质量 `m_eff` 和目标接触时间步 `dt_c`: ```text k_n = gamma_k m_eff / dt_c^2 ``` 其中 `gamma_k` 为安全系数。 等效质量可取: ```text m_eff = m_i ``` 若 FEM facet 节点质量可用,可取两侧等效质量: ```text 1/m_eff = 1/m_i + 1/m_f ``` ### 5.8.2 阻尼估计 临界阻尼形式: ```text c_crit = 2 sqrt(k_n m_eff) c_n = eta_c c_crit ``` 其中 `eta_c` 为阻尼比。 这些参数估计是 CCLite 工程约定,必须在输入和输出中记录。 ## 5.9 接触力算法伪代码 ```text compute_contact_force(pair): d = pair.penetration if d <= 0: return zero force n = pair.normal v_c = sum_A N_A v_A v_rel = v_i - v_c v_n = dot(v_rel, n) f = (k_n * d + c_n * max(0, -v_n)) * n if friction_enabled: v_t = v_rel - v_n * n f = f + regularized_coulomb_force(v_t, f, mu) write SPH force +f distribute FEM force -f by N_A update diagnostics ``` ## 5.10 第 5 章算法实现版本 | 算法项 | 首次实现 | 完整/补强版本 | | --- | --- | --- | | 单侧接触变量 `g,d,n` | 0.2.x | 0.3.x | | penalty 法向力 | 0.2.x | 0.4.x | | 法向阻尼 | 0.2.x | 0.4.x | | FEM 节点力分配 | 0.2.x | 0.4.x | | 力/力矩平衡诊断 | 0.2.x | 0.8.x | | Coulomb 摩擦 | 0.4.x | 0.8.x | | 自动 penalty 参数 | 0.4.x | 0.8.x | | 接触历史与 persistence | 0.3.x | 0.8.x | --- # 6. Tied Coupling 与 Release 模型 ## 6.1 Penalty tie SPH 粒子 `i` 与 FEM facet 最近点 `x_c` 建立 bond: ```text b = { i, a, N_A, x_i^0, x_c^0, delta_0 } ``` 当前相对位移: ```text delta = x_i - sum_A N_A x_A ``` Penalty tie 力: ```text f_i^tie = -k_tie (delta - delta_0) - c_tie (v_i - sum_A N_A v_A) ``` FEM 节点反力: ```text F_A^tie = -N_A f_i^tie ``` 该方法属于 CCLite 工程化 penalty tie。更严格的 kinematic constraint、mortar tie 或 Lagrange multiplier tie 可作为后续高级方法。 ## 6.2 Release 准则 Bond release 可由损伤、拉开位移或界面力触发: ```text release if D >= D_crit release if ||delta - delta_0|| >= delta_crit release if ||f_i^tie|| >= f_crit ``` 释放后: ```text bond_state = RELEASED if contact_after_release: activate contact detection for same interface ``` ## 6.3 能量记录 Tie 弹性能: ```text E_tie = 0.5 k_tie ||delta - delta_0||^2 ``` Release 时必须记录释放能量,并在诊断中区分: 1. tie 储能; 2. release 损失能; 3. release 后接触功。 ## 6.4 实现版本 Penalty tie 在 0.5.x 首次实现。Release 与 tie-to-contact 在 0.5.x 建立闭环,0.8.x 补强能量一致性、历史变量和异常诊断。 --- # 7. FSI 压力、速度与边界粒子模型 ## 7.1 Pressure projection SPH 压力投影到 FEM facet 的目标是从 SPH 粒子压力得到 facet 等效压力: ```text p_a = sum_i w_ia p_i / sum_i w_ia ``` 权重可采用核函数或距离权重: ```text w_ia = W(||x_i - x_a||, h_i) ``` 其中 `x_a` 可取 facet 中心或积分点。投影压力产生 FEM 侧合力: ```text F_a^p = -p_a A_a n_a ``` 节点力: ```text F_A^p = N_A F_a^p ``` 该模型是 CCLite 的压力投影工程模型。SPH 基本理论参考 [Gingold1977, Lucy1977, Monaghan1992];SPH 边界和流固耦合处理可参考 [Adami2012, Akinci2012]。 ## 7.2 FEM 运动边界到 SPH FEM facet 最近点速度: ```text v_c = sum_A N_A v_A ``` CCLite 可向 SPHLite 输出: ```text boundary_velocity = v_c boundary_position = x_c boundary_normal = n_a ``` SPHLite 如何把该边界状态纳入内部 SPH 邻域求和不由 CCLite 决定。 ## 7.3 Boundary/ghost particle 若 CCLite 生成 boundary particle,其状态应由 FEM facet 采样得到: ```text x_b = sample_point_on_facet(a) v_b = sum_A N_A(x_b) v_A n_b = n_a ``` Ghost state 可按镜像速度构造: ```text v_ghost = 2 v_b - v_i ``` 这是边界处理的工程约定,后续必须结合 SPHLite 内部 SPH 边界模型校准。0.6.x 建立基础能力,0.8.x 做稳定化和诊断补强。 --- # 8. Riemann FSI 界面模型 ## 8.1 界面状态 Riemann FSI 用于强冲击、水下爆炸和可压缩流固界面。界面法向为 `n`。 SPH 侧状态: ```text rho_L, p_L, u_L = dot(v_L, n), c_L ``` FEM/结构侧等效状态: ```text rho_R, p_R, u_R = dot(v_R, n), c_R ``` 其中 `c_L`、`c_R` 是声速或等效阻抗参数。SPH EOS 由 SPHLite 提供,CCLite 只使用导出的压力、密度和声速/阻抗。 ## 8.2 声阻抗近似 Riemann 解 声阻抗: ```text Z_L = rho_L c_L Z_R = rho_R c_R ``` CCLite 可采用线性声学近似: ```text p_star = (Z_R p_L + Z_L p_R + Z_L Z_R (u_L - u_R)) / (Z_L + Z_R) u_star = (Z_L u_L + Z_R u_R + p_L - p_R) / (Z_L + Z_R) ``` 该公式是 CCLite 的近似界面 Riemann 工程模型。若后续采用完整非线性 Riemann solver,应以可压缩流理论和 SPH Riemann 方法文献为准。 ## 8.3 界面载荷 Riemann 压力作用于 FEM facet: ```text F_a^R = -p_star A_a n ``` 反作用于 SPH 侧边界: ```text f_sph^R = +p_star A_a n ``` 实际分配给 SPH 粒子或 boundary particle 的方式由 SPHLite 可接受接口决定。 ## 8.4 实现版本 Riemann FSI 在 0.7.x 完成主要算法引入。0.8.x 后进行稳定化、EOS 接口细化、冲击场景验收和能量诊断补强。 --- # 9. 时间耦合数学框架 ## 9.1 显式-显式同步 同步耦合时间步: ```text dt = min(dt_sph, dt_fem, dt_contact) ``` 流程: ```text for each step n: SPHLite exports U_s^n FEMLite exports U_f^n CCLite computes interface loads L^n SPHLite imports L_s^n FEMLite imports L_f^n SPHLite advances to n+1 FEMLite advances to n+1 ``` 该模式在 0.2.x 起作为基础接触主流程。 ## 9.2 显式-显式异步子循环 若 `dt_sph < dt_fem`: ```text m = ceil(dt_fem / dt_sph) dt_sub = dt_fem / m ``` SPH 子循环累积冲量: ```text J = sum_{k=1}^m f_k dt_sub ``` 传给 FEM 的平均力: ```text F_bar = J / dt_fem ``` 该模式在 0.7.x 完成主要算法实现,0.8.x 补强能量和稳定性诊断。 ## 9.3 SPH 显式 + FEM 隐式弱耦合 弱耦合流程: ```text FEM predicts interface motion SPH advances with prescribed interface state CCLite accumulates SPH interface impulse FEM implicit step uses averaged interface load ``` 弱耦合适合 added-mass 效应不强的场景。强 added-mass 问题需要强耦合或松弛,相关稳定性问题参考 partitioned FSI 文献 [Causin2005]。 ## 9.4 强耦合迭代 每个宏步内迭代: ```text for k = 1..kmax: SPH solve/predict with interface state q^k CCLite transfers load/displacement FEM solve with transferred load compute residual r^k if ||r^k|| < tol: accept q^{k+1} = q^k + omega_k correction ``` Aitken 动态松弛: ```text omega_k = -omega_{k-1} * dot(r^{k-1}, r^k - r^{k-1}) / ||r^k - r^{k-1}||^2 ``` 动态松弛参考 partitioned FSI 中固定点迭代加速方法 [Kuttler2008]。 --- # 10. 稳定性控制 ## 10.1 接触稳定时间步 接触振子估计: ```text omega_c = sqrt(k_n / m_eff) dt_contact = gamma_dt / omega_c ``` 其中 `gamma_dt < 1`。 ## 10.2 Force relaxation 载荷松弛: ```text f_relaxed^n = alpha f_raw^n + (1 - alpha) f_relaxed^{n-1} ``` `alpha in (0,1]`。 ## 10.3 接触 persistence 为避免接触对闪烁,可引入激活/释放阈值: ```text activate if d > d_on keep active if d > -d_off release if d <= -d_off ``` 其中 `d_off >= 0`。 ## 10.4 非有限值保护 以下量必须检查有限性: ```text x, v, n, g, d, f, F, p, rho, dt ``` 发现非有限值时,当前接触对不应写入载荷;若数量超过阈值,应终止当前步。 --- # 11. 守恒与诊断量 ## 11.1 总力误差 ```text E_F = || sum_i f_i + sum_A F_A || ``` 相对误差: ```text e_F = E_F / max(eps, ||sum_i f_i|| + ||sum_A F_A||) ``` ## 11.2 总力矩误差 ```text E_M = || sum_i (x_i - x_ref) cross f_i + sum_A (x_A - x_ref) cross F_A || ``` ## 11.3 接触功 每步接触功: ```text W_c^n = sum_pairs f_pair^n dot v_rel^n dt ``` 累计接触功: ```text W_c = sum_n W_c^n ``` ## 11.4 冲量交换 ```text J_s = sum_n sum_i f_i^n dt J_f = sum_n sum_A F_A^n dt ``` 诊断要求: ```text J_s + J_f approx 0 ``` ## 11.5 接触诊断 必须输出: 1. active pair count; 2. candidate count; 3. max penetration; 4. max contact force; 5. edge fallback count; 6. degenerate geometry count; 7. nonfinite count。 --- # 12. 算法实现版本映射 本章只说明各版本实现目标,不改变前文数学模型的组织方式。 | 版本线 | 目标 | 算法状态 | | --- | --- | --- | | 0.1.x | 三进程主控、`.inp`、IPC、共享内存、空耦合 | 无真实界面算法,仅验证数据闭环 | | 0.2.x | SPH 粒子-FEM 面/壳基础 penalty contact | 基础接触算法首次实现 | | 0.3.x | 壳厚度、边缘接触、四边形面、接触 persistence | 接触检测基本完整 | | 0.4.x | 阻尼、摩擦、自动 penalty、接触稳定时间步 | 接触算法工程可用 | | 0.5.x | tied coupling、penalty tie、damage release、tie-to-contact | 固-固/局部破坏耦合可用 | | 0.6.x | pressure projection、FEM 运动边界、boundary/ghost 状态 | 基础 FSI 可用 | | 0.7.x | Riemann FSI、显式异步子循环、显隐弱耦合、强耦合框架 | 主要算法体系全部实现 | | 0.8.x | 稳定化、松弛、接触历史、能量修正、异常处理 | 算法鲁棒性增强 | | 0.9.x | 工程算例覆盖、参数推荐、验收矩阵、性能优化 | 工程试用候选 | | 0.10.x | 接口冻结、文档冻结、回归体系、工程发布候选 | 工程化基线候选 | --- # 13. 参考文献与出处管理 ## 13.1 计算几何与碰撞检测 [Ericson2005] Christer Ericson. *Real-Time Collision Detection*. Morgan Kaufmann, 2005. Companion site: https://realtimecollisiondetection.net/ [Gottschalk1996] S. Gottschalk, M. C. Lin, D. Manocha. OBBTree: A Hierarchical Structure for Rapid Interference Detection. SIGGRAPH 1996. UNC RAPID/OBBTree site: https://gamma.cs.unc.edu/OBB/ [Teschner2003] M. Teschner, B. Heidelberger, M. Muller, D. Pomeranets, M. Gross. Optimized Spatial Hashing for Collision Detection of Deformable Objects. VMV 2003. ## 13.2 SPH 与边界处理 [Gingold1977] R. A. Gingold, J. J. Monaghan. Smoothed particle hydrodynamics: theory and application to non-spherical stars. *Monthly Notices of the Royal Astronomical Society*, 1977. [Lucy1977] L. B. Lucy. A numerical approach to the testing of the fission hypothesis. *The Astronomical Journal*, 1977. [Monaghan1992] J. J. Monaghan. Smoothed Particle Hydrodynamics. *Annual Review of Astronomy and Astrophysics*, 1992. [Adami2012] S. Adami, X. Y. Hu, N. A. Adams. A generalized wall boundary condition for smoothed particle hydrodynamics. *Journal of Computational Physics*, 2012. [Akinci2012] N. Akinci, M. Ihmsen, G. Akinci, B. Solenthaler, M. Teschner. Versatile Rigid-Fluid Coupling for Incompressible SPH. *ACM Transactions on Graphics*, 2012. ## 13.3 接触力学 [Wriggers2006] P. Wriggers. *Computational Contact Mechanics*. 2nd edition, Springer, 2006. [Laursen2002] T. A. Laursen. *Computational Contact and Impact Mechanics*. Springer, 2002. ## 13.4 FSI 与分区耦合 [Causin2005] P. Causin, J. F. Gerbeau, F. Nobile. Added-mass effect in the design of partitioned algorithms for fluid-structure problems. *Computer Methods in Applied Mechanics and Engineering*, 2005. [Kuttler2008] U. Kuttler, W. A. Wall. Fixed-point fluid-structure interaction solvers with dynamic relaxation. *Computational Mechanics*, 2008. ## 13.5 Riemann 方法 [Toro2009] E. F. Toro. *Riemann Solvers and Numerical Methods for Fluid Dynamics*. 3rd edition, Springer, 2009.