mpacts.contact.models.springs. ratchetforce

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

import mpacts.contact.models.springs.ratchetforce
#or assign it to a shorter name
import mpacts.contact.models.springs.ratchetforce as rat

InternallyGivenForce

Description: Effective ratchet force is represented by the list of forces and spring constants. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

InternallyGivenForce (Deformable_Capsule Sphere)

Effective ratchet force is represented by the list of forces and spring constants.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • F_close — List of forces, from which the tangent force to the segment is chosen based upon the internal state in case we are interacting with the segment to which we are attached.
    • F_other — List of forces, from which the tangent force to the segment, is chosen based upon the internal state in case we are interacting with everything else.
    • array2 — Array of values you want to compare.
    • k_close — List of spring constant, from which the .
    • k_other — Number of potential wells in one segment.
    • 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.
    • r — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • reference_value2 — Interger value you want to compare elements in array2 to.

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_DataHead_2_DataInternalState2Capsule_SphereInternallyGivenForceAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2AbortIfOutsideFilamentFeedback

MultiFilamentVariableRatchetForce

Description: Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs or if in inactive state the force is given by factor*Vz_max and factor*k_max.

warning:: Do not use alone. Shall be used on the same contact list as produced by RatchetForceFindClosest via ReuseExistingContact.

Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

MultiFilamentVariableRatchetForce (Deformable_Capsule Sphere)

Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs or if in inactive state the force is given by factor*Vz_max and factor*k_max.

warning:: Do not use alone. Shall be used on the same contact list as produced by RatchetForceFindClosest via ReuseExistingContact.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • Vz_max — Maximal value of the ratchet potential.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • factor — How much of the potential remains in detached state ( Vz = ratio * Vz_max , k = ratio * k_max )
    • k_max — Maximal strength of the attractive spring.
    • k (kg . s^-2) — effective spring constant.
    • n (1) — Number of potential wells in one segment.
    • 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.
    • r (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • reference_value2 — Interger value you want to compare elements in array2 to.

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_DataHead_2_DataInternalState2Capsule_SphereRatchet_ForceN_LinearForceNoDashpotAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2AbortIfOutsideFilamentModifyRatchetStrength2NoFeedback

MultiFilamentVariableRatchetForceWithSaturation

Description: Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

MultiFilamentVariableRatchetForceWithSaturation (Deformable_Capsule Sphere)

Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • Vz_max — Maximal value of the ratchet potential.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • factor — How much of the potential remains in detached state ( Vz = ratio * Vz_max , k = ratio * k_max )
    • k_max — Maximal strength of the attractive spring.
    • k (kg . s^-2) — effective spring constant.
    • n (1) — Number of potential wells in one segment.
    • 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.
    • r (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • reference_value2 — Interger value you want to compare elements in array2 to.
  • Optional keywords:
    • E0_max (m^2 . kg . s^-2) (default value = 0) — Maximal value of base of the ratchet potential.

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_DataHead_2_DataInternalState2Capsule_SphereRatchet_ForceN_LinearForceNoDashpotAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2AbortIfOutsideFilamentModifyRatchetStrength_WithSaturation2NoFeedback

MultiFilamentVariableScreenedRatchetForce

Description: Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E0 ) V_sc(r), where V_r is ratchet potential, E0 is the base of the ratchet potential and V_sc(r) = ( 1 + (r-r0)/R * exp( - (r-r0)/R ) ) for r>r0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs or if in inactive state the force is given by factor*Vz_max and factor*k_max.

warning:: Do not use alone. Shall be used on the same contact list as produced by RatchetForceFindClosest via ReuseExistingContact.

Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

MultiFilamentVariableScreenedRatchetForce (Deformable_Capsule Sphere)

Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E0 ) V_sc(r), where V_r is ratchet potential, E0 is the base of the ratchet potential and V_sc(r) = ( 1 + (r-r0)/R * exp( - (r-r0)/R ) ) for r>r0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs or if in inactive state the force is given by factor*Vz_max and factor*k_max.

warning:: Do not use alone. Shall be used on the same contact list as produced by RatchetForceFindClosest via ReuseExistingContact.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • R (m) — Characteristic screening length. Note that R << rmax.
    • Vz_max — Maximal value of the ratchet potential.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • factor — How much of the potential remains in detached state ( Vz = ratio * Vz_max , k = ratio * k_max )
    • k_max — Maximal strength of the attractive spring.
    • k (kg . s^-2) — Stifnees of the attractive interaction.
    • n — Array containing the number of potential wells in one segment.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.
    • rmax (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • rmin (m) — Initial screening range - i.e. from what distance the screening starts.
  • Optional keywords:
    • E0 (m^2 . kg . s^-2) (default value = 0) — Shift in the potential in the attached state.

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_DataHead_2_DataInternalState2Capsule_SphereScreened_Ratchet_ForceAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2AbortIfOutsideFilamentModifyRatchetStrength2NoFeedback

MultiFilamentVariableScreenedRatchetForceWithSaturation

Description: Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E_0 ) V_{sc}(r), where V_r is ratchet potential, E_0 is the base of the ratchet potential and V_{sc}(r) = \left[ 1 + \frac{r-r_0}{R} * {\mathrm e}^{ -  rac{r-r_0}{R} } \right] for r > r_0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

MultiFilamentVariableScreenedRatchetForceWithSaturation (Deformable_Capsule Sphere)

Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E_0 ) V_{sc}(r), where V_r is ratchet potential, E_0 is the base of the ratchet potential and V_{sc}(r) = \left[ 1 + \frac{r-r_0}{R} * {\mathrm e}^{ -  rac{r-r_0}{R} } \right] for r > r_0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • R (m) — Characteristic screening length. Note that R << rmax.
    • Vz_max — Maximal value of the ratchet potential.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • factor — How much of the potential remains in detached state ( Vz = ratio * Vz_max , k = ratio * k_max )
    • k_max — Maximal strength of the attractive spring.
    • k (kg . s^-2) — Stifnees of the attractive interaction.
    • n — Array containing the number of potential wells in one segment.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.
    • rmax (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • rmin (m) — Initial screening range - i.e. from what distance the screening starts.
  • Optional keywords:
    • E0_max (m^2 . kg . s^-2) (default value = 0) — Maximal value of base of the ratchet potential.
    • E0 (m^2 . kg . s^-2) (default value = 0) — Shift in the potential in the attached state.

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_DataHead_2_DataInternalState2Capsule_SphereScreened_Ratchet_ForceAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2AbortIfOutsideFilamentModifyRatchetStrength_WithSaturation2NoFeedback

MultiFilamentVariableScreenedRatchetForceWithSaturation2

Description: Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E_0 ) V_{sc}(r), where V_r is ratchet potential, E_0 is the base of the ratchet potential and V_{sc}(r) = \left[ 1 + \frac{r-r_0}{R} * {\mathrm e}^{ -  rac{r-r_0}{R} } \right] for r > r_0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

MultiFilamentVariableScreenedRatchetForceWithSaturation2 (Deformable_Capsule Sphere)

Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E_0 ) V_{sc}(r), where V_r is ratchet potential, E_0 is the base of the ratchet potential and V_{sc}(r) = \left[ 1 + \frac{r-r_0}{R} * {\mathrm e}^{ -  rac{r-r_0}{R} } \right] for r > r_0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • R (m) — Characteristic screening length. Note that R << rmax.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • k (kg . s^-2) — Stifnees of the attractive interaction.
    • n — Array containing the number of potential wells in one segment.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.
    • rmax (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • rmin (m) — Initial screening range - i.e. from what distance the screening starts.
  • Optional keywords:
    • E0 (m^2 . kg . s^-2) (default value = 0) — Shift in the potential in the attached state.

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_DataHead_2_DataInternalState2Capsule_SphereScreened_Ratchet_ForceAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2ProceedIfMaximalOverlap2AbortIfGivenValue2NoFeedback

RatchetForce

Description: Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if: A) A particle from PC2 is in an active state. B) PC1 and PC2 are the closest pair, determined by the value of maximumOverlapValue. C) Particle 2 is inside the hull of particle 1. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

RatchetForce (Deformable_Capsule Sphere)

Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if: A) A particle from PC2 is in an active state. B) PC1 and PC2 are the closest pair, determined by the value of maximumOverlapValue. C) Particle 2 is inside the hull of particle 1.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • k (kg . s^-2) — effective spring constant.
    • n (1) — Number of potential wells in one segment.
    • 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.
    • r (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • reference_value2 — Interger value you want to compare elements in array2 to.

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_DataHead_2_DataInternalState2Capsule_SphereRatchet_ForceN_LinearForceNoDashpotAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2AbortIfOutsideFilamentProceedIfMaximalOverlap2AbortIfGivenValue2NoFeedback

RatchetForceFindClosest

Description: Iterates over all posible contacts and determines for each element of pc2 the closest element of pc1. The index and overlap is stored in maximumOverlapIndex amd maximumOverlapValue respectively. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES
Deformable_Capsule YES

RatchetForceFindClosest (Deformable_Capsule Deformable_Capsule)

Iterates over all posible contacts and determines for each element of pc2 the closest element of pc1. The index and overlap is stored in maximumOverlapIndex amd maximumOverlapValue respectively.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • array2 — Array of values you want to compare.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.

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

DefaultBoilerPlateDeformable_Cylinder_1_DataDeformable_Cylinder_2_DataHead_2_DataInternalState2Capsule_CapsuleHeadPolymerAttachment_2Feedback

RatchetForceFindClosest (Deformable_Capsule Sphere)

Iterates over all posible contacts and determines for each element of pc2 the closest element of pc1. The index and overlap is stored in maximumOverlapIndex amd maximumOverlapValue respectively.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • array2 — Array of values you want to compare.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.

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

DefaultBoilerPlateDeformable_Cylinder_1_DataSphere0_2_DataHead_2_DataInternalState2Capsule_SphereHeadPolymerAttachment_2Feedback

RatchetForceFindClosest2

Description: Iterates over all posible contacts and determines for each element of pc2 the closest element of pc1. The index and overlap is stored in maximumOverlapIndex amd maximumOverlapValue respectively. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

RatchetForceFindClosest2 (Deformable_Capsule Sphere)

Iterates over all posible contacts and determines for each element of pc2 the closest element of pc1. The index and overlap is stored in maximumOverlapIndex amd maximumOverlapValue respectively.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • R (m) — Characteristic screening length. Note that R << rmax.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • k (kg . s^-2) — Stifnees of the attractive interaction.
    • n — Array containing the number of potential wells in one segment.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.
    • rmax (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • rmin (m) — Initial screening range - i.e. from what distance the screening starts.
  • Optional keywords:
    • E0 (m^2 . kg . s^-2) (default value = 0) — Shift in the potential in the attached state.

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_DataHead_2_DataInternalState2Capsule_SphereRejectIfNotGivenValue2Screened_Ratchet_ForceAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2HeadPolymerAttachment_2Feedback

RatchetForceOnDetachedAndFindClosest

Description: Iterates over all posible contacts and determines for each element of pc2 the closest element of pc1. The index and overlap is stored in maximumOverlapIndex amd maximumOverlapValue respectively. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

RatchetForceOnDetachedAndFindClosest (Deformable_Capsule Sphere)

Iterates over all posible contacts and determines for each element of pc2 the closest element of pc1. The index and overlap is stored in maximumOverlapIndex amd maximumOverlapValue respectively.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • R (m) — Characteristic screening length. Note that R << rmax.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • contact_storage — Contact storage for heads attached to polymers.
    • k (kg . s^-2) — Stifnees of the attractive interaction.
    • n — Array containing the number of potential wells in one segment.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.
    • rmax (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • rmin (m) — Initial screening range - i.e. from what distance the screening starts.
  • Optional keywords:
    • E0 (m^2 . kg . s^-2) (default value = 0) — Shift in the potential in the attached state.

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_DataHead_2_DataInternalState2Capsule_SphereFindNearestPolymer_2Screened_Ratchet_ForceAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2Feedback

ScreenedRatchetForceWithSaturation

Description: Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E_0 ) V_{sc}(r), where V_r is ratchet potential, E_0 is the base of the ratchet potential and V_{sc}(r) = \left[ 1 + \frac{r-r_0}{R} * {\mathrm e}^{ -  rac{r-r_0}{R} } \right] for r > r_0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

ScreenedRatchetForceWithSaturation (Deformable_Capsule Sphere)

Computes the force caused by a screened flashing ratchet potential between the particles. The full potential is given by V(x) = ( V_r(z) + E_0 ) V_{sc}(r), where V_r is ratchet potential, E_0 is the base of the ratchet potential and V_{sc}(r) = \left[ 1 + \frac{r-r_0}{R} * {\mathrm e}^{ -  rac{r-r_0}{R} } \right] for r > r_0 and 1 otherwise. Force is non-zero only if particle 2 is inside the hull of particle 1. Force magnitude of the closest pair determined by maximalOverlapIndex value in active state determined by the condition array2[p2] != reference_value2 is given by Vz_max and k_max. For all other pairs in the active state the force is zero, otherwise the force is given by factor*Vz_max and factor*k_max.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • R (m) — Characteristic screening length. Note that R << rmax.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • k (kg . s^-2) — Stifnees of the attractive interaction.
    • n — Array containing the number of potential wells in one segment.
    • 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.
    • reference_value2 — Interger value you want to compare elements in array2 to.
    • rmax (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • rmin (m) — Initial screening range - i.e. from what distance the screening starts.
  • Optional keywords:
    • E0 (m^2 . kg . s^-2) (default value = 0) — Shift in the potential in the attached state.

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_DataHead_2_DataInternalState2Capsule_SphereScreened_Ratchet_ForceAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2NoFeedback

VariableRatchetForce

Description: Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if: A) PC1 and PC2 are the closest pair, determined by the value of maximumOverlapValue. B) Particle 2 is inside the hull of particle 1. Force magnitude depends on the internal state. In active state determined by the condition array2[p2] != reference_value2 the value of potential and stiffness are given by Vz_max and k_max. Otherwise their values are given by factor*Vz_max and factor*k_max. Geometry combinations available:

PC2 | PC1 - Deformable_Capsule
Sphere YES

VariableRatchetForce (Deformable_Capsule Sphere)

Computes the force caused by a flashing ratchet potential between the particles. Force is non-zero only if: A) PC1 and PC2 are the closest pair, determined by the value of maximumOverlapValue. B) Particle 2 is inside the hull of particle 1. Force magnitude depends on the internal state. In active state determined by the condition array2[p2] != reference_value2 the value of potential and stiffness are given by Vz_max and k_max. Otherwise their values are given by factor*Vz_max and factor*k_max.

Parallel Compatible: Yes

Properties:

  • Required keywords:
    • Vz_max — Maximal value of the ratchet potential.
    • Vz (m^2 . kg . s^-2) — Height of the potential in z direction.
    • a (1) — Skewedness of ratchet.
    • array2 — Array of values you want to compare.
    • factor — How much of the potential remains in detached state ( Vz = ratio * Vz_max , k = ratio * k_max )
    • k_max — Maximal strength of the attractive spring.
    • k (kg . s^-2) — effective spring constant.
    • n (1) — Number of potential wells in one segment.
    • 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.
    • r (m) — Range of the potential - i.e. how far the particle has to be before it is considered attached.
    • reference_value2 — Interger value you want to compare elements in array2 to.

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_DataHead_2_DataInternalState2Capsule_SphereRatchet_ForceN_LinearForceNoDashpotAssembleTorque_DeformableCapsule_1AssembleForces_DeformableCapsuleWithTorque_1AssembleForces_2AbortIfOutsideFilamentModifyRatchetStrength2ProceedIfMaximalOverlap2NoFeedback