Application hook for custom field transfer during mesh adaptation. More...

#include <Omega_h_adapt.hpp>

Public Member Functions
virtual void	out_of_line_virtual_method ()

virtual void	refine (Mesh &old_mesh, Mesh &new_mesh, LOs keys2edges, LOs keys2midverts, Int prod_dim, LOs keys2prods, LOs prods2new_ents, LOs same_ents2old_ents, LOs same_ents2new_ents)=0
	Transfer fields during edge refinement. More...

virtual void	coarsen (Mesh &old_mesh, Mesh &new_mesh, LOs keys2verts, Adj keys2doms, Int prod_dim, LOs prods2new_ents, LOs same_ents2old_ents, LOs same_ents2new_ents)=0
	Transfer fields during edge collapse/coarsening. More...

virtual void	swap (Mesh &old_mesh, Mesh &new_mesh, Int prod_dim, LOs keys2edges, LOs keys2prods, LOs prods2new_ents, LOs same_ents2old_ents, LOs same_ents2new_ents)=0
	Transfer fields during edge/face swaps. More...

virtual void	swap_copy_verts (Mesh &old_mesh, Mesh &new_mesh)=0
	Transfer vertex fields during swaps when custom processing needed. More...

virtual void	snap (Mesh &mesh, const Reals &old_coords, const Reals &warp)=0
	Transfer fields during vertex snap. More...

Detailed Description

Application hook for custom field transfer during mesh adaptation.

UserTransfer provides callbacks invoked during refinement, coarsening, snapping, and swapping operations to customize how application-specific fields are transferred from the old mesh to the new mesh. Each adaptation operation loops over entity dimensions (0=VERT to mesh->dim()), calling the corresponding method after default field transfers (should_inherit, should_interpolate, conserve, etc.) complete for that dimension.

See UserTransfer Interface Guide for more info.

Member Function Documentation

◆ coarsen()

virtual void Omega_h::UserTransfer::coarsen	(	Mesh &	old_mesh,
		Mesh &	new_mesh,
		LOs	keys2verts,
		Adj	keys2doms,
		Int	prod_dim,
		LOs	prods2new_ents,
		LOs	same_ents2old_ents,
		LOs	same_ents2new_ents
	)

pure virtual

Transfer fields during edge collapse/coarsening.

Called once per dimension (0 to mesh->dim()) after default transfers complete for dimension prod_dim.

Parameters

old_mesh	[in] Mesh before coarsening (read-only)
new_mesh	[in/out] Mesh after coarsening (modify tags here)
keys2verts	[in] Maps key indices to collapsing vertex IDs in old_mesh
keys2doms	[in] CSR graph (a2ab offsets, ab2b values) mapping keys to collapsing domain entity IDs
prod_dim	[in] Current entity dimension being processed
prods2new_ents	[in] Maps product indices to new entity IDs (empty for VERT dimension - no product vertices)
same_ents2old_ents	[in] Maps unchanged entity indices to old entity IDs
same_ents2new_ents	[in] Maps unchanged entity indices to new entity IDs

Note: For VERT dimension: No products exist (collapsed vertices removed). All surviving vertices are "same" entities. For higher dimensions: products represent entities in cavities created by collapse.

◆ refine()

virtual void Omega_h::UserTransfer::refine	(	Mesh &	old_mesh,
		Mesh &	new_mesh,
		LOs	keys2edges,
		LOs	keys2midverts,
		Int	prod_dim,
		LOs	keys2prods,
		LOs	prods2new_ents,
		LOs	same_ents2old_ents,
		LOs	same_ents2new_ents
	)

pure virtual

Transfer fields during edge refinement.

Called once per dimension (0 to mesh->dim()) after default transfers (inherit, interpolate, metric, conserve) complete for dimension prod_dim.

Parameters

old_mesh	[in] Mesh before refinement (read-only)
new_mesh	[in/out] Mesh after refinement (modify tags here)
keys2edges	[in] Maps key indices to refined edge IDs in old_mesh
keys2midverts	[in] Maps key indices to new midpoint vertex IDs in new_mesh
prod_dim	[in] Current entity dimension being processed (0=VERT, 1=EDGE, ...)
keys2prods	[in] CSR offset array: keys2prods[k] to keys2prods[k+1] gives product entity range for key k
prods2new_ents	[in] Maps product indices to new entity IDs in new_mesh
same_ents2old_ents	[in] Maps unchanged entity indices to old entity IDs
same_ents2new_ents	[in] Maps unchanged entity indices to new entity IDs

Note: For VERT dimension: new midpoint vertices are in prods2new_ents (equivalently keys2midverts). For higher dimensions: products are new entities created by splitting parent entities.

◆ snap()

virtual void Omega_h::UserTransfer::snap	(	Mesh &	mesh,
		const Reals &	old_coords,
		const Reals &	warp
	)

pure virtual

Transfer fields during vertex snap.

Called after edge lengths are satisfied. Might be called multiple times if snapping could not complete in one step. To be used to update fields that depend on the position of the verticies.

Parameters

mesh	[in/out] Mesh after snapping
old_coords	[in] Coordinates of each vertex before snapping
warp	[in] Amount of movement applied to each vertex

Note: If snapping could not complete in one step, then vertices will not yet be on the boundary. Between these snapping steps the mesh will change. Also, currently there is no built-in field transfer for vertex repositioning.

◆ swap()

virtual void Omega_h::UserTransfer::swap	(	Mesh &	old_mesh,
		Mesh &	new_mesh,
		Int	prod_dim,
		LOs	keys2edges,
		LOs	keys2prods,
		LOs	prods2new_ents,
		LOs	same_ents2old_ents,
		LOs	same_ents2new_ents
	)

pure virtual

Transfer fields during edge/face swaps.

Called once per dimension (EDGE to mesh->dim()) after default transfers complete for dimension prod_dim. Not called for VERT dimension (use swap_copy_verts instead).

Parameters

old_mesh	[in] Mesh before swap (read-only)
new_mesh	[in/out] Mesh after swap (modify tags here)
prod_dim	[in] Current entity dimension being processed (1=EDGE or higher)
keys2edges	[in] Maps key indices to swapped edge IDs in old_mesh
keys2prods	[in] CSR offset array for product entities
prods2new_ents	[in] Maps product indices to new entity IDs
same_ents2old_ents	[in] Maps unchanged entity indices to old entity IDs
same_ents2new_ents	[in] Maps unchanged entity indices to new entity IDs

Note: During swaps, vertices are completely unchanged (same IDs, same coordinates). Only edge/face/element connectivity is modified.

◆ swap_copy_verts()

virtual void Omega_h::UserTransfer::swap_copy_verts	(	Mesh &	old_mesh,
		Mesh &	new_mesh
	)

pure virtual

Transfer vertex fields during swaps when custom processing needed.

Called once per swap operation (not per dimension) at the end of transfer_copy(), after all vertex tags matching should_transfer_copy() are copied and before the dimensional loop begins.

Parameters

old_mesh	[in] Mesh before swap (read-only)
new_mesh	[in/out] Mesh after swap (modify VERT tags here)

Note: Swap operations preserve the vertex set exactly: same count, same IDs, same coordinates, same ownership. Implement custom logic only if vertex fields depend on surrounding element connectivity (e.g., gradient estimates, cached neighborhood data). Most vertex fields are automatically copied and require no custom handling.

The documentation for this struct was generated from the following files:

src/Omega_h_adapt.hpp
src/Omega_h_adapt.cpp

Public Member Functions

Detailed Description

Member Function Documentation

◆ coarsen()

◆ refine()

◆ snap()

◆ swap()

◆ swap_copy_verts()