Release FemLite 0.5.2 V5 closeout
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-07-01 14:51:40 +08:00
parent 5e90d58d0e
commit 75d4e735b1
82 changed files with 9972 additions and 2613 deletions
+24 -25
View File
@@ -102,13 +102,11 @@ src/interface C ABI 和 Fortran-C bridge
| `fem_material_mc_envelope` | Mohr-Coulomb 包络、margin 和 safety ratio helper |
| `fem_strength_reduction*` | 强度折减参数、trial 搜索状态和报告输出 |
| `fem_element_stiffness` | 实体/壳单元静力刚度 |
| `fem_shell_corotational` | 迁移期 S4 corotational 临时模块;finite-strain S4 完成后删除生产入口和接口 |
| `fem_shell_rotation` | V5.11 目标模块:壳节点 finite rotation trial/commit/rollback |
| `fem_shell_finite_kinematics` | V5.11 目标模块:S4 finite membrane strain、director、metric 和曲率增量 |
| `fem_shell_assumed_strain` | V5.11 目标模块:MITC/ANS shear 和 assumed strain 采样 |
| `fem_shell_nonlinear_driver` | V5.11 目标模块:finite-strain S4 内力装配调度 |
| `fem_shell_tangent` | V5.11 目标模块:material/geometric/rotation/drilling 解析一致切线 |
| `fem_shell_drilling` | V5.11 目标模块:drilling rotation 稳定化和诊断 |
| `fem_shell_rotation` | V5.11 生产模块:壳节点 finite rotation trial/commit/rollback/restart |
| `fem_shell_finite_kinematics` | V5.11 生产模块:S4 finite membrane strain、director、metric、曲率增量和 MITC shear 采样 |
| `fem_shell_finite_tangent` | V5.11 生产模块:S4 finite-strain B 矩阵、B 线性化、几何/旋转切线和高斯点切线 |
| `fem_shell_finite_element` | V5.11 生产模块:S4 finite-strain 内力/刚度装配、section resultants/tangent 调度和 drilling 能量项 |
| `fem_shell_section` | 壳单层、多层和 layer plastic section resultants/tangent 唯一生产入口 |
| `fem_dload_tangent` | 壳 `DLOAD P` current-geometry follower-pressure tangent 装配 |
| `fem_geometric_stiffness` | 线性屈曲几何刚度 helper,当前覆盖梁柱几何刚度 |
| `fem_element_internal` | 单元内力 |
@@ -289,17 +287,17 @@ damped/trust-limited 修正范数;NC-4 的目标位移必须使用求解时实
局部 Mohr-Coulomb 子步控制量也放在 `fem_control`,解析留在 `fem_inp_nlc`;
生产材料分发通过 `fem_material_j2` 进入 `fem_material_mc_driver`,不要在
benchmark 工具里重写材料积分。
S4 几何非线性开关同样属于生产路径。V5.11 后续目标接口是
`SHELL_GEOMETRIC=FINITE_STRAIN`/`LINEAR`;迁移期 `SHELL_GEOMETRIC=YES/NO` 可兼容,
但 `GEOMETRIC_SHELL`、`COROTATIONAL_SHELL` 和 `S4_COROTATIONAL` 属于旧
corotational 尝试遗留别名,finite-strain S4 完成后必须删除解析、测试、文档和示例入口。
S4 几何非线性开关同样属于生产路径。V5.11 稳定接口是
`SHELL_GEOMETRIC=FINITE_STRAIN`/`LINEAR`;旧布尔写法和旧 shell 几何名称已经从稳定
接口中移除,解析层只允许将其作为输入错误拒绝。`FINITE_STRAIN` 当前只支持 S4;
S3/S6/S8 必须在调度层清晰报 unsupported,不能隐式走线性壳。
修改该语义时必须同步 `test_shell_internal`、`test_implicit_inp`、spherical-cap
checker、算法文档、接口文档和用户手册;不要在 `examples/` 或 `tools/` 里实现替代壳
后屈曲逻辑。
强度折减相关模块分层如下:`fem_strength_reduction` 保存参数折减、bracket 更新和失稳指标;`fem_strength_reduction_driver` 保存 trial 搜索状态、上下界、收敛系数和历史记录;`fem_strength_reduction_report` 只负责 CSV/summary 输出。结构求解器接入边坡强度折减时,应把结构 trial 的残差、位移范数、塑性区比例和收敛失败标志传给 driver,不要在材料更新内部直接控制全局安全系数搜索。
V5.5 线性屈曲相关模块分层如下:`fem_geometric_stiffness` 只生成单元级几何刚度矩阵;`fem_eigensolver` 只负责小规模 dense 特征值算法、模态归一化和残差;`fem_buckling_solver` 只组合屈曲问题入口、几何刚度符号约定和解析 helper;`fem_buckling_column` 负责 Euler 柱专用 `*BUCKLING COLUMN` 读取、梁柱装配、主 `femlite --buckling` 求解和 CSV 输出。当前广义特征值入口要求参考几何刚度矩阵 SPD,适合解析基准和小规模工程验收;完整通用 `*BUCKLING`、静力预载后的壳/实体几何刚度和大规模稀疏屈曲求解仍需后续内部算法扩展,不能通过第三方库或外部求解器绕过当前模块边界。
V5.5 线性屈曲相关模块分层如下:`fem_geometric_stiffness` 生成单元级几何刚度矩阵,当前包含 truss-style 线几何刚度、Euler 梁柱几何刚度、轴向应力投影 helper,以及 C3D4/C3D8 实体 initial-stress `K_G` 子集;`fem_eigensolver` 只负责小规模 dense 特征值算法、模态归一化和残差;`fem_buckling_solver` 只组合屈曲问题入口、几何刚度符号约定和解析 helper;`fem_buckling_general` 负责普通 INP `*BUCKLING` 的小规模 dense 主流程,复用已装配线弹性 `K`,并支持显式 `*BUCKLING GEOMETRIC LINE` truss-style `K_G`、`*BUCKLING GEOMETRIC LINE, PRELOAD` 的预载派生线刚度子集,以及 `*STATIC` 后直接 `*BUCKLING` 时的 C3D4/C3D8 实体 initial-stress 几何刚度子集;`fem_cyclic_constraints` 将普通 INP `*CYCLIC SYMMETRY` 的 WAVE=0 显式节点对展开为 MPC 罚约束,覆盖 3-DOF 实体节点和 6-DOF 壳节点转角映射;通用 buckling 的 summary 和 modal CSV 通过普通输出目录工作流写出;`fem_buckling_column` 负责 Euler 柱专用 `*BUCKLING COLUMN` 读取、梁柱装配、主 `femlite --buckling` 求解和 CSV 输出。当前广义特征值入口要求参考几何刚度矩阵 SPD,适合解析基准和小规模工程验收;完整静力预载后的壳几何刚度、高阶实体几何刚度、自动循环边界配对、非零谐波主求解语义和大规模稀疏屈曲求解仍需后续内部算法扩展,不能通过第三方库或外部求解器绕过当前模块边界。
V5.6 滚压相关模块分层如下:`fem_rigid_roller` 负责刚体辊位姿、接触点相对速度、经典 Coulomb 牵引和正则化牵引;`fem_roller_schedule` 负责平移/下压/角速度时间调度;`fem_roll_metrics` 负责压力、摩擦功率、力矩、残余位移和回弹比例等过程指标。滚压接触扩展应继续复用通用接触与摩擦路径,不应在 solver 中新增只服务于单一示例的快捷通道。`roller_regularized_traction` 使用切向相对速度和 `tanh(slip/reference_speed)` 平滑因子,使角速度在小滑移正则化区间改变牵引幅值;修改该公式时必须同步更新 `test_rigid_roller`、滚压 benchmark checker 和算法文档。
@@ -327,24 +325,25 @@ V4.7 壳稳定和壳塑性维护约定:
- 壳刚度装配后的稳定性统计也放在 `fem_control`,测试中通过 `test_element_stiffness` 和 `test_c_api` 同时覆盖内部变量和外部接口。
- 当前 J2 弯曲塑性使用代表性外纤维应变近似,不是完整厚度方向 plastic
integration。V5.11 已有弹性多层 `*SHELL SECTION, COMPOSITE` 的
`fem_shell_section` ABD/H 矩阵路径;后续任何多层塑性扩展都必须保留
trial/rollback 的状态一致性,并删除被完整实现取代的临时单层/外纤维近似路径。
`fem_shell_section` ABD/H 矩阵、层级塑性状态和 algorithmic tangent 路径;后续任何
section/material 修改都必须保留 trial/rollback 的状态一致性,并删除被完整实现取代的
临时单层/外纤维近似路径。
- 壳 benchmark smoke 优先放在 `example_smoke` CTest 分组,长跑或网格收敛结果不提交全量 CSV/VTK。
- V5.11 S4 corotational 基础路径是 finite-membrane-strain S4 完成前的临时债务:
默认线性 S3/S4/S6/S8 行为不变;迁移期 `SHELL_GEOMETRIC=YES` 才进入旧
S4 reference/current frame 路径。该路径当前完成对象性、ELASTIC/J2/J2_JC
corotational algorithmic tangent、弹性多层 ABD/H section 矩阵、膜/弯曲/横剪
generalized resultant-delta load-stiffness 和 shell `DLOAD P` follower-pressure
tangent,但它不是稳定接口。finite-strain S4 接管后,必须删除旧生产 dispatch、
输入别名、文档入口和只服务旧路线的测试入口,不能留下“备用”接口。
- V5.11 S4 有限应变路径必须直接接管生产几何非线性壳请求:
默认线性 S3/S4/S6/S8 行为不变;`SHELL_GEOMETRIC=FINITE_STRAIN` 对 S4 调度到
`fem_shell_finite_element`,对 S3/S6/S8 显式返回 unsupported。旧 S4
reference/current frame 诊断路径的生产 dispatch、输入别名、模块文件和只服务该路线的
测试入口已删除,不能留下“备用”接口。
`shell_resultant(1:8,gp)` 是正式积分点状态,新增或修改时必须同步 element-state
reset/trial backup/rollback。`fem_shell_section` 是 shell section 矩阵的唯一生产入口;
不要重新引入 `shell_stiffness_props`、`shell_constitutive` 或 `shell4_resultants`
这类并行单层 helper。未支持壳材料仍必须显式报材料错误,不能静默回退旧工程切线。
载荷型 Riks/arc-length 增广方程已进入非线性静力生产路径,但有限转动 director、
MITC/ANS assumed strain、解析一致切线、多层塑性 through-thickness 状态、Shell-4/8/16
剩余非线性项、全部 follower-load 类型和真实非单调结构验收完成前,不能在文档或
checker 中标为完整 postbuckling PASS。
`fem_shell_rotation` 的 DOF sync 必须使用增量旋转复合语义,不能恢复为“总旋转向量
重新作用到 committed director”的旧写法。载荷型 Riks/arc-length 增广方程、有限转动
committed/trial 状态、S4 finite kinematics、MITC shear 运动学投影、S4 finite
内力/切线、drilling 能量项和多层塑性 section 状态已进入生产路径;但 S3 finite shell、
S6/S8 finite shell、全部 follower-load 类型和真实非单调 spherical-cap 结构验收完成前,
不能在文档或 checker 中标为完整 Shell-4/8/16 postbuckling PASS。
V5.4 Mohr-Coulomb 维护约定: