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/**).