mpacts.contact.models.collision. filaments

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

import mpacts.contact.models.collision.filaments
#or assign it to a shorter name
import mpacts.contact.models.collision.filaments as fil

HertzModelForFilamentsCorr

Description: Hertz model for filaments. Correction to overcounting the overlaps between node and ngon. Geometry combinations available:

PC2 | PC1 - Rigid_Triangle Rigid_Quad
Sphere YES YES

HertzModelForFilamentsCorr (Rigid_Quad Sphere)

Hertz model for filaments. Correction to overcounting the overlaps between node and ngon.

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.
    • 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
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • Ehat — Combined Young’s modulus (read-only)

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

DefaultBoilerPlateSphere0_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_SphereN_HertzInverseForcesAssembleForcesAssembleForces_Primitives_1AbortIfEndPointFeedback

HertzModelForFilamentsCorr (Rigid_Triangle Sphere)

Hertz model for filaments. Correction to overcounting the overlaps between node and ngon.

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.
    • 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
    • flip_normals (default value = 0) — Optionally flip normals if sphere is more than its radius submerged. In most cases, we recommend that you leave this option to its default ‘false’.
    • reject_large_overlap (default value = 1) — Optionally reject overlaps reject_overlap_r times larger than the radius. Unless you have a fully concave ‘container’ geometry, we recommend that you leave this value to its default ‘true’.
    • reject_overlap_r (default value = 1) — If reject_large_overlap is True, this specifies the number of sphere radii of overlap that should be rejected (Default=1).
  • Read only properties:
    • Ehat — Combined Young’s modulus (read-only)

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

DefaultBoilerPlateSphere0_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_SphereN_HertzInverseForcesAssembleForcesAssembleForces_Primitives_1AbortIfEndPointFeedback

LinearRepulsionForFilaments

Description: Linear repulsion model between filaments. Force is proportional to overlap independently of the overlap size. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Deformable_Capsule YES

LinearRepulsionForFilaments (Deformable_Capsule Deformable_Capsule)

Linear repulsion model between filaments. Force is proportional to overlap independently of the overlap size.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • k (kg . s^-2) — effective spring constant.
    • 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:
    • c (kg . s^-1) (default value = 0) — damping coefficient.

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

DefaultBoilerPlateDeformable_Cylinder_1_DataDeformable_Cylinder_2_DataDeformable_Capsule_1_Rotational_DataDeformable_Capsule_2_Rotational_DataCapsule_CapsuleN_LinearForceAssembleTorque_DeformableCapsule_2AssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorqueAbortIfCommonNodeFeedback

LinearRepulsionForFilamentsCorr1

Description: Linear repulsion model between filaments. Force is proportional to overlap independently of the overlap size. Correction for overcounting overlaps between nodes and deformable capsules. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

LinearRepulsionForFilamentsCorr1 (Deformable_Capsule Sphere)

Linear repulsion model between filaments. Force is proportional to overlap independently of the overlap size. Correction for overcounting overlaps between nodes and deformable capsules.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • k (kg . s^-2) — effective spring constant.
    • 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:
    • c (kg . s^-1) (default value = 0) — damping coefficient.

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

DefaultBoilerPlateDeformable_Cylinder_1_DataSphere0_2_DataDeformable_Capsule_1_Rotational_DataCapsule_SphereN_LinearForceInverseForcesAssembleForces_2AssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AbortIfEndPoint_2AbortIfNodePartOfCylinderFeedback

LinearRepulsionForFilamentsCorr2

Description: Linear repulsion model between filaments. Force is proportional to overlap independently of the overlap size. Correction for undercounting overlaps between nodes. Geometry combinations available:

PC2 | PC1 - Sphere
Sphere YES

LinearRepulsionForFilamentsCorr2 (Sphere Sphere)

Linear repulsion model between filaments. Force is proportional to overlap independently of the overlap size. Correction for undercounting overlaps between nodes.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • k (kg . s^-2) — effective spring constant.
    • 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:
    • c (kg . s^-1) (default value = 0) — damping coefficient.

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

DefaultBoilerPlateSphere0_1_DataSphere0_2_DataSphere_SphereN_LinearForceAssembleForcesAbortIfEndPointFeedback