Sunteți pe pagina 1din 27

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

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


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

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


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

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

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


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

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

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


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

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

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


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

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

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


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

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

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


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

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

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


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

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.

0-24

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


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

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.

0-25

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


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

PSSGMB Basics

The Desktop:

GMB-Menu

GMBButtons

Drawing
page
Stencils with
shapes
0-26

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


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

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

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


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

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

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


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

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 !


For internal use only / Siemens AG 2012. All rights reserved.
IC SG SE PTI
0-169 Siemens Power Transmission & Distribution, Inc., PSSGMB

Creating a new project with 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)
For internal use only / Siemens AG 2012. All rights reserved.
IC SG SE PTI
0-170 Siemens Power Transmission & Distribution, Inc., PSSGMB

Creating a new project with PSSGMB


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

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


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

Creating a new project with PSSGMB


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.

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


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

Creating a new project with PSSGMB


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
For internal use only / Siemens AG 2012. All rights reserved.
IC SG SE PTI
0-173 Siemens Power Transmission & Distribution, Inc., PSSGMB

Creating a new project with PSSGMB


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).
For internal use only / Siemens AG 2012. All rights reserved.
IC SG SE PTI
0-174 Siemens Power Transmission & Distribution, Inc., PSSGMB

Creating a new project with PSSGMB


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
For internal use only / Siemens AG 2012. All rights reserved.
according to the data input) .
0-175 Siemens Power Transmission & Distribution, Inc., PSSGMB

IC SG SE PTI

Creating a new project with PSSGMB


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.
For internal use only / Siemens AG 2012. All rights reserved.
IC SG SE PTI
0-176 Siemens Power Transmission & Distribution, Inc., PSSGMB

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.
For internal use only / Siemens AG 2012. All rights reserved.
IC SG SE PTI
0-180 Siemens Power Transmission & Distribution, Inc., PSSGMB

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.
For internal use only / Siemens AG 2012. All rights reserved.
IC SG SE PTI
0-185 Siemens Power Transmission & Distribution, Inc., PSSGMB

Using the Test Model in PSSE simulation


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

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


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

Using the Test Model in PSSE simulation


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.
0-194 Siemens Power Transmission & Distribution, Inc., PSSGMB

IC SG SE PTI

Thank you for your attention!

Page 215

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


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