All Frameworks  Object Hierarchy  This Framework  Indexes

Inertia (Object)

Represents the Inertia object.
The Inertia object can be associated with any relevant object of a document in order to get or compute its inertia data. It takes into account all bodies of a part.

This version allows you to compute the following data:

of a product.

The units are:

The method GetTechnologicalObject("Inertia") on the product to analyze, allows you to retrieve this object.

Property Index

Density
Returns or sets the density for the computation.
Mass
Returns the mass.

Method Index

GetCOGPosition
Retrieves the position of the center of gravity.
GetInertiaMatrix
Retrieves the matrix of inertia.
GetPrincipalAxes
Retrieves the the principal axes of inertia.
GetPrincipalMoments
Retrieves the principal moments of inertia.

Properties


o Property Density() As
Returns or sets the density for the computation.

The density value is set to:

  • 0: the computation must use densities attached to each object.
  • any positive value: the computation has to use this value.

The density value is returned as:

  • 1: a default value is used (there is no density attached to objects).
  • -1: the density is not homogeneous for each object.
  • other positive values: the density attached to all objects.
Example:
The first example gets the density of NewInertia inertia. 
    Dim ADensity As double
    ADensity = NewInertia.Density
The second example sets the density of NewInertia inertia. 
    NewInertia.Density = 10.
o Property Mass() As (Read Only)
Returns the mass.
Example:
This example retrieves the mass of NewInertia inertia. 
    Dim AMass As double
    AMass = NewInertia.Mass

Methods


o Sub GetCOGPosition( oCoordinates)
Retrieves the position of the center of gravity.
Parameters:
oCoordinates
The position of the center of gravity with respect to the product coordinate system:
  • oCoordinates(0) is the X coordinate
  • oCoordinates(1) is the Y coordinate
  • oCoordinates(2) is the Z coordinate
Example:
This example retrieves the position of the center of gravity of NewInertia inertia. 
    Dim Coordinates (2)
    NewInertia.GetCOGPosition Coordinates
o Sub GetInertiaMatrix( oMatrix)
Retrieves the matrix of inertia.
Parameters:
oMatrix
The matrix of inertia array:
  • oMatrix(0) is the Ixx component
  • oMatrix(1) is the Ixy component
  • oMatrix(2) is the Ixz component
  • oMatrix(3) is the Iyx component
  • oMatrix(4) is the Iyy component
  • oMatrix(5) is the Iyz component
  • oMatrix(6) is the Izx component
  • oMatrix(7) is the Izy component
  • oMatrix(8) is the Izz component
Example:
This example retrieves the matrix of inertia of NewInertia inertia. 
    Dim Matrix (8)
    NewInertia.GetInertiaMatrix Matrix
o Sub GetPrincipalAxes( oComponents)
Retrieves the the principal axes of inertia.
Parameters:
oComponents
The principal axes of inertia array (A1, A2 and A3 are the principal axes of inertia):
  • oComponents(0) is the A1x component
  • oComponents(1) is the A2x component
  • oComponents(2) is the A3x component
  • oComponents(3) is the A1y component
  • oComponents(4) is the A2y component
  • oComponents(5) is the A3y component
  • oComponents(6) is the A1z component
  • oComponents(7) is the A2z component
  • oComponents(8) is the A3z component
Example:
This example retrieves the principal axes of inertia of NewInertia inertia. 
    Dim Components (8)
    NewInertia.GetPrincipalAxes Components
o Sub GetPrincipalMoments( oValues)
Retrieves the principal moments of inertia.
Parameters:
oValues
The principal moments of inertia array:
  • oValues(0) is the M1 value with respect to the first principal exes of inertia
  • oValues(1) is the M2 value with respect to the second principal exes of inertia
  • oValues(2) is the M3 value with respect to the third principal exes of inertia
Example:
This example retrieves principal moments of inertia of NewInertia inertia. 
    Dim Values (2)
    NewInertia.GetPrincipalMoments Values

Copyright © 2003, Dassault Systèmes. All rights reserved.