Requests

Request 902

Request 902 (req902) can output predefined tire results into the request (.req) and results (.res) files.

Input:

REQ/id, FUNCTION = USER(routing_code, reqtyp, tir_id)
Routine= abgTire::req902
where:
 
Description
routing_code
=
Used only when routine= is not specified to dispatch to the proper routine
reqtyp
=
Integer code fixing the information output to the request file. The output for each value of reqtyp is described in the Outputting Results.
tir_id
=
Tire GFORCE statement ID

Request File Output

Refer to Outputting Results for Adams Car tire request activity name.

Notes on Input and Output

None

Request 904

Request 904 (req904) used in Adams Car spring, damper, bumpstop and reboundstop UDE's and outputs displacement magnitude, velocity and force in the direction of displacement.

Input:

REQ/id, FUNCTION = USER(routing_code, imarker, jmarker,rmarker, zerolim, dmCalc)
Routine= abgFDM::req904
where:
 
Description
routing_code
=
Used only when routine= is not specified to dispatch to the proper routine
imarker
=
ID of I marker
jmarker
=
ID of J marker
rmarker
=
(Optional) ID of reference marker
zerolim
=
(Optional) Result values smaller than zerolim (default is 1e-7) are returned as zero
dmCalc
=
(Optional) Initial displacement computed between the I and J markers

Request File Output

Column Number Output without dmCalc (when you don’t supply dmCalc via optional parameter):
1. .Displacement magnitude (dm(imarker, jmarker))
2. Velocity in direction of displacement
3. Force in direction of displacement
4. X component of displacement pointing from the jmarker to imarker
5. Y component of displacement pointing from the jmarker to imarker
6. Z component of displacement pointing from the jmarker to imarker
Column Number Output with dmCalc (when you supply dmCalc via optional parameter) :
1. Displacement magnitude (dm(imarker, jmarker))
2. Velocity in direction of displacement
3. Force in direction of displacement
4. Displacement magnitude (dm(imarker, jmarker)) - dmCalc)
5. (not used)
6. (not used)

Notes on Input and Output

If optional rmarker is specified then translational displacement, velocity and force makes use of it to resolve in that reference marker frame.

Request 905

Request 905 (req905) used in Adams Car bushing UDE and outputs displacement, velocity, standard Adams Car bushing forces, standard Adams bushing forces, and standard Adams vforce depending on the value of par(2) in the parameter list.

Input:

REQ/id, FUNCTION = USER(routing_code, branch_id, imarker, jmarker, force_id, rmarker, zerolim)
Routine= abgFDM::req905
where:
 
Description
routing_code
=
Used only when routine= is not specified to dispatch to the proper routine
branch_id
=
Output branching flag:
1 = displacement
2 = velocity
3 = field forces (standard Adams Car)
4 = bush forces (standard Adams)
5 = vforces
imarker
=
ID of I marker
jmarker
=
ID of J marker
force_id
=
ID of FIELD or BUSH or VFORCE element
rmarker
=
(Optional) ID of reference marker
zerolim
=
(Optional) Result values smaller than zerolim (default is 1e-7) are returned as zero

Request File Output

Column Number Output for branch_id = 1 :
1. Displacement in X
2. Displacement in Y
3. Displacement in Z
4. Angular displacement along X
5. Angular displacement along Y
6. Angular displacement along Z
Column Number Output for branch_id = 2 :
1. Velocity in X
2. Velocity in Y
3. Velocity in Z
4. Angular velocity along X
5. Angular velocity along Y
6. Angular velocity along Z
Column Number Output for branch_id = 3 (FIELD) and 4 (BUSH):
1. x component of the force
2. y component of the force
3. z component of the force
4. x component of the torque
5. y component of the torque
6. z component of the torque
Column Number Output for branch_id = 5 (VFORCE) :
1. x component of the force
2. y component of the force
3. z component of the force
4. (not used)
5. (not used)
6. (not used)

Notes on Input and Output

1. For branch_id = 3, force_id should be of FIELD, for branch_id=4, force_id should be of BUSH and for branch_id = 5, force_id should be of VFORCE.
2. By default, the results are expressed in jmarker coordinate system. If rmarker is specified, the results are expressed in rmarker coordinate system.
3. For branch_id=3, 4 or 5, the forces and moments are reported at the force element I marker (the I marker specified here is not used and the J marker specified here is only used as described in 2.)

Request 906

Request 906 (req906) used in Adams Car to calculate the point on the road that is closet to a specified point on a part. This works only with 3D (spline) roads.

Input:

REQ/id, FUNCTION = USER(routing_code, str_road_id, imarker, jmarker, rmarker)
Routine= abgTire::req906
where:
 
Description
routing_code
=
Used only when routine= is not specified to dispatch to the proper routine
str_road_id
=
String id of road property file
imarker
=
ID of marker on body
jmarker
=
ID of road reference marker
rmarker
=
ID of reference marker

Request File Output

Column Number Output:
1. x component of the distance
2. y component of the distance
3. z component of the distance
4. x component of the distance velocity
5. y component of the distance velocity
6. z component of the distance velocity

Notes on Input and Output

None

Request 907

The definition of the parameters array and the resulting output is:
par(1) = Branch Flag 907
par(2) = Request Type:
        0 = Displacement(Angles in radians)
        1 = Velocities    
             (Translational vel. in KPH)
              (Angular velocity in radians/s)
        2 = Accelerations
              (Translational acc. G's)
              (Rotational acc. in radians/s/2)
        3 = Body Side Slip Angle in Radians
par(3) = id I marker
par(4) = id J marker
par(5) = id RM marker
Any results with a magnitude less than 1e-7 are set to zero.

Vehicle Mass Properties (Request 908)

Computes the vehicles aggregate cm location, mass and inertia tensor.

Input:

REQ/id, FUNCTION = USER(routing_code,type,grm,zerolim)
Routine= abgVDM::req908
where:
 
Description
routing_code
=
Used only when routine= is not specified to dispatch to the proper routine
type
=
request type
0 = returns aggregate cm location (in ground origin coordinates) and mass
1 = returns aggregate inertias at aggregate cm
grm
=
Ground origin marker (only used to add Ftire belt mass and inertia to aggregate values, when necessary)
zerolim
=
Result values smaller than zerolim are returned as zero

Request File Output

Column Number Output for request type = 0:
1. Aggregate cm X location
2. Aggregate cm Y location
3. Aggregate cm Z location
4. Aggregate mass
5. (not used)
6. (not used)
Column Number Output for request type = 1:
1. Aggregate Ixx at aggregate cm
2. Aggregate Iyy at aggregate cm
3. Aggregate Izz at aggregate cm
4. Aggregate Ixy at aggregate cm
5. Aggregate Ixz at aggregate cm
6. Aggregate Iyz at aggregate cm

Notes on Input and Output

The output is reported in the ground coordinate system.

Request 909

Request 909 (req909) used in Adams Car joint force/motion UDE's and outputs displacement, velocity, torque/force and acceleration.

Input:

REQ/id, FUNCTION = USER(routing_code, imarker, jmarker, type_of_freedom, action_only_flag, array_id, zerolim)
Routine= abgFDM::req909
where:
 
Description
routing_code
=
Used only when routine= is not specified to dispatch to the proper routine
imarker
=
ID of I marker
jmarker
=
ID of J marker
type_of_freedom
=
specify type of freedom
0 = Translation
1 = Rotation
Default is set to rotation.
action_only_flag
=
Action only flag
0 = action reaction type force
1 = action only force
Default is set to action reaction type force.
array_id
=
ID of array storing actuator limits and ids of application and identifier strings.
zerolim
=
(Optional) Result values smaller than zerolim (default is 1e-7) are returned as zero

Request File Output

Column Number Output for Translation type of freedom:
1. Displacement
2. Velocity
3. Force
4. Acceleration
5. (not used)
6. (not used)

Column Number Output for Rotation type of freedom:

1. Displacement
2. Velocity
3. Torque
4. Acceleration
5. (not used)
6. (not used)

Notes on Input and Output

None

Request 1001

Request 1001 (req1001) used in Adams Car to outputs turn radius, bank angle and longitudinal acceleration in G.

Input:

REQ/id, FUNCTION = USER(routing_code)
Routine= abgVDM::req1001
where:
 
Description
routing_code
=
Used only when routine= is not specified to dispatch to the proper routine

Request File Output

Column Number Output:
1. Turn Radius (mm)
2. Bank Angle (deg)
3. Longitudinal Acceleration (G)
4. (not used)
5. (not used)
6. (not used)

Notes on Input and Output

None

Request 1090

Request 1090 (req1090) used in Adams Car to computes vehicle handling statistics. Refer to special request Vehicle Dynamics.

Wheel envelope output request

This routine returns the locations of the wheel center and a point on the spindle axis outboard of the wheel. It also writes these values to the .wev file for both the left and right sides.

Input:

REQ/id, FUNCTION = USER (routing_code, side, left_wheel_center_marker_id, right_wheel_center_marker_id, length)
Routine= acarSDM::req901
where:
 
Description
routing_code
=
Used only when routine is not specified to dispatch to the proper routine
side
=
1=left, 2=right
left_wheel_center_marker_id
=
left wheel center marker id
right_wheel_center_marker_id
=
right wheel center marker id
length
=
Distance between the wheel center and the axis point written to the .wev file for wheel envelope analyses.

Request File Output

Column Number Output for side = 1 and 2:
1. Left wheel center position
2. Left axis point position
3. Right wheel center position
4. Right axis point position

Notes on Input and Output

The output is reported in the ground coordinate system