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
+28 -13
View File
@@ -60,7 +60,7 @@ Python 环境约定:
- active set、gap residual 和 augmented penalty 诊断测试。
- 摩擦正则化、摩擦功和最大累计滑移输出测试。
- 接触示例 smoke 测试应覆盖刚性平面压入、两实体块面-面压缩和壳-刚性平面接触。
- 线性求解器分发测试应覆盖 CG、BiCGSTAB、GMRES、DENSE、none/Jacobi/Gauss-Seidel/ILU0 预条件、非法 method 拒绝和最近一次求解统计。
- 线性求解器分发测试应覆盖 CG、BiCGSTAB、GMRES、DENSE、none/Jacobi/Gauss-Seidel/ILU0 预条件、非法 method 拒绝和最近一次求解统计;BiCGSTAB/GMRES 非收敛路径必须暴露 `LS_STATUS_FAILED`、最终残差和相对残差诊断。
- 壳 V4.7 测试应覆盖 drilling 稳定参数、S3 剪切锁定折减诊断、J2 剪切/弯曲塑性、trial/rollback 和 Scordelis-Lo 静力基准 smoke。
## 4. 测试目录结构
@@ -267,12 +267,23 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- S4 J2/J2_JC 膜内塑性状态更新和膜内/弯曲/剪切 section tangent 对称性测试。
- V4.7 增加 drilling 稳定参数敏感性、S3 剪切锁定诊断、S4 J2 剪切塑性、代表性外纤维弯曲塑性和 trial rollback 回归。
- V5.11 finite-membrane-strain S4 几何非线性验收:有限转动 director
trial/rollback/commit、刚体平移/转动零内力、小转角退化到线性 S4、MITC/ANS
shear patch、解析一致切线与有限差分审计、膜力/弯矩/横剪几何刚度、drilling
稳定能量、shell `DLOAD P` follower-pressure tangent、J2/J2_JC/composite section
trial/rollback,以及 spherical-cap 非单调 postbuckling path。旧 corotational
回归仅作为迁移期防回退检查,不能作为 V5.11 PASS 依据;完整路线落地后需删除旧
输入别名和生产 dispatch。
trial/rollback/commit、增量旋转 DOF sync、运动学刚体平移/转动零应变、小转角退化到
线性 S4、MITC/ANS shear patch、生产 S4 内力/切线 dispatch、解析一致切线与有限差分
审计、膜力/弯矩/横剪几何刚度、drilling 稳定能量、shell `DLOAD P`
follower-pressure tangent、J2/J2_JC/composite section trial/rollback,以及
spherical-cap 有界非单调 postbuckling capability path。V5.11 发布验收要求可复现
post-peak load drop、明确 Shell-4 translational-rim benchmark 口径和完整 path
诊断;完整 `uz=-6.2 m` PDF 曲线匹配、Shell-4/8/16 digitized reference 全程比较、
pseudo-arclength branch following 和 late post-peak 性能优化移入下一版本增强。旧 shell 几何输入别名、旧生产 dispatch 和
只服务旧路线的回归已经删除;当前需覆盖旧名称被拒绝、S4 `FINITE_STRAIN` 进入生产路径,
以及 S3/S6/S8 `FINITE_STRAIN` 清晰报 unsupported。
- `shell_finite_kinematics` 覆盖 V5.11-3 运动学子集:小膜应变、小弯曲曲率、MITC
constant shear projection、warped reference zero strain、quaternion-state rigid
rotation zero strain 和 spherical-cap patch geometry。
- `shell_finite_element` 覆盖 V5.11 S4 生产单元路径:`fem_element_internal` /
`fem_element_stiffness` 调度、24 列元素切线有限差分审计、drilling 残差与刚度同源势能、
非对称 composite 膜-弯耦合、J2/J2_JC 大转动材料路径、composite plastic layer、
rejected trial rollback 和 unsupported finite-strain shell element 报错边界。
- Scordelis-Lo 壳静力位移基准测试。
- 板壳弯曲静力基准测试。
@@ -369,7 +380,7 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
- contact performance stats Fortran API 和 C ABI 包装层检查;小算例要求非负,空模型要求全零。
- contact cache stats Fortran API 和 C ABI 包装层检查;BVH 小算例要求 cache used 非零且 overflow 为零,空模型要求全零。
- BVH 跨调用候选缓存检查;第一次 BVH 力计算应建立缓存,第二次同几何力计算应命中缓存且 `search_bvh_nodes=0`,后续切线装配应复用同一候选缓存,slave facet 移动超过失效阈值后应失效并重新构建 BVH。
- restart v2 写读 mortar 积分点摩擦历史,验证重启后历史槽、累计滑移、摩擦功和切向力保持一致。
- restart v2 写读 mortar 积分点摩擦历史,验证重启后历史槽、累计滑移、摩擦功、切向力和 stick/slip 状态计数保持一致。
- 0.5.x restart 写读 `CONTACT_MULTIPLIER` 段,验证 active/released/open
乘子状态、已提交 lambda、trial gap 和 commit/trial 一致性在重启后保持。
- 法向接触功、摩擦功、stick/slip 计数、mortar 积分点历史槽、正则化摩擦切线和累计滑移 sanity check。
@@ -383,12 +394,16 @@ SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
检查 `contact_multiplier_audit`、`mortar_tan_audit_matrix`、
`contact_mult_report_summary`,并用 OpenMP 1/4 线程 contact/performance
smoke 防止接触统计在并行路径回退。
- V5.4 新增 `example_strength_reduction_benchmark`:运行 `examples/strengthReduction` 中按 `models.geomech.strength_reduction_method.pdf` 生成的 0.75 m 网格 C3D8 Mohr-Coulomb 坡体输入,并调用 checker 生成和检查 `strength_reduction_path.csv`、`strength_reduction_cases.csv`、summary、塑性区和位移探针;checker 同时验证输入记录 `CONFORMING_INTERFACE=YES`,并检查 `z=H1`、`x>=L2` 的上下土体界面节点被 lower/upper 元素共享。当前 FOS 参考为 8 个 PDF 工况全部收敛、最大 FOS 误差 `6.9392E-03`、86 个 trial、52 个 stable trial 和 34 个 unstable trial。可选 `--nonlinear-chain` 输出会检查 `continuation_method`、`last_dt`、`accepted_time`、`correction_norm`、目标/实际/下一 continuation 步长、adaptive adjust、trust radius、damping、merit ratio、trust rejection count、线性迭代数、线性残差和线性状态列;method 1 的两阶段 load-strength continuation 通过小参数 chain/cloud smoke 验证输出路径,NC-2 目标 Newton 步长控制和 NC-3 trust-region damped Newton 已由 `solver_implicit`、`implicit_inp` 与本 example checker 覆盖,目标 cloud 的中等 0.75 m 探针仍超过 120 s,PDF 位移云图 material case 2、`alpha=45 deg`、`FOS=1.525` 的 0.3 m 量级结果尚未作为 CTest 验收项。
- V5.4 新增 `example_strength_reduction_benchmark`:运行 `examples/strengthReduction` 中按 `models.geomech.strength_reduction_method.pdf` 几何和参考工况生成的 0.75 m 网格 C3D8 Mohr-Coulomb 边坡输入,并调用 checker 生成和检查 `strength_reduction_path.csv`、`strength_reduction_cases.csv`、summary、塑性区和位移探针;checker 同时验证输入记录 `CONFORMING_INTERFACE=YES`,并检查 `z=H1`、`x>=L2` 的上下土体界面节点被 lower/upper 元素共享。当前 FOS 参考为 8 个工况全部收敛、最大 FOS 误差 `6.9392E-03`、86 个 trial、52 个 stable trial 和 34 个 unstable trial。可选 `--nonlinear-chain` 输出会检查 `continuation_method`、`last_dt`、`accepted_time`、`correction_norm`、目标/实际/下一 continuation 步长、adaptive adjust、trust radius、damping、merit ratio、trust rejection count、线性迭代数、线性残差和线性状态列;method 1 的两阶段 load-strength continuation 通过小参数 chain/cloud smoke 验证输出路径,NC-2 目标 Newton 步长控制和 NC-3 trust-region damped Newton 已由 `solver_implicit`、`implicit_inp` 与本 example checker 覆盖。0.75 m `FOS=1.525` 位移/eqps cloud 属于边坡失稳临界现象长算例,计算量巨大,不作为 V5 CTest 或交付验收项。
- V5.5 新增 `example_euler_column_buckling_benchmark`:运行 `examples/euler_column_buckling` 的 Euler pinned-pinned column 输入,并调用 checker 生成和检查 `buckling_summary.csv` 与 `buckling_mode_1.csv`;当前参考为一阶临界载荷相对误差 `3.27660856E-05`、残差 `1.50014805E-11` 和 `phi^T K_G phi = 1.0`。
- V5.5 新增 `cli_buckling_generic_dense`:通用 `*BUCKLING` step 已能被主
INP 解析器识别,并支持小规模 dense solve。该路径复用已装配线弹性
`K`,几何刚度仅限显式 `*BUCKLING GEOMETRIC LINE` truss-style 子集;
完整静力预载后的壳/实体 `K_G` 仍需后续覆盖。
- V5.5 新增 `example_buckling_corrugated_shell_benchmark`:运行 `examples/buckling_corrugated_shell` 的紧凑循环波纹壳屈曲输入,并调用 checker 生成和检查 summary、wave sweep、modal CSV 和 profile;当前参考为 selected wave 4 load `453.031407`、critical wave 8 load `393.369677`、循环/全模型相对误差 `1.25473461E-16` 和 modal residual `1.31855319E-12`。
- V5.6 新增 `example_roll_forming_kinematics_benchmark`:运行 `examples/roll_forming` 的 roller kinematics 输入,并调用 checker 生成和检查 `roller_kinematics_history.csv` 与 summary;当前参考为 mean slip `0.4` with spin vs `0.2` without spin、mean traction `289.208274` with spin vs `228.478247` without spin、max traction delta `60.7300272` 和 positive torque `14.4604137`。
- V5.6 新增 `example_roll_forming_springback_benchmark`:运行 `examples/roll_forming` 的 springback 输入,并调用 checker 生成和检查 `springback_history.csv`、`springback_summary.csv` 与 `plastic_zone.csv`;当前参考为 springback ratio `0.473154068`、residual displacement `0.0316107559`、plastic work `1.11591736e-05`、56/81 个 active plastic points 和 residual moment 绝对值 `8.92778801e-11`。
- 已接入 `example_smoke`/`benchmark` CTest 分组:shell patch S3/S4 静力 smoke、Scordelis-Lo S3/S4 静力 smoke、clamped square plate pressure pulse S4 短步数动力 smoke、rigid sphere impact plate S3/S4 短步数动力 smoke、contact two blocks nonmatching benchmark、contact block sliding large-sliding benchmark、shell-shell contact benchmark、shell-solid contact benchmark、Mohr-Coulomb strength reduction PDF benchmark、Euler column buckling benchmark、corrugated shell cyclic buckling benchmark、roll forming kinematics benchmark、roll forming springback benchmark、ball adhesion cohesive benchmark、dynamic grain container particle benchmark、two arches reference-geometry benchmark、elliptic membrane、membrane uniaxial、shell-solid connection、golf ball impact、node analytical contact、block-on-arch、cylinder roller contact、sliding wedge、roll forming friction smoke、falling objects、ball adhesion contact、dynamic grain container pressure smoke、membrane airbag、spherical cap displacement-control benchmark、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere 和 stress dependent elasticity benchmark;接触类 smoke 检查 active contact,摩擦滑移类 smoke 检查正摩擦耗散,壳/静力基准 smoke 通过节点位移探针检查方向和最小量级,two arches benchmark 通过 checker 验证 PDF 参考坐标、30/75 壳网格、1.2 mm 上拱中点位移和 active contact,strengthReduction benchmark 通过 checker 验证 PDF 几何、0.75 m 网格、8 工况 FOS 曲线、Davis B/关联材料单调性、塑性区和位移停止准则,但不验收 PDF 位移云图,屈曲 benchmark 检查特征值、残差和模态输出,滚压 benchmark 检查旋转对 slip/traction/energy/torque 以及 J2 塑性区/回弹指标的影响,cohesive benchmark 检查拉脱力、滞回、耗散能、损伤和脱粘面积,dynamic grain benchmark 检查粒子数、粒子-facet 接触、映射节点力、容器位移、质量守恒和能量。thick plate 作为独立 NAFEMS LE10 benchmark 接入 `benchmark` 标签,检查 D 点恢复应力、位移方向和压力反力平衡;spherical cap benchmark 检查 PDF 几何、16 段经向壳网格、位移控制输入、冠点反力和无量纲曲线采样,可选 nonlinear route 还要求 post-peak load drop 与 restiffening 以防单调小应变曲线误判通过,但完整 Shell-4/8/16 postbuckling 路径必须等待 finite-membrane-strain S4、一致切线和旧 corotational 接口删除后再验收。
- 已接入 `example_smoke`/`benchmark` CTest 分组:shell patch S3/S4 静力 smoke、Scordelis-Lo S3/S4 静力 smoke、clamped square plate pressure pulse S4 短步数动力 smoke、rigid sphere impact plate S3/S4 短步数动力 smoke、contact two blocks nonmatching benchmark、contact block sliding large-sliding benchmark、shell-shell contact benchmark、shell-solid contact benchmark、Mohr-Coulomb strength reduction benchmark、Euler column buckling benchmark、corrugated shell cyclic buckling benchmark、roll forming kinematics benchmark、roll forming springback benchmark、ball adhesion cohesive benchmark、dynamic grain container particle benchmark、two arches geometry/contact smoke、two arches displacement reference-point、elliptic membrane、membrane uniaxial、shell-solid connection、golf ball impact、node analytical contact、block-on-arch、cylinder roller contact、sliding wedge、roll forming friction smoke、falling objects、ball adhesion contact、dynamic grain container pressure smoke、membrane airbag、spherical cap displacement-control benchmark、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere 和 stress dependent elasticity benchmark;接触类 smoke 检查 active contact,摩擦滑移类 smoke 检查正摩擦耗散,壳/静力基准 smoke 通过节点位移探针检查方向和最小量级,two arches smoke 通过 checker 验证 PDF 参考坐标、30/75 壳网格、1.2 mm 上拱中点位移和 active contact;two arches reference-point prepare 验证 optional 单个位移参考工况 deck 与 `two_arches_reference_point.csv` schema,不验收 COMSOL 参数化扫描,单点工况由 `check_two_arches_reference_point.py` 在运行输出上验证;strengthReduction benchmark 通过 checker 验证参考几何、0.75 m 网格、8 工况 FOS 曲线、Davis B/关联材料单调性、塑性区和位移停止准则,但不验收 0.75 m 临界失稳位移/eqps 云图,屈曲 benchmark 检查特征值、残差和模态输出,滚压 benchmark 检查旋转对 slip/traction/energy/torque 以及 J2 塑性区/回弹指标的影响,cohesive benchmark 检查拉脱力、滞回、耗散能、损伤和脱粘面积,dynamic grain benchmark 检查粒子数、粒子-facet 接触、映射节点力、容器位移、质量守恒和能量。thick plate 作为独立 NAFEMS LE10 benchmark 接入 `benchmark` 标签,检查 D 点恢复应力、位移方向和压力反力平衡;spherical cap benchmark 检查 PDF 几何、16 段经向壳网格、位移控制输入、冠点反力和无量纲曲线采样;V5.11 有界 nonlinear route 要求全 S4 Shell-4 target、translational rim support、continuation path 诊断和 post-peak load drop,以防单调小应变曲线误判通过。完整 `uz=-6.2 m` PDF 全曲线匹配、later restiffening 窗口和 Shell-4/8/16 digitized reference 比较留到后续版本。
- rigid sphere impact plate 的长步数结果保留为示例复现实验。
## 11. 输入解析测试
@@ -676,10 +691,10 @@ V4.4 contact pair 性能 smoke:
- `perf_contact_pair_smoke` 使用程序内生成的 S4 master/slave 面对,默认 CTest 规模为 32 对面片;`perf_contact_pair_medium` 使用 64 对面片覆盖更厚的 BVH/cache/tangent 路径。
- smoke 必须触发 BVH 搜索、active 接触和 BVH 候选缓存命中。
- `perf_contact_pair_omp_consistency` 通过 `tools/testing/check_perf_contact_pair_omp.py` 分别以 `OMP_NUM_THREADS=1/4` 运行同一性能 smoke,并要求 active、broad/active 候选、BVH 节点和缓存命中等非计时统计一致;该用例覆盖缩短后的 force 全局提交临界区和 tangent CSR 合并临界区。
- 可执行程序 `perf_contact_pair <facet_count> <do_tangent>` 可用于放大到中等规模专项测试;`facet_count` 必须大于 16 才能触发 BVH 路径。
- `perf_contact_pair_omp_consistency` 通过 `tools/testing/check_perf_contact_pair_omp.py` 分别以 `OMP_NUM_THREADS=1/4` 运行同一性能路径;默认路径为 64 对面片、4 个压入步,要求 path active、BVH 建树、缓存命中和末步 active、broad/active 候选等非计时统计一致;该用例覆盖缩短后的 force 全局提交临界区和 tangent CSR 合并临界区。
- 可执行程序 `perf_contact_pair <facet_count> <do_tangent> [path_steps]` 可用于放大到中等规模专项测试;`facet_count` 必须大于 16 才能触发 BVH 路径,`path_steps` 大于 1 时会沿压入路径反复执行 force/tangent/cache。
- `linear_solver_cg` 和 `test_c_api` 覆盖内部 CG/BiCGSTAB/GMRES/DENSE 设置、统计查询、CSR 矩阵分类诊断、非法 method 拒绝,以及旧外部 method 数值不改变现有设置;`solver_implicit` 覆盖非线性修正内部 fallback 后恢复用户配置。
- `solver_implicit` 和 `implicit_inp` 覆盖线性静力、隐式 Newmark 和非线性接触修正路径通过同一内部 dispatch 记录矩阵分类、初始残差、最终残差、相对残差和收敛状态;`implicit_inp` 同时覆盖 `*NONLINEAR CONTINUATION, METHOD=value` 的默认 `METHOD=1`、数字 `1..5`、符号名、非法值拒绝和失败时状态保持,并覆盖 NC-2 的 `TARGET_NEWTON/GROWTH/SHRINK`、NC-3 的 trust radius/min/max、growth/shrink 和 merit ratio 参数,以及迁移期 `SHELL_GEOMETRIC` 布尔开关。V5.11 后续必须新增 `SHELL_GEOMETRIC=FINITE_STRAIN`/`LINEAR` 覆盖,并删除 `COROTATIONAL_SHELL`/`S4_COROTATIONAL` 遗留别名测试。`solver_implicit` 覆盖 NC-2 自适应步长到达最终时间、NC-3 trust radius 限制实际修正范数、damping/merit/rejection 诊断和收敛结果;0.5.2 追加 NC-4 直接位移控制 accepted path 覆盖,验证每个 accepted increment 的控制 DOF、目标/实际位移、约束残差、反力、状态码和 Fortran API 查询。
- `solver_implicit` 和 `implicit_inp` 覆盖线性静力、隐式 Newmark 和非线性接触修正路径通过同一内部 dispatch 记录矩阵分类、初始残差、最终残差、相对残差和收敛状态;`implicit_inp` 同时覆盖 `*NONLINEAR CONTINUATION, METHOD=value` 的默认 `METHOD=1`、数字 `1..5`、符号名、非法值拒绝和失败时状态保持,并覆盖 NC-2 的 `TARGET_NEWTON/GROWTH/SHRINK`、NC-3 的 trust radius/min/max、growth/shrink 和 merit ratio 参数、`SHELL_GEOMETRIC=FINITE_STRAIN`/`LINEAR` 稳定写法,以及旧 shell 几何名称被拒绝且不污染当前状态。`solver_implicit` 覆盖 NC-2 自适应步长到达最终时间、NC-3 trust radius 限制实际修正范数、damping/merit/rejection 诊断和收敛结果;0.5.2 追加 NC-4 直接位移控制 accepted path 覆盖,验证每个 accepted increment 的控制 DOF、目标/实际位移、约束残差、反力、状态码和 Fortran API 查询。
- `strength_reduction_driver` 覆盖强度折减搜索状态机、trial 分类、bracket/convergence/limited 状态和历史查询;`strength_reduction_report` 覆盖 trial CSV、summary line 和报告文件写出。
- `eigensolver` 和 `buckling_support` 覆盖内部 dense 特征值、广义 SPD
特征值、模态残差、Euler 解析临界载荷和梁柱几何刚度;`example_euler_column_buckling_benchmark`