# Six degree-of-freedom motion¶

In many applications, the influence of flow on position and orientation of a rigid body is of interest. This requires allowing complete freedom to translate and rotate for the body. The six degree-of-freedom motion (6DoF) on the SimScale platform provides such functionality, making a major family of industrial and scientific simulations available for users.

Here is a detailed guide to defining the parameters for the 6DoF solid body motion.

## Creating a new solid body motion option¶

1. In your simulation, click on Advanced Concepts.
2. Click on Add solid body motion. A new solid body motion definition is created.
3. If need be, give the definition an appropriate name.
4. Type by default is set to Axis Rotation Motion. Change it to Six degrees-of-freedom motion.

## Setting parameters¶

### Basic paramters¶

The following set of basic settings is required to determine the physical characteristics of the rigid body:

1. Inner Morphing Distance ($$m$$): In many cases, it is important that the quality of the mesh near the surface of the body be preserved, e.g. for turbulence models. Since the 6DoF solver deforms the mesh around the body, this distance can be used to specify the distance from the body below which no cell deformation is allowed.
2. Outer Morphing Distance ($$m$$): Similarly, this distance specifies the extent of the mesh-morphing region around the body.
3. Center of Mass ($$m$$): Specifies the coordinates of the center of mass of the object. Note that the coordinates need to be specified in the global coordinate system (i.e., that of the entire flow domain).
4. Mass ($$kg$$): Specify the mass of the rigid body.
5. Moment of Inertia ($$kg.m^2$$): Specify the moment of inertia of the body in the $$x$$, $$y$$ and $$z$$ direction. (rotational equivalent of the mass). See here for the moments of inertia of some simple shapes.
6. Density: Provide the density of the reference fluid. Provide a value only for the incompressible case - for other cases, the value is picked automatically.
7. Gravity ($$m.s^{-2}$$): Provide the (signed) value of gravity in the $$x$$, $$y$$ and $$z$$ direction.
8. Initial Motion State: This setting allows you to specify the initial state of motion for the rigid body. The default state is Stationary, but one can also prescribe initial values for orientation, velocity, acceleration, angular momentum and torque. The orientation is specified in terms of a Rotation matrix.
9. Acceleration Relaxation Coefficient (-): This factor relaxes the acceleration computed in the previous timestep. It can be used to stabilize transient simulations.
10. Acceleration Damping Coefficient (-): This factor dampens the rigid-body’s acceleration in steady-state simulations.
11. Report : Specify if the motion data needs to be reported in the solver log during the simulation.

### Motion constraints¶

It is possible to constrain the motion of the rigid body to certain translations and rotations. The following setting show how such constraints could be defined:

1. Translation Constraint:
1. No Constraint: The body is free to move in any direction.
2. Point: The body is fixed to a reference point.
3. Line: Motion of the body is restricted along the specified line.
4. Plane: Motion of the body is restricted in a plane. The plane is specified by its normal vector.
2. Rotation Constraint:
1. No Constraint: The body is free to rotate.
2. Fixed Orientation: No rotation is allowed. The body translates in a fixed orientation.
3. Axis: The body is only allowed to rotate about a fixed axis.

### Motion restraints¶

Additionally, the motion of the rigid body could be restrained using physical components such as springs and dampers:

1. Linear Spring Restraint: Specify if there exists a linear spring restraint on the body’s motion.
• Fixed Anchor Point ($$m$$): The point at which one end of the spring is fixed in space.
• Attachment Point to Body ($$m$$): The point on the body at which the other end of the spring is attached.
• Stiffness Coefficient ($$Nm^{-1}$$): Stiffness coefficient of the spring.
• Damping Coefficient ($$Ns.m^{-1}$$): Damping coefficient of the spring.
• Rest Length ($$m$$): Rest length of the spring.
2. Linear Damper Restraint: Specify if a linear damping restraint needs to be applied on the body’s motion.
• Damping Coefficient ($$Ns.m^{-1}$$): Specify the damping coefficient.
3. Linear Axial Angular Spring Restraint: Specify if an axial angular restraint on the body’s motion.
• Reference Orientation: Orientation matrix for the rigid body. Equivalent to the rest length of a linear spring.
• Spring Axis: Axis about the angular spring works.
• Stiffness Coefficient ($$Nm^{-1}$$): Stiffness coefficient of the spring.
• Damping Coefficient ($$Ns.m^{-1}$$): Damping coefficient of the spring.
4. Angular Damper: Specify if a angular damping restraint needs to be applied on the body’s motion.
• Damping Coefficient ($$Ns.m^{-1}$$): Specify the damping coefficient.