Adams Basic Package > Adams View > View Command Language > panel > panel set twindow_function general_force

panel set twindow_function general_force

The GENERAL_FORCE function returns the force COMPONENT for a GENERAL_FORCE you identify in the GENERAL_FORCE_NAME parameter.

Format:

 
panel set twindow_function general_force
general_force_name =
an existing genforce
return_value_on_marker =
marker_type
component =
all_components
reference_marker =
an existing marker

Example:

 
panel set twindow_function general_force &
panel set twindow_function single_component_force return_value_on_marker =
i &
panel set twindow_function single_component_force component =
fx &
panel set twindow_function single_component_force reference_marker =
marker_84

Description:

 
Parameter
Value Type
Description
general_force_name
An Existing Genforce
Specifies an existing general force.
return_value_on_marker
Marker_type
Specifies for which marker on the force element (i or j) the function will return force values
component
All_components
Specifies the specific COMPONENT of force or torque that the function is to return for the force element.
reference_marker
An Existing Marker
Specifies a marker that provides a reference coordinate system for the function.

Extended Definition:

1. The force or torque is calculated in the coordinate system of the REFERENCE_MARKER. If the RETURN_VALUE_ON_MARKER parameter is set to "i", the value returned is the force or torque acting on the I_MARKER of the force/torque generating element. If RETURN_VALUE_ON_MARKER parameter is set to "j", the value returned is that acting on the J_MARKER. If the REFERENCE_MARKER is not specified the results are with respect to the ground coordinate system.
2. A GENERAL_FORCE defines a complete force element, consisting of three mutually orthogonal translational force components and three orthogonal torque components. The two resultant vectors formed by the three component forces and the three component torques determines the direction of the force and torque actions, respectively. The user defines these force and torque components along and about the "reference" marker axes. The reactions are equal and opposite to the action. The user may define the GENERAL_FORCE in Adams View through user-specified function expressions or by specifying up to 30 user-defined parameters that are passed to a user-written subroutine (a "GFOSUB") the user links with Adams.
The GENERAL_FORCE corresponds to the Adams GFORCE statement.
A GENERAL_FORCE creates a six component force element that applies the forces between two parts of the system. Here, force means three orthogonal translational components and three orthogonal rotational components. The element applies actions to the part to which the I marker belongs and corresponding reactions to the part to which a "floating_marker" belongs. This "floating marker" is automatically created by Adams View and is positioned to be coincident with the I marker. Subsequently, the GENERAL_FORCE internally establishes the position of the "floating_marker". As the system moves, Adams moves the "floating_marker" on its part to keep the "floating_marker" and I markers always superimposed. Thus, Adams applies the reaction force to the part containing the "floating_marker" marker at the instantaneous position of the I marker. The magnitude of the force depends on expressions or subroutines that the user supplies. The value of the force is the resultant (that is, the square root of the sum of the squares) of (up to) three mutually orthogonal force components together with the resultant (that is, the square root of the sum of the squares) of (up to) three mutually orthogonal torque components.
The resultant vector formed by the three user-defined component forces along the reference marker axes defines the direction of the translational force action. The reaction is equal and opposite to the action.
The resultant vector formed by the three component torques determines the direction of the rotational torque action. The user defines these torques about the reference marker axes. The reaction is equal and opposite to the action.
3. The force or torque is calculated in the coordinate system of the REFERENCE_MARKER. If the RETURN_VALUE_ON_MARKER parameter is set to "i", the value returned is the force or torque acting on the I_MARKER of the force/torque generating element. If RETURN_VALUE_ON_MARKER parameter is set to "j", the value returned is that acting on the J_MARKER. If the REFERENCE_MARKER is not specified the results are with respec to the ground coordinate system.
4. The value for the COMPONENT parameter is one of fm, fx, fy, fz, tm, tx, ty, or tz.
The force or torque is calculated in the coordinate system of the REFERENCE_MARKER. If the RETURN_VALUE_ON_MARKER parameter is set to "i", the value returned is the force or torque acting on the I_MARKER of the force/torque generating element. If RETURN_VALUE_ON_MARKER parameter is set to "j", the value returned is that acting on the J_MARKER. If the REFERENCE_MARKER is not specified the results are with respect to the ground coordinate system.
5. The force or torque is calculated in the coordinate system of the REFERENCE_MARKER. If the REFERENCE_MARKER is not specified the results are with respect to the ground coordinate system.

Cautions:

1. If the REFERENCE_MARKER is not specified the results are with respect to the ground coordinate system.