Release FemLite 0.3.0
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-06-23 19:28:44 +08:00
parent f838ccc099
commit be02684827
74 changed files with 11618 additions and 201 deletions
+163 -17
View File
@@ -29,14 +29,21 @@
- 可选线性和二次 bulk viscosity。
- SPH 压力、剪切力和节点力映射。
第二版应补充:
第二版应补充或形成最小可用框架:
- 基于 F = Fe Fp 的有限应变塑性。
- Rayleigh 阻尼。
- 接触算法。
- 隐式 Newmark + Newton 非线性算法。
- 基础 penalty 接触算法。
- 隐式线弹性小变形求解最小流程。
- C3D10、C3D20、S3、S6、S8。
- 更完整的壳 hourglass 控制。
第三版应补充:
- 线性静力学算法。
- 非线性静力学 Newton-Raphson 算法。
- 壳单元线性静力刚度。
- 隐式 Newmark + Newton 非线性动力学算法。
- Rayleigh 阻尼在隐式路径中的一致接入。
- 通用接触搜索、节点-面接触和面-面接触框架。
- 更完整的壳 hourglass 控制、drilling DOF 稳定和壳塑性路径。
## 3. 符号与约定
@@ -98,6 +105,18 @@ t = -p n + tau_s on Gamma_sph
M a + C v + F_int(u, state) = F_ext + F_sph + F_contact
```
线性静力方程:
```text
K u = F_ext
```
非线性静力平衡方程:
```text
R(u, state) = F_ext - F_int(u, state) - F_contact(u) = 0
```
第一版不实现接触,故实际显式残差为:
```text
@@ -205,7 +224,7 @@ I_i += rho A_e h^3 / (12 nnode)
- 第一版默认无 Rayleigh 阻尼。
- 第一版支持可选线性和二次 bulk viscosity。
- 第二版实现 Rayleigh 阻尼。
- 第三版在隐式动力路径中实现 Rayleigh 阻尼。
bulk viscosity 可写为等效附加压力:
@@ -371,8 +390,9 @@ kappa_s = 5 / 6
- S4 可用于板受压力脉冲等基础动力响应。
- S4 大转动能力有限。
- hourglass 控制第二版完善。
- hourglass 控制第三版完善。
- S3、S6、S8 第二版实现。
- 壳单元线性静力刚度第三版实现并用于 Scordelis-Lo 验证。
S4 删除默认规则:
@@ -464,7 +484,7 @@ W = skew(L)
应力更新采用 Cauchy 应力和 Jaumann 客观率。塑性修正仍采用 J2 偏应力返回思想。
第二版应补充:
第三版或后续应补充:
```text
F = Fe Fp
@@ -640,31 +660,147 @@ Delta_W_ext = 0.5 (F_ext_n + F_ext_(n+1)) . Delta_u
SPH 功按 fsph 单独累计。
## 16. 隐式算法预留
## 16. 静力与隐式算法
第二版隐式算法采用 Newmark + Newton。
第二版提供隐式线弹性小变形求解最小流程:
预留方程:
```text
K u = F_ext
```
该流程用于验证 CSR 装配、线性求解器、Dirichlet 约束和小型实体静力算例。
第三版线性静力算法正式支持实体和壳单元:
```text
assemble K
assemble F_ext
apply Dirichlet, MPC and Robin terms
solve K u = F_ext
recover strain, stress and reaction
write static output
```
第三版非线性静力算法采用 Newton-Raphson:
```text
for each load increment:
predict u
for each Newton iteration:
compute F_int(u, state_trial)
compute R = F_ext - F_int - F_contact
assemble K_tangent
apply constraints
solve K_tangent Delta_u = R
update u
check force and displacement convergence
commit state
```
当前 V3.4/V3.5 阶段实现采用 Newton 形式:
- 残差使用当前位移下的非线性内力 `F_int(u,state)`。
- 实体单元切线使用当前积分点弹性/J2 算法切线;壳单元膜内项对 J2/J2_JC 使用当前积分点算法切线,壳弯曲和横向剪切项暂保留弹性近似。
- Dirichlet、CLOAD、DLOAD、Robin、MPC、SPH/contact 外力向量进入静力残差。
- Robin、MPC、刚性平面 penalty contact 和面-面 contact pair 切线进入 Newton 切线矩阵。
- 材料状态和单元删除标志采用增量级 trial/restore/commit;非收敛时恢复到增量起点。
- Newton 线搜索默认启用;可选步长缩减在增量失败时回退到增量起点并缩小当前增量。
第三版隐式动力算法采用 Newmark + Newton。
有效残差方程:
```text
R(u) = F_ext - F_int(u,state) - M a - C v
K_eff Delta_u = R
```
当前 V3.5 阶段实现提供线性 Newmark 和非线性 Newmark-Newton 骨架。默认参数:
```text
beta = 1/4
gamma = 1/2
```
预测量:
```text
u_pred = u_n + dt v_n + dt^2 (1/2 - beta) a_n
v_pred = v_n + dt (1 - gamma) a_n
```
当前线性有效方程:
```text
a0 = 1 / (beta dt^2)
K_eff = K + a0 M
K_eff u_{n+1} = F_{n+1} + a0 M u_pred
a_{n+1} = a0 (u_{n+1} - u_pred)
v_{n+1} = v_pred + gamma dt a_{n+1}
```
Rayleigh 阻尼:
```text
C = alpha_M M + beta_K K
K_eff = K + a0 M + a1 C
```
非线性 Newmark-Newton 骨架:
```text
u_trial = u_pred + Delta_u
a_trial = a0 (u_trial - u_pred)
v_trial = v_pred + gamma dt a_trial
R = F_ext(t_{n+1}) - F_int(u_trial,state) - M a_trial - C v_trial
K_eff Delta_u = R
```
当前实现中 `K_eff` 使用当前实体材料算法切线、壳膜内塑性算法切线或壳弹性近似切线、集中质量矩阵、Rayleigh 阻尼和外部约束/接触切线形成。收敛判据使用绝对力残差和相对力残差,Dirichlet 约束自由度的位移增量残差置零。非线性 Newmark 支持线搜索;可选步长缩减在单步失败时恢复运动学量和材料 trial 状态后重试。
当前限制:
- Rayleigh 阻尼已在线性 Newmark 和非线性 Newmark-Newton 骨架中接入。
- 实体 J2 非线性 Newmark 使用当前积分点算法切线,壳膜内 J2/J2_JC 使用当前积分点算法切线,壳弯曲/剪切塑性切线仍为后续增强项。
- 材料状态和单元删除标志已具备 trial/restore/commit 机制。
- Robin 和 MPC 的非线性动力切线已接入 `K_eff`。
- 刚性平面 contact 和面-面 contact pair 的 penalty/damping 切线已接入 `K_eff`。
- 主要用于验证质量矩阵、CSR 有效刚度、Dirichlet 约束和命令行流程。
第一版不装配全局刚度矩阵,不要求算法切线用于求解。
## 17. 接触算法预留
第三版应记录:
第二版实现接触。
- 每个增量的 Newton 迭代次数。
- 初始残差、当前残差和相对残差。
- 线性求解器迭代次数。
- 收敛、失败和步长缩减状态。
预留方向:
## 17. 接触算法
第二版实现基础 penalty 接触。
第三版接触算法方向:
- penalty 接触。
- 接触搜索。
- 通用接触搜索。
- 节点-面接触。
- 面-面接触框架。
- 接触法向与穿透量。
- 接触阻尼。
- 摩擦接口预留。
- 静力接触和动力接触统一残差接口。
- 接触功输出。
当前第三版阶段实现:
- 刚性平面接触仍采用节点到平面的 penalty/damping 法向接触。
- 面-面 contact pair 使用边界 facet 的当前构形坐标、速度、法向和面积。
- slave facet 质心投影到 master facet 平面,投影点落在 master facet 等效半径和搜索距离内且法向间隙为负时激活。
- 接触力为 `penalty * penetration * area` 加可选法向阻尼项,均分到 slave 和 master facet 节点。
- 接触切线采用法向 penalty/damping 块,装配 slave-slave、slave-master、master-slave 和 master-master 四类自由度耦合。
- 当前尚未实现摩擦、mortar 积分、精确面内投影裁剪、空间加速搜索和完整接触功统计。
第一版不实现接触,只保留 fcontact 向量和接口位置。
## 18. 稳定性与误差控制
@@ -700,6 +836,17 @@ K_eff Delta_u = R
- 板受压力脉冲。
- 简化 SPH-FEM 边界力传递接口。
第三版验收算例:
- 实体单元线弹性静力 patch test。
- 实体单元单轴拉伸静力。
- 实体单元 J2 弹塑性静力加载卸载。
- Scordelis-Lo 壳静力基准。
- 板壳弯曲静力基准。
- 隐式动力弹性波传播。
- 简化接触静力压入。
- 简化接触动力冲击。
算法专项验证:
- 小应变 J2 单点返回映射。
@@ -708,4 +855,3 @@ K_eff Delta_u = R
- 绝热温升单点测试。
- 单元删除规则测试。
- 压力符号测试。