morphogen.iga.homogenization

Periodic homogenization of NURBS cells: effective stiffness and conductivity.

A cell is an assembly whose outer boundary is a rectangle (a box) with matching control points on opposite sides (morphogen.iga.shapes.cell_with_hole()): the trace of a field on a side of a patch depends on the control points of that side only, so that equal unknowns on matching control points make the field periodic exactly. Its holes are free of tractions; several materials are the phases of its patches.

The cell need not be a box. With the periods of the medium (lattice: one vector per row; the lattice of the assembly by default) it is any set of patches that tiles the plane (the space) by these translations — a parallelogram (the rhombus of a hexagonal array), or whole grains of the pattern cut nowhere (morphogen.iga.shapes.alternating_holes()): the control points of its boundary that are a period apart are then one, and |Y| is the area (volume) of the lattice, |det(lattice)|.

For each unit macroscopic strain E_I (gradient, for conduction) the fluctuation chi_I — periodic, fixed at one control point — solves K chi_I = -L_I, with L_I = int B^T D E_I the forces of the uniform strain, and the effective tensor is the mean energy of the pair of total strains:

C_IJ = (1 / |Y|) int (E_I + eps(chi_I)) : D : (E_J + eps(chi_J)) dY
     = (1 / |Y|) (int D_IJ dY + L_I . chi_J),

|Y| the area (volume) of the box, holes included: the stiffness in Voigt’s notation with engineering shears ((11, 22, 12) in the plane), or the conductivity tensor.

In the plane, plane="strain" gives the plane block of the stiffness of the cell extruded along the third axis (what a solver of the solid gives with eps_33 = 0); plane="stress" that of a thin sheet.

morphogen.iga.homogenization.periodic_classes(model: Multipatch, tolerance: float = 1e-08, lattice=None) → ndarray[source]

The class of each control point of a cell: the control points of opposite sides of its box that match (the same position along the side, the same weight) share one; an error if a side has control points without a match. With the periods of the cell (lattice, or those of the assembly), the control points of its boundary that are a period apart share one.

class morphogen.iga.homogenization.CellSolution(tensor: ndarray, measure: float, fraction: float, fluctuations: ndarray, analysis: Analysis)[source]

Bases: object

The effective tensor of a cell, the area (volume) measure of its box, the share fraction of it that the patches fill, the fluctuations of the unit macroscopic strains (fluctuations: unknowns x components) and the analysis.

constants() → dict[str, float][source]

The engineering constants of the tensor (plane_constants() in the plane; the mean conductivity for conduction).

morphogen.iga.homogenization.plane_constants(tensor) → dict[str, float][source]

The engineering constants of a plane stiffness (3 x 3; Voigt 11, 22, 12 with engineering shears): Young’s moduli and Poisson’s ratios of its plane law, young_1 = 1 / S_11, poisson_12 = -S_12 / S_11 (the contraction along 2 under a tension along 1), the shear modulus C_66 and the bulk modulus of the plane, (C_11 + C_22 + 2 C_12) / 4.

class morphogen.iga.homogenization.Cell(model, materials, *, physics: str = 'elastic', plane: str = 'strain', extra: int = 0, tolerance: float = 1e-08, lattice=None)[source]

Bases: object

A periodic cell (see the module): the assembly model, the materials of its phases, the physics ("elastic", with plane for surfaces, or "conduction") and, for a cell that is not a box, the periods lattice (those of the assembly by default). solve() gives its effective tensor.

solve() → CellSolution[source]

The effective tensor of the cell and the fluctuations of its unit loadings.

morphogen.iga.homogenization.homogenize(model, materials, *, physics: str = 'elastic', plane: str = 'strain', extra: int = 0, lattice=None) → CellSolution[source]

The effective tensor of a periodic NURBS cell (Cell).