> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/shafts-and-speed-reducers/mechanical-shaft.md).

# Mechanical Shaft

### Description <a href="#description" id="description"></a>

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-74eb9a3cdb007e1ce8ff7403a115675ac905e47f%2Fshaft_block.png?alt=media" alt=""><figcaption></figcaption></figure>

The Mechanical Shaft block, located in the **OPAL-RT SPS Software/Electrical Machines/Control/Shafts and Speed Reducers** library, outputs the transmitted torque through the shaft regarding the speed difference between the driving side and the loaded side of the shaft.

The transmitted torque *T*<sub>*l*</sub> is given by the following equation:

$$
T\_l = K \int \left( \omega\_m - \omega\_l \right), dt + B \left( \omega\_m - \omega\_l \right)\\\[8pt]
$$

where *K* (N.m) is the shaft stiffness, *B* (N.m.s) is the internal damping, and *ω*<sub>*m*</sub> and *ω*<sub>*l*</sub> are the speeds (rad/s) of the driving side and the loaded side, respectively. The following figure shows the internal schematic of the model. In this model the speeds are converted from rpm to rad/s.

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-e22847b2c8f523caa838eedb95a29282a3cc31d5%2Fshaft_mechanical_model_schem.png?alt=media" alt=""><figcaption><p><strong>Mechanical Shaft Model Schematic</strong></p></figcaption></figure>

The stiffness is defined as

$$
K=\frac{T}{\theta}
$$

where $$T$$ is the torsional torque applied to the shaft and *θ* the resulting angular deflection (rad).

The stiffness can also be determined by

$$
K\frac{GJ}{l}
$$

where $$G$$ is the shear modulus, $$J$$ the polar moment of inertia, and $$l$$ the length of the shaft.

For steel, the shear modulus *G* is usually equal to about 80 GPa, and the polar moment of inertia *J* of a shaft with a circular section of diameter D is given by

$$
J=\frac{\pi D^4}{32}
$$

Mechanical shafts have very small angular deflections to avoid bearing problems. As an example, the following table gives the corresponding stiffness for angular deflections of 0.1 degrees at maximum torque with respect to the power and speed of electrical motors connected to the driving end of the shaft. The maximum torque is here assumed to be 1.5 times bigger than the nominal torque.

**Shaft Stiffness K**

| **P (HP)** | **N (rpm)** | **T (N.m)** | **Tmax (N.m) (=1.5 T)** | **K (N.m)** |
| ---------- | ----------- | ----------- | ----------------------- | ----------- |
| 5          | 1750        | 20          | 30                      | 17190       |
| 200        | 1750        | 815         | 1223                    | 700730      |
| 200        | 1200        | 1190        | 1785                    | 1022730     |

The damping factor *B* represents internal friction. This factor increases with the shaft stiffness. As an example, the following table gives some values of *B* for the stiffness of the preceding table.

**Shaft Internal Damping B**

| **K (N.m)** | **B (N.m.s)** |
| ----------- | ------------- |
| 17190       | 600           |
| 700730      | 24460         |
| 1022730     | 35700         |

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-e77dcbe1bd9f23c4aa8ab34e408a42c94401ba2a%2Fshaft_simulink_schem.png?alt=media" alt=""><figcaption><p>Simulimk schematic</p></figcaption></figure>

The stiffness must be high enough to avoid large angular deflections that could cause misalignment inside the bearings and damage.

For proper simulation results, the internal damping must be high enough to avoid undesired transient speed and torque oscillations.

The model is discrete. Good simulation results have been obtained with a 10-µs time step.

### Model Specifications <a href="#model-specifications" id="model-specifications"></a>

The library contains three preset models. The nominal torques of these mechanical shaft models are shown in the following table:

**Preset Mechanical Shaft Models**

|                      | **1st** | **2nd** | **3rd** |
| -------------------- | ------- | ------- | ------- |
| Nominal torque (N.m) | 20      | 815     | 1190    |

The preset models have been designed in order to present 0.1 degrees of angular deflection at maximum torque (supposed to be 1.5 times the nominal torque).

## Parameters <a href="#parameters" id="parameters"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Preset model</strong></td><td>This pop-up menu allows you to choose preset model parameters. When you select a preset model, the other block parameters become inaccessible. Default is No.</td></tr><tr><td><strong>Stiffness</strong></td><td>The stiffness of the shaft (N.m). Default is 17190.</td></tr><tr><td><strong>Damping</strong></td><td>The internal damping of the shaft (N.m.s). Default is 600.</td></tr></tbody></table>

## Inputs <a href="#inputs" id="inputs"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Nm</strong></td><td>Speed (rpm) of the driving end of the shaft.</td></tr><tr><td><strong>Nl</strong></td><td>Speed (rpm) of the load connected to the second end of the shaft.</td></tr></tbody></table>

## Outputs <a href="#outputs" id="outputs"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Tl</strong></td><td>Torque transmitted from the driving end of the shaft to the load.</td></tr></tbody></table>

### Examples <a href="#examples" id="examples"></a>

The [Mechanical Shaft Example](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/motor-drives/mechanical-shaft.md) (shaft\_example) illustrates the mechanical shaft model.

### References <a href="#references" id="references"></a>

\[1] Norton, Robert L., **Machine Design**, Prentice Hall, 1998.

\[2] Nise, Norman S., **Control Systems Engineering**, Addison-Wesley Publishing Company, 1995.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/shafts-and-speed-reducers/mechanical-shaft.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
