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

Online Help

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,  (see Surface), and the inclination angle,  (see Tire Kinematics).

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

where   is the tire center speed with respect to ISO Z,  is tire stiffness,  is tire damping, and   is tire unloaded radius. The use of the min function is to ensure that  is continuous at .

Slip Calculations

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

Above,  is the tire effective radius and is considered to be equal to the loaded radius,  for the tire component.   is the tire speed of revolution, and  and  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 .

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:

Equations

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

When  is true, the longitudinal and lateral forces are linearly dependent on . When  is false, the longitudinal and lateral forces are not dependent on , 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., .

Connections

Name

Description

Modelica ID

Multibody frame for tire center

frame_a

Signal output for the normal force

Fz

Signal output for tire inclination angle or camber

IncAng

Signal output for longitudinal slip

LongSlip

Signal output for tire effective radius

r_eff

Signal output for slip angle

SlipAng

Signal output for tire speed of revolution or spin rate

SpinRate

[1] Vector signal input for surface normal vector

en_in

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

rz_in

[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

Nominal load

Fz0

Longitudinal force coefficient

Clong

Lateral force coefficient

Clat

Inertia

Name

Default

Units

Description

Modelica ID

Use inertia

 

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

useInertia

Tire mass

Mass

[I]

[1]

Rotational inertia, expressed in frame_a (center of tire)

Inertia

[1]

Initial Conditions

Name

Default

Units

Description

Modelica ID

Use Initial Conditions

 

True (checked) enables the following parameters

useICs

 

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

MechTranTree

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

InitPos

Velocity Frame

 

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

VelType

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

InitVel

 

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

MechRotTree

 

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

 

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

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

InitAng

Angular Velocity Frame

 

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

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

Tire radial stiffness

C

Damping

Tire radial damping

K

Settings

Name

Default

Units

Description

Modelica ID

[0,1,0]

 

Tire's spin axis (local)

SymAxis

Size

Name

Default

Units

Description

Modelica ID

Unloaded tire radius

R_0

Surface

Name

Default

Units

Description

Modelica ID

Flat surface

 

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

flatSurface

Defined externally

 

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

externallyDefined

Base distance for local surface patch approximation

deltaL

Data source

 

Data source for the uneven surface.  See following table.

datasourcemode

Surface data

 

 

Surface data; matrix or attached data set

table or data

Smoothness

 

Smoothness of table interpolation

smoothness

 

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

 

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

useTimeLag

Time lag for longitudinal slip

Tlong

Time lag for slip angle

Tlat

Visualization

Name

Default

Units

Description

Modelica ID

Show tire

 

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

showTire

Tire width (for visualization)

D_w

Tire color

 

Tire color

color00

Band color

 

Tire band color

color01

Tire transparency

 

True (checked) means the tire is transparent

transparent0

Show force arrow

 

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

showForceArrow

Show components

 

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

 

Specifies the color of the force arrow

color1

Force arrow transparency

 

True (checked means the force arrow is transparent

transparent1

Force arrow scale

Scales the length of the force arrow

scale1

Show torque arrow

 

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

showMomentArrow

Show components

 

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

 

Specifies the color of the torque arrow

color2

Torque arrow transparency

 

True (checked) means the torque arrow is transparent

transparent2

Torque arrow scale

Scales the length of the torque arrow

scale2

Show tangent plane

 

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

ShowTanSurface

Patch visualization thickness

th0

Patch visualization radius

r_patch

Patch color

Green

 

Color of the contact patch

color3

Patch transparency

 

True (checked) means contact patch is transparent

transparent3

Advanced Parameters

Name

Default

Units

Description

Modelica ID

Dependency factor of longitudinal/lateral forces on the normal force

kFz

Velocity threshold used for singularity avoidance in the slip calculations

V_x_min

 

Used to smooth  as

epsilon_sign

 

Used to prevent singularity in vector normalization

epsilon_norm

See Also

Surface

Tire Kinematics

Tires

 


Download Help Document