Skip to content
cccskills
FreePublished on GitHub

pfc-fishtank-tests

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (5)

  • SKILL.md5.3 KB
  • agents/openai.yaml308 B
  • references/overview.md2.7 KB
  • references/test-framework.md2.6 KB
  • scripts/check_fistpkg.py3.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.fisFISHTank 主库(核心工具函数:墙-颗粒行为、平衡等)
ck.fis检查/微观结构监测(级配、配位数等)
ct.fis压缩试验(confined/unconfined/uniaxial)
dc.fis劈裂/间接拉伸试验(diametral compression)——马歇尔试验基座
tt.fis直接拉伸试验
hl.p3fis + udm_hl.p3fisHill 用户自定义接触模型(3D)
contactmodelmechanical3dhill005_64.dllHill 模型 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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Build PFC 5.0 asphalt-mixture specimens with explicit aggregate objects, a declared homogenized-mastic or fine-particle abstraction, residual air voids, measured gradation conversion, contact-pair assignment, compaction, equilibrium, and mass-volume closure; use before Marshall, rutting, creep, or strength tests.

The English summary is being prepared. Showing the original description.

Echo-aloha/asphalt-codex-skills-526Updated Aug 26, 2026

Select, probe, calibrate, and audit the Burger viscoelastic contact model for PFC 5.0 asphalt-mixture cases, including Maxwell-Kelvin parameter roles, units, temperature/rate dependence, PFC5 cmat assignment, timestep checks, creep/recovery validation, and PFC5-only syntax boundary checks.

The English summary is being prepared. Showing the original description.

Echo-aloha/asphalt-codex-skills-526Updated Aug 26, 2026

Adapt and audit a PFC 5.0 asphalt Marshall stability/flow simulation using the external fistPkg26 dc.fis two-head controller as a starting skeleton; use for curved-head geometry, PFC5 wall/contact kinematics, load-deformation histories, peak stability, edition-specific flow processing, and validation against laboratory data.

The English summary is being prepared. Showing the original description.

Echo-aloha/asphalt-codex-skills-526Updated Aug 26, 2026

Post-process PFC 5.0 asphalt CSV and image exports into reproducible curves, fields, rose diagrams, animations, and summary tables without relying on a local PFC installation.

The English summary is being prepared. Showing the original description.

Echo-aloha/asphalt-codex-skills-526Updated Aug 26, 2026

Design, implement, and audit PFC3D 5.0 asphalt wheel-tracking and intersection-rutting simulations using RVE-to-strip-to-full-size scaling, PFC5-compatible vector reaction control, Burger-calibrated contacts, vertical-horizontal coupled loads, rut/shear histories, edition-specific metrics, and explicit surrogate validation.

The English summary is being prepared. Showing the original description.

Echo-aloha/asphalt-codex-skills-526Updated Aug 26, 2026

Govern Asphalt-Codex-Skills-5 as a PFC 5.0-only asphalt-mixture package, enforcing version purity, external fistPkg boundaries, portable assets, validation, and release hygiene.

The English summary is being prepared. Showing the original description.

Echo-aloha/asphalt-codex-skills-526Updated Aug 26, 2026

See all skills by Echo-aloha

Report a problem with this skill