GetPhysicalProperties Method

Description

Returns the current physical properties of the referenced object.

Syntax

Visual Basic
Public Sub GetPhysicalProperties( _ ByRef Status As Integer, _ ByRef Volume As Double, _ ByRef Area As Double, _ ByRef Mass As Double, _ ByRef CenterOfGravity() As Double, _ ByRef CenterOfVolume() As Double, _ ByRef GlobalMomentsOfInteria() As Double, _ ByRef PrincipalMomentsOfInteria() As Double, _ ByRef PrincipalAxes() As Double, _ ByRef RadiiOfGyration() As Double, _ ByRef RelativeAccuracyAchieved As Double _ )

Visual Basic

Public Sub GetPhysicalProperties( _
   ByRef Status As Integer, _
   ByRef Volume As Double, _
   ByRef Area As Double, _
   ByRef Mass As Double, _
   ByRef CenterOfGravity() As Double, _
   ByRef CenterOfVolume() As Double, _
   ByRef GlobalMomentsOfInteria() As Double, _
   ByRef PrincipalMomentsOfInteria() As Double, _
   ByRef PrincipalAxes() As Double, _
   ByRef RadiiOfGyration() As Double, _
   ByRef RelativeAccuracyAchieved As Double _
)

Parameters

Status: Returns the status of the physical properties of the model. The physical properties can be non-existent, out-of-date, or up-to-date.
Volume: Returns the volume of the model.
Area: Returns the surface area of the model.
Mass: Returns the mass of the model.
CenterOfGravity: Returns three values that specify the x, y, and z coordinates of the center of gravity of the model.
CenterOfVolume: Returns three values that specify the x, y, and z coordinates of the center of volume of the model.
GlobalMomentsOfInteria: Returns six values that specify the Ixx, Iyy, Izz, Ixy, Ixz, and Iyz components of the global moments of inertia.
PrincipalMomentsOfInteria: Returns three values that specify the Ixx, Iyy, and Izz components of the principle moments of inertia.
PrincipalAxes: Returns nine values that specify the orientation of the principle axes.
RadiiOfGyration: Returns three values that specify the radii of gyration.
RelativeAccuracyAchieved: Returns the actual accuracy achieved when calculating the physical properties. The accuracy parameter specifies the maximum accuracy, but depending on the geometry of the model, the physical properties can be calculated more accurately.

Remarks

The properties returned are the current properties stored with the model, which means they can be not computed yet, out-of-date, or up-to-date. To calculate properties for the first time or to update the properties use the ComputePhysicalProperties method. Properties must not be user-overridden. To determine whether physical properties status, use the PhysicalPropertiesStatus property.