*PointmassBodyPair()

Creates a point mass body pair entity.

Syntax

*PointmassBodyPair(pmb_name,"pmb_label",[cm_origin],[lprf_origin])

Arguments

pmb_name: The variable name of the point mass body pair.; Data type: varname
pmb_label: The descriptive label of the point mass body pair.; Data type: label
cm_origin: An optional argument for the center of mass for each point mass body of the point mass body pair.; Data type: Point or PointPair
lprf_origin: An optional argument for the local part reference frame for each point mass body of the point mass body pair.; Data type: Point or PointPair

Example

*BeginMDL( model, "The Model" )
 *PointPair( p_3, "Point 3 pair" )
 *PointPair( p_4, "Point 4 pair" )
 *SetPoint( p_3, LEFT, 31, 32, 33 )
 *SetPoint( p_4, LEFT, 34, 35, 36 )
 *PointmassBodyPair( pmb_2, "Point mass body 2", p_3, p_4 )
 *SetPointmassBody( pmb_2, LEFT, 15 )
 *SetPointmassBodyIC( pmb_2, 81, 82, 83, 84, 85, 86 )
 *SetPointmassBodyICFlag( pmb_2, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE )
*EndMDL()

Context

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

Properties

Table 1.
Property	Returns Data Type	Description
auto_color_index	integer	The value of the index representing the color to be used for graphics attached to this entity (unless overridden by the individual graphic).
cg	Point	The point where the center of mass is located.
draw_graphic	boolean	Set to TRUE if the graphic is to be displayed in the model window.
id	integer	Solver input deck ID number.
id_string	string	The ID represented as a string.
label	string	The descriptive label of the point mass body.
lprf	Marker	The local part reference frame of the point mass body.
mass	real	The value of the mass of the point mass body.
material	Material	The material setting that is applied to graphics attached to this body.
note	string	The note on the entity.
num	integer	The unique identification number within MDL.
point_mass	boolean	Always TRUE for this entity.
shade_mode		Can be set to USE_MATERIAL, TRANSPARENT, OPAQUE, or OFF.
state	boolean	Control state (TRUE or FALSE). This parameter is read only and cannot be directly changed by the user (see user_state).
usecm	boolean	Set to TRUE if the center of mass marker is to be used.
uselprf	boolean	Set to TRUE if the local part reference frame is to be used.
use_in_fit	boolean	Set to TRUE if the graphics associated with this entity are to be included when "Fit" is selected.
user_state	boolean	The state that can be set by the user (TRUE or FALSE).
use_vx	boolean	Set to TRUE if the vx initial velocity is to be used.
use_vy	boolean	Set to TRUE if the vy initial velocity is to be used.
use_vz	boolean	Set to TRUE if the vz initial velocity is to be used.
varname	string	The variable name of the user constraint.
vx	real	The initial translational velocity in the x direction relative to ground.
vy	real	The initial translational velocity in the y direction relative to ground.
vz	real	The initial translational velocity in the z direction relative to ground.
wire_mode		Can be set to WIREFRAME, FEATURE_LINES, or FREE_EDGE_LINES.

Comments

A point mass body contains no inertial information.

The individual point mass bodies of a point mass body pair can be referenced as pmb_name.l (left) and pmb_name.r (right).