morphogen.contact

Contact, self-contact and friction of the surfaces of a mesh, between themselves and with rigid obstacles, in small and finite strains.

Surfaces. A Surface is a set of faces of a tetrahedral mesh (three nodes, or six on 10-node elements, which may be curved), their normals out of the body: the free faces of the mesh (Surface.of()), all or some. A Pair is a slave surface and a master surface that may touch, or one surface that may touch itself (the walls of pores, the struts of a lattice); an Obstacle a rigid plane, sphere, cylinder or cone that moves with the load factor. Bodies meshed apart are brought into one mesh by assemble().

Discretization. The contact is enforced at the integration points of the faces of the slave surface (three per face of three nodes, six per face of six), each with its share of the reference area: its position x_s, the nearest point x_m of the master surface (the nearest point of a face among the master faces nearest by their centroids: Ericson’s regions on a triangle, Newton’s method on a curved face of six nodes and on its edges), the outward normal n of the master there and the gap g = (x_s - x_m) · n. A point presses when p = <λ - ε g> is positive (ε the penalty, λ the multiplier of the augmented Lagrangian, zero for the penalty alone); the force w (p n - t) goes to the nodes of its face by their functions, and its opposite to those of the master face by theirs at x_m. Only master faces that face the slave point (opposite normals) and that it has not passed by more than a given depth are looked at: a point further behind a face is across a wall, not through it; a surface against itself also leaves out the faces that share a node with that of the point. The tangent of the forces of a point is taken by central differences on the nodes of its two faces.

Corners and edges. The points inside the faces leave the corners and the edges of a body without a point: a corner that lands on a face enters it until the points next to it press. With points="nodes" (of a Pair, an Obstacle, a ContactCell, compression()) the slave points are at the nodes of the faces instead (their vertices; the middles of their edges and their centroids as well on faces of six nodes). The weight of such a point is the share of its face that the other surface sees (the cosine of the angle of their normals): the sides of a block that stands on a plane, which share the nodes of the edges of its base, carry nothing.

Friction (Coulomb; Laursen & Simo 1993 for the frame-indifferent slip). The slip of a point over a step is the move of x_m from the place, now, of the point of the master that faced it at the end of the last step (the same material point of the master: no slip under a rigid motion of the two bodies), in the tangent plane. The traction of the last step, turned into that plane with its norm, plus the stick ε_t times the slip, is returned radially to Coulomb’s cone |t| <= μ p; what is cut off is the slip that dissipates. A point rubs from the step after that in which it came into contact.

Solution. ContactProblem is the quasi-static solver of the cohesive zones (CohesiveProblem: prescribed displacements, dead loads, loadings in stages, an elastic or neo-Hookean bulk or the behaviours of morphoGen’s points, cohesive interfaces as well) with these forces. The faces that each slave point sees are searched again at each evaluation. The first tangent of a step is that of a predictor in which the points that touched at its start stay closed and stick. With augmentations, the multipliers are updated (Uzawa: λ <- <λ - ε g>) and the step solved again until no point penetrates deeper than a tolerance.

Periodic cells. ContactCell is the periodic element of the nonlinear homogenization with the contact of the walls of its pores, between themselves and with their images across the faces of the cell (morphogen.contact.periodic): loading paths in strains and stresses, the behaviours of morphoGen’s points, the macroscopic stress with the part that the contacts carry through the faces.

Ready-made tests (morphogen.contact.experiments). compression(): a sample between two rigid platens, on which it rubs, its walls free to close on themselves (the nominal stress against the nominal strain, the areas in contact); indentation(): a sphere or a cone pressed into its upper face, and out again (the force against the depth, the area of the contact, and the reduced modulus that the force reads by Hertz’s or Sneddon’s law, or by the slope of the unloading).

The results (ContactResult): at each step, the area in contact, the largest pressure and the force of each contact, the works (those of the bulk and of the contact add up to that of the grips), the energy that friction dissipated and the work of the obstacles; at the end the pressure, traction and gap of each slave point. The closed forms of morphogen.contact.hertz (Hertz, Sneddon, Cattaneo-Mindlin) are those of the checks.

Public names

  • CompressionResult — The compression of a sample between two platens. At each step: the nominal strain (the approach of the platens over the height of the sample: negative), the force that the sample exerts on the moving platen (positive), the nominal stress (minus this force over the section of the box of the sample: negative), the area in contact with the platens (steps x 2: the fixed one, the moving one; reference area), the area of the walls of the sample in contact with themselves (self_area, of one of the two sides) and the energy that friction dissipated (friction). section and height: those of the box of the sample. result: the steps of the problem ( ContactResult: reactions, works, the slave points at the end); problem: the problem (write() for its fields).

  • ContactCell — A cell whose free surface may touch itself along a loading path (see the module): the mesh of its solid (the pores left out: conforming_mesh(..., phases="solid"), or mesh.subset), the materials of its phases and the boundary conditions ("periodic": the walls also meet their images across the faces of the cell; "kubc").

  • ContactProblem — A body, or several in one mesh (assemble()), whose surfaces may touch each other, themselves and rigid obstacles (see morphogen.contact): mesh (tetrahedra of 4 or 10 nodes), the materials of its phases, the pairs of surfaces (Pair) and the obstacles (Obstacle).

  • ContactResult — The steps of a contact problem: the load factors, the reactions of the prescribed sets (steps x sets x 3), the Newton iterations, the final displacement (nodes x 3), with fields those of the steps, and for each contact (the pairs, then the obstacles: names) at each step the area in contact (reference area of the slave points that press; of one of the two sides for a symmetric pair or a surface that touches itself), the largest pressure (the points of the two sides then each carry half of it: theirs are doubled) and the forces of the slave surface on its master or on its obstacle (steps x contacts x 3); the deepest penetration of each step. work: at each step, "external" (of the prescribed displacements and forces), "bulk", "interfaces" and "contact" (of their internal forces: they add up to the external work; that of the contact is the energy of the penalty and of friction, less the work of the obstacles that move), "friction" (dissipated by friction) and "obstacles" (done by the obstacles on the body). points: for each contact, the slave points at the end, a dict of their position, pressure, tangential traction, gap, weight (reference area; of the points at the nodes of the faces, the share that the other surface sees) and energy dissipated by friction per unit area. cohesive: the steps of the cohesive interfaces of the problem, if any.

  • IndentationResult — The indentation of a sample. At each step: the depth of the indenter under the surface, the force on it, the area of the contact (the reference area of the points that press), its radius (of the disc of the same area), the largest pressure and the hardness (the mean pressure, force over area); modulus: the reduced modulus E / (1 - ν²) of the homogeneous half-space that would take the force at that depth (Hertz for a sphere, Sneddon for a cone: that of the sample while the contact is small against it and against its heterogeneities). With an unloading: stiffness, the slope of the force at its start, and unloading_modulus, S sqrt(π) / (2 sqrt(A)) (Oliver and Pharr 1992: the area is that of the points, known to a ring of them). radius_of_indenter (a sphere), thickness (of the sample under its face) and base: those of the test. result and problem: as for a compression.

  • Obstacle — A rigid obstacle that the integration points of the faces of surface stay out of, with Coulomb’s friction on it; stiffness and tangential: as for a Pair. motion: its translation, a vector grown with the load factor (load factor x motion) or a function of the load factor returning one; the force that the body exerts on it is a result of each step.

  • Pair — Two surfaces that may touch: the integration points of the faces of slave are kept out of master (and those of master out of slave too with symmetric: two passes, for bodies of like stiffness and meshes). slave alone (master None): a surface that may touch itself, the walls of pores or the struts of a lattice (every face against the others, those that share a node with it left out).

  • Surface — Faces of a tetrahedral mesh that may touch others: rows of three nodes (4-node tetrahedra) or of six (10-node ones: the corners, then the middles of the edges 0-1, 1-2 and 2-0), their normals out of the body.

  • assemble — Bodies meshed apart as one mesh, for their contact: the nodes and elements of the meshes one after the other (nothing is merged: nodes at the same place stay apart), in the box of them all; phases: a phase per mesh in place of their own (by default each mesh keeps its phases).

  • compression — Compress a sample between two rigid platens across axis: the platens are the planes of the two faces of the box of the mesh (that of the solid of a porous sample: conforming_mesh(..., phases="solid")), the lower one fixed, the upper one brought down by -strain times the height of the box (strain: the nominal strain, negative) in steps steps.

  • effective_modulus — The modulus of the contact of two isotropic bodies, 1/E* = (1 - ν1²)/E1 + (1 - ν2²)/E2; of one body against a rigid one without young_other.

  • flat_punch — The indentation of a half-space by a rigid flat punch of radius to a depth: F = 2 a E* h.

  • hertz_cylinder — Hertz’s contact of a cylinder of radius and a plane along a line, under a force per unit length: the half-width of the contact b = sqrt(4 F R / (π E*)) and the largest pressure p0 = 2 F / (π b), with the pressure p0 sqrt(1 - x² / b²).

  • hertz_sphere — Hertz’s contact of a sphere of radius and a plane (or of two spheres: 1/R = 1/R1 + 1/R2) of effective modulus E*, under a force or an approach of the two bodies: F = 4/3 E* sqrt(R) δ^(3/2), the radius of the contact a = sqrt(R δ) and the largest pressure p0 = 3 F / (2 π a²), with the pressure p0 sqrt(1 - r² / a²).

  • indentation — Indent the upper face of a sample (across axis) to a depth by a rigid indenter: a "sphere" of radius, or a "cone" of half_angle (degrees from its axis; 70.3: the cone of the same area as the pyramids of Berkovich and Vickers), at point of the face (two coordinates along it; by default its middle), in steps steps, then out again in as many with unload.

  • layer_correction — The factor by which the rigid base of a layer of thickness multiplies Hertz’s force of a sphere of radius pressed to a depth into it (Dimitriadis et al. 2002): with χ = sqrt(R δ) / h, the radius of the contact over the thickness,

  • mindlin_stick_radius — The radius of the stick zone of a Hertz contact of radius radius under a tangential force below μ N (Cattaneo 1938; Mindlin 1949): c = a (1 - T / (μ N))^(1/3), a ring of slip around it.

  • sneddon_cone — Sneddon’s indentation of a half-space of effective modulus by a rigid cone of half_angle (degrees, from its axis) to a depth: F = 2/π E* tan(α) h² and the radius of the contact a = 2/π h tan(α).

  • walls — The free faces of a cell that are not on its boundary: the walls of its pores (the faces of the solid on the faces of the box, or on the outer boundary of whole periodic cells, go on in the neighbouring cells).

Modules