================================== MotionContact (hwx.inspire.motion) ================================== Creates an object that generates a contact force between a collection of parts. Typical use cases include latches, cams, and other parts that have persistent or intermittent contact behavior including friction effects. Inherits: - :ref:`MotionObject (hwx.inspire.motion)` ---------- Attributes ---------- +-------------------------------------+-------------------------------------+-------------------------------------+ | active_: Bool | collisionType_: Enum | computedAtType_: Enum | +-------------------------------------+-------------------------------------+-------------------------------------+ | damping_: Double | enableFriction_: Bool | exponent_: Double | +-------------------------------------+-------------------------------------+-------------------------------------+ | frictionTransitionVelocity_: Double | frictionType_: Enum | keepForceResults_: Enum | +-------------------------------------+-------------------------------------+-------------------------------------+ | layerDepth_: Double | measureClearance_: Bool | muDynamic_: Double | +-------------------------------------+-------------------------------------+-------------------------------------+ | muStatic_: Double | name_: Attribute | newStepSize_: Double | +-------------------------------------+-------------------------------------+-------------------------------------+ | normalVelocity_: Double | parts_: Attribute | parts1_: Attribute | +-------------------------------------+-------------------------------------+-------------------------------------+ | parts2_: Attribute | penalty_: Double | penetrationDepth_: Double | +-------------------------------------+-------------------------------------+-------------------------------------+ | preciseContactEvent_: Bool | refineStepSize_: Bool | restitutionCoefficient_: Double | +-------------------------------------+-------------------------------------+-------------------------------------+ | stictionTransitionVelocity_: Double | stiffness_: Double | tolerance_: Double | +-------------------------------------+-------------------------------------+-------------------------------------+ | visible_: Bool | writePlantSignals_: Bool | | +-------------------------------------+-------------------------------------+-------------------------------------+ ---------- Properties ---------- +-----------+ | location_ | +-----------+ -------------- Public Methods -------------- +-------------------------------------------------------+ | classmethod areFeaturesContacted_ (cls, part1, part2) | +-------------------------------------------------------+ | classmethod arePartsContacted_ (cls, part1, part2) | +-------------------------------------------------------+ | classmethod getIntersections_ (cls, visibleOnly=True) | +-------------------------------------------------------+ | classmethod hideContacts_ (cls) | +-------------------------------------------------------+ | classmethod isValidPart_ (cls, part) | +-------------------------------------------------------+ | classmethod showContacts_ (cls, on=True) | +-------------------------------------------------------+ | getContactingPartPairs_ (self) | +-------------------------------------------------------+ | getIntersectingParts_ (self) | +-------------------------------------------------------+ ----------------- Attribute Details ----------------- .. _active: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ active : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Returns or sets the object activeness. Setting this on or off sets all children. Setting to True sets all the parents active too. .. _collisionType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ collisionType : :ref:`Enum ` (IMPACT, POISSON, VOLUME) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Type of collision upon contact between entities. Collision type can be Impact, Poisson and Volume. .. _computedAtType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ computedAtType : :ref:`Enum ` (NODE, ELEMENT) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies how the contact force will be computed. When parts come into contact, the contact normal force is applied at the element center, then the force computation type should be selected Element Center. If the parts come into contact, the contact normal force is applied at the nodes of the element, then force computation type should be selected Nodes. .. _damping: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ damping : :ref:`Double ` (units="damping") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the maximum damping coefficient. It defaults to 100 N*s/m and this property is specifiable when the contact collision is of type Impact or Volume. .. _enableFriction: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ enableFriction : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If True, enables friction between entities. .. _exponent: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ exponent : :ref:`Double ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The exponent of the force deformation characteristic. This value is used to generate the stiffness. It defaults to 2.1 and this property is specifiable when the contact collision type is Impact or Volume. .. _frictionTransitionVelocity: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ frictionTransitionVelocity : :ref:`Double ` (units="velocity") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The velocity at which transition occurs between a stationary entity and a moving entity. This property is specifiable when friction is enabled. .. _frictionType: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ frictionType : :ref:`Enum ` (ON, DYNAMIC_ONLY) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the type of friction upon contact. Type of friction can be Static and Dynamic or Dynamic only. This property is specifiable when friction is enabled. .. _keepForceResults: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ keepForceResults : :ref:`Enum ` (default, all, region, none) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This allows to limit the number of contact forces that are stored in the model after Motion Analysis. They can be Default, All, Region Only, or None .. _layerDepth: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ layerDepth : :ref:`Double ` (units="length") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The layer depth of material. This is used to calculate the contact stiffness and it defaults to 1 m. This property is specifiable when the contact collision is of type Volume. .. _measureClearance: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ measureClearance : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If True, allows proximity between parts to be computed. This will provide additional outputs during Motion Analysis, which is used in plotting. .. _muDynamic: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ muDynamic : :ref:`Double ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The dynamic coefficient of friction, which the body experiences while in motion. This property is specifiable when friction is enabled. .. _muStatic: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ muStatic : :ref:`Double ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The static coefficient of friction, which has to be overcome by a body before it can move. This property is specifiable when friction is enabled. .. _name: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ name : :ref:`Attribute ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Returns or sets the name of the object. It can be any text string, including spaces, although it's best to avoid using the following characters: " ' * ? and $. While these characters are allowed, they could create difficulties when you export the model to other applications. .. _newStepSize: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ newStepSize : :ref:`Double ` (units="time") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Specifies the new step size used by the solver after the contact is detected. Defaults to 0.0005 s. .. _normalVelocity: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ normalVelocity : :ref:`Double ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Velocity limit after which full damping force is applied. By default the value is 0.001. This property is specifiable when the contact collision type is Poisson. .. _parts: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ parts : :ref:`Attribute ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ List of entities used to create the contact. .. _parts1: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ parts1 : :ref:`Attribute ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The first part or feature entity used to create a contact. .. _parts2: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ parts2 : :ref:`Attribute ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The second part or feature entity used to create a contact. .. _penalty: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ penalty : :ref:`Double ` (units="stiffness") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Determines the local stiffness properties between materials. Larger values lead to reduced penetration between two bodies. By default penalty value is 5e+06 N/m. This property is specifiable when the contact collision type is Poisson. .. _penetrationDepth: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ penetrationDepth : :ref:`Double ` (units="length") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The depth beyond which full damping is applied. It defaults to 0.0001 m and this property is specifiable when the contact collision is of type Impact. .. _preciseContactEvent: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ preciseContactEvent : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If True, enables monitoring of the collision of two entities upon contact with greater accuracy. .. _refineStepSize: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ refineStepSize : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If True, this property along with the value of New Step Size, the solver will use it as the maximum step size for the simulation after the contact is detected. .. _restitutionCoefficient: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ restitutionCoefficient : :ref:`Double ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The ratio of the final to initial relative velocity between two entities after they collide. - 0 for a perfectly plastic collision - 1 for a perfectly elastic collision By default the value is 0.8. This property is specifiable when the contact collision type is Poisson. .. _stictionTransitionVelocity: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ stictionTransitionVelocity : :ref:`Double ` (units="velocity") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The velocity of the entity after overcoming the static friction upon contact. This property is specifiable when friction is enabled. .. _stiffness: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ stiffness : :ref:`Double ` (units="stiffness") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The stiffness of the boundary surface interaction. The nonlinear effect of the Exponent parameter will be accounted for automatically. It defaults to 1000 N/m and this property is specifiable when the contact collision is of type Impact. .. _tolerance: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ tolerance : :ref:`Double ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If Precise Contact Event is enabled then the tolerance value represents a band around the current integrator step size, its value is expressed as a percentage of the current integrator step size, defaults to 0.01. .. _visible: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ visible : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Determines whether the object is visible in the modeling window. Setting this on or off sets all children. Setting to True sets all the parents visible too. .. _writePlantSignals: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ writePlantSignals : :ref:`Bool ` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Generates a plant input and output signal for the contact, if set to True. ---------------- Property Details ---------------- .. _location: .. method:: location Specifies the midpoint of the all the parts center of gravity. -------------- Method Details -------------- .. _areFeaturesContacted: .. classmethod:: areFeaturesContacted(cls, part1, part2) Determines if there is a contact between the specified parts. :param part1: First part to determine contact. :type part1: Part, List[Part] :param part2: Second part to determine contact. :type part2: Part, List[Part] :returns: The found contact object. :rtype: MotionContact .. _arePartsContacted: .. classmethod:: arePartsContacted(cls, part1, part2) Determines if there is a contact between the specified parts. :param part1: First part to determine contact. :type part1: Part, List[Part] :param part2: Second part to determine contact. :type part2: Part, List[Part] :returns: The found contact object. :rtype: MotionContact .. _getIntersections: .. classmethod:: getIntersections(cls, visibleOnly=True) Finds the parts of the all contacts that intersect. :param visibleOnly: Search only for visible contacts. :type visibleOnly: bool :returns: A list of pair of parts that intersect. :rtype: list(tuple(Part)) .. _hideContacts: .. classmethod:: hideContacts(cls) Hides graphics for the contact while in the context. .. _isValidPart: .. classmethod:: isValidPart(cls, part) Determines if the specified part is valid for creating a motion contact. :param part: Part for which to determine the validity. :type part: Part :returns: True if its a valid part, False otherwise. :rtype: bool .. _showContacts: .. classmethod:: showContacts(cls, on=True) Shows graphics for the contact while in the context. .. _getContactingPartPairs: .. method:: getContactingPartPairs(self) Returns a generator of pairs (Features or Parts) that are in contact. .. _getIntersectingParts: .. method:: getIntersectingParts(self) Finds the parts of the contact that intersect. :returns: A list of pair of parts that intersect. :rtype: list(tuple(Part))