This commit is contained in:
@@ -1,559 +1,64 @@
|
||||
# FEM Software Architecture Design
|
||||
# 02 软件架构设计
|
||||
|
||||
文档状态:架构基线草稿
|
||||
文档状态:0.6.3 版整理稿
|
||||
|
||||
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
|
||||
## 1. 架构概览
|
||||
|
||||
## 1. 文档目的
|
||||
|
||||
本文档描述 FEM 软件的整体架构、交付形态、目录组织、模块划分、数据流、控制流、外部接口、错误处理和扩展策略。
|
||||
|
||||
本文档中的架构决策用于约束后续详细设计、算法设计、接口设计和代码实现。
|
||||
|
||||
## 2. 架构目标
|
||||
|
||||
软件架构应满足:
|
||||
|
||||
- 核心库与命令行程序分离
|
||||
- 第一版优先支持显式瞬态动力学
|
||||
- 第一版支持独立 FEM 程序运行和外部 SPH 驱动两种模式
|
||||
- 第一版支持 Abaqus inp 输入
|
||||
- 第一版支持 SPH-FEM 边界力交换接口
|
||||
- Fortran95 过程式模块组织,不采用面向对象类型绑定
|
||||
- 集中式数据库管理网格、材料、状态变量和全局向量
|
||||
- 单元、材料、求解器、耦合和输出模块保持职责分离
|
||||
- 第二版形成壳单元扩展、CSR、隐式线弹性、基础接触、VTK、restart 和外部接口的最小可用框架
|
||||
- 第三版正式支持线性静力、非线性静力、壳单元静力、隐式非线性动力学和通用接触
|
||||
|
||||
## 3. 交付形态
|
||||
|
||||
第一版交付:
|
||||
|
||||
- 静态库:libFemLite
|
||||
- 命令行程序:femlite
|
||||
- 测试程序:单元测试、模块测试和集成测试可执行文件
|
||||
- 示例算例:examples 目录中的 Abaqus inp 输入文件和参考输出
|
||||
- 文档:docs 目录中的需求、架构、详细设计、算法、接口和测试文档
|
||||
|
||||
第二版或后续版本可扩展:
|
||||
|
||||
- 动态库
|
||||
- C/C++/Python 包装层
|
||||
- 更完整后处理工具链
|
||||
- 内部稀疏求解器扩展层
|
||||
|
||||
第三版交付应补充:
|
||||
|
||||
- 静力学命令行分析模式
|
||||
- 静力学核心库接口
|
||||
- 壳静力和非线性静力验证算例
|
||||
- 静力学收敛历史、反力和 VTK/CSV 输出
|
||||
|
||||
## 4. 目录结构
|
||||
|
||||
建议目录结构:
|
||||
FemLite 采用 Fortran 95 风格的过程式架构。核心数据集中存放在数据库模块中,求解器、单元、材料、边界、接触、输出和接口层围绕数据库协作。
|
||||
|
||||
```text
|
||||
src/base 基础类型、常量、日志、错误码、控制参数
|
||||
src/input Abaqus inp 读取与输入数据预处理
|
||||
src/mesh 网格、集合、facet、自由度编号
|
||||
src/material 材料模型与状态变量更新
|
||||
src/element 实体单元、壳单元、形函数、积分规则
|
||||
src/solver 显式求解器、静力求解器、隐式动力求解器、稀疏矩阵
|
||||
src/boundary 边界条件、载荷、约束、接触
|
||||
src/particle 离散球颗粒状态、搜索、接触、step 和 facet/FEM 映射
|
||||
src/coupling FEM 外部耦合接口和 SPH 力映射
|
||||
src/output 日志、CSV、VTK 预留、restart 预留
|
||||
src/app femlite 命令行程序
|
||||
tests 测试程序与测试数据
|
||||
examples 示例 inp 文件与参考结果
|
||||
docs 工程文档
|
||||
输入层 -> 数据库 -> 单元/材料/边界/接触 -> 求解器 -> 输出/API
|
||||
```
|
||||
|
||||
目录职责边界:
|
||||
|
||||
- input 层只负责解析输入,不直接执行求解。
|
||||
- material 层只负责本构更新,不直接访问全局网格。
|
||||
- element 层负责单元级质量、内力、应力更新和稳定步长估计。
|
||||
- solver 层负责时间推进和全局向量更新,不直接依赖 SPH 实现。
|
||||
- coupling 层只负责数据交换和力映射,FEM 核心不依赖 SPH 程序。
|
||||
- output 层统一处理日志、历史量和结果输出。
|
||||
|
||||
## 5. 总体分层
|
||||
|
||||
软件采用以下分层:
|
||||
|
||||
```text
|
||||
Application Layer
|
||||
femlite command line program
|
||||
test programs
|
||||
examples
|
||||
|
||||
Public API Layer
|
||||
fem_initialize
|
||||
fem_read_inp
|
||||
fem_build_model
|
||||
fem_advance_explicit
|
||||
fem_get_boundary_facets
|
||||
fem_apply_sph_forces
|
||||
fem_finalize
|
||||
|
||||
Core FEM Layer
|
||||
mesh database
|
||||
dof numbering
|
||||
material update
|
||||
element routines
|
||||
boundary and load routines
|
||||
coupling force mapping
|
||||
|
||||
Solver Layer
|
||||
explicit central difference solver
|
||||
linear static solver
|
||||
nonlinear static solver
|
||||
implicit Newmark solver
|
||||
CSR matrix layer
|
||||
dense eigensolver and small-scale buckling support
|
||||
|
||||
Input/Output Layer
|
||||
Abaqus inp reader
|
||||
log writer
|
||||
CSV writer
|
||||
VTK placeholder
|
||||
restart placeholder
|
||||
```
|
||||
|
||||
## 6. 数据库架构
|
||||
|
||||
软件采用集中式 fem_database 模块。
|
||||
|
||||
架构约定:
|
||||
|
||||
- 网格、材料、截面、集合、自由度、状态变量和全局向量由 fem_database 统一保存。
|
||||
- 允许模块共享 fem_database 中的全局 allocatable 数组。
|
||||
- 各模块通过明确的初始化、查询和更新子程序访问数据库。
|
||||
- 不使用面向对象类型绑定。
|
||||
- 材料例程不直接访问全局数据库。
|
||||
- 单元例程可读取单元连接、坐标、材料编号和状态变量索引。
|
||||
- 求解器例程负责全局向量清零、累计、边界条件施加和时间推进。
|
||||
|
||||
核心数据库类别:
|
||||
|
||||
- 节点坐标
|
||||
- 单元连接关系
|
||||
- 单元类型
|
||||
- 节点集和单元集
|
||||
- 材料参数
|
||||
- 截面参数
|
||||
- 自由度编号
|
||||
- 位移、速度、加速度
|
||||
- 集中质量
|
||||
- 内力、外力、接触力、SPH 力
|
||||
- 高斯点应力、应变、塑性应变和历史变量
|
||||
- 单元删除标志
|
||||
|
||||
## 7. 自由度架构
|
||||
|
||||
每个节点预留 6 个自由度:
|
||||
|
||||
```text
|
||||
1 UX
|
||||
2 UY
|
||||
3 UZ
|
||||
4 RX
|
||||
5 RY
|
||||
6 RZ
|
||||
```
|
||||
|
||||
自由度规则:
|
||||
|
||||
- 实体单元只激活 UX、UY、UZ。
|
||||
- 壳单元激活 UX、UY、UZ、RX、RY、RZ。
|
||||
- 未激活自由度编号为 0。
|
||||
- 全局自由度编号由 mesh/dof 模块统一生成。
|
||||
- Dirichlet 边界、节点力、输出和 SPH 接口均使用同一自由度约定。
|
||||
- 后续 MPC、接触和壳-实体连接沿用同一自由度体系。
|
||||
|
||||
## 8. 大变形架构
|
||||
|
||||
第一版默认采用 Updated Lagrangian 架构。
|
||||
|
||||
基本约定:
|
||||
|
||||
- 当前构形用于计算单元几何、Jacobian、体积、面积和法向。
|
||||
- 单元内力基于当前构形上的应力状态累计。
|
||||
- 小应变 J2 和大应变 J2 通过材料更新选项切换。
|
||||
- 大变形相关运动学量由单元模块计算并传递给材料模块。
|
||||
- 材料模块只接收材料更新所需的局部变量和旧状态,返回新应力、状态变量和可选切线。
|
||||
- 壳单元第一版可采用有限转动能力受限的 S4 实现,第二版再扩展更完整壳大变形框架。
|
||||
|
||||
## 9. 材料与状态变量架构
|
||||
|
||||
状态变量存储按 element + integration point 组织。
|
||||
|
||||
职责划分:
|
||||
|
||||
- fem_database 保存所有高斯点状态变量。
|
||||
- element 模块负责从数据库取出旧状态并调用材料模块。
|
||||
- material 模块负责应力更新和状态变量更新。
|
||||
- element 模块负责把新状态写回数据库。
|
||||
- solver 模块负责控制何时提交或回滚状态变量。
|
||||
|
||||
材料例程接口原则:
|
||||
|
||||
- 输入应包含材料编号、应变增量或变形度量、应变率、温度、时间步长和旧状态。
|
||||
- 输出应包含新应力、新状态变量、失效标志和可选算法切线。
|
||||
- 材料例程不得依赖全局节点、单元或求解器状态。
|
||||
|
||||
第五版材料层增加 Mohr-Coulomb 专线。`fem_material_mohr_coulomb` 负责材料点
|
||||
返回映射、张拉截断、分支号和工程算法切线;`fem_material_mc_driver` 只做
|
||||
材料点路径执行和诊断汇总;`fem_material_mc_envelope` 只做包络 margin 和
|
||||
safety ratio 计算。结构级强度折减通过 `fem_strength_reduction_driver`
|
||||
接收求解器 trial 指标并维护 bracket,不反向污染材料点更新。
|
||||
|
||||
## 10. 单元调度架构
|
||||
|
||||
Fortran95 下直接使用 Abaqus 单元类型字符串作为内部主标识。
|
||||
|
||||
支持的单元类型字符串:
|
||||
|
||||
```text
|
||||
C3D4
|
||||
C3D8
|
||||
S4
|
||||
C3D10
|
||||
C3D20
|
||||
S3
|
||||
S6
|
||||
S8
|
||||
```
|
||||
|
||||
调度原则:
|
||||
|
||||
- elem_type 使用固定长度字符串保存,例如 character(len=16)。
|
||||
- INP 读取时将单元类型转换为大写并去除多余空格。
|
||||
- element_driver 根据 elem_type 字符串调用具体单元例程。
|
||||
- 具体单元例程只处理本单元的质量、内力、应力更新、稳定时间步和面载荷。
|
||||
- 新增单元时扩展 elem_type 字符串识别和对应单元例程。
|
||||
- 第一版必须实现 C3D4、C3D8、S4。
|
||||
- 第二版应实现 C3D10、C3D20、S3、S6、S8。
|
||||
- 后续如需性能优化,可增加内部缓存编码,但 Abaqus 字符串仍作为数据库主字段。
|
||||
|
||||
## 11. 核心数据流
|
||||
|
||||
独立程序模式数据流:
|
||||
|
||||
```text
|
||||
Abaqus inp
|
||||
-> inp reader
|
||||
-> mesh/material/section/boundary database
|
||||
-> dof numbering
|
||||
-> facet construction
|
||||
-> mass initialization
|
||||
-> explicit time integration loop
|
||||
-> element stress/internal force update
|
||||
-> boundary and load update
|
||||
-> output
|
||||
```
|
||||
|
||||
外部 SPH 驱动模式数据流:
|
||||
|
||||
```text
|
||||
external driver
|
||||
-> fem_initialize
|
||||
-> fem_read_inp / fem_build_model
|
||||
-> fem_get_boundary_facets
|
||||
-> external SPH force calculation
|
||||
-> fem_apply_sph_forces
|
||||
-> fem_advance_explicit(dt)
|
||||
-> fem_get_boundary_facets
|
||||
-> repeat
|
||||
```
|
||||
|
||||
## 12. 求解控制流
|
||||
|
||||
第一版显式中心差分控制流:
|
||||
|
||||
```text
|
||||
initialize model
|
||||
compute lumped mass
|
||||
initialize displacement, velocity and acceleration
|
||||
for each time step:
|
||||
clear force vectors
|
||||
apply prescribed loads
|
||||
receive SPH forces when running in coupling mode
|
||||
compute element stress and internal force
|
||||
apply boundary conditions
|
||||
compute acceleration from lumped mass
|
||||
update velocity
|
||||
update displacement
|
||||
update current configuration
|
||||
delete failed elements when required
|
||||
write output when required
|
||||
end for
|
||||
```
|
||||
|
||||
第二版隐式线弹性控制流:
|
||||
|
||||
```text
|
||||
initialize model
|
||||
build CSR sparsity
|
||||
assemble linear elastic stiffness
|
||||
assemble external load vector
|
||||
apply Dirichlet and constraint equations
|
||||
solve K u = f
|
||||
recover strain and stress
|
||||
write output
|
||||
```
|
||||
|
||||
第四版起,静力和隐式路径不直接绑定单一线性求解器,而是经由
|
||||
`fem_linear_solver_cg.f90` 中的分发层求解 CSR 系统。分发层读取
|
||||
`fem_control` 中的 method/preconditioner 设置,当前内部支持 CG、
|
||||
BiCGSTAB、GMRES 和 dense pivoting fallback,支持
|
||||
none/Jacobi/Gauss-Seidel/ILU0 预条件,并把最近一次 method、
|
||||
preconditioner、迭代数、残差和状态码写回控制模块供 Fortran API、C ABI
|
||||
和测试查询。分发层不包含外部求解器 adapter;非 CG/BiCGSTAB/GMRES/DENSE 的
|
||||
method 值在配置阶段返回错误,并保持当前设置不变。
|
||||
|
||||
第五版起,solver 层增加小规模内部特征值和线性屈曲支撑。`fem_eigensolver`
|
||||
负责 dense 对称 Jacobi 和 SPD 广义特征值求解,`fem_buckling_solver` 负责
|
||||
屈曲问题入口、几何刚度符号约定、Euler 解析临界载荷和模态 helper,
|
||||
`fem_geometric_stiffness` 生成单元级几何刚度。该路径用于解析 benchmark 和
|
||||
小规模工程验收,不接入第三方特征值库或外部求解器进程。
|
||||
|
||||
第三版非线性静力控制流:
|
||||
|
||||
```text
|
||||
initialize model
|
||||
build CSR sparsity
|
||||
for each increment:
|
||||
apply load factor and prescribed displacement increment
|
||||
Newton iteration:
|
||||
assemble internal force and external force
|
||||
assemble residual R = F_ext - F_int
|
||||
assemble tangent matrix
|
||||
apply boundary and constraint equations
|
||||
solve correction
|
||||
optionally perform line search
|
||||
update trial state
|
||||
check convergence
|
||||
if failed and allowed, restore state and cut back increment
|
||||
commit state
|
||||
write output
|
||||
end for
|
||||
```
|
||||
|
||||
第三版隐式 Newmark 动力学控制流:
|
||||
|
||||
```text
|
||||
initialize model
|
||||
build CSR sparsity
|
||||
for each time increment:
|
||||
Newmark predict displacement and velocity
|
||||
Newton iteration:
|
||||
assemble effective residual
|
||||
assemble effective tangent K_eff
|
||||
apply boundary, MPC and contact equations
|
||||
solve correction
|
||||
optionally perform line search
|
||||
update trial displacement, velocity and acceleration
|
||||
check convergence
|
||||
if failed and allowed, restore kinematics/state and cut back step
|
||||
commit state
|
||||
write output
|
||||
end for
|
||||
```
|
||||
|
||||
求解控制权:
|
||||
|
||||
- 独立程序模式由 femlite 控制时间循环。
|
||||
- 外部 SPH 驱动模式由外部驱动器控制时间步长和调用顺序。
|
||||
- SPH 耦合时,solver 只接收 fsph 全局力向量。
|
||||
- solver 不直接调用 SPH 程序或依赖 SPH 数据结构。
|
||||
|
||||
## 13. SPH-FEM 耦合架构
|
||||
|
||||
coupling 层职责:
|
||||
|
||||
- 构造和维护 FEM 边界 facet 列表。
|
||||
- 导出 facet 坐标、速度、法向和面积。
|
||||
- 接收压力、剪切力或等效节点力。
|
||||
- 将外部耦合载荷映射为 FEM 全局 fsph 向量。
|
||||
- 检查 coupling 接口参数合法性。
|
||||
|
||||
边界 facet 来源:
|
||||
|
||||
- 实体单元外表面
|
||||
- 壳单元表面
|
||||
- 指定 elset
|
||||
|
||||
耦合约束:
|
||||
|
||||
- FEM 核心不依赖具体 SPH 程序。
|
||||
- coupling 层不执行 SPH 粒子计算。
|
||||
- element 层不直接依赖 SPH。
|
||||
- solver 层只使用已经映射好的 fsph。
|
||||
- 每个时间步可执行一次双向交换。
|
||||
- 时间步由 SPH 或外部耦合驱动器控制。
|
||||
|
||||
V5.8 颗粒层职责:
|
||||
|
||||
- particle 层保存内置离散球颗粒状态,不依赖外部颗粒求解器。
|
||||
- particle step 负责颗粒显式推进、颗粒-颗粒/颗粒-墙接触和诊断输出。
|
||||
- particle facet coupling 负责把颗粒-facet 接触力分配到 facet 节点,并提供力平衡残差。
|
||||
- coupling 层可收集和应用颗粒-facet 节点载荷,但不负责颗粒时间积分。
|
||||
- 颗粒质量、动量、动能、耗散能和最大重叠通过 Fortran 诊断接口查询。
|
||||
- 动态颗粒柔性容器验收由 `tools/benchmarks/dynamic_grain_container_benchmark.f90` 编排:读取 `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` 的颗粒和压力-free 容器输入,调用生产 particle/FEM coupling 路径,将节点载荷写入 `fsph`,并输出 history/summary CSV 供 checker 验证。
|
||||
|
||||
## 14. 输出架构
|
||||
|
||||
第一版输出:
|
||||
|
||||
- 日志文件:运行信息、warning、error、关键统计量
|
||||
- CSV 历史量:时间、能量、最大位移、最大速度、外力功等
|
||||
- CSV 场变量:节点位移、速度、加速度,单元应力、应变、塑性应变
|
||||
|
||||
第二版输出:
|
||||
|
||||
- VTK 结果文件
|
||||
- restart 文件
|
||||
|
||||
第三版输出:
|
||||
|
||||
- 静力学收敛历史文件
|
||||
- 节点反力输出
|
||||
- 接触状态、接触力和接触功输出
|
||||
- 隐式增量残差和迭代次数输出
|
||||
|
||||
第三版当前接触模块保留刚性平面接触,并新增基于边界 facet 的面-面 contact pair force/tangent 路径。0.3.1 已补充投影裁剪面积积分、多 master 面积上限修正、Coulomb 摩擦、均匀空间网格候选搜索、facet 空间 broad-phase 精筛,以及接触状态/接触功 CSV 与 API 输出。0.3.2 已补充投影交叠域 mortar 形函数积分、接触对级粘滑历史变量、stick/slip/累计滑移输出,以及可选 OpenMP 的 master facet BVH 宽相搜索。0.3.3 已补充 `*SURFACE, TYPE=ELEMENT` 输入子集、同名 surface `OP=ADD/NEW`、face label 筛选、壳 `SPOS`/`SNEG` 侧向语义和数据行式 `*CONTACT PAIR` 子集,并将接触状态、目标筛选、几何积分、搜索、摩擦、力、切线和输出拆分为独立模块。
|
||||
|
||||
输出控制:
|
||||
|
||||
- 输出频率由 fem_control 统一管理。
|
||||
- 输出模块不参与求解状态更新。
|
||||
- 第一版不建立复杂后处理数据库。
|
||||
|
||||
## 15. 错误处理与日志
|
||||
|
||||
错误处理原则:
|
||||
|
||||
- 所有核心接口返回 ierr。
|
||||
- 日志模块记录 warning、error 和 fatal 信息。
|
||||
- 不支持的 Abaqus keyword 作为 warning 后跳过。
|
||||
- 关键数据缺失、非法材料参数、退化单元等错误应终止当前分析。
|
||||
- 外部接口不得通过未捕获异常或直接停止进程隐藏错误来源。
|
||||
|
||||
错误码分组:
|
||||
|
||||
```text
|
||||
0 success
|
||||
1000 input errors
|
||||
2000 mesh and dof errors
|
||||
3000 material and state errors
|
||||
4000 solver errors
|
||||
5000 coupling errors
|
||||
6000 output errors
|
||||
9000 internal errors
|
||||
```
|
||||
|
||||
日志至少记录:
|
||||
|
||||
- 输入文件名
|
||||
- 识别和跳过的 keyword
|
||||
- 节点数、单元数、自由度数
|
||||
- 材料和截面数量
|
||||
- 时间步设置
|
||||
- 输出设置
|
||||
- warning 和 error 位置
|
||||
- 分析开始和结束状态
|
||||
|
||||
## 16. 扩展策略
|
||||
|
||||
添加新单元:
|
||||
|
||||
- 增加 elem_type 字符串识别
|
||||
- 增加形函数和积分规则
|
||||
- 增加质量、内力、应力更新和面载荷例程
|
||||
- 增加单元测试和 patch test
|
||||
|
||||
添加新材料:
|
||||
|
||||
- 增加材料类型编码
|
||||
- 增加材料参数解析
|
||||
- 增加材料更新例程
|
||||
- 增加单轴或多轴材料测试
|
||||
|
||||
添加新边界条件:
|
||||
|
||||
- 增加输入解析
|
||||
- 增加数据库存储
|
||||
- 增加载荷或约束施加例程
|
||||
- 增加验证算例
|
||||
|
||||
添加新输入 keyword:
|
||||
|
||||
- 增加 keyword 识别
|
||||
- 增加参数解析
|
||||
- 增加错误诊断
|
||||
- 增加输入回归测试
|
||||
|
||||
内部线性求解器扩展:
|
||||
|
||||
- 通过 CSR 层提供矩阵、向量、残差和矩阵分类诊断。
|
||||
- 隐式求解器不得绑定第三方库或外部求解器进程。
|
||||
- 线性求解能力应优先扩展内部 iterative/diagnostics 子层。
|
||||
- 新增 method 或 preconditioner 必须保持默认构建无第三方依赖,并覆盖配置失败不改变既有设置的回归测试。
|
||||
|
||||
## 17. 构建与部署架构
|
||||
|
||||
构建系统:
|
||||
|
||||
- 使用 CMake。
|
||||
- 默认编译器为 gfortran。
|
||||
- 兼容 Intel Fortran。
|
||||
- 支持 Windows 和 Linux。
|
||||
|
||||
构建目标:
|
||||
|
||||
- FemLite 静态库
|
||||
- femlite 命令行程序
|
||||
- 单元测试程序
|
||||
- 模块测试程序
|
||||
- 集成测试程序
|
||||
|
||||
第一版不要求:
|
||||
|
||||
- OpenMP
|
||||
- MPI
|
||||
- 动态库
|
||||
- 第三方求解器强依赖
|
||||
|
||||
## 18. 0.6.0 Nonlinear Lifecycle Architecture Addendum
|
||||
|
||||
0.6.0 adds `src/solver/fem_nonlinear_lifecycle.f90` as a small shared
|
||||
diagnostic state machine. The module is intentionally additive: it records
|
||||
solver lifecycle state and owner rollback audit results, but it does not own
|
||||
Newton, Newmark, Riks, contact, cohesive or particle algorithms.
|
||||
|
||||
Lifecycle levels:
|
||||
|
||||
```text
|
||||
analysis step
|
||||
increment
|
||||
trial state
|
||||
iteration
|
||||
accept / reject
|
||||
commit / rollback
|
||||
```
|
||||
|
||||
Covered event names are `increment-begin`, `trial-begin`,
|
||||
`iteration-begin`, `iteration-result`, `accept`, `reject`, `cutback`,
|
||||
`commit` and `rollback`.
|
||||
|
||||
Audit status names are `begin-trial`, `rollback-requested`, `rollback-ok`,
|
||||
`rollback-failed` and `commit-ok`.
|
||||
|
||||
Owner adapters currently cover material/element state, contact multiplier
|
||||
state, compact cohesive state and particle step audit. Static nonlinear,
|
||||
nonlinear Newmark and Riks/arc paths record lifecycle events for the covered
|
||||
subset. Larger algorithm rewrites remain outside the 0.6.0 architecture
|
||||
boundary.
|
||||
## 2. 主要目录
|
||||
|
||||
| 目录 | 职责 |
|
||||
|---|---|
|
||||
| `src/base` | 全局精度、错误、控制参数、公共 API、诊断接口 |
|
||||
| `src/input` | Abaqus INP 子集读取与控制块解析 |
|
||||
| `src/mesh` | 节点、单元、集合、材料、截面和 DOF 数据库 |
|
||||
| `src/element` | 单元拓扑、形函数、积分、质量、刚度、内力和状态 |
|
||||
| `src/material` | 材料模型、Mohr-Coulomb、强度折减和材料点驱动 |
|
||||
| `src/boundary` | 约束、接触、mortar/AL、cohesive、滚压/刚体工具 |
|
||||
| `src/solver` | 静力、隐式、非线性、线性求解器、屈曲和模态工具 |
|
||||
| `src/output` | CSV、VTK、restart 和模态输出 |
|
||||
| `src/interface` | Fortran-C bridge 和 C ABI |
|
||||
| `tests` | 单元、模块、接口、CLI、benchmark 和性能测试 |
|
||||
| `tools` | benchmark 编排、测试辅助和脚本 |
|
||||
| `examples` | 可运行示例和 benchmark 输入 |
|
||||
|
||||
## 3. 数据流
|
||||
|
||||
1. `fem_initialize` 初始化控制参数、日志、诊断和数据库状态。
|
||||
2. `fem_read_inp` 读取输入文件并填充模型数据库。
|
||||
3. `fem_build_model` 校验模型、建立边界 facet 和必要的派生数据。
|
||||
4. 求解器根据命令行或 API 调用执行显式、静力、隐式或专用 benchmark 路径。
|
||||
5. 输出层写入 CSV、VTK、restart 或诊断文件。
|
||||
6. API 层提供模型状态、节点、元素、接触和诊断查询。
|
||||
7. `fem_finalize` 释放数据库、关闭日志并重置生命周期状态。
|
||||
|
||||
## 4. 单元基础设施
|
||||
|
||||
0.6.3 后单元基础设施分层如下:
|
||||
|
||||
- `fem_element_topology`:单元名称、种类、节点数、边/面拓扑和积分点计数。
|
||||
- `fem_quadrature`:积分规则描述符、Gauss/Gauss-Lobatto/Newton-Cotes/simplex 规则。
|
||||
- `fem_shape_functions`:各单元形函数和自然坐标导数。
|
||||
- `fem_element_stiffness`、`fem_element_internal`、`fem_element_mass`:单元计算路径。
|
||||
- `fem_api_state_access`:元素查询 API,不直接暴露内部数组。
|
||||
|
||||
## 5. 接口层
|
||||
|
||||
公开接口分三层:
|
||||
|
||||
- Fortran API:`src/base/fem_api.f90` 及其子模块。
|
||||
- C ABI:`include/femlite_c_api.h` 和 `src/interface/fem_c_api.c`。
|
||||
- 命令行程序:`src/app/fem_program.f90`。
|
||||
|
||||
C ABI 只做薄包装,不改变 Fortran API 的物理含义。多维数组以 Fortran 顺序展平成 C 缓冲区。
|
||||
|
||||
## 6. 版本治理
|
||||
|
||||
- 版本号由 `CMakeLists.txt` 和 `src/base/fem_precision.f90` 同步维护。
|
||||
- 版本计划、验收报告和 benchmark 矩阵统一合并到 `09_release_history.md`、`10_development_roadmap.md` 和 `11_benchmark_matrix.md`。
|
||||
- 新功能必须同步更新需求、算法、接口、测试、用户手册和开发者手册中的相关章节。
|
||||
|
||||
Reference in New Issue
Block a user