Files
CCLite/SPHLite/docs/cclite_input_keyword.md
T
2026-07-05 22:48:27 +08:00

50 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SPHLite CCLite Input Keyword
文档状态:0.8.x worker adapter 输入关键词草案
`*SPHLITE CCLITE` 是 SPHLite 侧 worker 集成提示关键词。它只保存 SPHLite 对 CCLite worker 数据交换的本地偏好,不生成几何、网格或粒子,不替代 CCLite 配置文件,也不负责匹配外部 FEM 区域。
## 1. 语法
```text
*SPHLITE CCLITE, WORKER=YES, REGION=ALL,
EXPORT_RADIUS=YES, EXPORT_SOUND_SPEED=YES,
ACCEPT_CONTACT_STATE=YES, ACCEPT_BOUNDARY_STATE=NO
```
所有选项均在关键词行内给出;当前不读取后续数据行。
## 2. 选项
| 选项 | 默认值 | 含义 |
|---|---|---|
| `WORKER` | `YES` | 当前输入文件声明可用于 SPHLite worker 模式;`NO` 表示不启用该提示 |
| `REGION` | `ALL` | SPHLite 侧 coupling region 名称;`ALL` 表示由 worker 导出全部启用 region |
| `EXPORT_RADIUS` | `YES` | worker 粒子数据块是否导出 `contact_radius` |
| `EXPORT_SOUND_SPEED` | `YES` | worker 粒子数据块是否导出 `sound_speed` |
| `ACCEPT_CONTACT_STATE` | `YES` | worker 是否接受 CCLite 写入的 contact state |
| `ACCEPT_BOUNDARY_STATE` | `NO` | boundary/ghost state 预留开关,当前只保存配置 |
布尔选项接受 `YES/NO`、`ON/OFF`、`TRUE/FALSE`、`1/0`。
## 3. 与 Coupling Region 的关系
- `*SPHLITE COUPLING REGION` 仍定义 SPHLite 侧导出/导入 region、集合、phase/material/section 过滤、`EXPORT`、`IMPORT`、`LOAD_MODE`、`DISTRIBUTION` 和 `CONTACT_STATE`。
- `*SPHLITE CCLITE, REGION=...` 只引用 region 名称,不创建 region。
- `EXPORT_RADIUS` 和 `EXPORT_SOUND_SPEED` 对应 worker AOR 粒子数据块字段。
- `ACCEPT_CONTACT_STATE=YES` 只有在 region 自身设置 `CONTACT_STATE=IMPORT` 时才会产生实际导入。
- `ACCEPT_BOUNDARY_STATE` 为后续 boundary/ghost/FSI 数据块预留。
## 4. 当前实现边界
当前解析结果保存到 SPHLite database:
- `cclite_worker_enabled`
- `cclite_region_name`
- `cclite_export_radius`
- `cclite_export_sound_speed`
- `cclite_accept_contact_state`
- `cclite_accept_boundary_state`
当前 worker 数据块仍以 `cclite_coupling_manifest.md` 为准;本关键词不改变求解器时间推进、材料模型或 CouplingInterface 的数值算法。