mpacts.contact.models.collision.md. md_basic

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

import mpacts.contact.models.collision.md.md_basic
#or assign it to a shorter name
import mpacts.contact.models.collision.md.md_basic as md_

MaugisDugdale

Description: Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area Geometry combinations available:

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

MaugisDugdale (Deformable_Capsule Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SphereN_MaugisDugdaleAssembleForces_2AssembleForces_DeformableCylinder_1Feedback

MaugisDugdale (Deformable_RoundedTriangle Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • abort_if_different (default value = 0) — If ‘True’, inverts the regular function of ‘AbortIfSameParent’, and makes the contact model early abort if the particles’ parents are different. Please do not change this ‘Property’ if you are not sure what you are doing.
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_MaugisDugdaleAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2AbortIfSameParentFeedback

MaugisDugdale (Deformable_Triangle Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • abort_if_different (default value = 0) — If ‘True’, inverts the regular function of ‘AbortIfSameParent’, and makes the contact model early abort if the particles’ parents are different. Please do not change this ‘Property’ if you are not sure what you are doing.
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataDeformable_NGon_1_Data  <3 >
  ↓
NGon_SphereN_MaugisDugdaleAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2AbortIfSameParentFeedback

MaugisDugdale (Rigid_Capsule Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_Cone Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_Cone_1_DataCone_SphereN_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_Cylinder Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_Cylinder_1_DataCylinder_SphereN_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_CylinderBottom Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Bottom_Selector >
  ↓
N_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_CylinderTop Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_Cylinder_1_DataDisk_Sphere  <Top_Selector >
  ↓
N_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_Quad Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_RoundedTriangle Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • disable_warning_fake_rounded_triangle (default value = 0) — Disables the printing of the specified warning message.
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereWarningMessage  <WARN::FakeRoundedTriangle >
  ↓
N_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_Sphere Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigidSphere_1_DataSphere_SphereN_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Rigid_Triangle Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Optional keywords:
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereN_MaugisDugdaleAssembleForcesFeedback

MaugisDugdale (Sphere Sphere)

Maugis-Dugdale model for contact between repulsive adhesive spheres. Basically just Hertz with constant adhesion energy / area

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • E1 — Young modulus material 1.
    • E2 — Young modulus material 2.
    • attrConst — effective adhesion energy [J/m^2]
    • effective_range — effective range of adhesive interaction. Relates adhesive pressure to adhesive energy MD.
    • nu1 — Poisson ratio material 1.
    • nu2 — Poisson ratio material 2.
    • pc1 — The first particle container in the binary contact detection.
    • pc2 — The second particle container in the binary contact detection. If contact detection within the same particle container is desired, and it is applicable for the contactmodel, pass the same pc to both pc1 and pc2.
  • Read only properties:
    • sigma0 — Maximum adhesive tension at the edge of the contact circle. NOTE: sigma0 = attrConst / effective_range

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

DefaultBoilerPlateSphere0_2_DataSphere0_1_DataSphere_SphereN_MaugisDugdaleAssembleForcesFeedback