4.3.4. pde.pdes.diffusion module

A simple diffusion equation

class DiffusionPDE(diffusivity=1, noise=0, bc='auto_periodic_neumann')[source]

Bases: PDEBase

A simple diffusion equation

The mathematical definition is

\[\partial_t c = D \nabla^2 c\]

where \(c\) is a scalar field and \(D\) denotes the diffusivity.

  • diffusivity (float) – The diffusivity of the described species

  • noise (float) – Variance of the (additive) noise term

  • bc (Dict[str, Dict | str | BCBase] | Dict | str | BCBase | Tuple[Dict | str | BCBase, Dict | str | BCBase] | BoundaryAxisBase | Sequence[Dict[str, Dict | str | BCBase] | Dict | str | BCBase | Tuple[Dict | str | BCBase, Dict | str | BCBase] | BoundaryAxisBase]) – The boundary conditions applied to the field. Boundary conditions are generally given as a list with one condition for each axis. For periodic axes, only periodic boundary conditions are allowed (indicated by ‘periodic’ and ‘anti-periodic’). For non-periodic axes, different boundary conditions can be specified for the lower and upper end (using a tuple of two conditions). For instance, Dirichlet conditions enforcing a value NUM (specified by {‘value’: NUM}) and Neumann conditions enforcing the value DERIV for the derivative in the normal direction (specified by {‘derivative’: DERIV}) are supported. Note that the special value ‘natural’ imposes periodic boundary conditions for periodic axis and a vanishing derivative otherwise. More information can be found in the boundaries documentation.

diagnostics: Dict[str, Any]

Diagnostic information (available after the PDE has been solved)



evolution_rate(state, t=0)[source]

evaluate the right hand side of the PDE

  • state (ScalarField) – The scalar field describing the concentration distribution

  • t (float) – The current time point


Scalar field describing the evolution rate of the PDE

Return type:


explicit_time_dependence: bool | None = False

Flag indicating whether the right hand side of the PDE has an explicit time dependence.



property expression: str

the expression of the right hand side of this PDE