BOSL Controllers Free License

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
License Group Free_License............................................................................................ 5

2.1
2.2
2.3
2.4
2.5
2.6
3
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
Governors (GOV) ..................................................................................................... 11
2.2.1 HYGOV_gmb - Hydro Turbine-Governor Model ............................................... 11
2.2.2 TGOV1_gmb - Steam Turbine-Governor Model ............................................... 12
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
Compensator Models ............................................................................................... 15
2.4.1 COMP_gmb - Voltage Regulator Current Compensating Model........................ 15
Excitation Limiter..................................................................................................... 16
2.5.1 MNLEX1_gmb - Minimum Excitation Limiter ................................................... 16
2.5.2 MAXEX1_gmb - Maximum Excitation Limiter .................................................. 17
Generic Network Element (GNE) .............................................................................. 18
2.6.1 GNE-Y4_UNSYM_gmb Unsymmetrical Four-Pole .......................................... 18
Test procedure ................................................................................................................. 19

3.1
3.2
3.3
PSSE ...................................................................................................................... 19
PSSNETOMAC ........................................................................................................ 22
PSSSINCAL ............................................................................................................. 26
Revision 1.8 / December 2012
Page 2 of 29
List of Figures
Figure 1
Figure 2
Figure 3
Figure 4
Figure 5
Figure 6
Figure 7
Figure 8
Figure 9
Figure 10
Figure 11
Figure 12
Figure 13
Figure 14
Figure 15
Figure 16
Figure 17
Figure 18
Figure 19
Figure 20
Figure 21
Figure 22
Directory tree for BOSL controller package Free_License......................................... 19

PSSE test network (3 bus system)........................................................................... 19
Invoke Run program automation file via the PSSE user interface ........................... 20
Run automation file _Run.py via the PSSE user interface .................................... 20
Check the BOSL Controller processing by PSSE........................................................ 20
Display of selected output channels by PSSE-33...................................................... 21
PSSNETOMAC test network (3 bus system) ............................................................. 22
Open the example network _test.net ................................................................ 22
Results output Screen ............................................................................................ 23
Starting the simulation............................................................................................ 23
PSSNETOMAC Simulation results ........................................................................... 24
Used PSSGMB models in the _test.net example .............................................. 24
Changes the plot settings........................................................................................ 25
Select Output-Functions in PSSNETOMAC .............................................................. 25
Open the example network _test.sin ............................................................... 26
Menu Options....................................................................................................... 26
Settings the local path for PSSGMB models............................................................ 27
Example network .................................................................................................... 27
Mask: Synchronous machine ................................................................................... 28
Mask for defining new dynamic model .................................................................... 28
Starting dynamic simulation.................................................................................... 28
PSSSINCAL simulation results ................................................................................ 29
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
Page 4 of 29
Introduction
Documentation of the available User-drawn BOSL controllers for the PSS Product Suite, namely:
PSSE
PSSSINCAL
PSSNETOMAC
The dynamic models described here are built with the Graphical Model Builder (GMB) and consist of:
Graphical model representation
BOSL Macro description
Controller block diagram
*_gmb.vsd
*_gmb.mac
*_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.
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 PSSE Standard
Models.
AVR
AVR
AVR
AVR
GOV
GOV
STAB
COMP
UEL
OEL
GNE-Y4
ESAC8B_gmb
IEEET1_gmb
SCRX_gmb
SEXS_gmb
HYGOV_gmb
TGOV1_gmb
STAB2A_gmb
COMP_gmb
MNLEX1_gmb
MAXEX1_gmb
GNE-Y4_UNSYM_gmb
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
TR (sec)
0,1
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,49
KA
0,01
TA
0,1
VRMAX or zero
10
0,01
10
VRMIN
-0,99
-0,99
1,49
TE > 0 (sec)
0,1
KE or zero
0,1
-1
E1
SE (E1)
0,4
E2
SE (E2)
0,5
User value
1
0,99
Page 6 of 29
2.1.1.3 ESAC8B_gmb - Example dyr-record for PSSE

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 /
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
TR (sec)
0,1
0,49
KA
100
10,01
499,99
TA (sec)
0,02
0,99
VRMAX or zero
7,3
0,51
9,99
VRMIN
-7,3
-9,99
-0,01
KE or zero
-1
TE (> 0) (sec)
0,1
0,041
0,99
KF
0,03
0,01
0,29
TF (> 0) (sec)
0,041
1,49
Switch
E1
2,9
SE (E1)
0,5
E2
3,9
SE (E2)
0,86
User value
0,99
2.1.2.3 IEEET1_gmb - Example dyr-record for PSSE

'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 /
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
TA/TB
0,29
0,051
0,29
TB (> 0) (sec)
5.01
5,01
24,99
50,01
50,01
399,99
TE (sec)
0,3
0,99
EMIN (pu on EFD base)
-4,99
-4,99
EMAX (pu on EFD base)
2,01
9,99
CSWITCH
rc/rfd
10
User value
2.1.3.3 SCRX_gmb - Example dyr-record for PSSE

'USRMBL', 'SCRX_gmb', 38, '1', 0.29 5.01 50.01 0.3 -4.99 6 1 2 /
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
TA/TB
0,99
0,051
0,99
TB (> 0) (sec)
5,01
5,01
19,99
50
20,01
100
TE (sec)
0,05
0,49
EMIN (pu on EFD base)
EMAX (pu on EFD base)
User value
2.1.4.3 SEXS_gmb - Example dyr-record for PSSE

'USRMBL', 'SEXS_gmb', 38, '1', 0.99 5.01 50 0.05 0 4 /
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
R, permanent droop
0,06
0,01
0,09
r, temporary droop
0,4
0,01
1,99
Tr (>0) governor time constant
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,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,49
qNL, no load flow
0,14
0,14
User value
2.2.1.3 HYGOV_gmb - dyr-record for PSSE

'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 /
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
0,06
0,01
0,099
T1 (>0) (sec)
0,49
0,041
0,49
VMAX
0,51
1,19
VMIN
0,99
T2 (sec)
T3 (>0) (sec)
0,041
9,99
Dt
0,49
User value
2.2.2.3 TGOV1_gmb - dyr-record for PSSE

'USRMBL', 'TGOV1_gmb', 38, '1', 0.06 0.49 1 0 1 1 0 /
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
K/T
T (sec) (>0)
0,05
T1/T3
T3 (sec) (>0)
0,05
T2/T4
T4 (sec) (>0)
0,05
HLIM
0,03
Min
Max
User value
2.3.1.3 STAB1_gmb - dyr-record for PSSE

'USRMBL', 'STAB1_gmb', 38, '1', 1 0.05 5 0.05 1 0.05 0.03 /
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
K2
0,0001
1000
T2 (sec) ( > DELT)
0,1
0,0001
1000
K3
0,0001
1000
T3 (sec) ( > DELT)
0,0085
1000
K4
0,0001
1000
K5
0,0001
1000
T5 (sec) ( > DELT)
0,1
1000
HLIM
10
0,01
1000
User value
2.3.2.3 STAB2A_gmb - dyr-record for PSSE

'USRMBL', 'STAB2A_gmb', 38, '1', 1 0.1 1 0.0085 1 1 0.1 10 /
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
Xe
0,1
-100,0
100,0
User value
2.4.1.3 COMP_gmb - dyr-record for PSSE

'USRMBL', 'COMP_gmb', 38, '1', 0.1 /
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
KF2
0,1
0,0001
0,3
TF2 (> 4*DELT)
0,1
0,0001
1,5
KM
0,0001
TM (sec)
0,1
0,5
MELMA
0,1
0,2
0,0001
10
User value
2.5.1.3 MNLEX1_gmb - dyr-record for PSSE

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 /
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
EFDRA
0,7
1,3
EFD1
1,1
TIME1
120
40
120
EFD2
1,2
TIME2
40
40
120
EFD3
1,5
TIME3
15
15
120
EFDDE
0,9
0,8
1,2
KMX
0,01
0,001
VLOW
-0,3
-0,5
User value
2.5.2.3 MAXEX1_gmb - dyr-record for PSSE

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 /
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 PSSE

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
Page 18 of 29
Test procedure
3.1
PSSE
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 PSSE 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 PSSE 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 PSSE simulations.
For the test a simple 3-bus-system shown in Figure 2 is used.
Figure 2 PSSE test network (3 bus system)

After having started PSSE you can run the automation file <model>\example_<model>\_Run.py
( Figure 3+4).
Page 19 of 29
Figure 3 Invoke Run program automation file via the PSSE user interface
Figure 4 Run automation file _Run.py via the PSSE user interface
After the python script _Run.py has run, you should check if the BOSL controller was processed
by PSSE. 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 PSSE
Page 20 of 29
Note: If the user-drawn model and its parameters are not shown in the PSSE user interface then
the progress output window has to be checked for any error reporting.
In case of a successful PSSE run, you should find the following information about the processing
of BOSL controllers in the progress output window:
PTI INTERACTIVE POWER SYSTEM SIMULATOR--PSSE
FRI, MAY 13 2011
SINGLE MACHINE X INFINITE BUS
E D SE PTI SW / BOSL CONTROLLERS PACKAGE "FREE_LICENSE"
12:35
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.00010.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 PSSE-33 plotting package and the channels
of interest can be selected ( Figure 6).
Figure 6 Display of selected output channels by PSSE-33
Page 21 of 29
3.2
PSSNETOMAC
After having installed PSSGMB, 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 PSSNETOMAC
simulations. For the test a simple 3-bus-system shown in Figure 7 is used.
Figure 7 PSSNETOMAC test network (3 bus system)

1. Start PSSNETOMAC
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\PSSNETOMAC\_
test.net
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.
Page 23 of 29
Figure 11 PSSNETOMAC Simulation results

5. Changing the used PSSGMB models
The information of the used PSSGMB 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 PSSGMB models in the _test.net example
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
PSSNETOMAC 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 PSSNETOMAC
Page 25 of 29
3.3
PSSSINCAL
After having installed PSSGMB, 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 PSSSINCAL
simulations.
1. Start PSSSINCAL
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\PSSSINCAL\_t
est.sin
3. Predefine the PSSGMB-models search path
Set the path to your GMB model:
Go to: Extras > Options
Figure 16 Menu Options
Page 26 of 29
Select Actual Standard Databases and define the local path for the PSSGMB models.
Example path can be defined as on the picture below.
Figure 17 Settings the local path for PSSGMB 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
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
Page 28 of 29
The simulation results will be automatically shown on your screen.
Figure 22 PSSSINCAL simulation results
Page 29 of 29

BOSL Controllers Free License

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

BOSL Controllers Free License

Transféré par

Droits d'auteur :

Formats disponibles

BOSL Controllers Package Free_License

GMB Dynamic Models for PSS Software Product Suite

Revision 1.8 / March 2013

License Group Free_License............................................................................................ 5

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

Revision 1.8 / December 2012

Directory tree for BOSL controller package Free_License......................................... 19

Revision 1.8 / December 2012

Test procedure updated + table of contents added

Release October 2012

Minor corrections to the documentation,

Revision 1.8 / December 2012

License Group Free_License

Revision 1.8 / December 2012

ESAC8B_gmb - Basler DECS Model

2.1.1.1 ESAC8B_gmb - Block Diagram

2.1.1.2 ESAC8B_gmb - Parameters

Revision 1.8 / December 2012

2.1.1.3 ESAC8B_gmb - Example dyr-record for PSSE

Revision 1.8 / December 2012

IEEET1_gmb - 1968 IEEE Type 1 Excitation System Model

2.1.2.1 IEEET1_gmb - Block Diagram

2.1.2.2 IEEET1_gmb - Parameters

2.1.2.3 IEEET1_gmb - Example dyr-record for PSSE

Revision 1.8 / December 2012

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

EMIN (pu on EFD base)

EMAX (pu on EFD base)

2.1.3.3 SCRX_gmb - Example dyr-record for PSSE

Revision 1.8 / December 2012

SEXS_gmb - Simplified Excitation System Model

2.1.4.1 SEXS_gmb - Block Diagram

2.1.4.2 SEXS_gmb - Parameters

EMIN (pu on EFD base)

EMAX (pu on EFD base)

2.1.4.3 SEXS_gmb - Example dyr-record for PSSE

Revision 1.8 / December 2012

HYGOV_gmb - Hydro Turbine-Governor Model

2.2.1.1 HYGOV_gmb - Block Diagram

2.2.1.2 HYGOV_gmb - Parameters

Tr (>0) governor time constant

Tf (>0) filter time constant

Tg (>0) servo time constant

+ VELM, gate velocity limit

GMAX, maximum gate limit

GMIN, minimum gate limit

TW (>0) water time constant

At, turbine gain

Dturb, turbine damping

qNL, no load flow

2.2.1.3 HYGOV_gmb - dyr-record for PSSE

Revision 1.8 / December 2012

TGOV1_gmb - Steam Turbine-Governor Model

2.2.2.1 TGOV1_gmb - Block Diagram

2.2.2.2 TGOV1_gmb - Parameters

2.2.2.3 TGOV1_gmb - dyr-record for PSSE

Revision 1.8 / December 2012

Stabilizer Models (STAB)

STAB1_gmb - Speed Sensitive Stabilizing Model

2.3.1.1 STAB1_gmb - Block Diagram

2.3.1.2 STAB1_gmb - Parameters

2.3.1.3 STAB1_gmb - dyr-record for PSSE