morphogen.fracture¶
Fracture: cohesive zone elements along interfaces and crack paths, in small and finite
strains (morphogen.fracture.cohesive), the interfaces of the phases of periodic
cells that debond along the loading paths of the homogenization
(morphogen.fracture.periodic), the linear elastic fracture mechanics of 3D
cracks, their energy release rate and propagation on conforming (remeshed) meshes or by
XFEM (morphogen.fracture.lefm), and mixed-mode cracks (I, II, III) in small and
finite strains: the G-θ method, the interaction integrals, kinked cracks and their growth
(morphogen.fracture.mixed), with the behaviours of morphoGen’s points as their bulk
(elasto-viscoplasticity, porous and crystal plasticity, MFront; morphogen.fracture.bulk),
and their ductile growth on remeshed meshes, the state of the points transferred from mesh to
mesh, grain by grain in polycrystals (morphogen.fracture.ductile); cracks through a
morphology, its phases and pores on the crack meshes (crack_mesh() with morphology),
the sides of the crack apart, which feel the toughness of each phase and of the interfaces
between them: deflected along weak interfaces, held back by tough phases
(morphogen.fracture.toughness); cracks of any surface and front, each point of
which advances and kinks on its own (morphogen.fracture.surface); and the
brittle fracture of voxel images by the
phase-field method, whose cracks start, branch and merge without being tracked
(morphogen.fracture.phasefield; in finite strains, the rubbers and soft solids of
morphogen.fracture.phasefield_finite).
Public names¶
XFEM— A cracked body by the extended finite element method (see the module): a linear tetrahedralmeshof an isotropicmaterial, thecrack, the radiustip_radiuswithin which the nodes get the branch functions (by default twice the mean edge) and the number of refinements of the sub-tetrahedra of the elements near the front (refine).Advance— A candidate advance of a crack (see the module):kind"bulk"or"interface", theangleof its last segment from the last segment of the crack (radians, towards its normal), thecrackafter it, the energy release rateG(θ)of its direction (release_rate), the toughnessΓ(θ)it meets and what it meets (met: the phase whose toughness it is, or the pair of phases of the interface).Bilinear— The bilinear mixed-mode law (see the module):stiffnessK (penalty),normal_strengthN,shear_strengthS, the fracture energiesmode_Iandmode_II(G_Ic, G_IIc) and the exponentetaof Benzeggagh & Kenane.CohesiveCell— A cell whose interfaces may debond along a loading path (see the module): themeshof its phases (4- or 10-node tetrahedra; periodic conditions need the same faces of elements on the opposite faces of the cell), theirmaterials, the traction-separationlawof the interfaces (Bilinear,Exponential, orContactfor lips without adhesion, each with its coefficient offriction; or a mapping of its parameters:interface_law(), with the stiffest Young’s modulus of the cell and the size of its interface elements) and the boundary conditions ("periodic"or"kubc"). A law for each pair of phases: a mapping of the pairs to their laws,{(0, 1): law, (0, 2): other}— the interfaces are then those of these pairs, unlessfacessays otherwise ("grains": every boundary of a grain, with the law of the two phases that it parts,(1, 1)for two grains of the phase 1).CohesiveProblem— A body with interface elements (see the module):mesh(tetrahedra of 4 or 10 nodes, afterinsert_interfaces()), the cohesiveinterfaces(of three or six nodes a side, as the faces of the mesh), thematerialsof the phases, the cohesivelawand thekinematics("small"or"finite"strains).CohesiveResult— The steps of a cohesive problem: load factors, reactions (steps x prescribed sets x 3, summed over the nodes of each set), cracked area and largest damage, Newton iterations, the history of the interface points at the end (elements x 3, or x 6 for elements of six nodes a side) and their damage, the final displacement (nodes x 3), withfieldsthe displacements of the steps, and the works at each step (work:"external", of the prescribed displacements and the forces;"bulk"and"interfaces", of their internal forces: the energy stored and dissipated by each, which add up to the external work; with a law that rubs,"friction": the part of the work of the interfaces that friction dissipated).slip: the frictional slip of the points at the end (elements x points x 2, in the frame of each point: the tangents of its mid-surface), andfrictionthe energy that friction dissipated at each per unit area.Contact— Contact of the lips of a crack: a penaltystiffnessagainst their interpenetration (t_n = K min(δ_n, 0)), no normal traction otherwise; with a coefficient offriction, lips in contact stick (thetangentialstiffness of the stick, by default that of the penalty) or slide under Coulomb’sμ |t_n|(see the module). Points whose history is negative (CohesiveProblem.run()) are bonded by the two stiffnesses, in tension as in compression: the ligament ahead of the front of a crack whose lips rub (morphogen.fracture.mixed.solve_crack()).Crack— A planar crack (see the module):kind"straight"(frompointalongdirectionoversize) or"penny"(centrepoint, radiussize), its plane throughpointnormal tonormal.CrackSolution— A solved cracked body: its openedmesh, the lipsfaces(pairs of faces), thecrack, thematerialsof the phases, the kinematics, the finaldisplacement(nodes x 3), thestepsof the solver, the final nodalforces, the stiffness of thecontactof the lips and thebulkof points with its final state (inelastic bodies;PointBulk).DuctileGrowth— A ductile growth (see the module): the cracks at each advance, the load factors of the advances, the driving forces at the tip (tip) and far from it (far,J_ψon the domain;work, the J of the deformation theory), the stress intensity factors of the elastic estimates (advances x 3), the angles of the advances, every load step (history: rows of the advance, the load, the driving forces and the porosity near the tip), withkeepthe solutions of the advances, and with a toughness of the phases or of their interfaces the advances chosen (advances: theAdvanceof each crack; that of the last one is not taken).Exponential— The irreversible exponential law of Ortiz & Pandolfi (see the module): the cohesivestrengthσc, the fractureenergyG_c, the shear-to-normal ratiobeta, thepenaltystiffness in compression (by default10 e σc / δc), which is also that of the stick of the broken share, and the coefficient offrictionof that share.FinitePhaseFieldProblem— The brittle fracture of a periodic voxel image in finite strains (see the module):materialsof its phases, those that break hyperelastic or elastic (isotropic);fracture(PhaseField, or a mapping of its parameters);initial: the voxels broken from the start.tol: the relative residual of the linear solves;staggered_tol: the largest change of the damage that ends the alternate minimization of a step, of at mostmax_staggerediterations;nonlinear: the other options ofNonlinearFFTProblem(newton_tol,max_newton,max_cuts,integration,tangent).FrontGrowth— The steps of the growth of aSurfaceCrack: thecracks, the coordinatessof the stations of the interaction integrals along the front and, at them (steps x stations), the energy releaserates, the stress intensityfactors(a last axis: the three modes) and theanglesof kinking; the largest advance of each step and thecycles(Paris), withkeepthe solutions.Interfaces— Interface elements: the nodes of their sideminusand of their sideplus(matching; elements x 3 between 4-node tetrahedra, elements x 6 between 10-node ones: the corners, then the mid-edge nodes of the edges 0-1, 1-2 and 2-0), the phases of the two sides (elements x 2; -1 unknown); the normal goes from side - to side +.KinkedCrack— A crack with a straight front alongaxis, whose path in the planes normal to the front is the polyline ofpoints(from its mouth, on the boundary of the body, to its front): an edge or through crack that kinks as it grows (grown()); the normal of each segmenteisaxis × e(towards the side+).KinkedGrowth— The steps of a propagation: the cracks, their energy release rates, stress intensity factors (steps x 3), angles of their advances and cycles (Paris), withkeepthe solutions; with a toughness, the critical load factor of each crack (loads:sqrt(Γ / G)of its advance at the load of the growth) and its advance (advances: theAdvancechosen; that of the last crack is not taken).PhaseField— The fracture of the phases of a sample:toughness, the critical energy release rateG_cof all the phases (one value) or of each (a mapping phase ->G_c; the phases left out do not break), the regularizationlengthl(at least two voxels), themodel(MODELS), thesplitof the driving energy (SPLITS), theresidualstiffnesskof a broken voxel and theirreversibility:"bound"(the damage of each node never decreases) or"history"(the largest driving energy reached; see the module).PhaseFieldProblem— The brittle fracture of a periodic voxel image (see the module):materialsof its phases (elastic; the crystals turned by the orientations of theirgrains),fracture(PhaseField, or a mapping of its parameters),initial: the voxels broken from the start (a boolean array of the shape of the image).tol: the relative residual of the conjugate gradients;staggered_tol: the largest change of the damage that ends the alternate minimization of a step, of at mostmax_staggerediterations.PhaseFieldResult— The response of a cell that breaks along a loading path: aPathResult(the macroscopicstrainandstressat thetimes; its variableplasticis the mean damage of the phases that break, as that of each phase inphases) with thedamage(the same), the regularized area of the cracks per unit volume (crack_surface), the elastic and fracture energies per unit volume, and the alternate minimizations of each step (iterations). Withfields: the damage, strain and stress of the voxels at chosen times.strength()is the strength of the cell andwork()the work done on it: with the stored energy released, more than the fracture energy when the cell breaks at once (the cracks of a brittle cell run faster than its loading).PointBulk— The bulk of a crack problem (see the module): a mesh of linear tetrahedra, the materials of its phases (an orientation per grain ofmesh.cellfrommesh.orientations) and the kinematics;evaluate()integrates the points for a displacement,commit()keeps their state at the end of a converged step.Propagation— The steps of a propagation: crack sizes, energy release rates, stress intensity factors (mode I), cycles (Paris) or critical load factors (Griffith).SurfaceCrack— A crack of any surface (see the module):points(rows x stations x 3), the successive positions of its front from its centre (closed: the stations go round a front inside the body; the first row may be one point repeated) or from its mouth (an open front, whose first and last stations lie outside the body or on its boundary); the front is the last row. With the normalnof the surface towards the reader, the stations of a closed front go anticlockwise.Toughness— The toughness of the phases and of their interfaces (see the module):phasesone value for every phase or a dict of the phases (default: that of the phases not in it);interfacesNone (no interface criterion), one value for every interface between two solid phases, or a dict of pairs of phases (in either order; the pairs not in it: no criterion);morphology: the phases at points whose interfaces the advances follow (a function of points, or a microstructure:phases_at(); by default the phases of the elements of the crack meshes of a morphology).advance_candidates— The candidate advances of the crack of a solved body byincrement(see the module): the bulk, and along the interfaces ahead (paths: those ofinterface_paths(), computed by default).modes: those ofmodes()(computed by default);driving: the driving force of the bulk (by defaultGof the modes;J_tipof an inelastic bulk);kink: the bulk in the direction of the largest hoop stress, else straight.choose_advance— The candidate of the largest ratioG(θ) / Γ(θ)(the first, the bulk, on a tie).cohesive_zone_length—l_cz = M E G / T²(factorM: 1 after Hillerborg, 9π/32 after Rice for a bilinear law in mode I, 0.21 after Falk; Turon et al. 2007).conforming_work_of—crack -> (W, area)on conforming meshes,mesh_of(crack)meshing (or remeshing,crack_mesh()) the body for each crack;options: those ofconforming_work()(order=2for 10-node elements, with quarter points).crack_faces— The mesh with the faces of the crack opened, those between its two sides behind its front, and the pairs of faces of its lips (interface elements).sides: a label per element (by default the sidesmesh.sideof a crack mesh of a morphology, or the two phases of a mesh fromcrack_mesh(), whose interface MMG may have moved slightly, otherwise the sign ofφat the centroids of the elements).crack_mesh— A tetrahedral mesh of the box[lower, upper]conforming to the plane of the crack (MMG;optionsthose ofmorphogen.mesh.conforming.conforming_mesh()): the remeshing step of the conforming approach. Its two phases are the sides of the crack.grains: a tessellation (a polycrystal) whose cells the elements take (with_grains()).cut_mesh— The mesh of the phases of a morphology (linear tetrahedra) cut by the plane of a crack,φ = 0, and remeshed by MMG in its multi-material mode, each phase split into its two sides (the sizes those ofmorphogen.mesh.conforming.conforming_mesh()): a mesh conforming to the interfaces of the phases and to the crack, its phases inmesh.phaseand the sides of the crack inmesh.side(1 whereφ < 0, as the phases ofcrack_mesh()), the faces of the box kept plane. The values ofφat the nodes closer to zero than a fraction of their variation along the edges are moved away from it, as on the grids of the conforming meshes (no sliver).dcb_beam_theory— The corrected beam theory of the double cantilever beam (Williams 1989; Reeder et al.; Linke & Lammering 2023, eqs. 2 to 6): the load and the crack length against the openingopeningof the loading line, for arms of thicknessarmandwidthof an isotropic material, a precrackprecrackand the mode I fracture energy:P = 3 E I d / (2 (a + χ h)³)witha = a0until the crack grows, thena = (9 d² E I / (4 w G))^(1/4) - χ h;χ = sqrt(E / (11 S) (3 - 2 (Γ / (1 + Γ))²)),Γ = 1.18 E / S.dcb_specimen— A double cantilever beam of two arms of thicknessarm(lengthxwidth), meshed by six tetrahedra per voxel of edgesize(of 4 nodes, or of 10 withorder2), opened along its mid-plane: the mesh, the interface elements of the bonded part (beyond the precrack) and the node sets of the loading lines ("top","bottom": the nodes atx = 0on the mid-plane of each arm).dissipation— The energy dissipated in the bulk of a solved body: its work less its free energy (stored elastically and by hardening).energy_release_rate—G = -(Π(a + δ) - Π(a - δ)) / (A(a + δ) - A(a - δ)), the potential energies at fixed prescribed displacements and forces,solve(crack)returning theCrackSolutionof a crack: the check of the G-θ method (the mean along the front).face_forces— Nodal forces (3 n) of a uniformtractionon the boundary faces whose centroids (those of their corners) satisfywhere: a third of the force of each face to each of its nodes for 4-node elements; for 10-node ones the consistent forces of the six nodes of the face,∫ N_a dA(a third to each mid-edge node of a plane face with straight edges, nothing to its corners).insert_interfaces— Open faces of a tetrahedral mesh (see the module):facesis"phases"(the faces between different phases; side - the lower phase), a boolean mask of the interior faces or a function of the centroids of their corners (rows) returning one. Returns the mesh with the duplicated nodes and the interface elements of the opened faces (all of them: keep a subset for the cohesive ones, the others being free crack faces).sides: a label per element, the faces kept only between different labels (the two sides of a crack). A mesh of 10-node elements is opened by its corners; its mid-edge nodes are made again, each lip with its own, where they were (the curved edges of the interfaces of the phases stay curved), and the interface elements have six nodes a side.inside_elements— Whether points (rows) lie in an element of a mesh of linear tetrahedra (among thekwhose centroids are nearest;tol: of their barycentric coordinates).interface_law— The traction-separation law of a mapping: itslaw("bilinear", by default,"exponential"or"contact": lips without adhesion) and the parameters ofBilinear(normal_strengthandmode_Iat least),Exponential(strengthandenergy) orContact. Left out: the shear strength is the normal one, the energy of mode II that of mode I times the square of the ratio of the strengths (the separations at failure in the ratio of the strengths), and the penaltystiffnessis100 young / size: a Young’s modulus (the stiffest of the cell) over a length (the size of its interface elements).interface_nodes— The nodes (a mask) of the interfaces between the phases of a mesh and of its free faces off the faces of its box (the walls of its pores).interface_paths— The advances of the crack of a solved body along the interfaces within anincrementahead of its front (see the module):(angle, crack, pair)for each, the angle of its last segment from the last segment of the crack, the crack after it and the pair of phases of the interface (none without interfaces in the toughness).kink_angle— The direction of the largest hoop stress (Erdogan & Sih), in radians from the direction of propagation towards the normal of the crack.kinked_factors— The stress intensity factors(k_I, k_II)of a kink of infinitesimal length atangle(radians, from the direction of propagation towards the normal of the crack) from a front of factorsk1,k2(Cotterell & Rice 1980, to first order).kinked_release_rate— The energy release rateG(θ) = (k_I² + k_II²) / E' + K_III² / 2μof the kink atangle(kinked_factors(); a negativek_I, a closed kink, counts nothing).material_groups— The material of each element (of itsphase) as a label: the first phase of an equal material (phases of the same material make one group).material_nodes— The nodes (a mask) inside the material of the phasephaseof a crack mesh of a morphology: those whose elements all have it (the phases of the same material alike), off the walls of the pores (the free faces off the faces of the box and off thelips, anInterfacesof the opened crack).open_cell— Open faces of the mesh of a periodic cell on its torus (see the module):facesis"phases"(the faces between different phases; side - the lower phase),"grains"(between different grains of a polycrystal,mesh.cell), pairs of phases (the faces between the two phases of a pair) or a function of the centroids (rows) of the faces that two elements share, returning a mask.open_crack— The mesh with the crack opened and the area of the crack (seecrack_faces()).phase_field_fracture— The response of a periodic voxel image that breaks along a loading path: aPhaseFieldProblem(itsoptions:initial,grains,orientations,tol,staggered_tol,max_staggered) run alongpath; withkinematics="finite", in finite strains (FinitePhaseFieldProblem: hyperelastic or elastic phases, nominal strains and stresses, its options).phase_mesh— The background mesh of the box[lower, upper](six tetrahedra per cube of a grid of spacingbackground, by defaultsize / 2) cut by MMG along the zero level set of a morphology (two phases: negative in phase 1), without remeshing: a mesh conforming to the interfaces of its phases, its elements of any quality, to be cut by each crack and remeshed once (cut_mesh();crack_mesh()withconforming). The level set is sampled and moved away from zero near the nodes of the grid as formorphogen.mesh.conforming.conforming_mesh(); the plane of a crack is then cut on the same grid as by the crack meshes of a homogeneous body.phases_at— The phase of a morphology at points (rows): its point queries (two phases), or the voxel of an image of it whose voxels are aboutspacing(at most 256 per edge; by default 1/128 of its longest edge);morphologymay also be a function giving the phases of points.propagate— Grow a crack bystepsuniform advances of its front byincrement(see the module):Gat each size byrelease_rate()(delta: half the advance of its differences, by defaultincrement / 2),K = sqrt(E' G)(E' = E / (1 - ν²)in plane strain), the cycles of Paris’ lawda/dN = C K^m(paris = (C, m), the loading of the forces as the range) and the load factorsqrt(G_c / G)at which Griffith’s criterion is met (toughnessG_c).propagate_ductile— Grow a crack in an inelastic body (see the module):mesh_of(crack)meshes the body conforming to it (crack_mesh()),prescribed(entries, or a function of the opened mesh) andforces(nodal forces, or a function of the opened mesh) are grown byload_stepof the load factor insolver_stepssteps between the checks of the criterion:J_tip >= toughness, or the porosity of the porous points withinradiusof the front (by default 1.5 element)>= porosity; each of thestepsadvances the front byincrementin the direction of kinking (straight withkink=False), the state transferred bytransfer("nearest"or"projection"); the far driving forces on thedomain(r_in, r_out)(by default that ofrelease_rate: 1 to 4 elements); the loading stops atmax_load;optionsthose ofrun()(tol,max_newton…), butdurationis the time of a unit of the load factor (by default 1: the load factor is the time of the viscous behaviours), the same over all the loadings.propagate_front— Grow a crack of any surface, each point of its front by its own advance and at its own angle (see the module):mesh_of(crack)meshes the body conforming to it (crack_mesh()),prescribed(entries, or a function of the opened mesh) andloadload it (options: those ofsolve_crack()). At each of thestepsthe energy release rate and the factors are taken atstationsalong the front (at least two elements apart), and the point whereGis largest advances byincrement, the others byincrement (G / G_max)^(exponent / 2)(exponent: that of Paris’ law; withparis = (C, m)it ism, and the cycles are counted), each in the direction of the largest hoop stress of itsK_IandK_II;Gis that of the factors,(K_I² + K_II²) / E' + K_III² / 2μ.domain: the radiir_inandr_outof the domain of the interaction integrals (by default one and four elements, within the last advance). Around a closed front the advances and the angles are those of the Fourier series of their values at the stations up toharmonics(by default a third of the stations): a front that stays smooth, where the noise of the factors, raised to the power of Paris’ law, would scallop it.propagate_kinked— Grow a kinked crack (see the module):mesh_of(crack)meshes the body conforming to it (crack_mesh()),prescribed(entries, or a function of the opened mesh) andloadload it; each of thestepsadvances the front byincrementin the direction of kinking;paris = (C, m)counts the cycles;optionsthose ofsolve_crack().quarter_points— The mesh of 10-node tetrahedra whose mid-edge nodes on the edges that leave the nodesfront(those of a crack front: one end on it, the other not) are moved to a quarter of the edge from the front (Barsoum 1976): the displacements of these elements vary as the square root of the distance to the front along these edges, and their strains as its inverse, as the fields of a crack. The edges along the front and the others keep their mid-edge nodes.refine_front— A crack mesh (linear tetrahedra; its phases, or its phases and its sides) remeshed by MMG with elements ofsizewithinradiusof the front of the crack (by default four times that size), growing beyond it by the ratiogradationbetween neighbours up to the sizes of the mesh: the surfaces between its labels (the surface of the crack, the interfaces of the phases, the walls of the pores) and the faces of the box are kept.release_rate— The mean energy release rate along the front,(W(a + δ) - W(a - δ)) / (2 (A(a + δ) - A(a - δ))), from a function givingW = fᵀ uand the area of the crack.sent_factor— The geometry factor of the single edge notched plate in uniform tension,K = σ sqrt(π a) F(a/W)(Tada, Paris & Irwin; 0.5 % for a/W < 0.6).snap_front— The mesh with the nodes of the crack surface (between its two phases, the sides of the crack, or its two sidesmesh.side) withinfractionof the length of their edges from the front moved onto it, in the surface: the opened faces then end on the front, instead of a zigzag that lengthens or shortens the crack locally by a fraction of an element (the remeshing of Z-cracks, whose meshes have the front along their edges). A node stays if the move would leave an element around it belowqualitytimes its volume, a triangle of the surface below that fraction of its area, or a node of a face of the box off it; and, with its sides apart from its phases, the nodes of the interfaces of the phases and of the walls of the pores (interface_nodes()).solve_crack— Open the crack on its conforming mesh and solve the body (see the module):materialsa material (all the phases) or a dict of the phases;prescribedthe entries(nodes, components, value)ofrun(), or a function of the opened mesh returning them, andforcesnodal forces (3 x nodes, or a function of the opened mesh), both grown toloadtimes their values insteps(by default 1, or 10 in finite strains, with contact or an inelastic bulk);contact: the penalty stiffness of the contact of the lips (True:50 E / h; none by default) andfrictiontheir coefficient of friction (Coulomb: lips in contact stick or slide; see the module);bulk: that ofCohesiveProblem(inelastic phases: their points);options: those of the solver (tol,max_newton,duration…).through_voids— The crack grown on through the voids of a mesh (its pores) in which its front would end: its last segment lengthened by halves ofincrementuntil most of thecountpoints of its front, and most of the points a quarter ofincrementbehind them (on its lips), lie in elements again (inside_elements()), or its front leaves the box. A front that ran into a pore so goes through it, the crack then emanating from its far wall, its front a quarter to three quarters ofincrementbeyond it.traction— The traction (local components: normal, shear, shear) of a law for a separation (local components) from ahistory(damage or largest opening), and the new history: a material point of the interfaces. Withslip(the frictional slip of the point at the start: two components, zeros for a new point), also the new slip and the energy that friction dissipated per unit area on the way.transfer_displacement— The displacement (nodes x 3) of a solved body interpolated at the nodes of the mesh of another crack (see the module).transfer_state— The state of a solved inelastic body (itsPointBulk) transferred to thebulkof the openedmeshofcrack(see the module): the internal variables, the work densities and the committed stresses of its points bymethod("nearest"or"projection"), the strain measures of the transferred displacement, which it returns (nodes x 3).turon_strength— The cohesive strength that keepselementselements of sizeelement_sizein the cohesive zone (Turon, Dávila, Camanho & Costa 2007):sqrt(9π E G / (32 N_e l_e)).with_grains— The mesh with the grains of a tessellation (grains: itscell_of(points)and itsorientations): each element in the cell of its centroid (mesh.cell), the crystal orientations of the cells (mesh.orientations). The grain boundaries are then staircases of element faces, whose steps shrink with the elements; the crack meshes of a polycrystal stay conforming to the crack alone (MMG cuts one level set).with_phases— A crack mesh (its phases the sides of the crack) with the phases of a morphology: each element in the phase of the morphology at its centroid (mesh.phase, byphases_at()), the sides of the crack kept inmesh.side. The interfaces of the phases are then staircases of element faces, as the grain boundaries ofwith_grains().without_voids— A mesh without the elements of the phasesvoids(pores), and without the parts of it they leave apart whose volume is belowislandstimes that of the largest (more than one large part: an error, a body that falls apart).xfem_work—crack -> (W, area)by XFEM on a fixed mesh (forces,supports: functions of the mesh).