Particles_mapToMeshOneBlk.F90 File Reference

Go to the source code of this file.

Functions/Subroutines
subroutine	Particles_mapToMeshOneBlk (blkLimitsGC, guard, blockID, particles, numParticles, pt_attribute, buff, particleOffset)

Function/Subroutine Documentation

Particles_mapToMeshOneBlk()

subroutine Particles_mapToMeshOneBlk	(	integer	blkLimitsGC,
		integer, dimension(MDIM)	guard,
		integer	blockID,
		real, dimension(NPART_PROPS,numParticles), intent(in)	particles,
		integer	numParticles,
		integer, intent(in)	pt_attribute,
		real, dimension(blkLimitsGC(LOW,IAXIS):blkLimitsGC(HIGH,IAXIS), blkLimitsGC(LOW,JAXIS):blkLimitsGC(HIGH,JAXIS), blkLimitsGC(LOW,KAXIS):blkLimitsGC(HIGH,KAXIS))	buff,
		integer	particleOffset
	)

Routine which manages the mapping of all particles existing on a certain block to a temporary buffer (buff). The particles in the particle buffer must be sorted prior to reaching this routine. This is because all particles between the particle buffer limits of pStart and pEnd will be mapped to the temporary buffer. The temporary buffer corresponds to a single block, and mapping may occur in the buffer's internal and guard cell grid points. The actual mapping takes place in the subroutine pt_mapOneParticle.

blkLimitsGC: Size of a block including guard cells. guard: Number of guard cells. blockID: ID of the block that will receive particle mapping. particles: list of particles to map to this block numParticles: length of second dim of particles argument pt_attribute: Particle attribute that will be mapped to the mesh. buff: Temporary buffer in which to accumulate particle mapping. particleOffset: offset of the dummy argument 'particles' within the global 'particles' array in the Particles_data module. Used only for debugging. The caller should supply this ONLY if it really passes an actual argument for the 'particles' dummy that is a slice from the Particles_data 'particles' array!

NOTES

In adaptive mesh simulations we may wish to identify those particles which smear across cells in blocks at different refinement levels. A motive is so that we can incorporate more elaborate particle mapping schemes in future. The routine which identifies these particles is named gr_ptParticleAtFcBdry.

Definition at line 49 of file Particles_mapToMeshOneBlk.F90.