6.2. pyafv.PhysicalParams

class PhysicalParams(r=1.0, A0=3.141592653589793, P0=4.8, KA=1.0, KP=1.0, lambda_tension=0.2, delta=None)[source]

Physical parameters for the active-finite-Voronoi (AFV) model.

Warning

  • Frozen dataclass is used for PhysicalParams to ensure immutability of instances.

  • Do not set delta unless you know what you are doing.

Parameters:

  • r (float) – Radius (maximal) of the Voronoi cells, sometimes denoted as \(\ell\).

  • A0 (float) – Preferred area of the Voronoi cells.

  • P0 (float) – Preferred perimeter of the Voronoi cells.

  • KA (float) – Area elasticity constant.

  • KP (float) – Perimeter elasticity constant.

  • lambda_tension (float) – Tension difference between non-contacting edges and contacting edges.

  • delta (float | None) – Contact truncation threshold to avoid singularities in computations; if None, set to 0.45*r.

Attributes

r

Radius (maximal) of the Voronoi cells, sometimes denoted as \(\ell\).

A0

Preferred area of the Voronoi cells.

P0

Preferred perimeter of the Voronoi cells.

KA

Area elasticity constant.

KP

Perimeter elasticity constant.

lambda_tension

Tension difference between non-contacting edges and contacting edges.

delta

Contact truncation threshold to avoid singularities in computations.

Methods

get_steady_state()

Search for the steady-state \((\ell,d)\) of a cell doublet for the given physical parameters (by minimizing total energy).

with_optimal_radius([digits, delta])

Returns a new instance of PhysicalParams with the maximum radius \(\ell\) (or r) updated to the steady state value \(\ell_0\) of cell doublets.

replace(**changes)

Returns a new instance of PhysicalParams with specified fields replaced by new values.