> 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/model-and-simulation/phasor-domain-with-ephasorsim/integrate-a-power-system-model-to-ephasorsim/native-library-components/machine-components.md).

# Machine Components

## Introduction

ePHASORSIM native library includes five built-in synchronous generator models derived from the corresponding PSS®E machine models.

These generator models can be used in both **positive-sequence** and **multiphase** networks and provide different levels of machine representation, ranging from the classical second-order model to detailed round-rotor and salient-pole models with saturation effects.

## Synchronous generator models

All synchronous generator models share a common set of operating-point, electrical, and mechanical parameters, while additional parameters are available depending on the selected machine model.

### Common parameters

These parameters are present in all generator models:

| Excel Column Name | Native Component Parameter | Description                                                                                   |
| ----------------- | -------------------------- | --------------------------------------------------------------------------------------------- |
| **Bus**           | `bus`                      | Connected bus identifier.                                                                     |
| **ID**            | `name`                     | Generator identifier.                                                                         |
| **Status**        | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p> |
| **Pg (MW)**       | `power[0]`                 | Active power output.                                                                          |
| **Qg (MVAr)**     | `power[1]`                 | Reactive power output.                                                                        |
| **Qmin (MVAr)**   | `reactivePowerLimits[0]`   | Minimum reactive power limit.                                                                 |
| **Qmax (MVAr)**   | `reactivePowerLimits[1]`   | Maximum reactive power limit.                                                                 |
| **Sbase (MVA)**   | `base`                     | Machine MVA base.                                                                             |
| **H (s)**         | `inertia`                  | Inertia constant.                                                                             |
| **D**             | `damping`                  | Damping coefficient (pu on machine base).                                                     |
| **Ra (pu)**       | `resistance`               | Stator resistance.                                                                            |

### SyncGenGENCLS

The SyncGenGENCLS model is a classical second-order synchronous generator model represented by a constant voltage source behind the d-axis transient reactance. This model is typically used for short-term dynamic studies and generators far from the disturbance location.

It uses the common generator parameters, and the following additional parameters:

| Excel Column Name | Native Component Parameter | Description                 |
| ----------------- | -------------------------- | --------------------------- |
| **x'\_d (pu)**    | `reactance`                | d-axis transient reactance. |

### SyncGenGENROE and SyncGenGENROU

The SyncGenGENROE and SyncGenGENROU models use the common generator parameters, and the same additional parameters.

The difference between the two models is the saturation formulation:

{% columns %}
{% column %}
**GENROE** uses an exponential saturation formulation.

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

{% column %}
**GENROU** uses a quadratic saturation formulation.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-4a5e7a5bbb7d289fe4fa3623badb6f7e2c2c24d8%2Feph-SyncGenGENROU.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

| Excel Column Name | Native Component Parameter | Description                                      |
| ----------------- | -------------------------- | ------------------------------------------------ |
| **x\_d (pu)**     | `reactance[0]`             | d-axis reactance.                                |
| **x\_q (pu)**     | `reactance[1]`             | q-axis reactance.                                |
| **x'\_d (pu)**    | `reactance[2]`             | d-axis transient reactance.                      |
| **x'\_q (pu)**    | `reactance[3]`             | q-axis transient reactance.                      |
| **x"\_d (pu)**    | `reactance[4]`             | d-axis sub-transient reactance.                  |
| **x\_l (pu)**     | `leakage`                  | Leakage reactance.                               |
| **T'\_do (s)**    | `openCircuit[0]`           | d-axis transient open-circuit time constant.     |
| **T"\_do (s)**    | `openCircuit[1]`           | d-axis sub-transient open-circuit time constant. |
| **T'\_qo (s)**    | `openCircuit[2]`           | q-axis transient open-circuit time constant.     |
| **T"\_qo (s)**    | `openCircuit[3]`           | q-axis sub-transient open-circuit time constant. |
| **S10**           | `satFactors[0]`            | Saturation factor at 1.0 pu.                     |
| **S12**           | `satFactors[1]`            | Saturation factor at 1.2 pu.                     |

### SyncGenGENSAE and SyncGenGENSAL

The SyncGenGENSAE and SyncGenGENSAL models use the common generator parameters, and the same additional additional machine parameters.

The difference between the two models is the saturation formulation:

{% columns %}
{% column %}
**GENSAE** uses exponential saturation formulation.

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

{% column %}
**GENSAL** uses quadratic saturation formulation on the d-axis.

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

| Excel Column Name | Native Component Parameter | Description                                      |
| ----------------- | -------------------------- | ------------------------------------------------ |
| **x\_d (pu)**     | `reactance[0]`             | d-axis reactance.                                |
| **x\_q (pu)**     | `reactance[1]`             | q-axis reactance).                               |
| **x'\_d (pu)**    | `reactance[2]`             | d-axis transient reactance.                      |
| **x"\_d (pu)**    | `reactance[3]`             | d-axis sub-transient reactance.                  |
| **x\_l (pu)**     | `leakage`                  | Leakage reactance .                              |
| **T'\_do (s)**    | `openCircuit[0]`           | d-axis transient open-circuit time constant.     |
| **T"\_do (s)**    | `openCircuit[1]`           | d-axis sub-transient open-circuit time constant. |
| **T"\_qo (s)**    | `openCircuit[2]`           | q-axis sub-transient open-circuit time constant. |
| **S10**           | `satFactors[0]`            | Saturation factor at 1.0 pu.                     |
| **S12**           | `satFactors[1]`            | Saturation factor at 1.2 pu.                     |

## Asynchronous generator induction models

The two asynchronous generator models available are equivalent to the **CIMTR3** machine models from the PSS®E library:

* **AsyncGenSingleCage**: Single-cage induction machine model.
* **AsyncGenDoubleCage**: Double-cage induction machine model.

Both models share a common set of operating-point, electrical, and mechanical parameters. The double-cage model extends the single-cage representation by introducing additional sub-transient rotor dynamics.

### Common parameters

Both asynchronous generator models use the following parameters:

| Excel Column Name | Native Component Parameter | Description                                                   |
| ----------------- | -------------------------- | ------------------------------------------------------------- |
| **Bus**           | `bus`                      | Connected bus identifier.                                     |
| **ID**            | `name`                     | Generator identifier.                                         |
| **Status**        | `status`                   | Initial service status (`1` = connected, `0` = disconnected). |
| **Pg (MW)**       | `power[0]`                 | Active power output.                                          |
| **Qg (MVAr)**     | `power[1]`                 | Reactive power output.                                        |
| **Qmin (MVAr)**   | `reactivePowerLimits[0]`   | Minimum reactive power limit.                                 |
| **Qmax (MVAr)**   | `reactivePowerLimits[1]`   | Maximum reactive power limit.                                 |
| **Sbase (MVA)**   | `base`                     | Machine power base.                                           |
| **Pmech0 (pu)**   | `mechanicalPower`          | Mechanical power at synchronous speed.                        |
| **H (s)**         | `inertia`                  | Inertia constant.                                             |
| **Ra (pu)**       | `resistance`               | Stator resistance.                                            |
| **x (pu)**        | `reactance[0]`             | Synchronous reactance.                                        |
| **x' (pu)**       | `reactance[1]`             | Transient reactance.                                          |
| **x\_l (pu)**     | `leakage`                  | Stator leakage reactance.                                     |
| **T' (s)**        | `openCircuit[0]`           | Transient rotor time constant.                                |
| **e1 (pu)**       | `satFactors[0]`            | First saturation reference voltage.                           |
| **e2 (pu)**       | `satFactors[1]`            | Second saturation reference voltage.                          |
| **S(e1)**         | `satFactors[2]`            | Saturation function value at **e1**.                          |
| **S(e2)**         | `satFactors[3]`            | Saturation function value at **e2**.                          |

### AsyncGenSingleCage

A single-cage induction machine model that represents the rotor using a single equivalent rotor cage. The AsyncGenSingleCage model uses only the asynchronous generator common parameters described above.

### AsyncGenDoubleCage

A double-cage induction machine model that represents the rotor using two equivalent rotor cages and includes sub-transient dynamics.

In addition to the common asynchronous generator parameters, the AsyncGenDoubleCage model defines the following parameters:

| Excel Column Name | Native Component Parameter | Description                        |
| ----------------- | -------------------------- | ---------------------------------- |
| **x" (pu)**       | `reactance[2]`             | Sub-transient reactance.           |
| **T" (s)**        | `openCircuit[1]`           | Sub-transient rotor time constant. |


---

# 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/model-and-simulation/phasor-domain-with-ephasorsim/integrate-a-power-system-model-to-ephasorsim/native-library-components/machine-components.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.
