Skip to content

Echo-aloha/asphalt-codex-skills-5 / skills/pfc-fishtank-tests

pfc-fishtank-tests

Verified

Integrate an external, licensed Itasca PFC 5.0 fistPkg26 tree as a reproducible material-generation and compression/diametral/tension test baseline; use to validate its PFC5.0 layout, copy a private working case, preserve provenance, and audit ck/ct/dc/tt/ft extension points for asphalt workflows.

FileKindSize
SKILL.mdskill md5.3 KB
agents/openai.yamlconfig308 B
references/overview.mdmarkdown2.7 KB
references/test-framework.mdmarkdown2.6 KB
scripts/check_fistpkg.pyscript3.2 KB

references/test-framework.md

View on GitHub
# fistPkg 试验框架与 FISH 工具用法

## 1. FISH 工具用途与调用

| 工具 | 职责 | 关键扩展点 |
| --- | --- | --- |
| `ft.fis` | 主库:墙-颗粒行为设置、平衡、应变/应力量测 | `ft_setGrainWallBehavior`、`ft_eq` |
| `ck.fis` | 检查:级配、配位数、微观结构 | 生成后自检 |
| `ct.fis` | 压缩试验:围压/无围压/单轴应变 | `_ct...` 系列 |
| `dc.fis` | 劈裂试验:压头加载 + 峰后停止 | `_dcMakeWalls`、`_dcSetWallVel` |
| `tt.fis` | 直接拉伸 | — |

### 墙-颗粒行为(ft.fis)

```fish
; 设置既有/未来接触的颗粒-墙行为
ft_setGrainWallBehavior('existing', 0.0, dc_emod, 0.0, 0.0, 'linear')
ft_setGrainWallBehavior('future',  0.0, dc_emod, 0.0, 0.0, 'linear')
```

### 平衡(ft.fis)

```fish
retCode = ft_eq(dc_ARatLimit, dc_stepLimit)
```

## 2. 扩展点:`_dcMakeWalls`

dc.fis 通过 `_dcMakeWalls` 创建压板,官方默认实现为**平面压板**:

```fish
def _dcMakeWalls
    ; OUT: dcWp0/dcWp1 上下压板指针
    ft_setGrainWallBehavior('existing', 0.0, dc_emod, 0.0, 0.0, 'linear')
    ft_setGrainWallBehavior('future',   0.0, dc_emod, 0.0, 0.0, 'linear')
    ; 3D:wall generate ... polygon ... makeplanar(宽 dc_w × 深 dc_d 平面压板)
    ; 2D:wall create ... vertices(线段压板)
    dcWp0 = wall.find(1)   ; 下压板
    dcWp1 = wall.find(2)   ; 上压板
end
```

这是 dc.fis 的最小几何扩展点。非平面压头需要重定义本函数,但不能据此
假定其余逻辑无需验证;还要检查墙 ID、第二坐标轴约定、头部转动/平移约束、
颗粒-墙接触、`ft_SmoothGrainWallInterface`、力/位移符号、峰后停止和流值
后处理。详见 `pfc-marshall-test/references/overview.md`。

## 3. Hill UDM 安装注意

Hill 用户自定义接触模型(3D)需要 DLL:

- 文件:`contactmodelmechanical3dhill005_64.dll`
- 安装:复制到 `PFC500\exe64\plugins\contactmodelmechanical3D`(PFC 5.0 布局)。
- 仅 3D Hill 材料需要;linear/contact-bonded/parallel-bonded/flat-jointed 不需要额外 DLL。

## 4. 版本边界

- fistPkg 面向 PFC 5.0:`cmat default`、`wall create ... face`、FISH 语法均按 5.0 运行时核对。
- 检测到其他主版本目标或命令时停止;本包不负责迁移或兼容层。

## 5. 版权与复用约定

- fistPkg 源码版权归 Itasca,**不得**整段复制进公共 MIT 仓库。
- 正确做法:提炼"调用方式 + 命令模板 + 扩展点",外部引用 fistPkg 路径,由用户自备官方包。
- 存档 `.sav`、STL、DLL 等二进制不入库,仅脚本与文档入库。
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall