Page Content

Prepare the I/O Pins File

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

Open

• In order to configure the Excel file, refer to CYME Excel File.

• Only incoming and outgoing pins must be specified - no network data is required 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.

CYME File

• A CYME netlist file (*.sxst) should be saved in the aforementioned folder.

Prepare the Simulink Model

• Change the MATLAB working directory to 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.

• 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:

Network Data Tab

• Select CYME as the Input file format.

• Uncheck Use UDB since this feature is not yet available for CYME data input.

• Select or insert the name of the Excel file containing the pins in the I/O pins file field.

• Select or insert the name of CYME netlist file (*.sxst) in the SXST file field.

• If applicable, Select or insert the name of the power-flow analysis report (*.xls) exported from CYME in the Power-flow report field.

• Check Use built-in models.

• Check Refresh netlist only when simulation starts.

Open

Library Tab

• If both Unbalanced and Use built-in models are unchecked in Network data tab FMU components can be used with CYME input data files.

• To do so, enter the FMU folder name in the FMU component field or use Path button to select the FMU folder (the default is the empty string ‘’, or two single quotes).

Simulation Settings Tab

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

• Power-flow: Only applicable if Power-flow report field in Network data tab is empty.

  • 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:

  • clear Start from Power-flow if CYME power-flow report in Network data tab is provided.

  • 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).

• Press OK. The ePHASORSIM Solver block is redrawn using the pins from the given 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 ePHASORSIM’s 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 in the figure below will be printed in the MATLAB Command Window.

• Save your model.