Files
FemLite/examples/ball_adhesion_decohesion/README.md
T
2026-06-26 12:54:40 +08:00

2.1 KiB

Ball Adhesion/Decohesion Cohesive Benchmark

This folder contains the original ball adhesion/decohesion reference files, the older contact indentation smoke case, and a V5.7 cohesive adhesion/decohesion benchmark:

  • ball_adhesion_decohesion_params.txt
  • ball_adhesion_contact_smoke.inp
  • ball_adhesion_cohesive_benchmark.inp
  • check_cohesive_results.py
  • run_case.bat

The reference model uses a rubber membrane, a ball indenter, adhesive normal and shear stiffness, tensile/shear strength limits and energy-release criteria. The smoke input keeps the executable contact part of the benchmark in the main solver: a rubber-like C3D8 membrane pad, a stiffer ball surrogate, the documented 50 mm / 150 mm / 6 mm length scale, and a short explicit indentation that checks contact activation.

The cohesive benchmark is driven by tools/benchmarks/ball_adhesion_cohesive_benchmark.f90. It discretizes the circular ball/membrane adhesive zone into concentric rings and drives a compression, unloading and pull-off displacement history. Each ring uses the production fem_cohesive_law, fem_cohesive_state and fem_cohesive_metrics modules, so damage, maximum opening, dissipated energy and failed area are advanced through the same state helpers used by the core.

Outputs:

  • adhesion_history.csv: force-displacement history, pull/compression force, cumulative energy, maximum damage and failed fraction.
  • adhesion_summary.csv: peak pull-off force, compression force, dissipated energy, hysteresis area, decohesion area and final failed fraction.
  • decohesion_profile.csv: ring-level damage, maximum opening, energy and failed status.

Run:

run_case.bat

The smoke result is written to results\auto_run; cohesive benchmark results are written to results\cohesive.

CTest benchmark:

ctest --test-dir build-win-gcc-16 -C Release -R example_ball_adhesion_cohesive_benchmark --output-on-failure

The checker fails if cohesive damage does not activate, if pull-off force is missing, if dissipated energy decreases, or if the final profile does not show a nonzero decohesion area.