6. Cursor Metrics

6.0 Introduction

From MTB 2.0, a number of cursor metrics have been introduced. They are

• START returns the signal value at the start cursor time value

• END returns the signal value at the end cursor time value

• DELTA returns the delta or difference in the signal values between the start cursor time and end cursor time values

• MIN returns the minimum value of the signal between the start cursor time and end cursor time values

• MAX returns the minimum value of the signal between the start cursor time and end cursor time values

• MEAN returns the mean value of the signal between the start cursor time and end cursor time values

• GRAD_MIN returns the minimum value of the signal's numpy.gradient between the start cursor time and end cursor time values

• GRAD_MAX returns the maximum value of the signal's numpy.gradient between the start cursor time and end cursor time values

• GRAD_MEAN returns the minimum value of the signal's numpy.gradient between the start cursor time and end cursor time values

• RESPONSE returns the response delay time of the signal measured from the start cursor time until the signal has reached 10% of the DELTA value between the start cursor time and the end cursor time

• RISE_FALL returns the rise or fall time of the signal, by measuring the time from the 10% to the 90% of the DELTA value between the start cursor time and the end cursor time

• SETTLING returns the settling time of the signal, by measuring the time from the start cursor time until the signal remains within the tolerance band (default value is 2%) of the DELTA value around the END value

• QU_T1 returns the response delay time of the signal measured from the start cursor time until the signal has reached 90% of the DELTA value between the start cursor time and the _end cursor time_s RESPONSE and RISE_FALL. This allows the metric to be used directly with RfG Article 21.3 (d)(iv) from NC RfG - Nationale krav

• QU_T2 returns the response delay time of the signal measured from the start cursor time until the signal has reached 90% of the DELTA value between the start cursor time and the _end cursor time_s RESPONSE and RISE_FALL. This allows the metric to be used directly with RfG Article 21.3 (d)(iv) from NC RfG - Nationale krav

• OVERSHOOT

• FSM_DROOP

• LFSM_DROOP

• QU_DROOP

• QU_SS_TOL

• DELTA_FFC

6.1 Cursor Setup

The cursurs to be used for each Case/Rank are configured using the cursorSetup.csv file.

Column Name	Description
title	A descriptive name that would be used for the cursor metric table
rank	The case rank number for which the cursor metric table will be generated for
cursor_options	A comma separated list of cursor functions to be applied
emt_signals	A comma separated list of the EMT signals to be used by the cursor functions
rms_signals	A comma separated list of the RMS signals to be used by the cursor functions
time_ranges	A comma separated list of the cursor start- and end-times to be used, entered in pairs

Most of the cursor function only require one signal. The exceptions are FSM_DROOP and LFSM_DROOP which require an active power and a frequency signal, i.e MTB\P_pu_PoC and MTB\pll_f_hz for EMT, and meas\s:ppoc_pu and meas\s:f_hz for RMS, and QU_DROOP which require a reactive power and a voltage signal, i.e. MTB\Q_pu_PoC and MTB\meas_Vag_pu for EMT, and meas\s:qpoc_pu and meas\s:Vag_pu for RMS.

6.2 Cursor Time Ranges

The cursor time ranges define the start- and end-time of each cursor pair, e.g.

• 0.0 - the cursor functions will be applied to the time range from 0.0 s up to the end of the simulated signal
• 0.0, 10.0 - the cursor functions will be applied to the time range from 0.0 s to 10.0 s
• 0.0, 10.0, 10.0 - the cursor functions will be applied to the time range from 0.0 s to 10.0 s, and from 10.0 s up to the end of the simulated signal
• 0.0, 10.0, 10.0, 20.0 - the cursor functions will be applied to the times range from 0.0 s to 10.0 s, and from 10.0 s to 20.0 s
• 0.0, 10.0, 10.0, 20.0, 20.0 - the cursor functions will be applied to the time range from 0.0 s to 10.0 s, and from 10.0 s to 20.0 s, and from 10.0 s up to the end of the simulated signal

The cursor time ranges can overlap, but must obey that end-time > start-time, e.g.

• 0.0, 10.0, 5.0, 15.0 - the cursor functions will be applied to the times range from 0.0 s to 10.0 s, and from 5.0 s to 15.0 s

6.3 Cursor Functions

The cursor functions are defined in the file, cursor_functions.py. They are:

6.3.1 START

6.3.2 END

6.3.3 DELTA

e.g. Rank_11: ION_RfG_P_step_up_0 0_0 5

6.3.4 MIN

6.3.5 MAX

6.3.6 MEAN

e.g. Rank 7: PRE_SS_flatrun_Uctrl1

e.g. Rank 7: PRE_SS_flatrun_Uctrl1

6.3.7 GRAD_MIN

6.3.8 GRAD_MEAN

6.3.9 GRAD_MAX

e.g. Rank_11: ION_RfG_P_step_up_0 0_0 5

6.3.10 RESPONSE

6.3.11 RISE_FALL

e.g. Rank 17: ION_RfG_FSM_step1

6.3.12 SETTLING

6.3.13 QU_T1

6.3.14 QU_T2

6.3.15 OVERSHOOT

e.g. Rank 38: ION_RfG_Ucontrol_Scmin-Cursor-Reactive_power

6.3.16 FSM_DROOP

6.3.17 LFSM_DROOP

6.3.18 QU_DROOP

e.g. Rank 38: ION_RfG_Ucontrol_Scmin-Cursor-Reactive_power

6.3.19 QU_SS_TOL