65 lines
3.0 KiB
Markdown
65 lines
3.0 KiB
Markdown
# 02 软件架构设计
|
||
|
||
文档状态:0.6.5 版整理稿
|
||
|
||
## 1. 架构概览
|
||
|
||
FemLite 采用 Fortran 95 风格的过程式架构。核心数据集中存放在数据库模块中,求解器、单元、材料、边界、接触、输出和接口层围绕数据库协作。
|
||
|
||
```text
|
||
输入层 -> 数据库 -> 单元/材料/边界/接触 -> 求解器 -> 输出/API
|
||
```
|
||
|
||
## 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、VTU/PVD、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、VTU/PVD、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`。
|
||
- 新功能必须同步更新需求、算法、接口、测试、用户手册和开发者手册中的相关章节。
|