Skip to main content

Template: Fingrid modelling instruction for PSS/E and PSCAD models & VJV2018

Preview of template's gridmo Flow showing Nodes

Last updated: 20 Mar 2024

Country:

FI

Software required:

PSS®E
PSCAD™

Source: Modelling Instructions (v2.0, 12 Jan 2024) and VJV2018 (16 Nov 2018)

This gridmo template:

  • Includes all required tests as per Appendix A and Appendix B of the Fingrid Modelling instruction for PSS/E and PSCAD models (referred to as Fingrid model requirements, version 2.0, 12.01.2024).
  • Includes additional tests to demonstrate compliance with specific sections of Fingrid Grid Code Specifications for Power Generating Facilities (VJV2018) (referred to as VJV2018)
info

In gridmo's templates, the global variable $g_max_scr corresponds with the Fingrid definition of Normal SCR and the global variable $g_min_scr corresponds with the Fingrid definition of Minimum SCR.

danger

The Fingrid model requirements specifies most tests to be completed at system normal SCR, however our template includes optional Minimum SCR tests which are disabled by default in each Loop Start Node.

The additional tests can be enabled as desired. Note these additional tests include a m suffix on the test number, e.g. Test 1.1m is the minimum SCR version of Test 1.1 as per the Fingrid model requirements.

Configuration​

To use this template:

  • Configure your global and scenario variables by using gridmo's Model setup template.
  • Download this template using the download button above and load the template into the gridmo web-app.
  • Transfer your general tab data, global variables and scenario variables across using the 'Import' buttons in the gridmo web-app.
  • Complete the below GPS-requirement-specific setup steps.
  • Generating system capability:
    • If your generating system does not support voltage control, disable the Test 1.1 row in Loop Start Node 1097.
    • If your generating system does not support reactive power control, disable the Test 1.2 row in Loop Start Node 1120.
    • If your generating system does not support power factor control, disable the Test 1.3 row in Loop Start Node 1112.
  • Test 5: Reactive power capability tests:
    • If your generating system does not support reactive power control, please contact gridmo support to discuss the template changes required - as the configuration of these tests uses reactive power control to demonstrate the reactive power capability of the generating system.
    • If your generating system uses on-load tap changers (OLTC) to achieve the full reactive power capability at the connection point, we recommend you increase the tap change time in your models to ensure the OLTC can respond to the voltage changes rapidly to avoid the requirement for extended simulation time.
  • Test 7: Fault ride-through capability tests:
    • If your generating system cannot ride through a 250 ms fault, please contact gridmo support to discuss the template changes required.
danger

Test 7: Fault ride-through capability tests

The Fingrid model requirements specifies that the LVRT tests (as part of Test 7: Fault ride-through capability tests) are to be completed at infinite SCR, however this approach can prevent low voltage ride-through mode re-triggering from being identified (that is, where the system strength is sufficiently low that reactive injection from the generating system raises the voltage above the LVRT threshold, thus disabling the control mode).

This template has been configured to complete the LVRT tests at both infinite and minimum SCR, though the minimum SCR tests are not required by the Fingrid model requirements and are therefore optional.

  • Test 8: Voltage and frequency protection trip tests:
    • Based on your voltage and frequency protection settings, you may need to extend the simulation time(s) of the PSS®E Dynamic and PSCAD™ Nodes connected to Start node 1620 to ensure the protection trips are captured.
  • Additional PSS®E and PSCAD™ tests:
    • If demonstrating compliance with PSCAD-A1 or PSSE-A1, change the global variable $g_pscad_compiler or $g_psse_version respectively, based on your available PSCAD™ compilers or PSS®E versions.

Assumptions​

  • It is unclear in the Fingrid model requirements if the PSS®E and PSCAD™ results should be benchmarked/overlaid, or displayed on separate plots. The two dynamic simulation results have been overlaid in this template, but can be separated if desired.
  • (Test 1.1 / 1.2 / 1.3): V droop / Q setpoint / Power factor set-point changes are spaced 10 seconds apart.
  • (Test 2.1, 2.2): The Fingrid model requirements do not specify the rate of change of frequency (ROCOF) deviations, nor the time duration of the frequency deviations. This template has been configured to use a 2 Hz/sec ROCOF (see Fingrid VJV2018 Section 10.2.2) and a 30 second duration for each frequency deviation.
  • (Test 3.1, 3.2): The Fingrid model requirements do not specify the rate of change of voltage of these voltage deviations, nor the time duration of the voltage deviations. This template has been configured to use an instantaneous voltage change with a 30 second duration for each voltage deviation.
  • (Test 3.3, 3.4): The Fingrid model requirements do not specify the rate of change of frequency (ROCOF) deviations, nor the time duration of the frequency deviations. This template has been configured to use a 2 Hz/sec ROCOF (see Fingrid VJV2018 Section 10.2.2) and a 30 second duration for each frequency deviation.
  • (Test 4): Compensation equipment switch-in/out logic tests If you have no dynamic compensation equipment which is not always in service as part of your generating system, then this section is not applicable and can be disabled (disable Start Node 1496).
  • (Test 6.1): The Fingrid model requirements do not specify the rate of change of voltage of these voltage deviations, nor the time duration of the voltage deviations. This template has been configured to use an instantaneous voltage change with a 30 second duration for each voltage deviation.
  • (Test 6.2): This test has been excluded from this template, as it appears to be functionally equivalent to Test 6.1.
  • (Test 5.1):
    • The Fingrid model requirements do not specify the rate of change of voltage of these voltage deviations, nor the time duration of the voltage deviations. This template has been configured to use an instantaneous voltage change with a 30 second duration for each voltage deviation.
    • It is implied by the Fingrid model requirements that Test 5.1 should be completed at both maximum reactive power and minimum reactive power, to demonstrate the full Q capability with connection point voltages between 0.90 - 1.10 pu. We have configured the template to demonstrate this.
  • (Test 5.2): The Fingrid model requirements do not specify the rate of change of voltage of these voltage deviations, nor the time duration of the voltage deviations. This template has been configured to use an instantaneous voltage change with a 15 second duration for each voltage deviation (noting the minimum 10 second requirement specified).
  • (Test 7.1.1/7.1.2): VJV2018 Table 10.1 and Table 10.2 do not specify the type of fault (balanced or unbalanced) to apply in these tests. We have assumed balanced faults for this template.
  • (Test 7.2): VJV2018 and the Fingrid model requirements does not define the time separation between faults as part of the multiple fault ride through. We have assumed a 2 second separation between faults for this template.
  • (Test 7.3, 7.4): This has been implemented as a sequence of three phase faults of 250 ms duration (the longest fault as per VJV2018 Table 10.1 and Table 10.2).
  • (Test 8.1): The point of connection voltage is ramped linearly and held at an over-voltage of 1.3 pu
  • (Test 8.2): The point of connection voltage is ramped linearly and held at an under-voltage of 0.2 pu
  • (Test 8.3): The system frequency is ramped linearly over 10 seconds and held at an over-frequency of 55 Hz
  • (Test 8.4): The system frequency is ramped linearly over 10 seconds and held at an under-frequency of 45 Hz

The Fingrid model requirements specifies the following additional model capabilities which need to be demonstrated. Not all of these tests can be demonstrated in gridmo.

Test numberDescriptionSupported by gridmo?
PSCAD-A1PSCAD™ version compatibility test and Fortran test.✅ Can be completed by changing the global variables $g_pscad_compiler and $g_pscad_compiler. For example, completing one run with gFortran and then switch $g_pscad_compiler to complete all tests again using Intel Visual Fortran.
PSCAD-A2Compatibility with other models and multiple instances❌ Possible, but typically not demonstrated in gridmo, as it requires a second PSCAD™ model of the generating system to be created with multiple of the same generating system with different settings.
PSCAD-A3Model aggregation, equipment, signals, and control modes.❌ Possible, but not built in as part of this template.
PSCAD-A4Multiple run and snapshot features❌ Possible, but a plot result from gridmo is likely insufficient evidence of multi-run and snapshot capability.
PSSE-A1(PSS®E) version compatibility 35✅ Can be completed by changing the global variable $g_psse_version. For example, completing one run in PSS®E v35.3.0 by setting $g_psse_version=35.3.0 and a second run in an alternative version.
PSSE-A2Unique model name❌ N/A as manual review of the generator's model name as per the DYRE file is required.
PSSE-A3System decimal separator❌ Toggling PSS®E's system decimal separator is not currently supported in gridmo - manual *.sav case modification is required.
PSSE-A4Initialisation (5 minute flat run)✅ Included in template.

Sources​

Template revision history​

  • 15 April 2024 (v1.4.12):
    • Updated to align with newest template Sticky Note format.
  • 20 March 2024 (v1.4.11):
    • First release.