Peano

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.__init__	(	self,
		particle_set,
		particle_cell_update_kernel = None,
		touch_vertex_first_time_compute_particle_update_kernel = None,
		touch_vertex_last_time_compute_particle_update_kernel = None,
		prepare_traversal_kernel = "",
		unprepare_traversal_kernel = "",
		additional_includes = "",
		active_particle_set = None )

Update particles without non-local interaction.

This action set is very similar to UpdateParticle_SingleLevelInteraction, but it assumes that data are stored continuously in memory. Therefore, we can provide meta information how many particles we have per vertex stored en bloc.

Per cell, there's a \( 2^d \) vector over integers called numberOfActiveParticles. It encodes how many particles are contributed towards the active set from each vertex. If you employ contiguous particle storage schemes, you can loop over this integer range rather than the particle set, and you can exploit the fact that data within the index set is contigous.

A cell update then resembles

auto localParticlesIterator = activeParticles.begin();
// There is some parallelism here if you wanna exploit it
for (int vertex=0; vertex<TwoPowerD; vertex++) {
  auto* firstParticle = *localParticlesIterator;
  std::advance( localParticlesIterator, numberOfActiveParticles[vertex] );
  // This loop encodes vector-level parallelism (SIMD)
  for (int currentParticleNo = 0; currentParticleNo < numberOfActiveParticles[vertex]; currentParticleNo++) {
     doSomethingFancy( firstParticle+currentParticleNo );
  }
}

A vertex update resembles

auto* firstParticle = *localParticles.begin();
// This loop encodes vector-level parallelism (SIMD)
for (int currentParticleNo = 0; currentParticleNo < numberOfActiveParticles; currentParticleNo++) {
   doSomethingFancy( firstParticle+currentParticleNo );
}

Validity if particles change their position of cut-off radius

If particles change their position or cut-off radius, you have to resort them. See also UpdateParticle_MultiLevelInteraction_StackOfLists_ContiguousParticles for a discussion of the data validity.

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Reimplemented in swift2.api.actionsets.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.

Definition at line 9 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

References peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.__init__().

Referenced by peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.__init__().

Here is the call graph for this function:

Here is the caller graph for this function:

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.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.solversteps.ActionSet.ActionSet.

Reimplemented in swift2.api.actionsets.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.

Definition at line 171 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.get_attributes ( self )

Return attributes as copied and pasted into the generated class.

Please note that action sets are not persistent, i.e. there is one object creation per grid sweep per tree.

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 193 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.get_body_of_getGridControlEvents ( self )

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 162 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.get_body_of_operation	(		self,
			operation_name )

Return actual C++ code snippets to be inserted into C++ code.

See class' string constants starting with OPERATION_ for possible values of operation_name.

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 152 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.get_body_of_prepareTraversal ( self )

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 165 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.get_body_of_unprepareTraversal ( self )

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 168 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.get_constructor_body ( self )

Define a tailored constructor body.

By default, the constructor of an action set is empty. If you you assign attributes to your action set, you however might want to initialise them here. We do not support initialisation lists, to all has to be done via setters unless you create attributes on the heap.

The constructor's signature will look similar to

   EnumerateAndInitSolution2petsc_actionsets_InitVertexDoFs0(int treeNumber);

where the treeNumber is -1 if this is the global instance of the action set owned by a rank, or a number greater or equal 0 if this action set is a clone of the glocal action set that's used by one tree traversal.

See also: get_attributes() to add attributes to your action set

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 198 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.get_includes ( self )

Return include statements that you need.

All of these includes will eventually end up in the header of the generated C++ code.

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 177 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.user_should_modify_template ( self )

Is the user allowed to modify the output.

Return whether you expect the user to modify the generated code. If this is the case, then the API places the generated output in the directory actions. Otherwise, it goes into the observer directory and will be overwritten in each and every Python run.

Reimplemented from peano4.solversteps.ActionSet.ActionSet.

Definition at line 174 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.__Template_TouchCellFirstTime

staticprivate

Initial value:

=  jinja2.Template(
        
    )

Definition at line 116 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.__Template_TouchVertexFirstTime

staticprivate

Initial value:

=  jinja2.Template(
        
    )

Definition at line 94 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.__Template_TouchVertexLastTime

staticprivate

Initial value:

=  jinja2.Template(
        
    )

Definition at line 105 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles._particle_set

protected

Definition at line 73 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

peano4.toolbox.particles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.UpdateParticle_SingleLevelInteraction_ContiguousParticles.d

Definition at line 74 of file UpdateParticle_SingleLevelInteraction_ContiguousParticles.py.

Public Member Functions
	__init__ (self, particle_set, particle_cell_update_kernel=None, touch_vertex_first_time_compute_particle_update_kernel=None, touch_vertex_last_time_compute_particle_update_kernel=None, prepare_traversal_kernel="", unprepare_traversal_kernel="", additional_includes="", active_particle_set=None)
	Update particles without non-local interaction.

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

	get_body_of_getGridControlEvents (self)

	get_body_of_prepareTraversal (self)

	get_body_of_unprepareTraversal (self)

	get_action_set_name (self)
	Return unique action set name.

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

	get_includes (self)
	Return include statements that you need.

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

	get_constructor_body (self)
	Define a tailored constructor body.

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

	get_destructor_body (self)

Data Fields
	d

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

	parallel

Additional Inherited Members
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"

Public Member Functions

Data Fields

Protected Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ init()

Validity if particles change their position of cut-off radius

Member Function Documentation

◆ get_action_set_name()

◆ get_attributes()

◆ get_body_of_getGridControlEvents()

◆ get_body_of_operation()

◆ get_body_of_prepareTraversal()

◆ get_body_of_unprepareTraversal()

◆ get_constructor_body()

◆ get_includes()

◆ user_should_modify_template()

Field Documentation

◆ __Template_TouchCellFirstTime

◆ __Template_TouchVertexFirstTime

◆ __Template_TouchVertexLastTime

◆ _particle_set

◆ d

Static Private Attributes
	__Template_TouchVertexFirstTime

	__Template_TouchVertexLastTime

	__Template_TouchCellFirstTime

Public Member Functions

Data Fields

Protected Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __init__()

Validity if particles change their position of cut-off radius

Member Function Documentation

◆ get_action_set_name()

◆ get_attributes()

◆ get_body_of_getGridControlEvents()

◆ get_body_of_operation()

◆ get_body_of_prepareTraversal()

◆ get_body_of_unprepareTraversal()

◆ get_constructor_body()

◆ get_includes()

◆ user_should_modify_template()

Field Documentation

◆ __Template_TouchCellFirstTime

◆ __Template_TouchVertexFirstTime

◆ __Template_TouchVertexLastTime

◆ _particle_set

◆ d

◆ init()