mpacts.contact.models.collision.hertz. hertz_matrix

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

import mpacts.contact.models.collision.hertz.hertz_matrix
#or assign it to a shorter name
import mpacts.contact.models.collision.hertz.hertz_matrix as her

HertzLinearAdhesionMatrix

Description: Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s). Geometry combinations available:

PC2 | PC1 - Sphere Rigid_Triangle Rigid_Sphere Rigid_RoundedTriangle Rigid_Quad Rigid_CylinderTop Rigid_CylinderBottom Rigid_Cylinder Rigid_Cone Rigid_Capsule Deformable_Triangle Deformable_RoundedTriangle Deformable_Line Deformable_Capsule
Sphere YES YES YES YES YES YES YES YES YES YES YES YES YES YES

HertzLinearAdhesionMatrix (Deformable_Capsule Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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.
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

HertzLinearAdhesionMatrix (Deformable_Line Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • orthogonal_to (default value = 0 0 1) — Direction ‘out of plane’ for the 2D system. Default = (0,0,1).
    • reject_larger_radius (default value = 1) — If true, overlaps larger than the sphere’s radius will be rejected’
  • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

HertzLinearAdhesionMatrix (Deformable_RoundedTriangle Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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.
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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).
    • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleAbortIfSameParentFeedbackKeepContacts

HertzLinearAdhesionMatrix (Deformable_Triangle Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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.
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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).
    • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleAbortIfSameParentFeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_Capsule Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_Cone Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_Cylinder Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_CylinderBottom Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Bottom_Selector >
  ↓
N_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_CylinderTop Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Top_Selector >
  ↓
N_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_Quad Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • Fprim1 (default value = None) — Array with vectors which stores the contact force per primitive for pc1. If not given, the array pc1[‘Fprim’] is searched first, and if not found, nothing will be done
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2AssembleForces_Primitives_1FeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_RoundedTriangle Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesFeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_Sphere Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

HertzLinearAdhesionMatrix (Rigid_Triangle Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

HertzLinearAdhesionMatrix (Sphere Sphere)

Hertz contact model with a linearly increasing adhesion force (upon retraction) with pull-off force ‘F_rupture’ and pull-off distance ‘d_rupture’. Effective contacts are counted, and contact stress is assembled from virial theory WARNING: it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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:
    • F_detach1 (kg . m . s^-2) (default value = 0) — Detachment force for pc1
    • F_detach2 (kg . m . s^-2) (default value = 0) — Detachment force for pc2
    • _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!
    • d_detach1 (m) (default value = 0) — Rupture length for pc1
    • d_detach2 (m) (default value = 0) — Rupture length for pc2
    • d_detach (m) (default value = -1) — Rupture length (If not given, we will try to use the values d_detach1 and d_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • f_detach (kg . m . s^-2) (default value = -1) — Detachment force (If not given, we will try to use the values F_detach1 and F_detach2 which are given either as single properties or can be Scalar arrays for pc1 and pc2).
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereN_HertzSingleValue_Property  <double >
  ↓
N_LinearAdhesionForceN_T_ConstantStiffnessN_T_ConstantResistanceAssembleForcesAssemble_VirialStressComputeContactMatrixElementOverdampedAssembleContactMatrixFeedbackKeepContacts

HertzMatrix

Description: Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area. Geometry combinations available:

PC2 | PC1 - Sphere Rigid_Triangle Rigid_Sphere Rigid_RoundedTriangle Rigid_Quad Rigid_CylinderTop Rigid_CylinderBottom Rigid_Cylinder Rigid_Cone Rigid_Capsule Deformable_Triangle Deformable_RoundedTriangle Deformable_Line Deformable_Capsule
Sphere YES YES YES YES YES YES YES YES YES YES YES YES YES YES

HertzMatrix (Deformable_Capsule Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereN_HertzN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedback

HertzMatrix (Deformable_Line Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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!
    • orthogonal_to (default value = 0 0 1) — Direction ‘out of plane’ for the 2D system. Default = (0,0,1).
    • reject_larger_radius (default value = 1) — If true, overlaps larger than the sphere’s radius will be rejected’
  • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereN_HertzN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1Feedback

HertzMatrix (Deformable_RoundedTriangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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.
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • 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).
    • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_HertzN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleAbortIfSameParentFeedback

HertzMatrix (Deformable_Triangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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.
    • 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).
    • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereN_HertzN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleAbortIfSameParentFeedback

HertzMatrix (Rigid_Capsule Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Rigid_Cone Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereN_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Rigid_Cylinder Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Rigid_CylinderBottom Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Bottom_Selector >
  ↓
N_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Rigid_CylinderTop Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Top_Selector >
  ↓
N_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Rigid_Quad Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Rigid_RoundedTriangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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!
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_HertzN_T_AreaWeightedResistanceAssembleForcesFeedback

HertzMatrix (Rigid_Sphere Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereN_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Rigid_Triangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereN_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzMatrix (Sphere Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. Friction coefficients are in units of (Pa s/m) and will be scaled by the Hertz contact area.

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.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereN_HertzN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedAssembleContactMatrixFeedback

HertzNoAreaMatrix

Description: Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s). Geometry combinations available:

PC2 | PC1 - Sphere Rigid_Triangle Rigid_Sphere Rigid_RoundedTriangle Rigid_Quad Rigid_CylinderTop Rigid_CylinderBottom Rigid_Cylinder Rigid_Cone Rigid_Capsule Deformable_Triangle Deformable_RoundedTriangle Deformable_Line Deformable_Capsule
Sphere YES YES YES YES YES YES YES YES YES YES YES YES YES YES

HertzNoAreaMatrix (Deformable_Capsule Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereN_HertzN_T_ConstantResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedback

HertzNoAreaMatrix (Deformable_Line Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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!
    • orthogonal_to (default value = 0 0 1) — Direction ‘out of plane’ for the 2D system. Default = (0,0,1).
    • reject_larger_radius (default value = 1) — If true, overlaps larger than the sphere’s radius will be rejected’
  • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereN_HertzN_T_ConstantResistanceAssembleForces_2AssembleForces_DeformableCylinder_1Feedback

HertzNoAreaMatrix (Deformable_RoundedTriangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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.
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • 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).
    • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_HertzN_T_ConstantResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleAbortIfSameParentFeedback

HertzNoAreaMatrix (Deformable_Triangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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.
    • 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).
    • 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):

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereN_HertzN_T_ConstantResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleAbortIfSameParentFeedback

HertzNoAreaMatrix (Rigid_Capsule Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Rigid_Cone Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereN_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Rigid_Cylinder Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Rigid_CylinderBottom Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Bottom_Selector >
  ↓
N_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Rigid_CylinderTop Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Top_Selector >
  ↓
N_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Rigid_Quad Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Rigid_RoundedTriangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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!
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_HertzN_T_ConstantResistanceAssembleForcesFeedback

HertzNoAreaMatrix (Rigid_Sphere Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereN_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Rigid_Triangle Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereN_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzNoAreaMatrix (Sphere Sphere)

Hertz contact model for overdamped systems, with normal and tangential friction coefficient to include ‘wet’ friction. WARNING: here it is assumed that friction is area independent, so they should be provided in units of (kg/s).

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.
    • gamma_normal (kg . s^-1) — Normal friction coefficient (kg/s)
    • gamma_tangential (kg . s^-1) — Tangential friction coefficient (kg/s)
    • 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 Young’s modulus (read-only)

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereN_HertzN_T_ConstantResistanceAssembleForcesComputeContactMatrixElementOverdampedAssembleContactMatrixFeedback

HertzTruncatedTraction

Description: Try out Geometry combinations available:

PC2 | PC1 - Sphere Rigid_Quad
Sphere YES YES

HertzTruncatedTraction (Rigid_Quad Sphere)

Try out

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — Adhesion energy, specified as W and has units J/m^2.
    • 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 — Poisson ratio material 1.
    • nu2 — 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.
    • sigma0 — Maximum adhesive traction before rupture occurs, similar to a ‘yield stress’. P_m.
  • 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).
    • init_contact_state (default value = 1) — If ‘True’, the contact state stick radius will be set to the geometric contact radius the next execution of this command. Afterwards, this value will be toggled to ‘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:
    • rupture_length — rupture length: d_r = \frac{2 W}{P_m}

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_Hertz_TruncatedTractionN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2Feedback

HertzTruncatedTraction (Sphere Sphere)

Try out

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — Adhesion energy, specified as W and has units J/m^2.
    • 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 — Poisson ratio material 1.
    • nu2 — 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.
    • sigma0 — Maximum adhesive traction before rupture occurs, similar to a ‘yield stress’. P_m.
  • 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).
    • init_contact_state (default value = 1) — If ‘True’, the contact state stick radius will be set to the geometric contact radius the next execution of this command. Afterwards, this value will be toggled to ‘False’.
  • Read only properties:
    • rupture_length — rupture length: d_r = \frac{2 W}{P_m}

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereN_Hertz_TruncatedTractionN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedAssembleContactMatrixFeedback