Skip to content

Echo-aloha/asphalt-codex-skills-5 / skills/pfc5-ae-energy

pfc5-ae-energy

Verified

Instrument and post-process PFC 5.0 asphalt damage studies using bond-break hits, clustered AE events, macro energy density, source fields, stage summaries, and auditable CSV outputs.

FileKindSize
SKILL.mdskill md2.6 KB
agents/openai.yamlconfig230 B
dependencies.jsonconfig114 B
references/ae-contract.mdmarkdown1.3 KB
scripts/ae_energy_metrics.pyscript2.2 KB
scripts/cluster_ae_events.pyscript3.4 KB
---
name: pfc5-ae-energy
description: Instrument and post-process PFC 5.0 asphalt damage studies using bond-break hits, clustered AE events, macro energy density, source fields, stage summaries, and auditable CSV outputs.
---

# PFC5 AE And Energy

Use this skill when a calibrated bonded/interface PFC5 asphalt model needs
damage timing, crack/AE hit statistics, event clustering, or macro energy curves.

## Required Inputs

- PFC2D/PFC3D 5.0, contact/bond failure law and event callback evidence;
- stress-strain CSV with units/sign;
- hit CSV with time, position, mode and optional force/tensor fields;
- clustering thresholds and loading-stage definitions;
- elastic modulus used by macro energy approximation.

## Workflow

1. Decide Level 1 hits, Level 2 clustered events, or a separately validated tensor route.
2. Prove PFC5 callback activation with a counter/history.
3. If native PFC energies are required, enable `set energy mechanical on` before the
   measured interval and inventory the partitions actually exposed by every active
   contact model. Export raw hits and stress-strain data without GUI-only transformations.
4. Cluster hits with `scripts/cluster_ae_events.py` when event catalogs are required.
5. Compute macro input/elastic/dissipated energy with
   `scripts/ae_energy_metrics.py`.
6. Tie events and figures to saved stages and preserve raw IDs.
7. Validate thresholds and mechanisms against experimental observations where available.

Read [ae-contract.md](references/ae-contract.md) before choosing classifications.

## Working Rules

- One bond break is a hit, not automatically one laboratory AE event.
- Macro stress-strain energy is not direct contact-energy release.
- PFC5 mechanical energy tracking is off by default, and the Burger model supplies no
  own energy partition. Missing native energy cannot be reconstructed from a later
  activation or silently replaced by the macro approximation.
- Do not claim moment-tensor mechanisms without the tensor construction and units.
- Keep scalar moment symbols distinct from tensor component names.
- Classification denominator and threshold must be defined together and used consistently.

## Output Contract

Return raw hit/event schemas, clustering parameters, energy method/units, stage
summaries, figures/tables, validation caveats and runtime status.

## Local Contents

- `references/ae-contract.md` — hit/event/energy definitions.
- `scripts/cluster_ae_events.py` — deterministic time-space clustering.
- `scripts/ae_energy_metrics.py` — macro energy-density computation.
- `agents/openai.yaml` — interface metadata.
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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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