# Rotational Damper

Faultable linear rotational damper

• Library:
• Simscape / Driveline / Couplings & Drives

Simscape / Foundation Library / Mechanical

Simscape / Foundation Library / Mechanical / Rotational Elements

## Description

The Rotational Damper block models a faultable linear rotational viscous damper. From the start of the simulation, the block uses the nominal damping coefficient. If you enable faults for the block, the damping coefficient changes in response to one or both of these triggers:

• Simulation time — A fault occurs at a specified time.

• Simulation behavior — If the magnitude of the rotational acceleration exceeds a specified maximum value, the block increments the number of shocks by one. A fault occurs if the number of shocks exceeds a specified maximum number of shocks.

If a fault trigger event occurs, the block uses the faulted damping coefficient for the remainder of the simulation. You can program the block to issue a fault report as a warning or error message.

The defining equations are

`$T=D\omega$`

and

`$\omega ={\omega }_{R}-{\omega }_{C},$`

where

• T is the torque transmitted through the damper.

• D is the damping (viscous friction) coefficient.

• ω is the relative velocity.

• ωR and ωC are the absolute velocities of terminals R and C, respectively.

The positive block direction is from port R to port C. Therefore, the torque is positive if it acts in the direction from R to C.

## Ports

### Conserving

expand all

Mechanical rotational conserving port associated with the rod interface.

Mechanical rotational conserving port associated with the case interface.

## Parameters

expand all

Main

The oscillation-reducing torque due to viscous friction that the block applies if no trigger event occurs. Specify a value that is greater than or equal to zero.

Faults

To enable the block to use a different damping coefficient based on the simulation time or when the magnitude of the rotational acceleration exceeds the specified number of shocks, select `On`.

#### Dependencies

Selecting `On` makes these parameters visible:

• Faulted damping coefficient

• Enable temporal fault trigger

• Enable behavioral fault trigger

• Reporting when fault occurs

The oscillation-reducing torque due to viscous friction that the block applies if a trigger event occurs. Specify a value that is greater than or equal to zero.

#### Dependencies

This parameter is only visible if you select `On` for the Enable faults parameter.

To enable the block to use the faulted damping coefficient starting at a specified time in the simulation, select `On`.

#### Dependencies

This parameter is only visible if you select `On` for the Enable faults parameter.

Selecting `On` makes the Simulation time for fault event parameter visible.

Specify the time during the simulation that you want the block to start using the faulted damping coefficient.

#### Dependencies

This parameter is only visible if you select `On` for the Enable faults parameter and `On` for the Enable temporal fault trigger parameter.

To use the faulted damping coefficient when the number of sustained shocks exceeds a specified maximum number of shocks, select `On`.

#### Dependencies

This parameter is only visible if you select `On` for the Enable faults parameter.

Selecting `On` makes these parameters visible:

• Maximum permissible acceleration

• Maximum number of shocks

The maximum value that the magnitude of the rotational acceleration can reach without causing the block to increment the number of sustained shocks.

#### Dependencies

This parameter is only visible if you select `On` for the Enable faults parameter and `On` for the Enable behavioral fault trigger parameter.

The maximum number of shocks that can be sustained without triggering the block to use the faulted damping coefficient.

#### Dependencies

This parameter is only visible if you select `On` for the Enable faults parameter and `On` for the Enable behavioral fault trigger parameter.

Select your reporting preference for the fault condition.

#### Dependencies

This parameter is only visible if you select `On` for the Enable faults parameter.