Checkpoint V5.11 shell redesign baseline
This commit is contained in:
+79
-32
@@ -16,6 +16,8 @@ FemLite 核心代码采用 Fortran 95 非面向对象风格,使用集中式 `f
|
||||
- 外部编号默认使用 Abaqus 原始编号,内部计算使用数据库映射编号。
|
||||
- 不支持的 Abaqus keyword 作为 warning 跳过,关键数据缺失或非法数据才 error。
|
||||
- 新增功能必须配套小型测试;影响共享行为时补充回归测试。
|
||||
- 如果同一算法同时存在前期遗留简化版和后期补强完整版,必须删除简化版;
|
||||
只有确需诊断的旧路径可以隔离到非生产调试入口,且不得作为生产 fallback 或验收证据。
|
||||
- 大型输出和临时结果不进入 git。
|
||||
|
||||
## 3. 构建目标
|
||||
@@ -77,11 +79,22 @@ src/interface C ABI 和 Fortran-C bridge
|
||||
| `fem_precision` | 全局精度、维度、版本常量 |
|
||||
| `fem_error` | 错误码和错误消息 |
|
||||
| `fem_control` | 时间步、求解控制、输出控制、V4.5 收敛诊断、V4.6 线性求解器状态、V4.7 壳稳定参数和 V5 nonlinear continuation 控制/诊断 |
|
||||
| `fem_api` | Fortran95 公共 API |
|
||||
| `fem_api` | Fortran95 公共 API facade,保留初始化、模型 I/O、求解/输出编排并 re-export API support 模块 |
|
||||
| `fem_api_state` | 公共 API 初始化状态 |
|
||||
| `fem_api_coupling` | SPH、contact、surface 和 boundary facet 相关公共 API |
|
||||
| `fem_api_diagnostics` | 收敛、continuation path、线性求解器和壳稳定公共 API |
|
||||
| `fem_api_state_access` | 节点运动学/反力/内力和单元状态公共 API |
|
||||
| `fem_api_stable_dt` | 公共 API 背后的稳定时间步估算 support 模块 |
|
||||
| `fem_inp_reader` | 两遍 INP 读取主流程 |
|
||||
| `fem_inp_defs` | INP 模式常量 |
|
||||
| `fem_inp_helpers` | INP 行解析和 keyword helper |
|
||||
| `fem_database` | 集中式全局数组、分配、初始化、校验和释放 |
|
||||
| `fem_inp_material_parser` | Mohr-Coulomb 等材料专用 INP 数据行解析 |
|
||||
| `fem_inp_contact_parser` | contact pair/property/friction 专用 INP 解析 |
|
||||
| `fem_inp_nlc` | `*NONLINEAR CONTINUATION` 方法和控制参数解析 |
|
||||
| `fem_database` | 集中式全局数组分配、DOF 分配和稳定 public wrapper |
|
||||
| `fem_database_lookup` | 节点/单元/集合/材料/surface/contact property 查询和 surface face helper |
|
||||
| `fem_database_lifecycle` | 数据库初始化/释放、contact 历史重置和计数归零 |
|
||||
| `fem_database_validation` | 完整模型校验、contact property 应用和输入一致性检查 |
|
||||
| `fem_database_surface` | surface/contact 目标和 facet 查询 helper |
|
||||
| `fem_material_j2` | J2 和 Johnson-Cook 相关材料更新 |
|
||||
| `fem_material_mohr_coulomb` | Mohr-Coulomb 返回映射、张拉截断、分支状态和活动集算法一致切线 |
|
||||
@@ -89,13 +102,23 @@ 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 reference/current local frame、刚体转动扣除和 corotational kinematics helper |
|
||||
| `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_dload_tangent` | 壳 `DLOAD P` current-geometry follower-pressure tangent 装配 |
|
||||
| `fem_geometric_stiffness` | 线性屈曲几何刚度 helper,当前覆盖梁柱几何刚度 |
|
||||
| `fem_element_internal` | 单元内力 |
|
||||
| `fem_solver_implicit` | 静力、隐式 Newmark、非线性 Newton、目标 Newton 自适应步长和 trust-region damped Newton 主流程 |
|
||||
| `fem_implicit_constraints` | 隐式求解 Dirichlet、Robin、MPC、外载和接触切线施加 |
|
||||
| `fem_solver_implicit` | 线性静力和隐式/非线性静力 dispatcher |
|
||||
| `fem_solver_static_nonlinear` | 非线性静力 fixed/adaptive loop、位移控制 path、Riks/arc-length 和静力 Newton 增量 |
|
||||
| `fem_solver_newmark` | 线性 Newmark 和非线性 Newmark-Newton 时间积分 |
|
||||
| `fem_eigensolver` | 内部 dense 对称 Jacobi 和 SPD 广义特征值求解 |
|
||||
| `fem_buckling_solver` | 线性屈曲 dense solve、几何刚度符号、Euler 解析载荷和模态 helper |
|
||||
| `fem_buckling_column` | Euler 柱 `femlite --buckling` 输入、装配、求解和 CSV 输出生产入口 |
|
||||
| `fem_contact` | 接触公开入口和刚性平面接触 |
|
||||
| `fem_contact_*` | contact pair 状态、目标、几何、搜索、摩擦、力、切线、mortar/AL、multiplier 和输出 |
|
||||
| `fem_contact_multiplier` | mortar/AL 积分点乘子、trial/commit/rollback、restart 和 audit |
|
||||
@@ -156,6 +179,8 @@ INP 相关文件:
|
||||
- `fem_inp_reader.f90`:主读取流程。
|
||||
- `fem_inp_defs.f90`:mode 常量。
|
||||
- `fem_inp_helpers.f90`:keyword 和 data-line helper。
|
||||
- `fem_inp_nlc.f90`:`*NONLINEAR CONTINUATION` 方法、Riks/arc-length、
|
||||
trust-region、MC 子步和 shell geometry 开关解析。
|
||||
|
||||
扩展新 keyword 的建议步骤:
|
||||
|
||||
@@ -239,33 +264,42 @@ fem_contact_mortar_*.f90 mortar/AL 点更新、批处理、约束、迭代、报
|
||||
- `fem_linear_solver_iterative.f90`:CG、BiCGSTAB、GMRES 和
|
||||
none/Jacobi/Gauss-Seidel/ILU0 预条件。
|
||||
- `fem_linear_solver_dense.f90`:内部 dense pivoting fallback,用于小中型回归矩阵和非线性修正诊断。
|
||||
- `fem_solver_implicit.f90`:静力、隐式 Newmark、非线性 Newton。
|
||||
- `fem_implicit_constraints.f90`:Dirichlet、Robin、MPC、follower-load
|
||||
tangent 和 contact tangent 施加;主求解器只调用该模块入口。
|
||||
- `fem_solver_implicit_support.f90`:隐式求解共享的收敛诊断、非线性线性方程 fallback、外载/刚度装配、CSR/mass helper 和 trust-region 更新。
|
||||
- `fem_solver_static_nonlinear.f90`:非线性静力 fixed/adaptive loop、静力 predictor history、直接位移控制 path、载荷型 Riks/arc-length 增广方程和静力 Newton 增量。
|
||||
- `fem_solver_newmark.f90`:线性 Newmark 和非线性 Newmark-Newton 时间积分;公开入口由 `fem_solver_implicit` 继续 re-export。
|
||||
- `fem_solver_implicit.f90`:线性静力和隐式/非线性静力 dispatcher,保持既有公开入口。
|
||||
|
||||
V4.6 起,隐式求解器内部不再直调 CG,而是通过 `linear_solver_solve` 分发。当前内部支持 CG、BiCGSTAB、GMRES 和 dense pivoting fallback;V5 当前模块要求保持稀疏求解器无第三方依赖,不导出外部求解器 method、backend、外部进程交互或 C ABI 接口。旧外部 method 数值必须在配置边界返回错误并保持当前设置不变。分发层在每次求解前调用 CSR diagnostics 记录矩阵分类,并在求解前后记录初始残差、最终残差和最终相对残差;新增线性求解能力时优先扩展 `fem_linear_solver_iterative`、`fem_linear_solver_dense`、CSR 诊断和预条件器。非线性 Newton 修正可在配置 CG 失败后依次尝试内部 GMRES、BiCGSTAB、dense pivoting 和受限对角正则化 dense pivoting,并在返回前恢复用户配置。如确需第三方 solver,必须在当前模块之外重新立项。测试工具放在 `tools/`,不要放入 `src/`。
|
||||
|
||||
Nonlinear continuation 维护约定:`*NONLINEAR CONTINUATION` 的解析留在
|
||||
`fem_inp_helpers`,控制、最近一次诊断和 accepted-increment path 表留在
|
||||
`fem_control`。NC-2 目标 Newton 步长控制、NC-3 trust-region damped Newton 和
|
||||
NC-4 直接位移控制 path 记录必须在 `fem_solver_implicit` 的生产非线性静力路径内
|
||||
实现;`tools/benchmarks` 只能编排案例、收集 diagnostics 和写 CSV。修改
|
||||
`fem_inp_nlc`,通用 keyword/data-line helper 留在 `fem_inp_helpers`;
|
||||
控制、最近一次诊断和 accepted-increment path 表留在
|
||||
`fem_control`。NC-2 目标 Newton 步长控制、NC-3 trust-region damped Newton、
|
||||
NC-4 载荷型 Riks/arc-length 增广方程和直接位移控制 path 记录必须在
|
||||
`fem_solver_static_nonlinear` 的生产非线性静力路径内实现;Dirichlet/Robin/MPC/
|
||||
follower-load/contact tangent 的施加边界留在 `fem_implicit_constraints`。
|
||||
`tools/benchmarks` 只能编排案例、收集 diagnostics 和写 CSV。修改
|
||||
continuation 参数、诊断字段、path CSV/API 字段或接受/拒绝规则时,必须同步更新
|
||||
`implicit_inp`、`solver_implicit`、strengthReduction checker、算法文档、接口文档和
|
||||
用户手册。NC-3 的 `convergence_correction_norm` 必须表示实际应用的
|
||||
damped/trust-limited 修正范数;NC-4 的目标位移必须使用求解时实际施加的
|
||||
`load_factor * amplitude * boundary_value`,不能用未缩放的边界输入值代替。NC-5
|
||||
局部 Mohr-Coulomb 子步控制量也放在 `fem_control`,解析留在 `fem_inp_helpers`;
|
||||
局部 Mohr-Coulomb 子步控制量也放在 `fem_control`,解析留在 `fem_inp_nlc`;
|
||||
生产材料分发通过 `fem_material_j2` 进入 `fem_material_mc_driver`,不要在
|
||||
benchmark 工具里重写材料积分。
|
||||
S4 几何非线性开关同样属于生产路径:`SHELL_GEOMETRIC`、`GEOMETRIC_SHELL`、
|
||||
`COROTATIONAL_SHELL` 和 `S4_COROTATIONAL` 的解析在 `fem_inp_helpers`,状态在
|
||||
`fem_control%shell_geometric_nonlinear`,运动学在 `fem_shell_corotational`。方法 4
|
||||
会默认启用同一 S4 current-frame 路径。修改该语义时必须同步
|
||||
`test_shell_internal`、`test_implicit_inp`、spherical-cap checker、算法文档、接口文档和
|
||||
用户手册;不要在 `examples/` 或 `tools/` 里实现替代壳后屈曲逻辑。
|
||||
S4 几何非线性开关同样属于生产路径。V5.11 后续目标接口是
|
||||
`SHELL_GEOMETRIC=FINITE_STRAIN`/`LINEAR`;迁移期 `SHELL_GEOMETRIC=YES/NO` 可兼容,
|
||||
但 `GEOMETRIC_SHELL`、`COROTATIONAL_SHELL` 和 `S4_COROTATIONAL` 属于旧
|
||||
corotational 尝试遗留别名,finite-strain S4 完成后必须删除解析、测试、文档和示例入口。
|
||||
修改该语义时必须同步 `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。当前广义特征值入口要求参考几何刚度矩阵 SPD,适合解析基准和小规模工程验收;大规模稀疏屈曲求解仍需后续内部算法扩展,不能通过第三方库或外部求解器绕过当前模块边界。
|
||||
V5.5 线性屈曲相关模块分层如下:`fem_geometric_stiffness` 只生成单元级几何刚度矩阵;`fem_eigensolver` 只负责小规模 dense 特征值算法、模态归一化和残差;`fem_buckling_solver` 只组合屈曲问题入口、几何刚度符号约定和解析 helper;`fem_buckling_column` 负责 Euler 柱专用 `*BUCKLING COLUMN` 读取、梁柱装配、主 `femlite --buckling` 求解和 CSV 输出。当前广义特征值入口要求参考几何刚度矩阵 SPD,适合解析基准和小规模工程验收;完整通用 `*BUCKLING`、静力预载后的壳/实体几何刚度和大规模稀疏屈曲求解仍需后续内部算法扩展,不能通过第三方库或外部求解器绕过当前模块边界。
|
||||
|
||||
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 和算法文档。
|
||||
|
||||
@@ -291,16 +325,26 @@ V4.7 壳稳定和壳塑性维护约定:
|
||||
|
||||
- drilling 稳定系数、S3 剪切折减系数和最小折减比例放在 `fem_control`,公共接口通过 `fem_api` 和 C ABI 追加,不改变旧函数签名。
|
||||
- 壳刚度装配后的稳定性统计也放在 `fem_control`,测试中通过 `test_element_stiffness` 和 `test_c_api` 同时覆盖内部变量和外部接口。
|
||||
- 当前 J2 弯曲塑性使用代表性外纤维应变近似,不是完整厚度方向积分;任何多层 section integration 扩展都必须保留 trial/rollback 的状态一致性。
|
||||
- 当前 J2 弯曲塑性使用代表性外纤维应变近似,不是完整厚度方向 plastic
|
||||
integration。V5.11 已有弹性多层 `*SHELL SECTION, COMPOSITE` 的
|
||||
`fem_shell_section` ABD/H 矩阵路径;后续任何多层塑性扩展都必须保留
|
||||
trial/rollback 的状态一致性,并删除被完整实现取代的临时单层/外纤维近似路径。
|
||||
- 壳 benchmark smoke 优先放在 `example_smoke` CTest 分组,长跑或网格收敛结果不提交全量 CSV/VTK。
|
||||
- V5.11 S4 corotational 基础路径必须保持 opt-in:默认线性 S3/S4/S6/S8 行为不变;
|
||||
`SHELL_GEOMETRIC=YES` 或方法 4 才进入 S4 reference/current frame 路径。该路径当前
|
||||
完成对象性、弹性 corotational algorithmic tangent、prestress-delta 膜几何刚度和
|
||||
shell `DLOAD P` follower-pressure tangent。algorithmic tangent 是生产内力的残差导数
|
||||
近似,允许非对称;不要为了旧对称性假设强行平均矩阵。非 `ELASTIC` 壳材料
|
||||
必须在 S4 corotational 刚度装配时显式报材料错误,不能静默回退旧工程切线。
|
||||
塑性/多层壳切线、弯曲/剪切初应力项、全部 follower-load 类型和 Riks/arc-length
|
||||
增广方程未完成前,不能在文档或 checker 中标为完整 postbuckling PASS。
|
||||
- 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、
|
||||
输入别名、文档入口和只服务旧路线的测试入口,不能留下“备用”接口。
|
||||
`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。
|
||||
|
||||
V5.4 Mohr-Coulomb 维护约定:
|
||||
|
||||
@@ -394,12 +438,15 @@ ctest --test-dir build-win-gcc-16 -R "^(contact|contact_omp1|contact_omp4|restar
|
||||
- 性能测试:`perf_p1`、`perf_contact_pair`、`perf_contact_pair_omp_consistency`。
|
||||
- Benchmark 编排工具:`tools/benchmarks/strength_reduction_benchmark.f90` 链接
|
||||
`femlite_core`,用于 `examples/strengthReduction` 生成 PDF 8 工况
|
||||
path/cases、summary、塑性区和位移探针;这类测试/benchmark orchestration 不应放入
|
||||
`src/`。
|
||||
- Benchmark 编排工具:`tools/benchmarks/euler_column_buckling_benchmark.f90`
|
||||
链接 `femlite_core`,用于 `examples/euler_column_buckling` 装配 Euler 柱
|
||||
梁弯曲刚度和生产几何刚度,调用 `buckling_dense_solve`,并输出屈曲
|
||||
summary 与一阶模态 CSV;这类工具同样保留在 `tools/benchmarks`。
|
||||
path/cases、summary、塑性区和位移探针;CLI 解析和 nonlinear-chain 选项维护在
|
||||
`tools/benchmarks/strength_reduction_benchmark_cli.f90`,CSV/summary 命名与报告
|
||||
格式维护在 `tools/benchmarks/strength_reduction_benchmark_report.f90`。这类
|
||||
测试/benchmark orchestration 不应放入 `src/`。
|
||||
- Benchmark 兼容包装:`tools/benchmarks/euler_column_buckling_benchmark.f90`
|
||||
链接 `femlite_core`,用于 `examples/euler_column_buckling` 调用生产
|
||||
`buckling_column_run_file`,并打印一阶临界载荷、残差和相对误差。Euler 柱
|
||||
屈曲算法只维护在 `src/solver/fem_buckling_column.f90`,不得在包装工具中保留
|
||||
第二套简化装配或特征值求解逻辑。
|
||||
- Benchmark 编排工具:`tools/benchmarks/corrugated_shell_buckling_benchmark.f90`
|
||||
链接 `femlite_core`,用于 `examples/buckling_corrugated_shell` 构造紧凑
|
||||
周期波纹壳屈曲矩阵,调用 `buckling_dense_solve`、`fem_cyclic_symmetry`
|
||||
|
||||
Reference in New Issue
Block a user