This commit is contained in:
1 parent
240d2728fa
commit
8f9c1ece61
109 files changed
+2122
-49
No files matched your search
+27
-9
@@ -1,12 +1,12 @@
|
||||
# FemLite 0.4.3 用户手册
|
||||
# FemLite 0.4.8 用户手册
|
||||
|
||||
日期:2026-06-24
|
||||
|
||||
## 1. 适用范围
|
||||
|
||||
本文档面向 FemLite 0.4.3 的使用者,说明如何编译、运行、准备输入文件、查看结果和复现实例。
|
||||
本文档面向 FemLite 0.4.8 的使用者,说明如何编译、运行、准备输入文件、查看结果和复现实例。
|
||||
|
||||
FemLite 0.4.3 是船舶接触爆炸结构响应 FEM 软件的第四版接触增强阶段版,当前支持:
|
||||
FemLite 0.4.8 是船舶接触爆炸结构响应 FEM 软件的第四版阶段验收版,当前支持:
|
||||
|
||||
- 三维实体和壳单元结构分析。
|
||||
- 显式瞬态动力学。
|
||||
@@ -17,11 +17,11 @@ FemLite 0.4.3 是船舶接触爆炸结构响应 FEM 软件的第四版接触增
|
||||
- element/node/analytical surface 子集、contact property 子集、刚性平面接触和面-面 contact pair 阶段能力。
|
||||
- contact pair active set、gap residual 和 augmented penalty 诊断输出。
|
||||
- 静力/隐式求解的收敛状态和 cutback 诊断查询接口。
|
||||
- 内部线性求解器可在 CG 和 BiCGSTAB 间切换,并提供预条件和迭代统计查询。
|
||||
- 内部线性求解器可在 CG、BiCGSTAB 和 GMRES 间切换,并提供预条件和迭代统计查询。
|
||||
- CSV、VTK、restart 和 contact CSV 输出。
|
||||
- Fortran95 原生接口、C ABI 子集和 Python 调试脚本。
|
||||
|
||||
0.4.3 不等价于完整 Abaqus 兼容求解器,也不等价于工程级通用 mortar/摩擦接触最终版。
|
||||
0.4.8 不等价于完整 Abaqus 兼容求解器,也不等价于工程级通用 mortar/摩擦接触最终版。
|
||||
|
||||
## 2. 目录概览
|
||||
|
||||
@@ -129,7 +129,7 @@ build-win-gcc-16\femlite.exe examples\rigid_sphere_impact_plate\rigid_sphere_imp
|
||||
|
||||
## 6. 输入文件
|
||||
|
||||
FemLite 使用 Abaqus inp 风格输入文件的子集。0.4.3 常用支持项包括:
|
||||
FemLite 使用 Abaqus inp 风格输入文件的子集。0.4.8 常用支持项包括:
|
||||
|
||||
- `*NODE`
|
||||
- `*ELEMENT`
|
||||
@@ -240,7 +240,7 @@ kind,pair_id,active_count,max_penetration,force_norm,work_estimate,cumulative_wo
|
||||
|
||||
`search_*` 字段在 `SUMMARY` 行给出最近一次 contact pair 力评估的全局搜索统计、BVH 候选缓存使用情况和 `cpu_time` 口径秒数;逐 `PAIR` 行给出对应接触对的搜索、缓存和计时统计。`cpu_time` 是轻量趋势诊断,小算例中可能显示为 0。
|
||||
|
||||
Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的增量、迭代、残差、位移修正范数和收敛标志,通过 `fem_get_convergence_metrics` 查询相对残差、contact gap residual 和 combined norm,通过 `fem_get_convergence_diagnostics` 查询 cutback 次数、最后步长、最后有效时间、状态码和失败原因码。`fem_set_linear_solver` 可选择 `CG` 或 `BiCGSTAB` 与 `none/Jacobi` 预条件,`fem_get_linear_solver_stats` 查询最近一次线性求解迭代数、残差和状态。V4.7 起,`fem_set_shell_stabilization` 可设置壳 drilling 系数、S3 剪切锁定折减系数和最小折减比例,默认分别为 `1.0e-4`、`0.0625`、`1.0e-4`;`fem_get_shell_stability_stats` 可查询最近壳刚度装配诊断。C ABI 提供同名 `femlite_get_*`/`femlite_set_*` 包装,`converged` 使用 0/1 整数返回。
|
||||
Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的增量、迭代、残差、位移修正范数和收敛标志,通过 `fem_get_convergence_metrics` 查询相对残差、contact gap residual 和 combined norm,通过 `fem_get_convergence_diagnostics` 查询 cutback 次数、最后步长、最后有效时间、状态码和失败原因码。`fem_set_linear_solver` 可选择 `CG`、`BiCGSTAB` 或 `GMRES` 与 `none/Jacobi` 预条件,`fem_get_linear_solver_stats` 查询最近一次线性求解迭代数、残差和状态。V4.7 起,`fem_set_shell_stabilization` 可设置壳 drilling 系数、S3 剪切锁定折减系数和最小折减比例,默认分别为 `1.0e-4`、`0.0625`、`1.0e-4`;`fem_get_shell_stability_stats` 可查询最近壳刚度装配诊断。C ABI 提供同名 `femlite_get_*`/`femlite_set_*` 包装,`converged` 使用 0/1 整数返回。
|
||||
|
||||
建议把大型结果输出到 `examples/.../results/...` 或独立 `output/` 目录。仓库 `.gitignore` 默认忽略大规模结果文件。
|
||||
|
||||
@@ -263,6 +263,24 @@ Fortran95 API 可通过 `fem_get_convergence_status` 查询最近一次求解的
|
||||
| `examples/shell_solid_connection` | 共享节点壳-实体接口静力案例 |
|
||||
| `examples/strengthReduction` | 强度折减文档派生的线弹性坡体案例 |
|
||||
| `examples/golfBallImpact` | 高尔夫冲击文档派生的壳接触动力缩减案例 |
|
||||
| `examples/node_analytical_plane_contact` | node surface 到 analytical plane 的接触 smoke |
|
||||
| `examples/block_on_arch` | 文档派生的浅拱-解析刚体面接触 smoke |
|
||||
| `examples/cylinder_roller_contact` | 滚子-基础法向接触代表性 smoke |
|
||||
| `examples/sliding_wedge` | 倾斜楔块摩擦滑移接触 smoke |
|
||||
| `examples/membrane_airbag_inflation` | 膜气囊压力载荷 S4 动力/静力回归入口 |
|
||||
| `examples/spherical_cap_with_central_point_load` | 球冠中心载荷 S4 壳静力回归入口 |
|
||||
| `examples/two_arches` | 双拱壳-壳接触 smoke |
|
||||
| `examples/blasting_rock` | 花岗岩块爆破脉冲显式动力 smoke |
|
||||
| `examples/nonlinear_harmonic` | 薄膜谐波压力响应显式动力 smoke |
|
||||
| `examples/failure_prediction_in_a_layered_shell` | 四层共享节点壳拉伸回归入口 |
|
||||
| `examples/pinched_hemispherical_shell` | pinched hemisphere S4 壳动力 smoke |
|
||||
| `examples/stress_dependent_elasticity` | 分区弹性模量悬臂梁弯曲回归入口 |
|
||||
| `examples/roll_forming` | 滚压成形文档派生的压紧-摩擦牵引 smoke |
|
||||
| `examples/falling_objects` | 多物体显式接触与刚性箱底代表性 smoke |
|
||||
| `examples/ball_adhesion_decohesion` | 球-膜接触压入 smoke,粘附/脱粘本构为后续能力 |
|
||||
| `examples/buckling_corrugated_shell` | 波纹锥壳屈曲文档派生的静力预载 smoke |
|
||||
| `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | 动态颗粒装填文档派生的柔性容器压力-地面接触 smoke |
|
||||
| `examples/thick_plate` | NAFEMS LE10 厚板压力静力回归入口 |
|
||||
| `examples/contact_rigid_plane_indentation` | 刚性平面压入接触算例 |
|
||||
| `examples/contact_two_blocks_compression` | 两实体块面-面压缩接触算例 |
|
||||
| `examples/shell_rigid_plane_contact` | S4 壳-刚性平面接触算例 |
|
||||
@@ -284,9 +302,9 @@ ctest --test-dir build-win-gcc-16 --output-on-failure
|
||||
ctest --test-dir build-win-gcc-16 -R "^(contact|implicit_inp|source_size)$" --output-on-failure
|
||||
```
|
||||
|
||||
0.4.3 本地记录:
|
||||
0.4.8 本地记录:
|
||||
|
||||
- Windows GCC 16:34/34 passed。
|
||||
- Windows GCC 16:V4.8 后硬化加入 GMRES、node analytical contact、P1 contact 性能 smoke,并补齐所有文档型 examples 目录后,当前 CTest 记录为 66/66 passed。
|
||||
- WSL Ubuntu + gfortran 13.3:沿用第三版发布流程复测。
|
||||
- Windows Intel oneAPI ifx 2026.0 + MSVC:沿用第三版发布流程复测。
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# FemLite 0.4.3 开发者手册
|
||||
# FemLite 0.4.8 开发者手册
|
||||
|
||||
日期:2026-06-24
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
|
||||
本文档面向 FemLite 开发者,说明代码结构、构建测试、模块职责、接口扩展、编码约束和发布检查流程。
|
||||
|
||||
FemLite 核心代码采用 Fortran 95 非面向对象风格,使用集中式 `fem_database` 保存模型、状态和求解数据。当前版本为 0.4.3。
|
||||
FemLite 核心代码采用 Fortran 95 非面向对象风格,使用集中式 `fem_database` 保存模型、状态和求解数据。当前版本为 0.4.8。
|
||||
|
||||
## 2. 开发原则
|
||||
|
||||
@@ -214,10 +214,10 @@ fem_contact_output.f90 contact CSV 字段辅助
|
||||
求解器核心文件:
|
||||
|
||||
- `fem_assembly_csr.f90`:DOF 获取、CSR 图案和装配。
|
||||
- `fem_linear_solver_cg.f90`:线性求解器分发层、Jacobi/none 预条件、CG、BiCGSTAB 和外部求解器占位。
|
||||
- `fem_linear_solver_cg.f90`:线性求解器分发层、Jacobi/none 预条件、CG、BiCGSTAB、GMRES 和外部第三方库预留入口。
|
||||
- `fem_solver_implicit.f90`:静力、隐式 Newmark、非线性 Newton。
|
||||
|
||||
V4.6 起,隐式求解器内部不再直调 CG,而是通过 `linear_solver_solve` 分发。新增线性求解器时应先在该分发层注册 method 常量、预条件支持、统计状态和模块测试,再接入 Fortran API / C ABI。
|
||||
V4.6 起,隐式求解器内部不再直调 CG,而是通过 `linear_solver_solve` 分发。当前内部支持 CG、BiCGSTAB 和 GMRES;新增线性求解器时应先在该分发层注册 method 常量、预条件支持、统计状态和模块测试,再接入 Fortran API / C ABI。外部第三方稀疏库后端仍作为后续适配项,不计入当前阶段完成项。
|
||||
|
||||
新增求解路径时应明确:
|
||||
|
||||
@@ -321,7 +321,7 @@ ctest --test-dir build-win-gcc-16 -R "^(contact|contact_omp1|contact_omp4|restar
|
||||
- 示例 smoke:shell patch、Scordelis-Lo、pressure pulse、rigid sphere impact。
|
||||
- 性能测试:`perf_p1`、`perf_contact_pair`、`perf_contact_pair_omp_consistency`。
|
||||
|
||||
0.4.3 基线 CTest 包含 34 项;V4.4 开发态加入 `contact_omp1`、`contact_omp4`、`perf_contact_pair_smoke`、`perf_contact_pair_medium` 和 `perf_contact_pair_omp_consistency` 后,在 Python 可用时包含 39 项。
|
||||
0.4.8 基线 CTest 已覆盖 V4.1 至 V4.8 的接触、隐式、壳、示例和发布检查项;V4.8 后硬化继续加入 GMRES、node analytical contact smoke、P1 contact 性能 smoke,以及所有文档型 `examples/` 目录的可执行案例和双击脚本检查。当前 Windows GCC 16 记录为 66/66 passed。
|
||||
|
||||
## 14. 源码规模门禁
|
||||
|
||||
@@ -339,7 +339,7 @@ python tests\scripts\check_source_size.py . --warn-file-lines 1500 --max-file-li
|
||||
- 超过 2000 行必须登记 hard-threshold exception。
|
||||
- stale exception 会导致测试失败。
|
||||
|
||||
0.4.3 当前无 active hard-threshold exception;软警告不阻断发布。
|
||||
0.4.8 当前无 active hard-threshold exception;软警告不阻断发布。
|
||||
|
||||
## 15. 编码规范
|
||||
|
||||
@@ -368,7 +368,7 @@ python tests\scripts\check_source_size.py . --warn-file-lines 1500 --max-file-li
|
||||
- Windows 双击自动运行脚本可命名为 `run_case.bat`;脚本应把结果写入示例目录下的 `results` 子目录,并支持自动检查失败码。
|
||||
|
||||
新增基准测试案例应放在 `examples/` 下,并为每个案例建立独立文件夹;旧兼容目录不作为新测试入口。
|
||||
V4.8 起,`examples_layout` CTest 会检查 `examples/` 一级目录:有文档的目录必须包含至少一个 `.inp`,有 `.inp` 的目录必须包含 `run_case.bat`。
|
||||
V4.8 起,`examples_layout` CTest 会检查 `examples/` 一级目录:有文档的目录必须包含至少一个 `.inp`,有 `.inp` 的目录必须包含 `run_case.bat`。文档后缀包含 `.md`、`.pdf`、`.ppt`、`.pptx`、`.txt` 和 `.rst`。
|
||||
|
||||
示例目录不应提交:
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ V4.8 是第四版阶段验收收束版,重点确认 0.4.x 开发期新增的
|
||||
- 第一版、第二版、第三版已验收能力无回退。
|
||||
- surface/contact 输入子集、contact pair active-set、augmented penalty、摩擦历史、BVH 搜索、候选缓存和性能统计保持可回归。
|
||||
- 非线性静力和非线性 Newmark 收敛诊断、cutback 诊断和 C ABI 查询接口保持可回归。
|
||||
- CG/BiCGSTAB 线性求解器分发、预条件设置和统计接口保持可回归。
|
||||
- CG/BiCGSTAB/GMRES 线性求解器分发、预条件设置和统计接口保持可回归。
|
||||
- 壳 drilling 稳定、S3 剪切锁定诊断、壳 J2 剪切/弯曲代表性塑性和 Scordelis-Lo smoke 保持可回归。
|
||||
- `examples/` 下文档型目录均有可执行 `.inp`,包含 `.inp` 的目录均有 `run_case.bat`。
|
||||
|
||||
@@ -32,10 +32,10 @@ V4.8 是第四版阶段验收收束版,重点确认 0.4.x 开发期新增的
|
||||
| 基础回归 | PASS | smoke、材料、单元、数据库、稀疏矩阵、线性求解、输出和 restart 测试保留 |
|
||||
| 接触与摩擦 | PASS | contact、OMP 1/4、contact block sliding、rigid impact 和接触统计回归覆盖 |
|
||||
| 隐式与收敛诊断 | PASS | implicit inp、solver implicit、cutback 和收敛状态接口回归覆盖 |
|
||||
| 线性求解器 | PASS | CG/BiCGSTAB、Jacobi、unsupported external 占位和 C ABI 设置查询覆盖 |
|
||||
| 线性求解器 | PASS | CG/BiCGSTAB/GMRES、Jacobi 和 C ABI 设置查询覆盖;external 仅为后续第三方库适配项 |
|
||||
| 壳稳定与壳塑性 | PASS | drilling、S3 剪切锁定、S4 J2 剪切/弯曲、trial rollback 和 Scordelis-Lo smoke 覆盖 |
|
||||
| 示例目录结构 | PASS | `examples_layout` 检查文档目录和双击脚本约定 |
|
||||
| 文档派生示例 | PASS | elliptic membrane、membrane uniaxial、shell-solid connection、strength reduction、golf ball impact 均接入 smoke |
|
||||
| 文档派生示例 | PASS | elliptic membrane、membrane uniaxial、shell-solid connection、strength reduction、golf ball impact,以及 block-on-arch、roller contact、sliding wedge、airbag membrane、spherical cap、two arches、blasting rock、nonlinear harmonic、layered shell、pinched hemisphere、stress dependent elasticity、roll forming、falling objects、ball adhesion contact、corrugated shell buckling preload、dynamic grain container 和 thick plate 均接入 smoke |
|
||||
| 源码规模门禁 | PASS | `source_size` 保持通过 |
|
||||
|
||||
## 4. 示例矩阵
|
||||
@@ -49,6 +49,24 @@ V4.8 期间补齐或确认的示例目录:
|
||||
| `examples/shell_solid_connection` | `run_case.bat` | C3D8 与 S4 共享节点接口静力案例 |
|
||||
| `examples/strengthReduction` | `run_case.bat` | 强度折减文档派生线弹性坡体案例 |
|
||||
| `examples/golfBallImpact` | `run_case.bat` | 壳接触动力缩减案例,采用文档摩擦系数尺度 |
|
||||
| `examples/node_analytical_plane_contact` | `run_case.bat` | node-based slave surface 到 analytical rigid plane 的接触 smoke |
|
||||
| `examples/block_on_arch` | `run_case.bat` | 浅拱与解析刚体面接触代表性 smoke |
|
||||
| `examples/cylinder_roller_contact` | `run_case.bat` | 滚子-基础法向接触代表性 smoke |
|
||||
| `examples/sliding_wedge` | `run_case.bat` | 倾斜接触面摩擦滑移 smoke |
|
||||
| `examples/membrane_airbag_inflation` | `run_case.bat` | S4 膜片压力载荷回归入口 |
|
||||
| `examples/spherical_cap_with_central_point_load` | `run_case.bat` | 球冠中心载荷 S4 静力回归入口 |
|
||||
| `examples/two_arches` | `run_case.bat` | 双拱壳-壳接触代表性 smoke |
|
||||
| `examples/blasting_rock` | `run_case.bat` | C3D8 花岗岩块爆破脉冲动力 smoke |
|
||||
| `examples/nonlinear_harmonic` | `run_case.bat` | 薄膜谐波压力显式动力 smoke |
|
||||
| `examples/failure_prediction_in_a_layered_shell` | `run_case.bat` | 四层共享节点壳拉伸回归入口 |
|
||||
| `examples/pinched_hemispherical_shell` | `run_case.bat` | pinched hemisphere S4 壳动力 smoke |
|
||||
| `examples/stress_dependent_elasticity` | `run_case.bat` | 分区弹性模量悬臂梁弯曲回归入口 |
|
||||
| `examples/roll_forming` | `run_case.bat` | 滚压成形文档派生的压紧-摩擦牵引 smoke |
|
||||
| `examples/falling_objects` | `run_case.bat` | 多物体显式接触与刚性箱底代表性 smoke |
|
||||
| `examples/ball_adhesion_decohesion` | `run_case.bat` | 球-膜接触压入 smoke,粘附/脱粘本构为后续能力 |
|
||||
| `examples/buckling_corrugated_shell` | `run_case.bat` | 波纹锥壳屈曲文档派生的静力预载 smoke |
|
||||
| `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | `run_case.bat` | 动态颗粒装填文档派生的柔性容器压力-地面接触 smoke |
|
||||
| `examples/thick_plate` | `run_case.bat` | NAFEMS LE10 厚板压力静力回归入口 |
|
||||
| 既有基准目录 | `run_case.bat` | Kirsch、Scordelis-Lo、shell patch、压力脉冲、刚球冲击、2D/3D 拉伸等均补齐双击入口 |
|
||||
|
||||
## 5. 测试命令
|
||||
@@ -66,10 +84,10 @@ ctest --test-dir build-win-gcc-16 --output-on-failure
|
||||
ctest --test-dir build-win-gcc-16 -R examples_layout --output-on-failure
|
||||
```
|
||||
|
||||
文档派生示例 smoke 专项检查:
|
||||
示例 smoke 专项检查:
|
||||
|
||||
```powershell
|
||||
ctest --test-dir build-win-gcc-16 -R "example_(elliptic_membrane|membrane_uniaxial|shell_solid_connection|strength_reduction|golf_ball_impact)_smoke" --output-on-failure
|
||||
ctest --test-dir build-win-gcc-16 -L example_smoke --output-on-failure
|
||||
```
|
||||
|
||||
本轮 Windows GCC 16 验证结果:
|
||||
@@ -79,11 +97,11 @@ cmake --build build-win-gcc-16 --config Release
|
||||
completed successfully
|
||||
|
||||
ctest --test-dir build-win-gcc-16 --output-on-failure
|
||||
100% tests passed, 0 tests failed out of 47
|
||||
100% tests passed, 0 tests failed out of 66
|
||||
```
|
||||
|
||||
## 6. 后续限制
|
||||
|
||||
- 完整 Mohr-Coulomb 强度折减、完整高尔夫球多材料冲击和高保真 shell-solid benchmark 仍需核心求解器后续能力支持。
|
||||
- 完整 Mohr-Coulomb 强度折减、完整高尔夫球多材料冲击、高保真 shell-solid benchmark、几何非线性 pinched hemisphere 载荷曲线、复合材料失效准则、应力相关弹性弱式映射、低反射边界、频域-时域谐波初值流程、完整滚压成形刚体辊旋转/塑性过程、球-膜粘附/脱粘 cohesive law、线性屈曲特征值、循环对称边界和颗粒流-膜双向耦合仍需核心求解器后续能力支持。
|
||||
- pinched cylinder、hemisphere、twisted beam 和更密 Scordelis-Lo 收敛矩阵建议作为 0.5.x 或专项长跑基准推进。
|
||||
- 外部稀疏求解器后端当前仍是显式 unsupported 占位,接口已预留但未绑定第三方库。
|
||||
- 外部第三方稀疏求解器后端仍是后续适配项;当前第四版完成范围以内置 CG、BiCGSTAB 和 GMRES 为准。
|
||||
@@ -592,7 +592,7 @@ FemLite 0.4.x 定位为:
|
||||
| S9 | 壳局部平面几何近似 | DONE/PARTIAL。Scordelis-Lo 曲壳 S3/S4 静力 smoke 已接入独立基准目录;完整 pinched cylinder/hemisphere/twisted beam 矩阵进入 V4.8 验收扩展 | V4.7 |
|
||||
| S10 | 壳塑性 section tangent 基准不足 | DONE/PARTIAL。已补充 S4 J2 剪切塑性、代表性外纤维弯曲塑性、trial/rollback 和 tangent 对称性回归;完整厚度积分壳塑性和卸载长跑进入后续 | V4.7 |
|
||||
| S11 | 集中质量和壳转动惯量对角近似 | B 类。显式继续默认集中质量;隐式路径增加一致质量或改进转动惯量选项的设计和小算例验证 | V4.5, V4.6 |
|
||||
| S12 | CG + Jacobi 单一路径 | DONE。已建立线性求解器分发层,支持 CG、BiCGSTAB、none/Jacobi 预条件、统计查询和外部求解器占位 | V4.6 |
|
||||
| S12 | CG + Jacobi 单一路径 | DONE。已建立线性求解器分发层,支持 CG、BiCGSTAB、GMRES、none/Jacobi 预条件和统计查询;外部第三方库后端作为后续适配项 | V4.6, V4.8 hardening |
|
||||
| S13 | MPC penalty 约束 | C 类。0.4.x 保留 penalty MPC,补充病态诊断和回归;严格 Lagrange multiplier 或 multiplier-augmented MPC 进入后续 | V4.5 |
|
||||
| S14 | 小应变 J2/J2_JC + Jaumann 客观率 | C 类。0.4.x 重点做接触/隐式稳定性验证和文档边界;完整 `F = Fe Fp` 大变形塑性列入 0.5.0 或后续 | V4.5, V4.7 |
|
||||
| S15 | restart 不保存完整模型数据库 | B 类。V4.3 已同步保存 mortar 积分点摩擦历史;0.4.x 后续继续同步新增求解状态,完整 inp 数据库级 restart 作为后续增强 | V4.3, V4.8 |
|
||||
@@ -724,7 +724,7 @@ FemLite 0.4.x 定位为:
|
||||
|
||||
### V4.4 搜索统计与并行优化起步
|
||||
|
||||
完成状态:V4.4 起步,尚未作为发布版本;当前项目版本仍为 0.4.3。
|
||||
完成状态:V4.4 起步记录;当前项目已继续推进到 0.4.8 阶段验收版。
|
||||
|
||||
已完成:
|
||||
|
||||
@@ -815,7 +815,7 @@ FemLite 0.4.x 定位为:
|
||||
|
||||
### V4.6 稀疏线性求解器接口完善
|
||||
|
||||
完成状态:V4.6 线性求解器抽象、内部可切换求解路径、预条件选择和最近一次求解统计已形成阶段完善基线;外部稀疏求解器当前为显式 unsupported 占位。
|
||||
完成状态:V4.6 线性求解器抽象、内部可切换求解路径、预条件选择和最近一次求解统计已形成阶段完善基线;V4.8 后硬化补充内部 GMRES,外部第三方稀疏求解器不再作为第四版完成项。
|
||||
|
||||
已完成:
|
||||
|
||||
@@ -824,7 +824,8 @@ FemLite 0.4.x 定位为:
|
||||
- 新增 BiCGSTAB 内部求解器,覆盖非对称 CSR 小系统。
|
||||
- 预条件器支持 `LPRECOND_NONE` 和 `LPRECOND_JACOBI`。
|
||||
- 隐式线性静力、线性 Newmark、非线性静力 Newton 修正方程和非线性 Newmark 修正方程均改为通过分发层求解。
|
||||
- `LSOLVER_EXTERNAL` 作为外部稀疏求解器预留 method;当前实际求解返回 `LS_STATUS_UNSUPPORTED`。
|
||||
- `LSOLVER_GMRES` 已接入分发层,作为 CG/BiCGSTAB 之外的内部非对称 Krylov 求解器。
|
||||
- `LSOLVER_EXTERNAL` 仅作为后续外部第三方稀疏库适配预留 method;当前实际求解返回 `LS_STATUS_UNSUPPORTED`,不计入 V4.8 完成范围。
|
||||
- 新增 Fortran API `fem_set_linear_solver`、`fem_get_linear_solver_settings` 和 `fem_get_linear_solver_stats`。
|
||||
- C ABI 新增 `femlite_set_linear_solver`、`femlite_get_linear_solver_settings` 和 `femlite_get_linear_solver_stats`。
|
||||
|
||||
@@ -833,9 +834,9 @@ FemLite 0.4.x 定位为:
|
||||
- `linear_solver_cg` 回归继续覆盖原 CG 入口、零 RHS 和非收敛路径。
|
||||
- `linear_solver_cg` 回归覆盖分发层 CG + none 预条件。
|
||||
- `linear_solver_cg` 回归覆盖 BiCGSTAB + Jacobi 求解非对称 CSR 小系统。
|
||||
- `linear_solver_cg` 回归覆盖外部求解器占位的 unsupported 状态。
|
||||
- `linear_solver_cg` 回归覆盖 GMRES + Jacobi 求解非对称 CSR 小系统,并保留外部求解器未启用时的明确 unsupported 状态。
|
||||
- `implicit_inp` 回归将隐式线性静力路径切换到 BiCGSTAB,并检查最后一次线性求解统计。
|
||||
- `c_api` 回归覆盖线性求解器默认设置、空模型统计、切换到 BiCGSTAB + none 和恢复默认。
|
||||
- `c_api` 回归覆盖线性求解器默认设置、空模型统计、切换到 BiCGSTAB + none、切换到 GMRES + Jacobi 和恢复默认。
|
||||
- `source_size` 定向 CTest 已通过,新增求解器接口未触发源码规模硬阈值。
|
||||
|
||||
后续:
|
||||
@@ -886,20 +887,24 @@ FemLite 0.4.x 定位为:
|
||||
- 新增 `examples/elliptic_membrane/` S4 静力缩减案例,基于 NAFEMS LE1 椭圆膜文档的几何、材料和边界尺度。
|
||||
- 新增 `examples/membrane_uniaxial_stretching/` S4 单轴拉伸静力案例,采用文档中的各向同性膜材料参数。
|
||||
- 新增 `examples/shell_solid_connection/` 共享节点壳-实体接口静力案例,覆盖 C3D8 与 S4 混合模型路径。
|
||||
- 新增 `examples/strengthReduction/` 线弹性坡体楔形静力案例,作为强度折减文档的可执行占位基准。
|
||||
- 新增 `examples/strengthReduction/` 线弹性坡体楔形静力案例,作为当前求解器范围内的强度折减文档回归入口。
|
||||
- 新增 `examples/golfBallImpact/` 壳接触动力缩减案例,采用文档中的摩擦系数尺度并复用刚球冲击路径。
|
||||
- 为 `clamped_square_plate_pressure_pulse`、`Kirsch`、`rigid_sphere_impact_plate`、`scordelis_lo_roof`、`ScordelisLo`、`shell_patch_test`、`tension2D`、`uniaxialTension3D` 和上述新增目录补充 `run_case.bat`。
|
||||
- 新增通用 `examples/run_example_case.bat`,统一示例双击运行、结果目录清理和失败码返回。
|
||||
- 新增 `tests/scripts/check_examples_layout.py`,检查 `examples/` 一级目录中“有文档无 `.inp`”和“有 `.inp` 无 `run_case.bat`”的回退。
|
||||
- CTest 新增 `examples_layout`,并将新增五个文档派生案例接入 `example_smoke`。
|
||||
- CTest 新增 `examples_layout`,并将文档派生案例接入 `example_smoke`。
|
||||
- 新增 `docs/v4_acceptance_report.md`,记录第四版 V4.8 阶段验收范围、测试矩阵、示例矩阵和后续限制。
|
||||
- V4.8 后硬化新增 `examples/node_analytical_plane_contact/`,将 node-based slave surface 到 analytical rigid plane 的接触路径提升为可双击示例和 CTest smoke。
|
||||
- V4.8 后硬化新增内部 GMRES 求解器和 `perf_contact_pair_p1`,增强线性求解器与接触性能验收覆盖。
|
||||
- V4.8 后硬化补齐 `examples/block_on_arch/`、`examples/cylinder_roller_contact/`、`examples/sliding_wedge/`、`examples/membrane_airbag_inflation/`、`examples/spherical_cap_with_central_point_load/`、`examples/two_arches/`、`examples/blasting_rock/`、`examples/nonlinear_harmonic/`、`examples/failure_prediction_in_a_layered_shell/`、`examples/pinched_hemispherical_shell/`、`examples/stress_dependent_elasticity/`、`examples/roll_forming/`、`examples/falling_objects/`、`examples/ball_adhesion_decohesion/`、`examples/buckling_corrugated_shell/`、`examples/Dynamic_Grain_Packing_of_a_Flexible_Container/` 和 `examples/thick_plate/`;每个目录均包含 README、可执行 `.inp` 和 `run_case.bat`,并在 README 中标明当前求解器覆盖范围与未覆盖的完整高保真能力。
|
||||
|
||||
已补充测试:
|
||||
|
||||
- `elliptic_membrane_s4_static.inp`、`membrane_uniaxial_s4_static.inp`、`shell_solid_connection_static.inp` 和 `strength_reduction_slope_static.inp` 已完成静力求解 smoke。
|
||||
- `example_golf_ball_impact_smoke` 使用短步数动态输入检查接触输出,避免常规回归运行完整长跑。
|
||||
- 新增 `example_node_analytical_contact_smoke`、`example_block_on_arch_contact_smoke`、`example_cylinder_roller_contact_smoke`、`example_sliding_wedge_friction_smoke`、`example_roll_forming_friction_smoke`、`example_falling_objects_contact_smoke`、`example_ball_adhesion_contact_smoke`、`example_buckling_corrugated_shell_smoke`、`example_dynamic_grain_container_smoke`、`example_thick_plate_pressure_smoke`、`example_membrane_airbag_pressure_smoke`、`example_spherical_cap_point_load_smoke`、`example_blasting_rock_pulse_smoke`、`example_nonlinear_harmonic_membrane_smoke`、`example_layered_shell_tension_smoke`、`example_two_arches_contact_smoke`、`example_pinched_hemisphere_smoke` 和 `example_stress_dependent_cantilever_smoke`,覆盖节点-解析面、壳/实体接触、摩擦滑移、多物体接触、球-膜压入、波纹锥壳静力预载、柔性容器压力-地面接触、厚板压力、压力载荷、脉冲动力、壳-壳接触、层合壳拉伸、曲壳 pinched load 和分区弹性梁弯曲路径。
|
||||
- `examples_layout` 纳入 Python CTest 分支,保护示例目录结构约定。
|
||||
- Windows GCC 16 Release 构建已通过;全量 CTest 已通过,47/47 passed。
|
||||
- Windows GCC 16 Release 构建已通过;全量 CTest 已通过,66/66 passed。
|
||||
- 已手动验证 `examples/elliptic_membrane/run_case.bat` 静力入口和 `examples/clamped_square_plate_pressure_pulse/run_case.bat` 动力入口均可在 `FEMLITE_NO_PAUSE=1` 下完成。
|
||||
|
||||
后续:
|
||||
|
||||