morphogen.iga.shapes

Geometries for isogeometric analyses: patches and assemblies with exact arcs.

A circular arc of half-angle a is a rational curve of degree 2: its ends, the point where their tangents meet, and the weights (1, cos a, 1) (Piegl & Tiller 1997, ch. 7); an ellipse is the image of a circle by a linear map of its control points. The patches here are ruled between two such curves — linear across, of the degree of the curves along — with positive Jacobians:

  • rectangle(), box(): a rectangle or a box, of any degree;

  • annulus(): a sector of a ring (a thick-walled cylinder in plane strain);

  • plate_with_hole(): a quarter of a square plate with a central hole, two patches (the benchmark of Kirsch’s solution, and of shape optimization);

  • cell_with_hole(): a rectangular cell with a hole, four patches around it, whose opposite sides match: a periodic cell (porous and architectured materials), the hole a circle, an ellipse, or any closed curve through its control points; the cell may be a parallelogram (the rhombus of a hexagonal array of holes);

  • alternating_holes(): a sheet with elongated holes at the nodes of a square lattice, turned in turn along its two axes — the pattern of the rotating squares, auxetic when its ligaments are thin (Grima & Evans 2000; Bertoldi et al. 2010; Taylor et al. 2014);

  • tiling(): cells side by side as one assembly (several holes per period); repeated(): a cell and its neighbours along its periods;

  • extruded(): a surface swept along the third axis into a solid.

morphogen.iga.shapes.rectangle(lower=(0.0, 0.0), upper=(1.0, 1.0), degree: int = 1, phase: int = 0) → Patch[source]

The rectangle of corners lower and upper: one element of degree.

morphogen.iga.shapes.box(lower=(0.0, 0.0, 0.0), upper=(1.0, 1.0, 1.0), degree: int = 1, phase: int = 0) → Patch[source]

The box of corners lower and upper: one element of degree.

morphogen.iga.shapes.arc(radius: float, start: float, end: float, centre=(0.0, 0.0)) → tuple[ndarray, ndarray][source]

The three control points and weights of the circular arc from the angle start to end (less than a half-turn apart): exact, of degree 2.

morphogen.iga.shapes.ruled(first, second, weights_first=None, weights_second=None, degree: int = 2, phase: int = 0) → Patch[source]

The patch between two curves of the same degree given by their control points (n x 2 each, without inner knots): direction 0 along the curves, direction 1 from the first to the second (linear).

morphogen.iga.shapes.annulus(inner: float, outer: float, angle: float = 1.5707963267948966, start: float = 0.0, centre=(0.0, 0.0), phase: int = 0) → Patch[source]

A sector of the ring between the radii inner and outer, from the angle start over angle (less than a half-turn): direction 0 along the arcs (clockwise, so that the Jacobian is positive), direction 1 from the inner to the outer radius.

morphogen.iga.shapes.plate_with_hole(radius: float = 1.0, half_width: float = 4.0, phase: int = 0) → Multipatch[source]

A quarter (x, y >= 0) of a square plate of half-width half_width with a circular hole of radius at the origin: two patches, from the right and upper sides (direction 1 = 0) to the arcs of the hole (direction 1 = 1), along which direction 0 turns anticlockwise.

morphogen.iga.shapes.cell_with_hole(lengths=(1.0, 1.0), hole=0.25, elements: int = 1, origin=(0.0, 0.0), phase: int = 0) → Multipatch[source]

The rectangular cell of lengths (its lower corner at origin) with a hole at its centre (see _hole_arcs(): a radius, an ellipse, or a closed curve): four patches, one per side of the cell, from the side (direction 1 = 0) to the arc of the hole that faces it (direction 1 = 1), direction 0 anticlockwise; elements along each arc. Opposite sides have matching control points: a periodic cell.

lengths may be the two vectors of a parallelogram instead (2 x 2, one per row, anticlockwise): the cell of an oblique lattice, which the assembly then carries (lattice) — [[1, 0], [0.5, sqrt(3) / 2]] for a hexagonal array of holes.

morphogen.iga.shapes.alternating_holes(spacing: float = 1.0, hole=(0.35, 0.15), elements: int = 1, phase: int = 0) → Multipatch[source]

A sheet with elliptic holes at the nodes of a square lattice of spacing along x and y, elongated in turn along x and along y: hole = (a, b), the half-axes along and across a hole (a + b < spacing; a radius for circles), the hole at the origin along x. Between four holes the sheet is a square grain, held to its four neighbours by the ligaments left between the tip of a hole and the flank of the next, of width spacing - a - b: thin ligaments let the grains turn, and the sheet widens when pulled (the rotating squares).

The assembly is two grains side by side, cut nowhere — [0, 2 spacing] x [0, spacing] without its quarters of holes — whose periods are (spacing, spacing) and (spacing, -spacing) (its lattice): two holes a period. Each grain is eight patches around its centre, two along each of its quarters of holes, from the arc (direction 1 = 0) to a curve between the centre of the grain and the middle of a ligament, which it crosses squarely (direction 1 = 1), with elements along each arc. The patches 0 and 1 are those of the hole at the origin: their arcs run from its flank (0, b) to a point p, then from p to its tip (a, 0), facing the curves from the middle of the left ligament to the centre and from the centre to the middle of the lower ligament; the other quarters are their images by the symmetries of the pattern (the mirrors x = 0 and y = 0, the quarter-turn about the centre of a grain).

morphogen.iga.shapes.tiling(cells) → Multipatch[source]

The assembly of several assemblies (or patches) placed side by side: their patches together, the control points of their common sides merged.

morphogen.iga.shapes.repeated(cell: Multipatch, counts=(2, 2)) → Multipatch[source]

A cell and its neighbours: counts copies along each of its periods (those of its lattice, or the sides of its box), as one assembly — for figures, or a larger period.

morphogen.iga.shapes.extruded(surface, height: float, degree: int = 1) → Multipatch[source]

The solid swept by a surface (a patch or an assembly in the plane) along the third axis over height: direction 2 of each patch, of degree.