1. Quickstart Guide Excel
The excel sheet testcases.xlsx is used as the model-independent toolbox interface to input model-specific information and set up different cases for simulation with the MTB. The file contains 3 different sets of premade cases used by Energinet to review models in relation to the RfG (Requirements for Generators), to the DCC (Demand Connection Code) and for unit testing. It is possible to add or disable cases as needed, either in the premade case sets and in separate custom cases set that is also available. The excel sheet testcases.xlsx consists of the following tabs:
- Settings
- Area values
- RfG cases
- DCC cases
- Unit cases
- Custom cases
- Event types
- RfG cases overview
- DCC cases overview
- Unit cases overview
The Settings tab and the cases tabs will be explained in depth below. A short description for the other tabs are as follows - The tab Area values contain handling of requirement values based on the plant-specific information such as the connection point. The tab Event types describes the different types of events that the testbench is able to perform, with detail as to how the X1 and X2 is used for the specific event type. The tabs RfG cases-, DCC cases- and Unit cases overview all describe the pre-defined test cases available in each of the cases sheets.
The Settings tab is the interface to input model-specific information. Most of the inputs are straight forward and self-explanatory with additional explaination in the comment column. Note that the project name must not contain any spaces as this causes an error in the plotter Python script later on, as it is not able to find the path of the output files.
The first setting is the Casegroup, this is important as it selects which of the pre-defined case sets that are run, either the RfG-, the DCC- or the Unit case set. The Area is selected based on if the plant is connected in DK1 (Continental Europe) or DK2 (Nordic).
There are three types of SCR and corresponding X/R-ratios:
- min, corresponding to the minimum short-circuit level.
- tuning, an intermediate short-circuit level between the minimum and the maximum short-circuit level. If the tuning parameters are not needed, leaving it blank will result in the MTB omitting them from the simulation.
- max, corresponding to the maximum short-circuit level.
PSCAD Initialization time and PF flat time dictates the simulation run time before the first event is activated. When looking at the event definition in the cases tabs, time 0 will always be offset by these times in PSCAD and PowerFactory respectively. The times do not have to be identical, as the plotter tool will offset the time accordingly, ensuring the first event will always happen at time 0 when plotting.
The tescases excel document contains four
The cases sheet contains data to set up each case. Rows represent individual cases and the columns specify the setup of each of those cases. More rows can be added to run user-defined cases.
The Event Types sheet describes what the names of the events in the type columns does. For example the type "Pref" changes the active power reference value in Event 1 in the first study case where the active power is
For example, case 30 (Rank, column C) demonstrates the model's ability to step reactive power.
Firstly, the case is active (Included, column D) and will control the reactive power reference signal (QrefCtrl, column I) throughout the case. Active power is initialized to 1 p.u. (P0, column E) with reactive power control mode, Qmode = 0 (Qmode, column F). In this case, Qmode = 0 corresponds to reactive power setpoint control, this is specified in the Input sheet. The reactive power is then initialized to 0 (InitValue, column G).
Only ´QrefCtrl, column I is activated while columns H, M, N, and O are deactivated (= 0). Since the case seeks to control the reactive power setpoint, there is no need for simulating a fault, so columns J, K, and L are also deactivated (= 0).
The grid impedance is then scaled to 1 (GridImped, column P), and the total simulation time is set to 145 seconds (Tstop (s), column Q).
The reactive power setpoint is then controlled throughout the simulation, in this case only in the negative direction. This is done by specifying setpoints in the value sets in column R - AL.
- The first point (C1start + C1setpoint + C1ramp, columns R, S and T) starting at the time 3 seconds, drops the reactive power setpoint to -0.1 p.u. with no ramp, i.e. as a step.
- Next point (C2start + C2setpoint + C2ramp, columns U, V and W) starts at the time 40 seconds and drops the setpoint to -0.2 p.u. also with no ramp.
- Next point (C3start + C3setpoint + C3ramp, columns X, Y and Z) starts at the time 75 seconds and further drops the setpoint to -0.3 p.u. with no ramp.
- The final point (C4start + C4setpoint + C4ramp, columns AA, AB and AC) starts at 110 seconds, returning the reactive power setpoint to 0 p.u. in a step. Since this is the final point, the setpoint will stay unchanged until the end of the simulation.
