mpacts.contact.models.springs. presetforce

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

import mpacts.contact.models.springs.presetforce
#or assign it to a shorter name
import mpacts.contact.models.springs.presetforce as pre

PresetForce

Description: Preset contact force with a user defined ‘F_applied’ 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

PresetForce (Deformable_Capsule Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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

DefaultBoilerPlateSphere0_2_DataDeformable_Cylinder_1_DataCapsule_SpherePresetForceAssembleForces_2AssembleForces_DeformableCylinder_1FeedbackKeepContacts

PresetForce (Deformable_RoundedTriangle Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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).
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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 >
  ↓
PresetForceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2FeedbackKeepContacts

PresetForce (Deformable_Triangle Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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).
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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_SpherePresetForceAssembleForces_DeformableTriangleBarycentric_1AssembleForces_2FeedbackKeepContacts

PresetForce (Rigid_Capsule Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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

DefaultBoilerPlateSphere0_2_DataRigid_Cylinder_1_DataCylinder_SpherePresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_Cone Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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

DefaultBoilerPlateSphere0_2_DataRigid_Cone_1_DataCone_SpherePresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_Cylinder Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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

DefaultBoilerPlateSphere0_2_DataRigid_Cylinder_1_DataCylinder_SpherePresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_CylinderBottom Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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 >
  ↓
PresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_CylinderTop Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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 >
  ↓
PresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_Quad Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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).
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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_SpherePresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_RoundedTriangle Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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).
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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 >
  ↓
PresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_Sphere Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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

DefaultBoilerPlateSphere0_2_DataRigidSphere_1_DataSphere_SpherePresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Rigid_Triangle Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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).
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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_SpherePresetForceAssembleForcesFeedbackKeepContacts

PresetForce (Sphere Sphere)

Preset contact force with a user defined ‘F_applied’

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_applied — Fixed applied force in the contact model
    • 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:
    • release_distance (default value = 1.7976931348623157e+308) — Distance at which the contact will be released

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

DefaultBoilerPlateSphere0_2_DataSphere0_1_DataSphere_SpherePresetForceAssembleForcesFeedbackKeepContacts

PresetNormalForce

Description: Preset force magnitude is given, force is along unitvector Geometry combinations available:

PC2 | PC1 - Sphere Rigid_Triangle Rigid_Quad Rigid_Cylinder Rigid_Capsule
Sphere YES YES YES YES YES

PresetNormalForce (Rigid_Capsule Sphere)

Preset force magnitude is given, force is along unitvector

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • f — constant repulsive force (negative is attractive) in direction of normal unit vector
    • 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.

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

DefaultBoilerPlatePoint_2_DataRigid_Cylinder_1_DataCylinder_PointN_ConstantForce  <0 >
  ↓
AssembleForcesNoFeedback

PresetNormalForce (Rigid_Cylinder Sphere)

Preset force magnitude is given, force is along unitvector

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • f — constant repulsive force (negative is attractive) in direction of normal unit vector
    • 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.

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

DefaultBoilerPlatePoint_2_DataRigid_Cylinder_1_DataCylinder_PointN_ConstantForce  <0 >
  ↓
AssembleForcesNoFeedback

PresetNormalForce (Rigid_Quad Sphere)

Preset force magnitude is given, force is along unitvector

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • f — constant repulsive force (negative is attractive) in direction of normal unit vector
    • 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) — If ‘True’, the normals of the N-Gon will be flipped.In most cases, we recommend that you leave this option to its default ‘false’. Contrary to the option ‘flip_normals’ in e.g. Ngon-Sphere contact, this option will always flip the normals, if enables, since points do not have any radius.

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

DefaultBoilerPlatePoint_2_DataRigid_NGon_1_Data  <4 >
  ↓
NGon_PointN_ConstantForce  <0 >
  ↓
AssembleForcesNoFeedback

PresetNormalForce (Rigid_Triangle Sphere)

Preset force magnitude is given, force is along unitvector

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • f — constant repulsive force (negative is attractive) in direction of normal unit vector
    • 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) — If ‘True’, the normals of the N-Gon will be flipped.In most cases, we recommend that you leave this option to its default ‘false’. Contrary to the option ‘flip_normals’ in e.g. Ngon-Sphere contact, this option will always flip the normals, if enables, since points do not have any radius.

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

DefaultBoilerPlatePoint_2_DataRigid_NGon_1_Data  <3 >
  ↓
NGon_PointN_ConstantForce  <0 >
  ↓
AssembleForcesNoFeedback

PresetNormalForce (Sphere Sphere)

Preset force magnitude is given, force is along unitvector

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • f — constant repulsive force (negative is attractive) in direction of normal unit vector
    • 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.

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

DefaultBoilerPlatePoint_2_DataPoint_1_DataPoint_PointN_ConstantForce  <0 >
  ↓
AssembleForcesNoFeedback