> 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/use-a-powerfactory-model/prepare-the-dgs-xml-file/power-system-stabilizer-mapping.md).

# Power System Stabilizer Mapping

## Power system stabilizer data

Power system stabilizer data is imported from the **ElmDsl** section of the DGS-XML file. Depending on their PowerFactory configuration, stabilizer components are mapped to different ePHASORSIM native library power system stabilizer components.

The stabilizer name in the DGS-XML file depends on the PowerFactory version:

* **PowerFactory 2022 and earlier:** stabilizer names use the prefix `pss_`.
* **PowerFactory 2023 and later:** stabilizer names use the prefix `pss_PSSE_`.

{% hint style="info" %}
The parameters `IPB` and `Kd` from PowerFactory 2022 and earlier are deprecated and ignored during import. Both default to `1`.
{% endhint %}

### IEE2ST

`pss_IEE2ST` or `pss_PSSE_IEE2ST` components are mapped to the ePHASORSIM **IEE2ST** power system stabilizer native library component.

| Parameter | Description                                 |
| --------- | ------------------------------------------- |
| `K1`      | Signal 1 transducer gain \[pu]              |
| `T1`      | Signal 1 transducer time constant \[s]      |
| `K2`      | Signal 2 transducer gain \[pu]              |
| `T2`      | Signal 2 transducer time constant \[s]      |
| `T3`      | First washout derivative time constant \[s] |
| `T4`      | First washout integral time constant \[s]   |
| `T5`      | First lead-lag lead time constant \[s]      |
| `T6`      | First lead-lag lag time constant \[s]       |
| `T7`      | Second lead-lag lead time constant \[s]     |
| `T8`      | Second lead-lag lag time constant \[s]      |
| `T9`      | Third lead-lag lead time constant \[s]      |
| `T10`     | Third lead-lag lag time constant \[s]       |
| `Ic1`     | Input selector 1 \[1-6]                     |
| `Ic2`     | Input selector 2 \[1-6]                     |
| `Lsmin`   | Stabilizer minimum signal \[pu]             |
| `Lsmax`   | Stabilizer maximum signal \[pu]             |
| `Vcl`     | Lower voltage output limiter \[pu]          |
| `Vcu`     | Upper voltage output limiter \[pu]          |

### IEEEST

`pss_IEEEST` or `pss_PSSE_IEEEST` components are mapped to the ePHASORSIM **IEEEST** power system stabilizer native library component.

| Parameter          | Description                             |
| ------------------ | --------------------------------------- |
| `T1`               | First lead-lag lead time constant \[s]  |
| `T2`               | First lead-lag lag time constant \[s]   |
| `T3`               | Second lead-lag lead time constant \[s] |
| `T4`               | Second lead-lag lag time constant \[s]  |
| `Ks`               | Stabilizer gain \[pu]                   |
| `T5`               | Stabilizer lead time constant \[s]      |
| `T6`               | Stabilizer lag time constant \[s]       |
| `A1-A6`            | Filter time constants \[s]              |
| `Ic`               | Input selector \[1-6]                   |
| `Lsmin` / `Vr_min` | Stabilizer minimum signal \[pu]         |
| `Lsmax` / `Vr_max` | Stabilizer maximum signal \[pu]         |
| `Vcl`              | Lower voltage output limiter \[pu]      |
| `Vcu`              | Upper voltage output limiter \[pu]      |

### STAB1

`pss_STAB1` or `pss_PSSE_STAB1` components are mapped to the ePHASORSIM **STAB1** power system stabilizer native library component.

| Parameter                              | Description                             |
| -------------------------------------- | --------------------------------------- |
| `K` (PowerFactory 2022 and earlier)    | Stabilizer gain \[pu]                   |
| `KT` (PowerFactory 2023 and later)     | Stabilizer gain (`K × T`)               |
| `T`                                    | Washout time constant \[s]              |
| `T1`                                   | First lead-lag lead time constant \[s]  |
| `T2`                                   | Second lead-lag lead time constant \[s] |
| `T3`                                   | First lead-lag lag time constant \[s]   |
| `T4`                                   | Second lead-lag lag time constant \[s]  |
| `T1T3` (PowerFactory 2023 and later)   | `T1 × T3`                               |
| `T2T4` (PowerFactory 2022 and earlier) | `T2 × T4`                               |
| `HLIM`                                 | Stabilizer maximum output \[pu]         |

### PSS2A

`pss_PSS2A` or `pss_PSSE_PSS2A` components are mapped to the ePHASORSIM **PSS2A** power system stabilizer native library component.

| Parameter      | Description                                  |
| -------------- | -------------------------------------------- |
| `Tw1`          | First washout time constant \[s]             |
| `Tw2`          | Second washout time constant \[s]            |
| `Tw3`          | Third washout time constant \[s]             |
| `Tw4`          | Fourth washout time constant \[s]            |
| `T6`           | Signal 1 transducer time constant \[s]       |
| `Ks2`          | Signal 2 transducer gain \[pu]               |
| `T7`           | Signal 2 transducer time constant \[s]       |
| `Ks3`          | Washout coupling factor \[pu]                |
| `Ks1`          | Stabilizer gain \[pu]                        |
| `Ts1` / `T1`   | First lead-lag lead time constant \[s]       |
| `Ts2` / `T2`   | First lead-lag lag time constant \[s]        |
| `Ts3` / `T3`   | Second lead-lag lead time constant \[s]      |
| `Ts4` / `T4`   | Second lead-lag lag time constant \[s]       |
| `T8`           | Ramp tracking filter lead time constant \[s] |
| `T9`           | Ramp tracking filter lag time constant \[s]  |
| `N`, `M`       | Ramp tracking filter coefficients            |
| `Ic1` / `Ics1` | Input selector 1 \[1-6]                      |
| `Ic2` / `Ics2` | Input selector 2 \[1-6]                      |
| `Vstmin`       | Minimum output \[pu]                         |
| `Vstmax`       | Maximum output \[pu]                         |

### PSS2B

`pss_PSS2B` or `pss_PSSE_PSS2B` components are mapped to the ePHASORSIM **PSS2B** power system stabilizer native library component.

| Parameter          | Description                              |
| ------------------ | ---------------------------------------- |
| `Tw1-Tw4`          | Washout time constants \[s]              |
| `T6`, `T7`         | Signal transducer time constants \[s]    |
| `Ks1`              | Stabilizer gain \[pu]                    |
| `Ks2`              | Signal 2 transducer gain \[pu]           |
| `Ks3`              | Washout coupling factor \[pu]            |
| `Ts1` / `T1`       | First lead-lag lead time constant \[s]   |
| `Ts2` / `T2`       | First lead-lag lag time constant \[s]    |
| `Ts3` / `T3`       | Second lead-lag lead time constant \[s]  |
| `Ts4` / `T4`       | Second lead-lag lag time constant \[s]   |
| `Ts10` / `T10`     | Third lead-lag lead time constant \[s]   |
| `Ts11` / `T11`     | Third lead-lag lag time constant \[s]    |
| `T8`, `T9`         | Ramp tracking filter time constants \[s] |
| `N`, `M`           | Ramp tracking filter coefficients        |
| `Ic1` / `Ics1`     | Input selector 1 \[1-6]                  |
| `Ic2` / `Ics2`     | Input selector 2 \[1-6]                  |
| `Vstmin`           | Minimum output \[pu]                     |
| `Vstmax`           | Maximum output \[pu]                     |
| `VS1min`, `VS1max` | Input signal 1 limits \[pu]              |
| `VS2min`, `VS2max` | Input signal 2 limits \[pu]              |

### STAB3

`pss_STAB3` or `pss_PSSE_STAB3` components are mapped to the ePHASORSIM **STAB3** power system stabilizer native library component.

| Parameter | Description                         |
| --------- | ----------------------------------- |
| `Tt`      | Power transducer time constant \[s] |
| `Tx1`     | Filter time constant \[s]           |
| `Kx`      | Washout factor \[pu]                |
| `Tx2`     | Washout time constant \[s]          |
| `Vlim`    | Output limiter \[pu]                |

### STAB4

`pss_STAB4` or `pss_PSSE_STAB4` components are mapped to the ePHASORSIM **STAB4** power system stabilizer native library component.

| Parameter | Description                          |
| --------- | ------------------------------------ |
| `Kx`      | Washout factor \[pu]                 |
| `Tx2`     | Washout time constant \[s]           |
| `Ta`      | Lead time constant 1 \[s]            |
| `Tx1`     | Lag time constant 1 \[s]             |
| `Tb`      | Lead time constant 2 \[s]            |
| `Tc`      | Lag time constant 2 \[s]             |
| `Td`      | Output filter time constant 1 \[s]   |
| `Te`      | Output filter time constant 2 \[s]   |
| `Tt`      | Signal transducer time constant \[s] |
| `L1`      | Minimum output limit \[pu]           |
| `L2`      | Maximum output limit \[pu]           |


---

# 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/use-a-powerfactory-model/prepare-the-dgs-xml-file/power-system-stabilizer-mapping.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.
