Example gallery¶

This section maps core solver capabilities to runnable workflows in the repository, so users can quickly see the public examples that are supported today.

Representative results¶

The panels below are lightweight documentation thumbnails, not raw benchmark archives. They point to the same workflows listed in the sections that follow.

Start With These¶

Use the capability matrix before assuming a workflow status. Use the promoted example contract when adding or auditing a gallery entry.

Quasi-static fracture

Implicit AT1/AT2 crack-path workflows with comparison reports and standard run metadata.

Dynamic fracture

Explicit dynamics for impact, branching, and perforated-plate crack-growth benchmarks.

Microstructured media

Perforated-plate and heterogeneous fracture cases used for dataset and morphology studies.

Engineering outputs

Force-displacement, energy, convergence, lockfile, and visualization artifacts from reproducible runs.

Solid mechanics

Linear elastic, hyperelastic, and J2 mechanics examples backed by the same sparse-solve and material-update paths used by the solver.

Capability-first pathways¶

Quasi-static fracture¶

The quasi-static family is the production path for many literature comparisons.

• SENT / SENS / TPB / L-panel: benchmark configs under configs/benchmarks/quasistatic/ and comparison scripts in matching example directories.

• Run example: python -m phast run examples/quasistatic/notched_holed_plate/config.yaml --validate-only

• Expected outputs: config.yaml, run_lockfile.json, results.csv, plots. Run compare.py in examples/quasistatic/notched_holed_plate/ for benchmark-level pass/fail summary.

Explicit dynamics fracture¶

• Branching, impact, perforation, Kalthoff-Winkler: configs/benchmarks/dynamic/*.yaml plus matching run folders under examples/dynamic/*.

• B7 dynamic branching: examples/dynamic/B7_dynamic_crack_branching_comsol/config.yaml is the full-plate COMSOL cross-check.

• Benchmark workflow:

  1. Launch via python -m phast run <cfg>

  2. Run compare.py in the corresponding examples/dynamic/<case>/ directory.

  3. Save comparison artifacts (compare.txt, compare.png) in run folder.

Solid mechanics FEA¶

• python -m phast run examples/solid_mechanics_beta/linear_plate/config.yaml Linear elastic plate FEA with displacement, stress, deformed-shape, response, and visual-manifest outputs.

• python -m phast run examples/solid_mechanics_beta/neohookean_plate/config.yaml Nonlinear neo-Hookean cantilever FEA with Newton convergence and final-state field outputs.

• python -m phast run examples/solid_mechanics_beta/j2_bar/config.yaml Mesh-level J2 plasticity bar FEA with von Mises and equivalent-plastic-strain fields.

Beta plasticity, cohesive, and PF-CZM validation¶

• J2 plasticity and ductile PF-plasticity: examples/plasticity_interface_beta/run_j2_validation.py and examples/plasticity_interface_beta/run_ductile_pf_plasticity_validation.py.

• Cohesive/interface benchmarks: mode-I jump, mixed-mode, contact-compression, delamination patch, structural DCB, diffuse-interface, and coupled PF-cohesive validation workflows live under examples/plasticity_interface_beta/.

• Manifested reproduction set: configs/benchmarks/plasticity_interface/reproducibility_contracts.yaml.

• Generated visual outputs: the scripts write *.png, manifest metadata, and summaries into their chosen output directories. These are beta validation artifacts until the nonlinear production gates in the capability matrix are closed.

Benchmark Catalogue¶

YAML-driven benchmark configurations live under configs/benchmarks/. Runnable public examples carry their config.yaml files directly in examples/. Prefer the example-local command when a case is promoted, because the folder also contains the README, setup image, result visuals, and postprocessing scripts expected by the public example contract.

Use python -m phast run <config.yaml> --validate-only to parse and schema-check a benchmark without running the solve. The full YAML schema is documented in configs/REFERENCE.yaml.

Quasi-static Benchmarks¶

Miehe tension is already promoted as an example-local YAML workflow under examples/quasistatic/miehe_tension/. Older Miehe shear and three-point bending variants should stay outside the gallery until they satisfy the same flat YAML, manifest, and visualization contract.

Dynamic Benchmarks¶

Acceptance Checks¶

Each promoted benchmark example may ship a local compare.py. Run it manually after the simulation completes; it loads the run output and reference data, then writes comparison artifacts into the run directory. The acceptance metric is case-specific: examples include peak load, load-displacement envelope error, branching onset time, final crack-path morphology, and required-output checks.

For load-displacement comparisons, configure the reaction writer explicitly:

output:
  reaction_node_set: <named_node_set>
  reaction_component: 1  # 0=x, 1=y

The benchmark command should not be the only record of a claim. Keep the validated configuration, lockfile, metadata, histories, retained visuals, and comparison output together with the example or run artifact.

Capability boundaries¶

For current non-hardened features, review Capability matrix. This doc is also the source of truth for what can be promised publicly.

Sparse direct vs CG inner solve¶

Driver: sparse_solve. Speedup is wall-time of the sparse direct path versus the matrix-free CG inner-solve path on the same mesh, tolerance, backend stack, and output settings. See Performance and Reproducibility for the reporting checklist before publishing numbers.