> 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/rt-lab/example-models/ehs-example-models/sps-software-example-models/saturable-transformer-op4510-op5707.md).

# Saturable Transformer - OP4510 - OP5707

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

The **Saturable Transformer** model illustrates the use of the saturable transformer and eHS solver to compute the transformer flux during energization of a transformer. When SW01 is closed, voltage is applied to the transformer. Voltages before and after the SW01 can be observed, as well as voltage on the secondary of the transformer. Transformer flux is observed in the CPU model by integrating the secondary voltage of the transformer. Distortion in the sinusoidal wave form shows the saturation effect. By closing SW01 a different time, transformer flux, and its saturation will vary.

## Requirements <a href="#requirements" id="requirements"></a>

The **RT-LAB**, **SPS Software** and **eFPGASIM toolboxes** must be installed on the host and target computers to run this example model properly. Please refer to the product documentation for details on version compatibility.

The eHS solver requires an FPGA-based hardware board. This board will be configured with the attached binary file automatically when the model is loaded in the RT-LAB interface. This model uses an OP4510 as its active carrier board.

## Simulation and results

### Setup and connections <a href="#setup-and-connections" id="setup-and-connections"></a>

This model does not require any IOs, as it is more a demonstrator of the expected results

### Run the model

To run the example, follow the procedure below:

1. If eFPGASIM is installed, add the example project to RT-LAB by selecting **File>>New>>RT-LAB Project>>eFPGASIM>>SimPowerSystems\_Workflow>>Saturable Transformer**.
2. Compile the RT Model by clicking on **Build** in RT-LAB.

#### eHS model <a href="#ehs-model" id="ehs-model"></a>

The eHS model is used to configure the eHS solver, but also the saturable transformer module. In the console, SW01 can change state by flipping the Manual switch block.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-9d4a0dfffa50b2284431b9f840dd9c69061fad35%2Fehs-model-sps-sattransfo-1.png?alt=media" alt=""><figcaption></figcaption></figure>

#### RT-Lab model <a href="#rt-lab-model" id="rt-lab-model"></a>

The **SM\_Controller\_eHS\_IOs subsystem** is used to send the configuration to the eHS solver, and to allow the user to interact with the model. Voltage on the secondary side of the transformer is integrated before being sent to the console subsystem.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-33f4ceed81e9a3dde27d322d00db90512f95c13b%2Fehs-model-sps-sattransfo-2.png?alt=media" alt=""><figcaption></figcaption></figure>

The **SC\_Console subsystem** is used to control SW01 and the amplitude of the voltage source. It also allows monitoring results at the CPU timestep using Acq 1.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-687dd455c6b0da317bef7780fe1c60760d0a628a%2Fehs-model-sps-sattransfo-3.png?alt=media" alt=""><figcaption></figcaption></figure>

SW01 is closed at 0.033 seconds. The yellow curve shows the transformer flux saturating. The purple curve shows when SW01 is closed.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-fc2090964dcc0c9037302c5d644b2daa4bd3c1d1%2Fehs-model-sps-sattransfo-4.png?alt=media" alt=""><figcaption></figcaption></figure>


---

# 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/rt-lab/example-models/ehs-example-models/sps-software-example-models/saturable-transformer-op4510-op5707.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.
