Professional Documents
Culture Documents
2 Adams/Tire
Introducing Adams/Tire
Introducing Adams/Tire
Adams/Tire software is a module you use with Adams/Car, Adams/Chassis, Adams/Solver, or
Adams/View to add tires to your mechanical model and to simulate maneuvers such as braking, steering,
acceleration, free-rolling, or skidding. Adams/Tire lets you model the forces and torques that act on a tire
as it moves over roadways or irregular terrain.
Adams/Tire is a set of shared object libraries that Adams/Solver calls through the Adams DIFSUB,
GFOSUB, GSESUB subroutines. These subroutines calculate the forces and moments that tires exert on
a vehicle as a result of the interaction between the tires and road surface.
You can use Adams/Tire to model tires for either vehicle-handling, ride and comfort, and vehicle-
durability analyses.
• Handling analyses are useful for studying vehicle dynamic responses to steering, braking, and
throttle inputs. For example, you can analyze the lateral accelerations produced for a given
steering input at a given vehicle speed.
• Ride and comfort analyses are useful for assessing the vehicle's vibrations due to uneven roads
with short wavelength obstacles (shorter than tire circumference), such as level crossings,
grooves, or brick roads.
• 3D contact analyses are useful for generating road load histories and stress and fatigue studies
that require component force and acceleration calculation. These studies can help you calculate
the effects of road profiles, such as pothole, curb, or Belgian block.
Adams/Tire Modules
Adams/Tire has a line of tire modules that you can use with Adams/View, Adams/Solver, Adams/Car,
and Adams/Chassis. The modules let you model the rubber tires found on many kinds of vehicles, such
as cars, trucks, and planes. More specifically, the modules let you model the force and torque that tires
produce to accelerate, brake, and steer vehicles. The five modules available in Adams/Tire are:
• Adams/Tire Handling Module
• Adams/Tire 3D Spline Road Module
• Adams/Tire 3D Shell Road Module
• Specific Tire Models
• Features in Adams/Tire Modules
Adams/Tire Handling uses a point-follower method to calculate tire normal force. Standard Adams/Tire
is limited to two-dimensional roads, but can be extended with the three-dimensional capabilities of
Adams/Tire 3D Spline Road.
*The formulae used in the Pacejka tire models are derived from publications, and are commonly referred
to as the Pacejka method in the automotive industry. Dr. Pacejka himself is not personally associated
with the development of these tire models, nor does he endorse them in any way.
Note: * Adams/Tire (included in Adams/Car Package) is not required to run the Fiala Tire Model.
The Fiala tire can be run with Adams Basic package.
Some of the Handling Tire models can describe the first-order response of a tire, but do not take the
eigenfrequencies of the tire itself into account. Therefore, the Handling Tire models are valid up to
approximately 8 Hz. The PAC2002 uses a contact mass method that enables it to describe tire behavior
up to 15 Hz. Beyond that, a tire model should be used, including modeling the tire belt, as FTire does.
Adams/Tire Steps
To use Adams/Tire:
1. Define tires. How you define tires depends on the product you are using (Adams/Chassis,
Adams/Car, or Adams/Solver). For more information on defining tires, see Defining Tires.
Regardless of the product you use, the product creates an Adams dataset (.adm), which contains
the necessary statements that represent the tires in your Adams model, as well as other elements
of the vehicle, such as the wheel, suspension, and landing gear strut. The primary statement for
each tire is a GFORCE that applies the tire force to the wheel in your suspension.
4 Adams/Tire
Use and Understanding of Adams/Tire
Invoking Adams/Tire
• When you perform an analysis, Adams/Solver investigates your .adm file to find elements that
represent a tire. For example, it looks for a GFORCE with the necessary parameters to define the
force to the wheel in your suspension. When it finds these parameters, it invokes Adams/Tire.
• Adams/Solver obtains the names of the tire property file (.tir) and road property file (.rdf) from
the STRING statements in the .adm file.
Performing Calculations
• The Tire Object Manager calls the selected tire model to calculate the tire forces and moments.
• The tire model reads the tire property file to obtain data for calculating the tire forces and
moments. It then calls the road model to evaluate where the road is in relation to the tire.
• The road model reads the road property file to obtain data about the road.
6 Adams/Tire
Use and Understanding of Adams/Tire
Defining Tires
If you use Adams/Car or Adams/Chassis, typically the models you work with will already include tires
(for example, the statements necessary to invoke Adams/Tire). Therefore, you do not need to add tires to
your model. If you work with Adams/View, however, you will need to define the tires, and for
Adams/Solver, add statements to your Adams model using Adams/View or a text editor. Learn how to
work with:
• Adams/View
• Adams/Car
• Adams/Chassis
• Adams/Solver
• Defining Wheel Inertia
The Modify Wheel dialog box appears with options that allow you to modify the tire property file
and wheel inertia.
Note: You can also use the Display Tire Property File tool to display the tire property file in
an Information window. You cannot, however, specify or display the road property file
from this dialog box. In Adams/Car, you specify the road property file when you submit a
full-vehicle analysis
2. Change the values as desired, and then select OK. Learn about entering values in Create/Modify
Wheel dialog box.
3. Edit the wheels and tires, such as edit the tire property files and change the scaling coefficients.
Learn About Tire Subsystems in Adams/Chassis.
editor. For a car with four tires, you need four sets of statements. The table below describes the sets of
statements. The table, MARKER Locations and Orientations, describes how to locate and orient the three
MARKERs.
Note: The STRING for "contact type" is required for Adams to correctly
create the STI tire, but it does not change the contact method, which
is based entirely on the road model.
ARRAY (1) Holds the IDs of the GFORCE, DIFF, and STRING statements.
Learning Adams/Tire 11
Defining Tires
Marker statements
required in dataset: Location and orientation:
Wheel center marker Because the tire applies forces to the wheel center marker, you must define
the wheel center so that it belongs to the wheel part and is located at the
wheel center. You orient the wheel center as follows:
• x-axis lies in the wheel plane and points in the forward direction of the
wheel.
• y-axis lies along the wheel's spin axis and points towards the left side of
the vehicle.
• z-axis lies in the wheel plane and points upward.
Road floating marker The tire applies the reaction forces to the road floating marker. The road
floating marker must belong to the road part, usually ground, and must be
defined as FLOATING. Because the marker floats, you do not enter a
location or orientation.
Road reference marker The road reference marker gives the location and orientation of the road.
You define the road reference marker so that it belongs to the road part,
usually ground. In addition, the road reference marker’s z-axis must be
directed upward, meaning the z-axis is parallel to, but points in the opposite
direction of, the gravity vector.
Locations of the points on the road contained in the road property file are
given relative to this marker. Generally, the road reference marker should
be located on the road surface and below the wheel center by approximately
the static loaded radius of the tire.
Example Dataset
This section gives you an example dataset fragment that includes a complete set of statements for a single
tire. The example is based on the following assumptions:
• PART/21 is the wheel and PART/99 is ground.
• The orientations assume that the ground part's x-axis points towards the rear of the vehicle, the
y-axis points towards the right side of the vehicle, and the z-axis points upward.
! adams_view_name='wheel_center_marker'
MARKER/1
, PART=21
, QP = 0,0,0
, REU = 180D, 0D, 0D
!
adams_view_name='road_floating_marker'
MARKER/2
12 Adams/Tire
Defining Tires
, PART = 99
, FLOATING
!
adams_view_name='road_reference_marker'
MARKER/3
, PART = 99
! adams_view_name='tire_forces'
GFORCE/1
, I = 1
, JFLOAT = 2
, RM = 3
, FUNCTION = USER(900,1,100)/
, ROUTINE=abgTire::gfo900
!
adams_view_name='tire_force_dif1'
DIFF/2
, IC = 0
, FUNCTION = USER(900,1,100)/
, ROUTINE=abgTire::dif900
!
adams_view_name='tire_force_dif2'
DIFF/3
, IC = 0
, FUNCTION = USER(900,1,100)/
, ROUTINE=abgTire::dif900
!Map for GFORCE/DIFF USER Functions:
!-----------------------------------
!par(1): dispatcher branch for tire request (always 900).
!par(2): tire GFORCE statement id.
!par(3): tire ARRAY statement id.
!
adams_view_name='tire_input_array'
ARRAY/100
,IC
,SIZE=9
,NUM= 2, 3, 1, 99, 100, 101, 102, 103, 0
!array[ 1] : 1st DIFF statement id
!array[ 2] : 2nd DIFF statement id
!array[ 3] : side flag (0 left, 1 right)
!array[ 4] : tire_minor_role STRING id
!array[ 5] : tire_property_file STRING id
!array[ 6] : simulation_type STRING id
!array[ 7] : road_property_file STRING id
!array[ 8] : road_contact_type STRING id
!array[ 9] : RIGID_WHEEL Radius (SUSPENSION analysis tire only)
!
adams_view_name='tire_rolling_states'
REQUEST/1,
, FUNCTION = USER(902,1,1)
!
adams_view_name='tire_kinematic_states_ISO'
REQUEST/2,
, FUNCTION = USER(902,2,1)
!
Learning Adams/Tire 13
Defining Tires
adams_view_name='tire_forces_contact_patch_ISO'
REQUEST/3,
, FUNCTION = USER(902,3,1)
!Map for REQUEST USER Functions:
!-------------------------------
!par(1) = branch for tire request (always 902).
!par(2) = reqtyp = {1,2,3,4,5,6,7.8.9.10,11}
!par(3) = tire GFORCE statement id.
!String Statements Description of use:
!------------------
!
! adams_view_name='tire_minor_role'
! Used by Adams/Car to determine minor role (for example, FRONT or
REAR).
STRING/99
,S=front
! adams_view_name='tire_property_file'
! Used by TYRxxx routines. Name of tire property file including
full path that
! contains tire data or 'RIGID_WHEEL' for use in a suspension
analysis.
STRING/100
,S=mdi_tire01.tir
!
adams_view_name='simulation_type'
! Used by Adams/Car to determine analysis to be performed one of
'VEHICLE_HANDLING_DYNAMIC'
or 'SUSPENSION'
STRING/101
,S=VEHICLE_HANDLING_DYNAMIC
!
adams_view_name='road_property_file'
! Used by ARCxxx routines. Name of road property file including
full path that
! contains road data or 'BEDPLATE' for a flat, rigid road used
! with suspension analysis.
STRING/102
,S=example_2d_flat.rdf
! adams_view_name='road_contact_type'
! handling/durability
!
STRING/103
, STRING =handling
The Create Wheel and Tire dialog box appears with options that allow you to introduce the
wheel inertia, tire property file, and side of the vehicle.
2. Enter the values as desired to define the tire, and then select OK. Learn more with Create/Modify
Wheel and Tire dialog box help.
Creating a Road
If your model includes tires, you must specify a road because each tire must reference a road. The road
determines the surface friction, bumps, and other inputs to tires.
16 Adams/Tire
Defining Tires
3. Enter the values as desired, and then select OK. Learn more about the values with Create/Modify
Road dialog box help..
Note: This dialog box generates a tire interface based on the general-state equation subroutine. A
more simple interface is shown in Defining Tires Using Adams/Solver.
Adams/Tire FTire
In FTire, a part of the tire can move with respect to the rim. Therefore, the tire mass and moments of
inertia have to be split into two parts: a part that is moving with the rim (wheel part) and a part that is
moving with the tire itself. This subdivision is performed during preprocessing of the tire property (.tir)
file. When a simulation begins with FTire, the following lines appear in the .msg file:
CTI: add the following mass properties to the rim in your MBS
model
CTI: (the 'rim-fixed' tire parts which are not accounted for in
FTire):
The inertia data printed after this message has to be added to the rim inertia and used to defined the wheel
part inertia. Modification of the wheel part is not done automatically.
18 Adams/Tire
Simulations and Results
Performing Simulations
Once you have incorporated the required statements for modeling a tire into your dataset, you can submit
the dataset for simulation. If you have Adams/Car installed, you can submit your dataset to the
Adams/Car version of Adams/Solver, or you can create an Adams/Solver user library and then run your
simulation using this library and standard Adams/Solver.
• On UNIX, from the Adams Toolbar, right-click the Adams/Car tool, and then select
Adams/Car - Solver.
Note: You can also set the Adams/Car tool on the Adams Toolbar to automatically run
Adams/Car with Adams/Solver. For more on the Adams Toolbar see Configuring Adams.
c. On UNIX, from the Adams Toolbar, right-click the Adams/Solver tool, point to New,
and then select Adams/Solver User Library. Enter the parameters to define how to create the
library. For more information see Creating User Libraries in Running and Configuring Adams.
Note: On Windows, you can now enter the FORTRAN file directly without first compiling it.
• On UNIX, from the Adams Toolbar, right-click the Adams/Solver tool, point to Select
Library, and then select a library, such as mysol.
Note: You can also set the AdamsAdams/Solver tool on the Adams Toolbar to automatically run
with your user library. For more on the Adams Toolbar, see Running and Configuring
Adams.
Outputting Results
If you combine requests with a USER function, you can output tire results to the request (.req) and results
(.res) files. The form of the request statement is:
REQUEST/id
, FUNCTION = USER(902, REQTYP, TIR_ID)/
, ROUTINE = abgTire::req902
where:
For information on the axis systems and sign conventions for these outputs, see About Axis Systems and
Sign Conventions.
20 Adams/Tire
Simulations and Results
Tire Outputs
REQTYP
Output: Request: Component definitions:
Tire rolling states 1 x = rolling radius
y= (rad/sec)
z= free (rad/sec)
is the actual angular velocity about the wheel's axis, while
free is the velocity of the wheel's axle center divided by
the radius to the instantaneous center of rotation. The
difference between the two is, therefore, a measure of the slip
when the vehicle is accelerating or decelerating.
Tire kinematic properties 2 x = longitudinal slip (%)
in TYDEX-W axis (ISO)
system. y = lateral slip angle (degrees)
REQTYP
Output: Request: Component definitions:
Tire kinematic properties 5 x = longitudinal slip (%)
in SAE axis system
y = lateral slip angle (radians)
z = FX moment arm*
r3 = gyroscopic moment*
Miscellaneous tire states 9 x = inclination angle induced side force*
#3
y = surface friction
22 Adams/Tire
Simulations and Results
REQTYP
Output: Request: Component definitions:
Miscellaneous tire states 14 x = distance traveled*
#4
y = effective plane height*
r2 = contact length*
Contact patch locations 10 x = road contact point X location
(the contact patch
y = road contact point Y location
location along the plane
of the tire in the z = road contact point Z location
GFORCE reference
marker’s coordinate r1 = tire radial penetration into the road surface
system.) r2 = tire radial penetration velocity into the road surface
Hub and wheel velocities 11 x = hub longitudinal velocity in wheel carrier (TYDEX-C)
axis system
y = tire longitudinal velocity at the contact patch in the
contact patch axis system
z = tire lateral velocity at the contact patch in the contact
patch axis system
Learning Adams/Tire 23
About Axis Systems and Sign Conventions
Units
The following tables list the valid choices for the parameters in the UNITS section of a tire property file.
Note the following:
• You must enter the choices in single quotes, such as 'METER' for meter.
• The choices are case-insensitive. Therefore, 'MeTeR,' 'meter,' and 'METER' are all equivalent.
• The strings are limited to 12 characters and the minimum abbreviation is shown in the tables. So,
for example, 'millisecond' is valid and is interpreted as 'MILLI.’
Note: For some tire models, the [UNITS] section is not applied consistently to all tire parameters.
The exceptions are the Magic Formula coefficients for the Pacejka ‘89 and ‘94 model and
spline data for the 521 model, where the unit conversion factors have to be defined
explicitly.
Length Units
Time Units
Angle Units
Mass Units
Force Units
A scheme of the Tire Data and Fitting Tool or Tyre Data and Fitting Tool is shown below.
Learning Adams/Tire 31
PAC2002 Tire Data and Fitting Tool (TDFT)
1. Create a measurement input data file for the tire parameter identification process:
This Section explains how to create a measurement/virtual data input file. The TDFT uses the following
3 keys to identify pure and combined slip measurement data in the measurement data file:
1. [FX_PURE] - Pure longitudinal slip (kappa) versus longitudinal force (Fx) data.
2. [FYMZ_PURE] - Pure lateral slip (alpha) versus lateral force (Fy) and/or self-aligning torque
(Mz) data.
3. [FXYMZ_COMBINED] - Combined longitudinal and lateral slip versus longitudinal, lateral
and self-aligning torque data.
Note: It is important that measurement data is expressed in ISO coordinates. (See also Axis
Systems and Slip Definitions in PAC2002 Tire Model.).
An example measurement data file containing measurement data for both pure and combined slip
conditions 'fm_data_example_tdft.txt' can be found in following directory
<adams_install>/acar/shared_car_database.cdb/tires.tbl.
Following Figures show some typical tire characteristics expressed in ISO coordinates and also show the
sign convention used in the TDFT for longitudinal, lateral force and self-aligning torque. The curves are
created using the example measurement data file ‘fm_data_example_tdft.txt’.
32 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
Figure 1 Pure slip condition: longitudinal slip (kappa) versus longitudinal force (Fx).
Figure 2 Pure slip condition: lateral slip (alpha) versus lateral force (Fy).
Learning Adams/Tire 33
PAC2002 Tire Data and Fitting Tool (TDFT)
Figure 3 Pure slip condition: lateral slip (alpha) versus self-aligning torque (Mz).
The order of the measurement/virtual data signals must be specified. It is possible to do this for each
measurement/virtual data Section by adding Section [FX_PURE_SIGNALS],
34 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
It is also possible to define a Section [SIGNALS] that specifies the order of the measurement
data/virtual data signals for all measurement/virtual data Sections, for example.
$----------------------------------------------------------------units
[SIGNALS]
ALPHA = 1
KAPPA = 2
CAMBER = 3
FZ = 4
FX = 5
FY = 6
MZ = 7
Note: It is not necessary to store all data in a single file. Multiple measurement data files can be
used as input to the TDFT.
2. Create an empty tire by selecting File -> Create New Tire Property (default values) from the
menu bar (see red arrow in Figure 4). Default values are specified in
<adams_install>/acar/shared_car_database.cdb/tires.tbl/tdft_template.tir
It is also possible to use an existing PAC2002 tire property file as a base for the tire identification
process to add new and/or overwrite existing tire parameters. To import a tire property file, select
File -> Open Tire Property and Add to Tire Database… from the menu bar.
Note: You set the environment variable TDFT_TEMPLATE_PATH to overwrite the default
location of tdft_template.tir (which is the Adams/Car Shared Tires Database).
36 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
3. It is important to verify that following parameters are specified because these parameters are used
in the PAC2002 tire model to make the tire parameters dimensionless:
Under entry Vertical in the left column (see red arrow in Figure 5): FNOMIN ($Nominal wheel
load)
Under entry Dimension in the left column (see red arrow in Figure 5): UNLOADED RADIUS
($Free tire radius)
Learning Adams/Tire 37
PAC2002 Tire Data and Fitting Tool (TDFT)
4. Select the tire by clicking on the top of the tire data column (1). Click on the Tire Fit button (see
red arrow in Figure 6) in the PAC2002 Tire Data and Fitting Tool or select Run -> Tire Fit from
the menu bar to start the Tire Fit Tool.
5. Figure 7 shows the Tire Fitting Tool. Clicking on the available entries to the left, start values and
lower/upper boundaries for each parameter of the identification process are shown and may be
modified, see Figure 8.
Default values are specified in
<adams_install>/acar/shared_car_database.cdb/tires.tbl/tdft_template.tir.
6. Select Add Measurements (see red arrow in Figure 9) and add the measurement data files to the
Measurement File(s) Table. See
<adams_install>/acar/shared_car_database.cdb/tires.tbl/fm_data_example_tdft.txt for an
example measurement data file containing steady-state force and moment measurement data for
pure and combined slip conditions.
7. If measurement data for both pure and combined slip conditions is available, select
Characteristic = All under Fitting Parameters and click on Start. Now, all tire characteristics will
be fitted in following order:
a. Fx_pure
b. Fy_pure
c. Mz_pure
d. Fx_combined
e. Fy_combined
f. Mz_combined
It is also possible to fit each tire characteristic separately if not all measurement data is available.
Select the desired Characteristic under Fitting Parameters.
Force/Moment expressions for the combined slip conditions are based on the expressions for the
pure slip conditions. Therefore, the force and/or moment for pure slip conditions need to be fitted
first before fitting the combined slip conditions.
40 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
Note: • Fy (and Fx in case of combined slip conditions) needs to be fitted before Mz because
the Mz formulation depends on the lateral force Fy.
• The .log files in the working directory show the result of the tire identification process.
The fit error (=100*sqrt(((measurement data)^2 - (model
data)^2)/(measurement_data)^2) ) and variations of each tire parameter are shown.
• The X[0], X[1], X[2], etc are the tire parameters that are identified and could be seen in
the log file generated in your working directory. For instance, if you perform a tire fit
for the FX_PURE coefficients then following parameters are being identified (see also
pac2002_205_55R16_tdft.tir, Section Longitudinal_Coefficients):
PCX1 = 1.3178 $Shape factor Cfx for longitudinal force
PDX1 = 1.0455 $Longitudinal friction Mux at Fznom
PDX2 = 0.063954 $Variation of friction Mux with load
PDX3 =0 $Variation of friction Mux with camber
PEX1 = 0.15798 $Longitudinal curvature Efx at Fznom
PEX2 = 0.41141 $Variation of curvature Efx with load
PEX3 = 0.1487 $Variation of curvature Efx with load squared
PEX4 = 3.0004 $Factor in curvature Efx while driving
PKX1 = 23.181 $Longitudinal slip stiffness Kfx/Fz at Fznom
PKX2 = -0.037391 $Variation of slip stiffness Kfx/Fz with load
PKX3 = 0.80348 $Exponent in slip stiffness Kfx/Fz with load
PHX1 = -0.00058264 $Horizontal shift Shx at Fznom
PHX2 = -0.0037992 $Variation of shift Shx with load
PVX1 = 0.045118 $Vertical shift Svx/Fz at Fznom
PVX2 = 0.058244 $Variation of shift Svx/Fz with load
PTX1 = 0.85683 $Relaxation length SigKap0/Fz at Fznom
PTX2 = 0.00011176 $Variation of SigKap0/Fz with load
PTX3 = -1.3131 $Variation of SigKap0/Fz with exponent of load
PTX4 = 0.1
You can find these parameters under the entry Longitudinal in the left column of the
PAC2002 Tire Fit Tool as well. Please note that both pure and combined slip
parameters are shown. The order of the parameters logged in the log file is the same as
in the Longitudinal entry of the PAC2002 Tire Fit Tool. This is also applicable for other
tire characteristics.
8. The next step will be to verify the calculated tire parameters versus measurement data and to
generate a tire property file which will be discussed in next Section.
Force/Moment characteristics are by default created using the embedded plotter and can be exported to
Adams/Postprocessor by selecting Plot -> Adams/PPT under Plot Parameters.
Select Settings -> Plot Units… to change the default plot units (SI).
1. Select Measurement Data = Yes under Plot Parameters, see Figure 10.
This means that measurement data (as added to the tire for the tire parameter identification
process) is plotted against PAC2002 model data. Longitudinal (kappa), lateral (alpha) slip data,
inclination angle (camber) and vertical tire load (Fz) extracted from the measurement data files
will be used as input to the PAC2002 tire model and the resulting forces/moment will be plotted
against measured forces/moment.
2. Select Slip Condition = Pure under Plot Parameters, see Figure 9.
Set Slip Condition to Pure to plot pure slip tire characteristics (that is, only braking/traction or
only cornering) or set Slip Condition to Combined to plot combined slip tire characteristics (that
is, cornering while braking/driving).
3. Select X-axis = Longitudinal Slip and select Y-axis = Fx to plot the longitudinal slip-force
characteristic versus measurement data for pure slip conditions.
4. Click on Tire Plot in the Main GUI (see red arrow in Figure 9) or select Run - > Tire Plot from
the menu bar to plot the PAC2002 tire model results versus measurement data. Plots are by default
created using the embedded plotter.
Click on Clear Tire Plot(s) or select Run -> Clear Tire Plot(s) to remove the plots from the
embedded plot window.
Figure 11 shows the resulting longitudinal slip-force characteristic versus measurement data for
pure slip conditions using Adams/Postprocessor.
42 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
Figure 11 Longitudinal slip-force characteristic versus measurement data for pure slip
conditions using Adams/Postprocessor
Note: Only the X-axis, Y-axis and Slip Condition need to be selected if Measurement Data is set
to Yes. The other options do not have any effect as input data is taken from the
measurement data files.
5. Table 1 provides more information about selections for Slip Condition, X-axis and Y-axis for
plotting of the tire model results versus measurement data for pure and combined slip conditions.
Table 1 Input selection for plotting of tire model results versus measurement data.
6. To generate a tire property file, select Save Tire property file (see red arrow in Figure 11) or
select File -> Save Tire Property File from the menu bar.
44 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
7. To save the database, that is, calculated tire parameters for a tire, loaded tires and references to
measurement data files, select Save Tire Database (see red arrow in Figure 13) or select File ->
Save Tire Database from the menu bar. Tire Database files can be loaded by clicking on Open
Tire Database which is located next to the Save Tire Database button.
Learning Adams/Tire 45
PAC2002 Tire Data and Fitting Tool (TDFT)
2. Set Measurement Data = No under the Plot Parameters, see Figure 15. This means that
measurement data (added in Tire Fit) is not used for plotting but only input data entered in the Plot
Parameters is used to evaluate the PAC2002 tire model.
3. Set Slip Condition = pure to plot pure slip tire characteristics (that is, braking/traction without
cornering and vice versa).
To plot tire characteristics for combined slip conditions, set Slip Condition = combined (that is,
cornering while braking/driving).
Learning Adams/Tire 47
PAC2002 Tire Data and Fitting Tool (TDFT)
4. Set X-axis = Longitudinal Slip and set Y-axis = Fx for plotting the longitudinal slip along the
X-axis and longitudinal force along the Y-axis.
5. Set Sweep = Longitudinal Slip. The Sweep variable is varied along each curve.
Input data for Longitudinal Slip can be entered in the Longitudinal Slip input field. Enter -1:0.01:1
to specify a range of values from -1 to 1 using a 0.01 step size.
Other possible input data formats:
0.0 - single values
1,2,3 - values separated by a comma
6. Set Independent = Vertical Load. The independent variable is constant for each curve. Input
data as shown in Figure 15 will produce 3 curves, one for each vertical load (2000, 4000 and 6000
N.). Input data for the Vertical Load can be entered in the Vertical Load input field, see Figure 13.
Enter: 2000, 4000, 6000.
7. Data for remaining fields must also be entered as this is input to the PAC2002 tire model.
Set Lateral Slip Angle = 0.0.
Set Inclination Angle = 0.0.
For a pure longitudinal slip-force characteristic, the lateral slip will not be used and vice versa.
However, it is recommend to use a single value (for instance 0) for the fields that are not used in
order not to evaluate unnecessary data points and not to increase calculation time.
8. Click on Tire Plot or select Run -> Tire Plot from the menu bar. You can either use the
embedded plotter or Adams/Postprocessor. Figure 15 shows the longitudinal slip-force tire
characteristic for pure slip conditions using Adams/Postprocessor.
Figure 15 Pure slip condition: longitudinal slip (kappa) versus longitudinal force (Fx).
48 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
Figure 16 slip condition: lateral slip (alpha) versus lateral force (Fy).
Measurement Data: No
Slip Condition: Pure
X-axis: Lateral Slip Angle
Y-axis: Mz
Learning Adams/Tire 49
PAC2002 Tire Data and Fitting Tool (TDFT)
Figure 17 Pure slip condition: lateral slip (alpha) versus self-aligning torque (Mz).
Measurement Data: No
Slip Condition: Combined
X-axis: Fx
Y-axis: Fy
Sweep: Longitudinal Slip
Independent: Lateral Slip Angle
50 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
Slip condition Vertical load Slip angle Inclination angle Long. Slip
[N] [deg] [deg] [-]
Pure lateral slip Fz1, Fz2, Fz3 -12 - +12 -5, 0, 5 deg Free rolling
Learning Adams/Tire 51
PAC2002 Tire Data and Fitting Tool (TDFT)
Slip condition Vertical load Slip angle Inclination angle Long. Slip
[N] [deg] [deg] [-]
Pure longitudinal Slip Fz1, Fz2, Fz3 0 0 - 100% - 0 - 100%
Combined slip Fz1, Fz2, Fz3 -1, 1, 3, 5, 8 -5, 0, 5 deg - 100% - 0 - 100%
More information about the tire test data required to calculate PAC2002 tire parameters can be found in
Knowledge Base article 1-KB12543.
52 Adams/Tire
PAC2002 Tire Data and Fitting Tool (TDFT)
Tire Models
2 Adams/Tire
Using the Fiala Handling Force Model
The following table summarizes the input that the Fiala tire model uses to calculate force.
Tire Models 3
Using the Fiala Handling Force Model
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity , and the loaded rolling radius Re:
V sx = V x – R e
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point:
V sx
= – -------
Vx
and
V sy
tan = --------
Vr
The rolling speed Vr is determined using the effective rolling radius Re:
Vr = Re
Tire Models 5
Using the Fiala Handling Force Model
Note that for realistic tire forces the slip angle is limited to 900 and the longitudinal slipSs (= ) in
between -1 (locked wheel) and 1.
When rolling, the first point having contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string will arise that depends on the slip angle size and the history
of the lateral deflection of previous points having contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid during braking slip:
1 dv 1 -----
v1
+ - = tan + a
: ----- --------
V x dt
6 Adams/Tire
Using the Fiala Handling Force Model
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
dv 1
: --------
+ V x v 1 = V sy
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
A similar approach yields the following for the deflection of the string in longitudinal direction:
du 1
-------- + V x u 1 = – V sx
dt
Now the practical slip quantities, ' and ' , are defined based on the tire deformation:
u1
' = ------ sgn V x
v1
' = atan ------
These practical slip quantities ' and ' are used instead of the usual and definitions for steady-
state tire behavior.
The longitudinal and lateral relaxation length are read from the tire property file, see Fiala Tire Property
File Format Example.
Instead of the linear vertical tire stiffness, also an arbitrary tire deflection - load curve can be defined in
the tire property file in the section [DEFLECTION_LOAD_CURVE] (see the Fiala Tire Property File
Format Example). If a section called [DEFLECTION_LOAD_CURVE] exists, the load deflection datap
oints with a cubic spline for inter- and extrapolation are used for the calculation of the vertical force of
the tire. Note that you must specify VERTICAL_STIFFNESS in the tire property file, but it does not play
any role.
Longitudinal Force
The longitudinal force depends on the vertical force (Fz), the current coefficient of friction (U), the
longitudinal slip ratio (Ss), and the slip angle (). The current coefficient of friction depends on the static
(Umax) and dynamic (Umin) friction coefficients and the comprehensive slip ratio ( S s ).
Umax specifies the tire/road coefficient of friction at zero slip and represents the static friction
coefficient. This is the y-intercept on the friction coefficient versus slip graph. Note that this value is an
unobtainable maximum friction value, because there is always slip within a footprint. This value is used
in conjunction with Umin to define a linear friction versus slip relation. Umax will normally be larger
than Umin.
Umin specifies the tire/road coefficient of friction for the full slip case and represents the sliding friction
coefficient. This is the friction coefficient at 100% slip, or pure sliding. This value is used in conjunction
with Umax to define a linear friction versus slip relationship.
2
Ss = S s + tan 2
The current value coefficient of friction (U):
U Fz
S critical = -------------------------
-
2 CSLIP
This is the value of longitudinal slip beyond which the tire is sliding.
Case 1. Elastic Deformation State: |Ss| < S_critical
Fx = -CSLIP × Ss
Case 2. Complete Sliding State: |Ss| > S_critical
Fx = -sign(Ss)(Fx1- Fx2)
where:
F x1 = U F z
U Fz 2
F x2 = ----------------------------------------
4 S s CSLIP
Lateral Force
Like the longitudinal force, the lateral force depends on the vertical force (Fz) and the current coefficient
of friction (U). And similar to the longitudinal force calculation, Fiala defines a critical lateral slip
critical :
3 U Fz
critical = arc tan ----------------------------
CALPHA
The lateral force peaks at a value equal to U × |Fz| when the slip angle () equals the critical slip angle
( critical ).
CALPHA tan
H = 1 – -------------------------------------------------
3 U Fz
Fy = -U|Fz|sign()
Tire Models 9
Using the Fiala Handling Force Model
Aligning Moment
CALPHA tan
H = 1 – -------------------------------------------------
3 U Fz
Mz= 0.0
Smoothing
Adams/Tire can smooth initial transients in the tire force over the first 0.1 seconds of simulation. The
longitudinal force, lateral force, and aligning torque are multiplied by a cubic step function of time. (See
STEP function in the Adams/Solver online help).
The USE_MODE parameter in the tire property file allows you to switch smoothing on or off:
• USE_MODE = 1, smoothing is off
• USE_MODE = 2, smoothing is on
You specify the tire carcass shape by entering points in fractions of the tire radius and width. Because
Adams/Tire assumes that the tire cross-section is symmetrical about the wheel plane, you only specify
points for half the width of the tire. The following apply:
• For width, a value of zero (0) lies in the wheel center plane.
• For width, a value of one (1) lies in the plane of the side wall.
• For radius, a value of one (1) lies on the tread.
For example, suppose your tire has a radius of 300 mm and a width of 185 mm and that the tread is joined
to the side wall with a fillet of 12.5 mm radius. The tread then begins to curve to meet the side wall at +/-
80 mm from the wheel center plane. If you define the shape table using six points with four points along
the fillet, the resulting table might look like the shape block that is at the end of the following property
format example.
VERTICAL_STIFFNESS = 310.0
VERTICAL_DAMPING = 3.1
ROLLING_RESISTANCE = 0.0
CSLIP = 1000.0
CALPHA = 800.0
UMIN = 0.9
UMAX = 1.0
RELAX_LENGTH_X = 0.05
RELAX_LENGTH_Y = 0.15
$---------------------------------------------carcass shape
[SHAPE]
{radius width}
1.0000 0.0000
1.0000 0.5000
1.0000 0.8649
0.9944 0.9235
0.9792 0.9819
0.9583 1.0000
$------------------------------------------------load_curve
$ Maximum of 100 points (optional)
[DEFLECTION_LOAD_CURVE]
{pen fz}
0 0.0
1 212.0
2 428.0
3 648.0
5 1100.0
10 2300.0
20 5000.0
30 8100.0
• ABS braking, when stopping distance is important (not for tuning ABS control strategies)
• Other common vehicle dynamics maneuvers on rather smooth roads (wavelength of road
obstacles must be longer than the tire radius)
For modeling roll-over of a vehicle, you must pay special attention to the overturning moment
characteristics of the tire (Mx) and the loaded radius modeling. The last item may not be sufficiently
accurate in this model.
The PAC2002 model has proven to be applicable for car, truck, and aircraft tires with camber
(inclination) angles to the road not exceeding 15 degrees.
New Features
The enhancements for PAC2002 in Adams/Tire 2005 r2 are:
• More advanced tire-transient modeling using a contact mass in the contact point with the road.
This results in more realistic dynamic tire model response at large slip, low speed, and standstill
(usemode > 20).
• Parking torque and turn-slip have been introduced: the torque around the vertical axis due to
turning at standstill or at low speed (no need for extra parameters).
• Extended loaded radius modeling (see Contact Point and Normal Load Calculation) are suitable
for driving under extreme conditions like roll-over events and racing applications.
• The option to use a nonlinear spline for the vertical tire load-deflection instead of a linear tire
stiffness. See Contact Point and Normal Load Calculation.
• Modeling of bottoming of the tire to the road by using another spline for defining the bottoming
forces. Learn more about wheel bottoming.
• Online scaling of the tire properties during a simulation; the scaling factors of the PAC2002 can
now be changed as a function of time, position, or any other variable in your model dataset. See
Online Scaling of Tire Properties.
longitudinal and lateral direction strongly depend on the slip between the tire patch elements and the
road.
The figure, Input and Output Variables of the Magic Formula Tire Model, presents the input and output
vectors of the PAC2002 tire model. The tire model subroutine is linked to the Adams/Solver through the
Standard Tire Interface (STI) [3]. The input through the STI consists of:
• Position and velocities of the wheel center
• Orientation of the wheel
• Tire model (MF) parameters
• Road parameters
The tire model routine calculates the vertical load and slip quantities based on the position and speed of
the wheel with respect to the road. The input for the Magic Formula consists of the wheel load (Fz), the
longitudinal and lateral slip , and inclination angle with the road. The output is the forces (Fx,
Fy) and moments (Mx, My, Mz) in the contact point between the tire and the road. For calculating these
forces, the MF equations use a set of MF parameters, which are derived from tire testing data.
The forces and moments out of the Magic Formula are transferred to the wheel center and returned to
Adams/Solver through STI.
• Units
• Definition of Tire Slip Quantities
Axis Systems
The PAC2002 model is linked to Adams/Solver using the TYDEX STI conventions, as described in the
TYDEX-Format [2] and the STI [3].
The STI interface between the PAC2002 model and Adams/Solver mainly passes information to the tire
model in the C-axis coordinate system. In the tire model itself, a conversion is made to the W-axis system
because all the modeling of the tire behavior as described in this help assumes to deal with the slip
quantities, orientation, forces, and moments in the contact point with the TYDEX W-axis system. Both
axis systems have the ISO orientation but have different origin as can be seen in the figure below.
TYDEX C- and W-Axis Systems Used in PAC2002, Source [2]
The C-axis system is fixed to the wheel carrier with the longitudinal xc-axis parallel to the road and in
the wheel plane (xc-zc-plane). The origin of the C-axis system is the wheel center.
The origin of the W-axis system is the road contact-point defined by the intersection of the wheel plane,
the plane through the wheel carrier, and the road tangent plane.
The forces and moments calculated by PAC2002 using the MF equations in this guide are in the W-axis
system. A transformation is made in the source code to return the forces and moments through the STI
to Adams/Solver.
The inclination angle is defined as the angle between the wheel plane and the normal to the road tangent
plane (xw-yw-plane).
5
Using the PAC2002Tire Model
Units
The units of information transferred through the STI between Adams/Solver and PAC2002 are according
to the SI unit system. Also, the equations for PAC2002 described in this guide have been developed for
use with SI units, although you can easily switch to another unit system in your tire property file. Because
of the non-dimensional parameters, only a few parameters have to be changed.
However, the parameters in the tire property file must always be valid for the TYDEX W-axis system
(ISO oriented). The basic SI units are listed in the table below (also see Definitions).
SI Units Used in PAC2002
Inclination angle
Force Longitudinal force Fx Newton
Lateral force Fy
Vertical load Fz
Moment Overturning moment Mx Newton.meter
Self-aligning moment Mz
Speed Longitudinal speed Vx Meters per second
Lateral speed Vy
V sx = V x – R e (1)
6 Adams/Tire
Using the PAC2002Tire Model
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y (2)
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point with:
V sx
= – ------- (3)
Vx
V sy
tan = -------- (4)
Vx
The rolling speed Vr is determined using the effective rolling radius Re:
Vr = Re (5)
Turn-slip is one of the two components that form the spin of the tire. Turn-slip is calculated using the
·
tire yaw velocity :
·
W t = ----- (6)
Vx
1 ·
1 = ----- – 1 – sin (7)
Vx
The total tire spin has contributions of turn-slip and camber. denotes the camber reduction factor for
the camber to become comparable with turn-slip.
7
Using the PAC2002Tire Model
Contact Point
In the vertical direction, the tire is modeled as a parallel linear spring and damper having one point of
contact (C) with the road. This is valid for road obstacles with a wavelength larger than the tire radius
(for example, for car tires 1m).
For calculating the kinematics of the tire relative to the road, the road is approximated by its tangent plane
at the road point right below the wheel center (see the figure below).
Contact Point C: Intersection between Road Tangent Plane, Spin Axis Plane, and Wheel
Plane
The contact point is determined by the line of intersection of the wheel center-plane with the road tangent
(ground) plane and the line of intersection of the wheel center-plane with the plane through the wheel
spin axis.
The normal load Fz of the tire is calculated with the tire deflection as follows:
8 Adams/Tire
Using the PAC2002Tire Model
Ro Fx 2 Fy 2 2
F z = 1 + q V2 ------ – q Fcxl -------- – q Fcyl -------- + q Fcl (8)
Vo F z0 F z0
2 ·
q Fzl ------ + q Fz2 ------ F z0 + K z
R0 R0
Using this formula, the vertical tire stiffness increases due to increasing rotational speed and decreases
by longitudinal and lateral tire forces. If qFz1 and qFz2 are zero, qFz1 will be defined as CzR0/Fz0.
When you do not provide the coefficients qV2, qFcx, qFcy, qFz1, qFz2 and qFc in the tire property file, the
normal load calculation is compatible with previous versions of PAC2002, because, in that case, the
normal load is calculated using the linear vertical tire stiffness Cz and tire damping Kz according to:
·
F z = C z Cz + K z
Instead of the linear vertical tire stiffness Cz (= qFz1Fz0/R0), you can define an arbitrary tire deflection -
load curve in the tire property file in the section [DEFLECTION_LOAD_CURVE] (see the Example of
PAC2002 Tire Property File). If a section called [DEFLECTION_LOAD_CURVE] exists, the load
deflection data points with a cubic spline for inter- and extrapolation are used for the calculation of the
vertical force of the tire. Note that you must specify Cz in the tire property file, but it does not play any
role.
R0 2
= R 0 – R 1 + q V1 R 0 ------ (9)
V0
The effective rolling radius Re (at free rolling of the tire), which is used to calculate the rotational speed
of the tire, is defined by:
Vx
R e = ----- (10)
For radial tires, the effective rolling radius is rather independent of load in its load range of operation
because of the high stiffness of the tire belt circumference. Only at low loads does the effective tire radius
decrease with increasing vertical load due to the tire tread thickness. See the figure below.
9
Using the PAC2002Tire Model
R 0 2
R e = R 0 + q V1 R 0 ----------- – Fz0 D Reff arc tan B Reff + F Reff
d d
(11)
V0
F z0
Fz0 = --------------- (12)
C z Cz
d
and is called the dimensionless radial tire deflection, defined by:
d
= --------- (13)
Fz0
Example of Loaded and Effective Tire Rolling Radius as Function of Vertical Load
Wheel Bottoming
You can optionally supply a wheel-bottoming deflection, that is, a load curve in the tire property file in
the [BOTTOMING_CURVE] block. If the deflection of the wheel is so large that the rim will be hit
(defined by the BOTTOMING_RADIUS parameter in the [DIMENSION] section of the tire property
file), the tire vertical load will be increased according to the load curve defined in this section.
Note that the rim-to-road contact algorithm is a simple penetration method (such as the 2D contact) based
on the tire-to-road contact calculation, which is strictly valid for only rather smooth road surfaces (the
length of obstacles should have a wavelength longer than the tire circumference). The rim-to-road contact
algorithm is not based on the 3D-volume penetration method, but can be used in combination with the
3D Contact, which takes into account the volume penetration of the tire itself. If you omit the
[BOTTOMING_CURVE] block from a tire property file, no force due to rim road contact is added to the
tire vertical force.
You can choose a BOTTOMING_RADIUS larger than the rim radius to account for the tire's material
remaining in between the rim and the road, while you can adjust the bottoming load-deflection curve for
the change in stiffness.
12 Adams/Tire
Using the PAC2002Tire Model
If (Pentire - (Rtire - Rbottom) - ½·width ·| tan() |) < 0, the left or right side of the rim has contact with the
road. Then, the rim deflection Penrim can be calculated using:
If the full rim has contact with the road, the rim deflection is:
Penrim = Pentire - (Rtire - Rbottom)
Using the load - deflection curve defined in the [BOTTOMING_CURVE] section of the tire property file,
the additional vertical force due to the bottoming is calculated, while Srim multiplied by the sign of the
inclination is used to calculate the contribution of the bottoming force to the overturning moment.
Further, the increase of the total wheel load Fz due to the bottoming (Fzrim) will not be taken into account
in the calculation for Fx, Fy, My, and Mz. Fzrim will only contribute to the overturning moment Mx using
the Fzrim·Srim.
Note: Rtire is equal to the unloaded tire radius R0; Pentire is similar to effpen (= ).
For pure slip conditions, the lateral force Fy as a function of the lateral slip , respectively, and the
longitudinal force Fx as a function of longitudinal slip , have a similar shape (see the figure,
Characteristic Curves for Fx and Fy Under Pure Slip Conditions). Because of the sine - arctangent
combination, the basic Magic Formula equation is capable of describing this shape:
where Y(x) is either Fx with x the longitudinal slip , or Fy and x the lateral slip .
14 Adams/Tire
Using the PAC2002Tire Model
The self-aligning moment Mz is calculated as a product of the lateral force Fy and the pneumatic trail t
added with the residual moment Mzr. In fact, the aligning moment is due to the offset of lateral force Fy,
called pneumatic trail t, from the contact point. Because the pneumatic trail t as a function of the lateral
slip has a cosine shape, a cosine version the Magic Formula is used:
In combined slip conditions, the lateral force Fy will decrease due to longitudinal slip or the opposite, the
longitudinal force Fx will decrease due to lateral slip. The forces and moments in combined slip
conditions are based on the pure slip characteristics multiplied by the so-called weighing functions.
Again, these weighting functions have a cosine-shaped MF equation.
16 Adams/Tire
Using the PAC2002Tire Model
The Magic Formula itself only describes steady-state tire behavior. For transient tire behavior (up to 8
Hz), the MF output is used in a stretched string model that considers tire belt deflections instead of slip
velocities to cope with standstill situations (zero speed).
Input Variables
The input variables to the Magic Formula are:
Output Variables
As a measure for the vertical load, the normalized vertical load increment dfz is used:
F z – F zo
df z = -------------------
(16)
F zo
17
Using the PAC2002Tire Model
with the possibly adapted nominal load (using the user-scaling factor, F Z0 ):
F zo = F zo Fz0
Parameter: Definition:
a= p Force at pure slip
q Moment at pure slip
r Force at combined slip
s Moment at combined slip
i= B Stiffness factor
C Shape factor
D Peak value
E Curvature factor
K Slip stiffness = BCD
H Horizontal shift
V Vertical shift
s Moment at combined slip
t Transient tire behavior
j= x Along the longitudinal axis
y Along the lateral axis
z About the vertical axis
k= 1, 2, ...
Note that the scaling factors change during the simulation according to any user-introduced function. See
the next section, Online Scaling of Tire Properties.
F x = F x0 F z (17)
x = + S Hx (19)
x = x (20)
C x = p Cx1 Cx (21)
Dx = x Fz 1 (22)
2
x = p Dx1 + p Dx2 df z 1 – p Dx3 x (23)
2
E x = p Ex1 + p Ex2 df z + p Ex3 df z 1 – p Ex4 sgn x Ex with E x 1 (24)
F x0
Kx = Bx Cx Dx = at x = 0
x
Bx = Kx Cx Dx (26)
y = + S Hy (31)
y = y (32)
with coefficients:
C y = p Cy1 Cy (33)
Dy = y Fz 2 (34)
2
y = p Dy1 + p Dy2 df z 1 – p Dy3 y y (35)
22 Adams/Tire
Using the PAC2002Tire Model
Fz
K y0 = P Ky1 F z0 sin 2arc tan --------------------------- Fz0 Ky (37)
P Ky2 F 0 Fz0
K y = K y0 1 – p Ky3 y 3 (38)
By = Ky Cy Dy (39)
M z0 = – t F y0 + M zr
with the pneumatic trail t:
t = + S Ht (45)
r = + S Hf (47)
S Hf = S Hy + S Vy K y (48)
z = z (49)
with coefficients:
2
B t = q Bz1 + q Bz2 df z + q Bz3 df z 1 + q Bz4 z + q Bz5 z Ky y (50)
C t = q Cz1 (51)
2 R0
D t = F z q Dz1 + q Dz2 df z 1 + q Dz3 z + q Dz4 z -------- t 5 (52)
F z0
24 Adams/Tire
Using the PAC2002Tire Model
2
E t = q Ez1 + q Ez2 df z + q Ez3 df z (53)
Ky
B r = q Bz9 -------- + q Bz10 B y C y 6 (55)
y
Cr = 7
D r = F z q Dz6 + q Dz7 df z r + q Dz8 + q Dz9 df z z R o + 8 – 1 (56)
M z
– ---------
Kz = –t Ky - at = 0 (57)
Aligning Moment Coefficients at Pure Slip
For situations where turn-slip may be neglected and camber remains small, the reduction factors i that
appear in the equations for steady-state pure slip, are to be set to 1:
i = 1 i = 0. 1.8
For larger values of spin, the reduction factors are given below.
The weighting function 1 is used to let the longitudinal force diminish with increasing spin, according
to:
2 2
3 = cos arc tan p Ky1 R 0
The horizontal shift of the lateral force due to spin is given by:
S Hy = D Hy sin C Hy arc tan B Hy R o – E Hy B Hy R 0 – arc tan B Hy R 0
The factors are defined by:
C Hy
= p Hy1
E Hy = P Hy4
K yR0
B Hy = ----------------------
C y D y K y0
The spin force stiffness KyR0 is related to the camber stiffness Kyy0:
K y0
K yR0 = -------------
1 –
= p 1 1 + p 2 df z
The reduction factors 0 and 4 for the vertical shift of the lateral force are given by:
0 = 0
4 = 1 + S Hy – S Vy K y
The reduction factor for the residual moment reads:
8 = 1 + D r
D r = D Dr sin e C Dr arc tan B Dr R 0 – E Dr B Dr R 0 – arc tan B Dr R 0
27
Using the PAC2002Tire Model
M z
D Dr = -----------------------------
sin --- C Dr
2
The pneumatic trail reduction factor due to turn slip is given by:
M z = q Cr1 y R 0 F z F z F z0
The shape factors are given by:
C Dr = q Dr1
E Dr = q Dr2
K zr0
B Dr = --------------------------------------------
C Dr D Dr 1 – y
in which:
2
M z90 = M z --- arc tan q Cr2 R 0 G yx
The spin moment at 90º slip angle is multiplied by the weighing function G y to account for the action
of the longitudinal slip (see steady-state combined slip equations).
2
7 = --- arc cos M z90 D Dr
Turn-Slip and Parking Parameters
Name used in
Name: tire property file: Explanation:
p 1 PECP1 Camber spin reduction factor parameter in camber stiffness
p 2 PECP2 Camber spin reduction factor varying with load parameter in
camber stiffness
pDx 1 PDXP1 Peak Fx reduction due to spin parameter
pDx 2 PDXP2 Peak Fx reduction due to spin with varying load parameter
pDx 3 PDXP3 Peak Fx reduction due to spin with kappa parameter
pDy 1 PDYP1 Peak Fy reduction due to spin parameter
pDy 2 PDYP2 Peak Fy reduction due to spin with varying load parameter
pDy 3 PDYP3 Peak Fy reduction due to spin with alpha parameter
pDy 4 PDYP4 Peak Fy reduction due to square root of spin parameter
pKy 1 PKYP1 Cornering stiffness reduction due to spin
pHy 1 PHYP1 Fy-alpha curve lateral shift limitation
pHy 2 PHYP2 Fy-alpha curve maximum lateral shift parameter
pHy 3 PHYP3 Fy-alpha curve maximum lateral shift varying with load
parameter
pHy 4 PHYP4 Fy-alpha curve maximum lateral shift parameter
qDt 1 QDTP1 Pneumatic trail reduction factor due to turn slip parameter
qBr 1 QBRP1 Residual (spin) torque reduction factor parameter due to side
slip
qCr 1 QCRP1 Turning moment at constant turning and zero forward speed
parameter
qCr 2 QCRP2 Turn slip moment (at alpha=90deg) parameter for increase
with spin
qDr 1 QDRP1 Turn slip moment peak magnitude parameter
qDr 2 QDRP2 Turn slip moment peak position parameter
The tire model parameters for turn-slip and parking are estimated automatically. In addition, you can
specify each parameter individually in the tire property file (see example).
See KB-article ## for further details about parking by means of an example.
29
Using the PAC2002Tire Model
with G x the weighting function of the longitudinal force for pure slip.
We write:
s = + S Hx (60)
with coefficients:
C x = r Cx1 (62)
F xo
D x = ---------------------------------------------------------------------------------------------------------------------------------------------------------------- (63)
cos C x arc tan B x S Hx – E x B x S Hx – arc tan B x S Hx
with Gyk the weighting function for the lateral force at pure slip and SVyk the ‘ -induced’ side force;
therefore, the lateral force can be written as:
s = + S Hy (69)
C y = r Cy1 (71)
F yo
D y = ------------------------------------------------------------------------------------------------------------------------------------------------------------- (72)
cos C y arc tan B y S Hy – E y B y S Hy – arc tan B y S Hy
with:
t = t t eq (79)
F y = 0 = F y – S Vy (81)
t = t t eq (83)
Kx 2 2
t eq = arc tan tan t + ------ sgn t
2
(84)
K y
Kx 2 2
r eq = arc tan tan r + ------ sgn r
2
(85)
K y
Fy
M x = R o F z q Sx1 VMx – q Sx2 + q Sx3 -------- Mx (86)
F z0
4
M y = R o F z q Sy1 + q Sy3 F x F z0 + q Sy3 V x V ref + q Sy4 V x V ref (87)
33
Using the PAC2002Tire Model
If qsy1 and qsy2 are both zero and FITTYP is equal to 5 (MF-Tyre 5.0), then the rolling resistance is
calculated according to an old equation:
M y = R 0 S Vx + K x S Hx (88)
S Vx
c = + S Hx + --------
Kx
S Vy
c = + S Hy + --------
Ky
= sin c
c
= acos -------------------------
2 + 2
c
F x 0 – S Vx F y 0 – S Vy
x act = ------------------------ y act = ------------------------
Fz Fz
Dx Dy
x max = ------ y max = ------
Fz Fz
34 Adams/Tire
Using the PAC2002Tire Model
1
x = --------------------------------------------------------
1 2 tan 2
------------- + ---------------
x act y max
tan
y = --------------------------------------------------------
1 2 tan 2
--------------- + -------------
x max y act
x y
F x = ------------- F x 0 F y = ------------- F y 0
x act y act
For aligning moment Mx, rolling resistance My and aligning moment Mz the formulae (76) until and
including (85) are used with S Vyk = 0 .
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid:
1 dv 1 -----
v1
----- + - = tan + a (89)
Vx d t
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
dv 1
+ V x v 1 = V sy (90)
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
A similar approach yields the following for the deflection of the string in longitudinal direction:
du 1
+ V x u 1 = V sx (91)
dt
Both the longitudinal and lateral relaxation length are defined as of the vertical load:
36 Adams/Tire
Using the PAC2002Tire Model
Fz
= p Ty1 sin 2arc tan --------------------------------- 1 – p Ky3 y R 0 Fz0 (93)
p Ty2 F z0 Fz0
Now the practical slip quantities, and , are defined based on the tire deformation:
u1
' = ----- sin V x (94)
x
v1
' = atan ------ (95)
Using these practical slip quantities, and , the Magic Formula equations can be used to calculate the
tire-road interaction forces and moments:
M z = M z ' ' F z (99)
The additional equations for the longitudinal u, lateral v, and yaw deflections are:
u· = V cx – V sx
v· = V cy – V sy
· ·
= c –
·
in which Vcx, Vcy and c are the sliding velocity of the contact body in longitudinal, lateral, and yaw
·
directions, respectively. Vsx, Vsy, and are the corresponding velocities of the lower part of the wheel.
The transient slip equations for side slip, turn-slip, and camber are:
c d ' + V x ' = V cy – V x + V x st
dt
d' t
c + V x ' t = V x '
dt
38 Adams/Tire
Using the PAC2002Tire Model
d' c ·
c + V x ' c =
dt
d' F2 ·
F2 + V x ' cF2 =
dt
d' 1 ·
1 + V x ' 1 =
dt
d' 2 ·
2 + V x ' 2 =
dt
where the calculated deflection angle has been used:
Mz
st = ------
c
The tire total spin velocity is:
·
= c – 1 – sin
With the transient slip equations, the composite transient turn-slip quantities are calculated:
The tire forces are calculated with ' F and the tire moments with ' M .
The relaxation lengths are reduced with slip:
c = a 1 –
t0
2 = ---- c
a
F2 = b F2 c
1 = b 1 c
2 = b 2 c
39
Using the PAC2002Tire Model
z
a = p A1 R 0 ------ + p A2 -----z-
R0 R 0
K y0
= ---------------
3 y F x
and the equivalent slip:
2
1 K x0 2 2
= ------------- ' + a 12 ' 1 – ' 2 + -------- ' + --- b ' c
2
1 + ' K y0 3
Coefficients and Transient Response
The remaining contact mass model parameters are estimated automatically based on longitudinal and
lateral stiffness specified in the tire property file.
40 Adams/Tire
Using the PAC2002Tire Model
dv
M z gyr = c gyr m belt V rl cos arc tan B r r eq (100)
dt
with the parameter (in addition to the basic tire parameter mbelt):
and:
Name used in
Name: tire property file: Explanation:
pTx1 PTX1 Longitudinal relaxation length at Fznom
pTx2 PTX2 Variation of longitudinal relaxation length with load
pTx3 PTX3 Variation of longitudinal relaxation length with exponent of
load
pTy1 PTY1 Peak value of relaxation length for lateral direction
pTy2 PTY2 Shape factor for lateral relaxation length
qTz1 QTZ1 Gyroscopic moment constant
Mbelt MBELT Belt mass of the wheel
The latest versions of tire property files contain a keyword TYRESIDE in the [MODEL] section that
indicates for which side of the vehicle the tire parameters in that file are valid (TYRESIDE = 'LEFT' or
TYRESIDE = 'RIGHT'). .
If this keyword is available, Adams/Car corrects for the conicity and plysteer and asymmetry when using
a tire property file on the opposite side of the vehicle. In fact, the tire characteristics are mirrored with
respect to slip angle zero. In Adams/View, this option can only be used when the tire is generated by the
graphical user interface: select Build -> Forces -> Special Force: Tire.
Next to the LEFT and RIGHT side option of TYRESIDE, you can also set SYMMETRIC: then the tire
characteristics are modified during initialization to show symmetric performance for left and right side
corners and zero conicity and plysteer (no offsets).Also, when you set the tire property file to
SYMMETRIC, the tire characteristics are changed to symmetric behavior.
42 Adams/Tire
Using the PAC2002Tire Model
PAC2002 output
(forces and
USE_MODE: State: Slip conditions: moments):
0 Steady state Acts as a vertical spring & 0, 0, Fz, 0, 0, 0
damper
1 Steady state Pure longitudinal slip Fx, 0, Fz, 0, My, 0
2 Steady state Pure lateral (cornering) slip 0, Fy, Fz, Mx, 0, Mz
3 Steady state Longitudinal and lateral (not Fx, Fy, Fz, Mx, My, Mz
combined)
4 Steady state Combined slip Fx, Fy, Fz, Mx, My, Mz
11 Transient Pure longitudinal slip Fx, 0, Fz, 0, My, 0
12 Transient Pure lateral (cornering) slip 0, Fy, Fz, Mx, 0, Mz
13 Transient Longitudinal and lateral (not Fx, Fy, Fz, Mx, My, Mz
combined)
14 Transient Combined slip Fx, Fy, Fz, Mx, My, Mz
15 Transient Combined slip and turn-slip Fx, Fy, Fz, Mx, My, Mz
21 Advanced transient Pure longitudinal slip Fx, 0, Fz, My, 0
22 Advanced transient Pure lateral (cornering slip) 0, Fy, Fz, Mx, 0, Mz
23 Advanced transient Longitudinal and lateral (not Fx, Fy, Fz, Mx, My, Mz
combined)
24 Advanced transient Combined slip Fx, Fy, Fz, Mx, My, Mz
25 Advanced transient Combined slip and turn- Fx, Fy, Fz, Mx, My, Mz
slip/parking
Note: Do not change Fz0 (FNOMIN) and R0 (UNLOADED_RADIUS) in your tire property
file. It will change the complete tire characteristics because these two parameters are used
to make all parameters without dimension.
44 Adams/Tire
Using the PAC2002Tire Model
Rolling Resistance
For a realistic rolling resistance, the parameter qsy1 must be positive. For car tires, it can be in the order
of 0.006 - 0.01 (0.6% - 1.0%); for heavy commercial truck tires, it can be around 0.006 (0.6%).
Tire property files with the keyword FITTYP=5 determine the rolling resistance in a different way (see
equation (88)). To avoid the ‘old’ rolling resistance calculation, remove the keyword FITTYP and add a
section like the following:
$---------------------------------------------------rolling
resistance[ROLLING_COEFFICIENTS]
QSY1 = 0.01
QSY2 = 0
QSY3 = 0
QSY4 = 0
Effect of Positive Camber on the Lateral Force in TYDEX W-axis (ISO) System
45
Using the PAC2002Tire Model
If one of the input parameters exceeds a minimum or maximum validity value, the calculation in the tire
model is performed with the minimum or maximum value of this range to avoid non-realistic tire
behavior. In that case, a message appears warning you that one of the inputs exceeds a validity value.
46 Adams/Tire
Using the PAC2002Tire Model
Definitions
• General
• Tire Kinematics
• Slip Quantities
• Force and Moments
General
General Definitions
Term: Definition:
Road tangent plane Plane with the normal unit vector (tangent to the road) in the tire-road contact
point C.
C-axis system Coordinate system mounted on the wheel carrier at the wheel center according to
TYDEX, ISO orientation.
Wheel plane The plane in the wheel center that is formed by the wheel when considered a rigid
disc with zero width.
47
Using the PAC2002Tire Model
Term: Definition:
Contact point C Contact point between tire and road, defined as the intersection of the wheel
plane and the projection of the wheel axis onto the road plane.
W-axis system Coordinate system at the tire contact point C, according to TYDEX, ISO
orientation.
Tire Kinematics
Tire Kinematics Definitions
Slip Quantities
Slip Quantities Definitions
References
1. H.B. Pacejka, Tyre and Vehicle Dynamics, 2002, Butterworth-Heinemann, ISBN 0 7506 5141 5.
2. H.-J. Unrau, J. Zamow, TYDEX-Format, Description and Reference Manual, Release 1.1,
Initiated by the International Tire Working Group, July 1995.
3. A. Riedel, Standard Tire Interface, Release 1.2, Initiated by the Tire Workgroup, June 1995.
4. J.J.M. van Oosten, H.-J. Unrau, G. Riedel, E. Bakker, TYDEX Workshop: Standardisation of
Data Exchange in Tyre Testing and Tyre Modelling, Proceedings of the 2nd International
Colloquium on Tyre Models for Vehicle Dynamics Analysis, Vehicle System Dynamics, Volume
27, Swets & Zeitlinger, Amsterdam/Lisse, 1996.
! 1: Fx,My only
! 2: Fy,Mx,Mz only
! 3: Fx,Fy,Mx,My,Mz uncombined force/moment calculation
! 4: Fx,Fy,Mx,My,Mz combined force/moment calculation
! +10: including relaxation behaviour
! *-1: mirroring of tyre characteristics
!
! example: USE_MODE = -12 implies:
! -calculation of Fy,Mx,Mz only
! -including relaxation effects
! -mirrored tyre characteristics
!
$--------------------------------------------------------------units
[UNITS]
LENGTH ='meter'
FORCE ='newton'
ANGLE ='radians'
MASS ='kg'
TIME ='second'
$--------------------------------------------------------------model
[MODEL]
PROPERTY_FILE_FORMAT ='PAC2002'
USE_MODE = 14 $Tyre use switch (IUSED)
VXLOW = 1
LONGVL = 16.6 $Measurement speed
TYRESIDE = 'LEFT' $Mounted side of tyre at
vehicle/test bench
$---------------------------------------------------------dimensions
[DIMENSION]
UNLOADED_RADIUS = 0.344 $Free tyre radius
WIDTH = 0.235 $Nominal section width of the
tyre
ASPECT_RATIO = 0.6 $Nominal aspect ratio
RIM_RADIUS = 0.19 $Nominal rim radius
RIM_WIDTH = 0.16 $Rim width
$----------------------------------------------------------parameter
[VERTICAL]
VERTICAL_STIFFNESS = 2.1e+005 $Tyre vertical stiffness
VERTICAL_DAMPING = 50 $Tyre vertical damping
BREFF = 8.4 $Low load stiffness e.r.r.
DREFF = 0.27 $Peak value of e.r.r.
FREFF = 0.07 $High load stiffness e.r.r.
FNOMIN = 4850 $Nominal wheel load
$----------------------------------------------------long_slip_range
[LONG_SLIP_RANGE]
KPUMIN = -1.5 $Minimum valid wheel slip
KPUMAX = 1.5 $Maximum valid wheel slip
$---------------------------------------------------slip_angle_range
[SLIP_ANGLE_RANGE]
ALPMIN = -1.5708 $Minimum valid slip angle
ALPMAX = 1.5708 $Maximum valid slip angle
$---------------------------------------------inclination_slip_range
[INCLINATION_ANGLE_RANGE]
CAMMIN = -0.26181 $Minimum valid camber angle
CAMMAX = 0.26181 $Maximum valid camber angle
$------------------------------------------------vertical_force_range
[VERTICAL_FORCE_RANGE]
FZMIN = 225 $Minimum allowed wheel load
FZMAX = 10125 $Maximum allowed wheel load
$-------------------------------------------------------------scaling
50 Adams/Tire
Using the PAC2002Tire Model
[SCALING_COEFFICIENTS]
LFZO = 1 $Scale factor of nominal (rated) load
LCX = 1 $Scale factor of Fx shape factor
LMUX = 1 $Scale factor of Fx peak friction coefficient
LEX = 1 $Scale factor of Fx curvature factor
LKX = 1 $Scale factor of Fx slip stiffness
LHX = 1 $Scale factor of Fx horizontal shift
LVX = 1 $Scale factor of Fx vertical shift
LGAX = 1 $Scale factor of camber for Fx
LCY = 1 $Scale factor of Fy shape factor
LMUY = 1 $Scale factor of Fy peak friction coefficient
LEY = 1 $Scale factor of Fy curvature factor
LKY = 1 $Scale factor of Fy cornering stiffness
LHY = 1 $Scale factor of Fy horizontal shift
LVY = 1 $Scale factor of Fy vertical shift
LGAY = 1 $Scale factor of camber for Fy
LTR = 1 $Scale factor of Peak of pneumatic trail
LRES = 1 $Scale factor for offset of residual torque
LGAZ = 1 $Scale factor of camber for Mz
LXAL = 1 $Scale factor of alpha influence on Fx
LYKA = 1 $Scale factor of alpha influence on Fx
LVYKA = 1 $Scale factor of kappa induced Fy
LS = 1 $Scale factor of Moment arm of Fx
LSGKP = 1 $Scale factor of Relaxation length of Fx
LSGAL = 1 $Scale factor of Relaxation length of Fy
LGYR = 1 $Scale factor of gyroscopic torque
LMX = 1 $Scale factor of overturning couple
LVMX = 1 $Scale factor of Mx vertical shift
LMY = 1 $Scale factor of rolling resistance torque
$-------------------------------------------------------longitudinal
[LONGITUDINAL_COEFFICIENTS]
PCX1 = 1.6411 $Shape factor Cfx for longitudinal force
PDX1 = 1.1739 $Longitudinal friction Mux at Fznom
PDX2 = -0.16395 $Variation of friction Mux with load
PDX3 = 0 $Variation of friction Mux with camber
PEX1 = 0.46403 $Longitudinal curvature Efx at Fznom
PEX2 = 0.25022 $Variation of curvature Efx with load
PEX3 = 0.067842 $Variation of curvature Efx with load squared
PEX4 = -3.7604e-005 $Factor in curvature Efx while driving
PKX1 = 22.303 $Longitudinal slip stiffness Kfx/Fz at Fznom
PKX2 = 0.48896 $Variation of slip stiffness Kfx/Fz with load
PKX3 = 0.21253 $Exponent in slip stiffness Kfx/Fz with load
PHX1 = 0.0012297 $Horizontal shift Shx at Fznom
PHX2 = 0.0004318 $Variation of shift Shx with load
PVX1 = -8.8098e-006 $Vertical shift Svx/Fz at Fznom
PVX2 = 1.862e-005 $Variation of shift Svx/Fz with load
RBX1 = 13.276 $Slope factor for combined slip Fx reduction
RBX2 = -13.778 $Variation of slope Fx reduction with kappa
RCX1 = 1.2568 $Shape factor for combined slip Fx reduction
REX1 = 0.65225 $Curvature factor of combined Fx
REX2 = -0.24948 $Curvature factor of combined Fx with load
RHX1 = 0.0050722 $Shift factor for combined slip Fx reduction
PTX1 = 2.3657 $Relaxation length SigKap0/Fz at Fznom
PTX2 = 1.4112 $Variation of SigKap0/Fz with load
PTX3 = 0.56626 $Variation of SigKap0/Fz with exponent of load
$--------------------------------------------------------overturning
[OVERTURNING_COEFFICIENTS]
QSX1 = 0 $Lateral force induced overturning moment
QSX2 = 0 $Camber induced overturning couple
QSX3 = 0 $Fy induced overturning couple
51
Using the PAC2002Tire Model
$------------------------------------------------------------lateral
[LATERAL_COEFFICIENTS]
PCY1 = 1.3507 $Shape factor Cfy for lateral forces
PDY1 = 1.0489 $Lateral friction Muy
PDY2 = -0.18033 $Variation of friction Muy with load
PDY3 = -2.8821 $Variation of friction Muy with squared camber
PEY1 = -0.0074722 $Lateral curvature Efy at Fznom
PEY2 = -0.0063208 $Variation of curvature Efy with load
PEY3 = -9.9935 $Zero order camber dependency of curvature Efy
PEY4 = -760.14 $Variation of curvature Efy with camber
PKY1 = -21.92 $Maximum value of stiffness Kfy/Fznom
PKY2 = 2.0012 $Load at which Kfy reaches maximum value
PKY3 = -0.024778 $Variation of Kfy/Fznom with camber
PHY1 = 0.0026747 $Horizontal shift Shy at Fznom
PHY2 = 8.9094e-005 $Variation of shift Shy with load
PHY3 = 0.031415 $Variation of shift Shy with camber
PVY1 = 0.037318 $Vertical shift in Svy/Fz at Fznom
PVY2 = -0.010049 $Variation of shift Svy/Fz with load
PVY3 = -0.32931 $Variation of shift Svy/Fz with camber
PVY4 = -0.69553 $Variation of shift Svy/Fz with camber and load
RBY1 = 7.1433 $Slope factor for combined Fy reduction
RBY2 = 9.1916 $Variation of slope Fy reduction with alpha
RBY3 = -0.027856 $Shift term for alpha in slope Fy reduction
RCY1 = 1.0719 $Shape factor for combined Fy reduction
REY1 = -0.27572 $Curvature factor of combined Fy
REY2 = 0.32802 $Curvature factor of combined Fy with load
RHY1 = 5.7448e-006 $Shift factor for combined Fy reduction
RHY2 = -3.1368e-005 $Shift factor for combined Fy reduction with load
RVY1 = -0.027825 $Kappa induced side force Svyk/Muy*Fz at Fznom
RVY2 = 0.053604 $Variation of Svyk/Muy*Fz with load
RVY3 = -0.27568 $Variation of Svyk/Muy*Fz with camber
RVY4 = 12.12 $Variation of Svyk/Muy*Fz with alpha
RVY5 = 1.9 $Variation of Svyk/Muy*Fz with kappa
RVY6 = -10.704 $Variation of Svyk/Muy*Fz with atan(kappa)
PTY1 = 2.1439 $Peak value of relaxation length SigAlp0/R0
PTY2 = 1.9829 $Value of Fz/Fznom where SigAlp0 is extreme
$-------------------------------------------------rolling resistance
[ROLLING_COEFFICIENTS]
QSY1 = 0.01 $Rolling resistance torque coefficient
QSY2 = 0 $Rolling resistance torque depending on Fx
QSY3 = 0 $Rolling resistance torque depending on speed
QSY4 = 0 $Rolling resistance torque depending on speed ^4
$-----------------------------------------------------------aligning
[ALIGNING_COEFFICIENTS]
QBZ1 = 10.904 $Trail slope factor for trail Bpt at Fznom
QBZ2 = -1.8412 $Variation of slope Bpt with load
QBZ3 = -0.52041 $Variation of slope Bpt with load squared
QBZ4 = 0.039211 $Variation of slope Bpt with camber
QBZ5 = 0.41511 $Variation of slope Bpt with absolute camber
QBZ9 = 8.9846 $Slope factor Br of residual torque Mzr
QBZ10 = 0 $Slope factor Br of residual torque Mzr
QCZ1 = 1.2136 $Shape factor Cpt for pneumatic trail
QDZ1 = 0.093509 $Peak trail Dpt" = Dpt*(Fz/Fznom*R0)
QDZ2 = -0.0092183 $Variation of peak Dpt" with load
QDZ3 = -0.057061 $Variation of peak Dpt" with camber
QDZ4 = 0.73954 $Variation of peak Dpt" with camber squared
QDZ6 = -0.0067783 $Peak residual torque Dmr" = Dmr/(Fz*R0)
QDZ7 = 0.0052254 $Variation of peak factor Dmr" with load
QDZ8 = -0.18175 $Variation of peak factor Dmr" with camber
QDZ9 = 0.029952 $Variation of peak factor Dmr" with camber and load
52 Adams/Tire
Using the PAC2002Tire Model
Contact Methods
The PAC2002 model supports the following roads:
• 2D Roads, see Using the 2D Road Model
• 3D Spline Roads, see Adams/3D Spline Road Model
Note that the PAC2002 model has only one point of contact with the road; therefore, the
wavelength of road obstacles must be longer than the tire radius for realistic output of the model.
In addition, the contact force computed by this tire model is normal to the road plane. Therefore,
the contact point does not generate a longitudinal force when rolling over a short obstacle, such
as a cleat or pothole.
• 3D Shell Roads, see Adams/Tire 3D Shell Road Model
For ride and comfort analyses, we recommend more sophisticated tire models, such as Ftire.
54 Adams/Tire
Using the PAC2002Tire Model
Using the PAC-TIME Tire Model
The PAC-TIME Magic-Formula tire model has been developed by MSC.Software according to a
publication, A New Tyre Model for TIME Measurement Data, by J.J.M. van Oosten e.a. [5]. PAC-TIME
has improved equations for side force and aligning moment under pure slip conditions. For longitudinal
pure slip and combined slip, the tire model is similar to PAC-TIME.
Learn about:
• When to Use PAC-TIME
• Modeling of Tire-Road Interaction Forces
• Axis Systems and Slip Definitions
• Contact Point and Normal Load Calculation
• Basics of Magic Formula
• Steady-State: Magic Formula
• Transient Behavior
• Gyroscopic Couple
• Left and Right Side Tires
• USE_MODES OF PAC-TIME: from Simple to Complex
• Quality Checks for Tire Model Parameters
• Standard Tire Interface (STI)
• Definitions
• References
• Example of PAC-TIME Tire Property File
• Contact Methods
The following is background information about the PAC-TIME tire model, as stated in the paper, A New
Tyre Model for TIME Measurement Data, J.J.M. van Oosten, E. Kuiper, G. Leister, D. Bode, H.
Schindler, J. Tischleder, S. Köhne [5]:
In 1999 a new method for tyre Force and Moment (F&M) testing has been developed by a consortium of
European tyre and vehicle manufacturers: the TIME procedure. For Vehicle Dynamics studies often a
Magic Formula (MF) tyre model is used based upon such F&M data. However when calculating MF
parameters for a standard MF model out of the TIME F&M data, several difficulties are observed. These
are mainly due to the non-uniform distribution of the data points over the slip angle, camber and load
area and the mutual dependency in between the slip angle, camber and load. A new MF model for pure
2 Adams/Tire
Using the PAC-TIME Tire Model
cornering slip conditions has been developed that allows the calculation of the MF parameters despite
of the dependency of the three input variables in the F&M data and shows better agreement with the
measured F&M data points. From mathematical point of view the optimisation process for deriving MF
parameters is better conditioned with the new MF-TIME, resulting in less sensitivity to starting values
and better convergence to a global minimum. In addition the MF-TIME has improved extrapolation
performance compared to the standard MF models for areas where no F&M data points are available.
Next to the use for TIME F&M data, the new model is expected to have interesting prospects for
converting ‘on-vehicle’ measured tyre data into a robust set of MF parameters.
In general, an MF tire model describes the tire behavior for rather smooth roads (road obstacle
wavelengths longer than the tire radius) up to frequencies of 8 Hz. This makes the tire model applicable
for all generic vehicle handling and stability simulations, including:
• Steady-state cornering
• Single- or double-lane change
• Braking or power-off in a turn
• Split-mu braking tests
• J-turn or other turning maneuvers
• ABS braking, when stopping distance is important (not for tuning ABS control strategies)
• Other common vehicle dynamics maneuvers on rather smooth roads (wavelength of road
obstacles must be longer than the tire radius)
For modeling roll-over of a vehicle, you must pay special attention to the overturning moment
characteristics of the tire (Mx), and the loaded radius modeling. The last item may not be sufficiently
addressed in this model.
The PAC-TIME model has been developed for car tires with camber (inclination) angles to the road not
exceeding 15 degrees.
The tire model routine calculates the vertical load and slip quantities based on the position and speed of
the wheel with respect to the road. The input for the Magic Formula consists of the wheel load (Fz), the
longitudinal and lateral slip ( , ), and inclination angle ( ) with the road. The output is the forces (Fx,
Fy) and moments (Mx, My, Mz) in the contact point between the tire and the road. For calculating these
forces, the MF equations use a set of MF parameters, which are derived from tire testing data.
The forces and moments out of the Magic Formula are transferred to the wheel center and returned to
Adams/Solver through STI.
Input and Output Variables of the Magic Formula Tire Model
Axis Systems
The PAC-TIME model is linked to Adams/Solver using the TYDEX STI conventions, as described in the
TYDEX-Format [2] and the STI [3].
4 Adams/Tire
Using the PAC-TIME Tire Model
The STI interface between the MF-TIME model and Adams/Solver mainly passes information to the tire
model in the C-axis coordinate system. In the tire model itself, a conversion is made to the W-axis system
because all the modeling of the tire behavior, as described in this help, assumes to deal with the slip
quantities, orientation, forces, and moments in the contact point with the TYDEX W-axis system. Both
axis systems have the ISO orientation but have different origin as can be seen in the figure below.
TYDEX C- and W-Axis Systems Used in PAC-TIME , Source [2]
The C-axis system is fixed to the wheel carrier with the longitudinal xc-axis parallel to the road and in
the wheel plane (xc-zc-plane). The origin of the C-axis system is the wheel center.
The origin of the W-axis system is the road contact-point defined by the intersection of the wheel plane,
the plane through the wheel carrier, and the road tangent plane.
The forces and moments calculated by PAC-TIME using the MF equations in this guide are in the W-axis
system. A transformation is made in the source code to return the forces and moments through the STI
to Adams/Solver.
The inclination angle is defined as the angle between the wheel plane and the normal to the road tangent
plane (xw-yw-plane).
Units
The units of information transferred through the STI between Adams/Solver and PAC-TIME are
according to the SI unit system. Also, the equations for PAC-TIME described in this guide have been
developed for use with SI units, although you can easily switch to another unit system in your tire
property file. Because of the non-dimensional parameters, only a few parameters have to be changed.
However, the parameters in the tire property file must always be valid for the TYDEX W-axis system
(ISO oriented). The basic SI units are listed in the table below.
5
Using the PAC-TIME Tire Model
Inclination angle
Force Longitudinal force Fx Newton
Lateral force Fy
Vertical load Fz
Moment Overturning moment Mx Newton.meter
Self-aligning moment Mz
Speed Longitudinal speed Vx Meters per second
Lateral speed Vy
The longitudinal slip velocity Vsx in the contact point (W-axis system, see Slip Quantities at Combined
Cornering and Braking/Traction) is defined using the longitudinal speed Vx, the wheel rotational velocity
, and the effective rolling radius Re:
6 Adams/Tire
Using the PAC-TIME Tire Model
V sx = V x – R e (1)
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y (2)
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point with:
V sx
= – ------- (3)
Vx
V sy
tan = -------- (4)
Vx
The rolling speed Vr is determined using the effective rolling radius Re:
Vr = Re (5)
Contact Point
In the vertical direction, the tire is modeled as a parallel linear spring and damper having one point of
contact (C) with the road. This is valid for road obstacles with a wavelength larger than the tire radius
(for example, for car tires 1m).
For calculating the kinematics of the tire relative to the road, the road is approximated by its tangent plane
at the road point right below the wheel center (see the figure below).
Contact Point C: Intersection between Road Tangent Plane, Spin Axis Plane, and Wheel Plane
7
Using the PAC-TIME Tire Model
The contact point is determined by the line of intersection of the wheel center-plane with the road tangent
(ground) plane and the line of intersection of the wheel center-plane with the plane though the wheel spin
axis.
The normal load Fz of the tire is calculated with:
·
Fz = Cz + Kz (6)
·
where is the tire deflection and is the deflection rate of the tire.
Instead of the linear vertical tire stiffness Cz, you can also define an arbitrary tire deflection - load curve
in the tire property file in the section [DEFLECTION_LOAD_CURVE] (see the Example of PAC-TIME
Tire Property File). If a section called [DEFLECTION_LOAD_CURVE] exists, the load deflection data
points with a cubic spline for inter- and extrapolation are used for the calculation of the vertical force of
the tire. Note that you must specify Cz in the tire property file, but it does not play any role.
Re = R0 – (7)
8 Adams/Tire
Using the PAC-TIME Tire Model
In this tire model, a constant (linear) vertical tire stiffness Cz is assumed; therefore, the tire deflection
can be calculated using:
Fz
= ----- (8)
Cz
The effective rolling radius Re (at free rolling of the tire), which is used to calculate the rotational speed
of the tire, is defined by:
Vx
R e = ----- (9)
For radial tires, the effective rolling radius is rather independent of load in its load range of operation
because of the high stiffness of the tire belt circumference. Only at low loads does the effective tire radius
decrease with increasing vertical load due to the tire tread thickness. See the figure below.
Effective Rolling Radius and Longitudinal Slip
9
Using the PAC-TIME Tire Model
d d
R e = R 0 – Fz0 Darc tan B + F (10)
F z0
Fz0 = -------- (11)
Cz
d
and is called the dimensionless radial tire deflection, defined by:
d = --------- (12)
Fz0
Effective Rolling Radius and Longitudinal Slip
For pure slip conditions, the lateral force Fy as a function of the lateral slip , respectively, and the
longitudinal force Fx as a function of longitudinal slip , have a similar shape. Because of the sine -
arctangent combination, the basic Magic Formula example is capable of describing this shape:
where Y(x) is either Fx with x the longitudinal slip , or Fy and x the lateral slip .
Characteristic Curves for Fx and Fy Under Pure Slip Conditions
11
Using the PAC-TIME Tire Model
The self-aligning moment Mz is calculated as a product of the lateral force Fy and the pneumatic trail t
added with the residual moment Mzr. In fact, the aligning moment is due to the offset of lateral force Fy,
called pneumatic trail t, from the contact point. Because the pneumatic trail t as a function of the lateral
slip has a cosine shape, a cosine version the Magic Formula is used:
In combined slip conditions, the lateral force Fy will decrease due to longitudinal slip or the opposite, the
longitudinal force Fx will decrease due to lateral slip. The forces and moments in combined slip
conditions are based on the pure slip characteristics multiplied by the so-called weighting functions.
Again, these weighting functions have a cosine-shaped MF examples.
The Magic Formula itself only describes steady-state tire behavior. For transient tire behavior (up to 8
Hz), the MF output is used in a stretched string model that considers tire belt deflections instead of slip
velocities to cope with standstill situations (zero speed).
The TIME measurement procedure guarantees more realistic tire test data, because they are performed
under realistic tire operating conditions and specific parts of the test program concentrate on getting
accurate cornering and camber stiffness. Because the inputs to the test program (side and longitudinal
slip, inclination, and load) are not independent, for the parameter optimization process, a Pacejka tire
model was required that has a better definition of cornering and camber stiffness from mathematical point
of view (for a more detailed explanation, see [5]).
Therefore, the PAC-TIME tire model has an explicit definition of camber effects, similar to the tire model
for motorcycle tires (PAC_MC). The basic Magic Formula sine function for the lateral force Fy has been
extended with an argument for the inclination as follows:
F yo
K = B C D = ----------- at = 0 (16)
Input Variables
The input variables to the Magic Formula are:
Input Variables
Output Variables
Its output variables are:
Output Variables.
As a measure for the vertical load, the normalized vertical load increment dfz is used:
F z – F' z0
df z = -------------------- (17)
F' z0
with the possibly adapted nominal load (using the user-scaling factor, Fz0 ):
F' z0 = F z0 F z0 (18)
Parameter: Definition:
a= p Force at pure slip
q Moment at pure slip
r Force at combined slip
s Moment at combined slip
15
Using the PAC-TIME Tire Model
Parameter: Definition:
i= B Stiffness factor
C Shape factor
D Peak value
E Curvature factor
K Slip stiffness = BCD
H Horizontal shift
V Vertical shift
s Moment at combined slip
t Transient tire behavior
j= x Along the longitudinal axis
y Along the lateral axis
z About the vertical axis
k= 1, 2, ...
Name used in
Name: tire property file: Explanation:
F LFZO Scale factor of nominal (rated) load
zo
Name used in
Name: tire property file: Explanation:
Ey LEY Scale factor of Fy curvature factor
Ky LKY Scale factor of Fy cornering stiffness
Vy LVY Scale factor of Fy vertical shift
Hy LHY Scale factor of Fy horizontal shift
K LKC Scale factor of camber stiffness (K-factor)
LGAY Scale factor of camber force stiffness
t LTR Scale factor of peak of pneumatic trail
Mr LRES Scale factor for offset of residual torque
z LGAZ Scale factor of camber torque stiffness
Mx LMX Scale factor of overturning couple
VMx LVMX Scale factor of Mx vertical shift
My LMY Scale factor of rolling resistance torque
F x = F x0 F z (19)
x = + S Hx (21)
x = x (22)
C x = p Cx1 Cx (23)
Dx = x Fz (24)
K = B C D = F x0
----------- at x = 0 (27)
x x x x x
Bx = Kx Cx Dx (28)
S Vx = F z p Vx1 + p Vx2 df z Vx x
18 Adams/Tire
Using the PAC-TIME Tire Model
1
F y0 = D y sin C y arc tan B y y – E y B y y – arc tan B y y + --- arc tan B y + S Vy (31)
2
y = + S Hy (32)
y = y (33)
with coefficients:
C y = p Cy1 Cy (34)
Dy = y Fz (35)
F y Fz
Ky = = p Ky1 F z0 sin p Ky4 arc tan ------------------------------ 1 – p Ky3 y2 Ky Fz0 (38)
p Ky2 F z0 Fz0
with p Ky4 2
F y
K = = F z p Ky5 + p Ky6 df z Ky (39)
Ky
B y = ------------- (40)
Cy Dy
2K
B = --------- (41)
Dy
M z0 = – t F y0 – S Vy = 0 + M zr
with the pneumatic trail t:
t = + S Ht
and the residual moment Mzr:
r = + S Hr (47)
S Hr = 0 (48)
z = z (49)
with coefficients:
C t = q Cz1 (51)
2
E t = q Ez1 + q Ez2 df z 1 + q Ez4 --- arc tan B t C t t (53)
with E t 1
B r = Kz y (55)
M z
= – tK y = F z q Dz1 + q Dz2 df z R 0 F z0 p Ky5 + p Ky6 df z F z t Ky (57)
and the aligning stiffness for inclination is:
M z
---------- = q Dz8 + q Dz9 df z F z R 0 y (58)
Aligning Moment Coefficients at Pure Slip
with G x the weighting function of the longitudinal force for pure slip.
We write:
s = + S Hx (61)
with coefficients:
C x = r Cx1 (63)
23
Using the PAC-TIME Tire Model
F xo
D x = ---------------------------------------------------------------------------------------------------------------------------------------------------------------- (64)
cos C x arc tan B x S Hx – E x B x S Hx – arc tan B x S Hx
with Gyk the weighting function for the lateral force at pure slip and SVyk the ' -induced' side force;
therefore, the lateral force can be written as:
s = + S Hy (70)
C y = r Cy1 (72)
24 Adams/Tire
Using the PAC-TIME Tire Model
F yo
D y = ------------------------------------------------------------------------------------------------------------------------------------------------------------ (73)
cos C y arc tan B y S Hy – E y B yk S Hy – arc tan B y S Hy
with:
25
Using the PAC-TIME Tire Model
t = t t eq (79)
t = t t eq
with the arguments:
Kx 2
t eq = arc tan tan t + ------ 2 sgn t
2
(83)
Ky
Kx 2
r eq = arc tan tan r + ------ 2 sgn r
2
(84)
K y
Fy
M x = R o F z q sx1 VMx – q sx2 + q sx3 -------- Mx (85)
F z0
S Vx
c = + S Hx + --------
Kx
S Vy
c = + S Hy + --------
Ky
= sin c
c
= acos -------------------------
2 + 2
c
F x 0 – S Vx F y 0 – S Vy
x act = ------------------------ y act = ------------------------
Fz Fz
Dx Dy
x max = ------ y max = ------
Fz Fz
1
x = --------------------------------------------------------
1 2 ---------------
------------- tan 2
+
x act y max
tan
y = --------------------------------------------------------
1 2 -------------
--------------- tan 2
+
x max y act
x y
F x = ------------- F x 0 F y = ------------- F y 0
x act y act
For aligning moment Mx, rolling resistance My and aligning moment Mz the formulae (76) until and
including (84) are used with S Vy = 0.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid:
1 dv 1 -----
v1
----- + - = tan + a (87)
Vx d t
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
dv 1
+ V x v 1 = V sy (88)
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
A similar approach yields the following for the deflection of the string in longitudinal direction:
29
Using the PAC-TIME Tire Model
du 1
+ V x u 1 = – V sx (89)
dt
Both the longitudinal and lateral relaxation length are defined as of the vertical load:
Fz
= p Ty1 F z0 sin p Ky4 arc tan ---------------------------- 1 – p Ky3 2 R 0 Fz0 (91)
p Ty2 F z0 Fz0
Now the practical slip quantities, ' and ' , are defined based on the tire deformation:
u1
' = ------ sin V x (92)
v1
' = atan ------ (93)
Using these practical slip quantities, ' and ' , the Magic Formula equations can be used to calculate
the tire-road interaction forces and moments:
dv
M z gyr = c gyr m belt V r1 cos arc tan B r r eq (97)
dt
with the parameters (in addition to the basic tire parameter mbelt):
and:
30 Adams/Tire
Using the PAC-TIME Tire Model
M z = M z' + M z gyr
Coefficients and Transient Response
Next to the LEFT and RIGHT side option of TYRESIDE, you can also set SYMMETRIC: then the tire
characteristics are modified during initialization to show symmetric performance for left and right side
corners and zero conicity and plysteer (no offsets). Also, when you set the tire property file to
SYMMETRIC, the tire characteristics are changed to symmetric behavior.
PAC-TIME output
USE_MODE: State: Slip conditions: (forces and moments):
0 Steady state Acts as a vertical spring and damper 0, 0, Fz, 0, 0, 0
1 Steady state Pure longitudinal slip Fx, 0, Fz, 0, My, 0
2 Steady state Pure lateral (cornering) slip 0, Fy, Fz, Mx, 0, Mz
3 Steady state Longitudinal and lateral (not combined) Fx, Fy, Fz, Mx, My, Mz
4 Steady state Combined slip Fx, Fy, Fz, Mx, My, Mz
11 Transient Pure longitudinal slip Fx, 0, Fz, 0, My, 0
12 Transient Pure lateral (cornering) slip 0, Fy, Fz, Mx, 0, Mz
13 Transient Longitudinal and lateral (not combined) Fx, Fy, Fz, Mx, My, Mz
14 Transient Combined slip Fx, Fy, Fz, Mx, My, Mz
Note: Do not change Fz0 (FNOMIN) and R0 (UNLOADED_RADIUS) in your tire property
file. It will change the complete tire characteristics because these two parameters are used
to make all parameters without dimension.
Rolling Resistance
For a realistic rolling resistance, the parameter qsy1 must be positive. For car tires, it can be in the order
of 0.006 - 0.01 (0.6% - 1.0%).
$---------------------------------------------------rolling
resistance
[ROLLING_COEFFICIENTS]
QSY1 = 0.01
QSY2 = 0
QSY3 = 0
QSY4 = 0
33
Using the PAC-TIME Tire Model
If one of the input parameters exceeds a minimum or maximum validity value, the calculation in the tire
model is performed with the minimum or maximum value of this range to avoid non-realistic tire
behavior. In that case, a message appears warning you that one of the inputs exceeds a validity value.
In TYDEX, two expert groups, consisting of participants of vehicle industry (passenger cars and trucks),
tire manufacturers, other suppliers and research laboratories, had been defined with following goals:
• The first expert group's (Tire Measurements - Tire Modeling) main goal was to specify an
interface between tire measurements and tire models. The result was the TYDEX-Format [2] to
describe tire measurement data.
• The second expert group's (Tire Modeling - Vehicle Modeling) main goal was to specify an
interface between tire models and simulation tools, which resulted in the Standard Tire Interface
(STI) [3]. The use of this interface should ensure that a wide range of simulation software can be
linked to a wide range of tire modeling software.
Definitions
• General
• Tire Kinematics
• Slip Quantities
• Force and Moments
General
General Definitions
Term: Definition:
Road tangent plane Plane with the normal unit vector (tangent to the road) in the tire-road contact
point C.
C-axis system Coordinate system mounted on the wheel carrier at the wheel center according to
TYDEX, ISO orientation.
Wheel plane The plane in the wheel center that is formed by the wheel when considered a rigid
disc with zero width.
Contact point C Contact point between tire and road, defined as the intersection of the wheel
plane and the projection of the wheel axis onto the road plane.
W-axis system Coordinate system at the tire contact point C, according to TYDEX, ISO
orientation.
Tire Kinematics
Tire Kinematics Definitions
Slip Quantities
Slip Quantities Definitions
References
1. H.B. Pacejka, Tyre and Vehicle Dynamics, 2002, Butterworth-Heinemann, ISBN 0 7506 5141 5.
2. H.-J. Unrau, J. Zamow, TYDEX-Format, Description and Reference Manual, Release 1.1,
Initiated by the International Tire Working Group, July 1995.
3. A. Riedel, Standard Tire Interface, Release 1.2, Initiated by the Tire Workgroup, June 1995.
4. J.J.M. van Oosten, H.-J. Unrau, G. Riedel, E. Bakker, TYDEX Workshop: Standardisation of
Data Exchange in Tyre Testing and Tyre Modelling, Proceedings of the 2nd International
Colloquium on Tyre Models for Vehicle Dynamics Analysis, Vehicle System Dynamics, Volume
27, Swets & Zeitlinger, Amsterdam/Lisse, 1996.
5. J.J.M. van Oosten, E. Kuiper, G. Leister, D. Bode, H. Schindler, J. Tischleder, S. Köhne, A new
tyre model for TIME measurement data,Tire Technology Expo 2003, Hannover.
FORCE ='newton'
ANGLE ='radians'
MASS ='kg'
TIME ='second'
$---------------------------------------------------------------model
[MODEL]
PROPERTY_FILE_FORMAT ='PAC-TIME'
USE_MODE = 14 $Tyre use switch (IUSED)
VXLOW = 2
LONGVL = 30 $Measurement speed
TYRESIDE = 'LEFT' $Mounted side of tyre
at vehicle/test bench
$----------------------------------------------------------dimensions
[DIMENSION]
UNLOADED_RADIUS = 0.317 $Free tyre radius
WIDTH = 0.205 $Nominal section width
of the tyre
ASPECT_RATIO = 0.55 $Nominal aspect ratio
RIM_RADIUS = 0.203 $Nominal rim radius
RIM_WIDTH = 0.165 $Rim width
$-----------------------------------------------------------parameter
[VERTICAL]
VERTICAL_STIFFNESS = 2.648e+005 $Tyre vertical
stiffness
VERTICAL_DAMPING = 500 $Tyre vertical damping
BREFF = 4.90 $Low load stiffness
e.r.r.
DREFF = 0.41 $Peak value of e.r.r.
FREFF = 0.09 $High load stiffness
e.r.r.
FNOMIN = 4704 $Nominal wheel load
$-----------------------------------------------------long_slip_range
[LONG_SLIP_RANGE]
KPUMIN = -1.5 $Minimum valid wheel slip
KPUMAX = 1.5 $Maximum valid wheel slip
$----------------------------------------------------slip_angle_range
[SLIP_ANGLE_RANGE]
ALPMIN = -1.5708 $Minimum valid slip
angle
ALPMAX = 1.5708 $Maximum valid slip
angle
$----------------------------------------------inclination_slip_range
[INCLINATION_ANGLE_RANGE]
CAMMIN = -0.26181 $Minimum valid camber
angle
CAMMAX = 0.26181 $Maximum valid camber
angle
$-----------------------------------------------vertical_force_range
[VERTICAL_FORCE_RANGE]
FZMIN = 140 $Minimum allowed wheel
load
FZMAX = 10800 $Maximum allowed wheel
load
$------------------------------------------------------------scaling
39
Using the PAC-TIME Tire Model
[SCALING_COEFFICIENTS]
LFZO = 1 $Scale factor of nominal
load
LCX = 1 $Scale factor of Fx
shape factor
LMUX = 1 $Scale factor of Fx
peak friction coefficient
LEX = 1 $Scale factor of Fx
curvature factor
LKX = 1 $Scale factor of Fx
slip stiffness
LHX = 1 $Scale factor of Fx
horizontal shift
LVX = 1 $Scale factor of Fx
vertical shift
LGAX = 1 $Scale factor of camber
for Fx
LCY = 1 $Scale factor of Fy
shape factor
LMUY = 1 $Scale factor of Fy
peak friction coefficient
LEY = 1 $Scale factor of Fy
curvature factor
LKY = 1 $Scale factor of Fy
cornering stiffness
LHY = 1 $Scale factor of Fy
horizontal shift
LVY = 1 $Scale factor of Fy
vertical shift
LKC = 1 $Scale factor of camber
stiffness
LGAY = 1 $Scale factor of camber
for Fy
LTR = 1 $Scale factor of Peak
of pneumatic trail
LRES = 1 $Scale factor of Peak
of residual torque
LGAZ = 1 $Scale factor of camber
torque stiffness
LXAL = 1 $Scale factor of alpha
influence on Fx
LYKA = 1 $Scale factor of kappa
influence on Fy
LVYKA = 1 $Scale factor of kappa
induced Fy
LS = 1 $Scale factor of Moment
arm of Fx
LSGKP = 1 $Scale factor of
Relaxation length of Fx
LSGAL = 1 $Scale factor of
Relaxation length of Fy
LGYR = 1 $Scale factor of
gyroscopic torque
40 Adams/Tire
Using the PAC-TIME Tire Model
Contact Methods
The PAC-TIME model supports the following roads:
• 2D Roads, see Using the 2D Road Model
• 3D Spline Roads, see Adams/3D Spline Road Model
Note that the PAC-TIME model has only one point of contact with the road; therefore, the
wavelength of road obstacles must be longer than the tire radius for realistic output of the model.
In addition, the contact force computed by this tire model is normal to the road plane. Therefore,
the contact point does not generate a longitudinal force when rolling over a short obstacle, such
as a cleat or pothole.
• 3D Shell Roads, see Adams/Tire 3D Shell Road Model
For ride and comfort analyses, we recommend more sophisticated tire models, such as Ftire.
Using Pacejka '89 and '94 Models
Adams/Tire provides you with the handling force models, Pacejka '89 and Pacejka '94.
• About Pacejka '89 and '94
• Using Pacejka '89 Handling Force Model
• Using Pacejka '94 Handling Force Model
• Combined Slip
• Left and Right Side Tires
• Contact Methods
Normal Force
The normal force Fz is calculated assuming a linear spring (stiffness: kz) and damper (damping constant
·
cz), so the next equation holds: F z = kz + cz
·
If the tire loses contact with the road, the tire deflection and deflection velocity become zero, so the
resulting normal force Fz will also be zero. For very small positive tire deflections, the value of the
damping constant is reduced and care is taken to ensure that the normal force Fz will not become
negative.
In stead of the linear vertical tire stiffness cz , also an arbitrary tire deflection - load curve can be defined
in the tire property file in the section [DEFLECTION_LOAD_CURVE], see also the example tire
property files, Example of Pacejka ’89 Property File and Example of Pacejka ’94 Property File. If a section
called [DEFLECTION_LOAD_CURVE] exists, the load deflection datapoints with a cubic spline for
inter- and extrapolation are used for the calculation of the vertical force of the tire. Note that you must
specify VERTICAL_STIFFNESS in the tire property, but it does not play any role.
3
Using Pacejka '89 and '94 Models
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity , and the loaded rolling radius Re:
V sx = V x – R e
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point:
V sx
= – -------
Vx
and
V sy
tan = --------
Vr
The rolling speed Vr is determined using the effective rolling radius Re:
Vr = Re
Note that for realistic tire forces the slip angle is limited to 900 and the longitudinal slip Ss (= ) in
between -1 (locked wheel) and 1.
4 Adams/Tire
Using Pacejka '89 and '94 Models
When rolling, the first point having contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string will arise that depends on the slip angle size and the history
of the lateral deflection of previous points having contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid during braking slip:
1 dv v
----- -------1- + -----1- = tan + a
V x dt
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
5
Using Pacejka '89 and '94 Models
dv 1
-------- + V x v 1 = V sy
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
A similar approach yields the following for the deflection of the string in longitudinal direction:
du 1
-------- + V x u 1 = – V sx
dt
Now the practical slip quantities, ' and ' , are defined based on the tire deformation:
u1
' = ------ sign V x
v1
' = atan ------
These practical slip quantities ' and ' are used instead of the usual and definitions for steady-
state tire behavior.
The longitudinal and lateral relaxation length are estimated with the longitudinal and lateral stiffness of
the non-rolling tire:
BCD x BCD y
= -------------------------------------------------------- and = --------------------------------------------
longitudinal_stiffness lateral_stiffness
For BCDx and BCDy see section Force and Moment Formulation for Pacejka '94.
In case the longitudinal stiffness is not available in the tire property file the longitudinal stiffness is
estimated with:
longitudinal_stiffness = 4 lateral_stiffness
Note: The section [UNITS] in the tire property file does not apply to the Magic Formula
coefficients.
D - Peak Factor
D=(B1*FZ2+B2*FZ)
BCD
BCD=(B3*FZ2+B4*FZ)*EXP(-B5*FZ)
B - Stiffness Factor
B=BCD/(C*D)
Horizontal Shift
Sh=B9*FZ+B10
Vertical Shift
Sv=0.0
Composite
X1=(+Sh)
8 Adams/Tire
Using Pacejka '89 and '94 Models
E Curvature Factor
E=(B6*FZ2+B7*FZ+B8)
FX Equation
FX=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv
Longitudinal Force
Parameters: Description:
B0 Shape factor
B1 , B2 Peak factor
B3 , B4 , B5 BCD calculation
B6 , B7 , B8 Curvature factor
B9, B10 Horizontal shift
D - Peak Factor
D=(A1*FZ2+A2*FZ)
BCD
BCD=A3*SIN(ATAN(FZ/A4)*2.0)*(1.0-A5*ABS())
B - Stiffness Factor
B=BCD/(C*D)
Horizontal Shift
Sh=A9*FZ+A10+A8*
Vertical Shift
Sv=A11*FZ*+A12*FZ+A13
Composite
X1=(+Sh)
E - Curvature Factor
E=(A6*FZ+A7)
FY Equation
FY=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv
Parameters: Description:
A0 Shape factor
A1, A2 Peak factor
A3, A4, A5 BCD calculation
A6, A7 Curvature factor
A8, A9, A10 Horizontal shift
A11, A12, A13 Vertical shift
10 Adams/Tire
Using Pacejka '89 and '94 Models
Self-Aligning Torque
C - Shape Factor
C=C0
D - Peak Factor
D=(C1*FZ2+C2*FZ)
BCD
BCD=(C3*FZ2+C4*FZ)*(1-C6*ABS())*EXP(-C5*FZ)
B - Stiffness Factor
B=BCD/(C*D)
Horizontal Shift
Sh=C11*+C12*FZ+C13
Vertical Shift
Sv= (C14*FZ2+C15*FZ)*+C16*FZ+C17
11
Using Pacejka '89 and '94 Models
Composite
X1=(+Sh)
E - Curvature Factor
E=(C7*FZ2+C8*FZ+C9)*(1.0-C10*ABS())
MZ Equation
MZ=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv
Parameters: Description:
C0 Shape factor
C1 , C2 Peak factor
C3, C4, C5, C6 BCD calculation
C7, C8, C9, C10 Curvature factor
C11, C12, C13 Horizontal shift
C14, C15, C16, C17 Vertical shift
Overturning Moment
The lateral stiffness is used to calculate an approximate lateral deflection of the contact patch when there
is a lateral force present:
deflection = Fy / lateral_stiffness
This deflection, in turn, is used to calculate an overturning moment due to the vertical force:
Mx (overturning moment) = -Fz * deflection
Here Mz,Magic Formula is the magic formula for aligning torque and Fx * deflection is the contribution due
to the longitudinal force.
Rolling Resistance
The rolling resistance moment My is opposite to the wheel angular velocity. The magnitude is given by:
My = Fz * Lrad * rolling_resistance
Where Fz equals the vertical force and Lrad is the tyre loaded radius. The rolling resistance coefficient
can be entered in the tire property file:
[PARAMETER]
ROLLING_RESISTANCE = 0.01
A value of 0.01 introduces a rolling resistance force that is 1% of the vertical load.
Smoothing
When you indicate smoothing by setting the value of use mode in the tire property file, Adams/Tire
smooths initial transients in the tire force over the first 0.1 seconds of simulation. The longitudinal force,
lateral force, and aligning torque are multiplied by a cubic step function of time. (See STEP in the
Adams/Solver online help.)
Longitudinal Force
FLon = S*FLon
Lateral Force
FLat = S*FLat
Overturning Moment
Mx = S*Mx
My = S*My
Aligning Torque
Mz = S*Mz
The USE_MODE parameter in the tire property file allows you to switch smoothing on or off:
• USE_MODE = 1 or 2, smoothing is off
• USE_MODE = 3 or 4, smoothing is on
$---------------------------------------------------------LOAD_CURVE
$ For a non-linear tire vertical stiffness (optional)
$ Maximum of 100 points
[DEFLECTION_LOAD_CURVE]
{pen fz}
0 0.0
1 212.0
2 428.0
3 648.0
5 1100.0
10 2300.0
20 5000.0
30 8100.0
$-----------------------------------------------LATERAL_COEFFICIENTS
[LATERAL_COEFFICIENTS]
a0 = 1.65000
a1 = -34.0
a2 = 1250.00
a3 = 3036.00
a4 = 12.80
a5 = 0.00501
a6 = -0.02103
a7 = 0.77394
a8 = 0.0022890
a9 = 0.013442
a10 = 0.003709
a11 = 19.1656
a12 = 1.21356
a13 = 6.26206
$--------------------------------------------------------longitudinal
[LONGITUDINAL_COEFFICIENTS]
b0 = 1.67272
b1 = -9.46000
b2 = 1490.00
b3 = 30.000
b4 = 176.000
b5 = 0.08860
b6 = 0.00402
b7 = -0.06150
b8 = 0.20000
b9 = 0.02990
b10 = -0.17600
$----------------------------------------------------------aligning
[ALIGNING_COEFFICIENTS]
c0 = 2.34000
c1 = 1.4950
c2 = 6.416654
c3 = -3.57403
c4 = -0.087737
c5 = 0.098410
c6 = 0.0027699
c7 = -0.0001151
c8 = 0.1000
c9 = -1.33329
15
Using Pacejka '89 and '94 Models
c10 = 0.025501
c11 = -0.02357
c12 = 0.03027
c13 = -0.0647
c14 = 0.0211329
c15 = 0.89469
c16 = -0.099443
c17 = -3.336941
$--------------------------------------------------------------shape
[SHAPE]
{radial width}
1.0 0.0
1.0 0.2
1.0 0.4
1.0 0.5
1.0 0.6
1.0 0.7
1.0 0.8
1.0 0.85
1.0 0.9
0.9 1.0
Note: The section [UNITS] in the tire property file does not apply to the Magic Formula
coefficients.
D - Peak Factor
D=(B1*FZ2+B2*FZ) * DLON
BCD
BCD=((B3*FZ2+B4*FZ)*EXP(-B5*FZ)) * BCDLON
B - Stiffness Factor
B=BCD/(C*D)
Horizontal Shift
Sh=B9*Fz+B10
Vertical Shift
Sv=B11*FZ+B12
17
Using Pacejka '89 and '94 Models
Composite
X1=(+Sh)
E Curvature Factor
E=((B6*FZ+B7)*FZ+B8)*(1-(B13*SIGN(1,X1))))
FX Equation
FX=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv
Parameters: Description:
B0 Shape factor
B1 , B2 Peak factor
B3 , B4 , B 5 BCD calculation
B6, B7, B8, B13 Curvature factor
B9, B10 Horizontal shift
B11, B12 Vertical shift
DLON, BCDLON Scale factor
D - Peak Factor
2
D=((A1*FZ+A2) *(1-A15* )*FZ) * DLAT
BCD
B - Stiffness Factor
B=BCD/(C*D)
Horizontal Shift
Sh=A8*FZ+A9+A10*
Vertical Shift
18 Adams/Tire
Using Pacejka '89 and '94 Models
Sv=A11*FZ+A12+(A13*FZ2+A14*FZ)*
Composite
X1=(+Sh)
E - Curvature Factor
E=(A6*FZ+A7)*(1-(((A16*)+A17)*SIGN(1,X1))))
FY Equation
FY=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv
Parameters: Description:
A0 Shape factor
A1, A2, A15 Peak factor
A3 , A4 , A 5 BCD calculation
A6, A7, A16, A17 Curvature factor
A8, A9, A10 Horizontal shift
A11, A12, A13, A14 Vertical shift
DLAT, BCDLAT Scale factor
D - Peak Factor
2
D=(C1*FZ2+C2*FZ)*(1-C18* )
BCD
BCD=(C3*FZ2+C4*FZ)*(1-(C6*ABS()))*EXP(-C5*FZ)
B - Stiffness Factor
B=BCD/(C*D)
Horizontal Shift
Sh=C11*FZ+C12+C13*
19
Using Pacejka '89 and '94 Models
Vertical Shift
Sv=C14*FZ+C15+(C16*FZ2+C17*FZ)*
Composite
X1=( +Sh)
E - Curvature Factor
MZ Equation
MZ=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv
Parameters: Description:
C0 Shape factor
C1, C2, C18 Peak factor
C3, C4, C5, C6 BCD calculation
C7, C8, C9, C19, C20 Curvature factor
C11, C12, C13 Horizontal shift
C14, C15, C16, C17 Vertical shift
Overturning Moment
The lateral stiffness is used to calculate an approximate lateral deflection of the contact patch when there
is a lateral force present:
deflection = Fy / lateral_stiffness
This deflection, in turn, is used to calculate an overturning moment due to the vertical force:
Mx (overturning moment) = -Fz * deflection
Here Mz,Magic Formula is the magic formula for aligning torque and Fx * deflection is the contribution due
to the longitudinal force.
Rolling Resistance
The rolling resistance moment My is opposite to the wheel angular velocity. The magnitude is given by:
20 Adams/Tire
Using Pacejka '89 and '94 Models
My = Fz * Lrad * rolling_resistance
Where Fz equals the vertical force and Lrad is the tyre loaded radius. The rolling resistance coefficient
can be entered in the tire property file:
[PARAMETER]
ROLLING_RESISTANCE = 0.01
A value of 0.01 will introduce a rolling resistance force, which is 1% of the vertical load.
Smoothing
Adams/Tire smooths initial transients in the tire force over the first 0.1 seconds of simulation. The
longitudinal force, lateral force, and aligning torque are multiplied by a cubic step function of time. (See
STEP in the Adams/Solver online help.)
Longitudinal Force
FLon = S*FLon
Lateral Force
FLat = S*FLat
Overturning Moment
Mx = S*Mx
Aligning Torque
Mz = S*Mz
The USE_MODE parameter in the tire property file allows you to switch smoothing on or off:
• USE_MODE = 1 or 2, smoothing is off
• USE_MODE = 3 or 4, smoothing is on
LENGTH = 'inch'
FORCE = 'pound_force'
ANGLE = 'radians'
MASS = 'pound_mass'
TIME = 'second'
$--------------------------------------------------------------model
[MODEL]
! use mode 12341234
! ---------------------------------------------------------------
! smoothingXXXX
! combinedXXXX
! transient X X X X
!
PROPERTY_FILE_FORMAT = 'PAC94'
USE_MODE = 12.0
TYRESIDE = 'LEFT'
$---------------------------------------------------------dimensions
[DIMENSION]
UNLOADED_RADIUS = 12.95
WIDTH = 10.0
ASPECT_RATIO = 0.30
$---------------------------------------------------------parameter
[PARAMETER]
VERTICAL_STIFFNESS = 2500
VERTICAL_DAMPING = 250.0
LATERAL_STIFFNESS = 1210.0
ROLLING_RESISTANCE = 0.01
$---------------------------------------------------------load_curve
$ Maximum of 100 points (optional)
[DEFLECTION_LOAD_CURVE]
{pen fz}
0.000 0
0.039 943
0.079 1904
0.118 2882
0.197 4893
0.394 10231
0.787 22241
1.181 36031
$-----------------------------------------------------------scaling
[SCALING_COEFFICIENTS]
DLAT = 0.10000E+01
DLON = 0.10000E+01
BCDLAT = 0.10000E+01
BCDLON = 0.10000E+01
$-----------------------------------------------------------lateral
[LATERAL_COEFFICIENTS]
A0 = 1.5535430E+00
A1 = -1.2854474E+01
A2 = -1.1133711E+03
A3 = -4.4104698E+03
A4 = -1.2518279E+01
A5 = -2.4000120E-03
A6 = 6.5642332E-02
22 Adams/Tire
Using Pacejka '89 and '94 Models
A7 = 2.0865589E-01
A8 = -1.5717978E-02
A9 = 5.8287762E-02
A10 = -9.2761963E-02
A11 = 1.8649096E+01
A12 = -1.8642199E+02
A13 = 1.3462023E+00
A14 = -2.0845180E-01
A15 = 2.3183540E-03
A16 = 6.6483573E-01
A17 = 3.5017404E-01
$------------------------------------------------------longitudinal
[LONGITUDINAL_COEFFICIENTS]
B0 = 1.4900000E+00
B1 = -2.8808998E+01
B2 = -1.4016957E+03
B3 = 1.0133759E+02
B4 = -1.7259867E+02
B5 = -6.1757933E-02
B6 = 1.5667623E-02
B7 = 1.8554619E-01
B8 = 1.0000000E+00
B9 = 0.0000000E+00
B10 = 0.0000000E+00
B11 = 0.0000000E+00
B12 = 0.0000000E+00
B13 = 0.0000000E+00
$----------------------------------------------------------aligning
[ALIGNING_COEFFICIENTS]
C0 = 2.2300000E+00
C1 = 3.1552342E+00
C2 = -7.1338826E-01
C3 = 8.7134880E+00
C4 = 1.3411892E+01
C5 = -1.0375348E-01
C6 = -5.0880786E-03
C7 = -1.3726071E-02
C8 = -1.0000000E-01
C9 = -6.1144302E-01
C10 = 3.6187314E-02
C11 = -2.3679781E-03
C12 = 1.7324400E-01
C13 = -1.7680388E-02
C14 = -3.4007351E-01
C15 = -1.6418691E+00
C16 = 4.1322424E-01
C17 = -2.3573702E-01
C18 = 6.0754417E-03
C19 = -4.2525059E-01
C20 = -2.1503067E-01
$--------------------------------------------------------------shape
[SHAPE]
{radial width}
1.0 0.0
23
Using Pacejka '89 and '94 Models
1.0 0.2
1.0 0.4
1.0 0.5
1.0 0.6
1.0 0.7
1.0 0.8
1.0 0.85
1.0 0.9
0.9 1.0
Output:
• Adjusted longitudinal force Fx and lateral force Fy to incorporate the reduction due to combined
slip:
* = + S hx
* = + S hy
SAG = sin *
*
= arc cos --------------------------------------
* 2 + SAG 2
Friction coefficients:
24 Adams/Tire
Using Pacejka '89 and '94 Models
F x – S vx F y – S vy
x act = ------------------- y act = -------------------
Fz Fz
Dx Dy
x max = ------ y max = ------
Fz Fz
1 tan
x = --------------------------------------------------------- y = ---------------------------------------------------------
1 2 ---------------
------------- tan 2 1 2 -------------
--------------- tan 2
+ +
x act y max x max y act
x y
F x comb = ------------- F x + S vx F y comb = ------------- F y + S vy
x act y act
side corners and zero conicity and plysteer (no offsets). Also, when you set the tire property file to
SYMMETRIC, the tire characteristics are changed to symmetric behavior.
Contact Methods
The Pacejka '89 and '94 models support the following roads:
• 2D roads, see Using the 2D Road Model.
• 3D Spline roads, see Adams/3D Spline Road Model
26 Adams/Tire
Using Pacejka '89 and '94 Models
These tire models use a one point of contact method; therefore, the wavelength of road obstacles
must be longer than the tire radius for realistic output of the model.
• 3D Shell roads, see Adams/Tire 3D Shell Road Model
PAC MC
Learn about using the University of Arizona (UA) tire model:
The tire model routine calculates the vertical load and slip quantities based on the position and speed of
the wheel with respect to the road. The input for the Magic Formula consists of the wheel load F z , the
longitudinal and lateral slip , and inclination angle with the road. The output is the forces
F x F y , and moments M x M y M z in the contact point between the tire and the road. For
calculating these forces, the MF equations use a set of MF parameters, which are derived from tire testing
data.
The forces and moments out of the Magic Formula are transferred to the wheel center and returned to
Adams/Solver through the STI.
3
PAC MC
Axis System
The PAC MC model is linked to Adams/Solver using the TYDEX STI conventions as described in the
TYDEX-Format [2] and the STI [3].
The STI interface between the PAC MC model and Adams/Solver mainly passes information to the tire
model in the C-axis coordinate system. In the tire model itself, a conversion is made to the W-axis system
because all the modeling of the tire behavior, as described in this help, assumes to deal with the slip
quantities, orientation, forces, and moments in the contact point with the TYDEX W-axis system. Both
axis systems have the ISO orientation but have a different origin as can be seen in the figure below.
4 Adams/Tire
PAC MC
The C-axis system is fixed to the wheel carrier with the longitudinal xc-axis parallel to the road and in
the wheel plane (xc-zc-plane). The origin of the C-axis system is the wheel center.
The origin of the W-axis system is the road contact-point defined by the intersection of the wheel plane,
the plane through the wheel carrier, and the road tangent plane.
The forces and moments calculated by PAC MC using the MF equations in this guide are in the W-axis
system. A transformation is made in the source code to return the forces and moments through the STI
to Adams/Solver.
The inclination angle is defined as the angle between the wheel plane and the normal to the road tangent
plane (xw-yw-plane).
Units
The units of information transferred through the STI between Adams/Solver and PAC MC are according
to the SI unit system. Also, the equations for PAC MC described in this guide have been developed for
use with SI units, although you can easily switch to another unit system in your tire property file. Because
of the non-dimensional parameters, only a few parameters have units to be changed.
However, the parameters in the tire property file must always be valid for the TYDEX W-axis system
(ISO oriented). The basic SI units are listed in the table below (also see Definitions).
5
PAC MC
Inclination angle
Force Longitudinal force Fx Newton
Lateral force Fy
Vertical load Fz
Moment Overturning moment Mx Newton.meter
Lateral speed Vy
Longitudinal slip speed V sx
Lateral slip speed V sy
Rotational speed Tire rolling speed Radians per second
The longitudinal slip velocity V sx in the contact point (W-axis system, see the figure, Slip Quantities at
Combined Cornering) is defined using the longitudinal speed V x , the wheel rotational velocity , and
V sx = V x – R e
6 Adams/Tire
PAC MC
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point with:
V sx
= – -------
Vx
V sy
tan = --------
Vx
The rolling speed Vr is determined using the effective rolling radius Re:
Vr = Re
Contact Point
In the vertical direction, the tire is modeled as a parallel linear spring and damper having one point of
contact (C) with the road. This is valid for road obstacles with a wavelength larger than the tire radius
(for example, for car tires 1m).
For calculating the kinematics of the tire relative to the road, the road is approximated by its tangent plane
at the road point right below the wheel center (see figure below).
7
PAC MC
Contact Point C: Intersection between Road Tangent Plane, Spin Axis Plane, and Wheel Plane
The contact point is determined by the line of intersection of the wheel center-plane with the road tangent
(ground) plane and the line of intersection of the wheel center-plane with the plane though the wheel spin
axis.
·
Fz = Cz + Kz
·
where is the tire deflection and is the deflection rate of the tire.
To take into account the effect of the tire cross-section profile, you can choose a more advanced method
(see the Tire Cross Section Profile Contact Method).
Instead of the linear vertical tire stiffness Cz, also an arbitrary tire deflection - load curve can be defined
in the tire property file in the section [DEFLECTION_LOAD_CURVE]. If a section called
[DEFLECTION_LOAD_CURVE] exists, the load deflection datapoints with a cubic spline for inter- and
extrapolation are used for the calculation of the vertical force of the tire. Note that you must specify C z
in the tire property file, but it does not play any role.
8 Adams/Tire
PAC MC
R1 = R0 –
In this tire model, a constant (linear) vertical tire stiffness C z is assumed; therefore, the tire deflection
can be calculated using:
Fz
= -----
Cz
The effective rolling radius Re (at free rolling of the tire), which is used to calculate the rotational speed
of the tire, is defined by:
Vx
R e = -----
For radial tires, the effective rolling radius is rather independent of load in its load range of operation due
to the high stiffness of the tire belt circumference. Only at low loads does the effective tire radius decrease
with increasing vertical load due to the tire tread thickness. See the figure below.
9
PAC MC
F z0
Fz0 = --------
Cz
d
and is called the dimensionless radial tire deflection, defined by:
10 Adams/Tire
PAC MC
d = ---------
Fz0
Example of the Loaded and Effective Tire Rolling Radius as a Function of the Vertical Load
For pure slip conditions, the lateral force Fy as a function of the lateral slip , respectively, and the
longitudinal force Fx as a function of longitudinal slip , have a similar shape (see the figure,
Characteristic Curves for Fx and Fy Under Pure Slip Conditions). Because of the sine - arctangent
combination, the basic Magic Formula example is capable of describing this shape:
(1)
where Y(x) is either Fx with x the longitudinal slip , or Fy and x the lateral slip .
The self-aligning moment M z is calculated as a product of the lateral force Fy and the pneumatic trail t
added with the residual moment M zr . In fact, the aligning moment is due to the offset of lateral force Fy,
called pneumatic trail t, from the contact point. Because the pneumatic trail t as a function of the lateral
slip has a cosine shape, a cosine version the Magic Formula is used:
Y x = D cos c arc tan B x – E B x – arc tan B x (2)
In combined slip conditions, the lateral force F y decreases due to longitudinal slip or the opposite, the
longitudinal force F x decreases due to lateral slip. The forces and moments in combined slip conditions
are based on the pure slip characteristics multiplied by the so-called weighting functions. Again, these
weighting functions have a cosine-shaped MF examples.
14 Adams/Tire
PAC MC
The Magic Formula itself only describes steady-state tire behavior. For transient tire behavior (up to 8
Hz), the MF output is used in a stretched string model that considers tire belt deflections instead of slip
velocities to cope with standstill situations (zero speed).
F yo at y = 0
K = B C D =
(4)
Input Variables
The input variables to the Magic Formula are:
Input Variables
Output Variables
Its output variables are:
Output Variables
As a measure for the vertical load, the normalized vertical load increment dfz is used:
F z – F' z0
df z = -------------------- (5)
F' z0
with the possibly adapted nominal load (using the user-scaling factor, F z0 ):
Parameter
: Definition:
a= p Force at pure slip
q Moment at pure slip
r Force at combined slip
s Moment at combined slip
16 Adams/Tire
PAC MC
Parameter
: Definition:
i= B Stiffness factor
C Shape factor
D Peak value
E Curvature factor
K Slip stiffness = BCD
H Horizontal shift
V Vertical shift
s Moment at combined slip
t Transient tire behavior
j= x Along the longitudinal axis
y Along the lateral axis
z About the vertical axis
k = 1, 2, ...
Name used in
Name: tire property file: Explanation:
Fz0 LFZO Scale factor of nominal (rated) load
Cx LCX Scale factor of Fx shape factor
LMUX Scale factor of Fx peak friction coefficient
Ex LEX Scale factor of Fx curvature factor
Kx LKX Scale factor of Fx slip stiffness
Vx LVX Scale factor of Fx vertical shift
x LGAX Scale factor of camber for Fx
Cy LCY Scale factor of Fy shape factor
y LMUY Scale factor of Fy peak friction coefficient
Ey LEY Scale factor of Fy curvature factor
17
PAC MC
Name used in
Name: tire property file: Explanation:
Ky LKY Scale factor of Fy cornering stiffness
C LCC Scale factor of camber shape factor
K LKC Scale factor of camber stiffness (K-factor)
E LEC Scale factor of camber curvature factor
Hy LHY Scale factor of Fy horizontal shift
LGAY Scale factor of camber force stiffness
t LTR Scale factor of peak of pneumatic trail
Mr LRES Scale factor for offset of residual torque
gz LGAZ Scale factor of camber torque stiffness
Mx LMX Scale factor of overturning couple
VMx LVMX Scale factor of Mx vertical shift
My LMY Scale factor of rolling resistance torque
F x = F x0 F z (7)
x = + S Hx (9)
x = x (10)
C x = p Cx1 Cx (11)
Dx = x Fz 1 (12)
F x0
(K x = B x C x D x = at x = 0
x
Bx = Kx Cx Dx (16)
S Hx = – q sy1 F z My + S Vx K x (17)
y = + S Hy Cy + C 2 (21)
y = y (22)
with coefficients:
C y = p Cy1 Cy (23)
Dy = y Fz 2 (24)
Fz
K y = p Ky1 F zo sin p Ky2 arc tan ---------------------------------------------------------
- (27)
p Ky3 + p Ky4 y F zo Fzo
2
1 – p Ky5 y2 Fzo Ky
F yo
(K y = B y C y D y = at y = 0
y
By = Ky Cy Dy (28)
S Hy = p Hy1 Hy (29)
C = p Cy2 C (30)
F yo
K = p Ky6 + p Ky7 df z F z K (=B C D = at y = 0 (31)
E = p Ey5 E with E 1 (32)
B = K C D (33)
Name used in
Name: tire property file: Explanation:
pCy1 PCY1 Shape factor Cfy for lateral forces
pCy2 PCY2 Shape factor Cfc for camber forces
pDy1 PDY1 Lateral friction Muy
pDy2 PDY2 Exponent lateral friction Muy
pDy3 PDY3 Variation of friction Muy with squared camber
pEy1 PEY1 Lateral curvature Efy at Fznom
pEy2 PEY2 Variation of curvature Efy with camber squared
pEy3 PEY3 Asymmetric curvature Efy at Fznom
21
PAC MC
Name used in
Name: tire property file: Explanation:
pEy4 PEY4 Asymmetric curvature Efy with camber
pEy5 PEY5 Camber curvature Efc
pKy1 PKY1 Maximum value of stiffness Kfy/Fznom
pKy2 PKY2 Curvature of stiffness Kfy
pKy3 PKY3 Peak stiffness factor
pKy4 PKY4 Peak stiffness variation with camber squared
pKy5 PKY5 Lateral stiffness dependency with camber squared
pKy6 PKY6 Camber stiffness factor Kfc
pKy7 PKY7 Vertical load dependency of camber stiffness Kfc
pHy1 PHY1 Horizontal shift Shy at Fznom
M z0 = – t F y0 + M zr (34)
t = + S Ht (36)
r = + S Hr (38)
z = z (39)
with coefficients:
C t = q Cz1 (41)
2
1 + q Ez4 + q Ez5 z --- arc tan B t C t t with E t 1 (44)
S Ht = 0 (45)
B r = q Bz9 Ky y (46)
Kz = –t Ky – dM z at = 0 (49)
d
Aligning Moment Coefficients at Pure Slip
with G x the weighting function of the longitudinal force for pure slip.
We write:
s = + S Hx (52)
24 Adams/Tire
PAC MC
with coefficients:
C x = r Cx1 (54)
F xo
D x = ---------------------------------------------------------------------------------------------------------------------------------------------------------------- (55)
cos C x arc tan B x S Hx – E x B x S Hx – arc tan B x S Hx
with Gyk the weighting function for the lateral force at pure slip and SVyk the ‘ -induced' side force;
therefore, the lateral force can be written as:
s = + S Hyk (61)
C y = r Cy1 (63)
F yo
D y = ------------------------------------------------------------------------------------------------------------------------------------------------------------- (64)
cos C y arc tan B y S Hy – E y B y S Hy – arc tan B y S Hy
with:
t = t t eq (71)
Kx 2
t eq = arc tan tan t + ------ 2 sgn t
2
(76)
K y
Kx 2
r eq = arc tan tan r + ------ 2 sgn r
2
(77)
K y
Fy
M x = R 0 F z q sx1 VMx – q sx2 + q sx3 -------- Mx (78)
F z0
27
PAC MC
S Vx
c = + S Hx + --------
Kx
S Vy
c = + S Hy + --------
Ky
= sin c
28 Adams/Tire
PAC MC
c
= acos -------------------------
2 + 2
c
F x 0 – S Vx F y 0 – S Vy
x act = ------------------------ y act = ------------------------
Fz Fz
Dx Dy
x max = ------ y max = ------
Fz Fz
1
x = --------------------------------------------------------
1 2 tan 2
------------- + ---------------
x act y max
tan
y = --------------------------------------------------------
1 2 -------------
--------------- tan 2
x max + y act
x y
F x = ------------- F x 0 F y = ------------- F y 0
x act y act
For aligning moment Mx, rolling resistance My and aligning moment Mz the formulae are used with
S Vy =0.
For accurate transient tire behavior, you can use the "stretched string" tire model (see also reference [1]).
The tire belt is modeled as stretched string, which is supported to the rim with lateral (and longitudinal)
springs. The figure, Stretched String Model for Transient Tire Behavior, shows a top-view of the string
model. When rolling, the first point having contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string arises that depends on the slip angle size and the history of the
lateral deflection of previous points having contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid:
1 dv 1 -----
v1
----- + - = tan + a (80)
Vx d t
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential example cannot be used at zero speed, but when multiplying with Vx, the example
can be transformed to:
30 Adams/Tire
PAC MC
dv 1
+ V x v 1 = V sy (81)
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
A similar approach yields the following for the deflection of the string in longitudinal direction:
du 1
+ V x u 1 = – V sx (82)
dt
Both the longitudinal and lateral relaxation length are defined as of the vertical load:
Fz
= p Ty1 sin p Ty2 arc tan -------------------------------------------------------
- 1 – p Ky5 2 R 0 F (84)
p Ty3 + p Ky4 F z0 Fz0
2 z0
Now the practical slip quantities, ' and ' , are defined based on the tire deformation:
u1
' = ----- sin V x (85)
x
v1
' = atan ------ (86)
Using these practical slip quantities, ' and ' , the Magic Formula examples can be used to calculate
the tire-road interaction forces and moments:
dv
M z gyr = c gyr m belt V r1 cos arc tan B r r eq (90)
dt
with the parameters (in addition to the basic tire parameter mbelt):
and:
If this keyword is available, Adams/Car corrects for the conicity and plysteer and asymmetry when using
a tire property file on the opposite side of the vehicle. In fact, the tire characteristics are mirrored with
respect to slip angle zero.
In Adams/View this option can only be used when the tire is generated by the graphical user interface:
select Build -> Forces -> Special Force: Tire (see figure of dialog box below).
Next to the LEFT and RIGHT side option of TYRESIDE, you can also select SYMMETRIC: then the
tire characteristics are modified during initialization to show symmetric performance for left and right
side corners and zero conicity and plysteer (no offsets). Also, when you set the tire property file to
SYMMETRIC, the tire characteristics are changed to symmetric behavior.
33
PAC MC
PAC MC output
USE MODE: State: Slip conditions: (forces and moments)
0 Steady state Acts as a vertical spring and damper 0, 0, Fz, 0, 0, 0
1 Steady state Pure longitudinal slip Fx, 0, Fz, 0, My, 0
2 Steady state Pure lateral (cornering) slip 0, Fy, Fz, Mx, 0, Mz
3 Steady state Longitudinal and lateral (not combined) Fx, Fy, Fz, Mx, My, Mz
4 Steady state Combined slip Fx, Fy, Fz, Mx, My, Mz
11 Transient Pure longitudinal slip Fx, 0, Fz, 0, My, 0
12 Transient Pure lateral (cornering) slip 0, Fy, Fz, Mx, 0, Mz
13 Transient Longitudinal and lateral (not combined) Fx, Fy, Fz, Mx, My, Mz
14 Transient Combined slip Fx, Fy, Fz, Mx, My, Mz
Contact Methods
The PAC MC model supports the following roads:
• 2D Roads, see Using the 2D Road Model
• 3D Spline Roads, see Adams/3D Spline Road Model
By default the PAC-MC uses a one point of contact model similar to all the other Adams/Tire
Handling models. However the PAC-MC has an option to take the tire cross section shape into
account:
• 3D Shell Roads, see Adams/Tire 3D Shell Road Model
If the tire model reads a section called [SECTION_PROFILE_TABLE] in the tire property file, the cross
section profile will be taken into account for the vertical load calculation of the tire. The method assumes
that the tire deformation will not influence the position of the point with largest penetration (P), which is
valid for motor cycle tires.
The vertical tire load Fz is calculated using the penetration (effpen = ) of the tire through the tangent
road plane in the point C, see Figure above, according to:
·
Fz = Cz + Kz (94)
Because in this method the tangent to the cross section profile determines the point P, a high accuracy of
the cross section profile is required. The section height y as function of the tire width x must be a
continous and monotone increasing function. To avoid singularities and instability, it is highly
recommended to fit measured cross section data with a polynom (for example y = a·x2 + b·x4 + c·x6 + ..)
and provide the y cross section height data (y) from the polynom in the tire property file up to the
maximum width of the tire. The profile is assumed to be symmetric with respect to the wheel plane.
Note that the PAC MC model has only one point of contact with the road; therefore, the wavelength of
road obstacles must be longer than the tire radius for realistic output of the model. In addition, the contact
force computed by this tire model is normal to the road plane. Therefore, the contact point does not
generate a longitudinal force when rolling over a short obstacle, such as a cleat or pothole.
For ride and comfort analysis, we recommend more sophisticated tire models, such as Ftire.
Note: Do not change Fz0 (FNOMIN) and R0 (UNLOADED_RADIUS) in your tire property
file. It will change the complete tire characteristics because these two parameters are used
to make all parameters without dimension.
Effect of Positive Camber on the Lateral Force in TYDEX W-axis (ISO) System
If one of the input parameters exceeds a minimum or maximum validity value, the calculation in the tire
model will be performed with the minimum or maximum value of this range to avoid non-realistic tire
behavior. In that case, a message appears warning you that one of the inputs exceeds a validity value.
Definitions
• General
• Tire Kinematics
• Slip Quantities
• Force and Moments
General
General Definitions
Term: Definition:
Road tangent plane Plane with the normal unit vector (tangent to the road) in the tire-road contact
point C.
C-axis system Coordinate system mounted on the wheel carrier at the wheel center according to
TYDEX, ISO orientation.
Wheel plane The plane in the wheel center that is formed by the wheel when considered a rigid
disc with zero width.
Contact point C Contact point between tire and road, defined as the intersection of the wheel plane
and the projection of the wheel axis onto the road plane.
W-axis system Coordinate system at the tire contact point C, according to TYDEX, ISO
orientation.
Tire Kinematics
Tire Kinematics Definitions
Slip Quantities
Slip Quantities Definitions
References
1. H.B. Pacejka, Tyre and Vehicle Dynamics, 2002, Butterworth-Heinemann, ISBN 0 7506 5141 5.
2. H.-J. Unrau, J. Zamow, TYDEX-Format, Description and Reference Manual, Release 1.1,
Initiated by the International Tire Working Group, July 1995.
3. A. Riedel, Standard Tire Interface, Release 1.2, Initiated by the Tire Workgroup, June 1995.
41
PAC MC
4. J.J.M. van Oosten, H.-J. Unrau, G. Riedel, E. Bakker, TYDEX Workshop: Standardisation of
Data Exchange in Tyre Testing and Tyre Modelling, Proceedings of the 2nd International
Colloquium on Tyre Models for Vehicle Dynamics Analysis, Vehicle System Dynamics, Volume
27, Swets & Zeitlinger, Amsterdam/Lisse, 1996.
About 521-Tire
The 521-Tire model is a simple model that requires a small set of parameters or experimental data to
simulate the behavior of tires. The 521-Tire is the first tire model incorporated in Adams. The name
“521” (actually “5.2.1”) refers to the version number of Adams/Tire when it was first released.
The slip forces and moments can be calculated in two ways:
• Using the Equation method
• Using the Interpolation method
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity and the loaded rolling radius Rl:
V sx = V z – R 1
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point:
V sx V sy
= – ------- and tan = --------
Vx Vx
Note that for realistic tire forces the slip angle is limited to 90 degrees and the longitudinal slip in
between -1 (locked wheel) and 1.
stretched string, which is supported to the rim with lateral springs, the lateral deflection of the belt can
be estimated (see also reference [1]). The figure below shows a top-view of the string model.
Stretched String Model for Transient Tire Behavior
When rolling, the first point having contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string will arise that depends on the slip angle size and the history
of the lateral deflection of previous points having contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid during braking slip:
1 dv v1
-------1- + ------
----- = tan + a
V x dt
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
dv 1
-------- + V x v 1 = – V sx
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
A similar approach yields the following for the deflection of the string in longitudinal direction:
4 Adams/Tire
521-Tire Model
du 1
-------- + V x u 1 = – V sx
dt
Now the practical slip quantities, and are defined based on the tire deformation:
u1
' = ------ sin V x
v1
' = atan ------
These practical slip quantities and are used instead of the usual and definitions for steady-
state tire behavior.
The longitudinal and lateral relaxation length are read from the tire property file, see Tire Property File
521_equation.tir and 521_interpol.tir
Force Calculations
You can use the 521-Tire model for handling and durability analyses.
Directional Vectors for the Application of Tire Forces and Torques at the Center of the Tire-Road
Surface Contact Patch
5
521-Tire Model
The forces act along the directional vectors. From the tire spin vector and various information you supply
in the tire property and the road profile data files, Adams/Tire determines the positions and orientations
of the tire vertical, lateral, and longitudinal directional vectors. Figure 3 shows these directional vectors.
The tire vertical force acts along the vertical directional vector, the tire aligning torque acts about the
same vector, the tire lateral force acts along the lateral directional vector, and the tire longitudinal force
acts along the longitudinal directional vector. At this point, Adams/Tire determines the force directions
as if it were going to apply the tire aligning torque and all of the tire forces at the center of the tire-road
surface contact patch.
The tire-road surface contact patch may deflect laterally. Adams/Tire calculates the lateral deflection in
the direction (and with the sign) of the lateral force. The magnitude of the deflection is equal to the lateral
force divided by the tire lateral stiffness you provide in the tire property data file.
The tire vertical, lateral, and longitudinal forces are forces in the tire vertical, lateral, and longitudinal
directions (as determined at the tire-road surface contact patch). The tire aligning torque is a torque about
the tire vertical vector. The vehicle durability force has components in both the tire vertical and the tire
longitudinal directions.
Normal Force
The tire normal force Fz is calculated based on the tire deflection and radial velocity. A progressive spring
and linear damping constant are employed:
F z = F stiff – F damp
where Fstiff is tire stiffness force and Fdamp is tire damping force. The vertical stiffness force is calculated
from:
F stiff = K z
where Kz is the tire vertical stiffness, is tire deflection, and is the stiffness exponent. The tire
damping force is calculated from:
F damp = C z RadialVelocity
where Cz is the tire damping constant.
The damping constant is reduced for small tire deflections, which are below 5% of the unloaded tire
radius.
The tire vertical stiffness can also be described using a spline function (force versus deflection) in the
Adams dataset. The user array is used to switch between tire property file stiffness and spline stiffness.
If the first value in the user array is equal to '5215', the spline vertical stiffness is used. The second value
of the user array refers to the ID of the spline. The message, 'Using spline data for the vertical spring', is
shown in the message file. If the first value in the user array is not equal to '5215', the tire property file
stiffness is used.
6 Adams/Tire
521-Tire Model
! adams_view_name='spline_vertical_stiffness'
SPLINE/10
, X = -1,0,10,30
, Y = 0,0,2000,6000
!
! adams_view_name='wheel_user_array'
ARRAY/102
, NUM=5215,10
Another option for having a non-linear tire stiffness is to introduce a deflection-load table in the tire
property file in a section called [DEFLECTION_LOAD_CURVE]. See 521-Tire Tire and Road Property
Files on page 20. If a section called [DEFLECTION_LOAD_CURVE] exists, the load deflection
datapoints with a cubic spline for inter- and extrapolation are used for the calculation of the vertical force
of the tire.
Longitudinal Force
The tire longitudinal force Fx can have up to three contributions:
• Traction/braking force
• Rolling resistance force
• Durability force (in case of durability contact)
Traction/Braking Force
Traction force is developed if the vehicle is starting to move and a braking force if the vehicle is
beginning to stop. In either case, the absolute magnitude of the force is calculated from:
F x = F z
where the friction coefficient is a function of the longitudinal slip velocity Vsx in the contact patch.
Note that this is somewhat unusual, since all the other Handling tire models in Adams/Tire assume that
the longitudinal force Fx is a function of the slip ratio.
7
521-Tire Model
The curve as a function of longitudinal slip velocity is created using standard Adams STEP functions
(see body 4 on page 10). You have to specify two points on the curve to define this characteristic:
• The coordinates of the curve at static: (velocity static, static)
• The coordinates of the curve at dynamic: (velocity dynamic, dynamic)
The friction values may be available to you as function of slip ratio instead of slip velocity. Converting
Slip Ratio Data to Velocity Data on page 16 explains how the slip ratios can be converted to slip
velocities.
M y = coef rr F z
where coefrr is the rolling resistance coefficient that should be supplied in the tire property data file.
Durability Force
Durability force, sometimes known as radial planar force, is a special kind of tire vertical force. It is the
durability force that resists the action of road bumps. This force acts along the instantaneous vertical
directional vector calculated by Adams/Tire. The Adams/Tire durability tire forces are limited to two-
dimensional forces that lie in the plane of the tire and are directed toward the wheel-center marker.
8 Adams/Tire
521-Tire Model
Adams/Tire superimposes these forces upon any traction or lateral forces developed in the tire-road
surface interaction.
You must select the Equivalent Plane Method for generating these durability forces.
• Interpolation Method
• Equation Method
Interpolation Method
The AKIMA spline is employed to calculate Fy and Mz as a function of the slip angle , camber angle ,
and vertical load Fz. You should provide the data in the SAE axis system.
Note that the slip angle and vertical load Fz input for the force and moment calculation of Fx, Fy, Mx,
My, and Mz are limited to minimum and maximum values in the input to avoid unrealistic extrapolated
values.
Equation Method
The Equation Method uses the following equation to generate the lateral force Fy:
–K
F y = – stat F z 1 – e sign
where K denotes the tire cornering stiffness coefficient.
The aligning moment Mz is calculated using the pneumatic trail t according to:
Mz = –t Fy
while the pneumatic trails are calculated with half the contact length a:
1 –K
t = --- a e
3
2 2
a = R0 – R1
with R0 and Rl are, respectively, the unloaded and loaded tire radius.
Overturning Moment
In both methods, the overturning moment Mx calculation is based on the lateral tire force Fy, the lateral
tire stiffness Ky, and the vertical load:
9
521-Tire Model
Fy
M x = ------ F z
Ky
Tire Lateral Force as a Function of Slip Angle
Output:
• Adjusted longitudinal force Fx and lateral force Fy incorporates the reduction due to combined
slip:
k
• = acos -----------------------------
k 2 + sin 2
Friction coefficients:
10 Adams/Tire
521-Tire Model
Fx F y – F y = 0
x act = ----- y act = ------------------------------
Fz Fz
1 tan
x = ---------------------------------------------------- y = ---------------------------------------------------
1 2 -----------
------------- tan 2 1 2 -------------
---------- tan 2
+ +
x act stat stat y act
x y
F x comb = ------------- F x F y comb = ------------- F y + F y = 0
x act y act
Due to the lateral deflection of the tire patch, the aligning moment under combined slip conditions
increases by the effect of the longitudinal force Fx and the lateral tire stiffness Ky:
F y comb
M z comb = M z pure + F x comb ------------------
Ky
and the overturning moment uses the lateral force for combined slip:
F y comb
M x comb = ------------------ F z
Ky
Smoothing
When you indicate smoothing by setting the value of USE_MODE in the tire property file, Adams/Tire
smooths initial transients in the tire force over the first 0.1 seconds of the simulation. The longitudinal
force, lateral force, and aligning torque are multiplied by a cubic step function of time. (See STEP in the
Adams/Solver online help.)
• Longitudinal Force Fx = SFx.
• Lateral Force Fy = SFy
• Overturning moment torque Mx = SMz
• Aligning torque Mz = SMz
By selecting a value of USE_MODE between 1 and 4, smoothing and combined slip correction can be
switched on and off, as shown in Table 1. The smoothing time equals 0.1 seconds for these values of
USE-MODE.
a – f
= ------------------
f
where:
• = Slip ratio
• f = Free rolling rotational velocity (no slip)
• a = Actual rotational velocity
Kinematic relationships between translational and rotational velocities and the effective rolling radius
give:
V x – V sx
a = -------------------
Re
Vx
f = -----
Re
where:
V sx
= – -------
Vx
Therefore:
V sx = – V x
During testing for the coefficient of friction as a function of slip ratio, the longitudinal velocity Vx is held
constant. Therefore, you can obtain Vsx, the relative velocity of the contact patch with respect to the road
surface, from the test data curves for the static and dynamic values of friction.
Contact Methods
For handling analyses (which use a flat road surface profile), the 521-Tire model uses the point-follower
contact method. For durability analyses (which use uneven road surface profiles), the Equivalent Plane
Method yields the instantaneous tire radius directly, while finding the new road surface orientation
vector.
Both the deflected tire area and its centroid remain unchanged. The vector between the deflected area
centroid and the wheel-center marker then determines the orientation of the. vertical vector perpendicular
to the road surface.
The Equivalent Plane method is best suited for relatively large obstacles because it assumes the tire
encompasses the obstacle uniformly. In reality, the pneumatics and the bending stiffness of the tire
carcass prevent this. The result is an uneven pressure distribution and possibly gaps between the tire and
the road. If the obstacle is larger than the tire contact patch (such as a pothole or curb), the uniform
assumption is good. If the obstacle is much smaller than the tire patch, however (such as a tar strip or
expansion joint), the assumption is poor, and the Equivalent Plane method may greatly underestimate the
durability force.
Definition of Equivalent Plane Parameters
14 Adams/Tire
521-Tire Model
When using the Equivalent Plane method the following parameters need to be specified in the tire
property file:
Equivalent_plane_angle
Specifies the subtended angle (in degrees) bisected by the z-axis of the wheel-center marker, as shown
in Figure 7. This angle determines the extent of the road the tire can envelop. The value of the
equivalent_plane_angle must be between 0 and 180 degrees.
Equivalent_plane_increments
Specifies the number of increments into which the shadow of the tire subtended section is divided, as
shown in Figure 7.
The first two files are tire property files, and the last two are road files. The file 521_equation.tir
illustrates the required format and parameters when you use the Equation method. The file
521_interpol.tir illustrates the Interpolation method. The two *.rdf files show how road data files must
be specified when either of the contact methods is used.
521-equation.tir
The 521-equation.tir example tire property file starts here.
$--------------------------------------------------------MDI_HEADER
[MDI_HEADER]
FILE_TYPE = 'tir'
FILE_VERSION = 3.0
FILE_FORMAT = 'ASCII'
(COMMENTS)
{comment_string}
'Tire - XXXXXX'
'Pressure - XXXXXX'
'Test Date - XXXXXX'
'Test tire'
$-------------------------------------------------------------units
[UNITS]
LENGTH = 'mm'
FORCE = 'newton'
ANGLE = 'rad'
MASS = 'kg'
TIME = 'second'
$-------------------------------------------------------------model
[MODEL]
! use mode 123411121314
! -----------------------------------------------------------------
! smoothingXXXX
! combinedXXXX
! transient X X X X
!
PROPERTY_FILE_FORMAT = '5.2.1'
USE_MODE = 1
$----------------------------------------------------------dimension
[DIMENSION]
UNLOADED_RADIUS = 310.0
16 Adams/Tire
521-Tire Model
WIDTH = 195.0
ASPECT_RATIO = 0.70
RIM_RADIUS = 195,0
RIM_WIDTH = 139.7
$---------------------------------------------------------parameters
!
VERTICAL_FORCE_METHOD = EQUIVALENT_PLANE
LATERAL_FORCE_METHOD = EQUATION
!
vertical_stiffness = 206.0
vertical_stiffness_exponent = 1.1
vertical_damping = 2.06
!
lateral_stiffness = 50
cornering_stiffness_coefficient = 50
!
Mu_Static = 0.95
Mu_Dynamic = 0.75
Mu_Static_Velocity = 3000
Mu_Dynamic_Velocity = 6000
!
rolling_resistance_coefficient = 0.01
!
EQUIVALENT_PLANE_ANGLE= 100
EQUIVALENT_PLANE_INCREMENTS= 50
!
521_interpol.tir
The 521-interpol.tir example tire property file starts here. In addition to the file for 521_equation.tir, it
contains data that is used for calculating the lateral force and aligning moment, instead of using formula
6 to 9. Note that the [DEFLECTION_LOAD_CURVE] can also be used in the tire property file for the
Equation method.
$--------------------------------------------------------MDI_HEADER
[MDI_HEADER]
FILE_TYPE = 'tir'
FILE_VERSION = 3.0
FILE_FORMAT = 'ASCII'
(COMMENTS)
{comment_string}
'Tire - XXXXXX'
'Pressure - XXXXXX'
'Test Date - XXXXXX'
'Test tire'
$-------------------------------------------------------------units
[UNITS]
LENGTH = 'mm'
FORCE = 'newton'
ANGLE = 'rad'
MASS = 'kg'
TIME = 'second'
$--------------------------------------------------------------model
17
521-Tire Model
[MODEL]
! use mode 123411121314
! ----------------------------------------------------------------
! smoothingXXXX
! combinedXXXX
! transient X X X X
!
PROPERTY_FILE_FORMAT = '5.2.1'
USE_MODE = 1
$----------------------------------------------------------dimension
[DIMENSION]
UNLOADED_RADIUS = 310.0
WIDTH = 195.0
ASPECT_RATIO = 0.70
RIM_RADIUS = 195,0
RIM_WIDTH = 139.7
$---------------------------------------------------------parameters
!
VERTICAL_FORCE_METHOD = POINT_FOLLOWER ! or EQUIVALENT_PLANE
LATERAL_FORCE_METHOD = INTERPOLATION ! or EQUATION
!
vertical_stiffness = 206.0
vertical_stiffness_exponent = 1.1
vertical_damping = 2.06
lateral_stiffness = 50
cornering_stiffness_coefficient = 50
!
Mu_Static = 0.95
Mu_Dynamic = 0.75
Mu_Static_Velocity = 3000
Mu_Dynamic_Velocity = 6000
!
rolling_resistance_coefficient = 0.01
!
EQUIVALENT_PLANE_ANGLE= 100
EQUIVALENT_PLANE_INCREMENTS= 50
!
!------------------CAMBER ANGLE VALUES-------------------------------
-----------
! Conversion
! No. of pnts factor(D to R) pnt1 pnt2 pnt3 pnt4 pnt5
!
CAMBER_ANGLE_DATA_LIST
5 0.017453292 -3.0 0.0 3.0 6.0 10.0
!
!------------------SLIP ANGLE VALUES---------------------------------
-----------
! Conversion
! No. of pnts factor(D to R) pnt1 ...... pnt9
!
SLIP_ANGLE_DATA_LIST
9 0.017453292 -15.0 -10.0 -5.0
-2.5 0.0 2.5
5.0 10.0 15.0
18 Adams/Tire
521-Tire Model
!
!-----------------VERTICAL FORCE VALUES------------------------------
-----------
! Conversion
! No. of pnts factor
! pnt1 pnt2 pnt3 pnt4 pnt5
!
VERTICAL_FORCE_DATA_LIST
5 4.448
200.0 600.0 1100.0 1500.0 1900.0
!
!-----------------ALLIGNING TORQUE VALUES----------------------------
-----------
! No. of pnts Conversion
! factor
!
! pnt1 .... pnt225
!
ALIGNING_TORQUE_DATA_LIST
225 -1355.7504
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity , and the effective rolling radius Re:
V sx = V x – R e
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point:
V sx V sy
= – ------- and tan = --------
Vx Vx
When the UA Tire is used for the force calculation the slip quantities during positive Vsx (driving) are
defined as:
V sx V sy
= – ------- and tan = --------
Vr Vr
The rolling speed Vr is determined using the effective rolling radius Re:
Vr = Re
Note that for realistic tire forces the slip angle is limited to 45 degrees and the longitudinal slip Ss
(= ) in between -1 (locked wheel) and 1.
When rolling, the first point having contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string will arise that depends on the slip angle size and the history
of the lateral deflection of previous points having contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid during braking slip:
1 dv 1 -----
v1
----- + - = tan + a
Vx d t
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
dv 1
+ V x v 1 = V sy
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
When the UA Tire is used for the force calculations, at positive Vsx (traction) the Vx should be replaced
by Vr in these differential equations.
5
Using the UA-Tire Model
A similar approach yields the following for the deflection of the string in longitudinal direction:
du 1
-------- + V x u 1 = – V sx
dt
Now the practical slip quantities, ’ and ’, are defined based on the tire deformation:
u1
' = ------ – k Vlow x V sx sin V x
v1
' = atan ------ – k Vlow y V sy
These practical slip quantities ' and ' are used instead of the usual and definitions for steady-
state tire behavior. kVlow_x and kVlow_y are the damping rates at low speed applied below the
LOW_SPEED_THRESHOLD speed. For the LOW_SPEED_DAMPING parameter in the tire property
file yields:
kVlow_x= 100 · kVlow_y= LOW_SPEED_DAMPING
Note: If the tire property file's REL_LEN_LON or REL_LEN_LAT = 0, then steady-state tire
behavior is calculated as tire response on change of the slip and .
Normal Force
The normal force Fz is calculated assuming a linear spring (stiffness: kz ) and damper (damping constant
cz ), so the next equation holds:
·
Fz = kz + cz
·
If the tire loses contact with the road, the tire deflection and deflection velocity become zero so the
resulting normal force Fz will also be zero. For very small positive tire deflections the value of the
damping constant is reduced and care is taken to ensure that the normal force Fz will not become
negative.
In stead of the linear vertical tire stiffness cz , also an arbitrary tire deflection - load curve can be defined
in the tire property file in the section [DEFLECTION_LOAD_CURVE], see also the Property File
Format Example. If a section called [DEFLECTION_LOAD_CURVE] exists, the load deflection
datapoints with a cubic spline for inter- and extrapolation are used for the calculation of the vertical force
of the tire. Note that you must specify VERTICAL_STIFFNESS in the tire property file but it does not
play any role.
Slip Ratios
For the calculation of the slip forces and moments a number of slip ratios will be introduced:
7
Using the UA-Tire Model
Ss =
Where is limited to be within the range -1 to 1.
tan during braking
S * =
1 – S tan
s during traction
S = min 1.0 S *
The lateral slip ratio due to inclination angle, S, is defined as:
S = sin
A combined lateral slip ratio due to slip and inclination angles, S, is defined as:
sin -
tan – l----------- during braking
*
2r l
S =
sin -
1 – S tan l-----------
s 2r l during traction
S = min 1.0 S
*
*
S s = S s2 + S
2
Friction Coefficient
The resultant friction coefficient between the tire tread base and the terrain surface is determined as a
function of the resultant slip ratio (Ss) and friction parameters (Umax and Umin ). The friction
parameters are experimentally obtained data representing the kinematic property between the surfaces of
tire tread and the terrain.
A linear relationship between Ss and , the corresponding road-tire friction coefficient, is assumed.
The figure below depicts this relationship.
Linear Tire-Terrain Friction Model
The friction circle concept allows for different values of longitudinal and lateral friction coefficients ( x
and y ) but limits the maximum value for both coefficients to . See the figure below.
9
Using the UA-Tire Model
2
2
-----x + -----y = 1
Ss S
cos = ---------
*
- and sin = ---------
*
-
S s S s
10 Adams/Tire
Using the UA-Tire Model
• Case 1: 0
• Case 2: 0 and C S C S
• Case 3: 0 and C S C S
• Forces and moments at the contact point
The lateral force F can be decomposed into two components: F and F. The two components are in
the same direction if * < 0 and in opposite direction if * > 0.
Case 1. < 0
Before computing the longitudinal force, the lateral force, and the self-aligning torque, some slip
parameters and a modified lateral friction coefficient should be determined. If a slip ratio due to the
critical inclination angle is denoted by S c , then it can be evaluated as:
Fz
S c = ------
C
If Ssc represents a slip ratio due to the critical (longitudinal) slip ratio, then it can be evaluated as:
Fz
S sc = 3 -----
Cs
If a slip ratio due to the critical slip angle is denoted by S c , then it can be determined as:
Cs S
2 – S 2 – 3C ------
S c = ------- S sc -
C s C
when S s S sc .
The term critical stands for the maximum value which allows an elastic deformation of a tire during pure
slip due to pure slip ratio, slip angle, or inclination angle. Whenever any slip ratio becomes greater than
its corresponding critical value, an elastic deformation no longer exists, but instead complete sliding state
represents the contact condition between the tire tread base and the terrain surface.
A nondimensional slip ratio Sn is determined as:
11
Using the UA-Tire Model
B 2 + B 22 – B 1 B 3
S n = -----------------------------------------
B1
where:
B 1 = 3F z 2 – 3C S 2
B 2 = 2C S C S
B3 = – Cs Ss 2 + C S 2
A nondimensional contact patch length is determined as:
ln = 1 – Sn
C S
ym = y – -----------
Fz
In the elastic deformation state, the longitudinal force F , the lateral force F , and three components
of the self-aligning torque are written as functions of the elastic stiffness and the slip ratio as well as the
normal force and the friction coefficients, such as:
12 Adams/Tire
Using the UA-Tire Model
F = C s S s l n2 + x F z 1 – 3l n2 + 2l n3
F = C S s l n2 + ym F z 1 – 3l n2 + 2l n3 + C S
1 2 3
M z = C S – --- + --- l n + --- ym F z S n2 ll n2
2 3 2
2--- 3 x y F z2
M zs = C s S s S l n + --------------------- 1 – 10l n3 + 15l n4 – 6l n5
3
3 5C
M zs = F
where:
• = S r l2 – l' 2 4 is the offset between the wheel plane center and the tire tread base.
M z is the portion of the self-aligning torque generated by the slip angle . M zs and M zs are other
components of the self-aligning torque produced by the longitudinal force, which has an offset between
and the inclination angle ,
the wheel center plane and the tire tread base, due to the slip angle
respectively. The self-aligning torque Mz is determined as combinations of M z , M zs and M zs .
F = x Fz
F = y Fz
M z = 0
3 x y F z2 l
M zs = -----------------------
5C
M zs = F
Case 2: 0 and C S C S
As in Case 1, a slip ratio due to the critical value of the slip ratio can be obtained as:
Fz
S sc = 3 -----
Cs
A slip ratio due to the critical value of the slip angle can be found as:
Cs S
2 – S 2 + 3C ------
S c = ------- S sc
C s C -
when S s S sc .
The nondimensional slip ratio Sn, is determined as:
B 2 + B 22 – B 1 B 3
S n = -----------------------------------------
B1
where:
14 Adams/Tire
Using the UA-Tire Model
B 1 = 3F z 2 – 3C S 2
B2 = –3 C S C S
B3 = – Cs Ss 2 + C S 2
The nondimensional contact patch length ln is found from the equation ln = 1 - Sn, and the modified
lateral friction coefficient ym is expressed as:
C S
ym = y + -----------
Fz
For the longitudinal force, the lateral force and the self-aligning torque two subcases should also be
considered separately. A slip ratio due to the critical value of the inclination angle is not needed here since
the required condition for Case 2, C S C S , replaces the critical condition of the inclination angle.
F = C s S s l n2 + x F z 1 – 3l n2 + 2l n3
F = C S s l n2 + ym F z 1 – 3l n2 + 2l n3 + C S
1 2 3
M z = C S – --- + --- l n + --- ym F z S n2 ll n2
2 3 2
2 3 x y F z2
M zs = --- C s S s S l n3 + --------------------- 1 – 10l n3 + 15l n4 – 6l n5
3 5C
M zs = F
F = x Fz
F = y Fz
M z = 0
3 x y F z2 l
M zs = -----------------------
5C
M zs = F
Case 3: 0 and C S C S
Similar to Cases 1 and 2, slip ratios due to the critical values of the inclination angle and the slip ratio are
obtained as:
3F z + C S
S c = --------------------------------
3C
1 2
S sc = ----- 3F z 2 – C S – 3C S
Cs
The nondimensional slip ratio Sn, is expressed as:
B 2 + B 22 – B 1 B 3
S n = -----------------------------------------
B1
where:
B 1 = 3F z 2 – 3C S 2
B2 = –3 C S C S
B3 = – Cs Ss 2 + C S 2
16 Adams/Tire
Using the UA-Tire Model
For the longitudinal force, the lateral force, and the self-aligning torque, two subcases should also be
considered similar to Cases 1 and 2. A slip ratio due to the critical value of the slip angle is not needed
here since the required condition for Case 3, C S C S , replaces the critical condition of the slip
angle.
F = C s S s l n2 + x F z 1 – 3l n2 + 2l n3
F = C S 3l n2 + 2l n3 – C S l n2 + y F z 1 – 3l n2 + 2l n3
l
C S n
M z = -------------------
6
2 3 x y F z2
M zs = --- C s S s S l n3 + --------------------- 1 – 10l n3 + 15l n4 – 6l n5
3 5C
M zs = F
In the complete sliding state, F , F , M z , M zs , and M zs can be determined by using:
17
Using the UA-Tire Model
F = x Fz
F = y Fz
M z = 0
3 x y F z2 l
M zs = -----------------------
5C
M zs = F
respectively. The longitudinal force F , the lateral force F , and three components of the self-aligning
torques, M z , M zs , and M zs , always have positive values, but they can be transformed to have
positive or negative values depending on the slip ratio s, the slip angle , and the inclination angle in
the SAE coordinate system.
For example, suppose your tire has a radius of 300 mm and a width of 185 mm and that the tread is joined
to the side wall with a fillet of 12.5 mm radius. The tread then begins to curve to meet the side wall at
>+/- 80 mm from the wheel center plane. If you define the shape table using six points with four points
19
Using the UA-Tire Model
along the fillet, the resulting table might look like the shape block that is at the end of the property format
example (see SHAPE).
1.0 0.4
1.0 0.6
1.0 0.8
0.9 1.0
$---------------------------------------------------------load_curve
$ For a non-linear tire vertical stiffness (optional)
$ Maximum of 100 points
[DEFLECTION_LOAD_CURVE]
{pen fz}
0.000 0.0
0.001 212.0
0.002 428.0
0.003 648.0
0.005 1100.0
0.010 2300.0
0.020 5000.0
0.030 8100.0
Contact Methods
The UA-Tire Model supports the following roads
• 2D roads, see Using the 2D Road Model.
• 3D Splie roads, see Adams/3D Spline Road Model
The UA-Tire Model uses a one point of contact method; therefore, the wavelength of road
obstacles must be longer than the tire radius for realistic output of the model.
• 3D Shell roads, see Adams/Tire 3D Shell Road Model
Using the Soft-Soil tire model
The Adams/Tire Soft Soil tire model offers a basic model to describe the tire-soil interaction forces for
any tire on elastic/plastic grounds, such as sand, clay, loam and snow.
The model requires a tire property file with keyword SOFT-SOIL and a road data file (one of the existing
formats) with additional soil properties. Two tire-soil contact models are offered:
• Elastic-plastic soil deformation model, USE_MODE = 1
• Visco-elastic soil deformation model, USE_MODE = 2
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity and the the effective rolling radius Re:
V sx = V z – R e (1)
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y (2)
The slip quantities (longitudinal slip) and (slip angle) are calculated with these slip velocities in the
contact point, for negative Vsx they are defined as:
V sx V sy
= – ------- and tan = -------- (3)
Vx Vx
2 Adams/Tire
Using the Soft-Soil tire model
V sx V sy
= – ------- and tan = -------- (4)
Vr Vr
Vr is the rolling speed Vr is determined using the effective rolling radius Re: Vr Re (5)
Note that for realistic tire forces the slip angle is limited to 90 degrees and the longitudinal slip
to 1.
Rl R0 f 0
(6)
The effective rolling radius Re (at free rolling of the tire), which is used to calculate the rotational speed
of the tire, is defined by:
Vx
Re
(7)
Using the Soft-Soil tire model 3
Definition of Tire Slip Quantities
For radial tires, the effective rolling radius is rather independent of load in its load range of operation
because of the high stiffness of the tire belt circumference. Only at low loads does the effective tire radius
decrease with increasing vertical load due to the tire tread thickness, see the Figure 2.
Figure 2 Effective and loaded tire radius as a function of the vertical load
4 Adams/Tire
Using the Soft-Soil tire model
To represent the effective rolling radius Re, a PAC2002 compatible equation is used:
in which f 0 ,Fz 0 is the nominal tire deflection at the nominal tire load Fz0:
Fz 0
f 0 ,Fz 0
Cz
(9)
f0
f 0d
f 0 ,Fz 0
(10)
p( h ) ( kc / b k )h n
(11)
in which kc and k are the cohesive and frictional moduli respectively, n the sinkage exponent. The
static stress p is in equilibrium with the vertical force Fz.
When applying this approach to a non-rolling wheel the static stress distribution can be estimated as
shown in the Figure 5
For the dynamic sinkage the wheel rotational speed must be taken into account.
Using the Soft-Soil tire model 7
Elastic-plastic tire-soil contact
Assume a wheel soil contact with entry angle f and exit angle r , see also [2], then these angles
can be written as a function of the total sinkage h and the exit penetration he as follows:
f acos( 1 h / R )
r acos( 1 he / R )
(12)
The exit penetration he depends on the elastic stiffness Cs of the soil.
8 Adams/Tire
Using the Soft-Soil tire model
Based on the terramechanical approach as described in [2] the normal and shear stresses can be modeled
as shown in the Figure 7.
The wheel normal stress distribution can be defined as function of the wheel angle [2,3]:
for m f :
Using the Soft-Soil tire model 9
Elastic-plastic tire-soil contact
k
( ) R0n c k cos( ) cos( f ) n
b (13)
for r m :
n
k r
( ) R0n c k cos f ( f m ) cos( f )
b m r
The angle m is the angle at which the maximum normal stress occurs [4]:
m ( a0 a1 ) f
(14)
The shear stress [5,6] in longitudinal direction is:
x ( ) ( c ( ) tan( ))( 1 e jx ( ) / k x )
(15)
and in lateral direction yields:
jy ( ) / k y
y ( ) ( c ( ) tan( ))( 1 e )
(16)
In equations 15 and 16 c represents the cohesion stress of the soil, the friction angle of the soil and kx
and ky the shear deformation moduli. Assuming that the wheel has a longitudinal slip , the longitudinal
shear displacement along the contact area jx in equation 16 can be estimated [5,6] by using the
longitudinal slip and wheel radius R0:
Similar the lateral shear displacement jy will depend on the slip angle and the wheel radius R0:
j y ( ) R0 ( 1 )( f ) tan( )
(18)
10 Adams/Tire
Using the Soft-Soil tire model
k x k x 0 k x1
(19)
and the lateral shear deformation modulus ky:
k y k y 0 k y1
Having the normal and shear stress for the rotating wheel, the tire-soil interaction contact forces and
moments can be calculated:
• Longitudinal force:
Using the Soft-Soil tire model 11
Elastic-plastic tire-soil contact
f
Fx bR { x ( ) cos( ) ( ) sin( )}d
r (20)
• Lateral force:
f
Fy bR y ( )d
r (21)
• Vertical load:
f
Fz bR { x ( ) sin( ) ( ) sin( )}d
r (22)
• Overturning moment:
Mx 0 (23)
f
f
y ( ) sin( )d
2
M z bR
r (25)
Tire deformation
In order to take the tire deflection into account the substitution circle approach is taken as was suggested
by Bekker [7]:
12 Adams/Tire
Using the Soft-Soil tire model
At a certain penetration of the tire into the soil the tire deflection and sinkage can be determined by an
iteration process based on the fact that the vertical tire force and the force due to the sinkage must be
equal.
The tire force can be calculated with the tire stiffness Cz and tire deflection f0 by:
Fz ,tire C z f 0 (26)
while the tire sinkage force is defined by equation (22), however, replacing the unloaded tire radius R0
by the radius of the substitution circle R*.
Bekker [7] derived following relation in between the tire deflection f0 and tire sinkage h:
Using the Soft-Soil tire model 13
Elastic-plastic tire-soil contact
R* f f0
1 0
R0 h h (27)
( m )
he
Cs (28)
Multi-pass effect
When a tire has passed a certain spot of soil, a second tire will experience different soil properties when
rolling over that spot due to the plastic deformation of the soil by the first tire.
Therefore this Soft Soil tire model stores the elastic and plastic deformation of each tire as a function of
the contact point x,y coordinates. When a tire passes a point with plastic deformation caused by a
previous tire, the normal pressure calculation will account for the plastic deformation history.
Figure 10 explains the mechanism applied in this tire model [8]:
Assume two tires rolling after each other over the same spot of soil. The first tire will have a total
deformation h1 existing of a plastic part hp1 and an elastic part he1. When a second tire passes the same
spot, the soil will first have an elastic deformation from A to B (= he1) and then continue to follow the
normal pressure characteristic to point C. The plastic deformation of the second tire hp2 will be equal to
the total deformation h2 subtracted with the elastic deformation he2.
14 Adams/Tire
Using the Soft-Soil tire model
Note: The tire model stores the x, y coordinates, the elastic and plastic deformation and tire width
of each tire. Because of the one-point of contact approach used in this Soft-Soil tire model,
the total stored plastic deformation will be applied for a next tire when its contact point
comes into the rut of a previous tire.
Figure 11 Three element Maxwell model for a rigid wheel on visco-elastic soil
For this model the normal stress in the contact in between tire and ground is:
x x
A
G GVT VxTr
( x ) 1 ( x 2A x 2 ) 2 x r ( x A VxTr )1 e xA x
2 R0 R0
(29)
With
xa R0 sin( f )
x R0 sin( )
Tr / G2
In which
Tr is the relaxation time
The longitudinal and lateral shear stresses are calculated using the equations 15 until and including 19 as
used for the elastic-plastic tire-soil model. Similar for the tire-ground interaction forces equation (20 -
24) are used.
For the multi-pass effect, the road deformation at the exit of the tire-soil contact (point B) and the time
of deformation occurrence is stored. When a second tire passes the same spot, the road deformation
corrected with the relaxation effect is taken to correct the road height input.
References:
1. Bekker, M.G., Off-the-road-locomotion, Ann Arbor, The University of Michigan Press, 1960.
2. G. Ishigami, A. Miwa, K. Nagatani, K. Yoshida, Terramechanics - Based Model for Steering
Maneuver of Planetary Exploration Rovers on Loose Soil, Journal of Field robotics 24(3), 233-
250 (2007), Wiley Periodicals, Inc.
3. Yoshida, K., Watanabe, T., Mizuna, N., Ishigami, G., Terramechanics - based analysis and
traction control of a lunar/planetary rover. In Proceedings of the Int. Conf. Of Field and Service
Robotics (FSR '03), Yamanashi, Japan.
4. Wong, J.Y., Reece, A., Prediction of rigid wheel performance based on the analysis of soil-wheel
stresses part I, performance driving rigid wheels, Journal of Terramechanics, 4, 81-98.
5. Janosi, Z. Hanamoto, B., The analytical determination of drawbar pull as a function of slip for
tracked vehicle in deformable soils, In proceedings of the 1st Int. conf. on Terrain-Vehicle
systems, Torino, Italy.
6. Wong, J.Y., Theory of Ground Vehicles, John Wiley & Sons, Inc., second edition, 1993.
7. Bekker, M.G., Introduction to terrain-vehicle systems, Ann Arbor, The University of Michigan
Press, 1969.
8. AS2TM User's Guide, version 1.12, AESCO GbR, Hamburg.
9. S. Wanjii, T. Hiroma, Y. Ota, T. Kataoka, Predicition of Wheel Performance by Analysis of
Normal and Tangential Stress Distributions under the Wheel-Soil Interface, Journal of
Terramechanics, Vol. 34, No. 3, pp. 165-186, 1997.
10. Schmid, I.C., Interaction of Vehicle and Terrain Results from 10 Years Research at IKK, Journal
of Terramechanics, Vol. 32, No. 1, pp. 3-26, 1995.
11. Schmid, I.C., Aubel, Th., Der elastische Reifen auf nachgiebiger Fahrbahn - Rechenmodell im
Hinblick auf Reifendruckregelung, VDI Berichte nr. 916, 1991.
12. Faßbender, F., Simulation der Vertikaldynamik von Fahrzeugen auf Geländeböden mit STINA -
SOIL TIRE INTERFACE TO ADAMS einem Zusatzmodul für das Mehrkörperprogramm
ADAMS. Number 521 in Fortschritt-Berichte VDI Reihe 12. VDI Verlag, Düsseldorf, 2002.
Dissertation Universität der Bundeswehr Hamburg.
Using the Soft-Soil tire model 17
Feature and property overview of the Adams/Tire Soft Soil Tire model
Example of the tire property file for the Soft-Soil Tire model:
$----------------------------------------------------------MDI_HEADER
[MDI_HEADER]
FILE_TYPE = 'tir'
FILE_VERSION = 2.0
FILE_FORMAT = 'ASCII'
(COMMENTS)
{comment_string}
'Tire - XXXXXX'
'Pressure - XXXXXX'
'Test Date - XXXXXX'
'Test tire'
'New File Format v2.1'
$---------------------------------------------------------------units
18 Adams/Tire
Using the Soft-Soil tire model
[UNITS]
LENGTH = 'mm'
FORCE = 'newton'
ANGLE = 'degree'
MASS = 'kg'
TIME = 'sec'
$---------------------------------------------------------------model
! use mode 1 2
! --------------------------------------------------------------
! flexible wheel/tire with elastic-plastic road X
! rigid wheel/tire with visco-elastic road X
!
PROPERTY_FILE_FORMAT = 'SOFT-SOIL'
USE_MODE = 1.0
$-----------------------------------------------------------dimension
[DIMENSION]
UNLOADED_RADIUS = 309.9
WIDTH = 235.0
ASPECT_RATIO = 0.45
$-----------------------------------------------------------parameter
[PARAMETER]
NOMINAL_TIRE_LOAD = 4000
VERTICAL_STIFFNESS = 310.0
VERTICAL_DAMPING = 0.5
ROLLING_RESISTANCE = 0.01
BREFF = 8.4
DREFF = 0.27
FREFF = 0.07
$---------------------------------------------------------------shape
[SHAPE]
{radial width}
1.0 0.0
1.0 0.2
1.0 0.4
1.0 0.5
1.0 0.6
1.0 0.7
1.0 0.8
1.0 0.85
1.0 0.9
0.9 1.0
$----------------------------------------------------------load_curve
$ For a non-linear tire vertical stiffness
$ Maximum of 100 points
[DEFLECTION_LOAD_CURVE]
{pen fz}
0 0.0
1.0 212.0
2.0 428.0
3.0 648.0
5.0 1100.0
10.0 2300.0
20.0 5000.0
30.0 8100.0
Using the Soft-Soil tire model 19
Example of the required Soil properties in the Road Data File:
$-----------------------------------------------------SOIL_PROPERTIES
[SOIL_PROPERTIES]
FRICTION_ANGLE = 37.2 $units: degree
COHESION_STRESS = 8.0E-4 $units: N/mm**2
SOIL_DEFORM_MOD_KX0 = 43.0 $units: mm
SOIL_DEFORM_MOD_KX1 = 0.6283 $units: mm/deg
SOIL_DEFORM_MOD_KY0 = 20.0 $units: mm
SOIL_DEFORM_MOD_KY1 = 0.2269 $units: mm/deg
!visco-elastic tire:
ELASTIC_MODULUS_G1 = 0.071E-3 $units: N/mm**3
ELASTIC_MODULUS_G2 = 1.072E-3 $units: N/mm**3
SOIL_VISCOSITY = 7.14E-3 $units: Ns/mm**3
!plastic-elastic tire:
PRESSURE_SINKAGE_KC = 1.37E-3 $units: N/mm**(n+1)
PRESSURE_SINKAGE_KFI = 8.14E-4 $units: N/mm**(n+2)
SINKAGE_EXPONENT = 1 $units: = n
SOIL_INTERACTION_A0 = 0.4 $units: -
SOIL_INTERACTION_A1 = 0.15 $units: -
SOIL_STIFFNESS = 8.14E-3 $units: N/mm**3
Symbols
Fy lateral force
Fz vertical load
Fz0 nominal tire load
h sinkage
he elastic deformation
hp plastic deformation
kc cohesive modulus
frictional modulus
k
kx soil deformation modulus
ky soil deformation modulus
Mx overturning moment
My rolling resistance moment
Mz aligning moment
n sinkage component
p static stress
Re effective rolling radius
R0 unloaded (free) tire/wheel radius
Rl tire loaded radius
R* radius of substitution circle
Tr relaxation time
V total tire/wheel speed
Vr tire rolling velocity
Vx tire/wheel forward speed (parallel to wheel plane)
Vsx longitudinal slip speed
Vsy lateral slip speed
slip angle
longitudinal slip
friction angle
normal stress
wheel angle
wheel soil entry angle
f
This help describes the Flexible Ring Tire Model (FTire)™, as it is invoked from Adams.
© Michael Gipser, Cosin Consulting
About FTire
The tire model, FTire (Flexible ring tire model), is a sophisticated tire force element. You can use it in
MBS-models for vehicle-ride comfort investigations and other vehicle dynamics simulations on even or
uneven roadways.
2 Adams/Tire
Using FTire Tire Model
In contrast to other tire models, FTire does not need any complicated road data preprocessing. Rather, it
takes and resolves road irregularities, and even extremely high and sharp-edged obstacles, just as they
are defined.
We recommend that you visit www.ftire.com, to learn more about FTire theory, validation, data supply,
and application. Also, at the FTire Web site, you will be kept informed about the latest FTire
improvements, and how to receive them. In the download section, you will find a set of auxiliary
programs, called FTire/tools for Windows™. These tools help to analyze and parameterize an FTire
3
Using FTire Tire Model
Model. FTire/tools is free for FTire licensees. It comprises static, steady-date, and modal analysis,
linearization, data estimation, identification and validation tools, road data visualization, and more. In the
site's documentation section, you will find a more detailed and permanently updated FTire
documentation, together with as some additional literature.
Modeling Approach
FTire uses the following modeling approach:
• The tire belt is described as an extensible and flexible ring carrying bending stiffnesses,
elastically founded on the rim by distributed, partially dynamic stiffnesses in radial, tangential,
and lateral directions. The degrees of freedom of the ring are such that rim in-plane as well as
out-of-plane movements are possible. The ring is numerically approximated by a finite number
of discrete masses, the belt elements. These belt elements are coupled with their direct neighbors
by stiff springs and by bending stiffnesses both in-plane and out-of-plane.
Belt In-Plane and Out-Of-Plane Bending Stiffness outlines in-plane and out-of-plane bending
stiffness placing. In-plane bending stiffness is realized by means of torsional springs about the
lateral axis. The torsional deflection of these springs is determined by the angle between three
consecutive belt elements, projected onto the rim mid-plane. Similarly, the out-of-plane bending
stiffness is described by means of torsional springs about the radial axis. Here, the torsional
deflection is determined by the angle between three consecutive belt elements, projected onto the
belt tangential plane. Note that in the figure, the yellow plates do not represent the belt elements
themselves, but rather the connecting lines between the elements.
• FTire calculates all stiffnesses, bending stiffnesses, and damping factors during preprocessing,
fitting the prescribed modal properties (see list of data below).
4 Adams/Tire
Using FTire Tire Model
• A number of massless tread blocks (5 to 50, for example) are associated with every belt element.
These blocks carry nonlinear stiffness and damping properties in the radial, tangential, and
lateral direction. The radial deflections of the blocks depend on the road profile, focus, and
orientation of the associated belt elements. FTire determines tangential and lateral deflections
using the sliding velocity on the ground and the local values of the sliding coefficient. The latter
depends on ground pressure and sliding velocity.
Note: Radial, tangential, and lateral are relative to the orientation of the belt element,
whereas sliding velocity is the block end-point velocity projected onto the road
profile tangent plane. By polynomial interpolation, certain precautions have been
taken not to let the ground pressure distribution mirror the polygonal shape of the
belt chain.
• FTire calculates all six components of tire forces and moments acting on the rim by integrating
the forces in the elastic foundation of the belt.
Because of this modeling approach, the resulting overall tire model is accurate up to relatively high
frequencies both in longitudinal and in lateral directions. There are few restrictions in its applicability
with respect to longitudinal, lateral, and vertical vehicle dynamics situations. FTire deals with large-
and/or short-wave-length obstacles. It works out of, and up to, a complete standstill, with no additional
computing effort nor any model switching. Finally, it is applicable with high accuracy in such delicate
simulations as ABS braking on extremely uneven roadways, and so on.
In a full 3D variant, FTire additionally takes into account belt element rotation and bending about the
circumferential axis. These new degrees of freedom enable FTire to use contact elements that are
distributed not only along a single line, but over the whole contact patch. You can choose the arrangement
of the contact elements to be either randomly distributed, or distributed along several parallel lines.
In the full 3D variant, belt torsion about the circumferential axis is described by:
• Torsional stiffnesses between belt elements and rim, about circumferential axis (represented by
red torsion springs in the left side of the figure, Belt).
• Torsional stiffnesses between adjacent belt elements, about circumferential axis (represented by
blue torsion springs in the left side of figure, Belt).
The right side of the figure, Belt outlines the belt bending stiffness about the circumferential axis. This
is done in a somewhat simplified manner. Actually, lateral belt bending is taken into account by
introducing a parabolic shape function for each belt element. The curvature of this shape function is
treated as a belt elements’ additional degree of freedom.
5
Using FTire Tire Model
Belt Torsional and Twisting Stiffness, and Belt Lateral Bending Stiffness
You should chose the full 3D variant, which takes about 30% more computing time, in situations where
a considerable excitation of tire vibrations in lateral direction is expected. This, for example, will happen
when the tire runs over cleats that are placed in an oblique direction relative to the tire rolling direction.
Similarly, such an excitation will happen when the tire is running over obstacles with large camber angle.
Optionally, FTire can take into account tire non-uniformity, that is, a harmonic variation of vertical or
longitudinal stiffness, as well as static and dynamic imbalance, conicity, ply-steer, and geometrical run-
out.
All stiffness values may depend on the actual inflation pressure. To take full advantage of that option, it
is necessary to provide basic FTire input data, such as radial stiffness data and natural frequencies at two
different pressure values. Actual inflation pressure is one of the ‘operating conditions variables,’ which
can be made time-dependent, and therefore, can be changed even during a simulation.
There are two more operating conditions: tread depth and model level. The latter signal allows you to
switch between the reduced variant of FTire (all contact elements are arranged in one single line near the
rim mid-plane), and the full 3D variant (contact elements cover the whole contact patch).
The kernel of the FTire implementation is an implicit integration algorithm (BDF) that calculates the belt
shape. The integrator runs parallel but synchronized with the Adams main integrator. By using this
specialized implicit BDF integrator, you can choose the belt extensibility so it is extremely small. This
also allows the simulation of an inextensible belt without any numerical drawbacks.
FTire Parameters
• About FTire Parameters
• Procedure for Parameterizing FTire
• Listing of FTire Parameters
For convenience, FTire tries to use data that can be measured as easy as possible. As a consequence, the
number of basic data might be larger than the number of internal parameters defined by these basic
parameters.
For example, the following four parameters together, after preprocessing, actually result in only two
values used in FTire: compression and shear stiffness of the idealized blocks that represent tread rubber:
• tread_depth
• tread_base_height
• stiffness_tread_rubber
• tread_positive
Also, sometimes different combinations of parameters are possible. This is true especially for data of the
second group, which determine the structural stiffness and damping properties of FTire. Your choice of
which combination of parameters to supply depends on the types of measurements that are available and
their accuracy.
Moreover, it is possible to prescribe over-determined subsets of parameters. For example, you may define
the belt in-plane bending stiffness by prescribing the frequency of the first bending mode, and at the same
time the radial stiffness on a transversal cleat. Both parameters are strongly influenced by the bending
stiffness, but might contradict each other.
In such a case, FTire automatically recognizes that the system of equations to be solved is over-
determined, and applies an appropriate solver (Householder QR factorization) to determine the solution
in the sense of least squares fit. That means, FTire is looking for a compromise to meet both conditions
as much as possible. Users can control the compromise by optionally defining weights for the
contradicting conditions.
8 Adams/Tire
Using FTire Tire Model
Note that, among others, FTire uses modal data to calculate internal structural stiffness and damping
coefficients. They are processed in such a way that the mathematical model, for small excitations, shows
exactly the measured behavior in the frequency domain. FTire is not a modal model, nor is it linear.
First Six Vibration Modes Of An Unloaded Tire With Fixed Rim
When parametrizing FTire, the bending mode frequencies rather sensitively influence the respective
bending stiffness. As an alternative, determining the radial stiffness both on a flat surface and on a short
obstacle (cleat) is an inexpensive and very accurate way to get both the vertical stiffness between belt
nodes and rim and the in-plane bending stiffness.
Other ways to determine the bending stiffness (and other data, as well) are to use the software tools
FTire/fit (time- and frequency-domain parameter identification) and FTire/estim (qualified parameter
estimation by comparison with a reference tire). For more information, see www.ftire.com.
Unfortunately, there is no direct analogy of the ‘radial stiffness on cleat’ measuring procedure to get the
out-of-plane bending stiffness. But this parameter does not seem to be as relevant as the in-plane bending
stiffness for ride comfort and durability. An indirect, but also very accurate, way to validate the out-of-
plane bending stiffness is to check resulting side-force and self-aligning characteristic. The cornering
stiffness, the pneumatic trail, as well as the difference between maximum side force and side force for
very large side-slip angles, are very sensitively determined both by the tread rubber friction characteristic
and by the out-of-plane bending stiffness. Similarly, the fourth mode (see figure, First Six Vibration
Modes Of An Unloaded Tire With Fixed Rim), being itself determined by the stiffness between belt nodes
and rim in lateral direction, very strongly influences the side-slip angle where maximum side force
occurs.
• Tread depth
• Rubber height over steel belt
• Shore-A stiffness or Young's modulus of tread rubber
• Tread pattern positive
2. Determine the natural frequencies and damping moduli of the first six modes, for an unloaded,
inflated tire, where the rim is fixed. Normally, you do this by exciting the tire structure with an
impulse hammer, measuring the time histories of at least four acceleration sensors in all three
directions, distributed along the tire circumference, and processing these using an FFT signal
analyzer. Optionally, repeat this step for a second inflation pressure value.
3. Determine the tire radial stiffness on a flat surface and on a short obstacle, for one or two inflation
pressure value(s).
4. Determine (or estimate) the lateral belt curvature radius from the unloaded tire's cross-section.
Determine the belt lateral bending stiffness to get a reasonable pressure distribution in the lateral
direction.
5. Determine (or estimate) tread rubber adhesion and sliding friction coefficients for ground
pressure values 0.5 bar, 2 bar, and 10 bar.
6. Take natural frequencies and damping moduli of modes 1, 2, and 4, together with the radial
stiffness on flat surface and on a cleat, for one or two inflation pressure value(s), as well as the
remaining basic data. These values result in a first, complete FTire input file for the basic variant
(belt circumferential rotation, twisting, and bending not taken in to account; all contact elements
are arranged in one line).
7. Let FTire preprocess these data. Compare the resulting additional modal properties of the model
with the modal data that are not used so far (modes 3, 5, and 6). If necessary, adjust the
preprocessed data to find a compromise with respect to accuracy.
8. If respective measurements are available, validate the data determined so far by means of side
force and aligning torque characteristics, and by measurements of vertical and longitudinal
force variations induced during rolling over cleats both with low and high speed. The validation
can be extended to a full parameter fitting procedure by using TIRE/fit, as mentioned earlier.
9. Estimate the following additional data that are only relevant for 'out-of-plane' excitation:
• Belt element torsional stiffness relative to rim (represented by red torsion springs between
yellow belt elements and gray rim in the figure, Belt)
• Belt twisting stiffness (represented by blue torsion springs between adjacent yellow belt
elements in the figure, Belt)
• Belt bending stiffness/damping about circumferential direction
• Belt lateral curvature radius
• Coupling coefficient between belt lateral displacement and belt rotation.
Start with the respective values of the sample data file. Then, adjust the values by fitting the model's
response to obliquely oriented cleats and handling characteristics for large camber angles at the same
time. This identification procedure can be made easier by using the the additional tool FTire/fit.
10 Adams/Tire
Using FTire Tire Model
Clearly, the performance of this procedure is not very easy in practice. On the other hand, every tire
model that is accurate enough for ride comfort and durability calculations will need as much or even more
data.
stat_wheel_load_at_10mm_defl and
stat_wheel_load_at_20mm_defl
Note: You can equally define:
stat_wheel_load_at_20mm_defl and
stat_wheel_load_at_40mm_defl.
Note: This will better fit typical operating conditions of truck
tires. For extremely heavy vehicles, there are even more
pairs of deflection values predefined. These can be
found at the extended documentation at www.ftire.com.
dynamical_stiffening Increase of the overall radial stiffness at high speed as compared
to radial stiffness during standstill. Unit is %.
speed_at_half_dyn_stiffening Running speed at which dynamic stiffening reaches half of the
final value.
belt_extension_at_200_kmh Percentage of rolling circumference growth at a running speed of
200 km/h = 55.55 m/s = 124.3 mph, compared to low speed.
interior_volume Interior tire volume when the tire is mounted on the rim and
inflated with inflation_pressure.
Note: This parameter is only needed if you specify the next
parameter (volume_gradient) and it is nonzero.
volume_gradient Relative decrease in volume, of a small tire segment, when that
segment is deflected vertically.
Note: This parameter is optional and only marginally affects
the model’s behavior.
rel_long_belt_memb_tension The percentage by which inflation pressure forces in the belt
region are compensated with membrane tension in longitudinal
direction, as compared to the total compensation in lateral and
longitudinal direction.
Note: This parameter is optional, and can only be calculated
using a finite-element (FE) model, or estimated by
parameter identification. A value of 70 to 80% seems to
be appropriate for many tires. The value will increase
with increasing belt lateral curvature radius.
12 Adams/Tire
Using FTire Tire Model
• 0 = Euler explicit
• 0.5 = Trapezoidal rule
• 1 = Euler implicit
Theoretically, every value between 0 and 1 are allowed. 0.505 or
greater is recommended.
This preprocessed data file is a copy of the original one; the preprocessed data are appended after the
bottom line, using a hexadecimal, space-saving coding. In contrast to earlier versions of FTire, it is
possible to use this file for parameter changes instead of the original one.
You should, of course, not change the hexadecimal data but only the readable part of the file. The
hexadecimal section does not only contain the preprocessed data, but a copy of the original one, as well.
Moreover, it carries coded information about the FTire version that was used for creation.
This information helps to automatically determine whether or not an update of the preprocessed data is
required. This means that whenever you change some basic data or you download a new FTire version,
preprocessing will be repeated automatically, and the preprocessed data file saved in your current
working directory. You can (and should) replace the FTire data file in your database with this one, without
any loss of information.
From www.ftire.com, you can download a tool (being a member of FTire/tools) to carry out preprocessing
outside of Adams.
The FTire interface routine automatically recognizes whether several wheels of the car share the same
basic data file. In that case, preprocessing is done only once for all these files. Also, FTire automatically
recognizes whether the data file contains basic parameters or pre-processed ones.
FTire does not use the data in the section [VERTICAL]. It is only included for compatibility with other
tire models. It is recommended that you set Vertical_Stiffness to the value of
stat_wheel_load_at_10_mm_defl, after dividing by 10 mm. For Vertical_Damping, choose 0 (or a small
nonzero value). The actual vertical damping of FTire is not just one single value, but will depend on
rolling speed, inflation pressure, load, camber, and so on.
The following is an examples of a basic FTire data file. Note that by far not all possible data are defined.
For examples, only data for one inflation pressure are provided.
$--------------------------------------------------------MDI_HEADER
[MDI_HEADER]
FILE_TYPE = 'tir'
FILE_VERSION = 4.0
FILE_FORMAT = 'ASCII'
(COMMENTS)
{comment_string}
'Tire Manufacturer - unknown'
'Tire Type - unknown'
'Tire Dimension - 195/65 R 15'
'Pressure - 2.0 bar'
'File Generation Date - 03/03/11 10:32'
$-------------------------------------------------------------SHAPE
[SHAPE]
{radial width}
1.0 0.0
1.0 0.4
1.0 0.9
0.9 1.0
$-------------------------------------------------------------UNITS
[UNITS]
FORCE = 'NEWTON'
20 Adams/Tire
Using FTire Tire Model
MASS = 'GRAM'
LENGTH = 'MM'
TIME = 'MILLISECOND'
ANGLE = 'DEGREE'
$---------------------------------------------------------DIMENSION
[DIMENSION]
UNLOADED_RADIUS = 326.0 $ [mm]
$----------------------------------------------------------VERTICAL
[VERTICAL]
VERTICAL_STIFFNESS = 170.0 $ [N/mm]
VERTICAL_DAMPING = 0.0 $ [Nms/mm]
$-------------------------------------------------------------MODEL
[MODEL]
PROPERTY_FILE_FORMAT = 'FTIRE' $
separate_animation = 0 $ [0/1]
additional_output_file = 0 $ [0/1]
verbose = 0 $ [0/1]
$----------------------------------------------OPERATING_CONDITIONS
[OPERATING_CONDITIONS]
inflation_pressure = 2.0 $ [bar]
tread_depth = 8.0 $ [m]
model_level = 7 $ [-]
$---------------------------------------------------------PARAMETER
[FTIRE_DATA]
$basic data and geometry *******************************************
tire_section_width = 195 $ [mm]
tire_aspect_ratio = 65 $ [%]
rim_diameter = 381 $ [mm]
rim_width = 152.4 $ [mm]
load_index = 91 $ [-]
rolling_circumference = 1975 $ [mm]
tread_lat_curvature_radius = 800 $ [mm]
tread_width = 160 $ [mm]
tire_mass = 9000 $ [g]
interior_volume = 0.03e9 $ [mm^3]
volume_gradient = 1.0 $ [%/mm]
belt_torsion_lat_displ_coupl = 0.0 $ [deg/mm]
$
$static and modal data for 1st infl. pressure ***********************
stat_wheel_load_at_10_mm_defl = 1690 $ [N]
stat_wheel_load_at_20_mm_defl = 3600 $ [N]
dynamic_stiffening = 20 $ [%]
speed_at_half_dyn_stiffening = 5.55 $ [mm/ms]=[m/s]
radial_hysteretic_stiffening = 0 $ [%]
radial_hysteresis_force = 0 $ [N]
tang_hysteretic_stiffening = 0 $ [%]
tang_hysteresis_force = 0 $ [N]
belt_extension_at_200_kmh = 1.0 $ [%]
rel_long_belt_memb_tension = 82.0 $ [%]
$
f1 = 62.1 $ in-plane rotat. [Hz]
f2 = 81.4 $ in-plane transl. [Hz]
f4 = 80.0 $ out-of-plane rotat. [Hz]
$
21
Using FTire Tire Model
If no constant value is found, FTire looks for a table that is defining data points for operating condition
versus time. These data points then will be piecewise linearly interpolated with respect to simulation
time.
You enter such look-up tables as subsections of the section [OPERATING_CONDITIONS]. These
subsections can each contain up to 200 data pairs, one pair per line. Every data pair consists of a value
for time and a corresponding value for the operating condition. Units are the same as for constant values.
Similarly as for constant values, tables which are valid for all tires, or individual tables for each instance
are allowed.
The names of these table subsections, with obvious meanings, are:
• (TIME_TABLE_INFLATION_PRESSURE)
• (TIME_TABLE_INFLATION_PRESSURE_WHEEL_ i)
• (TIME_TABLE_TREAD_DEPTH)
• (TIME_TABLE_TREAD_DEPTH_WHEEL_ i)
• (TIME_TABLE_MODEL_LEVEL)
• (TIME_TABLE_MODEL_LEVEL_WHEEL_ i)
The following examples defines a sudden pressure loss (between 5 and 5.2 s of simulation time) in tire
with GFORCE ID 2. In addition, it specifies constant inflation pressure (2.2 bar) for the other tires, and
a certain, equal and constant extreme tread wear (0.1 mm every100 s) for all tires. Model level is chosen
to be the full 3D variant for all tires at any time:
$-----------------------------------------------OPERATING_CONDITIONS
[OPERATING_CONDITIONS]
24 Adams/Tire
Using FTire Tire Model
MODEL_LEVEL = 7
INFLATION_PRESSURE_WHEEL_1 = 2.2
INFLATION_PRESSURE_WHEEL_3 = 2.2
INFLATION_PRESSURE_WHEEL_4 = 2.2
(TIME_TABLE_TREAD_DEPTH)
0 8.0
100 7.9
(TIME_TABLE_INFLATION_PRESSURE_WHEEL_2)
0 2.2
5 2.2
5.2 1.2
Note: If you use the preprocessed data file in subsequent simulations, don't forget to copy the
[operating_conditions] section from the basic data file manually into the preprocessed data
file. This is not done automatically, because tire operating conditions are not considered to
be part of the tire data.
Using Aircraft Tire Models
About Axis Systems and Sign Conventions
Symbol Description
Slip Angle. The angle formed between the direction of travel of the tire contact patch
center and the x'-axis. is positive if the wheel travel direction has a component in
the +y'-direction. This produces a negative Lateral force (Fy). Note that the steer
angle, or the vehicle attitude angle, plays no part in defining the slip angle.
Inclination Angle. The angle formed between the x'-z' plane and the wheel plane.
Inclination angle is positive if the wheel plane has a component lying in the +y'-
direction.
Fx Longitudinal Force. The x'-component of the resultant force acting on the tire by the
road.
Fy Lateral Force. The y'-component of the resultant force acting on the tire by the road.
Lateral Force may be produced by slip angle, inclination angle, conicity, plysteer, or
any combination of the above.
Fz Normal Force. The z'-component of the resultant force acting on the tire by the road.
The direction of this force is up, but this nomenclature requires that Fz be negative
whenever the tire is in contact with the road, as the positive z'-axis is directed
downward.
Mx Overturning Moment. The moment of the forces at the contact patch acting on the
tire by the road with respect to the x'-axis.
My Rolling Resistance Moment. The moment of the forces at the contact patch acting
on the tire by the road with respect to the y'-axis.
Mz Aligning Torque. The moment of the forces at the contact patch acting on the tire by
the road with respect to the z'-axis.
Spin Axis The axis about which the wheel rotates. Perpendicular to the Wheel Plane, not
necessarily about the y'-axis (only if inclination angle is zero).
Spin Velocity The angular velocity of the wheel on which the tire is mounted, about its spin axis.
( )
T Wheel Torque. The external torque applied from the vehicle about the spin axis of
the wheel.
Vertical Load The normal reaction of the tire on the road which is equal to the negative of Normal
Force. This is always a positive quantity when the tire is in contact with the road,
otherwise it is zero.
Wheel Plane The central plane of the tire and wheel, normal to the wheel spin axis.
+x' Direction of wheel heading along ground. The intersection of the wheel plane and
the road plane in the neighborhood of the Tire Axis System origin. This is not the
same as the direction in which the wheel is traveling. If the tire reverses its direction,
the axis system flips 180 degrees about the z'-axis.
4 Adams/Tire
Using Aircraft Tire Models
Symbol Description
+y' To the right along the ground, as viewed from behind a forward rolling tire. Chosen
to be Right-Hand Orthogonal to the definitions of x' and z'.
+z' Perpendicular to the road in the neighborhood of the Tire Axis System origin with
positive direction down. (If the road is flat and in the x-y plane, this is negative
Global Z.)
Tire Packages
The following table summarizes the capabilities associated with the Adams tire packages:
*The formulas used in the Pacejka’89, ’94 and 2002 tire models are derived from publications by Dr.
H.B. Pacejka, and are commonly referred to as the Pacejka method in the automotive industry. Dr.
Pacejka himself is not personally associated with the development of these tire models, nor does he
endorse them in any way.
To perform most aircraft simulations in Adams, the Aircraft Basic Tire package is required, at a
minimum, and is already included with Adams/Tire. The PAC2002 model can be of interest for more
accurate parking and scrubbing effects at low speeds and short turning radii, while its more accurate
dynamic tire modeling offers better tire response for spinning-up and shimmy analyses. FTire can handle
all high-frequency tire response and driving over short wavelength obstacles (shorter then the tire
circumference). It can deal with inflation pressure changes and requires a more physical parameter input.
6 Adams/Tire
Using Aircraft Tire Models
In general, the Aircraft Tire models are valid on rather smooth roads only: the wavelength of road
obstacles should not be smaller than the tire circumference. If the wavelengths are shorter, you should
use the FTire model to cope with the non-linear tire enveloping effects.
The Aircraft Tire models can describe the first-order response of a tire, but do not take the
eigenfrequencies of the tire itself into account. Therefore, these tire models are valid up to approximately
8 Hz. PAC2002 is valid up to approximately 15Hz. Beyond that, a tire model should be used, including
modeling the tire belt, as FTire does.
Overview
Assumptions
• Single contact point with the road profile.
• Disk representation of wheel and tire.
• No lateral, longitudinal, and twist deformation effects on tire center moments.
• First-order lag on longitudinal and lateral slip.
Inputs
The inputs to the Aircraft Basic Tire Model come from two sources:
• Input parameters from the tire property file (.tir), such as tire undeflected radius, that the tire
references.
• Tire states, given through the tire interface with the solver, such as slip angle ( ).
The following table summarizes the input data from the tire property file (.tir) that the Aircraft Basic Tire
Model requires.
8 Adams/Tire
Using Aircraft Tire Models
Parameters: Description:
[UNITS] block: LENGTH Units of length for all tire property file values that involve
length units.
Parameters: Description:
WIDTH Tire's maximum undeflected (or unloaded) width. In simple
geometry graphics, WIDTH represents the tread width, for
visualization purposes only. In computations, however,
WIDTH represents the tire's maximum undeflected width.
(Units: length.)
ASPECT_RATIO Ratio of "rim-to-tread distance" to WIDTH. Used only for tire
geometry graphics. (Units: none.)
BOTTOMING_RADIUS Wheel bottoming radius. (Units: length.)
(optional)
See Wheel Bottoming.
VERTICAL_DAMPING Vertical tire damping force coefficient. (Units:
force/(length/time).)
Parameters: Description:
UMAX Coefficient of friction at zero slip. (Units: none.)
omit the [SHAPE] block from a tire property file, the tire carcass cross-section defaults to the rectangle
that the tire radius and width define.
You specify the tire carcass shape by entering points in fractions of the tire radius and width. Because
Adams/Tire assumes that the tire cross-section is symmetrical about the wheel plane, you only specify
points for half the width of the tire. The following apply:
• For width, a value of zero (0) lies in the wheel center plane.
• For width, a value of one (1) lies in the plane of the sidewall.
• For radius, a value of one (1) lies on the tread.
Wheel Bottoming
You can optionally supply a wheel bottoming deflection - load curve in the tire property file in the
[BOTTOMING_CURVE] block. If the deflection of the wheel is so large that the rim will be hit (defined
by the BOTTOMING_RADIUS parameter in the [DIMENSION] section of the tire property file), the
tire vertical load will be increased according to the load curve defined in this section.
Note: The rim-to-road contact algorithm is a simple penetration method (such as the 2D contact)
based upon the tire-to-road contact calculation, which is strictly valid only for rather
smooth road surfaces (the length of obstacles should have a wavelength longer than the tire
circumference). The rim-to-road contact algorithm is not based on the 3D volume
penetration method, but can be used in combination with the 3D Contact (that takes into
account the volume penetration of the tire itself). If you omit the [BOTTOMING_CURVE]
block from a tire property file, no force due to rim road contact will be added to the tire
vertical force.
Wheel Bottoming 13
Using Aircraft Tire Models
The BOTTOMING_RADIUS may be chosen larger than the rim radius to account for the tire's material
left in between the rim and the road, while the bottoming load-deflection curve may be adjusted for the
change in stiffness.
If (Pentire- (Rtire - Rbottom) - ½ width · | tan( ) |) < 0 the left or right side of the rim has contact with the
road. Then the rim deflection Penrim can be calculated with:
with Srim the lateral offset of the force with respect to the wheel plane.
If the full rim has contact with the road, the rim deflection is
14 Adams/Tire
Using Aircraft Tire Models
Using the load - deflection curve defined in the [BOTTOMING_CURVE] section of the tire property file,
the additional vertical force due to the bottoming is calculated, while Srim multiplied by the sign of the
inclination is used to calculate the contribution of the bottoming force to the overturning moment.
Further, the increase of the total wheel load Fz due to the bottoming (Fzrim) will not be taken into account
in the calculation for Fx, Fy, My and Mz. The Fzrim will only contribute to the overtuning moment Mx
using the Fzrim· Srim.
Note: Rtire is equal to the unloaded tire radius, Pentire is similar to effpen.
• Fzk is the normal force due to the tire radial load-deflection curve
• Fzk = - f (effpen, tire load-deflection spline)
• Fzc is the normal force due to tire vertical damping
• Fzc = - VERTICAL_DAMPING x Vpen
• Fzrim is the normal force due to bottoming of the wheel
The normal penetration (effpen, or ) and penetration velocity (Vpen) are obtained from the appropriate
road contact model.
Vyc = Y-component of R
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity , and the effective rolling radius Re:
V sx = V x – R e
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point with:
V sx
= --------
Vx
V sy
tan = --------
Vr
The rolling speed Vr is determined using the effective rolling radius Re:
Handling Forces of Road on Tire 17
Using Aircraft Tire Models
Vr = Re
Note that for realistic tire forces the slip angle is limited to 45 deg and the longitudinal slip S s =
in between -1 (locked wheel) and 1.
When rolling, the first point that has contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string forms that depends on the slip angle size and the history of
the lateral deflection of previous points that had contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid:
1 dv v1
-------1- + ------
----- = tan + a
V x dt
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
18 Adams/Tire
Using Aircraft Tire Models
dv 1
-------- + V x v 1 = V sy
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
A similar approach yields the following for the deflection of the string in the longitudinal direction:
du 1
-------- + V x u 1 = – V sx
dt
Now the practical slip quantities, ' , and ' , are defined based on the tire deformation:
U1
' = ------ – k Vlow x V sx sign V x
V1
' = atan ------ – k Vlow y V sy
These practical slip quantities, ' , and ' , are used instead of the usual and definitions for steady
state tire behavior. kVlow_x and kVlow_y are the damping rates at low speed applied below the
LOW_SPEED_THRESHOLD speed. The LOW_SPEED_DAMPING parameter in the tire property file
yields:
kVlow_x = 100 · kVlow_y = LOW_SPEED_DAMPING
and are the relaxation lengths for the lateral and longitudinal direction, respectively, in the
Aircraft tire models = = RLEN = RELAXATION_LENGTH.
The above stretched string model approach results in a tire behavior that can be compared to a spring (the
force response depends on deflection) at zero speed, while during rolling the tire will act like a damper
(the force response depends on slip speeds). When the wheel starts rolling (spinning up), low damped
wheel rotation oscillations may occur which may be not realistic. The LOW_SPEED_DAMPING
parameter can be used to increase the damping in such cases.
Note: If the tire property file's RELAXATION_LENGTH = 0, then steady state tire behavior will
be calculated is instantaneous response on change of slip and .
Longitudinal Force
Fx = 0
Handling Forces of Road on Tire 19
Using Aircraft Tire Models
Lateral Force
Fy = 0
Oversteering Moment
Tx = 0
Aligning Moment
Tz = 0
Additional Parameters
Before calculating the current maximum available friction coefficient, the Fiala tire model requires the
evaluation of some additional variables. First is the comprehensive slip S*s :
Friction Models
You can choose from four friction models. The friction mode parameter within the tire property file is
used to select the friction model. The friction model ultimately computes the maximum available
comprehensive friction coefficient.
• Slip Ratio-based Friction Model A (Linear U-Slip)
• Slip (or Scrub) Velocity-based Friction Decay Model A
• Slip (or Scrub) Velocity-based Friction Decay Model B
• Slip Ratio based Model B (User-Defined Mu-Slip)
20 Adams/Tire
Using Aircraft Tire Models
A linear relationship between Ss and U( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Note: The figure illustrates that the available friction coefficient, U, varies linearly with slip ratio,
but the actual curve of Fx/Fz is not linear, as described in Longitudinal Force.
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Notice that Umin is not used in this friction model. Also, notice the effect of V_UREF upon the decay of
the available friction coefficient with total slip (or scrub) velocity Vsxy:
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
parameters are experimentally obtained data representing the kinematic property between the surfaces of
tire tread and the terrain.
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed (AGARD-R-800 "The Design, Qualification and Maintenance of Vibration-Free
Landing Gear": Denti, E., Fanteria D., "Analysis and Control of the Flexible Dynamics of Landing Gear
in the Presence of Antiskid Control Systems" (1996)). The following figure shows this relationship.
Umax – Umin
U = Umin + Umax – Umin Umin + -------------------------------------------
V sxy
1 + --------------------------- -
V UREF
Notice the effect of V_UREF on the decay of the available friction coefficient with total slip (or scrub)
velocity Vsxy:
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
Handling Forces of Road on Tire 23
Using Aircraft Tire Models
The following figure shows the relationship between Ss and U ( ), the corresponding maximum
available road-tire friction coefficient.
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
UF Z
S_critical = ------------------------------
-
2 CSLIP
This is the value of longitudinal slip beyond which the tire is sliding.
Case 1. Elastic Deformation State:|Ss| < S_critical
Fx = -CSLIP x Ss
Fx = -sign(Ss)(Fx1-Fx2)
where:
• Fx1 = U x Fz
2
U FZ
• F X 2 = ---------------------------------------------
-
4 S S CSLIP
The calculations of Fx can be used to calculate Fx/Fz, which can be contrasted to the available total
coefficient of friction (U) curves shown above. All of the above figures are plots of U, but they are not
the plots of Fx/Fz. The U curves show the maximum possible friction coefficient, but the actual
longitudinal force, while based on U, is modified by the rolling characteristics of the tire.
For example, consider the plot of Linear Tire-Terrain Friction Model. The coefficient of friction is a
straight line. Consider next the following figure based on the equations for Fx shown in Case 1 and Case
2 above. The following figure, created using arbitrarily chosen parameters, illustrates that Fx/Fz is less
than the value of U at every value of slip, Ss . The actual Fx/Fz curve is a function of the U curve, CSLIP,
and tire vertical force, Fz.
Handling Forces of Road on Tire 25
Using Aircraft Tire Models
This type of difference between the chosen U curve and Fx/Fz affects all four friction models. You should
keep this in mind when creating your tire property file. Also, after you run a simulation, such as a braking
or wheel test simulation, you can plot Fx/Fz to determine whether the friction values are what you require.
Lateral Force
Like the longitudinal force, the lateral force depends on the vertical force (Fz) and the current coefficient
of friction (U). And similar to the longitudinal force calculation, Fiala defines a critical lateral slip
(Alpha_critical):
3 U FZ
Alpha_critical = arctan ----------------------------
-
CALPHA
The lateral force peaks at a value equal to U x |Fz| when the slip angle (Alpha) equals the critical slip
angle (Alpha_critical).
Oversteering Moment
Tx = 0
Aligning Moment
3
T Z = 2 U F Z WIDTH 1 – H H sign Alpha
Force Reducer
In a balancing simulation, you can switch on the force reducer by using the tire user array. If the first
element reads the value 1500 and the second 1, the force reducer is switched on. Except for the vertical
load Fz, all tire forces and moments are reduced drastically to reach airplane equilibrium in a more
efficient way.
Fx = Fx * FORCE_REDUCER_X
Fy = Fy * FORCE_REDUCER_Y
Mx = Mx * FORCE_REDUCER_Y
My = My * FORCE_REDUCER_X
Mx = Mz* FORCE_REDUCER_Y
FORCE_REDUCER_X = 0.01
FORCE_REDUCER_Y = 0.0
• Wheel Bottoming
• Normal Force of Road on Tire
• Handling Forces of Road on Tire
Overview
Assumptions
• Single contact point with the road profile.
• Disk representation of wheel and tire.
• User-controlled lateral and longitudinal deformation (vertical center of pressure shift) effects on
tire center moments.
• First-order lag on longitudinal and lateral slip.
Inputs
The inputs to the Aircraft Enhanced Tire Model come from two sources:
• Input parameters from the tire property file (.tir), such as tire undeflected radius, that the tire
references.
• Tire states, given through the tire interface with the solver, such as slip angle ( ).
The following table summarizes the input data from the tire property file (.tir) that theAircraft Enhanced
Tire Model requires.
Parameters: Description:
[UNITS] block: LENGTH Units of length for all tire property file values that involve
length units.
Parameters: Description:
[UNITS] block: MASS Units of mass for all tire property file values that involve mass
units.
Parameters: Description:
BOTTOMING_RADIUS Wheel bottoming radius. (Units: length.)
(optional)
See Wheel Bottoming.
VERTICAL_DAMPING Vertical tire damping force coefficient. (Units:
force/(length/time).)
Parameters: Description:
UMIN Coefficient of friction when tire is sliding. Not used if
FRICTION_MODE = 2. (Units: none.)
Parameters: Description:
[LON_STIFFNESS] block: lon_k Column of tire longitudinal stiffness values, corresponding to
the adjacent tire vertical load value. (Units: force/length.)
[LAT_STIFFNESS] block: fz Column of tire vertical load values, corresponding to the
adjacent lateral stiffness value. (Units: force.)
[LAT_STIFFNESS] block: lat_k Column of tire lateral stiffness values, corresponding to the
adjacent tire vertical load value. (Units: force/length.)
[SHAPE] block: radial Column of tire radial scale values, corresponding to the
(optional) adjacent tire width station value. This value is multiplied with
UNLOADED RADIUS. (Units: none.)
Wheel Bottoming
You can optionally supply a wheel bottoming deflection - load curve in the tire property file in the
[BOTTOMING_CURVE] block. If the deflection of the wheel is so large that the rim will be hit (defined
by the BOTTOMING_RADIUS parameter in the [DIMENSION] section of the tire property file), the
tire vertical load will be increased according to the load curve defined in this section.
Note: The rim-to-road contact algorithm is a simple penetration method (such as the 2D contact)
based upon the tire-to-road contact calculation, which is strictly valid only for rather
smooth road surfaces (the length of obstacles should have a wavelength longer than the tire
circumference). The rim-to-road contact algorithm is not based on the 3D volume
penetration method, but can be used in combination with the 3D Contact (that takes into
account the volume penetration of the tire itself). If you omit the [BOTTOMING_CURVE]
block from a tire property file, no force due to rim road contact will be added to the tire
vertical force.
34 Adams/Tire
Using Aircraft Tire Models
The BOTTOMING_RADIUS may be chosen larger than the rim radius to account for the tire's material
left in between the rim and the road, while the bottoming load-deflection curve may be adjusted for the
change in stiffness.
If (Pentire- (Rtire - Rbottom) - ½ width · | tan( ) |) < 0 the left or right side of the rim has contact with the
road. Then the rim deflection Penrim can be calculated with:
with Srim the lateral offset of the force with respect to the wheel plane.
If the full rim has contact with the road, the rim deflection is
Normal Force of Road on Tire 35
Using Aircraft Tire Models
Using the load - deflection curve defined in the [BOTTOMING_CURVE] section of the tire property file,
the additional vertical force due to the bottoming is calculated, while Srim multiplied by the sign of the
inclination is used to calculate the contribution of the bottoming force to the overturning moment.
Further, the increase of the total wheel load Fz due to the bottoming (Fzrim) will not be taken into account
in the calculation for Fx, Fy, My and Mz. The Fzrim will only contribute to the overtuning moment Mx
using the Fzrim· Srim.
Note: Rtire is equal to the unloaded tire radius, Pentire is similar to effpen.
• Fzk is the normal force due to the tire radial load-deflection curve
• Fzk = - f (effpen, tire load-deflection spline)
• Fzc is the normal force due to tire vertical damping
• Fzc = - VERTICAL_DAMPING x Vpen
• Fzrim is the normal force due to bottoming of the wheel
The normal penetration (effpen, or ) and penetration velocity (Vpen) are obtained from the appropriate
road contact model.
Vyc = Y-component of ( x R )
Vzc = Z-component of ( x R )
The component Vzc* tan( ) takes into account the lateral slip due to a vertical movement of the tire if
the roll inclination with the road is not zero. The default for LAT_SLIP_MODE is zero.
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity , and the effective rolling radius Re:
V sx = V x – R e
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point with:
V sx V sy
= -------- and tan = --------
Vx Vx
When the UA Tire is used for the force calculation the slip quantities during positive Vsx (driving) are
defined as:
V sx V sy
= -------- and tan = --------
Vr Vr
The rolling speed Vr is determined using the effective rolling radius Re:
Vr = Re
Note that for realistic tire forces the slip angle is limited to 45 deg and the longitudinal slip Ss =
in between -1 (locked wheel) and 1.
role on the overall vehicle response. For modeling the transient tire behavior, a first-order system is used
both for the longitudinal slip as the side slip angle, . Considering the tire belt as a stretched string,
which is supported to the rim with lateral spring, the lateral deflection of the belt can be estimated (see
H.B. Pacejka, Tyre and Vehicle Dynamics, 2002, Butterworth-Heinemann, ISBN 0 7506 5141 5). The
following figure shows a top-view of the string model.
When rolling, the first point that has contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string forms that depends on the slip angle size and the history of
the lateral deflection of previous points that had contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid:
1 dv v1
-------1- + ------
----- = tan + a
V x dt
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
dv 1
-------- + V x v 1 = V sy
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
When the UA Tire is used for the force calculations, positive Vsx (traction) the Vx should be replaced by
Vr in these differential equations.
40 Adams/Tire
Using Aircraft Tire Models
A similar approach yields the following for the deflection of the string in the longitudinal direction:
du 1
-------- + V x u 1 = – V sx
dt
Now the practical slip quantities, ' , and ' , are defined based on the tire deformation:
U1
' = ------ – k Vlow x V sx sign V x
V1
' = atan ------ – k Vlow y V sy
These practical slip quantities, ' , and ' , are used instead of the usual and definitions for steady
state tire behavior. kVlow_x and kVlow_y are the damping rates at low speed applied below the
LOW_SPEED_THRESHOLD speed. The LOW_SPEED_DAMPING parameter in the tire property file
yields:
kVlow_x = 100 · kVlow_y = LOW_SPEED_DAMPING
and are the relaxation lengths for the lateral and longitudinal direction, respectively, in the
Aircraft tire models = .
= .= RLEN + FLEN/2.
2
flen = 2 D o ------ + ------ FOOTPRINT LENGTH FACTOR
Do Do
The above stretched string model approach results in a tire behavior that can be compared to a spring (the
force response depends on deflection) at zero speed, while during rolling the tire will act like a damper
(the force response depends on slip speeds). When the wheel starts rolling (spinning up), low damped
wheel rotation oscillations may occur which may be not realistic. The LOW_SPEED_DAMPING
parameter can be used to increase the damping in such cases.
Note: If the tire property file's RELAXATION_LENGTH = 0, then steady state tire behavior will
be calculated is instantaneous response on change of slip and .
Longitudinal Force
Fx = 0
Lateral Force
Fy = 0
Oversteering Moment
Tx = 0
Aligning Moment
Tz = 0
Additional Parameters
Before calculating the current maximum available friction coefficient, the Fiala tire model requires the
evaluation of some additional variables. First is the comprehensive slip S*s :
Friction Models
You can choose from four friction models. The friction mode parameter within the tire property file is
used to select the friction model. The friction model ultimately computes the maximum available
comprehensive friction coefficient.
• Slip Ratio-based Friction Model A (Linear U-Slip)
42 Adams/Tire
Using Aircraft Tire Models
A linear relationship between Ss and U( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Note: The figure illustrates that the available friction coefficient, U, varies linearly with slip ratio,
but the actual curve of Fx/Fz is not linear, as described in Longitudinal Force.
parameters are experimentally obtained data representing the kinematic property between the surfaces of
tire tread and the terrain.
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Notice that Umin is not used in this friction model. Also, notice the effect of V_UREF upon the decay of
the available friction coefficient with total slip (or scrub) velocity Vsxy:
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
parameters are experimentally obtained data representing the kinematic property between the surfaces of
tire tread and the terrain.
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed (AGARD-R-800 "The Design, Qualification and Maintenance of Vibration-Free
Landing Gear": Denti, E., Fanteria D., "Analysis and Control of the Flexible Dynamics of Landing Gear
in the Presence of Antiskid Control Systems" (1996)). The following figure shows this relationship.
Umax – Umin
U = Umin + Umax – Umin Umin + -------------------------------------------
V sxy
1 + --------------------------- -
V UREF
Notice the effect of V_UREF on the decay of the available friction coefficient with total slip (or scrub)
velocity Vsxy:
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
Handling Forces of Road on Tire 45
Using Aircraft Tire Models
The following figure shows the relationship between Ss and U ( ), the corresponding maximum
available road-tire friction coefficient.
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
UF Z
S_critical = ------------------------------
-
2 CSLIP
This is the value of longitudinal slip beyond which the tire is sliding.
Case 1. Elastic Deformation State:|Ss| < S_critical
Fx = -CSLIP x Ss
Fx = -sign(Ss)(Fx1-Fx2)
where:
• Fx1 = U x Fz
2
U FZ
• F X 2 = ---------------------------------------------
-
4 S S CSLIP
The calculations of Fx can be used to calculate Fx/Fz, which can be contrasted to the available total
coefficient of friction (U) curves shown above. All of the above figures are plots of U, but they are not
the plots of Fx/Fz. The U curves show the maximum possible friction coefficient, but the actual
longitudinal force, while based on U, is modified by the rolling characteristics of the tire.
For example, consider the plot of Linear Fiala Tire-Terrain Friction Model. The coefficient of friction is a
straight line. Consider next the following figure based on the equations for Fx shown in Case 1 and Case
2 above. The following figure, created using arbitrarily chosen parameters, illustrates that Fx/Fz is less
than the value of U at every value of slip, Ss , The actual Fx/Fz curve is a function of the U curve, CSLIP,
and tire vertical force, Fz.
Handling Forces of Road on Tire 47
Using Aircraft Tire Models
This type of difference between the chosen U curve and Fx/Fz affects all four friction models. You should
keep this in mind when creating your tire property file. Also, after you run a simulation, such as a braking
or wheel test simulation, you can plot Fx/Fz to determine whether the friction values are what you require.
Lateral Force
Like the longitudinal force, the lateral force depends on the vertical force (Fz) and the current coefficient
of friction (U). And similar to the longitudinal force calculation, Fiala defines a critical lateral slip
(Alpha_critical):
3 U FZ
Alpha_critical = arctan ----------------------------
-
CALPHA
The lateral force peaks at a value equal to U x |Fz| when the slip angle (Alpha) equals the critical slip
angle (Alpha_critical).
Oversteering Moment
Tx = 0
Aligning Moment
3
T Z = 2 U F Z WIDTH 1 – H H sign Alpha
Additional Parameters
The UATire tire model requires the evaluation of some additional variables:
• Lateral Slip Ratios
• Comprehensive Slip Ratio
The lateral slip ratio due to slip angle, S , may then be defined as:
S = tan whether traction or braking
S = min 1.0 S
S = sin
A combined lateral slip ratio due to slip and inclination angles, S , is defined as:
sin -
S = tan – -------------- whether traction or braking
2 r 1
S = min 1.0 S
2 2
S s = S s + S
Note that:
S s = S s for = = 0
S s = S for s = = 0
S s = S for s = = 0
S s = S for s = 0
= tan–1 S ag S s
Slip properties and slip ratio relationships are shown in the following figure (a), (b), and (c):
a. Slip Properties Between Tire and Terrain During Braking
b. Slip Properties Between Tire and Terrain During Traction
c. Resultant Slip Ratio Relationships
50 Adams/Tire
Using Aircraft Tire Models
Friction Models
You can choose from three friction models. The friction mode parameter within the tire property file is
used to select the friction model. The friction model ultimately computes the maximum available
comprehensive friction coefficient
• Slip Ratio-based Friction Model
• Slip (or Scrub) Velocity-based Friction Decay Model A
• Slip (or Scrub) Velocity-based Friction Decay Model B
A linear relationship between Ss and , the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
U = Umax - (Umax-Umin) x S s
parameters are experimentally obtained data representing the kinematic property between the surfaces of
tire tread and the terrain.
A decay relationship between Vsxy and , the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Notice that Umin is not used in this friction model. Also, notice the effect of V_UREF upon the decay of
the available friction coefficient with total slip (or scrub) velocity Vsxy:
A decay relationship between Vsxy and , the corresponding maximum available road-tire friction
coefficient, is assume, from (Denti, E., Fanteria D., "Analysis and Control of the Flexible Dynamics of
52 Adams/Tire
Using Aircraft Tire Models
Landing Gear in the Presence of Antiskid Control Systems" AGARD-R-800 "The Design, Qualification
and Maintenance of Vibration-Free Landing Gear" (1996)). The following figure shows this relationship.
U max – U min
U = U min + U max – U min U min + --------------------------------------
V sxy
1 + -----------------------
V UREF
Notice the effect of V_UREF upon the decay of the available friction coefficient with total slip (or scrub)
velocity Vsxy:
2 2
----x- ----y-
+ = 1
or x = cos
Handling Forces of Road on Tire 53
Using Aircraft Tire Models
and y = sin
s S
where cos = ------------
-
Ss
Note that x and y in the following figure depend on the untruncated value Ss .
• Case 1: 0
• Case 2: 0 and C S C S
• Case 3: 0 and C S C S
C C len
C = ----------------------
6 R0
C len = 8 R 0 effpen
The lateral force Fh can be decomposed into two components: Fha and Fhg. The two components are in
the same direction if 0 and in opposite direction if 0 .
Case 1. 0
Before computing the longitudinal force, the lateral force, and the self-aligning torque, some slip
parameters and a modified lateral friction coefficient should be determined. If a slip ratio due to the
critical inclination angle is denoted by S c , then it can be evaluated as:
Fz
S c = ------
C
If Ssc represents a slip ratio due to the critical (longitudinal) slip ratio, then it can be evaluated as:
Fz
S sc = 3 ------
Cs
If a slip ratio due to the critical slip angle is denoted by S c , then it can be determined as
Cs 2 2 S
S c = ------- S sc – S s – 3 C -------
C C
The term "critical" stands for the maximum value which allows an elastic deformation of a tire during
pure slip due to pure slip ratio, slip angle, or inclination angle. Whenever any slip ratio becomes greater
than its corresponding critical value, an elastic deformation no longer exists, but instead complete sliding
state represents the contact condition between the tire tread base and the terrain surface.
A nondimensional slip ratio Sn is determined as:
2
B2 + B2 – B1 B3
S n = --------------------------------------------
B1
where:
• B1 = (3mFz)2 - (3CgSg)2
• B2 = -3CaSaCgSg
• B3 = -[(CsSs)2 + (CaSa)2]
m
A modified lateral friction coefficient m y is evaluated as:
C S
= y – -----------
m
y
Fz
To determine the longitudinal force, the lateral force, and the self-aligning torque, consider two subcases
separately. The first case is for the elastic deformation state, while the other is for the complete sliding
state without any elastic deformation of a tire. These two subcases are distinguished by slip ratios caused
by the critical values of the slip ratio, the slip angle, and the inclination angle. Specifically, if all of slip
ratios are smaller than those of their corresponding critical values, then there exists an elastic deformation
state, otherwise there exists only complete sliding state between the tire tread base and the terrain surface.
1. Elastic Deformation State: S S c , S s Ssc and S S c
In the elastic deformation state, the longitudinal force F , the lateral force Fh, and three
components of the self-aligning torque are written as functions of the elastic stiffness and the slip
ratio as well as the normal force and the friction coefficients, such as:
2 2 3
F = Cs Ss ln + x Fz 1 – 3 ln + 2 ln
2 m 2 3
F = C S ln + y Fz 1 – 3 ln + 2 ln + C S
1 2 3 m
M z = C S – --- + --- l n + --- y F z S n l n
2 2
2 3 2
2
2 3 3 x y Fz 3 4 5
M zs = --- C s S s S l n + --------------------------- l – 10 l n + 15 l n – 6 l n
3 5 C
M zs = F
where:
2 2
• = S r l – 4 is the offset between the wheel plane center and the tire tread base.
2 2
• r l – 4 is set to zero if it is negative.
• M z is the portion of the self-aligning torque generated by the slip angle a.
• M zs and M zs are other components of the self-aligning torque produced by the longitudinal
force, which has an offset between the wheel center plane and the tire tread base, due to the
slip angle a and the inclination angle g, respectively. The self-aligning torque Mz is
determined as combinations of Mz , M zs and Mzsg .
2. Complete Sliding State: Sg > Sgc, Ss > Ssc or Sa > Sac
In the complete sliding state, the longitudinal force, the lateral force, and three components of the
self-aligning torque are determined as functions of the normal force and the friction coefficients
without any elastic stiffness and slip ratio as:
F = x Fz
56 Adams/Tire
Using Aircraft Tire Models
F = y Fz
Mz = 0
2
3 x y Fz
M z s = ---------------------------
5 C
M zs = F
Case 2: 0 and C S C S
Same as in Case 1, a slip ratio due to the critical value of the slip ratio can be obtained as:
Fz
S sc = 3 ------
Cs
A slip ratio due to the critical value of the slip angle can be found as:
Cs 2 2 S
S c = ------- S sc – S s + 3 C -------
C C
2
B2 + B2 – B1 B3
S n = --------------------------------------------
B1
where:
• B1 = (3mFz)2 - (3CgSg)2
• B2 = -3CaSaCgSg
• B3 = -[(CsSs)2 + (CaSa)2]
The nondimensional contact patch length ln is found from the equation ln = 1 - Sn, and the modified lateral
m
friction coefficient y is expressed as:
m C S
y = y + -----------
Fz
For the longitudinal force, the lateral force, and the self-aligning torque two subcases should also be
considered separately. A slip ratio due to the critical value of the inclination angle is not needed here since
the required condition for Case 2, CaSa > CgSg, replaces the critical condition of the inclination angle.
2 m 2 3
F = C S ln + y Fz 1 – 3 ln + 2 ln – C S
2 2 3
F = Cs Ss ln + x Fz 1 – 3 ln + 2 ln
1 2 3 m
M z = C S – --- + --- l n + --- y F z S n l n
2 2
2 3 2
2
2 3 3 x y Fz 3 4 5
M zs = --- C s S s S l n + --------------------------- 1 – 10 l n + 15 l n – 6 l n
3 5 C
M zs = F
2. Complete sliding state: Ss > Ssc or Sa > Sac
F = x Fz
F = y Fz
Mz = 0
2
3 x y Fz
M z s = ---------------------------
5 C
M zs = F
Case 3: 0 and C S C S
Similar to cases 1 and 2, slip ratios due to the critical values of the inclination angle and the slip ratio are
obtained as:
3 Fz + C S
S c = --------------------------------
3 C
1 2 2
S sc = ------ 3 F z – C S – 3 C S
Cs
2
B2 + B2 – B1 B3
S n = --------------------------------------------
B1
where:
• B1 = (3mFz)2 - (3CgSg)2
• B2 = -3CaSaCgSg
• B3 = -[(CsSs)2 + (CaSa)2]
58 Adams/Tire
Using Aircraft Tire Models
For the longitudinal force, the lateral force, and the self-aligning torque, two subcases should also be
considered similar to Cases 1 and 2. A slip ratio due to the critical value of the slip angle is not needed
here since the required condition for Case 3, CaSa< CgSg, replaces the critical condition of the slip angle.
C S ln
M z = ---------------------
6
2
2 3 3 x y Fz 3 4 5
M zs = --- C s S s S l n + --------------------------- l – 10 l n + 15 l n – 6 l n
3 5 C
M zs = F
2. Complete Sliding State: Sg > Sgc or Ss > Ssc
In the complete sliding state, F , Fh, Mza, Mzsa, and Mzsg can be determined by using:
F = x Fz
F = y Fz
Mz = 0
2
3 x y Fz
M zs = ---------------------------
5 C
M zs = F
respectively. The longitudinal force F , the lateral force Fh, and three components of the self-
aligning torques Mza, Mzsa, and Mzsg always have positive values, but they can be transformed to
have positive or negative values depending on the slip ratio , the slip angle , and the inclination
angle in the SAE coordinate system.
Lateral Force
Fy = -sign(a) Fh, for cases 1 and 2
Handling Forces of Road on Tire 59
Using Aircraft Tire Models
Self-aligning Torque
Mz = sign(a) Mza + sign(s) [-sign(a) Mzsa + sign(g)Mzsg]
Where Cr = ROLLING_RESISTANCE.
Moment Adjustments
An adjustment to the tire moments is conducted to capture the effects of the longitudinal and lateral
shifting of the approximate contact patch vertical center of pressure and center of longitudinal shear
pressure, in the presence of longitudinal and lateral tire forces.
Note: A separate moment adjustment has previously been calculated for the tire rolling resistance
effects.
Moment Adjustments
Mx = Mx + [ Fz * dlat]
My = My - [ Fz * dlon]
Mz = Mz - [ Fx * dlat]
Force Reducer
In a balancing simulation, you can switch on the force reducer by using the tire user array. If the first
element reads the value 1500 and the second 1, the force reducer is switched on. Except for the vertical
load Fz, all tire forces and moments are reduced drastically to reach airplane equilibrium in a more
efficient way.
Fx = Fx * FORCE_REDUCER_X
Fy = Fy * FORCE_REDUCER_Y
60 Adams/Tire
Using Aircraft Tire Models
Mx = Mx * FORCE_REDUCER_Y
My = My * FORCE_REDUCER_X
Mx = Mz* FORCE_REDUCER_Y
FORCE_REDUCER_X = 0.01
FORCE_REDUCER_Y = 0.0
Inputs
The inputs to the Aircraft TRR64 Tire Model come from two sources:
• Input parameters from the tire property file (.tir), such as tire undeflected radius, that the tire
references.
• Tire state, given through the tire interface with the solver, such as slip angle ( ).
The following table summarizes the input data from the tire property file (.tir) that the Aircraft TRR64
Tire Model requires.
Parameters: Description:
[UNITS] block: LENGTH Units of length for all tire property file values that involve
length units.
Parameters: Description:
HANDLING_MODE 1 = don't compute handling forces (zero)
2 = Fiala-based handling force computations
3 = UATire-based handling force computations
4 = basic NASA TR-R-64 handling force computations
Parameters: Description:
LOW_SPEED_THRESHOLD The speed below which the low speed damping will be
(optional) applied. (Units: length/time.) If not specified in the tire
property file, the value for this parameter is 4 m/s.
Parameters: Description:
LAT_DEFL_FACTOR Reduction factor used in the calculation of lateral shift in tire
vertical center of pressure in the presence of a lateral force.
(Units: none.)
Half-footprint Length
The tire half-footprint length is calculated as:
2
h = D o ------ + ------ FOOTPRINT LENGTH FACTOR
D o D o
Footprint Width
The tire footprint width is calculated as:
4 6
b = 1.7 w W 1 – 2.5 W 1 + 1.5 W 1
where:
• w = WIDTH
• W1 = -----
W
A g = 2.38 W D o
81 40
P 1 0.6 + ------------------- ----- for ----- ------ C z
1600. C z W W 9
pg =
-
–1
40
P 1 1.05 + C z ---- W for ----- ------ C z
W 9
where:
pg
P n = ----------------------------------------------------------------------------
FOOTPRINT AREA RATIO
Basic NASA TR-R-64 Parameters 67
Using Aircraft Tire Models
K lon = 0.565 D o P 5 3 D o
where:
P5 = INFLATION_PRESSURE + 4 (RATED_PRESSURE).
• tA = 2.0
• P0 = INFLATION_PRESSURE + 0.24 (RATED_PRESSURE)
2
P 1 W 3 250 ------ for ------ 0.03
D o Do
K tor =
3 – 0.015
for ------ 0.03
P 1 W 15 ------
D o D o
P 2 W 11 ------ for ------ 0.06
D o D o
Ly =
for ------ 0.06
P 2 W 0.9075 – 4 ------
D o Do
Note: This equation is from the NASA TR-R-64 report. However, in order to avoid integrator-
related complications associated with the differential equation for the lagged lateral and
longitudinal slip, the following simplified equation is used: Ly = P2 · w · 2.5
• Fzk is the normal force due to the tire radial load-deflection curve
• Fzk = - f (effpen, tire load-deflection spline)
• Fzc is the normal force due to tire vertical damping
• Fzc = - VERTICAL_DAMPING x Vpen
• Fzrim is the normal force due to bottoming of the wheel
Handling Forces of Road on Tire 69
Using Aircraft Tire Models
The normal penetration (effpen, or ) and penetration velocity (Vpen) are obtained from the appropriate
road contact model.
Vyc = Y-component of R
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the
wheel rotational velocity , and the effective rolling radius Re:
V sx = V x – R e
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane:
V sy = V y
The practical slip quantities (longitudinal slip) and (slip angle) are calculated with these slip
velocities in the contact point with:
V sx V sy
= -------- and tan = --------
Vx Vx
When the UA Tire is used for the force calculation the slip quantities during positive Vsx (driving) are
defined as:
V sx V sy
= -------- and tan = --------
Vr Vr
The rolling speed Vr is determined using the effective rolling radius Re:
Handling Forces of Road on Tire 71
Using Aircraft Tire Models
Vr = Re
Note that for realistic tire forces the slip angle is limited to 45 deg and the longitudinal slip S s =
in between -1 (locked wheel) and 1.
When rolling, the first point that has contact with the road adheres to the road (no sliding assumed).
Therefore, a lateral deflection of the string forms that depends on the slip angle size and the history of
the lateral deflection of previous points that had contact with the road.
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the
following differential equation is valid:
1 dv v1
-------1- + ------
----- = tan + a
V x dt
with the relaxation length in the lateral direction. The turnslip can be neglected at radii larger than
10 m. This differential equation cannot be used at zero speed, but when multiplying with Vx, the equation
can be transformed to:
72 Adams/Tire
Using Aircraft Tire Models
dv 1
-------- + V x v 1 = V sy
dt
When the tire is rolling, the lateral deflection depends on the lateral slip speed; at standstill, the deflection
depends on the relaxation length, which is a measure for the lateral stiffness of the tire. Therefore, with
this approach, the tire is responding to a slip speed when rolling and behaving like a spring at standstill.
When the UA Tire is used for the force calculations, positive Vsx (traction) the Vx should be replaced by
Vr in these differential equations.
A similar approach yields the following for the deflection of the string in the longitudinal direction:
du 1
-------- + V x u 1 = – V sx
dt
Now the practical slip quantities, ' ’ and ' ’, are defined based on the tire deformation:
U1
' = ------ – k Vlow x V sx sign V x
V1
' = atan ------ – k Vlow y V sy
These practical slip quantities, ' ’ and ' ’, are used instead of the usual and definitions for steady
state tire behavior. kVlow_x and kVlow_y are the damping rates at low speed applied below the
LOW_SPEED_THRESHOLD speed. The LOW_SPEED_DAMPING parameter in the tire property file
yields:
kVlow_x = 100 · kVlow_y = LOW_SPEED_DAMPING
sa and sk are the relaxation lengths for the lateral and longitudinal direction, respectively, in the Aircraft
tire models sa = sk.
Note: Currently, the lagged slip cannot be forced to be equal to the instantaneous slip, thus the
NASA TR-R-64 tire model can only be used in transient mode.
Handling Forces of Road on Tire 73
Using Aircraft Tire Models
Longitudinal Force
Fx = 0
Lateral Force
Fy = 0
Oversteering Moment
Tx = 0
Aligning Moment
Tz = 0
Additional Parameters
Before calculating the current maximum available friction coefficient, the Fiala tire model requires the
evaluation of some additional variables. First is the comprehensive slip S*s :
Friction Models
You can choose from four friction models. The friction mode parameter within the tire property file is
used to select the friction model. The friction model ultimately computes the maximum available
comprehensive friction coefficient.
• Slip Ratio-based Friction Model A (Linear U-Slip)
• Slip (or Scrub) Velocity-based Friction Decay Model A
• Slip (or Scrub) Velocity-based Friction Decay Model B
• Slip Ratio based Model B (User-Defined Mu-Slip)
A linear relationship between Ss and U( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Note: The figure illustrates that the available friction coefficient, U, varies linearly with slip ratio,
but the actual curve of Fx/Fz is not linear, as described in Longitudinal Force.
Handling Forces of Road on Tire 75
Using Aircraft Tire Models
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Notice that Umin is not used in this friction model. Also, notice the effect of V_UREF upon the decay of
the available friction coefficient with total slip (or scrub) velocity Vsxy:
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
The resultant friction coefficient between the tire tread base and the terrain surface is determined as a
function of the total planar slip (or scrubbing) velocity Vsxy, friction parameters (Umax and Umin), and
the friction coefficient reference velocity parameter V_UREF from the tire property file. The friction
parameters are experimentally obtained data representing the kinematic property between the surfaces of
tire tread and the terrain.
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed (AGARD-R-800 "The Design, Qualification and Maintenance of Vibration-Free
Landing Gear": Denti, E., Fanteria D., "Analysis and Control of the Flexible Dynamics of Landing Gear
in the Presence of Antiskid Control Systems" (1996)). The following figure shows this relationship.
Umax – Umin
U = Umin + Umax – Umin Umin + -------------------------------------------
V sxy
1 + --------------------------- -
V UREF
Notice the effect of V_UREF on the decay of the available friction coefficient with total slip (or scrub)
velocity Vsxy:
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
The following figure shows the relationship between Ss and U ( ), the corresponding maximum
available road-tire friction coefficient.
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
78 Adams/Tire
Using Aircraft Tire Models
UF Z
S_critical = ------------------------------
-
2 CSLIP
This is the value of longitudinal slip beyond which the tire is sliding.
Case 1. Elastic Deformation State:|Ss| < S_critical
Fx = -CSLIP x Ss
Fx = -sign(Ss)(Fx1-Fx2)
where:
• Fx1 = U x Fz
2
U FZ
• F X 2 = ---------------------------------------------
-
4 S S CSLIP
The calculations of Fx can be used to calculate Fx/Fz, which can be contrasted to the available total
coefficient of friction (U) curves shown above. All of the above figures are plots of U, but they are not
the plots of Fx/Fz. The U curves show the maximum possible friction coefficient, but the actual
longitudinal force, while based on U, is modified by the rolling characteristics of the tire.
For example, consider the plot of Linear Fiala Tire-Terrain Friction Model. The coefficient of friction is a
straight line. Consider next the following figure based on the equations for Fx shown in Case 1 and Case
2 above. The following figure, created using arbitrarily chosen parameters, illustrates that Fx/Fz is less
Handling Forces of Road on Tire 79
Using Aircraft Tire Models
than the value of U at every value of slip, Ss , The actual Fx/Fz curve is a function of the U curve, CSLIP,
and tire vertical force, Fz.
This type of difference between the chosen U curve and Fx/Fz affects all four friction models. You should
keep this in mind when creating your tire property file. Also, after you run a simulation, such as a braking
or wheel test simulation, you can plot Fx/Fz to determine whether the friction values are what you require.
Lateral Force
Like the longitudinal force, the lateral force depends on the vertical force (Fz) and the current coefficient
of friction (U). And similar to the longitudinal force calculation, Fiala defines a critical lateral slip
(Alpha_critical):
3 U FZ
Alpha_critical = arctan ----------------------------
-
CALPHA
The lateral force peaks at a value equal to U x |Fz| when the slip angle (Alpha) equals the critical slip
angle (Alpha_critical).
Oversteering Moment
80 Adams/Tire
Using Aircraft Tire Models
Tx = 0
Aligning Moment
3
T Z = 2 U F Z WIDTH 1 – H H sign Alpha
Additional Parameters
The UATire tire model requires the evaluation of some additional variables:
• Lateral Slip Ratios
• Comprehensive Slip Ratio
The lateral slip ratio due to slip angle, S , may then be defined as:
S = tan whether traction or braking
S = min 1.0 S
S = sin
A combined lateral slip ratio due to slip and inclination angles, S , is defined as:
sin
S = tan – --------------
- whether traction or braking
2 r 1
S = min 1.0 S
2 2
S s = S s + S
Note that:
S s = S s for = = 0
S s = S for s = = 0
S s = S for s = = 0
S s = S for s = 0
= tan–1 S ag S s
Slip properties and slip ratio relationships are shown in the following figure (a), (b), and (c):
a. Slip Properties Between Tire and Terrain During Braking
b. Slip Properties Between Tire and Terrain During Traction
82 Adams/Tire
Using Aircraft Tire Models
Friction Models
You can choose from three friction models. The friction mode parameter within the tire property file is
used to select the friction model. The friction model ultimately computes the maximum available
comprehensive friction coefficient
• Slip Ratio-based Friction Model
• Slip (or Scrub) Velocity-based Friction Decay Model A
• Slip (or Scrub) Velocity-based Friction Decay Model B
A linear relationship between S s and , the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
U = Umax - (Umax-Umin) x S s
A decay relationship between Vsxy and , the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Notice that Umin is not used in this friction model. Also, notice the effect of V_UREF upon the decay of
the available friction coefficient with total slip (or scrub) velocity Vsxy:
A decay relationship between Vsxy and , the corresponding maximum available road-tire friction
coefficient, is assume, from (Denti, E., Fanteria D., "Analysis and Control of the Flexible Dynamics of
Handling Forces of Road on Tire 85
Using Aircraft Tire Models
Landing Gear in the Presence of Antiskid Control Systems" AGARD-R-800 "The Design, Qualification
and Maintenance of Vibration-Free Landing Gear" (1996)). The following figure shows this relationship.
U max – U min
U = U min + U max – U min U min + --------------------------------------
V sxy
1 + -----------------------
V UREF
Notice the effect of V_UREF upon the decay of the available friction coefficient with total slip (or scrub)
velocity Vsxy:
2 2
----x- ----y-
+ = 1
or x = cos
86 Adams/Tire
Using Aircraft Tire Models
and y = sin
s S
where cos = ------------
-
Ss
Note that x and y in the following figure depend on the untruncated value Ss .
• Case 1: 0
• Case 2: 0 and C S C S
• Case 3: 0 and C S C S
C C len
C = ----------------------
6 R0
C len = 8 R 0 effpen
The lateral force Fh can be decomposed into two components: Fha and Fhg. The two components are in
the same direction if 0 and in opposite direction if 0 .
Case 1. 0
Before computing the longitudinal force, the lateral force, and the self-aligning torque, some slip
parameters and a modified lateral friction coefficient should be determined. If a slip ratio due to the
critical inclination angle is denoted by S c , then it can be evaluated as:
Fz
S c = ------
C
If Ssc represents a slip ratio due to the critical (longitudinal) slip ratio, then it can be evaluated as:
Fz
S sc = 3 ------
Cs
If a slip ratio due to the critical slip angle is denoted by S c , then it can be determined as
Cs 2 2 S
S c = ------- S sc – S s – 3 C -------
C C
The term "critical" stands for the maximum value which allows an elastic deformation of a tire during
pure slip due to pure slip ratio, slip angle, or inclination angle. Whenever any slip ratio becomes greater
than its corresponding critical value, an elastic deformation no longer exists, but instead complete sliding
state represents the contact condition between the tire tread base and the terrain surface.
A nondimensional slip ratio Sn is determined as:
2
B2 + B2 – B1 B3
S n = --------------------------------------------
B1
where:
• B1 = (3mFz)2 - (3CgSg)2
• B2 = -3CaSaCgSg
• B3 = -[(CsSs)2 + (CaSa)2]
m
A modified lateral friction coefficient m y is evaluated as:
C S
= y – -----------
m
y
Fz
To determine the longitudinal force, the lateral force, and the self-aligning torque, consider two subcases
separately. The first case is for the elastic deformation state, while the other is for the complete sliding
state without any elastic deformation of a tire. These two subcases are distinguished by slip ratios caused
by the critical values of the slip ratio, the slip angle, and the inclination angle. Specifically, if all of slip
ratios are smaller than those of their corresponding critical values, then there exists an elastic deformation
state, otherwise there exists only complete sliding state between the tire tread base and the terrain surface.
1. Elastic Deformation State: S S c , S s S sc and S S c
In the elastic deformation state, the longitudinal force F , the lateral force Fh, and three
components of the self-aligning torque are written as functions of the elastic stiffness and the slip
ratio as well as the normal force and the friction coefficients, such as:
2 2 3
F = Cs Ss ln + x Fz 1 – 3 ln + 2 ln
2 m 2 3
F = C S ln + y Fz 1 – 3 ln + 2 ln + C S
1 2 3 m
M z = C S – --- + --- l n + --- y F z S n l n
2 2
2 3 2
2
2 3 3 x y Fz 3 4 5
M zs = --- C s S s S l n + --------------------------- l – 10 l n + 15 l n – 6 l n
3 5 C
M zs = F
where:
2 2
• = S r l – 4 is the offset between the wheel plane center and the tire tread base.
2 2
• r l – 4 is set to zero if it is negative.
• M z is the portion of the self-aligning torque generated by the slip angle a.
• M zs and M zs are other components of the self-aligning torque produced by the longitudinal
force, which has an offset between the wheel center plane and the tire tread base, due to the
slip angle a and the inclination angle g, respectively. The self-aligning torque Mz is
determined as combinations of M z , Mzs and M zsg .
2. Complete Sliding State: Sg > Sgc, Ss > Ssc or Sa > Sac
In the complete sliding state, the longitudinal force, the lateral force, and three components of the
self-aligning torque are determined as functions of the normal force and the friction coefficients
without any elastic stiffness and slip ratio as:
F = x Fz
Handling Forces of Road on Tire 89
Using Aircraft Tire Models
F = y Fz
Mz = 0
2
3 x y Fz
M z s = ---------------------------
5 C
M zs = F
Case 2: 0 and C S C S
Same as in Case 1, a slip ratio due to the critical value of the slip ratio can be obtained as:
Fz
S sc = 3 ------
Cs
A slip ratio due to the critical value of the slip angle can be found as:
Cs 2 2 S
S c = ------- S sc – S s + 3 C -------
C C
2
B2 + B2 – B1 B3
S n = --------------------------------------------
B1
where:
• B1 = (3mFz)2 - (3CgSg)2
• B2 = -3CaSaCgSg
• B3 = -[(CsSs)2 + (CaSa)2]
The nondimensional contact patch length ln is found from the equation ln = 1 - Sn, and the modified lateral
m
friction coefficient y is expressed as:
m C S
y = y + -----------
Fz
For the longitudinal force, the lateral force, and the self-aligning torque two subcases should also be
considered separately. A slip ratio due to the critical value of the inclination angle is not needed here since
the required condition for Case 2, CaSa > CgSg, replaces the critical condition of the inclination angle.
2 m 2 3
F = C S ln + y Fz 1 – 3 ln + 2 ln – C S
2 2 3
F = Cs Ss ln + x Fz 1 – 3 ln + 2 ln
1 2 3 m
M z = C S – --- + --- l n + --- y F z S n l n
2 2
2 3 2
2
2 3 3 x y Fz 3 4 5
M zs = --- C s S s S l n + --------------------------- 1 – 10 l n + 15 l n – 6 l n
3 5 C
M zs = F
2. Complete sliding state: Ss > Ssc or Sa > Sac
F = x Fz
F = y Fz
Mz = 0
2
3 x y Fz
M z s = ---------------------------
5 C
M zs = F
Case 3: 0 and C S C S
Similar to cases 1 and 2, slip ratios due to the critical values of the inclination angle and the slip ratio are
obtained as:
3 Fz + C S
S c = --------------------------------
3 C
1 2 2
S sc = ------ 3 F z – C S – 3 C S
Cs
2
B2 + B2 – B1 B3
S n = --------------------------------------------
B1
where:
• B1 = (3mFz)2 - (3CgSg)2
• B2 = -3CaSaCgSg
• B3 = -[(CsSs)2 + (CaSa)2]
Handling Forces of Road on Tire 91
Using Aircraft Tire Models
For the longitudinal force, the lateral force, and the self-aligning torque, two subcases should also be
considered similar to Cases 1 and 2. A slip ratio due to the critical value of the slip angle is not needed
here since the required condition for Case 3, CaSa< CgSg, replaces the critical condition of the slip angle.
C S ln
M z = ---------------------
6
2
2 3 3 x y Fz 3 4 5
M zs = --- C s S s S l n + --------------------------- l – 10 l n + 15 l n – 6 l n
3 5 C
M zs = F
2. Complete Sliding State: Sg > Sgc or Ss > Ssc
In the complete sliding state, F , Fh, Mza, Mzsa, and Mzsg can be determined by using:
F = x Fz
F = y Fz
Mz = 0
2
3 x y Fz
M zs = ---------------------------
5 C
M zs = F
respectively. The longitudinal force F , the lateral force Fh, and three components of the self-
aligning torques Mza, Mzsa, and Mzsg always have positive values, but they can be transformed to
have positive or negative values depending on the slip ratio , the slip angle , and the inclination
angle in the SAE coordinate system.
Lateral Force
Fy = -sign(a) Fh, for cases 1 and 2
92 Adams/Tire
Using Aircraft Tire Models
Self-aligning Torque
Mz = sign(a) Mza + sign(s) [-sign(a) Mzsa + sign(g)Mzsg]
Where Cr = ROLLING_RESISTANCE.
Additional Parameters
Before calculating the current maximum available friction coefficient, the Basic NASA TR-R-64
Handling Force Model (for Aircraft simulations) requires the evaluation of some additional variables.
First is the comprehensive slip S*s :
Friction Models
You can choose from four friction models. The friction mode parameter within the tire property file is
used to select the friction model. The friction model ultimately computes the maximum available
comprehensive friction coefficient.
• Slip Ratio-based Friction Model A (Linear U-Slip)
• Slip (or Scrub) Velocity-based Friction Decay Model A
Handling Forces of Road on Tire 93
Using Aircraft Tire Models
A linear relationship between Ss and U( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed. The following figure shows this relationship.
Notice that Umin is not used in this friction model. Also, notice the effect of V_UREF upon the decay of
the available friction coefficient with total slip (or scrub) velocity Vsxy:
A decay relationship between Vsxy and U ( ), the corresponding maximum available road-tire friction
coefficient, is assumed (AGARD-R-800 "The Design, Qualification and Maintenance of Vibration-Free
Handling Forces of Road on Tire 95
Using Aircraft Tire Models
Landing Gear": Denti, E., Fanteria D., "Analysis and Control of the Flexible Dynamics of Landing Gear
in the Presence of Antiskid Control Systems" (1996)). The following figure shows this relationship.
Umax – Umin
U = Umin + Umax – Umin Umin + -------------------------------------------
V sxy
1 + --------------------------- -
V UREF
Notice the effect of V_UREF on the decay of the available friction coefficient with total slip (or scrub)
velocity Vsxy:
Note: The figure illustrates the available friction coefficient, U, as it varies with slip ratio. The
actual curve of Fx/Fz deviates from this curve, as described in Longitudinal Force.
The longitudinal force depends on the vertical force (Fz), the current maximum available total coefficient
of friction (U), and the longitudinal slip ratio (Ss).
The Aircraft implementation of the NASA TR-R-64 tire model is similar to the Fiala model. Fiala defines
a critical longitudinal slip (S_critical):
U Fz
S critical = ------------------------------
-
2 CSLIP
This is the value of longitudinal slip beyond which the tire is sliding.
Case 1. Elastic Deformation State:|Ss| < S_critical
Fx = -CSLIP x Ss
Fx = -sign(Ss)(Fx1-Fx2)
where:
• Fx1 = U x Fz
2
U FZ
• F X 2 = ---------------------------------------------
-
4 S S CSLIP
Lateral Force
The NASA TR-R-64 computation for the tire lateral (termed "normal" in NASA TR-R-64) is used. Like
the longitudinal force, the lateral force depends on the vertical force (Fz) and the current coefficient of
friction (U).
4 3
U Fz – ------ for 1.5
Fy = – sign 27
U Fz for 1.5
where:
N
= --------------
U Fz
Oversteering Moment
Tx = 0
Aligning Moment
Moment Adjustments
An adjustment to the tire moments is conducted to capture the effects of the longitudinal and lateral
shifting of the approximate contact patch vertical center of pressure and center of longitudinal shear
pressure, in the presence of longitudinal and lateral tire forces.
Note: A separate moment adjustment has previously been calculated for the tire rolling resistance
effects.
Moment Adjustments
Mx = Mx + [ Fz * dlat]
My = My - [ Fz * dlon]
Mz = Mz - [ Fx * dlat]
Force Reducer
In a balancing simulation, you can switch on the force reducer by using the tire user array. If the first
element reads the value 1500 and the second 1, the force reducer is switched on. Except for the vertical
load Fz, all tire forces and moments are reduced drastically to reach airplane equilibrium in a more
efficient way.
Fx = Fx * FORCE_REDUCER_X
Fy = Fy * FORCE_REDUCER_Y
Mx = Mx * FORCE_REDUCER_Y
98 Adams/Tire
Using Aircraft Tire Models
My = My * FORCE_REDUCER_X
Mx = Mz* FORCE_REDUCER_Y
FORCE_REDUCER_X = 0.01
FORCE_REDUCER_Y = 0.0
Road Models in Adams/Tire
2 Adams/Tire
Using the 2D Road Model
2D Road Types
The available road types are:
• DRUM - Tire test drum (requires a zero-speed-capable tire model).
• FLAT - Flat road.
• PLANK - Single plank perpendicular, or in oblique direction relative to x-axis, with or without
bevel edges.
• POLY_LINE - Piece-wise linear description of the road profile. The profiles for the left and right
track are independent.
• POT_HOLE- Single pothole of rectangular shape.
• RAMP - Single ramp, either rising or falling.
• ROOF - Single roof-shaped, triangular obstacle.
• SINE - Sine waves with constant wave length.
• SINE_SWEEP - Sine waves with decreasing wave lengths.
• STOCHASTIC_UNEVEN - Synthetically generated irregular road profiles that match measured
stochastic properties of typical roads. The profiles for left and right track are independent, or
may have a certain correlation.
Examples of 2D Roads
Sample files for all the road types for Adams/Car are in the standard Adams/Car database:
install_dir/shared_car_database.cdb/roads.tbl/
Sample files for all the road types for Adams/Tire are in:
install_dir/solver/atire/
Sample files for all the road types for Adams/Chassis are in:
Road Models in Adams/Tire 3
Using the 2D Road Model
install_dir/achassis/examples/rdf/
Note that you must select a specific contact method, such as point-follower or equivalent plane, to define
how the roads will interact with the tires. Not all combinations of road, tire, and contact methods are
permitted. Allowable combinations are explained in Tire Models help under the description of the specific
tire model.
The following is an example of the full [PARAMETERS] Body for a road type of polyline:
$---------------------------PARAMETERS
[PARAMETERS]
OFFSET = 0
ROTATION_ANGLE_XY_PLANE = 180
$
(XZ_DATA)
0 0 0
1000 100 50
2000 -1000 100
3001 50 0
The XZ_DATA subblock can be extremely large. In this case, only the portion that is needed at the
moment is loaded. To facilitate efficient reloading while simulation is running, do not use any comment
lines in a subblock that contains more than 2000 lines.
2
z s = a sin ------ s – s s
The last step is to linearly combine the two realizations of the above process: z 1 s , z 2 s , resulting in
the left and right profile z l s , z r s . This is done such that the two signals are completely independent
·
if corr rl = 0.0 , and identical if corr rl = 1.0 :
corr rl
z l s = z 1 s + -------------- z 2 s – z 1 s
2
corr rl
z r s = z 2 s – -------------- z 2 s – z 1 s
2
8 Adams/Tire
Using the 2D Road Model
1 1
f s = ----- and f e = -----
s e
Note the factor 2 in the denominator is not an error. The actual frequency (=
derivative of the sine function argument with respect to travel path, divided
by 2 ; this is not equal to that factor that is multiplied by 2 s – s s in the
sine function) is given by the following:
fe – fs s – ss
f s = f s + ------------------------------------
se – ss
• Logarithmic sweep: (sweep_type = 1) with every cycle, the wave
length decreases by a constant factor. The road height value is
calculated as follows:
ae – as s
z s = a s + ---------------- s – s s sin 2 f s s ln ------------------------
se – ss s + s s – s
where:
fe
s = ------------- s e – s s
fe – fs
s
f s = ------------------------ f s
s + ss – s
Road Models in Adams/Tire 11
Adams/3D Spline Road Model
Examples of event (.xml) file for use with Driving Machine and Adams/SmartDriver are shown next:
dcdSteerFile="mdids://acar_shared/roads.tbl/3d_road_smooth_ramp.xml"
steerRadius="0"
steerEntry="0"
turnDirection="right"
pathPositioning="default"
speedControl="lon_accel"
velocity="0" acceleration="0" jerk="0"
startTime="0.1"
samplePeriod="0.01"
>
For Adams/SmartDriver:
controlMode="absolute"
controlType="constant"
constantValue="0" initialValue="0" finalValue="0"
startTime="0" duration="0" rampValue="0"
maximumValue="0" cycleLength="0" amplitude="0"
initialFrequency="0" frequencyRate="0"
maximumFrequency="0" functionString="0"
>
…
<DcfSmartDriver name="smartdriver" active="true"
userDefined="false" task="vehicle_limits"
courseFile="mdids://acar_shared/roads.tbl/3d_road_smooth_ramp.xml"
max_driving_accel="70" max_braking_accel="70"
max_lh_turn_accel="70" max_rh_turn_accel="70"
samplePeriod="0.01"
/>
Keyword: Description:
COORDINATE_SYSTEM The type of coordinate system:
• local for a local perturbation-bound coordinate system.
• distance if the perturbation is defined along the length of the
road.
START The start position of the perturbation.
• '0.0 0.0 0.0' for a local coordinate system.
• '0.0' for a distance-defined perturbation.
STOP The stop position of the perturbation.
• '1.0 0.0 0.0' for a local coordinate system.
• '1.0' for a distance-defined perturbation.
LENGTH The length of the perturbation. LENGTH is used in defining the local
coordinate system.
Road Models in Adams/Tire 15
Adams/3D Spline Road Model
Keyword: Description:
WIDTH The width of the obstacle. The obstacle width can be specified
independently of the road width.
FRICTION The friction coefficient of the obstacle.
ROAD_TYPE The perturbation type.
• Local coordinate system - The START and STOP keywords define the local coordinate system,
while the interconnecting line and the LENGTH keyword provide the direction of the
perturbation. Adams/3D Spline Road projects the road profile height in the local coordinate
system onto the smooth road surface.
• Distance coordinate system - The START and STOP positions are expressed in distance along
the road centerline or chord length. The direction and length are, therefore, defined implicitly.
The following combinations of coordinate system and perturbation types are valid:
Valid Combinations of Perturbation Type and Coordinate System
Coordinate system:
Perturbation type: Local: Distance:
CROWN X
CURB X
PLANK X
POLYLINE X
POTHOLE X
RAMP X
ROOF X
ROUGHNESS X
SINE X
SWEEP X
GRID X
16 Adams/Tire
Adams/3D Spline Road Model
The road profile height z is a function of width-coordinates , obstacle width w , height z 0 , and crown
coefficient c r :
cr
z = z 0 – 4 ---- 2
w
See Illustration of Crown.
Keyword: Description:
HEIGHT Height of the curb(s).
ROUND_OFF Round-off radius of the top of the curb.
TOP_WIDTH The width of the top of the curb.
EDGE_WIDTH The width of the edge of the curb.
SIDE The side of the road where the curb is positioned:
• LEFT
• RIGHT
• BOTH
• Rounded Plank
Keyword: Description:
HEIGHT Height of the plank.
BEVEL_EDGE_LENGTH Length of the beveled edge. A beveled edge has a 45º slope. When
BEVEL_EDGE_LENGTH < 0, 3D Spline Road uses rounded corners
instead of beveled edges. In this case, the radius of the corner is
|BEVEL_EDGE_LENGTH|.
Keyword: Description:
HEIGHT Height of the ramp.
SLOPE Slope of ramp. 1 corresponds to 45º.
Keyword: Description:
HEIGHT Height of the roof.
LENGTH Length of the base of the triangular roof.
Keyword: Description:
GE Elevation PSD parameter.
GS Velocity PSD parameter.
GA Acceleration PSD parameter.
SAMPLE_INTERVAL The distance between the road profile data points.
CORRELATION_BASE Correlation base length for filtering (recommended value = 5.0 m).
LENGTH
SEED Seed for random numbers.
• If seed is negative, the computer's clock is used as a seed. An
infinite number of profiles can be generated to match the same set
of Sayers-model parameters.
• If seed is greater than zero, the value of the seed is used as the seed
to the random-number generator. This is a means of generating
reproducible profiles with the Sayers model.
References:
1. Sayers, M.W., "Dynamic Terrain Inputs to Predict Structural Integrity of Ground Vehicles."
UMTRI Report No. UMTRI-88-16, April 1988, 114 pp.
Keyword: Description:
AMPLITUDE Amplitude of the sine wave (a).
WAVE_LENGTH Wave length of the sine wave (l).
2
z s = a sin ------ s
Keyword: Description:
AMPLITUDE_AT_START Amplitude of the sine wave at start (as a s ).
Keyword: Description:
WAVE_LENGTH_AT_END Wave length of the sine wave at end (le l e ).
where:
fe
s = ------------- s e – s s
fe – fs
s¥ is the distance at which, theoretically, an infinitely high
frequency is reached, with respect to the start ss.
The lateral distance between two points in a row is determined by the WIDTH of the obstacle and the
number of points in a row:
distance_y = WIDTH / (number of points in a row -1)
Similar, the longitudinal distance between two points in a column is determined by the LENGTH of the
obstacle and the number of points in a column:
distance_x = LENGTH / (number of points in a column -1)
3D Spline Road will calculate the road height using cubic splines through the road height data points. See
Illustration of Grid keywords.
File Details
The first block of data, [MDI_HEADER], describes the TeimOrbit file:
[MDI_HEADER]
FILE_TYPE = 'rdf'
FILE_VERSION = 5.00
FILE_FORMAT = 'ASCII'
{COMMENTS}
'User entered comments go here'
MDI_HEADER Keywords
Units Details
The [UNITS] blocks defines the units for the road:
[UNITS]
LENGTH = 'meter'
FORCE = 'newton'
ANGLE = 'radians'
MASS = 'kg'
TIME = 'sec'
[UNITS] Keywords
Model Details
The [MODEL] block defines the road model and version:
[MODEL]
METHOD = '3D_SPLINE'
VERSION = 1.00
[MODEL] Keywords
Global Parameters
The [GLOBAL_PARAMETERS]block defines parameters applying to the entire road.
[GLOBAL_PARAMETERS]
CLOSED_ROAD = 'NO'
SEARCH_ALGORITHM = 'FAST'
ROAD_VERTICAL = '0.0 0.0 1.0'
FORWARD_DIR = 'NORMAL'
MU_LEFT = 0.5
MU_RIGHT = 0.6
WIDTH = 5.000
BANK = 0.0
[GLOBAL_PARAMETERS) Keywords
$-------------------------------------------------------DATA_POINTS
[DATA_POINTS]
{ X Y Z WIDTH BANK MU_LEFT MU_RIGHT
OBSTACLES }
12.50000E+00 4.60432E-15 0.00000E-00 7.000 0.000 0.900
0.900
10.50000E+00 4.60432E-15 0.00000E-00 7.000 0.000 0.900
0.900
5.50000E+00 4.60432E-15 0.00000E-00 7.000 0.000 0.900 0.900
CROWN
0.50000E+00 4.60432E-15 0.00000E-00 7.000 0.000 0.900 0.900
26 Adams/Tire
Adams/3D Spline Road Model
(CROWN_DATA)
{S HEIGHT CROWN}
7.00000E+00 0.00000E+00 0.00000E+00
8.00000E+00 1.25000E-02 3.12500E-03
9.00000E+00 5.00000E-02 1.25000E-02
1.00000E+01 8.75000E-02 2.18750E-02
1.10000E+01 1.00000E-01 2.50000E-02
1.20000E+01 1.00000E-01 2.50000E-02
1.30000E+01 1.00000E-01 2.50000E-02
1.40000E+01 1.00000E-01 2.50000E-02
1.50000E+01 1.00000E-01 2.50000E-02
1.60000E+01 1.00000E-01 2.50000E-02
In both cases, the Road Builder starts with the road_3d_sine_example.xml example road property file
loaded as shown in the figure below. The Road Builder consists of six tabs:
• Header - Displays header and units information and lets you enter comments. Learn more.
• Global - Sets parameters for the entire road. Learn more.
• Soil Properties - If road is used for the Soft Soil Tire model, the soil properties should be
entered. Learn more.
• Road Points - Sets parameters that define the points in the road. Learn more.
• Obstacle - Defines obstacles in the road. Learn more.
• Road Generator - Allows the user to create/modify road data file using segments. Learn more.
28 Adams/Tire
Adams/3D Spline Road Model
When you create a new 3D Spline Road property file, the default values of the road vertical are set to
(0.0, 0.0, 1.0). Note that the road vertical is normalized at the Adams/Solver level.
• To the right of the Road File text box, select the Browse button , and then browse for the
desired file.
Changing Units
Saving Changes
Enter
Comments
here
Tip: To help you correctly enter values, the units for the current parameter appear in the
Current Field Unit text box.
Road Models in Adams/Tire 31
Adams/3D Spline Road Model
Displays
units of
currently
selected
parameter
Displays
table of
points,
which can
edit
directly
To fit the display of the plot into the plotting window, do one of the following:
• Select Fit.
• Right-click the plot, and then select Fit.
Defining Obstacles
The Obstacle tab shows the 3D Spline Road obstacles (also called road perturbations). If there is more
than one road obstacle, the Obstacle tab displays the Obstacle table, as shown in the figure below. If there
is only one road obstacle, the Obstacle tab shows the Obstacle Property Editor. You can only create a new
obstacle in the Obstacle table.
For each obstacle, all parameters are stored in the XML format 3D Spline Road property file. This will
make it easy to change obstacle type for a particular obstacle if data already exists.
2. Select Add.
3. Enter the values for the obstacle as explained in Adams/3D Spline Road Perturbation Keywords
To rename an obstacle:
• Right-click the obstacle name in the table, select Rename Obstacle, and then enter a new name.
To delete an obstacle:
• Right-click the obstacle name in the table, select Delete Obstacle.
Tip: To help you correctly enter values, the units for the current parameter appear in the
Current Field Unit text box.
38 Adams/Tire
Adams/3D Spline Road Model
Parameters
common
to all
obstacles
Parameters
specific
to the
selected
obstacle
To create a new segment, enter segment name in the Name field and click Add button. Segment name
should be unique. To make it easier for the user to create road profile, some basic functions were created.
User can use these functions by giving appropriate values.
40 Adams/Tire
Adams/3D Spline Road Model
To see the road points click on Export points to Data Table this will calculate the road points according
to the segment function and export them to the Road Points tab in the GUI.
To see the road points in 2D click button Show X-Y Plot & Show X-Z Plot. To see the road profile with
shell graphics click on Generate 3d Road. To see in 3D, user should have Adams/Car license.
Description of Functions:
Linear:
This function will create a straight line between two given points. Inputs required are Number of points,
Start point, End point, Width, Bank, mu Left and mu Right.
Road Models in Adams/Tire 41
Adams/3D Spline Road Model
Curvature:
This function will create a curve. Inputs required for this function are Number of Points, Start point,
Center point, Tangent Point, Radius, Arc Length, Width, Bank, mu Left and mu Right.
42 Adams/Tire
Adams/3D Spline Road Model
Transition:
This function will connect the start and end point of the road. Inputs required for this are segment 1,
segment 1 point, segment 2, segment 2 point, Width, Bank, mu Left and mu Right.
User Defined Points:
This functionality allows the user to define their road points directly. This functionality is more useful in
the case when a user wants to use the existing road point which is already in the old road data file format.
Road Models in Adams/Tire 43
Adams/3D Spline Road Model
These blocks of data can appear in any order in the file, and keywords can appear in any order within the
block to which they belong.
The road property file can contain more data than what the 3D Shell Road currently requires. The 3D
Shell Road searches for the blocks and keywords it needs and disregards any additional information in
the file. Any line that is not recognized as input data is treated as a comment, and therefore skipped.
Therefore, you can use almost any character to begin a comment line, but we recommend that you use
$'s, !'s, or #'s to avoid confusion. Avoid using comment lines beginning with a square bracket ( [ ), or lines
that could interfere with keywords.
Tables must always appear as one set of data. No comment or empty lines are allowed between lines.
Tables must always have a header line beginning with a brace, ( { ).
48 Adams/Tire
Adams/Tire 3D Shell Road Model
A keyword and its value are separated by an equal sign (=). You must enter strings within single (' ') or
double (" ") quotes.
Examples of Blocks:
Units Block
Block header: [UNITS]
Keywords: Allowed values:
LENGTH = {'meter', 'mm', 'cm', 'km', 'inch', 'mile'}
Model Block
The method keyword in the block determines the road contact algorithm Adams/Tire uses. You must set
method='3D' to instruct Adams/Tire to use the 3D Shell Road algorithm.
Block header: [MODEL]
Keywords: Allowed values:
METHOD = {'3D'}
Nodes Block
Block header: [NODES]
Keywords: Allowed values:
NUMBER_OF_NODES = <an integer number>
Tabular data:
{ node x_value y_value z_value }
1 <a real number (X)> <a real number (Y)> <a real number (Z)>
2 <a real number (X)> <a real number (Y)> <a real number (Z)>
...
<an integer number> <a real number (X)> <a real number (Y)> <a real
number (Z)>
Elements Block
Block header: [ELEMENTS]
Keywords: Allowed values:
NUMBER_OF_ELEMENTS = <an integer number>
Tabular data:
{ node_1 node_2 node_3 mu }
<an integer number> <an integer number> <an integer number> <a real
number>
<an integer number> <an integer number> <an integer number> <a real
number>
...
<an integer number> <an integer number> <an integer number> <a real
number>
Road Models in Adams/Tire 49
Soft Soil Road Model
The predecessor of OpenCRG® is a format called CRG which has been used internally for several years
by Daimler AG. An entire suite of MATLAB® and FORTRAN tools had been developed for the handling,
evaluation and generation of CRG data.
This knowledge and a whole new series of tools including a new C-API shall be made available to the
broad public by means of the OpenCRG® initiative. Users shall be enabled to use all data, libraries and
code samples on this website with minimum opensource licensing restrictions.'
For details about the use and format of the CRG road files is referred to the users manual available at the
website. Below the use of CRG within Adams is explained.
The OpenCRG road can be used with any Adams/Tire tire model.
Note: Some .crg files contain binary formatted data blocks. Adding ascii statements in
such .crg file may easily destroy the format and make the file un-readable for the
OpenCRG code. One may avoid editing the existing .crg file by using the
$ROAD_CRG_FILE feature in a master .crg file. An example of a master file is the
sample_country_road_repositioned.crg in the acar_shared/tires.tbl folder.
Messaging by OpenCRG
By default the messaging level is set to writing out (fatal) errors only (level 1). Changing the messaging
level can be done by setting the environment variable CRG_MESSAGE_LEVEL:
Road Models in Adams/Tire 51
OpenCRG Road Model
CRG_MESSAGE_LEVEL = 0 dCrgMsgLevelNone
1 dCrgMsgLevelFatal
2 dCrgMsgLevelWarn
3 dCrgMsgLevelNotice
4 dCrgMsgLevelInfo
5 dCrgMsgLevelDebug
However, the user can specify his own detailed preferences for visualization by adding his specification
in a $ROAD_CRG_VISUALIZATION data block in the .crg file.
$ROAD_CRG_VISUALIZATION
visualization_increment_u = 0.25 !for grid size in long. direction
visualization_increment_v = 0.25 !for grid size in lat. direction
visualization_start_u = -10.0 !point where visualization starts
visualization_start_v = -5.0 !point where visualization starts
visualization_end_u = 700.0 !point where visualization ends
visualization_end_v = 5.0 !point where visualization ends
Adams/SmartDriver support
The .crg files can also be used for the desired path on the x-y plane in case of a ‘Full-Vehicle Analysis
Course Event' or a ‘Full-Vehicle Analysis Adams/SmartDriver’ analysis. The x and y
coordinates are derived by converting the u at v = 0 coordinates towards the x, y coordinate system. Also
the ‘Full-Vehicle Analysis Path Optimization’ tool can deal with the .crg files.
You can create tire or road models that extend the capabilities of Adams/Tire to better meet your needs.
You create a tire model by writing a TYRSUB subroutine that Adams/Tire calls to calculate tire forces
and moments. You create a road model by writing a ARCSUB subroutine that Adams/Tire calls to
determine the tire-road contact point, local road normal, and road coefficient of friction.
The sections introduce you to creating tire and road models:
• How Adams/Tire Works
• What Adams/Tire Expects Tire Models to Do
• Steps to Create a Tire or Road Model
• Example Tire Model
[MODEL]
METHOD = 'USER'
USER_SUB_ID = 400
Adams/Tire uses the road model implemented in subroutine ARC400.
• Adams/Tire then calls the tire model to initialize it. And, in turn, the tire model calls the road
model to initialize it.
• Adams/Tire also calls the tire model many times during a simulation, passing it the wheel states
(displacement, orientation, and velocity). The tire model calls the road model, which returns the
tire-road contact point, local road normal, and coefficient of friction. The tire model then
calculates the tire forces and moments and returns them to Adams/Tire.
The following figure shows the relationship between Adams/Tire, tire models, road models, and the tire
and road property files.
• Tire Models
• Road Models
Tire Models
Adams/Tire executes in two basic phases:
• Initialization - During the initialization phase, Adams/Tire expects a tire model to:
• Read parameters from the tire property file and return them to Adams/Tire for storage in
static memory.
• Call the road model so it can read the road property file.
• Simulation - During the simulation phase, Adams/Tire expects a tire model to:
• Call the road model to obtain the tire-road contact point, local road normal, and coefficient
of friction.
• Calculate tire forces and moments and return them in System International (SI) units
(Newton and Newton-meters) in the ISO-C (TYDEX) axis system (see About Axis Systems
and Sign Conventions).
• Return other results in an array for plotting and output. For example, return slip angle,
inclination angle, and effective rolling radius.
The interaction between Adams/Tire and tire models generally adheres to the TYDEX Working Group's
Standard Tire Interface v1.4 (STI v1.4).To learn more about how Adams/Tire interacts with tire models,
including the calling arguments for TYRSUB, see Creating Tire Models.
Road Models
Adams/Tire does not directly call road models. Instead, Adams/Tire calls the tire, and the tire model
(TYRSUB) calls the road model. Again, there are two basic phases of execution:
• Initialization - During initialization, Adams/Tire expects a road model to read parameters from
the road property file and return them through the tire model to Adams/Tire for storage in static
memory.
• Simulation - During simulation, road models calculate the tire-road contact point, local road
normal, and local coefficient of friction. The road model calculates these quantities based on the
location and orientation of the wheel center of the tire. To learn more about road models, see
Creating Road Models.
• How your tire model will calculate tire kinematic quantities, such as slip angle. Adams/Tire
provides utilities you might want to use (see Utilities for Reading Property Files).
• What outputs Adams/Tire requires for tire and road models. And, in the case of a tire model,
what additional quantities you might want to output.
2. Create an example property file for use with your tire or road model and the code to read the file.
Before you begin you need to know:
• What parameters your tire or road property files will contain, including those required by
Adams/Tire.
• How to read the parameters from the file and how to convert these parameters from the units
specified in the property file to SI units (meters-kilograms-seconds).
• Where to store the parameters in the tire (TYRARR) or road (ROPAR) parameters array so
Adams/Tire can save them between calls to your TYRSUB.
For more information, see Defining and Reading Tire Property Files.
3. Create a private version of an Adams/Car Adams/Solver user library (currently you cannot add a
user tire or road models outside of Adams/Car). To learn how, see Performing Simulations.
4. Test your tire or road model using a simple Adams model and the private Adams/Car
Adams/Solver user library. You can find a simple Adams model and Adams/Solver command file
for testing tires and roads at install_dir/solver/atire/test_rig.{adm,acf}. Access to a debugger is
helpful to verify that your tire model is working properly.
To learn more about the default Fiala tire model supplied with Adams/Tire, see Using the Fiala Handling
Force Model.
6 Adams/Tire
Creating Tire Models
include 'ac_sti_jobflg.inc'
include 'abg_varptr.inc'
ENDIF
CALL ROAD(....)
c Tire Kinematics
ENDIF
c Handle Errors
RETURN
END
Adams/Tire passes a pointer to the ROAD subroutine to your TYRSUB. Therefore, your TYRSUB
declares ROAD as an external and never knows the exact subroutine that is called. This allows your
TYRSUB to work with different road models without having to alter your TYRSUB.
Note: Adams/Tire provides utilities for calculating slip angle, inclination angle, longitudinal slip,
and other quantities in SAE coordinates. See Utilities for Reading Property Files.
Note: Adams/Car and Adams/Chassis use the effective rolling radius returned in the VARINF
array to calculate initial wheel rotational velocities. In addition, Adams/SmartDriver
examines the lateral and longitudinal slips returned in VARINF to determine how close a
vehicle is to its limit of adhesion. So if you plan to use your TYRSUB with these products,
you must load results in the VARINF array.
Handling Errors
According to TYDEX STI v1.4, a TYRSUB should not stop the execution of a simulation because of a
fatal error. Instead, it should use the IERR argument to return a fatal error and use the TYRMOD
argument to return an error message. The simulation code can then cleanly terminate execution. In
User-Written Tire/Road Models 9
Creating Tire Models
Adams/Tire, however, you can call the Adams/Solver utility, ERRMES, from your TYRSUB to output a
message to your screen and message file to terminate the Adams execution.
TYRSUB Arguments
The following sections provide an overview of the arguments in TYRSUB based on their function, and
then describes each argument in order of calling sequence:
• TYRSUB Calling Sequence
• TYRSUB Input Arguments
• TYRSUB Output Arguments
• TYRSUB Argument Descriptions
Job Control
There is only one job control argument: JOBFLG. The value of JOBFLG determines the task that
TYRSUB performs, such as reading the tire property file or evaluating the tire forces and moments.
Subroutine TYRXXX(
+ NDEV, ISWTCH, JOBFLG, IDTYRE,
+ TIME, DIS, TRAMAT, ANGTWC, VEL, OMEGA, OMEGAR,
+ NDEQVR, DEQVAR, NTYPAR, TYPARR,
+ NCHTDS, CHTDST, ROAD, IDROAD,
+ NROPAR, ROPAR, NCHRDS, CHRDST,
+ FORCES, TORQUE, DEQINI, DEQDER, TYRMOD,
+ NVARS, VARINF, NWORK, WRKARR,
10 Adams/Tire
Creating Tire Models
States
The tire states contain the displacement, orientation, and velocity information about the wheel and wheel
carrier (hub). The state arguments are:
Subroutine TYRXXX(
+ NDEV, ISWTCH, JOBFLG, IDTYRE,
+ TIME, DIS, TRAMAT, ANGTWC, VEL, OMEGA, OMEGAR,
+ NDEQVR, DEQVAR, NTYPAR, TYPARR,
+ NCHTDS, CHTDST, ROAD, IDROAD,
+ NROPAR, ROPAR, NCHRDS, CHRDST,
+ FORCES, TORQUE, DEQINI, DEQDER, TYRMOD,
+ NVARS, VARINF, NWORK, WRKARR,
+ NIWORK, IWRKAR, IERR)
Tire Properties
The tire properties arrays (TYPARR) contain the data that your TYRSUB reads from the tire property
file during initialization and returns to Adams/Tire. Adams/Tire stores this array statically.
The integer NTYPAR is the size of the TYPARR array, which is currently limited to 300.
Subroutine TYRXXX(
+ NDEV, ISWTCH, JOBFLG, IDTYRE,
+ TIME, DIS, TRAMAT, ANGTWC, VEL, OMEGA, OMEGAR,
+ NDEQVR, DEQVAR, NTYPAR, TYPARR,
+ NCHTDS, CHTDST, ROAD, IDROAD,
+ NROPAR, ROPAR, NCHRDS, CHRDST,
+ FORCES, TORQUE, DEQINI, DEQDER, TYRMOD,
+ NVARS, VARINF, NWORK, WRKARR,
+ NIWORK, IWRKAR, IERR)
Information
TYDEX STI supports the output of tire information, such as contact patch forces and slip angle, through
the variable information array (VARINF).
Subroutine TYRXXX(
+ NDEV, ISWTCH, JOBFLG, IDTYRE,
+ TIME, DIS, TRAMAT, ANGTWC, VEL, OMEGA, OMEGAR,
+ NDEQVR, DEQVAR, NTYPAR, TYPARR,
+ NCHTDS, CHTDST, ROAD, IDROAD,
+ NROPAR, ROPAR, NCHRDS, CHRDST,
+ FORCES, TORQUE, DEQINI, DEQDER, TYRMOD,
+ NVARS, VARINF, NWORK, WRKARR,
+ NIWORK, IWRKAR, IERR)
Error Handling
TYDEX STI states that the TYRSUB may not terminate execution of the calling program, but rather
should return an error code (IERR) and message text (TYRMOD). Adams/Tire modifies the standard and
allows TYRSUB to call the Adams/Solver utilities USRMES or ERRMES for purposes of error handling
and stopping execution, if desired.
Subroutine TYRXXX(
+ NDEV, ISWTCH, JOBFLG, IDTYRE,
+ TIME, DIS, TRAMAT, ANGTWC, VEL, OMEGA, OMEGAR,
+ NDEQVR, DEQVAR, NTYPAR, TYPARR,
+ NCHTDS, CHTDST, ROAD, IDROAD,
+ NROPAR, ROPAR, NCHRDS, CHRDST,
+ FORCES, TORQUE, DEQINI, DEQDER, TYRMOD,
+ NVARS, VARINF, NWORK, WRKARR,
+ NIWORK, IWRKAR, IERR)
12 Adams/Tire
Creating Tire Models
• NDEV • IDROAD
• ISWTCH • NROPAR
• JOBFLG • ROPAR
• IDTYRE • NCHRDS
• TIME • CHRDST
• DIS • FORCE
• TRAMAT • TORQUE
• ANGTWC • DEQINI
• VEL • DEQDER
• OMEGA • TYRMOD
• OMEGAR • NVARS
• NDEQVR • VARINF
• DEQVR • NWORK
• NTYPAR • WRKARR
• TYPARR • NIWORK
• NCHTDS • IWRKAR
• CHTDST • IERR
• ROAD
NDEV
An integer variable that contains the value of the logical output device number for error messages. We
recommend calling the Adams/Solver utilities USRMES or ERRMES rather than writing directly to the
NDEV device. This ensures proper handling of the error message. For more information, see USRMES
and ERRMES in the Adams/Solver Subroutines online help.
ISWTCH
An integer variable that contains the value of the USE_MODE control switch. Adams/Tire sets the
ISWTCH variable to zero in all cases except dynamic and quasi-static simulations (for example,
Adams/Solver modes 4 and 6). For dynamic and quasi-static simulations, ISWTCH = TYPARR(1).
Parameter in
Description: Value: ac_sti_jobflg.inc:
INITIALIZE JOBFLG = 2 INIT
RESET JOBFLG = 3 RESET
INQUIRE* JOBFLG = 1 INQUIRE
END SIMULATION JOBFLG = ENDSIM = ENDSIM
99
SUCCESSFUL JOBFLG = SSTEP = 4 SSTEP
INTEGRATION STEP*
NORMAL JOBFLG = NORMAL = NORMAL
EVALUATION 0
DERIVATIVE JOBFLG = DIFF = 5 DIFF
EVALUATION
* Indicates item is not supported in current version of Adams/Tire.
Currently, Adams/Tire does not support JOBFLG = sstep = 4 in its version of TYDEX STI.
When JOBFLG = sstep = 4, the input states (such as displacement and velocity) are converged
states.
• NORMAL EVALUATION (JOBFLG =normal = 0)
When called with JOBFLG = normal = 0, TYRSUB returns the tire forces and torques based on
the inputs.
• DERIVATIVE EVALUATION
(JOBFLG = diff = 5)
When called with JOBFLG = diff = 5, TYRSUB should return tire forces and torques based on
the inputs. Adams/Solver uses the returned value to estimate the partial derivatives of the forces
and torques with respect to the inputs.
IDTYRE
An integer variable that provides the ID of the GFORCE statement that applies the tire forces and
moments to the wheel.
TIME
A double-precision variable that provides the current simulation time.
DIS
A double-precision array of dimension three, which specifies the values of the wheel carrier translational
displacement (x, y, z) at the wheel center with respect to the road reference marker expressed in the road
reference marker's axis system in units of meters.
TRAMAT
A double-precision array of dimension 3 x 3, which specifies a transformation matrix used to transform
data from the wheel carrier axis system to the road reference marker axis system.
ANGTWC
A double-precision variable, which specifies the rotational angle of the wheel with respect to the wheel
carrier in radians.
VEL
A double-precision array of dimension three, which specifies the values of the wheel carrier translational
velocities (x, y, z) at the wheel center with respect to the road reference marker expressed in the wheel
carrier (ISO-C) axis system in units of meters/second.
User-Written Tire/Road Models 15
Creating Tire Models
OMEGA
A double-precision array of dimension three, which specifies the wheel carrier angular velocity at the
wheel center with respect to the road reference marker expressed in the wheel carrier (ISO-C) axis system
in units of radians/second.
OMEGAR
A double-precision variable that specifies the value of the rotational speed of the rim with respect to the
wheel carrier about the wheel's (rim's) spin axis in radians/second.
NDEQVR
An integer variable the dimension of DEQVAR, default is two, which means that Adams/Tire supports
tire models using two differential equations.
The number of states can be set by adding N_TIRE_STATES in the [MODEL] section of the tire
property file:
[MODEL]
N_TIRE_STATES = <number of required stated>
DEQVAR
A double-precision array that provides the values of the differential equations associated with the tire.
Note that to determine the values in the DEQVAR array, Adams/Tire integrates the derivatives that the
tire model returns in the DEQDER array.
NTYPAR
An integer variable that represents the dimension of the tire parameters array (TYPARR). If NTYPAR
equals zero, TYPARR contains no values.
TYPARR
The tire parameters array. A double-precision array of dimension NTYPAR that contains the values of
the tire model parameters. If the PROPERTY_FILE_FORMATin the tire property file is set to 'USER',
NTYPAR is set to zero and the tire property file name is passed to the STI in the CHTDSTstring. The
maximum size of TYPARR is 300.
NCHTDS
An integer variable that gives the number of characters in the tire property file name (CHTDST).
CHTDST
The tire property file name. A character variable of length 256 that provides the tire property file name
and path (for example: "/usr/people/cjones/tire.tpf ").
16 Adams/Tire
Creating Tire Models
ROAD
The external symbol name that provides the road contact subroutine that TYRSUB calls to determine the
local road normal and tire-road contact point.
IDROAD
An integer that specifies the branch flag for the road contact model method. The value is set according
to the contents of the road property file (.rdf). Reserved values are:
900 BEDPLATE used for suspension analysis
901 2D Handling (point follower) Contact method
902 2D Durability Contact method
903 3D Handling (point follower on a smooth road)
904 3D Durability Contact method
For more information, see Creating Road Models.
NROPAR
An integer variable that gives the dimension of ROPAR. If NROPAR equals zero, ROPAR contains no
values.
ROPAR
The road parameters array. A double-precision array of dimension NROPAR, which contains the values
of the road contact model parameters. If the method is set to 'USER' in the [MODEL] block of the road
property file, then NROPAR is set to zero, and the road property file name is passed to the STI in
character variable CHRDST. For more information, see Creating Road Models.
NCHRDS
An integer variable that provides the number of characters (length) of the road property file name.
CHRDST
The road property file name. A character variable of length 256 that holds the road property file name
and path, for example: /usr/people/cjones/road.dat.
FORCE
The tire force vector. A double-precision array of dimension three, that TYRSUB outputs. It provides tire
forces at the wheel center in Newtons expressed in the TYDEX-C (ISO-C) axis system.
TORQUE
The tire moment vector. A double-precision array of dimension three that the TYRSUB outputs. It
provides the tire moments at the wheel center in Newton-Meters expressed in the TYDEX-C (ISO-C)
axis system.
User-Written Tire/Road Models 17
Creating Tire Models
DEQINI
A double-precision array of dimension NDEQVR. It specifies the initial values of the differential
equations (DEQVAR) associated with the tire. When JOBFLG = inquire = 1, TYRSUB returns the initial
values of the differential equations. For other values of JOBFLG, the values returned in DEQINI are
ignored. Currently, Adams/Tire does not use values returned in DEQINI. The initial values of differential
equations are always set to zero.
DEQDER
A double-precision array of dimension NDEQVR. It provides the time derivative of the differential
equations (DEQVAR) associated with the tire. When JOBFLG = normal = 0 or JOBFLG = diff = 5,
TRYSUB must return values for DEQDER. For other values of JOBFLG, any values returned in DEQINI
are ignored.
TYRMOD
A character variable of length 256 containing a descriptive error message. Adams/Tire outputs the
message to the screen and message file (.msg) when the value of IERR is not equal to zero.
NVARS
An integer parameter giving the maximum size, currently 40, of the VARINF array. A TYRSUB must
not assign a value to NVARS.
VARINF
The tire-variable information array. A double-precision array of dimension NVARS for outputting
information, such as tire contact patch forces and slip angle, which the simulation does not use directly.
TYDEX STI specifies that the first six values of the VARINF array should hold the contact patch forces
and moments in the TYDEX-H (ISO-W) axis system.
NWORK
An integer parameter giving the dimension of the working array (WRKARR), currently one. A TYRSUB
must not assign a value to NWORK.
WRKARR
The working array. A static double-precision array of dimension NWORK the tire model may use as
desired. Currently, the working array is limited to a dimension of one. Adams/Tire stores these values for
each tire between calls to TYRSUB.
NIWORK
An integer parameter giving the dimension of the integer working array (IWRKAR), currently one. A
TYRSUB must not assign a value to NIWORK. As specified in TYDEX STI, when Adams/Tire adds
support for the JOBFLG = inquire = 1, TYRSUB can return the actual dimension of IWRKAR using
NIWORK.
18 Adams/Tire
Creating Tire Models
IWRKAR
The integer working array. A static integer array of dimension NIWORK, which is currently limited to
one, that TYRSUB can use as needed. Adams/Tire stores these values for each tire between calls to the
TYRSUB.
IERR
The integer variable giving an error value. Valid values are:
• 0 No error
• 1 Warning: Calling program should print message contained in TYRMOD
• 2 Error: Calling program must not use the outputs
• 3 Fatal Error: Calling program should stop execution.
User-Written Tire/Road Models 19
Defining and Reading Tire Property Files
Because Adams/Tire reads the above information from every tire property file, you must provide it in the
form shown in the next sections.
Besides the required data, your property file can contain any information in any form you want. If you
choose to structure the data in TeimOrbit format, MSC supplies a set of utilities for reading the data from
your file. These utilities include routines to obtain unit conversion factors so you can convert data to SI
units. For more information, see Utilities for Reading Property Files.
$----------------------------------------------------------------
units
[UNITS]
LENGTH
= 'mm'
FORCE
= 'newton'
ANGLE
= 'degree'
MASS
= 'kg'
TIME
= 'sec'
$----------------------------------------------------------------
model
[MODEL]
! use mode
1
2
! ---------------------------------
! smoothing
X
!
PROPERTY_FILE_FORMAT
= 'USER'
FUNCTION_NAME
= 'TYR501'
USE_MODE
= 2.0
$------------------------------------------------------------
dimension
[DIMENSION]
UNLOADED_RADIUS
= 309.9
WIDTH
= 235.0
ASPECT_RATIO
= 0.45
$-----------------------------------------------------------parameter
[PARAMETER]
VERTICAL_STIFFNESS
= 310.0
VERTICAL_DAMPING
= 3.1
ROLLING_RESISTANCE
= 0.0
CSLI
= 1000.0
CALPHA
= 800.0
CGAMMA
= 0.0
UMIN
= 0.9
User-Written Tire/Road Models 21
Defining and Reading Tire Property Files
UMAX
= 1.0
RELAXATION_LENGTH
= 0.0
$---------------------------------------------------------------shape
[SHAPE]
{radial width}
1.0
0.0
1.0
0.2
1.0
0.4
1.0
0.5
1.0
0.6
1.0
0.7
1.0
0.8
1.0
0.85
1.0
0.9
0.9
1.0
Required Blocks
Your tire property file must contain a specific set of blocks that Adams/Tire expects. These blocks can
appear in any order, and your tire property file can contain other blocks that you define. The blocks that
your tire property file must contain are:
• [MODEL] Block
• [UNITS] Block
• [DIMENSION] Block
• [PARAMETER] Block
[MODEL] Block
The [MODEL] block specifies the tire model that Adams/Tire will use. For your tire model, specify a
property file format of “USER”and a function name that is the entry point to the tire functions, such as:
[MODEL]
PROPERTY_FILE_FORMAT = “USER”
FUNCTION_NAME = “TYR501”
In the example above, Adams/Tire calls subroutine TYR501 to read the tire property file and to evaluate
the tire forces and moments.
22 Adams/Tire
Defining and Reading Tire Property Files
[UNITS] Block
A [UNITS] block specifies the units of the data in the tire property file. This enables Adams/Tire to
convert any data it reads from the tire property file to SI units (meters kilograms, Newtons, seconds,
radians). Any data your TYRSUB reads from the tire property file should also be converted to SI units,
as the example TYRSUB illustrates.
An example [UNITS] block is shown below:
[UNITS]
LENGTH
= 'mm'
FORCE
= 'newton'
ANGLE
= 'radians'
MASS
= 'kg'
TIME
= 'sec'
The allowed values for unit strings are:
Note: You can use the utility subroutine ATRTOU to read the [UNITS] block from a tire property
file and then use the utility subroutine ACUNFN to obtain unit conversion factors. For
more information, see ATRTOU and ACUNFN.
[DIMENSION] Block
The [DIMENSION] block specifies the tire's unloaded radius, width, and aspect ratio. Adams/Tire uses
these values to size wheel and tire graphics.
[DIMENSION]
UNLOADED_RADIUS = real_value > 0
WIDTH = real_value > 0
ASPECT_RATIO = 1 > real_value > 0
User-Written Tire/Road Models 23
Defining and Reading Tire Property Files
[PARAMETER] Block
The [PARAMETER] block specifies the vertical stiffness and damping of the tire. Adams/Tire makes this
information available to Adams/Car and Adams/Chassis during suspension analysis by incorporating a
test-rig tire.
[PARAMETER]
VERTICAL_STIFFNESS = real_value > 0
VERTICAL_DAMPING = real_value >= 0
24 Adams/Tire
Creating Road Models
include 'ac_sti_jobflg.inc'
ENDIF
ENDIF
c Handle Errors
RETURN
END
• CHRDST
• NSHAPE
• SHAPE
• UNLDRD
• WIDTH
JOBFLG
An integer variable that contains the value of the initialization flag. JOBFLG takes the value:
• 0 - Normal mode
• 1 - Subroutine must return the actual dimensions of NTYPAR, NDEQVR, NVARS, NIWORK,
NWORK(Not used in Adams/Tire)
• 2 - First initialization
• 3 - Re-initialization during simulation
• 4 - Successful step (not used in Adams/Tire)
• 5 - Adams/Solver is differencing (unique to Adams/Tire)
• 99 - Final simulation step (not used in Adams/Tire)
IDTYRE
An ID of the GFORCE statement that applies the tire forces and moments to the wheel.
TIME
A double-precision variable that contains the value of the current simulation time.
DIS
A double-precision array of dimension 3, which specifies the values of the wheel carrier translational
displacement (x, y, z) at the wheel center with respect to the road reference marker.
TRAMAT
A double-precision array of dimension 3 x 3, which specifies a transformation matrix used to transform
data from the wheel carrier coordinate system to the coordinate system of the road reference marker.
IDROAD
An integer that specifies the road model method (for example, 900 for ARC900).
NROPAR
An integer variable that represents the dimension of ROPAR. If NROPAR is equal to zero, ROPAR
contains no available values.
User-Written Tire/Road Models 27
Creating Road Models
ROPAR
A double-precision array of dimension NROPAR, which contains the values of the road model
parameters. If [MODEL] -> METHOD in the road property file is set to 'USER', NROPAR is set to zero
and the road property file name is passed to the STI in the CHRDST string.
NCHRDS
An integer that represents the dimension of CHRDST.
CHRDST
A character string of dimension NCHRDS, which contains the name of the road property file. The
CHRDST string contains the full path of the file up to a maximum of 256 characters.
NSHAPE
An integer that represents the dimension of SHAPE. If NSHAPE = 0, then the cross section defaults to a
cylindrical shape.
SHAPE
A double-precision array of dimension (2,NSHAPE) representing the shape of the tire carcass cross-
section:
• 1 = Radius [%]
• 2 = Width [%]
For example, the following shows how data is stored in the SHAPE array:
Shape (1) = First
fractional radius
Shape (2) = First
fractional width
Shape (3) = Second
fractional radius
Shape (4) = Second
fractional radius
28 Adams/Tire
Creating Road Models
NSHAPE
An integer that represents the dimension of SHAPE. If NSHAPE = 0, then the cross section defaults to a
cylindrical shape.
SHAPE
A double-precision array of dimension (2,NSHAPE) representing the shape of the tire carcass cross-
section:
• 1 = Radius [%]
• 2 = Width [%]
UNLDRD
A double-precision variable that specifies the unloaded radius.
WIDTH
A double-precision variable that specifies the total width of the tire.
NROAD
An integer value that is used to define the surface type. NROAD takes the following values:
• 0 - No road data
• 1 - In contact with the road
User-Written Tire/Road Models 29
Creating Road Models
EFFVOL
A double-precision variable that contains the value of the effective penetrated volume between the tire
carcass and the road.
EFFPEN
A double-precision variable that contains the value of the effective penetration between the tire carcass
and the road.
RCP
A double-precision array of dimension three, which contains the values of the contact point location
relative to the road reference marker.
RNORM
A double-precision array of dimension three, which contains the road normal vector. This vector is
directed out (upward) from the road surface.
SURFAC
A double-precision variable that contains the value of the average surface friction.
IERR
An integer variable giving the error status of the road contact subroutine. IERR takes the following
values:
• 0 = No error
• 1 = Warning
• 2 = Error - Do not use the results
• 3 = Fatal Error
ERRMSG
A character string of dimension 80 that contains descriptive error messaging that is passed to the main
tire calling routine through TYRMOD.
Note: Inside the road model, STOP statements are not allowed.
30 Adams/Tire
Utilities for Reading Property Files
A subblock is always the child of a block. A table can be a child of either a block or a subblock.
For example, a TeimOrbit file might contain the following blocks and subblocks:
[BLOCK_1]
PARAMETER_1 = 1.0
(SUB-BLOCK_1)
PARAMETER_2 = 2.0
{TABLE_1}
1.0 2.0
2.0 3.0
[BLOCK_2]
PARAMETER_2 = 'TWO'
{TABLE_2}
1.0 2.0
2.0 3.0
(SUB-BLOCK_2)
PARAMETER_1 = 'ONE'
Parameters and tables are located for reading according to the block and/or subblock in which they reside.
Therefore, PARAMETER_2 in BLOCK_2 is not confused with PARAMETER_2 in BLOCK_1. This
example, which uses realistic names, illustrates where parameter are placed:
User-Written Tire/Road Models 31
Utilities for Reading Property Files
[VERTICAL_DATA]
STIFFNESS = 310.0
DAMPING = 14.3
[LATERAL_DATA]
STIFFNESS = 232.0
DAMPING = 11.2
Any strings beginning with a dollar sign "$" are ignored and, therefore, are used as comments. Before
you create your own property file, we recommend that you review some existing files to learn how they
are structured.
ACUNFN
Calling Sequence
Subroutine ACUNFN ( UNITS, CV2MDL, CV2SI )
Description
Given unit strings read from a property file, ACUNFN returns conversion factors from property file units
to model and SI units. Generally, you proceed a call to ACUNFN by a call to ATRTOU to read the
[UNITS] block from a property file.
You use the unit conversion factors that ACUNFN returns to convert data read from a property file to
either model or SI units (Newtons, kilograms, meters, seconds, radians). For example, if you read a
damping coefficient from a property file that has units of force*time/length and you need to convert that
value to model units, then you might do the following:
damp_coeff = damp_coeff*CV2MDL(1)*CV2MDL(4)/CV2MDL(3)
Arguments
ACUNFN_F2C
Calling Sequence
Subroutine ACUNFN_F2C ( FORCE, MASS, LENGTH, TIME, ANGLE, CV2MDL, CV2SI)
Description
Provides an entry point to ACUNFN from C-language routines.
Arguments
ACUNMP
Calling Sequence
Subroutine ACUNMP ( UN_IN, UN_OUT )
Description
Maps standard property file (Adams/View) unit strings to Adams/Solver unit strings.
User-Written Tire/Road Models 35
Utilities for Reading Property Files
Arguments
ATRTOU
Calling Sequence
SubroutineATRTOU (ID, UNITS)
Description
Reads the [UNITS] block from a property file and returns a character array containing the unit strings for
force, mass, length, time, and angle. Use ATRTOU with ACUNFNto obtain conversion factors from
property file units to model units or SI units.
Before calling ATRTOU, you must call RTO_OPEN_FILE_F2C to open the property file for reading. If
the [UNITS] block is not found in the file or there is a problem reading one of the unit strings, ARTOU
writes a message to the message file and terminates Adams/Solver execution.
36 Adams/Tire
Utilities for Reading Property Files
Arguments
RTO_CLOSE_FILE_F2C
Calling Sequence
Subroutine RTO_CLOSE_FILE_F2C (FileName, FileNameLen, Success)
Description
Closes a previously opened file.
Arguments
RTO_OPEN_FILE_F2C
Calling Sequence
Subroutine RTO_OPEN_FILE_F2C (FileName, FileNameLen, Success)
Description
Opens a file for reading by the TeimOrbit utilities.
Note: Before using any of the other RTO utilities, you must first open a file using this subroutine.
Arguments
RTO_READ_INTEGER_F2C
Calling Sequence
Subroutine RTO_READ_INTEGER_F2C (
BlockName, BlockNameLen,
AttributeName, AttribNameLen,
Value, Success )
Description
Reads an integer value assigned to an attribute in a block in the open file. For example, the call:
CALL RTO_READ_INTEGER_F2C( 'GEAR_RATIOS', 11,
+ 'N_GEARS', 7, Value, Success)
will read this from an open file:
[GEAR_RATIOS]
N_GEARS = 5
On return, the integer variable Value is 5 and Success is 1.
Arguments
RTO_READ_QUOTED_STRING_F2C
Calling Sequence
Subroutine
User-Written Tire/Road Models 39
Utilities for Reading Property Files
RTO_READ_QUOTED_STRING_F2C
( BlockName, BlockNameLen,
AttributeName, AttribNameLen,
Value, ValueLen, Success )
Description
Reads the string associated with an attribute in a block of a file. For example, the call:
CALL RTO_READ_QUOTED_STRING_F2C( 'MYBLOCK', 7, 'MYSTRING',
+ 8, Value, ValueLen, Success)
reads the data:
[MYBLOCK]
MYSTRING = 'heretofore'
On return:
• The character array Value holds ‘heretofore’
• The integer ValueLen is 10
• Success is 1
Arguments
RTO_READ_REAL_F2C
Calling Sequence
Subroutine RTO_READ_REAL_F2C (
BlockName, BlockNameLen,
AttributeName, AttribNameLen,
Value, Success)
Description
Reads a real value assigned to an attribute in a block in the open file. For example, the call:
CALL RTO_READ_INTEGER_F2C('GEAR_RATIOS', 11,
+ 'FINAL_DRIVE', 11, Value, Success)
reads this data from an open file:
[GEAR_RATIOS]
FINAL_DRIVE = 4.11
On return, the variable Value is 4.11 and Success is 1.
Arguments
RTO_READ_SUBBLOCK_INTEGER_F2C
Calling Sequence
Subroutine RTO_READ_SUBBLOCK_INTEGER_F2C (
BlockName, BlockNameLen,
User-Written Tire/Road Models 41
Utilities for Reading Property Files
SubBlockName, SubBlockNameLen,
AttributeName, AttribNameLen,
Value, Success)
Description
Reads an integer value assigned to an attribute in a subblock of a block in the open file. For example, the
call:
CALL RTO_READ_SUBBLOCK_INTEGER_F2C( 'TIRE_DATA', 9,
+ 'LATERAL_FORCE', 13, 'N_SLIP_ANGLES', 13,
+ Value, Success )
reads this data from the file:
[TIRE_DATA]
(LATERAL_FORCE)
N_SLIP_ANGLES = 6
On return, the integer variable Value is 6 and Success is 1.
Arguments
RTO_READ_SUBBLOCK_REAL_F2C
Calling Sequence
Subroutine
RTO_READ_SUBBLOCK_REAL_F2C (
BlockName, BlockNameLen, SubBlockName, SubBlockNameLen,
AttributeName, AttribNameLen,
Value, Success)
Description
Reads a real value assigned to an attribute in a subblock of a block in the open file. For example, the call:
CALL RTO_READ_SUBBLOCK_REAL_F2C( 'FORCES', 6, 'FY', 2,
+ 'DAMPING_COEFF', 13, Value, Success )
reads this data from an open file:
[FORCES]
(FY)
DAMPING_COEFF = 1.72
On return, the variable Value is 1.72 and Success is 1.
Arguments
RTO_READ_SUBBLOCK_STRING_F2C
Calling Sequence
Subroutine RTO_READ_SUBBLOCK_STRING_F2C (
BlockName, BlockNameLen,
SubBlockName, SubBlockNameLen,
AttributeName, AttribNameLen,
Value, ValueLen, Success )
Description
Reads a string assigned to an attribute in a subblock of a block in the open file. For example, the call:
CALL RTO_READ_SUBBLOCK_STRING_F2C( 'FORCES', 6, 'FY',
+ 2, 'DAMPING', 7, Value, ValueLen, Success )
reads the data:
[FORCES]
(FY)
DAMPING = 'on'
On return:
• Character array Value holds ‘on’
• The integer ValueLen is 2
• Success is 1
Arguments
RTO_READ_TABLE_LINE_F2C
Calling Sequence
Subroutine RTO_READ_TABLE_LINE_F2C
(Value, ValueLen, Success)
Description
Reads a single line from a table. Use RTO_READ_TABLE_LINE_F2C after first locating the start of
table using either RTO_START_TABLE_READ_F2C or
RTO_START_SUBBLOCK_TABLE_READ_F2C. Typically, you use
RTO_READ_TABLE_LINE_F2C in a while loop to read an entire table. For example, to read this table:
[MYBLOCK]
{ X Y }
0.0 0.24
0.1 0.48
0.3 0.96
Use code, such as the following:
c --- Locate the start of the table ---
CALL RTO_START_TABLE_READ_F2C( 'MYBLOCK', 7,
User-Written Tire/Road Models 45
Utilities for Reading Property Files
RTO_START_SUBBLOCK_TABLE_READ_F2C
Calling Sequence
Subroutine RTO_START_SUBBLOCK_TABLE_READ_F2C (
BlockName, BlockNameLen, SubBlockName, SubBlockNameLen,
Format, FormatLen, Success )
46 Adams/Tire
Utilities for Reading Property Files
Description
Locates the start of a table in a subblock of a block in a file before calling
RTO_READ_TABLE_LINE_F2C. There can be only one table per subblock. The start of a table is
denoted by braces {" and "}. For example, the call:
CALL RTO_START_SUBBLOCK_TABLE_READ_F2C
( 'MYBLOCK', 7,
+ 'MYSUBBLOCK', Format, FormatLen, Success)
Searches for this data in the open file:
[MYBLOCK]
(MYSUBBLOCK)
{ S FX FY }
0.0 1.15 -2.13
0.1 2.15 -2.13
0.2 1.48 -2.13
On return:
• Format contains the string, “ _S_FX_FY”
• FormatLen contains the integer 9
• Success contains the integer 1
Arguments
RTO_START_TABLE_READ_F2C
Calling Sequence
Subroutine RTO_START_TABLE_READ_F2C (
BlockName, BlockNameLen, Format, FormatLen, Success)
Description
Locates the start of table in a block in a file before calling RTO_READ_TABLE_LINE_F2C. There can
be only one table per block. The start of a table is denoted by braces {" and "}. For example, the call:
CALL RTO_START_TABLE_READ_F2C( 'MYBLOCK', 7, Format,
+ FormatLen, Success)
Searches for this data in the open file:
[MYBLOCK]
{ X Y }
0.0 0.24
0.1 0.48
0.3 0.96
On return:
• Format contains the string, " XY"
• FormatLen contains the integer 6
• Success contains the integer 1
Arguments
ACTCLC
Calling Sequence
SUBROUTINE ACTCLC(TRAMAT, VEL, OMEGA, OMEGAR, RADIUS, RNORM,
VLON, VCPLON, VCPLAT, VCPVRT,
ALPHA, GAMMA, KAPPA,
URAD, CPMTX)
Description
Given the wheel/tire's orientation (TRAMAT) and velocity (VEL, OMEGA, OMEGAR) relative to the
road and the local road normal (RNORM), ACTCLC computes tire kinematics in the SAE axis system.
The tire kinematics are:
• Contact-patch velocities
• Slip angle (ALPHA)
• Inclination angle (GAMMA)
• Longitudinal slip (KAPPA)
• SAE contact-patch axis system (CPMTX)
• Unit vector directed from the wheel center to the contact patch (URAD)
Arguments
ACTFZ
Calling Sequence
SUBROUTINE ACTFZ (VCPVRT, RADIUS, TIREK, TIREC, UNLRAD,
FRCRAD, ERRMSG, IERR)
Description
ACTFZ uses the contact-patch vertical velocity in the SAE coordinate system to compute the radial
damping. It replaces PNTFRC for calculating tire vertical force.
User-Written Tire/Road Models 51
Utilities for Calculating Tire Forces and Moments
Arguments
XCP2HB
Calling Sequence
SUBROUTINE XCP2HB(FCP, TCP, RAD, TRNMTX, FORCES, TORQUE)
Description
XCP2HB transforms the contact-patch forces and torques to hub forces and torques expressed in the road
reference marker axis system:
forces = [cpmtx]fcp
torque = rad X ([cpmtx]fcp) + [cpmtx]tcp
Arguments
Edged Plank
Appendix 3
Example of specifying cleat_length
Illustration of Crown
6 Adams/Tire
Illustration of Grid keywords
Rounded Plank