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 predefined 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 predefined 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 tabs for defining cases, 3 of them being the predefined sets as described earlier. The last is for setup of additional custom cases, however the former 3 can also be edited as desired.
Each of the tabs will look similar to the example below. Each row represents an individual case that is refered to by its rank in column A. Each of the other columns specify the setup of each specific case individually. What each column represents should be more or less straight forward, but never the less is described from column B to column L:
- RMS: Run case in RMS model? Is to be set either TRUE or FALSE.
- EMT: Run case in EMT model? Is to be set either TRUE or FALSE.
- Name: Name of the case.
- U0: Initial voltage level in p.u.
- P0: Initial active power reference in p.u.
- Pmode: Active power control mode.
- Qmode: Reactive power control mode.
- Qref0: Initial reactive power reference, is set based on Qmode.
- SCR0: SCR, -1 equals stiff grid.
- XR0: X/R ratio.
- Simulationtime: Simulation time of the case. Automatically accounts for initialisation time.
Followed by the first columns, the events of each simulation are defined. These are defined in groups of 4 columns going outward, grouped as a single event defined by type, time, X1 and X2. The type defines what type of event is performed and can be set equal to any of the types defined in the tab Event types, this is anything from reference changes to faults to frequency events to actual recordings to changes in SCR etc. The time defines when the specific event will occur while the X1 and X2 differs based on the event type. Please refer to the tab Event types for more information.
For each of the 3 predefined sets of cases, an overview tab is also included that provides an overall description of each case.
Let us use case rank 85 as an example. This case is used to simulate a 3ph-fault and a change in the SCR when the fault is cleared to represent e.g. a faulty line being disconnected.
Firstly, the case is only active, if the plant is not a DSO connection, since the row is colored slightly purple. If it isn't a DSO connection, the case will be run for both RMS and EMT (column B and C).
The case will be named "ION_RfG_Fault_3_SCR" (column D) and will start with an initial voltage equal to U0, in this case set based on Uc from the Settings tab (column E). In this case corresponding to 1.065 p.u. in relation to the Un.
The active power will initialize at 1 p.u. (column F) and the plant should only have the LFSM active power control mode active (column G).
The reactive power control mode is set as the plants default control mode (column H), which is defined in the Settings tab, with a reference of 0 (column I).
SCR (column J) and X/R ratio (column O) will be equal to the SCR tuning and X/R tuning defined in the Settings tab. In this case 20 and 15 respectively.
Lastly the simulation time will be 15 seconds (column L) in addition to whatever is defined as the PF flat time in the Settings tab.
The case consists of two events.
Event 1 is a 3ph-fault (column M) set to start at time 0 (column N), this corresponds to the moment the flat run period is finished. X1 is set as 5% (column O) while X2 is set as 0.150 (column P). This indicates that the 3ph-fault should result in a residual voltage of 5% or 0.05 p.u. at POC and it should last for 150 ms.
Event 2 is a change in the SCR (column Q) that will occur at time 0.149 (column R), which is 0.149 secounds after the flat run period. X1 is set as the SCR min (column S) and X2 is set as the X/R ratio min (column T), in this case both are equal to 10. This results in the SCR and X/R ratio changing after 149 ms from when the flat run period has finished.
The simulation will continue for a total of 15 seconds, excluding the flat run period defined in the Settings tab.