Echo-aloha/asphalt-codex-skills-5 / skills/pfc-postprocessing
pfc-postprocessing
VerifiedPost-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.
scripts/README.md
View on GitHub# Scripts
This directory is the executable core of the public `pfc-postprocessing` skill.
## Learning order
1. `run_demo.py`
2. `plot_curves.py`
3. `plot_fields.py`
4. `plot_rose.py`
5. `plot_rutting_evidence.py`
6. `export_animation_frames.py`
7. `export_animation.py`
8. `plot_porosity_3d_surface_zhongguo.py`
9. `plot_nature_ball_displacement_vectors.py`
10. `plot_nature_ball_velocity_vectors.py`
After that, read the legacy text-conversion helpers:
- `convert_legacy_contact_export.py`
- `convert_legacy_ball_export.py`
## What each script does
- `run_demo.py` — runs the public examples end to end
- `plot_curves.py` — draws a global response curve from `stress_strain.csv`
- `plot_fields.py` — draws displacement, velocity, stress, and porosity field figures
- `plot_rose.py` — draws a rose diagram from fracture or contact orientation data
- `plot_rutting_evidence.py` — checks and plots solver/equivalent time, signed vector
reactions, rut/heave/asymmetry and an optional tensor-defined shear-depth profile
- `export_animation_frames.py` — normalizes frame order and filenames
- `export_animation.py` — assembles GIF and optional MP4 outputs
- `convert_legacy_contact_export.py` — converts old contact text exports into a public CSV
- `convert_legacy_ball_export.py` — converts old ball text exports into a public CSV
- `plot_porosity_3d_surface_zhongguo.py` — draws a smooth 3D porosity surface from `plotdata_porosity.csv` using a Chinese-traditional sequential palette
## Public contract
- All scripts use directory-based inputs.
- No script depends on the author's local absolute paths.
- Old `.exe` utilities are not required.
- Proprietary project/save files must be exported to CSV or PNG in the licensed PFC 5.0 environment first.
- Outputs should land in `figures/`, `animations/`, `tables/`, or the requested case/output directory.
## Porosity 3D Surface
Use this when a case has `plotdata_porosity.csv` with `x`, `y`, and `porosity` columns:
```bash
python <SKILLS_ROOT>/pfc-postprocessing/scripts/plot_porosity_3d_surface_zhongguo.py Intact
```
Default outputs are written beside the CSV:
- `porosity_3d_surface_zhongguo.png`
- `porosity_3d_surface_zhongguo.svg`
- `porosity_3d_surface_zhongguo.pdf`
- `porosity_3d_surface_zhongguo.tiff`
## Displacement Vector Figure
Use this when a case has:
- `plotdata_ball_displacement_arrows_stage_A.csv`
- `plotdata_ball_displacement_arrows_stage_B.csv`
- `plotdata_ball_displacement_arrows_stage_C.csv`
- `plotdata_ball_displacement_arrows_stage_D.csv`
- `plotdata_ball_displacement_arrows_stage_peak.csv`
- `plotdata_ball_displacement_arrows_stage_final.csv`
Run:
```bash
python <SKILLS_ROOT>/pfc-postprocessing/scripts/plot_nature_ball_displacement_vectors.py <case-dir> --thin 2
```
Outputs:
- `nature_ball_displacement_vectors.png`
- `nature_ball_displacement_vectors.svg`
- `nature_ball_displacement_vectors.pdf`
- `nature_ball_displacement_vectors.tiff`
## Velocity Vector Figure
Use this when a case has:
- `plotdata_ball_velocity_arrows_stage_A.csv`
- `plotdata_ball_velocity_arrows_stage_B.csv`
- `plotdata_ball_velocity_arrows_stage_C.csv`
- `plotdata_ball_velocity_arrows_stage_D.csv`
- `plotdata_ball_velocity_arrows_stage_peak.csv`
- `plotdata_ball_velocity_arrows_stage_final.csv`
Run:
```bash
python <SKILLS_ROOT>/pfc-postprocessing/scripts/plot_nature_ball_velocity_vectors.py <case-dir> --thin 2
```
Outputs:
- `nature_ball_velocity_vectors.png`
- `nature_ball_velocity_vectors.svg`
- `nature_ball_velocity_vectors.pdf`
- `nature_ball_velocity_vectors.tiff`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| Agent Cost Reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |