Table of Contents: BOSL Controllers

Table of Contents:............................................................................................................................... 1
1. Package „Free_License“ 2
Simple test procedure ..................................................................................................................
2. License Group “Free_License” ................................................................................................... 5
2.1 Exiters (AVR) ......................................................................................................................... 5
2.1.1 ESAC8C - Basler DECS model (modified).................................................................... 5
2.1.2 IEEET1 - 1968 IEEE type 1 excitation system model ................................................... 6
2.1.3 SCRX - Bus or solid fed SCR bridge excitation system model ..................................... 7
2.1.4 SEXS - Simplified excitation system model .................................................................. 8
2.2 Governors (GOV) ................................................................................................................... 9
2.2.1 HYGOV - Hydro turbine-governor model ...................................................................... 9
2.2.2 TGOV1 - Steam turbine-governor model .................................................................... 10

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 using

the Graphical Model Builder (GMB) and consist of

• Graphical model representation Æ *.vsd

• Macro description of the models Æ *.mac

Siemens PTI– Software Solutions

www.siemens.com/power technologies/software
-
BOSL Controllers – Package „Free_License“

1. Simple test procedure

After installing GMB, the BOSL controller package “Free_License” can usually be found in path
C:\Program Files\PTI\StandardModels with a sub-structure similar to fig. 1. The directory _test
contains the PSS™E test data files and the directories ESAC8C, HYGOV, IEEET1, … contain the files
*.vsd and *.mac. In the sub-directory example of the model directories, PSS™E automation files for
model test and output files are located.

Fig. 1 – Directory tree for BOSL controller package “Free_License”

Note: Before working/testing with a Standard Model it is highly recommended to copy it to a user-
defined path. Please also make sure that you have full reading/writing access to the destination
directory.

The following description shows the principle way to run GMB models in PSS™E simulations. For the
test a simple 2-bus-system shown in fig. 2 is used.

Fig. 2 – Test network (2 bus system)

After starting PSS™E you can run the automation file <model>\example\_Run.py (Æ fig. 3+4).

Fig. 3 – Invoke “Run program automation file” via the PSS™E user interface

E D SE PTI SW Ru/Bei Page 2 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

Fig. 4 – Run automation file “_Run.py” via the PSS™E user interface

After running the python script “_Run.py”, you should check if the BOSL controller was processed by
PSS™E. At first you should make sure that the “User-drawn” model has been correctly assigned to
the Generator at Bus 38 and that the model data can be reviewed (Æ fig. 5).

Fig. 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, the progress output window should contain the following
information about the processing of BOSL controllers:

MODEL IEEET1 AT BUS 38 [LT 24.000] MACHINE 1 REMOVED

PROCESSING RECORD:
'USRMBL','ESAC8C', 38,'1', 0.3, 200, 200, 200, 0.3, 0.7, 0.6, 4, 0, 1, 0, 4, 0.4, 5, 0.5 /

EXCITATION SYSTEM MODELS USE:

CONS 67- 81
VARS 4- 4

INITIAL CONDITIONS CHECK O.K.

CHANNEL OUTPUT FILE IS ESAC8C.out

E D SE PTI SW Ru/Bei Page 3 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

The channel output file can be loaded by PSS™E-31 new plotting package and the channels of
interest can be selected (Æ fig. 6). Alternatively, the results can also be viewed by starting the old
plotting program PSSPLT and running the automation file <model>\example\_Plot.idv.

Fig. 6 – Display of selected output channels by PSS™E-31 new plotting package

E D SE PTI SW Ru/Bei Page 4 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

2. License Group “Free_License”

The models of this License Group are part of the GMB delivery:
- AVR ESAC8C
- AVR IEEET1
- AVR SCRX
- AVR SEXS
- GOV HYGOV
- GOV TGOV1

2.1 Exiters (AVR)

2.1.1 ESAC8C - Basler DECS model (modified)

2.1.1.1 ESAC8C - Block Diagram

2.1.1.2 ESAC8C – Parameters

Description Default Min Max User value
TR (sec) 0.3 0.01 0.5
KP 200 0 1000
KI 1
KD 10 1 25
TD (sec) 0.03 0.01 0.1
KA 0.7
TA 0.6
VRMAX 10
VRMIN 0
TE > 0 (sec) 0.45 0.1 1
KE 0.1 0.05 1
E1 7 0 10
SE1 0.04 0 1
E2 9 0 10
SE2 0.13 0 1

2.1.1.3 ESAC8C - Example dyr-record for PSS™E

For bus 38, generator-id ‘1’ the dyr-record may be:
'USRMBL','ESAC8C', 38,'1', 0.3 200 1 10 0.03 0.7 0.6 10 0 0.45 0.1 7 0.04 9 0.13 /

E D SE PTI SW Ru/Bei Page 5 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

2.1.2 IEEET1 - 1968 IEEE type 1 excitation system model

2.1.2.1 IEEET1 - Block Diagram

EC 1 VC
ECOMP
1 + s Tr SAT
Saturation

- VERP DV VF DE EFD
VREF Ka 1
VERR
+ Efd
1 + s Ta Ke + sTe

PSS
VOTHSG
VFRZ s KF
1 + s TF1
VUEL VSS
VUEL

SIEMENS AG
VOEL Name of Controller: IEEET1
VOEL PTD SE PTI SW

Date: 18.06.2007

Name: Jian Type of Controller: EXCITER

IEEET1.mac

2.1.2.2 IEEET1 - Parameters

Description Default Min Max User value
TR (sec) 0
KA 400
TA (sec) 0.02
VRMAX or zero 7.3
VRMIN -7.3
KE or zero 1
TE (> 0) (sec) 0.8
KF 0.03
TF (> 0) (sec) 1
E1 2.9
SE (E1) 0.5
E2 3.9
SE (E2) 0.86

2.1.2.3 IEEET1 - Example dyr-record for PSS™E

For bus 38, generator-id ‘1’ the dyr-record may be:

'USRMBL','IEEET1’, 38,'1', 0 400 0.02 7.3 -7.3 1 0.8 0.03 1 2.9 0.5 3.9 0.86 /

E D SE PTI SW Ru/Bei Page 6 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

2.1.3 SCRX - Bus or solid fed SCR bridge excitation system model

2.1.3.1 SCRX - Block Diagram

XIFD
XADIFD

VOTHSG

VOEL

VUEL

EC
ECOMP

-
VREF 1+sTa K Eb
+
1 + s Tb 1 + s Te
x
OUT
Fortran
Negative current
Logic
Efd

ET MUL
ETERM

SIEMENS AG
PTD PTI SW SE
Controller name: SCRX
Date: july 17 2007
Controller type: Excitation
Name: DJB
Project: SCRX.mac

2.1.3.2 SCRX - Parameters

Description Default Min Max User value

TA/TB 1
TB (> 0) (sec) 2
K 5
TE (sec) 0.3
EMIN (pu on EFD base) 0
EMAX (pu on EFD base) 3
CSWITCH 1
rc/rfd 2

2.1.3.3 SCRX - Example dyr-record for PSS™E

For bus 38, generator-id ‘1’ the dyr-record may be:

'USRMBL','SCRX’, 38,'1', 1 2 5 0.3 0 3 1 2 /

E D SE PTI SW Ru/Bei Page 7 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

2.1.4 SEXS - Simplified excitation system model

2.1.4.1 SEXS - Block Diagram

EC VT
ECOMP K

VSPR VSPRS VTSP

#VSTP

PSS
VOTHSG

- VERR VREG EFD

VREF K(1+sT) K
+ Efd
1 + s T1 1+sT

SIEMENS AG
PTD PTI SW SE
Controller name: SEXS
Date: july 17 2007
Controller type: Excitation
Name: DJB
Project: SEXS.mac

2.1.4.2 SEXS - Parameters

Description Default Min Max User value

TE (sec) 0.05
K 200
EMIN (pu on EFD base) 0
EMAX (pu on EFD base) 4
VSTP 0
TSTP 1.00E+06
TA/TB 0.3
TB (> 0) (sec) 10

2.1.4.3 SEXS - Example dyr-record for PSS™E

For bus 38, generator-id ‘1’ the dyr-record may be:

'USRMBL','SEXS’, 38,'1', 0.05 200 0 4 0 1E6 0.3 10 /

E D SE PTI SW Ru/Bei Page 8 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

2.2 Governors (GOV)

2.2.1 HYGOV - Hydro turbine-governor model

2.2.1.1 HYGOV - Block Diagram

x
2.2.1.2 HYGOV - Parameters

Description Default Min Max User value

R 0.06 0.01 0.1
r 0.4 0.02 1
Tr 8 0.02 10
Tf 0.05 0.01 1
Tg 0.2 0.01 1
VELM 0.2 0.01 0.25
Gmax 1 -1 10
Gmin 0
Tw 1.2 -1 100
At 2.5 0.5 3
Dturb 0.3 0.0 0.5
qNL 0.5 0.01 0.5

2.2.1.3 HYGOV - dyr-record for PSS™E

For bus 38, generator-id ‘1’ the dyr-record may be:

'USRMBL','HYGOV', 38,'1', 0.06 0.4 8 0.05 0.2 0.2 1 0 1.2 2.5 0.3 0.5 /

E D SE PTI SW Ru/Bei Page 9 of 10 21.04.2008

BOSL Controllers – Package „Free_License“

2.2.2 TGOV1 - Steam turbine-governor model

2.2.2.1 TGOV1 - Block Diagram

2.2.2.2 TGOV1 - Parameters

Description Default Min Max User value

T1 0.5
VMIN 0.0
VMAX 1.0
T2 1.0
T3 1.0
DT 0
R 0.06

2.2.2.3 TGOV1 - dyr-record for PSS™E

For bus 38, generator-id ‘1’ the dyr-record may be:

'USRMBL','tgov1',38,'1', 0.5 0.0 1.0 1.0 1.0 0 0.06 /

E D SE PTI SW Ru/Bei Page 10 of 10 21.04.2008