Files
FemLite/examples/contact_block_sliding
shenw 2b7962eb96
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.5.3
2026-07-01 18:39:18 +08:00
..
2026-07-01 18:39:18 +08:00
2026-07-01 18:39:18 +08:00
2026-06-26 12:54:40 +08:00

contact_block_sliding

V5.3 nonmatching large-sliding mortar-friction benchmark for two elastic C3D8 blocks.

Purpose:

  • Exercise face-to-face contact with Coulomb friction over multiple master facets.
  • Exercise FRICTION_REGULARIZATION inheritance from *SURFACE INTERACTION.
  • Check contact CSV friction work, accumulated slip, stick/slip counters, tangential force output and active search statistics.
  • Provide the compact large-sliding benchmark used by CTest.

Model:

  • Lower block: 0.40 m x 0.10 m x 0.05 m, split into four C3D8 elements on the contact face.
  • Upper block: 0.10 m x 0.10 m x 0.05 m, one C3D8 element starting near the left side of the lower master surface.
  • The upper block starts with 0.001 m initial penetration into the lower block.
  • The lower block is fixed, while the upper block is driven by a horizontal nodal force and compressed by the prescribed top-face z displacement.
  • Contact property: penalty = 1.0E7, damping = 1.0E2, friction = 0.30, friction regularization = 1.0E-4, augment = 0.20.

Run from the repository root:

Double-click run_case.bat in this directory, or run manually:

New-Item -ItemType Directory -Force examples\contact_block_sliding\results | Out-Null
build-win-gcc-16\femlite.exe examples\contact_block_sliding\block_sliding_friction.inp --output-dir examples\contact_block_sliding\results --output-interval 10 --run

Check:

.\Python\.venv\Scripts\python.exe examples\contact_block_sliding\check_contact_results.py examples\contact_block_sliding\results

The double-click script writes repeatable output to results\auto_run.

The checker verifies active contact on multiple candidates, four available master facets, accumulated sliding, stick/slip counters, positive frictional work, nonzero tangential force and VTK output. It also writes sliding_profile.csv in the result directory for benchmark inspection.

0.5.3 diagnostic checks also consume contact state/status fields, activation/release counts, active-set flip count, gap L2, failed projection count, augmentation factor/lambda, slip increment/residual and friction residual fields. These checks are diagnostic guards, not a retuning of the friction law.