bosl controllers package 'free license' - energy · bosl controllers package...
TRANSCRIPT
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 Page 2 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 1.8 / December 2012 Page 3 of 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
Revision 1.8 / December 2012 Page 4 of 29
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
Revision 1.8 / December 2012 Page 5 of 29
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
Revision 1.8 / December 2012 Page 6 of 29
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 /
Revision 1.8 / December 2012 Page 7 of 29
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
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 8 of 29
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
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 9 of 29
2.1.4 SEXS_gmb - Simplified Excitation System Model
2.1.4.1 SEXS_gmb - Block Diagram
2.1.4.2 SEXS_gmb - Parameters
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 10 of 29
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
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 11 of 29
2.2.2 TGOV1_gmb - Steam Turbine-Governor Model
2.2.2.1 TGOV1_gmb - Block Diagram
2.2.2.2 TGOV1_gmb - Parameters
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 12 of 29
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
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 13 of 29
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
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 14 of 29
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
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 15 of 29
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
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 16 of 29
2.5.2 MAXEX1_gmb - Maximum Excitation Limiter
2.5.2.1 MAXEX1_gmb - Block Diagram
2.5.2.2 MAXEX1_gmb - Parameters
Description Default Min Max User value
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 /
Revision 1.8 / December 2012 Page 17 of 29
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
Description Default Min Max User value
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
Revision 1.8 / December 2012 Page 18 of 29
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).
Revision 1.8 / December 2012 Page 19 of 29
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
Revision 1.8 / December 2012 Page 20 of 29
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
Revision 1.8 / December 2012 Page 21 of 29
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”
Revision 1.8 / December 2012 Page 22 of 29
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.
Revision 1.8 / December 2012 Page 23 of 29
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
Revision 1.8 / December 2012 Page 24 of 29
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
Revision 1.8 / December 2012 Page 25 of 29
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”
Revision 1.8 / December 2012 Page 26 of 29
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
Revision 1.8 / December 2012 Page 27 of 29
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
Revision 1.8 / December 2012 Page 28 of 29
Revision 1.8 / December 2012 Page 29 of 29
The simulation results will be automatically shown on your screen.
Figure 22 PSS®SINCAL simulation results