> 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/model-and-simulation/phasor-domain-with-ephasorsim/integrate-a-power-system-model-to-ephasorsim/use-a-cyme-model/prepare-the-sxst-file/cyme-component-mapping.md).

# CYME Component Mapping

The following sections describe the CYME component data imported into ePHASORSIM. For each supported component, the imported parameters correspond directly to the fields available in the CYME component properties and are used to configure the equivalent ePHASORSIM component during import.

Not all CYME component data is imported. The following sections identify the imported fields, supported values, and any applicable import restrictions. Any field that is not listed in the tables is ignored during import.

## Voltage source data

ePHASORSIM supports CYME **Source Node** components and maps them to the ePHASORSIM **Voltage Source** component.

| CYME Component Field           | Description                                                           |
| ------------------------------ | --------------------------------------------------------------------- |
| **Name** (Source Node)         | Source node identifier. May contain up to 31 alphanumeric characters. |
| **Operating Voltage** (Source) | Source operating line-to-line voltage \[kV].                          |

{% hint style="info" %}
This component is modeled as a fixed voltage source. The short-circuit capacity is fixed to **1,000,000,000 MVA**.
{% endhint %}

## Transformer data

ePHASORSIM supports CYME **2-winding transformer** models. When importing an **unbalanced network**, transformers are modeled using the ePHASORSIM **Multiphase Transformer** component. When importing a **balanced network**, transformers are converted to their positive-sequence equivalent.

| CYME Component Field                 | Description                                                                         |
| ------------------------------------ | ----------------------------------------------------------------------------------- |
| **Section ID**                       | Transformer identifier. No spaces allowed.                                          |
| **Phase**                            | Phases present in the network.                                                      |
| **Primary** (General Settings)       | Primary side of the transformer.                                                    |
| **Nominal Rating** (Nominal Data)    | Transformer rating \[kVA].                                                          |
| **Primary Voltage** (Nominal Data)   | Primary-side rated line-to-line voltage \[kV].                                      |
| **Secondary Voltage** (Nominal Data) | Secondary-side rated line-to-line voltage \[kV].                                    |
| **Z1** (Sequence Impedances)         | Positive-sequence impedance \[% on transformer base].                               |
| **Z0** (Sequence Impedances)         | Zero-sequence impedance \[% on transformer base].                                   |
| **X1/R1** (Sequence Impedances)      | Positive-sequence reactance-to-resistance ratio.                                    |
| **X0/R0** (Sequence Impedances)      | Zero-sequence reactance-to-resistance ratio.                                        |
| **Primary** (Configuration)          | Primary-side winding connection. Supported values: **Star to ground**, **Delta**.   |
| **Secondary** (Configuration)        | Secondary-side winding connection. Supported values: **Star to ground**, **Delta**. |
| **Phase Shift**                      | Supported connection types: **DD0**, **YGyg0**, **YGg0**, **Dyg1**, **YGD1**.       |
| **Final Tap**                        | Transformer tap position. If no LTC is defined, defaults to **0**.                  |

{% hint style="info" %}
Supported transformer connections:

* **DD0**: Delta-Delta, 0° phase shift
* **YGyg0**: Grounded Wye-Grounded Wye, 0° phase shift
* **Dyg1**: Delta-Grounded Wye, 30° phase shift
* **YGD1**: Grounded Wye-Delta, 30° phase shift
  {% endhint %}

## Electronically Coupled Generator (ECG) data

**Electronically Coupled Generators (ECGs)** are supported only when the inverter control type is set to **Adjust Power Factor** and the operating mode is **INV3**. In this case, the ECG is modeled as a multiphase constant-power load whose active power is equal to the configured **Active Generation** value with the opposite sign. Reactive power is calculated from the configured power factor.

| CYME Component Field      | Description                                                             |
| ------------------------- | ----------------------------------------------------------------------- |
| **ID**                    | ECG identifier. No spaces allowed.                                      |
| **Number**                | ECG number. Supports up to 31 alphanumeric characters.                  |
| **Status**                | Component connection status.                                            |
| **Phase**                 | Phases present in the network.                                          |
| **Active Generation**     | Total generated active power \[kW].                                     |
| **Inverter Control Type** | Inverter control mode.                                                  |
| **Power Factor**          | Available when *Adjust Power Factor* is selected. Range: -100% to 100%. |

## Cable and overhead line data

ePHASORSIM supports CYME **Cable** and **Overhead Line** models.

| CYME Component Field | Description                              |
| -------------------- | ---------------------------------------- |
| **Section ID**       | Component identifier. No spaces allowed. |
| **Phase**            | Phases present in the network.           |
| **Status**           | Component connection status.             |
| **Length**           | Component length \[ft].                  |
| **Z\[ABC]**          | Phase impedance matrix \[Ω/mi].          |
| **Y\[ABC]**          | Phase admittance matrix \[µS/mi].        |

## Shunt reactor data

| CYME Component Field | Description                                                          |
| -------------------- | -------------------------------------------------------------------- |
| **Number**           | Shunt reactor identifier. Supports up to 31 alphanumeric characters. |
| **Status**           | Component connection status.                                         |
| **Phase**            | Phases present in the network.                                       |
| **Rated Power**      | Rated reactive power \[kVAr].                                        |
| **Rated Voltage**    | Rated line-to-neutral voltage \[kV].                                 |
| **Configuration**    | Shunt reactor configuration.                                         |

## Shunt capacitor data

| CYME Component Field | Description                                                            |
| -------------------- | ---------------------------------------------------------------------- |
| **Number**           | Shunt capacitor identifier. Supports up to 31 alphanumeric characters. |
| **Type**             | Shunt capacitor type.                                                  |
| **Status**           | Component connection status.                                           |
| **Phase**            | Phases present in the network.                                         |
| **Rated Power**      | Rated reactive power \[kVAr].                                          |
| **Rated Voltage**    | Rated line-to-neutral voltage \[kV].                                   |
| **Configuration**    | Shunt capacitor configuration. Star-grounded only.                     |

## Spot load and distributed load data

| CYME Component Field                     | Description                                                                  |
| ---------------------------------------- | ---------------------------------------------------------------------------- |
| **Number**                               | Load identifier.                                                             |
| **Status**                               | Load connection status.                                                      |
| **Phase**                                | Phases present in the network.                                               |
| **Customer Type**                        | Constant Power, Constant Current, Constant Impedance, or ZIP load model.     |
| **Configuration**                        | Load configuration.                                                          |
| **Format**                               | Input format: kW & kVAr, kVA & PF, or kW & PF.                               |
| **Real Power (A/B/C)**                   | Active power per phase \[kW].                                                |
| **Reactive Power (A/B/C)**               | Reactive power per phase \[kVAr].                                            |
| **Constant Impedance Voltage Threshold** | Voltage threshold below which the load is represented as constant impedance. |

{% hint style="info" %}
**Distributed loads** are modeled as two ZIP loads connected to the terminal nodes of the line on which the load is defined. Half of the total active and reactive power is assigned to each side.
{% endhint %}

## Regulator data

ePHASORSIM models CYME regulators as **2-winding transformers** with a small impedance value.

| CYME Component Field | Description                              |
| -------------------- | ---------------------------------------- |
| **Section ID**       | Regulator identifier. No spaces allowed. |
| **Phase**            | Phases present in the network.           |
| **Primary**          | Primary side of the regulator.           |
| **Nominal Rating**   | Regulator rating \[kVA].                 |
| **Rated Voltage**    | Rated line-to-line voltage \[kV].        |
| **Configuration**    | Transformer connection type.             |
| **Tap**              | Regulator tap position.                  |

{% hint style="info" %}
The regulator sequence impedances are not imported from CYME. ePHASORSIM uses:

* Z1 = 1e-8 Ω
* Z0 = 1e-8 Ω
* X1/R1 = 10
* X0/R0 = 10
  {% endhint %}

## Synchronous generator data

**Synchronous generators** are modeled as multiphase ZIP loads operating as negative constant-power loads:

* If all three phases are active, the active and reactive power assigned to each phase is equal to one-third of the generated power multiplied by the **# of Generators** parameter.
* If only one or two phases are active, the active and reactive power assigned to each active phase is equal to the generated power multiplied by the **# of Generators** parameter.

| CYME Component Field  | Description                                                  |
| --------------------- | ------------------------------------------------------------ |
| **ID**                | Generator identifier. No spaces allowed.                     |
| **Number**            | Generator number. Supports up to 31 alphanumeric characters. |
| **Status**            | Component connection status.                                 |
| **Phase**             | Phases present in the network.                               |
| **Control Type**      | Generator control mode.                                      |
| **# of Generators**   | Number of generators.                                        |
| **Active Generation** | Generated active power per machine \[kW].                    |
| **Power Factor**      | Available when Fixed Generation control mode is selected.    |

## Fuse data

ePHASORSIM models CYME **fuses** using its **Switch** component.

| CYME Component Field | Description                    |
| -------------------- | ------------------------------ |
| **Number**           | Fuse identifier.               |
| **Status**           | Component connection status.   |
| **Phase**            | Phases present in the network. |
| **State**            | Operating state of the fuse.   |

{% hint style="info" %}
When closed, the fuse is represented by a series resistance of **1e-6 Ω**. When open, the series resistance is **1e6 Ω**. The shunt admittance is fixed at **1e-6 S**.
{% endhint %}

## Bus data

Both CYME **Bus** and **Node** components are mapped to the ePHASORSIM **Bus** component.

| CYME Component Field | Description                                                 |
| -------------------- | ----------------------------------------------------------- |
| **Name**             | Node identifier. Supports up to 32 alphanumeric characters. |
| **Base Voltage**     | Bus base line-to-line voltage \[kV].                        |

## Busway data

| CYME Component Field | Description                              |
| -------------------- | ---------------------------------------- |
| **Section ID**       | Component identifier. No spaces allowed. |
| **Phase**            | Phases present in the network.           |
| **Status**           | Component connection status.             |
| **Length**           | Component length \[ft].                  |
| **Z1**               | Positive-sequence impedance \[Ω/mi].     |
| **Z0**               | Zero-sequence impedance \[Ω/mi].         |

## Switch, breaker, and recloser data

ePHASORSIM models CYME **Switches**, **Breakers**, and **Reclosers** using its **Switch** component.

| CYME Component Field | Description                              |
| -------------------- | ---------------------------------------- |
| **Section ID**       | Component identifier. No spaces allowed. |
| **Status**           | Component connection status.             |
| **Phase**            | Phases present in the network.           |
| **State**            | Operating state of the component.        |

{% hint style="info" %}
A closed device is represented by a series resistance of **1e-6 Ω**. An open device is represented by a series resistance of **1e6 Ω**. The associated shunt admittance is fixed at **1e-6 S**.

Closed switches or breakers located within a line section are ignored during the conversion process.
{% endhint %}


---

# 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/model-and-simulation/phasor-domain-with-ephasorsim/integrate-a-power-system-model-to-ephasorsim/use-a-cyme-model/prepare-the-sxst-file/cyme-component-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.
