TIRE_FORCE

 

This subroutine defines a user - defined tire force.

 

Language type

SubRoutine

FORTRAN

tire_usub (TIME, ITIME, CONPROP, TIREPROP, MASSPROP, UPAR, NPAR, JFLAG, IFLAG, TFSAE, RFSAE, FCOEF)

C/C++

tire_usub (double time, double itime, double conprop[], double tireprop[], double massprop[], double upar[], int npar, int jflag, int iflag, double tfsae[3], double rfsae[3], double fcoef[2])

 

Parameter information

 

Variable Name

Size

Description

time

double

Current simulation time of RecurDyn/Solver.

itime

double

Past time for saved values.

conprop

double[10]

Contact property for computing Tire force.

     conprop(1) = Longitudinal slip ratio.

     conprop(2) = Lateral slip angle in radian

     conprop(3) = Camber angle in radian.

     conprop(4) = Normal penetration of tire into road surface

     conprop(5) = Normal velocity of penetration of tire into road surface.

     conprop(6) = Longitudinal sliding velocity of contact patch.

     conprop(7) = Loaded radius of tire.

     conprop(8) = Angular velocity about spin axis of tire.

     conprop(9) = Longitudinal velocity of tire tread base.

     conprop(10) = Lateral velocity of tire tread base.

tireprop

double[11]

Geometry and Material property of TIRE.

     tireprop(1) = Undeformed radius of tire.

     tireprop(2) = Carcass radius of a toroidal tire.

     tireprop(3) = Normal stiffness.

     tireprop(4) = Longitudinal stiffness.

     tireprop(5) = Lateral stiffness due to slip angle.

     tireprop(6) = Lateral stiffness due to camber angle.

     tireprop(7) = Rolling moment resistance coefficient.

     tireprop(8) = Normal damping ratio.

     tireprop(9) = Friction coefficient at zero slip.

     tireprop(10) = Friction coefficient at full slip.

     tireprop(11) = Friction coefficient at the current slip value.

massprop

double[2]

Mass property of TIRE.

upar

double[100]

Parameters defined by the user. The maximum size of array is 100.

npar

int

Number of user parameters.

jflag

int

When RecurDyn/Solver evaluates the Jacobian, the flag is true. Otherwise, the flag is false.

iflag

int

When RecurDyn/Solver makes its initial call to this routine, the flag is true. Otherwise, the flag is false.

tfsae

double[3]

Returned force vector acting at the contact point in the SAE coordinate system and this is three dimensional arrays.

     tfsae(1) = Longitudinal force at the contact point(SAE Coordinate system).

     tfsae(2) = Lateral force at the contact point(SAE Coordinate system).

     tfsae(3) = Normal force at the contact point(SAE Coordinate system).

rfsae

double[3]

Returned torque vector acting at the contact point in the SAE coordinate system this is three dimensional arrays.

     rfsae (1) = Overturning moment at the contact point(SAE Coordinate system).

     rfsae (2) = Rolling resistance moment(SAE Coordinate system).

     rfsae (3) = Aligning moment at the contact point(SAE Coordinate system).

fcoef

double[2]

Returned friction coefficients this is two dimensional arrays.

     fcoef(1) = Longitudinal friction coefficient between tire and road.

     fcoef(2) = Lateral friction coefficient between tire and road.

 

Example

Figure 1  Tire model

 

Note

If the user wants to run this model using a user subroutine, the user can refer it in the directory (<install dir>/Help/usub/**).