morphogen.homogenization.paths¶
Loading paths: macroscopic loadings that vary in time, and the responses to them.
A path gives, at increasing times, the value of each macroscopic component, prescribed as a strain or as a stress (the other one is then an unknown, solved for), and the change of temperature; values vary linearly in time between them. The first time is the natural state: zero strain, stress and change of temperature. Uniaxial tension at a strain rate, creep under a stress, relaxation, cycles or thermal histories are paths.
- class morphogen.homogenization.paths.LoadingPath(times: tuple[float, ...], values: tuple[tuple[float, ...], ...], controls: tuple[bool, ...], temperature: tuple[float, ...] = (), increments: tuple[int, ...] = ())[source]¶
Bases:
objectHistory of a macroscopic loading of elasticity.
At the
times(increasing; the first one is the natural state),valuesgives the six Voigt components (11, 22, 33, 23, 31, 12; engineering shear strains), prescribed as strains wherecontrolsis true and as stresses elsewhere, andtemperaturethe change of temperature. Each segment between two times is divided intoincrementssteps (the solver divides a step further when it does not converge).- classmethod from_spec(spec) LoadingPath[source]¶
Path of a configuration mapping:
times,increments(one per segment, or one for all),strainandstress(component -> values at the times, or one value reached at the end of the first segment and held; the first value, zero, may be omitted) andtemperature(likewise). Components not given are free: zero stress.{"times": [0, 10], "strain": {"11": 0.02}}is a uniaxial tension at the strain rate 0.002.
- classmethod parse(text: str) LoadingPath[source]¶
Path of a compact text:
t=0,10,20 n=10 E11=0,0.02,0 S12=0 dT=0,50,50: the timest, the incrementsn(one, or one per segment), strainEand stressScomponents and the change of temperaturedTat the times (or one value reached at the end of the first segment and held); the components not given are free (zero stress).
- classmethod uniaxial(axis: int, *, times, strain=None, stress=None, increments=10, temperature=None) LoadingPath[source]¶
Tension (compression) along
axis: its strain (or stress) at thetimes, the other stress components zero.
- property strain_controlled: ndarray¶
- property duration: float¶
- class morphogen.homogenization.paths.PathResult(name: str, bc: str, path: LoadingPath, times: ndarray, strain: ndarray, stress: ndarray, temperature: ndarray, plastic: ndarray, phases: dict = <factory>, iterations: ndarray = <factory>, info: dict = <factory>, fields: dict = <factory>, support: object | None = None, kinematics: str = 'small', cauchy: ndarray | None = None, log_strain: ndarray | None = None, porosity: ndarray | None = None, series: dict = <factory>, scalars: dict = <factory>, orientation: ndarray | None = None)[source]¶
Bases:
objectMacroscopic response of a volume element (or of a material point) along a path.
times(n),strainandstress(n x 6, Voigt; engineering shear strains),temperatureandplastic(the mean cumulated plastic strain of the material) at each converged step, the first one the natural state;phases: for each phase, its meanstress,strainandplasticstrain at each step;iterations: Newton iterations of each step;fields: element fields at some times (time -> name -> array) onsupport.In finite strains (
kinematics="finite"),strainholds the components 11, 22, 33, 23, 13, 12 of the upper triangular macroscopic displacement gradientF - I(nominal strains and simple shears) andstressthose of the mean first Piola-Kirchhoff stress (nominal stresses);cauchyholds the Cauchy (true) stress andlog_strainthe logarithmic (true) strain, and each phase its meancauchystress. With porous plastic materials,porosityholds the mean porosity of their points at each step, and each porous phase its meanporosity.series: the other curves that a solver records at each step (name -> values: the area in contact of the walls of a cell that close,ContactCell), columns ofrows()and quantities ofvalue()as the others.orientation: for a material point that is a crystal, in finite strains or where its twins turn it, the Bunge angles (degrees) of its lattice at each step (n x 3; the columnsphi1,Phiandphi2ofrows()). The lattices of the crystals of a volume element are in itsfields(orientation):texture().- scalars: dict¶
final values (
components()) and quantities ofvalue()- Type:
other scalar results of the path, by name (the fatigue of its cycle)
- property n_steps: int¶
- property finite: bool¶
- rows() list[dict][source]¶
The curves, one row per step: time,
E11 ... E12,S11 ... S12, in finite strains the logarithmic strainsLE11 ...and the Cauchy stressesTS11 ..., the change of temperature, the mean cumulated plastic strain (and porosityf), the mean stress (and Cauchy stress) and plastic strain (and porosity) of each phase, and the other curves recorded (series).
- driven() int[source]¶
The component of the loading: that whose prescribed strain varies most along the path (of its prescribed stresses, without a prescribed strain).
- texture(time: float | None = None)[source]¶
The lattices of the crystals at a time of the path (the nearest of those of its fields; the last one by default): their orientations (Bunge angles in degrees, m x 3) and their volumes (m), for the pole figures of
morphogen.texture. The crystals are the elements of a mesh or the voxels of an image whose fields have anorientation(crystals in finite strains, or whose twins turn their lattices; the paths run withfields), or the material point oforientation.
- strength(component: int | None = None, upto: int | None = None) float[source]¶
The largest stress (in absolute value) reached along the path, up to the step
upto, of a component: by default that of the loading (driven()). The strength of a volume element that softens (damage, fracture), its flow stress otherwise.
- work(upto: int | None = None) float[source]¶
The work of the macroscopic stress per unit volume along the path,
int Sigma : dE(trapezoids over the steps; nominal stresses and strains in finite strains), up to the stepupto: the energy stored and dissipated; at the end of a path that breaks the volume element, its work of fracture.
- value(name: str, time: float | None = None) float[source]¶
Value of a quantity of the curves (a column of
rows():E11,S11,TS11,p,S11_1…) at the end of the path, or attime: the end of one of its steps; orstrengthandwork, the largest stress of the loading and the work done up to there (strength(),work()).
- class morphogen.homogenization.paths.PathQuantity(path: str, quantity: str, time: float | None = None, bc: str | None = None)[source]¶
Bases:
objectA quantity of the curves of a loading path, for the statistics of RVE studies: a column of
PathResult.rows()(S11,TS11,p,S11_1…) at the end of the path, or attime, the end of one of its steps (the flow stress at a given strain, say), under every boundary condition, or underbconly.Written
<path>.<quantity>or<path>.<quantity>@<time>:tension.S11@5isS11of the pathtensionat the time 5;.<bc>follows for one boundary condition (tension.S11@5.periodic).- property name: str¶
Name of the series of the quantity (without the boundary condition).
- property key: str¶
- of(result: PathResult) float[source]¶
The quantity in a response to the path.