Sphere Sphere Contact - MapleSim Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Sphere Sphere Contact

Sphere-sphere contact force model

 

Description

Connections

Parameters

Description

The Sphere Sphere Contact model connects Sphere and Sphere contact elements.

Activation

Contact forces are generated only when the contacts are enabled.

The active parameter selects how the contacts are enabled. It has the following settings:

Always Active, the default, means the contacts are always enabled.

Boolean Signal means the contacts are enabled when the enable contact boolean input is true.

Start/Stop Time means the contacts are enabled at specified start time, Ton, and disabled at a specified stop time, Toff.

The on/off parameter is used with the Start/Stop Time selection and has the following settings:

Start Time means the contacts are enabled at Ton.

Stop Time means the contacts are disabled at Toff.

Start/Stop Time means the contacts are enabled at Ton and disabled at Toff.

Contact Properties

The use record boolean parameter, if enabled, specifies the name of an external record parameter that defines the parameters of the contact.

The mode parameter selects one of three modes: Linear spring and damper, Linear spring and limited damper, and Hunt and Crossley. The first two use the c and d parameters to set the spring and damping constants. The Hunt and Crossley model uses the parameters cn, dn, n, p, and q. See the Multibody Contact Modes help page for the resulting force equations.

The μ parameter is the coefficient of friction between contacting bodies.

The kμ parameter is a smoothness coefficient for sliding friction, it scales μ by tanhkμvt, where vt is the tangential velocity.

The ε parameter specifies a minimum length used when normalizing vectors.

Connections

Name

Description

Modelica ID

enablecontact

Optional boolean input; enable contact

enable_contact

port1

Connection to spheres

port_1

port2

Connection to spheres

port_2

Parameters

Name

Default

Units

Description

Modelica ID

active

Always Active

 

Selects contact activation

active

on/off

Start Time

 

Selects start/stop times

onoff

Ton

0

s

On time

Ton

Toff

0

s

Off time

Toff

use record

false

 

Use contact properties record

useRecord

mode

Linear spring and damper

 

Contact force formulation

mode

c

104

Nm

Spring constant (c>0)

c

d

0

Nsm

Damping constant

d

cn

104

 

Nonlinear spring constant (cn>0)

cn

dn

0

 

Nonlinear damping constant

dn

n

1.5

 

Nonlinear elastic force exponent

n

p

n

 

Nonlinear damping force exponent

p

q

1

 

Nonlinear damping force exponent

q

μ

0

 

Coefficient of friction

mu

kμ

1

 

Smoothness coefficient for sliding friction

kTANH

ε

1.×10−6

 

Minimum length of vectors for normalization

eps

contact properties

 

 

Name of contact property record component

conparams

nsphere1

1

 

Number of spheres at port 1

nSphere1

use sphere to sphere contact at port 1

false

 

True (checked) means model contacts between the spheres at port 1

useSphereSphereContact1

nsphere2

1

 

Number of spheres at port 2

nSphere2

use sphere to sphere contact at port 2

false

 

True (checked) means model contacts between the spheres at port 2

useSphereSphereContact2

inside contact

false

 

True (checked) means contact is inside sphere

insideContact

See Also

Forces

Multibody

Multibody Contacts