Peano

Searching...

No Matches

Preprocess the solution and reconstruct halo for this. More...

Inheritance diagram for exahype2.solvers.rkfd.actionsets.PreprocessSolution.PreprocessReconstructedSolutionWithHalo:

[legend]

Collaboration diagram for exahype2.solvers.rkfd.actionsets.PreprocessSolution.PreprocessReconstructedSolutionWithHalo:

[legend]

Public Member Functions
	__init__ (self, solver, compute_kernel_implementation, enclave_task_cell_label=None)
	Construct the preprocessing.

	get_action_set_name (self)
	Return unique action set name.

	get_includes (self)
	Return include statements that you need.

Public Member Functions inherited from peano4.toolbox.blockstructured.ReconstructPatchAndApplyFunctor.ReconstructPatchAndApplyFunctor
	get_constructor_body (self)
	Define a tailored constructor body.

	user_should_modify_template (self)
	Is the user allowed to modify the output.

	get_body_of_operation (self, operation_name)
	Return actual C++ code snippets to be inserted into C++ code.

	get_attributes (self)
	Return attributes as copied and pasted into the generated class.

Public Member Functions inherited from peano4.solversteps.ActionSet.ActionSet
	get_static_initialisations (self, full_qualified_classname)

	get_destructor_body (self)

	get_body_of_getGridControlEvents (self)

	get_body_of_prepareTraversal (self)

	get_body_of_unprepareTraversal (self)

Protected Attributes
	_solver

Additional Inherited Members
Data Fields inherited from peano4.toolbox.blockstructured.ReconstructPatchAndApplyFunctor.ReconstructPatchAndApplyFunctor
	guard

	no_of_unknowns

	dofs_per_axis

	total_overlap

	overlap_name

	patch_name

	functor_implementation

	add_assertions_to_halo_exchange

	reconstructed_array_memory_location

Data Fields inherited from peano4.solversteps.ActionSet.ActionSet
	descend_invocation_order

	parallel

Static Public Attributes inherited from peano4.solversteps.ActionSet.ActionSet
str	OPERATION_BEGIN_TRAVERSAL = "beginTraversal"

str	OPERATION_END_TRAVERSAL = "endTraversal"

str	OPERATION_CREATE_PERSISTENT_VERTEX = "createPersistentVertex"

str	OPERATION_DESTROY_PERSISTENT_VERTEX = "destroyPersistentVertex"

str	OPERATION_CREATE_HANGING_VERTEX = "createHangingVertex"

str	OPERATION_DESTROY_HANGING_VERTEX = "destroyHangingVertex"

str	OPERATION_CREATE_PERSISTENT_FACE = "createPersistentFace"

str	OPERATION_DESTROY_PERSISTENT_FACE = "destroyPersistentFace"

str	OPERATION_CREATE_HANGING_FACE = "createHangingFace"

str	OPERATION_DESTROY_HANGING_FACE = "destroyHangingFace"

str	OPERATION_CREATE_CELL = "createCell"

str	OPERATION_DESTROY_CELL = "destroyCell"

str	OPERATION_TOUCH_VERTEX_FIRST_TIME = "touchVertexFirstTime"

str	OPERATION_TOUCH_VERTEX_LAST_TIME = "touchVertexLastTime"

str	OPERATION_TOUCH_FACE_FIRST_TIME = "touchFaceFirstTime"

str	OPERATION_TOUCH_FACE_LAST_TIME = "touchFaceLastTime"

str	OPERATION_TOUCH_CELL_FIRST_TIME = "touchCellFirstTime"

str	OPERATION_TOUCH_CELL_LAST_TIME = "touchCellLastTime"

Protected Member Functions inherited from peano4.toolbox.blockstructured.ReconstructPatchAndApplyFunctor.ReconstructPatchAndApplyFunctor
	_add_action_set_entries_to_dictionary (self, d)
	Befill dictionary.

Static Protected Attributes inherited from peano4.toolbox.blockstructured.ReconstructPatchAndApplyFunctor.ReconstructPatchAndApplyFunctor
str	_Template_TouchCellFirstTime_Preamble

str	_Template_TouchCellFirstTime_Fill_Patch

str	_Template_TouchCellFirstTime_Fill_Halos

str	_Template_TouchCellFirstTime_Core

str	_Template_TouchCellFirstTime_Epilogue

Detailed Description

Preprocess the solution and reconstruct halo for this.

This action set preprocesses the solution. By default, it only plugs into the very first grid sweep of a time step. That is, if you have a Runge-Kutta solver and/or enclave solver, these guys usually need multiple sweeps. We only plug into the very first one.

If it becomes active, it first of all creates an array called oldQWithHalo. It is held on the heap and will be destroyed automatically later on. This array is properly befilled. You can postprocess it, but if you alter entries therein, these alterations will be lost after the preprocessing step.

Enclave solver variant

The action set can work in an enclave solver style or as plain invocation. Plain invocation means we just reconstruct the patch plus halo, invoke a compute kernel on it, and then free this reconstruction data structure again.

Enclave-style means that we do the reconstruction, but then embed the actual operation and the freeing into a task. We use the actual enclave task number as task number. Peano does not allow multiple tasks in the system with the same number, so if an enclave task is spawned afterwards, we have a read-write-read dependency.

Todo: Das ist falsch

Definition at line 38 of file PreprocessSolution.py.

Constructor & Destructor Documentation

◆ init()

exahype2.solvers.rkfd.actionsets.PreprocessSolution.PreprocessReconstructedSolutionWithHalo.__init__	(	self,
		solver,
		compute_kernel_implementation,
		enclave_task_cell_label = None )

Construct the preprocessing.

If we work with an enclave task, the modelling is pretty straightforward. However, we have to explicitly delete the reconstructed data structure oldQWithHalo, as we tell the parent class not to delete stuff. If they deleted the oldQWithHalo, it would be at the end of the function. At this point our task might not have finished yet. We need the delete within the task.

Parameters

enclave_task_cell_label String or None If this field is none, we do not use any tasking. If it is a string, we assume it denotes a cell label (usually it is something similar to fineGridCellMySolver_FD4CellLabel). In this case, we spawn a separate task as enclave task.

Reimplemented from peano4.toolbox.blockstructured.ReconstructPatchAndApplyFunctor.ReconstructPatchAndApplyFunctor.

Definition at line 70 of file PreprocessSolution.py.

References exahype2.solvers.rkfd.actionsets.PreprocessSolution.PreprocessReconstructedSolutionWithHalo.__init__().

Referenced by exahype2.solvers.rkfd.actionsets.PreprocessSolution.PreprocessReconstructedSolutionWithHalo.__init__().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Function Documentation

◆ get_action_set_name()

exahype2.solvers.rkfd.actionsets.PreprocessSolution.PreprocessReconstructedSolutionWithHalo.get_action_set_name ( self )

Return unique action set name.

Returns a description (word) for the mapping which is also used as class name for the generated type. As a consequence, the result should be one word (if possible) and uppercase. Also, every subclass should overwrite this routine.

The generator will take the result and construct eventually classes similar to MyStep2Dummy.h and MyStep2Dummy.cpp or similar for the example below, where we return Dummy.

Reimplemented from peano4.toolbox.blockstructured.ReconstructPatchAndApplyFunctor.ReconstructPatchAndApplyFunctor.

Definition at line 141 of file PreprocessSolution.py.