依据 Nathan Shauer,“Less than 500 lines self-contained Python finite element implementation of the phase-field method for fracture mechanics”, Advances in Engineering Software (2025), doi:10.1016/j.advengsoft.2025.104013.
- 对照作者的代码
- 30 / 30 项检查通过· 查看检查
- 对照论文的图
- 与作者 Python 参考输出(提交 61037c6)以及 1D AT2 杆解进行了比较。图中显示的是我们求解器的结果;力曲线图中还包含 Python 参考值。这些比较不能证明与文章中印出的图一致。
研究,不是设计工具。此处的任何内容都不是工程结果。
一块方形板,切口从左边缘延伸到中心,在顶部被拉开。AT2 相场模型把裂纹表示为取值在 0(完好)与 1(断裂)之间的损伤场 d,并弥散在长度 ℓ 范围内。试验面板在 Stabileo 的查看器中运行 Stabileo 的 Rust 实现;橙色曲线是作者的 Python 代码算出的结果。
论文展示的内容
参考代码仓库提供了 AT2 断裂的 Python 有限元实现,含三个算例:受拉杆、带切口板和三点弯曲。本页的方法和比较均指该代码的提交 61037c6。
在回放中,损伤在切口前方平滑扩展,而 起初几乎线性上升,随后软化,趋向 ;在下一个增量步, ,经过 ,力降到几乎为零。 显示了变形板上张开的裂纹。
模型
位移 u 和损伤 d 在四边形上均为双线性,采用 2×2 高斯点积分;平面应变、小应变、准静态加载。
- 弹性 在固定 d 下:div(g(d) C : ε(u)) = 0,其中 g(d) = (1 − d)²,作用于整个应力。
- 损伤 (AT2) 在固定 u: (Gc/ℓ + 2H) d − Gc ℓ Δd = 2H.
- 驱动能: H = ψ+ = ½ Σ σi εi 对正主应变求和,其中 σi 为未受损的主应力。这种参考代码的混合分解会使整个弹性应力退化。在混合应变状态下,正的主应变可能对应负的应力,从而得到负的驱动能,并可能产生负的损伤。历史模式把驱动能限制为其先前最大值(非负);它不对节点损伤施加界限。
- 交替求解 每个荷载步:求解 u (用当前的 d),再求解 d(用新的 u),直到弹性残差 ‖K(d)u − f‖ 小于 10−5.
- 不可逆性:参考代码中没有;损伤由当前能量重新计算,且不以 1 为界。 以便卸载时保持损伤(参考代码中没有)。
单位为 kN 和 mm。1D 单轴应力 AT2 估计值 σc = √(27 E Gc / 256 ℓ) ≈ 2.82 kN/mm²,因此 ℓ 既是强度参数,也是正则化长度: 峰值荷载就会下降。网格也很重要:裂纹带需要比 ℓ 小几倍的单元; .
我们如何复现
- 作者的代码(提交 61037c6,MIT 许可)在 Python 3.12.15、numpy 2.1.3 和 scipy 1.14.1 下未经修改地运行了其三个算例;每一步的力、迭代次数、残差和损伤范围,以及选定步的节点场,连同版本和校验和清单一并保存。
- Rust 实现重新生成相同的网格(逐位一致),采用相同的边界条件、循环和停止准则,并用 Stabileo 计算引擎的稀疏 Cholesky 分解求解。
- 30 项命名检查对两者进行比较,每项均有明确的容差,在持续集成中运行。本页的浏览器包和回放另外与原生构建核对。
与参考值的比较
| 检查 | 观测值 | 容差 | 结果 |
|---|---|---|---|
| 1 · 网格指纹 | 相同 | — 精确 | ✓ 通过 |
| 1 · 荷载步数 | 相同 | — 精确 | ✓ 通过 |
| 1 · 每一步的迭代次数 | 相同 | — 精确 | ✓ 通过 |
| 1 · 每一步的最大损伤 | 8.3 × 10−12 | 1 × 10−9 相对差异 | ✓ 通过 |
| 1 · 每一步的中心应力 | 1.1 × 10−12 | 1 × 10−9 |Δσ| / σc | ✓ 通过 |
| 1 · 节点损伤 · 步 50 | 4.5 × 10−10 | 1 × 10−8 max |Δd| | ✓ 通过 |
| 1 · 节点损伤 · 步 73 | 3.8 × 10−10 | 1 × 10−8 max |Δd| | ✓ 通过 |
| 1 · 节点位移 · 步 50 | 1.6 × 10−10 | 1 × 10−8 max |Δu| / max |u| | ✓ 通过 |
| 1 · 中心应力 / 一维 AT2 解,max d < 0.25 | 7.3 × 10−5 | 1 × 10−3 |Δσ| / σc | ✓ 通过 |
| 2 · 网格指纹 | 相同 | — 精确 | ✓ 通过 |
| 2 · 荷载步数 | 相同 | — 精确 | ✓ 通过 |
| 2 · 每一步的迭代次数 | 相同 | — 精确 | ✓ 通过 |
| 2 · 峰值力所在步 | 相同 | — 精确 | ✓ 通过 |
| 2 · 峰值力 | 1.2 × 10−12 | 1 × 10−9 相对差异 | ✓ 通过 |
| 2 · 直至峰值的力 | 1.6 × 10−12 | 1 × 10−9 相对差异 | ✓ 通过 |
| 2 · 直至峰值的最大损伤 | 4.2 × 10−12 | 1 × 10−9 相对差异 | ✓ 通过 |
| 2 · 含断裂阶段的力 | 2.2 × 10−7 | 1 × 10−5 |ΔF| (kN) | ✓ 通过 |
| 2 · 节点损伤 · 步 56 | 5 × 10−11 | 1 × 10−8 max |Δd| | ✓ 通过 |
| 2 · 节点位移 · 步 56 | 8.5 × 10−11 | 1 × 10−8 max |Δu| / max |u| | ✓ 通过 |
| 2 · 节点损伤,参考值或镜像 · 步 57 | 2.9 × 10−5 | 1 × 10−4 max |Δd| | ✓ 通过 |
| 2 · 节点损伤,参考值或镜像 · 步 78 | 3.1 × 10−10 | 1 × 10−8 max |Δd| | ✓ 通过 |
| 3 · 网格指纹 | 相同 | — 精确 | ✓ 通过 |
| 3 · 荷载步数 | 相同 | — 精确 | ✓ 通过 |
| 3 · 每一步的迭代次数 | 相同 | — 精确 | ✓ 通过 |
| 3 · 峰值力所在步 | 相同 | — 精确 | ✓ 通过 |
| 3 · 直至峰值的力 | 4 × 10−11 | 1 × 10−9 相对差异 | ✓ 通过 |
| 3 · 含断裂阶段的力 | 1 × 10−6 | 1 × 10−4 |ΔF| (kN) | ✓ 通过 |
| 3 · 节点损伤 · 步 56 | 6.9 × 10−11 | 1 × 10−8 max |Δd| | ✓ 通过 |
| 3 · 节点位移 · 步 56 | 1.1 × 10−10 | 1 × 10−8 max |Δu| / max |u| | ✓ 通过 |
| 3 · 节点损伤,参考值或镜像 · 步 98 | 4.1 × 10−10 | 1 × 10−8 max |Δd| | ✓ 通过 |
由于舍入误差,裂纹可能选择切口平面的任一侧。最终损伤与镜像后参考值的差异为 3.09 × 10−10。表中的阈值是比较容差,不是数学上的误差界限。位移场的比较取算例 1 第 50 步、算例 2 第 56 步和算例 3 第 56 步。 第 57 步的损伤容差取 1e-4,因为裂纹在一个增量步内贯穿整块板;稳定后的场取 1e-8。这些是比较阈值,不是误差界限。
步骤表(79 步)
| 步 | 顶部位移 u (mm) | 力 F (kN) | 次迭代 | 残差 | 最大损伤 | 弹性能 (kN·mm) | 断裂能 Gc·Γ (kN·mm) | 参考 F,kN |
|---|---|---|---|---|---|---|---|---|
| 0 | 0.00010 | 0.01345287 | 1 | 2.8 × 10−8 | 0.0001 | 0.0000006726407 | 0.000000000005020209 | 0.01345287 |
| 1 | 0.00020 | 0.02690475 | 1 | 1.7 × 10−7 | 0.0004 | 0.000002690442 | 0.00000000008031908 | 0.02690475 |
| 2 | 0.00030 | 0.04035443 | 1 | 4.3 × 10−7 | 0.0009 | 0.00000605304 | 0.0000000004065996 | 0.04035443 |
| 3 | 0.00040 | 0.0538007 | 1 | 7.9 × 10−7 | 0.0016 | 0.00001075983 | 0.000000001285025 | 0.0538007 |
| 4 | 0.00050 | 0.06724236 | 1 | 1.3 × 10−6 | 0.0024 | 0.00001680997 | 0.000000003137237 | 0.06724236 |
| 5 | 0.00060 | 0.08067819 | 1 | 1.9 × 10−6 | 0.0035 | 0.00002420236 | 0.000000006505409 | 0.08067819 |
| 6 | 0.00070 | 0.09410698 | 1 | 2.6 × 10−6 | 0.0048 | 0.00003293568 | 0.00000001205232 | 0.09410698 |
| 7 | 0.00080 | 0.1075275 | 1 | 3.4 × 10−6 | 0.0063 | 0.00004300835 | 0.00000002056145 | 0.1075275 |
| 8 | 0.00090 | 0.1209386 | 1 | 4.4 × 10−6 | 0.0079 | 0.00005441856 | 0.00000003293714 | 0.1209386 |
| 9 | 0.00100 | 0.134339 | 1 | 5.5 × 10−6 | 0.0098 | 0.00006716425 | 0.00000005020477 | 0.134339 |
| 10 | 0.00110 | 0.1477276 | 1 | 6.7 × 10−6 | 0.0119 | 0.00008124311 | 0.00000007351096 | 0.1477276 |
| 11 | 0.00120 | 0.161103 | 1 | 8 × 10−6 | 0.0142 | 0.0000966526 | 0.0000001041238 | 0.161103 |
| 12 | 0.00130 | 0.1744642 | 1 | 9.4 × 10−6 | 0.0166 | 0.0001133899 | 0.0000001434334 | 0.1744642 |
| 13 | 0.00140 | 0.1877887 | 2 | 3.5 × 10−7 | 0.0194 | 0.0001314519 | 0.0000001931542 | 0.1877887 |
| 14 | 0.00150 | 0.2011143 | 2 | 4.5 × 10−7 | 0.0223 | 0.0001508354 | 0.0000002546024 | 0.2011143 |
| 15 | 0.00160 | 0.2144218 | 2 | 5.9 × 10−7 | 0.0255 | 0.000171537 | 0.0000003296798 | 0.2144218 |
| 16 | 0.00170 | 0.2277098 | 2 | 7.6 × 10−7 | 0.0289 | 0.0001935527 | 0.0000004202749 | 0.2277098 |
| 17 | 0.00180 | 0.2409771 | 2 | 9.6 × 10−7 | 0.0324 | 0.0002168786 | 0.0000005284013 | 0.2409771 |
| 18 | 0.00190 | 0.2542226 | 2 | 1.2 × 10−6 | 0.0362 | 0.0002415104 | 0.0000006561995 | 0.2542226 |
| 19 | 0.00200 | 0.267445 | 2 | 1.5 × 10−6 | 0.0403 | 0.0002674436 | 0.0000008059377 | 0.267445 |
| 20 | 0.00210 | 0.2806429 | 2 | 1.8 × 10−6 | 0.0446 | 0.0002946734 | 0.0000009800127 | 0.2806429 |
| 21 | 0.00220 | 0.2938153 | 2 | 2.2 × 10−6 | 0.0491 | 0.0003231946 | 0.000001180952 | 0.2938153 |
| 22 | 0.00230 | 0.3069608 | 2 | 2.7 × 10−6 | 0.0539 | 0.0003530022 | 0.000001411415 | 0.3069608 |
| 23 | 0.00240 | 0.3200782 | 2 | 3.2 × 10−6 | 0.0589 | 0.0003840904 | 0.000001674196 | 0.3200782 |
| 24 | 0.00250 | 0.3331662 | 2 | 3.8 × 10−6 | 0.0641 | 0.0004164535 | 0.000001972225 | 0.3331662 |
| 25 | 0.00260 | 0.3462235 | 2 | 4.5 × 10−6 | 0.0697 | 0.0004500854 | 0.00000230857 | 0.3462235 |
| 26 | 0.00270 | 0.3592489 | 2 | 5.3 × 10−6 | 0.0755 | 0.0004849797 | 0.000002686445 | 0.3592489 |
| 27 | 0.00280 | 0.372241 | 2 | 6.1 × 10−6 | 0.0816 | 0.0005211298 | 0.000003109206 | 0.372241 |
| 28 | 0.00290 | 0.3851986 | 2 | 7.1 × 10−6 | 0.0880 | 0.0005585288 | 0.000003580361 | 0.3851986 |
| 29 | 0.00300 | 0.3981203 | 2 | 8.3 × 10−6 | 0.0947 | 0.0005971694 | 0.000004103572 | 0.3981203 |
| 30 | 0.00310 | 0.4110048 | 2 | 9.6 × 10−6 | 0.1017 | 0.0006370443 | 0.000004682662 | 0.4110048 |
| 31 | 0.00320 | 0.4238411 | 3 | 2 × 10−6 | 0.1092 | 0.0006781436 | 0.000005323662 | 0.4238411 |
| 32 | 0.00330 | 0.4366456 | 3 | 2.4 × 10−6 | 0.1168 | 0.0007204625 | 0.000006027212 | 0.4366456 |
| 33 | 0.00340 | 0.4494086 | 3 | 2.9 × 10−6 | 0.1249 | 0.0007639913 | 0.000006799272 | 0.4494086 |
| 34 | 0.00350 | 0.4621286 | 3 | 3.5 × 10−6 | 0.1333 | 0.0008087209 | 0.000007644422 | 0.4621286 |
| 35 | 0.00360 | 0.4748041 | 3 | 4.3 × 10−6 | 0.1421 | 0.0008546423 | 0.000008567453 | 0.4748041 |
| 36 | 0.00370 | 0.4874337 | 3 | 5.1 × 10−6 | 0.1513 | 0.0009017459 | 0.000009573385 | 0.4874337 |
| 37 | 0.00380 | 0.5000156 | 3 | 6.2 × 10−6 | 0.1609 | 0.0009500217 | 0.00001066749 | 0.5000156 |
| 38 | 0.00390 | 0.5125483 | 3 | 7.4 × 10−6 | 0.1710 | 0.0009994594 | 0.00001185533 | 0.5125483 |
| 39 | 0.00400 | 0.52503 | 3 | 8.9 × 10−6 | 0.1816 | 0.001050048 | 0.00001314277 | 0.52503 |
| 40 | 0.00410 | 0.537452 | 4 | 3.3 × 10−6 | 0.1929 | 0.001101772 | 0.00001453996 | 0.537452 |
| 41 | 0.00420 | 0.5498249 | 4 | 4.1 × 10−6 | 0.2046 | 0.001154627 | 0.00001604682 | 0.5498249 |
| 42 | 0.00430 | 0.562141 | 4 | 5.1 × 10−6 | 0.2170 | 0.001208596 | 0.00001767348 | 0.562141 |
| 43 | 0.00440 | 0.574398 | 4 | 6.5 × 10−6 | 0.2299 | 0.001263667 | 0.00001942766 | 0.574398 |
| 44 | 0.00450 | 0.5865935 | 4 | 8.2 × 10−6 | 0.2437 | 0.001319824 | 0.00002131774 | 0.5865935 |
| 45 | 0.00460 | 0.5987187 | 5 | 4.2 × 10−6 | 0.2584 | 0.001377047 | 0.00002335834 | 0.5987187 |
| 46 | 0.00470 | 0.6107814 | 5 | 5.5 × 10−6 | 0.2739 | 0.001435329 | 0.00002555083 | 0.6107814 |
| 47 | 0.00480 | 0.6227733 | 5 | 7.4 × 10−6 | 0.2903 | 0.001494646 | 0.0000279108 | 0.6227733 |
| 48 | 0.00490 | 0.6346904 | 5 | 9.9 × 10−6 | 0.3080 | 0.001554977 | 0.00003045171 | 0.6346904 |
| 49 | 0.00500 | 0.6465205 | 6 | 6.8 × 10−6 | 0.3272 | 0.001616292 | 0.0000331988 | 0.6465205 |
| 50 | 0.00510 | 0.65827 | 6 | 9.7 × 10−6 | 0.3479 | 0.001678574 | 0.00003615699 | 0.65827 |
| 51 | 0.00520 | 0.6699181 | 7 | 8 × 10−6 | 0.3708 | 0.001741775 | 0.0000393686 | 0.6699181 |
| 52 | 0.00530 | 0.6814596 | 8 | 7.6 × 10−6 | 0.3962 | 0.001805857 | 0.00004286155 | 0.6814596 |
| 53 | 0.00540 | 0.6928765 | 9 | 8.5 × 10−6 | 0.4250 | 0.001870754 | 0.00004668914 | 0.6928765 |
| 54 | 0.00550 | 0.704134 | 11 | 8.1 × 10−6 | 0.4588 | 0.001936356 | 0.00005094941 | 0.704134 |
| 55 | 0.00560 | 0.7151725 | 14 | 8.7 × 10−6 | 0.5006 | 0.00200247 | 0.00005582035 | 0.7151725 |
| 56 | 0.00570 | 0.7257948 | 22 | 9.3 × 10−6 | 0.5606 | 0.002068501 | 0.00006187247 | 0.7257948 |
| 57 | 0.00580 | 0.0004754389 | 308 | 8.3 × 10−6 | 1.0081 | 0.000001380029 | 0.001477904 | 0.0004752194 |
| 58 | 0.00590 | 0.0004541939 | 2 | 4.6 × 10−7 | 1.0081 | 0.000001339005 | 0.001477991 | 0.0004541974 |
| 59 | 0.00600 | 0.0004334678 | 2 | 2.5 × 10−7 | 1.0083 | 0.000001299518 | 0.001478075 | 0.0004334679 |
| 60 | 0.00610 | 0.0004139992 | 2 | 2.3 × 10−7 | 1.0085 | 0.000001261854 | 0.001478154 | 0.0004139992 |
| 61 | 0.00620 | 0.0003957132 | 2 | 2.1 × 10−7 | 1.0087 | 0.000001225908 | 0.001478231 | 0.0003957132 |
| 62 | 0.00630 | 0.0003785198 | 2 | 2 × 10−7 | 1.0088 | 0.000001191572 | 0.001478304 | 0.0003785198 |
| 63 | 0.00640 | 0.0003623365 | 2 | 1.9 × 10−7 | 1.0089 | 0.000001158747 | 0.001478373 | 0.0003623365 |
| 64 | 0.00650 | 0.0003677663 | 1 | 9.6 × 10−6 | 1.0091 | 0.000001128049 | 0.001478439 | 0.0003677663 |
| 65 | 0.00660 | 0.0003524283 | 1 | 9.2 × 10−6 | 1.0092 | 0.000001097949 | 0.001478503 | 0.0003524283 |
| 66 | 0.00670 | 0.0003377493 | 1 | 8.9 × 10−6 | 1.0093 | 0.000001069101 | 0.001478565 | 0.0003377493 |
| 67 | 0.00680 | 0.0003238947 | 1 | 8.5 × 10−6 | 1.0094 | 0.000001041441 | 0.001478623 | 0.0003238947 |
| 68 | 0.00690 | 0.0003108076 | 1 | 8.2 × 10−6 | 1.0094 | 0.000001014898 | 0.00147868 | 0.0003108076 |
| 69 | 0.00700 | 0.000298434 | 1 | 7.9 × 10−6 | 1.0095 | 0.0000009894115 | 0.001478734 | 0.000298434 |
| 70 | 0.00710 | 0.0002867248 | 1 | 7.6 × 10−6 | 1.0095 | 0.0000009649225 | 0.001478786 | 0.0002867248 |
| 71 | 0.00720 | 0.0002756351 | 1 | 7.4 × 10−6 | 1.0095 | 0.0000009413773 | 0.001478837 | 0.0002756351 |
| 72 | 0.00730 | 0.0002651233 | 1 | 7.1 × 10−6 | 1.0096 | 0.0000009187257 | 0.001478885 | 0.0002651233 |
| 73 | 0.00740 | 0.0002551516 | 1 | 6.9 × 10−6 | 1.0096 | 0.0000008969209 | 0.001478931 | 0.0002551516 |
| 74 | 0.00750 | 0.0002456849 | 1 | 6.7 × 10−6 | 1.0096 | 0.0000008759191 | 0.001478976 | 0.0002456849 |
| 75 | 0.00760 | 0.000236691 | 1 | 6.4 × 10−6 | 1.0096 | 0.0000008556795 | 0.001479019 | 0.000236691 |
| 76 | 0.00770 | 0.00022814 | 1 | 6.2 × 10−6 | 1.0096 | 0.0000008361641 | 0.001479061 | 0.00022814 |
| 77 | 0.00780 | 0.0002200045 | 1 | 6 × 10−6 | 1.0096 | 0.000000817337 | 0.001479101 | 0.0002200045 |
| 78 | 0.00790 | 0.000212259 | 1 | 5.8 × 10−6 | 1.0095 | 0.0000007991648 | 0.00147914 | 0.000212259 |
与论文的比较
与作者 Python 参考输出(提交 61037c6)以及 1D AT2 杆解进行了比较。图中显示的是我们求解器的结果;力曲线图中还包含 Python 参考值。这些比较不能证明与文章中印出的图一致。
局限
- 与参考代码一致不等于通过试验验证,此处的任何内容都不是工程认证。
- 参考代码只在切口尖端附近的小方框内加密网格。方框之外,单元宽度超过三倍特征长度,高度超过两倍;水平裂纹带的分辨率不足。
- 无约束的参考离散可能超出完好与断裂的损伤界限。负的损伤会使刚度退化到高于完好刚度。组装使用积分点处的插值损伤;仅凭节点极值无法衡量组装后的刚度误差。求解器保留这些值;回放场和颜色标尺在显示时将其截断。
- 交替方案没有加速;在裂纹失稳扩展时,一步内可能需要数百次迭代。
- 浏览器中的运行在网格规模和参数范围上有限制。
代码与参考文献
- 实现、测试和参考输出: shauer-2025 (网格生成器和循环改编自 MIT 许可的参考代码,已在源码中注明)。
- 参考代码: github.com/nathanshauer/phasefield-jr-py, MIT, © 2025 Nathan Shauer.
引用本文
Stabileo Research,「带切口板的相场断裂」,对以下论文的复现: Nathan Shauer (2025), doi:10.1016/j.advengsoft.2025.104013。实现: research/fracture/shauer-2025 ,提交 d91995cb39c7。计算引擎:同一提交的 Stabileo 计算引擎。