*InplaneJointPair() - inplane joints (normal)

Creates an inplane joint pair specifying a normal to the plane.

Syntax

*InplaneJointPair(joint_name,"joint_label",body_1, body_2, origin, NORMAL, POINT|VECTOR, point|vector)

Arguments

joint_name
The variable name of the inplane joint pair.
Data type: varname
joint_label
The descriptive label of the inplane joint pair.
Data type: label
body_1
The first body or body pair constrained by the inplane joint pair.
Data type: Body or BodyPair
body_2
The second body or body pair constrained by the inplane joint pair.
Data type: Body or BodyPair
origin
The location(s) of the inplane joint pair for body_1.
Data type: Point or PointPair
NORMAL
A required argument when a point, point pair, vector, or vector pair is used to define normals to the planes of the joint pair.
POINT|VECTOR
A keyword that indicates the alignment method.
point|vector
An entity variable referring to a Point, PointPair, Vector, or VectorPair which is based on the above keyword.
Data type: Point, PointPair, Vector, or VectorPair

Example

*BodyPair(b_wheel,         "Wheel",         p_wheel_cm)
*BodyPair(b_kn,            "Knuckle joint", p_kn_cm)
*PointPair(p_wc,           "Wheel center")
*Vector(v_Z,               "Global Z")
*InplaneJointPair(jt_name, "WC inplane", b_wheel, 
                                         b_kn, 
                                         p_wc, 
                                         NORMAL, 
                                         VECTOR, 
                                         v_Z)

Context

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

Properties

Table 1.
Property Returns Data Type Description
b1 BodyPair The first body pair constrained by the inplane joint pair.
b2 BodyPair The second body pair constrained by the inplane joint pair.
i MarkerPair The marker attached to b1.
j MarkerPair The marker attached to b2.
l InplaneJoint Left inplane joint.
label string The descriptive label of the inplane joint pair.
r InplaneJoint Right inplane joint.
state boolean Control state (TRUE or FALSE).
varname string The variable name of the inplane joint pair.

Comments

The individual joints of a *InplaneJointPair() can be referred to as joint_name.l (left inplane joint) and joint_name.r (right inplane joint).

An inplane joint constrains the relative motion of markers, i and j, to a plane. This plane may be defined by either specifying a normal to the plane (using the NORMAL flag for the sixth argument) or specifying three points (or vectors) lying in the plane (using the INPLANE flag for the sixth argument).

When a point is used (instead of a vector) to define an axis, it is obtained as the direction from the origin of the joint to the specified point.