====== Contact Interactions ======

Contact elements are generated on the mesh using ''Interactions'' described below, in the same way as volume elements. 

===== Rigid-Defo contact =====

Interaction between a rigid body (die), meshed or not, and a deformable meshed entity.

  ci = RdContactInteraction(number)
  ci.setTool(gObject1)
  ci.push(gObject2)
  ci.setSmoothNormals(bool)
  ci.addProperty(prp)
  interactionset.add(ci) 

where
| ''number'' | number of the ''Interaction''|
| ''gObject1'' | Reference of a geometric object (facetised contact), meshed or not|
| ''gObject2'' | Reference of a meshed geometric object|
| ''prp'' | [[doc:user:elements:general:def_element_properties|Properties]] of [[doc:user:elements:contact:elements|contact elements]] to generate |
| ''setTool'' | Rigid tools |
|''setUseMultiProj(bool)'' \\ \\ Revision >= v3542| Option only used with meshed (facetised) tool \\ = True (default) : use of multiple projection operator :  ''[[doc:user:geometry:user:contours#remarques|MultiProjWire]]'' or ''[[doc:user:geometry:user:peaux#remarques|MultiprojSkin]]''. The unification of the normal depend of smoothNormal parameter value \\ = False : use Single projection operator ''[[doc:user:geometry:user:contours|Wire]]'' or  ''[[doc:user:geometry:user:peaux|Skin]]'' designed for C1 geometrical tools (tool MUST RESPECT the normal continuity) |
|''setSmoothNormals(bool)''  \\ \\ Revision >= v3542| Option only used with meshed (facetised) tool AND if ''useMultiProj = True'' \\ = True (default) : unify multiple projection with a smoothed normal formulation \\ = False : select the best projection as an unique projection (assume discontinuity) |
|''setSmoothNormals(bool)''  \\ OLD \\ Revision < v3542| Facetised tool\\ = True (default) : continuous normal - projection on a ''[[doc:user:geometry:user:contours#remarques|MultiProjWire]]'' or ''[[doc:user:geometry:user:peaux#remarques|MultiprojSkin]]''\\ = False : discontinuous normal -  projection on ''[[doc:user:geometry:user:contours|Wire]]'' or  ''[[doc:user:geometry:user:peaux|Skin]]''|

===== Defo-Defo contact ===== 

Interaction between two different deformable meshed entities. By default, contact is double in two steps. First, the nodes from the second body are considered as slaves of the first body, then, nodes from the first are considered as slaves of the second.

  ci = DdContactInteraction(number)
  ci.setTool(gObject1)
  ci.push(gObject2)
  ci.setSmoothNormals(bool)
  ci.setGeoContact()
  ci.setSinglePass()
  ci.addProperty(prp)
  interactionset.add(ci) 

where
| ''number'' | number of the ''Interaction''|
| ''gObject1'', ''gObject2'' | Reference of a meshed geometric object|
| ''prp'' | [[doc:user:elements:general:def_element_properties|Properties]] of [[doc:user:elements:contact:elements|contact elements]] to generate |
| ''setTool'' | "Preferential" tool (tool in one step and for [[doc:user:elements:contact:elements#tm_2_contact_2_3_delement|thermomechanical contact]])|
| ''setSmoothNormals(bool)'' | Facetised tool\\ = True (default) : continuous normal - projection on a ''[[doc:user:geometry:user:contours#remarques|MultiProjWire]]'' or ''[[doc:user:geometry:user:peaux#remarques|MultiprojSkin]]''\\ = False : discontinuous normal (normal not smoothed, might lead to convergence issue)-  projection on ''[[doc:user:geometry:user:contours|Wire]]'' or  ''[[doc:user:geometry:user:peaux|Skin]]''|
| ''setSinglePass()'' | Contact in one step (Nodes from second body are slaves of the first one)|
| ''setGeoContact()'' | Contact between nodes of the second body and a [[doc:user:geometry:user:courbes#spline_cubique|spline]] rebuild from nodes of the first body|

===== Auto - Contact =====

Interaction between two parts of a same meshed body.

  ci = ScContactInteraction(number)
  ci.push(gObject1)
  ci.setSmoothNormals(bool)
  ci.addProperty(prp)
  interactionset.add(ci) 

where
| ''number'' | number of the ''Interaction''|
| ''gObject1'' | Reference of a meshed geometric object |
| ''prp'' | [[doc:user:elements:general:def_element_properties|Properties]] of [[doc:user:elements:contact:elements|contact elements]] to generate |
| ''setSmoothNormals(bool)'' | Facetised tool\\ = True (default) : continuous normal - projection on a ''[[doc:user:geometry:user:contours#remarques|MultiProjWire]]'' or ''[[doc:user:geometry:user:peaux#remarques|MultiprojSkin]]''\\ = False : discontinuous normal -  projection on ''[[doc:user:geometry:user:contours|Wire]]'' or  ''[[doc:user:geometry:user:peaux|Skin]]''|

===== Rigid-Defo contact driven with a force =====

Interaction between a rigid body (die) and a deformable meshed entity. When this contact interaction is instantiated, the rigid body gets a node to impose force monitoring. Consequently, the body has rigid body modes in translation.

  ci = FdRdContactInteraction(number)
  ci.setTool(gObject1)
  ci.push(gObject2)
  ci.setSmoothNormals(bool)
  ci.addProperty(prp)
  interactionset.add(ci) 

where

| ''number'' | number of the ''Interaction''|
| ''gObject1'' | Reference of a geometric object (facetised contact), meshed or not|
| ''gObject2'' | Reference of a meshed geometric object|
| ''prp'' | [[doc:user:elements:general:def_element_properties|Properties]] of [[doc:user:elements:contact:elements|contact elements]] to generate |
| ''setTool'' | Rigid tools |
| ''setSmoothNormals(bool)'' | Facetised tool\\ = True (default) : continuous normal - projection on a ''[[doc:user:geometry:user:contours#remarques|MultiProjWire]]'' or ''[[doc:user:geometry:user:peaux#remarques|MultiprojSkin]]''\\ = False : discontinuous normal -  projection on ''[[doc:user:geometry:user:contours|Wire]]'' or  ''[[doc:user:geometry:user:peaux|Skin]]''|