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