Levelset + Barrier Method

[LDTalbot]

Description
Improved Levelset with Barrier method; original method via Zhao et al. (2023).

TODO

• 2D benchmark tests for elastic sliding block on plane.
• 3D benchmark tests for elastic sliding block on plane.
• Benchmark tests for elastic rolling/sliding cylinder/sphere on plane.
• 2D benchmark tests for Mohr-Coulomb sand flume.
• 3D benchmark tests for Mohr-Coulomb sand flume.
• Adhesion functionality.
• "Uphill prevention" (potential versus actual tangent resistance).
• Local PIC contact velocity.
• Damping functionality.
• Compatible with B-Bar.
• OpenMP.
• MPI.
• Resume functionality.
• Write tests.
• Add documentation: update wiki, example input files/benchmarks.

Other Edits in PR

• Mohr-Coulomb separate yield state.
• Closed-form BSpline.
• Refactor for updating mass and momentum within single loop & mutex, mitigating CPU idle time every step when using OpenMP. Previous separate update functions still available.
• Geometry .vtk output off.

Potential Future Modifications

• Separate levelset mesh implementation
• Potential levelset normal source of error once mesh is separate
• RBD levelset

Related Issues

• Contact functionality
• Nomenclature for subclasses/derived classes: want e.g. MeshLevelset, ParticleLevelset

[codecov]

Codecov Report

Attention: Patch coverage is 37.18887% with 429 lines in your changes missing coverage. Please review.

Project coverage is 94.95%. Comparing base (a0dad92) to head (390a739).

Files with missing lines	Patch %	Lines
.../particles/anti_locking/particle_levelset_bbar.tcc	0.00%	133 Missing ⚠️
include/particles/particle_levelset.tcc	0.00%	80 Missing ⚠️
include/mesh/mesh_levelset.tcc	0.00%	56 Missing ⚠️
include/solvers/mpm_base.tcc	30.91%	38 Missing ⚠️
include/io/io_mesh_ascii.tcc	8.00%	23 Missing ⚠️
include/contacts/contact_levelset.tcc	0.00%	16 Missing ⚠️
include/nodes/node_levelset.tcc	0.00%	15 Missing ⚠️
...lude/elements/2d/quadrilateral_bspline_element.tcc	88.89%	12 Missing ⚠️
include/nodes/node_base.h	0.00%	12 Missing ⚠️
include/nodes/node_levelset.h	0.00%	12 Missing ⚠️
... and 7 more

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #88      +/-   ##
==========================================
- Coverage   95.72%   94.95%   -0.78%     
==========================================
  Files         241      250       +9     
  Lines       50578    51103     +525     
==========================================
+ Hits        48414    48520     +106     
- Misses       2164     2583     +419     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.