Files
FemLite/examples/contact_block_sliding/README.md
T
shenw 2b7962eb96
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.5.3
2026-07-01 18:39:18 +08:00

54 lines
2.2 KiB
Markdown

# 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:
```powershell
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:
```powershell
.\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.