Echo-aloha/asphalt-codex-skills-5 / skills/pfc-fishtank-tests
pfc-fishtank-tests
VerifiedIntegrate 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
| agents/openai.yaml | config | 308 B |
| references/overview.md | markdown | 2.7 KB |
| references/test-framework.md | markdown | 2.6 KB |
| scripts/check_fistpkg.py | script | 3.2 KB |
SKILL.md
View on GitHub---
name: pfc-fishtank-tests
description: 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.
---
# PFC FISHTank (fistPkg) Standard Test Framework
Use this skill to understand and externally reuse Itasca PFC 5.0 FISHTank
`fistPkg26`. Treat it as a PFC 5.0 dependency without requiring a particular PFC5.0
subversion. Its
files remain outside this skills package; the complete asphalt parent is
`pfc5-asphalt-workflow`.
## When To Use
Use this skill when the user needs to:
- Understand what fistPkg (FISHTank) provides and how its directories are laid out.
- Reuse the standard compression / diametral-compression / direct-tension test framework (ct/dc/tt).
- Generate a material specimen with MatGen (linear, contact-bonded, parallel-bonded, flat-jointed, Hill).
- Extend the diametral-compression framework with custom loading heads (e.g. curved heads for a Marshall-type test per JTG T0709).
- Locate the FISH tools (ck/ct/dc/tt/ft/hl) and the Hill DLL installation requirement.
Do NOT use this skill for asphalt-specific modeling choices — those are in `pfc-asphalt-mixture`, `pfc-burger-viscoelastic`, `pfc-marshall-test`, `pfc-rutting-test`.
## Required Inputs
Ask for these if missing:
- Target material type: linear / contact-bonded / parallel-bonded / flat-jointed / Hill (3D UDM).
- Target test: compression (confined/unconfined/uniaxial) / diametral-compression / direct-tension.
- PFC2D or PFC3D 5.0. If another major version is requested, stop: it is outside
this package.
- Whether the Hill UDM DLL is needed (3D Hill material only).
- Legal `<FISTPKG_ROOT>` and a PFC2D/PFC3D 5.0 runtime.
## fistPkg Capabilities
- **Material genesis**: linear, contact-bonded, parallel-bonded, flat-jointed, and user-defined (3D Hill) materials in polyaxial/cylindrical/spherical vessels; grains as balls or clumps.
- **Material tests**: compression (confined, unconfined, uniaxial strain), diametral-compression, direct-tension.
- **Microstructural monitoring**: grain-size distribution, microstructural plots, crack monitoring for bonded materials.
## Directory Layout
```
fistPkgN/
├── fistPkg-README.txt
├── fistPkg-publicMods.txt
├── Documentation/ ; PDF docs (BPM, FlatJoint, Hill, MatModelingSupport)
└── ExampleProjects/
├── fistSrc/ ; FISH source: ck/ct/dc/tt/ft/hl + Hill DLL
├── MatGen-Linear / ContactBonded / ParallelBonded / FlatJointed / Hill
│ └── CompTest / DiamCompTest / TenTest
└── HillContactModel / FlatJointContactModel / ...
```
## FISH Tool Map
| 工具 | 用途 |
| --- | --- |
| `ft.fis` | FISHTank 主库(核心工具函数:墙-颗粒行为、平衡等) |
| `ck.fis` | 检查/微观结构监测(级配、配位数等) |
| `ct.fis` | 压缩试验(confined/unconfined/uniaxial) |
| `dc.fis` | 劈裂/间接拉伸试验(diametral compression)——马歇尔试验基座 |
| `tt.fis` | 直接拉伸试验 |
| `hl.p3fis` + `udm_hl.p3fis` | Hill 用户自定义接触模型(3D) |
| `contactmodelmechanical3dhill005_64.dll` | Hill 模型 DLL(需安装到插件目录) |
## Workflow
1. Run the self-contained checker:
`scripts/check_fistpkg.py "<FISTPKG_ROOT>"`.
2. 选材料类型(linear/contact-bonded/parallel-bonded/flat-jointed/Hill)。
3. 按官方 README,把 `ExampleProjects/fistSrc` 与一个 `MatGen-X` 复制到
私有案例目录;先运行未修改的基线。
4. 生成完成后运行对应试验(CompTest/DiamCompTest/TenTest)。
5. 自定义压头时,以 `_dcMakeWalls` 为最小几何钩子,同时审计墙 ID、
轴向、接触、平滑、力/位移、终止和后处理。
## Working Rules
- fistPkg is PFC 5.0 — use PFC 5.0 syntax directly and do not generate another
major-version case from this skill.
- The Hill UDM requires copying the DLL to `PFC500\exe64\plugins\contactmodelmechanical3D` (PFC 5.0 layout).
- Do NOT vendor Itasca's fistPkg source into a public MIT repo — extract usage patterns and command templates only, cite the package as external.
- Reuse the staged, saved-state style (MatGen → CompTest/DiamCompTest/TenTest) for reproducibility.
- Replacing `_dcMakeWalls` is necessary for custom heads but is not by itself a
complete Marshall validation.
## Output Contract
A complete fistPkg handoff should include:
- Material type and vessel geometry chosen, test type selected.
- Which FISH tools (ck/ct/dc/tt/ft) are needed and how they are called.
- The extension point used (e.g. `_dcMakeWalls` for custom heads).
- Any DLL/plugin installation note.
- A note that the case targets PFC2D/PFC3D 5.0; route other major versions outside this skill.
- The checker result, baseline run result, copied-file manifest and
`runtime_validated` status.
## Local Contents
- `references/overview.md`: fistPkg capabilities, directory layout, five material types, three tests.
- `references/test-framework.md`: FISH tool usage (ck/ct/dc/tt/ft), Hill DLL installation, and extension points.
- `scripts/check_fistpkg.py`: self-contained, read-only external fistPkg layout/version checker.
- `agents/openai.yaml`: agent interface metadata.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |