morphogen.models.ebsd

Polycrystals of measured orientation maps (EBSD).

The model ebsd reads an orientation map (morphogen.io.ebsd: an .ang or a .ctf file), finds its grains, and gives a window of it as a microstructure: a lattice of one cell through the thickness of the domain, each cell with the phase, the label and the mean orientation of its grain — a columnar polycrystal whose section is the map, for the solvers of the homogenization (crystal elasticity and plasticity turned by the orientations of the grains).

The window has the size of the domain in the plane of the map: its first rows and columns (the top left corner of its image), or a window drawn at random in it for each realization (window: random) — the realizations of an RVE study are then windows of the measured microstructure.

The axes of the domain are those of the image of the map: the first to the right, the second upwards, the third towards the viewer; the orientations of the file are brought into them (axes: map; setting: that of the system of an .ang file; see morphogen.io.ebsd).

morphogen.models.ebsd.WINDOWS = ('origin', 'random')

Where the window of a realization is taken in the map

class morphogen.models.ebsd.EBSD(file: str, threshold: float = 5.0, min_size: int = 5, window: str = 'origin', axes: str = 'map', setting: int = 1, turn: tuple[float, ...] | None = None)[source]

Bases: Model

Polycrystal of a measured orientation map (EBSD): the grains of the map, with their orientations, in a window of the size of the domain.

phases: ClassVar[dict[int, str]] = {1: 'crystals'}

Meaning of the phase indices of the voxel images.

supports_periodic: ClassVar[bool] = False

False for models that cannot be periodic (e.g. infinite Poisson fibres).

has_level_set: ClassVar[bool] = False

Whether one level set, that of the phase 1, describes the realizations (two phases: the extended finite elements, the contours of the sections). False for the models of more phases, or of other phases than 0 and 1 (cells of a tessellation, coated inclusions, osteons…): each of their phases has its implicit function (Microstructure.phase_level_set()), from which they are meshed conformingly.

count_label: ClassVar[str] = 'grains'

Objects counted by expected_count() (fibres, spheres, cells…).

crystal_orientations: ClassVar[bool] = True

The grains carry orientations (those of the map)

path_parameters: ClassVar[tuple[str, ...]] = ('file',)

a configuration file gives them from its folder

Type:

The parameters that are files

path() → str[source]

The file of the map: file, or the map of its name that comes with morphoGen where there is no such file.

grains()[source]

The grains of the whole map (morphogen.io.ebsd.Grains).

active_phases() → dict[int, str][source]

Phases the realizations of this model can contain, with their names (the phases of the model, unless its parameters choose them).

generate(domain: Domain, seed: int | SeedSequence | Generator | None = None) → LatticeField[source]

One realization of the model in domain.

expected_count(domain: Domain) → float | None[source]

Mean number of objects of the model in domain (None when undefined).

Used to express RVE sizes as numbers of fibres, grains or cells (Dirrenberger et al. 2014, Table 10).