Versions Compared

Old Version 3

changes.mady.by.user Sylvain Ménard

Saved on

compared with

New Version 4

changes.mady.by.user Sylvain Ménard

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page:

Table of Contents

The primary input data format for ePHASORSIM is an Excel workbook that can be in XLS or XLSX formats. An empty and preformatted Excel template file is provided with each installation of product located at the following path:

~\OPAL-RT\RT-LAB\installed version\Simulink\ephasorsim\Template.xls.

This file is also accessible via:

  1.  ePHASORSIM Blockset page in MATLAB’s Help section.

  2. Mask of

...

  1. ePHASORSIM Solver through the link

...

  1. below Complete network field in the Network data. 

This Excel template includes individual and preformatted sheets for all supported components and their required data entry with guidelines in form of field comments. In Native Library chapter, all the components are presented based on this Excel template format; however, ePHASORSIM also supports other vendor specific file formats, which are discussed in Third Party Data Formats.

The version of the Excel template file included in this package is v2.0. This new template has the following new features:

  • The component pages in earlier versions for positive sequence and multiphase systems, which share the same type, are now merged into a single page. For example, Load and Multiphase Load pages in earlier version, which corresponds to positive sequence and multiphase systems respectively, are now merged to a single page named Load. 

  • Several types of machine, exciter, turbine and governor, power system stabilizer (PSS) in Native Library

     can

     can be imported via this version of Excel file. Previously, many of these models were only accessible using PSS/e input files.

  • FMU of a single component exciter, turbine-governor, and PSS controller types can be added and instantiated via the corresponding component pages. Thus, there is no need to create a separate page for each new single component FMU. The sperate page in Excel file is still required in case of GenUnit FMU.

Each page of the Excel template has a specific name that must not be modified or changed.

General

The basic information of the power system and current version of template

Pins

To define incoming ports and outgoing ports of the model

Bus

To define all buses

Current Injector

To externally inject current into a bus

Voltage Source

To define positive sequence and three-phase voltage source

Machine

To define various synchronous machines and induction machine models

Exciter

To define various native and FMU excitation system models

PSS

To define various native and FMU power system stabilizer models

Turbine and Governor

To define various native and FMU turbine-governor models

Load

Constant impedance, constant current, and constant power positive sequence loads and multiphase ZIP model loads.

Line

PI-section positive sequence and multiphase line models

Transformer

Two and three winding positive sequence transformers and two-winding multiphase transformers.

Switch

To model breakers and disconnectors

Shunt

Positive sequence and multiphase Shunt models.

Multiphase Fault

Fault model for phase-to-ground fault (single-phase, double-phase, three-phase) and phase-to-phase fault (double-phase, three-phase).


Background Color
color#D3D3D3

Notes:

  • Incorrect names of pages create invalid simulation results.

  • Parameters not used by a component type but existing in the page must be left empty, e.g. for single-phase-to-ground fault in Multiphase Fault page, Bus2 and Bus3 column must be left empty.

  • A data row can be commented in the Excel file by adding ‘//’ to the leftmost cell of that row.

  • In Excel template v2.0, for pages where model type is listed, the default order of blocks and columns after row 11 must not change. Also, one empty row between End of each block and the next block is mandatory; otherwise, empty rows are NOT allowed.

  • If there exist several components with Status=0 in the Excel file whose Status is not going to change during simulation, it is recommended to remove them from the file. Otherwise, in large-scale system they will have impact on run-time performance and memory usage.

  • Please Refer to Migration Notes for details about how to migrate from older versions of Excel template.

...

...

General 

The basic information of the power system is entered on this page.

General parameters

Symbol

Description

Unit

Excel file version

Defines the version of the template

v2.0

Name

Name of the Excel file


Frequency (Hz)

Frequency of the network

Hz

Power Base (MVA)

Based power of the network

MVA

...

Pins

...

In ePHASORSIM, Pins are the links to interact with the Solver block in the Simulink model. There are two types of pins:

Outgoing

To define measurement probes or monitor a status in the power system (e.g. voltage of a bus, or in-service status of a shunt device)

Incoming

To send operational commands to the simulator (e.g. apply faults). These pins must not be left disconnected; otherwise, the Solver block may behave unexpectedly.

Refer to each component page in Native Library chapter to explore the available I/O pins.

Example

Pins for Positive Sequence Components

...