ConstitutiveLaws

Constitutive laws

This page should grow to give overview of all constitutive laws in Yade. The purpose is twofold:

1. Names of respective classes do not say much and it seems that lot of code is duplicated; should improve orientation in material models available
2. 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 exists 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	Bourrier2013	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_CpmPhys_Cpm	model for concrete	mature	no	-	-	Václav Šmilauer, Jan Stransky	Jan Stransky
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_ScGeom6D_NormalInelasticityPhys_NormalInelasticity	Contact law used to simulate granular filler in rock joints including cohesion, moment transfer and inelastic compression behaviour.	mature	yes	Duriez2009, Duriez2011	normalInelasticity-test.py	Jérôme Duriez	J. Duriez
Law2_ScGeom_ViscElPhys_Basic	Visco-elastic contact law which supports explicit parameter input (Kn, Ks, Cn and Es) and implicit (contact time, restitution coefficient).	mature	yes	Pournin2001	Many scripts in examples/-directory, grep for ViscElPhys there (baraban.py, bulldozerVTK.py etc.).	Anton Gladky	-
Law2_ScGeom_ViscElCapPhys_Basic	Extended version of linear viscoelastic model with capillary parameters	-	-	-	-	Anton Gladky	-
Law2_ScGeom_JCFpmPhys_JointedCohesiveFrictionalPM	Elastic contact law with cohesion and joints for fractured rock modelling.	mature	yes	Scholtes2012	in folder jointedCohesiveFrictionalPM	Luc Scholtes, J. Duriez	-
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_ScGeom6D_InelastCohFrictPhys_CohesionMoment	Inelastic contact law with cohesion, twist and bending.	-	no	-	-	Ignacio Olmedo, François Kneib	-
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_ScGeom_LudingPhys_Basic	Cohesive contact model	-	more or less	Luding2008, Singh2013	LudingPM.py	Anton Gladky (coded)	-
Law2_ScGeom_MindlinPhys_HertzWithLinearShear
Law2_ScGeom_MindlinPhys_MindlinDeresiewitz
Law2_ScGeom_BubblePhys_Bubble
Law2_ScGeom_FrictViscoPhys_CundallStrackVisco
Non-ScGeom laws
Law2_L3Geom_FrictPhys_ElPerfPl
Law2_L6Geom_FrictPhys_Linear
Law2_ScGridCoGeom_FrictPhys_CundallStrack
Law2_ScGridCoGeom_CohFrictPhys_CundallStrack
Law2_GridCoGridCoGeom_FrictPhys_CundallStrack
Law2_TTetraSimpleGeom_NormPhys_Simple
PolyhedraVolumetricLaw