> 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/import-models-from-external-software-or-code/import-from-pss-e/import-into-hypersim.md).

# Import into HYPERSIM

This page describes how to import a **PSS®E network model** into **HYPERSIM** using the Network Import tools.

## Input file requirements

* The import requires a **`.raw` file**, which defines the network topology and steady-state data.
* To import dynamic models, a `.dyr` file must be located in the **same directory** as the `.raw` file and have the **same name**. If no `.dyr` file with the same name is present, the model is imported using **network data only**.
* A `.dyr` file **cannot be imported on its own**.

## Import procedure

{% stepper %}
{% step %}

## Create a new HYPERSIM model

1. Open the **File** tab.
2. Select **New** to create a new HYPERSIM model.
3. Choose the desired folder and enter a file name.
4. Click **Save**.
   {% endstep %}

{% step %}

## Import the PSS®E model

1. In the **HYPERSIM** tab, click **Import Network** in the **Import/Export** section to open the **Import Panel** window.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-8e6de4965022afe7bd6696e2537e0db357ad0be5%2Fimport-network.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Select **PSSE**, browse for the `.raw` file, configure the import options, and click **Import**.
   * **Replace machines by sources:** Replaces all machines with ideal voltage sources.
   * **Group machines with controls:** Groups machines and their associated controllers into subcircuits.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-e373bdea30b7c3b36719674eed55cf37f670d711%2Fpsse-import.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Wait for the import to complete

Once the import is started, HYPERSIM automatically processes the PSS®E model and builds the corresponding network. The import duration depends on the size and complexity of the model and may take several minutes.
{% endstep %}

{% step %}

## Review import reports

After the import is complete, a set of reports is generated in the `ConversionReports_YYYY-MM-DD_HH-mm` folder, located next to the input files. These reports provide detailed information about the conversion process and help assess its quality and completeness. In particular, they can be used to identify unsupported or ignored components, diagnose errors and warnings encountered during import, and assist OPAL-RT support in troubleshooting issues.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-976efff97fe0640e58c5f357227e4664caf3ffeb%2Fnetwork-reports-folder.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Main reports

* **hs\_error.log**: Provides information about the connection status to HyWorks.
* **hs\_import.log**: Contains warnings and errors related to component creation, connections, rotation, and parameter assignment.
* **netlist.xlsx**: Lists all imported components along with their parameters.

#### Detailed logs

* **{model\_name}\_full.log**: Consolidates information from the parser and mapper logs.
* **{model\_name}\_mapper.log**: Lists unsupported or skipped components during mapping to Unified Database components.
* **{model\_name}\_parser.log**: Provides details about parsing the input file.
* **{model\_name}\_modelexporter.log**: Contains information about the generation of the Python import script.

#### Generated files

* **{model\_name}.edd**: Intermediate file used during the import process.
* **{model\_name}.py**: Generated Python script used to build the model in HYPERSIM.
  {% endstep %}
  {% endstepper %}


---

# 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/import-models-from-external-software-or-code/import-from-pss-e/import-into-hypersim.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.
