Release FemLite 0.6.3
FemLite CI / build-test (push) Has been cancelled

This commit is contained in:
shenw
2026-07-02 12:40:31 +08:00
parent ee18a9b757
commit 3d009d021e
197 changed files with 4027 additions and 46170 deletions
@@ -1,52 +1,32 @@
# contact_two_blocks_compression
# 两块体非匹配压缩接触 benchmark
V5.3 nonmatching face-to-face mortar contact benchmark for two C3D8 elastic
blocks.
文档状态:0.6.3 文档整理稿
Purpose:
## 用途
- Exercise nonmatching slave/master face contact with explicit face labels.
- Exercise contact property inheritance through `*SURFACE INTERACTION`.
- Exercise active-set, mortar-weighted gap and augmented-penalty multiplier
diagnostics.
- Provide the compact two-body pressure-profile benchmark used by CTest.
本目录保存 FemLite 示例或 benchmark:`contact_two_blocks_compression`。它用于验证指定模型、算法路径或输出检查器,不代表所有相近工程问题都已完整生产化。
Model:
## 主要输入文件
- Lower block: 0.10 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 on the contact face.
- The upper block starts with 0.001 m initial penetration into the lower top
face so contact is active immediately after the first force evaluation.
- Lower bottom face is fixed in z; all nodes are fixed in x/y.
- Upper top face is prescribed downward by 0.004 m over 1.0E-3 s.
- Contact property: penalty = 1.0E7, damping = 1.0E2, augment = 0.20.
System.Object[]
Run from the repository root:
## 运行方式
Double-click `run_case.bat` in this directory, or run manually:
- Windows 下可双击或执行 `run_case.bat`。
- 若该示例已接入 CTest,优先使用项目测试计划中记录的 CTest 名称运行。
- 运行前请先完成项目编译。
```powershell
New-Item -ItemType Directory -Force examples\contact_two_blocks_compression\results | Out-Null
build-win-gcc-16\femlite.exe examples\contact_two_blocks_compression\two_blocks_compression.inp --output-dir examples\contact_two_blocks_compression\results --output-interval 10 --run
```
## 检查脚本
Check:
System.Object[]
```powershell
.\Python\.venv\Scripts\python.exe examples\contact_two_blocks_compression\check_contact_results.py examples\contact_two_blocks_compression\results
```
## 结果文件
The checker verifies active contact, at least four contributing master facets,
positive augmented multiplier history, bounded contact pressure, bounded
mortar-weighted penetration and VTK output. It also writes
`pressure_profile.csv` in the result directory with one row per contact output
sample.
- 结果通常写入 `results`、`results/auto_run` 或命令指定的输出目录。
- 不要提交全量 CSV、VTK、restart、临时网格或缓存文件。
- 如需保留参考结果,只保留小型 summary、profile 或 checker 需要的抽样数据。
0.5.3 diagnostic checks also consume contact state/status fields, activation
and release counts, active-set flip count, augmentation factor/lambda,
failed projection count, mean gap and L2 gap. The numerical checks emphasize
existence, sign, boundedness and internal consistency rather than exact
large-path nonlinear matching.
## 边界
The double-click script writes repeatable output to `results\auto_run`.
- 示例和 benchmark 是受控验收入口,不等同于完整工业级流程。
- 若修改输入、checker 或参考容差,应同步更新 `docs/11_benchmark_matrix.md`。