ConstitutiveLaws
From Yade
Constitutive laws
This page should grow to give overview of all constitutive laws in Yade. The purpose is twofold:
- Names of respective classes do not say much and it seems that lot of code is duplicated; should improve orientation in material models available
- Not all laws are in the same development stage. Some of them are well validated while others are purely experimental. Users should quickly find out which ones are safe to use in this table.
Yade users are strongly encouraged to choose one of the green laws unless a reason exist to decide otherwise.
| Legend | |
|---|---|
| Green | Actively used and maintained without known bugs. Safe to use. |
| Yellow | In developement. Could be functional but may be subjected to frequent changes and bugs. |
| Red | Orphan. Though possibly useful, the code has no identified maintainer. The help from mailing list will be limited and bugfixes may never come. For prepared users. |
| Class | description | dev. status | validated | publications | example script | maintainer(s) | active users |
|---|---|---|---|---|---|---|---|
| Law2_ScGeom_FrictPhys_CundallStrack | The traditional Cundall's linear elastic-plastic law. This law has three parameters : tangential stiffness, normal stiffness, and friction coefficient - it modelizes dry contacts (no tensile force allowed). | mature | yes | (>10 papers) e.g. Scholtes2009c, Chareyre2012a | triax-basic.py | Bruno Chareyre | >20 |
| Law2_ScGeom6D_CohFrictPhys_CohesionMoment | An augmented version of Law2_ScGeom_FrictPhys_CundallStrack with cohesion and torques at contacts. Creep is optional. | mature | yes | not yet | triax-cohesive.py | Bruno Chareyre | F. Kneib |
| Law2_ScGeom_MindlinPhys_Mindlin | The non-linear elastic Hertz-Mindlin no-slip solution contact law. The law also allows for rolling resistance and non-linear viscous damping. | mature | yes | Modenese2012b | mindlin.py | Chiara Modenese | C. Modenese, C. Jakob |
| Law2_ScGeom_WirePhys_WirePM | A contact law for steel wires which is defined by a piece-wise linear stress-strain curve. The contact law considers tensile forces only. | mature | yes | Thoeni2011, Bertrand2008 | WireMatPM/wirecontacttest.py WireMatPM/wiretensiltest.py | Klaus Thoeni | K. Thoeni |
| Law2_CylScGeom_FrictPhys_CundallStrack | Similar to Law2_ScGeom_FrictPhys_CundallStrack but adapted to interactions between spheres and chained cylinders. | in development | more or less | not yet | chained-cylinder-roots.py | Bruno Chareyre, François Kneib | B. Chareyre, F. Kneib, I. Olmedo |
| Law2_CylScGeom6D_CohFrictPhys_CohesionMoment | Similar to Law2_ScGeom6D_CohFrictPhys_CohesionMoment but adapted to interactions between spheres and chained cylinders. | in development | no | not yet | CohesiveCylinderSphere.py | François Kneib, Bruno Chareyre | B. Chareyre, F. Kneib, I. Olmedo |
| Law2_ScGeom_ViscoFrictPhys_CundallStrack | Generalized Maxwell model of visco-elasto-plastic interactions (2 springs and 2 dashpots for each force component). | in development | no | - | Bruno Chareyre | B. Chareyre | |
| Law2_SomeGeom_CpmPhys_Cpm | A generic class for inheritance by more specialized functors (e.g.Law2_ScGeom_CpmPhys_Cpm). Not to be used in simulations. | ||||||
| Law2_Dem3DofGeom_CpmPhys_Cpm | |||||||
| Law2_Dem3DofGeom_RockPMPhys_Rpm | |||||||
| Law2_L3Geom_FrictPhys_ElPerfPl | |||||||
| Law2_L6Geom_FrictPhys_Linear | |||||||
| Law2_ScGeom6D_NormalInelasticityPhys_NormalInelasticity | |||||||
| Law2_ScGeom_CFpmPhys_CohesiveFrictionalPM | |||||||
| Law2_ScGeom_CpmPhys_Cpm | |||||||
| Law2_ScGeom_MindlinPhys_HertzWithLinearShear | |||||||
| Law2_ScGeom_MindlinPhys_MindlinDeresiewitz | |||||||
| Law2_ScGeom_ViscElPhys_Basic |