darrays_dlb Module

Dynamic load balancing for distributed arrays

Provides atomic counter-based load balancing using MPI-3 RMA. Rank 0 hosts the counter, all ranks can atomically increment it.

Uses

- mpi_f08
- pic_mpi_lib
- pic_types
Help

Graph Key

Nodes of different colours represent the following:

Solid arrows point from a submodule to the (sub)module which it is descended from. Dashed arrows point from a module or program unit to modules which it uses.
Where possible, edges connecting nodes are given different colours to make them easier to distinguish in large graphs.

Used by

Help

Graph Key

Nodes of different colours represent the following:

Solid arrows point from a submodule to the (sub)module which it is descended from. Dashed arrows point from a module or program unit to modules which it uses.
Where possible, edges connecting nodes are given different colours to make them easier to distinguish in large graphs.

Variables

Type	Visibility	Attributes		Name		Initial
integer(kind=int64),	private,	pointer, save	::	counter_ptr(:)	=>	null()
type(win_t),	private,	save	::	counter_win
type(comm_t),	private,	save	::	dlb_comm
logical,	private,	save	::	dlb_initialized	=	.false.

Subroutines

public subroutine dlb_finalize()

Finalize dynamic load balancing

Arguments

None

public subroutine dlb_init(comm)

Initialize dynamic load balancing

Arguments

Type	Intent	Optional	Attributes		Name
type(comm_t),	intent(in)			::	comm	MPI communicator to use

public subroutine dlb_next(counter)

Get next work unit atomically

Arguments

Type	Intent	Optional	Attributes		Name
integer(kind=int64),	intent(out)			::	counter	Output: unique counter value (0-indexed)

public subroutine dlb_reset()

Reset the load balancing counter to zero

Arguments

None