Pour la documentation en FRANÇAIS, utilisez l’outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

On this page:

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 ePHASORSIM Solver through the link 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 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.

GeneralThe basic information of the power system and current version of template
PinsTo define incoming ports and outgoing ports of the model

Bus

To define all buses
Current InjectorTo externally inject current into a bus
Voltage SourceTo define positive sequence and three-phase voltage source
MachineTo define various synchronous machines and induction machine models
Exciter

To define various native and FMU excitation system models

PSSTo define various native and FMU power system stabilizer models
Turbine and GovernorTo define various native and FMU turbine-governor models
LoadConstant impedance, constant current, and constant power positive sequence loads and multiphase ZIP model loads.
LinePI-section positive sequence and multiphase line models
TransformerTwo and three winding positive sequence transformers and two-winding multiphase transformers.
SwitchTo model breakers and disconnectors
ShuntPositive sequence and multiphase Shunt models.
Multiphase FaultFault model for phase-to-ground fault (single-phase, double-phase, three-phase) and phase-to-phase fault (double-phase, three-phase).



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:

OutgoingTo 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)
IncomingTo 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

  • No labels