Skip to content

Echo-aloha/asphalt-codex-skills-5 / skills/pfc-postprocessing

pfc-postprocessing

Verified

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.

FileKindSize
LICENSEother1.1 KB
NOTICE.mdmarkdown725 B
SKILL.mdskill md4.4 KB
agents/openai.yamlconfig300 B
examples/README.mdmarkdown379 B
examples/animation_case/README.mdmarkdown811 B
examples/animation_case/raw_frames/jieguo_1.pngbinary1.3 KB
examples/animation_case/raw_frames/jieguo_2.pngbinary1.4 KB
examples/animation_case/raw_frames/jieguo_3.pngbinary1.4 KB
examples/animation_case/raw_frames/jieguo_4.pngbinary1.3 KB
examples/animation_case/raw_frames/jieguo_5.pngbinary1.4 KB
examples/animation_case/raw_frames/jieguo_6.pngbinary1.4 KB
examples/animation_case/raw_frames/jieguo_7.pngbinary1.4 KB
examples/animation_case/raw_frames/jieguo_8.pngbinary1.4 KB
examples/minimal_case/README.mdmarkdown871 B
examples/minimal_case/data/plotdata_ball_fields.csvother334 B
examples/minimal_case/data/plotdata_fracture_orientations.csvother117 B
examples/minimal_case/data/plotdata_porosity.csvother100 B
examples/minimal_case/data/plotdata_stress.csvother188 B
examples/minimal_case/data/rutting_history.csvother786 B
examples/minimal_case/data/rutting_shear_profile.csvother577 B
examples/minimal_case/data/stress_strain.csvother95 B
examples/plugin_migration_case/legacy_ball_export.datother127 B
examples/plugin_migration_case/legacy_contact_export.txtmarkdown222 B
references/animation-workflow.mdmarkdown633 B
references/data-contract.mdmarkdown2.5 KB
references/overview.mdmarkdown1.6 KB
references/plugin-migration.mdmarkdown1.6 KB
references/script-catalog.mdmarkdown3.6 KB
references/ucs-3d-surface-lollipop.mdmarkdown4.7 KB
scripts/README.mdmarkdown3.5 KB
scripts/_common.pyscript1.9 KB
scripts/convert_legacy_ball_export.pyscript1.4 KB
scripts/convert_legacy_contact_export.pyscript1.5 KB
scripts/export_animation.pyscript1.4 KB
scripts/export_animation_frames.pyscript1.3 KB
scripts/plot_curves.pyscript2.3 KB
scripts/plot_fields.pyscript3.8 KB
scripts/plot_nature_ball_displacement_vectors.pyscript5.9 KB
scripts/plot_nature_ball_velocity_vectors.pyscript5.3 KB
scripts/plot_porosity_3d_surface_zhongguo.pyscript6.7 KB
scripts/plot_rose.pyscript1.9 KB
scripts/plot_rutting_evidence.pyscript7.1 KB
scripts/plot_ucs_3d_surface_lollipop.pyscript9.1 KB
scripts/run_demo.pyscript5.5 KB

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`
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall
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: 118kUpdated Claude CodeCodexVerifiedInstall