Professional Documents
Culture Documents
12 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 vehicledurability 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 Module Adams/Tire Handling incorporates the following tire models for use in vehicle dynamic studies:
Using the PAC2002Tire Model* Using the PAC-TIME Tire Model Using Pacejka '89 and '94 Models* Using the Fiala Handling Force Model Using the UA-Tire Model
13
Welcome to Adams/Tire
521-Tire Model
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. Adams/Tire 3D Spline Road Module Adams/3D Spline Road lets you define an arbitrary three-dimensional smooth road surface. In addition, you can place three-dimensional road obstacles, such as a curb, pothole, ramp, or road crown, on top of the underlying smooth road surface. You can use the 3D Spline Road Module with any of the tire models in Adams/Tire. Use the smooth road part in combination with any of the handling tire models, or use the more advanced FTire to deal with road obstacles for ride and comfort and durability analysis. Adams/Tire 3D Shell Road Module Adams/Tire 3D Shell Road uses a three-dimensional equivalent-volume method to calculate tire normal force on three-dimensional roads for use in predicting vehicle loads for durability studies. You can use the Pacejka 2002, Pacejka TIME, Pacejka '89, Pacejka '94, or Fiala models to calculate the tire handling forces and moments (lateral force, longitudinal force, aligning torque, and so on). Specific Tire Models In addition to the tire models in the Adams/Tire Handling Module, Adams/Tire supplies specific tire models:
Pacejka Motorcycle Tire Model
A Pacejka tire model suitable for motorcycle handling analysis. It describes the tire-road interaction forces with tire-road inclination angles up to 60 degrees.
Adams/Tire FTire Module
FTire can describe the 3D tire dynamic response up to 120 Hz and beyond, due to its flexible ring approach for the tire belt. It can handle any road obstacle. All tire models support the Adams/Linear functionality.
14 Adams/Tire
Features in Adams/Tire Modules The table below lists the features available in Adams/Tire modules. Adams/Tire modules: Adams/Tire Handling Features: Fiala Tire Model Pacejka '89* Tire Model Pacejka '94* Tire Model Pacejka 2002 Tire Model Pacejka TIME Tire Model UA-Tire Tire Model 2D Road Models ----------------------------------5.2.1 Tire 5.2.1 Tire Methods: - Equation Method - Interpolation Method 5.2.1 Road Methods: - Point Follower - Equivalent Plane Requirements: Full Simulation Package
Adams/Tire 3D Spline Road Fiala Tire Model 3D Smooth Road and Road pertubations Adams/Tire FTire 2D FTire Model 3D FTire Model 2D Road Models
15
Welcome to Adams/Tire
16 Adams/Tire
12 Adams/Tire
13
Learning Adams/Tire Basics
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. 2. Reference an existing tire property file from:
14 Adams/Tire
Adams/Tire (/install_dir/solver/atire) Tire manufacturers or testing companies. Files that you create. For example, you can create your own tire property file for simple kinds
of tire models, such as the Fiala model. You can find examples of tire property files for all tire models in the Adams installation directory at: install_dir/solver/atire where install_dir/ is the path to the installation directory for Adams/Tire. 3. Reference an existing road property file. You can find an example road property file for a flat road in the Adams installation directory: install_dir/solver/atire/mdi_2d_flat.rdf where install_dir/ is the path to the installation directory for Adams/Tire. 4. Run a simulation of your model. You can run a simulation using Adams/Cars version of Adams/Solver (you do not need an Adams/Car license) or you can create an Adams/Solver user library and then run your simulation using this library and Adams/Solver. For more information, see Performing Simulations. 5. View the results of the simulation in a postprocessor, such as Adams/PostProcessor.
15
Learning Adams/Tire Basics
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. Determining Tire and Road Model to Use Inside Adams/Tire, the Tire Object Manager examines the tire property file to determine the tire model (for example, Fiala or Pacejka 89) to use and examines the road property file to determine the road model (for example, 2D or 3D) to use. 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.
16 Adams/Tire
The tire model returns the forces and moments to Adams/Solver. Adams/Solver applies the forces and moments to the wheel part.
17
Learning Adams/Tire Basics
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
18 Adams/Tire
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.
19
Learning Adams/Tire Basics
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.
Statements Needed for Defining Tires For each tire you want to add to your model, you must create a set of statements in your model. This can be done using the dialog box in Adams/View (see Defining Tires in Adams/View) or manually using a text 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.
20 Adams/Tire
Statements Needed for Adding Tires to Your Model Statement types: MARKER (3) Purpose in dataset:
Wheel center marker - Identify the wheel part, the wheel center
location and orientation, and the location for applying tire force movements. Use as the GFORCE I marker.
Road floating marker - Identify the road part to the GFORCE for
road. Use as the GFORCE RM marker. You must locate and orient the MARKER statements as described in MARKER Locations and Orientations. GFORCE (1) DIFF (2) Apply the tire force and moments to the wheel part. Integrate internal tire states for lag effects.
REQUEST (Up to 11) Output tire kinematics and forces (longitudinal slip, slip angle, camber angle, contact patch forces, and moments). For more information, see Performing Simulations and Viewing Results. STRING (5) Identify the tire property file, road property file, and other miscellaneous information. 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.
21
Learning Adams/Tire Basics
MARKER Locations and Orientations Marker statements required in dataset: Wheel center marker
Location and orientation: 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
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. 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 markers 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 , PART = 99
22 Adams/Tire
, 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) ! adams_view_name='tire_forces_contact_patch_ISO'
23
Learning Adams/Tire Basics
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
24 Adams/Tire
Creating a Road
tool.
From the Build menu, point to Forces, and then select Special Force: Tire.
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.
25
Learning Adams/Tire Basics
2. Enter the values as desired to define the tire, and then select OK.
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. To create the road: 1. Display the Create Wheel and Tire dialog box as explained in step 1 above.
26 Adams/Tire
2. Right-click the Road text box, point to vpg_road, and then select Create. The Create Road dialog box appears.
3. Enter the values as desired, and then select OK.. 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 Handling and Motorcycle Modules For tire models in the Adams/Tire Handling Module and the Pacejka Motorcycle Tire model, the inertia given for the wheel part must be equal to the total inertia of the tire and the rim.
27
Learning Adams/Tire Basics
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.
28 Adams/Tire
mdi acar ru-solver On Windows, from the Start menu, point to Programs, point to MSC.Software, point to MD R2 Adams, point to ACar, and then select Adams - Car (solver).
On UNIX, from the Adams Toolbar, right-click the Adams/Car
Adams/Car - Solver. Note: You can also set the Adams/Car tool on the Adams Toolbar to automatically run Adams/Car with Adams/Solver.
To create an Adams/Solver user library: 1. Copy the file install_dir/solver/atire/atire.f to your local directory. 2. Using atire.f, create a user Adams/Solver library: a. In a command window, enter the command, where mysol.dll is the name of the library:
For UNIX, enter:
mdi cr-user n atire.f -n mysol.dll exit b. On Windows, from the Start button, point to Programs, point to MSC.Software, point to MD R2 Adams, point to ASolver, and then select Create Custom Solver. Follow the menu selections to create a private or site library.
29
Learning Adams/Tire Basics
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. . Note: On Windows, you can now enter the FORTRAN file directly without first compiling it.
(assuming your library was mysol): a. For UNIX, enter: mdi -c ru-user i mysol . b. For Windows, enter: mdi -c ru-user i mysol .
On Windows, from the Start menu, point to Programs, point to MSC.Software, point to MD
R2 Adams, point to ASolver, and then select Run Custom Solver. Enter the name of the library you want to run.
On UNIX, from the Adams Toolbar, right-click the Adams/Solver
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.
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:
902 - Branch flag for tire request subroutine. REQTYP - Integer code fixing the information output to the request file. Valid values are
{1,2,3,4,5,6,7,8,9,10,11}. The output for each value of REQTYP is described in the table, Tire Outputs.
TIR_ID - Tire GFORCE statement ID.
For information on the axis systems and sign conventions for these outputs, see About Axis Systems and Sign Conventions.
Example of a request in a dataset.
30 Adams/Tire
Tire Outputs Output: Tire rolling states REQTYP Request: 1 Component definitions: x = rolling radius y= z=
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 in TYDEX-W axis (ISO) system. x = longitudinal slip (%) y = lateral slip angle (degrees) z = inclination angle (degrees) Tire contact patch forces 3 in TYDEX-W axis (ISO) system x = longitudinal force (model units) y = lateral force (model units) z = vertical force (model units) r1 = residual overturning moment (model units) r2 = rolling resistance moment (model units) r3 = aligning moment (model units) Tire contact patch forces 4 in SAE axis system x = longitudinal force (model units) y = lateral force (model units) z = vertical force (model units) r1 = residual overturning moment (model units) r2 = rolling resistance moment (model units) r3 = aligning moment (model units) Tire kinematic properties 5 in SAE axis system x = longitudinal slip (%) y = lateral slip angle (radians) z = inclination angle (radians)
31
Learning Adams/Tire Basics
REQTYP Request: 6
Component definitions: x = longitudinal force (model units) y = lateral force (model units) z = vertical force (model units) r1 = overturning moment (model units) r2 = rolling resistance moment (model units) r3 = aligning moment (model units)
x = longitudinal lag (du/dt)* y = lateral lag (du/dt)* z = longitudinal coefficient of friction r1 = lateral coefficient of friction r2 = FXMAX = DX + SVX (peak shift) r3 = FYMAX = DY + SVY (peak shift)
x = pneumatic trail * y = residual aligning moment at contact patch in ISO z = FX moment arm* r1= longitudinal relaxation length* r2 = lateral relaxation length* r3 = gyroscopic moment*
32 Adams/Tire
Output:
REQTYP Request:
Component definitions: x = distance traveled* y = effective plane height* z = effective plane angle* r1= effective plane curvature* r2 = contact length*
Contact patch locations (the contact patch location along the plane of the tire in the GFORCE reference markers coordinate system.)
10
x = road contact point X location y = road contact point Y location z = road contact point Z location r1 = tire radial penetration into the road surface r2 = tire radial penetration velocity into the road surface 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
33
Learning Adams/Tire Basics
ISO-C (TYDEX C) Axis System The TYDEX STI specifies the use of the ISO-C axis system for calculating translational and rotational velocities, and for outputting the force and torque at the tire hub. The properties of the ISO-C axis system are:
The origin of the ISO-C axis system lies at the wheel center. The + x-axis is parallel to the road and lies in the wheel plane. The + y-axis is normal to the wheel plane and, therefore, parallel to the wheels spin axis. The + z-axis lies in the wheel plane and is perpendicular to x and y (such as z = x x y).
34 Adams/Tire
ISO-W (TYDEX W) Contact-Patch Axis System The properties of the ISO-W (TYDEX W) axis system are:
The origin of the ISO-W contact-patch system lies in the local road plane at the tire contact
point.
The + x-axis lies in the local road plane along the intersection of the wheel plane and the local
road plane.
The + z-axis is perpendicular (normal) to the local road plane and points upward. The + y-axis lies in the local road plane and is perpendicular to the + x-axis and + z-axis (such as
35
Learning Adams/Tire Basics
Road Reference Marker Axis System The road reference marker axis system is the underlying coordinate system that Adams/Tire uses internally. For example, the tire translational displacement and local road normal for a three-dimensional road are expressed in the axis system of the road reference marker. The properties of the reference marker axis system are:
The GFORCE reference marker defines the axis system. The + z-axis points upward.
36 Adams/Tire
Conventions for Naming Variables Variable name and abbreviation: Slip angle
Description: The angle formed between the direction of travel (velocity) of the center of the tire contact patch and the ISO-W: x-axis. If the wheel-travel direction has a component in the ISO-W: +y direction, a is positive. 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. The angle formed between the ISO-W: x-z plane and the wheel plane. If the wheel plane has a component lying in the direction of ISO-W, the inclination angle is positive. The ratio of the longitudinal-slip velocity of the contact patch to the longitudinal velocity of the wheel. The longitudinal slip is positive during acceleration of a moving tire and negative during braking. Longitudinal slip is limited to the range -1 to +1. The x-component of the force exerted by the road or tire.
(WactualWfree)/Wfree
Longitudinal force at contact patch Lateral force at contact patch Normal force at contact patch Overturning moment at contact patch Rolling resistance moment Aligning moment Spin axis
Fx
Fy
The y-component of the force exerted by the road or tire. Lateral force may be produced by one or any combination of the following: slip angle, inclination angle, conicity, or plysteer. The z-component of the force exerted by the road or tire. The direction of this force is up. The moment of the forces at the contact patch acting on the tire by the road with respect to the ISO-W: x-axis. The moment of the forces at the contact patch acting on the tire by the road with respect to the y-axis. The moment of the forces at the contact patch acting on the tire by the road with respect to the z-axis. The axis about which the wheel rotates. Perpendicular to the wheel plane, not necessarily about the ISO-C: y-axis (only if inclination angle is zero). The wheel plane is normal to the wheel spin axis.
Fz
Mx
My
Mz Spin Axis
37
Learning Adams/Tire Basics
Variable name and abbreviation: Wheel ISO W:X heading along road Direction to the left along the road Z-coordinate ISO W:Y
Description: 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. The direction to the left along ground as viewed from behind a forward rolling tire. Expressed as right-hand orthogonal to the definitions of x' and z' (such as y = Z x X). Perpendicular to the road in the neighborhood of the origin of the tire axis system in a positive (downward) direction. (If the road is flat and in the x-y plane, this is negative global z.)
ISO W:Z
38 Adams/Tire
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 The unit: Kilometers Meters Centimeters Millimeters Miles Feet Inches Time Units The unit: Milliseconds Seconds Minutes Hours Angle Units The units: Degrees Radians Can be abbreviated: 'DEG' 'RAD' Can be abbreviated: 'MILLI' 'SEC' 'MIN' 'HOUR' Can be abbreviated: 'KM' 'METER' 'CM' 'MM' 'MILE' 'FOOT' 'IN'
39
Learning Adams/Tire Basics
Mass Units The unit: Kilograms Grams Pound-Mass Kilo-Pound-Mass Slugs Ounce-mass Force Units The unit: Kilograms-Force Newtons Kilo-Newtons Pounds-force Kilo-Pound-Force Dynes (gram-cm/sec2) Ounce-force Can be abbreviated: KG_FORCE' 'NEWTON' or 'N' 'KNEWTON' or 'KN' 'POUND_FORCE' 'KPOUND_FORCE' DYNE' 'OUNCE_FORCE' Can be abbreviated: 'KG' 'GRAM' 'POUND_MASS' 'KPOUND_MASS' 'SLUG' OUNCE_MASS'
40 Adams/Tire
Tire Models
12 Adams/Tire
references.
Tire kinematic states, such as slip angle ( ), which Adams/Tire calculates.
The following table summarizes the input that the Fiala tire model uses to calculate force.
13
Tire Models
Input for Calculating Tire Forces Quantity: Mt Alpha Ss pen Vpen Vertical_dampin g Description: Mass of tire Slip angle Longitudinal slip ratio Use by Fiala:
Damping Vertical force (Fz)
Source:
Tire kinematic state from Adams/Solver Tire kinematic state from Adams/Solver Tire kinematic state from Adams/Solver Tire kinematic state from Adams/Solver Tire property file (.tir) Tire property file (.tir) Tire property file (.tir)
Penetration (tire deflection) Vertical force (Fz) d/dt (penetration) Vertical damping coefficient Vertical force (Fz)
Damping Vertical force (Fz)
Longitudinal force (Fx) Partial derivative of longitudinal force (Fx) with respect to longitudinal slip ratio (S) at zero longitudinal slip Partial derivative of lateral force (Fy) with respect to slip angle ( ) at zero slip angle Coefficient of friction with full slip (slip ratio = 1) Coefficient of friction at zero slip Lateral force (Fy)
CALPHA
UMIN UMAX
Tire property file (.tir) Tire property file (.tir) Tire property file (.tir)
14 Adams/Tire
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the wheel rotational velocity
The lateral slip velocity is equal to the lateral speed in the contact point with respect to the road plane: V sy
The practical slip quantities (longitudinal slip) and velocities in the contact point:
Lagged longitudinal and lateral slip quantities (transient tire behavior) In general, the tire rotational speed and lateral slip will change continuously because of the changing interaction forces in between the tire and the road. Often the tire dynamic response will have an important role on the overall vehicle response. For modeling this so-called 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 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.
15
Tire 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: ------ --------
v1 1 dv 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. A similar approach yields the following for the deflection of the string in longitudinal direction: --------
du 1 + V x u 1 = V sx dt
16 Adams/Tire
u1 = ----- sgn ( V x )
' and ' are used instead of the usual and definitions for steady-
The longitudinal and lateral relaxation length are read from the tire property file, see Fiala Tire Property File Format Example
Normal Force of Road on Tire The normal force of a road on a tire at the contact patch in the SAE coordinates (+Z downward) is always negative (directed upward). The normal force is: Fz = min (0.0, {Fzk + Fzc}) where:
Fzk is the normal force due to tire vertical stiffness Fzc is the normal force due to tire vertical damping Fzk = - vertical_stiffness pen Fzc = - vertical_damping Vpen
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 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.
17
Tire Models
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 (Alpha). The current coefficient of friction depends on the static (UMAX) and dynamic (UMIN) friction coefficients and the comprehensive slip ratio (SsAlpha). 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 UMAZ to define a linear friction versus slip relationship. The comprehensive slip ( S s ):
Ss =
S s + tan 2 ( )
< >
S_critical
S_critical
F x1 = U F z ( U Fz ) 2 F x2 = ------------------------------------4 S s CSLIP
18 Adams/Tire
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 ):
critical
critical
> critical
19
Tire Models
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 in the Adams/Solver online help). Longitudinal Force FLon = S*FLon Lateral Force FLat = S*FLat 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, smoothing is off USE_MODE = 2, smoothing is on
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.
20 Adams/Tire
'Pressure - XXXXXX' 'Test Date - XXXXXX' 'Test tire' 'New File Format v2.1' $---------------------------------------------------------------units [UNITS] LENGTH = 'mm' FORCE = 'newton' ANGLE = 'degree' MASS = 'kg' TIME = 'sec' $--------------------------------------------------------------model [MODEL] ! use mode 12 11 12 ! -------------------------------------------! smoothingX X ! transient X X ! PROPERTY_FILE_FORMAT = 'FIALA' 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 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
21
Tire Models
10 20 30
22 Adams/Tire
12 Adams/Tire
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 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. PAC2002 and Previous Magic Formula Models Compared to previous versions, PAC2002 is backward compatible with all previous versions of PAC2002, MF-Tyre 5.x tire models, and related tire property files. 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
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.
13
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. Input and Output Variables of the Magic Formula Tire Model
14 Adams/Tire
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). 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
15
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. SI Units Used in PAC2002 Variable type: Angle Name: Slip angle Inclination angle Force Longitudinal force Lateral force Vertical load Moment Overturning moment Abbreviation: Unit: Radians
Fx Fy Fz Mx
Newton
Newton.meter
Rolling resistance moment My Self-aligning moment Speed Longitudinal speed Lateral speed Longitudinal slip speed Lateral slip speed Rotational speed Tire rolling speed Definition of Tire Slip Quantities 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
16 Adams/Tire
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 velocities in the contact point with:
(2)
(3)
(4)
Vr = Re
Turn-slip is one of the two components that form the spin of the tire. Turn-slip
(5)
is calculated using:
(7)
1 1 = ------ { ( 1 ) sin } Vx
The total tire spin has contributions of turn-slip and camber. the camber to become comparable with turn-slip.
17
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:
18 Adams/Tire
Ro Fx 2 Fy 2 2 F z = 1 + q V2 ------ q Fcxl ------- q Fcyl ------- + q Fcyl Vo F z0 F z0 2 q Fzl ----- + q Fz2 ----- F z0 + K z R 0 R0
(8)
Using this formula, the vertical tire stiffness increases due to increasing rotational speed and decreases by longitudinal and lateral tire forces. If qFz1 is zero, qFz1 will be 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: (9)
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. Loaded and Effective Tire Rolling Radius With the loaded tire radius Rl defined as the distance of the wheel center to the contact point of the tire with the road, the tire deflection can be calculated using the free tire radius R0 and a correction for the tire radius growth due to the rotational tire speed
:
(10)
R0 2 = R 0 R 1 + q V1 R 0 ------ V 0
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 = -----
(11)
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.
19
(12)
in which
20 Adams/Tire
F z0 Fz0 = --------------C z Cz
and
(13)
d = ------- Fz0
Example of Loaded and Effective Tire Rolling Radius as Function of Vertical Load
Normal Load and Rolling Radius Parameters Name Used in Tire Property File: FNOMIN UNLOADED_RADIUS BREFF DREFF FREFF VERTICAL_STIFFNESS VERTICAL_DAMPING
Name: Fz0 Ro B D F Cz Kz
Explanation: Nominal wheel load Free tire radius Low load stiffness effective rolling radius Peak value of effective rolling radius High load stiffness effective rolling radius Tire vertical stiffness (if qFz1=0) Tire vertical damping
21
Name Used in Tire Property File: QFZ1 QFZ2 QFCX1 QFCY1 QFCG1 QV1 QV2
Explanation: Tire vertical stiffness coefficient (linear) Tire vertical stiffness coefficient (quadratic) Tire stiffness interaction with Fx Tire stiffness interaction with Fy Tire stiffness interaction with camber Tire radius growth coefficient Tire stiffness variation coefficient with speed
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.
22 Adams/Tire
If (Pentire - (Rtire - Rbottom) - width | tan(g) |) < 0, the left or right side of the rim has contact with the road. Then, the rim deflection Penrim can be calculated using:
23
/| tan( ) |)/3
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: Penrim = Pentire - (Rtire - Rbottom) Srim = width2 | tan( ) | /(12 Penrim) 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 FzrimSrim. Rtire is equal to the unloaded tire radius R0; Pentire is similar to effpen (= ).
Note:
For pure slip conditions, the lateral force Fy as a function of the lateral slip longitudinal force Fx as a function of longitudinal slip
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:
(15)
24 Adams/Tire
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:
(16)
The figure, The Magic Formula and the Meaning of Its Parameters, illustrates the functionality of the B, C, D, and E factor in the Magic Formula:
D-factor determines the peak of the characteristic, and is called the peak factor. C-factor determines the part used of the sine and, therefore, mainly influences the shape of the
25
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.
26 Adams/Tire
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: Longitudinal slip Slip angle Inclination angle Normal wheel load Output Variables Longitudinal force Lateral force Overturning couple Rolling resistance moment Aligning moment Fx Fy Mx My Mz [N] [N] [Nm] [Nm] [Nm]
Fz
The output variables are defined in the W-axis system of TYDEX. Basic Tire Parameters All tire model parameters of the model are without dimension. The reference parameters for the model are: Nominal (rated) load Unloaded tire radius Tire belt mass Fz0 R0 mbelt [N] [m] [kg]
As a measure for the vertical load, the normalized vertical load increment dfz is used:
F z F' z0 df z = ------------------F' z0
with the possibly adapted nominal load (using the user-scaling factor, z0 ):
(17)
27
F' z0 = F z0 Fz0
Nomenclature of the Tire Model Parameters
(18)
In the subsequent sections, formulas are given with non-dimensional parameters aijk with the following logic: Tire Model Parameters Parameter: a= p q r s i= B C D E K H V s t j= x y z k= 1, 2, ... Force at pure slip Moment at pure slip Force at combined slip Moment at combined slip Stiffness factor Shape factor Peak value Curvature factor Slip stiffness = BCD Horizontal shift Vertical shift Moment at combined slip Transient tire behavior Along the longitudinal axis Along the lateral axis About the vertical axis Definition:
User Scaling Factors A set of scaling factors is available to easily examine the influence of changing tire properties without the need to change one of the real Magic Formula coefficients. The default value of these factors is 1. You can change the factors in the tire property file. The peak friction scaling factors,
and , are
also used for the position-dependent friction in 3D Road Contact and 3D Road. An overview of all scaling factors is shown in the following tables.
28 Adams/Tire
Scaling Factor Coefficients for Pure Slip Name used in tire property file: LFZO LCZ LCX LMUX LEX LKX LHX LVX LGAX LCY LMUY LEY LKY LHY LVY LGAY LTR LRES LGAZ LMX LVMX LMY
Name:
Explanation: Scale factor of nominal (rated) load Scale factor of vertical tire stiffness Scale factor of Fx shape factor Scale factor of Fx peak friction coefficient Scale factor of Fx curvature factor Scale factor of Fx slip stiffness Scale factor of Fx horizontal shift Scale factor of Fx vertical shift Scale factor of inclination for Fx Scale factor of Fy shape factor Scale factor of Fy peak friction coefficient Scale factor of Fy curvature factor Scale factor of Fy cornering stiffness Scale factor of Fy horizontal shift Scale factor of Fy vertical shift Scale factor of inclination for Fy Scale factor of peak of pneumatic trail Scale factor for offset of residual moment Scale factor of inclination for Mz Scale factor of overturning couple Scale factor of Mx vertical shift Scale factor of rolling resistance moment
Fzo Cz Cx x Ex Kx Hx Vx x Cy y Ey Ky Hy Vy gy t Mr z Mx VMx My
29
Scaling Factor Coefficients for Combined Slip Name used in tire property file: LXAL LYKA LVYKA LS
Name:
Explanation: Scale factor of alpha influence on Fx Scale factor of alpha influence on Fx Scale factor of kappa-induced Fy Scale factor of moment arm of Fx
x y V y s
Scaling Factor Coefficients for Transient Response Name used in tire property file: LSGKP LSGAL LGYR
Name:
Explanation: Scale factor of relaxation length of Fx Scale factor of relaxation length of Fy Scale factor of gyroscopic moment
gyr
Note that the scaling factors change during the simulation according to any user-introduced function. See the next section, Online Scaling of Tire Properties. Online Scaling of Tire Properties PAC2002 can provide online scaling of tire properties. For each scaling factor, a variable should be introduced in the Adams .adm dataset. For example: !lfz0 scaling ! adams_view_name='TR_Front_Tires until wheel_lfz0_var' VARIABLE/53 , IC = 1 , FUNCTION = 1.0 This lets you change the scaling factor during a simulation as a function of time or any other variable in your model. Therefore, tire properties can change because of inflation pressure, road friction, road temperature, and so on. You can also use the scaling factors in co-simulations in MATLAB/Simulink. For more detailed information, see Knowledge Base Article 12732.
30 Adams/Tire
Formulas for the Longitudinal Force at Pure Slip For the tire rolling on a straight line with no slip angle, the formulas are:
(27)
(28) (29)
31
S Vx = F z ( p Hx1 + p Hx2 df z ) Vx Hx 1
Longitudinal Force Coefficients at Pure Slip Name used in tire property file: PCX1 PDX1 PDX2 PDX3 PEX1 PEX2 PEX3 PEX4 PKX1 PKX2 PKX3 PHX1 PHX2 PVX1 PVX2
(30)
Name: pCx1 pDx1 pDx2 pDx3 pEx1 pEx2 pEx3 pEx4 pKx1 pKx2 pKx3 pHx1 pHx2 pVx1 pVx2
Explanation: Shape factor Cfx for longitudinal force Longitudinal friction Mux at Fznom Variation of friction Mux with load Variation of friction Mux with inclination Longitudinal curvature Efx at Fznom Variation of curvature Efx with load Variation of curvature Efx with load squared Factor in curvature Efx while driving Longitudinal slip stiffness Kfx/Fz at Fznom Variation of slip stiffness Kfx/Fz with load Exponent in slip stiffness Kfx/Fz with load Horizontal shift Shx at Fznom Variation of shift Shx with load Vertical shift Svx/Fz at Fznom Variation of shift Svx/Fz with load
y = y
with coefficients:
(34)
C y = p Cy1 Cy Dy = y Fz 2
(35) (36)
32 Adams/Tire
(37) (38)
Fz K y0 = P Ky1 F z0 sin 2ac tan -------------------------- Fz0 Ky P Ky2 F 0 Fz0 K y = K y0 ( 1 p Ky3 y ) 3 By = Ky ( Cy Dy ) S Hy = ( p Hy1 + p Hy2 df z ) Hy + p Hy3 y 0 + 4 1 S Vy = F z { ( p Vy1 + p Vy2 df z ) Vy + ( p Vy3 + p Vy4 df z ) y } y 4
The camber stiffness is given by:
(39)
K y0 = P Hy3 K y0 + F z ( p y3 + p y4 df z )
Lateral Force Coefficients at Pure Slip Name used in tire property file: PCY1 PDY1 PDY2 PDY3 PEY1 PEY2 PEY3 PEY4 PKY1 PKY2 PKY3 PHY1 PHY2 Lateral friction Muy Variation of friction Muy with load Variation of friction Muy with squared inclination Lateral curvature Efy at Fznom Variation of curvature Efy with load Inclination dependency of curvature Efy Variation of curvature Efy with inclination Maximum value of stiffness Kfy/Fznom Load at which Kfy reaches maximum value Variation of Kfy/Fznom with inclination Horizontal shift Shy at Fznom Variation of shift Shy with load
(44)
Name: pCy1 pDy1 pDy2 pDy3 pEy1 pEy2 pEy3 pEy4 pKy1 pKy2 pKy3 pHy1 pHy2
33
Name used in tire property file: PHY3 PVY1 PVY2 PVY3 PVY4
Explanation: Variation of shift Shy with inclination Vertical shift in Svy/Fz at Fznom Variation of shift Svy/Fz with load Variation of shift Svy/Fz with inclination Variation of shift Svy/Fz with inclination and load
M' z = M z0 ( , , F z ) M z0 = t F y0 + M zr
with the pneumatic trail t:
(45)
(46) (47)
z = z
with coefficients:
2
(51)
B t = ( q Bz1 + q Bz2 df z + q Bz3 df z ) ( 1 + q Bz4 z + q Bz5 z ) Ky y C t = q Cz1 R0 2 D t = F z ( q Dz1 + q Dz2 df z ) ( 1 + q Dz3 z + q Dz4 z ) ------- t 5 F z0
(52) (53)
(54)
34 Adams/Tire
E t = ( q Ez1 + q Ez2 df z + q Ez3 df z ) 2 1 + ( q Ez1 + q Ez2 z ) -- arc tan ( B t C t t ) w ith ( E t 1 ) S Ht = q Hz1 + q Hz2 df z + ( q Hz3 + q Hz4 df z ) z Ky B r = q Bz9 -------- + q Bz10 B y C y 6 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
An approximation for the aligning moment stiffness reads:
(55)
(56)
(57)
(58)
Kz = t Ky
M at = 0 ) z
(59)
Aligning Moment Coefficients at Pure Slip Name used in tire property file: QBZ1 QBZ2 QBZ3 QBZ4 QBZ5 QBZ9 QBZ10 QCZ1 QDZ1 QDZ2 QDZ3 QDZ4 QDZ6 QDZ7 QDZ8
Name: qBz1 qBz2 qBz3 qBz4 qBz5 qBz9 qBz10 qCz1 qDz1 qDz2 qDz3 qDz4 qDz6 qDz7 qDz8
Explanation: Trail slope factor for trail Bpt at Fznom Variation of slope Bpt with load Variation of slope Bpt with load squared Variation of slope Bpt with inclination Variation of slope Bpt with absolute inclination Slope factor Br of residual moment Mzr Slope factor Br of residual moment Mzr Shape factor Cpt for pneumatic trail Peak trail Dpt = Dpt*(Fz/Fznom*R0) Variation of peak Dpt with load Variation of peak Dpt with inclination Variation of peak Dpt with inclination squared. Peak residual moment Dmr = Dmr/ (Fz*R0) Variation of peak factor Dmr with load Variation of peak factor Dmr with inclination
35
Name: qDz9 qEz1 qEz2 qEz3 qEz4 qEz5 qHz1 qHz2 qHz3 qHz4
Name used in tire property file: QDZ9 QEZ1 QEZ2 QEZ3 QEZ4 QEZ5 QHZ1 QHZ2 QHZ3 QHZ4
Explanation: Variation of Dmr with inclination and load Trail curvature Ept at Fznom Variation of curvature Ept with load Variation of curvature Ept with load squared Variation of curvature Ept with sign of Alpha-t Variation of Ept with inclination and sign Alpha-t Trail horizontal shift Sht at Fznom Variation of shift Sht with load Variation of shift Sht with inclination Variation of shift Sht with inclination and load
Turn-slip and Parking 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:
36 Adams/Tire
2 2
C Hy
= p Hy1
K y0 K yR0 = -----------1
in which the camber reduction factor is given by:
= 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
The peak spin torque Dr is given by:
37
M z D Dr = ---------------------------C sin -- Dr 2
The moment at vanishing wheel speed at constant turning is given by:
M z = q Cr1 y R 0 F z F z F z0
The shape factors are given by:
38 Adams/Tire
Turn-Slip and Parking Parameters Name used in tire property file: PECP1 PECP2 PDXP1 PDXP2 PDXP3 PDYP1 PDYP2 PDYP3 PDYP4 PKYP1 PHYP1 PHYP2 PHYP3 PHYP4 QDTP1 QBRP1 QCRP1 QCRP2 QDRP1 QDRP2
Name: p 1 p 2 pDx 1 pDx 2 pDx 3 pDy 1 pDy 2 pDy 3 pDy 4 pKy 1 pHy 1 pHy 2 pHy 3 pHy 4 qDt 1 qBr 1 qCr 1 qCr 2 qDr 1 qDr 2
Explanation: Camber spin reduction factor parameter in camber stiffness Camber spin reduction factor varying with load parameter in camber stiffness Peak Fx reduction due to spin parameter Peak Fx reduction due to spin with varying load parameter Peak Fx reduction due to spin with kappa parameter Peak Fy reduction due to spin parameter Peak Fy reduction due to spin with varying load parameter Peak Fy reduction due to spin with alpha parameter Peak Fy reduction due to square root of spin parameter Cornering stiffness reduction due to spin Fy-alpha curve lateral shift limitation Fy-alpha curve maximum lateral shift parameter Fy-alpha curve maximum lateral shift varying with load parameter Fy-alpha curve maximum lateral shift parameter Pneumatic trail reduction factor due to turn slip parameter Residual (spin) torque reduction factor parameter due to side slip Turning moment at constant turning and zero forward speed parameter Turn slip moment (at alpha=90deg) parameter for increase with spin Turn slip moment peak magnitude parameter 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). Steady-State Combined Slip PAC2002 has two methods for calculating the combined slip forces and moments. If the user supplies the coefficients for the combined slip cosine 'weighing' functions, the combined slip is calculated according to Combined slip with cosine 'weighing' functions (standard method). If no coefficients are supplied, the
39
so-called friction ellipse is used to estimate the combined slip forces and moments, see section Combined Slip with friction ellipse Combined slip with cosine 'weighing' functions
Longitudinal Force at Combined Slip Lateral Force at Combined Slip Aligning Moment at Combined Slip Overturning Moment at Pure and Combined Slip Rolling Resistance Moment at Pure and Combined Slip
F x = F x0 G x ( , , F z )
with Gx the weighting function of the longitudinal force for pure slip. We write:
(60)
(61) (62)
B x = r Bx1 cos [ arc tan { r Bx2 } ] x C x F xo D x = ----------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C x arc tan { B x S Hx E x ( B x S Hx arc tan ( B x S Hx ) ) } ] E x = r Ex1 + r Ex2 df z with E x 1 S Hx = r Hx1
The weighting function follows as:
(63) (64)
cos [ C x arc tan { B x s E x ( B x s arc tan ( B x s ) ) } ] G x = --------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C x arc tan [ B x S Hx E x ( B x S Hx arc tan ( B x S Hx ) ) ] ]
(68)
40 Adams/Tire
Longitudinal Force Coefficients at Combined Slip Name used in tire property file: RBX1 RBX2 RCX1 REX1 REX2 RHX1
Explanation: Slope factor for combined slip Fx reduction Variation of slope Fx reduction with kappa Shape factor for combined slip Fx reduction Curvature factor of combined Fx Curvature factor of combined Fx with load Shift factor for combined slip Fx reduction
F y = F y0 G y ( , , , F z )
(69)
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:
(70) (71)
B y = r By1 cos [ arc tan { r By2 ( r By3 ) } ] y C y = r Cy1 F yo D y = -------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C y arc tan { B y S Hy E y ( B y S Hy arc tan ( B y S Hy ) ) } ] E y = r Ey1 + r Ey2 df z with E y 1 S Hy = r Hy1 + r Hy2 df z S Vy = D Vy sin [ r Vy5 arc tan ( r Vy6 ) ]
(72) (73)
(74)
(75)
(76)
(77)
41
(78)
cos [ C y arc tan { B y s E y ( B y s arc tan ( B y s ) ) } ] G y = -------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C y arc tan { B y S Hy E y ( B y S Hy arc tan ( B y S Hy ) ) } ]
Lateral Force Coefficients at Combined Slip Name used in tire property file: RBY1 RBY2 RBY3 RCY1 REY1 REY2 RHY1 RHY2 RVY1 RVY2 RVY3 RVY4 RVY5 RVY6
(79)
Name: rBy1 rBy2 rBy3 rCy1 rEy1 rEy2 rHy1 rHy2 rVy1 rVy2 rVy3 rVy4 rVy5 rVy6
Explanation: Slope factor for combined Fy reduction Variation of slope Fy reduction with alpha Shift term for alpha in slope Fy reduction Shape factor for combined Fy reduction Curvature factor of combined Fy Curvature factor of combined Fy with load Shift factor for combined Fy reduction Shift factor for combined Fy reduction with load Kappa induced side force Svyk/Muy*Fz at Fznom Variation of Svyk/Muy*Fz with load Variation of Svyk/Muy*Fz with inclination Variation of Svyk/Muy*Fz with alpha Variation of Svyk/Muy*Fz with kappa Variation of Svyk/Muy*Fz with atan (kappa)
M' z = t F y' + M zr + s F x
with:
(80)
t = t ( t, eq )
(81)
42 Adams/Tire
= D t cos [ C t arc tan { B t t, eq E t ( B t t, eq arc tan ( B t t, eq ) ) } ] cos ( ) F' y, = 0 = F y S Vy M zr = M zr ( r, eq ) = D r cos [ arc tan ( B r r, eq ) ] cos ( ) t = t ( t, eq )
with the arguments:
(82)
(83)
(84)
(85)
(86)
(87)
Explanation: Nominal value of s/R0 effect of Fx on Mz Variation of distance s/R0 with Fy/Fznom Variation of distance s/R0 with inclination Variation of distance s/R0 with load and inclination
Formulas for Overturning Moment at Pure and Combined Slip For the overturning moment, the formula reads both for pure and combined slip situations:
(88)
43
Overturning Moment Coefficients Name used in tire property file: QSX1 QSX2 QSX3
Explanation: Lateral force induced overturning couple Inclination induced overturning couple Fy induced overturning couple
Formulas for Rolling Resistance Moment at Pure and Combined Slip The rolling resistance moment is defined by:
(89)
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 )
Rolling Resistance Coefficients Name used in tire property file: QSY1 QSY2 QSY3 QSY4 LONGVL
(90)
Explanation: Rolling resistance moment coefficient Rolling resistance moment depending on Fx Rolling resistance moment depending on speed Rolling resistance moment depending on speed^4 Measurement speed
Combined Slip with friction ellipse In case the tire property file does not contain the coefficients for the 'standard' combined slip method (cosine 'weighing functions), the friction ellipse method is used, as described in this section. Note that the method employed here is not part of one of the Magic Formula publications by Pacejka, but is an inhouse development of MSC.Software.
S Vx c = + S Hx + -------Kx
44 Adams/Tire
F y, 0 S Vy y, act = -----------------------Fz
Dy y, max = -----Fz
1 x = -------------------------------------------------------tan 1 2 --------------- 2 ------------- + x, act y, max tan y = -------------------------------------------------------2 2 1 tan --------------- + ------------- x, max y, act
The forces corrected for the combined slip conditions are:
x F x = ------------- F x, 0 x, act
y F y = ------------- F y, 0 y, act
For aligning moment Mx, rolling resistance My and aligning moment Mz the formulae (76) until and including (85) are used with
S Vy =0.
45
Stretched String Model For accurate transient tire behavior, you can use the stretched string tire model (see reference [1]). The tire belt is modeled as stretched string, which is supported to the rim with lateral (and longitudinal) springs. 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. Stretched String Model for Transient Tire Behavior
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the following differential equation is valid:
46 Adams/Tire
(91)
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
(92)
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 = x V sx dt
(93)
Both the longitudinal and lateral relaxation length are defined as of the vertical load:
x = F z ( p Tx1 + p Tx2 df z ) exp ( p Tx3 df z ) ( R 0 F z0 ) x Fz = p Ty1 F z0 sin 2arc tan --------------------------------- ( 1 p Ky3 y ) R 0 Fz0 ( p Ty2 F z0 Fz0 )
Now the practical slip quantities,
(94)
(95)
(97)
Using these practical slip quantities, and , the Magic Formula equations can be used to calculate the tire-road interaction forces and moments:
(98) (99)
47
(100)
Explanation: Longitudinal relaxation length at Fznom Variation of longitudinal relaxation length with load Variation of longitudinal relaxation length with exponent of load Peak value of relaxation length for lateral direction Shape factor for lateral relaxation length Gyroscopic moment constant Belt mass of the wheel
Contact Mass Model The contact mass model is based on the separation of the contact patch slip properties and the tire carcass compliance (see reference [1]). Instead of using relaxation lengths to describe compliance effects, the carcass springs are explicitly incorporated in the model. The contact patch is given some inertia to ensure computational causality. This modeling approach automatically accounts for the lagged response to slip and load changes that diminish at higher levels of slip. The contact patch itself uses relaxation lengths to handle simulations at low speed. The contact patch can deflect in longitudinal, lateral, and yaw directions with respect to the lower part of the wheel rim. A mass is attached to the contact patch to enable straightforward computations. The differential equations that govern the dynamics of the contact patch body are:
m c ( V cx V cy c ) + k x u + c x u = F m c ( V cy V cx c ) + k y u + c y u = F Jc c + k + c = Mz
The contact patch body with mass mc and inertia Jc is connected to the wheel through springs cx, cy, and c and dampers kx, ky, and k in longitudinal, lateral, and yaw direction, respectively. The additional equations for the longitudinal u, lateral v, and yaw
deflections are:
u = V cx V sx v = V cy V sy
48 Adams/Tire
= c 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.
in which Vcx, Vcy and The transient slip equations for side slip, turn-slip, and camber are:
c d ' + V x ' = V cy V x + V x st dt c c d' t + V x ' t = V x ' dt d' c + V x ' c = dt d' F2 + V x ' cF2 = dt d' 1 + V x ' 1 = dt d' 2 + V x ' 2 = dt
F2 1 2
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:
49
c = a ( 1 ) t0 2 = --- c a F2 = b F2 c 1 = b 1 c 2 = b 2 c
Here a is half the contact length according to:
z z a = p A1 R 0 ----- + p A2 ----- R 0 R0
The composite tire parameter reads:
K y0 = -------------2 y F x
and the equivalent slip:
Name: mc Ic kx ky cx cy c k
Explanation:
50 Adams/Tire
Name used in tire property file: PA1 PA2 EP EP12 BF2 BP1 BP2
Explanation: Half contact length with vertical tire deflection Half contact length with square root of vertical tire deflection Composite turn-slip (moment) Composite turn-slip (moment) increment Second relaxation length factor First moment relaxation length factor Second moment relaxation length factor
12
bF2 b 1 b 2
The remaining contact mass model parameters are estimated automatically based on longitudinal and lateral stiffness specified in the tire property file.
(101)
with the parameter (in addition to the basic tire parameter mbelt):
(102)
(103)
M z = M' z + M z, gyr
(104)
51
Coefficients and Transient Response Name used in tire property file: PTX1 PTX2 PTX3 PTY1 PTY2 QTZ1 MBELT
Explanation: Longitudinal relaxation length at Fznom Variation of longitudinal relaxation length with load Variation of longitudinal relaxation length with exponent of load Peak value of relaxation length for lateral direction Shape factor for lateral relaxation length Gyroscopic moment constant Belt mass of the wheel
52 Adams/Tire
53
USE_MODE Values of PAC2002 and Related Tire Model Output PAC2002 output (forces and moments): 0, 0, Fz, 0, 0, 0 Fx, 0, Fz, 0, My, 0 0, Fy, Fz, Mx, 0, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz Fx, 0, Fz, 0, My, 0 0, Fy, Fz, Mx, 0, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz Fx, 0, Fz, My, 0 0, Fy, Fz, Mx, 0, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz
USE_MODE: 0 1 2 3 4 11 12 13 14 15 21 22 23 24 25
State: Steady state Steady state Steady state Steady state Steady state Transient Transient Transient Transient Transient Advanced transient Advanced transient Advanced transient Advanced transient Advanced transient
Slip conditions: Acts as a vertical spring & damper Pure longitudinal slip Pure lateral (cornering) slip Longitudinal and lateral (not combined) Combined slip Pure longitudinal slip Pure lateral (cornering) slip Longitudinal and lateral (not combined) Combined slip Combined slip and turn-slip Pure longitudinal slip Pure lateral (cornering slip) Longitudinal and lateral (not combined) Combined slip Combined slip and turnslip/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.
54 Adams/Tire
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 (85)). 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
Camber (Inclination) Effects Camber stiffness has not been explicitly defined in PAC2002; however, for car tires, positive inclination should result in a negative lateral force at zero slip angle. If positive inclination results in an increase of the lateral force, the coefficient may not be valid for the ISO but for the SAE coordinate system. Note that PAC2002 only uses coefficients for the TYDEX W-axis (ISO) system. Effect of Positive Camber on the Lateral Force in TYDEX W-axis (ISO) System
55
Checklist for PAC2002 Parameters and Properties Parameter/property: LONGVL VXLOW Dx pDx1/pDx2 Kx Dy pDy1/pDy2 Ky qsy1 Requirement: 1 m/s Approximately 1 m/s >0 <0 >0 >0 <0 <0 >0 Explanation: Reference velocity at which parameters are measured Threshold for scaling down forces and moments Peak friction (see equation (24)) Peak friction Fx must decrease with increasing load Long slip stiffness (see equation (27)) Peak friction (see equation (36)) Peak friction Fx must decrease with increasing load Cornering stiffness (see equation (39)) Rolling resistance, in the range of 0.005 - 0.015
Validity Range of the Tire Model Input In the tire property file, a range of the input variables has been given in which the tire properties are supposed to be valid. These validity range parameters are (the listed values can be different): $--------------------------------------------------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
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.
56 Adams/Tire
At the First International Colloquium on Tire Models for Vehicle Dynamics Analysis on October 21-22, 1991, the International Tire Workshop working group was established (TYDEX). The working group concentrated on tire measurements and tire models used for vehicle simulation purposes. For most vehicle dynamics studies, people used to develop their own tire models. Because all car manufacturers and their tire suppliers have the same goal (that is, development of tires to improve dynamic safety of the vehicle) it aimed for standardization in tire behavior description. 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: Road tangent plane C-axis system Wheel plane Contact point C W-axis system Definition: Plane with the normal unit vector (tangent to the road) in the tire-road contact point C. Coordinate system mounted on the wheel carrier at the wheel center according to TYDEX, ISO orientation. The plane in the wheel center that is formed by the wheel when considered a rigid disc with zero width. 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. Coordinate system at the tire contact point C, according to TYDEX, ISO orientation.
57
Tire Kinematics Tire Kinematics Definitions Parameter: R0 R Re Definition: Unloaded tire radius Loaded tire radius Effective tire radius Radial tire deflection Dimensionless radial tire deflection Radial tire deflection at nominal load Tire belt mass Rotational velocity of the wheel [m] [m] [m] [m] [-] [m] [kg] [rads-1] Units:
d Fz0
mbelt
Slip Quantities Slip Quantities Definitions Parameter: V Vsx Vsy Vs Vx Vy Vr Definition: Vehicle speed Slip speed in x direction Slip speed in y direction Resulting slip speed Rolling speed in x direction Lateral speed of tire contact center Linear speed of rolling Longitudinal slip Slip angle Inclination angle [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [-] [rad] [rad] Units:
Forces and Moments Force and Moment Definitions Abbreviation: Fz Fz0 dfz Definition: Vertical wheel load Nominal load Dimensionless vertical load [N] [N] [-] Units:
58 Adams/Tire
Definition: Longitudinal force Overturning moment Braking/driving moment Aligning moment [N] [N] [Nm] [Nm] [Nm]
Units:
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.
59
! ! 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]
60 Adams/Tire
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 [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
61
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
62 Adams/Tire
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 $------------------------------------------------------------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
63
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
64 Adams/Tire
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 QEZ1 = -1.5697 $Trail curvature Ept at Fznom QEZ2 = 0.33394 $Variation of curvature Ept with load QEZ3 = 0 $Variation of curvature Ept with load squared QEZ4 = 0.26711 $Variation of curvature Ept with sign of Alpha-t QEZ5 = -3.594 $Variation of Ept with camber and sign Alpha-t QHZ1 = 0.0047326 $Trail horizontal shift Sht at Fznom QHZ2 = 0.0026687 $Variation of shift Sht with load QHZ3 = 0.11998 $Variation of shift Sht with camber QHZ4 = 0.059083 $Variation of shift Sht with camber and load SSZ1 = 0.033372 $Nominal value of s/R0: effect of Fx on Mz SSZ2 = 0.0043624 $Variation of distance s/R0 with Fy/Fznom SSZ3 = 0.56742 $Variation of distance s/R0 with camber SSZ4 = -0.24116 $Variation of distance s/R0 with load and camber QTZ1 = 0.2 $Gyration torque constant MBELT = 5.4 $Belt mass of the wheel $-----------------------------------------------turn-slip parameters [TURNSLIP_COEFFICIENTS]
65
PECP1 = 0.7 $Camber stiffness reduction factor PECP2 = 0.0 $Camber stiffness reduction factor with load PDXP1 = 0.4 $Peak Fx reduction due to spin PDXP2 = 0.0 $Peak Fx reduction due to spin with load PDXP3 = 0.0 $Peak Fx reduction due to spin with longitudinal slip PDYP1 = 0.4 $Peak Fy reduction due to spin PDYP2 = 0.0 $Peak Fy reduction due to spin with load PDYP3 = 0.0 $Peak Fy reduction due to spin with lateral slip PDYP4 = 0.0 $Peak Fy reduction with square root of spin PKYP1 = 1.0 $Cornering stiffness reduction due to spin PHYP1 = 1.0 $Fy lateral shift shape factor PHYP2 = 0.15 $Maximum Fy lateral shift PHYP3 = 0.0 $Maximum Fy lateral shift with load PHYP4 = -4.0 $Fy lateral shift curvature factor QDTP1 = 10.0 $Pneumatic trail reduction factor QBRP1 = 0.1 $Residual torque reduction factor with lateral slip QCRP1 = 0.2 $Turning moment at constant turning with zero speed QCRP2 = 0.1 $Turning moment at 90 deg lateral slip QDRP1 = 1.0 $Maximum turning moment QDRP2 = -1.5 $Location of maximum turning moment $--------------------------------------------contact patch parameters [CONTACT_COEFFICIENTS] PA1 = 0.4147 $Half contact length dependency on Fz) PA2 = 1.9129 $Half contact length dependency on sqrt(Fz/R0) $--------------------------------------------contact patch slip model [DYNAMIC_COEFFICIENTS] MC = 1.0 $Contact mass IC = 0.05 $Contact moment of inertia KX = 409.0 $Contact longitudinal damping KY = 320.8 $Contact lateral damping KP = 11.9 $Contact yaw damping CX = 4.350e+005 $Contact longitudinal stiffness CY = 1.665e+005 $Contact lateral stiffness CP = 20319 $Contact yaw stiffness EP = 1.0 EP12 = 4.0 BF2 = 0.5 BP1 = 0.5 BP2 = 0.67 $------------------------------------------------------loaded radius [LOADED_RADIUS_COEFFICIENTS] QV1 = 0.000071 $Tire radius growth coefficient QV2 = 2.489 $Tire stiffness variation coefficient with speed QFCX1 = 0.1 $Tire stiffness interaction with Fx QFCY1 = 0.3 $Tire stiffness interaction with Fy QFCG1 = 0.0 $Tire stiffness interaction with camber QFZ1 = 0.0 $Linear stiffness coefficient, if zero, VERTICAL_STIFFNESS is taken QFZ2 = 14.35 $Tire vertical stiffness coefficient (quadratic)
66 Adams/Tire
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.
12 Adams/Tire
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 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.
13
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. Input and Output Variables of the Magic Formula Tire Model
14 Adams/Tire
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]. 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.
15
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. SI Units Used in PAC-TIME Variable type: Angle Name: Slip angle Inclination angle Force Longitudinal force Lateral force Vertical load Moment Overturning moment Abbreviation: Unit: Radians
Fx Fy Fz Mx
Newton
Newton.meter
Rolling resistance moment My Self-aligning moment Speed Longitudinal speed Lateral speed Longitudinal slip speed Lateral slip speed Rotational speed Tire rolling speed Definition of Tire Slip Quantities Slip Quantities at Combined Cornering and Braking/Traction Mz Vx Vy Vsx Vsy Meters per second
16 Adams/Tire
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
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 velocities in the contact point with:
(2)
(3)
(4)
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
17
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
where
(6)
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. Loaded and Effective Tire Rolling Radius With the loaded rolling tire radius R defined as the distance of the wheel center to the contact point of the tire with the road, where the loaded tire radius Rl is:
is the deflection of the tire, and R0 is the free (unloaded) tire radius, then
(7)
R1 = R0
In this tire model, a constant (linear) vertical tire stiffness Cz is assumed; therefore, the tire deflection can be calculated using:
18 Adams/Tire
Fz = ----Cz
(8)
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
(10)
19
in which
F z0 Fz0 = ------Cz
and
d = ------- Fz0
Effective Rolling Radius and Longitudinal Slip
Normal Load and Rolling Radius Parameters Name Used in Tire Property File: FNOMIN UNLOADED_RADIUS BREFF DREFF Nominal wheel load Free tire radius Low load stiffness effective rolling radius Peak value of effective rolling radius
Name: Fz0 Ro B D
Explanation:
20 Adams/Tire
Name: F Cz Kz
Explanation: High load stiffness effective rolling radius Tire vertical damping
For pure slip conditions, the lateral force Fy as a function of the lateral slip
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:
(13)
21
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
The figure, The Magic Formula and the Meaning of Its Parameters, illustrates the functionality of the B, C, D, and E factor in the Magic Formula:
D-factor determines the peak of the characteristic, and is called the peak factor. C-factor determines the part used of the sine and, therefore, mainly influences the shape of the
22 Adams/Tire
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). Inclination Effects in the Lateral Force From a historical point of view, the camber stiffness always has been modeled implicit in the Magic Formulas. For deriving coefficients of a Pacejka tire model usually so-called tire tests with slip angle sweeps at various values of constant load and inclination are performed. In the resulting Force & Moment measurement data, the effects of camber on the side force Fy are relatively small compared to side force
23
effects by slip angle, which can easily result in non-realistic camber stiffness properties. Because there is no explicit definition of the camber stiffness, the effects on camber stiffness cannot be controlled in the coefficient optimization process. 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:
(15)
In the PAC-TIME tire model, C has been set to , and E is not used (zero value). This approach results in an explicit definition of the camber stiffness, because:
F yo K = B C D = ------- at = 0
Input Variables The input variables to the Magic Formula are: Input Variables Longitudinal slip Slip angle Inclination angle Normal wheel load Output Variables Its output variables are: Output Variables. Longitudinal force Lateral force Fx Fy [N] [N]
(16)
Fz
24 Adams/Tire
Mx My Mz
The output variables are defined in the W-axis system of TYDEX. Basic Tire Parameters All tire model parameters of the model are without dimension. The reference parameters for the model are: Basic Tire Parameters Nominal (rated) load Unloaded tire radius Tire belt mass Fz0 R0 mbelt [N] [m] [kg]
As a measure for the vertical load, the normalized vertical load increment dfz is used:
F z F' z0 df z = ------------------F' z0
with the possibly adapted nominal load (using the user-scaling factor,
(17)
Fz0):
(18)
F' z0 = F z0 Fz0
Nomenclature of the Tire Model Parameters
In the subsequent sections, formulas are given with non-dimensional parameters aijk with the following logic: Tire Model Parameters Parameter: a= p q r s Force at pure slip Moment at pure slip Force at combined slip Moment at combined slip Definition:
25
Parameter: i= B C D E K H V s t j= x y z k= 1, 2, ... Stiffness factor Shape factor Peak value Curvature factor
Definition:
Slip stiffness = BCD Horizontal shift Vertical shift Moment at combined slip Transient tire behavior Along the longitudinal axis Along the lateral axis About the vertical axis
User Scaling Factors A set of scaling factors is available to easily examine the influence of changing tire properties without the need to change one of the real Magic Formula coefficients. The default value of these factors is 1. You can change the factors in the tire property file. The peak friction scaling factors, factors,
and
', are also used for the position-dependent friction in 3D Road Contact and Adams/3D Road. An overview of all scaling factors is shown in the next tables.
Scaling Factor Coefficients for Pure Slip Name used in tire property file: LFZO LCX LMUX LEX LKX LVX LHX LGAX LCY LMUY
Name:
Explanation: Scale factor of nominal (rated) load Scale factor of Fx shape factor Scale factor of Fx peak friction coefficient Scale factor of Fx curvature factor Scale factor of Fx slip stiffness Scale factor of Fx vertical shift Scale factor of Fx horizontal shift Scale factor of camber for Fx Scale factor of Fy shape factor for side slip Scale factor of Fy peak friction coefficient
Fzo Cx Ex Kx Vx Hx x Cy y
26 Adams/Tire
Name:
Name used in tire property file: LEY LKY LVY LHY LKC LGAY LTR LRES LGAZ LMX LVMX LMY
Explanation: Scale factor of Fy curvature factor Scale factor of Fy cornering stiffness Scale factor of Fy vertical shift Scale factor of Fy horizontal shift Scale factor of camber stiffness (K-factor) Scale factor of camber force stiffness Scale factor of peak of pneumatic trail Scale factor for offset of residual torque Scale factor of camber torque stiffness Scale factor of overturning couple Scale factor of Mx vertical shift Scale factor of rolling resistance torque
Ey Ky Vy Hy K t Mr z Mx VMx My
Scaling Factor Coefficients for Combined Slip Name used in tire property file: LXAL LYKA LVYKA LS
Name:
Explanation: Scale factor of alpha influence on Fx Scale factor of alpha influence on Fx Scale factor of kappa induced Fy Scale factor of moment arm of Fx
x y Vy s
Scaling Factor Coefficients for Transient Response Name used in tire property file: LSGKP LSGAL LGYR
Name:
Explanation: Scale factor of relaxation length of Fx Scale factor of relaxation length of Fy Scale factor of gyroscopic moment
gyr
27
Formulas for the Longitudinal Force at Pure Slip For the tire rolling on a straight line with no slip angle, the formulas are:
C x = p Cx1 cx Dx = x Fz
2 x = ( p Dx1 + p Dx2 df z ) 1 ( p Dx3 x ) x 2 E x = ( p Ex1 + p Ex2 df z + p Ex2 df z ) { 1 p Ex4 sgn ( x ) } Ex with E x 1
(27)
(28) (29)
28 Adams/Tire
Longitudinal Force Coefficients at Pure Slip Name used in tire property file: PCX1 PDX1 PDX2 PDX3 PEX1 PEX2 PEX3 PEX4 PKX1 PKX2
Name: pCx1 pDx1 pDx2 pDx3 pEx1 pEx2 pEx3 pEx4 pKx1 pKx2
Explanation: Shape factor Cfx for longitudinal force Longitudinal friction Mux at Fznom Variation of friction Mux with load Variation of friction Mux with inclination Longitudinal curvature Efx at Fznom Variation of curvature Efx with load Variation of curvature Efx with load squared Factor in curvature Efx while driving Longitudinal slip stiffness Kfx/Fz at Fznom Variation of slip stiffness Kfx/Fz with load
F y = F y0 ( , , F z )
(30)
y = y
with coefficients:
(33)
C y = p Cy1 Cy Dy = y Fz
2 y = ( p Dy1 + p Dy2 df z ) ( 1 p Dy3 y ) y
29
() y K
Fz F y 2 = p Ky1 F z0 sin p Ky4 arc tan ------------------------------ ( 1 p Ky3 y ) Ky Fz0 (38) p Ky2 F z0 Fz0
(40)
Name: pCy1 pDy1 pDy2 pDy3 pEy1 pEy2 pEy3 pEy4 pKy1 pKy2 pKy3 pKy4 pKy5 pKy6
30 Adams/Tire
Explanation: Horizontal shift Shy at Fznom Variation of shift Shy with load Vertical shift in Svy/Fz at Fznom Variation of shift Svy/Fz with load
M' z = M z0 ( , , F z ) M z0 = t ( F y0 S Vy ) = 0 + Mzr
with the pneumatic trail t:
(44)
(45)
z = z
with coefficients:
2 B t = ( q Bz1 + q Bz2 df z ) ( ( 1 + q Bz4 z + q Bz5 z ) k y )
(49)
31
2 E t = ( q Ez1 + q Ez2 df z ) 1 + q Ez4 -- arc tan ( B t C t t ) with E t 1 S Ht = q Hz1 + q Hz2 df z + ( q Hz3 + q Hz4 df z ) z B r = Kz y D r = F z { ( q Dz6 + q Dz7 df z ) r + ( q Dz8 + q Dz9 df z ) z }R 0 y
An approximation for the aligning moment stiffness reads:
(53)
(57)
dM z = ( q Dz8 + q Dz9 df z )R 0 F z y d
Aligning Moment Coefficients at Pure Slip Name used in tire property file: QBZ1 QBZ2 QBZ4 QBZ5 QCZ1 QDZ1 QDZ2 QDZ6 QDZ7 QDZ8 QDZ9 QEZ1
(58)
Name: qBz1 qBz2 qBz4 qBz5 qCz1 qDz1 qDz2 qDz6 qDz7 qDz8 qDz9 qEz1
Explanation: Trail slope factor for trail Bpt at Fznom Variation of slope Bpt with load Variation of slope Bpt with inclination Variation of slope Bpt with absolute inclination Shape factor Cpt for pneumatic trail Peak trail Dpt = Dpt*(Fz/Fznom*R0) Variation of peak Dpt with load Peak residual moment Dmr = Dmr/ (Fz*R0) Variation of peak factor Dmr with load Variation of peak factor Dmr with inclination Variation of Dmr with inclination and load Trail curvature Ept at Fznom
32 Adams/Tire
Name used in tire property file: QEZ2 QEZ4 QHZ1 QHZ2 QHZ3 QHZ4
Explanation: Variation of curvature Ept with load Variation of curvature Ept with sign of Alpha-t Trail horizontal shift Sht at Fznom Variation of shift Sht with load Variation of shift Sht with inclination Variation of shift Sht with inclination and load
Steady-State Combined Slip PAC-TIME has two methods for calculating the combined slip forces and moments. If the user supplies the coefficients for the combined slip cosine 'weighing' functions, the combined slip is calculated according to Combined slip with cosine 'weighing' functions (standard method). If no coefficients are supplied, the so-called friction ellipse is used to estimate the combined slip forces and moments, see section Combined Slip with friction ellipse Combined slip with cosine 'weighing' functions
Longitudinal Force at Combined Slip Lateral Force at Combined Slip Aligning Moment at Combined Slip Overturning Moment at Pure and Combined Slip Rolling Resistance Moment at Pure and Combined Slip
F x = F x0 G x ( , , F z )
with Gx the weighting function of the longitudinal force for pure slip. We write:
(59)
(60) (61)
(62) (63)
33
cos [ C x arc tan { B x s E x ( B x s arc tan ( B x s ) ) } ] G x = ----------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C x arc tan { B x S Hx E x ( B x S Hx arc tan ( B x S Hx ) ) } ]
Longitudinal Force Coefficients at Combined Slip Name used in tire property file: RBX1 RBX2 RCX1 REX1 REX2 RHX1
(67)
Explanation: Slope factor for combined slip Fx reduction Variation of slope Fx reduction with kappa Shape factor for combined slip Fx reduction Curvature factor of combined Fx Curvature factor of combined Fx with load Shift factor for combined slip Fx reduction
F y = F y0 G y ( , , , F z ) + S Vy
(68)
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:
(69) (70)
(71) (72)
34 Adams/Tire
F yo D y = -------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C y arc tan { B y S Hy E y ( B x S Hy arc tan ( B y S Hy ) ) } ] E y = r Ey1 + r Ey2 df z with E y 1 S Hy = r Hy1 + r Hy2 df z D Vy = y F z ( r Vy1 + r Vy2 df z + r Vy3 ) cos [ arc tan ( r Vy4 ) ]
The weighting function appears is defined as:
cos [ C y arc tan { B y s E y ( B x s arc tan ( B y s ) ) } ] G y = -------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C y arc tan { B y S Hy E y ( B x S Hy arc tan ( B y S Hy ) ) } ]
Lateral Force Coefficients at Combined Slip Name used in tire property file: RBY1 RBY2 RBY3 RCY1 REY1 REY2 RHY1 RHY2 RVY1 RVY2 RVY3 RVY4 RVY5 RVY6
(77)
Name: rBy1 rBy2 rBy3 rCy1 rEy1 rEy2 rHy1 rHy2 rVy1 rVy2 rVy3 rVy4 rVy5 rVy6
Explanation: Slope factor for combined Fy reduction Variation of slope Fy reduction with alpha Shift term for alpha in slope Fy reduction Shape factor for combined Fy reduction Curvature factor of combined Fy Curvature factor of combined Fy with load Shift factor for combined Fy reduction Shift factor for combined Fy reduction with load Kappa induced side force SVyk/yFz at Fznom Variation of SVyk/yFz with load Variation of SVyk/yFz with inclination Variation of SVyk/yFz with Variation of SVyk/yFz with Variation of SVyk/yFz with atan()
M' z = t F' y + M zr + s F x
with:
(78)
t = t ( t, eq )
(79)
35
= D t cos [ C t arc tan { B t t, eq E t ( B t t, eq arc tan ( B t t, eq ) ) } ] cos ( ) F' y, = 0 = F y S Vy M zr = M zr ( r, eq ) = D r cos [ arc tan ( B r r, eq ) ] cos ( ) t = t ( t, eq )
with the arguments:
Kx 2 t, eq = arc tan tan t + ------ 2 sgn ( t ) K y Kx 2 2 r, eq = arc tan tan r + ------ 2 sgn ( r ) K y
Aligning Moment Coefficients at Combined Slip Name used in tire property file: SSZ1 SSZ2 SSZ3 SSZ4
(83)
(84)
Explanation: Nominal value of s/R0 effect of Fx on Mz Variation of distance s/R0 with Fy/Fznom Variation of distance s/R0 with inclination Variation of distance s/R0 with load and inclination
Formulas for Overturning Moment at Pure and Combined Slip For the overturning moment, the formula reads both for pure and combined slip situations:
(85)
Explanation: Lateral force induced overturning couple Inclination induced overturning couple Fy induced overturning couple
36 Adams/Tire
Formulas for Rolling Resistance Moment at Pure and Combined Slip The rolling resistance moment is defined by:
(86)
Explanation: Rolling resistance moment coefficient Rolling resistance moment depending on Fx Rolling resistance moment depending on speed Rolling resistance moment depending on speed^4 Measurement speed
Combined Slip with friction ellipse In case the tire property file does not contain the coefficients for the 'standard' combined slip method (cosine 'weighing functions), the friction ellipse method is used, as described in this section. Note that the method employed here is not part of one of the Magic Formula publications by Pacejka, but is an inhouse development of MSC.Software.
F y, 0 S Vy y, act = -----------------------Fz
Dy y, max = -----Fz
37
1 x = -------------------------------------------------------1 2 tan 2 ------------- + -------------- x, act y, max tan y = -------------------------------------------------------2 2 tan 1 --------------- + ------------- x, max y, act
The forces corrected for the combined slip conditions are:
x F x = ------------- F x, 0 x, act
For aligning moment Mx, rolling resistance My and aligning moment Mz the formulae (76) until and including (84) are used with
38 Adams/Tire
For calculating the lateral deflection v1 of the string in the first point of contact with the road, the following differential equation is valid:
(87)
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
(88)
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:
39
du 1 + V x u 1 = x V sx dt
(89)
Both the longitudinal and lateral relaxation length are defined as of the vertical load:
x = F z ( p Tx1 + p Tx2 df z ) exp ( p Tx3 df z ) ( R 0 F z0 ) Fz = p Ty1 F z0 sin p Ky4 arc tan ---------------------------- ( 1 p Ky3 2 ) R 0 Fz0 p Ty2 F z0 Fz0
Now the practical slip quantities,
(90)
(91)
(93)
Using these practical slip quantities, ' and ' , the Magic Formula equations can be used to calculate the tire-road interaction forces and moments:
(97)
with the parameters (in addition to the basic tire parameter mbelt):
(98)
40 Adams/Tire
(99)
M z = M z' + M z, gyr
Coefficients and Transient Response Name used in tire property file: PTX1 PTX2 PTX3 PTY1 PTY2 QTZ1 MBELT
Explanation: Longitudinal relaxation length at Fznom Variation of longitudinal relaxation length with load Variation of longitudinal relaxation length with exponent of load Peak value of relaxation length for lateral direction Shape factor for lateral relaxation length Gyroscopic moment constant Belt mass of the wheel
41
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
The options for the USE_MODE and the output of the model have been listed in the table below. USE_MODE Values of PAC-TIME and Related Tire Model Output PAC-TIME output (forces and moments): 0, 0, Fz, 0, 0, 0 Fx, 0, Fz, 0, My, 0 0, Fy, Fz, Mx, 0, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz Fx, 0, Fz, 0, My, 0 0, Fy, Fz, Mx, 0, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz
USE_MODE: 0 1 2 3 4 11 12 13 14
State: Steady state Steady state Steady state Steady state Steady state Transient Transient Transient Transient
Slip conditions: Acts as a vertical spring and damper Pure longitudinal slip Pure lateral (cornering) slip Longitudinal and lateral (not combined) Combined slip Pure longitudinal slip Pure lateral (cornering) slip Longitudinal and lateral (not combined) Combined slip
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
43
QSY4 = 0 Camber (Inclination) Effects Camber stiffness has been explicitly defined in PAC-TIME, so camber stiffness can be easily checked by the tire model parameters itself, see the table, Checklist for PAC-TIME Parameters and Properties, below. For car tires, positive inclination should result in a negative lateral force at zero slip angle (see Effect of Positive Camber on the Lateral Force in TYDEX W-axis (ISO) System below). If positive inclination results in an increase of the lateral force, the coefficient may not be valid for the ISO, but for the SAE coordinate system. Note that PAC-TIME only uses coefficients for the TYDEX W-axis (ISO) system. Effect of Positive Camber on the Lateral Force in TYDEX W-axis (ISO) System
The following table lists further checks on the PAC-TIME parameters. Checklist for PAC-TIME Parameters and Properties Parameter/property: LONGVL VXLOW Dx Requirement: 1 m/s >0 Explanation: Reference velocity at which parameters are measured Peak friction (see equation (24))
44 Adams/Tire
Explanation: Peak friction Fx must decrease with increasing load Long slip stiffness (see equation (27)) Peak friction (see equation (35)) Peak friction Fx must decrease with increasing load Cornering stiffness (see equation (38)) Camber stiffness (see equation (39)) Rolling resistance, in the range of 0.005 - 0.015
Validity Range of the Tire Model Input In the tire property file, a range of the input variables has been given in which the tire properties are supposed to be valid. These validity range parameters are (the listed values can be different): $-----------------------------------------------------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
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.
45
Because all car manufacturers and their tire suppliers have the same goal (that is, development of tires to improve dynamic safety of the vehicle), it aimed for standardization in the tire behavior description. 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
Road tangent plane Plane with the normal unit vector (tangent to the road) in the tire-road contact point C. C-axis system Wheel plane Contact point C W-axis system Coordinate system mounted on the wheel carrier at the wheel center according to TYDEX, ISO orientation. The plane in the wheel center that is formed by the wheel when considered a rigid disc with zero width. 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. Coordinate system at the tire contact point C, according to TYDEX, ISO orientation.
46 Adams/Tire
Tire Kinematics Tire Kinematics Definitions Parameter: R0 R Re Definition: Unloaded tire radius Loaded tire radius Effective tire radius Radial tire deflection Dimensionless radial tire deflection Radial tire deflection at nominal load Tire belt mass Rotational velocity of the wheel Units: [m] [m] [m] [m] [-] [m] [kg] [rads-1]
d Fz0
mbelt
Slip Quantities Slip Quantities Definitions Parameter: V Vsx Vsy Vs Vx Vy Vr Vehicle speed Slip speed in x direction Slip speed in y direction Resulting slip speed Rolling speed in x direction Lateral speed of tire contact center Linear speed of rolling Longitudinal slip Slip angle Inclination angle Definition: Units: [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [-] [rad] [rad]
Forces and Moments Force and Moment Definitions Abbreviation: Fz Fz0 dfz Fx Definition: Vertical wheel load Nominal load Dimensionless vertical load Longitudinal force Units: [N] [N] [-] [N]
47
Abbreviation: Fy Mx My Mz
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. Khne,A new tyre model for TIME measurement data,Tire Technology Expo 2003, Hannover.
48 Adams/Tire
! *-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 ='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]
49
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 [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
50 Adams/Tire
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.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 RBX1 = 13.276 $Slope factor for combined slip Fx reduction RBX2 = -13.778 $Variation of slope Fx reduction with kappa RCX1 = 1.0 $Shape factor for combined slip Fx reduction
51
REX1 = 0 $Curvature factor of combined Fx REX2 = 0 $Curvature factor of combined Fx with load RHX1 = 0 $Shift factor for combined slip Fx reduction 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 $--------------------------------------------------------overturning [OVERTURNING_COEFFICIENTS] QSX1 = 0 $Lateral force induced overturning moment QSX2 = 0 $Camber induced overturning moment QSX3 = 0 $Fy induced overturning moment $------------------------------------------------------------lateral [LATERAL_COEFFICIENTS] PCY1 = 1.18 $Shape factor Cfy for lateral forces PDY1 = 0.90312 $Lateral friction Muy PDY2 = -0.17023 $Exponent lateral friction Muy PDY3 = -0.76512 $Variation of friction Muy with squared camber PEY1 = -0.57264 $Lateral curvature Efy at Fznom PEY2 = -0.13945 $Variation of curvature Efy with load PEY3 = 0.030873 $Zero order camber dependency of curvature Efy PEY4 = 0 $Variation of curvature Efy with camber PKY1 = -25.128 $Maximum value of stiffness Kfy/Fznom PKY2 = 3.2018 $Load with peak of cornering stiffness PKY3 = 0 $Variation with camber squared of cornering stiffness PKY4 = 1.9998 $Shape factor for cornering stiffness with load PKY5 = -0.50726 $Camber stiffness/Fznom PKY6 = 0 $Camber stiffness depending on Fz squared PHY1 = 0.0031414 $Horizontal shift Shy at Fznom PHY2 = 0 $Variation of shift Shy with load PVY1 = 0.0068801 $Vertical shift in Svy/Fz at Fznom
52 Adams/Tire
PVY2 = -0.0051 $Variation of shift Shv with 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.0 $Shape factor for combined Fy reduction REY1 = 0 $Curvature factor of combined Fy REY2 = 0 $Curvature factor of combined Fy with load RHY1 = 0 $Shift factor for combined Fy reduction RHY2 = 0 $Shift factor for combined Fy reduction with load RVY1 = 0 $Kappa induced side force Svyk/Muy*Fz at Fznom RVY2 = 0 $Variation of Svyk/Muy*Fz with load RVY3 = 0 $Variation of Svyk/Muy*Fz with camber RVY4 = 0 $Variation of Svyk/Muy*Fz with alpha RVY5 = 0 $Variation of Svyk/Muy*Fz with kappa RVY6 = 0 $Variation of Svyk/Muy*Fz with atan(kappa) PTY1 = 4.1114 $Peak value of relaxation length SigAlp0/R0 PTY2 = 6.1149 $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 = 5.6241 $Trail slope factor for trail Bpt at Fznom QBZ2 = -2.2687 $Variation of slope Bpt with load QBZ4 = 6.891 $Variation of slope Bpt with camber QBZ5 = -0.35587 $Variation of slope Bpt with absolute camber
53
QCZ1 = 1.0904 pneumatic trail QDZ1 = 0.082871 Dpt*(Fz/Fznom*R0) QDZ2 = -0.012677 with load QDZ6 = 0.00038069 Dmr = Dmr/(Fz*R0) QDZ7 = 0.00075331 factor Dmr with load QDZ8 = -0.083385 factor Dmr with camber QDZ9 = 0 factor Dmr with camber and load QEZ1 = -34.759 at Fznom QEZ2 = -37.828 Ept with load QEZ4 = 0.59942 Ept with sign of Alpha-t QHZ1 = 0.0025743 Sht at Fznom QHZ2 = -0.0012175 Sht with load QHZ3 = 0.038299 Sht with camber QHZ4 = 0.044776 Sht with camber and load SSZ1 = 0.0097546 effect of Fx on Mz SSZ2 = 0.0043624 s/R0 with Fy/Fznom SSZ3 = 0 s/R0 with camber SSZ4 = 0 s/R0 with load and camber QTZ1 = 0 constant MBELT = 0 -kg-
$Shape factor Cpt for $Peak trail Dpt = $Variation of peak Dpt $Peak residual torque $Variation of peak $Variation of peak $Variation of peak $Trail curvature Ept $Variation of curvature $Variation of curvature $Trail horizontal shift $Variation of shift $Variation of shift $Variation of shift $Nominal value of s/R0: $Variation of distance $Variation of distance $Variation of distance $Gyroscopic torque $Belt mass of the wheel
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
54 Adams/Tire
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.
International Colloquium on Tyre Models for Vehicle Dynamics Analysis, Swets & Zeitlinger B.V., Amsterdam/Lisse, 1993. PAC2002 is technically superior, continuously kept up to date with latest Magic Formula developments, and MSCs recommended handling model. However, because many Adams/Tire users have pre-existing tire data or new data from tire suppliers and testing organizations in a format that is compatible with the Pacejka '89 and '94 models, the Adams/Tire Handling module includes these models in addition to the PAC2002. The material in this help is intended to illustrate only the formulas used in the Pacejka '89 and '94 tire models. For general information on the PAC2002 and the Magic Formula method, see the papers cited above or the PAC2002 help.
History of the Pacejka Name in Adams/Tire About Coordinate Systems Normal Force
History of the Pacejka Name in Adams/Tire The formulas used in the Pacejka '89 and '94 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. About Coordinate Systems The coordinate systems used in tire modeling and measurement are sometimes confusing. The coordinate systems employed in the Pacejka 89 and 94 tire models are no exception. They are derived from the
12 Adams/Tire
tire-measurement systems that the majority of Adams/Tire customers were using at the time when the models were originally developed. The Pacejka '89 and '94 tire models were developed before the implementation of the TYDEX STI. As a result, Pacejka 89 conforms to a modified SAE-based tire coordinate system and sign conventions, and Pacejka 94 conforms to the standard SAE tire coordinate system and sign conventions. MSC maintains these conventions to ensure file compatibility for Adams/Tire customers. Future tire models will adhere to one single coordinate system standard, the TYDEX C-axis and W-axis system. For more information on the TYDEX standard, see Standard Tire Interface (STI). 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. Definition of Tire Slip Quantities Slip Quantities at combined cornering and braking/traction
13
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the wheel rotational velocity
V sx = V x R l
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 velocities in the contact point:
Lagged longitudinal and lateral slip quantities (transient tire behavior) In general, the tire rotational speed and lateral slip will change continuously because of the changing interaction forces in between the tire and the road. Often the tire dynamic response will have an important role on the overall vehicle response. For modeling this so-called transient tire behavior, a firstorder 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 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
14 Adams/Tire
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:
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 used instead of the usual and definitions for steady-
The longitudinal and lateral relaxation length are estimated with the longitudinal and lateral stiffness of the non-rolling tire:
BCD x = ------------------------------------------------------longitudinal_stiffness
and
BCD y = -----------------------------------------lateral_stiffness
For BCDx and BCDy see section Force and Moment Formulation for Pacejka '89 or '94.
15
In case the longitudinal stiffness is not available in the tire property file the longitudinal stiffness is estimated with:
16 Adams/Tire
Conventions for Naming Variables Variable name and abbreviation: Normal load Lateral force Longitudinal force Self-aligning torque Inclination angle Fz (kN) Fy (N) Fx (N) Mz (Nm) Description: Positive when the tire is penetrating the road.* Positive in a right turn. Negative in a left turn. Positive during traction. Negative during braking. Positive in a left turn. Negative in a right turn. Positive when the top of the tire tilts to the right (when viewing the tire from the rear).* Positive in a right turn.* Negative in braking (-100%: wheel lock). Positive in traction.
* Opposite convention to standard SAE coordinate system shown in SAE Tire Coordinate System.
Longitudinal Force for Pacejka '89 C - Shape Factor C=B0 D - Peak Factor D=(B1*FZ2+B2*FZ) BCD BCD=(B3*FZ2+B4*FZ)*EXP(-B5*FZ) B - Stiffness Factor B=BCD/(C*D)
17
Horizontal Shift Sh=B9*FZ+B10 Vertical Shift Sv=0.0 Composite X1=(+Sh) 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: B0 B1 , B2 B3 , B4 , B 5 B6 , B7 , B 8 B9, B10 Shape factor Peak factor BCD calculation Curvature factor Horizontal shift Description:
18 Adams/Tire
Lateral Force for Pacejka '89 C - Shape Factor C=A0 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
19
E=(A6*FZ+A7) FY Equation FY=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv Parameters for Lateral Force Parameters: A0 A1, A2 A3, A4, A5 A6, A7 A8, A9, A10 A11, A12, A13 Shape factor Peak factor BCD calculation Curvature factor Horizontal shift Vertical shift Description:
20 Adams/Tire
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 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 for Self-Aligning Torque Parameters: C0 C1 , C2 C3 , C4 , C5 , C6 C7, C8, C9, C10 C11, C12, C13 C14, C15, C16, C17 Shape factor Peak factor BCD calculation Curvature factor Horizontal shift Vertical shift Description:
21
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 And an incremental aligning torque due to longtiudinal force (Fx) Mz = Mz,Magic Formula + Fx * 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
22 Adams/Tire
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 Rolling resistance moment 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
23
$-------------------------------------------------------------MODEL [MODEL] ! use mode 123411121314 ! ----------------------------------------------------------------! smoothingXXXX ! combinedXXXX ! transient X X X X ! PROPERTY_FILE_FORMAT = 'PAC89' USE_MODE = 12.0 TYRESIDE = 'LEFT' $----------------------------------------------------------DIMENSION [DIMENSION] UNLOADED_RADIUS = 326.0 WIDTH = 245.0 ASPECT_RATIO = 0.35 $----------------------------------------------------------PARAMETER [PARAMETER] VERTICAL_STIFFNESS = 310.0 VERTICAL_DAMPING = 3.1 LATERAL_STIFFNESS = 190.0 ROLLING_RESISTANCE = 0.0 $---------------------------------------------------------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]
24 Adams/Tire
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 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
25
Conventions for Naming Variables Variable name and abbreviation: Normal load Lateral force Longitudinal force Self-aligning torque Inclination angle Sideslip angle Longitudinal slip Fz (kN) Fy (N) Fx (N) Mz (Nm) Description: Positive when the tire is penetrating the road. Positive in a right turn. Negative in a left turn. Positive during traction. Negative during braking. Positive in a left turn. Negative in a right turn. Positive when the top of the tire tilts to the right (when viewing the tire from the rear). Positive in a left turn. Negative in braking (-100%: wheel lock). Positive in traction.
Longitudinal Force for Pacejka '94 C - Shape Factor C=B0 D - Peak Factor
26 Adams/Tire
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 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 for Longitudinal Force Parameters: B0 B1 , B2 B3 , B4 , B5 B6, B7, B8, B13 B9, B10 B11, B12 DLON, BCDLON Shape factor Peak factor BCD calculation Curvature factor Horizontal shift Vertical shift Scale factor Description:
Lateral Force for Pacejka '94 C - Shape Factor C=A0 D - Peak Factor D=((A1*FZ+A2) *(1-A15* 2)*FZ) * DLAT
27
BCD BCD=(A3*SIN(ATAN(FZ/A4)*2.0)*(1-A5*ABS( )))* BCDLAT B - Stiffness Factor B=BCD/(C*D) Horizontal Shift Sh=A8*FZ+A9+A10* Vertical Shift 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 for Lateral Force Parameters: A0 A1, A2, A15 A3, A4, A5 A6, A7, A16, A17 A8, A9, A10 A11, A12, A13, A14 DLAT, BCDLAT Shape factor Peak factor BCD calculation Curvature factor Horizontal shift Vertical shift Scale factor Description:
Self-Aligning Torque for Pacejka '94 C - Shape Factor C=C0 D - Peak Factor D=(C1*FZ2+C2*FZ)*(1-C18* 2) BCD
28 Adams/Tire
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* Vertical Shift Sv=C14*FZ+C15+(C16*FZ2+C17*FZ)* Composite X1=( +Sh) E - Curvature Factor E=(((C7*FZ2)+(C8*FZ)+C9)*(1-(((C19* )+C20)*SIGN(1,X1))))/(1-(C10*ABS( ))) MZ Equation MZ=(D*SIN(C*ATAN(B*X1-E*(B*X1-ATAN(B*X1)))))+Sv Parameters for Self-Aligning Torque Parameters: C0 C1, C2, C18 C3 , C4 , C5 , C6 C7, C8, C9, C19, C20 C11, C12, C13 C14, C15, C16, C17 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 And an incremental aligning torque due to longtiudinal force (Fx): Mz = Mz,Magic Formula + Fx * deflection Shape factor Peak factor BCD calculation Curvature factor Horizontal shift Vertical shift Description:
29
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 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 Rolling resistance moment 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
30 Adams/Tire
!:COMMENT: New File Format v2.1 !:FILE_FORMAT: ASCII !:TIMESTAMP: 1996/02/15,13:22:12 !:USER: ncos $--------------------------------------------------------------units [UNITS] 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
31
A1 = -1.2854474E+01 A2 = -1.1133711E+03 A3 = -4.4104698E+03 A4 = -1.2518279E+01 A5 = -2.4000120E-03 A6 = 6.5642332E-02 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
32 Adams/Tire
C19 = -4.2525059E-01 C20 = -2.1503067E-01 $--------------------------------------------------------------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
Output:
Adjusted longitudinal force Fx and lateral force Fy to incorporate the reduction due to combined
slip:
33
F y S vy y, act = ------------------Fz Dy y, max = -----Fz tan y = ----------------------------------------------------------tan 1 --------------- 2 + --------------- 2 x, max y, max y F y, comb = ------------- ( F y + S vy ) y, act
1 x = -------------------------------------------------------tan 1 ------------- 2 + --------------- 2 x, act y, max x F x, comb = ------------- ( F x + S vx ) x, act Left and Right Side Tires
In general, a tire produces a lateral force and aligning moment at zero slip angle due to the tire construction, known as conicity and plysteer. In addition, the tire characteristics cannot be symmetric for positive and negative slip angles. A tire property file with the parameters for the model results from testing with a tire that is mounted in a tire test bench comparable either to the left or the right side of a vehicle. If these coefficients are used for both the left and the right side of the vehicle model, the vehicle does not drive straight at zero steering wheel angle. 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 (TIRESIDE = 'LEFT' or TIRESIDE = '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 AdamsS/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 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.
34 Adams/Tire
Figure 1
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
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
35
36 Adams/Tire
PAC MC
Learn about using the University of Arizona (UA) tire model:
obstacles must be longer than the tire radius) The PAC MC model has proven to be applicable to motorcycle tires with inclination angles to the road up to 60 degrees. In some cases, it can be used for car tires when exposed to large camber. PAC MC and Previous Magic Formula Models Compared to previous versions, PAC MC is backward compatible with all MF-MCTyre 1.x tire models, generates the same output, and deals with all previous versions of MF-MCTyre property files. In addition to PAC MC in Adams, the PAC MC in v2 contins a more advanced tire-road contact modeling method that takes the tire's cross-section shape into account, which plays an important role at large inclination angles of the wheel with the road. Learn more about the tire cross-section profile contact method.
12 Adams/Tire
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. Input and Output Variables of the Magic Formula Tire Model
13
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. TYDEX C- and W-Axis Systems Used in PAC MC, Source[2]
14 Adams/Tire
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.
15
SI Units Used in PAC MC Variable Type: Angle Name: Slip angle Inclination angle Force Longitudinal force Lateral force Vertical load Moment Overturning moment Rolling resistance moment Self-aligning moment Speed Longitudinal speed Lateral speed Longitudinal slip speed Lateral slip speed Rotational speed Tire rolling speed Abbreviation: Unit: Radians
Fx Fy Fz Mx My Mz Vx Vy V sx V sy
Newton
Newton.meter
Definition of Tire Slip Quantities Slip Quantities at Combined Cornering and Braking/Traction
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
16 Adams/Tire
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
The practical slip quantities (longitudinal slip) and velocities in the contact point with:
(2)
(3)
(4)
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 figure below). Contact Point C: Intersection between Road Tangent Plane, Spin Axis Plane, and Wheel Plane
17
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 F z of the tire is calculated with:
Fz = Cz + Kz
where
(6)
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.
18 Adams/Tire
Loaded and Effective Tire Rolling Radius With the loaded rolling tire radius R defined as the distance of the wheel center to the contact point of the tire with the road (see Effective Rolling Radius and Longitudinal Slip), where is the deflection of the tire, and R0 is the free (unloaded) tire radius, then the loaded tire radius Rl reads:
R1 = R0
In this tire model, a constant (linear) vertical tire stiffness
(7)
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 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. Effective Rolling Radius and Longitudinal Slip
19
R e = R 0 Fz0 ( D atan ( ( B d ) + F d ) )
in which
(10)
F z0 Fz0 = ------Cz
and
20 Adams/Tire
d = ------- Fz0
Example of the Loaded and Effective Tire Rolling Radius as a Function of the Vertical Load
(12)
Normal Load and Rolling Radius Parameters Name Used in Tire Property File: FNOMIN UNLOADED_RADIUS BREFF DREFF FREFF VERTICAL_STIFFNESS VERTICAL_DAMPING Free tire radius Low load stiffness effective rolling radius Peak value of effective rolling radius High load stiffness effective rolling radius Tire vertical stiffness Tire vertical damping
Name:
F z0 R0 B D F Cz KZ
21
For pure slip conditions, the lateral force F y as a function of the lateral slip
longitudinal force F x 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:
(13)
added with the residual moment M zr . In fact, the aligning moment is due to the offset of lateral force F y , called pneumatic trail t, from the contact point. Because the pneumatic trail t as a function of the lateral slip
22 Adams/Tire
(14)
The figure, The Magic Formula and the Meaning of Its Parameters, illustrates the functionality of the B, C, D, and E factor in the Magic Formula:
D-factor determines the peak of the characteristic, and is called the peak factor. C-factor determines the part used of the sine and, therefore, mainly influences the shape of the
23
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
24 Adams/Tire
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). Inclination Effects in the Lateral Force From a historical point of view, the basic Magic Formulas have always been developed for car and truck tires, which cope with inclinations angles of not more than 10 degrees. To be able to describe the effects at large inclinations, an extension of the basic Magic Formula for the lateral force Fy has been developed. A contribution of the inclination
This elegant formulation has the advantage of an explicit definition of the camber stiffness, because this results now in:
K = B C D =
Input Variables
F yo at
y = 0
(16)
The input variables to the Magic Formula are: Input Variables Longitudinal slip Slip angle Inclination angle Normal wheel load Output Variables Its output variables are: Output Variables Longitudinal force Lateral force Fx Fy [N] [N]
Fz
25
Mx My Mz
The output variables are defined in the W-axis system of TYDEX. Basic Tire Parameters All tire model parameters of the model are without dimension. The reference parameters for the model are: Basic Tire Parameters Nominal (rated) load Unloaded tire radius Tire belt mass Fz0 R0 mbelt [N] [m] [kg]
As a measure for the vertical load, the normalized vertical load increment dfz is used:
F z F' z0 df z = ------------------F' z0
with the possibly adapted nominal load (using the user-scaling factor,
(17)
Fz0 ):
(18)
F' z0 = F z0 Fz0
Nomenclature of the Tire Model Parameters
In the subsequent sections, formulas are given with non-dimensional parameters aijk with the following logic: Tire Model Parameters Parameter: a= p q r s Definition: Force at pure slip Moment at pure slip Force at combined slip Moment at combined slip
26 Adams/Tire
Curvature factor Slip stiffness = BCD Horizontal shift Vertical shift Moment at combined slip Transient tire behavior Along the longitudinal axis Along the lateral axis About the vertical axis
User Scaling Factors A set of scaling factors is available to easily examine the influence of changing tire properties without the need to change one of the real Magic Formula coefficients. The default value of these factors is 1. You can change the factors in the tire property file. The peak friction scaling factors, and , are also used for the position-dependent friction in 3D Road Contact and Adams/3D Road. An overview of all scaling factors is shown in the next tables. Scaling Factor Coefficients for Pure Slip Name used in tire property file: LFZO LCX LMUX LEX LKX LVX LGAX LCY LMUY LEY
Name:
Explanation: Scale factor of nominal (rated) load Scale factor of Fx shape factor Scale factor of Fx peak friction coefficient Scale factor of Fx curvature factor Scale factor of Fx slip stiffness Scale factor of Fx vertical shift Scale factor of camber for Fx Scale factor of Fy shape factor Scale factor of Fy peak friction coefficient Scale factor of Fy curvature factor
Fz0 Cx Ex Kx Vx x Cy y Ey
27
Name:
Name used in tire property file: LKY LCC LKC LEC LHY LGAY LTR LRES LGAZ LMX LVMX LMY
Explanation: Scale factor of Fy cornering stiffness Scale factor of camber shape factor Scale factor of camber stiffness (K-factor) Scale factor of camber curvature factor Scale factor of Fy horizontal shift Scale factor of camber force stiffness Scale factor of peak of pneumatic trail Scale factor for offset of residual torque Scale factor of camber torque stiffness Scale factor of overturning couple Scale factor of Mx vertical shift Scale factor of rolling resistance torque
Ky C K E Hyy t Mr gz Mx VMx My
Scaling Factor Coefficients for Combined Slip Name used in tire property file: LXAL LYKA LVYKA LS
Name:
Explanation: Scale factor of alpha influence on Fx Scale factor of alpha influence on Fx Scale factor of kappa induced Fy Scale factor of Moment arm of Fx
x y Vy s
Scaling Factor Coefficients for Combined Slip Name used in tire property file: LXAL LYKA LVYKA LS
Name:
Explanation: Scale factor of alpha influence on Fx Scale factor of alpha influence on Fx Scale factor of kappa induced Fy Scale factor of Moment arm of Fx
x y Vy s
28 Adams/Tire
Scaling Factor Coefficients for Transient Response Name used in tire property file: LSGKP LSGAL LGYR
Name:
Explanation: Scale factor of relaxation length of Fx Scale factor of relaxation length of Fy Scale factor of gyroscopic moment
gyr
Formulas for the Longitudinal Force at Pure Slip For the tire rolling on a straight line with no slip angle, the formulas are:
C x = p Cx1 Cx Dx = x Fz 1
2 x = ( p Dx1 + p Dx2 df z ) ( 1 p Dx3 x ) x 2 E x = ( p Ex1 + p Ex2 df z + p Ex3 df z ) { 1 p Ex4 sgn ( x ) } Ex with E x 1
29
(27)
(K x = B x C x D x = Bx = Kx ( Cx Dx )
Name: pCx1 pDx1 pDx2 pDx3 pEx1 pEx2 pEx3 pEx4 pKx1 pKx2 pKx3 pVx1 pVx2
Explanation: Shape factor Cfx for longitudinal force Longitudinal friction Mux at Fznom Variation of friction Mux with load Variation of friction Mux with camber Longitudinal curvature Efx at Fznom Variation of curvature Efx with load Variation of curvature Efx with load squared Factor in curvature Efx while driving Longitudinal slip stiffness Kfx/Fz at Fznom Variation of slip stiffness Kfx/Fz with load Exponent in slip stiffness Kfx/Fz with load Vertical shift Svx/Fz at Fznom Variation of shift Svx/Fz with load
(31) (32)
30 Adams/Tire
y = + S Hy y = y
with coefficients:
( Cy + C < 2 )
(33)
C y = p Cy1 Cy Dy = y Fz 2
2 y = p Dy1 exp ( p Dy2 df z ) ( 1 p Dy3 y ) y 2 E y = { p Ey1 + p Ey2 y ( p Ey3 + p Ey4 y ) sin ( y ) } Ey with E y 1
(39)
(K y = B y C y D y = By = Ky ( Cy Dy ) S Hy = p Hy1 Hy C = p Cy2 C
F yo at y = 0 ) y
(40) (41) (42)
(=B C D =
F yo at y = 0
31
Lateral Force Coefficients at Pure Slip Name used in tire property file: PCY1 PCY2 PDY1 PDY2 PDY3 PEY1 PEY2 PEY3 PEY4 PEY5 PKY1 PKY2 PKY3 PKY4 PKY5 PKY6 PKY7 PHY1
Name: pCy1 pCy2 pDy1 pDy2 pDy3 pEy1 pEy2 pEy3 pEy4 pEy5 pKy1 pKy2 pKy3 pKy4 pKy5 pKy6 pKy7 pHy1
Explanation: Shape factor Cfy for lateral forces Shape factor Cfc for camber forces Lateral friction Muy Exponent lateral friction Muy Variation of friction Muy with squared camber Lateral curvature Efy at Fznom Variation of curvature Efy with camber squared Asymmetric curvature Efy at Fznom Asymmetric curvature Efy with camber Camber curvature Efc Maximum value of stiffness Kfy/Fznom Curvature of stiffness Kfy Peak stiffness factor Peak stiffness variation with camber squared Lateral stiffness dependency with camber squared Camber stiffness factor Kfc Vertical load dependency of camber stiffness Kfc Horizontal shift Shy at Fznom
M z' = M z0 ( , , F z ) M z0 = t F y0 + M zr
with the pneumatic trail t: (46)
(47) (48)
(49)
32 Adams/Tire
r = + S Hr
The scaled inclination angle:
(50)
z = z
with coefficients:
2 B t = ( q Bx1 + q Bx2 df z + q Bx3 df z ) { 1 + q Bx4 z + q Bz5 z } Ky y
(51)
C t = q Cz1
2 D t = F z ( q Dz1 + q Dz2 df z ) ( 1 + q Dz3 z + q Dz4 z ) ( R 0 F z0 ) 2 E t = ( q Ex1 + q Ex2 df z + q Ex3 df z )
(56)
(57) (58)
D r = F z [ ( q Dz6 + q Dz7 df z ) r + ( q Dz8 + q Dz9 df z ) z + ( q Dz10 + q Dz11 df z ) ( z z )(59) y ]R 0 S Hr = q Hz1 + q Hz2 df z + ( q Hz3 + q Hz4 df z ) z
An approximation for the aligning moment stiffness reads: (60)
Kz = t Ky
dM z at = 0 ) d
(61)
Aligning Moment Coefficients at Pure Slip Name used in tire property file: QBZ1 QBZ2 qBz3 QBZ4 QBZ5
Explanation: Trail slope factor for trail Bpt at Fznom Variation of slope Bpt with load Variation of slope Bpt with load squared Variation of slope Bpt with camber Variation of slope Bpt with absolute camber
33
Name: qBz9 qCz1 qDz1 qDz2 qDz3 qDz4 qDz6 qDz7 qDz8 qDz9 qDz10 qDz11 qEz1 qEz2 qEz3 qEz4 qEz5 qHz1 qHz2 qHz3 qHz4
Name used in tire property file: QBZ9 QCZ1 QDZ1 QDZ2 QDZ3 QDZ4 QDZ6 QDZ7 QDZ8 QDZ9 QDZ10 QDZ11 QEZ1 QEZ2 QEZ3 QEZ4 QEZ5 QHZ1 QHZ2 QHZ3 QHZ4
Explanation: Slope factor Br of residual torque Mzr Shape factor Cpt for pneumatic trail Peak trail Dpt = Dpt*(Fz/Fznom*R0) Variation of peak Dpt with load Variation of peak Dpt with camber Variation of peak Dpt with camber squared. Peak residual moment Dmr = Dmr/ (Fz*R0) Variation of peak factor Dmr with load Variation of peak factor Dmr with camber Variation of Dmr with camber and load Variation of peak factor Dmr with camber squared Variation of Dmr with camber squared and load Trail curvature Ept at Fznom Variation of curvature Ept with load Variation of curvature Ept with load squared Variation of curvature Ept with sign of Alpha-t Variation of Ept with camber and sign Alpha-t Trail horizontal shift Shr at Fznom Variation of shift Shr with load Variation of shift Shr with camber Variation of shift Sht with camber and load
Steady-State Combined Slip PAC-TIME has two methods for calculating the combined slip forces and moments. If the user supplies the coefficients for the combined slip cosine 'weighing' functions, the combined slip is calculated according to Combined slip with cosine 'weighing' functions (standard method). If no coefficients are supplied, the so-called friction ellipse is used to estimate the combined slip forces and moments, see section Combined Slip with friction ellipse Combined slip with cosine 'weighing' functions
Longitudinal Force at Combined Slip Lateral Force at Combined Slip Aligning Moment at Combined Slip Overturning Moment at Pure and Combined Slip
34 Adams/Tire
F x = F x0 G x ( , , F z )
with Gx o the weighting function of the longitudinal force for pure slip. We write:
(62)
(63) (64)
B x = ( r Bx1 + r Bx3 2 ) cos [ arc tan { r Bx2 } ] x C x = r Cx1 F xo D x = ----------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C x arc tan { B x S Hx E x ( B x S Hx arc tan ( B x S Hx ) ) } ] E x = r Ex1 + r Ex2 df z with E x 1 S Hx = r Hx1
The weighting function follows as:
(65) (66)
cos [ C x arc tan { B x s E x ( B x s arc tan ( B x s ) ) } ] G x = ----------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C x arc tan { B x S Hx E x ( B x S Hx arc tan ( B x S Hx ) ) } ]
Longitudinal Force Coefficients at Combined Slip Name used in tire property file: RBX1 RBX2 RBX3 RCX1 REX1 REX2 RHX1
(70)
Explanation: Slope factor for combined slip Fx reduction Variation of slope Fx reduction with kappa Influence of camber on stiffness for Fx reduction Shape factor for combined slip Fx reduction Curvature factor of combined Fx Curvature factor of combined Fx with load Shift factor for combined slip Fx reduction
35
F y = F y0 G y ( , , , F z ) + S Vy
(71)
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:
(72) (73)
B y = ( r By1 + r By4 2 ) cos [ arc tan { r By2 ( r By3 ) } ] y C y = r Cy1 F yo D y = -------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C y arc tan { B y S Hy E y ( B y S Hy arc tan ( B y S Hy ) ) } ] E y = r Ey1 + r Ey2 df z with E y 1 S Hy = r Hy1 + r Hy2 df z S Vyk = D Vy sin [ r Vy5 arc tan ( r vy6 ) ] Vy D Vy = y F z ( r Vy1 + r Vy2 df z + r Vy3 ) cos [ arc tan ( r Vy4 ) ]
The weighting function appears is defined as:
(74) (75)
cos [ C y arc tan { B y s E y ( B y s arc tan ( B y s ) ) } ] G y = -------------------------------------------------------------------------------------------------------------------------------------------------------------cos [ C y arc tan { B y S Hy E y ( B y S Hy arc tan ( B y S Hy ) ) } ]
Lateral Force Coefficients at Combined Slip Name used in tire property file: RBY1 RBY2 RBY3 RCY1 REY1
(81)
Explanation: Slope factor for combined Fy reduction Variation of slope Fy reduction with alpha Shift term for alpha in slope Fy reduction Shape factor for combined Fy reduction Curvature factor of combined Fy
36 Adams/Tire
Name: rEy2 rHy1 rHy2 rVy1 rVy2 rVy3 rVy4 rVy5 rVy6
Name used in tire property file: REY2 RHY1 RHY2 RVY1 RVY2 RVY3 RVY4 RVY5 RVY6
Explanation: Curvature factor of combined Fy with load Shift factor for combined Fy reduction Shift factor for combined Fy reduction with load Kappa-induced side force Svyk/Muy*Fz at Fznom Variation of Svyk/Muy*Fz with load Variation of Svyk/Muy*Fz with inclination Variation of Svyk/Muy*Fz with alpha Variation of Svyk/Muy*Fz with kappa Variation of Svyk/Muy*Fz with atan (kappa)
M z' = t F y' + M zr + s F x
with:
(82)
t = t ( t, eq ) = D t cos [ C t arc tan { B t t, eq E t ( B t t, eq ac tan ( B t t, eq ) ) } ] cos ( ) F' y, = 0 = F y S Vy M zr = M zr ( r, eq ) = D r cos [ arc tan ( B r r, eq ) ] cos ( ) s = { s sz1 + s sz2 ( F y F z0 ) + ( s sz3 + s sz4 df z ) } R 0 s
with the arguments:
Kx 2 2 t, eq = arc tan tan t + ------ 2 sgn ( t ) K y Kx 2 2 r, eq = arc tan tan r + ------ 2 sgn ( r ) K y
(88)
(89)
37
Aligning Moment Coefficients at Combined Slip Name used in tire property file: SSZ1 SSZ2 SSZ3 SSZ4
Explanation: Nominal value of s/R0 effect of Fx on Mz Variation of distance s/R0 with Fy/Fznom Variation of distance s/R0 with inclination Variation of distance s/R0 with load and inclination
Formulas for Overturning Moment at Pure and Combined Slip For the overturning moment, the formula reads both for pure and combined slip situations:
(90)
Explanation: Lateral force-induced overturning couple Inclination-induced overturning couple Fy-induced overturning couple
Formulas for Rolling Resistance Moment at Pure and Combined Slip The rolling resistance moment is defined by:
(91)
Explanation: Rolling resistance moment coefficient Rolling resistance moment depending on Fx Rolling resistance moment depending on speed Rolling resistance moment depending on speed^4 Measurement speed
38 Adams/Tire
Combined Slip with friction ellipse In case the tire property file does not contain the coefficients for the 'standard' combined slip method (cosine 'weighing functions), the friction ellipse method is used, as described in this section. Note that the method employed here is not part of one of the Magic Formula publications by Pacejka, but is an inhouse development of MSC.Software.
F y, 0 S Vy y, act = -----------------------Fz
Dy y, max = -----Fz
1 x = -------------------------------------------------------1 2 --------------- 2 tan ------------- + x, act y, max tan y = -------------------------------------------------------1 tan --------------- 2 + ------------- 2 x, max y, act
The forces corrected for the combined slip conditions are:
x F x = ------------- F x, 0 x, act
y F y = ------------- F y, 0 y, act
39
For aligning moment Mx, rolling resistance My and aligning moment Mz the formulae (283) until and including (291) 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:
40 Adams/Tire
(92)
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:
dv 1 + V x v 1 = V sy dt
(93)
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 = x V sx dt
(94)
Both the longitudinal and lateral relaxation length are defined as of the vertical load:
(95)
Fz = p Ty1 sin p Ty2 arc tan -------------------------------------------------------- ( 1 p Ky5 2 ) R 0 Fz0 (96) 2 )F ( p Ty3 + p Ky4 z0 Fz0
Now the practical slip quantities,
(98)
Using these practical slip quantities, ' and ' , the Magic Formula examples can be used to calculate the tire-road interaction forces and moments:
(99) (100)
41
(101)
(102)
with the parameters (in addition to the basic tire parameter mbelt):
(103)
(104)
M z = M z' + M z, gyr
Coefficients and Transient Response Name used in tire property file: PTX1 PTX2 PTX3 PTY1 PTY2 PTY3 QTZ1 MBELT
(105)
Explanation: Relaxation length sigKap0/Fz at Fznom Variation of sigKap0/Fz with load Variation of sigKap0/Fz with exponent of load Peak value of relaxation length Sig_alpha Shape factor for lateral relaxation length Load where lateral relaxation is at maximum Gyroscopic torque constant Belt mass of the wheel
42 Adams/Tire
A tire property file with the parameters for the model results from testing with a tire that is mounted in a tire test bench comparable either to the left or the right side of a vehicle. If these coefficients are used for both the left and the right side of the vehicle model, the vehicle does not drive straight at zero steering wheel angle. 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 (TIRESIDE = 'LEFT' or TIRESIDE = '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 (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. Create Wheel and Tire Dialog Box in Adams/View
43
44 Adams/Tire
USE_MODE Values of PAC MC and Related Tire Model Output PAC MC output (forces and moments) Fx, 0, Fz, 0, My, 0 0, Fy, Fz, Mx, 0, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz Fx, 0, Fz, 0, My, 0 0, Fy, Fz, Mx, 0, Mz Fx, Fy, Fz, Mx, My, Mz Fx, Fy, Fz, Mx, My, Mz
USE MODE: 0 1 2 3 4 11 12 13 14
State: Steady state Steady state Steady state Steady state Steady state Transient Transient Transient Transient
Slip conditions: Pure longitudinal slip Pure lateral (cornering) slip Longitudinal and lateral (not combined) Combined slip Pure longitudinal slip Pure lateral (cornering) slip Longitudinal and lateral (not combined) Combined slip
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
Tire Cross-Section Profile Contact Method In combination with the 2D Road Model and the 3D Road Model, you can improve the tire-road contact calculation method by providing the tire's cross-section profile, which has an important influence on the wheel center height at large inclination angles with the road.
45
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 = road plane in the point C, see Figure above, according to:
Fz = Cz + Kz
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
46 Adams/Tire
recommended to fit measured cross section data with a polynom (for example y = ax2 + bx4 + cx6 + ..) 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.
Camber (Inclination) Effects Camber stiffness has been explicitly defined in PAC MC (see equation (43). For realistic tire behavior, the sign of the camber stiffness must be negative (TYDEX W-axis (ISO) system). If the sign is positive, the coefficients may not be valid for the ISO but for the SAE coordinate system. Note that PAC MC only uses coefficients for the TYDEX W-axis (ISO) system. Effect of Positive Camber on the Lateral Force in TYDEX W-axis (ISO) System
47
The table below lists further checks on the PAC MC parameters. Checklist for PAC MC Parameters and Properties Parameter/property: LONGVL VXLOW Dx pDx1/pDx2 Kx Dy pDy1/pDy2 Ky qsy1 Requirement: Explanation: Reference velocity at which parameters are measured Peak friction (see equation (24)) Peak friction Fx must decrease with increasing load Long slip stiffness (see equation (27)) Peak friction (see equation (36)) Peak friction Fx must decrease with increasing load Cornering stiffness (see equation (39)) Rolling resistance, should in range of 0.005 - 0.015 Camber stiffness (see equation (43))
> 1 m/s > < < > < < < <
0 0 0 0 0 0 0 0
Validity Range of the Tire Model Input In the tire property file, a range of the input variables has been given in which the tire properties are supposed to be valid. These validity range parameters are (the listed values can be different):
48 Adams/Tire
$---------------------------------------------------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 = -1.0996 $Minimum valid camber angle CAMMAX = 1.0996 $Maximum valid camber angle $----------------------------------------------vertical_force_range [VERTICAL_FORCE_RANGE] FZMIN = 73.75 $Minimum allowed wheel load FZMAX = 3319.5 $Maximum allowed wheel load
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.
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.
49
Definitions
General Tire Kinematics Slip Quantities Force and Moments
General General Definitions Term: Road tangent plane C-axis system Wheel plane Contact point C W-axis system Definition: Plane with the normal unit vector (tangent to the road) in the tire-road contact point C. Coordinate system mounted on the wheel carrier at the wheel center according to TYDEX, ISO orientation. The plane in the wheel centre that is formed by the wheel when considered a rigid disc with zero width. 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. Coordinate system at the tire contact point C, according to TYDEX, ISO orientation.
Tire Kinematics Tire Kinematics Definitions Parameter: R0 R Re Definition: Unloaded tire radius Loaded tire radius Effective tire radius Radial tire deflection Dimensionless radial tire deflection Tire belt mass Rotational velocity of the wheel [m] [m] [m] [m] [-] [kg] [rads-1] Units:
d Fz0
mbelt
50 Adams/Tire
Slip Quantities Slip Quantities Definitions Parameter: V Vsx Vsy Vs Vx Vy Vr Definition: Vehicle speed Slip speed in x direction Slip speed in y direction Resulting slip speed Rolling speed in x direction Linear speed of rolling Longitudinal slip Slip angle Inclination angle Units: [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [ms-1] [-] [rad] [rad]
Forces and Moments Force and Moment Definitions Abbreviation: Fz Fz0 dfz Fx Fy Mx My Mz Definition: Vertical wheel load Nominal load Longitudinal force Lateral force Overturning moment Braking/driving moment Aligning moment [N] [N] [N] [N] [Nm] [Nm] [Nm] Units:
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.
51
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.
52 Adams/Tire
LONGVL = 16.7 $Longitudinal speed during measurements TYRESIDE = 'SYMMETRIC' $Mounted side of tyre at vehicle/test bench $---------------------------------------------------------dimensions [DIMENSION] UNLOADED_RADIUS = 0.322 $Free tyre radius WIDTH = 0.18 $Nominal section width of the tyre RIM_RADIUS = 0.216 $Nominal rim radius RIM_WIDTH = 0.135 $Rim width $----------------------------------------------------------parameter [VERTICAL] VERTICAL_STIFFNESS = 2e+005 $Tyre vertical stiffness VERTICAL_DAMPING = 50 $Tyre vertical damping BREFF = 8.4 $Low load stiffness eff. rolling radius DREFF = 0.27 $Peak value of eff. rolling radius FREFF = 0.07 $High load stiffness eff. rolling radius FNOMIN = 1475 $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 = -1.0996 $Minimum valid camber angle CAMMAX = 1.0996 $Maximum valid camber angle $-----------------------------------------------vertical_force_range [VERTICAL_FORCE_RANGE] FZMIN = 73.75 $Minimum allowed wheel load FZMAX = 3319.5 $Maximum allowed wheel load $------------------------------------------------------------scaling [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
53
LEX = 1 $Scale factor of Fx curvature factor LKX = 1 $Scale factor of Fx slip stiffness 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 LCC = 1 $Scale factor of camber shape factor LKC = 1 $Scale factor of camber stiffness (K-factor) LEC = 1 $Scale factor of camber curvature factor LHY = 1 $Scale factor of Fy horizontal shift LGAY = 1 $Scale factor of camber force stiffness 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 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]
54 Adams/Tire
PCX1 = 1.7655 $Shape factor Cfx for longitudinal force PDX1 = 1.2839 $Longitudinal friction Mux at Fznom PDX2 = -0.0078226 $Variation of friction Mux with load PDX3 = 0 $Variation of friction Mux with camber PEX1 = 0.4743 $Longitudinal curvature Efx at Fznom PEX2 = 9.3873e-005 $Variation of curvature Efx with load PEX3 = 0.066154 $Variation of curvature Efx with load squared PEX4 = 0.00011999 $Factor in curvature Efx while driving PKX1 = 25.383 $Longitudinal slip stiffness Kfx/Fz at Fznom PKX2 = 1.0978 $Variation of slip stiffness Kfx/Fz with load PKX3 = 0.19775 $Exponent in slip stiffness Kfx/Fz with load PVX1 = 2.1675e-005 $Vertical shift Svx/Fz at Fznom PVX2 = 4.7461e-005 $Variation of shift Svx/Fz with load RBX1 = 12.084 $Slope factor for combined slip Fx reduction RBX2 = -8.3959 $Variation of slope Fx reduction with kappa RBX3 = 2.1971e-009 $Influence of camber on stiffness for Fx combined RCX1 = 1.0648 $Shape factor for combined slip Fx reduction REX1 = 0.0028793 $Curvature factor of combined Fx REX2 = -0.00037777 $Curvature factor of combined Fx with load RHX1 = 0 $Shift factor for combined slip Fx reduction PTX1 = 0.83 $Relaxation length SigKap0/Fz at Fznom PTX2 = 0.42 $Variation of SigKap0/Fz with load PTX3 = 0.21 $Variation of SigKap0/Fz with exponent of load $--------------------------------------------------------overturning [OVERTURNING_COEFFICIENTS] QSX1 = 0 $Lateral force induced overturning moment QSX2 = 0.16056 $Camber induced overturning moment QSX3 = 0.095298 $Fy induced overturning moment
55
$------------------------------------------------------------lateral [LATERAL_COEFFICIENTS] PCY1 = 1.1086 $Shape factor Cfy for lateral forces PCY2 = 0.66464 $Shape factor Cfc for camber forces PDY1 = 1.3898 $Lateral friction Muy PDY2 = -0.0044718 $Exponent lateral friction Muy PDY3 = 0.21428 $Variation of friction Muy with squared camber PEY1 = -0.80276 $Lateral curvature Efy at Fznom PEY2 = 0.89416 $Variation of curvature Efy with camber squared PEY3 = 0 $Asymmetric curvature Efy at Fznom PEY4 = 0 $Asymmetric curvature Efy with camber PEY5 = -2.8159 $Camber curvature Efc PKY1 = -19.747 $Maximum value of stiffness Kfy/Fznom PKY2 = 1.3756 $Curvature of stiffness Kfy PKY3 = 1.3528 $Peak stiffness factor PKY4 = -1.2481 $Peak stiffness variation with camber squared PKY5 = 0.3743 $Lateral stiffness depedency with camber squared PKY6 = -0.91343 $Camber stiffness factor Kfc PKY7 = 0.2907 $Vertical load dependency of camber stiffn. Kfc PHY1 = 0 $Horizontal shift Shy at Fznom RBY1 = 10.694 $Slope factor for combined Fy reduction RBY2 = 8.9413 $Variation of slope Fy reduction with alpha RBY3 = 0 $Shift term for alpha in slope Fy reduction RBY4 = -1.8256e-010 $Influence of camber on stiffness of Fy combined RCY1 = 1.0521 $Shape factor for combined Fy reduction REY1 = -0.0027402 $Curvature factor of combined Fy REY2 = -0.0094269 $Curvature factor of combined Fy with load RHY1 = -7.864e-005 $Shift factor for combined Fy reduction RHY2 = -6.9003e-006 $Shift factor for combined Fy reduction with load
56 Adams/Tire
RVY1 = 0 $Kappa induced side force Svyk/Muy*Fz at Fznom RVY2 = 0 $Variation of Svyk/Muy*Fz with load RVY3 = -0.00033208 $Variation of Svyk/Muy*Fz with camber RVY4 = -4.7907e+015 $Variation of Svyk/Muy*Fz with alpha RVY5 = 1.9 $Variation of Svyk/Muy*Fz with kappa RVY6 = -30.082 $Variation of Svyk/Muy*Fz with atan(kappa) PTY1 = 0.75 $Peak value of relaxation length Sig_alpha PTY2 = 1 $Shape factor for Sig_alpha PTY3 = 0.6 $Value of Fz/Fznom where Sig_alpha is maximum $-------------------------------------------------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 = 9.246 $Trail slope factor for trail Bpt at Fznom QBZ2 = -1.4442 $Variation of slope Bpt with load QBZ3 = -1.8323 $Variation of slope Bpt with load squared QBZ4 = 0 $Variation of slope Bpt with camber QBZ5 = 0.15703 $Variation of slope Bpt with absolute camber QBZ9 = 8.3146 $Slope factor Br of residual torque Mzr QCZ1 = 1.2813 $Shape factor Cpt for pneumatic trail QDZ1 = 0.063288 $Peak trail Dpt = Dpt*(Fz/Fznom*R0) QDZ2 = -0.015642 $Variation of peak Dpt with load QDZ3 = -0.060347 $Variation of peak Dpt with camber QDZ4 = -0.45022 $Variation of peak Dpt with camber squared QDZ6 = 0 $Peak residual torque Dmr = Dmr/(Fz*R0)
57
QDZ7 = 0 factor Dmr with load QDZ8 = -0.08525 factor Dmr with camber QDZ9 = -0.081035 factor Dmr with camber and load QDZ10 = 0.030766 factor Dmr with camber squared QDZ11 = 0.074309 camber squared and load QEZ1 = -3.261 at Fznom QEZ2 = 0.63036 Ept with load QEZ3 = 0 Ept with load squared QEZ4 = 0 Ept with sign of Alpha-t QEZ5 = 0 camber and sign Alpha-t QHZ1 = 0 Sht at Fznom QHZ2 = 0 Sht with load QHZ3 = 0 Sht with camber QHZ4 = 0 Sht with camber and load SSZ1 = 0 effect of Fx on Mz SSZ2 = 0.0033657 s/R0 with Fy/Fznom SSZ3 = 0.16833 s/R0 with camber SSZ4 = 0.017856 s/R0 with load and camber QTZ1 = 0 constant MBELT = 0 -kg- $
$Variation of peak $Variation of peak $Variation of peak $Variation of peak $Variation of Dmr with $Trail curvature Ept $Variation of curvature $Variation of curvature $Variation of curvature $Variation of Ept with $Trail horizontal shift $Variation of shift $Variation of shift $Variation of shift $Nominal value of s/R0: $Variation of distance $Variation of distance $Variation of distance $Gyroscopic torque $Belt mass of the wheel
58 Adams/Tire
521-Tire Model
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
Any combination of force and contact method is allowed. The road data files used for the 521-Tire are unique and cannot be used in combination with any other Handling tire model. The 521 road file format is described in Road Data File 521_pnt_follow.rdf. Note that the capability and generality of the 521-Tire have been superseded by other, newer tire models, described throughout this guide. Weve retained the 521-Tire model primarily for backward compatibility. We recommend that you use other tire models for new work.
12 Adams/Tire
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 = -------Vx
and
V sy tan = -------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. Lagged longitudinal and lateral slip quantities (transient tire behavior) In general, the tire rotational speed and lateral slip will change continuously because of the changing interaction forces in between the tire and the road. Often the tire dynamic response will have an important role on the overall vehicle response. For modeling this so-called 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 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
13
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 v 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:
du 1 -------- + V x u 1 = V sx dt
Now the practical slip quantities, and are defined based on the tire deformation:
14 Adams/Tire
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
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
15
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 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. The following is an example of using the spline vertical stiffness: ! adams_view_name='spline_vertical_stiffness' SPLINE/10 , X = -1,0,10,30 , Y = 0,0,2000,6000 !
16 Adams/Tire
! 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. Schematic of Friction Coefficient Versus Local Slip Velocity
17
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. Rolling Resistance Force Rolling resistance Moment My is calculated from:
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 twodimensional forces that lie in the plane of the tire and are directed toward the wheel-center marker. Adams/Tire superimposes these forces upon any traction or lateral forces developed in the tire-road surface interaction.
18 Adams/Tire
You must select the Equivalent Plane Method for generating these durability forces. Lateral Force and Aligning Torque Two methods exist for calculating the lateral force Fy and self-aligning moment Mz:
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:
K 1 t = -- a e 3
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:
Fy M x = ------ F z Ky
19
stat F z K a .
Longitudinal force Fx and lateral force Fy calculated using the equations of 521-Tire The vertical shift of Fy,a=0 is Fy calculated at zero slip angle
Output:
Adjusted longitudinal force Fx and lateral force Fy incorporates the reduction due to combined
slip:
Friction coefficients:
Fx x, act = ----Fz
F y F y, = 0 y, act = ----------------------------Fz
20 Adams/Tire
1 tan x = --------------------------------------------------- y = -------------------------------------------------2 2 2 2 tan tan 1 1 ------------- + ---------- --------- + ------------- x, act stat stat y, act
Forces corrected for combined slip conditions:
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
21
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. USE_MODE: 1 2 3 4 off off on on Smoothing: Combined slip correction: off on off on
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:
22 Adams/Tire
Substituting these relationships into the original slip ratio equation with some cancelling of variables gives:
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. About the Point-Follower Method The point-follower contact method assumes a single contact point between the tire and road. The contact point is the point nearest to the wheel center that lies on the line formed by the intersection of the tire (wheel) plane with the local road plane. The contact force computed by the point-follower contact method is normal to the road plane. Therefore, in a simulation of a tire hitting a pothole, the point-follower contact method does not generate the expected longitudinal force. About the Equivalent Plane Method 521-Tire uses the Equivalent Plane method to reorient the vertical road surface vector, which gives the direction of the vertical force, and to calculate the new tire radius. To do this, a new smooth road surface is generated at an angle calculated such that only the shape of the tire is different (see body 6 on page 18). Equivalent Plane Method
23
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
24 Adams/Tire
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.
25
Tire Property File 521_equation.tir and 521_interpol.tir You can select the method for calculating the normal force by setting the VERTICAL_FORCE_METHOD parameter to either POINT_FOLLOWER (for the Point Follower method) or EQUIVALENT_PLANE (for the Equivalent Plane method). See Contact Methods on page 17 for details on these methods. You can select the method for calculating the lateral force by setting the LATERAL_FORCE_METHOD parameter to either INTERPOLATION or symbol. See Lateral Force and Aligning Torque on page 11 for details on these calculation methods. The following table specifies how some of the parameter names used in the tire property file correspond to parameters introduced in the equations that were presented in the previous sections. Parameter in file: vertical_stiffness vertical_damping lateral_stiffness cornering_stiffness_coefficient Mu_Static Mu_Dynamic Mu_Static_velocity Mu_Dynamic_Velocity rolling_resistance_coefficient vertical_stiffness_exponent Used in equation: [10] [11] [18] [6] Figure 4 Figure 4 Figure 4 Figure 4 [13] [141] Kz Cz Ky K static dynamic velocity static velocity dynamic coeffrr Note: If you do not specify vertical_stiffness_ exponent in the tire property file, 521-Tire uses the default value of 1.1. As parameter:
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
26 Adams/Tire
[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 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.
27
$--------------------------------------------------------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 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
28 Adams/Tire
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 ! !-----------------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 5.31 0.11 0.47 0.04 0.80 1.75 2.54 -1.28 1.59 6.52 2.84 -12.44 -21.38 -3.70 17.43 11.08 0.02 -3.77 22.88 5.49 -37.99 -69.04 -27.94 52.20 40.53 14.82 -17.17 26.41 -3.92 -67.22 -111.44 -44.25 81.97 73.54 2.93 6.60 30.58 -14.04 -116.07 -168.11 -53.74 145.78 95.55 10.35 -11.91
22.93 11.45 15.74 13.72 -1.65 -15.64 -26.98 -57.25 -107.71 -62.62 -109.03 -161.88
29
0.46 4.71 4.26 2.41 -0.92 0.43 6.70 -2.20 -1.39 2.87 6.99 7.10 1.63 -0.78 5.62 2.31 7.87 1.40 2.10 5.60 3.56 -0.08 1.38
-2.48 26.10 16.60 4.28 0.22 -4.62 15.92 -5.53 -17.28 -0.38 24.54 18.78 2.91 10.13 4.36 6.41 1.33 -10.04 0.56 26.48 20.63 1.81 -2.13
-19.48 60.80 52.46 2.21 12.61 15.36 0.14 -13.28 -52.17 -14.27 66.06 58.20 8.33 -9.94 23.16 14.10 -16.31 -50.94 -16.15 62.92 60.74 14.39 -2.42
-33.54 90.85 93.32 9.11 2.51 7.16 -4.20 -47.48 -102.80 -29.03 93.27 104.51 20.32 -13.02 38.03 6.03 -40.24 -93.06 -27.15 90.16 108.26 34.98 -4.08
-49.52 119.51 141.34 30.44 -18.77 11.70 -11.81 -92.88 -161.71 -42.42 126.38 156.39 42.09 -11.95 8.73 -11.66 -82.58 -157.50 -40.13 122.03 162.97 59.72 -2.72
3.69 1.71 29.06 10.05 11.38 3.09 7.15 -7.92 13.53 -5.78 6.08 0.38 -2.69 -32.10 -62.17 0.76 -7.65 -37.28 -89.05 -145.09 0.70 4.37 -7.59 -23.71 -28.49 5.92 34.39 72.55 92.88 129.34 4.36 29.81 76.70 118.91 180.59 -2.03 5.94 26.18 53.59 89.76 0.39 -5.52 -6.06 10.16 7.81 !-----------------LATERAL FORCE VALUES-------------------------------------! No. of pnt Conversion ! factor ! pnt1 .... pnt225 ! LATERAL_FORCE_DATA_LIST 225 4.448 234.08 269.79 213.70 150.79 11.52 -116.75 -224.15 -242.08 -213.99 585.56 628.82 565.29 452.18 50.58 -367.42 -588.24 -612.70 -597.29 1000.29 1040.78 974.49 752.21 199.87 -618.68 -1001.01 -1059.55 -988.14 1307.77 1331.72 1198.82 885.23 199.50 -683.16 -1235.88 -1344.53 -1343.86 1603.78 1624.83 1387.74 960.13 208.75 -857.81 -1488.88 -1658.66 -1689.35
30 Adams/Tire
234.40 239.27 252.34 167.55 32.23 -122.59 -208.93 -261.05 -241.50 210.20 237.91 226.60 154.74 34.37 -130.29 -226.48 -270.70 -254.64 238.28 227.13 221.76 195.50 28.51 -145.10 -230.33 -230.62 -218.36 228.49 221.19 224.63 178.96 42.58 -144.43 -224.99 -246.51 -239.34
572.75 647.77 603.75 481.45 78.77 -423.13 -576.28 -634.90 -607.16 578.56 600.60 629.48 496.21 74.19 -339.00 -557.52 -595.22 -602.76 531.25 594.51 633.49 505.90 68.59 -319.56 -548.99 -597.10 -570.13 564.69 595.52 590.58 474.70 65.26 -290.91 -494.65 -563.13 -567.10
981.30 1007.37 1033.50 826.41 231.31 -552.58 -948.45 -1064.15 -1021.87 968.72 1025.67 1084.97 878.72 240.00 -509.04 -884.91 -1059.76 -1032.71 945.70 1038.87 1135.31 899.88 241.99 -464.11 -815.88 -1009.76 -1049.72 954.06 1019.74 1108.01 918.87 230.69 -368.02 -761.78 -980.33 -1050.56
1352.37 1357.22 1288.76 962.64 250.14 -613.52 -1149.44 -1338.52 -1322.30 1344.05 1377.57 1354.12 1028.03 284.42 -543.75 -1083.18 -1314.74 -1313.22 1305.28 1365.33 1375.28 1059.92 311.15 -499.27 -991.78 -1261.43 -1344.94 1332.84 1378.35 1408.87 1125.97 306.58 -398.98 -886.03 -1249.57 -1348.66
1698.90 1666.30 1483.64 1028.74 254.32 -607.61 -1314.69 -1581.84 -1598.25 1730.40 1733.03 1575.22 1095.59 283.85 -555.05 -1175.12 -1564.43 -1609.96 1786.96 1733.29 1619.82 1135.28 331.84 -500.83 -1108.36 -1504.09 -1589.60 1687.50 1749.40 1707.09 1242.75 428.45 -394.66 -941.20 -1462.88 -1611.11
521-Tire Road Data Files The road data files used with the 521-Tire are unique and cannot be used with any other tire model. The data files are fully described by the following two examples. Road Data File 521_pnt_follow.rdf This example file shows that, if you use the Point Follower method and indicate it in the associated tire property file, the road_profile_type parameter must be set to FLAT. $--------------------------------------------------------MDI_HEADER [MDI_HEADER] FILE_TYPE = 'rdf' FILE_VERSION = 5.00
31
FILE_FORMAT = 'ASCII' (COMMENTS) {comment_string} 'flat 2d contact road for testing purposes' $-------------------------------------------------------------UNITS [UNITS] LENGTH = 'mm' FORCE = 'newton' ANGLE = 'radians' MASS = 'kg' TIME = 'sec' $-------------------------------------------------------------MODEL [MODEL] METHOD = '5.2.1' FUNCTION_NAME = 'ARC913' $--------------------------------------------------------PARAMETERS ROAD_PROFILE_TYPE = FLAT INITIAL_HEIGHT = 0.000 Road Data File 521_equiv_plane.rdf The following example shows which data the road data file must contain if the Equivalent Plane method is used and specified in the associated tire property file. The main difference with the road data file used in association with the Point Follower method is that here the ROAD_PROFILE_TYPE parameter is set to INPUT and a ROAD_INPUT_DATA_LIST is specified. $---------------------------------------------------------MDI_HEADER [MDI_HEADER] FILE_TYPE = 'rdf' FILE_VERSION = 5.00 FILE_FORMAT = 'ASCII' (COMMENTS) {comment_string} '5.2.1 input road for testing purposes' $--------------------------------------------------------------UNITS [UNITS] LENGTH = 'mm' FORCE = 'newton' ANGLE = 'radians' MASS = 'kg' TIME = 'sec' $--------------------------------------------------------------MODEL [MODEL] METHOD = '5.2.1' FUNCTION_NAME = 'ARC913' $---------------------------------------------------------PARAMETERS ROAD_PROFILE_TYPE = INPUT INITIAL_HEIGHT = 0.000 ROAD_INPUT_DATA_LIST 23, 1 -10000.00, 00.00 1740.00, 00.00 1740.94, 1.92 1743.73, 3.55
32 Adams/Tire
1748.31, 1754.55, 1762.32, 1771.41, 1781.61, 1792.65, 1804.28, 1816.20, 1828.12, 1839.75, 1850.79, 1860.99, 1870.08, 1877.85, 1884.09, 1888.67, 1891.46, 1892.40, 40000.00,
4.59 4.79 3.88 1.65 7.89 2.47 5.26 6.20 5.26 2.47 7.89 1.65 3.88 4.79 4.59 3.55 1.92 00.00 00.00
can be found in About Tire Kinematic and Force Outputs. The tire deflection and deflection velocity are determined using either a point follower or durability contact
slip and camber angle model. For more information, see Road Models in Adams/Tire. A description of outputs, longitudinal force Fx, lateral force Fy, normal force Fz, rolling resistance moment My and self aligning moment Mz is given in About Tire Kinematic and Force Outputs. The required tire model parameters are described in Tire Model Parameters. Inputs and Output of the UA-Tire Model
12 Adams/Tire
Definition of Tire Slip Quantities Slip Quantities at Combined Cornering and Braking/Traction
13
The longitudinal slip velocity Vsx in the SAE-axis system is defined using the longitudinal speed Vx, the wheel rotational velocity
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 velocities in the contact point:
V sx = -------Vx
When the UA Tire is used for the force calculation the slip quantities during positive Vsx (driving) are defined as:
V sx = -------Vr Vr = Re
The rolling speed Vr is determined using the effective rolling radius Re:
Lagged longitudinal and lateral slip quantities (transient tire behavior) In general, the tire rotational speed and lateral slip will change continuously because of the changing interaction forces in between the tire and the road. Often the tire dynamic response will have an important role on the overall vehicle response. For modeling this so-called transient tire behavior, a firstorder 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 also reference [1]). The figure below shows a top-view of the string model. Stretched String Model for Transient Tire Behavior
14 Adams/Tire
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:
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. A similar approach yields the following for the deflection of the string in longitudinal direction:
15
Symbol: r1 kz cz Cr Cs
Units*: L
Description: Tire unloaded radius Vertical stiffness Vertical damping Rolling resistance parameter Longitudinal slip stiffness, Cornering stiffness,
VERTICAL_STI F/L FFNESS VERTICAL_DA MPING ROLLING_RES ISTANCE CSLIP CALPHA CGAMMA UMIN FT/L L F F/A F/A -
C C UMIN
F y F y =0 Camber stiffness, = 0
F x
=0
16 Adams/Tire
Symbol: UMAX
Units*:
Description: Maximum friction coefficient (Ssg=0) Relaxation length in longitudinal direction Relaxation length in lateral direction
x y
REL_LEN_LON L L
Normal Force The normal force F z is calculated assuming a linear spring (stiffness: k z ) and damper (damping constant c z ), 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 F z 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: Longitudinal Slip Ratio: Ss The absolute value of longitudinal slip ratio, Ss, is defined as:
Ss =
Where is limited to be within the range -1 to 1.
17
Lateral Slip Ratios: S , S , S The lateral slip ratio due to slip angle,
S , is defined as:
* S =
* S = min ( 1.0, S )
S = sin
A combined lateral slip ratio due to slip and inclination angles, S , is defined as:
* S
during braking
where
l =
S = min ( 1.0, S * )
Comprehensive Slip Ratio: Ss A comprehensive slip ratio due to longitudinal slip, slip angle, and inclination angle may be defined as:
S * s =
2 S s + S 2
S = min ( 1.0, S * )
18 Adams/Tire
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
This can be analytically described as: = UMAX - (UMAX - UMIN) * Ss 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.
19
or
where:
20 Adams/Tire
The lateral force Fh can be decomposed into two components: Fha and Fhg. The two components are in the same direction if a g < 0 and in opposite direction if 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:
< 0.
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 - 2 S c = ------ S sc S s 3C -----C 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:
2 B2 + B2 B1 B3 -----------------------------------------Sn = B1
where:
21
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
A modified lateral friction coefficient
( ym ) is evaluated as:
C S ( ym ) = y ----------- Fz
where
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. (i) Elastic Deformation State:
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:
22 Adams/Tire
2 2 3 F = C s S s l n + x F z ( 1 3l n + 2l n ) 2 ( 2 3 F = C S s l n + ym ) F z ( 1 3l n + 2l n ) + C S
= S r l2 l' 2 4 is the offset between the wheel plane center and the tire tread base. r l2 l 2 4 is set to zero if it is negative. l = 8r l the length of the contact patch.
Mz is the portion of the self-aligning torque generated by the slip angle . Mzs and Mzs are other components of the self-aligning torque produced by the longitudinal force, which has an offset between
and the inclination angle , respectively. The self-aligning torque Mz is determined as combinations of Mz , Mzs and Mzs .
the wheel center plane and the tire tread base, due to the slip angle (ii) Complete Sliding State: S
S c, Ss
Ssc, and S
S c
In the complete sliding state, the longitudinal force, the lateral force, and three components of the selfaligning torque are determined as functions of the normal force and the friction coefficients without any elastic stiffness and slip ratio as:
23
F = x Fz F = y Fz M z = 0
2 3 x y F z 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 c = 3 ----C
A slip ratio due to the critical value of the slip angle can be found as:
Cs S 2 - 2 S c = ------ S sc S s + 3C -----C C
when Ss
Ssc.
where:
24 Adams/Tire
B 1 = ( 3F z ) 2 ( 3C S ) 2 B 2 = 2C 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 angle. (i) Elastic Deformation State: Ss In the elastic deformation state:
2 2 3 F = C s S s l n + x F z ( 1 3l n + 2l n ) 2 ( 2 3 F = C S s l n + ym ) F z ( 1 3l n + 2l n ) + C S
<
Ssc and S
Ssc and S
25
F = x Fz F = y Fz M z = 0
2 3 x y F z 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 S sc = ----- ( 3F z ) 2 ( C S 3C S ) Cs
The nondimensional slip ratio Sn, is expressed as:
2 B2 + B2 B1 B3 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 ]
26 Adams/Tire
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 the slip angle. (i) Elastic Deformation State: S
< <
<
S c and Ss
Ssc
S c and Ss
Ssc
In the complete sliding state, F , F , Mz , Mzs , and Mzs can be determined by using:
F = x Fz F = y Fz M z = 0
2 3 x y F z l M zs = ----------------------5C
M zs = F
27
respectively. The longitudinal force F , the lateral force F , and three components of the self-aligning torques, Mz , Mzs , and Mzs , always have positive values, but they can be transformed to have positive or negative values depending on the slip ratio s, the slip angle the SAE coordinate system. Tire Forces and Moments in the SAE Coordinate System For the general formulations of the longitudinal force Fx, lateral force Fy, and self-aligning torque Mz, in the SAE coordinate system, the three possible combinations of the slip ratio, the slip angle, and the inclination angle are also considered. Longitudinal Force: Fx = sin() F , for all cases Lateral Force: Fy = -sin( ) F , for cases 1 and 2 Fy = sin( ) F , for case 3 Self-aligning Torque: Mz = sin( ) Mz - sin( ) [-sin( ) Mzs + sin( )Mzs ] Rolling Resistance Moment: My = -Cr Fz, for a forward rolling tire. My = Cr Fz, for a backward rolling tire.
excitation frequencies.
USE_MODE = 2: Smoothing of forces and moments on startup of the simulation
28 Adams/Tire
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 Aligning Torque Mz = S*Mz
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 property format example (see SHAPE).
29
MASS = 'kg' TIME = 'sec' $-------------------------------------------------------------model [MODEL] ! use mode 1 2 3 ! -----------------------------------------! relaxation lengths X ! smoothing X ! PROPERTY_FILE_FORMAT = 'UATIRE' USE_MODE = 2 $-------------------------------------------------------dimension [DIMENSION] UNLOADED_RADIUS = 0.295 WIDTH = 0.195 ASPECT_RATIO = 0.55 $---------------------------------------------------------parameter [PARAMETER] VERTICAL_STIFFNESS = 190000 VERTICAL_DAMPING = 50 ROLLING_RESISTANCE = 0.003 CSLIP = 80000 CALPHA = 60000 CGAMMA = 3000 UMIN = 0.8 UMAX = 1.1 REL_LEN_LON = 0.6 REL_LEN_LAT = 0.5 $-------------------------------------------------------------shape [SHAPE] {radial width} 1.0 0.0 1.0 0.2 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
30 Adams/Tire
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
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.
12 Adams/Tire
level.
High accuracy when passing single obstacles, such as cleats and potholes. Applicable in extreme situations like many kinds of tire misuse and sudden pressure loss. Sufficiently accurate in predicting steady-state tire characteristics.
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
13
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. Belt In-Plane (left) and Out-Of-Plane (right) Bending Stiffness
FTire calculates all stiffnesses, bending stiffnesses, and damping factors during preprocessing,
14 Adams/Tire
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 largeand/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
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. Belt Torsional and Twisting Stiffness, and Belt Lateral Bending Stiffness
15
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 runout. 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.
16 Adams/Tire
Controlling Integrator Step Size in Adams/Car In Adams/Car, you can control the integrator step size by selecting: Settings Solver Dynamics and entering 1ms in the Hmax text box. Alternatively, you can edit the driver control file (.dcf) that Adams/Car automatically generates when performing a new dynamic maneuver. In that file, override the integrator step size, which is defined in [EXPERIMENT] block, by entering the value 0.001 or less. After editing the file, you can launch subsequent simulation experiments with the same driver's control (and, of course, the new integrator step size) by selecting the following from Adams/Car: Simulate Full-Vehicle Analysis DCF Driven Driver Control Files Browse and selecting the .dcf you just edited. Controlling Integrator Step Size in Adams/Chassis In Adams/Chassis, you can control the integrator step size by setting the HMAX value to 0.001 or less. HMAX is defined by selecting the following from Adams/Chassis: System file Properties system_parameters solver hmax Controlling Integrator Step Size in Adams/View In Adams/View, you can control the integrator step size by checking: Settings Solver Dynamics Customized Settings size, Min Step Size, and Max Step Size. Controlling Integrator Step Size in Adams/Solver In Adams/Solver, you can control the integrator step size by setting INTEGRATOR/HMAX to the desired value in the Adams dataset (adm).
17
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 overdetermined, 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.
18 Adams/Tire
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-ofplane 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.
19
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
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.
20 Adams/Tire
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.
The circumference is the distance traveled with one complete wheel revolution. tire_mass inflation_pressure inflation_pressure_2 stat_wheel_load_at_10mm_defl Overall tire mass. Inflation pressure, at which tire data measurements have been taken. Second inflation pressure, at which tire data measurements have been taken (optional). Static wheel load of the inflated tire, when it is deflected by 10 mm, with zero camber angle, on a flat surface, during stand-still, at very low friction value.
21
Means: Static wheel load of the inflated tire, when it is deflected by 20 mm, with zero camber angle, on a flat surface, during stand-still, at very low friction value. Note: Instead of using: 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.
Increase of the overall radial stiffness at high speed as compared to radial stiffness during standstill. Unit is %. Running speed at which dynamic stiffening reaches half of the final value. 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 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 models 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.
22 Adams/Tire
The parameter: f1
Means: First natural frequency: in-plane, rigid-body rotation around wheel spin axis. Rim is fixed. See the figure, First Six Vibration Modes. Second natural frequency: rigid-body movement in fore-aft direction. Rim is fixed. See the figure, First Six Vibration Modes. Fourth natural frequency: out-of-plane, rigid-body rotation around road normal axis. Rim is fixed. See the figure, First Six Vibration Modes. Note: f3 (out-of-plane, rigid-body movement) is not needed because it is closely related to f4.
f2 f4
At least one of: f5 belt_in_plane_bend_stiffn wheel_load_at_10_mm_defl_clea t Fifth natural frequency: first in-plane bending mode (quadrilateral-shaped). Rim is fixed. In-plane bending stiffness of the belt ring of deflated and unloaded tire. Static wheel load of the inflated tire, when it is deflected by 10 mm, with zero camber angle, on a cleat as specified below, during stand-still. Cleat must be high enough that the tire does not touch the ground apart from the cleat. The cleat is oriented in the lateral direction, perpendicular to the tires rolling direction. Note: weight_f5 weight_in_plane_bend_stiffn weight_wheel_load_cleat For truck tires, you can specify wheel_load_at_20_mm_defl_ cleat, as well.
If you provide at least two of the data on the previous page to define the in-plane bending stiffness, they constitute an overdetermined system of equations for the respective FTire's internal stiffness values. FTire will try to find a compromise. You can control this compromise by setting these weight values. Their relative size controls, in a least-squares approach, the contribution of the respective parameter. If a weight is set to zero, the related parameter is completely ignored. Note: The weights are optional. Default value is 1.
cleat_width
Width of cleat that was used to determine all parameters that require a cleat: wheel_load_at_10_mm_defl_ cleat wheel_load_at_10_mm_defl_ cl_lo and so on. Note: Parameter is optional. Default value is 20 mm.
23
Means: Bevel edge width (measured after projection to x-y-plane) of cleat that was used to determine all parameters that require a cleat: wheel_load_at_10_mm_defl_ cleat wheel_load_at_10_mm_defl_ cl_lo and so on. Note: Parameter is optional. Default value is 0 mm.
At least one of: f6 belt_out_of_plane_bend_stiffn weight_f6 weight_out_of_plane_bend_st Sixth natural frequency: first out-of-plane bending mode (bananashaped). Out-of-plane bending stiffness of the belt ring of inflated but unloaded tire. If you provide both data above (f6 and belt_out_of_plane_bend_stiff) to define the out-of-plane bending stiffness, they constitute an over-determined system of equations for the respective FTire's internal stiffness values. FTire will try to find a compromise. You can control the compromise by setting these weight values. Their relative size controls, in a least-squares approach, the contribution of the respective parameter. If a weight is set to zero, the related parameter is completely ignored. Note: D1 The weights are optional. Default value is 1.
D2 D4
Damping of f2. Damping of f4. Note: D5 and D6 cannot be prescribed, but result from D1, D2, and D4.
belt_twist_stiffn
Belt-twisting stiffness: if the mean torsion angle relative to the rim is 0, the value is the moment in longitudinal direction per 1 degree twist angle for a unit length belt segment. This value is independent on the number of belt segments. Note: Only needed for full 3D variant. Unit is force*length2/angle.
24 Adams/Tire
Means: Belt-torsional stiffness: if twist angle is 0, the value is the moment in longitudinal direction per 1 degree torsion angle relative to rim, for a unit-length belt segment. This value is independent on the number of belt segments. Note: Only needed for full 3D variant.Unit is force/angle.
belt_torsion_lat_displ_coupl
If belt twist angle is 0, value is the kinematic belt torsion angle at 1 mm lateral belt displacement. Note: Optional, and only needed for full 3D variant. Unit is angle/length. Default value is 0.
belt_lat_curvature_radius
Curvature radius of belt cross section perpendicular to mid-plane. Note: Optional, and only needed for full 3D variant. Default value is (nearly) infinity.
belt_lat_bend_stiffn
Bending stiffness of belt elements about circumferential direction. Note: Optional, and only needed for full 3D variant. Unit is force*length2. Default value is (nearly) infinity.
wheel_load_at_10_mm_defl_lo_c Wheel load at 10 mm deflection on longitudinal cleat. Static l wheel load of the inflated tire, when it is deflected by 10 mm, with zero camber angle, on a cleat as specified above, during standstill. Cleat must be high enough that the tire does not touch the ground apart from the cleat. The cleat is oriented in longitudinal direction, along foot-print centerline. Note: This parameter is optional and you can specify it instead of, or in addition to, belt_lat_bend_stiffn. For truck tires, if you specify wheel_load_at_40_mm, FTire looks for wheel_load_at_20_mm_defl_ lo_cl instead.
weight_lat_bend_st weight_wheel_load_lo_cl
If you provide both data on the previous page (belt_lat_bend_stiffn and wheel_load_at_10_mm_defl_lo_cl) to define the lateral belt bending stiffness, they constitute an overdetermined system of equations for the respective FTire's internal stiffness values. FTire will try to find a compromise. You can control the compromise by setting these weight values. Their relative size controls, in a least-squares approach, the contribution of the related parameter. If a weight is set to zero, the respective parameter is completely ignored. Note: The weights are optional. Default value is 1.
belt_lat_bend_damp
Quotient of bending damping and bending stiffness of belt elements about circumferential direction. Note: Optional, and only needed for full 3D variant. Unit is time. Default value is 1 ms.
25
The parameter:
Means:
If measurements for a second inflation pressure f1_p2 (inflation_pressure_2) are available, these are the respective f2_p2 values of the following taken at that pressure: f4_p2 f5_p2 f1 f6_p2 f2 D1_p2 D2_p2 f4 D4_p2 f5 belt_in_plane_bend_st_p2 f6 wheel_load_at_10_mm_defl_cl_p 2 D1 wheel_load_at_20_mm_defl_cl_p D2 2 D4 belt_out_of_plane_bend_st_p2 belt_lat_bend_stiffn_p2 belt_in_plane_bend_stiffn belt_twist_st_p2 wheel_load_at_10_mm_defl_cleat belt_torsion_st_p2 wheel_load_at_20_mm_defl_cleat
belt_out_of_plane_bend_stiffn belt_lat_bend_stiffn belt_twist_stiffn belt_torsion_stiffn
Mean groove depth in tread. Rubber height over steel belt for zero tread depth, which is the distance between steel belt and grooves. Stiffness of tread rubber in Shore-A units. Percentage of gross tread contact area with respect to overall footprint area (tread pattern positive). Quotient of tread rubber damping modulus and tread rubber elasticity modulus. Note: Deflection/force phase-lag of elastomers is often assumed to be independent of excitation frequency. This behavior is not yet implemented in FTire; instead, viscous damping is used. The parameter damping_tread_rubber is nothing but the quotient of damper coefficient and spring stiffness of the coupling of blocks and belt. For that reason, the parameter carries the unit time.
26 Adams/Tire
Means: The sliding velocity of a tread rubber block, when its friction coefficient reaches the my_sliding values. The sliding velocity of a tread rubber block, when its friction coefficient reaches the my_blocking values. The first of three ground-pressure values that defines the pressure dependency of the friction coefficient. Default value is 0.1 bar. The second of three ground-pressure values that defines the pressure dependency of the friction coefficient. Default value is 2 bar. The third of three ground-pressure values that defines the pressure dependency of the friction coefficient. Default value is 10 bar. Coefficient of adhesion friction (which is equal to static friction) between tread rubber and road, at first ground pressure value. Note: For this parameter and the parameters in the following eight rows, you can still use the parameter names my_..._at_..._bar, used in the previous FTire version. To avoid confusion with the actual ground pressure values, however, we recommend you use the more general names.
high_ground_pressure my_adhesion_at_low_p
my_sliding_at_low_p
Coefficient of sliding friction, at a sliding velocity defined by parameter sliding_velocity, between tread rubber and road, at first ground pressure value. Coefficient of sliding friction, at a sliding velocity defined by parameter blocking_velocity, between tread rubber and road, at first ground pressure value. Coefficient of adhesion friction (which is equal to static friction) between tread rubber and road, at second ground pressure value. Coefficient of sliding friction, at a sliding velocity defined by parameter sliding_velocity, between tread rubber and road, at second ground pressure value. Weight that would have put up on the rim horn for static balancing. Note: Parameter is optional.
my_blocking_at_low_p
my_adhesion_at_med_p my_sliding_at_med_p
static_balance_weight
static_balance_ang_position
The angular position at the rim where the static balance weight would have been placed. Note: Parameter is optional.
27
Means: One of the two equal weights that would have been placed on the rim outer and inner horns for dynamic balancing. Note: Parameter is optional.
dynamic_balance_ang_position
The angular position at the rim where the left dynamic balance weight would have been placed. Note: This parameter is optional.
radial_non_uniformity
Amplitude of the harmonic radial stiffness variation as percentage of the mean radial stiffness. Note: Parameter is optional.
radial_non_unif_ang_position
Angular position where radial stiffness reaches its maximum. Note: This parameter is optional.
tang_non_uniformity
Amplitude of the harmonic tangential stiffness variation as percentage of the mean tangential stiffness. Note: Parameter is optional.
tang_non_unif_ang_position
Angular position where tangential stiffness reaches its maximum. Note: Parameter is optional.
conicity
Small rotation angle of belt elements at zero moment, about circumferential axis, resulting in a conical shape of the unloaded belt. Note: Parameter is optional and can only be used with the full 3D variant. Nonzero conicity will cause a small sideforce without side-slip angle. The sign of that force is independent of the tires rolling direction.
ply_steer_percentage
Percentage of lateral belt displacement relative to radial belt displacement, when a radial force is applied. Note: Ply-steer, besides conicity, is one of the reasons for nonzero side forces at zero side-slip angle. In contrast to the conicity side-force, this residual side force changes sign when the tire rolling direction is reversed.
run_out
The maximum deviation of the local tire radius from the mean tire radius. Run-out is assumed to be a harmonic function of the angular position. The angular belt element position relative to the rim, where maximum run-out occurs. Number of numerical belt segments. Maximum value is 200, but can be changed upon request.
run_out_ang_position number_belt_segments
28 Adams/Tire
Means: Number of numerical blocks (= contact elements) per belt segment. Maximum value is 50, but can be changed upon request. Number of strips, into which the contact points are arranged in the full 3D variant, using an equal spacing. Note: If value is greater than or equal to 1000, the contact points are scattered randomly over the tread. Alternatively, it is possible to place tread elements according to the actual tread pattern of the tire. This is done by specifying a bitmap file of the footprint. For more information, see the extended documentation at www.ftire.com. If you specify neither number_tread_strips nor the bitmap file, FTire uses the basic FTire variant instead of the full 3D variant, regardless of the model-level specification in the operating_conditions section.
maximum_time_step
Maximum integration time step allowed. Note: You can call FTire with very large time steps (if this makes sense for your model). Internally, FTire uses multi-step integration with an internal time step that is chosen on basis of maximum_time_step. This internal time step is kept constant if the external time step does not change. Changing the external time step can result in considerable longer computation time, because certain time-consuming preprocessing calculations have to be repeated. For that reason, you should avoid changing the external time step whenever possible.
BDF_parameter
Numerical parameter to control the internal FTire implicit (BDF) integration scheme, which is independent of the Adams integrator. 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.
29
The basic parameters are preprocessed during initialization, resulting in the preprocessed parameters. These parameters are saved in a separate TeimOrbit-style file, which can be used in further simulations instead of the basic data file. By this, you can omit the preprocessing calculation phase, which may result in a considerable saving of time. 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
30 Adams/Tire
1.0 0.9 0.9 1.0 $-------------------------------------------------------------UNITS [UNITS] FORCE = 'NEWTON' 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 $ [%]
31
$ f1 = f2 = f4 = $ D1 = D2 = D4 = $ belt_in_plane_bend_stiffn = 2.0e6 belt_out_of_plane_bend_stiffn = 200.0e6 belt_lat_bend_stiffn = 20.0e6 belt_twist_stiffn = 1.0e6 belt_torsion_stiffn = 100.0 $ rim_flange_contact_stiffness = 3000.0 rim_to_flat_tire_distance = 30.0 $ [N/mm] $ [mm] $ $tread properties ************************************************** tread_depth = 8.0 $ [mm] tread_base_height = 3.0 $ [mm] stiffness_tread_rubber = 64 $ [Shore A] tread_positive = 65 $ [%] damping_tread_rubber = 0.025 $ [ms] $ sliding_velocity = 0.1 $ [mm/ms] blocking_velocity = 50.0 $ [mm/ms] low_ground_pressure = 0.01 $ [bar] med_ground_pressure = 2.0 $ [bar] high_ground_pressure = 10.0 $ [bar] mu_adhesion_at_low_p = 1.3 $ [-] mu_sliding_at_low_p = 1.1 $ [-] mu_blocking_at_low_p = 0.8 $ [-] mu_adhesion_at_med_p = 1.3 $ [-] mu_sliding_at_med_p = 1.0 $ [-] mu_blocking_at_med_p = 0.8 $ [-] mu_adhesion_at_high_p = 1.3 $ [-] mu_sliding_at_high_p = 1.0 $ [-] mu_blocking_at_high_p = 0.8 $ [-] $ $tire imperfections ************************************************ static_balance_weight = 0.0 $ [g] static_balance_ang_position = 0.0 $ [deg] dynamic_balance_weight = 0.0 $ [g] dynamic_balance_ang_position = 0.0 $ [deg] radial_non_uniformity = 0.0 $ [%] radial_non_unif_ang_position = 0.0 $ [deg] tang_non_uniformity = 0.0 $ [%] tang_non_unif_ang_position = 0.0 $ [deg] ply_steer_percentage = 0.0 $ [%] conicity = 0.0 $ [deg] run_out = 0.0 $ [mm] run_out_angular_position = 0.0 $ [deg] $ $ $ $ $ [Nmm^2] [Nmm^2] [Nmm^2] [Nmm^2/deg] [N/deg] 0.05 0.08 0.05 $ in-plane rotat. [-] $ in-plane transl. [-] $ out-of-plane rotat. [-] 62.1 81.4 80.0 $ in-plane rotat. [Hz] $ in-plane transl. [Hz] $ out-of-plane rotat. [Hz]
32 Adams/Tire
$ $measuring conditions ********************************************** inflation_pressure = 2.0 $ [bar] rim_inertia = 0.25e9 $ [g*mm^2] $ $numerical data **************************************************** number_belt_segments = 80 $ number_blocks_per_belt_segm = 32 $ number_tread_strips = 8 $ maximum_time_step = 0.2 $ [ms] BDF_parameter = 0.505 $ 0.5 .. 1.0 [-]
possibly time-dependent inflation pressure, whereas the [FTIRE_DATA] value describes the inflation pressure at which the remainder of the data measurements had been taken.
Tread depth -The operating condition value of tread_depth defines the actual, possibly time-
dependent tread depth, whereas the [FTIRE_DATA] value describes the tread depth at which the remainder of the data measurements had been taken.
Model level - The operating condition value of model_level defines what variant of FTire is to
be used: the basic version (=6) or the full 3D version (=7). The list of possible variants will be extended in the next release. Also in the next FTire release, ambient temperature, will be added to the list of operating conditions. To determine the actual operating conditions, FTire looks for the section [OPERATING_CONDITIONS] in the basic or preprocessed tire data file. If it does not find this section, or it does not contain the respective definitions, FTire uses the data in the sections [FTIRE_DATA] or [FTIRE_PREPROCESSED_DATA] as the measurement conditions. In case the section [OPERATING_CONDITIONS] is defined, FTire first tries to read a constant value for each operating condition. This value may either be the same for all tires using the data file, or it can have individual values for each such tire instance. You can enter constant operating conditions as shown the table below.
33
OPERATING_CONDITIONS Section Parameters The parameter: inflation_pressure inflation_pressure_wheel_i Means: Actual inflation pressure, used for all FTire instances that are parameterized by this data file. Actual inflation pressure, used only for FTire instance with GFORCE ID i. This value overrides the inflation_pressure value (i is to be replaced by a numerical GFORCE ID value of the tire instance). Actual tread depth, used for all FTire instances that are parameterized by this data file. Actual tread depth, used only for FTire instance with GFORCE ID i. This value overrides the tread_depth value (i is to be replaced by the numerical GFORCE ID value of the tire instance). Actual model level, used for all FTire instances that are parameterized by this data file. In the current release, the following model levels are implemented:
6: FTire basic version (three degrees of freedom for each belt
tread_depth tread_depth_wheel_i
model_level
for each belt element, several lines of, or irregularly scattered, contact elements). model_level_wheel_i Actual model level, used for FTire instance with GFORCE ID i. This value will override the model_level value (i is to be replaced by the numerical GFORCE ID value of the tire instance).
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)
34 Adams/Tire
(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] 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.
12 Adams/Tire
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
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: install_dir/achassis/examples/rdf/
13
Road Models in Adams/Tire
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.
rotation_angle_xy_plane Rotation angle of the xy-plane about the road z-axis. In Adams/Car, vehicles start running along the negative x-axis by default. It also might be convenient to use positive x-values in the .rdf. In that case, choose rotation_angle_xy_plane = 180 (deg). mu Road friction correction factor (not the friction value itself), to be multiplied with the respective rubber friction values of the tire model. Default setting: mu = 1.0.
14 Adams/Tire
cleat_bevel_edge_length Length of bevel edge of cleat, measured in circumferential direction of drum. Bevel edge has 45 slope. acceleration_time Optional time span at the beginning of the simulation, during which the drum is accelerated to a nominal rolling speed.
bevel_edge_length Length of bevel edge, measured along x-axis. Bevel edge has 45 slope. When bevel_edge_length < 0, rounded corners instead of bevel edges are used. In this case, radius of the corner is |bevel_edge_length|. direction Direction of plank relative to y-axis. If the plank is placed crosswise, direction = 0. If the plank is along the x-axis, direction = 90.
15
Road Models in Adams/Tire
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 3000 -100 100 3001 50 0 4000 -100 100 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.
16 Adams/Tire
[PARAMETERS] Data for Road Type of Ramp The parameter: height start slope Indicates: Height of ramp. Start of ramp (travel distance). Slope of ramp. 1 means 45.
2 z ( s ) = a sin ----- ( s s s )
17
Road Models in Adams/Tire
random numbers is approximated by summing several equally distributed random numbers, taking advantage of the law of large numbers of mathematical statistics. Next, these values are integrated with respect to travel distance, using a simple first order time-discrete integration filter. The independent variable of that filter is not time, but travel path. That is why the filter cutoff frequency is controlled by a path constant instead of a time constant. The filter process results in two approximate realizations of white velocity noise; that is, two signals, the derivatives of which are close to white noise. Signals with that property are known as road profiles with waviness 2. Several investigations in the past showed that the waviness derived from measured road spectral densities ranges from about 1.8 to 2.2. 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
Can be any value between 0 and 1. start Start of unevenness (travel distance).
18 Adams/Tire
[PARAMETERS] Data for Road Type of Sine Sweep The parameter: start end amplitude_at_start amplitude_at_end Indicates: Start of swept sine wave (travel distance) ( s s ). End of swept sine wave (travel distance) ( s e ). Amplitude of swept sine wave at start travel distance ( a s ). Amplitude of swept sine wave at end travel distance ( a e ).
19
Road Models in Adams/Tire
The parameter:
Indicates:
wave_length_at_start Wave length of swept sine wave a start travel distance ( ). s wave_length_at_end Wave length of swept sine wave at end travel distance. Must be less than or equal to wave_length_at_start ( e ).
20 Adams/Tire
Indicates:
sweep_type = 0: frequency increases linearly with respect to travel sweep_type = 1: wave length decreases by a constant factor per cycle.
Depending on the value of sweep_type, the road height is given by the following functions, where:
1 f s = ---s
and
1f e = ---e
respect to travel distance. The road height value z(s) as function of travel distance s is alculated as follows:
s s ) in the
( 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:
fe s = ------------- ( s e s s ) fe fs s is the travel path where theoretically an infinitely high frequency was
reached, measured relative to sweep start s s . The actual frequency is given by:
s f ( s ) = ------------------------ f s s + ss s
21
Road Models in Adams/Tire
the road.
When using with Driving Machine, you may also use a road data file as you would a driver
control data (.dcd) file to specify the vehicle path. The Driving Machine will then drive the vehicle along the centerline of the road.
When using with Adams/SmartDriver, you can use the road data file to replace the driver road
data (.drd) file. In this case, the vehicle will use the x, y, and z road centerline to define the vehicle path.
22 Adams/Tire
Examples of event (.xml) file for use with Driving Machine and Adams/SmartDriver are shown next: For Driving Machine: <DcfMini name="3D_SMOOTH_ROAD" active="true" userDefined="false" smoothingTime="0.1" activeFlag="true" abortTime="1" stepSize="0.01" hMax="0" > <DcfDemand name="steering" active="true" userDefined="false" demandType="steering" actuatorType="rotation" controlMethod="machine" 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" > <DcfMachine name="machine" active="true" userDefined="false" steerControl="file" 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: DcfMini name="3D_SMOOTH_ROAD" active="true" userDefined="false" smoothingTime="0.1" activeFlag="true" abortTime="1" stepSize="0.01" hMax="0" > <DcfDemand name="steering" active="true" userDefined="false" demandType="steering" actuatorType="rotation" controlMethod="SmartDriver" controlMode="absolute"
23
Road Models in Adams/Tire
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" />
roads.
SINE - Sine wave with constant amplitude and wavelength. SWEEP - Sine wave with variable amplitude and wavelength.
Note that a specific contact method has to be selected, which defines how Adams/3D Spline Road interacts with the tires. Not all combinations of road, tire, and contact methods are permitted. For more information, see the topics under Tire Model in the Table of Contents. Be aware that Adams/3D Spline Road perturbations can generally have small wavelength content. Therefore, the combination of tire and contact methods should be able to handle this type of excitation. Any number of perturbations can be defined. If an overlap exists between the perturbations, then Adams/3D Spline Road superpositions the perturbations.
24 Adams/Tire
STOP
LENGTH
The length of the perturbation. LENGTH is used in defining the local coordinate system.
25
Road Models in Adams/Tire
Description: The width of the obstacle. The obstacle width can be specified independently of the road width. The friction coefficient of the obstacle. The perturbation type.
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: CROWN CURB PLANK POLYLINE POTHOLE RAMP ROOF ROUGHNESS SINE SWEEP X X X X X X X X Local: X X Distance:
26 Adams/Tire
The first column is a set of distance-values in ascending order. The second column contains the height of the crown. The third column contains the crown coefficient.
The road profile height z is a function of width-coordinates r , obstacle width w , height z 0 , and crown coefficient c r :
cr z ( ) = z 0 4 --- 2 w
Illustration of CROWN.
27
Road Models in Adams/Tire
respectively.
28 Adams/Tire
Keywords for Roughness Perturbation Type Keyword: GE GS GA SAMPLE_INTERVAL Elevation PSD parameter. Velocity PSD parameter. Acceleration PSD parameter. The distance between the road profile data points. Description:
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.
2 z ( s ) = a sin ----- s
29
Road Models in Adams/Tire
Keywords for Sweep Perturbation Type Keyword: AMPLITUDE_AT_START AMPLITUDE_AT_END Description: Amplitude of the sine wave at start (as a s ). Amplitude of the sine wave at end (ae a e ).
WAVE_LENGTH_AT_START Wave length of the sine wave at start (ls l ). s WAVE_LENGTH_AT_END SWEEP_TYPE Wave length of the sine wave at end (le l e ).
SWEEP_TYPE = 0, then frequency changes linearly. SWEEP_TYPE = 1, then frequency changes logarithmically.
Depending on the value of SWEEP_TYPE, the road profile height is given by the following functions:
Linear sweep - The frequency changes linearly with distance
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.
30 Adams/Tire
Model Details Global Parameters Data Points Information Sample Road Data File
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 The keywords: FILE_TYPE FILE_VERSION FILE_FORMAT {COMMENTS} 'User entered comments go here' Units Details The [UNITS] blocks defines the units for the road: [UNITS] LENGTH FORCE ANGLE MASS TIME = = = = = 'meter' 'newton' 'radians' 'kg' 'sec' The file type. Version of file; to be changed when modifications to this file are made. The format of the data; for TeimOrbit, this is always ASCII. Descriptive comments about the file, such as what road this represents, when the data was acquired, and so on. Contains:
[UNITS] Keywords The keywords: LENGTH FORCE Specifies: Unit of length. Unit of force.
31
Road Models in Adams/Tire
The [MODEL] block defines the road model and version: [MODEL] METHOD = '3D_SPLINE' VERSION = 1.00 [MODEL] Keywords The keyword: METHOD Determines: Road contact algorithm that Adams/Tire uses. You must set method='3D_SPLINE'to instruct Adams/Tire to use the Adams/3D Spline Road spline algorithm. Version of 3D_SPLINEalgorithm being used; currently, 1.00.
The [GLOBAL_PARAMETERS]block defines parameters applying to the entire road. [GLOBAL_PARAMETERS] CLOSED_ROAD SEARCH_ALGORITHM ROAD_VERTICAL FORWARD_DIR MU_LEFT MU_RIGHT WIDTH BANK = = = = = = = = 'NO' 'FAST' '0.0 0.0 1.0' 'NORMAL' 0.5 0.6 5.000 0.0
32 Adams/Tire
[GLOBAL_PARAMETERS) Keywords The keyword: CLOSED_ROAD Specifies: Whether the road is closed or open. If the road is not structured to be closed (the beginning and end of the road are not facing each other) and you select the closed option, Adams/Tire creates a deformed road.
'YES' - The road is closed. 'NO'- The road is open.
SEARCH_ALGORITHM
The type of algorithm to be used to determine the contact location. For smooth roads, we recommend Fast algorithm.
'FAST' - Specifies Fast algorithm.With Fast algorithm, caching is 6
1 10
caching is used and the greatest accuracy is achieved. ROAD_VERTICAL Vector specifying the z-axis of the user-coordinate system with respect to ISO-coordinate system. This option allows you to specify the road data points in your preferred reference frame. During simulation, Adams/Tire converts all the data points to the ISO-reference frame based on the ROAD_VERTICALvalues: '0.0 0.0 1.0' - The z-axis of user-reference frame with respect to ISO reference frame. FORWARD_DIR Forward direction of the road:
'NORMAL' - Vehicle travels along the specification of road data
point.
'INVERT' - Vehicle travels in a direction opposite to that of
specified road data points. MU_LEFT Road friction value on the left side of the road with respect to the centerline of the road. Specifying road friction under [GLOBAL_PARAMETERS] overwrites any specification of road friction values in the [DATA_POINTS] block. See Data Points Information.
33
Road Models in Adams/Tire
Specifies: Road friction value on the right side of the road with respect to the centerline of the road. Specifying road friction under [GLOBAL_PARAMETERS] overwrites any specification of road friction values in the [DATA_POINTS] block. See Data Points Information. Width of the road. If you specify WIDTH, it takes precedence over the WIDTH value specified in the [DATA_POINTS] block. Even if this parameter is set, you must specify the WIDTH parameter in [DATA_POINTS]. If this parameter is not required, then you can omit it from the road data file (.rdf). See Data Points Information. Slope angle of the road around its centerline in each data point. Zero bank means a horizontal width line. A positive value specifies a slope along a clockwise direction in ISO-reference frame. If you specify this dimension, then it takes precedence over the BANK value specified in the [DATA_POINTS] block. Even if you set this dimension, you must specify a BANK value. If this dimension is not required, then you can omit it from the .rdf file. See Data Points Information.
WIDTH
BANK
Data Points Information The [DATA_POINTS] block contains the road information in a tabular form. The following information needs to be supplied for each entry. [DATA_POINTS] { X Y OBSTACLES } [DATA_POINTS] Keywords The keyword: X Y Z WIDTH BANK Specifies: X coordinate of sampled road data point. Y coordinate of sampled road data point. Z coordinate of sampled road data point. Width of road at the sampled point. Angle of road at the sampled point; positive value specifies a slope along a clockwise direction in ISO-reference frame. Z WIDTH BANK MU_LEFT MU_RIGHT
34 Adams/Tire
Specifies: Road friction on the left side of road with respect to the centerline of the road at the sampled point. Road friction on the right side of road with respect to the centerline of the road at the sampled point. The name of block that contains the perturbation information. This entry is optional.
Sample Road Data File $--------------------------------------------------------MDI_HEADER [MDI_HEADER] FILE_TYPE = 'rdf' FILE_VERSION = 5.00 FILE_FORMAT = 'ASCII' (COMMENTS) {comment_string} 'Example of 3d Smooth road' $------------------------------------------------------------UNITS [UNITS] LENGTH = 'meter' FORCE = 'newton' ANGLE = 'radians' MASS = 'kg' TIME = 'sec' $--------------------------------------------------------DEFINITION [MODEL] METHOD = '3D_SPLINE' $---------------------------------------------------ROAD_PARAMETERS [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.5 WIDTH = 5.000 BANK = 0.0 $-------------------------------------------------------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
35
Road Models in Adams/Tire
1.53081E-18 1.42109E-17 0.00000E-00 7.000 0.000 0.900 -2.50000E+00 4.68958E-16 0.00000E-00 7.000 0.000 0.900 -5.00000E+00 9.37916E-16 0.00000E-00 7.000 0.000 0.900 -7.50000E+00 1.39266E-15 0.00000E-00 7.000 0.000 0.900 -1.00000E+01 1.84741E-15 0.00000E-00 7.000 0.000 0.900 -1.25000E+01 2.30216E-15 0.00000E-00 7.000 0.000 0.900 -1.50000E+01 2.77112E-15 0.00000E-00 7.000 0.000 0.900 -1.75000E+01 3.22586E-15 0.00000E-00 7.000 0.000 0.900 -2.00000E+01 3.69482E-15 0.00000E-00 7.000 0.000 0.900 $----------------------------------------------------END_DATA_POINTS [CROWN] COORDINATE_SYSTEM = 'distance' START = 7 STOP = 16 WIDTH = 4 ROAD_TYPE = 'CROWN DATA_BLOCK = 'CROWN_DATA' FRICTION = 0.900 (CROWN_DATA) {S HEIGHT CROWN} 7.00000E+00 0.00000E+00 8.00000E+00 1.25000E-02 9.00000E+00 5.00000E-02 1.00000E+01 8.75000E-02 1.10000E+01 1.00000E-01 1.20000E+01 1.00000E-01 1.30000E+01 1.00000E-01 1.40000E+01 1.00000E-01 1.50000E+01 1.00000E-01 1.60000E+01 1.00000E-01
0.00000E+00 3.12500E-03 1.25000E-02 2.18750E-02 2.50000E-02 2.50000E-02 2.50000E-02 2.50000E-02 2.50000E-02 2.50000E-02
36 Adams/Tire
Creating Road Property Files Opening Road Property Files Changing Units Saving Changes Displaying Header Information and Adding Comments Setting Global Parameters Defining Road Data Points Defining Obstacles Defining Analytical Road
Conversion of TeimOrbit Format 3D Spline Road Property Files to XML Format The Road Builder does not use TeimOrbit property files. If you open a TeimOrbit 3D Spline Road property file in the Road Builder, it automatically converts it to XML format. This XML 3D Spline Road property file is stored in the working directory and loaded in the Road Builder. Starting the Road Builder To start the Road Builder in Adams/Car:
From the Simulate menu, point to Full-Vehicle Analysis, and then select Road Builder.
To start the Road Builder in Adams/Chassis: In Build mode, from the Utilities menu, select Road Builder. 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 five tabs:
Header - Displays header and units information and lets you enter comments. Learn more. Global - Sets parameters for the entire road. 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.
37
Road Models in Adams/Tire
Creating a 3D Spline Road Property File To create a new 3D Spline Road property file: From the File menu, select New. 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. Opening an Existing 3D Spline Road Property File To edit an existing 3D Spline Road property file, do one of the following: From the File menu, select Open, and then browse for the desired file.
To the right of the Road File text box, select the Browse button
desired file.
38 Adams/Tire
Changing Units To change the units: 1. From the Settings menu, select Units. 2. Change the units, and then select OK. Saving Changes To save changes you make to the XML file: 1. At the bottom of the Road Builder, select either Save or Save As. 2. If you selected Save As, enter the file name, and then select OK. Displaying Header Information and Adding Comments The Header tab shows information about the road file and the units of the 3D Spline Road object. You can add comments in the Revision Comment area, as shown in the figure below. To display header information and add comments: 1. Select the Header tab. 2. View the information and in the Revision Comment area, enter any comments to help you manage the road property file.
39
Road Models in Adams/Tire
Setting Global Parameters Parameters that apply to the entire road are defined in the Global Tab, shown below. Learn more about
the global parameters.
To edit the parameters: 1. Select the Global tab. 2. Change the parameters as explained in global parameters. Tip: To help you correctly enter values, the units for the current parameter appear in the Current Field Unit text box.
40 Adams/Tire
Defining Road Data Points The Road Points tab shows the Road Data Points table, as shown in the figure below. Learn about 3D Spline Road data points. Using the table, you can add and delete road data points and display the points as a plot so you can visualize the road and make changes to it.
Working with Data Rows Plotting Road Data Points
41
Road Models in Adams/Tire
Working with Data Rows You can edit any of the data in the rows of the Road Data Points table and add or delete rows. The following provide you with the basics of enter data points in the table. To edit the values in a row: Select the value you want to change, and then type a new value. Learn about the data point values. To add rows to the Road Data Points table: 1. Select Add Road Points, located below the table. 2. Enter the number of data points you want to enter, and then select OK. The Road Builder adds the rows to the end of the table. To delete rows in the Road Data Point table: Select the row or rows you want to delete, right-click the column Number, and then select Delete Row(s).
42 Adams/Tire
The Road Builder renumbers the rows of the table. To add a single row to the end of the table: Right-click the column Number, and then select Add Row. To insert a single row below a selected row: Right-click the row in the column below which you want to add a row, and then select Insert Row. To copy and paste data in rows: Highlight the text you want to copy, and then select an copy (CTRL + C) data from a source and paste (CTRL + V) it in the road data points table. Plotting Road Data Points You can visualize the road data plots by plotting them as x-y (x values versus y values) or x-z plots (x values versus z values). Note that if both the x-y plot and x-z plots are active, changes to road data points in one plot are not automatically updated in the other plot. Close and reopen the plot after updating the main road data points table.
43
Road Models in Adams/Tire
To plot the road data points: Select Show X-Y Plot or Show X-Z Plot to create a plot of the road, as shown in the figure above for x-y values. 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.
To view the data points in the plot: Right-click the plot, and then select Show Symbols.
To view the data points as a curve: Right-click the plot, and then select Show Curve.
To zoom the display: 1. Select Zoom. 2. using the mouse, draw a box around the area of the plot you want to view. To modify the road data points: 1. Right-click the plot, and then select Show Symbols. 2. Drag the points using the mouse. The new coordinates for the data points update in the table on the right. 3. Select OK. (The road data points are not updated in the main table until you select OK.) To exit the plot: In the upper right corner, select the X. 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.
44 Adams/Tire
Adding, Deleting, and Renaming Obstacles To create a new road obstacle in the Obstacle table: 1. In the Name text box, enter the name of the obstacle. 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. Using the Obstacle Property Editor The Obstacle Property Editor, shown in the figure below, shows the common and obstacle-specific parameters. The obstacle-specific parameters portion of the dialog box only shows those parameters that belong to the selected obstacle type. Note that you cannot change the coordinate system in the Common Obstacle portion as the obstacle type determines whether Local or Distance should be used.
45
Road Models in Adams/Tire
You manage the data in the tables for the Polyline and Crown obstacle types in the same way you do road data points. For more information on adding, deleting, and copying/pasting of data, see Defining Road Data Points. To display the Obstacle Property Editor, do one of the following: Right-click the obstacle name in the Obstacle table, and then select Modify with PropertyEditor.
Double-click the obstacle name in the obstacle table.
Tip:
To help you correctly enter values, the units for the current parameter appear in the Current Field Unit text box.
46 Adams/Tire
Defining Analytical Road Following example illustrates how to create/modify a road model analytically from scratch in Adams/Road Builder. Road data can be created with multiple segments, each segment representing predefined formulations like Linear, Curvature, and Transition Curve or through User Defined Functions and User Defined Points. Steps to Create a Road Data File: New tab Road Generator is added to the Road Builder GUI. This tab allows the user to create/modify road data file using segments.
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.
47
Road Models in Adams/Tire
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.
48 Adams/Tire
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.
49
Road Models in Adams/Tire
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. The points are appended to the road points table.
50 Adams/Tire
User Defined Functions: User can calculate points using their own functions. For example: User function = s*75; s*10; 0 Function Start = -10 Function End = 10 Calculation of Road Point: -10*75; -10*10; 0 -9*75; -9*10; 0 -8*75; -8*10; 0
51
Road Models in Adams/Tire
52 Adams/Tire
53
Road Models in Adams/Tire
54 Adams/Tire
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, ( { ). A keyword and its value are separated by an equal sign (=). You must enter strings within single (' ') or double (" ") quotes.
55
Road Models in Adams/Tire
Examples of Blocks:
Units Block Block header: Keywords: LENGTH 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: Keywords: METHOD [MODEL] Allowed values: = {'3D'} [UNITS] Allowed values: = {'meter', 'mm', 'cm', 'km', 'inch', 'mile'}
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 u } <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>
56 Adams/Tire
12 Adams/Tire
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
opens the file, and reads portions of it to determine which tire model to use (for example, Fiala, MF-TYRE, or your tire model). If the [MODEL] block in tire property, for example, looks like this: [MODEL] PROPERTY_FILE_FORMAT = 'USER' FUNCTION_NAME = 'TYR501' Adams/Tire uses the tire model implemented in subroutine TYR501.
Adams/Tire gets the road property file name from another STRING statement in the Adams
model, opens the file, and reads portions of it to determine which road model to use (for example, 2D, 3D, or your road model). If the [MODEL] block in the road property file, for example, looks like this:
13
User-Written Tire/Road Models
[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
(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. Flow of Information in Adams/Tire
14 Adams/Tire
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
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.
15
User-Written Tire/Road Models
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
Adams/Tire can save them between calls to your TYRSUB. 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). 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.
moments: tyr501.f
An include file that tyr501.f and rpf501.f share. The include file defines the locations in the
TYRARR array of parameters read from the tire property file: tyr501.inc
Other include files that tyr501.f requires: abg_varptr.inc and ac_tir_jobflg.inc
To learn more about the default Fiala tire model supplied with Adams/Tire, see Using the Fiala Handling Force Model.
16 Adams/Tire
17
User-Written Tire/Road Models
c Read Tire Property File ENDIF c Call The ROAD Subroutine CALL ROAD(....) IF ( JOBFLG .EQ. NORMAL .OR. . JOBFLG .EQ. DIFF ) THEN C Calculate The Tire Forces And Moments c Tire Kinematics c Tire Forces And Moments At Contact Patch c Transfer Forces And Moments to Wheel Center in ISO C-Axis System c Load Results In VARINF Array ENDIF c Handle Errors RETURN END Reading The Tire Property File During the initialization process, Adams/Tire calls your TYRSUB with JOBFLG = 2 (INIT ). When JOBFLG = INIT, your TYRSUB should open and read the tire property file. Your TYRSUB can statically store the data read from the property file or return it to Adams/Tire in the TYPARR array. Adams/Tire stores the contents of TYPARR in static memory between calls to your TYRSUB. Adams/Tire requires all tire property files to contain specific information in TeimOrbit format that it reads before calling your TYRSUB. For more information about these requirements. Finally, Adams/Tire provides utilities for reading property files employing TeimOrbit format. For information about these utilities and TeimOrbit format. Calling the ROAD Subroutine Each time Adams/Tire calls your TYRSUB, your TYRSUB must call the ROAD subroutine to ensure that the ROAD subroutine is initialized properly and can perform its work of calculating the tire-road contact point, the local road normal, and coefficient of friction. 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.
18 Adams/Tire
Calculating Tire Forces and Moments When Adams/Tire calls your TYRSUB with JOBFLG = NORMAL (0) or DIFF (5), your TYRSUB should calculate and return tire forces and moments. To calculate tire forces and moments, typically your TYRSUB will:
Call the ROAD subroutine. Calculate tire kinematics.
Note:
Adams/Tire provides utilities for calculating slip angle, inclination angle, longitudinal slip, and other quantities in SAE coordinates.
Calculate tire forces and moments at the tire contact patch. Transfer the forces and moments from the contact patch to the wheel center in ISO-C axis system
for return to Adams/Tire. Loading Results For Plotting When Adams/Tire calls your TYRSUB with JOBFLG = NORMAL(0) or DIFF (5), your TYRSUB should load results in the VARINF array. The specific results and their location in the VARINF array are defined in include file: install_dir/solver/atire/usrsubs/abg_varptr.inc. For example, abg_varptr.inc defines integer parameters giving the location of the lateral and longitudinal slips that you use, such as: VARINF( slipi_ptr ) = alpha VARINF( slipx_ptr ) = kappa Where alpha and kappa are the lateral and longitudinal slip, respectively, calculated by your TYRSUB. 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/Driver 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 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
19
User-Written Tire/Road Models
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, + NIWORK, IWRKAR, IERR) States The tire states contain the displacement, orientation, and velocity information about the wheel and wheel carrier (hub). The state arguments are:
20 Adams/Tire
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)
Forces and Moments The arguments FORCES and TORQUE return the forces and moments on the wheel at the wheel center. TYRSUB returns the forces and moments in units of Newtons and Newton-meters, respectively, according to the TYDEX ISO-C coordinate system. For more information on the TYDEX axis systems, see Tire Axis Systems. 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)
21
User-Written Tire/Road Models
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)
22 Adams/Tire
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). JOBFLG - (Job Control Flag) An integer variable whose value determines the action TYRSUB should take. Table 1 shows the values and meaning of JOBFLG
23
User-Written Tire/Road Models
JOBFLAG Values and Descriptions: Parameter in ac_sti_jobflg.inc: INIT RESET INQUIRE ENDSIM SSTEP NORMAL DIFF
Description: INITIALIZE RESET INQUIRE* END SIMULATION SUCCESSFUL INTEGRATION STEP* NORMAL EVALUATION DERIVATIVE EVALUATION
Value: JOBFLG = 2 JOBFLG = 3 JOBFLG = 1 JOBFLG = ENDSIM = 99 JOBFLG = SSTEP = 4 JOBFLG = NORMAL = 0 JOBFLG = DIFF = 5
* Indicates item is not supported in current version of Adams/Tire. Each value is explained below.
INITIALIZE (JOBFLG = 2)
The first call to a TYRSUB always has JOBFLG=init=1. TYRSUB opens and reads any files necessary to process the tire data before the actual simulation begins.
RESET (JOBFLG = 3)
The TYRSUB is called with JOBFLG=reset=3 after the first initialization while IFLAG=true. You can ignore reset mode in Adams/Tire. This deviates from the TYDEX STI definition stating that the tire parameters array may have changed.
INQUIRE (JOBFLG = 1)
Currently, Adams/Tire does not support JOBFLG=inquire=1. TYDEX STI states that a TYRSUB when called with JOBFLG=inquire=1 should return the needed dimensions of the TYPAR, DEQVAR, VARINF, WORK, and IWRAR arrays. For example, a tire that requires 30 states integrated (30 modes) would set NDEQVAR=30 to give the needed dimension of the DEQVAR array. Currently, Adams/Tire limits the number of integrated states to two. These are usually used for relaxation length in the longitudinal and lateral direction. Therefore, this JOBFLG setting is not used in this release of Adams/Tire.
END SIMULATION (JOBFLG = endsim = 99)
The TYRSUB is called with JOBFLG=endsim=99 just before Adams/Solver is excited. The TYRSUB should close any open files and free any memory allocated. Message handling is not available at this point during execution. Therefore, calls to ERRMES or USRMES do not function.
SUCCESSFUL INTEGRATION STEP (JOBFLG = sstep = 4)
24 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. 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.
25
User-Written Tire/Road Models
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 "). 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:
26 Adams/Tire
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. 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.
27
User-Written Tire/Road Models
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. 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.
28 Adams/Tire
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.
29
User-Written Tire/Road Models
About Tire Property Files When you create your own user tire model, you must also define your own tire property file. At a minimum, this file instructs Adams/Tire to call your tire model to compute tire forces and moments during a simulation and supplies to Adams/Tire required information about the tire. Adams/Tire requires every tire property file to supply:
Tire model to be used (for example, a reference that causes Adams/Tire to call your TYRSUB). Units of the data contained in the file. Dimensions of the tire: unloaded radius, width, and aspect ratio. Tire vertical stiffness and damping.
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. Example Tire Property File $----------------------------------------------------------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'
30 Adams/Tire
$---------------------------------------------------------------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
31
User-Written Tire/Road Models
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 USERand 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.
32 Adams/Tire
[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 = FORCE = ANGLE = MASS = TIME =
The allowed values for unit strings are: FORCE: FORCE : 'KG_FORCE', 'NEWTON', 'KNEWTON','POUND_FORCE', 'KPOUND_FORCE', 'DYNE', 'OUNCE_FORCE' 'KG', 'GRAM', 'POUND_MASS', 'KPOUND_MASS', 'SLUG', 'OUNCE_MASS' 'KM', 'METER', ' CM', 'MM', 'MILE', 'FOOT', 'INCH' 'MILLISECOND', 'SEC', 'MINUTE', 'HOUR' 'DEGREE', 'RADIAN' 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.
[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
33
User-Written Tire/Road Models
[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
34 Adams/Tire
35
User-Written Tire/Road Models
IF ( JOBFLG .EQ. INIT .OR. . JOBFLG .EQ. RESET ) THEN c Read Road Property File ENDIF IF ( JOBFLG .EQ. NORMAL .OR. . JOBFLG .EQ. DIFF ) THEN c Calculate Tire-Road Contact Point, Road Normal, and c Coefficient of Friction. ENDIF c Handle Errors RETURN END
36 Adams/Tire
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,
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.
37
User-Written Tire/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 crosssection:
1 = Radius [%] 2 = Width [%]
Note:
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
38 Adams/Tire
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 crosssection:
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
39
User-Written Tire/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.
40 Adams/Tire
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 = (SUB-BLOCK_1) PARAMETER_2 = {TABLE_1} 1.0 2.0 2.0 3.0 [BLOCK_2] PARAMETER_2 = {TABLE_2} 1.0 2.0 2.0 3.0 (SUB-BLOCK_2) PARAMETER_1 = 1.0 2.0
'TWO'
'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: [VERTICAL_DATA] STIFFNESS = 310.0 DAMPING = 14.3
41
User-Written Tire/Road Models
[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 )
42 Adams/Tire
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)
43
User-Written Tire/Road Models
Type*: CA
Storage: 12x5 R
Use* and Description: Array of five 12-character strings read from the property file containing the unit names.
CV2MDL
CV2MDL(1)
DA
Force conversion
CV2MDL(2)
Mass conversion
CV2MDL(3) Length
conversion
CV2MDL(4)
Time conversion
CV2MDL(5)
DA Force conversion
CV2SI(2)
Conversion factor from property file units to SI units. SI units are Newtons, kilograms, meters, seconds, and radians.
Mass conversion
CV2SI(3)
Length conversion
CV2SI(4)
Time conversion
CV2SI(5)
Angle conversion *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates double-precision array). Use: R = referenced, but not set; E = evaluated (for example, the subroutine sets the value of this argument).
44 Adams/Tire
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 Argument: FORCE MASS LENGTH TIME ANGLE Type*: C C C C C Storage: 12 12 12 12 12 R R R R R Use* and Description: Force string from property file [UNITS] block. Mass string from property file [UNITS] block. Length string from property file [UNITS] block. Time string from property file [UNITS] block. Angle string from property file [UNITS] block.
45
User-Written Tire/Road Models
Argument: CV2MDL
CV2MDL(2)
Type*: DA
Storage: 5 E
Use* and Description: Conversion factor from property file units to model (dataset) units.
Mass conversion
CV2MDL(3)
Length conversion
CV2MDL(4)
Time conversion
CV2MDL(5)
DA Force conversion
CV2SI(2)
Conversion factor from property file units to SI units. SI units are Newtons, kilograms, meters, seconds, and radians.
Mass conversion
CV2SI(3)
Length conversion
CV2SI(4)
Time conversion
CV2SI(5)
Angle conversion *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates double-precision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
ACUNMP
Calling Sequence Subroutine ACUNMP ( UN_IN, UN_OUT ) Description Maps standard property file (Adams/View) unit strings to Adams/Solver unit strings.
46 Adams/Tire
Type: CA
Storage: 12x5 R
Use* and Description: Array of five 12-character strings read from the property file containing the unit names.
UN_OUT
CA
2x5
Array of five two-character strings containing the Adams/Solver unit string corresponding to the unit strings read from the property file.
*Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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.
47
User-Written Tire/Road Models
Arguments Argument: ID I Type*: Storage: R Use* and Description: Identifier of the Adams dataset statement associated with the property file being read (for example, the ID of the tire GFORCE statement when reading a tire property file). Identifies the statement when an error occurs. Array of five 12-character strings read from the tire property file containing the unit names.
UNITS
UNITS(1): force UNITS(2): mass UNITS(3): length UNITS(4): time UNITS(5): angle
C.A.
12x5
*Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (for example, the subroutine sets the value of this argument).
RTO_CLOSE_FILE_F2C
Calling Sequence Subroutine RTO_CLOSE_FILE_F2C (FileName, FileNameLen, Success) Description Closes a previously opened file.
48 Adams/Tire
Arguments Argument: FileName FileNameLen Success I I Type*: C Storage: 256 R R E Use* and description: File name with full path Number of characters in the file name (not the length of the FileName array).
If the file was found and closed,
not be closed, success is returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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: Arguments Argument: FileName C Type*: Storage: 256 R Use* and description: File name with full path (for example, '/usr/people/smith/tire.tir') Before using any of the other RTO utilities, you must first open a file using this subroutine.
49
User-Written Tire/Road Models
Type*:
Storage: R E
Use* and description: Number of characters in the file name (not the length of the FileName array).
If the file was found and opened,
opened, success is returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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 Argument: BlockName BlockNameLen Attribute Name Attribute NameLen Type*: C I C I Storage: 256 256 R R R R Use* and Description: Block name in file containing the desired subblock. Number of characters in the block name. The name of the attribute sought in the file. Number of characters in the attribute name.
50 Adams/Tire
Type*:
Storage: E E
zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
RTO_READ_QUOTED_STRING_F2C
Calling Sequence Subroutine 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
51
User-Written Tire/Road Models
Arguments Argument: BlockName BlockNameLen AttributeName AttributeName Len Value ValueLen Success Type*: C I CI I C I I Storage: 256 256 R R R R E E E Use* and description: Block name in file containing the desired attribute. Number of characters in the file name (not the length of the FileName array). Name of attribute sought in the file. Number of characters in attribute name. On return the string value of the attribute. Number of characters in value.
If a value is read, success is
returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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.
52 Adams/Tire
Arguments Argument: BlockName BlockNameLen Attribute Name Value Success Type*: Storage: C I C D I 256 256 R R R R E E Use* and Description: Block name in file containing the desired subblock. Number of characters in the block name. The name of the attribute sought in the file. Number of characters in the attribute name. On return, the value of the attribute.
If the value is read, success is returned as
Attribute NameLen I
one (1).
If the read fails, success is returned as zero
(0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
RTO_READ_SUBBLOCK_INTEGER_F2C
Calling Sequence Subroutine RTO_READ_SUBBLOCK_INTEGER_F2C ( BlockName, BlockNameLen, 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.
53
User-Written Tire/Road Models
Arguments Argument: BlockName BlockNameLen SubBlockName SubBlockNameLen Attribute Name Attribute NameLen Value Success Type*: C I C I C I I I Storage: 256 256 256 R R R R R R E E Use* and Description: Block name in file containing the desired subblock. Number of characters in the block name. Name of subblock in file containing the desired attribute. Number of characters in the subblock name. The name of the attribute sought in the file. Number of characters in the attribute name. On return the value of the attribute.
If the value is read, success is
returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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:
54 Adams/Tire
[FORCES] (FY) DAMPING_COEFF = 1.72 On return, the variable Value is 1.72 and Success is 1. Arguments Argument: BlockName BlockNameLen SubBlockName SubBlockNameLen Attribute Name Attribute NameLen Value Success Type*: C I C I C I D I Storage: 256 256 256 R R R R R R E E Use* and Description: Block name in file containing the desired subblock. Number of characters in the block name. Name of subblock in file containing the desired attribute. Number of characters in the subblock name. The name of the attribute sought in the file. Number of characters in the attribute name. On return the value of the attribute.
If the value is read, success is
returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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:
55
User-Written Tire/Road Models
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 Argument: BlockName BlockNameLen SubBlockName SubBlockNameLen Attribute Name Attribute NameLen Value ValueLen Success Type*: C I C I C I C I I Storage: 256 256 256 256 R R R R R R E E E Use* and Description: Block name in file containing the desired subblock. Number of characters in the block name. Name of subblock in file containing the desired attribute Number of characters in the subblock name. The name of the attribute sought in the file. Number of characters in the attribute name. On return the string value of attribute. Number of characters in value.
If the value is read, success is
returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
56 Adams/Tire
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, + Format, FormatLen, Success ) IF ( Success .eq. 0 ) THEN c --- Table Not Found --ELSE 10 CONTINUE CALL RTO_READ_TABLE_LINE_F2C( Value, ValueLen, Success ) IF ( Success .eq. 0 ) then c --- End of table found --GOTO 20 ELSE c --- Parse string in Value To retrieve values, then go c get another line of the table. c c The first time through this loop Value holds c " 0.0 0.24/n" c c The third time through this loop Value holds c " 0.3 0.96/n" c --GOTO 10 ENDIF ENDIF 20 CONTINUE
57
User-Written Tire/Road Models
Arguments Argument: Value ValueLen Success Type*: C I I Storage: 256 E R E Use* and Description: On return the nth line of a table. Number of characters in value.
If the value is read from the table, success is
returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
RTO_START_SUBBLOCK_TABLE_READ_F2C
Calling Sequence Subroutine RTO_START_SUBBLOCK_TABLE_READ_F2C ( BlockName, BlockNameLen, SubBlockName, SubBlockNameLen, Format, FormatLen, Success ) 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
58 Adams/Tire
Arguments Argument: BlockName BlockNameLen SubBlockName SubBlockNameLen Format FormatLen Success Type*: C I C I C I I Storage: 256 256 256 R R R R E E E Use* and Description: Block name in file containing the desired subblock. Number of characters in the block name. Name of subblock in file containing the desired attribute. Number of characters in the subblock name. The string containing the table column headings. The number of characters in the Format string.
If the value is read, success is
returned as zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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
59
User-Written Tire/Road Models
On return:
Format contains the string, " XY" FormatLen contains the integer 6 Success contains the integer 1
Arguments Argument: BlockName BlockNameLen Format FormatLen Success Type*: C I C I I Storage: 256 256 R R E E E Use* and Description: Block name in file containing the desired subblock. Number of characters in the block name. The string containing the table column headings. The number of characters in the Format string.
If the value is read, success is returned
as one (1).
If the read fails, success is returned as
zero (0). *Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
60 Adams/Tire
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 Argument: TRAMAT Type:* DA Storage: 3,3 R Use* and Description: Transformation from ISO wheel carrier (TYDEX ISO-C system) axis system to road (earth) axis system. Translational velocity of wheel carrier in ISO wheel carrier axis system. Rotational velocity of wheel carrier in ISO wheel carrier axis system. Rotational speed of the rim (wheel) with respect to the wheel carrier about the +y axis of the ISO wheel carrier axis system.
DA DA DS
3 3 1
R R R
61
User-Written Tire/Road Models
Argument: RADIUS
Type:* DS
Storage: 1 R
Use* and Description: The loaded tire radius (for example, distance from the wheel center to the road surface in the plane of the wheel). Unit vector giving the local road normal in the road (earth) axis system. The road normal must be directed upward from the road surface. The longitudinal velocity of the tire in TYDEX ISO-C axis system. The SAE contact-patch longitudinal velocity. The SAE contact-patch lateral velocity. The SAE contact-patch vertical velocity. Slip angle in SAE axis system. Inclination (camber) angle. Longitudinal slip ratio. Unit vector directed from wheel center to contact patch expressed in road (earth) reference marker axis system. Transformation matrix from the SAE contactpatch axis system to the road (earth) reference marker axis system.
RNORM
DA
DS DS DS DS DS DS DS DA
1 1 1 1 1 1 1 3
E E E E E E E E
CPMTX
DA
3,3
*Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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.
62 Adams/Tire
Arguments Argument: VCPVRT RADIUS TIREK TIREC UNLRAD FRCRAD ERRMSG IERR Type:* DS DS DS DS DS DS CA IS 80 Storage: R R R R R E E E Use* and Description: Vertical contact-patch velocity in SAE coordinates (+z is downward) Loaded tire radius Tire stiffness <n/m> Tire damping <n*s/m> Unloaded tire radius <m> Radial (vertical) force <n> Error message Error code: IERR = 0, normal execution IERR = 3, problem calling IMPACT function
*Key: Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
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 Argument: FCP TCP RAD Type:* DA DA DA Storage: 3 3 3 R R R Use* and description: Contact patch forces expressed in SAE axis system (+z is downward). Contact patch torques expressed in SAE axis system (+z is downward). Radius vector from wheel center to contact patch expressed in the road reference marker axis system.
63
User-Written Tire/Road Models
Argument: CPMTX
Type:* DA
Storage: 3,3 R
Use* and description: Transformation matrix from SAE contact-patch axis system to the road reference marker axis system. Hub forces expressed in the road reference marker axis system. Hub torques expressed in the road reference marker axis system.
DA DA
3 3
E E
Type: A = array; C = character; D = double precision; I = integer (for example, DA indicates doubleprecision array). Use: R = referenced, but not set; E = evaluated (the subroutine sets the value of this argument).
64 Adams/Tire
Similar demand loaded library functionality is available for user-written roads: [MODEL] PROPERTY_FILE_FORMAT FUNCTION_NAME ='USER' ='<roaduserlibname>::ARC<number>'