From 1cc1ce24a82884275f1667ba4de2c492ac56922d Mon Sep 17 00:00:00 2001 From: shenw Date: Mon, 22 Jun 2026 12:43:41 +0800 Subject: [PATCH] Add initial FEM documentation skeletons --- docs/01_requirements_specification.md | 139 +++++++++++++ docs/02_software_architecture_design.md | 130 ++++++++++++ docs/03_detailed_design.md | 208 +++++++++++++++++++ docs/04_mathematical_model_and_algorithms.md | 160 ++++++++++++++ docs/05_interface_control_document.md | 144 +++++++++++++ docs/06_test_and_verification_plan.md | 134 ++++++++++++ 6 files changed, 915 insertions(+) create mode 100644 docs/01_requirements_specification.md create mode 100644 docs/02_software_architecture_design.md create mode 100644 docs/03_detailed_design.md create mode 100644 docs/04_mathematical_model_and_algorithms.md create mode 100644 docs/05_interface_control_document.md create mode 100644 docs/06_test_and_verification_plan.md diff --git a/docs/01_requirements_specification.md b/docs/01_requirements_specification.md new file mode 100644 index 0000000..a9c2c0a --- /dev/null +++ b/docs/01_requirements_specification.md @@ -0,0 +1,139 @@ +# FEM Software Requirements Specification + +文档状态:草稿 + +适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序 + +## 1. 文档目的 + +本文档用于定义 FEM 软件模块的功能需求、非功能需求、输入输出要求、约束条件和第一阶段开发范围。 + +待补充: + +- 需求来源与适用项目 +- 需求优先级规则 +- 验收准则 + +## 2. 项目目标 + +本软件面向船舶接触爆炸问题中的船体结构响应分析,支持三维线弹性、弹塑性和瞬态动力学计算。 + +目标包括: + +- 提供可被外部程序调用的 Fortran95 FEM 核心库 +- 提供基于 Abaqus inp 文件的小型 FEM 分析程序 +- 暴露与 SPH 方法进行边界耦合的接口 +- 支持后续扩展接触、壳单元、实体单元和非线性求解能力 + +## 3. 应用场景 + +待补充: + +- 船体局部板架受爆炸冲击 +- 船体结构与 SPH 流体/爆炸载荷耦合 +- 壳-实体混合模型瞬态响应 +- 弹塑性变形与接触冲击分析 + +## 4. 功能需求 + +### 4.1 物理模型 + +待补充: + +- 线弹性 +- 弹塑性 +- 瞬态动力学 +- 非线性增量迭代 + +### 4.2 空间维度 + +软件应支持三维结构有限元分析。 + +### 4.3 单元类型 + +待补充: + +- 三角形壳单元 +- 四边形壳单元 +- 四面体实体单元 +- 六面体实体单元 +- 线性单元 +- 二次单元 + +### 4.4 材料模型 + +待补充: + +- 各向同性线弹性材料 +- 各向同性 J2 弹塑性材料 +- 密度、弹性参数、屈服参数和硬化参数定义 + +### 4.5 边界条件与载荷 + +待补充: + +- Dirichlet 边界 +- Neumann 边界 +- Robin 边界 +- 接触边界 +- 约束方程 +- SPH 边界耦合载荷 + +### 4.6 求解类型 + +待补充: + +- 默认显式瞬态动力学 +- 可选隐式瞬态动力学 +- 非线性增量迭代 + +### 4.7 输入输出 + +待补充: + +- Abaqus inp 输入子集 +- 日志输出 +- 结果输出 +- 重启动文件 +- 错误诊断信息 + +## 5. 非功能需求 + +待补充: + +- Fortran95 兼容性 +- Windows/Linux 平台 +- 编译器兼容性 +- 计算规模目标 +- 内存使用目标 +- 数值稳定性要求 +- 鲁棒性要求 + +## 6. 约束与假设 + +待补充: + +- 非面向对象 Fortran95 编程 +- 第一阶段不追求完整 Abaqus 兼容 +- 默认采用一致单位制,由用户输入保证 +- 第一阶段优先支持显式动力学 + +## 7. 开发阶段划分 + +待补充: + +- 原型阶段 +- 核心算法阶段 +- INP 驱动程序阶段 +- SPH 耦合阶段 +- 验证与发布阶段 + +## 8. 验收标准 + +待补充: + +- 支持的输入样例 +- 必须通过的基准算例 +- 接口调用测试 +- 回归测试要求 + diff --git a/docs/02_software_architecture_design.md b/docs/02_software_architecture_design.md new file mode 100644 index 0000000..0f62779 --- /dev/null +++ b/docs/02_software_architecture_design.md @@ -0,0 +1,130 @@ +# FEM Software Architecture Design + +文档状态:草稿 + +适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序 + +## 1. 文档目的 + +本文档描述 FEM 软件的整体架构、模块划分、数据流、控制流、外部接口和扩展策略。 + +## 2. 架构目标 + +待补充: + +- 核心库与小型主程序分离 +- 显式动力学优先 +- 保留隐式非线性扩展路径 +- 支持 Abaqus inp 输入 +- 支持 SPH-FEM 边界耦合 +- 采用 Fortran95 过程式模块组织 + +## 3. 总体分层 + +建议分层: + +- 输入层:Abaqus inp 读取与模型构造 +- 核心 FEM 层:网格、材料、单元、边界、接触、耦合 +- 求解层:显式动力学、隐式非线性、稀疏矩阵与外部求解器接口 +- 输出层:日志、结果文件、诊断信息、重启动数据 + +待讨论: + +- 是否需要独立 preprocessing 层 +- 是否需要独立 restart 层 +- 输出格式优先级 + +## 4. 模块划分 + +初步模块: + +- fem_precision.f90 +- fem_control.f90 +- fem_database.f90 +- fem_inp_reader.f90 +- fem_shape_solid.f90 +- fem_shape_shell.f90 +- fem_quadrature.f90 +- fem_material_iso.f90 +- fem_element_solid.f90 +- fem_element_shell.f90 +- fem_assembly.f90 +- fem_boundary.f90 +- fem_constraint.f90 +- fem_contact.f90 +- fem_sph_coupling.f90 +- fem_solver_explicit.f90 +- fem_solver_implicit.f90 +- fem_sparse_csr.f90 +- fem_program.f90 + +待补充: + +- 每个模块的职责边界 +- 模块依赖关系 +- 禁止出现的循环依赖 + +## 5. 核心数据流 + +待补充: + +```text +Abaqus inp + -> inp reader + -> mesh/material/section/boundary database + -> dof numbering + -> mass initialization + -> time integration loop + -> element stress/internal force update + -> boundary/contact/SPH force update + -> result output +``` + +## 6. 求解控制流 + +待补充: + +- 显式中心差分控制流 +- 隐式 Newmark + Newton 控制流 +- 非线性状态变量更新时机 +- 输出与重启动时机 + +## 7. SPH-FEM 耦合架构 + +待补充: + +- FEM 边界 facet 导出 +- 边界坐标、速度、法向、面积交换 +- SPH 压力/剪切/节点力导入 +- 时间步同步策略 +- 错误码和耦合状态管理 + +## 8. 错误处理与日志 + +待补充: + +- 错误级别 +- 错误码范围 +- 日志格式 +- 不支持 keyword 的处理策略 + +## 9. 扩展策略 + +待补充: + +- 添加新单元 +- 添加新材料 +- 添加新边界条件 +- 添加新输入 keyword +- 接入外部线性求解器 + +## 10. 构建与部署架构 + +待补充: + +- 静态库 +- 动态库 +- 小型命令行程序 +- 测试程序 +- 示例算例目录 + diff --git a/docs/03_detailed_design.md b/docs/03_detailed_design.md new file mode 100644 index 0000000..9326a62 --- /dev/null +++ b/docs/03_detailed_design.md @@ -0,0 +1,208 @@ +# FEM Detailed Design + +文档状态:草稿 + +适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序 + +## 1. 文档目的 + +本文档给出各 Fortran95 模块的数据结构、子程序接口、调用顺序和实现细节,用于直接指导编码。 + +## 2. 设计原则 + +待补充: + +- 过程式 Fortran95 +- 模块化组织 +- 全局数据库集中管理 +- 单元例程局部化 +- 求解器与单元实现解耦 +- 输入解析与计算核心解耦 + +## 3. 全局精度与常量模块 + +模块:fem_precision.f90 + +待补充: + +- real kind 定义 +- integer kind 定义 +- 常用常量 +- 容差参数 + +## 4. 控制参数模块 + +模块:fem_control.f90 + +待补充: + +- 时间步控制 +- 求解器类型 +- 输出控制 +- 非线性迭代控制 +- 接触控制 +- SPH 耦合控制 + +## 5. 数据库模块 + +模块:fem_database.f90 + +待补充: + +- 节点数组 +- 单元数组 +- 自由度编号 +- 材料表 +- 截面表 +- 边界条件表 +- 状态变量表 +- 全局向量 + +初步自由度约定: + +```text +1 UX +2 UY +3 UZ +4 RX +5 RY +6 RZ +``` + +## 6. INP 读取模块 + +模块:fem_inp_reader.f90 + +待补充: + +- 支持 keyword +- 不支持 keyword 处理 +- 集合解析 +- 材料解析 +- step 解析 +- 错误恢复策略 + +## 7. 形函数与积分模块 + +模块: + +- fem_shape_solid.f90 +- fem_shape_shell.f90 +- fem_quadrature.f90 + +待补充: + +- 单元自然坐标 +- 形函数接口 +- 导数接口 +- Jacobian 计算 +- 积分点与权重 + +## 8. 材料模块 + +模块:fem_material_iso.f90 + +待补充: + +- 线弹性更新 +- J2 弹塑性返回映射 +- 状态变量定义 +- 一致切线或算法切线 +- 波速估计 + +## 9. 实体单元模块 + +模块:fem_element_solid.f90 + +待补充: + +- 单元质量 +- 单元内力 +- 单元刚度 +- 应力更新 +- 稳定时间步估计 +- C3D4/C3D10/C3D8/C3D20 支持计划 + +## 10. 壳单元模块 + +模块:fem_element_shell.f90 + +待补充: + +- 壳截面 +- 膜应变 +- 弯曲应变 +- 横向剪切 +- 厚度积分 +- 剪切锁死处理 +- hourglass 控制 + +## 11. 边界、约束与接触模块 + +模块: + +- fem_boundary.f90 +- fem_constraint.f90 +- fem_contact.f90 + +待补充: + +- Dirichlet 处理 +- Neumann 处理 +- Robin 处理 +- MPC 处理 +- penalty 接触 +- 接触搜索接口 + +## 12. SPH 耦合模块 + +模块:fem_sph_coupling.f90 + +待补充: + +- 边界 facet 数据结构 +- FEM 状态导出接口 +- SPH 载荷导入接口 +- 节点力映射 +- 时间同步约定 + +## 13. 求解器模块 + +模块: + +- fem_solver_explicit.f90 +- fem_solver_implicit.f90 + +待补充: + +- 显式初始化 +- 显式单步推进 +- 稳定时间步估计 +- 隐式残差组装 +- Newton 迭代 +- 收敛准则 + +## 14. 稀疏矩阵模块 + +模块:fem_sparse_csr.f90 + +待补充: + +- CSR 存储 +- 稀疏结构构造 +- 装配接口 +- 矩阵向量乘 +- 外部求解器接口 + +## 15. 主程序模块 + +模块:fem_program.f90 + +待补充: + +- 命令行参数 +- inp 文件读取 +- 求解流程 +- 输出流程 +- 返回码 + diff --git a/docs/04_mathematical_model_and_algorithms.md b/docs/04_mathematical_model_and_algorithms.md new file mode 100644 index 0000000..4e2c1de --- /dev/null +++ b/docs/04_mathematical_model_and_algorithms.md @@ -0,0 +1,160 @@ +# FEM Mathematical Model and Algorithms + +文档状态:草稿 + +适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序 + +## 1. 文档目的 + +本文档说明软件采用的控制方程、有限元离散、材料算法、时间积分、接触算法和 SPH-FEM 耦合算法。 + +## 2. 控制方程 + +待补充: + +- 动量守恒方程 +- 初始条件 +- 位移边界 +- 力边界 +- 接触边界 +- SPH 耦合边界 + +离散后基本方程: + +```text +M a + C v + F_int(u, state) = F_ext + F_contact + F_sph +``` + +## 3. 弱式形式 + +待补充: + +- 虚功原理 +- 内力项 +- 外力项 +- 惯性项 +- 阻尼项 +- 接触和耦合边界贡献 + +## 4. 空间离散 + +待补充: + +- 位移插值 +- 应变-位移矩阵 +- 实体单元离散 +- 壳单元离散 +- 节点自由度定义 + +## 5. 质量矩阵与阻尼 + +待补充: + +- 一致质量矩阵 +- 集中质量矩阵 +- Rayleigh 阻尼 +- 边界阻尼 +- 显式动力学质量处理 + +## 6. 显式中心差分算法 + +待补充: + +- 速度半步更新 +- 位移整步更新 +- 加速度计算 +- 边界条件施加 +- 稳定时间步限制 + +## 7. 隐式 Newmark 算法 + +待补充: + +- Newmark 参数 +- 有效刚度 +- 有效残差 +- Newton-Raphson 迭代 +- 收敛准则 + +## 8. 实体单元算法 + +待补充: + +- C3D4 +- C3D10 +- C3D8 +- C3D20 +- 形函数 +- 数值积分 +- Jacobian +- 内力和刚度 + +## 9. 壳单元算法 + +待补充: + +- Reissner-Mindlin 壳理论 +- 三角形壳 +- 四边形壳 +- 膜应变 +- 弯曲应变 +- 横向剪切 +- 厚度积分 +- 锁死控制 + +## 10. 材料算法 + +待补充: + +- 各向同性线弹性 +- J2 屈服函数 +- 关联流动法则 +- 各向同性硬化 +- 径向返回映射 +- 状态变量更新 +- 算法切线 + +## 11. 接触算法 + +待补充: + +- penalty 接触 +- 接触法向 +- 穿透量计算 +- 接触力计算 +- 接触阻尼 +- 时间步限制 + +## 12. SPH-FEM 耦合算法 + +待补充: + +- 边界 facet 构造 +- FEM 边界运动学量导出 +- SPH 压力映射 +- 剪切力映射 +- 节点等效力积分 +- 显式时间同步 + +## 13. 稳定性与误差控制 + +待补充: + +- 临界时间步 +- 材料波速 +- 单元特征长度 +- 退化单元检测 +- 能量平衡检查 + +## 14. 数值验证算例 + +待补充: + +- patch test +- 单轴拉伸 +- 悬臂梁 +- 自由振动 +- 弹性波传播 +- 板受冲击 +- SPH-FEM 耦合压力传递 + diff --git a/docs/05_interface_control_document.md b/docs/05_interface_control_document.md new file mode 100644 index 0000000..218d588 --- /dev/null +++ b/docs/05_interface_control_document.md @@ -0,0 +1,144 @@ +# FEM Interface Control Document + +文档状态:草稿 + +适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序 + +## 1. 文档目的 + +本文档定义 FEM 核心库对外暴露的调用接口、数据交换约定、错误码、单位制和 SPH-FEM 耦合接口。 + +## 2. 接口设计原则 + +待补充: + +- Fortran95 数组接口 +- 不依赖面向对象特性 +- 调用者不直接访问内部数据库 +- 通过错误码返回状态 +- 一致单位制由调用者保证 + +## 3. 库生命周期接口 + +待补充: + +```fortran +subroutine fem_initialize(ierr) +subroutine fem_finalize(ierr) +``` + +## 4. 模型输入接口 + +待补充: + +```fortran +subroutine fem_read_inp(filename, ierr) +subroutine fem_build_model(ierr) +``` + +待讨论: + +- filename 字符串长度约定 +- 多 step inp 文件处理方式 +- 不支持 keyword 的返回策略 + +## 5. 求解控制接口 + +待补充: + +```fortran +subroutine fem_set_time_step(dt, ierr) +subroutine fem_estimate_stable_dt(dtcrit, ierr) +subroutine fem_advance_explicit(dt, ierr) +subroutine fem_solve_current_step(ierr) +``` + +## 6. 结果查询接口 + +待补充: + +```fortran +subroutine fem_get_nodal_displacement(nnode, node_id, disp, ierr) +subroutine fem_get_nodal_velocity(nnode, node_id, vel, ierr) +subroutine fem_get_nodal_acceleration(nnode, node_id, acc, ierr) +subroutine fem_get_element_stress(nelem, elem_id, stress, ierr) +``` + +## 7. 载荷施加接口 + +待补充: + +```fortran +subroutine fem_clear_external_force(ierr) +subroutine fem_apply_nodal_force(nnode, node_id, force, ierr) +subroutine fem_apply_pressure(nface, face_id, pressure, ierr) +``` + +## 8. SPH-FEM 耦合接口 + +待补充: + +```fortran +subroutine fem_get_boundary_facets(nfacet, conn, x, v, normal, area, ierr) +subroutine fem_apply_sph_nodal_forces(nnode, node_id, force, ierr) +subroutine fem_apply_sph_facet_tractions(nfacet, facet_id, pressure, shear, ierr) +``` + +待讨论: + +- facet 编号稳定性 +- 法向方向约定 +- 压力正负号约定 +- 剪切力坐标系约定 +- FEM 与 SPH 时间步同步方式 + +## 9. 边界条件接口 + +待补充: + +```fortran +subroutine fem_apply_prescribed_displacement(nnode, node_id, dof, value, ierr) +subroutine fem_apply_prescribed_velocity(nnode, node_id, dof, value, ierr) +subroutine fem_apply_robin_boundary(nnode, node_id, dof, stiffness, damping, ierr) +``` + +## 10. 错误码定义 + +待补充: + +- 成功 +- 输入文件错误 +- 不支持功能 +- 内存分配失败 +- 非法参数 +- 网格质量错误 +- 求解失败 +- 耦合接口错误 + +## 11. 内存与数组约定 + +待补充: + +- 数组维度顺序 +- 调用方分配还是库内分配 +- 字符串长度 +- 下标从 1 开始 +- 节点、单元和 facet 编号约定 + +## 12. 单位制约定 + +待补充: + +- 软件不内置单位转换 +- inp 文件和外部耦合程序必须采用一致单位制 +- 日志中记录建议单位说明 + +## 13. C/C++/Python 包装层规划 + +待补充: + +- Fortran95 原生接口 +- C ABI 包装层 +- Python 调研接口 +- 与外部 SPH 程序耦合方式 + diff --git a/docs/06_test_and_verification_plan.md b/docs/06_test_and_verification_plan.md new file mode 100644 index 0000000..590cc1e --- /dev/null +++ b/docs/06_test_and_verification_plan.md @@ -0,0 +1,134 @@ +# FEM Test and Verification Plan + +文档状态:草稿 + +适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序 + +## 1. 文档目的 + +本文档定义 FEM 软件的测试层级、验证算例、确认算例、回归测试、性能测试和验收策略。 + +## 2. 测试目标 + +待补充: + +- 验证有限元公式实现正确 +- 验证材料更新算法正确 +- 验证显式动力学稳定可靠 +- 验证 Abaqus inp 子集解析正确 +- 验证 SPH-FEM 边界接口可用 +- 建立回归测试基准 + +## 3. 测试层级 + +待补充: + +- 单元测试 +- 模块测试 +- 集成测试 +- 系统测试 +- 回归测试 +- 性能测试 +- 鲁棒性测试 + +## 4. 单元测试计划 + +待补充: + +- 形函数 Kronecker delta 性质 +- 形函数 partition of unity +- Jacobian 计算 +- 高斯积分规则 +- 线弹性应力更新 +- J2 弹塑性返回映射 +- CSR 索引构造 +- INP keyword 解析 + +## 5. 模块测试计划 + +待补充: + +- 实体单元质量矩阵 +- 实体单元内力 +- 壳单元膜响应 +- 壳单元弯曲响应 +- 边界载荷等效节点力 +- Dirichlet 约束施加 +- SPH facet 导出与载荷导入 + +## 6. 集成测试计划 + +待补充: + +- inp 读取到数据库构建 +- 数据库到自由度编号 +- 显式初始化 +- 单步推进 +- 多步输出 +- 错误日志检查 + +## 7. 验证算例 + +待补充: + +- 实体单元 patch test +- 壳单元 patch test +- 单轴拉伸 +- 悬臂梁静力 +- 自由振动频率 +- 弹性波传播 +- 薄板弯曲 +- 弹塑性单轴加载卸载 + +## 8. 确认算例 + +待补充: + +- Taylor impact +- 板受冲击压力载荷 +- 简化船体板架爆炸响应 +- 接触冲击算例 +- SPH-FEM 耦合压力传递算例 + +## 9. 回归测试 + +待补充: + +- 基准结果存储格式 +- 允许误差 +- 浮点误差处理 +- 自动测试脚本 +- 每次提交必须运行的测试集合 + +## 10. 性能测试 + +待补充: + +- 节点规模 +- 单元规模 +- 时间步规模 +- 内存占用 +- 显式单步耗时 +- INP 读取耗时 + +## 11. 鲁棒性测试 + +待补充: + +- 缺失材料 +- 退化单元 +- 非法边界自由度 +- 不支持 keyword +- 空集合 +- 非法塑性曲线 +- 时间步过大 + +## 12. 验收准则 + +待补充: + +- 第一阶段验收算例 +- 数值误差阈值 +- 日志和错误码要求 +- 文档完整性要求 +