# Bodies¶

Bodies are basic objects affected by a mass repartition and inertia properties. The position and rotation of the body are represented by a body reference frame fixed to the body. Various external constraints can be applied to a body such as external forces, cables, kinematic links, motors, body constraints…

## Position of the Center of Gravity (COG)¶

Position of the center of gravity is defined in body local coordinate system with respect to the body frame of reference.

External forces and inertia properties can be set directly at the COG position or at an arbitrary position. In this last case, transport formula are used to express such quantities at COG.

## Mass and inertia¶

The mass \(m\) and inertial quantities \(\mathbf{I}_G\) of the body are defined using an inertia tensor at the center of gravity, denoted \(G\).

In case the inertia matrix is not defined at \(G\) but in an other point \(M\) of the body, the generalized Huygens theorem is used to express the inertia matrix on an other point:

with:

where \(\mathbf{MG} = [a, b, c]\).

## External forces¶

The external forces represent the forces and moments applied on the body. They can be applied at any arbitrary point \(P\) on the body. By convenient, they are represented by a force tensor :

where \(\mathbf{F}\) and \(\mathbf{M}_P\) are respectively the force and moment applied on the body at position \(P\).

To compute the equivalent force tensor at COG, the transport equation is applied on the moment as follows :

## Degrees of freedom (DOFMask)¶

By default, bodies are free to move in the six degrees of freedom, corresponding to the three translations and three rotations. However, some of these degrees of freedom can be fixed by the user in the world reference frame, by adding constraints.

Note

All degrees of freedom are solved even those fixed by constraints.

## Nodes¶

Nodes are specific frames, added to the body and fixed in the body reference frame. Their position and rotation, defined in the body reference frame, remain fixed with respect to this one during the simulation. They can be used to add links, cables or actuators to the body at a given position. Also, they can be used to monitor a specific quantity on the body.

Note

Like frames, translations and rotations can be applied on nodes.