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 nominalstrain(the approach of the platens over the height of the sample: negative), theforcethat the sample exerts on the moving platen (positive), the nominalstress(minus this force over the section of the box of the sample: negative), theareain 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).sectionandheight: 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): themeshof its solid (the pores left out:conforming_mesh(..., phases="solid"), ormesh.subset), thematerialsof 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 (seemorphogen.contact):mesh(tetrahedra of 4 or 10 nodes), thematerialsof its phases, thepairsof surfaces (Pair) and theobstacles(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), withfieldsthose of the steps, and for each contact (the pairs, then the obstacles:names) at each step theareain 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 largestpressure(the points of the two sides then each carry half of it: theirs are doubled) and theforcesof the slave surface on its master or on its obstacle (steps x contacts x 3); the deepestpenetrationof 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 theirposition,pressure, tangentialtraction,gap,weight(reference area; of the points at the nodes of the faces, the share that the other surface sees) and energydissipatedby 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: thedepthof the indenter under the surface, theforceon it, theareaof the contact (the reference area of the points that press), itsradius(of the disc of the same area), the largestpressureand thehardness(the mean pressure, force over area);modulus: the reduced modulusE / (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, andunloading_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) andbase: those of the test.resultandproblem: as for a compression.Obstacle— A rigid obstacle that the integration points of the faces ofsurfacestay out of, with Coulomb’sfrictionon it;stiffnessandtangential: as for aPair.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 ofslaveare kept out ofmaster(and those ofmasterout ofslavetoo withsymmetric: two passes, for bodies of like stiffness and meshes).slavealone (masterNone): 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 themeshesone 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 acrossaxis: the platens are the planes of the two faces of the box of themesh(that of the solid of a porous sample:conforming_mesh(..., phases="solid")), the lower one fixed, the upper one brought down by-straintimes the height of the box (strain: the nominal strain, negative) instepssteps.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 withoutyoung_other.flat_punch— The indentation of a half-space by a rigid flat punch ofradiusto adepth:F = 2 a E* h.hertz_cylinder— Hertz’s contact of a cylinder ofradiusand a plane along a line, under aforceper unit length: the half-width of the contactb = sqrt(4 F R / (π E*))and the largest pressurep0 = 2 F / (π b), with the pressurep0 sqrt(1 - x² / b²).hertz_sphere— Hertz’s contact of a sphere ofradiusand a plane (or of two spheres:1/R = 1/R1 + 1/R2) of effectivemodulusE*, under aforceor anapproachof the two bodies:F = 4/3 E* sqrt(R) δ^(3/2), the radius of the contacta = sqrt(R δ)and the largest pressurep0 = 3 F / (2 π a²), with the pressurep0 sqrt(1 - r² / a²).indentation— Indent the upper face of a sample (acrossaxis) to adepthby a rigidindenter: a"sphere"ofradius, or a"cone"ofhalf_angle(degrees from its axis; 70.3: the cone of the same area as the pyramids of Berkovich and Vickers), atpointof the face (two coordinates along it; by default its middle), instepssteps, then out again in as many withunload.layer_correction— The factor by which the rigid base of a layer ofthicknessmultiplies Hertz’s force of a sphere ofradiuspressed to adepthinto 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 radiusradiusunder 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 effectivemodulusby a rigid cone ofhalf_angle(degrees, from its axis) to adepth:F = 2/π E* tan(α) h²and the radius of the contacta = 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).