Siemens Power Pow er Technologies Technologies International
Dynamic Modeling using the Graphical Model Builder (PSS ® GMB) Release 3.0 Du08/10/2012
www.siemens.com/energy www.siemens.co m/energy/power-technologies /power-technologies For internal use only / © Siemens AG 2012. All rights reserved.
Introduction Wh W h a t i s P SS SS® ®GMB ?
The Graphic Model Builder (PSS®GMB) is sold as a separate PSS®E add-on module to the PSS®E base that allows PSS®E users to graphically build user models for dynamic simulation without having the need to writing and compiling high level language programs (e.g. FORTRAN). PSS®GMB works with PSS®E, Rev. 30.3.2 and newer
For internal use only / © Siemens AG 2012. All rights reserved.
Introduction W h a t i s P SS ® G M B ?
PSS®GMB 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.
For internal use only / © Siemens AG 2012. All rights reserved.
Introduction W h a t i s P SS ® G M B ?
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.
For internal use only / © Siemens AG 2012. All rights reserved.
Introduction W h a t i s P SS ® G M B ?
You are free to add FORTRAN statements to your model, which are then interpreted by PSS®GMB 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 PSS®GMB) that can be handled in PSS®E is defined in the PSS®E Program Operation Manual.
For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Basics 1 VISIO Standard and VISO Profess ion al :
1VISIO
Standard and VISIO Professional are Microsoft products and are not supplied with the PSS®GMB
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.
PSS®GMB needs only VISIO Standard to work ! For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Basics PSS®GMB and NETCAD:
PSS®GMB has been originally developed as a part of NETCAD (the graphical editor for PSS®NETOMAC) 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 PSS®NETOMAC 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.
For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Basics PSS®GMB and PSS®E:
PSS®GMB has an interface to PSS®E and uses a special API to communicate with PSS®E. The data input is done via dyre records or directly with the help of the GUI of PSS®E. The initial and the momentary values of the input variables for the PSS®GMB model are coming from PSS®E The calculation of the PSS®GMB 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 PSS®E
For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Basics W o r k i n g w i t h P SS ® GM B :
Starting GMB by clicking on the icon on the windows desktop or on “Run PSS®GMB” in the windows/PSS®NetCad start menu opens the GMB- desktop showing either the last treated GMB file, e.g. c:\Prog ram files(x86)\PTI\Netcad\Getting Started\Exam ples\Exam ple1\Esac8c\Esac8c.vsd
or an empty GMB-screen For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Basics W o r k i n g w i t h PS S® G M B :
Vsd is the file extension of all PSS®GMBmodels, drawn in Visio. The filenames of PSS®GMBmodels are limited to sixteen characters plus extension, and will be used as the model name when referencing this model in the PSS®E DYRE data record. PSS®GMB additionally generates a ‘mac’ file with the same file name as the PSS®GMB file, but with extension ‘mac’. The ‘mac’ file is an ASCII file that contains the description of the controller structure.
For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Basics
W o r k i n g w i t h P S S® G M B :
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 PSS®GMB.
For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Basics
Th e Deskt op :
GMB-Menu
GMBButtons
Drawing page Stencils with shapes For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Menus T h e P SS ® G M B m e n u : B O S L
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 For internal use only / © Siemens AG 2012. All rights reserved.
PSS®GMB Menus
T h e PS S® G M B T o o l b a r 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) T oggle the BOS L s tencils
P rotect/unprotect connections E dit/change connections Copy/paste marked elements with data to/from clipboard S how the data file of the macro
The PSS®GMB BOSL buttons help to quickly reach specific BOSL-functions
For internal use only / © Siemens AG 2012. All rights reserved.
Creating a new project with PSS®GMB : S et t i n g P S S® G M B O p t i o n s
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.
Creating a new project with PSS®GMB C r e at i n g a f i l e i n a n e w d i r e ct o r y
To create a new PSS®GMB project do: 1.)Choose “File” -”New” in the GMB
menu 2.) Choose a new project directory and a new filename Note: Filenames for PSS®GMB 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.
Creating a new project with PSS®GMB U s i n g l a y er s f o r t h e n e w m o d e l
Layers can help to bring order in your PSS®GMB -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.
Creating a new project with PSS®GMB S et t i n g o f t h e s i m u l at i o n c o n t r o l
A t t e n t i o n : F o r B O S L t es t s p l e a s e ad a p t c a r e fu l l y t h e
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 PSS®E dynamic simulation.
t i m e s t e p t o t h e t im e con stants of the used c o n t r o l l er s ! For internal use only / © Siemens AG 2012. All rights reserved.
Creating a new project with PSS®GMB D r a w i ng a s i m p l e PS S® G M B - c o n t ro l l er
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 it’s 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 PSS®E: 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.
Creating a new project with PSS®GMB V er i f y in g t h e In p u t d a t a fo r t h e v a ri ab l e s
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.
Creating a new project with PSS®GMB V er i f y in g t h e In p u t d a t a fo r t h e v a ri ab l e s
You can now see the data of your variable(s) including the description with the name, which will be used in PSS®E. 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) .
Creating a new project with PSS®GMB V i ew i n g t h e m a c r o -f i l e
The macro file created automatically by PSS®GMBcan be examined by clicking on the “Show-Data-File”-button in the PSS®GMB 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.
Standalone test of the designed model R u n t h e St a n d a l o ne t e s t o f t e s t 1 .v s d
You can now verify the different signals of your model by running BOSL using “BOSL” – “Run BOSL” of the PSS®GMBmenu. Change simulation step width and shape data as desired and observe the different signals. For internal use only / © Siemens AG 2012. All rights reserved.
Using the Test Model in PSS®E simulation D Y RE D at a R e c o r d s f o r G M B M o d e l s :
To use your PSS®GMBmodel in PSS®E, 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 PSS®E simulation using the GUI of PSS®E The general structure of DYRE data records for a PSS®GMB model would look as follows: ‘USRMBL’ , ‘Model’, DS1 , DS2, DS3 /
where ‘USRMBL’ is a new keyword to be used in the PSS®E ‘DYR’ file for PSS®GMB models. Note: The name USRMBL has to be specified within single quotes. For internal use only / © Siemens AG 2012. All rights reserved.
Using the Test Model in PSS®E simulation A d d i n g P S S® G M B m o d e ls t o a P SS ® E d y n a m i c s i m u l at i o n c a s e u s i n g th e GUI of PSS®E
Since PSS®E 33 you can directly add GMB models to PSS®E
For internal use only / © Siemens AG 2012. All rights reserved.
Using the Test Model in PSS®E simulation A d d i n g P S S® G M B m o d e ls t o a P SS ® E d y n a m i c s i m u l at i o n c a s e u s i n g th e GUI of PSS®E
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.
Thank you for your attention!
For internal use only / © Siemens AG 2012. All rights reserved.