> 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/example-models/machines/synchronous-machine.md).

# Synchronous Machine

This example shows the use of the Machine Initialization tool of Powergui to initialize machine currents.

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

## Description

A three-phase generator rated 200 MVA, 13.8 kV, 112.5 rpm is connected to a 230 kV, 10,000 MVA network through a Delta-Wye 210 MVA transformer. At t = 0.1 s, a three-phase to ground fault occurs on the 230 kV bus. The fault is cleared after 6 cycles (t = 0.2 s).

## Simulation

1. Open the Powergui and select 'Machine Initialization'. A new window appears. The machine 'Bus type' is initialized as 'PV generator', indicating that the initialization is performed with the machine controlling the active power and its terminal voltage. The desired terminal voltage parameter is set to 13800 and the active Power to 150e6.\
   Press the 'Compute and Apply' button. The phasors of AB and BC machine voltages as well as the currents flowing out of phases A and B are updated. The machine reactive power, mechanical power and field voltage requested to supply the electrical power is also be displayed: Q = 3.4 Mvar; Pmec = 150.32 MW (0.7516 pu); field voltage Ef = 1.291 pu.
2. In order to start the simulation in steady state with the HTG and excitation system connected, these two blocks are initialized according to the values calculated by the Machine Initialization tool. This initialization is automatically performed as long as you connect at the Pm and Vf inputs of the machine either Constant blocks or regulation blocks from the machine library (HTG, STG, or Excitation System). Open the HTG block menu and note that the initial mechanical power was set to 0.7516 pu (150.32 MW) by the tool. Open the Excitation System block menu and note that the initial terminal voltage and field voltage have been set respectively to 1.0 and 1.29071 pu.
3. Open the 4 scopes and restart the simulation. Observe that the terminal voltage Va is 1.0 p.u. at the beginning of the simulation. It falls to about 0.4 pu during the fault and returns to nominal quickly after the fault is cleared. This quick response in terminal voltage is due to the fact that the Excitation System output Vf can go as high as 11.5 pu which it does during the fault. The speed of the machine increases to 1.01 pu during the fault then it oscillates around 1 p.u. as the governor system regulates it. The speed takes much longer than the terminal voltage to stabilize mainly because the rate of valve opening/closing in the governor system is limited to 0.1 pu/s.

## Command

Example model name: power\_turbine

{% code lineNumbers="true" %}

```matlab
open('power_turbine')
```

{% endcode %}


---

# 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/example-models/machines/synchronous-machine.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.
