mpacts.contact.models.collision.jkr. jkr_matrix

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

import mpacts.contact.models.collision.jkr.jkr_matrix
#or assign it to a shorter name
import mpacts.contact.models.collision.jkr.jkr_matrix as jkr

JKRArrayPropsMatrix

Description: Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. 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

JKRArrayPropsMatrix (Deformable_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRArrayPropsMatrix (Deformable_Line Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

JKRArrayPropsMatrix (Deformable_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRArrayPropsMatrix (Deformable_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_Cone Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_Cylinder Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_CylinderBottom Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_CylinderTop Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_Quad Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesFeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Rigid_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRArrayPropsMatrix (Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedAssembleContactMatrixFeedbackKeepContacts

JKRMatrix

Description: Spheres (cells) which interact using JKR adhesive/repulsive contact force 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

JKRMatrix (Deformable_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRMatrix (Deformable_Line Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

JKRMatrix (Deformable_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRMatrix (Deformable_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRMatrix (Rigid_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Rigid_Cone Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Rigid_Cylinder Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Rigid_CylinderBottom Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Rigid_CylinderTop Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Rigid_Quad Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Rigid_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesFeedbackKeepContacts

JKRMatrix (Rigid_Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Rigid_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRMatrix (Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesComputeContactMatrixElementOverdampedAssembleContactMatrixFeedbackKeepContacts

JKRStressArrayPropsMatrix

Description: Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress. 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

JKRStressArrayPropsMatrix (Deformable_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressArrayPropsMatrix (Deformable_Line Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

JKRStressArrayPropsMatrix (Deformable_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressArrayPropsMatrix (Deformable_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_Cone Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_Cylinder Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_CylinderBottom Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_CylinderTop Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_Quad Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesFeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Rigid_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressArrayPropsMatrix (Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Adhesion and stiffness in JKR vary with an array. Also Calculates Stress.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStressComputeContactMatrixElementOverdampedAssembleContactMatrixFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix

Description: Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array. 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

JKRStressCountContactsArrayPropsMatrix (Deformable_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Deformable_Line Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Deformable_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Deformable_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_Cone Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_Cylinder Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_CylinderBottom Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_CylinderTop Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_Quad Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
ArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Rigid_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsArrayPropsMatrix (Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.Adhesion and stiffness AND friction in JKR vary with an array.

Parallel Compatible: No

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — 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!
    • attrConst1 (default value = None) — Adhesion energy of material 1
    • attrConst2 (default value = None) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereArrayValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStressComputeContactMatrixElementOverdampedAssembleContactMatrixCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix

Description: Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array. 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

JKRStressCountContactsMatrix (Deformable_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Deformable_Line Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Deformable_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Deformable_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_Cone Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_Cylinder Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_CylinderBottom Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_CylinderTop Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_Quad Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Rigid_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrix (Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStressComputeContactMatrixElementOverdampedAssembleContactMatrixCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN

Description: Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array. 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

JKRStressCountContactsMatrixNN (Deformable_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Deformable_Line Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Deformable_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Deformable_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_Cone Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_Cylinder Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_CylinderBottom Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_CylinderTop Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_Quad Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesCountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Rigid_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • distance_edge_interpolation (m) (default value = -1) — Distance over which the normal will be interpolated based on the normals on the nodes of the NGon. If the evaluated point lies further than this distance from a NGon edge, than the normal of the NGon will be used instead of the interpolated node normal.

By default, this value is set to -1. With this value, the normal of the triangle will always be used. When this value is set to a very large value, the normal will always be the interpolated value of the node normals.

  • 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. We strongly recommend to keep this value to True for any more or less complex geometry.
  • reject_overlap_r (default value = 2) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected.
We strongly recommend to keep this value to the default of 2, as this guaruantees continuity when moving around in the neighbourhood of sharp edges and corners of a convex geometry.
  • smooth_normal (default value = 0) — If ‘True’, the normal unit vector will be computed as the interpolated local normal vector at the contact point. This will effectively ‘round’ the body a bit, so that the direction of force always evolves smoothly over a surface
  • weight_with_area (default value = 1) — If ‘true’, a modification factor will be computed that weights a given contact as the ratio between the actual sphere-n-gon intersection area and the sphere-infinite plane intersection area. Setting this to ‘true’ (default) ensures that contact forces are conversed for refining meshes. A side-effect of this is that sharp edges and corners might appear ‘softened’ a bit. In general, only set this property to false for extremely stiff contacts, where the expected overlap distances is only a tiny fraction of the sphere radius

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_Sphere_NNSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2CountEffectiveContactsFeedbackKeepContacts

JKRStressCountContactsMatrixNN (Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force. Contacts are saved in ‘number_of_effective_contacts’ array.

Parallel Compatible: No

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStressComputeContactMatrixElementOverdampedAssembleContactMatrixCountEffectiveContactsFeedbackKeepContacts

JKRStressMatrix

Description: Spheres (cells) which interact using JKR adhesive/repulsive contact force 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

JKRStressMatrix (Deformable_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressMatrix (Deformable_Line Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

JKRStressMatrix (Deformable_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressMatrix (Deformable_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressMatrix (Rigid_Capsule Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Rigid_Cone Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Rigid_Cylinder Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Rigid_CylinderBottom Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Rigid_CylinderTop Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Rigid_Quad Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Rigid_RoundedTriangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesFeedbackKeepContacts

JKRStressMatrix (Rigid_Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Rigid_Triangle Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressMatrix (Sphere Sphere)

Spheres (cells) which interact using JKR adhesive/repulsive contact force

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStressComputeContactMatrixElementOverdampedAssembleContactMatrixFeedbackKeepContacts

JKRStressVolumeLossFprimMatrix

Description: Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’. 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

JKRStressVolumeLossFprimMatrix (Deformable_Capsule Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Deformable_Line Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Deformable_RoundedTriangle Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Deformable_Triangle Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_Capsule Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_Cone Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_Cylinder Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_CylinderBottom Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2Assemble_VolumeLossToPlane_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_CylinderTop Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2Assemble_VolumeLossToPlane_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_Quad Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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:
    • 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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssembleForces_Primitives_1Assemble_VirialStress_2Assemble_VolumeLossToPlane_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_RoundedTriangle Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesFeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_Sphere Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigidSphere_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2Assemble_VolumeLoss_1Assemble_VolumeLoss_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Rigid_Triangle Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2Assemble_VolumeLossToPlane_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossFprimMatrix (Sphere Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataSphere0_1_DataSphere_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStressAssemble_VolumeLoss_1Assemble_VolumeLoss_2ComputeContactMatrixElementOverdampedAssembleContactMatrixFeedbackKeepContacts

JKRStressVolumeLossMatrix

Description: Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’. 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

JKRStressVolumeLossMatrix (Deformable_Capsule Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1ComputeContactMatrixElementOverdampedDeformableCapsuleDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressVolumeLossMatrix (Deformable_Line Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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’

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataDeformable_Line_1_DataLine_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

JKRStressVolumeLossMatrix (Deformable_RoundedTriangle Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressVolumeLossMatrix (Deformable_Triangle Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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.

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2ComputeContactMatrixElementOverdampedDeformableTriangleBarycentricDof_1SphereDof_2AssembleContactMatrix_ComposedParticleFeedbackKeepContacts

JKRStressVolumeLossMatrix (Rigid_Capsule Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossMatrix (Rigid_Cone Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cone_1_DataCone_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossMatrix (Rigid_Cylinder Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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

DefaultBoilerPlateContactMatrixDataBoilerPlateContactMatrixContactStateKeepTimeStepSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossMatrix (Rigid_CylinderBottom Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2Assemble_VolumeLossToPlane_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossMatrix (Rigid_CylinderTop Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • implicitness (default value = 0) — Choose the semi-implicit integration method. (0 for explicit Euler, 1 for implicit Euler, 0.5 for Cranck-Nicholson).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2Assemble_VolumeLossToPlane_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossMatrix (Rigid_Quad Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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_SphereSingleValue_Property  <double >
  ↓
N_JKRN_T_AreaWeightedResistanceAssembleForcesAssemble_VirialStress_2Assemble_VolumeLossToPlane_2ComputeContactMatrixElementOverdampedRigidBodyDof_1SphereDof_2AssembleContactMatrixToDiagonal_2FrictionMatrixForce_2FeedbackKeepContacts

JKRStressVolumeLossMatrix (Rigid_RoundedTriangle Sphere)

Cells which interact using JKR contact force, assembling the lost volume due to overlapping spheres into ‘volume_loss’ and the virial stress due to contact forces in the array ‘stress’.

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!
    • attrConst1 (kg . s^-2) (default value = 0) — Adhesion energy of material 1
    • attrConst2 (kg . s^-2) (default value = 0) — Adhesion energy of material 2
    • attrConst (kg . s^-2) (default value = -1) — Combined adhesion energy. Always over-rules attrConst1 and attrConst2, even if given as arrays!
    • 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).

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 >
  ↓
SingleValue_Property  <double >
  ↓
N_JKR