*PointPair()

Creates a point pair.

Syntax

*PointPair(point_name,"point_label",[point_num_1], [point_num_2])

Arguments

point_name: The variable name of the point pair.; Data type: varname
point_label: The descriptive label of the point pair.; Data type: label
point_num_1 point_num_2: Optional integer arguments assigned to the left and right points of the point pair as their entity numbers.; Data type: integer

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, 
                                         v_Z)
*SetPoint(p_wc, , 10, -210, 130, 0, 0, 30)

Context

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

Properties

Table 1.
Property	Returns Data Type	Description
l	Point	Left point.
label	string	The descriptive label of the point pair.
r	Point	Right point.
state	boolean	Indicates whether or not the entity is active. Returns TRUE or FALSE. The entity state is controlled using the *SetState() command.
varname	string	The variable name of the point pair.

Comments

If no point_num_2 appears in the argument list, the value of point_num_1 is applied to both points of the point pair.

The individual points of a *PointPair()can be referred to as point_name.l (left point) and point_name.r (right point).

The values of the coordinates are set in the *SetPoint() statement.

When the entity number is not specified, one is assigned to the point by the pre-processor. The entity number may be used in ID schemes for generating IDs for other entities, such as bushings and joints.