morphogen.iga.analysis

Isogeometric analysis of linear elasticity and conduction on NURBS assemblies.

The isoparametric concept of Hughes, Cottrell & Bazilevs (2005): the rational functions R_a that describe the geometry (morphogen.iga.geometry) interpolate the unknowns too, u = sum_a R_a u_a, the unknowns attached to the control points. The geometry of the analysis is that of the design — a circle stays a circle at any refinement —, and the functions are smooth across the elements of a patch (C^(p-1) after a k-refinement), which gives more accuracy per unknown than finite elements of the same degree.

Discretization. The elements are the knot spans of each patch; the integrals are those of Gauss-Legendre with p + 1 points per direction. At a point, the derivatives of the functions with respect to the parameters give the Jacobian J = sum_a P_a (x) dR_a/dxi and the gradients dR_a/dx = dR_a/dxi J^-1; the stiffness is K = sum int B^T D B det J dxi, as for finite elements, with B the strain operator of these gradients. Strains and stresses are written in Voigt’s notation with engineering shears: (11, 22, 12) in the plane, (11, 22, 33, 23, 31, 12) in space (the order of the rest of morphoGen). In the plane, plane="strain" takes the stiffness of the plane components of the three-dimensional law, plane="stress" its condensation at zero out-of-plane stresses.

Conditions. The functions of an open knot vector interpolate at the ends of a patch: the control points of a side carry the values of the unknown along it, so that a uniform value (a clamped or symmetric side) is prescribed on them exactly; tractions are integrated on the sides.

morphogen.iga.analysis.elastic_matrix(material, ndim: int, plane: str = 'strain') → ndarray[source]

The stiffness of a material in Voigt’s notation for an analysis of ndim dimensions: the 6 x 6 matrix of a solid; in the plane, its plane components (plane strain) or its condensation at zero out-of-plane stresses (plane stress). material: a Material, or a 6 x 6 (or, in the plane, 3 x 3) array.

morphogen.iga.analysis.conduction_matrix(material, ndim: int) → ndarray[source]

The conductivity tensor of a material for an analysis of ndim dimensions: a Material, a number or a tensor.

class morphogen.iga.analysis.Points(patch: int, nodes: ndarray, weights: ndarray, x: ndarray, values: ndarray, gradients: ndarray, jacobian: ndarray)[source]

Bases: object

The integration points of a group of elements of a patch: the control points of each element (nodes: elements x functions), the weights of the points times the Jacobian (weights: elements x points), their positions, the functions there and their gradients (elements x points x functions (x dim)), and the Jacobian determinants.

morphogen.iga.analysis.patch_points(model: Multipatch, k: int, extra: int = 0) → Iterator[Points][source]

The integration points of patch k of an assembly, by groups of elements (extra Gauss points per direction beyond degree + 1).

morphogen.iga.analysis.strain_operator(gradients: ndarray) → ndarray[source]

The strain operator B of the gradients of the functions (… x functions x dim): … x strains x (functions dim), in Voigt’s notation with engineering shears.

class morphogen.iga.analysis.Analysis(model: Multipatch, materials, *, physics: str = 'elastic', plane: str = 'strain', extra: int = 0)[source]

Bases: object

The discretization of an assembly for a physics (see the module): "elastic" (plane: "strain" or "stress" for surfaces) or "conduction", with the materials of the phases of its patches (Material, or their matrices); extra Gauss points per direction beyond degree + 1.

nd

Unknowns per control point, and components of the gradient-like measure

points() → Iterator[tuple[Points, ndarray, ndarray, ndarray]][source]

The groups of integration points with their operator B (strains, or gradients: elements x points x components x unknowns of the element), the matrix of their material and the unknowns of their elements.

matrix() → csr_matrix[source]

The stiffness (conductivity) matrix of all the unknowns.

measure() → float[source]

The area (volume) of the assembly.

uniform_loads() → tuple[ndarray, ndarray][source]

The nodal forces int B^T D E of the unit uniform strains (gradients) E (unknowns x components), and int D (components x components).

side_load(patch: int, axis: int, end: int, traction) → ndarray[source]

The nodal forces of a traction (a flux, for conduction) on a side of a patch: a vector, or a function traction(x, n) of the points (points x dim) and of the outward unit normals there.

dofs(nodes, components=None) → ndarray[source]

The unknowns of control points: all their components, or those given.

solve(forces, fixed, values=0.0, matrix=None) → ndarray[source]

The unknowns under nodal forces with the unknowns fixed prescribed to values (0 by default).

fields(u, counts: int = 4) → list[dict][source]

For each patch, on a grid of parameters (counts per element and direction): the positions, the unknown and, for the elastic problems, the strains and the stresses there (Voigt’s notation); for conduction, the gradient and the flux.

at(u, patch: int, params) → dict[source]

The position, the unknown and its measures at parameters of a patch (points x ndim), as fields().

error(u, exact: Callable | None = None, exact_stress: Callable | None = None)[source]

The errors of a solution against an exact one: l2, the relative error of the unknown in the mean square (exact(x): points x unknowns), and energy, that of the stresses in the energy norm (exact_stress(x): points x components, Voigt’s notation); each for the function given.