A tool: mergeMeshToBulkMesh

The tool merges one mesh into a bulk mesh, which can be used in simulations of excavation, backfilling, and successive geo-engineering operations. For such simulations:

-The excavation simulation uses a mesh without the domain to be excavated (termed the "bulk mesh") and employs the release-load force approach.

-The backfilling and geo-engineering operation processes use a mesh merged from the bulk mesh and the excavated domain mesh, facilitated by the new tool.

In addition to merging meshes, the tool transfers all point data, cell data, and integration point data from the bulk mesh to the bulk portion of the merged mesh. It can also assign pressure or temperature values to point data, or integration point stress values to the remaining part of the merged mesh. Thus, the initial conditions of the backfilling simulation can incorporate excavation simulation results from the merged mesh.

Since the implementation utilizes the Mesh class and accesses pointer-type data for nodes and elements, it has been verified to be free of memory leaks.

Here is an input example:

mergeMeshToBulkMesh   -b sma_h2m_excavation_plastic_ts_6.3072e+08.vtu -i SMA_2D_cavern.vtu -o test.vtu --sigma_xx -10e+6 --sigma_yy -2e+6 --sigma_zz -3e+6 --temperature 293.15 --gas_pressure 1e+5 --capillary_pressure 5e+6  --material_id 0

Domain to be excavated	Bulk mesh
	)

|

Merged mesh with data

1. Feature description was added to the changelog
2. Tests covering your feature were added?
3. Any new feature or behaviour change was documented?