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
+47 -14
View File
@@ -235,7 +235,9 @@ Mohr-Coulomb 子步数、请求子步数、driver 状态、分支 mask、最大
不会退回普通 Newton path 记录。两条有效路径都会在每个收敛增量输出控制参数、
位移、约束残差、反力和收敛状态。方法 5
`MC_SUBSTEPPING_SEMISMOOTH` 当前会在 Mohr-Coulomb 材料点启用局部子步和活动集
诊断;结构级 substep 汇总和 longrun 效果证明仍按 NC-5 继续完善。
诊断,并在 strengthReduction 可选诊断输出中汇总结构级 substep 信息。
完整 0.75 m 临界失稳 cloud 的 longrun 效果证明属于后续研究验证,
不作为 V5 使用验收项。
方法 2 示例:
@@ -255,18 +257,43 @@ Mohr-Coulomb 子步数、请求子步数、driver 状态、分支 mask、最大
*NONLINEAR CONTINUATION, METHOD=ARC_LENGTH_OR_DISPLACEMENT_CONTROL, ARC_LENGTH=0.05, ARC_LOAD_SCALE=1.0
```
For direct prescribed-displacement paths, adaptive path spacing is the default
continuation route. `DISP_ADAPTIVE=NO` on the same `*NONLINEAR CONTINUATION`
line, or CLI `--disp-path-adaptive off`, can be used to recover the older fixed
time-grid sampling. The adaptive route also limits the next displacement step
when the accepted generalized reaction changes sharply, so post-peak branches
are sampled before cutback is forced to recover from an over-large step.
When the input keeps the historical `TARGET_NEWTON=6` default, the direct
displacement path uses a relaxed internal target of 12 accepted Newton
iterations before shrinking; explicit `TARGET_NEWTON` values remain honored.
The CLI option `--linear-precond none|jacobi|gs|ilu0` can override the internal
linear preconditioner for diagnostic runs. The default remains Jacobi.
For nonlinear line-search diagnostics, `--line-search-min-alpha value`,
`--line-search-reduction value`, and `--line-search-accept-ratio value` override
the Newton damping floor, backtracking reduction, and residual merit acceptance
ratio for the current run only.
For cutback diagnostics, `--max-cutback count` and `--cutback-factor value`
override the retry count and shrink factor for the current run; the factor must
be greater than 0 and less than 1.
For trust-region diagnostics, `--trust-radius value`, `--trust-min-radius
value`, and `--trust-max-radius value` can enable the existing damped Newton
correction limiter for direct prescribed-displacement ARC_DISP paths when a
positive trust radius is provided. The default remains off for ARC_DISP.
当输出目录启用且有 accepted path 数据时,会生成 `continuation_path.csv`;库调用者
也可使用 `fem_get_continuation_path_count` 和 `fem_get_continuation_path_row`
查询同一数据。V5.11 后续正式壳几何非线性配置为
`SHELL_GEOMETRIC=FINITE_STRAIN`,目标是 finite-membrane-strain S4、有限转动
director、MITC/ANS assumed strain 和解析一致切线。当前 `SHELL_GEOMETRIC=YES`
仍是迁移期兼容写法,进入既有 S4 corotational 临时路径;`GEOMETRIC_SHELL`、
`COROTATIONAL_SHELL` 和 `S4_COROTATIONAL` 是待删除遗留别名,用户不应在新输入中使用。
查询同一数据。V5.11 正式壳几何非线性配置为
`SHELL_GEOMETRIC=FINITE_STRAIN`,当前支持 S4 finite-membrane-strain、有限转动
director、MITC/ANS assumed strain、section material coupling 和生产切线。稳定配置只接受
`SHELL_GEOMETRIC=LINEAR` 或 `SHELL_GEOMETRIC=FINITE_STRAIN`;旧布尔写法和旧
shell 几何名称已移除,输入中出现时会报错。S3/S6/S8 请求 `FINITE_STRAIN` 时会报
unsupported。
`ARC_LENGTH`/`ARC_RADIUS` 指定弧长半径;
省略时使用当前静力增量长度。`ARC_LOAD_SCALE` 指定载荷因子在弧长约束中的缩放,
默认 1。当前临时路径包含 S4 ELASTIC/J2/J2_JC section tangent、弹性多层 ABD/H
section 矩阵、广义力 resultant-delta load-stiffness 和壳压力 follower tangent,但
不能作为完整 Shell-4/8/16 后屈曲验收依据。
默认 1。当前保留的可复用基础设施包括 section/resultant 状态、弹性多层 ABD/H
section 矩阵、内部非对称修正求解链和壳压力 follower tangent;它们仍不能作为完整
Shell-4/8/16 后屈曲验收依据。
方法 5 示例:
@@ -316,7 +343,7 @@ slave_surface, master_surface
- `FRICTION_REGULARIZATION` 是接触对级摩擦正则化滑移尺度;0 表示经典 Coulomb 截断。
- `SLAVE` 和 `MASTER` 可为 surface 名称、elset 名称、element id 字符串或 `ALL`。
- `*SURFACE` 当前支持 `TYPE=ELEMENT`、`TYPE=NODE` 和 `TYPE=ANALYTICAL` 刚性平面子集。
- 面-面 contact pair 当前仍以 element surface facet 路径为主;node surface 和 analytical plane 主要用于节点目标/刚性平面接触子集。
- 面-面 contact pair 当前仍以 element surface facet 路径为主;node surface 和 analytical plane 主要用于节点目标/刚性平面接触子集。V5 明确拒绝 `TYPE=NODE` slave 对一般 element master 的 contact pair;该路径留到后续版本转换为 facet 约束或完整 mortar 节点约束后再支持。
- analytical plane 数据行为 `PLANE, nx, ny, nz, offset`。
- face label 支持省略、`ALL`、`EXTERIOR`、`S1`、`F1`、`FACE1` 等形式。
- 壳单元支持 `SPOS`/`SNEG` 当前单一 shell facet 语义。
@@ -372,8 +399,8 @@ Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的
| `examples/cylinder_roller_contact` | 滚子-基础法向接触代表性 smoke |
| `examples/sliding_wedge` | 倾斜楔块摩擦滑移接触 smoke |
| `examples/membrane_airbag_inflation` | 膜气囊压力载荷 S4 动力/静力回归入口 |
| `examples/spherical_cap_with_central_point_load` | 球冠中心载荷位移控制壳 benchmark;默认检查 Shell-16 小应变样本,附带迁移期 S4 nonlinear diagnostic deck;完整后屈曲验收等待 finite-membrane-strain S4 |
| `examples/two_arches` | 基于 `models.sme.two_arches.pdf` 几何的双拱壳-壳接触 benchmark |
| `examples/spherical_cap_with_central_point_load` | 球冠中心载荷位移控制壳 benchmark;默认检查 Shell-16 小应变样本,附带全 S4 finite-strain target deck;V5.11 用于验证有限应变 S4 生产路径、translational-rim 口径、continuation path 诊断和 post-peak load drop,完整 PDF 全曲线匹配留到后续版本 |
| `examples/two_arches` | 基于 `models.sme.two_arches.pdf` 几何的双拱壳-壳接触 geometry/contact smoke;当前默认验收参考几何、30/75 壳网格、1.2 mm 上拱中点位移和 active contact;另提供 optional `run_two_arches_reference_point.py` 单个位移参考工况入口,输出 `two_arches_reference_point.csv`;V5 不提供 COMSOL 参数化扫描 |
| `examples/blasting_rock` | 花岗岩块爆破脉冲显式动力 smoke |
| `examples/nonlinear_harmonic` | 薄膜谐波压力响应显式动力 smoke |
| `examples/failure_prediction_in_a_layered_shell` | 四层共享节点壳拉伸回归入口 |
@@ -531,9 +558,15 @@ V5 当前开发态记录:
- `*SURFACE` 已支持 element/node/analytical plane 子集,但尚不支持完整 Abaqus surface 语义。
- 面-面接触已具备 mortar 权重、mortar 积分点摩擦历史、正则化摩擦、摩擦功输出、BVH 搜索、active set 和 pair 级 augmented penalty 诊断,但仍不是完整工程级 mortar 约束求解器。
- Mohr-Coulomb 当前已具备材料点返回映射、driver、活动集算法一致切线、强度折减参数折减基础和结构级边坡安全系数 benchmark;完整结构级自动 trial 重求解、非线性失稳判据和 PDF 位移/塑性云图复现仍在 V5.4 后续项中完善。
- 线性屈曲当前已具备小规模内部 dense 特征值求解、梁柱几何刚度、Euler 柱 `femlite --buckling` 主程序路径和波纹壳紧凑循环屈曲 benchmark;完整通用 `*BUCKLING` step、静力预载后的壳/实体几何刚度装配、完整壳 FE 波纹壳高保真模型和循环扇区约束接入主求解流程仍在 V5.5 后续项中完善。
- 线性屈曲当前已具备小规模内部 dense 特征值求解、梁柱几何刚度、Euler 柱 `femlite --buckling` 主程序路径、波纹壳紧凑循环屈曲 benchmark,以及普通 INP 中的小规模 dense `*BUCKLING` 子集;该子集使用已装配线弹性 `K`,并通过 `*BUCKLING GEOMETRIC LINE` 显式给出有限 truss-style `K_G`,通过 `*BUCKLING GEOMETRIC LINE, PRELOAD` 从线性静力预载后的宿主实体应力派生线刚度子集,或在 `*STATIC` 后直接 `*BUCKLING` 时从 C3D4/C3D8 实体预载应力装配 initial-stress `K_G`。静力预载后的完整壳几何刚度、高阶实体几何刚度、完整壳 FE 波纹壳高保真模型和更完整循环扇区约束仍在 V5.5 后续项中完善。
- 循环扇区约束当前支持普通 INP 中的 `*CYCLIC SYMMETRY, SECTORS=n, WAVE=0, DOF=3|6, PENALTY=p`,数据行为显式 `master_node, slave_node` 节点对。主程序会把它展开为 MPC 罚约束;`DOF=3` 适用于实体平移自由度,`DOF=6` 额外映射壳转角自由度。自动边界配对和非零 harmonic wave 主求解语义尚未作为生产输入交付。
- 滚压成形当前已具备刚体辊平移/下压/角速度运动学、角速度参与切向相对速度和正则化牵引的 benchmark,以及基于 J2 多层材料点的塑性成形/卸载回弹 benchmark;主求解器通用滚压成形 step、完整三维工件网格滚压和 restart 驱动多 step 工艺流仍在后续完善。
- S4 几何非线性当前仍处于 finite-membrane-strain formulation 替换前的迁移期;旧 corotational 输入别名和生产路径不作为稳定接口,也不能作为 spherical cap 完整后屈曲验收依据。
- S4 几何非线性当前已具备 finite rotation state、S4 finite kinematics、MITC shear、
生产内力、生产切线、section/material 耦合和 drilling 能量项;旧 shell 几何输入别名和
旧生产路径已移除。S3/S6/S8 的 `FINITE_STRAIN` 请求仍会清晰报 unsupported;球冠
V5.11 验收范围是全 S4 finite-strain target deck 的 post-peak load drop 能力证明、
支撑口径和 path 诊断,不声明完整 `uz=-6.2 m` PDF 曲线严格复现。完整 Shell-4/8/16
PDF 曲线匹配、pseudo-arclength branch following 和 late post-peak 性能优化留到后续版本。
- 颗粒耦合当前已具备内置离散球颗粒、颗粒-facet 映射和动态柔性容器紧凑 benchmark;它不是工业规模 DEM 长跑,也不接入外部颗粒求解器。
- 非线性 Newmark-Newton 和复杂壳塑性仍需要更多工程基准和长时间稳定性验证。
- 大型工程算例的并行、内存和接触收敛策略仍需后续版本完善。