GMB Training 2014 Indien

Siemens Power Technologies
International
Dynamic Modeling using

the Graphical Model Builder
(PSSGMB)
Release 3.0 Du08/10/2012
www.siemens.com/energy/power-technologies
For internal use only / Siemens AG 2012. All rights reserved.
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
0-4

IC SG SE PTI
Siemens Power Transmission & Distribution, Inc., PSSGMB
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.
0-5

IC SG SE PTI
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 nonlinear functions, output, and many
additional control functions.
0-6

IC SG SE PTI
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.
0-7

IC SG SE PTI
PSSGMB Basics
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 needs only VISIO Standard to work !
0-20

IC SG SE PTI
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.
0-21

IC SG SE PTI
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
0-22

IC SG SE PTI
PSSGMB Basics
Working with PSSGMB :
Starting GMB by
clicking on the
icon on the windows desktop or
on Run PSSGMB in the windows/PSSNetCad start menu
opens the GMB- desktop
showing either the last treated
GMB file, e.g.
c:\Program files(x86)\PTI\Netcad\GettingStarted\Examples\Example1\Esac8c\Esac8c.vsd
or an empty GMB-screen
0-23

IC SG SE PTI
PSSGMB Basics
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.
0-24

IC SG SE PTI
PSSGMB Basics
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.
0-25

IC SG SE PTI
PSSGMB Basics
The Desktop:
GMB-Menu
GMBButtons
Drawing
page
Stencils with
shapes
0-26

IC SG SE PTI
PSSGMB Menus
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
0-39

IC SG SE PTI
PSSGMB Menus
The PSSGMB Toolbar
E dit the data of the marked shape
C hange shape IC ON to text and vise versa
C onnect links
split connectors to links
C reate subsystem (macro in a new page or US E R master)
Toggle the B OS L stencils
P rotect/unprotect connections
E dit/change connections
C opy/paste marked elements
with data to/from clipboard
S how the data file of the macro
The PSSGMB BOSL buttons help to quickly reach specific

BOSL-functions
0-45

IC SG SE PTI
Creating a new project with PSSGMB

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 !

IC SG SE PTI
0-169 Siemens Power Transmission & Distribution, Inc., PSSGMB

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 !
Result:
- a new, empty drawing file with all necessary associated files
is created (.vsd,.mac,/ctl/.syn)
IC SG SE PTI

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

IC SG SE PTI

Setting of the simulation control
Attention: For BOSL tests

please adapt carefully the
time step to the time
constants of the used
controllers !
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.

IC SG SE PTI

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
IC SG SE PTI

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).
IC SG SE PTI

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) .
IC SG SE PTI

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.
IC SG SE PTI
Standalone test of the designed model

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.
IC SG SE PTI
Using the Test Model in PSSE simulation

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.
IC SG SE PTI

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

IC SG SE PTI

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
theFormodel
CONs
ICONs.
internal use
only / and
Siemens
AG 2012. All rights reserved.
IC SG SE PTI
Thank you for your attention!
Page 215

2012-03
IC SG SE PTI
Siemens Power Transmission &Author
Distribution, Inc., PSSGMB

GMB Training 2014 Indien

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

GMB Training 2014 Indien

Uploaded by

Copyright:

Available Formats

Siemens Power Technologies

Dynamic Modeling using

For internal use only / Siemens AG 2012. All rights reserved.

For internal use only / Siemens AG 2012. All rights reserved.

For internal use only / Siemens AG 2012. All rights reserved.

For internal use only / Siemens AG 2012. All rights reserved.

PSSGMB needs only VISIO Standard to work !

For internal use only / Siemens AG 2012. All rights reserved.

For internal use only / Siemens AG 2012. All rights reserved.

For internal use only / Siemens AG 2012. All rights reserved.

For internal use only / Siemens AG 2012. All rights reserved.

Vsd is the file extension of all PSSGMBmodels,

For internal use only / Siemens AG 2012. All rights reserved.

The following slides will explain, how to

For internal use only / Siemens AG 2012. All rights reserved.

For internal use only / Siemens AG 2012. All rights reserved.

The BOSL menu allows to:

- Run the Standalone BOSL

For internal use only / Siemens AG 2012. All rights reserved.

The PSSGMB BOSL buttons help to quickly reach specific

For internal use only / Siemens AG 2012. All rights reserved.

Creating a new project with PSSGMB

Note: Do not forget to choose your preferred editor !

Creating a new project with PSSGMB

Creating a new project with PSSGMB

Layers can help to bring order

For internal use only / Siemens AG 2012. All rights reserved.

Creating a new project with PSSGMB

Attention: For BOSL tests

BOSL control data can be

For internal use only / Siemens AG 2012. All rights reserved.

Creating a new project with PSSGMB

To create the simple GMB controller on the

Creating a new project with PSSGMB

Creating a new project with PSSGMB

Creating a new project with PSSGMB

The macro file created automatically by PSSGMBcan be

Standalone test of the designed model

Using the Test Model in PSSE simulation

To use your PSSGMBmodel in PSSE, you must place the mac

Using the Test Model in PSSE simulation

For internal use only / Siemens AG 2012. All rights reserved.

Using the Test Model in PSSE simulation

Thank you for your attention!

For internal use only / Siemens AG 2012. All rights reserved.

You might also like