VTORQUE
The VTORQUE command redefines and/or lists the data for a VTORQUE statement that defines a vector torque that consists of three orthogonal components.
Format
Arguments
FUNCTION=USER(r1[,...,r30]) | Respecifies up to thirty user-defined constants used to compute the torque components in an externally-defined subroutine VTOSUB (see the VTOSUB subroutine). |
JFLOAT=id | Respecifies the marker on the part to which Adams Solver (C++) applies the reaction torque. You must ensure that the JFLOAT marker is a floating marker and on a different part than the I marker. Adams Solver (C++) moves the JFLOAT marker to keep it superimposed on the I marker. Adams Solver (C++) does not calculate reaction forces when the JFLOAT marker is on the ground part. |
I=id | Respecifies the marker on the part to which Adams Solver (C++) applies the action torque. You must ensure that the I marker is a fixed marker and on a different part than the JFLOAT marker. |
LIST | Lists the current values of the VTORQUE arguments. |
ROUTINE=libname::subname | Specifies an alternative library and name for the user subroutine VTOSUB. Learn more about the ROUTINE Argument. |
RM=id | Respecifies the marker that determines the orientation of the torque components. You must ensure that RM is a fixed marker. RM may be the same as I and on any part in the system. |
TXYZ=e3d | Respecifies the 3D vector expression for the VTORQUE torque relative to the RM marker. |
TX=e | Respecifies the magnitude and sign of the x component of the torque exerted by the VTORQUE element. The direction of this torque component is parallel to the x-axis of the RM marker in the sense of the right-hand rule (that is, a positive torque causes a counterclockwise rotation). |
TY=e | Respecifies the magnitude and sign of the y component of the torque exerted by the VTORQUE element. The direction of this torque component is parallel to the y-axis of the RM marker in the sense of the right-hand rule (that is, a positive torque causes a counterclockwise rotation). |
TZ=e | Respecifies the magnitude and sign of the z component of the torque exerted by the VTORQUE element. The direction of this torque component is parallel to the z-axis of the RM marker in the sense of the right-hand rule (that is, a positive torque causes a counterclockwise rotation). |
Extended Definition
The VTORQUE command lists or redefines a force element that consists of three mutually orthogonal translational torque components. You can alter one or both points of torque application, change the torque reference marker, and change the torque function expressions or the parameters passed to the VTOSUB user-written subroutine.
After a change to a VTORQUE, Adams Solver (C++) reprocesses the model at the next SIMULATE command, as if it had just been read in from the dataset. During the reprocessing, Adams Solver (C++) checks the entire model for consistency, reinitializes user subroutines, and recomputes initial conditions.
While checking, Adams Solver (C++) verifies that the model is still valid with the new VTORQUE. If, for example, the VTORQUE function expression refers to an inactive element, Adams Solver (C++) issues an error.
Adams Solver (C++) also reinitializes all user subroutines to re-establish functional dependencies. For each element that refers to a user-written subroutine, Adams Solver (C++) calls the user-written subroutine with IFLAG set to true.
Prior to the actual simulation, Adams Solver (C++) computes initial conditions for the model. If this is the first simulation, Adams Solver (C++) begins with the positions and velocities specified in the dataset. If you ran a previous simulation, Adams Solver (C++) begins with the final displacements and velocities. Adams Solver (C++) then adjusts the initial conditions to ensure that they are consistent with the model constraints. If this is the first simulation, Adams Solver (C++) also maintains any user supplied joint initial-conditions and positions specified as EXACT.
Tip: | Depending on the nature of the desired torque relationship, the RM marker may belong to the same part as the I marker or the JFLOAT marker, or to a third, unrelated part. |
Caution: | The user-defined functions TX, TY, and TZ should be smooth, continuous, and single-valued. These conditions make the solution process very effective. |
Example 1
VTORQUE/10, LIST &
,TX= -90.5*Dx(109,102,102) - 9.05*Vx(109,102,102,102)\ &
,TY= -90.5*Dy(109,102,102) - 9.05*Vy(109,102,102,102)\ &
,TZ=-750.8*Dz(109,102,102) - 75.08*Vz(109,102,102,102)
Example 2
VTORQUE/10, LIST &
,TXYZ = -90.5*DXYZ(109,102,102) - 9.05*VXYZ(109,102,102) - [0, 0, 660.3*DZ(109,102,102), 66.03*VZ(109,102,102,102)]
See other Forces available.