extended_phasemapping

ExtendedPhaseMapping

Pipeline for extended phase mapping on phasefield data.

This class processes a given phasefield by applying optional filters, extracting cycles (from faces and/or boundaries), and categorizing them into critical, noncritical, and wavefront cycles. It provides a structured way to analyze spatiotemporal phase dynamics using topological criteria.

Attributes:

Name	Type	Description
phasefield	PhaseField	The input phasefield mesh.
phasefield_filters	list	List of filters to apply to the phasefield.
cycles	DataFrame	DataFrame containing all extracted cycles.
critical_cycles	DataFrame	Cycles with non-zero topological charge.
noncritical_cycles	DataFrame	Cycles with zero topological charge and more nodes than a single face.
wavefront_cycles	DataFrame	Cycles corresponding to propagating wavefronts (non-zero wave number, zero topological charge, and equal to the face size).

critical_cycles = pd.DataFrame() instance-attribute

cycles = None instance-attribute

noncritical_cycles = pd.DataFrame() instance-attribute

phasefield = phasefield instance-attribute

phasefield_filters = phasefield_filters or [] instance-attribute

wavefront_cycles = pd.DataFrame() instance-attribute

__init__(phasefield, phasefield_filters=None)

Initialize the ExtendedPhaseMapping pipeline.

Parameters:

Name	Type	Description	Default
phasefield	PhaseField	The phasefield mesh to be processed.	required
phasefield_filters	list	List of functions to filter the phasefield.	None

run(extract_faces=True, extract_boundaries=True)

Execute the ExtendedPhaseMapping pipeline.

Applies filters and extracts cycles from the phasefield.

Parameters:

Name	Type	Description	Default
extract_faces	bool	Whether to extract cycles from the faces of the phasefield (Default=True).	True
extract_boundaries	bool	Whether to extract cycles from the boundaries of the phasefield (Default=True).	True