For internal use only / Siemens AG 2012. All rights reserved.
Dynamic Modeling using
the Graphical Model Builder
(PSSGMB) Release 3.0 Du08/10/2012
Siemens Power Technologies
International
www.siemens.com/energy/power-technologies
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-4
Introduction
What is PSSGMB ?
The Graphic Model Builder (PSSGMB) is sold as a separate PSSE
add-on module to the PSSE base that allows PSSE users to
graphically build user models for dynamic simulation without having the
need to writing and compiling high level language programs (e.g.
FORTRAN).
PSSGMB works with PSSE, Rev. 30.3.2 and newer
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-5
Introduction
What is PSSGMB ?
PSSGMB uses the
Microsoft Visio graphical
interface to draw and
simulate dynamic models of
exciters and turbine
governors, with other model
categories added in future
releases.
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-6
Introduction
What is PSSGMB ?
GMB provides in its library
predefined graphic elements and
their associated control model to
represent fundamental control
blocks like Time-delay, limits
summing, product, math and non-
linear functions, output, and many
additional control functions.
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-7
Introduction
What is PSSGMB ?
You are free to add FORTRAN statements to your model, which are then
interpreted by PSSGMB without the need of an additional compiler.
The total number of user-defined models (traditional FORTRAN based
user-defined models plus user-defined models created using PSSGMB)
that can be handled in PSSE is defined in the PSSE Program
Operation Manual.
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-20
VISIO Standard and VISO Professional1: 1VISIO Standard and VISIO Professional are Microsoft products and are
not supplied with the PSSGMB
With VISIO Standard, business-related diagrams such as flowcharts,
organization charts, and project scheduling diagrams can be created.
VISIO Professional contains all of what the standard edition has, plus
features which allow to create technical diagrams e.g. building plans,
network diagrams, software diagrams, Web diagrams or engineering
diagrams.
PSSGMB Basics
PSSGMB needs only VISIO Standard to work !
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-21
PSSGMB Basics
PSSGMB and NETCAD:
PSSGMB has been originally developed as a part of NETCAD (the
graphical editor for PSSNETOMAC) and is now available as the
standalone tool GMB.
NETCAD allows to completely design a power network using predefined
and user defined graphical block elements and is only a passive editor.
No calculation is done in NETCAD. After finishing the design the user
must invoke PSSNETOMAC for the simulation.
GMB is an ACTIVE editor and comprises two parts, NETCAD with an
ensemble of NETCAD-elements (especially controller blocks) to draw
the models and the BOSL engine, that performs the GMB model
calculation during simulation.
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-22
PSSGMB Basics
PSSGMB and PSSE:
PSSGMB has an interface to PSSE and uses a special API to
communicate with PSSE. The data input is done via dyre records
or directly with the help of the GUI of PSSE.
The initial and the momentary values of the input variables for the
PSSGMB model are coming from PSSE
The calculation of the PSSGMB model(s) during initialization and
simulation is done by the BOSL engine
The output of the model(s) is sent to the appropriate machine or
network element in PSSE
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-23
Starting GMB by
clicking on the
icon on the windows desktop or
on Run PSSGMB in the win-
dows/PSSNetCad start menu
opens the GMB- desktop
showing either the last treated
GMB file, e.g.
PSSGMB Basics
c:\Program files(x86)\PTI\Netcad\GettingStarted\Examples\Example1\Esac8c\Esac8c.vsd
or an empty GMB-screen
Working with PSSGMB :
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-24
PSSGMB Basics
Working with PSSGMB :
Vsd is the file extension of all PSSGMBmodels,
drawn in Visio.
The filenames of PSSGMBmodels are limited to
sixteen characters plus extension, and will be used as
the model name when referencing this model in the
PSSE DYRE data record.
PSSGMB additionally generates a mac file with
the same file name as the PSSGMB file, but with
extension mac. The mac file is an ASCII file that
contains the description of the controller structure.
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-25
PSSGMB Basics
Working with PSSGMB :
Creating a controller like shown here is pretty easy. The used shapes (in
this example, the controller blocks) are already ready for use. All you have
to do is drag them into place and connect them with connectors, add
some parameters and resize them a little bit, if necessary.
The following slides will explain, how to
use all the tools of the PSSGMB.
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-26
GMB-Menu
Stencils with
shapes
Drawing
page
GMB-
Buttons
PSSGMB Basics
The Desktop:
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-39
The PSSGMB menu: BOSL
The BOSL menu allows to:
- Run the Standalone BOSL
- Display Initial Conditions of
the block elements
- Debug Initial Conditions of
the project
- Debug Controller using Debug log
- Set BOSL Options like choice of
dropping shapes with transfer
functions or set nominal frequency
- Set BOSL Controls like Timestep
and calculation period
- Save Model to new folder
- Display Help on BOSL texts
PSSGMB Menus
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-45
The PSSGMB Toolbar
PSSGMB Menus
E dit the data of the marked shape
C hange shape IC ON to text and vise versa
C onnect links
C reate subsystem (macro in a new page or US E R master)
Toggle the BOS L stencils
P rotect/unprotect connections
split connectors to links
C opy/paste marked elements with data to/from clipboard
E dit/change connections
S how the data file of the macro
The PSSGMB BOSL buttons help to quickly reach specific
BOSL-functions
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-169
Setting PSSGMB Options:
Before starting with the design of a GMB
model, please choose the appropriate options
of the GMB menu BOSL-Options. You can
here change the non numeric prefix for shape
output labels (should be normally set to $),
set the Nominal frequency which is used as
f.0 in some BOSL shapes. You can choose
the GMB-option Start with recent file, decide
about your shape layout for standard shapes
(transfer function or DIN) and set debug
conditions.
Note: Do not forget to choose your preferred editor !
Creating a new project with PSSGMB
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-170
Creating a file in a new directory
To create a new PSSGMB project do:
1.)Choose File-New in the GMB
menu
2.) Choose a new project directory and
a new filename
Note: Filenames for PSSGMB must
be entered without extension and must
not have more than 16 characters !
Creating a new project with PSSGMB
Result:
- a new, empty drawing file with all necessary associated files
is created (.vsd,.mac,/ctl/.syn)
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-171
Using layers for the new model
Layers can help to bring order
in your PSSGMB -model.
To use layers:
1.) click on the GMB layer
button and choose New
2.) Give the new layer a name
and adapt the layer attributes
3.) Decide how many layers
you need and create them
Creating a new project with PSSGMB
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-172
Setting of the simulation control
BOSL control data can be
entered with the GMB menu
option BOSL - Controls...
from the Formatting toolbar. The
time step and End time is
needed only for BOSL
standalone runs and are not
used in PSSE dynamic
simulation.
Creating a new project with PSSGMB
Attention: For BOSL tests
please adapt carefully the
time step to the time
constants of the used
controllers !
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-173
Drawing a simple PSSGMB -controller
To create the simple GMB controller on the
left please open a new file test1 and:
1.) Drop the standard shape Input
(ECOMP) on the drawing page and set the
Constant Output Value for Standalone to 2
2.) Add a SUM shape and set its fixed value to 0
3.) Add an INTEGRATOR with an integration time of #T1 and
Data: Def. 1, Min. 0.1,Max. 10; Description (for PSSE: T1)
4.) Add a plot shape and an Efd output shape.
5.) Choose the Simulation End Time 2.0 s and a step width of 0.01s
6.) Add an Event from the PSS_Standard stencil
Creating a new project with PSSGMB
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-174
Verifying the Input data for the variables
Click twice on the integrator shape to open the shape Data menu.
Choose now Control - Show Input Data from the Data toolbar to
show a new window with all variable data (see next slide).
Creating a new project with PSSGMB
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-175
Verifying the Input data for the variables
You can now see the data of your variable(s) including the description
with the name, which will be used in PSSE.
You can also change the order of the variables (is initially sorted
according to the data input) .
Creating a new project with PSSGMB
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-176
Viewing the macro-file
The macro file created automatically by PSSGMBcan be
examined by clicking on the Show-Data-File-button in the
PSSGMB Toolbar. This will open the macro-file (Test1.mac) with
the editor you have configured in the GMB menu BOSL-Options.
Creating a new project with PSSGMB
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-180
Run the Standalone test of test1.vsd
You can now verify the different signals of your model by running
BOSL using BOSL Run BOSL of the PSSGMBmenu.
Change simulation step width and shape data as desired and
observe the different signals.
Standalone test of the designed model
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-185
DYRE Data Records for GMB Models:
To use your PSSGMBmodel in PSSE, you must place the mac
and vsd files in your working directory and create (or change) the
DYRE file for your dynamic simulation. Another possibility is to add
your model to your PSSE simulation using the GUI of PSSE
The general structure of DYRE data records for a PSSGMB model
would look as follows:
USRMBL , Model, DS1 , DS2, DS3 /
where USRMBL is a new keyword to be used in the PSSE DYR
file for PSSGMB models.
Note: The name USRMBL has to be specified within single quotes.
Using the Test Model in PSSE simulation
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-193
Adding PSSGMB models to a PSSE dynamic simulation case using
the GUI of PSSE Since PSSE 33 you can directly add GMB models to PSSE
Using the Test Model in PSSE simulation
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 0-194
Adding PSSGMB models to a PSSE dynamic simulation case using
the GUI of PSSE 1.) Open snapshot (via "File" "Open"
and select the snapshot file option
from the pull down menu) and open
the file esac8c.snp in the
"/Example1/"- folder.
2.) Add the new controller to your
machine by doing a "RIGHT"-click on
the cell, where you want to place a
new controller (e.g. EXCITER machine
GENCLS). Choose "ADD/REPLACE
MODEL" in the appearing menu and
choose then the desired GMB model.
You must then enter all the values for
the model CONs and ICONs.
Using the Test Model in PSSE simulation
IC SG SE PTI
For internal use only / Siemens AG 2012. All rights reserved.
Siemens Power Transmission & Distribution, Inc., PSSGMB 2012-03 Author Page 215
Thank you for your attention!
For internal use only / Siemens AG 2012. All rights reserved.
Top Related