Versions Compared

Key

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

...

Page Content

Table of Contents
minLevel1
maxLevel3
include
outlinefalse
indent
styledefault
excludePage Content
typelist
class
printablefalse

Prepare the I/O Pins File

  • A template Excel network file is available on the ePHASORSIM Blockset page in the MATLAB user help.

...

Insert excerpt
Excel Input File
Excel Input File
namelocate-excel-template
nopaneltrue

  • To configure the Excel file for PSS/

...

  • E input files, refer to

...

...

Note: The Pins page is used to create measurement probes (outgoing pin) and control signals (incoming pins) to the system. To create the incoming and outgoing pins, the user needs to know the name of each component.

PSS/e Files

...

  • . All the network component related sheets have to be removed in the Excel input file.

...

Save the Excel file in an empty folder in an intuitive location, like 'C:\OPAL-RT\ePHASORSIM' or in your active default project folder.

...

You will use this folder and path throughout this procedure; this is why we recommend an intuitive and/or default location.

PSS/E Files

  • PSS/E version 32 RAW format (*.raw)

...

  • are compatible with ePHASORSIM.

    • If you are using a more recent version, make sure to save the RAW file with the PSS®E - 32 option

    • This can be done through the following menu in PSS/E: File>Save Case As…>Power Flow Raw Data, Previous Versions>RAW file version

      image-20241016-190057.pngImage Added
  • Save the RAW file in the

...

  • the previously created folder.

  • The PSS/

...

  • E DYR file (*.dyr) should be saved in the same folder.

Prepare the Simulink Model

  • Change the MATLAB working directory to the previously created folder.

  • Open the Simulink Library.

  • Select RT-LAB/ePHASORSIM.

  • Drag the Solver block into a new Simulink model.

  • Save this model in the previously created directory.

  • Open the mask and do the following steps.

Network Data Tab

Insert excerpt
Excel Input File
Excel Input File
nameprepare-simulink-model
nopaneltrue

Insert excerpt
Excel Input File
Excel Input File
namenetwork-data-tab
nopaneltrue

  • Select PSS/E Ver. 32 as the Input file format.

...

  • Use

...

  • Select button or insert the name of the:

    • Excel file containing the pins in the I/O pins file field.

    • RAW file in the PSS/

...

    • E RAW file field.

    • DYR file in the PSS/

...

Library Tab

  • If Use built-in models in Network data tab is unchecked, enter the FMU folder name in the FMU component field (the default is the empty string).

  • Make sure Use UDB in Network data tab is unchecked to use FMU as this feature is not supported with FMU yet.

...

Simulation Settings Tab

  • Specify a Time-step (The default value is 10 ms).

  • Power-flow:

    • select the Initialization method from the drop-down menu,

    • enter the Power mismatch (max p.u.) tolerance for the power-flow calculation (The default value is 1e-8).

    • enter the Max number of NR iterations (The default value is 100).

    • clicking Execute or Execute and export report runs the power-flow. Only the latter writes the power-flow results in CSV format.

  • Dynamic simulations:

    • when Start from Power-flow is checked, power-flow is executed before dynamic simulation.

    • enter the Number of partitions to be used for the network solution (The default value is 1).

    • clicking Export admittance matrix writes the admittance matrix in CSV format.

    • check Optimize number of threads (Windows only).

...

  • Click OK. The ePHASORSIM Solver block is redrawn using the pins from the Excel file. The network data may also be converted to OPAL format, depending on the configuration of the Refresh netlist option in the Network data tab.

  • Connect Simulink sources and sinks (scopes, displays) to the input/output pins on ePHASORSIMs' Solver block.

  • Ensure the simulation is set to use a fixed time-step (under Simulation/Model Configuration parameters/Solver), and that the time-step is consistent with that specified in the Simulation settings tab.

  • Once the Solver mask and Simulink model are configured, run the model to verify a reasonable value appears on the scopes.

  • The messages below are printed in the MATLAB Command Window.

  • Save your model.

...

    • E DYR file field.

image-20240815-143923.pngImage Added

...

Check Use built-in models.

...

Check Refresh netlist only when simulation starts.

Insert excerpt
Excel Input File
Excel Input File
namelibrary-tab
nopaneltrue

Insert excerpt
Excel Input File
Excel Input File
namesimulation-settings-tab
nopaneltrue