Files
FemLite/docs/01_requirements_specification.md
shenw a2126f360c
FemLite CI / build-test (push) Has been cancelled
Release 0.6.5 real IPC worker
2026-07-05 21:09:37 +08:00

3.6 KiB

01 需求规格说明

文档状态:0.6.5 版整理稿

1. 软件定位

FemLite 是一个轻量级有限元求解器,核心使用 Fortran 实现,面向结构动力学、静力学、非线性分析、壳/实体单元、接触、材料非线性和紧凑工程基准算例开发。

当前项目版本为 0.6.5。0.6.5 是 CCLite 真实 IPC worker 接入闭环版本,重点交付标准 worker 参数、真实 Windows IPC worker 后端、AOR_V1 data block、能力查询和进程级 IPC 自测。

2. 当前交付范围

当前软件应支持以下能力:

  • 显式动力学、线性静力、非线性静力和隐式 Newmark 路径。
  • 实体单元:C3D4、C3D8、C3D8R、C3D10、C3D20。
  • 壳单元:S3、S4、S4R、S6、S8。
  • Abaqus 风格单元名称识别;不支持的名称必须明确报错。
  • 线弹性、J2/J2_JC 和 Mohr-Coulomb 材料路径。
  • 内部 CG、BiCGSTAB、GMRES 和 dense pivoting 线性求解器。
  • 基础接触、mortar/AL、摩擦、cohesive 和颗粒耦合诊断基础设施。
  • CSV、VTU/PVD、restart、Fortran API 和 C ABI 输出/查询接口。
  • 元素 introspection API:元素类型、节点、坐标、积分点、形函数、Jacobian 和 B 矩阵。
  • CCLite coupling surface/facet 查询、节点力导入、worker mock、真实 IPC worker、IPC adapter 和载荷诊断 CSV。
  • continuation_path.csv、nonlinear_lifecycle.csv 和 restart version 5 生命周期诊断。

3. 0.6.4 新增需求

0.6.4 的新增需求已经交付:

  • 增加中立 coupling surface/facet 查询和扩展导出接口。
  • 增加 coupling 节点力导入接口,包含 source_id、load_mode 和 valid_flags。
  • 增加本步总力、总力矩、拒绝计数和按 source_id 汇总的诊断。
  • 增加 femlite_cclite_load_report.csv 与 femlite_cclite_surface_report.csv 输出。
  • 增加 worker mock 命令状态机和 VTU/PVD + coupling 诊断输出闭环。
  • 增加 Windows shared memory / named event IPC adapter 的 C 层边界。
  • 保留 0.6.3 的 S4R、受控 C3D8R、积分规则基础设施和元素 introspection API。

4. 0.6.5 新增需求

0.6.5 的新增需求已经交付:

  • 增加 --worker-backend ipc 真实 Windows IPC worker 路径,支持 READY、INIT、STEP、STOP、ERROR 命令闭环。
  • 增加 --solver-id、--timeout-ms、--worker-id、--command-block、--data-prefix 等标准 worker 参数。
  • 增加 AOR_V1 data block 布局、初始化和校验接口,支持 surface/facet 导出和 nodal load 导入的共享内存数据段边界。
  • 增加 --cclite-capabilities 能力查询输出,便于 CCLite 侧进行启动前能力探测。
  • 增加真实进程级 IPC worker 小闭环、100 step、timeout 和异常输入自测。

5. 明确不交付范围

以下内容不属于 0.6.5 交付:

  • 完整 reduced-integration solid 家族。
  • 完整 Abaqus 单元库。
  • 用户侧任意积分规则选择关键字。
  • 生产级有限变形 S4R。
  • 高级 hourglass 控制参数体系。
  • 完整工业级 AL/mortar 一致切线。
  • 广义 mixed-control continuation 和分支切换。
  • cohesive 主线接触 step。
  • DEM/FEM 子循环和大规模颗粒长算例。
  • 真实 SPH-FEM penalty contact、FSI 和强耦合 rollback。
  • 生产级滚压成形工艺链。

6. 质量要求

  • 所有新增功能必须有小型、可重复的测试或 checker。
  • 公开接口必须通过 ierr 或 C 返回码报告错误,不得直接终止程序。
  • 不支持的输入必须明确报错或明确 warning,不得静默回退到不同物理模型。
  • 生成的 CSV、VTU/PVD、restart 和临时结果不得提交。
  • 发布前必须通过当前版本 release gate。