Files
FemLite/docs/v4_development_plan.md
T
2026-06-24 18:07:39 +08:00

607 lines
27 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# FemLite 0.4.x 第四版开发计划
文档状态:第四版开发建议稿
日期:2026-06-24
适用对象:FemLite 0.4.0 至 0.4.x 开发、评审、测试与阶段验收
## 1. 文档目的
本文档定义 FemLite 第四版的开发定位、阶段划分、技术路线、验收准则和风险控制。
第四版以 0.3.3 第三版阶段验收基线为起点,在保持显式动力学、静力学、隐式 Newmark、壳单元、面-面接触和外部接口能力不回退的前提下,重点推进工程级非线性接触、隐式非线性求解稳定性、Abaqus surface/contact 输入子集、壳塑性验证和大规模性能能力。
## 2. 第四版定位
FemLite 0.4.x 定位为:
```text
工程级非线性接触 + 隐式非线性求解增强 + 壳塑性验证 + 大规模性能基础版
```
第四版不是追求完整 Abaqus 全关键字兼容,也不是一次性完成所有工业级通用有限元能力。第四版的核心是把 0.3.3 已具备的阶段能力继续工程化,尤其是:
- 将 surface/contact 输入从 element-target 子集扩展为更完整的工程常用子集。
- 将面-面 contact pair 从 penalty/mortar 权重阶段能力推进到更稳健的 mortar/augmented penalty 接触框架。
- 将 Coulomb 摩擦从接触对级历史推进到更完整的接触积分点历史与正则化模型。
- 将非线性 Newmark-Newton 从骨架和小算例回归推进到更可靠的工程非线性求解流程。
- 将壳塑性、钻转稳定、剪切锁定和壳接触纳入系统验证。
- 将大规模接触搜索、并行、外部稀疏求解器和性能测试纳入阶段验收。
第四版工程约束:
- 普通过程/函数尽量不超过 100 行,超过 128 行必须登记审查理由和后续拆分方向。
- 源文件尽量不超过 1500 行,超过 2000 行必须审查是否拆分。
- `source_size` CTest 继续作为本地回归检查项。
- 新增大型算例结果不得全量提交到 git,只提交小型参考结果、抽样结果和生成脚本。
- 所有新增能力必须同时更新需求、详细设计、数学算法、接口、测试和用户/开发者手册中的相关章节。
## 3. 开发基线
0.3.3 已具备:
- 显式瞬态动力学。
- 线性静力和非线性静力入口。
- 隐式 Newmark 线性动力学和非线性 Newmark-Newton 主流程。
- C3D4、C3D8、C3D10、C3D20 实体单元。
- S3、S4、S6、S8 壳单元基础动力、静力和输出能力。
- 各向同性线弹性、J2 弹塑性、Johnson-Cook 强化/损伤相关路径。
- 材料状态、单元删除状态的 trial/restore/commit 机制。
- 实体 J2 算法切线,以及壳 section J2/J2_JC 切线路径。
- Robin、MPC、刚性平面接触和面-面 contact pair 的非线性切线装配。
- 面-面 contact pair 的投影裁剪面积、多 master 面积分摊、mortar 形函数积分、Coulomb 粘滑历史、stick/slip/累计滑移输出、空间网格和可选 OpenMP BVH 候选搜索。
- Abaqus `*SURFACE, TYPE=ELEMENT` 输入子集、face label 筛选、壳 `SPOS`/`SNEG` 侧向语义和数据行式 `*CONTACT PAIR` 子集。
- CSV、VTK、restart、C ABI、Python 调试接口。
- Windows GCC、WSL gfortran 和 Windows Intel oneAPI ifx/MSVC 构建与 CTest 验证。
0.3.3 已知限制中进入第四版的内容:
- `*SURFACE` 当前仍为 element-target 子集,尚未支持完整 Abaqus surface 变体、node-based surface、analytic rigid surface 和复杂 surface 操作。
- 面-面 contact pair 已具备 mortar 权重、摩擦历史和 BVH 搜索,但仍不是完整工程级 mortar 约束求解器。
- 摩擦模型当前以接触对级 Coulomb 粘滑历史为主,尚未形成接触积分点级历史和摩擦正则化参数体系。
- 大规模接触收敛控制、接触域分解和负载均衡仍需推进。
- 壳塑性一致切线仍需要更多弯曲/剪切塑性基准和长时间稳定性验证。
- 非线性 Newmark-Newton 仍需要更多工程基准、长时间稳定性验证和线性求解器鲁棒性增强。
## 4. 版本与分支策略
建议分支:
- `main`:保持已发布稳定版本。
- `dev/v0.4`:第四版主开发分支。
- `feature/v4-surface-input`:surface/contact 输入增强。
- `feature/v4-contact-mortar`:工程级 mortar/augmented penalty 接触。
- `feature/v4-friction`:摩擦正则化和接触历史变量。
- `feature/v4-implicit-robustness`:隐式非线性求解稳定性。
- `feature/v4-shell-plasticity`:壳塑性和壳基准。
- `feature/v4-performance`:大规模性能、并行和外部求解器。
版本号策略:
- `0.4.0`:完整 surface/contact 工程常用子集和工程级接触框架。
- `0.4.1`:摩擦正则化、接触积分点历史和接触功输出增强。
- `0.4.2`:隐式非线性长跑、步长控制和外部稀疏求解器接口。
- `0.4.3`:壳塑性基准、性能优化、多平台发布整理。
发布前必须更新:
- CMake 项目版本。
- Fortran 版本常量。
- `docs/v4_acceptance_report.md`。
- 用户手册和开发者手册。
- 接口、算法和测试文档。
## 5. 第四版阶段划分
| 阶段 | 名称 | 主要内容 | 完成标志 |
|---|---|---|---|
| V4.1 | Surface/contact 输入增强 | node-based surface、analytic rigid surface、contact property 子集 | 常用 Abaqus 接触输入可读取 |
| V4.2 | 工程级 mortar 接触 | active set、约束残差、一致切线、augmented penalty | 面-面接触收敛性显著提升 |
| V4.3 | 摩擦与接触输出 | 正则化 Coulomb、积分点历史、摩擦功和耗散输出 | 粘滑转换和能量输出可验证 |
| V4.4 | 搜索与并行 | BVH 动态更新、候选缓存、OpenMP 装配优化 | 大规模 contact pair 性能测试通过 |
| V4.5 | 隐式非线性鲁棒性 | 自适应步长、多准则收敛、求解失败诊断 | 非线性静力/动力长跑稳定 |
| V4.6 | 稀疏求解器接口 | 线性求解器抽象、预条件、外部库预留 | 可切换内部/外部求解路径 |
| V4.7 | 壳塑性与壳基准 | 弯曲/剪切塑性切线、锁定测试、壳接触基准 | 壳非线性基准矩阵通过 |
| V4.8 | 验证、性能和发布 | 大算例、文档、验收报告、多编译器回归 | 形成 0.4.x 阶段验收版 |
## 6. V4.1 Surface/Contact 输入增强
目标:
- 扩展 Abaqus inp 中 surface 和 contact 相关关键字的工程常用子集。
- 让典型接触算例的建模过程更接近 Abaqus 输入习惯。
建议实现内容:
1. 扩展 `*SURFACE`:
- `TYPE=ELEMENT` 的更多数据行变体。
- `TYPE=NODE` 或 node-based surface 子集。
- analytic rigid surface 子集。
- surface `GENERATE`。
- surface `OP=ADD`、`OP=NEW` 的完整回归。
- element set、node set、混合显式编号的数据行。
2. 扩展 shell surface 语义:
- `SPOS`、`SNEG`、双侧 shell surface 行为。
- 壳法向翻转、slave/master 侧向筛选。
3. 扩展 `*CONTACT PAIR`:
- header 式和数据行式输入。
- contact property 名称关联。
- 小滑移/有限滑移参数先 warning 或保留字段。
4. 增加接触属性输入:
- 法向 penalty。
- 法向阻尼。
- 摩擦系数。
- 摩擦正则化参数预留。
5. 明确 unsupported keyword 行为:
- 不影响模型完整性的参数 warning 后跳过。
- 关键 surface 或 contact pair 数据缺失时 error。
验收条件:
- node-based surface 小算例可读取并导出 facet 或节点目标。
- analytic rigid surface 小算例可读取并参与接触。
- element surface 的 face label、elset、显式编号、`OP=ADD/NEW` 回归通过。
- contact property 可正确绑定到 contact pair。
- 不支持参数的 warning 信息稳定、可读、可测试。
## 7. V4.2 工程级 Mortar 接触
目标:
- 将第三版 penalty/mortar 权重阶段能力推进到更稳健的工程接触求解框架。
建议实现内容:
1. 接触 active set:
- 激活、保持、释放三类状态。
- 接触开闭切换记录。
- 初始穿透处理策略。
2. 接触残差:
- 法向 gap 约束残差。
- mortar 约束积分残差。
- slave/master 双侧贡献。
3. 接触切线:
- gap 对节点位移的线性化。
- 法向变化项的近似或一致处理。
- mortar 权重对局部坐标的敏感性可先近似,需文档说明。
4. 求解策略:
- penalty 继续保留为默认稳健路径。
- augmented penalty 或 augmented Lagrangian 作为第四版主增强方向。
- Lagrange multiplier 路径可预留,不作为 0.4.0 必需项。
5. 接触稳定化:
- 法向 penalty 自动建议值。
- penalty 过大导致病态时的诊断。
- 穿透容限和接触力容限。
验收条件:
- 平块压入刚体平面静力接触可收敛。
- 两弹性块面-面压缩接触可收敛,压力分布合理。
- 壳-刚体接触可运行并输出接触功。
- active set 切换不会破坏 trial/rollback。
- 接触残差、接触力、最大穿透量和接触功随网格加密趋势合理。
## 8. V4.3 摩擦与接触输出
目标:
- 从接触对级摩擦历史推进到接触积分点级或 mortar 积分点级摩擦历史。
- 建立可验证的摩擦功、接触功和粘滑状态输出。
建议实现内容:
1. 摩擦历史变量:
- 接触积分点切向滑移。
- 切向牵引。
- stick/slip 状态。
- 累计滑移。
2. 摩擦模型:
- 无摩擦。
- Coulomb 摩擦。
- 正则化 Coulomb 摩擦。
- 粘滑转换返回映射。
3. 摩擦切线:
- stick 状态切向 penalty。
- slip 状态一致或近似切线。
- 正则化参数对切线的影响。
4. 输出:
- 法向接触功。
- 摩擦功。
- 累计耗散能。
- stick/slip 计数。
- 最大穿透和最大切向滑移。
- contact pair 分项统计。
验收条件:
- block sliding 摩擦算例可重现静摩擦到动摩擦转换趋势。
- 摩擦功非负耗散检查通过。
- 粘滑循环加载历史变量不丢失。
- contact CSV 字段稳定并在用户手册中说明。
## 9. V4.4 搜索、并行与大规模接触
目标:
- 提高接触搜索和接触装配在大规模模型中的效率与可诊断性。
建议实现内容:
1. BVH 增强:
- BVH 构建、重构和更新策略。
- facet AABB 扩张距离。
- 候选缓存与失效条件。
2. 空间网格增强:
- 网格尺寸自动估计。
- 高度非均匀模型的 fallback 策略。
3. OpenMP 并行:
- slave facet 并行搜索。
- contact pair 并行残差计算。
- 装配阶段减少临界区。
- 摩擦历史更新的线程安全。
4. 性能输出:
- facet 数。
- broad-phase 候选数。
- narrow-phase 激活数。
- 搜索时间。
- 接触力和切线装配时间。
验收条件:
- 大规模接触 P1 性能测试通过。
- 并行和串行路径结果在容限内一致。
- 接触搜索时间随 facet 数增长趋势合理。
- OpenMP 关闭时功能不回退。
## 10. V4.5 隐式非线性求解鲁棒性
目标:
- 让非线性静力和非线性 Newmark-Newton 可用于更复杂材料、接触和壳模型。
建议实现内容:
1. Newton 策略:
- full Newton。
- modified Newton。
- 自动切换或用户控制。
2. 收敛准则:
- 力残差绝对/相对准则。
- 位移增量准则。
- 能量范数准则。
- 接触穿透准则。
3. 步长控制:
- 自适应增量。
- cutback 后状态恢复。
- 最小步长退出。
- 最大 cutback 次数。
4. 线搜索:
- 残差型线搜索。
- 能量型线搜索预留。
5. 失败诊断:
- 线性求解失败。
- 接触 penalty 病态。
- 约束不足。
- 材料局部失效导致刚度退化。
验收条件:
- 非线性静力弹塑性加载卸载长跑稳定。
- 接触非线性静力压入可自动 cutback 并最终收敛。
- 非线性 Newmark 接触冲击小算例可完成指定时间。
- 失败日志能说明失败阶段、残差和建议检查项。
## 11. V4.6 稀疏求解器接口
目标:
- 建立内部/外部线性求解器可切换的架构,为大规模隐式求解做准备。
建议实现内容:
1. 线性求解器抽象层:
- CSR 矩阵输入。
- RHS 和解向量。
- 求解器参数。
- 迭代历史和失败码。
2. 内部求解器增强:
- CG 保留。
- BiCGSTAB 或 GMRES。
- Jacobi 预条件。
- 简单对角缩放。
3. 外部求解器预留:
- MUMPS。
- SuperLU。
- Intel MKL Pardiso。
- oneAPI/MKL 检测和 CMake 选项。
4. 跨平台策略:
- 默认不强依赖外部库。
- 外部库不可用时自动降级到内部求解器。
- Windows、WSL Linux、Intel Fortran 和 gfortran 路径都需可配置。
验收条件:
- 线性求解器接口单元测试通过。
- 内部 CG/BiCGSTAB 或 GMRES 可在相同 CSR 矩阵上切换。
- 外部求解器未启用时构建不受影响。
- 求解器残差和迭代数进入 convergence CSV 或日志。
## 12. V4.7 壳塑性与壳非线性基准
目标:
- 系统验证壳单元在塑性、弯曲、剪切、锁定和接触问题中的表现。
建议实现内容:
1. 壳塑性切线:
- 膜内塑性路径继续保留。
- 弯曲塑性一致切线增强。
- 横向剪切塑性切线增强。
- section 积分点状态 trial/rollback 检查。
2. 壳数值稳定:
- drilling DOF 稳定参数敏感性。
- 剪切锁定敏感性。
- 膜锁定敏感性。
- hourglass 控制策略复查。
3. 壳基准:
- Scordelis-Lo 网格收敛。
- pinched cylinder。
- hemispherical shell。
- twisted beam。
- clamped square plate pressure pulse 长跑。
4. 壳接触:
- 壳-刚体接触。
- 壳-壳接触。
- 壳 SPOS/SNEG 接触侧向回归。
验收条件:
- 壳弯曲和剪切塑性测试通过。
- 壳静力基准位移与参考解趋势一致。
- 壳显式压力脉冲长跑稳定。
- 壳接触算例接触状态和法向方向正确。
## 13. V4.8 验证、性能和发布
目标:
- 建立第四版验收矩阵,覆盖接触、隐式、壳、性能和多平台兼容性。
建议测试矩阵:
- 单元测试:
- surface 解析。
- contact property 解析。
- mortar 权重。
- 摩擦历史变量。
- active set 状态切换。
- BVH 候选搜索。
- 线性求解器接口。
- 模块测试:
- 接触残差和切线。
- 摩擦功和接触功。
- 非线性 cutback。
- 壳 section tangent。
- 示例 smoke:
- Hertz 或简化压入接触。
- block sliding。
- shell contact。
- nonlinear Newmark contact impact。
- P1 性能测试:
- 10000 节点、10000 单元、100 步保持回归。
- 新增中等规模接触搜索性能。
- P2 长跑:
- 大规模 contact pair。
- 非线性 Newmark 长时间稳定性。
- 壳压力脉冲长跑。
发布验收环境:
- Windows GCC。
- WSL Ubuntu gfortran。
- Windows Intel oneAPI ifx + MSVC。
- OpenMP 开启和关闭两种路径。
- 外部求解器开启路径如尚未具备,可记录为可选验证。
## 14. 接口影响
第四版接口扩展原则:
- 现有 Fortran95 接口保持向后兼容。
- C ABI 保持已公开函数签名稳定,新增函数只能追加。
- Python 调试接口跟随新增查询能力,但不作为高性能接口。
- 外部 SPH 耦合接口不依赖接触内部实现。
建议新增或增强接口:
- surface 数量、surface 类型和 surface facet 查询。
- contact pair 属性查询。
- 接触 summary 查询扩展:
- active set 数量。
- stick/slip 数量。
- 法向接触功。
- 摩擦功。
- 最大切向滑移。
- 搜索候选数量。
- 线性求解器统计查询:
- 求解器类型。
- 迭代次数。
- 最终残差。
- 失败码。
- 非线性求解统计查询:
- 当前增量。
- Newton 迭代次数。
- cutback 次数。
- 收敛状态。
## 15. 文档更新要求
第四版开发过程中必须同步更新:
- `docs/01_requirements_specification.md`:
- 增加第四版范围和非范围。
- `docs/02_software_architecture_design.md`:
- 增加接触、求解器和外部稀疏求解器架构。
- `docs/03_detailed_design.md`:
- 增加 surface/contact 数据结构、active set、摩擦历史和求解器接口。
- `docs/04_mathematical_model_and_algorithms.md`:
- 增加 mortar/augmented penalty、摩擦正则化、非线性收敛策略。
- `docs/05_interface_control_document.md`:
- 增加 surface/contact/solver 统计查询接口。
- `docs/06_test_and_verification_plan.md`:
- 增加第四版验收测试矩阵。
- `docs/07_user_manual.md`:
- 增加新输入、接触设置、求解器选项和输出说明。
- `docs/08_developer_manual.md`:
- 增加开发流程、模块边界和扩展指南。
- `docs/v4_acceptance_report.md`:
- 第四版验收时新增,不在开发初期提前伪造验收结论。
## 16. 风险与控制
主要风险:
- 工程级 mortar 接触范围过大,导致 0.4.0 无法阶段验收。
- 接触一致切线复杂,可能引入非线性收敛回退。
- 摩擦历史变量和 OpenMP 并行更新存在状态一致性风险。
- 外部稀疏求解器依赖跨平台配置复杂。
- 壳塑性与接触叠加后验证难度显著提高。
- 大规模性能优化可能与 Fortran95 非面向对象约束发生冲突。
控制策略:
- penalty 接触作为始终可用 fallback。
- augmented penalty 优先于完整 Lagrange multiplier 路径。
- mortar 权重、active set、摩擦历史、切线装配分阶段接入。
- 先用小型解析算例验证,再扩展到长跑和大规模算例。
- 外部求解器保持可选,不作为默认构建依赖。
- 所有接触状态修改必须进入 trial/rollback 流程。
- 性能优化不得破坏串行确定性回归。
## 17. 与后续版本的边界
第四版不强制完成:
- 完整 Abaqus 全关键字兼容。
- 完整 Abaqus 所有 contact formulation。
- 通用自接触最终版。
- 完整热-力耦合求解。
- 分布式 MPI 并行。
- 大规模工业模型的生产级 GUI 前后处理。
- 高阶复杂材料库。
- 完整商业求解器级别的接触鲁棒性。
这些内容可进入 0.5.0 或后续版本。
## 18. 第四版阶段验收准则
0.4.x 阶段验收建议满足:
- 0.1.0、0.2.0、0.3.3 已验收能力无回退。
- `*SURFACE` 和 `*CONTACT PAIR` 工程常用子集明显扩展,并有解析回归测试。
- node-based surface 或 analytic rigid surface 至少一类达到可用。
- 工程级 mortar/augmented penalty 接触小算例可稳定收敛。
- 摩擦正则化和接触积分点历史变量具备可验证输出。
- 接触功、摩擦功、stick/slip、最大穿透和接触搜索统计可输出。
- 非线性静力和非线性 Newmark 接触算例可完成长跑。
- 壳塑性弯曲/剪切基准和壳接触小算例通过。
- 至少一个中等规模接触性能测试通过。
- 内部线性求解器接口可切换,并输出迭代统计。
- Windows GCC、WSL gfortran、Windows Intel ifx/MSVC 构建和 CTest 通过。
- `source_size` 无 active hard-threshold exception,或每个例外均有审查理由和拆分计划。
- 用户手册、开发者手册、接口文档、算法文档、测试文档和验收报告同步更新。
## 19. 建议启动顺序
建议第四版先做 V4.1 和 V4.2:
1. 扩展 surface/contact 输入和数据结构。
2. 固化 contact pair property、active set 和状态变量。
3. 将现有 penalty/mortar 接触接入新的 active set 框架。
4. 增加小型接触收敛测试。
5. 再推进摩擦正则化、并行搜索和隐式求解鲁棒性。
这样可以先稳定数据结构和接口,再逐步替换接触算法内部实现,降低对已有显式、静力和隐式测试的冲击。
## 20. 当前阶段性简化实现清单与处置策略
代码中未发现独立命名为 mini 版或 demo 版的求解器模块,但存在若干第三版阶段验收所需的简化实现、fallback 路径和工程近似。第四版不应直接删除这些实现,而应先登记、测试保护,再按优先级替换或增强。
处置原则:
- 已通过验收、能稳定支撑示例和测试的简化实现保留为 fallback。
- 会影响第四版接触、隐式和壳非线性目标的简化实现,应列入 V4 主线增强。
- 仅用于调试或小规模验证的实现,应增加命名、文档和 warning,避免用户误认为工程级能力。
- 替换简化实现前,必须先补充等价回归测试,保证旧路径可对比、可回退。
当前简化实现与第四版处置建议:
| 类别 | 当前代码形态 | 是否删除 | 第四版处置 |
|---|---|---:|---|
| Surface 输入 | `*SURFACE` 当前只支持 `TYPE=ELEMENT` 子集,`OP=ADD/NEW` 和 face label 已支持基础语义 | 不删除 | V4.1 扩展 node-based surface、analytic rigid surface、更多数据行和 contact property 绑定 |
| 未支持 INP keyword | 未支持 keyword warning 跳过,关键数据缺失才 error | 不删除 | 保持兼容策略,但为 contact/surface 关键字建立更细的 warning/error 分级 |
| 刚性平面接触 | 节点到刚性平面的 penalty/damping 法向接触 | 保留 | 作为接触 fallback 和调试基准,补充 active set 输出和接触功一致性检查 |
| 面-面 contact pair | mortar 权重、投影裁剪、多 master 分摊、penalty 法向力和近似切线 | 不删除 | V4.2 升级为 active set + augmented penalty/mortar 残差和更一致切线 |
| 摩擦历史 | 接触对级 Coulomb 粘滑历史,切向刚度按 `penalty * area` 估计 | 不删除 | V4.3 升级为接触积分点或 mortar 积分点历史、正则化 Coulomb 和摩擦功输出 |
| 接触并行 | BVH 搜索可 OpenMP 并行,但力/切线装配仍依赖 critical 保护 | 不删除 | V4.4 降低锁竞争,增加候选缓存、并行一致性测试和性能统计 |
| 壳 drilling 稳定 | 使用固定 `SHELL_DRILLING_STIFFNESS_FACTOR = 1.0e-4` | 不删除 | V4.7 参数化并增加敏感性测试,形成推荐范围和失稳诊断 |
| S3 剪切锁定处理 | 使用经验型 `shell3_shear_locking_scale` | 不删除 | V4.7 通过基准算例验证,必要时替换为更系统的 MITC/ANS 或改进减缩策略 |
| 壳局部几何 | 壳静力基于局部平面 basis,复杂曲壳几何仍是阶段能力 | 不删除 | V4.7 用 Scordelis-Lo、pinched cylinder、hemisphere 等曲壳基准约束误差 |
| 壳塑性切线 | section tangent 已接入膜、弯曲、剪切映射,但基准仍不足 | 不删除 | V4.7 补充弯曲/剪切塑性、卸载和长跑基准 |
| 质量矩阵 | 显式和隐式动力主要使用集中质量,壳转动惯量为对角近似 | 保留 | 显式继续默认集中质量;V4.5/V4.6 可预留一致质量或改进转动惯量选项 |
| 线性求解器 | 内部 CG + Jacobi 预条件为主 | 保留 | V4.6 增加求解器抽象、BiCGSTAB/GMRES、预条件和外部稀疏求解器预留 |
| MPC | MPC 当前采用 penalty 装配 | 保留 | 非 V4 主线;接触/隐式增强后再考虑 Lagrange multiplier 或更严格约束形式 |
| 材料大变形 | 当前为小应变 J2/J2_JC + Jaumann 客观率的 hypoelastic-plastic 路径 | 保留 | 第四版主要验证其在接触/隐式中的稳定性;完整 `F = Fe Fp` 可列入后续版本 |
| Restart | restart 保存已建模型上的 DOF、单元状态和高斯点状态,不保存完整 inp 模型数据库 | 保留 | 如 V4 新增接触积分点历史,restart 必须同步保存新增历史变量 |
| 输出 | CSV/VTK 为工程调试级输出,单元量多为平均值 | 保留 | V4 增加 contact/solver 统计和关键积分点历史输出,避免提交大规模全场结果 |
第四版启动前建议先建立对应测试保护:
- 刚性平面 penalty 接触回归。
- 现有面-面 contact pair 回归。
- 摩擦 stick/slip 计数回归。
- S3/S4 壳静力和压力脉冲回归。
- CG+Jacobi 小型 CSR 求解回归。
- restart 写读现有状态回归。
第四版完成后,上表中仍保留的 fallback 应在用户手册中明确标注适用范围,避免与工程级新路径混淆。
## 21. 简化策略 0.4.x 实施计划列表
当前简化策略可以全部纳入 0.4.x 管理,但不应全部承诺为“最终完整实现”。第四版采用三类完成口径:
- A 类:0.4.x 内完成工程化替换或增强,旧实现保留为 fallback。
- B 类:0.4.x 内完成参数化、验证、文档和可诊断输出,暂不强制替换旧实现。
- C 类:0.4.x 内完成接口预留、风险隔离和回归保护,完整实现进入 0.5.0 或后续。
0.4.x 计划列表:
| 编号 | 简化策略 | 0.4.x 完成口径 | 阶段 |
|---|---|---|---|
| S1 | `*SURFACE, TYPE=ELEMENT` 子集 | A 类。扩展 node-based surface、analytic rigid surface、surface/contact property 常用子集;旧 element surface 保留兼容 | V4.1 |
| S2 | unsupported INP keyword warning 跳过 | B 类。建立 contact/surface 关键字 warning/error 分级表,关键数据缺失保持 error | V4.1 |
| S3 | 刚性平面 penalty 接触 | B 类。保留为 fallback,补充 active set 统计、接触功一致性、接触状态输出和回归测试 | V4.2, V4.3 |
| S4 | 面-面 penalty/mortar 近似接触 | A 类。升级为 active set + augmented penalty/mortar 残差 + 更一致切线;旧 penalty/mortar 路径保留为调试 fallback | V4.2 |
| S5 | contact-pair 级摩擦历史 | A 类。升级到接触积分点或 mortar 积分点历史,补充正则化 Coulomb、粘滑切换和摩擦功输出 | V4.3 |
| S6 | BVH/OpenMP 装配依赖 critical | A 类。降低锁竞争,增加候选缓存、线程私有累加或分块装配,并建立串并行一致性测试 | V4.4 |
| S7 | 固定 drilling 稳定系数 | B 类。改为可配置参数,增加默认推荐值、敏感性测试、失稳诊断和用户手册说明 | V4.7 |
| S8 | S3 剪切锁定经验缩放 | B 类。通过壳基准验证误差;必要时增加改进减缩、MITC/ANS 预研路径或更明确适用范围 | V4.7 |
| S9 | 壳局部平面几何近似 | B 类。用曲壳基准矩阵约束误差,补充法向、曲率和局部坐标诊断;不承诺完整有限转动壳最终形态 | V4.7 |
| S10 | 壳塑性 section tangent 基准不足 | A 类。补充弯曲/剪切塑性切线验证、卸载路径、长跑基准和 trial/rollback 回归 | V4.7 |
| S11 | 集中质量和壳转动惯量对角近似 | B 类。显式继续默认集中质量;隐式路径增加一致质量或改进转动惯量选项的设计和小算例验证 | V4.5, V4.6 |
| S12 | CG + Jacobi 单一路径 | A 类。建立线性求解器抽象,增加 BiCGSTAB/GMRES 或等价内部求解器、预条件接口和外部稀疏求解器预留 | V4.6 |
| 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 类。0.4.x 同步保存新增接触历史、摩擦历史和求解状态;完整 inp 数据库级 restart 作为后续增强 | V4.3, V4.8 |
| S16 | CSV/VTK 调试级输出和单元平均量 | B 类。增加 contact/solver 统计、关键积分点历史抽样和输出体量控制;全量高性能后处理格式后续推进 | V4.3, V4.8 |
0.4.x 验收时,上述列表应逐项给出状态:
- `DONE`:按 A/B/C 类口径完成并有测试。
- `PARTIAL`:已有实现但未达到计划口径,需要说明缺口。
- `DEFERRED`:经评审确认推迟到 0.5.0 或后续,必须说明原因和风险。
任何 `DEFERRED` 项不得影响 0.1.0、0.2.0、0.3.3 已验收能力。