7.3.2. pyafv.FiniteVoronoiSimulator.build

FiniteVoronoiSimulator.build(connect=True)

Build the finite Voronoi structure and compute forces, returning a dictionary of diagnostics.

Do the following:

• Build Voronoi (+ extensions)

• Get cell connectivity

• Compute per-cell quantities and derivatives

• Assemble forces

Parameters:

connect (bool) – Whether to compute cell connectivity information. Setting this to False saves some computation time (though very marginal) when connectivity is not needed.

Returns:

A dictionary containing forces and geometric properties with keys:

• forces: (N,2) array of forces on cell centers

• areas: (N,) array of cell areas

• perimeters: (N,) array of cell perimeters

• vertices: (M,2) array of all Voronoi + extension vertices

• edges_type: List-of-lists of edge types per cell (1=straight, 0=circular arc)

• regions: List-of-lists of vertex indices per cell

• connections: (K,2) array of connected cell index pairs

Return type:

dict[str, object]