25 KiB
CCLite 详细设计说明书
Coupling & Contact Lite for SPHLite and FEMLite
文档版本:V1.1
软件名称:CCLite
实现基线:Fortran95 算法核心 + Fortran2018 IPC 包装 + C/C++ Windows IPC 薄层
输入基线:Abaqus 风格 .inp
第一阶段平台:Windows / gfortran / 本机共享内存
1. 文档说明
1.1 编写目的
本文档细化 CCLite 的目录结构、模块职责、核心数据结构、共享内存布局、控制状态机、输入关键词、显式同步流程、接触算法、诊断输出、错误码和版本实现路径。
1.2 设计范围
本文档覆盖:
- Fortran 源码目录结构;
- CCLite 主控上下文;
.inp解析器;- Controller 状态机;
- Windows 本机共享内存和控制 IPC;
- Fortran2018
iso_c_binding包装; - SPH/FEM interface view;
- 几何、搜索和接触检测;
- penalty damping 接触力;
- SPH/FEM 力传递;
- 诊断输出;
- 第一阶段测试和验收。
1.3 设计边界
CCLite 负责 SPHLite 与 FEMLite 之间的数据交换、接触/耦合算法和同步调度;不负责 SPH/FEM 内部求解。
第一版只实现 Windows/gfortran/本机共享内存。Linux 共享内存、MPI 和分布式 socket 后端只保留枚举、配置项和错误提示。
2. 推荐目录结构
2.1 源码目录
本节给出长期推荐结构。0.2.10 当前实现已按职责拆分,但目录名以现有仓库为准,见 2.3。
CCLite/
├── Makefile
├── CMakeLists.txt 可选构建入口
├── include/
│ └── cclite/
│ └── cclite_ipc.h C IPC 薄层头文件
├── src/
│ ├── app/
│ │ └── cclite_main.f90
│ ├── base/
│ │ ├── ccl_precision.f90
│ │ ├── ccl_error.f90
│ │ ├── ccl_constants.f90
│ │ └── ccl_string.f90
│ ├── case/
│ │ ├── ccl_case_types.f90
│ │ ├── ccl_inp_reader.f90
│ │ ├── ccl_keyword_parser.f90
│ │ └── ccl_case_validate.f90
│ ├── controller/
│ │ ├── ccl_context.f90
│ │ ├── ccl_controller.f90
│ │ ├── ccl_solver_process.f90
│ │ └── ccl_state_machine.f90
│ ├── ipc/
│ │ ├── ccl_ipc_types.f90
│ │ ├── ccl_ipc_f2018.f90
│ │ ├── ccl_shared_block.f90
│ │ ├── ccl_buffer_state.f90
│ │ └── ccl_win_ipc.c
│ ├── interface/
│ │ ├── ccl_interface_types.f90
│ │ ├── ccl_sph_view.f90
│ │ ├── ccl_fem_view.f90
│ │ └── ccl_interface_manager.f90
│ ├── geometry/
│ │ ├── ccl_vec3.f90
│ │ ├── ccl_aabb.f90
│ │ ├── ccl_closest_point.f90
│ │ └── ccl_shell_geometry.f90
│ ├── search/
│ │ ├── ccl_hash_grid.f90
│ │ └── ccl_candidate_builder.f90
│ ├── contact/
│ │ ├── ccl_contact_types.f90
│ │ ├── ccl_contact_detector.f90
│ │ ├── ccl_penalty_contact.f90
│ │ └── ccl_contact_manager.f90
│ ├── transfer/
│ │ ├── ccl_force_buffer.f90
│ │ ├── ccl_force_transfer.f90
│ │ └── ccl_force_balance.f90
│ ├── diagnostics/
│ │ ├── ccl_diag_types.f90
│ │ ├── ccl_contact_report.f90
│ │ ├── ccl_ipc_report.f90
│ │ └── ccl_timestep_report.f90
│ └── output/
│ ├── ccl_log.f90
│ ├── ccl_csv_writer.f90
│ └── ccl_snapshot_writer.f90
├── tests/
│ ├── unit/
│ ├── integration/
│ └── regression/
├── examples/
└── docs/
2.2 0.2.10 当前实现目录
0.2.10 发布候选中的实际源码边界为:
src/
app/ cclite 主程序入口
common/ 版本、错误码和日志
case/ .inp 解析、case model 和校验
controller/ worker 调度、step loop、接触流程和诊断调用
diagnostics/ run.log、ipc、candidate、contact 和 force balance 输出
geometry/ Vec3、AABB、最近点和基础几何
search/ uniform hash grid 和候选对
contact/ 窄相接触和 penalty force
transfer/ SPH/FEM interface view 与 load buffer
interface_data/ command block、data block 和 AoR v1 record
ipc/ Windows shared memory 和 named event
platform/ worker 进程启动、等待和终止
mock_workers/ mock SPH/FEM worker service
0.2.10 不把接触算法写入 SPHLite 或 FEMLite 内部;真实 worker 接入仍由 docs/07_real_worker_access_audit.md 中的 adapter gate 管理。
2.3 命名约定
ccl_ Fortran procedure/module 前缀
ccl_*_mod Fortran module 后缀
CCL_ 公共枚举和常量前缀
CCLITE_ 共享内存 magic、环境变量和命令行前缀
示例:
module ccl_contact_manager_mod
subroutine ccl_contact_manager_compute(ctx, ierr)
integer, parameter :: CCL_CMD_EXPORT_INTERFACE = 20
3. 核心数据类型
3.1 精度模块
module ccl_precision_mod
implicit none
integer, parameter :: ccl_i4 = selected_int_kind(9)
integer, parameter :: ccl_i8 = selected_int_kind(18)
integer, parameter :: ccl_r8 = selected_real_kind(15, 300)
end module
算法核心使用上述 kind,避免在 Fortran95 核心中依赖平台类型。
3.2 CCL_Case
type CCL_SolverConfig
character(len=32) :: name
character(len=32) :: solver_type
character(len=260) :: executable
character(len=260) :: input_file
character(len=260) :: work_dir
end type
type CCL_IpcConfig
character(len=32) :: ipc_type
character(len=64) :: prefix
character(len=32) :: control
character(len=32) :: buffering
integer :: timeout_ms
end type
type CCL_TimeConfig
real(ccl_r8) :: start_time
real(ccl_r8) :: end_time
real(ccl_r8) :: dt
integer :: output_frequency
end type
type CCL_InterfaceConfig
character(len=64) :: name
character(len=64) :: sph_region
character(len=64) :: fem_surface
end type
type CCL_ContactConfig
character(len=64) :: name
character(len=64) :: interface_name
character(len=64) :: interaction_name
character(len=64) :: contact_type
end type
3.3 CCL_Context
CCL_Context 是 CCLite 顶层运行上下文。
type CCL_Context
type(CCL_Case) :: case_data
type(CCL_RunState) :: run_state
type(CCL_IpcManager) :: ipc
type(CCL_InterfaceManager) :: interfaces
type(CCL_SearchState) :: search
type(CCL_ContactState) :: contact
type(CCL_TransferState) :: transfer
type(CCL_Diagnostics) :: diagnostics
end type
上下文保存 CCLite 自身状态,不保存 SPHLite/FEMLite 私有求解状态。
3.4 Run State
type CCL_RunState
integer :: mode
integer :: controller_state
integer :: current_step
real(ccl_r8) :: current_time
integer :: last_error_code
character(len=256) :: last_error_message
end type
4. .inp 解析详细设计
4.1 解析范围
第一版解析器支持 CCLite 关键词子集:
*CCLITE CONTROL
*CCLITE SOLVER
*CCLITE IPC
*CCLITE TIME
*CCLITE INTERFACE
*CCLITE SURFACE INTERACTION
*CCLITE CONTACT PAIR
*CCLITE OUTPUT
*END STEP
不承诺完整 Abaqus 语法兼容。
4.2 关键词行
关键词行格式:
*KEYWORD, PARAM1=VALUE1, PARAM2=VALUE2
解析步骤:
- 去除首尾空白;
- 跳过空行和
**注释; - 若首字符为
*,识别新关键词; - 逗号分割参数;
- 将参数名转换为大写;
- 保存到当前 keyword record;
- 后续非关键词行作为数据行归属当前关键词。
4.3 参数校验
必须检查:
- 是否存在一个
*CCLITE CONTROL; - 是否存在 SPH 和 FEM 两个
*CCLITE SOLVER; - 是否存在
*CCLITE IPC; - 是否存在
*CCLITE TIME; CONTACT PAIR引用的 interface 和 interaction 是否存在;- 第一版
IPC TYPE是否为WINDOWS_SHMEM; - 路径字段是否非空。
4.4 错误策略
解析错误必须包含:
file
line_number
keyword
parameter
message
示例:
CCL_ERROR_INPUT_MISSING_PARAM:
line 18, *CCLITE SOLVER missing INPUT
5. IPC 详细设计
5.1 C IPC 薄层
C/C++ 薄层只负责 OS 资源,不包含接触算法。
建议导出接口:
void* ccl_ipc_create_block(const char* name, long long bytes);
void* ccl_ipc_open_block(const char* name, long long bytes);
void* ccl_ipc_map_block(void* handle);
int ccl_ipc_unmap_block(void* ptr);
int ccl_ipc_close_block(void* handle);
void* ccl_ipc_create_event(const char* name);
void* ccl_ipc_open_event(const char* name);
int ccl_ipc_wait_event(void* handle, int timeout_ms);
int ccl_ipc_signal_event(void* handle);
int ccl_ipc_reset_event(void* handle);
Windows 实现可使用 file mapping object 和 named event。Linux 实现只预留。
5.2 Fortran2018 Wrapper
Fortran2018 wrapper 使用 iso_c_binding:
module ccl_ipc_f2018_mod
use iso_c_binding
implicit none
type CCL_IpcHandle
type(c_ptr) :: raw = c_null_ptr
type(c_ptr) :: mapped = c_null_ptr
integer(c_size_t) :: bytes = 0
end type
contains
subroutine ccl_ipc_map_real64_1d(handle, offset_bytes, n, values)
type(CCL_IpcHandle), intent(in) :: handle
integer(c_size_t), intent(in) :: offset_bytes
integer, intent(in) :: n
real(c_double), pointer, intent(out) :: values(:)
end subroutine
end module
Fortran95 算法核心不得直接依赖 c_ptr。
5.3 Shared Block Header
Header 使用固定字段:
type CCL_SharedHeader
integer(ccl_i4) :: magic
integer(ccl_i4) :: version_major
integer(ccl_i4) :: version_minor
integer(ccl_i4) :: block_role
integer(ccl_i4) :: producer_id
integer(ccl_i4) :: consumer_id
integer(ccl_i4) :: step_id
integer(ccl_i4) :: buffer_id
integer(ccl_i4) :: state
integer(ccl_i4) :: item_count
integer(ccl_i4) :: item_stride
integer(ccl_i8) :: payload_bytes
integer(ccl_i4) :: error_code
integer(ccl_i4) :: reserved(16)
end type
注意:实际跨 C/Fortran 二进制布局实现时,应由 IPC 层提供 pack/unpack 或使用 bind(C) 镜像类型;算法层只读写逻辑字段。
5.4 Buffer 状态转换
EMPTY -> WRITING -> READY -> READING -> CONSUMED
\-> ERROR
规则:
- producer 只能写
EMPTY或CONSUMEDbuffer; - consumer 只能读
READYbuffer; - step_id 必须单调递增;
- 任何一方发现版本、大小、状态非法,应置
ERROR并上报 Controller。
5.5 Block Role
第一版 role:
integer, parameter :: CCL_BLOCK_SPH_PARTICLE = 101
integer, parameter :: CCL_BLOCK_SPH_FACET = 102
integer, parameter :: CCL_BLOCK_FEM_FACET = 201
integer, parameter :: CCL_BLOCK_TO_SPH_FORCE = 301
integer, parameter :: CCL_BLOCK_TO_FEM_LOAD = 302
integer, parameter :: CCL_BLOCK_DIAGNOSTIC = 900
6. 共享数据布局
6.1 SPH Particle Payload
每个 SPH 粒子记录推荐字段:
int external_id
int internal_index
int phase
int status
int material_id
int section_id
real mass
real volume
real density
real pressure
real h
real x(3)
real v(3)
real a(3)
real contact_radius
payload 可按 structure-of-arrays 或 array-of-records 实现。第一版推荐 array-of-records,便于调试;后续性能优化可改为 structure-of-arrays,但共享内存 version 必须升级。
6.2 FEM Facet Payload
每个 FEM facet 记录推荐字段:
int facet_id
int elem_id
int face_id
int node_count
int node_ids(max_face_nodes)
real x(max_face_nodes,3)
real v(max_face_nodes,3)
real normal(3)
real area
real thickness
max_face_nodes 第一版可取 4 或 8,必须在 header 或配置中明确。
6.3 CCL to SPH Force Payload
int external_id
int export_index
real force(3)
real moment(3)
int contact_state
real normal(3)
real gap
real penetration
6.4 CCL to FEM Load Payload
int facet_id
int node_count
int node_ids(max_face_nodes)
real node_forces(max_face_nodes,3)
real pressure
real traction(3)
real resultant(3)
7. Controller 状态机
7.1 Controller State
CCL_CTRL_CREATED
CCL_CTRL_CASE_LOADED
CCL_CTRL_IPC_READY
CCL_CTRL_SOLVERS_STARTED
CCL_CTRL_SOLVERS_READY
CCL_CTRL_RUNNING
CCL_CTRL_FINALIZING
CCL_CTRL_DONE
CCL_CTRL_FAILED
7.2 Solver State
SOLVER_CREATED
SOLVER_INITIALIZING
SOLVER_READY
SOLVER_EXPORTING
SOLVER_WAITING_IMPORT
SOLVER_ADVANCING
SOLVER_DONE
SOLVER_FAILED
SOLVER_STOPPED
7.3 Command Enum
integer, parameter :: CCL_CMD_INIT = 1
integer, parameter :: CCL_CMD_READ_INPUT = 2
integer, parameter :: CCL_CMD_BUILD_MODEL = 3
integer, parameter :: CCL_CMD_EXPORT_INTERFACE = 4
integer, parameter :: CCL_CMD_IMPORT_LOADS = 5
integer, parameter :: CCL_CMD_ADVANCE = 6
integer, parameter :: CCL_CMD_WRITE_OUTPUT = 7
integer, parameter :: CCL_CMD_STOP = 99
7.4 显式同步 Stepper
伪代码:
do step = 1, nstep
time = time0 + step * dt
call ccl_controller_command(ctx, SOLVER_SPH, CCL_CMD_EXPORT_INTERFACE, step, ierr)
call ccl_controller_command(ctx, SOLVER_FEM, CCL_CMD_EXPORT_INTERFACE, step, ierr)
call ccl_controller_wait_both(ctx, step, ierr)
call ccl_interface_update_views(ctx, step, ierr)
call ccl_search_build_candidates(ctx, ierr)
call ccl_contact_detect(ctx, ierr)
call ccl_contact_compute_forces(ctx, ierr)
call ccl_transfer_write_buffers(ctx, step, ierr)
call ccl_controller_command(ctx, SOLVER_SPH, CCL_CMD_IMPORT_LOADS, step, ierr)
call ccl_controller_command(ctx, SOLVER_FEM, CCL_CMD_IMPORT_LOADS, step, ierr)
call ccl_controller_wait_both(ctx, step, ierr)
call ccl_controller_advance(ctx, SOLVER_SPH, dt, step, ierr)
call ccl_controller_advance(ctx, SOLVER_FEM, dt, step, ierr)
call ccl_controller_wait_both(ctx, step, ierr)
call ccl_diagnostics_write_step(ctx, step, time, ierr)
end do
8. Interface View 设计
8.1 SPHParticleView
type CCL_SPHParticleView
integer :: count
integer, pointer :: external_id(:)
integer, pointer :: export_index(:)
integer, pointer :: phase(:)
integer, pointer :: status(:)
real(ccl_r8), pointer :: mass(:)
real(ccl_r8), pointer :: x(:,:)
real(ccl_r8), pointer :: v(:,:)
real(ccl_r8), pointer :: radius(:)
end type
维度约定:
x(3, count)
v(3, count)
8.2 FEMFacetView
type CCL_FEMFacetView
integer :: count
integer :: max_face_nodes
integer, pointer :: facet_id(:)
integer, pointer :: node_count(:)
integer, pointer :: node_ids(:,:)
real(ccl_r8), pointer :: x(:,:,:)
real(ccl_r8), pointer :: v(:,:,:)
real(ccl_r8), pointer :: normal(:,:)
real(ccl_r8), pointer :: area(:)
real(ccl_r8), pointer :: thickness(:)
end type
维度约定:
node_ids(max_face_nodes, count)
x(3, max_face_nodes, count)
normal(3, count)
8.3 Force Buffers
SPH force buffer:
type CCL_SPHForceBuffer
integer :: count
integer, allocatable :: external_id(:)
integer, allocatable :: export_index(:)
real(ccl_r8), allocatable :: force(:,:)
real(ccl_r8), allocatable :: normal(:,:)
real(ccl_r8), allocatable :: gap(:)
real(ccl_r8), allocatable :: penetration(:)
end type
FEM load buffer:
type CCL_FEMLoadBuffer
integer :: count
integer :: max_face_nodes
integer, allocatable :: facet_id(:)
integer, allocatable :: node_count(:)
integer, allocatable :: node_ids(:,:)
real(ccl_r8), allocatable :: node_force(:,:,:)
end type
9. 几何与搜索详细设计
9.1 Vec3
基础向量过程:
ccl_vec3_dot(a, b)
ccl_vec3_cross(a, b, c)
ccl_vec3_norm(a)
ccl_vec3_normalize(a, ierr)
9.2 AABB
type CCL_AABB
real(ccl_r8) :: xmin(3)
real(ccl_r8) :: xmax(3)
end type
SPH 粒子 AABB:
x - radius <= point <= x + radius
FEM facet AABB:
min/max(facet node coords) expanded by search_distance + shell_thickness/2
9.3 Hash Grid
第一版使用均匀 hash grid:
- cell size 取最大搜索距离;
- FEM facet 插入 grid;
- 每个 SPH 粒子查询邻近 cell;
- 生成候选 pair。
9.4 最近点计算
必须实现:
- point-triangle closest point;
- point-quad closest point,可拆成两个 triangle;
- point-edge closest point;
- barycentric 或 shape weight 输出。
9.5 Candidate Pair
type CCL_ContactCandidate
integer :: sph_index
integer :: fem_facet_index
integer :: candidate_type
end type
10. 接触检测详细设计
10.1 ContactPair
type CCL_ContactPair
integer :: pair_id
integer :: sph_index
integer :: fem_facet_index
integer :: contact_type
real(ccl_r8) :: closest_point(3)
real(ccl_r8) :: normal(3)
real(ccl_r8) :: gap
real(ccl_r8) :: penetration
real(ccl_r8) :: relative_velocity_normal
real(ccl_r8) :: shape_weight(8)
integer :: node_count
end type
10.2 SPH 粒子到 FEM 面
流程:
- 读取 SPH 粒子位置
xp、速度vp、半径rp; - 读取 FEM facet 节点坐标和速度;
- 计算 facet 最近点
xc; - 计算面法向
n; - 计算
gap = dot(xp - xc, n); - 若 FEM 是壳,接触距离
rc = rp + 0.5 * thickness; - 若 FEM 是实体面,接触距离
rc = rp; - 若
gap < rc,生成接触; penetration = rc - gap。
10.3 边缘 fallback
当 point-face 最近点落在 facet 外或接近边界时,执行 point-edge 检测:
- 遍历 facet 边;
- 计算点到边最近点;
- 若距离小于接触距离,生成 edge contact;
- 法向从 edge closest point 指向 SPH 粒子。
10.4 壳厚度处理
FEM 壳不得简单视为零厚度面。第一版规则:
effective_distance = sph_radius + 0.5 * shell_thickness
壳法向由 FEMLite facet normal 提供,CCLite 不重构复杂壳法向。
11. 接触力详细设计
11.1 法向 penalty force
fn = kn * penetration
若 penetration <= 0,法向接触力为 0。
11.2 阻尼力
fd = cn * max(0, -vn)
其中 vn 为法向相对速度:
vn = dot(v_sph - v_fem_closest, normal)
11.3 合力
f_normal = (fn + fd) * normal
作用在 SPH 上的力为 +f_normal 或 -f_normal 取决于法向定义。设计要求:最终输出必须通过 force balance 检查验证作用-反作用。
11.4 FEM 节点分配
FEM 侧反力:
f_fem = -f_sph
节点力:
f_node_i = N_i * f_fem
其中 N_i 为最近点处形函数或由三角形 barycentric 权重得到的权重。
11.5 Force Balance
每步计算:
sum_f_sph
sum_f_fem
force_error = norm(sum_f_sph + sum_f_fem)
sum_m_sph
sum_m_fem
moment_error = norm(sum_m_sph + sum_m_fem)
输出到 force_balance.csv。
12. 传递写回设计
12.1 写入 SPH
CCLite 将 SPH 粒子力写入 CCL_TO_SPH:
external_id
export_index
force(3)
normal(3)
gap
penetration
contact_state
SPHLite 根据 export index 或 external id 将载荷映射回内部粒子。
12.2 写入 FEM
CCLite 将 FEM 节点力写入 CCL_TO_FEM:
facet_id
node_count
node_ids
node_forces
FEMLite 根据 facet/node id 将载荷加入外部 SPH 力缓存。
12.3 非有限保护
写回前必须检查:
- force 是否有限;
- node force 是否有限;
- penetration 是否非负;
- node_count 是否在范围内;
- facet_id/node_id 是否有效。
发现错误时应停止当前步并上报。
13. 诊断详细设计
13.1 contact_report.csv
字段:
step,time,active_pairs,max_penetration,max_force,
mean_penetration,edge_pair_count,failed_candidate_count
13.2 force_balance.csv
字段:
step,time,
sph_fx,sph_fy,sph_fz,
fem_fx,fem_fy,fem_fz,
force_error,
sph_mx,sph_my,sph_mz,
fem_mx,fem_my,fem_mz,
moment_error
13.3 ipc_report.csv
字段:
step,solver,command,state,elapsed_ms,block_role,
buffer_id,payload_bytes,error_code
13.4 timestep_report.csv
字段:
step,time,dt,sph_state,fem_state,contact_pairs,controller_state
13.5 日志
cclite.log 记录:
- 输入文件路径;
- 进程启动参数;
- IPC 名称;
- 每个阶段开始/结束;
- warning 和 error;
- 最终统计。
14. 错误码设计
integer, parameter :: CCL_OK = 0
integer, parameter :: CCL_ERROR_INPUT_BASE = 1000
integer, parameter :: CCL_ERROR_INPUT_UNKNOWN_KEYWORD = 1001
integer, parameter :: CCL_ERROR_INPUT_MISSING_PARAM = 1002
integer, parameter :: CCL_ERROR_INPUT_BAD_VALUE = 1003
integer, parameter :: CCL_ERROR_IPC_BASE = 2000
integer, parameter :: CCL_ERROR_IPC_CREATE_FAILED = 2001
integer, parameter :: CCL_ERROR_IPC_MAP_FAILED = 2002
integer, parameter :: CCL_ERROR_IPC_TIMEOUT = 2003
integer, parameter :: CCL_ERROR_IPC_BAD_HEADER = 2004
integer, parameter :: CCL_ERROR_IPC_BAD_STATE = 2005
integer, parameter :: CCL_ERROR_SOLVER_BASE = 3000
integer, parameter :: CCL_ERROR_SOLVER_START_FAILED = 3001
integer, parameter :: CCL_ERROR_SOLVER_FAILED = 3002
integer, parameter :: CCL_ERROR_SOLVER_BAD_STEP = 3003
integer, parameter :: CCL_ERROR_CONTACT_BASE = 4000
integer, parameter :: CCL_ERROR_CONTACT_NONFINITE = 4001
integer, parameter :: CCL_ERROR_CONTACT_BAD_GEOM = 4002
integer, parameter :: CCL_ERROR_CONTACT_OVERFLOW = 4003
所有错误应写入 cclite.log,并在命令行返回非零退出码。
15. 版本实现路径
15.1 CCLite 0.1.x
目标:主控程序、.inp、IPC 和空耦合闭环。
任务:
- Fortran 项目骨架;
cclite_main.f90;cclite.inp解析器;- CCLite Controller 状态机;
- Windows IPC 薄层;
- Fortran2018 IPC wrapper;
- mock solver 测试;
- SPHLite/FEMLite 进程启动;
- 空耦合同步推进;
ipc_report.csv。
验收:
cclite check可检查输入;cclite dry-run可启动并停止两个求解器;cclite run可完成空耦合;- 通信错误可诊断。
15.2 CCLite 0.2.x
目标:显式同步 SPH-FEM 接触。
任务:
- SPH particle view;
- FEM facet view;
- hash grid;
- point-face/point-edge;
- penalty damping;
- SPH/FEM load buffer;
- force balance;
- 单粒子撞面验收算例。
15.3 CCLite 0.3.x
目标:显式异步子循环。
任务:
- 子循环 stepper;
- 宏步/子步映射;
- 冲量累计;
- 平均力传递;
- 子循环诊断。
15.4 CCLite 0.4.x
目标:SPH-FEM tied coupling。
任务:
- InterfaceBond;
- penalty tie;
- bond damage;
- release 后转 contact;
- tie 诊断。
15.5 CCLite 0.5.x
目标:基础 FSI。
任务:
- SPH pressure projection;
- FEM motion boundary;
- boundary/ghost particle;
- 水下爆炸 FSI 小算例。
15.6 CCLite 0.6+
预留:
- SPH 显式 + FEM 隐式弱耦合;
- rollback;
- 强耦合迭代;
- Aitken 松弛;
- Riemann FSI;
- Linux/MPI 后端。
16. 测试详细设计
16.1 单元测试
inp_keyword_parse
inp_case_validate
ipc_header_pack
buffer_state_transition
vec3_ops
closest_point_triangle
closest_point_quad
closest_point_edge
hash_grid_candidates
penalty_contact_force
force_balance
16.2 集成测试
mock_solver_ipc
controller_two_mock_solvers
empty_coupling_sph_fem
sph_particle_fem_plane_contact
sph_particle_fem_shell_contact
ipc_timeout_error
nonfinite_force_error
16.3 验收输出检查
每个接触验收算例应检查:
contact_report.csv存在且 active pair 数合理;- 最大穿透非负且在预期范围;
- 最大接触力非负且有限;
force_balance.csv中 force_error 可接受;ipc_report.csv无 timeout/error;- 求解器进程正常停止。
17. 关键实现注意事项
17.1 不把 CCLite 写成 SPH/FEM 内部库
CCLite 第一版是独立主控程序。不得要求 SPHLite 或 FEMLite 直接链接 CCLite 算法核心。
17.2 不把 CCLite 写成通用接触库
第一版只处理 SPH-FEM 跨域接触,不处理 FEM 内部接触、SPH 内部接触或任意多体接触。
17.3 IPC 层必须薄
Windows API、句柄、事件、共享内存映射只在 IPC 层出现。接触算法只面对 Fortran 数组和 view。
17.4 .inp 第一版保持小而稳
只实现 *CCLITE 关键词子集。后续增加关键词时必须保持旧算例可读。
17.5 共享内存必须版本化
任何 payload 布局变化都必须升级 version,并在 check/dry-run 阶段发现不兼容。
18. 总结
CCLite 详细设计以三独立进程和本机共享内存为核心:CCLite 负责主控与接触算法,SPHLite/FEMLite 负责各自求解。Fortran95 保持算法核心简洁稳定,Fortran2018 与 C/C++ 薄层承担共享内存和 IPC。第一版交付重点是 .inp 主控、Windows/gfortran 通信闭环、显式同步 SPH-FEM penalty 接触和完整诊断。