Domain decomposition¶
An Arbor simulation requires a Recipes, a (hardware) context, and a domain decomposition. The Recipe contains the neuroscientific model, the hardware context describes the computational resources you are going to execute the simulation on, and the domain decomposition describes how Arbor will use the hardware. Since the context and domain decomposition may seem closely related at first, it might be instructive to see how recipes are used by Arbor:
lif_cell_0
cable_cell_A
arbor.lif_cell
arbor.cable_cell
gid=37
type=cable_cell_A
.
gid=37
kind=arbor.cable_cell
.
arbor.cable_cell
.
cable_cell_group_gpu
cable_cell_group_gpu
construct cable_cell_A
object.
cable_cell_group_gpu
: Construction complete.
cable_cell_group_gpu
simulate for t .. t + dt
A domain decomposition describes the distribution of the model over the available computational resources. The description partitions the cells in the model as follows:
group the cells into cell groups of the same kind of cell;
assign each cell group to either a CPU core or GPU on a specific MPI rank.
The number of cells in each cell group depends on different factors, including the type of the cell, and whether the cell group will run on a CPU core or the GPU. The domain decomposition is solely responsible for describing the distribution of cells across cell groups and domains.
The domain decomposition can be built manually by the modeler, or an automatic load balancer can be used.
Load balancers¶
A load balancer generates the domain decomposition using the model recipe and a description of the available computational resources on which the model will run described by an execution context. Currently Arbor provides one load balancer and more will be added over time.