bosl controllers package 'free license' - energy · bosl controllers package...

BOSL Controllers Package „Free_License“

GMB Dynamic Models for PSS® Software Product Suite

Revision 1.8 / March 2013

Table of Contents

List of Figures .............................................................................................................................. 3

Revision History ........................................................................................................................... 4

1 Introduction ....................................................................................................................... 5

2 License Group “Free_License”............................................................................................ 5

2.1 Exiters (AVR).............................................................................................................. 6 2.1.1 ESAC8B_gmb - Basler DECS Model .................................................................... 6 2.1.2 IEEET1_gmb - 1968 IEEE Type 1 Excitation System Model ................................. 8 2.1.3 SCRX_gmb - Bus or Solid Fed SCR Bridge Excitation System Model..................... 9 2.1.4 SEXS_gmb - Simplified Excitation System Model ............................................. 10

2.2 Governors (GOV) ..................................................................................................... 11 2.2.1 HYGOV_gmb - Hydro Turbine-Governor Model ............................................... 11 2.2.2 TGOV1_gmb - Steam Turbine-Governor Model ............................................... 12

2.3 Stabilizer Models (STAB)........................................................................................... 13 2.3.1 STAB1_gmb - Speed Sensitive Stabilizing Model.............................................. 13 2.3.2 STAB2A_gmb - ASEA Power Sensitive Stabilizer Model .................................... 14

2.4 Compensator Models ............................................................................................... 15 2.4.1 COMP_gmb - Voltage Regulator Current Compensating Model........................ 15

2.5 Excitation Limiter..................................................................................................... 16 2.5.1 MNLEX1_gmb - Minimum Excitation Limiter ................................................... 16 2.5.2 MAXEX1_gmb - Maximum Excitation Limiter .................................................. 17

2.6 Generic Network Element (GNE) .............................................................................. 18 2.6.1 GNE-Y4_UNSYM_gmb – Unsymmetrical Four-Pole .......................................... 18

3 Test procedure ................................................................................................................. 19

3.1 PSS®E ...................................................................................................................... 19 3.2 PSS®NETOMAC ........................................................................................................ 22 3.3 PSS®SINCAL ............................................................................................................. 26

Revision 1.8 / December 2012 of 29

List of Figures

Figure 1 Directory tree for BOSL controller package “Free_License”......................................... 19 Figure 2 PSS®E test network (3 bus system)........................................................................... 19 Figure 3 Invoke “Run program automation file” via the PSS®E user interface ........................... 20 Figure 4 Run automation file “_Run.py” via the PSS®E user interface .................................... 20 Figure 5 Check the BOSL Controller processing by PSS®E........................................................ 20 Figure 6 Display of selected output channels by PSS®E-33...................................................... 21 Figure 7 PSS®NETOMAC test network (3 bus system) ............................................................. 22 Figure 8 Open the example network “_test.net” ................................................................ 22 Figure 9 Results output “Screen” ............................................................................................ 23 Figure 10 Starting the simulation............................................................................................ 23 Figure 11 PSS®NETOMAC Simulation results ........................................................................... 24 Figure 12 Used PSS®GMB models in the “_test.net” example .............................................. 24 Figure 13 Changes the plot settings........................................................................................ 25 Figure 14 Select Output-Functions in PSS®NETOMAC.............................................................. 25 Figure 15 Open the example network “_test.sin” ............................................................... 26 Figure 16 Menu “Options”....................................................................................................... 26 Figure 17 Settings the local path for PSS®GMB models............................................................ 27 Figure 18 Example network .................................................................................................... 27 Figure 19 Mask: Synchronous machine ................................................................................... 28 Figure 20 Mask for defining new dynamic model .................................................................... 28 Figure 21 Starting dynamic simulation.................................................................................... 28 Figure 22 PSS®SINCAL simulation results ................................................................................ 29


Revision History

Date Revision Author Description

2008-01-30 1.1 Ruhle Initial Revision

2008-05-01 1.2 Beissler Test procedure updated + table of contents added

2010-12-22 1.3 Medak Update

2011-06-24 1.4 Medak Update

2011-10 1.5 Angelov Minor Fixes

2012-03 1.6 Lin Update

2012-10-22 1.7 Angelov Release October 2012

2013-03-27 1.8 Medak Minor corrections to the documentation, STAB1_gmb model added


1 Introduction

Documentation of the available “User-drawn” BOSL controllers for the PSS® Product Suite, namely: PSS®E PSS®SINCAL PSS®NETOMAC The dynamic models described here are built with the Graphical Model Builder (GMB) and consist of: Graphical model representation *_gmb.vsd BOSL Macro description *_gmb.mac Controller block diagram *_gmb.jpg General Notes: Dear user. All example descriptions included in this document are created under Windows XP operation system. If a different operation system is running, for example Windows Vista or Windows 7, please copy the complete folder “…\Program Files\PTI\NetCad\StandardModels” including subfolders to a working directory, with full write and read access. During the software operation the program pre-requires a write and read access to these folders; if this permission is not given a run time error may occur.

2 License Group “Free_License” The models of this License Group are part of the GMB delivery. All model names end with “_gmb” to show very clearly, that these models are GMB-models and not for example PSS®E Standard Models. AVR ESAC8B_gmb AVR IEEET1_gmb AVR SCRX_gmb AVR SEXS_gmb GOV HYGOV_gmb GOV TGOV1_gmb STAB STAB2A_gmb COMP COMP_gmb UEL MNLEX1_gmb OEL MAXEX1_gmb GNE-Y4 GNE-Y4_UNSYM_gmb


2.1 Exiters (AVR)

2.1.1 ESAC8B_gmb - Basler DECS Model

2.1.1.1 ESAC8B_gmb - Block Diagram

2.1.1.2 ESAC8B_gmb - Parameters

Description Default Min Max User value

TR (sec) 0,1 0 0,49

KP 10,01 10,01 499,99

KI 10,01 10,01 499,99

KD 10,01 10,01 499,99

TD (sec) 0,4 0 0,49

KA 1 0,01 1

TA 0,1 0 1

VRMAX or zero 10 0,01 10

VRMIN -0,99 -0,99 1,49

TE > 0 (sec) 0,1 0

KE or zero 0,1 -1 1

E1 4 0

SE (E1) 0,4 0 0,99

E2 5 0

SE (E2) 0,5 0


2.1.1.3 ESAC8B_gmb - Example dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'ESAC8B_gmb', 38, '1', 0.1 10.01 10.01 10.01 0.4 1 0.1 10 -0.99 0.1 0.1 4 0.4 5 0.5 /


2.1.2 IEEET1_gmb - 1968 IEEE Type 1 Excitation System Model

2.1.2.1 IEEET1_gmb - Block Diagram

2.1.2.2 IEEET1_gmb - Parameters


TR (sec) 0,1 0 0,49

KA 100 10,01 499,99

TA (sec) 0,02 0 0,99

VRMAX or zero 7,3 0,51 9,99

VRMIN -7,3 -9,99 -0,01

KE or zero 1 -1 1

TE (> 0) (sec) 0,1 0,041 0,99

KF 0,03 0,01 0,29

TF (> 0) (sec) 1 0,041 1,49

Switch 0

E1 2,9 0

SE (E1) 0,5 0 0,99

E2 3,9 0

SE (E2) 0,86 0

2.1.2.3 IEEET1_gmb - Example dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'IEEET1_gmb', 38, '1', 0.1 100 0.02 7.3 -7.3 1 0.1 0.03 1 0 2.9 0.5 3.9 0.86 /


2.1.3 SCRX_gmb - Bus or Solid Fed SCR Bridge Excitation System Model

2.1.3.1 SCRX_gmb - Block Diagram

2.1.3.2 SCRX_gmb - Parameters


TA/TB 0,29 0,051 0,29

TB (> 0) (sec) 5.01 5,01 24,99

K 50,01 50,01 399,99

TE (sec) 0,3 0 0,99

EMIN (pu on EFD base) -4,99 -4,99 0

EMAX (pu on EFD base) 6 2,01 9,99

CSWITCH 1 0 1

rc/rfd 2 0 10

2.1.3.3 SCRX_gmb - Example dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'SCRX_gmb', 38, '1', 0.29 5.01 50.01 0.3 -4.99 6 1 2 /


2.1.4 SEXS_gmb - Simplified Excitation System Model

2.1.4.1 SEXS_gmb - Block Diagram

2.1.4.2 SEXS_gmb - Parameters


TA/TB 0,99 0,051 0,99

TB (> 0) (sec) 5,01 5,01 19,99

K 50 20,01 100

TE (sec) 0,05 0 0,49

EMIN (pu on EFD base) 0 0 0

EMAX (pu on EFD base) 4 3 6

2.1.4.3 SEXS_gmb - Example dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'SEXS_gmb', 38, '1', 0.99 5.01 50 0.05 0 4 /


2.2 Governors (GOV)

2.2.1 HYGOV_gmb - Hydro Turbine-Governor Model

2.2.1.1 HYGOV_gmb - Block Diagram

2.2.1.2 HYGOV_gmb - Parameters


R, permanent droop 0,06 0,01 0,09

r, temporary droop 0,4 0,01 1,99

Tr (>0) governor time constant 8 0,041 29,99

Tf (>0) filter time constant 0,05 0,041 0,09

Tg (>0) servo time constant 0,2 0,041 0,99

+ VELM, gate velocity limit 0,2 0,01 0,29

GMAX, maximum gate limit 0,99 0,01 0,99

GMIN, minimum gate limit 0,01 0 0,99

TW (>0) water time constant 1,2 0,51 2,99

At, turbine gain 1,49 0,81 1,49

Dturb, turbine damping 0,3 0 0,49

qNL, no load flow 0,14 0 0,14

2.2.1.3 HYGOV_gmb - dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'HYGOV_gmb', 38, '1', 0.06 0.4 8 0.05 0.2 0.2 0.99 0.01 1.2 1.49 0.3 0.14 /


2.2.2 TGOV1_gmb - Steam Turbine-Governor Model

2.2.2.1 TGOV1_gmb - Block Diagram

2.2.2.2 TGOV1_gmb - Parameters


R 0,06 0,01 0,099 T1 (>0) (sec) 0,49 0,041 0,49 VMAX 1 0,51 1,19 VMIN 0 0 0,99 T2 (sec) 1 0 T3 (>0) (sec) 1 0,041 9,99 Dt 0 0 0,49

2.2.2.3 TGOV1_gmb - dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'TGOV1_gmb', 38, '1', 0.06 0.49 1 0 1 1 0 /


2.3 Stabilizer Models (STAB)

2.3.1 STAB1_gmb - Speed Sensitive Stabilizing Model

2.3.1.1 STAB1_gmb - Block Diagram

2.3.1.2 STAB1_gmb - Parameters


K/T 1 T (sec) (>0) 0,05 T1/T3 5 T3 (sec) (>0) 0,05 T2/T4 1 T4 (sec) (>0) 0,05 HLIM 0,03

2.3.1.3 STAB1_gmb - dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'STAB1_gmb', 38, '1', 1 0.05 5 0.05 1 0.05 0.03 /


2.3.2 STAB2A_gmb - ASEA Power Sensitive Stabilizer Model

2.3.2.1 STAB2A_gmb - Block Diagram

2.3.2.2 STAB2A_gmb - Parameters


K2 1 0,0001 1000 T2 (sec) ( > DELT) 0,1 0,0001 1000 K3 1 0,0001 1000 T3 (sec) ( > DELT) 0,0085 0 1000 K4 1 0,0001 1000 K5 1 0,0001 1000 T5 (sec) ( > DELT) 0,1 0 1000 HLIM 10 0,01 1000

2.3.2.3 STAB2A_gmb - dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'STAB2A_gmb', 38, '1', 1 0.1 1 0.0085 1 1 0.1 10 /


2.4 Compensator Models

2.4.1 COMP_gmb - Voltage Regulator Current Compensating Model

2.4.1.1 COMP _gmb - Block Diagram

2.4.1.2 COMP_gmb - Parameters


Xe 0,1 -100,0 100,0

2.4.1.3 COMP_gmb - dyr-record for PSS®E

For bus 38, generator-id ‘1’ the dyr-record may be: 'USRMBL', 'COMP_gmb', 38, '1', 0.1 /


2.5 Excitation Limiter

2.5.1 MNLEX1_gmb - Minimum Excitation Limiter

2.5.1.1 MNLEX1_gmb - Block Diagram

2.5.1.2 MNLEX1_gmb - Parameters


KF2 0,1 0,0001 0,3

TF2 (> 4*DELT) 0,1 0,0001 1,5

KM 2 0,0001 5

TM (sec) 0,1 0 0,5

MELMA 0,1 0 0,2

K 2 0,0001 10

2.5.1.3 MNLEX1_gmb - dyr-record for PSS®E

For bus 38. generator-id ‘1’ the dyr-record may be: 'USRMBL', 'MNLEX1_gmb', 38, '1', 0.1 0.1 2 0.1 0.1 2 /


2.5.2 MAXEX1_gmb - Maximum Excitation Limiter

2.5.2.1 MAXEX1_gmb - Block Diagram

2.5.2.2 MAXEX1_gmb - Parameters


EFDRA 1 0,7 1,3

EFD1 1,1 1 2

TIME1 120 40 120

EFD2 1,2 1 2

TIME2 40 40 120

EFD3 1,5 1 2

TIME3 15 15 120

EFDDE 0,9 0,8 1,2

KMX 0,01 0,001 1

VLOW -0,3 -0,5 0

2.5.2.3 MAXEX1_gmb - dyr-record for PSS®E

For bus 38. generator-id ‘1’ the dyr-record may be: 'USRMBL', 'MAXEX1_gmb', 38, '1', 1 1.1 120 1.2 40 1.5 15 0.9 0.01 -0.3 /


2.6 Generic Network Element (GNE)

2.6.1 GNE-Y4_UNSYM_gmb – Unsymmetrical Four-Pole

2.6.1.1 GNE-Y4_UNSYM_gmb - Block Diagram

2.6.1.2 GNE-Y4_UNSYM_gmb - Parameters


R12

X12

G10

B10

R21

X21

G20

B20

2.6.1.3 GNE-Y4_UNSYM_gmb - raw-record for PSS®E

raw-record may be: "GNE-Y4 ","GNE-Y4_UNSYM_GMB",2, 29, 39, 8, 0, 0 1, 1, 29 0.00000E+00, 2.25200E-02, 0.00000E+00, 0.00000E+00, 0.00000E+00, 2.25200E-02, 0.00000E+00, 0.00000E+00


3 Test procedure 3.1 PSS®E After having installed GMB, the BOSL controller package “Free_License” can normally be found in the path “…\Program Files\PTI\StandardModels” with a sub-structure similar to Figure 1. The directory _test contains the PSS®E test data files and the directories ESAC8B_gmb, HYGOV_gmb, IEEET1_gmb… contain the files *.vsd, *.mac, *.jpg and *.dyr. In the sub-directory example of the model directories PSS®E automation files for model test and output files are located.

Figure 1 Directory tree for BOSL controller package “Free_License” Note: Before working/testing with the controllers included into the Standard Model library it is highly recommended to copy it to a user-defined path. Make also sure that you have full read/write rights on the destination directory. The following description shows the principle way how to run GMB models in PSS®E simulations. For the test a simple 3-bus-system shown in Figure 2 is used.

Figure 2 PSS®E test network (3 bus system) After having started PSS®E you can run the automation file <model>\example_<model>\_Run.py ( Figure 3+4).


Figure 3 Invoke “Run program automation file” via the PSS®E user interface

Figure 4 Run automation file “_Run.py” via the PSS®E user interface After the python script “_Run.py” has run, you should check if the BOSL controller was processed by PSS®E. At first you should see that the “User-drawn” model was correctly assigned to the generator at bus 38 and also if the model data can be reviewed ( Figure 5).

Figure 5 Check the BOSL Controller processing by PSS®E


Note: If the “user-drawn” model and its parameters are not shown in the PSS®E user interface then the progress output window has to be checked for any error reporting. In case of a successful PSS®E run, you should find the following information about the processing of BOSL controllers in the progress output window: PTI INTERACTIVE POWER SYSTEM SIMULATOR--PSS®E FRI, MAY 13 2011 12:35 SINGLE MACHINE X INFINITE BUS E D SE PTI SW / BOSL CONTROLLERS PACKAGE "FREE_LICENSE" INITIAL CONDITION LOAD FLOW USED 1 ITERATIONS ----------------------------- MACHINE INITIAL CONDITIONS ----------------------------- BUS# X-- NAME --X BASKV ID ETERM EFD POWER VARS P.F. ANGLE ID IQ 38 LT 24.000 1 1.0000 1.2386 43.90 93.54 0.4249 2.19 0.0427 0.0186 39 BUS 400.00 1 0.9800 0.9800 -43.89 -91.11-0.4340 -0.00-0.0001-0.0000 INITIAL CONDITIONS CHECK O.K. Channel output file is "example_ESAC8B_gmb.out" Channel output file is "example_ESAC8B_gmb.out"

The channel output file can be loaded by PSS®E-33 plotting package and the channels of interest can be selected ( Figure 6).

Figure 6 Display of selected output channels by PSS®E-33


3.2 PSS®NETOMAC After having installed PSS®GMB, the BOSL controller package “Free_License” can normally be found in the path “…\Program Files\PTI\StandardModels”. The following description shows the principle way how to use GMB models in PSS®NETOMAC simulations. For the test a simple 3-bus-system shown in Figure 7 is used.

Figure 7 PSS®NETOMAC test network (3 bus system) 1. Start PSS®NETOMAC

2. Open the example file “_test.net”

Go to: File > Open (F2)

Figure 8 Open the example network “_test.net”

The example network could be found default under the following location: “…\ProgramFiles\PTI\NetCad\StandardModels\Free_License\_test\PSS®NETOMAC\_test.net”


3. Output of the simulation results

Please select the “Screen” calculation results output as shown below (Figure 8):

Figure 9 Results output “Screen”

4. Start simulation Go to: Simulation > Output options ignored, with graphic (F5) or click on the icon “Simulation” as shown in Figure 9

Figure 10 Starting the simulation

The simulation results will be automatically shown on your screen.


Figure 11 PSS®NETOMAC Simulation results

5. Changing the used PSS®GMB models The information of the used PSS®GMB model in this example can be edited in the file “_test.net”. To change the model open the “_test.net” file using a text editor program, for example Notepad. You can see the definition of the macro file in section “Macro”, as shown below:

Figure 12 Used PSS®GMB models in the “_test.net” example


To change the model simply define the path where your new *.mac file is located. For example, if your *.mac-file is located in “D:\ESAC8B_gmb.mac”, you can specify the following path in your *.net file “#D:\ESAC8B_gmb.mac”. Detailed information can be found in the “PSS®NETOMAC operation manual” guide. 6. Changing the plot sheets To change plots displayed after the calculation on your screen you can use Online-Edit tool.

Go to: Options > Online-Edit > Output or click on the icon “Online-Edit-Output”

Figure 13 Changes the plot settings

After selecting Online-Edit you can change the quantities which can be displayed as follows:

Figure 14 Select Output-Functions in PSS®NETOMAC


3.3 PSS®SINCAL After having installed PSS®GMB, the BOSL controller package “Free_License” can normally be found in the path “…\Program Files\PTI\StandardModels”. The following description shows the principle way how to use GMB models in PSS®SINCAL simulations. 1. Start PSS®SINCAL 2. Open the example file “_test.sin” Go to: File > Open or use the keyboard shortcut “Ctrl+O”

Figure 15 Open the example network “_test.sin” The example network could be found default under the following location: “…\ProgramFiles\PTI\NetCad\StandardModels\Free_License\_test\PSS®SINCAL\_test.sin” 3. Predefine the PSS®GMB-models search path Set the path to your GMB model: Go to: Extras > Options…

Figure 16 Menu “Options”


Select “Actual Standard Databases” and define the local path for the PSS®GMB models. Example path can be defined as on the picture below.

Figure 17 Settings the local path for PSS®GMB models 4. Loading a GMB model Select the synchronous machine on which the GMB model should be used by double-click.

Figure 18 Example network


After selecting the element a settings mask will appear. Please go to the tab “Dynamics”. Select the checkbox in the right corner to turn on the usage of a GMB controller, for example, the “Voltage Controller”. By clicking on the button “play” the specific controller parameters can be shown and edited (see Figure 19).

Figure 19 Mask: Synchronous machine

Figure 20 Mask for defining new dynamic model

5. Start simulation Go to: Calculate > Dynamics > Stability

Figure 21 Starting dynamic simulation



The simulation results will be automatically shown on your screen.

Figure 22 PSS®SINCAL simulation results

bosl controllers package 'free license' - energy · bosl controllers package...

Documents