mpacts.contact.models.collision. dmt_matrix

In order to be able to use this module import it like this:

import mpacts.contact.models.collision.dmt_matrix
#or assign it to a shorter name
import mpacts.contact.models.collision.dmt_matrix as dmt

DMTMatrix

Description: DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules. Geometry combinations available:

PC2 | PC1 - Sphere Rigid_Triangle Rigid_Sphere Rigid_Quad Rigid_CylinderTop Rigid_CylinderBottom Rigid_Cylinder Rigid_Cone Rigid_Capsule Deformable_Cylinder Deformable_Capsule
Sphere YES YES YES YES YES YES YES YES YES YES YES
Rigid_Sphere   YES YES YES YES YES          
Rigid_Capsule                 YES   YES
Deformable_Capsule                     YES

DMTMatrix (Deformable_Capsule Deformable_Capsule)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • abort_if_different (default value = 0) — If ‘True’, inverts the regular function of ‘AbortIfSameParent’, and makes the contact model early abort if the particles’ parents are different. Please do not change this ‘Property’ if you are not sure what you are doing.
    • contact_data_storage_factory (default value = None) — The contact data storage factory to make contact data. Do not change! Especially vector in parallel is not a safe choice here.
    • contact_data (default value = None) — The contact data belonging to the DoF (parents) made by this model.
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
    • torque_factor (default value = 1) — Optional factor to differentially weight the heuristic torque contribution w.r.t. the normal adhesion force. If no additional data is available on the particles you are simulating, please leave this at ‘1’.
    • transpose (default value = 0) — switches around pc1 and pc2 for the ContactMatrix.
  • Read only properties:
    • Ehat — Combined Young’s modulus (read-only)

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepDeformable_Cylinder_2_DataDeformable_Cylinder_1_DataCapsule_CapsuleN_HertzDMT_CapsuleN_T_AreaWeightedResistanceAssembleForces_DeformableCylinder_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1DeformableCapsuleDof_2AssembleContactMatrix_ComposedParticleAbortIfSameParentFeedback

DMTMatrix (Deformable_Capsule Rigid_Capsule)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • torque_factor (default value = 1) — Optional factor to differentially weight the heuristic torque contribution w.r.t. the normal adhesion force. If no additional data is available on the particles you are simulating, please leave this at ‘1’.
  • Read only properties:
    • Ehat — Combined Young’s modulus (read-only)

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepRigid_Cylinder_2_DataDeformable_Cylinder_1_DataCapsule_CapsuleN_HertzDMT_CapsuleN_T_AreaWeightedResistanceFeedback

DMTMatrix (Deformable_Capsule Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • contact_data_storage_factory (default value = None) — The contact data storage factory to make contact data. Do not change! Especially vector in parallel is not a safe choice here.
    • contact_data (default value = None) — The contact data belonging to the DoF (parents) made by this model.
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
    • transpose (default value = 0) — switches around pc1 and pc2 for the ContactMatrix.
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataDeformable_Cylinder_1_DataCapsule_SphereN_DMTN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedback

DMTMatrix (Deformable_Cylinder Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataDeformable_Cylinder_1_DataCylinder_SphereN_DMTN_T_AreaWeightedResistanceFeedback

DMTMatrix (Rigid_Capsule Rigid_Capsule)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • abort_if_different (default value = 0) — If ‘True’, inverts the regular function of ‘AbortIfSameParent’, and makes the contact model early abort if the particles’ parents are different. Please do not change this ‘Property’ if you are not sure what you are doing.
    • torque_factor (default value = 1) — Optional factor to differentially weight the heuristic torque contribution w.r.t. the normal adhesion force. If no additional data is available on the particles you are simulating, please leave this at ‘1’.
  • Read only properties:
    • Ehat — Combined Young’s modulus (read-only)

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepRigid_Cylinder_2_DataRigid_Cylinder_1_DataCapsule_CapsuleN_HertzDMT_CapsuleN_T_AreaWeightedResistanceAbortIfSameParentFeedback

DMTMatrix (Rigid_Capsule Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigid_Cylinder_1_DataCapsule_SphereN_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Rigid_Cone Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigid_Cone_1_DataCone_SphereN_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Rigid_Cylinder Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigid_Cylinder_1_DataCylinder_SphereN_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Rigid_CylinderBottom Rigid_Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepRigidSphere_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Bottom_Selector >
  ↓
N_DMTN_T_AreaWeightedResistanceFeedback

DMTMatrix (Rigid_CylinderBottom Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Bottom_Selector >
  ↓
N_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Rigid_CylinderTop Rigid_Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepRigidSphere_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Top_Selector >
  ↓
N_DMTN_T_AreaWeightedResistanceFeedback

DMTMatrix (Rigid_CylinderTop Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Top_Selector >
  ↓
N_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Rigid_Quad Rigid_Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • abort_if_different (default value = 0) — If ‘True’, inverts the regular function of ‘AbortIfSameParent’, and makes the contact model early abort if the particles’ parents are different. Please do not change this ‘Property’ if you are not sure what you are doing.
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepRigidSphere_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_DMTN_T_AreaWeightedResistanceAbortIfSameParentFeedback

DMTMatrix (Rigid_Quad Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Rigid_Sphere Rigid_Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • abort_if_different (default value = 0) — If ‘True’, inverts the regular function of ‘AbortIfSameParent’, and makes the contact model early abort if the particles’ parents are different. Please do not change this ‘Property’ if you are not sure what you are doing.
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepRigidSphere_2_DataRigidSphere_1_DataSphere_SphereN_DMTN_T_AreaWeightedResistanceAbortIfSameParentFeedback

DMTMatrix (Rigid_Sphere Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigidSphere_1_DataSphere_SphereN_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Rigid_Triangle Rigid_Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • abort_if_different (default value = 0) — If ‘True’, inverts the regular function of ‘AbortIfSameParent’, and makes the contact model early abort if the particles’ parents are different. Please do not change this ‘Property’ if you are not sure what you are doing.
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepRigidSphere_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereN_DMTN_T_AreaWeightedResistanceAbortIfSameParentFeedback

DMTMatrix (Rigid_Triangle Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereN_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

DMTMatrix (Sphere Sphere)

DMT model for contact between repulsive adhesive bodies including friction matrix. Basically just Hertz with constant adhesion energy / area. For capsule-capsule contacts, an adhesive ‘torque’ will be computed based on the relative orientation of the capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 (kg . m^-1 . s^-2) — Young modulus material 1.
    • E2 (kg . m^-1 . s^-2) — Young modulus material 2.
    • attrConst (kg . s^-2) — Adhesion energy between two particles
    • gamma_normal (kg . s^-1 . m^-2) — Normal friction coefficient (Pa*s/m)
    • gamma_tangential (kg . s^-1 . m^-2) — Tangential friction coefficient (Pa*s/m)
    • nu1 (1) — Poisson ratio material 1.
    • nu2 (1) — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • _contactmatrixdatatype (default value = 1) — Identifier that signals that this chain element’s containing contact model is a friction matrix type. Only change this if you really know what you are doing!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).
  • Read only properties:
    • Ehat — Combined (effective) elastic modulus

This contact model is composed out of following pieces (click on the chain elements to get more information):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere_2_DataSphere_1_DataSphere_SphereN_DMTN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedAssembleContactMatrixFeedback