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

Online Help

All Products    Maple    MapleSim


Linear

Linear tire formulation

 

Description

Details

Equations

Connections

Parameters

Description

The Linear tire component provides a linear relationship between the slip angle and longitudinal slip of the tire, and the lateral and longitudinal forces developed at the contact patch. The aligning moment, rolling resistance and overturning moment are assumed to be zero.

The tire geometry is assumed to be a thin circular disk, which is common in automotive applications.  A single point contact is considered for the tire-ground interaction.

The tire kinematics used in this component are described in detail in Tire Kinematics.

Several options are available for defining the surface on which the tire is operating. These options are explained in Surface.

Details

Normal Force

The normal force exerted by the surface to the tire is calculated using the given compliance parameters and surface geometry.

The tire loaded radius is calculated using the distance of the tire center from the surface, rz (see Surface), and the inclination angle, γ (see Tire Kinematics).

rL=rzcosγ

Using a linear spring and saturated damping forces based on the tire compliance, the normal force, Fz, is calculated as follows

FzC&equals;{CR0rLrL<R00otherwise

FzK&equals;{KVzrL<R00otherwise

Fz&equals;{FzC&plus;minFzC&comma;FzK0<FzC&plus;FzK0otherwise

where Vz  is the tire center speed with respect to ISO Z, C is tire stiffness, K is tire damping, and R0  is tire unloaded radius. The use of the min function is to ensure that Fz is continuous at rL&equals;R0.

Slip Calculations

The following equations for longitudinal slip, κ, and slip angle, α, hold true on a flat surface with no inclination angle:

κ&equals;{ΩreVxVx&verbar;Vx&verbar;&gt;VxminΩreVx2VxminVx2&plus;Vxmin2otherwise

tanα&equals;{VyVx&verbar;Vx&verbar;&gt;VxminVy2VxminVx2&plus;Vxmin2otherwise

Above, re is the tire effective radius and is considered to be equal to the loaded radius, rL for the tire component. Ω  is the tire speed of revolution, and Vx and Vy are the speeds of the tire center with respect to ISO X and ISO Y axes, respectively. The component code implementation is such that the longitudinal slip and slip angle are continuous and differentiable in the neighborhood of Vx&equals;0.

Using Time Lags

A first-order dynamics to the longitudinal slip and slip angle calculation can be introduced in the Time Lags section of the component properties. When active, the following slip formulation will be used:

Tlongdκdt&equals;reΩVxκVx

Tlatddttanα&equals;VytanαVx

Equations

The formulation for resultant forces/moments of tire-surface interaction at the tire contact patch are summarized below for the linear tire component.

Fx&equals;{ClongκFzFz0use Fz&equals;trueClongκtanhkFzFzotherwise

Fy&equals;{ClatαFzFz0use Fz&equals;trueClatαtanhkFzFzotherwise

Mx&equals;My&equals;Mz&equals;0

When use Fz is true, the longitudinal and lateral forces are linearly dependent on Fz. When use Fz is false, the longitudinal and lateral forces are not dependent on Fz, however, a tanh function is used so that the tire does not generate longitudinal or lateral forces when not in contact with the ground, i.e., Fz&equals;0.

Connections

Name

Description

Modelica ID

framea

Multibody frame for tire center

frame_a

Fz

Signal output for the normal force

Fz

IncAng

Signal output for tire inclination angle or camber

IncAng

LongSlip

Signal output for longitudinal slip

LongSlip

reff

Signal output for tire effective radius

r_eff

SlipAng

Signal output for slip angle

SlipAng

SpinRate

Signal output for tire speed of revolution or spin rate

SpinRate

enin

[1] Vector signal input for surface normal vector

en_in

rzin

[1] Signal input for tire center distance from the surface

rz_in

rc

[1] Vector signal output for tire center position w.r.t. the inertial frame

r_c

[1] Available if Surface parameters Flat surface is false and Defined externally is true.

Parameters

Coefficients

Name

Default

Units

Description

Modelica ID

Use Fz dependency

false

 

True (checked) means that longitudinal/lateral forces will also linearly depend on the normal force

useFz

Fz0

4000

N

Nominal load

Fz0

Clong

1.15·105

N

Longitudinal force coefficient

Clong

Clat

1.17·105

N

Lateral force coefficient

Clat

Inertia

Name

Default

Units

Description

Modelica ID

Use inertia

false

 

True (checked) means use mass and inertia parameters for tire and enable the following two parameters

useInertia

m

28

kg

Tire mass

Mass

[I]

[1]

kgm2

Rotational inertia, expressed in frame_a (center of tire)

Inertia

[1] 0.780001.560000.78

Initial Conditions

Name

Default

Units

Description

Modelica ID

Use Initial Conditions

false

 

True (checked) enables the following parameters

useICs

ICr&comma;v

Ignore

 

Indicates whether to ignore, try to enforce, or strictly enforce the translational initial conditions

MechTranTree

r&conjugate0;0

0&comma;0&comma;0

m

Initial displacement of frame_a (tire center) at the start of the simulation expressed in the inertial frame

InitPos

Velocity Frame

Inertial

 

Indicates whether the initial velocity is expressed in frame_a or inertial frame

VelType

v&conjugate0;0

0&comma;0&comma;0

ms

Initial velocity of frame_a (tire center) at the start of the simulation expressed in the frame selected in Velocity Frame

InitVel

ICθ&comma;ω

Ignore

 

Indicates whether to ignore, try to enforce, or strictly enforce the rotational initial conditions

MechRotTree

Quaternions

false

 

Indicates whether the 3D rotations will be represented as a 4 parameter quaternion or 3 Euler angles. Regardless of setting, the initial orientation is specified with Euler angles.

useQuats

Euler Sequence

1&comma;2&comma;3

 

Indicates the sequence of body-fixed rotations used to describe the initial orientation of frame_a (center of mass). For example, [1, 2, 3] refers to sequential rotations about the x, then y, then z axis (123 - Euler angles)

RotType

θ&conjugate0;0

0&comma;0&comma;0

rad

Initial rotation of frame_a (center of tire) at the start of the simulation (based on Euler Sequence selection)

InitAng

Angular Velocity Frame

Euler

 

Indicates whether the initial angular velocity is expressed in frame_a (body) or the inertial frame. If Euler is chosen, the initial angular velocities are assumed to be the direct derivatives of the Euler angles.

AngVelType

ω&conjugate0;0

0&comma;0&comma;0

rads

Initial angular velocity of frame_a (center of tire) at the start of the simulation expressed in the frame selected in Angular Velocity Frame

InitAngVel

Radial Compliance

These parameters define the radial compliance of the tire.

Name

Default

Units

Description

Modelica ID

Stiffness

3.04·105

Nm

Tire radial stiffness

C

Damping

500

Nsm

Tire radial damping

K

Settings

Name

Default

Units

Description

Modelica ID

eSpin

[0,1,0]

 

Tire's spin axis (local)

SymAxis

Size

Name

Default

Units

Description

Modelica ID

R0

0.355

m

Unloaded tire radius

R_0

Surface

Name

Default

Units

Description

Modelica ID

Flat surface

true

 

True (checked) means the road surface is assumed flat. It is defined by a plane passing through (0,0,0) and the normal vector given by e&Hat;g

flatSurface

Defined externally

false

 

True (checked) means the road surface is defined external to the tire component. Additional input and output signal ports are activated.

externallyDefined

δL

0.01

m

Base distance for local surface patch approximation

deltaL

Data source

inline

 

Data source for the uneven surface.  See following table.

datasourcemode

Surface data

 

 

Surface data; matrix or attached data set

table or data

Smoothness

linear

 

Smoothness of table interpolation

smoothness

nIter

2

 

Number of iterations to find the contact point candidate, recommended value between 1 and 5

nIter

Content of Data source matrix.

Surface normal

First Column

First Row

Global Z

x values

y values

Global Y

z values

x values

Global X

y values

z values

Time Lags

Name

Default

Units

Description

Modelica ID

Use time lags

false

 

True (checked) means use time lags in slip calculation and enable the following two parameters

useTimeLag

Tlong

0.3

s

Time lag for longitudinal slip

Tlong

Tlat

0.3

s

Time lag for slip angle

Tlat

Visualization

Name

Default

Units

Description

Modelica ID

Show tire

false

 

True (checked) creates a tire visualization and enables following three parameters

showTire

Dw

0.1

m

Tire width (for visualization)

D_w

Tire color

black

 

Tire color

color00

Band color

yellow

 

Tire band color

color01

Tire transparency

false

 

True (checked) means the tire is transparent

transparent0

Show force arrow

false

 

True (checked) display a force vector and enables the following three parameters

showForceArrow

Show components

false

 

True (checked) means three arrows for force components in ISO axes will be shown instead of a single total force arrow

showForceComponents

Force arrow color

red

 

Specifies the color of the force arrow

color1

Force arrow transparency

false

 

True (checked means the force arrow is transparent

transparent1

Force arrow scale

1

Nm

Scales the length of the force arrow

scale1

Show torque arrow

false

 

True (checked) displays a torque vector and enables the following three parameters

showMomentArrow

Show components

false

 

True (checked) means three arrows for torque components in ISO axes will be shown instead of a single total torque arrow

showMomentComponents

Torque arrow color

blue

 

Specifies the color of the torque arrow

color2

Torque arrow transparency

false

 

True (checked) means the torque arrow is transparent

transparent2

Torque arrow scale

1

Nmm

Scales the length of the torque arrow

scale2

Show tangent plane

false

 

True (checked) displays the tangent plane of the contact patch and enables the following four parameters

ShowTanSurface

th0

0.01

m

Patch visualization thickness

th0

rp

0.2

m

Patch visualization radius

r_patch

Patch color

Green

 

Color of the contact patch

color3

Patch transparency

false

 

True (checked) means contact patch is transparent

transparent3

Advanced Parameters

Name

Default

Units

Description

Modelica ID

kFz

0.01

1N

Dependency factor of longitudinal/lateral forces on the normal force

kFz

Vxmin

0.1

ms

Velocity threshold used for singularity avoidance in the slip calculations

V_x_min

εsgn

0.001

 

Used to smooth signx as tanhxεsgn

epsilon_sign

εnorm

1·10−8

 

Used to prevent singularity in vector normalization

epsilon_norm

See Also

Surface

Tire Kinematics

Tires