> 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/example-models/ephasorsim-example-models/import-data-files-in-cyme-format-unbalanced.md).

# Import Data Files in CYME Format (Unbalanced)

## Description

The **Import Data Files in CYME Format (Unbalanced)** example can be created by starting a new RT‑LAB project. From the menu bar, select **File > New > RT‑LAB Project**. Enter a name and location for your project, then click **Next**. From the available templates list, navigate to **ePHASORsim** and select **phasor09\_IEEE34**, then click **Finish**.

The **modified IEEE 34-node Test Feeder distribution system** \[1] is used to show how to import CYME (CYMDIST sub-module) network data files in ePHASORSIM for three-phase unbalanced dynamic simulations. Figure below shows the single line diagram of this network. The solid lines are 3-phase and the dashed lines are single phase.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-addf85bc66f4c00180ef81b37a3e7d280fc0fa6c%2Fphasor09_IEEE34.jpg?alt=media" alt=""><figcaption><p>IEEE 34-bus network diagram.</p></figcaption></figure>

The CYME input file format is \*.sxst and it is compatible with version 7.2. In order to have the simulation starting from a steady state, the power flow results are needed either from ePHASORSIM power flow feature directly or from CYME.

The comparison between CYME power flow results and ePHASORSIM power flow results are presented in this demo for a modified IEEE 34-node test case.

A copy of standard IEEE 34-node system report exists in the demo folder. This network is one feeder with 34 nodes that includes 3-phase voltage source, single, two and three phase spot loads as well as distributed loads, transformers, three phase shunt, single phase lines and three phase lines. The following modifications are made in this system:

* The two voltage regulators (on node 814 and 852) are substituted by three phase transformers with (Yg-Yg) configurations.
* The configuration of all the loads, spot and distributed, is changed to Yg concoction.

## Requirements

* MATLAB R2019b and later

## Simulation and results

The in-port and out-port pins are defined in **phasor09\_IEEE34.xlsx** file. In the "Pins" page of the Excel file the following outgoing and incoming pins are assigned:

<details>

<summary>Outgoing pins (measurements)</summary>

* Voltage measurement for phases A, B, and C at nodes 810, 822, 826, 856, 864, 890, 848, 838, 840.
* Current measurement for phases A, B, and C on lines 802-806, 850-816, 830-854 and 832-858.

</details>

<details>

<summary>Incoming pins (control commands)</summary>

* Adjust three-phase tap position for transformer between node 832 and 888.
* Adjust P and Q for each phase of load 3 at bus 844.

</details>

In this demo, the power flow results are calculated directly from ePHASORsim with the option 'Power-flow and dynamic simulation' in the solver mask.

The simulation begins from steady state and two disturbances happen in the system as described below:

* At t = 1.5s: Taps of transformer are changed from 0 to 8 on three phases.
* At t = 6s: Active and reactive power of load are changed to be 3-phase balanced.

There are three types of load in the system: constant power, constant impedance, and constant current loads. The bandwidth of these loads are set to 0.3, which means if the voltage is over 1.3 p.u. or under 0.7 p.u., then the load will change to a constant impedance type during the dynamic simulation.

Table below shows power flow comparison results of ePHASORSIM against CYME (CYMDIST sub-module). In this table, column 4 shows voltage magnitude's relative error and column 5 shows absolute voltage angle error for some buses of the network.

<table data-search="false"><thead><tr><th>Result Type</th><th>CYMDIST Power Flow</th><th>ePHASORSIM Power Flow</th><th>Error Magnitude (%)</th><th>Error Angle (deg)</th></tr></thead><tbody><tr><td>V_810_b (V)</td><td>14772.346/-120.514</td><td>14772.800/-120.514</td><td>0.003</td><td>0.000</td></tr><tr><td>V_822_a (V)</td><td>12791.347/-7.537</td><td>12791.784/-7.538</td><td>0.003</td><td>0.001</td></tr><tr><td>V_826_b (V)</td><td>13496.952/-126.924</td><td>13497.647/-126.925</td><td>0.005</td><td>0.001</td></tr><tr><td>V_856_b (V)</td><td>13231.510/-127.144</td><td>13231.690/-127.145</td><td>0.001</td><td>0.001</td></tr><tr><td>V_864_b (V)</td><td>12365.202/-133.048</td><td>12366.254/-133.049</td><td>0.009</td><td>0.001</td></tr><tr><td>V_890_a (V)</td><td>1772.051/-15.456</td><td>1772.031/-15.457</td><td>0.001</td><td>0.001</td></tr><tr><td>V_890_b (V)</td><td>1805.137/-135.982</td><td>1805.176/-135.983</td><td>0.002</td><td>0.001</td></tr><tr><td>V_890_c (V)</td><td>1733.242/104.216</td><td>1733.122/104.216</td><td>0.007</td><td>0.000</td></tr><tr><td>V_848_a (V)</td><td>12261.151/-13.100</td><td>12261.309/-13.103</td><td>0.001</td><td>0.003</td></tr><tr><td>V_848_b (V)</td><td>12315.175/-133.221</td><td>12315.938/-133.222</td><td>0.006</td><td>0.001</td></tr><tr><td>V_848_c (V)</td><td>12000.315/106.836</td><td>12001.103/106.834</td><td>0.007</td><td>0.002</td></tr><tr><td>V_838_b (V)</td><td>12308.489/-133.141</td><td>12308.750/-133.142</td><td>0.002</td><td>0.001</td></tr><tr><td>V_840_a (V)</td><td>12252.930/-13.017</td><td>12252.683/-13.019</td><td>0.002</td><td>0.002</td></tr><tr><td>V_840_b (V)</td><td>12311.045/-133.138</td><td>12311.625/-133.140</td><td>0.005</td><td>0.002</td></tr><tr><td>V_840_c (V)</td><td>11991.703/106.925</td><td>11992.477/106.924</td><td>0.006</td><td>0.001</td></tr></tbody></table>

## References

\[1] [IEEE Distribution Test Feeders](http://ewh.ieee.org/soc/pes/dsacom/testfeeders/index.html).

{% file src="/files/4nSZEcLOree9qaDSpxvc" %}


---

# 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/example-models/ephasorsim-example-models/import-data-files-in-cyme-format-unbalanced.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.
