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

references/script-catalog.md

View on GitHub
# PFC Postprocessing Script Catalog

This file is generated from the bundled Python scripts and is the first reference to read after `SKILL.md` when choosing a plotting route.

Hard rule: do not invent a plot from the prose description alone. Read the selected script before adapting or running it.

Scripts that call `_common.make_argument_parser(...)` also share these required/common arguments even if they are not repeated below:

- `--input-dir`: required directory containing input files.
- `--output-dir`: required directory to write outputs.
- `--case-name`: display name for titles; default `case`.
- `--stage`: stage label for output naming; default `final`.

## `convert_legacy_ball_export.py`

Convert legacy ball export text into a public ball-field CSV

Arguments:

- `--input-file`; required
- `--output-dir`; required

## `convert_legacy_contact_export.py`

Convert legacy PFC5 contact export text into a public orientation CSV

Arguments:

- `--input-file`; required
- `--output-dir`; required

## `export_animation.py`

Create GIF and optional MP4 from ordered PNG frames

Arguments:

- `--input-dir`; required
- `--output-dir`; required
- `--stem`; default `animation`
- `--fps`; default `4`
- `--write-mp4`

## `export_animation_frames.py`

Normalize animation frame names into frame_0001.png order

Arguments:

- `--input-dir`; required
- `--output-dir`; required
- `--glob`; default `*.png`

## `plot_curves.py`

Plot a public stress-strain figure from stress_strain.csv

Arguments:

- `--filename`; default `stress_strain.csv`

## `plot_fields.py`

Plot public field figures from standard CSV exports

Arguments:

- No command-line arguments detected; inspect the script before use.

## `plot_nature_ball_displacement_vectors.py`

Nature-style multi-panel ball displacement vector figure.

Arguments:

- `case`; default `Intact`
- `--thin`; default `1`. Plot every nth ball arrow; default 1 uses all balls.

## `plot_nature_ball_velocity_vectors.py`

Nature-style multi-panel ball velocity vector figure.

Arguments:

- `case`; default `Intact`
- `--thin`; default `1`. Plot every nth ball arrow; default 1 uses all balls.

## `plot_porosity_3d_surface_zhongguo.py`

Draw a smooth 3D porosity surface from plotdata_porosity.csv.

Arguments:

- `case_dir`; default `.`. Case directory containing plotdata_porosity.csv (default: current directory).
- `--csv`; default `plotdata_porosity.csv`. CSV filename or path. Relative paths are resolved under case_dir.
- `--prefix`; default `porosity_3d_surface_zhongguo`. Output prefix. Relative paths are resolved under case_dir.
- `--up`; default `8`. Bicubic upsampling factor.
- `--elev`; default `22.0`. 3D view elevation.
- `--azim`. 3D view azimuth.
- `--no-tiff`. Skip TIFF export.

## `plot_rutting_evidence.py`

Plot auditable rutting, vector-reaction, asymmetry and shear-depth evidence.

Arguments:

- `--history`; default `rutting_history.csv`
- `--shear-profile`; default `rutting_shear_profile.csv`; optional file
- `--check-only`; validate contracts without plotting dependencies or output writes

The script preserves signed vertical/horizontal reactions, checks monotonic solver/
equivalent time and pass counters, and writes a summary table. It does not compute a
normative dynamic-stability value.

## `plot_rose.py`

Plot a rose diagram from fracture or contact orientation data

Arguments:

- `--filename`. Optional explicit filename
- `--bins`; default `18`

## `plot_ucs_3d_surface_lollipop.py`

No argparse description found.

Arguments:

- No command-line arguments detected; inspect the script before use.

## `run_demo.py`

No argparse description found.

Arguments:

- No command-line arguments detected; inspect the script before use.
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: 119kUpdated 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: 119kUpdated 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