> 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/hypersim/library-blocks-reference/control-governors/ieee-ggov1.md).

# IEEE GGOV1

## Description

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-21c67ae87f94cc69111c4099d1294f5eb3514e95%2Fimage%20(862).png?alt=media" alt=""><figcaption></figcaption></figure>

The **IEEE GGOV1** block, located in the **Control Governors** library, is a natural gas turbine-governor dynamic model. It was initially developed for GE heavy frame machines and is also used to represent turbine-governor models from other manufacturers. The component follows reference.

The implementation depends on the values of Kpgov and Kpload.

* When **Kpgov and Kpload are equal to 0**:

  * If Kpgov = 0, the integrator Kigov/s is placed in parallel with the derivative controller Kdgov/Tdgov.
  * If Kpload = 0, the integrator Kiload/s is fed by the input to Kpload and outputs to Fsrt.

  <figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-a3ddb0fd11e1078e59e6c7788a2e855876a1e2bb%2Fimage%20(774).png?alt=media" alt="" width="563"><figcaption><p>Implementation of GGOV1 when Kpgov and Kpload are equal to 0</p></figcaption></figure>
* When **Kpgov and Kpload are different from 0**, the configuration with proportional-integral-derivative (PID) controllers is used.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-27bb52577d28d1f001f531616d8dba96e6117c22%2Fimage%20(775).png?alt=media" alt="" width="563"><figcaption><p>Implementation of GGOV1 when Kpgov and Kpload are different than 0</p></figcaption></figure>

An additional equation computes the load reference (Lref) based on the control configuration (Rselect) and temperature effects. The equations used for Lref are:

<table><thead><tr><th width="165">Configuration</th><th>Load reference</th></tr></thead><tbody><tr><td><strong>Rselect=1</strong></td><td>Lref=w_ic+R*0</td></tr><tr><td><strong>Rselect=2</strong></td><td>Lref=w_ic+wf_ic*R= w_ic +(Pm_IC/Kturb)+Wfnl</td></tr><tr><td><strong>Rselect=3</strong></td><td>Lref=w_ic+wf_ic*R= w_ic +(Pm_IC/Kturb)+Wfnl</td></tr><tr><td><strong>Rselect=4</strong></td><td>Lref=w_ic+wf_ic<em>R= w_ic +Pelec_IC</em>R</td></tr></tbody></table>

The load reference Lref is summed with Pref (Lref + Pref). Pref represents a variation in HS, while Lref is computed internally. In PSS<sup>®</sup>E, Lref is obtained at initialization from the governor parameters and load-flow results (see the table above).

{% hint style="info" %}
The HYPERSIM<sup>®</sup> simulation option Set Initial Conditions must be checked for the automatic initialization to work properly.
{% endhint %}

## Mask parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-95662208bf9c1c9d99bd022f112b69b7d5b655ad%2FGGOV1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="GGOV1" %}

<table><thead><tr><th width="200">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Rselet</strong></td><td>Control selection:<br>1 none (isochronous governor)<br>2 governor output (requested stroke)<br>3 fuel valve stroke (true stroke)<br>4 electrical power</td></tr><tr><td><strong>R</strong></td><td>Permanent droop (pu) Default: 0.04</td></tr><tr><td><strong>maxerr</strong></td><td>Maximum speed error signal (pu) Default: 0.05</td></tr><tr><td><strong>minerr</strong></td><td>Minimum speed error signal (pu) Default: -0.05</td></tr><tr><td>db</td><td>Deadband (pu) Default: 0</td></tr><tr><td><strong>Kpgov</strong></td><td>Governor proportional gain Default: 10</td></tr><tr><td><strong>Kigov</strong></td><td>Governor integral gain Default: 2</td></tr><tr><td><strong>Kdgov</strong></td><td>Governor derivative gain Default: 0</td></tr><tr><td><strong>Tdgov</strong></td><td>Governor derivative controller time constant (s) Default: 1</td></tr><tr><td><strong>Tpelec</strong></td><td>Electrical power transducer time constant (s) Default: 1</td></tr><tr><td><strong>Aset</strong></td><td>Acceleration limiter setpoint (pu/s) Default: 0.01</td></tr><tr><td><strong>Ka</strong></td><td>Acceleration limiter gain Default: 10</td></tr><tr><td><strong>Ta</strong></td><td>Acceleration limiter time constant (s) Default: 1</td></tr><tr><td><strong>Pmwset</strong></td><td>Power controller setpoint (pu)</td></tr><tr><td><strong>Kimw</strong></td><td>Power controller (reset) gain Default: 0.01</td></tr><tr><td><strong>Ldref</strong></td><td>Load limiter reference value (pu) Default: 1</td></tr><tr><td><strong>Kpload</strong></td><td>Load limiter proportional gain for PI controller Default: 2</td></tr><tr><td><strong>Kiload</strong></td><td>Load limiter integral gain for PI controller Default: 0.67</td></tr><tr><td><strong>Tfload</strong></td><td>Load limiter time constant (s) Default: 3</td></tr><tr><td><strong>Tsa</strong></td><td>Temperature detection lead time constant (s) Default: 4</td></tr><tr><td><strong>Tsb</strong></td><td>Temperature detection lag time constant (s) Default: 5</td></tr><tr><td><strong>Flag</strong></td><td>Fuel flow dependency:<br>0 fuel flow proportional to speed<br>1 fuel flow independent of speed</td></tr><tr><td><strong>Dm</strong></td><td>Mechanical damping coefficient (pu) Default: 0</td></tr><tr><td><strong>Tact</strong></td><td>Actuator time constant (s) Default: 0.5</td></tr><tr><td><strong>Vmax</strong></td><td>Maximum valve position limit (pu) Default: 1</td></tr><tr><td><strong>Vmin</strong></td><td>Minimum valve position limit (pu) Default: 0.1</td></tr><tr><td><strong>rclose</strong></td><td>Maximum valve closing rate (pu/s) Default: -0.1</td></tr><tr><td><strong>ropen</strong></td><td>Maximum valve opening rate (pu/s) Default: 0.1</td></tr><tr><td><strong>Tb</strong></td><td>Turbine lag time constant (s) Default: 0.1</td></tr><tr><td><strong>Tc</strong></td><td>Turbine lead time constant (s) Default: 0</td></tr><tr><td><strong>Kturb</strong></td><td>Turbine gain Default: 1.5</td></tr><tr><td><strong>Teng</strong></td><td>Transport lag time constant for diesel engine (s) Default: 0</td></tr><tr><td><strong>Wnfl</strong></td><td>No-load fuel flow (pu) Default: 0.2</td></tr></tbody></table>
{% endtab %}

{% tab title="Initial values" %}

<table><thead><tr><th width="200">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Pm0</strong></td><td>Initial mechanical power output (pu)</td></tr><tr><td><strong>w0</strong></td><td>Speed reference (pu)</td></tr></tbody></table>
{% endtab %}

{% tab title="Block diagram" %}
Content the full GGOV1 diagram

{% hint style="info" %}
Each parts of the governor are available to see from when expanding the diagrams in the GGOV1 tab.
{% endhint %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
The initial values can be set manually or automatically from load-flow results by referencing synchronous machine variables.

For a **machine defined as PV type** named SM1 :

* Pmwset (pu) = SM1.lfP/1e6/SM1.sBase
* Pm0 (pu) = SM1.lfP/1e6/SM1.sBase + 3\*SM1.Rs\*((sqrt(SM1.lfP^2+SM1.lfQ^2)/1e6/SM1.sBase)/sqrt(3)/SM1.lfVolt)^2
* w0 (pu) = SM1.Wm\_Init

For a **machine defined as swing type** named SM1 :

* Pmwset (pu) = *BusName*.LF\_Pbus/SM1.sBase
* Pm0 (pu) = *BusName*.LF\_Pbus/SM1.sBase + 3\*SM1.Rs\*((sqrt(SM1.lfP^2+SM1.lfQ^2)/1e6/SM1.sBase)/sqrt(3)/SM1.lfVolt)^2
  {% endhint %}

## Inputs

<table><thead><tr><th width="199.5999755859375">Inputs</th><th>Description</th></tr></thead><tbody><tr><td><strong>w</strong></td><td>Machine actual speed (pu)</td></tr><tr><td><strong>Pref</strong></td><td>External control reference (pu)</td></tr><tr><td><strong>Pelec</strong></td><td>Measured electrical power (pu)</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="199.5999755859375">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>Pm</strong></td><td>Mechanical power output (pu)</td></tr></tbody></table>

## References

\[1] PSS<sup>®</sup>E 34.2.0 Model Library. NY, USA: Siemens Industry, Inc., 2017.

\[2] Reliability Guideline: Application Guide for Modeling Turbine-Governor and Active Power-Frequency Controls in Interconnection-Wide Stability Studies., 2019.


---

# 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/hypersim/library-blocks-reference/control-governors/ieee-ggov1.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.
