PFC 5 Asphalt Post-processing
Use this skill after a PFC 5.0 asphalt run has exported CSV data or ordered image frames. It is intentionally file-based: no newer-version object API or saved-state bridge is bundled.
When To Use
- plot stress-strain, Marshall load-flow, creep/recovery, or rut-depth curves;
- audit intersection-rutting time maps, vertical/horizontal reaction tracking,
face-deformation asymmetry, lateral heave and shear-depth profiles;
- render displacement, velocity, stress, or porosity fields;
- draw fracture/contact orientation rose diagrams;
- order exported PNG frames and assemble GIF/MP4 animations;
- convert the bundled legacy text exports into stable CSV contracts;
- generate summary tables and publication-ready figures.
Use pfc-vedo-postprocess for 3D particle/force-chain scenes. Return physical interpretation and acceptance decisions to pfc5-asphalt-workflow.
Required Inputs
- case/test name, PFC2D/PFC3D 5.0, units, and stage;
- actual exported files and column meanings;
- requested plots/tables and output formats;
- sign conventions, coordinate scaling, and any smoothing/transformation rule;
- standard edition if a normative test metric is requested.
- for a surrogate rutting case, the signed coordinate/tensor convention, physical-to-
solver time map, reaction commands, boundary case and measure-region definition.
Script-First Workflow
- Read
references/script-catalog.md and the selected script.
- Validate inputs against
references/data-contract.md.
- Preserve raw values; write transformed values to separate columns and disclose the rule.
- Run the smallest matching script before adapting it.
- Save source data, figure outputs, summary tables, and the exact command.
- Confirm units, peak/rut/flow calculation, frame order, and file existence.
Router
| Need |
Script |
| global curve and peak summary |
scripts/plot_curves.py |
| rut/time/vector-reaction/asymmetry/shear evidence |
scripts/plot_rutting_evidence.py |
| particle/stress/porosity fields |
scripts/plot_fields.py |
| orientation rose diagram |
scripts/plot_rose.py |
| normalize image-frame order |
scripts/export_animation_frames.py |
| build GIF/MP4 |
scripts/export_animation.py |
| legacy ball/contact text to CSV |
scripts/convert_legacy_*_export.py |
| public smoke test |
scripts/run_demo.py |
The public demo uses deterministic CSV files under examples/minimal_case/data/ and does not require PFC:
python scripts/run_demo.py
Validate only the bundled inputs when plotting dependencies are unavailable:
python scripts/run_demo.py --check-only
Working Rules
- Do not infer missing columns or units silently.
- Do not derive normative Marshall/车辙 metrics without the selected standard formula and coefficients.
- Do not replace equivalent physical time with solver time or solver cycles. Preserve
all three columns and the declared
lambda convention.
- Keep vertical/horizontal command and signed reaction separate. A friction-demand
ratio, contact friction and measured reaction ratio are different quantities.
- A shear profile must retain tensor component, axes/sign, measure radius, weighting,
overlap and sampling state; do not plot an undefined absolute “shear stress”.
- Keep seven-position/approved normative deformation separate from deepest rut,
face asymmetry and lateral-heave diagnostics.
- Keep global color limits fixed across animation frames.
- Treat screenshots as presentation outputs, not numerical source data.
- Keep output directories user-selected for production work; the demo alone may recreate its own
examples/demo_outputs/.
Output Contract
Deliver the input manifest, units/sign conventions, command used, source/transformation table, requested figures/animations, metric summary, and any pending physical or standard-validation gate.
Local Contents
references/data-contract.md — stable CSV contracts.references/script-catalog.md — executable route map.references/animation-workflow.md — frame ordering and animation rules.examples/minimal_case/data/ — deterministic public demo data.scripts/ — executable post-processing tools.LICENSE and NOTICE.md — retained MIT terms and upstream provenance.
1---2name: pfc-postprocessing3description: 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.4---56# PFC 5 Asphalt Post-processing78Use this skill after a PFC 5.0 asphalt run has exported CSV data or ordered image frames. It is intentionally file-based: no newer-version object API or saved-state bridge is bundled.910## When To Use1112- plot stress-strain, Marshall load-flow, creep/recovery, or rut-depth curves;13- audit intersection-rutting time maps, vertical/horizontal reaction tracking,14 face-deformation asymmetry, lateral heave and shear-depth profiles;15- render displacement, velocity, stress, or porosity fields;16- draw fracture/contact orientation rose diagrams;17- order exported PNG frames and assemble GIF/MP4 animations;18- convert the bundled legacy text exports into stable CSV contracts;19- generate summary tables and publication-ready figures.2021Use `pfc-vedo-postprocess` for 3D particle/force-chain scenes. Return physical interpretation and acceptance decisions to `pfc5-asphalt-workflow`.2223## Required Inputs2425- case/test name, PFC2D/PFC3D 5.0, units, and stage;26- actual exported files and column meanings;27- requested plots/tables and output formats;28- sign conventions, coordinate scaling, and any smoothing/transformation rule;29- standard edition if a normative test metric is requested.30- for a surrogate rutting case, the signed coordinate/tensor convention, physical-to-31 solver time map, reaction commands, boundary case and measure-region definition.3233## Script-First Workflow34351. Read `references/script-catalog.md` and the selected script.362. Validate inputs against `references/data-contract.md`.373. Preserve raw values; write transformed values to separate columns and disclose the rule.384. Run the smallest matching script before adapting it.395. Save source data, figure outputs, summary tables, and the exact command.406. Confirm units, peak/rut/flow calculation, frame order, and file existence.4142## Router4344| Need | Script |45| --- | --- |46| global curve and peak summary | `scripts/plot_curves.py` |47| rut/time/vector-reaction/asymmetry/shear evidence | `scripts/plot_rutting_evidence.py` |48| particle/stress/porosity fields | `scripts/plot_fields.py` |49| orientation rose diagram | `scripts/plot_rose.py` |50| normalize image-frame order | `scripts/export_animation_frames.py` |51| build GIF/MP4 | `scripts/export_animation.py` |52| legacy ball/contact text to CSV | `scripts/convert_legacy_*_export.py` |53| public smoke test | `scripts/run_demo.py` |5455The public demo uses deterministic CSV files under `examples/minimal_case/data/` and does not require PFC:5657```bash58python scripts/run_demo.py59```6061Validate only the bundled inputs when plotting dependencies are unavailable:6263```bash64python scripts/run_demo.py --check-only65```6667## Working Rules6869- Do not infer missing columns or units silently.70- Do not derive normative Marshall/车辙 metrics without the selected standard formula and coefficients.71- Do not replace equivalent physical time with solver time or solver cycles. Preserve72 all three columns and the declared `lambda` convention.73- Keep vertical/horizontal command and signed reaction separate. A friction-demand74 ratio, contact friction and measured reaction ratio are different quantities.75- A shear profile must retain tensor component, axes/sign, measure radius, weighting,76 overlap and sampling state; do not plot an undefined absolute “shear stress”.77- Keep seven-position/approved normative deformation separate from deepest rut,78 face asymmetry and lateral-heave diagnostics.79- Keep global color limits fixed across animation frames.80- Treat screenshots as presentation outputs, not numerical source data.81- Keep output directories user-selected for production work; the demo alone may recreate its own `examples/demo_outputs/`.8283## Output Contract8485Deliver the input manifest, units/sign conventions, command used, source/transformation table, requested figures/animations, metric summary, and any pending physical or standard-validation gate.8687## Local Contents8889- `references/data-contract.md` — stable CSV contracts.90- `references/script-catalog.md` — executable route map.91- `references/animation-workflow.md` — frame ordering and animation rules.92- `examples/minimal_case/data/` — deterministic public demo data.93- `scripts/` — executable post-processing tools.94- `LICENSE` and `NOTICE.md` — retained MIT terms and upstream provenance.
Echo-aloha