Subroutine Type

Utility/Data Access

Definition

Returns mass data for one set of bodies minus another set of bodies.

Use

The function can be called by any user-defined subroutine.

Calling Syntax

Fortran

CALL SUBTRACT_MASS_PROPERTY(cm1, mass1, ip1, cm2, mass2, ip2)

C

c_subtract_mass_property(cm1, mass1, ip1, cm2, mass2, ip2)

Python

[cm, mass, ip] = py_subtract_mass_property(cm1, mass1, ip1, cm2, mass2, ip2)

MATLAB

[cm, mass, ip] = m_subtract_mass_property(cm1, mass1, ip1, cm2, mass2, ip2)

Input Arguments

[double] cm1

A double precision array of length three containing the x, y, and z coordinates of one body or a set of bodies.

[double] mass1

A double precision number representing the mass of one body or a set of bodies.

[double] ip1

A double precision array of length six containing the six inertia tensors (Ixx, Iyy, Izz, Ixy, Ixz, Iyz) for one body or a set of bodies, expressed in a reference marker located at the body center of mass and oriented parallel to the global frame.

[double] cm2

A double precision array of length three containing the x, y, and z coordinates of the second body or a set of bodies.

[double] mass2

A double precision number representing the mass of the second body or a set of bodies.

[double] ip2

A double precision array of length six containing the six inertia tensors (Ixx, Iyy, Izz, Ixy, Ixz, Iyz) for the second body or a set of bodies, expressed in a reference marker located at the body center of mass and oriented parallel to the global frame.

Output Values

[double] cm2

C/Fortran Only: A double precision array of length three containing the x, y, and z coordinates of the second set of bodies minus the first set of bodies.

[double] mass2

C/Fortran Only: A double precision number representing the mass of the second set of bodies minus the first set of bodies.

[double] ip2

C/Fortran Only:A double precision array of length six containing the six inertia tensors (Ixx, Iyy, Izz, Ixy, Ixz, Iyz) of the second set of bodies minus the first set of bodies, expressed in a reference marker located at the body center of mass and oriented parallel to the global frame.

[double] cm

Python, Matlab only: A double precision array of length three containing the x, y, and z coordinates of the second set of bodies minus the first set of bodies.

[double] mass

Python, Matlab only: A double precision number representing the mass of the second set of bodies minus the first set of bodies.

[double] ip

Python, Matlab only: A double precision array of length six containing the six inertia tensors (Ixx, Iyy, Izz, Ixy, Ixz, Iyz) of the second set of bodies minus the first set of bodies, expressed in a reference marker located at the body center of mass and oriented parallel to the global frame.