Professional Documents
Culture Documents
DIgSILENT
PowerFactory 15
User Manual
D
I
G
SILENT
PowerFactory
DIgSILENT PowerFactory
Version 15
User Manual
Online Edition
DIgSILENT GmbH
Gomaringen, Germany
April 2013
Publisher:
DIgSILENT GmbH
Heinrich-Hertz-Strae 9
72810 Gomaringen / Germany
Tel.: +49 (0) 7072-9168-0
Fax: +49 (0) 7072-9168-88
Please visit our homepage at:
http://www.digsilent.de
Copyright DIgSILENT GmbH
All rights reserved. No part of this
publication may be reproduced or
distributed in any form without permission
of the publisher.
April 2013
r766
Contents
I General Information 1
1 About this Guide 3
1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Contents of the User Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Used Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 Contact 5
2.1 Direct Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2 General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3 Documentation and Help System 7
4 PowerFactory Overview 9
4.1 General Concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.2 Database, Objects, and Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.3 PowerFactory Simulation Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.4 General Design of PowerFactory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
4.5 Type and Element Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.6 Data Arrangement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.6.1 Global Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.6.2 Project Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.6.3 Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.6.4 Network Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.6.5 Operation Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.6.6 Study Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.6.7 Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
DIgSILENT PowerFactory 15, User Manual i
CONTENTS
4.7 Project Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.7.1 Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.7.2 Branches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.7.3 Cubicles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.7.4 Switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.7.5 Substations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.7.6 Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.7.7 Branch Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.8 User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
4.8.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
4.8.2 Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.8.3 Main Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.8.4 The Output Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.9 DIgSILENT Programming Language (DPL) Scripts . . . . . . . . . . . . . . . . . . . . . . 28
II Administration 31
5 Program Administration 33
5.1 Program Installation and Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.2 The Log-on Dialogue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.2.1 Log On Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.2.2 License Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.2.3 Network Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.2.4 Database Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.2.5 Advanced Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.2.6 Appearance Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.3 Housekeeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.3.2 Conguring permanently logged-on users . . . . . . . . . . . . . . . . . . . . . . 37
5.3.3 Conguring housekeeping tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.3.4 Conguring deletion of old projects . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.3.5 Conguring purging of projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5.3.6 Conguring emptying of recycle bins . . . . . . . . . . . . . . . . . . . . . . . . . 40
ii DIgSILENT PowerFactory 15, User Manual
CONTENTS
5.3.7 Monitoring Housekeeping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
5.3.8 Summary of Housekeeping Deployment . . . . . . . . . . . . . . . . . . . . . . . 40
6 User Accounts, User Groups, and Proles 41
6.1 PowerFactory Database Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.2 The Database Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.3 Creating and Managing User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.4 Creating User Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.5 Creating Proles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
6.5.1 Tool Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
6.5.2 Conguration of Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
6.5.3 Conguration of Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.5.4 Conguration of Dialogue Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.5.5 Conguration of Dialogue Parameters . . . . . . . . . . . . . . . . . . . . . . . . 49
6.5.6 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7 User Settings 51
7.1 General Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7.2 Graphic Windows Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
7.3 Data Manager Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
7.4 Output Window Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
7.5 Functions Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
7.6 Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.7 Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.8 StationWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.9 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
III Handling 57
8 Basic Project Denition 59
8.1 Dening and Conguring a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
8.1.1 The Project Edit Dialogue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
8.1.2 The Project Overview Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
8.1.3 Project Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
DIgSILENT PowerFactory 15, User Manual iii
CONTENTS
8.1.4 Activating and Deactivating Projects . . . . . . . . . . . . . . . . . . . . . . . . . 65
8.1.5 Exporting and Importing of Projects . . . . . . . . . . . . . . . . . . . . . . . . . . 65
8.1.6 External References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
8.2 Creating New Grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
9 Network Graphics (Single Line Diagrams) 67
9.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
9.2 Dening Network Models with the Graphical Editor . . . . . . . . . . . . . . . . . . . . . . 67
9.2.1 Adding New Power System Elements . . . . . . . . . . . . . . . . . . . . . . . . . 67
9.2.2 Drawing Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
9.2.3 Drawing Branch Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
9.2.4 Marking and Editing Power System Elements . . . . . . . . . . . . . . . . . . . . 70
9.2.5 Interconnecting Power Subsystems . . . . . . . . . . . . . . . . . . . . . . . . . . 72
9.2.6 Working with Substations in the Graphical Editor . . . . . . . . . . . . . . . . . . 73
9.2.7 Working with Composite Branches in the Graphical Editor . . . . . . . . . . . . . 77
9.2.8 Working with Single and Two Phase Elements . . . . . . . . . . . . . . . . . . . . 77
9.3 Dening and Working with Lines and Cables . . . . . . . . . . . . . . . . . . . . . . . . . 78
9.3.1 Dening a Line (ElmLne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
9.3.2 Dening Line Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
9.3.3 Example Cable System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
9.3.4 Example Line Couplings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
9.4 Graphic Windows and Database Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
9.4.1 Network Diagrams and Graphical Pages . . . . . . . . . . . . . . . . . . . . . . . 84
9.4.2 Active Graphics, Graphics Board and Study Cases . . . . . . . . . . . . . . . . . 85
9.4.3 Single Line Graphics and Data Objects . . . . . . . . . . . . . . . . . . . . . . . . 86
9.4.4 Editing and Selecting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
9.4.5 Creating a New Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
9.4.6 Creating New Graphic Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
9.4.7 Basic Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
9.4.8 Page Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
9.4.9 Drawing Toolboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
9.4.10 Active Grid Folder (Target Folder) . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
9.5 Drawing Diagrams with Existing Network Elements . . . . . . . . . . . . . . . . . . . . . 90
iv DIgSILENT PowerFactory 15, User Manual
CONTENTS
9.5.1 Drawing Existing Busbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
9.5.2 Drawing Existing Lines, Switches, and Transformers . . . . . . . . . . . . . . . . 92
9.5.3 Building Single Line Diagrams from Imported Data . . . . . . . . . . . . . . . . . 92
9.6 Graphic Commands, Options, and Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 93
9.6.1 Zoom, Pan, and Select Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 93
9.6.2 Page, Graphic, and Print Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
9.6.3 Graphic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
9.6.4 Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
9.6.5 Element Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
9.6.6 Graphic Attributes and Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
9.6.7 Node Default Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
9.7 Editing and Changing Symbols of Elements . . . . . . . . . . . . . . . . . . . . . . . . . . 110
9.8 Results Boxes, Text Boxes and Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
9.8.1 Results Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
9.8.2 Text Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
9.8.3 Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
9.8.4 Free Text Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
9.9 Geographical Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
10 Data Manager 117
10.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
10.2 Using the Data Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
10.2.1 Navigating the Database Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
10.2.2 Adding New Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
10.2.3 Deleting an Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
10.2.4 Cut, Copy, Paste and Move Objects . . . . . . . . . . . . . . . . . . . . . . . . . . 122
10.2.5 The Data Manager Message Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
10.2.6 Additional Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
10.3 Dening Network Models with the Data Manager . . . . . . . . . . . . . . . . . . . . . . . 124
10.3.1 Dening New Network Components in the Data Manager . . . . . . . . . . . . . 124
10.3.2 Connecting Network Components in the Data Manager . . . . . . . . . . . . . . . 124
10.3.3 Dening Substations in the Data Manager . . . . . . . . . . . . . . . . . . . . . . 124
10.3.4 Dening Composite Branches in the Data Manager . . . . . . . . . . . . . . . . . 125
DIgSILENT PowerFactory 15, User Manual v
CONTENTS
10.3.5 Dening Sites in the Data Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 126
10.3.6 Editing Network Components using the Data Manager . . . . . . . . . . . . . . . 126
10.4 Searching for Objects in the Data Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 127
10.4.1 Sorting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
10.4.2 Searching by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
10.4.3 Using Filters for Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
10.5 Editing Data Objects in the Data Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
10.5.1 Editing in Object Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
10.5.2 Editing in Detail Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
10.5.3 Copy and Paste while Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
10.6 The Flexible Data Page Tab in the Data Manager . . . . . . . . . . . . . . . . . . . . . . 135
10.6.1 Customizing the Flexible Data Page . . . . . . . . . . . . . . . . . . . . . . . . . 135
10.7 The Input Window in the Data Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
10.7.1 Input Window Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
10.8 Save and Restore Parts of the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
10.8.1 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
10.9 Spreadsheet Format Data Import/Export . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
10.9.1 Export to Spreadsheet Programs (e. g. MS EXCEL) . . . . . . . . . . . . . . . . 139
10.9.2 Import from Spreadsheet Programs (e. g. MS EXCEL) . . . . . . . . . . . . . . . 141
11 Study Cases 147
11.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
11.2 Creating and Using Study Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
11.3 Summary Grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
11.4 Study Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
11.5 The Study Case Edit Dialogue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
11.6 Variation Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
11.7 Operation Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
11.8 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
11.9 Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
11.9.1 Dispatch Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
11.9.2 External Measurement Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
11.9.3 Intercircuit Fault Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
vi DIgSILENT PowerFactory 15, User Manual
CONTENTS
11.9.4 Events of Loads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
11.9.5 Message Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
11.9.6 Outage of Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
11.9.7 Parameter Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
11.9.8 Save Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
11.9.9 Short-Circuit Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
11.9.10 Stop Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
11.9.11 Switch Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
11.9.12 Synchronous Machine Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
11.9.13 Tap Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
11.10Simulation Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
11.11Results Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
11.12Variable Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
11.13Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
11.14Graphic Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
12 Project Library 159
12.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
12.2 Equipment Type Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
12.3 Operational Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
12.3.1 Circuit Breaker Ratings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
12.3.2 Demand Transfers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
12.3.3 Fault Cases and Fault Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
12.3.4 Capability Curves (Mvar Limit Curves) for Generators . . . . . . . . . . . . . . . . 167
12.3.5 Planned Outages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
12.3.6 Running Arrangements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
12.3.7 Thermal Ratings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
12.4 Templates Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
12.4.1 General Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.4.2 Substation Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.4.3 Busbar Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.4.4 Composite Branch Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.4.5 Example Generator Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
DIgSILENT PowerFactory 15, User Manual vii
CONTENTS
12.4.6 Example Busbar Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
13 Grouping Objects 179
13.1 Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
13.2 Virtual Power Plants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
13.2.1 Dening and Editing a New Virtual Power Plant . . . . . . . . . . . . . . . . . . . 180
13.2.2 Applying a Virtual Power Plant . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
13.2.3 Inserting a Generator into a Virtual Power Plant and Dening its Virtual Power
Plant Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
13.3 Boundaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
13.4 Circuits (ElmCircuit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
13.5 Feeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
13.6 Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
13.7 Owners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
13.8 Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
13.9 Routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
13.10Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
14 Operation Scenarios 189
14.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
14.2 Operation Scenarios Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
14.3 How to use Operation Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
14.3.1 How to create an Operation Scenario . . . . . . . . . . . . . . . . . . . . . . . . . 191
14.3.2 How to save an Operation Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . 192
14.3.3 How to activate an existing Operation Scenario . . . . . . . . . . . . . . . . . . . 193
14.3.4 How to deactivate an Operation Scenario . . . . . . . . . . . . . . . . . . . . . . 193
14.3.5 How to identify operational data parameters . . . . . . . . . . . . . . . . . . . . . 194
14.4 Administering Operation Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
14.4.1 How to view objects missing from the Operation Scenario data . . . . . . . . . . 195
14.4.2 How to compare the data in two operation scenarios . . . . . . . . . . . . . . . . 195
14.4.3 How to view the non-default Running Arrangements . . . . . . . . . . . . . . . . 196
14.4.4 How to transfer data from one Operation Scenario to another . . . . . . . . . . . 196
14.4.5 How to update the default data with operation scenario data . . . . . . . . . . . . 197
14.4.6 How exclude a grid from the Operation Scenario data . . . . . . . . . . . . . . . 197
viii DIgSILENT PowerFactory 15, User Manual
CONTENTS
14.4.7 How to create a time based Operation Scenario . . . . . . . . . . . . . . . . . . . 197
14.5 Advanced Conguration of Operation Scenarios . . . . . . . . . . . . . . . . . . . . . . . 199
14.5.1 How to change the automatic save settings for Operation Scenarios . . . . . . . 199
14.5.2 How to modify the data stored in Operation Scenarios . . . . . . . . . . . . . . . 199
15 Network Variations and Expansion Stages 201
15.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
15.2 Variations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
15.3 Expansion Stages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
15.4 The Study Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
15.5 The Recording Expansion Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
15.6 The Variation Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
15.7 Variation and Expansion Stage Example . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
15.8 Variation and Expansion Stage Housekeeping . . . . . . . . . . . . . . . . . . . . . . . . 206
15.8.1 Applying Changes from Expansion Stages . . . . . . . . . . . . . . . . . . . . . . 206
15.8.2 Consolidating Variations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
15.8.3 Splitting Expansion Stages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
15.8.4 Comparing Variations and Expansion Stages . . . . . . . . . . . . . . . . . . . . 207
15.8.5 Colouring Variations the Single Line Graphic . . . . . . . . . . . . . . . . . . . . . 208
15.8.6 Variation Conicts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
15.8.7 Error Correction Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
15.9 Compatibility with Previous PowerFactory
Releases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
15.9.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
15.9.2 Converting System Stages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
16 Parameter Characteristics, Load States, and Tariffs 215
16.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
16.2 Parameter Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
16.2.1 Scalar Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
16.2.2 Discrete Time Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
16.2.3 Vector Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
16.2.4 Matrix Parameter Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
16.2.5 Parameter Characteristics from Files . . . . . . . . . . . . . . . . . . . . . . . . . 221
DIgSILENT PowerFactory 15, User Manual ix
CONTENTS
16.2.6 Characteristic References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
16.2.7 Example Application of Characteristics . . . . . . . . . . . . . . . . . . . . . . . . 222
16.3 Load States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
16.3.1 Creating Load States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
16.3.2 Viewing Existing Load States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
16.3.3 Load State Object Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
16.3.4 Example Load States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
16.4 Load Distribution States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
16.4.1 Creating Load Distribution States . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
16.4.2 Viewing Existing Load Distribution States . . . . . . . . . . . . . . . . . . . . . . 229
16.4.3 Load Distribution State Object Properties . . . . . . . . . . . . . . . . . . . . . . 229
16.4.4 Example Load Distribution States . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
16.5 Tariffs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
16.5.1 Dening Time Tariffs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
16.5.2 Dening Energy Tariffs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
17 Reporting and Visualizing Results 235
17.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
17.2 Results, Graphs and Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
17.2.1 Editing Result Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
17.2.2 Output of Device Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
17.2.3 Output of Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
17.2.4 Result Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
17.3 Comparisons Between Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
17.3.1 Editing a Set Of Comparison Cases . . . . . . . . . . . . . . . . . . . . . . . . . 245
17.3.2 Update Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
17.4 Variable Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
17.4.1 The Variable Selection Monitor Dialogue . . . . . . . . . . . . . . . . . . . . . . . 247
17.4.2 Searching the Variables to Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . 249
17.4.3 Examples of Variable Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
17.4.4 Selecting the Bus to be Monitored . . . . . . . . . . . . . . . . . . . . . . . . . . 254
17.5 Virtual Instruments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
17.5.1 Virtual Instrument Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
x DIgSILENT PowerFactory 15, User Manual
CONTENTS
17.5.2 Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
17.5.3 The Vector Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
17.5.4 The Voltage Prole Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
17.5.5 Schematic Visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
17.5.6 The Waveform Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
17.5.7 The Curve-Input Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
17.5.8 Embedded Graphic Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
17.5.9 Tools for Virtual Instruments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
17.5.10 User-Dened Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
18 Data Management 297
18.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
18.2 Project Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
18.2.1 What is a Version? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
18.2.2 How to Create a Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
18.2.3 How to Rollback a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
18.2.4 How to Check if a Version is the base for a derived Project . . . . . . . . . . . . . 300
18.2.5 How to Delete a Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
18.3 Derived Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
18.3.1 Derived Projects Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
18.3.2 How to Create a Derived Project . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
18.4 Comparing and Merging Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
18.4.1 Compare and Merge Tool Background . . . . . . . . . . . . . . . . . . . . . . . . 304
18.4.2 How to Merge or Compare two projects using the Compare and Merge Tool . . . 305
18.4.3 How to Merge or Compare three projects using the Compare and Merge Tool . . 306
18.4.4 Compare and Merge Tool Advanced Options . . . . . . . . . . . . . . . . . . . . 307
18.4.5 Compare and Merge Tool diff browser . . . . . . . . . . . . . . . . . . . . . . . . 308
18.5 How to update a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
18.5.1 Updating a Derived Project from a new Version . . . . . . . . . . . . . . . . . . . 313
18.5.2 Updating a base project from a Derived Project . . . . . . . . . . . . . . . . . . . 315
18.5.3 Tips for working with the Compare and Merge Tool . . . . . . . . . . . . . . . . . 315
18.6 Sharing Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
DIgSILENT PowerFactory 15, User Manual xi
CONTENTS
19 The DIgSILENT Programming Language - DPL 317
19.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
19.2 The Principle Structure of a DPL Command . . . . . . . . . . . . . . . . . . . . . . . . . 318
19.3 The DPL Command Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
19.3.1 Creating a new DPL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
19.3.2 Dening a DPL Commands Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
19.3.3 Executing a DPL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
19.3.4 DPL Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
19.3.5 DPL Script Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
19.4 The DPL Script Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
19.5 The DPL Script Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
19.5.1 Variable Denitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
19.5.2 Constant parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
19.5.3 Assignments and Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
19.5.4 Standard Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
19.5.5 Program Flow Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
19.5.6 Input and Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
19.6 Access to Other Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
19.6.1 Object Variables and Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
19.7 Access to Locally Stored Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
19.8 Accessing the General Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
19.9 Accessing External Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
19.10Remote Scripts and DPL Command Libraries . . . . . . . . . . . . . . . . . . . . . . . . 330
19.10.1 Subroutines and Calling Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 332
19.11DPL Functions and Subroutines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
20 PowerFactory Interfaces 335
20.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
20.2 DGS Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
20.2.1 DGS Interface Typical Applications . . . . . . . . . . . . . . . . . . . . . . . . . . 336
20.2.2 DGS Structure (Database Schemas and File Formats) . . . . . . . . . . . . . . . 337
20.2.3 DGS Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
20.2.4 DGS Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
xii DIgSILENT PowerFactory 15, User Manual
CONTENTS
20.3 PSS/E File Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
20.3.1 Importing PSS/E Steady-State Data . . . . . . . . . . . . . . . . . . . . . . . . . 340
20.3.2 Import of PSS/E le (Dynamic Data) . . . . . . . . . . . . . . . . . . . . . . . . . 344
20.3.3 Exporting a project to a PSS/E le . . . . . . . . . . . . . . . . . . . . . . . . . . 345
20.4 NEPLAN Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
20.4.1 Importing NEPLAN Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
20.5 UCTE-DEF Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
20.5.1 Importing UCTE-DEF Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
20.5.2 Exporting UCTE-DEF Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
20.6 CIM Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
20.6.1 Importing CIM Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
20.6.2 Exporting CIM Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
20.7 MATLAB Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
20.8 OPC Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
20.8.1 OPC Interface Typical Applications . . . . . . . . . . . . . . . . . . . . . . . . . . 356
20.9 StationWare Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
20.9.1 About StationWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
20.9.2 Component Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
20.9.3 Fundamental Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
20.9.4 Conguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
20.9.5 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
20.9.6 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
20.9.7 Technical Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
20.10API (Application Programming Interface) . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
IV Power System Analysis Functions 383
21 Load Flow Analysis 385
21.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
21.2 Technical Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
21.2.1 Network Representation and Calculation Methods . . . . . . . . . . . . . . . . . 389
21.2.2 Active and Reactive Power Control . . . . . . . . . . . . . . . . . . . . . . . . . . 392
21.2.3 Advanced Load Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
DIgSILENT PowerFactory 15, User Manual xiii
CONTENTS
21.2.4 Temperature Dependency of Lines and Cables . . . . . . . . . . . . . . . . . . . 400
21.3 Executing Load Flow Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
21.3.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
21.3.2 Active Power Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
21.3.3 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
21.3.4 Iteration Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
21.3.5 Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
21.3.6 Low Voltage Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
21.3.7 Advanced Simulation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
21.4 Result Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
21.4.1 Viewing Results in the Single Line Diagram . . . . . . . . . . . . . . . . . . . . . 413
21.4.2 Flexible Data Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
21.4.3 Predened Report Formats (ASCII Reports) . . . . . . . . . . . . . . . . . . . . . 414
21.4.4 Diagram Colouring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
21.4.5 Load Flow Sign Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
21.5 Troubleshooting Load Flow Calculation Problems . . . . . . . . . . . . . . . . . . . . . . 415
21.5.1 General Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
21.5.2 Data Model Problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
21.5.3 Some Load Flow Calculation Messages . . . . . . . . . . . . . . . . . . . . . . . 417
21.5.4 Too many Inner Loop Iterations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
21.5.5 Too Many Outer Loop Iterations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
21.6 Load Flow Sensitivities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
21.6.1 Load Flow Sensitivities Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
21.6.2 Load Flow Sensitivities Execution and Results . . . . . . . . . . . . . . . . . . . . 423
21.6.3 Technical Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
22 Short-Circuit Analysis 427
22.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
22.1.1 The IEC 60909/VDE 0102 Method . . . . . . . . . . . . . . . . . . . . . . . . . . 430
22.1.2 The ANSI Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
22.1.3 The Complete Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
22.1.4 The IEC 61363 Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
22.2 Executing Short-Circuit Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
xiv DIgSILENT PowerFactory 15, User Manual
CONTENTS
22.2.1 Toolbar/Main Menu Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
22.2.2 Context-Sensitive Menu Execution . . . . . . . . . . . . . . . . . . . . . . . . . . 439
22.2.3 Faults on Busbars/Terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
22.2.4 Faults on Lines and Branches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
22.2.5 Multiple Faults Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
22.3 Short-Circuit Calculation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
22.3.1 Basic Options (All Methods) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
22.3.2 Verication (Except for IEC 61363) . . . . . . . . . . . . . . . . . . . . . . . . . . 446
22.3.3 Basic Options (IEC 60909/VDE 0102 Method) . . . . . . . . . . . . . . . . . . . . 447
22.3.4 Advanced Options (IEC 60909/VDE 0102 Method) . . . . . . . . . . . . . . . . . 448
22.3.5 Basic Options (ANSI C37 Method) . . . . . . . . . . . . . . . . . . . . . . . . . . 450
22.3.6 Advanced Options (ANSI C37 Method) . . . . . . . . . . . . . . . . . . . . . . . . 452
22.3.7 Basic Options (Complete Method) . . . . . . . . . . . . . . . . . . . . . . . . . . 453
22.3.8 Advanced Options (Complete Method) . . . . . . . . . . . . . . . . . . . . . . . . 454
22.3.9 Basic Options (IEC 61363) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
22.3.10 Advanced Options (IEC 61363) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
22.4 Result Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
22.4.1 Viewing Results in the Single Line Diagram . . . . . . . . . . . . . . . . . . . . . 458
22.4.2 Flexible Data Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
22.4.3 Predened Report Formats (ASCII Reports) . . . . . . . . . . . . . . . . . . . . . 459
22.4.4 Diagram Colouring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
23 Harmonics Analysis 461
23.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
23.2 Harmonic Load Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
23.2.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
23.2.2 IEC 61000-3-6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
23.2.3 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
23.3 Frequency Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
23.3.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
23.3.2 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
23.4 Filter Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
23.5 Modelling Harmonic Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
DIgSILENT PowerFactory 15, User Manual xv
CONTENTS
23.5.1 Denition of Harmonic Injections . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
23.5.2 Assignment of Harmonic Injections . . . . . . . . . . . . . . . . . . . . . . . . . . 475
23.5.3 Harmonic Distortion Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
23.5.4 Frequency Dependent Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 477
23.5.5 Waveform Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
23.6 Flicker Analysis (IEC 61400-21) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
23.6.1 Continuous Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
23.6.2 Switching Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
23.6.3 Flicker Contribution of Wind Turbine Generator Models . . . . . . . . . . . . . . . 483
23.6.4 Denition of Flicker Coefcients . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
23.6.5 Assignment of Flicker Coefcients . . . . . . . . . . . . . . . . . . . . . . . . . . 484
23.6.6 Flicker Result Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
23.7 Short-Circuit Power Sk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
23.7.1 Balanced Harmonic Load Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
23.7.2 Unbalanced Harmonic Load Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
23.7.3 Sk Result Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
23.7.4 Short-Circuit Power of the External Grid . . . . . . . . . . . . . . . . . . . . . . . 487
23.8 Denition of Result Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
23.8.1 Denition of Variable Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
23.8.2 Selection of Result Variables within a Variable Set . . . . . . . . . . . . . . . . . 489
24 Flickermeter 491
24.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
24.2 Flickermeter (IEC 61000-4-15) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
24.2.1 Calculation of Short-Term Flicker . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
24.2.2 Calculation of Long-Term Flicker . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
24.3 Flickermeter Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
24.3.1 Flickermeter Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
24.3.2 Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
24.3.3 Signal Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
24.3.4 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
24.3.5 Input File Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
xvi DIgSILENT PowerFactory 15, User Manual
CONTENTS
25 Stability and EMT Simulations 501
25.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
25.2 Calculation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
25.2.1 Balanced RMS Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
25.2.2 Three-Phase RMS Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
25.2.3 Three-Phase EMT Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
25.3 Setting Up a Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
25.3.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
25.3.2 Step Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
25.3.3 Step Size Adaptation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
25.3.4 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
25.3.5 Noise Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
25.3.6 Advanced Simulation Options - Load Flow . . . . . . . . . . . . . . . . . . . . . . 510
25.4 Result Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
25.4.1 Saving Results from Previous Simulations . . . . . . . . . . . . . . . . . . . . . . 513
25.5 Simulation Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
25.5.1 Frequency Scan Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
25.5.2 Loss of Synchronism Scan Module . . . . . . . . . . . . . . . . . . . . . . . . . . 514
25.5.3 Variables Scan Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
25.5.4 Voltage Scan Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
25.5.5 Simulation scan example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
25.6 Events (IntEvt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
25.7 Running a Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
25.8 Models for Stability Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
25.9 System Modelling Approach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
25.9.1 The Composite Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
25.9.2 The Composite Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
25.9.3 The Common Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
25.10The Composite Block Denition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
25.10.1 Drawing Composite Block Diagrams and Composite . . . . . . . . . . . . . . . . 539
25.11User Dened (DSL) Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
25.11.1 Modelling and Simulation Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
DIgSILENT PowerFactory 15, User Manual xvii
CONTENTS
25.11.2 DSL Implementation: an Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 547
25.11.3 Dening DSL Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
25.12The DIgSILENT Simulation Language (DSL) . . . . . . . . . . . . . . . . . . . . . . . . . 554
25.12.1 Terms and Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
25.12.2 General DSL Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
25.12.3 DSL Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
25.12.4 DSL Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
25.12.5 Denition Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
25.12.6 Initial Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
25.12.7 Equation Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
25.12.8 Equation Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
25.12.9 DSL Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
25.12.10Events and Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
25.12.11Example of a Complete DSL Model . . . . . . . . . . . . . . . . . . . . . . . . . 563
25.13DSL Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
25.13.1 DSL Standard Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
25.13.2 DSL Special Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
25.14MATLAB Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
25.14.1 Example Implementation of Voltage Controller . . . . . . . . . . . . . . . . . . . 570
25.14.2 Additional notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
26 Modal Analysis / Eigenvalue Calculation 579
26.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
26.2 Theory of Modal Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
26.3 How to Complete a Modal Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
26.3.1 Completing a Modal Analysis with the Default Options . . . . . . . . . . . . . . . 582
26.3.2 Explanation of Modal Analysis Command Basic
Options (ComMod) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
26.3.3 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
26.4 Viewing Modal Analysis Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
26.4.1 Viewing Modal Analysis Reports in the Output Window . . . . . . . . . . . . . . . 586
26.4.2 Viewing Modal Analysis Results using the built-in Plots . . . . . . . . . . . . . . . 589
26.4.3 Viewing Modal Analysis Results using the Modal Data Browser . . . . . . . . . . 595
xviii DIgSILENT PowerFactory 15, User Manual
CONTENTS
26.4.4 Viewing Results in the Data Manager Window . . . . . . . . . . . . . . . . . . . . 597
26.5 Troubleshooting Modal Analysis Calculation Problems . . . . . . . . . . . . . . . . . . . . 599
26.5.1 Models not supported by the QR method . . . . . . . . . . . . . . . . . . . . . . . 599
26.5.2 The Arnoldi/Lanczos Method is slow . . . . . . . . . . . . . . . . . . . . . . . . . 599
27 Model Parameter Identication 601
27.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
27.2 Target Functions and Composite Frames . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
27.2.1 The Measurement File Slot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
27.2.2 Power System Element Slot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
27.2.3 Comparison Slot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
27.3 Creating The Composite Identication Model . . . . . . . . . . . . . . . . . . . . . . . . . 604
27.3.1 The Comparison Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
27.4 Performing a Parameter Identication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
27.5 Identifying Primary Appliances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
28 Contingency Analysis 611
28.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
28.2 Technical Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
28.2.1 Single Time Phase Contingency Analysis . . . . . . . . . . . . . . . . . . . . . . 614
28.2.2 Multiple Time Phases Contingency Analysis . . . . . . . . . . . . . . . . . . . . . 614
28.2.3 Time Sweep Option (Single Time Phase) . . . . . . . . . . . . . . . . . . . . . . 615
28.2.4 Consideration of Predened Switching Rules . . . . . . . . . . . . . . . . . . . . 615
28.2.5 Parallel Computing Option (Single Time Phase) . . . . . . . . . . . . . . . . . . . 615
28.3 Executing Contingency Analyses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
28.4 The Single Time Phase Contingency Analysis Command . . . . . . . . . . . . . . . . . . 617
28.4.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
28.4.2 Effectiveness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
28.4.3 Multiple Time Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
28.4.4 Time Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
28.4.5 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
28.4.6 Parallel Computing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
28.4.7 Calculating an Individual Contingency . . . . . . . . . . . . . . . . . . . . . . . . 626
DIgSILENT PowerFactory 15, User Manual xix
CONTENTS
28.4.8 Representing Contingency Situations
Contingency Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626
28.5 The Multiple Time Phases Contingency Analysis Command . . . . . . . . . . . . . . . . 628
28.5.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
28.5.2 Effectiveness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
28.5.3 Multiple Time Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
28.5.4 Time Sweep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
28.5.5 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
28.5.6 Parallel Computing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
28.5.7 Dening Time Phases for Contingency Analyses . . . . . . . . . . . . . . . . . . 631
28.5.8 Representing Contingency Situations with Post - Fault Actions . . . . . . . . . . . 633
28.6 Creating Contingency Cases Using Fault
Cases and Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634
28.6.1 Browsing Fault Cases and Fault Groups . . . . . . . . . . . . . . . . . . . . . . . 635
28.6.2 Dening a Fault Case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635
28.6.3 Dening a Fault Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
28.7 Creating Contingency Cases Using the
Contingency Denition Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637
28.8 Comparing Contingency Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
28.9 Result Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
28.9.1 Predened Report Formats (Tabular and ASCII Reports) . . . . . . . . . . . . . . 641
29 Reliability Assessment 645
29.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
29.2 Probabilistic Reliability Assessment
Technical Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647
29.2.1 Reliability Assessment Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
29.2.2 Stochastic Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
29.2.3 Calculated Results for Reliability Assessment . . . . . . . . . . . . . . . . . . . . 650
29.2.4 System State Enumeration in Reliability Assessment . . . . . . . . . . . . . . . . 655
29.2.5 Failure Effect Analysis in Reliability Assessment . . . . . . . . . . . . . . . . . . . 656
29.3 Setting up the Network Model for Reliability Assessment . . . . . . . . . . . . . . . . . . 661
29.3.1 How to Dene Stochastic Failure and Repair models . . . . . . . . . . . . . . . . 661
29.3.2 How to Create Feeders for Reliability Calculation . . . . . . . . . . . . . . . . . . 666
xx DIgSILENT PowerFactory 15, User Manual
CONTENTS
29.3.3 Conguring Switches for the Reliability Calculation . . . . . . . . . . . . . . . . . 666
29.3.4 Load Modelling for Reliability Assessment . . . . . . . . . . . . . . . . . . . . . . 667
29.3.5 Modelling Load Interruption Costs . . . . . . . . . . . . . . . . . . . . . . . . . . 668
29.3.6 System Demand and Load States (ComLoadstate) . . . . . . . . . . . . . . . . . 668
29.3.7 Fault Clearance Based on Protection Device Location . . . . . . . . . . . . . . . 669
29.3.8 How to Consider Planned Maintenance . . . . . . . . . . . . . . . . . . . . . . . 669
29.3.9 Specifying Individual Component Constraints . . . . . . . . . . . . . . . . . . . . 669
29.4 Running The Reliability Assessment Calculation . . . . . . . . . . . . . . . . . . . . . . . 670
29.4.1 How to run the Reliability Assessment . . . . . . . . . . . . . . . . . . . . . . . . 670
29.4.2 Viewing the FEA results for a Specic Contingency . . . . . . . . . . . . . . . . . 676
29.4.3 Viewing the Load Point Indices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
29.4.4 Viewing the System Reliability Indices (Spreadsheet format) . . . . . . . . . . . . 677
29.4.5 Printing ASCII Reliability Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . 678
29.4.6 Using the Colouring modes to aid Reliability Analysis . . . . . . . . . . . . . . . . 678
29.4.7 Using the Contribution to Reliability Indices Script . . . . . . . . . . . . . . . . . . 679
30 Generation Adequacy Analysis 681
30.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
30.2 Technical Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
30.3 Database Objects and Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
30.3.1 Stochastic Model for Generation Object (StoGen) . . . . . . . . . . . . . . . . . . 684
30.3.2 Power Curve Type (TypPowercurve) . . . . . . . . . . . . . . . . . . . . . . . . . 685
30.3.3 Meteorological Station (ElmMeteostat) . . . . . . . . . . . . . . . . . . . . . . . . 685
30.4 Assignment of Stochastic Model for Generation Object . . . . . . . . . . . . . . . . . . . 686
30.4.1 Denition of a Stochastic Multi-State Model . . . . . . . . . . . . . . . . . . . . . 686
30.4.2 Stochastic Wind Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
30.4.3 Time Series Characteristic for Wind Generation . . . . . . . . . . . . . . . . . . . 688
30.4.4 Demand denition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
30.4.5 Generation Adequacy Analysis Toolbar . . . . . . . . . . . . . . . . . . . . . . . . 691
30.4.6 Generation Adequacy Initialisation Command
(ComGenrelinc) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
30.4.7 Run Generation Adequacy Command (ComGenrel) . . . . . . . . . . . . . . . . . 694
30.5 Generation Adequacy Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
DIgSILENT PowerFactory 15, User Manual xxi
CONTENTS
30.5.1 Draws (Iterations) Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
30.5.2 Distribution (Cumulative Probability) Plots . . . . . . . . . . . . . . . . . . . . . . 696
30.5.3 Convergence Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
30.5.4 Summary of variables calculated during the Generation Adequacy Analysis . . . 701
31 Optimal Power Flow 703
31.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
31.2 AC Optimization (Interior Point Method) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
31.2.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
31.2.2 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717
31.2.3 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718
31.2.4 Iteration Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718
31.2.5 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720
31.3 DC Optimization (Linear Programming) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721
31.3.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722
31.3.2 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726
31.3.3 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727
31.3.4 Iteration Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728
31.4 Contingency Constrained DC Optimization (LP Method) . . . . . . . . . . . . . . . . . . . 729
31.4.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730
31.4.2 Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
31.4.3 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
31.4.4 Iteration Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
31.4.5 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
32 Techno-Economical Calculation 739
32.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739
32.2 Requirements for Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740
32.3 Calculation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740
32.3.1 Basic Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740
32.3.2 Costs Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741
32.3.3 Output Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742
32.4 Example Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742
xxii DIgSILENT PowerFactory 15, User Manual
CONTENTS
33 Distribution Network Tools 747
33.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747
33.2 Voltage Sag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747
33.2.1 Calculation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748
33.2.2 How to Perform a Voltage Sag Table Assessment . . . . . . . . . . . . . . . . . . 749
33.2.3 Voltage Sag Table Assessment Results . . . . . . . . . . . . . . . . . . . . . . . 750
33.3 Voltage Prole Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752
33.3.1 Optimization Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
33.3.2 Basic Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755
33.3.3 Output Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756
33.3.4 Advanced Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756
33.3.5 Results of Voltage Prole Optimization . . . . . . . . . . . . . . . . . . . . . . . . 756
33.4 Tie Open Point Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757
33.4.1 Tie Open Point Optimization Background . . . . . . . . . . . . . . . . . . . . . . . 757
33.4.2 How to run a Tie Open Point Optimization . . . . . . . . . . . . . . . . . . . . . . 758
33.5 Backbone Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761
33.5.1 Basic Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762
33.5.2 Scoring Settings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763
33.5.3 Tracing Backbones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764
33.5.4 Example Backbone Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764
33.6 Optimal RCS Placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765
33.6.1 Basic Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765
33.6.2 Output Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766
33.6.3 Advanced Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766
33.6.4 Example Optimal RCS Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . 767
34 Optimal Capacitor Placement 769
34.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769
34.2 Optimal Capacitor Placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769
34.2.1 OCP Objective Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770
34.2.2 OCP Optimization Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772
34.2.3 Basic Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772
34.2.4 Available Capacitors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774
DIgSILENT PowerFactory 15, User Manual xxiii
CONTENTS
34.2.5 Load Characteristics Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775
34.2.6 Advanced Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776
34.2.7 Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777
35 Cable Sizing 779
35.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779
35.2 Calculation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781
35.2.1 Basic Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781
35.2.2 Constraints Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783
35.2.3 Output Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784
35.2.4 Advanced Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786
35.2.5 Type Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789
35.3 Cable Sizing Line Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 790
35.3.1 Cable Sizing Line Type Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 790
35.3.2 Cable Sizing Line Element Parameters . . . . . . . . . . . . . . . . . . . . . . . . 791
35.4 System Technology Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
36 Motor Starting 793
36.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793
36.2 How to dene a motor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793
36.2.1 How to dene a motor Type and starting methodology . . . . . . . . . . . . . . . 793
36.2.2 How to dene a motor driven machine . . . . . . . . . . . . . . . . . . . . . . . . 795
36.3 How to run a Motor Starting simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796
36.3.1 Basic Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796
36.3.2 Output Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 798
36.3.3 Motor Starting simulation results . . . . . . . . . . . . . . . . . . . . . . . . . . . 799
36.3.4 Motor Starting Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 800
37 Arc-Flash Hazard Analysis 803
37.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
37.2 Arc-Flash Hazard Analysis Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
37.2.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
37.2.2 Data Inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 804
37.3 Arc-Flash Hazard Analysis Calculation Options . . . . . . . . . . . . . . . . . . . . . . . . 805
xxiv DIgSILENT PowerFactory 15, User Manual
CONTENTS
37.3.1 Arc-Flash Hazard Analysis Basic Options Page . . . . . . . . . . . . . . . . . . . 805
37.3.2 Arc-Flash Hazard Analysis Advanced Options Page . . . . . . . . . . . . . . . . 806
37.4 Arc-Flash Hazard Analysis Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807
37.4.1 Viewing Results in the Single Line Graphic . . . . . . . . . . . . . . . . . . . . . . 807
37.4.2 Arc-Flash Reports Dialogue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807
37.4.3 Arc-Flash Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807
37.5 Example Arc-Flash Hazard Analysis Calculation . . . . . . . . . . . . . . . . . . . . . . . 808
38 Protection 811
38.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 811
38.2 General approach to protection modelling in PowerFactory . . . . . . . . . . . . . . . . . 811
38.2.1 The Modelling Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 811
38.3 Dening a protection scheme
- a brief overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815
38.3.1 Adding protective devices to the network model . . . . . . . . . . . . . . . . . . . 815
38.3.2 Locating Devices which have been added to
the network model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 818
38.4 Setup and analysis of an overcurrent
protection scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 818
38.4.1 Overcurrent relay model setup - basic data tab . . . . . . . . . . . . . . . . . . . 818
38.4.2 Overcurrent relay model setup - max/min fault
currents tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819
38.4.3 The Current Transformer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820
38.4.4 The Voltage Transformer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822
38.4.5 Fuse model setup - basic data tab . . . . . . . . . . . . . . . . . . . . . . . . . . 826
38.4.6 Fuse model setup - optimization tab . . . . . . . . . . . . . . . . . . . . . . . . . 826
38.4.7 Basic relay blocks for overcurrent relays . . . . . . . . . . . . . . . . . . . . . . . 827
38.4.8 The time-overcurrent plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833
38.5 Setup and analysis of a distance protection scheme . . . . . . . . . . . . . . . . . . . . . 848
38.5.1 Distance relay model setup - basic data tab . . . . . . . . . . . . . . . . . . . . . 848
38.5.2 Distance relay model setup - max./min. fault currents tab . . . . . . . . . . . . . . 850
38.5.3 Instrument Transformers for distance protection . . . . . . . . . . . . . . . . . . . 850
38.5.4 Basic relay blocks used for distance protection . . . . . . . . . . . . . . . . . . . 850
38.5.5 The time-distance plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856
DIgSILENT PowerFactory 15, User Manual xxv
CONTENTS
38.5.6 The impedance plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 861
38.6 Accessing results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865
38.6.1 Tabular protection setting report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865
38.6.2 Results in Single Line Graphic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869
38.7 Short Circuit Trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870
38.7.1 Short Circuit Trace Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 871
38.8 Building a basic overcurrent relay model . . . . . . . . . . . . . . . . . . . . . . . . . . . 872
38.9 Appendix - Other commonly used relay blocks . . . . . . . . . . . . . . . . . . . . . . . . 881
39 Network Reduction 883
39.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883
39.2 Technical Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883
39.2.1 Network Reduction for Load Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . 883
39.2.2 Network Reduction for Short-Circuit . . . . . . . . . . . . . . . . . . . . . . . . . 884
39.3 How to Complete a Network Reduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 884
39.3.1 How to Backup the Project (optional) . . . . . . . . . . . . . . . . . . . . . . . . . 884
39.3.2 How to run the Network Reduction tool . . . . . . . . . . . . . . . . . . . . . . . . 885
39.3.3 Expected Output of the Network Reduction . . . . . . . . . . . . . . . . . . . . . 885
39.4 Network Reduction Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887
39.4.1 Basic Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 887
39.4.2 Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889
39.4.3 Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 889
39.5 Network Reduction Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890
39.6 Tips for using the Network Reduction Tool . . . . . . . . . . . . . . . . . . . . . . . . . . 893
39.6.1 Station Controller Busbar is Reduced . . . . . . . . . . . . . . . . . . . . . . . . . 893
39.6.2 Network Reduction doesnt Reduce Isolated Areas . . . . . . . . . . . . . . . . . 894
39.6.3 The Reference Machine is not Reduced . . . . . . . . . . . . . . . . . . . . . . . 894
40 State Estimation 895
40.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 895
40.2 Objective Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 896
40.3 Components of the PowerFactory State Estimator . . . . . . . . . . . . . . . . . . . . . . 896
40.3.1 Plausibility Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 897
xxvi DIgSILENT PowerFactory 15, User Manual
CONTENTS
40.3.2 Observability Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 898
40.3.3 State Estimation (Non-Linear Optimization) . . . . . . . . . . . . . . . . . . . . . 899
40.4 State Estimator Data Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899
40.4.1 Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 900
40.4.2 Activating the State Estimator Display Option . . . . . . . . . . . . . . . . . . . . 904
40.4.3 Editing the Element Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905
40.5 Running SE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907
40.5.1 Basic Setup Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 908
40.5.2 Advanced Setup Options for the Plausibility Check . . . . . . . . . . . . . . . . . 911
40.5.3 Advanced Setup Options for the Observability Check . . . . . . . . . . . . . . . . 911
40.5.4 Advanced Setup Options for Bad Data Detection . . . . . . . . . . . . . . . . . . 911
40.5.5 Advanced Setup Options for Iteration Control . . . . . . . . . . . . . . . . . . . . 912
40.6 Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913
40.6.1 Output Window Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913
40.6.2 External Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 914
40.6.3 Estimated States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916
40.6.4 Colour Representation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 917
V Appendix 919
A Glossary 921
B Hotkeys Reference 927
B.1 Calculation Hotkeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 927
B.2 Graphic Windows Hotkeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 927
B.3 Data Manager Hotkeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 929
B.4 Dialogue Hotkeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 931
B.5 Output Window Hotkeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 931
B.6 Editor Hotkeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933
C Technical References of Models 937
C.1 Branch Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938
C.1.1 2-Winding Transformers (ElmTr2/ElmTr2n) . . . . . . . . . . . . . . . . . . . . . . 938
C.1.2 3-Winding Transformer (ElmTr3) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938
DIgSILENT PowerFactory 15, User Manual xxvii
CONTENTS
C.1.3 Autoransformers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 939
C.1.4 Booster Transformer (ElmTrb) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 939
C.1.5 Overhead Lines Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 939
C.1.6 Cables Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 941
C.1.7 Series Capacitances (ElmScap) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942
C.1.8 Series Reactance (ElmSind) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942
C.1.9 Common Impedance (ElmZpu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942
C.2 Generators and Loads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942
C.2.1 Asynchronous Machine (ElmAsm) . . . . . . . . . . . . . . . . . . . . . . . . . . 942
C.2.2 Doubly Fed Induction Machine (ElmAsmsc) . . . . . . . . . . . . . . . . . . . . . 942
C.2.3 Static Generator (ElmGenstat) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942
C.2.4 Synchronous Machine (ElmSym) . . . . . . . . . . . . . . . . . . . . . . . . . . . 943
C.2.5 Loads (ElmLod) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943
C.2.6 Low Voltage Load (ElmLodlv) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943
C.2.7 Partial Loads (ElmLodlvp) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943
C.2.8 Motor Driven Machine (ElmMdm X) . . . . . . . . . . . . . . . . . . . . . . . . . 944
C.3 Power Electronic Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944
C.3.1 PWM AC/DC Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944
C.3.2 Rectier/Inverter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944
C.3.3 Soft Starter (ElmVar) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945
C.3.4 DC/DC Converter (ElmDcdc) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945
C.4 Reactive Power Compensation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945
C.4.1 Neutral Earthing Element (ElmNec) . . . . . . . . . . . . . . . . . . . . . . . . . . 945
C.4.2 Shunt/Filter Element (ElmShnt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945
C.4.3 Static Var System (ElmSvs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945
C.4.4 Station Controller (ElmStactrl)) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945
C.5 Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.5.1 AC Voltage Source (ElmVac) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.5.2 DC Voltage Source (ElmVdc) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.5.3 DC Current Source (ElmDci) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.5.4 External Network (ElmXnet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.5.5 Fourier Source (ElmFsrc) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
xxviii DIgSILENT PowerFactory 15, User Manual
CONTENTS
C.6 Measurement Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.6.1 Current Measurement (StaImea) . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.6.2 Power Measurement (StaPqmea) . . . . . . . . . . . . . . . . . . . . . . . . . . . 946
C.6.3 Voltage Measurement (StaVmea) . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
C.6.4 Phase Measurement Device (Phase Locked Loop, ElmPhi pll) . . . . . . . . . . 947
C.6.5 Measurement File (ElmFile) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
C.7 Digital Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
C.7.1 Digital Clock (ElmClock) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
C.7.2 Digital Register (ElmReg) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 947
C.7.3 Sample and Hold Model (ElmSamp) . . . . . . . . . . . . . . . . . . . . . . . . . 947
C.7.4 Trigger Model (ElmTrigger) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948
C.8 Analysis Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 948
C.8.1 Fast Fourier Transform (ElmFft)) . . . . . . . . . . . . . . . . . . . . . . . . . . . 948
D DPL Reference 949
D.1 Class Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 949
D.2 DPL Methods and Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959
D.3 General Functions and Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970
D.3.1 Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 970
D.3.2 General Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 995
D.3.3 String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1005
D.3.4 Time and Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1013
D.3.5 Output Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018
D.3.6 File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1023
D.3.7 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027
D.4 Project Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036
D.4.1 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036
D.4.2 Project Methods (IntPrj) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043
D.4.3 Project Folder Methods (IntPrjfolder) . . . . . . . . . . . . . . . . . . . . . . . . . 1047
D.4.4 StudyCaseMethods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1048
D.4.5 Variant Methods (IntVariant) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1051
D.4.6 Variation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1052
D.4.7 Scenario Methods (IntScenario) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1053
DIgSILENT PowerFactory 15, User Manual xxix
CONTENTS
D.5 Reporting and Graphical Representation . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055
D.5.1 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055
D.5.2 Virtual Instrument Methods: SetVipage . . . . . . . . . . . . . . . . . . . . . . . . 1056
D.5.3 Virtual Instrument Methods: VisPlot/VisPlot2 Methods . . . . . . . . . . . . . . . 1066
D.5.4 Virtual Instrument Methods:VisFft Methods . . . . . . . . . . . . . . . . . . . . . 1085
D.5.5 Virtual Instrument Methods: IntPlot Methods . . . . . . . . . . . . . . . . . . . . . 1086
D.5.6 Graphic Board Methods (SetDesktop) . . . . . . . . . . . . . . . . . . . . . . . . 1090
D.5.7 Text Box Methods (SetLevelvis) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1097
D.5.8 Table Report Methods (ComTablereport) . . . . . . . . . . . . . . . . . . . . . . . 1099
D.6 Data Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115
D.6.1 SetFilt Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115
D.6.2 SetSelect Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1116
D.6.3 Feeder (SetFeeder) Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1123
D.6.4 Path (SetPath) Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1124
D.6.5 IntDplmap Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1127
D.6.6 IntDplvector Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1134
D.7 PowerFactory Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1138
D.7.1 General Functions and Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . 1138
D.7.2 Load Flow Calculation (ComLdf) Methods . . . . . . . . . . . . . . . . . . . . . . 1140
D.7.3 Short-Circuit Calculation (ComShc) . . . . . . . . . . . . . . . . . . . . . . . . . . 1141
D.7.4 Time-Domain Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1142
D.7.5 Result Export (ComRes) Methods . . . . . . . . . . . . . . . . . . . . . . . . . . 1143
D.7.6 Contingency Case (ComOutage) Methods . . . . . . . . . . . . . . . . . . . . . . 1144
D.7.7 Contingency Analysis (ComSimoutage) Methods . . . . . . . . . . . . . . . . . . 1146
D.7.8 Contingency Denition (ComNmink) Methods . . . . . . . . . . . . . . . . . . . . 1148
D.7.9 Reliability Assessment (ComRel3) Methods . . . . . . . . . . . . . . . . . . . . . 1150
D.7.10 DPL Command (ComDpl) Methods . . . . . . . . . . . . . . . . . . . . . . . . . . 1153
D.7.11 ComImport Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1153
D.7.12 ComMerge Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1154
D.7.13 ComLink Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1160
D.7.14 ComUcteexp Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1161
D.8 Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1162
xxx DIgSILENT PowerFactory 15, User Manual
CONTENTS
D.8.1 Grid (ElmNet) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1162
D.8.2 Asynchronous Machine (ElmAsm) . . . . . . . . . . . . . . . . . . . . . . . . . . 1163
D.8.3 Double Fed Induction Machine (ElmAsmsc) . . . . . . . . . . . . . . . . . . . . . 1164
D.8.4 Feeder (ElmFeeder) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1165
D.8.5 Boundary (ElmBoundary) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1168
D.8.6 Cubicles (StaCubic) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1169
D.8.7 Composite Model (ElmComp) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1171
D.8.8 Breaker/Switch (ElmCoup) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1171
D.8.9 Line (ElmLne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1174
D.8.10 Result Object (ElmRes) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1180
D.8.11 Station Control (ElmStactrl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1192
D.8.12 Substation (ElmSubstat) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1194
D.8.13 Synchronous Machine (ElmSym) . . . . . . . . . . . . . . . . . . . . . . . . . . . 1200
D.8.14 Terminal (ElmTerm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1203
D.8.15 Tower (ElmTow) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1206
D.8.16 Transformer (ElmTr2 / ElmTr2n / ElmTr3) . . . . . . . . . . . . . . . . . . . . . . . 1207
D.8.17 Zone (ElmZone) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1208
D.8.18 Switch (StaSwitch) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1211
D.8.19 Bay (ElmBay) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1213
D.9 Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1213
D.9.1 Induction Machine Type (TypAsm) . . . . . . . . . . . . . . . . . . . . . . . . . . 1213
D.9.2 Induction Machine Type (TypAsmo) . . . . . . . . . . . . . . . . . . . . . . . . . . 1214
D.9.3 Line Type (TypLne) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1214
D.10 Additional Objects (Int*) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1215
D.10.1 IntEvt Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1215
D.10.2 IntForm Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1215
D.10.3 IntMat Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1217
D.10.4 IntMon Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223
D.10.5 IntThrating Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1225
D.10.6 IntUser Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1226
D.10.7 IntUserman Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1227
D.10.8 IntVec Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1230
DIgSILENT PowerFactory 15, User Manual xxxi
CONTENTS
D.11 DDE Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1232
E The DIgSILENT Output Language 1237
E.1 Format string, Variable names and text Lines . . . . . . . . . . . . . . . . . . . . . . . . . 1238
E.2 Placeholders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1238
E.3 Variables, Units and Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1239
E.4 Colour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1241
E.5 Advanced Syntax Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1241
E.6 Line Types and Page Breaks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1242
E.7 Predened Text Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1242
E.8 Object Iterations, Loops, Filters and Includes . . . . . . . . . . . . . . . . . . . . . . . . . 1243
F Element Symbol Denition 1245
F.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1245
F.2 General Symbol Denition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1245
F.3 Geometrical Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1246
F.4 Including Graphic Files as Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1248
G Standard Functions DPL and DSL 1249
Bibliography 1251
Index 1253
xxxii DIgSILENT PowerFactory 15, User Manual
Part I
General Information
Chapter 1
About this Guide
1.1 Introduction
This User Manual is intended to be a reference for users of the DIgSILENT PowerFactory software. This
chapter provides general information about the contents and the used conventions of this documenta-
tion.
1.2 Contents of the User Manual
The rst section of the User Manual provides General Information, including an overview of PowerFac-
tory software, a description of the basic program settings, and a description of the PowerFactory data
model. The next sections describe PowerFactory administration, handling, and power system analysis
functions. In the Power System Analysis Functions section, each chapter deals with a different calcula-
tion, presenting the most relevant theoretical aspects, the PowerFactory approach, and the correspond-
ing interface. Additional tools such as the DIgSILENT Programming Language (DPL), the reporting
functions, and communication interfaces with other programs are presented in the appendices. The
online version of this manual includes additional sections dedicated to the mathematical description of
models and their parameters, referred to as Technical References. To facilitate their portability, visual-
ization, and printing, the papers are attached to the online help as PDF documents. They are opened
by clicking on the indicated links within the manual. References for DIgSILENT Programming Language
functions are also included as appendices of the online manual. It is recommended that new users com-
mence by reading Chapter 4 (PowerFactory Overview), and completing the PowerFactory Tutorials.
1.3 Used Conventions
Conventions to describe user actions are as follows:
Buttons and Keys Dialogue buttons and keyboard keys are referred to with bold and underline text
formatting. For example, press the OK button in the PowerFactory dialogue, or press CTRL+B on
the keyboard.
Menus and Icons Menus and icons are usually referenced using Italics. For example, press the User
Settings icon , or select Tools User Settings. . .
Other Items Speech marks are used to indicate data to be entered by the user, and also to refer to
an item dened by the author. For example, consider a parameter x.
DIgSILENT PowerFactory 15, User Manual 3
CHAPTER 1. ABOUT THIS GUIDE
4 DIgSILENT PowerFactory 15, User Manual
Chapter 2
Contact
For further information about the company DIgSILENT , our products and services please visit our web
site, or contact us at:
DIgSILENT GmbH
Heinrich-Hertz-Strae 9
72810 Gomaringen / Germany
www.digsilent.de
2.1 Direct Technical Support
DIgSILENT experts offer direct assistance to PowerFactory users with valid maintenance agreements
via telephone or online via support queries raised on the customer portal.
To register for the on-line portal, select Help Register. . . or go to directly to the registration page (link
below). Log-in details will be provided by email shortly thereafter.
To log-in to the portal, enter the email (or Login) and Password provided. When raising a new support
query, please include the PowerFactory version and build number in your submission, which can be
found by selecting Help About PowerFactory. . . from the main menu. Note that including relevant
*.dz or *.pfd le(s) may assist with our investigation into your query. The customer portal is shown in
Figure 2.1.1.
Phone: +49-(0)7072-9168-50 (German)
+49-(0)7072-9168-51 (English)
Portal log-in and Registration: http://www.digsilent.de/index.php/support.html
DIgSILENT PowerFactory 15, User Manual 5
CHAPTER 2. CONTACT
Figure 2.1.1: DIgSILENT customer portal
2.2 General Information
For general information about DIgSILENT or your PowerFactory license, please contact us via:
Phone: +49-(0)7072-9168-0
Fax: +49-(0)7072-9168-88
E-mail: mail@digsilent.de
6 DIgSILENT PowerFactory 15, User Manual
Chapter 3
Documentation and Help System
DIgSILENT PowerFactory is provided with a complete help package to support users at all levels of
expertise. Documents with the basic information of the program and its functionality are combined with
references to advanced simulation features, mathematical descriptions of the models and of course
application examples.
PowerFactory offers the following help resources:
Installation Manual: PowerFactory installation guide, describes the procedures followed to install
and set the program. It is available in the PowerFactory installation CD and from the DIgSILENT
Customer Portal under Download.
Ofine Mode Manual: The Ofine Mode manual describes how to congure PowerFactory for
local caching of projects when an external server connection is unavailable. It is available from
the DIgSILENT Customer Portal.
Tutorial: Basic Information for new users and hands-on tutorial. Access via Help menu (CHM le)
of PowerFactory , and the DIgSILENT customer portal (PDF le) by searching for Tutorial on the
Knowledge section.
User Manual: This document. Access via Help menu of PowerFactory. Current and previous
manuals (PDF les) can also be found on the DIgSILENT Customer Portal by search for Manual
on the Knowledge section.
Technical References: Description of the models implemented in PowerFactory for the different
power systems components. The technical reference documents are attached to the online help
(Appendix C: Technical References of Models).
Context Sensitive Help: Pressing the key F1 while working with PowerFactory will lead you di-
rectly to the related topic inside the User Manual.
PowerFactory Examples: The window PowerFactory Examples provides a list of application ex-
amples of PowerFactory calculation functions. Every example comes with an explaining document
which can be opened by pressing the corresponding document button. Additional videos are avail-
able for demonstrating the software handling and its functionalities.
The PowerFactory Examples window will pop up automatically every time the software is open,
this could be deactivated by unchecking the Show at Startup checkbox. PowerFactory Examples
are also accessible on the main menu, by selecting File Examples. . . .
Release Notes: For all new versions and updates of the program Release Notes are provided,
which document the implemented changes. They are available from the DIgSILENT Customer
Portal under Download, and on the DIgSILENT webpage.
FAQs: Users with a valid maintenance agreement can access the FAQ section, on the DIgSILENT
customer portal under Knowledge. In this section you will nd interesting questions and answers
DIgSILENT PowerFactory 15, User Manual 7
CHAPTER 3. DOCUMENTATION AND HELP SYSTEM
regarding specic applications of PowerFactory. See Chapter 2: Contact, for Customer Portal
log-in and registration details.
Technical Support: See Chapter 2: Contact
Portal log-in and Registration:
http://www.digsilent.de/index.php/support.html
Website: www.digsilent.de
8 DIgSILENT PowerFactory 15, User Manual
Chapter 4
PowerFactory Overview
The calculation program PowerFactory , as written by DIgSILENT , is a computer aided engineering
tool for the analysis of transmission, distribution, and industrial electrical power systems. It has been
designed as an advanced integrated and interactive software package dedicated to electrical power
system and control analysis in order to achieve the main objectives of planning and operation optimiza-
tion.
DIgSILENT is an acronym for DIgital SImuLation of Electrical NeTworks. DIgSILENT Version 7 was
the worlds rst power system analysis software with an integrated graphical single-line interface. That
interactive single-line diagram included drawing functions, editing capabilities and all relevant static and
dynamic calculation features.
PowerFactory was designed and developed by qualied engineers and programmers with many years of
experience in both electrical power system analysis and programming elds. The accuracy and validity
of results obtained with PowerFactory has been conrmed in a large number of implementations, by
organizations involved in planning and operation of power systems throughout the world.
To address users power system analysis requirements, PowerFactory was designed as an integrated
engineering tool to provide a comprehensive suite of power system analysis functions within a single
executable program. Key features include:
1. PowerFactory core functions: denition, modication and organization of cases; core numerical
routines; output and documentation functions.
2. Integrated interactive single line graphic and data case handling.
3. Power system element and base case database.
4. Integrated calculation functions (e.g. line and machine parameter calculation based on geometri-
cal or nameplate information).
5. Power system network conguration with interactive or on-line SCADA access.
6. Generic interface for computer-based mapping systems.
Use of a single database, with the required data for all equipment within a power system (e.g. line
data, generator data, protection data, harmonic data, controller data), means that PowerFactory can
easily execute all power simulation functions within a single program environment - functions such as
load-ow, short-circuit calculation, harmonic analysis, protection coordination, stability calculation, and
modal analysis.
Although PowerFactory includes some sophisticated power system analysis functions, the intuitive user
interface makes it possible for new users to very quickly perform common activities such as load-ow
and short-circuit calculations.
DIgSILENT PowerFactory 15, User Manual 9
CHAPTER 4. POWERFACTORY OVERVIEW
The functionality purchased by a user is congured in a matrix, where the licensed calculation functions,
together with the maximum number of busses, are listed as coordinates. The user may, as required,
congure the interface as well as some functions according to their requirements.
Depending on user requirements, a specic PowerFactory license may or may not include all the func-
tions described in this manual. As requirements dictate, additional functionality can be added to a
license. These functions can be used within the same program interface with the same network data.
Only additional data, as may be required by an added calculation function, need be added.
4.1 General Concept
The general PowerFactory program design concept is summarized as follows:
Functional Integration
DIgSILENT PowerFactory software is implemented as a single executable program, and is fully
compatible with Windows 2000/XP/Vista and Windows 7. The programming method employed
allows for fast selection of different calculation functions. There is no need to reload modules and
update or transfer data and results between different program applications. As an example, the
Load Flow, Short-Circuit, and Harmonic Load Flow analysis tools can be executed sequentially
without resetting the program, enabling additional software modules and engines, or reading and
converting external data les.
Vertical Integration
DIgSILENT PowerFactory software has adopted a unique vertically integrated model concept that
allows models to be shared for all analysis functions. Furthermore, studies relating to Genera-
tion, Transmission, Distribution, and Industrial analysis can all be completed within Power-
Factory . Separate software engines are not required to analyze separate aspects of the power
system, or to complete different types of analysis, as DIgSILENT PowerFactory can accommo-
date everything within one integrated program and one integrated database.
Database Integration
Single Database Concepts:DIgSILENT PowerFactory provides optimal organization of data and
denitions required to perform various calculations, memorization of settings or software op-
eration options. The PowerFactory database environment fully integrates all data required for
dening Study Cases, Operation Scenarios, Single Line Graphics, textual and graphical Results,
calculation options, and user-dened models, etc. Everything required to model and simulate
the power system is integrated into a single database which can be congured for single and/or
multiple users.
Project Management: All data that denes a power system model is stored in Project folders
within the database. Inside a Project folder, Study Cases are used to dene different studies
of the system considering the complete network, parts of the network, or Variations on its cur-
rent state. This project and study case approach is used to dene and manage power system
studies in a unique application of the object-oriented software principle. DIgSILENT PowerFac-
tory has taken an innovative approach and introduced a structure that is easy to use, avoids
data redundancy, and simplies the task of data management and validation for users and or-
ganizations. Additionally, the application of Study Cases and project Variations in PowerFactory
facilitates efcient and reliable reproduction of study results.
Multi-User Operation: Multiple users each holding their own projects or working with data
shared from other users are supported by a Multi-user database operation. In this case the def-
inition of access rights, user accounting and groups for data sharing are managed by a database
Administrator.
Ofine Mode: In some instances, a network connection to a server database may not be avail-
10 DIgSILENT PowerFactory 15, User Manual
4.2. DATABASE, OBJECTS, AND CLASSES
able. To address this, PowerFactory provides functionality to work in Ofine Mode. The required
project data is cached to the users local machine, which can then later be synchronized to the
server database. Ofine Mode functionality includes the ability to lock and unlock projects, edit
projects as read-only, and limit the database size on the computer(s) working in ofine mode.
Customization
By default, Beginner and Default user proles are available in PowerFactory . Proles can
be selected from the main menu under Tools Proles. The Beginner prole limits the icons
displayed on the main toolbar to those typically used by new users, such as load-ow and short-
circuit commands. The database Administrator can create and customize user proles, in partic-
ular:
Customize the element dialogue pages that are displayed.
Customize element dialogue parameters. Parameters can be Hidden (not shown) or Disabled
(shown but not editable).
Fully congure Main Toolbar and Drawing Toolbar menus, including denition of custom DPL
Commands and Templates with user-dened icons.
Customize Main Menu, Data Manager, and context-sensitive menu commands.
Chapter 6: User Accounts, User Groups, and Proles (Section 6.5 Creating Proles) details the
customization procedure.
Note: When right-clicking with the mouse button, the available menu options depend on the location of
the mouse pointer. For example, if a load is selected, the menu options are those appropriate for
loads, whereas when the mouse pointer is over the Output Window, the menu options are those
appropriate for the Output Window. These menus are collectively referred to as Context sensitive
menus.
4.2 Database, Objects, and Classes
PowerFactory uses a hierarchical, object-oriented database. All the data, which represents power sys-
temElements, Single Line Graphics, Study Cases, systemOperation Scenarios, calculation commands,
program Settings etc., are stored as objects inside a hierarchical set of folders. The folders are arranged
in order to facilitate the denition of the studies and optimize the use of the tools provided by the pro-
gram.
The objects are grouped according to the kind of element that they represent. These groups are
known as Classes within the PowerFactory environment. For example, an object that represents a
synchronous generator in a power system belongs to a Class called ElmSym, and an object storing the
settings for a load ow calculation belongs to a Class called ComLdf. Object Classes are analogous
to computer le extensions. Each object belongs to a Class and each Class has a specic set of pa-
rameters that denes the objects it represents. As explained in Section 4.8 (User Interface), the edit
dialogues are the interfaces between the user and an object; the parameters dening the object are
accessed through this dialogue. This means that there is an edit dialogue for each class of objects.
Note: Everything in PowerFactory is an object, all the objects belong to a Class and are stored accord-
ing to a hierarchical arrangement in the database tree.
DIgSILENT PowerFactory 15, User Manual 11
CHAPTER 4. POWERFACTORY OVERVIEW
4.3 PowerFactory Simulation Functions
PowerFactory incorporates a comprehensive list of simulation functions, described in detail in Volume II
of the manual, including the following:
Load Flow Analysis, allowing meshed and mixed 1-,2-, and 3-phase AC and/or DC networks
(Chapter 21: Load Flow Analysis).
Low Voltage Network Analysis (Section 21.2.3: Advanced Load Options).
Short-Circuit Analysis, for meshed and mixed 1-,2-, and 3-phase AC networks (Chapter 22: Short-
Circuit Analysis).
Harmonic Analysis (Chapter 23: Harmonics Analysis).
RMS Simulation (time-domain simulation for stability analysis, Chapter 25: Stability and EMT
Simulations).
EMT Simulation (time-domain simulation of electromagnetic transients, Chapter 25: Stability and
EMT Simulations).
Eigenvalue Analysis (Chapter 26: Modal Analysis / Eigenvalue Calculation).
Model Parameter Identication (Chapter 27: Model Parameter Identication).
Contingency Analysis (Chapter 28: Contingency Analysis).
Reliability Analysis (Chapter 29: Reliability Assessment).
Generation Adequacy Analysis (Chapter 30: Generation Adequacy Analysis).
Optimal Power Flow (Chapter 31: Optimal Power Flow).
Distribution Network Optimization (Chapter 33: Distribution Network Tools).
Protection Analysis (Chapter 38: Protection).
Network Reduction (Chapter 39: Network Reduction).
State Estimation (Chapter 40: State Estimation).
4.4 General Design of PowerFactory
PowerFactory is primarily intended to be used and operated in a graphical environment. That is, data is
entered by drawing the network Elements, and then editing and assigning data to these objects. Data
is accessed from the graphics page by double-clicking on an object. An input dialogue is displayed and
the user may then edit the data for that object.
Figure 4.4.1 shows the PowerFactory Graphical User Interface (GUI) when a project is active. The GUI
is discussed in further detail in Section 4.8
12 DIgSILENT PowerFactory 15, User Manual
4.4. GENERAL DESIGN OF POWERFACTORY
Figure 4.4.1: PowerFactory Main Window
All data entered for objects is hierarchically structured in folders for ease of navigation. To view the data
and its organization, a Data Manager is used. Figure 4.4.2 shows the Data Manager window. The
Data Manager is similar in appearance and functionality to a Windows Explorer window.
Within the Data Manager, information is grouped based on two main criterion:
1. Data that pertains directly to the system under study, that is, electrical data.
2. Study management data, for example, which graphics should be displayed, what options have
been chosen for a Load Flow, which Areas of the network should be considered for calculation,
etc.
Figure 4.4.2: PowerFactory Data Manager
DIgSILENT PowerFactory 15, User Manual 13
CHAPTER 4. POWERFACTORY OVERVIEW
Note that most user-actions can be performed in both the Single Line Graphic and the Data Manager.
For example, a new terminal can be added directly to the Single Line Graphic, or alternatively created
in the Data Manager. In the latter case, the terminal could be shown in the Single Line Graphic by
drawing existing net elements, by dragging and dropping from the Data Manager, or by creating a
new Graphical Net Object in the Data Manger (advanced).
4.5 Type and Element Data
Since power systems are constructed using standardized materials and components, it is convenient to
divide electrical data into two sets, namely Type data and Element data sets.
Characteristic electrical parameters, such as the reactance per km of a line, or the rated voltage of
a transformer are referred to as Type data. Type objects are generally stored in the Global Library
or Project Library, and are shown in red. For instance, a Line Type object, TypLne ( ).
Data relating to a particular instance of equipment, such as the length of a line, the derating
factor of a cable, the name of a load, the connecting node of a generator, or the tap position of a
transformer are referred to as Element data. Element objects are generally stored in the Network
Data folder, and are shown in green. For instance, a Line Element object, ElmLne ( ).
Consider the following example:
A cable has a Type reactance of X Ohms/ km, say 0.1 Ohms/ km.
A cable section of length L is used for a particular installation, say 600 m, or 0.6 km.
This section (Element) therefore has an reactance of X * L Ohms, or 0.06 Ohms.
Note that Element parameters can be modied using Operation Scenarios (which store sets of network
operational data), and Parameter Characteristics (which can be used to modify parameters based on
the Study Case Time, or other user-dened trigger).
4.6 Data Arrangement
The PowerFactory database supports multiple users (as mentioned in 4.1) and each user can manage
multiple projects. User Account folders with access privileges only for their owners (and other users
with shared rights) must then be used. User accounts are of course in a higher level than projects.
Figure 4.6.1 shows a snapshot from a database as seen by the user in a Data Manager window, where
there User Accounts for Demo and User, and one project titled Project. The main folders used to
arrange data in PowerFactory are summarized below:
14 DIgSILENT PowerFactory 15, User Manual
4.6. DATA ARRANGEMENT
Figure 4.6.1: Structure of a PowerFactory project in the Data Manager
4.6.1 Global Library
This global Library contains a wide range of pre-dened models, including:
Type data for standard components such as conductors, motors, generators, and transformers.
Standard control system frames, models, and macros (i.e. transfer functions and logic blocks,
etc).
Standard CT, VT, fuse, and relay models.
Pre-dened model templates, including:
Battery System with frequency control (10 kV, 30 MVA).
Double Fed Induction Wind Turbine Generator (0.69 kV, 2 MW).
Fully Rated Converter Wind Turbine Generator (0.4 kV, 2 MW).
Variable Rotor Resistance Wind Turbine Generator (0.69 kV, 0.66 MW).
Photovoltaic System (0.4 kV, 0.5 MVA)
DIgSILENT PowerFactory 15, User Manual 15
CHAPTER 4. POWERFACTORY OVERVIEW
Standard DPL scripts, including scripts to:
Produce PV and QV curves.
Minimize the Net Present Value of project (Variation) costs by varying the project service
date.
Conduct time-sweep load ow calculations.
4.6.2 Project Library
The project Library contains the equipment Types, network operational information, DPL scripts, tem-
plates, and user-dened models (generally) only used within a particular project. A particular project
may have references to the project Library and / or global Library. The Project Library folder and sub-
folders are discussed in detail in Chapter 12 (Project Library).
4.6.3 Diagrams
Single Line Graphics are dened in PowerFactory by means of graphic folders of class IntGrfNet ( ).
Each diagram corresponds to a IntGrfNet folder. They are stored in the Network Diagrams folder ( ) of
the Network Model. Single line diagrams are composed of graphical objects, which represent compo-
nents of the networks under study. Graphical components reference network components and symbol
objects (IntSym).
The relation between graphical objects and network components allows the denition and modication
of the studied networks directly fromthe Single Line Graphics. Network components can be represented
by more than one graphical object (many IntGrf objects can refer to the same network component).
Therefore, one component can appear in several diagrams.
These diagrams are managed by the active Study Case, and specically by an object called the Graph-
ics Board. If a reference to a network diagram is stored in a Study Cases Graphics Board, when the
Study Case is activated, the diagram is automatically opened. Diagrams can be easily added and
deleted from the Graphics Boards.
Each diagram is related to a specic Grid (ElmNet ). When a Grid is added to an active Study Case, the
user is asked to select (among the diagrams pointing to that grid) the diagrams to display. References
to the selected diagrams are then automatically created in the corresponding Graphics Board.
Chapter 9 (Network Graphics (Single Line Diagrams)), explains how to dene and work with single line
graphics.
4.6.4 Network Data
The Network Data folder holds network data (Element data) in Grid folders, network modication
information in Variation folders, and object Grouping information.
Grids
In PowerFactory , electrical network information is stored in Grid folders (ElmNet, ). A power system
may have as many grids as dened by the user. These grids may or may not be interconnected. As long
as they are active, they are considered by the calculations. Data may be sorted according to logical,
organizational and/or geographical areas (discussed further in Section 4.7: Project Structure).
An example of this approach is the Tutorial project provided with the Getting Started Manual. In this
project, a distribution network and a transmission network are created and analyzed separately. At a
later stage both networks are connected and the analysis of the complete system is carried out.
16 DIgSILENT PowerFactory 15, User Manual
4.6. DATA ARRANGEMENT
Note: A Grid (and in general any object comprising the data model) is active when it is referred to by
the current study case. Only objects referred in the current (active) Study Case are considered for
calculation. In the Data Manager, the icon of an active Grid is shown in red, to distinguish it from
inactive Grids.
For details of how to dene grids refer to Chapter 8.Basic Project Denition, Section 8.2 (Creating New
Grids).
Variations
During the planning and assessment of a power system, it is often necessary to analyze different vari-
ations and expansion alternatives of the base network. In PowerFactory these variations are modelled
by means of Variations. These are objects that store and implement required changes to a network,
and can be easily activated and deactivated. The use of Variations allows the user to conduct studies
under different network congurations in an organized and simple way.
Variation objects (IntScheme, ) are stored inside the Variations folder ( ) which resides in the Net-
work Model folder. Variations are composed of Expansion Stages (IntStage), which store the changes
made to the original network(s). The application of these changes depends on the current study time
and the activation time of the Expansion Stages.
The study time is a parameter of the active Study Case, and is used to situate the current study within a
time frame. The activation time is a parameter given to the Expansion Stages, to determine whether or
not, according to the study time, the changes contained within the Expansion Stages are applied to the
network. If the activation time precedes the study time, the changes are applied to the original network.
The changes of a subsequent expansion stage add to the changes of its predecessors.
In order that changes to the network conguration are applied and can be viewed, a Variation must be
activated. These changes are contained in the expansion stage(s) of this active Variation. Once the
Variation is deactivated, the network returns to its original state. Changes contained in an Expansion
Stage can be classied as:
Modications to network components.
Components added to the network.
Components deleted from the network.
Note: If there is no active Operation Scenario, modications to operational data will be stored in the
active Variation.
Grouping Objects
In addition to Grid folders, the Network Data folder contains a set of objects that allow further grouping
of network components. By default, when a new project is created, new empty folders to store these
grouping objects is created inside the Network Model folder.
For details of how to dene grouping objects, refer to Chapter 13: Grouping Objects.
4.6.5 Operation Scenarios
Operation Scenarios may be used to store operational settings, a subset of Element data. Operational
data includes data that relates to the operational point of a device but not to the device itself e.g. the tap
position of a transformer or the active power dispatch of a generator. Operation Scenarios are stored in
the Operation Scenarios folder.
DIgSILENT PowerFactory 15, User Manual 17
CHAPTER 4. POWERFACTORY OVERVIEW
4.6.6 Study Cases
The Study Cases folder holds study management information. Study Cases are used to store informa-
tion such as command settings, active Variations and Operations Scenarios, graphics to be displayed,
and study results. See Chapter 11 (Study Cases) for details.
4.6.7 Settings
Project settings such as user-dened diagram styles for example, which differ from global settings, are
stored inside the Settings folder.
4.7 Project Structure
The structure of project data depends on the complexity of the network, use of the model, and user
preferences. The user has the exibility to dene network components directly within the Grid, or to
organize and group components in a way that simplies management of project data.
Consider the example network data arrangement shown in Figure 4.7.1 In this case, two busbar sys-
tems (ElmSubstat in PowerFactory ) have been dened, one at 132 kV, and one at 66 kV. The two
busbar systems are grouped within a Site, which includes the 132 kV / 66 kV transformers (not shown
in Figure 4.7.1). A Branch composed of two line sections and a node connects 132 kV Busbar to
HV terminal. Grouping of components in this way simplies the arrangement of data within the Data
Manager, facilitates the drawing overview diagrams, and facilitates storing of Substation switching con-
gurations.
Figure 4.7.1: Example Project Structure
The following subsections provide further information regarding the PowerFactory representation of key
network topological components.
4.7.1 Nodes
In PowerFactory , nodes connecting lines, generators, loads, etc. to the network are generally called
Terminals (ElmTerm). Depending on their usage within the power system, Terminals can be used to
represent Busbars, Junctions, or Internal Nodes (their usage is dened by a drop down menu found in
the Basic Data page of the terminal dialogue). According to the selected usage, different calculation
functions are enabled; for example the short-circuit calculation can be performed only for busbars, or
for busbars and internal nodes, and so on.
18 DIgSILENT PowerFactory 15, User Manual
4.7. PROJECT STRUCTURE
4.7.2 Branches
Elements with multiple connections are referred to Branches (as distinct from a Branch Element,
which is a grouping of elements, discussed in Section 4.7.7). Branches include two-connection el-
ements such as transmission lines and transformers, and three-connection elements such as three-
winding transformers, AC/DC converters with two DC terminals, etc.
For information about how to dene transmission lines (and cables) and sections refer to Chapter 9: Net-
work Graphics, Section 9.2(Dening Network Models with the Graphical Editor). Technical information
about transmission line and cable models is provided in Appendix C (Line (ElmLne)).
4.7.3 Cubicles
When any branch element is directly connected to a Terminal, PowerFactory uses a Cubicle (StaCubic)
to dene the connection. Cubicles can be visualized as the panels on a switchgear board, or bays
in a high voltage yard, to which the branch elements are connected. A Cubicle is generally created
automatically when an element is connected to a node (note that Cubicles are not shown on the Single
Line Graphic).
4.7.4 Switches
To model complex busbar-substation congurations, switches (ElmCoup) can be used. Their usage
can be set to Circuit-Breaker, Disconnector, Switch Disconnector, or Load Switch. The connection of
an ElmCoup to a Terminal is carried out by means of an automatically generated Cubicle without any
additional switch (StaSwitch) object.
4.7.5 Substations
Detailed busbar congurations are represented in PowerFactory as Substations (ElmSubstat ). Sepa-
rate single line diagrams of individual substations can be created. Substation objects allow the use
of running arrangements to store/set station circuit breaker statuses (see Chapter 12: Project Library,
Section 12.3: Operational Library). For information about how to dene substations refer to Chapter 9:
Network Graphics, Section 9.2(Dening Network Models with the Graphical Editor) and Chapter 10,
Section 10.3(Dening Network Models with the Data Manager).
4.7.6 Sites
Network components including Substations and Branches can be grouped together within a Site (Elm-
Site). This may include Elements such as substations / busbars at different voltage levels. For informa-
tion about how to dene sites refer to Chapter 10, Section 10.3(Dening Network Models with the Data
Manager).
4.7.7 Branch Elements
Similar to Substations, Terminal Elements and Line Elements can be stored within an object called a
Branch Element (ElmBranch). Branches are composite two-port elements that may be connected to
a Terminal at each end. They may contain multiple Terminals, Line sections (possible including various
line types), and Loads etc, but be represented as a single Branch on the Single Line Graphic. As for
Substations, separate diagrams for the detailed branch can be created with the graphical editor.
DIgSILENT PowerFactory 15, User Manual 19
CHAPTER 4. POWERFACTORY OVERVIEW
For information about how to dene branches refer to Chapter 9: Network Graphics, Section 9.2(Den-
ing Network Models with the Graphical Editor) and Chapter 10, Section 10.3(Dening Network Models
with the Data Manager).
4.8 User Interface
An overview of the PowerFactory user interface is provided in this section, including general discussion
of the functionality available to enter and manipulate data and graphics. Aspects of the user interface
are discussed in further detail in the following chapters, in particular:
Chapter 6 (User Accounts, User Groups, and Proles).
Chapter 9(Network Graphics (Single Line Diagrams)).
Chapter 10 (Data Manager).
4.8.1 Overview
The main PowerFactory window is shown in Figure 4.8.1
Figure 4.8.1: PowerFactory user interface
Key features of the main window are as follows:
1. The main window includes a description of the PowerFactory version, and standard icons to Mini-
mize, Maximize/Restore, Resize, and Close the window.
20 DIgSILENT PowerFactory 15, User Manual
4.8. USER INTERFACE
2. The main menu bar includes drop-down menu selections. The main menu is discussed further in
section 4.8.2 (Menu Bar).
3. The Main Toolbar includes commands and other icons. The Main Toolbar is discussed in further
detail in section 4.8.3 (Main Toolbar).
4. The Graphical Editor displays single line diagrams, block diagrams and/or simulation plots of the
active project. Studied networks and simulation models can be directly modied from the graphical
editor by placing and connecting elements.
5. When an object is right clicked (in the graphical editor or in the data manager) a context sensitive
menu with several possible actions appears.
6. When an object is double clicked its edit dialogue will be displayed. The edit dialogue is the inter-
face between an object and the user. The parameters dening the object are accessed through
this edit dialogue. Normally an edit dialogue is composed of several pages. Each page groups
parameters that are relevant to a certain function. In Figure 4.8.1 the Load Flow page of a gener-
ator is shown, where only generator parameters relevant to load ow calculations are shown.
7. The Data Manager is the direct interface with the database. It is similar in appearance and
functionality to a Windows Explorer window. The left pane displays a symbolic tree representation
of the complete database. The right pane is a data browser that shows the content of the currently
selected folder. The data manager can be accessed by pressing the Data Manager icon ( )
on the left of the main toolbar. It is always oating, and more than one can be active at a
time. Depending on how the user navigates to the Database Manager, it may only show the
database tree for selecting a database folder, or it may show the full database tree. The primary
functionality of the Data Manager is to provide access to power system components/objects. The
data manager can be used to edit a group of selected objects within the data manager in tabular
format. Alternatively, objects may be individually edited by double clicking on an object (or right-
click Edit ).
8. The output window is shown at the bottom of the PowerFactory window. The output window cannot
be closed, but can be minimized. The output window is discussed in further detail in section 4.8.4
(The Output Window).
9. The Project Overview window is displayed by default on the left side of the main application
window between the main toolbar and the output window. It displays an overview of the project
allowing the user to assess the state of the project at a glance and facilitating easy interaction with
the project data.
4.8.2 Menu Bar
The menu bar contains the main PowerFactory menus. Each menu entry has a drop down list of menu
options and each menu option performs a specic action. To open a drop down list, either click on the
menu entry with the left mouse button, or press the Alt key together with the underlined letter in the
menu. Menu options that are shown in grey are not available, and only become available as the user
activates projects or calculation modes, as required.
DIgSILENT PowerFactory 15, User Manual 21
CHAPTER 4. POWERFACTORY OVERVIEW
Figure 4.8.2: The help menu on the Menu bar
For example as show in Figure 4.8.2:
To access PowerFactory tutorials: Press Alt-H to open the help menu. Use the keyboard to select
Start Tutorial. Press Execute to open the Tutorial. Note that the on-line Getting Started Tutorial is
identical to the printed version.
To access the User Manual: Left click the Help menu. Left-click the option User Manual to open
the electronic User Manual.
4.8.3 Main Toolbar
The main PowerFactory toolbar provides the user with quick access to the main commands available
in the program (see Figure 4.8.1). Buttons that appear in grey are only active when appropriate. All
command icons are equipped with balloon help text which are displayed when the cursor is held still
over the icon for a moment, and no key is pressed.
To use a command icon, click on it with the left mouse button. Those icons that perform a task will
automatically return to a non-depressed state when that task is nished. Some command icons will
remain depressed, such as the button to Maximise Output Window. When pressed again, the button
will return to the original (non-depressed) state.
This section provides a brief explanation of the purpose of the icons found on the upper part of the
toolbar. Icons from the lower part of the toolbar are discussed in Chapter 9(Network Graphics (Single
Line Diagrams)). Detailed explanations for each of the functions that the icons command are provided
in the other sections of the manual.
Open Data Manager
Opens a new instance of the Database Manager. When the option Use Multiple Data Manager
is enabled in the user settings menu (User Settings General ) the user will be able to open
as many instances of the data manager as required. If Use Multiple Data Manager is disabled
in the user settings menu, the rst instance of the data manager will be re-opened. For more
information on the Data Manager refer to Chapter 10.
Edit Relevant Objects for Calculation
Provides a list of elements (coloured in green) and types (coloured in red) that are in an active
Grid: e.g. transformer types, line elements, composite models, etc. When an object icon is
selected, all objects from the selected class(es) will be shown in a browser.
22 DIgSILENT PowerFactory 15, User Manual
4.8. USER INTERFACE
Date/Time of Calculation Case (SetTime)
Displays the date and time for the case calculation. This option is used when parameter charac-
teristics of specic elements (e.g. active and reactive power of loads) are set to change according
to the study time, or a Variation status is set to change with the study time.
Edit Trigger
Displays a list of all Triggers that are in the active Study Case. These Triggers can be edited in
order to change the values for which one or more characteristics are dened. These values will
be modied with reference to the new Trigger value. All Triggers for all relevant characteristics
are automatically listed. If required, new Triggers will be created in the Study Case. For more
information, see Chapter 16: Parameter Characteristics, Load States, and Tariffs. Section 16.2
(Parameter Characteristics).
Data Verication (ComCheck)
Performs model data verication, see Section 21.5 (Troubleshooting Load Flow Calculation Prob-
lems).
Calculate Load-Flow (ComLdf)
Activates the load-ow command dialogue. For more information about the specic settings, refer
to Chapter 21 (Load Flow Analysis).
Calculate Short-Circuit (ComShc)
Activates the short-circuit calculation command dialogue. For more information, refer to Chap-
ter 22 (Short-Circuit Analysis).
Edit Short-Circuits
Edits Short-Circuit events. Events are used when a calculation requires more than one action or
considers more than one object for the calculation. Multiple fault analysis is an example of this. If,
for instance, the user multi-selects two busbars (using the cursor) and then clicks the right mouse
button Calculate Multiple Faults a Short-circuit event list will be created with these two busbars
in it.
Execute DPL Scripts
Displays a list of DPL scripts that are available. See section 4.9 for a general description of DPL
scripts, and Chapter 19 (The DIgSILENT Programming Language - DPL) for detailed information.
Output Calculation Analysis (ComSh)
Presents calculation results in various formats. The output is printed to the Output Window and
can be viewed, or copied for use in external reports. Several different reports, depending on
the calculation, can be created. For more information about the output of results refer to Chap-
ter 17:Reporting and Visualizing Results, Section 17.2.3 (Output of Results).
Documentation of Device Data (ComDocu)
Presents a listing of device data (a device is the model of any physical object that has been en-
tered into the project for study). This output may be used in reports, and for checking data that
has been entered. Depending on the element chosen for the report, the user has two options;
generate a short listing, or a detailed report. For more information please refer to Chapter 17:Re-
porting and Visualizing Results, Section 17.2.3 (Output of Results).
Comparing of Results On/Off
Turns on/off comparing of calculation results. Used to compare results where certain settings
DIgSILENT PowerFactory 15, User Manual 23
CHAPTER 4. POWERFACTORY OVERVIEW
or designs options of a power system have been changed from one calculation to the next. For
more information please refer to Chapter 17:Reporting and Visualizing Results, Section 17.3
(Comparisons Between Calculations).
Edit Comparing of Results (CommDiff)
Enables the user to select the cases/ calculation results that are to be compared to one an-
other, or to set the colouring mode for the difference reporting. For more information please refer
to Chapter 17:Reporting and Visualizing Results, Section 17.3 (Comparisons Between Calcula-
tions).
Update Database
Utilizes the current calculations results (i.e. the calculation output data) to change input param-
eters (i.e. data the user has entered). An example is the transformer tap positions, where these
have been calculated by the load-ow command option Automatic Tap Adjust of Tap Chang-
ers. For more information refer to Chapter 17:Reporting and Visualizing Results, Section 17.3
(Comparisons Between Calculations).
Save Operation Scenario
Saves the current operational data to an Operation Scenario (e.g. load values, switch statuses,
etc.). See Chapter 14 (Operation Scenarios).
Break
Stops a transient simulation or DPL script that is running.
Reset Calculation
Resets any calculation performed previously. This icon is only enabled after a calculation has
been carried out.
Note: In User Settings, on the General page, if Retention of results after network change is set to Show
last results in the User Settings (see Chapter 7: User Settings, section 7.1), results will appear in
grey on the Single Line Diagram and on the Flexible Data tab until the calculation is reset, or a
new calculation performed.
User Settings (SetUser)
User options for many global features of PowerFactory may be set from the dialogue accessed
by this icon. For more information refer to Chapter 7 (User Settings).
Maximize Graphic Window
Maximizes the graphic window. Pressing this icon again will return the graphic window to its
original state.
Maximize Output Window
Maximizes the output window. Pressing this icon again will return the output window to its original
state.
Change Toolbox
In order to minimize the number of icons displayed on the taskbar, some icons are grouped based
on the type of analysis, and are only displayed when the relevant category is selected from the
Change Toolbox icon. In Figure 4.8.3, the user has selected RMS/EMT Simulation, and therefore
only icons relevant for RMS and EMT studies are displayed to the right of the Change Toolbox
icon. If, for example, Reliability Assessment were selected then icons to the right of the Change
24 DIgSILENT PowerFactory 15, User Manual
4.8. USER INTERFACE
Toolbox icon would change to those suitable for a reliability assessment.
Figure 4.8.3: Change Toolbox selection
4.8.4 The Output Window
In addition to results presented in the Single Line Graphics and / or Data Manager, the Output Window
displays other textual output, such as error messages, warnings, command messages, device docu-
mentation, result of calculations, and generated reports, etc. This section describes Output Window
use and functionality.
Sizing and Positioning the Output Window
The default location of the Output Window is docked (xed) at the bottom of the main window, as
shown in Figure 4.8.1 It can be minimized, but not closed. When right-clicking the mouse button with the
cursor in the output windows area, the context sensitive menu of the output window appears. The output
window can then be undocked by deselecting the Dock Output Window. The undocked output window
is still conned to the main window, but now as a free oating window. This can occur unintentionally
when the user left clicks the tool bar for the output window and drags the mouse (keeping the mouse
button down) to somewhere outside of the output window boundaries. To rectify this simply left-click in
the title bar of the undocked window and drag it down to the bottom of the screen where it will dock once
more (if you have right-clicked and unticked Docking View then right click and select Docking View
once more).
The upper edge of the output window shows a splitter bar which is used to change the size of the output
window. The drag cursor appears automatically when the cursor is placed on the splitter bar. The left
mouse button can be pressed when the drag cursor is visible. This will turn the splitter bar to grey and
the output window can now be resized by holding down the mouse button and moving the mouse up or
down.
The output window may be moved and resized by:
Dragging the splitter bar (grey bar at the upper edge of the output window) when the output window
is in docking mode.
Double-clicking the frame of the output window to dock/undock it from the main window.
Pressing the Maximize Graphic Window icon ( ) on the main toolbar to enlarge the graphics
board by hiding the output window.
DIgSILENT PowerFactory 15, User Manual 25
CHAPTER 4. POWERFACTORY OVERVIEW
Pressing the Maximize Output Window icon ( ) icons on the main toolbar to enlarge the output
window.
Output Window Options The contents of the output window may be stored, edited, redirected, etc.,
using the icons shown on the right-hand pane of the output window. Some commands are also available
from the context sensitive menu by right-clicking the mouse in the output window pane.
Opens an editor. The user can copy and paste text from the output window to the editor, and
manually type data in the editor.
Opens a previously saved output le.
Saves the selected text to an ASCII le, or the complete contents of the output window if no selection
was made.
Copies the selected text to the Windows Clipboard. Text may then be pasted in other programs.
Clears the output window by deleting all messages. Note that when the user scrolls through previous
messages in the output window, the output window will no longer automatically scroll with new
output messages. The Clear All icon will reset scrolling of the output window.
Searches the text in the output window for the occurrences of a given text.
Changes the font used in the output window.
Redirects the output window to a le. The output window will not display messages while this icon
is depressed.
Redirects the output window to be printed directly.
Redirects the output window to be printed directly.
Using the Output Window
The Output Window facilitates preparation of data for calculations, and identication of network data
errors. Objects listed in the output window (with a folder name and object name) can be double-clicked
with the left mouse button to open an edit dialogue for the object. Alternatively, the object can be
right-clicked and then Edit, Edit and Browse Object, or Mark in Graphic selected. For example, if
a Synchronous Machine Element does not have a Type dened, the load-ow will not solve and a
message will be reported. (see Figure 4.8.4). This simplies the task of locating objects in the Single
Line Graphic.
Figure 4.8.4: Output Window Context Sensitive Menu
Output Window Context Sensitive Menu
As mentioned in the previous section, to show the Output Windows context sensitive menu, right-click
the mouse button whilst pointing at the object name. The available option are as follows:
26 DIgSILENT PowerFactory 15, User Manual
4.8. USER INTERFACE
Edit Object : Opens the edit dialogue of the selected object.
Edit and Browse Object : Opens a Data Manager and displays the Element and its parameters.
Mark in Graphic: Marks the selected element in the Single Line Graphic and zooms into the region
it is placed.
Output Window Legend
The Output Window uses colours and other formatting to distinguish between different types of mes-
sages, and for bar graph results. Used text message formats are as follows:
DIgSI/err - ... Error messages. Format: red coloured.
DIgSI/info - .... Information messages. Format: green coloured.
DIgSI/wrng - ... Warning message. Format: brown coloured.
DIgSI/pcl - ... Protocol message. Format: blue coloured.
Text only Output text. Format: black coloured.
Output Window Graphical Results
Reports of calculation results may contain bar graphical information. The voltage proles report after
a load-ow command, for instance, produces bar graphs of the per-unit voltages of busbars. These
bars will be coloured blue, green or red if the Verication option in the load-ow command dialogue
has been enabled. They will be hatch-crossed if the bars are too large to display.
Part of a bar graph output is shown in Figure 4.8.5 The following formatting is visible:
Figure 4.8.5: Output window bar diagram
Green Solid Bar: Used when the value is in the tolerated range.
Blue Solid Bar: Used when the value is below a limit.
Red Solid Bar: Used when the value is above a limit.
Hatch-crossed Bar: Used when the value is outside the range.
DIgSILENT PowerFactory 15, User Manual 27
CHAPTER 4. POWERFACTORY OVERVIEW
Copying from the Output Window
The contents of the Output Window, or parts of its contents, may be copied to the built-in editor of
PowerFactory , or to other programs. Normally, not all selected lines will be copied and the format of the
copied text may undergo changes. The latter is caused by the fact that the PowerFactory output window
uses special formatting escape sequences, which other programs may not support.
The lines that are to be copied is determined by the Output Window settings. When text from the output
window is copied, an info message will be displayed, informing the user about the current settings (see
Figure 4.8.6). From this dialogue, the Output Window User Settings may be modied, and the Info
message may be disabled.
Figure 4.8.6: The output window Info Message
4.9 DIgSILENT Programming Language (DPL) Scripts
The DIgSILENT Programming Language DPL offers an interface to the user for the automation of tasks
in PowerFactory . By means of a simple programming language and in-built editor, the user can dene
automation commands (scripts) to perform iterative or repetitive calculations on target networks, and
post-process the results.
To nd the name of an object parameter to be used in a DPL script, simply hover the mouse pointer
over the relevant eld in an object dialogue. For example, for a General Load, on the Load Flow page,
hover the mouse pointer over the Active Power eld to show the parameter name plini.
User-dened DPL scripts can be used in all areas of power system analysis, for example:
Network optimization.
Cable-sizing.
Protection coordination.
Stability analysis.
Parametric sweep analysis.
Contingency analysis.
DPL scripts may include the following:
28 DIgSILENT PowerFactory 15, User Manual
4.9. DIGSILENT PROGRAMMING LANGUAGE (DPL) SCRIPTS
Program ow commands such as if-else and do-while.
PowerFactory commands (i.e. load-ow or short-circuit commands: ComLdf, ComShc).
Input and output routines.
Mathematical expressions.
PowerFactory object procedure calls.
Subroutine calls.
DPL command objects provide an interface for the conguration, preparation, and use of DPL scripts.
These objects may take input parameters, variables and/or objects, pass these to functions or subrou-
tines, and then output results. DPL commands are stored inside the Scripts folder ( ) in the project
directory.
Consider the following simple example shown in Figure 4.9.1 to illustrate the DPL interface, and the
versatility of DPL scripts to take a user-selection from the Single Line Graphic. The example DPL script
takes a load selection from the Single Line Graphic, and implements a while loop to output the Load
name(s) to the Output Window. Note that there is also a check to see if any loads have been selected
by the user.
Figure 4.9.1: Example DPL Script
For further information about DPL commands and how to write and execute DPL scripts refer to Chap-
ter 19 (The DIgSILENT Programming Language - DPL), and Appendix D DPL Reference.
DIgSILENT PowerFactory 15, User Manual 29
CHAPTER 4. POWERFACTORY OVERVIEW
30 DIgSILENT PowerFactory 15, User Manual
Part II
Administration
Chapter 5
Program Administration
This chapter provides information on how to congure the program, and how to log on. More Detailed
descriptions of the installation, database settings and additional information on these topics can be
found in the PowerFactory Installation Manual.
5.1 Program Installation and Conguration
In general there are 3 main questions to be answered before installing the software, the answers to
these questions will determine the installation settings:
License: Where should the license key(s) reside?
Installation: Where should PowerFactory be installed?
Database: Where should the database reside?
Once PowerFactory has been set up in a computer, the installation setting is carried out by means of a
Log-on dialogue. This dialogue pops up automatically when the program is opened for the rst time.
Through the Licence, Network and Database tabs of the Log-on dialogue, the answers to the questions
above are provided and the program installation is congured.
A detailed description of the installation procedure and the program conguration alternatives is given
in the PowerFactory Installation Manual. The next section provides reference information about the
Log-on dialogue.
5.2 The Log-on Dialogue
The application of PowerFactory is carried out within a user session. Since an account system is used,
it is necessary to log on when starting a session. Immediately after opening the program a Log-on dia-
logue is presented, there the user must specify his/her credentials. As indicated in Section 5.1(Program
Installation and Conguration) the Log-on dialogue also serves as interface to the program settings.
To start a session, the user must always provide the corresponding name and password (credentials).
Unless they have changed, the installations settings do not need to be update every time a session
starts.
DIgSILENT PowerFactory 15, User Manual 33
CHAPTER 5. PROGRAM ADMINISTRATION
Note: A user account is the working space of a specic user (the account owner) within the DB. It
is the object where the user stores his projects and settings. To access a specic account the
corresponding user name and password must be given. Information on the account management
system and how to share information with other users is given in Chapter 18 (Data Management).
The description on how data is arranged within PowerFactory is given in Chapter 12 (Project Li-
brary).
5.2.1 Log On Conguration
Figure 5.2.1: The Log-on Dialogue, User Credentials
Once the PowerFactory installation had been set, a name and a password must be given in order to ac-
cess an account and start to use the program. The Administrator account is created when installing
PowerFactory and is used to create and manage users accounts in a multi-user environment (see
Chapter 6: User Accounts, User Groups, and Proles). To log on as administrator, just select write
Administrator in the name eld (5.2.1) and use the assigned password. By default the administrator
account password is Administrator.
Users other than the Administrator, require their own name and password to log on. When using a
stand alone installation, a new user account can be created by typing in a new name and clicking
on Create a new user, and then a password (an empty password is also accepted). In a multi-user
installation (see Chapter 6: User Accounts, User Groups, and Proles) new accounts and passwords
are created by the administrator.
For further information about the roll of the database administrator please refer Section 6.2: The
Database Administrator.
5.2.2 License Settings
In order to run the program, the user require to dene the License Setting in the License page of the
Log-on dialogue, as showed in gure 5.2.2. The options are described below, more information about
the licenses types is available in the PowerFactory Installation Manual
34 DIgSILENT PowerFactory 15, User Manual
5.2. THE LOG-ON DIALOGUE
Figure 5.2.2: Log-on Dialogue License Settings
Activation le or Demo request
An activation le must be available in the corresponding directory. When starting PowerFactory for the
rst time with this option, the DIgSILENT License Administration dialogue is open with the instructions
to get the activation le.
PowerFactory Workstation
This option is for single-user clients with a license key (also known as a dongle or hardlock).
PowerFactory Server
This option if for multi-user clients with a license key which allows access to several users over a
network.
The network license key requires an additional program which is also part of the installation package:
License Server.
When using PowerFactory Server, the computer name or the IP network address of the license server
is required.
Advanced RPC-Settings
If a network license key with protocol based communication is used, the Advanced RPC-Settings must
be given. These elds, are in the the Advanced tab of the License page.
The RPC settings must be the ones specied in the license server. For detailed information the network
administrator should be consulted also more information is available in the PowerFactory Installation
Manual.
5.2.3 Network Settings
The PowerFactory installation directory contains the applications binaries; the working directory con-
tains some temporary data, an error log le and the local database. In the Network page of the Log-on
dialogue, the location of the PowerFactory installation and working directories is dened. Depending on
that location three installation types are available:
on local machine Locally installed on individual computers.
on le server Only the working directory of each client resides on the local hard disk.
on an application server (e.g. Terminal Server) The installation and working directories reside
on a server.
DIgSILENT PowerFactory 15, User Manual 35
CHAPTER 5. PROGRAM ADMINISTRATION
A detailed description of the different installation methods is given in the PowerFactory Installation
Manual, it is especially recommended to review this document when using Multi-User Database.
5.2.4 Database Conguration
In this page it is specied how the database is going to be used. You can select among:
A single-user database which resides locally on each computer.
A multi-user database which resides on an remote server. Here all users have access to the same
data simultaneously. In this case user accounts are created and administrated exclusively by the
Administrator.
DIgSILENT PowerFactory provides drivers for the following multi-user database systems:
Oracle.
Microsoft SQL Server.
For further information about the database conguration please refer to the PowerFactory Installation
Manual.
5.2.5 Advanced Settings
The advanced program settings should only be changed under the guidance of the DIgSILENT Power-
Factory support (see Chapter 2 Contact)
5.2.6 Appearance Settings
The appearance settings inuence the way in which the toolbar buttons are displayed and the way in
which dialogues will open, close or move scroll bars and other objects.
These settings may be changed to suit the users personal taste.
5.3 Housekeeping
5.3.1 Introduction
Housekeeping automates administration of certain aspects of the database, in particular purging projects,
emptying user recycle bins and the deletion of old projects. Housekeeping is triggered by the execution
of a Windows Scheduled Task; this can be set up to run at night, thus improving performance during the
day by moving regular data processing to off-peak periods. An additional benet to housekeeping is that
users will need to spend less time purging projects and emptying recycle bins, something in particular
that can slow down the process of exiting PowerFactory .
Housekeeping is only available for multi-user databases (e.g. Oracle, SQL Server). For details about
how to schedule housekeeping, see the PowerFactory Installation Manual.
36 DIgSILENT PowerFactory 15, User Manual
5.3. HOUSEKEEPING
5.3.2 Conguring permanently logged-on users
Normally housekeeping will not process data belonging to logged-on users; however, some user ac-
counts (e.g. those for a control room) may be connected to PowerFactory permanently. These users
can be congured to allow housekeeping to process their data whilst logged-on. This is done from the
User Settings dialogue (see gure 5.3.1). Regardless of this setting, housekeeping will not operate on
a users active project.
Figure 5.3.1: The User Settings Dialogue: housekeeping for connected users
5.3.3 Conguring housekeeping tasks
The SetHousekeeping object is used to control which housekeeping tasks are enabled (see gure 5.3.2).
It is recommended that you move this object from Database\System\Conguration\Housekeeping to
Database\Conguration
\Housekeeping, in order to preserve your conguration through database upgrades.
The following sections discuss the different housekeeping tasks shown on the SetHousekeeping object.
DIgSILENT PowerFactory 15, User Manual 37
CHAPTER 5. PROGRAM ADMINISTRATION
Figure 5.3.2: The SetHousekeeping object
5.3.4 Conguring deletion of old projects
If Delete projects based on last activation is set on the SetHousekeeping object, then when house-
keeping executes, for each user, each project in turn will be considered for automatic deletion.
The project properties determine whether a project can be automatically deleted, as shown in g-
ure 5.3.3. The default setting is for project deletion to be off. When set on, the default retention pe-
riod is 60 days. These defaults can be changed for new projects by using a template project (under
Conguration/Default in the Data Manager tree).
Figure 5.3.3: Project properties
You can change the settings for many existing projects at once using the tabular pane of the Data
Manager window (select the relevant column, right-click and choose Modify Values). A value of 1 is
38 DIgSILENT PowerFactory 15, User Manual
5.3. HOUSEKEEPING
equivalent to the Housekeeping project deletion radio button being set to On. (see gure 5.3.4). You
can also change projects in bulk via the tabular window resulting from a Find operation, though note
that executing a Find is potentially a lengthy operation.
Figure 5.3.4: Setting parameters for many projects at once
A project will be deleted by the housekeeping task if it meets the following criteria:
1. The project is congured for automatic deletion on the Storage page of the project properties.
2. The last activation of the project is older than the retention setting on the project.
3. It is not a base project with existing derived projects
4. It is not a special project (user settings, or anything under System or Conguration trees)
5. The project is not locked (e.g. active).
6. The owner of the project is not connected, unless that user is congured to allow concurrent
housekeeping (see section 5.3.2).
5.3.5 Conguring purging of projects
If Purge projects is set on the SetHousekeeping object, then when housekeeping executes, each
project in turn will be considered for purging. A project that is already locked (e.g. an active project) is
not purged.
The criteria for housekeeping to purge a project are:
if the project has been activated since its last purge.
DIgSILENT PowerFactory 15, User Manual 39
CHAPTER 5. PROGRAM ADMINISTRATION
if it is now more than a day beyond the object retention period since last activation, and the project
hasnt been purged since then.
if the project is considered to have invalid metadata (e.g. is a pre 14.0 legacy project, or a PFD
import without undo information).
Once housekeeping is congured to purge projects you can consider disabling the automatic purging
of projects on activation, thus preventing the Yes/No dialogue popping up. To do this set Automatic
Purging to Off on the Storage page of the Project properties dialogue. You can also set this parameter
to Off for many projects at a time (see methods described in section 5.3.4).
5.3.6 Conguring emptying of recycle bins
If Delete recycle bin objects is set on the SetHousekeeping object, then when housekeeping executes,
each users recycle bin in turn will be examined. Entries older than the number of days specied on the
SetHousekeeping object (see gure 5.3.2) will be deleted.
5.3.7 Monitoring Housekeeping
Once deployed, how do you know that housekeeping is operating effectively? For example, it could be
failing every night with a connection error. An administrator should regularly check that housekeeping
is working. The primary check is to inspect the HOUSEKEEPING LOG table via SQL or the data
browsing tools of your multi-user database. For each run, housekeeping will insert a new row to this
table showing the start and end date/time and the completion status (success or failure). Other statistics
such as the number of deleted projects are kept. Note that absence of a row in this table for a given
scheduled day indicates that the task failed before it could connect to the database. In addition to the
HOUSEKEEPING LOG table, there is also a detailed log of a Housekeeping run in the log le of the
Housekeeper user.
5.3.8 Summary of Housekeeping Deployment
The basic steps to implement housekeeping are:
1. Set up the Windows Scheduled Task, as described in the PowerFactory Installation Manual..
2. Congure users expected to be active during housekeeping, as described in section 5.3.2.
3. Congure the SetHousekeeping object as described in section 5.3.3.
4. If using the project deletion task, congure automatic deletion properties for new projects, as
described in section 5.3.4.
5. If using the project deletion task, congure automatic deletion properties for existing projects, as
described in section 5.3.4.
6. Regularly monitor HOUSEKEEPING LOG table to check for success after housekeeping runs, as
described in 5.3.7.
40 DIgSILENT PowerFactory 15, User Manual
Chapter 6
User Accounts, User Groups, and
Proles
This chapter provides details of how to create and manage user accounts, user groups, and proles.
Key objectives of the user account managing system are to:
Protect the system parts of the database from changes by normal (non-Administrator) users.
Protect parts of the databases belonging to user A from changes by user B.
Facilitate sharing of user data.
The user account managing system provides each user with their own private database space. The
user is nevertheless able to use shared data, either from the common system database or from other
users, and may enable other users to use data from their private database.
The user account managing system manages this whilst using only one single database in the back-
ground, which allows for simple backup and management of the overall database.
6.1 PowerFactoryDatabase Overview
A brief introduction to the top level structure of the PowerFactory database is convenient before present-
ing the user accounts and their functionality.
The data in PowerFactory is stored inside a set of hierarchical directories. The top level structure is
constituted by the following folders:
The Conguration folder Contains company specic customizing for user groups, user default set-
tings, project templates and class templates for objects. Conguration folder is read only for
normal users.
The main Library folder Contains all standard types and models provided with PowerFactory. The
main library folder is read only for normal users.
The System folder Contains all objects that are used internally by PowerFactory. The system folder is
read only for all normal users. Changes are only permitted when logged on as the Administrator,
and should be conducted under the guidance of DIgSILENT customer support.
User account folders Contain user project folders and associated objects and settings.
DIgSILENT PowerFactory 15, User Manual 41
CHAPTER 6. USER ACCOUNTS, USER GROUPS, AND PROFILES
The structure described above is illustrated in Figure 6.1.1
Figure 6.1.1: Basic database structure
6.2 The Database Administrator
A database administrator account is created with the PowerFactory installation. The main functions of
the administrator are:
Creation and management of user accounts.
System database maintenance under the guidance of the DIgSILENT customer support.
Under a multiuser database environment, the administrator is the only user with permissions to:
Add and delete users.
Dene users groups.
Set individual user rights.
Restrict or allow calculation functions.
Set/reset user passwords.
Create and edit Proles (see Section 6.4 for details).
The administrator is also the only user that can modify the main library and the system folders. Although
the administrator has access to all the projects of all the users, it does not have the right to perform any
calculation.
To log on as administrator, write Administrator in the name eld of the Log on page from the Log-on
dialogue and write the corresponding password. By default the administrator password is Administrator.
For further information about the administrator roll, please refer to the PowerFactory Installation Man-
ual.
42 DIgSILENT PowerFactory 15, User Manual
6.3. CREATING AND MANAGING USER ACCOUNTS
6.3 Creating and Managing User Accounts
In the case of an installation with a local database, the simplest way to create a new user account is
to enter an unknown account name and select Create new user in the Log-on dialogue (see Chap-
ter 5: Program Administration, Section 5.2.1: Log On Conguration). In this case the program will
automatically create and activate the new account, without administrator intervention.
In multi-user database installations, the administrator creates new user accounts by means of a tool
called the User Manager, which is found in the Conguration folder.
To create a new user:
Log on as administrator.
In the left pane of the Data Manager click on Conguration folder to display its contents.
Double click on the User Manager icon ( , rigth pane) and press the Add User. . . button.
The User edit dialogue will be displayed:
In the General tab, enter the new user name and password.
If a licensed version with a restricted number of functions is used (i.e. you may have 4 licences
with basic functionality, but only 2 stability licences), the License tab may be used to dene the
functions that a user can access. The Multi User Database option (bottom of the tab) should be
checked for all users that will access the multi user database.
The administrator can edit any user account to change the user name, set new calculation rights or
change the password. To edit an existing user account:
Right-click on the desired user and select Edit from the context sensitive menu. The User edit
dialogue will be displayed.
Any user can edit her/his own account by means of the User edit dialogue. In this case only the full
name and the password can be changed.
Note: The administrator is the only one who may delete a user account. Although users can delete
all projects inside their account folder, they cannot delete the account folder itself or the standard
folders that belong to it (i.e. the Recycle Bin or the Settings folder).
6.4 Creating User Groups
Any project or folder in a user account may be shared. This action can be performed selectively by shar-
ing only with certain user groups. User groups are created by the administrator via the User Manager.
To create a new user group:
Log on as administrator.
In the Data Manager open the Conguration folder and double click on the User Manager icon( ).
In the User manager dialogue that appears press Add Group. . .
DIgSILENT PowerFactory 15, User Manual 43
CHAPTER 6. USER ACCOUNTS, USER GROUPS, AND PROFILES
Enter the name of the new group, optionally a description and press Ok.
The new group is automatically created in the User Groups directory of the Conguration folder.
The administrator can change the name of an existing group by means of the corresponding edit dia-
logue (right clicking on it and selecting Edit from the context sensitive menu). Via the context sensitive
menu, groups can also be deleted.
The administrator can add users to a group by:
Copying the user in the Data Manager (right click on the user and select Copy from the context
sensitive menu).
Selecting a user group in the left pane of the Data Manager.
Pasting a shortcut of the copied user inside the group (right-click the user group and select Paste
Shortcut from the context sensitive menu).
Users are taken out of a group by deleting their shortcut from the corresponding group.
The administrator can also set the Groups Available Proles on the Prole tab of the Group dialogue.
For information about sharing projects please refer to Chapter 18 (Data Management).
6.5 Creating Proles
Proles can be used to congure toolbars, menus, dialogue pages, and dialogue parameters. By de-
fault, PowerFactory includes Base Package and Standard proles, selectable from the main menu
under Tools Proles. Selecting the Base Package prole limits icons shown on the Main Toolbar to
those that are used with the Base Package of the software. The Standard prole includes all available
PowerFactory icons.
Proles are created in the Conguration Proles folder by selecting the New Object icon and then
Others SettingsProle. An Administrator can create and customize proles, and control User/User
Group selection of proles from the Prole tab of each group.
Figure 6.5.1 shows the Prole dialogue for a new prole, CustomProle, and Figure 6.5.2 illustrates
aspects of the GUI that may be customized using this prole. This section describes the customization
procedure.
Figure 6.5.1: Prole Dialogue
44 DIgSILENT PowerFactory 15, User Manual
6.5. CREATING PROFILES
Figure 6.5.2: GUI Customization using Proles
6.5.1 Tool Conguration
Denition of Icons
Icons can be dened in the Conguration Icons folder by selecting the New Object icon and then
Others Other ElementsIcon. From the Icon dialogue, icon images can be imported and exported.
Icons should be 19 pixels by 19 pixels in Bitmap format (recommended to be 24-bit format).
Command Conguration
Figure 6.5.3 shows the Tool Conguration Commands tab.
Figure 6.5.3: Commands Conguration.
Command: This is the selected DPL script (which should generally be located in the Conguration
DIgSILENT PowerFactory 15, User Manual 45
CHAPTER 6. USER ACCOUNTS, USER GROUPS, AND PROFILES
DPL commands folder), or selected Com* object.
Edit: If selected, the DPL command dialogue will appear when a Command is executed. If de-
selected, the DPL command dialogue will not appear when a Command is executed.
Icon: Previously created icons can be selected, which will be shown on the menu where the
command is placed. If no icon is selected, a default icon will appear (a Hammer, DPL symbol, or
default Com* icon, depending on the Class type).
Template Conguration:
Figure 6.5.4 shows the Tool Conguration Templates tab.
Figure 6.5.4: Template Conguration
Template The name of the template. The name may be for a unique template, or include wild-
cards (such as *.ElmLne) for selection of a group of templates. Templates should be in Sys-
tem/Library/Busbar Systems folder, or in the Templates folder of the active project.
Drawing modeThe drawing mode can be set where there are multiple diagrammatic representa-
tions for a template (such as for a substation). Three options are available:
Blank will place the default (detailed) graphic of the template.
Simplied will place the simplied graphic of the template.
Composite will place a composite representation of the template.
Symbol name Sets the representation of templates with a composite drawing mode (e.g. Gener-
alCompCirc or GeneralCompRect).
Icon Previously created icons can be selected, which will be shown on the menu where the tem-
plate is placed. If no icon is selected, a default icon will appear (a Template symbol or custom
icon).
Description This description will be displayed when a user hovers the mouse pointer over the
icon. If left blank, the template name will be displayed.
6.5.2 Conguration of Toolbars
The Main Toolbar and Drawing Toolbars can be customized using the Toolbar Conguration. The eld
Toolboxes may either refer to a Toolbox Conguration (SetTboxcong) or a Toolbox Group Conguration
(SetTboxgrcong), which may in-turn refer to one or more Toolbox Congurations.
46 DIgSILENT PowerFactory 15, User Manual
6.5. CREATING PROFILES
Figure 6.5.5 shows an example where there is a main toolbox, and a toolbox group. The toolbox group
adds a Change Toolbox icon to the menu, which allows selection of Basic Commands and Custom
Commands groups of commands.
Figure 6.5.5: Toolbar Conguration
Each toolbox can be customized to display the desired icons, such as illustrated in Figure 6.5.6
Figure 6.5.6: Toolbox Conguration
Prior to customizing the displayed buttons and menu items etc, the user should rst dene any required
custom Commands and Templates. A Tool Conguration object can be created in the Conguration
DIgSILENT PowerFactory 15, User Manual 47
CHAPTER 6. USER ACCOUNTS, USER GROUPS, AND PROFILES
Proles folder, or within a user-dened Prole, by selecting the New Object icon and then Others
SettingsTool Conguration. If created in the Proles folder, the commands will be available from the
Standard prole. Conversely, if the Tool Conguration object is created within a prole (SetProle) the
commands and templates will only be available for use in this prole. If there is a Tool Conguration
within a user-dened prole, as well as in the Proles folder, the Tool Conguration in the user-dened
prole will take precedence. Optionally, customized icons can be associated with the Commands and
Templates.
6.5.3 Conguration of Menus
The Main Menu, Data Manager, Graphic, Virtual Instruments, and Output Window menus can be cus-
tomized from the Menu Conguration dialogue. The Change to Conguration View button of the Prole
dialogue is used to display description identiers for congurable items, such as illustrated in the context-
sensitive menu shown in Figure 6.5.7. The Menu Conguration includes a list of entries to be removed
from the specied menu. Note that a Prole may include multiple menu congurations (e.g. one for
each type of menu to be customized).
Figure 6.5.7: Menu Conguration
6.5.4 Conguration of Dialogue Pages
The Dialogue Page Conguration may be used to specify the Available and Unavailable Dialogue pages
shown when editing elements, such as illustrated in Figure 6.5.8. Note that Users can further customize
the displayed dialogue pages from the Functions tab of their User Settings.
48 DIgSILENT PowerFactory 15, User Manual
6.5. CREATING PROFILES
Figure 6.5.8: Dialogue Page Conguration
6.5.5 Conguration of Dialogue Parameters
The Dialogue Conguration may be used to customize element dialogue pages, such as illustrated for
a Synchronous Machine element in Figure 6.5.9. Hidden Parameters are removed from the element
dialogue page, whereas Disabled Parameters are shown but cannot be modied by the user. A Prole
may include multiple dialogue congurations (e.g. one for each class to be customized).
Note that if a there is a Dialogue Conguration for say, Elm* (or similarly for ElmLne,ElmLod), as well
as a Dialogue Conguration for ElmLne (for example), the conguration settings will be merged.
Figure 6.5.9: Dialogue Conguration
Note: Conguration of Dialogue parameters is an advanced feature of PowerFactory , and the user
should be cautious not to hide or disable dependent parameters. Please seek assistance from
DIgSILENT support if required.
6.5.6 References
Proles can also contain references to congurations. This allows several proles to use the same
congurations. These referenced congurations can either be stored in another prole or in a subfolder
of the Proles folder (e.g. a user-dened prole can use congurations from a pre-dened prole).
DIgSILENT PowerFactory 15, User Manual 49
CHAPTER 6. USER ACCOUNTS, USER GROUPS, AND PROFILES
50 DIgSILENT PowerFactory 15, User Manual
Chapter 7
User Settings
The User Settings dialogue, shown in Figure 7.0.1, offers options for many global features of Power-
Factory. This chapter is dedicated to describe this options. The User settings dialogue may be opened
either by clicking the User Settings button ( ) on the main tool bar, or by selecting the Options User
Settings. . . menu item from the main menu.
Figure 7.0.1: User Settings dialogue
7.1 General Settings
The general settings include (Figure 7.0.1):
Conrm Delete Activity Pops up a conrmation dialogue whenever something is about to be deleted.
Open Graphics Automatically Causes the graphics windows to re-appear automatically when a project
is activated. When not checked, the graphics window must be opened manually.
Beep on user errors May be de-selected to suppress sounds.
DIgSILENT PowerFactory 15, User Manual 51
CHAPTER 7. USER SETTINGS
Use Multiple Data Manager When enabled, more than one data manager dialogue can be opened at
a time. When disabled only one data manager may be opened at a time and pressing the New
Data Manager button will pop up the minimized data manager.
Use operating system Format for Date and Time The operating system date and time settings are
used when this is checked.
Use Default Graphic Converter.
Edit Filter before Execute Presents the lter edit dialogue when a lter is selected, allowing the user
to edit the lter before application. However, this is sometimes irksome when a user is applying a
lter several times. Thus one may choose to go straight to the list of ltered objects when the lter
is applied by un-checking this option.
Always conrm Deletion of Grid Data When this option checked a conrmation dialogue is popped
up when the user deletes grid data.
Decimal Symbol Selects the symbol selected to be used for the decimal point.
Use Standard Database Structure In order to simplify the operation of PowerFactory for users who
do not use the program often, or who are just starting out certain restrictions may be introduced
into the database structure, for example, allowing only Type data to be placed in Library folders
(when this option is un-checked). However, this may be irksome for advanced users or those who
are used to the standard database working where a great deal of exibility is permitted, so as to
suit the users needs, and thus the standard structure may be engaged by checking this option.
System Stage Prole The ability to create system stages may be limited by this option. Existing sys-
tem stages will still be visible but the right menu options that create new revisions or system stages
will be removed. This is once again a tool that may be used to simplify PowerFactory for users
not familiar with the program by limiting the operations that they may use.
Retention of results after network change when the option Show last results is selected, modica-
tions to network data or switch status etc. will retained the results, these will be shown on the
single line diagram and on exible data pages in grey until the user reset the results (e.g. by
selecting Reset Calculation, or conducting a new calculation).
7.2 Graphic Windows Settings
The graphic windows has the following settings.
Cursor settings
Denes the cursor shape:
Arrow A normal, arrow shaped cursor.
Tracking cross A small cross.
General Options
Valid for all graphs:
Show Grid only if stepsize will be least Grid points smaller than the selected size will not be
shown.
Show Text only if height will be least Text smaller than the selected size will not be shown.
No. of Columns in Drawing Tools Floater Species the width of the graphics toolbar when this
is a oating window.
52 DIgSILENT PowerFactory 15, User Manual
7.3. DATA MANAGER SETTINGS
No. of Columns in Drawing Tools Docker Species the width of the graphics toolbar when it is
docked on the right side of the drawing space.
Line factor when printing The width of all lines in the graphics will be multiplied by the specied
percentage when printing.
Update Hidden pages always
Results in all graphical pages on a graphics board being updated, even when they are not visible. Note
that this can slow the processing speed considerably. The advantage is that no updating is required
when a different graphics page is selected.
Exclude Feeder Colours
May be used to exclude colours, by number code, which are to be used for feeder denitions. This
is used to prevent the use of colours which are already used for other purposes. Ranges of colour
numbers are entered as 2-9. Multiple ranges of colours must separated by commas, as in 2-9;16-23.
Update Graphic while Simulation is running
Use own background colour for single line graphics
If the option is enabled, the user can dene the background colour of the single line graphics by using
the pop up menu and then pressing OK.
In the Advanced tab of the Graphic Window page more graphic setting options are available:
Allow Resizing of branch objects
If the option is enabled, the user can left click a branch element within the single line graphic and then
resize it.
Edit Mode Cursor Set
Allows the selection of the mouse pointer shape.
Mark Objects in Region
Denes how objects within an user dened region of the single line graphic (dened by left clicking and
then drawing a rectangle) are selected:
Complete Only the objects, that are completely enclosed in the dened region, are selected.
Partial All the objects within the dened area are selected.
Show balloon Help
Enables or disables the balloon help dialogues.
For information about the Graphic Windowrefer to Chapter 9(Network Graphics (Single Line Diagrams)).
7.3 Data Manager Settings
The data manager page species which object types will be displayed or hidden in the tree representa-
tion, and whether conrmation prompts will appear when objects or data is changed in the data manager
itself.
DIgSILENT PowerFactory 15, User Manual 53
CHAPTER 7. USER SETTINGS
Show in Treelist
Object classes that are selected will be displayed in the database tree.
Browser
Save data automatically The data manager will not ask for conrmation every time a value is
changed in the data browser when this option is selected.
Sort Automatically Species that objects are automatically sorted (by name) in the data browser.
Operation Scenario
If the Save active Operation Scenario automatically is enabled, the period for automatic saving must be
dened.
Export/Import Data
Congures the export and import of PowerFactory DZ-les, as follows:
Binary DataSaves binary data, such as results in the result folders, to the DZ export les accord-
ing to selection.
Export References to Deleted Objects Will also export references to objects which reside in the
recycle bin. Normally, connections to these objects are deleted on export.
Enable export of activated projects Will permit the export of an activated project.
Folders for Global Library
The default global type folder is the System/Library/Types folder. This default folder contains many
predened object types, but objects within this folder may not be changed by the user (read-only ac-
cess). This option allows the user to specify a different Global Type Folder, possibly a company
specic and dened type library.
For information about the PowerFactory Database Manager refer to Chapter 10 (Data Manager).
7.4 Output Window Settings
The output window settings control the way in which messages selected by the user, in the output
window are to be copied for pasting into other programs.
Whichever options are checked will determine what will be copied. The text in the output window itself
will not be inuenced.
Escape sequences are special hidden codes which are used for colouring the text, or other formatting
commands. Some text processing programs are not capable of using the PowerFactory escape codes.
The Text Only option should be set in such cases. The text in the output window itself will not be
inuenced by the options chosen here.
The number of lines displayed in the output window may also be limited.
7.5 Functions Settings
The functions settings page provides check boxes for the function modules that are accessible from the
data manager or from the object edit dialogues. The user may choose to see only certain modules in
54 DIgSILENT PowerFactory 15, User Manual
7.6. DIRECTORIES
order to unclutter dialogues.
This may also be used to protect data by allowing only certain calculation functionality to be seen by
certain users. This is particularly useful in a multi-user environment or in when inexperienced users
utilize PowerFactory .
7.6 Directories
Compiled DSL Models Pre-compiled DSL models may be available for use as external models.
The DSL directory should be directed to the correct folder/ directory in order for PowerFactory to
nd these models.
PFM-DSM
7.7 Editor
The editor which is used to enter large pieces of text (such as DPL scripts, objects descriptions, etc.)
can be congured on this page.
Options
Enable Virtual Space Allows the cursor to move into empty areas.
Enable Auto Indent Automatically indents the next line.
Enable Backspace at Start of Line Will not stop the backspace at the left-most position, but will
continue at the end of the previous line.
View blanks and tabs Shows these spaces.
Show Selection Margin Provides a column on the left side where bookmarks and other markings
are shown.
Show line Numbers Shows line numbers.
Tab Size Denes the width of a single tab.
Tabs
Toggles between the use of standard tabs, or to insert spaces when the tab-key is used.
Language colouring
Denes the syntax-highlighting used when the type of text is not known.
ShortCuts
Opens the short-cut denition dialogue.
7.8 StationWare
When working with DIgSILENT s StationWare, connection options are stored in the user settings.The
connection options are as follows:
DIgSILENT PowerFactory 15, User Manual 55
CHAPTER 7. USER SETTINGS
Service Endpoint Denotes the StationWareserver name. This name resembles a web page URL and
must have the form:
http://the.server.name/psmsws/psmsws.asmx or
http://192.168.1.53/psmsws/psmsws.asmx
http denotes the protocol, the.server.name is the computer name (or DNS) of the server computer
and psmsws/psmsws.asmx is the name of the StationWareapplication.
Username/Password
Username and Password have to be valid user account in StationWare. A StationWareuser account
has nothing to do with the StationFactory user account. The very same StationWareaccount can be
used by two different PowerFactory users.The privileges of the StationWareaccount actually restrict the
functionality. For device import the user requires read-access rights. For exporting additionally write-
access rights are required.
7.9 Advanced Options
Contingency Analysis
A conrmation dialogue is showed when the Remove Contingencies option is selected in the Contin-
gency Analysis dialogue.
56 DIgSILENT PowerFactory 15, User Manual
Part III
Handling
Chapter 8
Basic Project Denition
The basic database structure in PowerFactory and the data model used to dene and study a power
system is explained in Chapter 4 (PowerFactory Overview). It is recommended that users become
familiar with this chapter before commencing project denition and analysis in PowerFactory . This
Chapter describes how to dene and congure projects, and how to create grids.
8.1 Dening and Conguring a Project
There are three methods to create a new project. Two of them employ the Data Manager window and
the third the main menu. Whichever method is used, the end result will be the same, a project object in
the data base.
Method 1 - Using the Main Menu:
On the Main Menu choose File NewProject.
Enter the name of the project. Make sure that the Target Folder points to the folder in which you
want to create the project (By default it is set to the active user account folder).
Press Execute.
Method 2 - Using the Element Selection Dialogue from the Data Manager:
In the Data Manager press on the New Object button ( )
In the eld at the bottom of the New Object window type IntPrj (after selecting the option Others
in the Elements eld). Note that the names in PowerFactory are case-sensitive.
Press Ok. The window that opens next is the edit dialogue of the project folder. Press Ok.
Method 3 - Direct from the Data Manager:
Locate the active user in the left-hand portion of the Data Manager.
Place the cursor on the icon of the active user or a folder within the active user account and
right-click.
From the context sensitive menu choose New Project. Press Ok. The window that opens next
is the edit dialogue of the project folder. Press Ok.
DIgSILENT PowerFactory 15, User Manual 59
CHAPTER 8. BASIC PROJECT DEFINITION
Note: The ComNew command is used to create objects of several classes. To create a new project it
must be ensured that the Project option is selected.
In order to dene and analyze a power system, a project must contain at least one grid and one study
case. After the new project is created (by any of the presented methods), a new study case is auto-
matically created and activated. A dialogue used to specify the name and nominal frequency of a new
automatically created grid pops up. As the button OK is pressed in the grid edit dialogue:
The new grid folder is created in the newly created project folder.
An empty single line diagram associated to the grid is opened.
The newly created project has the default folder structure shown in 8.1.1. Although a grid folder and a
study case are enough to dene a system and perform calculations, the new project may be expanded
by creating library folders, extra grids, variations, operation scenarios, operational data objects, extra
study cases, graphic windows, etc.
Projects can be deleted by right clicking on the project name on the data manager and selecting Delete
from the context sensitive menu. Only non active projects can be deleted.
Note: The default structure of the Project folder is arranged to take advantage of the data model struc-
ture and thus the user is advised to keep to this pre-determined data structure, at least at rst until
sufcient experience in using PowerFactory is gained. As may be inferred, the user is not limited
to the pre-determined structure and may create, within certain limits, their own project structure
for advanced or particular studies.
Figure 8.1.1: Default Project Structure
60 DIgSILENT PowerFactory 15, User Manual
8.1. DEFINING AND CONFIGURING A PROJECT
8.1.1 The Project Edit Dialogue
The project dialogue of 8.1.2 pops up when selecting Edit Project. . . on the main menu or when
right-clicking the project folder in the Data Manager and selecting Edit from the context sensitive menu.
The Basic Data page, allows the edition of basic project settings and the creation of new study cases
and grids:
Pressing the button at the Project Settings eld opens a dialogue where the validity period of
the project, the input units to be used within the project (unit system and the decimal prexes for
the adaptable element input dialogues within the project) and the calculation settings (the base
apparent power and the minimal value of the resistances and conductances in p.u) are dened.
Pressing the New Grid button will create a new grid and will open the grid edit dialogue. A second
dialogue will ask for the study case to which the new grid folder will be added. For additional
information about creating a new grid please refer to Section 8.2(Creating New Grids).
The New Study Case button will create a new study case and will open its dialogue. The new
study case will not be activated automatically. For further information about creating study cases
please refer to Chapter 11: Study Cases, Section 11.2 (Creating and Using Study Cases).
When a project is created, its settings (i.e.the result box denitions, the reports denitions, the
exible page selectors, etc.) are dened by the default settings from the system library. If
these settings are changed, the changes are stored in the Settings folder of the project. The
settings from another project or the original (default) ones can be taken by using the buttons
Take from existing Project or Set to default in the Changed Settings eld of the edit dialogue.
The settings can only be changed when a project is inactive.
The name of the active study case is shown in the lower part of the dialogue window under the
Active Study Case assignment, its edit dialogue can be opened by pressing the button.
DIgSILENT PowerFactory 15, User Manual 61
CHAPTER 8. BASIC PROJECT DEFINITION
Figure 8.1.2: The project dialogue
Pressing the Contents button on the dialogue will open a new data browser displaying all the
folders included in the current project directory.
The Sharing page of the dialogue allows the denition of the project sharing rules. This function is
especially suitable when working in a multiple user database environment, further information is given
in Chapter 18 (Data Management).
The Derived Project page provides information when the project is a derived project of a master project.
The Storage page provides information about the stored data inside the project.
The Description page, like all objects description pages is used to add user comments and the approval
status.
8.1.2 The Project Overview Window
The Project Overview window is illustrated in gure 8.1.3. It is a dockable window, displayed by default
on the left side of the main application window between the main toolbar and the output window. It
displays an overview of the project allowing the user to assess the state of the project at a glance and
facilitating easy interaction with the project data. The window is docked by default, but can be undocked
by the user and displayed as a oating window that can be placed both inside and outside of the main
application window. If required, the window can be closed by the user. To close or reopen the window
the user should deselect or select the option Window Dock Output Window. . . from the main menu.
Only one window can be open at a time.
62 DIgSILENT PowerFactory 15, User Manual
8.1. DEFINING AND CONFIGURING A PROJECT
Figure 8.1.3: The project Overview Window
The following objects and information can be accessed via the project window.
Study Cases
Active Study Case
Inactive Study Cases
Current Study Time
Operation Scenarios
Active Scenario Schedulers
Active Scenarios
Inactive Scenarios
Variations
Recording Expansion Stage
List of active Variations with active Expansion Stages as children
List of inactive Variations with inactive Expansion Stages as children
Grid/System Stages
List of active Grids or System Stages
List of active Grids or System Stages
Trigger
Active triggers
Entries for active objects are displayed with bold text, entries for inactive objects (where currently no
object is active, but inactive objects exist) are displayed as disabled/grey.
A context sensitive menu can be accessed by right clicking on each of the tree entries. The following
actions are available for each of the entries:
DIgSILENT PowerFactory 15, User Manual 63
CHAPTER 8. BASIC PROJECT DEFINITION
Change active item(s): Activate, Deactivate, Change active
Show all available items
Edit (open dialogue)
Edit and Browse
Delete
Save (for Operation Scenario only)
8.1.3 Project Settings
In the Project Settings you can set up the Validity Period of the Project, the method used for Calculation
of symmetrical components for untransposed lines, and other settings.
The Validity Period of the Project
PowerFactory 15 extends the idea of a model into the dimension of time. The Project may span a period
of months or even years considering network expansions, planned outages and other system events.
The period of validity of a project species therefore the time span the network model, which is dened
in the Project, is valid for.
The Validity Period is dened by Start Time and End Time of the Project (see Figure 8.1.2). The Study
Case has got a Study Time, which has to be inside the Validity Period of the Project.
To specify the Validity Period of the Project:
Open the Data Manager and browse for the Project folder object (IntPrj ).
Right click on it and select Edit from the context sensitive menu.
On the Basic Data tab press the Project Settings Edit button ( ). The Project Settings dialogue
will open.
On the Validity Period page adjust the start and end time of the project.
Press OK to accept the changes and close the window.
Advanced Calculation Parameters
Auto slack assignment
This option has only an inuence of the automatic slack assignment (e.g. if no machine is marked
as Reference Machine)
Method 1: all the synchronous machines can be selected as Slack (Reference Machine);
Method 2: a synchronous machine is not automatically selected as Slack if for that machine
the option on load ow page: Spinning if circuit-breaker is open is disabled.
Calculation of symmetrical components for untransposed lines
The selection of one of these methods denes how the sequence components of lines in Power-
Factory will be calculated:
Method 1: apply the 012 transformation (irrespective of line transposition). This is the stan-
dard method used;
Method 2: rst calculate a symmetrical transposition for untransposed lines, and then apply
the 012 transformation.
64 DIgSILENT PowerFactory 15, User Manual
8.2. CREATING NEW GRIDS
8.1.4 Activating and Deactivating Projects
To activate a project use the option File Activate Project from the main menu. This brings up a tree
with all the projects in your user account. Select the project that you want to activate. Alternatively, you
may activate a project using the context sensitive menu on the Data Manager.
The last 5 active projects are listed at the File eld of the main menu bar. The currently active project
is the rst one in this list. To deactivate the currently active project, select it in the list (left click on it).
Alternatively, you may choose the option File Deactivate Project from the main menu. To activate
another project, select it in the list of 5 last active projects.
Note: Only one project can be activated at a time.
8.1.5 Exporting and Importing of Projects
Projects (or any folder in the data base) can be exported using the *.dz or the *.pfd (PowerFactory
Data) le format. Whenever possible it is recommended to use the new PFD format (*.pfd). This format
(*.pfd) is improved for handling even very large projects. The performance of the import/export has been
optimized and the consumption of memory resources is much lower than with the old le format (*.dz).
All new functions available in the data base of PowerFactory , e.g. time stamps and versions, are fully
supported with the new PFD le format.
To export a project select File Export. . . Data. . . from the main menu or by clicking on the icon
of the Data Manager. Alternatively projects can be exported by selecting the option Export. . . on the
project context sensitive menu (only available for non active projects).
Projects can be imported by selecting File Import. . . Data. . . from the main menu or by clicking on
the icon of the Data Manager. The user can select the type of le to import from the Files of type
menu of the Windows Open le that pops up. Alternatively projects can be imported by selecting the
option Import. . . on the project context sensitive menu (only available for non active projects).
Additionally a lot of Import/Export lters are available for foreign data formats.
8.1.6 External References
In order to avoid problems when exporting/importing projects, it is recommended to check for external
references before exporting the project. This can be done by selecting the option Check for external
References on the project context sensitive menu.
If external references are found, these can be packed before exporting by selecting the option Pack
external References on the project context sensitive menu.
The user can dene the source of the External References (i.e. Global Library, Conguration folder,
etc). A new folder call External containing all the external references will be created inside the Project.
8.2 Creating New Grids
Electrical networks can be dened in PowerFactory using the Graphical Editor or the Data Manager.
The graphical method is the simplest one, it just consist in selecting the desired network components
from the drawing toolbox and place them in the desired location within the single line graphic. In this
case the program automatically creates the network components represented by the graphical objects
in the active grids/expansion stages. The connections and the corresponding cubicles are automatically
created as the new component is placed (and connected). The use of the data manager requires the
DIgSILENT PowerFactory 15, User Manual 65
CHAPTER 8. BASIC PROJECT DEFINITION
manual denition of the cubicles within the terminals and the selection of the specic cubicle where
a branch element is to be connected. This manual denition is more suitable for big networks whose
graphical representation becomes complicated. Advanced users may combine both graphical and data
manager methods to dene and modify their network models more efciently.
Besides explaining the basic methods used to dene and edit the network models, this section is in-
tended to explain practical aspects related with the creation and managing of the network grouping
objects (reference to grouping objects). The procedures used to create and manage additional network
diagrams are also presented here. Information about dening and working with variations and variations
stages will be given in a separate section. To start with the description of the network model denition,
a description of how new grid folders are created is required.
Note: Experienced users may dene networks combining the Data Manager and the Graphical Editor.
A good practice is to create and connect the network components in the single line graphic and
multi edit them in the Data Manager.
To add a grid folder to the current network model, various methods may be employed:
1. Select Edit Project on the main menu. This will open the dialogue of the project that is currently
active. Press the New Grid button.
2. Select Insert Grid . . . on the main menu.
3. Right-click the project folder in a data manager and select Edit. Press the New Grid button.
4. Right-click the Network Data folder (of the active project) in a data manager window and select
New Grid from the context sensitive menu.
The dialogue to create a new grid will pop up after the indicated actions are performed. There the grid
name, the nominal frequency and a grid owner (optional) may be specied. A second dialogue will
appear after the Ok button has been pressed, here the study case that the grid will be linked to must be
selected. Three options are presented:
1. add this Grid/System Stage to active Study Case: Only available when a study case is active.
2. activate a new Study Case and add this Grid/System Stage: Creates and activates a newstudy
case for the new grid.
3. activate an existing Study Case and add this Grid/System Stage: Add the new grid folder to
an existing, but not yet active study case.
After the Ok button of the second dialogue is pressed, the new grid is created in the Network Model
folder and a reference in the Summary Grid object of the selected study case is created. Normally,
the second option is preferred because this creates a new study case, dedicated to the new grid only.
In that way, the new grid may be tested separately by load-ow or other calculations. To analyze the
combination of two or more grids, new study cases may be created later on, or the existing ones may
be altered.
As indicated in Chapter 11(Study Cases), grids can be added or removed from the active study case
afterwards by right clicking and selecting Add/Remove from Active study case.
66 DIgSILENT PowerFactory 15, User Manual
Chapter 9
Network Graphics (Single Line
Diagrams)
9.1 Introduction
PowerFactory works with three different classes of graphics which constitute the main tools used to
design new power systems, controller block diagrams and displays of results:
Single Line Diagrams (described in this chapter)
Block Diagrams (described in Section 25.8: Models for Stability Analysis)
Virtual Instruments (described in Section 17.5: Virtual Instruments)
Diagrams are organized in Graphic Boards for visualization (see Section 9.4.2 for more information).
9.2 Dening Network Models with the Graphical Editor
In this section it is explained how the tools of the Graphical Editor are used to dene and work with
network models.
9.2.1 Adding New Power System Elements
Drawing power system elements is a simple matter of choosing the required element representation in
the Drawing Toolbox located in the right hand pane of the PowerFactory GUI. Input parameters of the
element are edited through the element and type dialogues. Complete information about the element
and type parameters are given in the Appendix C Technical References of Models.
To create a new power system element, select the corresponding button in the Drawing Toolbox. This
toolbar is only visible to the user when a project and study case is active and the open graphic is
unfrozen by deselecting the Freeze Mode button ( ). As the cursor is positioned over the drawing
surface, it will have a symbol of the selected tool attached to it, showing that the cursor is, for example,
in Terminal drawing mode (to reset the mode either press the one of the cursor icons (rectangular or
free-form selection) or press ESC or right-click with the mouse).
Power system elements are placed and connected in the single line graphic by left clicking on empty
places on the drawing surface (places a symbol), and by left clicking nodes (makes a connection). If
DIgSILENT PowerFactory 15, User Manual 67
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
wishing to stop the drawing and connecting process press the Escape key or right click at the mouse.
There are basically three ways of positioning and connecting new power system elements:
1. By left clicking on one or more nodes to connect and position the element directly. Single port
elements (loads, machines) will be positioned directly beneath the nodes at a default distance
(the symbol can later be moved if required). Double or triple port objects (transformers) will be
centred between the rst two terminal connections automatically.
2. By rst left clicking on an empty place to position the symbol and then left clicking a node to make
the connections.
3. By rst left clicking on an empty place, consequently clicking on the drawing surface to dene a
non-straight connection line and nally clicking on a terminal to make the connection.
Note: Nodes for connecting branches are usually dened before placing them on the single line dia-
gram. However, it is possible to place connection free branch element on the single line diagram
by pressing the Tab key once for each required connection (e.g. twice for a line, three times for a
three winding transformer)
Figure 9.2.1 shows an example of a generator placed according to the rst method (left generator),
one placed according to the second method (middle generator), and one placed according to the third
method (right generator with long connection).
Figure 9.2.1: Illustration of graphical connection methods
If a load or machine is connected to a terminal using the rst method (single left click on busbar), but a
cubicle already exists at that position on the busbar, the load or machine symbol will be automatically
positioned on the other side of the terminal, if possible.
Note: By default all power system elements are positioned bottom down. However, if the Ctrl key
is pressed when the graphic symbol is positioned onto the drawing surface, it will be positioned
either turned 90 degrees (terminals) or 180 degrees (edge elements). If the element has already
been placed and the user wishes to ip it to the other side of the terminal, it can be done by
selecting the element and the right-click Flip At Busbar.
Once drawn, an element can be rotated by right-click and selecting from the Rotate commands. Fig-
ure 9.2.2 shows an example of rotated and ipped power system elements.
68 DIgSILENT PowerFactory 15, User Manual
9.2. DEFINING NETWORK MODELS WITH THE GRAPHICAL EDITOR
Figure 9.2.2: Flipped and rotated power system elements
The connection between edge elements and terminals is carried out by means of cubicles. When work-
ing with the graphical editor, the cubicles are automatically generated in the corresponding terminal.
Note: When connections to terminals are dened with switch elements of the class ElmCoup (circuit
breakers), cubicles without any additional switches (StaSwitch) are generated.
9.2.2 Drawing Nodes
When commencing a single line diagram, it is common to rst place the required nodes / terminals
(ElmTerm) on the graphic. There are several symbol representations available for busbar type terminals,
from the drawing toolbox on the right-hand pane of the PowerFactory GUI.
Busbar This is the most common representation of a node.
Busbar (Short) Looks the same as a Busbar but is shorter and the results box and name is
placed on the Invisible Objects layer by default. Typically used to save space or to unclutter the
graphic.
Junction / Internal Node Typically used to represent a junction point, say between an overhead
line and cable. The results box and name is placed on the Invisible Objects layer by default.
Busbar (rectangular) Typically used for reticulation and / or distribution networks.
Busbar (circular) Typically used for reticulation and / or distribution networks.
Busbar (polygonal) Typically used for reticulation and / or distribution networks.
Busbars (terminals) should be placed in position and then, once the cursor is reset, dragged, rotated
and sized as required. Re-positioning is performed by rst left clicking on the terminal to mark it, and
then click once more so that the cursor changes to . Hold the mouse button down and drag the
terminal to a new position. Re-sizing is performed by rst left clicking on the terminal to mark it. Sizing
handles appear at the ends.
9.2.3 Drawing Branch Elements
Single port elements (loads, machines, etc.) can be positioned in two ways. The simplest method is
to select the symbol from the toolbar and then left click the busbar where the element is to be placed.
This will draw the element at a default distance under the busbar. In case of multi busbar systems, only
DIgSILENT PowerFactory 15, User Manual 69
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
one of the busbars need be left-clicked. The switch-over connections to the other busbars will be drawn
automatically.
The free-hand method rst places the element symbol wherever desired, that is, rst click wherever
you wish to place the symbol. The cursor now has a rubber band connected to the element (i.e. a
dashed line), left-clicking on another node will connect it to that node. To create corners in the joining
line left click on the graphic. The line will snap to grid, be drawn orthogonally, as determined by the
Graphic Options that have been set.
Double port elements (lines, transformers, etc.) are positioned in a similar manner to single port sym-
bols. By left-clicking the rst busbar, the rst connection is made. The second connection line is now
held by the cursor. Again, left-clicking the drawing area will create corners. Double-clicking the drawing
area will position the symbol (if not a line or cable - e.g. a transformer). The second connection is made
when a node is left clicked.
Triple port elements (e.g. three-winding transformers) are positioned in the same manner as two port
symbols. Clicking the rst, and directly thereafter the second node, will place the symbol centred be-
tween the two nodes, which may be inconvenient. Better positioning will result from left clicking the rst
busbar, double-clicking the drawing space to position the element, and then making the second and
third connection.
The free-hand method for two and triple port elements works the same as for one port elements.
Note: Pressing the Tab key after connecting one side will leave the second leg unconnected, or jump
to the third leg in the case of three port elements (press Tab again to leave the third leg un-
connected). Pressing Esc or right-click will stop the drawing and remove all connections. If the
element being drawn seems as if it will be positioned incorrectly or untidily there is no need to
escape the drawing process, make the required connections and then right-click the element and
Redraw the element whilst retaining the data connectivity.
Annotations are created by clicking one of the annotation drawing tools. Tools are available for drawing
lines, squares, circles, pies, polygons, etc. To draw these symbols left click at on an empty space on
the single line diagram and release the mouse at another location (e.g. circles, lines, rectangles). Other
symbols require that you rst set the vertices by clicking at different positions and nishing the input
mode by double-clicking at the last position.
For further information on dening lines, see section 9.3 (Dening and Working with Lines and Cables).
9.2.4 Marking and Editing Power System Elements
To mark (select) a power system element click on it with the cursor. The element is then highlighted and
becomes the focus of the next action or command. The element can be un-marked or de-selected by
clicking on another element or by clicking onto some free space in the graphic.
70 DIgSILENT PowerFactory 15, User Manual
9.2. DEFINING NETWORK MODELS WITH THE GRAPHICAL EDITOR
(a) Freeze Mode (b) Unfreeze Mode
Figure 9.2.3: Marking/ Selecting elements
The element is highlighted with a different pattern depending on whether the graphic has been frozen
or not, as seen in Figure 9.2.3, where 9.2.3a is the when the Freeze Mode is selected and 9.2.3b when
Freeze Mode is deselected.
There are different ways to mark several objects at once:
To mark all graphical elements, press the All button ( ). The keyboard short cut Ctrl+A may also
be used.
To mark a set of elements at the same time click on a free spot in the drawing area, hold down
the mouse key and move the cursor to another place where you release the mouse button. All
elements in the so dened rectangle will now be marked. A setting, found in the User Settings
dialogue under the Graphic Windows page, on the Advanced tab, can alter the manner in which
objects are marked using this marking method, as either Partial or Complete. Complete means
that the whole object marked must lie inside the rectangle.
To mark more than one object, hold down the Ctrl key whilst marking the object.
When clicking on an element and clicking on this element a second time whilst holding down the
Alt key will also mark all the elements connected to the rst element.
In PowerFactory it is possible to place a terminal on an existing line in the single line diagram by
placing the terminal on the line itself. Moving the terminal to a different location on the single line
diagram may move line sections in an undesirable manner. By holding the CtrL+Alt keys whilst
moving the terminal, the line sections will not be moved. However, note that this does not change
the actual location of the terminal along the line.
The data of any element (its edit dialogue) may be viewed and edited by either double-clicking the
graphic symbol under consideration, or by right-clicking it and selecting Edit Data.
When multiple objects are selected, their data can be viewed and edited trough a data browser by
right-clicking the selection and choosing Edit Data from the context sensitive menu.
Note: Finding specic elements in a large project may be difcult if one had to look through the single
line diagram alone. PowerFactory includes the Mark in Graphic tool, to assist the user in nding
elements within the graphic. The user has to rst search for the desired object in the Data Man-
ager using any of the methods presented in Chapter 10 (Data Manager). Once a searched object
is identied, it may be right-clicked and the option Mark in Graphic selected.
DIgSILENT PowerFactory 15, User Manual 71
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
9.2.5 Interconnecting Power Subsystems
Interconnections between two different graphics can be achieved using two methods:
1. Representing a node in additional different graphics by copying and pasting the graphic only and
then by connecting branch and edge elements to the graphical object in the additional graphic.
This is performed by copying the desired node (right-click Copy) and then clicking on the other
graphic in which it should be represented and right-click Paste Graphic Only. Only a graphical
object is pasted into the second graphic and no new data element is created.
2. Ensure that there is a node to connect to in the graphics that are to be interconnected. Then
connect an edge element between the two graphics.
Example
In this example a line will be used to interconnect two regions according to the second method.
1. Select a line drawing tool from the toolbar and create the rst connection as normal by left clicking
a node (see Figure 9.2.4).
2. Double-click to place the symbol. Your cursor is now attached to the line by a rubber band.
Move the cursor to the bottom of the drawing page and click on the tab of the graphic that the
interconnection is to be made to (see Figure 9.2.5).
3. Once in the second graphic left click to place the line symbol (see Figure 9.2.6) and then left click
on the second node.
The interconnected leg is shown by an symbol. Right-clicking on the element presents a Jump to
next page option.
Figure 9.2.4: First step to interconnecting
72 DIgSILENT PowerFactory 15, User Manual
9.2. DEFINING NETWORK MODELS WITH THE GRAPHICAL EDITOR
Figure 9.2.5: Second step to interconnecting
Figure 9.2.6: Third step to interconnecting
Note: The rst method of interconnection, that of representing a node in two, or more, different graph-
ics, may lead to confusion at a later point as the inow and outow to the node will not appear
correct when just one graphic is viewed - especially if a user is not familiar with the system. The
node may be right-clicked to show all connections in what is known as the Station Graphic (menu
option Show station graphic). Thus, the second method may be preferred. To check for nodes that
have connections on other graphics the Missing graphical connections diagram colouring may
be employed.
9.2.6 Working with Substations in the Graphical Editor
Substations and Secondary Substations from existing templates are created using the network dia-
grams. The substations are represented in these diagrams by means of composite node symbols.
Creating a New Substation in an Overview Diagram
Overview diagrams are single line diagrams without detailed graphical information of the substations.
Substations and Secondary Substations are illustrated as Composite Nodes, which can be coloured
DIgSILENT PowerFactory 15, User Manual 73
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
to show the connectivity of the connected elements (Beach Ball). Substations and Secondary Sub-
stations from pre-dened templates (or templates previously dened by the user) are created using the
network diagrams. The substations are represented in these diagrams by means of composite node
symbols.
To draw a substation from an existing template in an overview diagram:
Click on the symbol of the composite node ( or ) for Substations or ( ) for Secondary
Substations listed among the symbols on the right-hand drawing pane.
Select the desired substation template from the list.
Click on the overview single line diagram to place the symbol. The substation is automatically
created in the active grid folder.
Right click the substation, select Edit Substation, and rename the substation appropriately.
Close the window with the templates.
Press Esc or right click on the mouse to get the cursor back.
Resize the substation symbol in the overview diagram to the desired size.
A diagram of the newly created substation can be opened by double clicking at the composite node
symbol. In the new diagram it is possible to rearrange the substation conguration and to connect the
desired components to the grid.
To resize a composite node:
Click once on the composite node you want to resize.
When it is highlighted, place the cursor on one of the black squares at the corners and hold down
the left mouse button.
A double-arrow symbol appears and you can resize the gure by moving the mouse. For a rect-
angular composite node you can also resize the shape by placing the cursor on one of the sides.
For further information on templates please refer to Chapter 12: Project Library, Section 12.4 (Templates
Library).
To show the connectivity inside a composite node:
Press the button to open the colouring dialog. Select the Function for which the colouring mode
is relevant (for example, select the Basic Data tabpage). Under Other select Topology, and then
Station Connectivity.
There are two ways to open the graphic page of a substation. The rst is to double-click on the cor-
responding composite node in the overview diagram. The second is to go to the graphic object of the
substation in the data manager, right-click and select Show Graphic.
Details of how to dene templates are provided in Chapter 12 (Project Library).
Substation Switching Rules
Switching Rules ( ) (IntSwitching) store switching actions for a selected group of switches that are
dened inside a substation. The different switching actions (no change, open or close) are dened by
the user considering different fault locations that can occur inside a substation. By default, the number
of fault locations depends on the number of busbars and bay-ends contained inside the substation;
although the user is allowed to add (and remove) specic fault locations and switches belonging to the
substation. The switch actions will always be relative to the current switch positions of the breakers.
74 DIgSILENT PowerFactory 15, User Manual
9.2. DEFINING NETWORK MODELS WITH THE GRAPHICAL EDITOR
The selection of a Switching Rule for a substation is independent of the selection of a Running Arrange-
ment and if required, the reference to the switching rule in a substation can be stated to be operational
data; provided the user uses the Scenario Conguration object. For more information on the scenario
conguration refer to Chapter 14 (Operation Scenarios).
A typical application of Switching Rules is in contingency analysis studies, where there is a need to
evaluate the contingency results considering the actual switch positions in a substation and compare
them to the results considering a different substation conguration (for the same contingency).
To create a switching rule
To create a new Switching Rule:
Edit a Substation, either by right-clicking on the substation busbar from the single line graphic,
and from the context-sensitive menu choosing Edit a Substation, or by clicking on an empty place
in the substation graphic, and from the context-sensitive menu choosing Edit Substation. This will
open the substation dialogue.
Press the Select button ( ) in the Switching Rule section and select New. . .
The new Switching Rule dialogue pops up, where a name and the switching actions can be spec-
ied. The switching actions are arranged in a matrix where the rows represent the switches and
the columns the fault locations. By default the fault locations (columns) correspond to the number
of busbars and bay-ends contained inside the substation, while the switches correspond only to
the circuit breakers. The user can nevertheless add/remove fault locations and/or switches from
the Conguration page. The switch action of every dened breaker in the matrix can be changed
by double clicking on the corresponding cell, as illustrated in Figure 9.2.7. Press afterwards Ok.
The new switching rule is automatically stored inside the substation element.
DIgSILENT PowerFactory 15, User Manual 75
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Figure 9.2.7: Switching Rule Dialogue
To select a Switching Rule
A Switching Rule can be selected in the Basic Data page of a substation dialogue (ElmSubstat ) by:
Opening the substation dialogue.
Pressing the Select button ( ) in the Switching Rule section. A list of all Switching Rules for the
current substation is displayed.
Selecting the desired Switching Action.
To apply a Switching Rule
A Switching Rule can be applied to the corresponding substation by pressing the Apply button from
within the switching rule dialogue. This will prompt the user to select the corresponding fault locations
(busbars) in order to copy the statuses stored in the switching rule directly in the substation switches.
Here, the user has the option to select either a single fault location, a group or all of them.
The following functional aspects must be regarded when working with switching rules:
A switching rule can be selected for each substation. By default the selection of a switching rule
in a substation is not recorded in the operation scenario. However, this information can dened
as part of an operational scenario by using the Scenario Conguration object (see Chapter 14:
Operation Scenarios).
76 DIgSILENT PowerFactory 15, User Manual
9.2. DEFINING NETWORK MODELS WITH THE GRAPHICAL EDITOR
If a variation is active the selection of the Switching Rule is stored in the recording expansion
stage; that is considering that the Scenario Conguration object hasnt been properly set.
To assign a Switching Rule
The Assign button contained in the switching rule dialogue allows to set it as the one currently selected
for the corresponding substation. This action is also available in the context-sensitive menu in the data
manager (when right-clicking on a switching rule inside the data manager).
To preview a Switching Rule
The Preview button contained in the switching rule dialogue allows to display in a separate window the
different switch actions for the different fault locations of the corresponding substation.
9.2.7 Working with Composite Branches in the Graphical Editor
New composite branches can be created in the Data Manager using the procedure described in Chap-
ter 10, Section 10.3.4 (Dening Composite Branches in the Data Manager). The denition and con-
nection of the branch components can then be carried out in the relevant single line diagram, which is
automatically generated after the creation of the new branch.
Branches from previously dened templates are created using the single line diagram. The branches
are represented in these diagrams by means of the Composite Branch symbol ( ). To create a new
branch from a template:
Click on the Composite Branch button ( ) listed among the symbols on the right-hand drawing
pane. A list of available templates (from the Templates library) for branches will appear. If only
one Branch template exists, no list is shown.
From this list choose the template that you want to create the branch from.
If the branch is to be connected with terminals of the same single line graphic, simply click once
on each terminal.
If the branch is to be connected with a terminal from another single line diagram, you have to
Paste graphically one of the terminals on the diagram where you want to represent the branch,
or connect across pages as discussed in section 9.2.5 (Interconnecting Power Subsystems).
If the branch is to be connected with terminals from a substation, click once on each composite
node to which the branch is to be connected. You will be automatically taken inside each of those
composite nodes to make the connections. In the substation graphic click once on an empty spot
near the terminal where you want to connect the branch end, and then on the terminal itself.
A diagram of the newly created branch can be opened by double clicking at the composite branch
symbol. In the new diagram it is possible to rearrange the branch conguration and to change the
branch connections.
Details of how to dene templates are provided in Chapter 12 (Project Library).
9.2.8 Working with Single and Two Phase Elements
It is possible to dene the phase technology of elements such as terminals, lines, and loads. In in-
stances where the number of phases of a connecting element (e.g. a circuit breaker or line) is equal
to the number of phases of the terminal to which it connects, PowerFactory will automatically assign
the connections. However, when connecting single-phase elements to a terminal with greater than one
phase, or two-phase elements to terminals with greater than three phases, it is sometimes necessary to
DIgSILENT PowerFactory 15, User Manual 77
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
adjust the phase connectivity of the element to achieve the desired connections. The phase connectivity
can be modied as follows:
Open the dialogue window of the element (by double-clicking on the element).
Press the Figure >> button to display a gure of the elements with its connections on the bottom
of the dialogue window.
Double-click on the dark-red names for the connections inside this gure.
Specify the desired phase connection/s.
Alternatively, click the right arrow ( ) next to the Terminal entry and specify the desired phase connec-
tion/s.
Note: It is possible to colour the grid according to the phases (System Type AC/DC and Phases). For
more information about the colouring refer to Section 9.6.6 (Graphic Attributes and Options).
9.3 Dening and Working with Lines and Cables
This section describes specic features and aspects of line and cable data models used in PowerFactory
. Detailed technical descriptions of the models are provided in Appendix C (Technical References of
Models).
In PowerFactory , lines and cables are treated alike, they are both instances of the generalized line
element ElmLne. A line may be modelled simply as a point-to-point connection between two nodes and
will refer to a line (TypLne), tower (TypTow), a tower geometry (TypGeo), a line coupling (ElmTow), or a
cable system coupling (ElmCabsys) type. Alternatively, lines may be subdivided into sections referring
to different types.
Note: Anywhere that line is written in this section, lines and/or cables may be read, unless otherwise
specied.
The two basic line congurations are depicted in Figure 9.3.1:
1. Top line: the simplest line is a single line object (ElmLne).
2. Bottom line: such a single line may be subdivided into line section objects (ElmLnesec) at any
time/location. No terminals are allowed between two sections, but the sections may have different
line types.
Figure 9.3.1: Basic line congurations
The purpose of separating lines into sections is to obtain different line parts, with different types (such as
when a line uses two or more different tower types, or when manual transpositions should be modelled
- since the Transposed option in the type object is a perfect, balanced, transposition).
78 DIgSILENT PowerFactory 15, User Manual
9.3. DEFINING AND WORKING WITH LINES AND CABLES
9.3.1 Dening a Line (ElmLne)
The simplest line model is a point-to-point connection between two nodes. This is normally done in the
single line graphic by selecting the ( ) icon and by left clicking the rst terminal, possibly clicking on
the drawing surface to draw a corner in the line and ending the line at the second terminal by left clicking
it. This will create an ElmLne object in the database. When this object is edited, the following dialogue
will appear.
Figure 9.3.2: Editing a transmission line
The dialogue shows the two cubicles to which the transmission line is connected (terminal i and ter-
minal j). The example in Figure 9.3.2 shows a line which is connected between the nodes called Line
End Terminal and Line Feeder Bus from a grid called North. The line edit dialogue shows the name
of the node (in red) in addition to the name of the cubicle (in blue). The actual connection point to the
node is the cubicle and this may be edited by pressing the edit button ( ). The cubicle may be edited
to change the name of the cubicle, add/remove the breaker, or change phase connectivity as discussed
in section 9.2.8 (Working with Single and Two Phase Elements).
The type of the line is selected by pressing the ( ) next to the type eld. Line types for a line/ line route
are:
The TypLne object type, where electrical parameters are directly written (the user can select if the
type is dened for an overhead line or a cable).
Tower types (TypTow and TypGeo), where geometrical coordinates and conductor parameters are
specied, and the electrical parameters are calculated from this data. Selection of the tower type
will depend on the users requirement to link conductor type data to the line element as in TypGeo
(for re-use of the one tower geometry with different conductors), or to link conductor type data to
the tower type as in TypTow (for re-use of one tower geometry with the same conductors).
Once the lines (or cables) have been created it is possible to dene couplings between the circuits that
DIgSILENT PowerFactory 15, User Manual 79
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
they are representing by means of line coupling elements ElmTow (for overhead lines) and cable system
coupling elements ElmCabsys (for cables).
Details of how to create Line Sections, Cable Systems, and Line Couplings are provided in the fol-
lowing sections, and further information about line/cable modelling is given in the respective Technical
References.
9.3.2 Dening Line Sections
To divide a line into sections:
Press the Sections/Line Loads button in the line dialogue. This will open a data browser showing
the existing line sections (if the line has not been sectioned, it will be empty).
Click on the new object icon ( ) and select the element Line Sub-Section (ElmLnesec).
The edit dialogue of the new line section will pop up. There it is possible to dene the type and
length of the new section.
9.3.3 Example Cable System
Consider a three-phase underground cable comprised of three single-core cables with sheaths. The
cable system is created within the active project by taking the following steps.
1. Create a Single Core Cable Type (TypCab) and Cable Denition Type (TypCabsys):
Navigate to the Equipment Type Library and select the New Object icon, or on the right-hand
side of the data manager right-click and select New Others.
Select Special Types, Single Core Cable Type, and then Ok.
Enter the Type parameters and select Ok. (Note that in this example, a Sheath is also
selected, and therefore a separate line will later be dened in the Network Model to represent
the sheath.)
Again select the New Object icon, or on the right hand side of the data manager right-click
and select New Others.
Select Special Types, Cable Denition, and then Ok.
Enter type parameters including Earth Resistivity, and Coordinates of Line Circuits (note
that positive values indicate the depth below the surface). Select the Single Core Cable Type
dened in the previous steps and press Ok.
2. Create the Network Model:
Add four terminals in the single line diagram at the same voltage dened in the Single Core
Cable Type.
Connect a Line Element between two of the terminals to represent the phase conductors,
and enter the element parameters.
Connect another Line Element between the other two terminals to represent the sheath,
and enter the element parameters. (Add connections from the sheath terminals to earth as
required.)
3. Create a Cable System Element (ElmCabsys):
Create a Cable System by selecting the two lines drawn in the single line diagram (hold down
Ctrl and left-click each line). Then right-click one of the lines and select Dene Cable
System from the context sensitive menu. Alternatively, dene the cable system in the Data
Manager by creating a New Object and selecting Other Net Elements Cable System,
and then select the required Cable Denition and Line Elements to represent the Conductor
and Sheath circuits.
80 DIgSILENT PowerFactory 15, User Manual
9.3. DEFINING AND WORKING WITH LINES AND CABLES
Select the Cable Denition dened in step 1 and press Ok twice.
Note that the steps above could be conducted in an alternative order. For example, item 2 could be
completed before 1. Also, item 3 could be completed before item 1, and Cable Types could be created
at the time the Cable System Element is created. However, the recommended approach is to rst dene
the Type data that is to be used in the Network Model, then to create the Network Model with particular
instances of the cable as in the example.
Figure 9.3.3 illustrates the interrelationship between the elements and types used to dene cable sys-
tems inPowerFactory. Note that by right-clicking the line that represents the sheath and selecting Edit
Graphic Object the Line Style can be modied to indicate graphically that this line represents the sheath.
Figure 9.3.3: Example Cable System
DIgSILENT PowerFactory 15, User Manual 81
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
9.3.4 Example Line Couplings
Consider an example where there are two parallel transmission lines, each with a three-phase HV (132
kV) circuit, three-phase MV (66 kV) circuit, and two earth conductors. The tower element is created
within the active project by taking the following steps.
1. Create the Conductor Types (TypCon) for phase and earth conductors:
Navigate to the Equipment Type Library and select the New Object icon, or on the right-hand
side of the data manager right-click and select New Others.
Select Special Types, Conductor Type, and then Ok.
Enter the Type parameters and select Ok. In this example, conductors are dened for HV,
MV, and earth conductors.
2. Create a Tower Geometry Type (TypeGeo):
Again select the New Object icon, or on the right hand side of the data manager right-click
and select New Others.
Select Special Types, Tower Geometry Type, and then Ok.
Enter type parameters for the number of Earth Wires and Line Circuits (in this example, two
earth wires and two line circuits), and the coordinates of the conductors.
3. Create the Network Model:
Add two HV and two MV terminals in the single line diagram (at voltages consistent with the
previously dened conductor types).
Connect two Line Elements between the HV terminals, connect two Line Elements between
the MV terminals, and enter element parameters.
4. Create a Line Couplings Element (ElmTow):
Create a Line Coupling by selecting the four lines drawn in the single line diagram (hold
down Ctrl and left-click each line). Then right-click one of the lines and select Dene
Line Couplings from the context sensitive menu. Alternatively, dene the Line Coupling in
the Data Manager by creating a New Object and selecting Other Net Elements Line
Couplings.
Enter the Number of Overhead Line Systems (in this case, two) select the previously dened
tower Geometries, Earth Wires, Circuits, and Types, and enter element parameters such as
the Distance between the Towers.
Optionally dene a Route so that the single line diagram may be coloured based on the
dened Line Couplings and press Ok.
Note that the steps above could be conducted in an alternative order. For example, item 3 could be
completed before 1 and 2. Also, item 4 could be completed before items 1 and 2, and Conductor
Types and Towers could be created at the time the Line Couplings Element is created. However, the
recommended approach is to rst dene the Type data that is to be used in the Network Model, then to
create the Network Model with particular instances of the lines/towers as in the example.
Figure 9.3.4 illustrates the interrelationship between the elements and types used to dene Line Cou-
plings (Tower Elements) in PowerFactory.
82 DIgSILENT PowerFactory 15, User Manual
9.4. GRAPHIC WINDOWS AND DATABASE OBJECTS
Figure 9.3.4: Example Tower
9.4 Graphic Windows and Database Objects
In the PowerFactory graphic windows, graphic objects associated with the active study case are dis-
played. Those graphics include single line diagrams, station diagrams, block diagrams and Virtual
Instruments. Many commands and tools are available to edit and manipulate symbols in the graphics.
The underlying data objects may also be accessed and edited from the graphics, and calculation results
may be displayed and congured.
DIgSILENT PowerFactory 15, User Manual 83
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Many of the tools and commands are found in the drop down menus or as buttons in the toolbars, but by
far the most convenient manner of accessing them is to use the right mouse button to display a menu.
This menu is known as a Context Sensitive Menu; PowerFactory evaluates where the tip of your cursor
is, and then presents a menu that is appropriate to the cursor location. Thus cursor position is important
when selecting various menu options. It is important to keep the cursor in place when right-clicking, as
the menu presented is determined from cursor position primarily, and not from the selected or marked
object.
9.4.1 Network Diagrams and Graphical Pages
Four types of graphical pages are used in PowerFactory:
1. Single Line Diagrams (network diagrams) for entering power grid denitions and for showing cal-
culation results.
2. Detailed graphics of substations or branches (similar to network diagrams) for showing busbar
(nodes) topologies and calculation results
3. Block Diagrams for designing logic (controller) circuits and relays.
4. Virtual Instrument Pages for designing (bar) graphs, e.g. for the results of a stability calculation,
bitmaps, value boxes, etc...
The icon Graphical Pages ( ) can be found inside the Data Manager. Grids, substations, branches,
and controller types (common and composite types in PowerFactory terminology) each have a graphical
page. In order to see the graphic on the screen, open a Data Manager and locate the graphic page
object you want to show, click on the icon next to it, right-click and select Show Graphic. The Show
Graphic option is also available directly from each object. So for example you can select a grid in the
data manager, right-click, and show the graphic. The graphic pages of grids and substations are to be
found in the subfolder Diagrams ( ) under the Network Model folder.
Note that it is also possible to store Diagrams within the Grid, although this is generally not recom-
mended.
Figure 9.4.1: The Diagrams folder inside the Data Manager
84 DIgSILENT PowerFactory 15, User Manual
9.4. GRAPHIC WINDOWS AND DATABASE OBJECTS
9.4.2 Active Graphics, Graphics Board and Study Cases
The graphics that are displayed in an active project are determined by the active study case. The study
case folder contains a folder called the Graphics Board folder (SetDesktop) in which references to the
graphics to be displayed are contained. This folder is much like the Summary Grid folder which is
also stored within the Study Case, and links active grids to the Study Case. Both the Graphics Board
and Summary Grid are automatically created and maintained and should generally not be edited by the
user.
Within a PowerFactory project, the Network Model folder contains a sub-folder called Diagrams. This
sub-folder should generally also not be edited by the user as it is automatically created and maintained.
It contains the objects that represent single line and substation graphics (IntGrfnet objects). More
than one graphic (single line or substation diagrams) may be created for a grid, either to display the
different grid elements over several pages, or to display the same grid elements in different graphical
arrangements.
Consider the Project that is shown in Figure 9.4.2. The active study case is called Study Case 1 and
the active grid has three single line graphics that have been created for it, Grid 1, Grid 2 and Grid 3.
The graphics board folder in the study case has a reference to only the Grid 1 graphic object and thus
only this graphic for the grid will be shown when the study case is activated.
In the case of single line graphics, the references in the graphics board folder are created when the
user adds a grid to a study case. PowerFactory will ask the user which graphics of the grid should be
displayed. At any time later the user may display other graphics by right-clicking the grid and selecting
Show Graphic from the context sensitive menu. Graphics may be removed from the active study case
by right-clicking the tab at the bottom of the corresponding graphic page and selecting Remove Page(s).
The study case and graphics board folder will also contain references to any other graphics that have
been created when the study case is active, such as Virtual Instrument Panels.
DIgSILENT PowerFactory 15, User Manual 85
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Figure 9.4.2: Relationship between the study case, graphics board and single line diagrams
9.4.3 Single Line Graphics and Data Objects
In a simple network there may be a 1:1 relationship between data objects and their graphical repre-
sentations, i.e. every load, generator, terminal and line is represented once in the graphics. However,
PowerFactory provides additional exibility in this regard. Data objects may be represented graphically
on more than one graphic, but only once per graphic. Thus a data object for one terminal can be repre-
sented graphically on more than one graphic. All graphical representations contain the link to the same
data object.
Furthermore, graphical symbols may be moved without losing the link to the data object they represent.
Likewise, data objects may be moved without affecting the graphic.
The graphics themselves are saved in the database tree, by default in the Diagrams folder of the Network
Model. This simplies nding the correct Single Line graphic representation of a particular grid, even in
the case where there are several graphic representations for one grid.
When the drawing tools are used to place a new component (i.e. a line, transformer, etc.) a new data
object is also created in the database tree. A Single Line Graphic object therefore has a reference
to a grid folder. The new data objects are stored into the target folders that the graphics page are
associated with. This information may be determined by right-clicking the graphic Graphic Options,
see Section 10.5 (Editing Data Objects in the Data Manager) for more information.
Since data objects may have more than one graphic representation the deletion of a graphic object
should not mean that the data object will also be deleted. Hence the user may choose to delete only the
graphical object (right-click menu Delete Graphical Object only). In this case the user is warned that
the data object will not be deleted. This suggests that a user may delete all graphical objects related to
a data object, with the data object still residing in the database and being considered for calculations.
86 DIgSILENT PowerFactory 15, User Manual
9.4. GRAPHIC WINDOWS AND DATABASE OBJECTS
When an element is deleted completely (right menu option Delete Element ) a warning message will
conrm the action. This warning may be switched off in the User Settings dialogue, General page,
Always conrm deletion of Grid Data).
9.4.4 Editing and Selecting Objects
Once elements have been drawn on the graphic the data for the element may be viewed and edited by
either double-clicking the graphic symbol under consideration, or by right-clicking it and selecting Edit
Data.
The option Edit and Browse Data will show the element in a data manager environment. The object itself
will be selected (highlighted) in the data manager and can be double-clicked to open the edit dialogue.
A new data manager will be opened if no data manager is presently active. If more than one symbol
was selected when the edit data option was selected, a data browser will pop up listing the selected
objects. The edit dialogues for each element may be opened from this data browser one by one, or the
selected objects can be edited in the data browser directly, see Section 10.5 (Editing Data Objects in
the Data Manager).
Finding specic elements in a large project may be difcult if one had to look through the single line
diagram alone. PowerFactory includes the Mark in Graphic tool, to assist the user in nding elements
within the graphic. To use this tool the user has to rst search for the desired object in the Data Manager
using any of the methods presented in Chapter 10 (Data Manager). Once a searched object/element
is identied, it may be right-clicked and the option Mark in Graphic selected. This action will mark the
selected object in the single line graphic where it appears.
When performing this command ensure that the object itself is selected, as shown in Figure 9.4.3. The
menu will be different to that seen when selecting an individual eld, as shown in Figure 9.4.4.
Figure 9.4.3: Selecting an object correctly to Mark in Graphic
DIgSILENT PowerFactory 15, User Manual 87
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Figure 9.4.4: Selecting an object incorrectly to Mark in Graphic
Note: The position of an object in the database tree can be found by:
-Opening the edit dialogue. The full path is shown in the header of the dialogue.
-Right-clicking the object and selecting Edit and Browse. This will open a new database browser
when required, and will focus on the selected object.
9.4.5 Creating a New Project
A new project may be created by selecting File New on the main menu. This creates a new Project
folder and a dialogue is displayed where the user can dene a grid folder in the Project folder. Finally
the Graphic page in which the single line diagram will be displayed.
9.4.6 Creating New Graphic Windows
A new graphic window can be created using the New command dialogue. This dialogue may be opened
using one of the following methods:
By pressing the icon.
By pressing the keyboard shortcut Ctrl+N.
By selecting from the Insert menu on the main menu.
The ComNew dialogue must be congured to create the desired new object and the new object should
be named appropriately. Ensure that the correct target folder for the new object is selected. Graphical
objects that may be created using this dialogue (DiaPagetyp) are:
Grid Creates a new grid folder and a new Single Line Graphic object in that folder. The (empty)
single line graphic will be displayed.
Block Diagram Creates a new Block Diagram folder in the selected folder and a new Block
Diagram Graphic object. The (empty) block diagram graphic will be displayed.
88 DIgSILENT PowerFactory 15, User Manual
9.4. GRAPHIC WINDOWS AND DATABASE OBJECTS
Virtual Instrument Panel Creates a new Virtual Instrument Page object. The (empty) Virtual
Instrument Page will be displayed.
Single Line Diagram Creates a Single Line Graphic in the target folder. Before the graphic is
inserted, the user is prompted to select the relevant grid.
The target folder will be set to the \User folder by default, but may be changed to any folder in the
database tree. The new grid, Block Diagram or Virtual Instruments folder will be created in the target
folder.
In all cases, a new graphics board object is also created, because graphic pages can only be shown as
a page in a graphics board. An exception is the creation of a new page, while in a graphics board. This
can be done by pressing the icon on the graphics board toolbar. This will add the new graphics page
to the existing graphics board.
Further information about how to draw network components is given in the following sections.
9.4.7 Basic Functionality
Each of the four graphic window types are edited and used in much the same way. This section gives
a description of what is common to all graphic windows. Specic behaviour and functionality of the
graphic windows themselves are described other sections of the manual.
9.4.8 Page Tab
The page tab of the graphic window displays the name of the graphics in the graphics board. The
sequence of the graphics in the graphics board may be changed by the user. A page tab is clicked and
moved by dragging and dropping. An arrow marks the insert position during drag and drop. Another way
to change the order of the graphics is to select the option Move/Copy Page(s) of the context sensitive
menu. In addition virtual instrument panels can be copied very easily. To do so the Ctrl key is pressed
during drag and drop. The icon copies a virtual instrument panel and inserts the copy alongside the
original panel.
The page tab menu is accessed by a right-click on the page tab of the graphic windows. The following
commands are found:
Insert Page Create New Page creates a new page (the icon in the toolbar will do the same).
Insert Page Open Existing Page opens a page or graphic that has already been created but
which is not yet displayed (the icon in the toolbar will do the same).
Rename Page presents a dialogue to change the name of the graphic.
Move/Copy Page(s) displays a dialogue to move or copy the selected page. Copy is only available
for virtual instrument panels.
9.4.9 Drawing Toolboxes
Each graphics window has a specic Drawing Tool Box. This toolbox has buttons for new network
symbols and for non-network symbols. See Figure 9.4.5 for two examples.
DIgSILENT PowerFactory 15, User Manual 89
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
(a) Single Line Diagrams (b) Block Diagrams
Figure 9.4.5: Drawing Toolbox examples
The toolboxes have:
Network or block diagram symbols, which are linked to a database object: terminals, busbars,
lines, transformers, switches, adders, multipliers, etc.
Graphical add-on symbols: text, polygons, rectangles, circles, etc.
The toolboxes are only visible when the graphics freeze mode is off. The graphics freeze mode is turned
on and off with the icon (found at the main icon bar of the graphical window).
9.4.10 Active Grid Folder (Target Folder)
On the status bar of PowerFactory (Figure 9.4.6), the active grid folder is displayed on the left-most eld,
indicating the target folder (grid) that will be modied when you make changes in the network diagram.
To change the active target folder, double-click this eld and then select the desired target folder. This
can be useful if the user intends to place new elements on a single line diagram, but have the element
stored in a different grid folder in the data manager.
Figure 9.4.6: The Status Bar
9.5 Drawing Diagrams with Existing Network Elements
This section provides information about how to draw network components from existing objects.
Designing new (extensions to) power system grids, is preferably done graphically. This means that the
new power system objects should be created in a graphical environment. After the new components
90 DIgSILENT PowerFactory 15, User Manual
9.5. DRAWING DIAGRAMS WITH EXISTING NETWORK ELEMENTS
are added to the design, they are edited, either from the graphical environment itself (by double-clicking
the objects), or by opening a database manager and using its editing facilities.
It is however possible, to rst create objects in the database manager (either manually, or via import
from another program), and subsequently draw these objects in one or more single line diagrams.
PowerFactory allows for this either by drag and drop facilities to drag power system objects from the
data manager to a graphic window, or by the Draw Existing Net Elements tool. The way this is done is
as follows:
1. Select from the drawing tools toolbox the type of object that is to be drawn in the graphic.
2. Enable the drag & drop feature in the data manager by double-clicking the drag & drop message
in the message bar.
3. Select the data object in the data manager by left clicking the object icon.
4. Hold down the left mouse button and move the mouse to the graphic drawing area (drag it).
5. Position the graphical symbol in the same way as is done normally.
6. A new graphical symbol is created, the topological data is changed, but the graphical symbol will
refer to the dragged data object. No new data object is created.
The Draw Existing Net Elements tool may also be used to perform this action, as described in the next
sections.
9.5.1 Drawing Existing Busbars
Click on the button Drawing existing Net Elements ( ) and a window with a list of all the terminals
(busbars) in the network that are not visualized in the active diagram will appear.
Click on the symbol for busbars ( ) in the drawing toolbox. The symbol of the busbar (terminal) is now
attached to the cursor.
If the list is very large, press the button Adjacent Element Mode ( ), and then right-click an existing
node in the single line diagram and select Set as starting node. This activates the selecting of distance
(number of elements) from elements in the active node. Select the Distance of 1 in order to reduce the
number of busbars (terminals) shown.
If the button Use drawn nodes as starting objects ( ) is also selected, the list will be ltered based on
all drawn nodes (not just a single starting node).
If Show elements part of drawn composite nodes ( ) is selected, elements internal to already drawn
composite nodes will be shown in the list. However, since they are already drawn as part of the com-
posite node, they should not be re-drawn.
The marked or selected element can now be visualized or drawn by clicking somewhere in the active
diagram. This element is drawn and disappears from the list.
Note that the number of elements in the list can increase or decreases depending on how many el-
ements are a distance away from the element lastly drawn. Scroll down the list, in case only certain
elements have to be visualized.
Close the window and press Esc to return the Cursor to normal. The drawn terminals (busbars) can be
moved, rotated or manipulated in various ways.
DIgSILENT PowerFactory 15, User Manual 91
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
9.5.2 Drawing Existing Lines, Switches, and Transformers
Similar to the busbars, elements like lines and transformers connecting the terminals in the substation
can be drawn.
Press the button Draw Existing Net Elements ( ). For lines select the line symbol ( ) from the drawing
toolbox, for transformers select the transformer symbol ( ), and so on.
Similar to terminals, a list of all the lines (or transformers, or elements which have been chosen) in the
network, that are not in the active diagram are listed. Reduce the list by pressing the button Elements
which can be completely connected ( ) at the top of the window with the list. A list of lines with both
terminals in the active diagram is pre-selected. If the list is empty, then there are no lines connecting
any two unconnected terminals in the active diagram.
For each selected line (or transformers...) a pair of terminals, to which the line is connected is marked
in the diagram. Click on the rst terminal and then on the second. The selected line is drawn and is
removed from the list of lines.
Continue drawing all lines (or transformers...), until the list of lines is empty or all the lines to be drawn
have been drawn. If a branch cannot be completely drawn (for example, when the terminal at only one
end of a line is shown on the diagram), it is possible to double-click the diagram and arrows will appear
to indicate that the line connects to a terminal that is not shown. Figure 9.5.1 provides an illustration.
Figure 9.5.1: Illustration of single line diagram connectivity
9.5.3 Building Single Line Diagrams from Imported Data
When a power system model is imported from DGS format that includes graphical information or GIS
data, single line diagram/s will automatically be created. However, if a model is imported from another
program it may only include network data (some data converters provided in PowerFactory do also
import graphics les). Even without a single line diagram, it is possible to perform load-ow and other
calculations, and new single line diagram can be created by drawing existing database elements.
This is done by rst creating a new single line graphic object in the Diagrams folder of the Network Model
(right-click the Diagrams folder and select New Graphic). This opens the single line graphic dialogue,
where the Current Net Data pointer should be set to the respective grid folder. See Section 9.6 for more
information.
As soon as the correct folder has been set, and OK has been pressed, the single line graphic object ( )
is created and a blank graphic page will be displayed. The Draw Existing Net Elements ( ) icon on the
graphics toolbar may now be pressed. This opens a database browser listing all elements considered
by the active study case (see Figure 9.5.2) and which have not yet been inserted into the new single
line graphic.
This list may be ltered to show only particular grids or all grids by using the drop down window (Fig-
ure 9.5.2, red square) provided. Once a drawing tool is chosen, in this case the Terminal tool, the list is
further ltered to show only terminals, as can be seen in the example. When the user now clicks on the
graphic the highlighted terminal (in the browser, Figure 9.5.2) will be removed from the list and placed
onto the graphic, and the next terminal down will be highlighted, ready for placement.
92 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Figure 9.5.2: Using the Draw Net Elements tool
After all busbars have been inserted into the single line graphic, branch elements may be selected in
the graphic toolbox. When one of the branch elements is selected in the browser, the corresponding two
busbars will be highlighted in the single line graphic. This is also why the nodes should rst be placed
on the graphic. Branch elements are placed once the nodes are in position.
See also:
9.5.1: Drawing Existing Terminals
9.5.2: Drawing Existing Lines, Switches, and Transformers
Note: Another useful approach to developing single line diagrams is to rst dene a feeder (say, at
the cubicle closest to the source node), then run a load-ow, navigate to the feeder in the data
manager, right-click and select Show Schematic visualization by Distance or Bus Index. See
Section 13.5 (Feeders) for further information on how to dene feeders.
Note: Before placing elements onto the graphic users may nd it useful to congure and display a
background layer. This will be an image of an existing single line diagram of the system. It may be
used to trace over so that the PowerFactory network looks the same as current paper depictions;
see Section 9.6.4 for more information on layers.
9.6 Graphic Commands, Options, and Settings
In this section the commands, options and settings that are available in PowerFactory to congure and
use the graphic windows are introduced. The sub-sections of this chapter are divided as illustrated in
Figure 9.6.1.
Figure 9.6.1: Categories of graphic commands, options, and settings
9.6.1 Zoom, Pan, and Select Commands
Figure 9.6.2 shows the commands available for zooming, panning, and selecting. These commands
are also available from the main menu under View. The commands are described below.
DIgSILENT PowerFactory 15, User Manual 93
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Figure 9.6.2: Zoom, Pan, and Select Commands
Freeze Mode:
Locks the diagram from graphical changes, no network elements can be added or deleted. Note that
the status of switches can still be modied when freeze mode is on.
Zoom In:
Press the Zoom In icon to change the cursor to a magnifying glass. The mouse can then be clicked and
dragged to select a rectangular area to be zoomed. When the frame encompasses the area you wish
to zoom into release the mouse button. Alternatively, Ctrl+- and Ctrl++ keys can be used to zoom in
and out, or Ctrl and the mouse scroll wheel.
Note: The Acceleration Factor for zooming and panning can be changed on the second page of the
Graphic Window page in User Settings.
Zoom Back:
To zoom back press the Zoom Out button - this will step the zoom back to the last state.
Zoom All:
Zooms to the page extends.
Zoom Level:
Zooms to a custom or pre-dened level.
Hand Tool:
Use the hand tool to pan the single line diagram (when not at the page extends). Alternatively, the
mouse scroll wheel can be used to scroll vertically, and Ctrl+Arrow keys used to scroll vertically and
horizontally. When zoomed to the extent of the page, the tool will automatically switch to either Rectan-
gular Selection or Free-form Selection.
Rectangular Selection:
Used to select a rectangular section of the single line diagram. Note that this icon is generally depressed
when using the mouse pointer for other tasks, such as selecting Menu items, however the Hand Tool or
Free-form Selection may also be used.
Free-form Selection:
Used to select a custom area of the single line diagram.
94 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Mark All Elements:
This function marks (selects) all objects in the single line diagram. This is helpful for moving the whole
drawing to another place or copying the whole drawing into the clipboard. In block diagrams the sur-
rounding block will not be marked. The keyboard short cut Ctrl+A may also be used to perform this
action.
9.6.2 Page, Graphic, and Print Options
Figure 9.6.3 shows the page, graphic, and print options buttons available. These commands are dis-
cussed in this section, as well as some commands available through the page tab menu.
Figure 9.6.3: Page, Graphic, and Print Options
Print: This function will send the graphic to a printer. A printer dialogue will rst appear.
Also accessed through:
Main Menu: File Print
Keyboard: Ctrl+P
Drawing Format: The drawing area for single line diagrams, block diagrams and virtual instruments is
modied in the Drawing Format dialogue. A predened paper format can be selected as-is, edited, or
a new format be dened. The selected paper format has Landscape orientation by default and can be
rotated by 90 degrees by selecting Portrait. The format denitions, which are shown when an existing
format is edited or when a new format is dened, also show the landscape dimensions for the paper
format.
It is not possible to draw outside the selected drawing area. If a drawing no longer ts to the selected
drawing size, then a larger format should be selected. The existing graphs or diagrams are repositioned
on the new format (use Ctrl+A to mark all objects and then grab and move the entire graphic by left
clicking and holding the mouse key down on one of the marked objects; drag the graphic to a new
position if desired).
If no Subsize for Printing format has been selected, then, at printing time, the drawing area will be
scaled to t the paper size of the printer. If, for instance, the drawing area is A3 and the selected paper
in the printer is A4, then the graphs/diagrams will be printed at 70% of their original size.
By selecting a subsize for printing, the scaling of the drawing at printing time can be controlled. The
dimensions of the sub-sized printing pages are shown in the graphic page. If, for instance, the drawing
size has been selected as A3 landscape, and the printing size as A4 portrait, then a vertical grey line
will divide the drawing area in two halves. The drawing area will be accordingly partitioned at printing
time and will be printed across two A4 pages.
Make sure that the selected subsize for used for printing is available at the printer. The printed pages
are scaled to the available physical paper if this is not the case.
For instance:
DIgSILENT PowerFactory 15, User Manual 95
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
The drawing area has been selected as A2 landscape.
The subsize for printing has been selected as A3 portrait. The A2 drawing is thus to be printed
across two pages.
Suppose that the selected printer only has A4 paper. The original A2 drawing is then scaled down
to 70% and printed on two A4 sheets of paper.
Also accessed through:
Main Menu: File Page Setup
Rebuild:
The drawing may not be updated correctly in some circumstances. The rebuild function updates the
currently visible page by updating the drawing from the database.
Also accessed through:
Main Menu: Edit Rebuild
Right-Click: Drawing Rebuild
Insert New Graphic:
Inserts a new graphic object into the Graphic Board folder of the active study case and presents a blank
graphics page to the user. A dialogue to congure the new graphics object will appear rst.
Also accessed through:
Page Tab Menu: Insert Page Create New Page
Note: The Page Tab menu is opened by right-clicking a page tab, shown just below the single line dia-
gram.
Insert Existing Graphic:
Inserts existing graphics, which may be one of the following:
Graphic folder object (IntGrfnet, single line network or substation diagrams) opens the se-
lected graphic.
Terminal (ElmTerm, ) opens the station graphic of the selected terminal (this may also be ac-
cessed by right-clicking the terminal in a Data Manager, or a terminal on the single line graphic
Show Station Graphic.
Block Denition (BlkDef, ) The graphic of the block denition is opened. If there is no graphic
dened for the block denitions the command is not executed
Virtual Instrument Panels (SetVipage) A copy of the selected virtual instrument panel is created
and displayed.
Graphic folder objects (IntGrfnet ) may be opened in more than one Graphics Board at the same time,
even more than once in the same Graphics Board. Changes made to a graphic will show themselves
on all pages on which the graphic object is displayed.
Also accessed through:
Page Tab Menu: Insert Page Open Existing Page
Other Page Commands:
Other page commands accessed through the Page Tab Menu are as follows:
Remove Page:
This function will remove the selected graphic from the Graphics Board. The graphic itself will not be
deleted and can be re-inserted to the current or any other Graphics Board at any time.
96 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Rename Page:
This function can be used to change the name of the selected graphic.
Move/Copy Page(s):
This function can be used to move a page/s to modify the order of graphics.
Also accessed through:
Mouse Click: Left-click and select a single page (optionally press control and select multiple
pages) and drag the page/s to change the order graphics are displayed.
Data Manager: (Advanced) Modify the order eld of Graphics Pages listed within the Study Case
Graphics Board. To reect the changes, the study case should be deactivated and then re-
activated.
9.6.3 Graphic Options
Each graphic window has its own settings, which may be changed using the Graphic Options function
( ).
9.6.3.1 Basic Attributes page:
This function presents a dialogue for the following settings. See Figure 9.6.4.
Name The name of the graphic
Current Grid Data The reference to the database folder in which new power system elements created
in this graphic will be stored.
Write protected If enabled, the single line graphic can not be modied. The drawing toolboxes are not
displayed and the freeze icon becomes inactive.
Snap Snaps the mouse onto the drawing raster.
Grid Shows the drawing raster using small points.
Ortho-Type Denes if and how non-orthogonal lines are permitted:
Ortho Off: Connections will be drawn exactly as their line points were set.
Ortho: Allow only right-angle connections between objects.
Semi Ortho: The rst segment of a connection that leads away from a busbar or terminal will
always be drawn orthogonally.
Line Style for Cables Is used to select a line style for all cables.
Line Style for Overhead Lines Is used to select a line style for all overhead lines.
Offset Factor for Branch Symbols Denes the length of a connection when a branch symbol is drawn
by clicking on the busbar/terminal. This is the default distance from the busbar/terminal in grid points.
Allow Individual Line Style Permits the line style to be set for individual lines. The individual style may
be set for any line in the graphic by right-clicking the line Set Individual Line Style. This may also be
performed for a group of selected lines/cables in one action, by rst multi selecting the elements.
DIgSILENT PowerFactory 15, User Manual 97
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Allow Individual Line Width As for the individual line style, but may be used in combination with the
Line Style for Cables/Overhead Lines option. The individual width is dened by selecting the corre-
sponding option in the right mouse menu (may also be performed for a group of selected lines/cables in
one action).
Figure 9.6.4: Graphic Options dialogue
9.6.3.2 Text Boxes page:
Boxes of Object Names - Background Species the transparency of object names boxes:
Opaque: Means that objects behind the results box cannot be seen through the results box.
Transparent: Means that objects behind the results box can be seen through the results box.
Result Boxes - Background Species the transparency of result boxes (as boxes of object names).
Always show result boxes of detailed couplers Self-explanatory.
Space saving representation of result boxes on connection lines Self-explanatory.
Show line from General Textboxes to referenced objects may be disabled to unclutter the graphic.
Reset textboxes completely Textboxes and result boxes have reference points (the point on the box
at which the box will attach to its element) that may be changed by the user. If this option is:
Enabled: The default reference will be used.
Disabled: The user dened reference will be used.
98 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
9.6.3.3 Switches page:
Cubicle representation Selects the switch representation (see Figure 9.6.5):
Permanent Box: Shows a solid black square for a closed and an frame line for an open switch
(left picture).
Old Style Switch: Shows the switches as the more conventional switch symbol (right picture).
Figure 9.6.5: Cubicle representations
Display Frame around Switches Draws a frame around the switch itself (Breakers, Disconnectors,
etc.). This only applies to user-drawn breakers and disconnectors.
Create switches when connecting to terminal Self-explanatory.
Show connected busbars as small dots in simplied substation representation Denes how the
connection points on busbars are represented in busbar systems.
Additional Attributes and Coordinates pages should generally only be congured with the assistance
of DIgSILENT support staff. Note that if Use Scaling Factor for Computation of Distances is selected
on the Coordinates page, it is possible to calculate the length of lines on the Single Line Graphic by
right-clicking and selecting Measure Length of Lines.
Also accessed through:
Right-click: Graphic Options
Note: The settings for the cursor type for the graphic windows (arrow or tracking cross) may be set
in the User Settings dialogue, see Section 7.2 Graphic Windows Settings. This is because the
cursor shape is a global setting, valid for all graphic windows, while all graphic settings described
above are specic for each graphic window.
9.6.4 Layers
The single line graphic and the Block diagram graphic windows use transparent layers of drawing sheets
on which the graphical symbols are placed. Each of these layers may be set to be visible or not. The
names of objects that have been drawn, for example, are on a layer called Object Names and may be
made visible or invisible to the user.
Which layers are visible and exactly what is shown on a layer is dened in the Graphical Layers dia-
logue, accessed through the main toolbar ( ), by right-clicking on an empty spot of the graphic area
DIgSILENT PowerFactory 15, User Manual 99
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Show Layer, or selecting View Layers from the main menu. The layers dialogue has a Visibility
page to determine which layers will be visible, and a Conguration page to dene various attributes
for the layers. See Figure 9.6.6.
In Figure 9.6.6, the layers in the left pane (Base Level, Object Names, Results, etc.) are visible in the
graphical window. The layers in the right pane are invisible. Layers can be made visible by multi select-
ing them (hold the Ctrl key down whilst selecting) and pressing the button (alternatively, double-click
a layer name and it will jump to the other pane). A layer can be made invisible again by selecting it in the
left pane and pressing the button or by double-clicking it. It is also possible to dene user-specic
layers, by pressing the New button.
Figure 9.6.6: Graphical layers dialogue (SetLevelvis)
The layers existing in PowerFactory are described in Table 9.6.1.
Each graphic symbol in a single line diagram or block diagram is assigned to default layer at rst. All
busbar symbols, for example, are drawn on the Base Level layer by default. Graphic symbols may be
shifted onto other layers by right-clicking them in the single line graphic and selecting the option Shift to
Layer from the context sensitive menu. This option will show a second menu with all layers. Selecting a
layer will move all selected symbols to that layer. Moving symbols from one layer to another is normally
only needed when only a few symbols from a certain group should be made visible (for instance the
result boxes of one or two specic junction node), or when user dened layers are used.
Note: Certain names and results boxes are, by default, assigned to the Invisible Objects layer. An ex-
ample are the names and results boxes for point terminals. This is done to unclutter the graphic.
Should the user wish to display names and/or results boxes for certain Junction / Internal nodes
simply make the Invisible Objects layer visible and re-assign the names and results boxes re-
quired to another layer, such as the Object Names or Results layers - then make the Invisible
Objects layer invisible once more.
The Conguration page has a drop down list showing all layers that may be congured by the user.
Considering the Object Names layer as shown in Figure 9.6.7, it may be seen that a target (or focus)
may be set. The selected target will be the focus of the performed conguration command. Various
actions or settings may be performed, such as e.g. changing the font using the Change Font button.
The conguration page may also be used to mark (select/ highlight) the target objects in the graphic
using the Mark button.
The options available to congure a layer depend on the type of Layer. Table 9.6.1 shows for each layer
in which way its content can be changed in format.
100 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Figure 9.6.7: Graphical layers conguration page
As and example, suppose that a part of the single line graphics is to be changed, for instance, to allow
for longer busbar names. To change the settings, the correct graphical layer is rst selected. In this
example, it will be the Object Names layer. In this layer, only the busbar names are to be changed,
and the target must therefore be set to All Nodes. When the layer and the target has been selected,
the width for object names may be set in the Settings area. The number of columns may be set using
the Visibility/Frame/Width button. Alternatively, the Adapt Width will adapt all of the object name
placeholders to the length of the name for each object.
Changing a setting for all nodes or all branches at once will overwrite the present settings.
Note: Should an object disappear when it has been re-assigned to a layer, that layer may be invisible.
Layer visibility should be inspected and changed if required.
Layer Content
Conguration
Options
Diagram Type
SL Single Line
B Block
Base Level
Symbols for the elements
of the grid
Text/Box For-
mat
SL/B
Object
Names
Boxes with names and
additional data descrip-
tion, if congured
Text/Box For-
mat
SL/B
Results
Boxes with calculation re-
sults
Text/Box For-
mat
SL/B
DIgSILENT PowerFactory 15, User Manual 101
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Layer Content
Conguration
Options
Diagram Type
SL Single Line
B Block
Connection
Points
Dots at the connections
between edges and
buses/terminals and
signal connections to
blocks
Text/Box For-
mat
SL/B
Device Data
Additional Text explana-
tion given in the device
symbol
Text/Box For-
mat
SL/B
Invisible
Objects
Layer containing the sym-
bols of elements hidden
by default
Text/Box For-
mat
SL/B
Background
Graphic used as the back-
ground (wallpaper) to al-
low easier drawing of the
diagram or to show addi-
tional information (map in-
formation)
Name of le
with graphics
(WMF, DXF,
BMP, JPEG,
PNG, GIF,
TIF)
SL/B
Numbers of
connection
lines
Number of lines for each
connection
Text/Box For-
mat
SL
Sections
and Line
Loads
Symbols at lines consist-
ing of sections and/or
where line loads are con-
nected
Text/Box For-
mat
SL
Connection
Arrows
Double-Arrow at connec-
tions where the end point
is not represented in the
current diagram.
Text/Box For-
mat
SL
Tap Posi-
tions
Positions of taps for
shunts and transformers
Text/Box For-
mat
SL
Vector
Groups
Vector group for rotating
machines and transform-
ers
Text/Box For-
mat
SL
Direction
Arrows
Arrows that can be cong-
ured for active and reac-
tive power ow represen-
tation
Active/Reactive
Power for di-
rect/ inverse/
homopolar
system
SL
Phases
Number of phases of a
line/cable, shown as par-
allel lines
Text/Box For-
mat
SL
Connection
Numbers
Index of each possible
block connection point
Text/Box For-
mat
B
Connection
Names
Name of each unused
connection of a block
Text/Box For-
mat
B
Signals
Name of the signal trans-
mitted
Text/Box For-
mat
B
Block De-
nition
Denition each block is
based on
Text/Box For-
mat
B
102 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Layer Content
Conguration
Options
Diagram Type
SL Single Line
B Block
Remote
Controlled
Substa-
tions
Remote Controlled Sub-
stations
Colour SL
Annotations Annotations in the graphic
Text/Box For-
mat
SL
Table 9.6.1: Diagram Layers of PowerFactory
9.6.5 Element Options
Figure 9.6.8 shows the commands available for zooming, panning, and selecting.
Figure 9.6.8: Element options
Edit and Browse Data:
This option lets the user edit the device data of all marked objects in the drawing. If only one object
is marked, then this objects edit dialogue will be displayed. When more than one object is marked,
the Data Manager window will show the list of marked objects. As with a normal Data Manager, these
objects can be double-clicked to open their edit dialogues. See Chapter 10 (Data Manager) for more
information.
Note: Changes made in the device data of objects are not registered by the graphical Undo Function.
Undoing these changes is therefore not possible.
Also accessed through:
Right-click: Edit and Browse Data
Note: To edit data for a single element, double-click the element, or select the element and press
Alt+Return.
Delete Element:
This function deletes all marked objects in the diagram. The database objects for the graphical object
will also be deleted (a warning message will pop up rst - this may be switched off in the User Settings
dialogue; see Section 7.2 (Graphic Windows Settings).
DIgSILENT PowerFactory 15, User Manual 103
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Also accessed through:
Right-click: Delete
Keyboard: Del
Note: To delete graphical objects only, right click the selected element/s and select Delete Graphical
Object only.
Cut:
This function cuts the marked objects in the diagram. Objects can then later be pasted as discussed
below.
Also accessed through:
Right-click: Cut
Keyboard: CTRL+X
Copy:
Copies all marked objects from the current drawing and puts them into the clipboard.
Also accessed through:
Right-click: Delete
Keyboard: CTRL+C
Paste:
Copies all objects from the clipboard and pastes them into the current drawing. The objects are pasted
at the current graphical mouse position. Objects that are copied and pasted create completely new
graphic and data objects in the graphic that they are pasted into.
Also accessed through:
Right-click: Paste
Keyboard: CTRL+V
Note: If you wish to copy and paste just the graphic, then choose Paste Graphic Only from the right-
click menu. Similar results are obtained when using the Draw Existing Net Elements tool (see
Section 9.5: Drawing Diagrams with Existing Network Elements).
Note: The undo command undoes the last graphic action and restore deleted elements, or deletes cre-
ated elements. Note that data that has been deleted or changed will not be restored. The undo
command is accessed through the undo icon ( ), by right-clicking and selecting Undo, or by
pressing Ctrl+Z.
Reconnect Element:
Disconnects the selected elements and then presents the element for immediate re-connection. The
branch to be connected will be glued to the cursor. Left clicking a bar or terminal will connect the
element.
Also accessed through:
Right-click: Reconnect Element
Note: Elements can also be disconnected and connected by selecting right-clicking and selecting Dis-
connect or Connect.
104 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Other Commands:
Rotate: Right-click selection and Rotate to rotate symbols clockwise, counter-clockwise, or 180 degrees.
It is generally preferable to disconnect an element before rotating it.
Disconnect:
Right-click and select Disconnect to disconnect the selected element/s.
Connect:
Right-click and select Connect to connect an element.
Redraw:
Right-click and select Redraw to redraw a selected element.
Move:
Marked objects can be moved by left clicking them and holding down the mouse button. The objects
can be moved when the cursor changes to an arrowed cross ( ). Hold down the mouse button and
drag the marked objects to their new position. Connections from the moved part of the drawing to other
objects will be adjusted.
Edit Line Points:
Right-click and select Edit Line Points will show the black squares (line points) that dene the shape
of the connection. Each of these squares can be moved by left clicking and dragging them to a new
position (see Figure 9.6.9). New squares can be inserted by left clicking the connection in between
squares. Line points are deleted by right-clicking them and selecting the Delete Vertex option from the
case sensitive menu. This menu also presents the option to stop (end) the line point editing, which can
also be done by left clicking somewhere outside the selected lines.
Figure 9.6.9: Editing line points
DIgSILENT PowerFactory 15, User Manual 105
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
9.6.6 Graphic Attributes and Options
Figure 9.6.10 shows the commands available for zooming, panning, and selecting.
Figure 9.6.10: Graphic Attributes and Options
9.6.6.1 Select Graphic Attributes:
This dialogue sets the line style, line width, brush style, colour and font, for annotations (i.e. not for
power system elements).
The line style includes several kinds of dashed or dotted lines and one special line style: the TRUE
DOTS style. This style will only put a dot at the actual coordinates. In a single line graphic, this means
only at the start and the end, which does not make much sense. For result graphs, however, the TRUE
DOTS style will only show the actual data points.
The brush style is used to ll solid symbols like squares and circles. These settings may also be
accessed by simply double-clicking an annotation.
9.6.6.2 Diagram Colouring:
The single line graphic window has an automatic colour representation mode. The Diagram Colouring
icon on the local toolbar will open the diagram colouring representation dialogue (alternatively, select
View Diagram Colouring on the main menu). This dialogue is used to select different colouring
modes and is dependent if a calculation has been performed or not. If a specic calculation is valid,
then the selected colouring for that calculation is displayed.
The Diagram Colouring has a 3-priority level colouring scheme also implemented, allowing colouring
elements according to the following criteria: 1
st
Energizing status, 2
nd
Alarm and 3
rd
Normal (Other)
colouring.
Energizing Status If this check box is enabled De-energized or Out of Calculation elements
are coloured according to the settings in the Project Colour Settings. The settings of the De-
energized or Out of Calculation mode can be edited by clicking on the Colour Settings button.
Alarm If this check box is enabled a drop down list containing alarm modes will be available. It
is important to note here that only alarm modes available for the current calculation page will be
listed. If an alarm mode is selected, elements exceeding the corresponding a limit are coloured.
Limits and colours can be dened by clicking on the Colour Settings button.
Normal (Other) Colouring Here, two lists are displayed. The rst list will contains all available
colouring modes. The second list will contain all sub modes of the selected colouring mode. The
settings of the different colouring modes can be edited by clicking on the Colour Settings button.
106 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Every element can be coloured by one of the three previous criteria. Also, every criterion is optional and
will be skipped if disabled. Regarding the priority, if the user enables all three criterion, the hierarchy
taken account will be the following:
Energizing Status overrules the Alarm and Normal Colouring mode. The Alarm mode over-
rules the Normal Colouring mode.
The graphic can be coloured according to the following listed below. Availability of some options will
depend on the Function that is selected (e.g. Voltage Violations does not appear when the Basic Data
page is selected, but does when the Load Flow page is selected).
Energizing Status:
De-energized
Out of Calculation
Alarm:
Feeder Radiality Check (Only if Feeder is supposed to be operated radially is selected).
Outages
Overloading of Thermal/Peak Short Circuit Current
Voltage Violations/Overloadings
Normal (Other) Colouring:
Results
Average Interruption Duration
Fault Clearing Times
Load Point Energy Not Supplied
Loading of Thermal / Peak Short-Circuit Current
State Estimator
Voltages / Loading
Yearly interruption frequency
Yearly interruption time
Incident Energy
PPE - Category
Topology
Boundaries (Denition)
Boundaries (Interior Region)
Connected Components
Connected Components, Voltage Level
Connected Grid Components
Energizing Status
Feeders
Missing graphical connections
Outage Check
DIgSILENT PowerFactory 15, User Manual 107
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Station Connectivity
Station Connectivity (Beach Balls only)
Supplied by Secondary Substation
Supplied by Substation
System Type AC/DC and Phases
Voltage Levels
Primary Equipment
Cross Section
Forced Outage Duration
Forced Outage Rate
Year of Construction
Secondary Equipment
Measurement Locations
Power Restoration
Relays, Current and Voltage Transformers
Switches, Type & Usage
Groupings (Grids, Zones, Areas...)
Areas
Grids
Meteo Stations
Operators
Owners
Paths
Routes
Zones
Variations / System Stages
Modications in Recording Expansion Stage
Modications in Variations / System Stages
Original Locations
User-dened
Individual
An illustration of diagram colouring options is shown in Figure 9.6.11. In this case, the Voltage Colouring
Mode is set to Voltage Drop and Rise, under Colour Settings. Also, the Colouring scheme for voltages
and loading is set to Continuous on the Advanced tab.
108 DIgSILENT PowerFactory 15, User Manual
9.6. GRAPHIC COMMANDS, OPTIONS, AND SETTINGS
Figure 9.6.11: Illustration of diagram colouring
9.6.6.3 Show Title Block:
The title block can be turned on and off from the single line diagram toolbar ( ) or the View menu.
The title block is placed in the lower right corner of the drawing area by default, see Figure 9.6.12 for an
example.
Figure 9.6.12: Single line title mask
The contents and size of the title mask can be changed by right-clicking the title block and selecting
the Edit Data option from the context sensitive menu. The Select Title dialogue that pops up is used to
scale the size of the title block by setting the size of the block in percent of the default size. The font
used will be scaled accordingly. To edit the text in the title block press the edit button ( ) for the Title
Text eld. All text elds have a xed format in the title block. The data and time elds may be chosen as
automatic or user dened. Most text elds are limited to a certain number of characters. When opening
a new graphic the title will appear by default.
DIgSILENT PowerFactory 15, User Manual 109
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
9.6.6.4 Show Legend Block:
The legend block can be turned on and off from the single line diagram toolbar ( ), or from the View
menu. The legend block describes the contents of result boxes (for information about result boxes
see 9.8).
Because more than one type of result box is normally used in the Single line graphic, for instance, one
for node results and another one for branch results, the legend box normally shows more than one
column of legends. After changing the result box denitions, it may be required to manually resize the
legend box in order to show all result box legends.
The Legend Box denition dialogue is opened by right-clicking the legend block and selecting Edit Data
from the context sensitive menu. The font and format shown may be congured. When opening a new
graphic the legend will appear by default.
9.6.6.5 Colour Legend Block:
The colour legend block can be turned on and off from the single line diagram toolbar ( ), or from the
View menu. The legend updates automatically based on the colouring options selected.
9.6.7 Node Default Options
Figure 9.6.13 shows the commands available for setting node default options. These are discussed in
further detail in this section.
Figure 9.6.13: Node default options
Default Voltage Levels for Terminals and Busbars:
The default voltage level for terminals can be set in this eld. New terminals placed on the single line
diagram will have this voltage (e.g. 110 kV, 0.4 kV).
Default Phase Technologies for Terminals:
The default phase technology for terminals can be set in this eld. New terminals placed on the single
line diagram will be of this type (e.g. three-phase ABC, one-phase, DC, etc.).
9.7 Editing and Changing Symbols of Elements
You can edit or change the symbols, which are used to represent the elements in the single line graphic.
Click with the right mouse button on a symbol of an element in the single line graphic, then either:
Select Edit Graphic Object from the context sensitive menu in order to edit the symbol of the
element. Note that colour changes will only be displayed if Other User-dened is selected in
the Diagram Colouring options.
110 DIgSILENT PowerFactory 15, User Manual
9.8. RESULTS BOXES, TEXT BOXES AND LABELS
Select Change Symbol from the context sensitive menu in order to use a different symbol for the
element. PowerFactory supports user-dened symbols as Windows-Metale (
.bmp) les.
For additional information refer to Appendix F (Element Symbol Denition).
9.8 Results Boxes, Text Boxes and Labels
PowerFactory uses results boxes, text boxes, and labels in the Single Line Diagramto display calculation
results and other useful information. Figure 9.8.1 illustrates how these can be shown in the Single Line
Diagram.
Figure 9.8.1: Results boxes, text boxes, and labels available in PowerFactory
9.8.1 Results Boxes
General:
Result boxes are generally set up so that there are a series of different formats for each calculation
function, with variables appropriate to that function. In addition, the format differs for the objects class
and/or for individual objects. For example, following a load-ow, branch and edge elements will have
different formats compared to nodes, and an external grid will have an individual, different, format as
compared to the branch and edge elements.
The result box itself is actually a small output report, based on a form denition. This form denition,
and the PowerFactory output language that is used to dene it, allows for the display of a wide range of
calculated values, object parameters, and even for colouring or user dened text.
Although the result boxes in the single line graphic are a very versatile and powerful way for displaying
calculation results, it is often not possible to display a large (part of a) power system without making
the result boxes too small to be read. PowerFactory solves this problem by offering balloon help on the
result boxes. Positioning the mouse over a result box will pop up a yellow text balloon with the text
displayed in a xed size font. This is depicted in Figure 9.8.1. The result box balloon always states the
name of the variable, and may thus also be used as a legend.
DIgSILENT PowerFactory 15, User Manual 111
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
Reference points:
A result box is connected to the graphical object for which it displays the results by a reference point.
Figure 9.8.1 shows the default reference points for the resultbox of a terminal. A reference point is a
connection between a point on the result box (which has 9 optional points), and one of the docking
points of the graphical object. The terminal has three docking points: on the left, in the middle and on
the right. The reference point can be changed by:
Right-clicking the resultbox with the graphics cursor (freeze mode off), and selecting Change
Reference Points.
The reference points are shown: docking points in green, reference points in red. Select one of
the reference points by left-clicking it.
Left-click the selected reference point, and drag it to a red docking point and drop it.
An error message will result if you drop a reference point somewhere else than on a docking point.
Result boxes can be freely moved around the diagram. They will remain attached to the docking point,
and will move along with the docking point. A result box can be positioned back to its docking point by
right-clicking it and selecting Reset Settings from the menu.
If the option Reset textboxes completely is set in the graphical settings, then the default reference
and docking points will be selected again, and the result box is moved back to the default position
accordingly.
Editing Results Boxes:
PowerFactory uses separate result boxes for different groups of power system objects, such as node
objects (i.e. busbars, terminals) or edge objects (i.e. lines, loads). For each type of result box, a different
result box denition is used.
A newly installed version of PowerFactory has pre-dened result box formats for all object groups. These
default formats cannot be changed, however the user may dene other formats and save these for use.
For the edge objects, for example, the default box shows P and Q without units.
A number of these predened formats are available for display; they may be selected by right-clicking a
results box to get the Format for Edge Elements (in this example) option, which then presents a number
of formats that may be selected. The active format is ticked ( ) and applies for all the visualized edge
elements.
It is also possible to select predened formats for an specic element class. If the edge element is
for example an asynchronous machine, in the context sensitive menu it will be also possible to get the
option Format for Asynchronous Machine, which shows the predened formats for the element class
Asynchronous Machine (ElmAsm). The selected format will in this case apply only to the visualized
asynchronous machines.
If the user wants to create a specic format that is different from the pre-dened ones, the Edit Format
for Edge Elements (or Node Elements) option should be used. Note that the new format will be applied
to the entire group of objects (edge or node objects).
If a created format is expected to be used for just one specic element, then the Create Textbox option
should be used. An additional results box/ textbox will be created, using the current format for the object.
This may then be edited. Information about text boxes is given in 9.8.2.
When the Edit Format option has been selected the user can modify the variables and how are they
showed as described Chapter 17: Reporting and Visualizing Results, Section 17.2.1: Editing Result
Boxes.
112 DIgSILENT PowerFactory 15, User Manual
9.8. RESULTS BOXES, TEXT BOXES AND LABELS
Formatting Results Boxes:
Result boxes can be formatted by means of the context sensitive menu (right-clicking the desired result
box). The available options include:
Shift to layer (see 9.6.4).
Rotate the result box.
Hide the results box.
Change the font type and size of the text.
Change the width.
Set the text alignment.
Adapt width
Change reference points.
Set the default format (Reset Settings, only available after changes have been made).
Resetting Calculation Results:
When pressed, the Reset Calculation icon ( ) will clear the results shown on the Single Line Diagram.
By default, PowerFactory will also clear the calculation results when there is a change to network data
or network conguration (such as opening a switch). However, if Retention of results after network
change is set to Show last results in the User Settings (see Section 7.1: General Settings), results will
appear in grey on the Single Line Diagram and on the Flexible Data tab until the calculation is reset,
or a new calculation performed. Reset Calculation can also be accessed from the main menu under
Calculation.
9.8.2 Text Boxes
As mentioned in 11.8.1, text boxes are used to display user dened variables from a specic referenced
object within the single line graphic. To create a text box, right-click on the desired object (one end of
the object when it is a branch element) and select Create Textbox. By default a text box with the same
format of the corresponding result box will be generated.
The created text box can be edited, to display the desired variables, following the same procedure de-
scribed in 9.8.1. In this case after right-clicking the text box, the option Edit Format should be selected.
By default the text boxes are graphically connected to the referred object by means of a line. This con-
nection line can be made invisible if the option show line from General Textboxes.... from the Result
Boxes page of the Graphic Option dialogue (9.6.3, Figure 9.6.4) is disabled.
9.8.3 Labels
In the general case, a label showing the name of an element within the single line graphic is automat-
ically created with the graphical objects (see Figure 9.8.1). The label can be visualized as a text box
showing only the variable corresponding to the name of the object. As for text boxes, the format of
labels can be set using the context sensitive menu.
9.8.4 Free Text Labels
Free Text Labels (see Figure 9.8.1) can be anchored to an element on the single line diagram, and used
to display custom text. The are created by right-click and selecting Create Free Text Label.
DIgSILENT PowerFactory 15, User Manual 113
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
9.9 Geographical Diagrams
In PowerFactory it is possible to specify terminal GPS coordinates, and automatically generate Geo-
graphical Diagrams. GPS coordinates (latitude and longitude) are entered on the Description page of
terminals and lines. This is on the Geographical Coordinates tab. Once GPS coordinates are entered,
a single geographical diagram can be created by either:
Opening the Data Manager, right-clicking the active project or active grid and selecting Show
Geographical Diagram.
On the main menu, on the Window tab, selecting Show Geographical Diagram.
The geographical diagram provides a visual representation of the network, it is not possible to add new
elements to the diagram.
An additional layer call Load / Generation Distribution is available for GPS coordinates to illustrate the
magnitude of network load and generation (apparent power), as illustrated in Figure 9.9.1. Note that
the displayed size of circles does not change as the user zooms in and out of the diagram. Colour
and Scaling Factor settings can be modied on the Conguration page of Graphic Layers, see 9.6.4
(Layers).
Figure 9.9.1: Geographical diagram example
To display background images (e.g. maps) on the geographical diagram a File for reading Background
Images must be selected in the Geographic Diagram page of the Graphic Options dialogue. This
facilitates tiling of multiple images in the background of the GPS graphic if required.
The File for reading background images is simply a text le with semi-coma delimited entries in the
following format:
Image lename; X1; Y1; X2; Y2
114 DIgSILENT PowerFactory 15, User Manual
9.9. GEOGRAPHICAL DIAGRAMS
Where:
Image lename is the name of the image le. If it is not in the same directory as the File for
reading background images it should include the le path.
X is the latitude and Y is the longitude.
(X1,Y1) are the bottom-left coordinates of the image.
(X2,Y2) are the top-right coordinates of the image.
The # symbol can be used to comment out entries.
DIgSILENT PowerFactory 15, User Manual 115
CHAPTER 9. NETWORK GRAPHICS (SINGLE LINE DIAGRAMS)
116 DIgSILENT PowerFactory 15, User Manual
Chapter 10
Data Manager
10.1 Introduction
To manage/ browse the data in PowerFactory , a Data Manager is provided. The objective of this
chapter is to provide detailed information on how this Data Management tool. Before starting, users
should ensure that they are familiar with Chapter 4 (PowerFactory Overview).
10.2 Using the Data Manager
The Data Manager provides the user with all the features required to manage and maintain all the data
from the projects. It gives both an overview over the complete data base as well as detailed information
about the parameters of single power system elements or other objects. New case studies can be
dened, new elements can be added, system stages can be created, activated or deleted, parameters
can be changed, copied, etc. All of these actions can be instituted and controlled from a single data
base window.
The data manager uses a tree representation of the whole database, in combination with a versatile
data browser.To initially open a data manager window press the icon from the main toolbar. The
settings of this window can be edited using the User Settings dialogue (Section 10.2.5: Data Manager
Settings).
The data manager window has the following parts (see Figure 10.2.1):
The title bar, which shows the name and path of the of the folder currently selected in the database
[1].
The data manager local tool bar [2].
In the left upper area the database window, which shows a symbolic tree representation of the
complete database [3].
In the left lower area the input window. It may be used by more experienced users to enter
commands directly, instead of using the interactive command buttons/dialogues. By default it is
not shown. For further information see Section 10.7 (The Input Window in the Data Manager)
[4].The input window is opened and closed by the clicking on the Input Window button ( ).
On the right side is the database browser that shows the contents of the currently selected folder
[5].
Below the database browser and the input window is the message bar, which shows the current
status and settings of the database manager (for further information see Section 10.2.5).
DIgSILENT PowerFactory 15, User Manual 117
CHAPTER 10. DATA MANAGER
There are some special features of the database browser which can be accessed at any time when the
content of a folder is shown:
Balloon text: this is not only available for the buttons in the tool bar and the active parts of the
message bar or the browser window, but also for the data elds [a].
Active Title buttons of each column; click on any title button to sort the items in the column; rst
click- items are sorted in ascending order; second click - items are sorted in descending order [b].
Object buttons showing the object standard icon in the rst column of the database browser: each
object is represented by a button (here a line object is shown). One click selects the object and a
double-click presents the edit dialogue for the object [c].
Figure 10.2.1: The data manager window
PowerFactory makes extensive use of the right mouse button. Each object or folder may be right-clicked
to pop up a context sensitive menu. For the same object the menu presented will differ depending on
whether the object is selected in the left or right hand side of the data manager (this is known as a
context sensitive menu). Generally, the left hand side of the data manager will show object folders
only. That is, objects that contain other objects inside them. The right hand side of the data manager
shows object folders as well as individual objects.
118 DIgSILENT PowerFactory 15, User Manual
10.2. USING THE DATA MANAGER
Figure 10.2.2: Context sensitive menus in the data manager
Using the right mouse button to access menus is usually the most effective means of accessing features
or commands. Figure 10.2.2 shows an Illustration of a context-sensitive right mouse button menu.
The symbolic tree representation of the complete database shown in the database window may not
show all parts of the database. The user settings offer options for displaying hidden folders, or for
displaying parts that represent complete stations. Set these options as required (Section 10.2.5: Data
Manager Settings).
Note: It is useful to keep in mind that object folders, such as the grid ( ) folder are merely common
folders , that have been designated to contain particular classes of objects.
10.2.1 Navigating the Database Tree
There are several ways to walk up and down the database tree:
Use the mouse: all folders that have a + sign next to them may be expanded by double-clicking
on the folder, or by single clicking the + sign.
Use the keyboard: the arrow keys are used to walk up and down the tree and to open or close
folders (left and right arrows). The Page Up and Page Down keys jump up and down the tree in
big steps and the - and + keys may also be used to open or close folders.
Use the toolbar in combination with the browser window. Double-click objects (see c in Fig-
ure 10.2.1) in the browser to open the corresponding object. This could result in opening a folder,
in the case of a common or case folder, or editing the object dialogue for an object. Once again,
the action resulting from your input depends on where the input has occurred (left or right side of
the data manager).
DIgSILENT PowerFactory 15, User Manual 119
CHAPTER 10. DATA MANAGER
The buttons Up Level ( ) and Down Level ( ) on the data manager tool bar can be used to
move up and down the database tree.
10.2.2 Adding New Items
Generally, new network components are added to the database via the graphical user interface (see
Section 9.2: Dening Network Models with the Graphical Editor), such as when a line is drawn between
two nodes creating, not only the graphical object on the graphics board, but also the corresponding
element data in the relevant grid folder. However, users may also create new objects manually in the
database, from the data manager.
Certain new folders and objects may be created by right-clicking on folders in the data manager. A
context sensitive menu is presented, offering a choice of objects to be created that will t the selected
folder. For example, right-clicking a grid folder will allow the creation (under the New menu) of a Graphic,
a Branch, a Substation, a Site or a Folder object. The new object will be created in the folder that was
selected prior to the new object button being pressed. This folder is said to have the focus for the
commanded action. This means that some objects may not be possible to create since the focused
folder may not be suited to hold that object.
For instance: A synchronous machine should not go into a line folder. A line folder should contain
only line routes, line sections and cubicles. The cubicles in their turn should contain only switches or
protection elements.
To access the whole range of objects that may be created, the icon must be pressed (new object
icon). This is found the data manager toolbar and presents the dialogue shown in Figure 10.2.3.
To simplify the selection of the new objects, a lter is used to sort the object list. This lter determines
what sort of list will appear in the drop-down list of the Element eld. If Branch Net Elements is rst
selected, the selection of, for instance, a 2-winding transformer is accomplished by then scrolling down
the element list.
The Element eld is a normal edit eld. It is therefore possible to type the identity name of the new
element, like ElmTr3 for a three-winding transformer, or TypLne for a line type directly into the eld.
The possible list of new objects is therefore context sensitive and depends on the type or class of the
originally selected folder.
120 DIgSILENT PowerFactory 15, User Manual
10.2. USING THE DATA MANAGER
Figure 10.2.3: The element selection dialogue
After the selection for a new object has been conrmed, the Element Selection dialogue will close, the
new object will be inserted into the database and the edit dialogue for the new object will pop up. If
this dialogue is closed by pressing the Cancel button, the whole action of inserting the new object will
be cancelled: the newly created object will be deleted from the active folder. The dialogue for the new
object may now be edited and the OK button pressed to save the object to the database.
As any other object, folders can be created either by using the context sensitive menu or by using the
icon. Common folders (IntFolder objects) may have an owner name entered, for documentation or
organizational purposes. In this way it should be clear who has created the data. Descriptions may also
be added. An existing folder may be edited by using the Edit icon on the toolbar or by using the right
mouse button.
Each folder may be set to be read-only, or to be a PowerFactory system folder. The folder may be
a Common or Library folder. These attributes can be changed in the edit-folder dialogue. These
settings have the following meaning:
Common folders are used for storing non-type objects: electric elements, command objects, set-
tings, projects, etc.
Type folders are used as libraries for type objects.
System folders, which are read only folders
The use of read-only folders is clear: they protect the data. In addition, folders containing data that is
not normally accessed may be hidden. Selecting the kind of folders that the user/administrator wants to
be hidden is done in the user settings dialogue see Chapter 7 (User Settings).
10.2.3 Deleting an Item
A folder or object which is selected may be deleted by pressing the Delete key on the keyboard, or by
clicking the icon on the toolbar of the database manager.
DIgSILENT PowerFactory 15, User Manual 121
CHAPTER 10. DATA MANAGER
Because most power system objects that are stored in the database are interconnected through a
network topology or through type-element relationships, deleting objects often causes anomalies in the
database consistency. Of course, PowerFactory knows at any moment which objects are used by which
others and could prevent the user from creating an inconsistency by refusing to delete an object that is
used by others. This, however, would create a very stubborn program.
PowerFactory solves this problem by using a Recycle Bin folder. All deleted objects are in fact moved to
the recycle bin. All references to the deleted objects will therefore stay valid (for example, the reference
between element and type), but will show that the referenced object has been deleted by:
Showing the path to the recycle bin and the name of the recycle object in stead of the original
location and name.
Colouring: a reference to a deleted object will be coloured red, i.e. a reference to a type. Type
references are found in the edit dialogues of all elements which use a type like the line or the
transformer object.
An object that has been deleted by mistake can be restored to the original location by selecting the
restore menu option on the recycle objects context sensitive menu. All references to the object will also
be restored.
10.2.4 Cut, Copy, Paste and Move Objects
Cut, Copy and Paste
Cutting, copying and pasting may be achieved in four different manners:
1. By using the data manager tool bar buttons.
2. By using the normal MS Windows shortcuts:
Ctrl-X will cut a selection,
Ctrl-C will copy it,
Ctrl-V will paste the selection to the active folder.
Cutting a selection will colour the item-icons gray. The cut objects will remain in their current folder
until they are pasted. A cut-and-paste is exactly the same as moving the object, using the context
sensitive menu. All references to objects that are being moved will be updated. Cancelling a
cut-and-paste operation is performed by pressing the Ctrl-C key after the Ctrl-X key has been
pressed.
3. By using the context sensitive menu. This menu offers a Cut, a Copy and a Move item. The move
item will pop up a small second database tree in which the target folder can be selected. When
the selected objects have been Cut or Copied, the context sensitive menu will then show a Paste,
Paste Shortcut and a Paste Data item.
Paste will paste the selection to the focused folder.
Paste Shortcut will not paste the copied objects, but will create shortcuts to these objects. A
shortcut object acts like a normal object. Changes made to the shortcut object will change the
original object. All other shortcuts to this original object will reect these changes immediately
Paste Data is only be available when just one object is copied, and when the selected target
object is the same kind of object as the copied one. In that case, Paste Data will paste all
data from the copied object into the target object. This will make the two objects identical,
except for the name and the connections.
122 DIgSILENT PowerFactory 15, User Manual
10.2. USING THE DATA MANAGER
4. By dragging selected objects to another folder. The Drag & Drop option must be enabled rst
by double-clicking the Drag & Drop: off message on the data managers message bar. When
the Drag & Drop option is on, it is possible to copy or move single objects by selecting them and
dragging them to another folder. Dragging is done by holding down the left mouse button after an
object has been selected and keeping it down while moving the cursor to the target/destination
folder, either in the database tree or in the database browser window.
Note: When dragging and dropping a COPY of the object will be made (instead of moving it) if the Ctrl
key is held down when releasing the mouse button at the destination folder. To enable the Drag
& Drop option double click the Drag & Drop message at the bottom of the Data Manager window.
10.2.5 The Data Manager Message Bar
The message bar shows the current status and settings of the database manager. Some of the mes-
sages are in fact buttons which may be clicked to change the settings.
The message bar contains the following messages.
Pause: on/off (only in case of an opened input window) shows the status of the message queue
in the input window. With pause on, the command interpreter is waiting which makes it possible
to create a command queue. The message is a button: double-clicking it will toggle the setting.
N object(s) of M shows the number of elements shown in the browser window and the total
number of elements in the current folder.
N object(s) Selected: shows the number of currently selected objects.
Drag & Drop: on/off shows the current drag & drop mode. Double clicking this message will
toggle the setting.
10.2.6 Additional Features
Most of the data manager functionality is available through the context sensitive menus (right mouse
button).
The following items can also be found in the context sensitive menus:
Show Reference List (Output... Reference List) Produces the list of objects that have links, or
references (plus the location of the linked object), to the selected object. The list is printed to the
output window. In this manner for example, a list of elements that all use the same type can be
produced. The listed object names can be double- or right-clicked in the output window to open
their edit dialogue.
Select All Selects all objects in the database browser.
Mark in Graphic Marks the highlighted object(s) in the single line graphic. This feature can be used to
identify an object.
Show Station Opens a detailed graphic (displaying all the connections and switches) of the terminal
to which the selected component is connected. If the component, is connected to more than one
terminal, as might be in the case of lines or other objects, a list of possible terminals is shown rst.
Goto Busbar Opens the folder in the database browser that holds the busbar to which the currently
selected element is connected. If the element is connected to more than one busbar, a list of
possible busbars is shown rst.
DIgSILENT PowerFactory 15, User Manual 123
CHAPTER 10. DATA MANAGER
Goto Connected Element Opens the folder in the database browser that holds the element that is
connected to the currently selected element. In the case of more than one connected element,
which is normally the case for busbars, a list of connected elements is shown rst.
Calculate Opens a second menu with several calculations which can be started, based on the currently
selected objects. A short-circuit calculation, for example, will be performed with faults positioned
at the selected objects, if possible. If more than one possible fault location exists for the currently
selected object, which is normally the case for station folders, a short-circuit calculation for all
possible fault locations is made.
Other useful features:
Relevant objects for calculations are tagged with a check-mark sign (this will only be shown fol-
lowing a calculation). Editing one of these objects will reset the calculation results.
10.3 Dening Network Models with the Data Manager
In this section it is explained how the tools of Data Manager are used to dene network models.
10.3.1 Dening New Network Components in the Data Manager
New network components can be directly created in the Data Manager. To do this you have to click
on the target grid/expansion stage (right pane) to display its contents in the browser (left pane). Then
you have to click on the New Object icon and select the kind of object to create. Alternatively you can
directly enter the class name of the new component.
10.3.2 Connecting Network Components in the Data Manager
To connect newly created branch elements to a node, a free cubicle must exist in the target terminal. In
the Terminal eld (Terminal I and Terminal j for two port elements, etc.) of the edge element you have
to click on the ( ) arrow to select (in the data browser that pops up) the cubicle where the connection
is going to take place.
To create a new cubicle in a terminal you have to open its edit dialogue (double click) and press the
Cubicles button (located at the right of the dialogue). A new browser with the existing cubicles will
pop up, press the New Object icon and in the Element eld select Cubicle (StaCubic). The edit
dialogue of the new cubicle will pop up; by default no internal switches will be generated. If you want
a connection between the edge element and the terminal trough a circuit breaker, you have to press
the Add Breaker button. After pressing the Ok button the new cubicle will be available to connect new
branch elements.
Note: New users are recommended to create and connect elements directly from the single line graph-
ics. The procedures described above are intended for advanced users.
10.3.3 Dening Substations in the Data Manager
The concept and the application context of substations is presented in Section 4.7 (Project Structure).
A description of the procedure used to dene new substations with the data manager is given as fol-
lows. For information about working with substations in the graphical editor please refer to Section 9.2
(Dening Network Models with the Graphical Editor).
124 DIgSILENT PowerFactory 15, User Manual
10.3. DEFINING NETWORK MODELS WITH THE DATA MANAGER
To dene a new substation from the Data Manager do the following:
Display the content of the grid where you want to create the new substation.
Right click on the right pane of the Data Manager and select New Substation from the context
sensitive menu.
The new substation edit dialogue will pop up. There you can change the name, assign running
arrangements and visualize/edit the content of the substation (directly after creation it is empty).
After pressing Ok the new substation and an associated diagram (with the same name of the
substation) will be created.
The components of the new substation can be created and connected using the associated single line
diagram or using the data manager, the rst option is recommended. For the second option, a data
browser with the content of the substation will pop up after pressing the Contents button; there you can
use the New Object icon to create the new components.
Components of a substation can of course be connected with components of the corresponding grid or
even with components of other networks. The connection in the Data Manager is carried out following
the same procedure discussed in the previous section.
For information about working with substations in the graphical editor please refer to Section 9.2 (Den-
ing Network Models with the Graphical Editor). For information about the denition of Running Arrange-
ments please refer to Section 12.3.6 (Running Arrangements).
10.3.4 Dening Composite Branches in the Data Manager
The concept and the application context of composite branches is discussed in Section 4.7 (Project
Structure), and a description of how to dene branches from within the diagram is provided in Sec-
tion 9.2 (Dening Network Models with the Graphical Editor). This section provides a description of the
procedure used to dene new branches from within the Data Manager.
Branches can be dened in the Data Manager as follows:
1. To create a Branch template, navigate to the Library Templates folder in the Data Manager.
2. Right-click on the right pane of the Data Manager and select New Branch from the context
sensitive menu.
3. In the branch edit dialogue, dene the name of the branch and press Ok.
4. Now navigate back to the branch edit dialogue (right-click and edit, or double click), and select
Contents to add terminal and line elements etc. to the template as required. The internal ele-
ments can be connected as discussed in Section 10.3.2.
5. Use the elds Connection 1 and Connection 2 to dene how the branch is to be connected to
external elements.
6. To create an instance of the Branch from the created Branch template, either:
Select the Composite Branch icon and connect the branch to existing terminals on the
Single Line Diagram.
Select the Composite Branch icon and place the branch on the single line diagram, press
Tab twice to place the branch without making any connections. Then connect the branch to
external elements by right-clicking and selecting Connect, or double-clicking the branch and
selecting external connections for the relevant internal elements (e.g. lines). Select Update
on in the Branch dialogue to update the external connections.
Alternatively, for a single Branch (i.e. not using Templates) the branch can be dened in the grid folder.
DIgSILENT PowerFactory 15, User Manual 125
CHAPTER 10. DATA MANAGER
10.3.5 Dening Sites in the Data Manager
The concept and the application context of sites are presented in the Section 4.7 (Project Structure).
Next a description of the procedure used to dene new sites is given.
To dene a new site from the Data Manager do the following:
Display the content of the grid where you want to create the new site.
Right click on the right pane of the Data Manager and select New Site from the context sensitive
menu.
The new Site edit dialogue will pop up.
After pressing Ok the new site will be created.
Note: Advanced users would notice that it is possible to move objects from a grid to a Substation,
Branch, Site, etc. and vice versa.
10.3.6 Editing Network Components using the Data Manager
Each component can be individually edited by double clicking on it to open the corresponding dia-
logue. The class dialogue is composed of several tabs each corresponding to a calculation function
of PowerFactory. The parameters required by a determined calculation are always available on the
corresponding tab. The description of the network components models, explaining the relations among
the input parameters is given in the technical reference papers attached to the Appendix C (Technical
References of Models).
It is possible to simultaneously edit components of the same class using the Data Manager. To do this
you have to select a component of the class that you want to edit (left click on the component icon) and
click on the Detail Mode icon at the upper part of the Data Manager.
In detail mode, the browser shows all data elds for the selected calculation function data set, which
can be selected by clicking on a tab shown at the bottom of the table view. If a page tab is out of reach,
then the page tab scrollers will bring it within the browser window again.
The list of objects may be sorted by any column by pressing the title eld button. The widths of the data
elds can be adjusted by pointing the mouse on the separation line between two title elds and dragging
the eld border by holding a mouse button down. The data elds can be edited by double-clicking them.
As with any Spread Sheet, you can copy and paste individual or multiple cells with Crtl C and Crtl V or
with right click Copy/Paste.
It is also possible to change a parameter eld for more than one object simultaneously. The parameter
elds which are going to be changed have to be multi-selected rst, then you have to right-click the
selection and select the option Modify Value(s) from the context sensitive menu. This will open the
SetValue dialogue. This dialogue can be used to:
Increase or decrease them by multiplication with a scale factor (Relative).
Increase or decrease them by multiplication with a scale factor with respect to the sum of values
selected (Relative to Sum).
Set all the selected parameter elds to a new xed (absolute) value.
Note: It is not possible to simultaneously alter parameter elds from more than one column, i.e. to
change nominal currents and nominal frequencies simultaneous, even if they would happen to
take the same value or would have to be raised with the same percentage.
126 DIgSILENT PowerFactory 15, User Manual
10.4. SEARCHING FOR OBJECTS IN THE DATA MANAGER
For further information please refer to 10.5 (Editing Data Objects in the Data Manager).
10.4 Searching for Objects in the Data Manager
There are three main methods of searching for objects in the data base: Sorting, searching by name
and ltering.
10.4.1 Sorting Objects
Objects can be sorted according to various criteria, such as object class, name, rated voltage,..., etc.
Sorting according to object class is done using the Edit Relevant Objects for Calculation icon on the
toolbar ( ). The user may select a particular class of calculation-relevant object (e.g. synchronous
machine, terminal, general load, but not graphics, user settings etc.) to be displayed in a browser.
Further sorting can be done according to the data listed in a table- either in the data manager or in a
browser obtained using the procedure described above. This is done by clicking on the column title. For
example, clicking on the column title Name in a data browser sorts the data alphanumerically (A-Z and
1-9). Pressing it again sorts the data Z-A, and 9-1.
Tabulated data can be sorted by multiple criteria. This is done by clicking on various column titles in a
sequence. For example, terminals can be sorted alphanumerically rst by name, then by rated voltage
and nally by actual voltage by pressing on the titles corresponding to these properties in reverse-
sequence (actual voltagerated voltagename). A more detailed example follows:
Suppose that you have executed a load ow calculation and that, for each rated voltage level in the
network, you want to nd the terminal with the highest voltage. These terminals could be identied
easily in a table of terminals, sorted rst by rated voltage and then by calculated voltage. Proceed as
follows:
Perform the load ow calculation.
Select the ElmTerm from the Edit Relevant Object for Calculation dialogue .
Include, in the Flexible Data page tab, the terminal voltage and nominal voltage (see 10.6).
In the table (Flexible Data page tab), click on the title u, Magnitude p.u to sort all terminals from
highest to lowest calculated voltage.
Then click on the title Nom.L-L Volt kV to sort by nominal voltage level.
Now you will have all terminals rst sorted by voltage level and then by rated terminal voltage.
10.4.2 Searching by Name
Searching for an object by name is done either in the right-hand pane of the data manager or in a data
browser. To understand the procedure below, notice that the rst column contains the symbols of the
objects in the table. Clicking on such a symbol selects all columns of that row, i.e. for that object. The
procedure is as follows:
Select an object in the table by clicking on any object symbol in the table (if one object was already
selected then select a different one).
Now start typing the object name, which is case sensitive. Notice how the selection jumps as you
type, For example, typing T moves the selection to the rst object whose name starts with T, etc.
Continue typing until the selection matches the object that you are looking for
DIgSILENT PowerFactory 15, User Manual 127
CHAPTER 10. DATA MANAGER
10.4.3 Using Filters for Search
Advanced ltering capability is provided with the Find function . A lter is normally dened to nd a
group of objects, rather than individual objects (although the latter is also possible). Advanced search
criteria can be dened, e.g. transmission lines with a length in the range 1km to 2.2km, or synchronous
machines with a rating greater than 500MW etc.
The function is available in both the data manager and a data browser. Clicking on Find in the data
manager allows the user to apply a predened lter or to dene a new lter, called General lter. If a
new lter is dened, the database folder that will be searched can be dened. Clicking on Find in a
data browser allows the user to dene a General Filter for objects within the browser.
General Filters dened by the user are objects stored in the Changed Settings \ Filters folder.
The options in the General Filter dialogue window are now explained with reference to Figure 10.4.1:
Name: Name of lter.
Object lter: This eld denes either the complete or a part of the search criteria, and is optional.
Examples are as follows:
*.ElmSym: Include element objects of the class synchronous machines.
*.TypSym: Include type objects of the class synchronous machines.
Lahney.*: Include all objects with the name Lahney.
Lahney.Elm*: Include all element objects with the name Lahney.
D*.ElmLod: Include all load element objects whose names start with D.
A drop down list providing various object classes can be accessed with .
Look in: This eld is available if a lter id dened within the data manager. It allows the user to specify
the folder in the database that will be searched.
Check boxes:
Include Subfolders will search the root folder specied as well as the subfolders in the root
folder. The search can be stopped at the matching folder.
Relevant Objects for Calculation will include only those objects considered by the active
study case (if no study case is active the search is meaningless and no search results will be
returned).
Area Interconnecting Branches will search for branch elements that interconnect grids.
Figure 10.4.1: General Filter dialogue
128 DIgSILENT PowerFactory 15, User Manual
10.4. SEARCHING FOR OBJECTS IN THE DATA MANAGER
The OK button will close the search dialogue, but save the lter object to the Changed Settings\Filters
folder. This makes it available for further use. The CANCEL button will close the dialogue without saving
the changes. This button is useful if a search criterion (lter) will only be used once.The APPLY button
starts the actual search. It will scan the relevant folders and will build a list of all objects that match the
search criteria.
Once the search is complete a list of results is returned in the form of a new data browser window. From
this browser, the returned objects can be marked, changed, deleted, copied, moved, etc. . . .
Advanced search options allow more sophisticated expressions as search criteria. These are specied
in the Advanced page of the General Filter dialogue (Figure 10.4.2). The lter criterion is dened in
terms of a logical expression, making use of parameter names. Objects will be included in the data
browser if, for their parameters, the logical expression is determined to be true. An example of a logical
expression is dline >0.7. The variable dline refers to the length of a transmission line, and the effect of
such a lter criterion is to limit the data in the browser to transmission lines having a length exceeding 0.7
km. The logical expressions can be expanded to include other relations (e.g. >=), standard functions
(e.g. sin()), and logical operators (e.g. .and.).
Note: Parameter names can be object properties or results. The parameter names for object proper-
ties are found, for example, by letting the mouse pointer hover over an input eld in an objects
dialogue window. Parameter names for result variables are found from variable sets, which are
described in Section 17.4 (Variable Sets).
Figure 10.4.2: Filter dialogue - Advanced
Search Literally is used to search for user dened strings inside parameter elds. For example,
perhaps the comment damaged but serviceable has been entered for some elements in the network.
This may be searched for as shown in Figure 10.4.3. All parameter elds will be searched for this string.
DIgSILENT PowerFactory 15, User Manual 129
CHAPTER 10. DATA MANAGER
Figure 10.4.3: Searching literally
As stated before, the objects matching the lter criteria are displayed in a data browser. They may also
be highlighted in the graphic using the Color representation function described in Chapter 9: Network
Graphics (Single Line Diagrams). The colour to be used in this case can be specied under the page
Graphic of the General Filter dialogue window.
Note: New a lters are saved to the Project\Changed Settings\Filters folder in the project and are
available for use directly, using the right mouse menu. If a search is to be performed in a particu-
lar grid simply proceed as follows: right-click the grid folder FindLocal FiltersFilter Name
(e.g. Lines longer than 700m). Remember to press the Apply button to perform the search. If you
unchecked the Show Filter Settings before Application box under User Settings General then
the lter will be applied as soon as it is selected from the menu. This is useful when you have
already dened several lters for regular use.
10.5 Editing Data Objects in the Data Manager
The database manager (or Data Manager) offers several ways to edit power system components and
other objects stored in the database, regardless they appear graphically or not.
The basic method is to double-click the object icons in the database browser. This will open the same
edit dialogue window obtained, when double clicking the graphical representation of an element in the
graphic window.
130 DIgSILENT PowerFactory 15, User Manual
10.5. EDITING DATA OBJECTS IN THE DATA MANAGER
Figure 10.5.1: Full size edit window appearing after double-clicking the object icon in the data manager
An open edit dialogue will disable the data manager windowfromwhich it was opened. The edit dialogue
has to be closed rst in order to open another edit dialogue.
However, it is possible to activate more than one data manager (by pressing the icon on the main
toolbar) and to open an edit dialogue from each of these data managers. This can be useful for com-
paring objects and parameters.
Using the edit dialogues (Figure 10.5.1) has one major drawback: it separates the edited object from
the rest of the database, making it impossible to copy data from one object to the other, or to look at
other object parameter values while editing.
PowerFactory brings the big picture back in sight by offering full scale editing capabilities in the data
managers browser window itself. The browser window in fact acts like a spreadsheet, where the user
can edit and browse the data at the same time. The browser window has two modes in which objects
can be edited,
Object mode
Detail Mode
which are described in the following sections.
10.5.1 Editing in Object Mode
In the general case the icon, the name, the type and the modication date (with its author) of the objects
are shown in the object mode (see Figure 10.5.2). Certain objects, for example network components,
show additional elds like the Out of Service eld.
DIgSILENT PowerFactory 15, User Manual 131
CHAPTER 10. DATA MANAGER
Figure 10.5.2: The browser window in object mode
The title buttons are used to sort the entries in the browser. The visible data elds can be double-clicked
to edit their contents, or the F2 button can be pressed. The object will show a triangle in its icon when
it is being edited.
After the data eld has been changed, move to the other elds of the same object using the arrow-keys
or by clicking on these data elds, and alter them too.
The new contents of a data eld are conrmed by pressing the Return key, or by moving to another
eld within the same object. The triangle in the icon will change to a small star to show that the object
has been altered. The object itself however has not been updated. Updating the changes is done by
pressing Return again, or by moving to another object in the browser. By default, PowerFactory will
ask to conrm the changes. See Section 10.2.5 (Data Manager Settings) to disable these conformation
messages.
10.5.2 Editing in Detail Mode
If the icon on the browse window of the data manager is pressed, the browser changes to detail
mode (see Figure 10.5.3). It will display only the objects from the same class as the one which was
selected when the button was pressed. In the example of Figure 10.5.3, this is a load object (ElmLod).
The icon or a lter (10.4.3) may also be used to engage detail mode.
Figure 10.5.3: The browser window in detail mode
132 DIgSILENT PowerFactory 15, User Manual
10.5. EDITING DATA OBJECTS IN THE DATA MANAGER
In detail mode, the browser shows all data elds for the selected calculation function data set, which
can be selected by clicking on a tab shown at the bottom of the table view.If a page tab is out of reach,
then the page tab scrollers will bring it within the browser window again.
The list of objects may be sorted by any column by pressing the title eld button. The widths of the
data elds can be adjusted by pointing the mouse on the separation line between two title elds and
dragging the eld border by holding a mouse button down.
As with the browser in object mode, the data elds can be edited by double-clicking them. In the
example the active power settings are being edited, but from the star in the object icon it is clear
that another eld of the same object has been edited too, but not conrmed, because this star would
otherwise be a triangle.
It is possible to change a parameter eld for more than one object simultaneously. This is, for instance,
useful to raise a certain limit for a range of objects, in order to get a better load-ow result i.e. by
alleviating line overloads. An example is shown in Figure 10.5.4 where the nominal current for a range
of lines is changed at once.
Figure 10.5.4: Modify values dialogue
Figure 10.5.5: Modify values dialogue
The parameter elds which have to be changed have to be multi-selected rst. Right-clicking the se-
lection will pop up a case sensitive menu from which the Modify Value(s) option opens the SetValue
dialogue, see Figure 10.5.5.
This dialogue can be used to:
DIgSILENT PowerFactory 15, User Manual 133
CHAPTER 10. DATA MANAGER
increase or decrease them by multiplication with a scale factor (Relative).
increase or decrease them by multiplication with a scale factor with respect to the sum of values
selected (Relative to Sum).
Set all the selected parameter elds to a new xed (absolute) value.
It is not possible to simultaneously alter parameter elds from more than one column, i.e. to change
nominal currents and nominal frequencies simultaneous, even if they would happen to take the same
value or would have to be raised with the same percentage.
10.5.3 Copy and Paste while Editing
One of the great advantages of editing data elds in the data managers browser windowis the possibility
to copy data from one object to another. This is done by selecting one or more objects or object elds,
copying this selection to the clipboard, and pasting the data back in another place.
To copy one or more objects,
1. Open the Data Manager and select the grid folder where you nd the objects to be copied. Please
do not open the icon for the Objects relevant for the calculation , as this is a lter view collecting
objects stored at various locations.
2. Select them (see Figure 10.5.6).
3. Press Ctrl-C to copy or use the icon on the data manager toolbox.
4. Press Ctrl-V to paste or use the icon on the data manager toolbox. The objects will be copied
with all the data. Their names will automatically be altered to unique names (see Figure 10.5.7).
Figure 10.5.6: Copying an object in the browser
Figure 10.5.7: Modify values dialogue
Copying data elds from one object to another is done just like for any spreadsheet software you may
be familiar with. To copy one or more data elds,
1. Select them by clicking them once. Select more data elds by holding down the Ctrl key.
2. Copy the elds to the clipboard by pressing Ctrl-C or the icon.
3. Select one or more target objects data elds. If more than one eld was copied, make sure that
the target eld is the same as the rst copied data eld.
4. Press Ctrl-V or the icon. The contents of the data elds will be copied to the target objects.
134 DIgSILENT PowerFactory 15, User Manual
10.6. THE FLEXIBLE DATA PAGE TAB IN THE DATA MANAGER
10.6 The Flexible Data Page Tab in the Data Manager
The data browser (this will be seen in the data manager when the Detail Mode has been engaged) has
page tabs for all calculation functions. These tabs are used to view or edit object parameters which are
categorized according to a calculation function and have a xed format.
The Flexible Data tab, normally used to display calculation results, allows the user to dene a custom
set of data to be displayed.
The default format for the calculation results displayed in the exible page depends on the calculation
performed: Following a load-ow calculation, the default variables for terminals are line-to-line voltage,
per unit voltage and voltage angle. Following a short-circuit calculation the default variables are initial
short-circuit current, initial short-circuit power, peak current etc. Figure 10.6.1 shows an example of the
exible data page tab.
Figure 10.6.1: The Flexible Data page tab
10.6.1 Customizing the Flexible Data Page
The displayed variables are organized in Variables Sets that are, in turn, organized according to the
calculation functions. For example, an object class ElmTr2 (two-winding transformer) has a variable set
for symmetrical load ow calculation, a variable set for short-circuit calculation etc. There may also be
more than one variable set for any calculation function. For example, the object ElmTr2 may have two
variable sets for symmetrical load ow calculation.
The Flexible Page Selector allows the user to specify the variable set to use, or to dene new variable
sets. Furthermore, the Flexible Page Selector allows the user to access and edit the variable sets, i.e.
to specify which variables to display in the Flexible Data page.
The Flexible Page Selector dialogue is shown in Figure 10.6.2. This dialogue is opened by pressing
the ( ) icon on the data manager toolbar. The Flexible Page Selector has a menu with all the different
calculation functions. It opens in the page corresponding to the most recent calculation.
The selection of variables within Variable Sets is presented in detail in Section 17.4 (Variable Sets).
DIgSILENT PowerFactory 15, User Manual 135
CHAPTER 10. DATA MANAGER
Figure 10.6.2: The Flexible Page Selector
The Format/Header tab (Figure 10.6.3) allows the user to customize the header of the Flexible Data
page.
Figure 10.6.3: The Flexible Page Selector
136 DIgSILENT PowerFactory 15, User Manual
10.7. THE INPUT WINDOW IN THE DATA MANAGER
Note: Variable Sets are objects of class IntMon, within PowerFactory they have multiple uses. This
section only presents their use in conjunction with Flexible Data. For further information please
refer to Section 17.4 (Variable Sets).
The number format per column in the Flexible Data Page can also be modied by right clicking on
the column header of the variable and selecting Edit Number Format . . . . A new window showed in
gure 10.6.4 will appear and the user may dene the number representation.
Figure 10.6.4: Number Format
10.7 The Input Window in the Data Manager
The input window is for the more experienced users of DIgSILENT PowerFactory . It is closed by default.
Almost all commands that are available in PowerFactory through the menu bars, pop-up menus, icons,
buttons, etc., may also be entered directly into the input window, using the PowerFactory commands.
The contents of the input window can be saved to le, and commands can be read back into the window
for execution.
PowerFactory also has special command objects which carry one single command line and which are
normally used to execute commands. In this way, complex commands can be saved in the same folder
as the power system for which they were congured.
10.7.1 Input Window Commands
In principle, everything that can be done in DIgSILENT PowerFactory , can be done from the command
line in the input window. This includes creating objects, setting parameters, performing load-ow or
short-circuit calculations.
Some commands that are available are typically meant for command line use or for batch commands.
These commands are rarely used in another context and are therefore listed here as command line
commands, although they do not principally differ from any other command.
Cd Command Moves around in the database tree by opening another folder at a relative position
from the currently open folder.
Example:
cd...\gridB\Load1
Cl Command Stops the redirection of the output window to either a le or to a printer. All following
DIgSILENT PowerFactory 15, User Manual 137
CHAPTER 10. DATA MANAGER
messages will again be shown only in the output window.
cl/out stops redirection to a le cl/prn stops redirection to a printer
Cls Command Clears the output or input window.
cls/out clears output window
cls/inp clears input window completely
cls/inp/done clears only previously executed commands
.../y asks for conrmation
Dir Command Displays the contents of a folder.
Example:
dir Study Case
Ed Command Pops up the dialogue of a default command, i.e. ldf, shc, etc.
Example:
ed ldf
Exit Command Queries or sets a variable.
Example:
man/set obj=Load 1.elmlod variable=plini value=0.2
Op CommandC Redirects output to either a le or a printer.
Example:
op/out f=train3.out
Pause Command Interrupts the execution of the command pipe until a next pause command is
executed.
Pr Command Prints either the contents of the output window or the currently active graphics
window.
Rd Command Opens and reads a le.
Stop Command Stops the running calculation.
Wr Command Writes to a le.
10.8 Save and Restore Parts of the Database
A selected part of the database can be written to a DZ Import/Export le with the button Export Data...
. This will bring a File Save dialogue where a lename must be specied.
Alternatively, the folder or object that is to be exported can be right-clicked in the database tree, after
which the option Export... is selected.
The exported part of the database may be a complete project, a library, or a specic object in the
browser window. Exporting a folder (i.e a project, grid, library, etc.) will export the complete content of
that folder, inclusive subfolders, models, settings, single line graphics, etc.
It is even possible to export a complete user account. However, only the administrator is able to import
an user-account. Exporting the user-account on a regular basis is a practical way to backup your data.
It is even possible to export data from another user account, or even to export another user-account
completely. However, only the shared, visible, data will be exported.
The exported data le can be imported into the database again in any desired folder by pressing the
Import Data... button. This will bring a File Open dialogue where the DZ data-le can be selected.
138 DIgSILENT PowerFactory 15, User Manual
10.9. SPREADSHEET FORMAT DATA IMPORT/EXPORT
The DZ-le will be analyzed and error messages will be displayed when the le is not a genuine
PowerFactory data le, or if it is corrupted. If the le format has been found to be correct, a dialogue will
appear which shows the data and version of the le. The default target folder is shown also, which is the
original folder of the saved data. If this is not desired, another target folder can be selected by pressing
the Drop Down button. This button will bring a small version of the database tree. A new target folder
can be selected from this tree.
10.8.1 Notes
By exporting a folder from the database, only the information in that folder and all its subfolders will be
stored. If the exported objects use information (e.g. power system types like line or transformer types)
that is saved somewhere else, then that information will not be stored. Make sure that the used power
system types and all other referenced information is exported too.
When importing a le that contains objects which use data outside the import-le, a search for that data
is started.
For instance, assume a project is exported. One of the line-models uses a type from a library outside
the project. When exporting, the path and name of this type is written in the export-le, but the type
itself is not exported, as is does not reside in the exported project.
At importing, the stored path and name of the external type is used to nd the type again and to
restore the link. However, if the external type is not found, then it will be created, using the stored
path and name. Of course, the created object has default data, as the original data was not exported.
Additionally, an error message is written to the output window.
Suppose that you are working with a large library, which is stored in a special user-account to make it
read-only. The library is made accessible by sharing it to all users.
When export the projects, the objects from the external library are not exported. However, a colleague
which has access to the same library may still import your projects without problems. The external
objects used in your projects will be found in the same location, and the links to these objects will be
correctly restored.
10.9 Spreadsheet Format Data Import/Export
The PowerFactory data browser in the data managers window looks and acts like a spreadsheet pro-
gram as far as creating and editing power system objects is concerned. To enable and simplify the use
of power system element data which is stored in spreadsheet programs such as the Microsoft Excel or
the Lotus 123 programs, the data browser offers Spreadsheet Format import and export facilities.
10.9.1 Export to Spreadsheet Programs (e. g. MS EXCEL)
All data visible in the data browser may be exported as it is. The export format is such that most
common spreadsheet programs can read in the data directly (space separated ASCII). Exporting data
is performed as follows.
Select a range of data in the data browser. Such a range may contain more than one column and
more than one row.
Right-click the selected range.
Now you have different options:
DIgSILENT PowerFactory 15, User Manual 139
CHAPTER 10. DATA MANAGER
If you want to copy the content of the marked cells only, simply select Copy from the context-
sensitive menu.
If you want to copy the content of the marked cells together with a description header, select
the Spread Sheet Format option. This opens a second menu which offers the choice between
writing the Spreadsheet export to a le (Write to File), or to put it on the Windows Clipboard
(Copy (with column headers)). See Figure 10.9.1.
The exported data can now be imported into a Spreadsheet program. When the Clipboard was
used, using the Paste option of the spreadsheet program or pressing Ctrl-V will Paste the data
into the spreadsheet.
The imported data may now be edited, or additional calculations may be made. The PowerFactory
data is imported as numbers and descriptions. The example in Figure 10.9.2 calculates a mean
value from a range of line loading percentages.
Figure 10.9.1: Exporting a range of data
140 DIgSILENT PowerFactory 15, User Manual
10.9. SPREADSHEET FORMAT DATA IMPORT/EXPORT
Figure 10.9.2: Imported data in a spreadsheet program
10.9.2 Import from Spreadsheet Programs (e. g. MS EXCEL)
There are two methods available for importing data from a spreadsheet program. The rst method uses
a direct import of anonymous numerical data, i. e. of the values stored in the cells of the table. This
method is used to change parameter of existing objects by importing columns of parameter values.
The second method can be used to create new objects (or replace whole objects) by importing all the
data from a spreadsheet.
Any range of parameter values can be copied from a spreadsheet program and imported into the
database manager. The import is performed by overwriting existing parameter values by anonymous
values. The term anonymous expresses the fact that the imported data has no parameter description.
The size of the imported value range and the required data are tested. Importing invalid values (i.e. a
power factor of 1.56) will result in an error message.
Spreadsheet Import of Values
The import of values (anonymous variables), i. e. cells of a table, is explained by the following example.
In Figure 10.9.3, a range of active and reactive power values is copied in a spreadsheet program. In
Figure 10.9.4, this range is pasted to the corresponding elds of 6 load objects by right-clicking the
upper left most eld which is to be overwritten. The result of this action is shown in Figure 10.9.5.
In contrast to the import of whole objects, the anonymous import of data does not need a parameter
description. This would complicate the import of complete objects, as the user would have to enter all
parameters in the correct order.
Figure 10.9.3: Copying a range of spreadsheet data
DIgSILENT PowerFactory 15, User Manual 141
CHAPTER 10. DATA MANAGER
Figure 10.9.4: Pasting spreadsheet data from clipboard
Figure 10.9.5: Database browser with imported data
Spreadsheet Import of Objects and Parameters
With this kind of import, it is possible to import whole objects (in contrast to the import of pure values,
which is described above). The object import uses a header line with the parameter names (which is
necessary in addition to the cells with the pure values). This header must have the following structure:
The rst header must be the class name of the listed objects.
The following headers must state a correct parameter name.
This is shown in Figure 10.9.6.
142 DIgSILENT PowerFactory 15, User Manual
10.9. SPREADSHEET FORMAT DATA IMPORT/EXPORT
Figure 10.9.6: DExcel required format
Figure 10.9.7 shows an example of valid spreadsheet data of some line types and some 2-winding
transformer types.
Figure 10.9.7: Example of valid spreadsheet data
The import of the spreadsheet data into PowerFactory is performed as follows.
Select the header line and one or more objects lines.
Copy the selection. See Figure 10.9.8 for example.
Right-click the folder browser in the database manager to which the objects are to be imported.
Select Spread Sheet Format Import Objects from Clipboard. See Figure 10.9.9 for example.
Figure 10.9.8: Selecting object data in spreadsheet
DIgSILENT PowerFactory 15, User Manual 143
CHAPTER 10. DATA MANAGER
Figure 10.9.9: Importing objects from clipboard
The result of the object import depend on whether or not objects of the imported class and with the
imported names already exist or not in the database folder. In the example of Figure 10.9.10, none of
the imported objects existed in the database an all were created new therefore. The example shows
the database in detail mode.
Figure 10.9.10: Result of spreadsheet object import
Note: New objects are created in the PowerFactory database folder only when no object of the imported
class and with the imported name is found in that folder. If such an object is found then its data
will be overwritten by the imported data
Because new objects are only created when they do not exist already, and only the imported parameters
are overwritten when the object did exists already, the import is always a save action.
Remarks
Object Names
Object names may not contain any of the characters
? = , \ |
144 DIgSILENT PowerFactory 15, User Manual
10.9. SPREADSHEET FORMAT DATA IMPORT/EXPORT
Default Data
When an imported object is created newly, the imported data is used to overwrite the correspond-
ing default data. All parameters that are not imported will keep their default value.
Units
The spreadsheet values are imported without units. No conversion from MW to kW, for exam-
ple, will be possible. All spreadsheet values therefore have to be in the same units as used by
PowerFactory.
DIgSILENT PowerFactory 15, User Manual 145
CHAPTER 10. DATA MANAGER
146 DIgSILENT PowerFactory 15, User Manual
Chapter 11
Study Cases
11.1 Introduction
The concept of Study Cases was introduced in Chapter 4 (PowerFactory Overview). Study Cases
(IntCase, ) dene the studies to be performed in the modelled system. They store all the denitions
created by the user to perform calculations, allowing the easy reproduction of results even after the
deactivation of the project. By means of the objects stored inside them objects the program recognizes:
The parts of the network model (grids and expansion stages) to be consider for calculation.
The calculations (and their settings) to be performed over the selected parts of the network.
The study time.
The active variations.
The active operation scenario.
The calculation results to be stored for reporting.
The graphics to be displayed during the study.
A study case with a reference to at least one grid or expansion stage has to be activated in order to
enable calculations. A project that contains more than one grid, which has several expansion stages for
design alternatives, or which uses different operation scenarios to model the various conditions under
which the system should operate, requires multiple study cases. All the study cases of a project are
stored inside the Study Cases folder ( ) in the project directory.
Note: Only one study case can be active. When activating a study case, all the grids, variations and
operation scenarios that it refers become active.
Without study cases, it would be necessary to manually activate the correct grid and/or expansion stage
over and over again in order to analyze the resulting power system conguration. Similarly, it would be
necessary to dene over and over again the same calculation command setup used to analyze the
behavior of the selected network.
Besides storing the objects that dene a network study, study case objects set the output units for the
performed calculations and allow the denition of certain calculation options for the solving algorithms.
The following sections describe the main objects stored inside the study cases, as mentioned before
they are used to dene the network studies. For information about dening and working with study
cases please refer to Section 11.2 (Creating and Using Study Cases).
DIgSILENT PowerFactory 15, User Manual 147
CHAPTER 11. STUDY CASES
11.2 Creating and Using Study Cases
When a new project is created, a new empty study case is automatically generated and activated. The
new study case is assigned the default settings of PowerFactory. The user can later edit them using the
study case dialogue (Figure 11.5.1).
The user may dene several study cases to facilitate the analysis of projects containing more than one
grid, several expansion stages, different operation scenarios or simply different calculation options. To
create a new study case:
Open the Data Manager and go to the Study Cases folder. Right-click the folder and select New
Study Case from the context sensitive menu. Enter the name of the new case in the dialogue
that pos up (Figure 11.5.1) and edit (if required) the default settings.
Only one study case can be active at any time. To (de)activate a study case:
Open the Data Manager. The active study case and the folder(s) where it is stored are highlighted.
Right-click on the active study case and choose Deactivate from the context sensitive menu. To
activate a dormant study case place the cursor on its name, right-click and choose Activate. Study
cases may also be activated in the Project Overview Window (see Figure 11.2.1).
Figure 11.2.1: Activating a study case from the Project Overview Window
A study case can have more than one grid. Only the objects in the active grids will be regarded in the
calculations. To add an existing grid to the active study case:
Open the data manager and go to the Network Data folder. Right-click the grid you want to add
to your calculation and select Add to Study Case from the context sensitive menu. The grid will
be activated and graphics will be opened (after a selection by the user). To remove an active grid,
select Remove from Study Case.
Variations are considered by a study case when they are activated. The expansion stages are applied
according to the study case time, which is set by the time trigger stored inside the study case folder.
More than one variation can be active for a study case. However there will always be only one recording
stage. For further information, please refer to Chapter 15 (Network Variations and Expansion Stages).
To add (activate) a variation to the active study case:
Right-click on it and select Activate from the context sensitive menu. The variation will be activated
and stages will be highlighted depending on the study time.
An operation scenario can be (de)activated via context menu or using the option File Activate Op-
eration Scenario/ Deactivate Operation Scenario from the main menu. On activation, a completeness
148 DIgSILENT PowerFactory 15, User Manual
11.3. SUMMARY GRID
check is done (check if operational data is available for all components). This is reported in the Pow-
erFactory output window. If an operation scenario is active, all operational data attributes in property
sheets or in data manager are highlighted in a blue colour. This indicates that changes of these values
will not modify the base component (or variation) but are recorded by the active operation scenario.
On deactivation, previous operational data are restored. If the operation scenario was modied, a user
conrmation is requested whether to save the changes or to discard them. For further information about
working with operation scenarios, please refer to Chapter 14 (Operation Scenarios).
Note: Only one study case can be activated at a time. Although network components and diagrams
can be edited without an active study case, calculations can not be performed unless a study case
is activated. Variations and operation scenarios used by a study case are automatically activated
with the corresponding study case.
11.3 Summary Grid
The primary task of a Study Case is to activate and deactivate a calculation target, which is a combi-
nation of grids and optionally expansion stages from the Network Model. The Summary Grid object
holds references to the grids which are considered in the calculation (that is the active grids). Grids may
be added to, or removed from, the study case by right-clicking them in the database tree and selecting
Add to Study Case or Remove from Study Case from their edit dialogue. Automatically a reference
to the activated/deactivated grid is generated/deleted in the Summary Grid object.
A grid cannot be activated separately; a study case linked to the grid must be active. The context
sensitive menu will show an Activate option when a grid or system stage folder is right-clicked if no
study case folder is active. This will present a prompt dialogue which request that either an existing
study case be activated, or a new study case be created rst. The grid or system stage is then activated
in conjunction with whichever choice is made.
11.4 Study Time
PowerFactory Version 14 extends the idea of a model into the dimension of time. The Study Case has
got a Study Time. The Study Time denes the point in time you wish to analyze.
The Study Time must be inside the Validity Period of the Project, which species the time span the
Project is valid for (see Chapter 8: Basic Project Denition, Section 8.1.3 (Project Settings)). PowerFac-
tory will use the Study Time in conjunction with time-dependent network expansions (see Chapter 15:
Network Variations and Expansion Stages) to determine which network data is applicable to that point in
time. You are able to change the Study Time in order to analyze a different point in time. The Expansion
Stages will be activated/deactivated with the Study Time.
The status bar at the bottom of the PowerFactory program window shows the currently set Study Time.
The most easy way to change the Study Time is:
Double click on the Study Time shown in the status bar of PowerFactory.
Enter the date and time or press the button Date andTime in order to set the Study Time to
the current time of your computer.
Press OK to accept the changes and close the window.
There are several alternative ways to edit the Study Time.
Alternative 1: Edit the Study Time like a Trigger:
DIgSILENT PowerFactory 15, User Manual 149
CHAPTER 11. STUDY CASES
Press the button Date/Time of Calculation Case in the main toolbar of PowerFactory.
Enter the date and time or press the button Date andTime in order to set the Study Time to
the current time of your computer.
Press OK to accept the changes and close the window.
Alternative 2: Edit the Study Case from within the Study Case dialogue:
Activate the project and browse for the Study Case in the Data Manager.
Right click on the Study Case and select Edit from the context sensitive menu.
On the Basic Data page press the button with the three dots beneath the entry for the Study Time
Set the Study Time according to your needs.
Press OK to accept the changes and close the window.
11.5 The Study Case Edit Dialogue
To edit the settings of a study case, you may select Edit Study Case in the main menu, or right-click
the study case in the Data Manager and select Edit from the context sensitive menu. A dialogue as
shown in Figure 11.5.1 will appear.
Figure 11.5.1: Study Case edit dialogue
In the Basic Data page, the user can dene the name and an owner to the study case. The output units
of the calculated variables are dened in the Output Variables eld. The grids that are linked to a study
case may be viewed by pressing the Grids/System Stages button. The study time can be edited by
pressing the button; this will open the edit dialogue of the study case time trigger (see Section 15.4:
Study Time). Please regard that the study time can also change as a result of setting the recording
expansion stage explicitly (see Chapter 15: Network Variations and Expansion Stages).
The Calculation Options page is used to set the solving algorithm for the case calculations. The change
of the default options is only recommended under the supervision of the DIgSILENT support experts.
The Description page, like all objects description pages is used to add user comments.
Note: To edit the study time you can alternatively, press on the Date/Time of Calculation Case button
. This will open the study case time trigger window. Also, at the lower right corner of the screen
150 DIgSILENT PowerFactory 15, User Manual
11.6. VARIATION CONFIGURATION
the time of the simulation case is displayed. By double-clicking on this eld you are taken to the
same window.
11.6 Variation Conguration
Similarly to the Summary Grid object, the Variation Conguration object (IntAcscheme ) holds refer-
ences to the active variations.
11.7 Operation Scenarios
A reference to the active operation scenario (if any) is always stored in the study cases. Similar to
variation congurations and summary grids, when a study case is activated, the operation scenario (if
any) whose reference is hold, will be automatically activated. The reference to the active operation
scenario is automatically updated by the program.
11.8 Commands
In PowerFactory a calculation (i.e load ow , short circuit , initial conditions of a time domain simu-
lation , etc.) is performed via Calculation Commands, which are the objects that store the calculation
settings dened by the user. Each study case stores its own calculation commands, holding the most
recent settings. This ensures consistency between results and calculation commands and enables the
user to easily reproduce the same results at a later stage. When a calculation is performed in a study
case for the rst time, a calculation command of the corresponding class is automatically created in-
side the active study case. Different calculation commands of the same class (i.e different load ow
calculation commands: objects of the class ComLdf or different short circuit calculation commands:
objects of the class ComShc ) can be stored in the same study case. These approach allows the
user to repeat any calculation, with all the settings (such as fault location, type, fault impedance, etc.)
as last performed in the study case. Of course the calculations are performed only over the active grids
(expansion stages).
Figure 11.8.1 shows a study case called Study 1 witch contains two load ow calculation commands
( , Ldf 1 and Ldf2), one command for an OPF calculation , one command for the calculation of
initial conditions , and one transient simulation . The edit dialogue of each one of the calcula-
tion commands existing in PowerFactory is described in the chapter corresponding to that calculation
function.
DIgSILENT PowerFactory 15, User Manual 151
CHAPTER 11. STUDY CASES
Figure 11.8.1: Calculation Commands in a Study Case
Actions such as generating a report of the actual calculation results or the state of the dened network
components are carried out via command objects (in this case ComSh and ComDocu objects respec-
tively). For information about reporting commands please refer to Chapter 17 (Reporting and Visualizing
Results).
Note: Command objects basically consist of the data set that congures the calculation, and the Exe-
cution function to perform the computations. Like any other object calculation commands can be
copied, pasted, renamed and edited.
11.9 Events
Simulation Events objects are used to dene simulation events. For time-domain simulations, events
are stored within the Study Case Simulation Events/Fault folder (see Chapter 25: Stability and EMT
Simulations, Section 25.6 for a general description). For short-circuit studies, they are stored in the
Study Case Short Circuits folder. For other steady-state calculations that utilize Simulation Events,
they are stored within the Operational Library Faults folder. PowerFactory offers several kinds of
events:
Dispatch Event (EvtGen)
External Measurement Event (EvtExtmea)
Intercircuit Fault Events (EvtShcll )
Events of Loads (EvtLod)
Message Event (EvtMessage)
Outage of Element (EvtOutage)
Parameter Events (EvtParam)
Save Results (EvtTrigger )
Short-Circuit Events (EvtShc)
Stop Events (EvtStop)
152 DIgSILENT PowerFactory 15, User Manual
11.9. EVENTS
Switch Events (EvtSwitch)
Synchronous Machine Event (EvtSym)
Tap Event (EvtTap)
11.9.1 Dispatch Event
The user species the point in time in the simulation for the event to occur, and a generation element
(ElmSym, ElmXnet or ElmGenstat ). The incremental change of the generator can then be altered using
the dispatch event.
11.9.2 External Measurement Event
External measurement events can be used to set and reset values and statuses of external measure-
ment objects.
11.9.3 Intercircuit Fault Events
This type of event is similar to the short-circuit event described in Section 11.9.9 (Short-Circuit Events
(EvtShc)). Two different elements and their respective phases are chosen, between which the fault
occurs. As for the short-circuit event, four different elements can be chosen:
Busbar (StaBar )
Terminal (ElmTerm)
Overhead line or cable (ElmLne)
11.9.4 Events of Loads
The user species the point in time in the simulation for the event to occur, and a load element(s)
(ElmLod, ElmLodlv, ElmLodmv or ElmLodlvp). The value of the load can then be altered using the load
event. The power of the selected load(s) can be changed as follows:
Step Changes the current value of the power (positive or negative) by the given value (in % of the
nominal power of the load) at the time of the event.
Ramp Changes the current value of the power by the given value (in % of the nominal power of
the load), over the time specied by the Ramp Duration (in seconds). The load ramping starts at
the time of the event.
11.9.5 Message Event
A message will be printed to the output window at the specied time in the simulation.
11.9.6 Outage of Element
This Outage of Element event can be used to take an element out of service at a specied point in time.
It is intended for use in steady-state calculations e.g. short-circuit calculation and reliability assessment.
DIgSILENT PowerFactory 15, User Manual 153
CHAPTER 11. STUDY CASES
It may also be used to take elements out of service in time-domain simulations, however it is not possible
to bring an outaged element back into service using this event during a transient simulation. This is
only possible in steady-state calculation functions. The following message will be displayed if the user
attempt to bring a previously outaged element back into service using Outage of Element :
DIgSI/err (t=000:000 ms) - Outage Event in Simulation
not available.
Use Switch-Event instead!
11.9.7 Parameter Events
With this type of event, an input parameter of any element or DSL model can be set or changed. First, a
time specifying when the event will occur is specied. Then an element has to be to specied/selected
using the down-arrow button . Then choose Select... from the context-sensitive menu. Afterwards
insert the name and the new value of a valid element parameter.
11.9.8 Save Results
This event is only used for PowerFactory Monitor applications. It cannot be used during time-domain
simulations.
11.9.9 Short-Circuit Events
This event applies a short-circuit on a busbar, terminal or on a specied point on a line. The fault
type (three-phase, two-phase or single-phase fault) can be specied as well as the fault resistance and
reactance and the phases which are affected.
The duration of the fault cannot be dened. Instead, to clear the fault, another short-circuit event has to
be dened, which will clear the fault at the same location.
11.9.10 Stop Events
Stops the simulation at the specied time within the simulation time-frame.
11.9.11 Switch Events
Switch events are used only in transient simulations. To create a new switch event, press the icon
on the main menu (if this icon is available), which will open a browser containing all dened simulation
events. Click on the icon in this browser, which will show a IntNewobj (Figure 11.9.1) dialogue which
can be used to create a new switching event.
154 DIgSILENT PowerFactory 15, User Manual
11.10. SIMULATION SCAN
Figure 11.9.1: Creation of a New Switch Event (IntNewobj )
After pressing OK, the reference to the switch (labelled Breaker or Element ) must be manually set. Any
switch in the power system may be selected, thus enabling the switching of lines, generators, motors,
loads, etc. The user is free to select the switches/breakers of all phases or of only one or two phases.
It should be noted that more than one switching event must be created if, for instance, a line has to be
opened at both ends. These switch events should then have the same execution time.
11.9.12 Synchronous Machine Event
The Synchronous Machine Event is used to easily change the mechanical torque of a synchronous
machine (ElmSym). The user species the point in time in the simulation for the event to occur, and
an active synchronous machine. The user can then dene the additional mechanical torque supplied to
the generator. The torque can be positive or negative and is entered in per unit values.
11.9.13 Tap Event
The user species the point in time in the simulation for the tap event to occur, and a shunt or transformer
element (ElmShnt, ElmTr2, etc). The Tap Action can then be specied.
11.10 Simulation Scan
For details of Simulation Scan modules, refer to Chapter 25 Section 25.5.
11.11 Results Objects
The Results object (ElmRes ) is used to store tables with the results obtained after the execution of
a command in PowerFactory. The typical use of a Results object is in writing specic variables during a
transient simulation, or during a data acquisition measurement. The obtained results can later be used
to generate plots, or in DPL scripts.
An example of the result object dialogue is depicted in Figure 11.11.1.
DIgSILENT PowerFactory 15, User Manual 155
CHAPTER 11. STUDY CASES
Figure 11.11.1: The Results Object Dialogue
The result object shows the following elds:
Name The name of the result object
Database ID Its database ID and the date, when it was changed the last time
Default for Its default use
Info Information about the currently stored data, ie.e the time interval, step sizes, number of variables,
etc.
Trigger-Times Trigger times (in case of a Triggered default use)
The information about the stored data shows:
The time interval.
The average time step.
The number of points in time.
The number of variables.
The size of the database result-le.
The Clear Data will clear all result data (only available if calculation results are stored).
Note: Clearing the data will delete the result-le and will reset the database ID. This will destroy all
calculated or measured data in the result le. It will not be possible to restore the data.
The content of a result object (the variables whose results are stored) is determined by sets of selected
variables called Monitor Variable Sets (IntMon ). Each Monitor Variable Set stores the results of the
selected variables for one network component. These monitor objects can be edited by pressing the
Variables button. This will show the list of monitor sets currently in use by the result object.
Note: Selecting a set of result variables, trough the use of monitor objects is necessary because oth-
erwise all available variables would have to be stored, which is practically impossible.
When the Export button is pressed, all events that happened during the simulation, could be exported
in different formats. For information about exporting results, please refer to Chapter 17: Reporting and
Visualizing Results, Section 17.2.4 (Result Objects).
156 DIgSILENT PowerFactory 15, User Manual
11.12. VARIABLE SETS
11.12 Variable Sets
The result object combines one or more monitor variable sets (IntMon ), allowing a very exible and
highly transparent result denition. In fact, by using monitor variable sets, just about every parameter
used in the PowerFactory program comes available as calculation result, together with a description and
a unit.
The variables selected with the IntMon dialogue in the result object become available to the subplot
objects in the virtual instrument panels. In these plots, one or more result objects can be selected and
from those result objects a power system element and one of its variables can be chosen, if that element
and that variable was selected in one of the IntMon objects. The subplot will then show the calculated
curve of that variable.
Variable sets always have a reference to a network component, whose selected variables are going
to be recorded (Figure 11.12.1 red circle, in this case a transformer called EBT1). To facilitate the
selection of the variables, monitor variable sets are organized according to the calculation functions of
PowerFactory and by the type of data. For example, if the results of a harmonics calculation are to be
recorded, the user should go to the Harmonics/Power Quality page (Figure 11.12.1, green circle). If
the voltage or the power of the referred element is to be stored, the selected Variable Set should be
Currents, Voltages and Powers (Figure 11.12.1 blue circle).
Figure 11.12.1: Monitor Variable Set Dialogue
For further information about the denition of Monitor Variable Sets please refer to Chapter 17: Report-
ing and Visualizing Results, Section 17.4 (Variable Sets).
11.13 Triggers
As described in Chapter 16 (Parameter Characteristics, Load States, and Tariffs), parameter charac-
teristics are used to dene parameters as ranges of values instead of xed amounts. The parameter
characteristics are set over user dened scales. The current value of the parameter is at the end deter-
DIgSILENT PowerFactory 15, User Manual 157
CHAPTER 11. STUDY CASES
mined by a trigger object (SetTrigger, ), which sets a current value on the corresponding scale. For
example if the value of a certain parameter depends on the temperature, a characteristic over a temper-
ature scale is set. The current value of the temperature is dened by the trigger. The current value of
the temperature determines the current value of the parameter, according to the dened characteristic.
Once a parameter characteristic and its corresponding scale are set, a trigger pointing to the scale is
automatically created in the active study case. The user can access the trigger object and change its
actual value every time that he/she requires.
PowerFactory offers different types of characteristics and scales; each scale (by default scales are
stored in the Scales folder of the Equipment Library) points to a trigger from the active study case.
Information about the use and denition of characteristics, scales and triggers is given in Chapter 16
(Parameter Characteristics, Load States, and Tariffs).
11.14 Graphic Board
The Study Case folder contains a folder called the Graphics Board folder (SetDesktop, ) where ref-
erences to the graphics to be displayed are contained. This folder, much like the Summary Grid folder,
is automatically created and maintained and should generally not be edited by the user.
The references in the graphics board folder are created when the user adds a grid to a study case.
PowerFactory will ask the user which graphics of the grid should be displayed. At any time later the user
may display other graphics in the grid by right-clicking the grid and selecting Show Graphic. Graphics
may be removed by right-clicking the tab at the bottom of the page and selecting Remove Page(s).
The study case and graphics board folder will also contain references to any other graphics that have
been created when the study case is active.
158 DIgSILENT PowerFactory 15, User Manual
Chapter 12
Project Library
12.1 Introduction
The project library stores the following categories of data:
Equipment Types (Section 12.2: Equipment Type Library)
Operational Data (Section 12.3: Operational Library)
DPL Scripts (See Chapter 19: The DIgSILENT Programming Language - DPL)
Table Reports (See Appendix D, section D.5.8 Table Report Methods)
Templates (Section 12.4: Templates Library).
User Dened Models (See Section 25.11: User Dened (DSL) Models)
This chapter is describes the Equipment Type Library, Operational Library, and Templates library. Note
that in addition to the project Library, the global Library includes a range of pre-dened types, models,
templates, and scripts (refer to Chapter 4: PowerFactory Overview, Section 4.6: Data Arrangement for
details).
12.2 Equipment Type Library
The Equipment Type Library is used to store and organize Type data for each class of network com-
ponent. Once a new project is created, an Equipment Type Library is automatically set by the program
within the Library folder. It also includes a subfolder for storing Scales.
To create or edit a folder in the Equipment Type Library:
1. On the Equipment Type Library folder in the left pane of the Data Manager right-click and select
New Project Folder from the context sensitive menu (or to edit an existing folder, right-click the
folder and select Edit ). The project folder edit dialogue is displayed.
2. In the Name eld, enter the name of the new folder.
3. In the Folder Type eld, select Generic.
4. In the Class Filter eld, write the name of the type class(es) to be allowed in the folder (case
sensitive). If more than one class is to be allowed, write the class names separated by commas.
An asterisk character (
i=1
u(i) cos(2(f(i) t +(i)) (17.1)
where
i Index of frequency
n Number of frequencies
t Time
f(i) Frequency at index i
u(i) Magnitude at frequency i
phi(i) Angle at frequency i
For the If a successful harmonic load-ow calculation with the option All Frequencies is performed, the
waveform plot will show the results of any distorted or pure sinusoidal variable, e.g. voltages or currents,
from any element in the network. It can also be created if there is no load-ow calculated.
To create a waveformplot on the current VI panel, press the icon and select a WaveformPlot (VisHrm)
278 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
from the pull down list. More than one subplot may be created at once by setting the Number of VI(s).
The new empty subplots appear with standard settings.
Usage, settings and tools of this plot are similar to the subplot. A detailed description can be found
in 17.5.2 (The Subplot). Although the denition of the variables is slightly different. Besides the result
object and the element, there can be dened the magnitude of the variable, which is to be shown in
the plot, and additionally the angle related to the magnitude can be inserted when this information is
needed.
The appropriate angle is automatically matched to the selected magnitude, if such angle is available in
the results and if the variable is a voltage or a current. When no appropriate angle is found, one may be
selected manually. Nevertheless it is not obligable to insert an angle to shown the waveform plot.
Figure 17.5.15 shows an example for dening a variable in the VisHrm.
Figure 17.5.15: Dening variables in a waveform plot (VisHrm)
The Waveform Plot Settings Most other settings/options of the waveform plot act exactly like the
settings of the Subplot (VisPlot ). See Section 17.5.2 (The Subplot) for more information. Additionally to
the standard settings of the plots there are specied settings of the waveform plot. Step size and range
for time t are specied at the waveform plot settings object stored in the Settings of the active project.
To change the waveform plot settings either press the Calculation button in the dialogue of the plot or
select Calculation in the context menu on the plot. The Settings WaveformPlot object SetWave holds the
Step Size and the Range for the calculation of waveforms in the Waveform Plots (see Figure 17.5.16).
Figure 17.5.16: The waveform plot settings dialogue
Step Size
The waveforms seen in the plot are calculated by the waveform plot itself. To avoid errors the Step Size
must be smaller than half the period of the highest frequency calculated by the harmonics load-ow. To
guarantee that this criteria is always fullled, independent of the harmonics calculation, the Step Size
DIgSILENT PowerFactory 15, User Manual 279
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
is entered in Number of Samples in Highest Frequency. The Highest Frequency and the resulting Step
Size are shown just for information.
Range
To be independent of the basic frequency the time range of the waveform is entered in Number of cycles
of Basic Frequency. Basic Frequency and the resulting Range are shown just for information.
17.5.7 The Curve-Input Command
The curve input command is used for measuring printed curves. The original curves must be available
in windows metale (*.wmf) or in bitmap (*.bmp) format. The graphics le is displayed as background in
a curve input plot. This plot then allows for dening plot points by successive mouse clicks.
The curve input plot (VisDefcrv) allows for measuring and editing single curves of group of curves at
once. The measured curve points are stored in a Matrix object. The positions of the axis in the curve
input plot can be set by the user.
Special functions for groups of curves allow for x-value synchronization and many other facilities to
make their input easier and faster.
Creating a Curve-Input Plot
The special Curve Input virtual instrument plot VisDefcrv is needed for measuring curves. Such a plot,
like al other virtual instruments, is displayed on a Virtual Instrument Panel. A new virtual instrument
panel is created with the new command in the le menu or the new icon of the graphics window.
A new Curve Input plot is created by right-clicking the empty panel, or by pressing on the panel
button bar and subsequently selecting the Curve-Input (VisDefcrv). The curve input option dialogue as
shown in Figure 17.5.17 is opened by double-clicking the curve input plot.
The Input Options
The input options are used to select the graphics le which is to be measured. Only windows metale
(*.wmf) or bitmap (*.bmp) formats are allowed. The x-scale and y-scale settings are used to set the
range and type of the axes of the curves as they are in the graphics le.
280 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
Figure 17.5.17: Editing the curve input plot
Two different types of curves can be input:
Single
Each matrix input denes a single curve. The rst column in the matrix holds the x-values, the
second one the y values. Other columns are ignored.
Set of Curves
Only the rst matrix is used for input. The rst column in the matrix holds the x-values, the other
columns hold the y-values of each curve in the group of curves.
The measured curve is drawn between the measured points by interpolation. This is important when
the measured curve is later used with a specic interpolation. Setting the correct interpolation mode
when measuring the curve causes a better t while avoiding excess curve point denitions. Available
modes of interpolation:
Linear
Cub. Spline
Polygon
Hermite
The Context Sensitive Menu
The case sensitive menu is opened by right-clicking the curve input plot. The menu is used to select the
DIgSILENT PowerFactory 15, User Manual 281
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
curve for which points are to be measured or edited, to select the measurement mode, to synchronize
x-values by interpolation, etc.
Grid
Opens the grid layout dialogue
Curves
Used to switch from single to set of curves mode.
Interpolation
Selects the interpolation mode
Interpolate All
interpolates undened y values for all curves for all dened x-values
Interpolate N
interpolates undened y values of curve N for all dened x-values
Delete Curve N
Removes curve N from the matrix
Add Curve
appends a new curve
Set Axis
With this option the origin of the axes and the length of the axes can be adjusted according to the
gure imported.
Origin
sets the origin of the graph to be inserted.
x-Axis
sets the x-axis independent on the y-axis.
x-Axis (y=Origin)
sets the x-axis dependent on the y-axis origin.
y-Axis
sets the y-axis independent on the x-axis
y-Axis (x=Origin)
sets the origin of the graph to be inserted.
Origin
sets the origin of the graph to be inserted.
Input
species the input mode:
282 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
Off
switches off the measurement mode
x/y-Pairs
each left mouse click adds a point to the curve.
Drag & Drop
turns on the edit mode: all points can be dragged and dropped to change their y-position
or left clicked and deleted with the Del key.
Active Curve
sets the curve to modify
How to Scan curve(s) using the curve-input plot:
Create a virtual instrument panel with a curve input plot
Open the curve-input dialogue with a double-click and set the following options
Select the background le
Select Single or Set of Curves in the Curves Listbox
Select the interpolation mode
Select on or more Matrix objects in the table named Curves. At least two columns must be
already present in the matrix object.
Close the dialogue.
Dene the axis position to adapt the curve input to the background plot:
Select the graphic cursor
Right-click the plot and select Set Axis - Origin. Left click the origin of the plot
Right-click the plot and select Select Set Axis - x-Axis. Left click the end of the x-axis of the
background plot.
Right-click the plot and select Select Set Axis - y-Axis. Left click the end of the y-axis of the
background plot.
Open the curve-input dialogue and adapt the scale of the curve input plot to the scale of back-
ground plot
Right-click the plot and select the Active Curve option and activate the rst curve. The option is
not available when
There is no Matrix object selected in the Curves table of the dialogue
One of the matrix object(s) has less than two columns
Right-click the plot and select the Input option. Select the input mode. With the rst curve, select
the with x/y-Pairs option.
Left click the curve to set x/y values.
Right-click the plot and select the Input - Off option to nish the denition of the curve
DIgSILENT PowerFactory 15, User Manual 283
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
17.5.8 Embedded Graphic Windows
Some dialogues contain embedded graphic windows to visualize input settings. An example is shown in
Figure 17.5.18 for the parameter characteristic dialogue. Many other dialogues have also such embed-
ded graphs. An embedded graph shares much of its functionality and features with the normal graphs
in the Virtual Instruments, like the subplot in section .
Figure 17.5.18: Example of an embedded graphs
Similar to the plots on a VI page the mouse position in the embedded graphic is shown in the status
bar. The context sensitive menu of the embedded graphs offers commands for printing and zooming.
Print Picture
This option opens the print dialogue. The default print format for embedded graphs is A4. The
printer orientation is set to the orientation of the embedded graph. The print dialogue offers to
preview the printed area.
Zoom In
This option changes the cursor to a magnifying glass. Drawing a rectangle with the cursor will
enlarge that area.
Zoom Back
This option restores the previous zoom area.
Zoom All
This option zooms out to the complete window.
Change Viewpoint
This option changes the arrow to the move arrow . Press the left mouse button, hold it down
284 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
and move the mouse outside the window. This will move the zoomed area in that direction. Press
the right mouse button or Esc to change the cursor back again.
Additionally there may be a Limits available in the dialogue. Pressing this button will open a small
dialogue where the minimum and maximum of the x-axis can be changed, or the Scale button will reset
the settings and scale the axis automatically.
17.5.9 Tools for Virtual Instruments
Different kinds of plots are used to display calculation results or device data. There are a lot of tools,
which will help the user interpreting and analyzing these data or results of calculations. Most of them
are accessible directly through the status bar of PowerFactory or through the context sensitive menu.
This is activated by right-clicking on the curve or an the plot background depending on the function one
wants to choose.
Edit Dialogues
The Edit dialogue of the plots can be accessed through double-clicking on the background of each plot
or by selecting Edit in the context sensitive menu. A faster way to access special information of the plot
is to double-click directly on the element which is to be change. This can be the:
Legend
the legend text and representation can be edited directly.
X-Axis
to edit the x-axis limits, scales and variable representation and auto scaling options of the current
graphics board or panel.
Y-Axis
to edit the y-axis limits, scales and variable representation and auto scaling options as well as
the variable to be shown.
A double-click on other positions will open the plot dialogue.
The Status Bar
In the status bar of PowerFactory on the bottom of the program window useful information of the data
shown in the curves can be obtained.
First the value of the mouse position in the diagram is displayed in the status bar, similar to the
information shown with an open single line diagram.
When a curves is clicked and marked with a cross, the cross value is also displayed in the status
bar and remains unchanged until the cross is set to a different position. If there is no cross on
the active page the status bar value is reset and no longer displayed. Some plots have different
scales on one axis, therefore these plots can not display a value in the status bar.
The option Curve-Tracking can be found in the status bar, normally in a grey font style. When
double-clicking this option the Curve-Tracking mode will be activated. Then a cross will appear if
the mouse arrow will be near a curve. If the mouse is hold still for one second, the x- and y-value
will be shown in a balloon window.
Labelling Plots There are different styles of labels available for labelling curves and graphics. Setting
labels is possible in most of the different plots, although some of the labels are not available in all kinds
of plots. The labels are created the same way.
DIgSILENT PowerFactory 15, User Manual 285
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
The label option is available from the context sensitive menu whenever a curve or graphic was clicked
and marked with a cross. The option Label Insert . . . Label can be selected for the different labels.
In addition there are two icons and in the toolbar, which can be used to create labels.
After selecting the appropriate label from the sub-option of label, a rubber band from the cross to the
mouse is shown. A click with the left mouse button sets the label, the right mouse button cancels. The
following different labels are available.
The Text and Value Label
The text-label displays an user dened text above and below a line connected to the curve with a
rubber band. Edit the label to change the text shown. The value-label displays the x/y coordinates
of the cross. The label is a text-label lled with the coordinates. Edit the label to change the text.
The Format Label
The form-label uses a form to print the displayed text. The form is local for each label or common
to all plots of the same type in the active project.
The Text and Value Label The text and the value label (VisValue) is used to label curves or graphics
displayed in plots. The text of the label is written above and below a horizontal line. The line is connected
to the curve/graphic with a rubber band.
After creating the labels, they can freely be dragged across the plot while staying connected to the data
point on the curve. The text can also be changed by double-clicking the label or the rubber band. The
edit dialogue of these two labels is depicted in Figure 17.5.19.
Figure 17.5.19: X/Y value dialogue
Value
Value displays the connected curve position of the label. For labels created as value this position
is displayed as label text. x-Axis displays the x axis value, y-Axis the y axis value. Time is
visible only for plots showing a trajectory.
Text on Top
286 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
Text written above the horizontal line.
Text on Bottom
Text written below the horizontal line.
Delete Label when a new Simulation is started
Some plots show the simulation results. Labels in plots showing simulation results are deleted
when the simulation is started again. To keep labels in such plots, e.g. to compare curves with
the last run, turn off this option. The default of this option is on.
The Format Label Like the text/value label, the format label (VisLabel ) is set in plots to label curves or
graphics. This label displays text printed using a form. The form is different for each type of diagram. It
is either dened local at the label or dened for all diagrams of the same type in the activated project.
Its dialogue is shown in Figure 17.5.20.
Figure 17.5.20: The form-label dialogue
Value
Value displays the connected curve position of the label. x-Axis displays the x axis value, y-
Axis the y axis value.
Data Object
Data Object is a reference to the shown object. If Data Object is not set the label itself is taken
as shown object.
Shown Object
The object output by the form, see Data Object described above.
Edit Used Format
Shows the used Form Manager. The used format is either the local format or the one dened
for all plots of the same type in the active project.
Create Local Format
Creates a new Form Manager valid for the current label only. The forms can be edit without
inuencing other labels in the same plot or in the active project. The Create Local Format
button is replaced by the Set Default Format when a local format was dened.
DIgSILENT PowerFactory 15, User Manual 287
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
Set Default Format
Removes the local format. The format used is the one used for all plots of the same type in the
active project. The Set Default Format button is replaced by the Create Local Format when
the local format was reset.
Delete Label when a new Simulation is started
Some plots show simulation results. Labels in plots showing simulation results are deleted when
the simulation is started again. To keep labels in such plots, e.g. to compare curves with the last
run, turn off this option.
From the context sensitive menu of the format labels more options can be selected
Border
A simple border of the selected label can be turned on or off.
Form
The format options can be directly accessed by Edit used Format and Create Local Format for
the marked format label.
Reconnect with...
Reconnects the format label to another curve or data point.
The Constant Value The constant label (VisXvalue) is used to display y-values for a constant x-
quantity or x-values for a constant y. In some plots like the overcurrent plot, constant labels are created
and deleted automatically e.g. to visualize the short-circuit current for relays.
The look of constant labels may vary because of different settings like the label location, the intersection
values and other options. The dialogue of the constant label is depicted in Figure 17.5.21.
Figure 17.5.21: The constant label dialogue
To insert a constant label into a diagram or plot, the option Set constant x-Value or Set constant
y-Value places a constant x- or a constant y-value into the current plot. Thus the dialogue for constant
the VisXvalue object will pop up (shown in Figure 17.5.21) and a horizontal respectively vertical line will
then be displayed at the value specied in the dialogue. Also the constant value and (if exist) the value
of intersections with the curves will be shown.
288 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
There are different options and styles for the constant label:
Name denes the name of the constant line and will be displayed in the plot.
Style changes the representation of the constant label:
Line Only displays only the solid line and the related label.
Line with Intersections shows a solid line including label and indicates the values when intersections
with the curves of the plot.
Short Line Only (Left/Right indicates the constant value at the bottom/top respectively at the right/left
side of the plot.
Short Line/Intersection (Left/Right) indicates the constant value at the bottom/top respectively at the
right/left side of the plot and the intersections with curves.
Intersection Only shows only the intersection points with the curves.
Label denes the position of the constant value label:
None displays no label at all.
Outside of Diagram creates the label between the border of the VI and the diagram area. Labels of
constant x values are created above the diagram area, labels of constant y values are created
right of the diagram area.
Above Line (right) shows a label above the line if y is constant, the label will be on the right hand side.
Below Line (left) shows the label below the line on the left hand side.
Left of Line (top) shows a label on the left side of the line if x is constant, the label will be on the top
end.
Right of Line (bottom) shows the label right of the line on the bottom end.
Value denes the constant value, either X or Y. The dialogue shows if either a X or Y is set. Also the
actual position of the cross will be shown as a x- respectively y-value. It is not possible to change
a constant X into a constant Y label other than by removing the old and creating the new one.
Color species the color of the line and the labels/intersections.
Linestyle and Width species the line style and line width for the line shown. Invisible if Show Values
is set to Intersections Only.
For constant x-values in time-overcurrent diagrams there exist additional options:
x-Value is Displays the type of current displayed. Visible only for constant x values in time overcurrent
diagrams.
Show Values The constant value can be displayed as a line, as intersections with the curves/graphics
or both. Line Only shows a vertical or horizontal line without labels for the intersections with the
curves. Line with Intersection creates crosses at the intersection of the line with the curves. For
constant x values the y value is displayed at the crossing ant the other way round. The values and
their unit are coloured like the curve crossed.
Intersections Constant x values created automatically in the overcurrent plot are displaying the short-
circuit current. To get the tripping times Intersections can be set to SHC Currents. All would
display the intersection of the relay curve ignoring the type of current. Visible only for automatic
constant x values showing currents in the time overcurrent diagrams.
DIgSILENT PowerFactory 15, User Manual 289
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
Set User Dened The button Set user dened is visible for constant values created by the short-
circuit in overcurrent plots. Labels showing this button display the short-circuit current. The labels
are deleted whenever a new short-circuit was calculated. If one wants to modify and keep the
label even if a new short-circuit was calculated the label must be changed to user dened.
The Straight Line
There are various ways of inserting lines into a plot. With the option Straight Line . . . there can be
used a
Set Secant to add a line directly through the selected data point.
Through Point denes a graphic line through the selected data point with a dened gradient and gives
back the function of the line.
User Dened denes a line independent from the curves shown with a dened gradient and y-offset.
The function of the inserted line can also be seen, when holding the mouse arrow over the line
for 1 second. The options of the line dialogue or similar to the options for the constant value in
section.
Curve Filter Curves shown in the plots and diagram can be ltered using the Curve Filter. The option
Filter... from the context sensitive menu displays the lters available to be applied to the data read from
the result object. Another way to access this function is from the edit dialogue of the plot. Here the
Filter... button can be pressed. The Figure 17.5.22 shows the dialogue of the function.
Figure 17.5.22: Dening a curve lter
The Curve Filter species the type of lter applied to the data read from the result object. This object
is a lter applied to curves in plots. There are different lter types available. The following lter settings
are available. (N=number of points in the original curve, K=number of points in the ltered curve)
Disabled No ltering will be performed. K=N.
Average The ltered curve is the running average of the last n points. The rst n-1 points are omitted.
K=N-n+1.
Balanced Average The ltered curve is the running average of the last (n-1)/2 points, the current point
and the next (n-1)/2 points. This lter thus looks ahead of time. The rst and last (n-1)/2 values
are omitted, n must be an odd number. K=N-n+1.
Purge Points by averaging The ltered curve contains the averages of each block of n values. K=N/n.
This lter may be used to speed up the display of large curves.
Purge Points The ltered curve only contains every n-th value. All other values are omitted. K=N/n.
This lter may be used to speed up the display of large curves.
Note: A curve lter can only be applied at the end of the simulation or measurement, points added
during a simulation or measurement are not ltered. The option Filter... is not available in all plots.
290 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
Border
Off
Simple
3D
3D with label
The border with 3-dimensional effect and label will insert an additional label on the bottom of the se-
lected plot. This label can now be dened by double-clicking on it. Furthermore the text style can be
altered by choosing the option Select Font for Border.
Export of Curve Graphic
The whole diagram or plot can also be exported for further usage in reports. Thereto rst mark the plot
which is to be exported to a graphic le. Then select the option File Export. . . . . . from the main
menu.
There is the selection between the export into a Windows MetaFile (*.wmf) or into a Bitmap File (*.bmp).
Export of Curve Data
The export of curve data is available for a single VI or for the variables of the entire VI panel. Hence there
are different ways to access the ASCII Results Export command ComRes of curve data, described in
the following paragraph. The export directly from the result le gives the opportunity to directly export
several variables at once and is described in more detail in Section 17.2.4(Exporting Results).
Exporting curves of a single VI:
Press the Export... button in the right side of the dialogue box of a virtual instrument.
Right-click on the VI and select Export... from the context sensitive menu.
Exporting curves of the entire VI panel:
Press the Export Results... button on the Results page of the VI panel.
Right-click on an empty area of the VI panel and select Export Results... from the context sensitive
menu.
Note: If in one plot or on one VI panel variables are shown from several result objects, a dialogue will
appear before the export command, where you have to select one result le from the list.
This function will export the data from the displayed curve with the given time range as ASCII text to the
following programs/les:
Output Window
Windows Clipboard
Measurement File (ElmFile)
ComTrade
Textle
DIgSILENT PowerFactory 15, User Manual 291
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
In this dialogue the individual step size can be set, the columns of the result le and the header for the
export as can be seen from Figure 17.5.23.
Figure 17.5.23: Command dialogue of the ASCII result export
Various VI Tools
Grid This option in the context sensitive menu displays a dialogue to turn on/off the available grid lines.
For both x- and y-axis a main grid and a help grid can be displayed in the plots. Furthermore -
depending on the type of plot - the representation of the different ticks on the axes can also be
specied.
Autoscale X, Autoscale Y Changes the autoscale settings of the plot. Off turns off the auto-scale
mode. On performs an auto-scale at the end of the simulation or calculation. Online is available in
simulation plots only and tests the plot limits after each new simulation point.These settings can
also be dened in the edit dialogue of the x- and y-axes.
x-Scale(s), y-Scale(s) There are two options in the x-scale or y-scale entry. Edit displays a dialogue to
modify the scale settings like minimum, maximum and other settings. Scale Automatic calculates
the minimum and maximum of the curve and adapts the scale limits.These settings can also be
dened in the edit dialogue of the x- and y-axes or by double-clicking on the corresponding axis.
292 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
Show dx/dy Right-click on data point on a curve and select Show dx/dy from the menu. The two lines
will appear, which are connected to the tip of the mouse pointer. A balloon window will show the x-
and y-difference between the selected data point and the point where the tip of the mouse pointer
is in the diagram. Additionally the gradient is displayed.
17.5.10 User-Dened Styles
Each VI panel, each virtual instrument and every single plot uses a style where line-widths, fonts,
brushes and other graphical settings are dened. These objects normally use predened styles. In
PowerFactory there are six predened styles available:
Default - Standard English Text and Symbols
Gr Default - Greek Symbols
Tr Default - Turkish Symbols
Paper
Gr Paper
Tr Paper
These styles can be modied for all VIs or only for single plots. For this user-dened styles can easily
be created and specied. The base for an user dened style is always the previous default style.
There are several ways to select a predened or user-dened style or change between the available
styles.
The easiest way is using the list-box in the toolbar by clicking and selecting one of the available
styles.
A style can be selected from the Style Select Style . . . in the context sensitive menu of the
VI.
A style is selected in the VI-Style list-box on the Advanced page of the VI Panel dialogue.
The user-dened styles are stored in the settings folder element of the active project. Therefore each
project has its own \ Settings \ Styles \... path and user dened styles. Only the changed elements are
stored in the project, the unchanged ones are the ones predened in the default style.
The settings folder elements can be seen in the database in Figure 17.5.24.
Figure 17.5.24: The settings folder in the database
Dening Styles for the VI Panel The Style Create new Style option in the context sensitive menu of
the VI panel SetVipage or every plot on the panel is selected to create a new style for the actual virtual
DIgSILENT PowerFactory 15, User Manual 293
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
instrument panel. Insert a name for the style to be created in the input dialogue. Then the new style is
added to the predened styles and is automatically selected for the current VI panel. The created style
is not set automatically in other VI panels of the project.
If a user-dened style is selected for the current VI panel, the Style Edit Style option of the context
sensitive menu of the panel may be selected to open the dialogue of the new panel style. Figure 17.5.25
shows the dialogue for editing the layout of the panel.
Figure 17.5.25: Editing the panel style
With the settings shown in Figure 17.5.25, mainly the layout of the title block of the VI panel is edited.
Here the user can dene
the different font styles for the various entries of the block by clicking on the buttons
the height and the width of the columns of the title block (see Section 9.6.3: Graphic Options)
the line width of the title block and of the page frame
Dening Styles for the Virtual Instruments
There is the possibility to dene the x- and y-axis of the plots inside on one page. These settings then
are valid every plot on panels using this style.
To change the styles, right-click on a virtual instrument on the panel and select the option Style Edit
Style in the context menu. Then a dialogue will pop up containing the settings for
all x-axis of VIs using this style
all y-axis
294 DIgSILENT PowerFactory 15, User Manual
17.5. VIRTUAL INSTRUMENTS
the selected object VIsplot
Double-click on the object which is to be changed. As shown in gures 17.5.26, the dialogue of the
selected axis will be opened and can then be modied.
Figure 17.5.26: Editing the styles of X-axis
In the dialogue the following settings of the axes can be specied for the selected style:
Axis Here the style and width of the axis itself can be changed. Also the number of small ticks shown
between the divisions can be chosen.
Text The number of characters and the digits behind the decimal point as well as the font type and size
can be specied.
Distance between Axis and Text
Arrow The representation can be altered between the normal style and a style with an arrow at the end
of the axis with a certain width and length of its tip.
Dening Styles for Single Plots In addition to the axes the presentation of the plot itself can be
chosen by the user. These settings can be accessed through the dialogue shown in 17.5.27 and then
double-clicking on the settings of the VisPlot object.
Another and simpler way to change the settings of the style is to directly select the option Style Edit
Style of clicked Element from the context sensitive menu. These are the same dialogues shown in
Figure 17.5.27 and can directly be accessed by right-clicking on the
DIgSILENT PowerFactory 15, User Manual 295
CHAPTER 17. REPORTING AND VISUALIZING RESULTS
x-axis in the plot to access the settings of the x-axis
y-axis in the plot to access the settings of the y-axis
on the plot itself to access the settings plot style, i.e. the grid, legend, etc.
Figure 17.5.27: Editing the settings of the plot
Figure 17.5.27 shows all different settings available for the plots on a VI panel. Thus one can
Grid Options to alter the width, line style and color of the main grid and the help grid.
Legend Edit the distances from the legend to axis and between the different legends.
Margins Set spaces between the diagram and the surroundings.
Saving Predened Styles for Plots
If the settings of the x- and y-axis, of the plot itself as well as the size of a particular plot shall be saved
and then reused for further plots, there is the option Style Save as predened VI form the context
menu of every plot or VI.
This option saves the setting of the plot and stores a new VI in the list of all VIs. Hence if adding a plot
the newly created VI can now be selected from the list by pressing the icon and selecting the e.g.
NewName(VisPlot) from the pull down list or by using the option Create VI . . . from the context menu
of theSetVipage to add new virtual instruments to the VI panel. The new empty subplots appear with
new dened settings.
296 DIgSILENT PowerFactory 15, User Manual
Chapter 18
Data Management
18.1 Introduction
The basic elements of project management within the PowerFactory environment were introduced in
Chapter 4 (PowerFactory Overview). They allow the user to generate network designs and administer
all input information and settings related to PowerFactory calculations and analyses. The project object
is much more than a simple folder which stores all objects which comprise a power system model; it
allows the user to do advanced management tasks such as: versioning, deriving, comparing, merging
and sharing. These advanced features simplify data management in multi-user environments.
The following chapters explain in more detail, each of the data management functions, including:
Project Versions;
Derived Projects;
Comparing and Merging Projects;
How to update a Project; and
Sharing Projects
18.2 Project Versions
The section explains the PowerFactory concept of a version. The section rst explains what a version
is and when it can be used. Next the procedure for creating a version is explained. Specic procedures
related to versions such as rolling back to a version, checking if a version is the basis for a derived
project and deleting a version are then explained.
18.2.1 What is a Version?
A version is a snapshot of a project taken at a certain point in time. Using versions, the historic devel-
opment of a project can be controlled. Also, the previous state of a project can be recovered by rolling
back a version. From the PowerFactory database point of view, a version is a read-only copy of the orig-
inal project (at the moment of version creation), which is stored inside a version object (IntVersion, ).
Version objects are stored inside the original project in a special folder called Versions.
The concept of versions is illustrated in Figure 18.2.1. At time t0, the project SIN is created. After a
time, t1, when the owner has made several changes they decide to make a copy of the project in its
DIgSILENT PowerFactory 15, User Manual 297
CHAPTER 18. DATA MANAGEMENT
current state by creating the version V1. After more time, t2, and after more changes with respect to
V1, another version V2 is created by the owner. The version control can continue with time like this,
with versions accumulating with a periodicity of t.
After versions are created, the owner can revert the project to the state of the version by using the roll-
back function. This destroys all modications implemented after such a version was created (including
all versions created after the rolled back version.
Figure 18.2.1: Project Versions
18.2.2 How to Create a Version
This sub-section describes the procedure for creating a version. To create a version of the active project
follow these steps:
1. Right-click on the active project.
2. Select New Version from the context sensitive menu. Alternatively, use the option File New
Version from the main PowerFactory menu. The dialogue for the new version appears as shown
in Figure 18.2.1.
3. Set the desired options (explained in the following section) and press OK. PowerFactory auto-
matically creates and stores the version in the versions folder (which is automatically created if it
doesnt yet exist).
298 DIgSILENT PowerFactory 15, User Manual
18.2. PROJECT VERSIONS
Figure 18.2.2: The Create Project Version Dialogue
Options in the Create Project Version Dialogue
Point in Time By default this is set to the system clock time when you initiate the creation of the
version. However, it is also possible to enter an earlier time back to the beginning of retention
period of the project.
Note: Setting a Point in Time earlier than the clock time means that the version is created considering
the state of the project at the time entered. This can be used for example, to revert the project to
a previous state, even though you have not yet created other versions.
Notify users of derived projects If this option is enabled, when a user of a project that is derived
from the active project activates their derived project, they are informed that this new version is
available. Thereafter, updates of the derived project can be made (for further information about
derived projects please refer to Section 18.3).
Complete project approval for versioning required If this option is enabled, PowerFactory
checks if all the objects in the active project are approved. If Not Approved objects are found, an
error message is printed and the version is not created.
Note: The Approval Status is found on the description page in the dialogue of most grid and library
objects.
18.2.3 How to Rollback a Project
This sub-section describes the use of the Rollback function to revert a project to the state of a version
of that project. For example, consider a project called V0, created at a point in time, t. If a Rollback
DIgSILENT PowerFactory 15, User Manual 299
CHAPTER 18. DATA MANAGEMENT
to V0 is completed, the project returns to the state it had at the creation of V0. After the Rollback, all
changes implemented after V0 (after V0s point in time) are deleted. Also, all versions newer than V0
are removed. This concept is illustrated in Figure 18.2.3.
Figure 18.2.3: Example of a Rollback
To complete a Rollback
1. Deactivate the target project.
2. Right-click on the version that you wish to rollback to and select the option Rollback to this version
from the context sensitive menu.
3. Press OK on the conrmation message.
Note that a Rollback is not allowed (not enabled in the context sensitive menu) if a newer version of the
project exists and this version is the base of a derived project. A Rollback cannot be undone!
Note: A version can only be deleted if it does not have derived projects.
18.2.4 How to Check if a Version is the base for a derived Project
This sub-section explains the procedure for checking if a version is the base for a derived project. Follow
these steps:
1. Activate the project.
2. Go to the versions folder inside the project.
3. Right-click on the version that you want to check. Note, do this from the right window pane in the
data manager, not the main data manager tree.
4. Select the option Output... Derived Projects.
5. A list of derived projects will be shown in PowerFactorys output window.
300 DIgSILENT PowerFactory 15, User Manual
18.3. DERIVED PROJECTS
18.2.5 How to Delete a Version
To delete a version:
1. Activate the project containing the version.
2. Go to the versions folder inside the project.
3. Right-click on the version that you want to delete.
4. Select the option Delete.
18.3 Derived Projects
This section explains the concept of a derived project. First, background on the use of derived projects is
presented in sub-section 18.3.1. Then, sub-section 18.3.2 explains the procedure for creating a derived
project.
18.3.1 Derived Projects Background
Often, several users might wish to work on the same project. To avoid the large amount of data duplica-
tion needed to create a project copy for each user, DIgSILENT has developed a virtual copy approach
called derived projects. From a users point of view a derived project behaves like a normal copy of a
project version. However, only the differences between the original project version (Base Project ) and
the virtual copy (derived project ) are stored in the database. Because the derived project is based on a
version, changes made to the base project do not affect it. Like normal projects, derived projects can
be controlled in time by versions, but these derived versions cannot be used to create further derived
projects.
Note: A derived project is a local virtual copy of a version of a base project (master project):
- It behaves like a real copy from the users point of view.
- Internally only the data differences between the Base Project and the derived project are stored
in the database.
- This approach reduces the data overhead.
In a multi-user database, the data administrator might publish a base project in a public area of the
database. Every user can subsequently create their own derived project and use as if it is the original
base project. Changes made by individual users are stored in their respective derived projects, so that
the base project remains the same for all users.
The purpose of a derived project is that all users work with an identical power system model. The
derived project always remains connected to the base project.
The concept of derived projects is illustrated in Figure 18.3.1; here version Version3 of the base project
(MasterProject) was used to create DerivedProject. After DerivedProject was created, two Versions
of it were created.
DIgSILENT PowerFactory 15, User Manual 301
CHAPTER 18. DATA MANAGEMENT
Figure 18.3.1: Principle of Derived Projects
At any stage, the data administrator might create a version of a base project that has derived projects
from other versions of the base project. The user might wish to update their derived project with one of
these new versions. Alternatively, the data administrator might like to incorporate changes made in a
derived project to the base project. All of these features are possible, by using the Compare and Merge
Tool, explained in section 18.4.
Figure 18.3.2: Derived Projects in a multi-user database
In the Data Manager a derived project looks like a normal project. The Derived Project page of its
dialogue has a reference where the user can see the base project and the version used for deriving the
project.
Users are notied of changes in the base project, if there is a new version of the base project (newer than
the used version) which has the option Notify users of derived projects enabled (the user/administrator
enables this option when creating a new version), and the option Disable notication at activation dis-
abled (found within the derived project tab of the project dialogue).
The option of updating a derived project is presented to the user when they next activate the derived
project, when the conditions above are met. The newest version that can be used to update a derived
project is referred to (if available) in the Most recent Version eld of the dialogue. The users can
compare this new version with their own derived project and decide which changes to include in the
derived project. For comparing and accepting or refusing individual changes, the Compare and Merge
Tool is used. For information about the Compare and Merge Tool refer to section 18.4.
302 DIgSILENT PowerFactory 15, User Manual
18.3. DERIVED PROJECTS
Figure 18.3.3: New Version of the base project in a multi-user database
Figure 18.3.4: Merging the new Version of the base project into the Derived Projects
18.3.2 How to Create a Derived Project
A new derived project is created using the Data Manager as follows:
1. Right-click the desired folder in the right pane of the Data Manager where the derived project is to
be created.
2. Select New Derived Project from the context-sensitive menu.
3. Select the source version of the base project using the data browser that appears. This will likely
be the last available version of a project in a public area, created by the data administrator.
4. Press OK.
Note: The base or master project has to have at least one version before other projects can be derived
from it.
-You cannot derive a project from a derived project.
- You can check if a project is derived or not by opening the Edit dialogue of the project itself and
selecting the derived project tab.
DIgSILENT PowerFactory 15, User Manual 303
CHAPTER 18. DATA MANAGEMENT
To create a derived project from a Base Project stored in another users account, you need at least
read access, see Section 18.6.
After the derived project is created, it can be used like a normal project.
The Derived Project can be exported as a Regular Project or with the Base Project. The option can
be selected from the Export Dialogue.
18.4 Comparing and Merging Projects
This section describes the procedure for comparing and merging projects within the PowerFactory
database. There are many circumstances when you might need to merge together data from multi-
ple projects. For example, one of the most common would be when the data administrator updates a
master project that is the base project for a derived project that you are working with. The Compare
and Merge Tool (CMT) can be used to update your project with the data changes, but it also gives you
control over what changes you implement.
This section is separated into six sub-sections. Firstly, the background of the CMT is presented. The
next sub-section explains the procedure needed for merging together or comparing two projects. Sub-
section 18.4.3 explains the procedure for merging or comparing three projects. In sub-section 18.4.4,
the advanced options of the CMT are explained. The CMT uses a diff browser for showing the differ-
ences and conicts between compared projects and also for allowing you to make data assignments.
This is explained in sub-section 18.4.5.
18.4.1 Compare and Merge Tool Background
During collaborative working in a multi-user environment, a data administrator might often need to up-
date the Master project to create a version based on updates completed by one or more users to derived
projects of the Master project. PowerFactory has a specic tool called the Compare and Merge Tool
(CMT), that is used for this purpose. This tool can also be used for project comparison in addition to the
merging of project data. It is capable of a two way comparison between two projects and also a three
way comparison for three projects.
Internally, PowerFactory refers to each of the compared projects according to the following nomencla-
ture:
<Base> Project - the base project for comparison.
<1st> - the rst project to compare to the <Base> project.
<2nd> - the second project to compare to the <Base> project and to the <1st> project (three
way comparison only).
The CMT internally compares the chosen projects and generates an interactive window known as the
CMT diff browser to show the differences. For a two-way merge, the changes found in the <1st>Project
can be implemented in the <Base>, provided that the user selects <1st> as the source (<Base> is
by default the target ). When merging together three projects, the target is either the <1st> or <2nd>
project.
304 DIgSILENT PowerFactory 15, User Manual
18.4. COMPARING AND MERGING PROJECTS
18.4.2 How to Merge or Compare two projects using the Compare and Merge
Tool
This section describes the procedure for merging together or comparing two projects using the Compare
and Merge Tool (CMT). Note the comparison procedure is completed using a similar procedure but with
slight differences that will also be explained here.
To merge or compare two Projects:
1. In the data manager, right-click an inactive project and choose Select as Base to Compare.
2. Right-click a second (also inactive) project and select Compare to [Name of Base Project]. The
CMT options dialogue will appear as shown in Figure 18.4.1. The <Base> and the <1st> project
are listed in the Compare section of the dialogue.
Figure 18.4.1: Compare and Merge Tool options dialogue
3. Optional : If you want to include a third project in the comparison, the box next to <2nd> must be
checked. The third project can then be selected with a data browser by using the icon. Please
see Section 18.4.3 for a more detailed explanation of the 3-way comparison.
4. Optional : If you decide that you need to switch the base and compare projects you can press the
button. For instance in Figure 18.4.1, if you would like Project A to be the <1st> project and
Project B to be the <Base>.
5. Select one of the options Compare only, Manually or Automatically. The differences between
these three choices are explained below:
Compare only: If you only want to compare the two projects and no merge is desired, then
select the radio button Compare only. This disables the merge functionality and only the
differences between the two projects will be shown.
Manually: When this option is selected, you will later be asked to make assignments (to
choose the source project data for common objects that are merged together). For this
option, the target project can also be selected. Selecting <Base> will merge changes into
the <Base> project, whereas selecting <1st> will instead merge changes into the <1st>
comparison project.
Automatically: When this option is selected, PowerFactory will attempt to automatically merge
the two projects together, by automatically making data assignments. In a two-way compar-
ison, merging will be automatically into the base project (the base is automatically assumed
to be the target for the merging procedure). Note that if conicts are detected during an
automatic merge, the CMT will automatically switch to manual mode.
6. Press Execute to run the compare or merge. The CMT diff browser will appear (unless an au-
tomatic merge was selected and no conicts were identied by PowerFactory ). Interpreting and
using the diff browser is described in Section 18.4.5.
DIgSILENT PowerFactory 15, User Manual 305
CHAPTER 18. DATA MANAGEMENT
Note: It is possible to assign user dened names for each of the compared projects to make it more con-
venient for remembering which project is being referred to by the CMT later on in the diff browser
(see Section 18.4.5). For example, you might wish to name two compared projects something like
Master and User. Custom names can be implemented by typing the desired name in the as ...
eld in the CMT options dialogue shown in Figure 18.4.1. These user-dened names are limited
to a maximum of ten characters.
18.4.3 How to Merge or Compare three projects using the Compare and Merge
Tool
This section describes the procedure for merging together or comparing three projects using the Com-
pare and Merge Tool (CMT). The comparison procedure is completed using a similar method to a
two-way merge or compare but with slight differences that will be explained here.
To merge or compare three Projects:
1. In the data manager, right-click an inactive project and choose Select as Base to Compare.
2. In the window on the right of the data manager, hold the CTRL key to multi-select a second and
third inactive project.
3. Right-click the multi-selection and select the option Compare to <project>. The CMT options
dialogue will appear as shown in Figure 18.4.2. The <Base>, the <1st> and the <2nd> project
are listed in the Compare section of the dialogue.
Figure 18.4.2: Compare and Merge Tool options dialogue for a three way merge
4. Select one of the options Compare only, Manually or Automatically. The differences between
these three choices are explained below:
Compare only: If you only want to compare the two projects and no merge is desired, then
select the radio button Compare only. This disables the merge functionality and only the
differences between the two projects will be shown.
Manually: When this option is selected, you will later be asked to make assignments (to
choose the source project data for common objects that are merged together). For this
option, the target project can also be selected. or a three-way merge you cannot merge into
the <Base>, either the <1st> or the <2nd> project must be selected.
Automatically: When this option is selected, PowerFactory will attempt to automatically merge
the three projects together, by automatically making data assignments. As for the Manually
option, the target can be either the <1st> or <2nd> project. Note that if conicts are de-
tected during an automatic merge, the CMT will automatically switch to manual mode.
306 DIgSILENT PowerFactory 15, User Manual
18.4. COMPARING AND MERGING PROJECTS
5. If using the Manually or Automatic options, you must choose the Assignment priority, by selecting
an option from the Assign drop-down menu. This denes the default assignment in the CMT diff
browser (or automatic merge) when PowerFactory identies conicts. For example, say the CMT
identies that the load called L1 has an active power of 10 MW in <Base>, 12 MW in <1st> and
13 MW in <2nd>. By choosing the option Automatically and favor 1st, the default assignment for
L1 would be <1st> and a power of 12 MW would be assigned to this load in the target project if
you did not alter the assignment manually.
6. Press Execute to run the compare or merge. The CMT diff browser will appear (unless an au-
tomatic merge was selected and no conicts were identied by PowerFactory ). Interpreting and
using the diff browser is described in Section 18.4.5.
Note: It is possible to assign user dened names for each of the compared projects to make it more
convenient for remembering which project is being referred to by the CMT later on in the diff
browser (see Section 18.4.5). For example, a user might wish to name two compared projects
something like Master and User. Custom names can be implemented by typing the desired name
in the as ... eld in the CMT options dialogue shown in Figure 18.4.1. These user-dened names
are limited to a maximum of ten characters.
18.4.4 Compare and Merge Tool Advanced Options
The Advanced Options page of the CMT shown is shown Figure 18.4.3.
Figure 18.4.3: Compare and Merge Tool Advanced Options
Search correspondents for added objects
This option is only available for a three way merge and is enabled by default. If enabled then
PowerFactory can automatically align two independently added objects as being the same
object. This option can be useful when completing a comparison on projects where users
have added the same object (same name) in each of their respective projects and you want
to make sure PowerFactory identies this object as being the same object. Note this option
is only considered when the Identify correspondents always by name/rules option is also
enabled.
Consider approval information
By default this option is disabled, which means that information in the object description page
under Approval Information is not compared. For example, when this option is disabled if an
objects Approval status changes from Not Approved to Approved or vice versa, then this
modication would not be registered by the CMT comparison engine.
Depth
DIgSILENT PowerFactory 15, User Manual 307
CHAPTER 18. DATA MANAGEMENT
This option controls whether the CMT compares only the selected objects or also all objects
contained within the compared objects. By default, Chosen and contained objects is enabled
which means the CMT compares all objects within the selected comparison objects. This is
generally the most appropriate option when merging projects.
Ignore differences <
This eld controls the sensitivity of the comparison engine when comparing numerical pa-
rameters. If the difference between two numerical parameters is less than the value entered
into this eld, then the comparison will show the two values as equal =.
18.4.5 Compare and Merge Tool diff browser
After the CMT options are set, and the button Execute is used to start the CMT comparison. Then
the comparison and assignment results are presented in a data browser window (the CMT diff browser
window shown in Figure 18.4.4). The diff browser is divided into three parts:
The Data Tree Window on the left;
The Comparison and Assignment Window on the right; and
The Output Window at the bottom.
These features are explained in the following sections.
Figure 18.4.4: Compare and Merge Tool diff browser after a three-way merge
The Output Window
The Output window displays reports from the context sensitive right-click menu and other error informa-
tion.
How to use the Comparison and Assignment Window
In the CMT Comparison and Assignment Window, a list of the compared objects is shown. The win-
dow appears slightly different depending on whether a two way merge, a three way merge or a com-
parison has been completed. For instance, after a comparison, the Assigned from and Assignment
Conict columns are not shown. After a two-way merge, the columns with the project names will show
<Base> and <1st> (or user-dened names), whereas after a three-way merge they will show <1st>
and <2nd>. A comparison result symbol, indicating the differences found for each object from the list,
308 DIgSILENT PowerFactory 15, User Manual
18.4. COMPARING AND MERGING PROJECTS
is displayed in the columns <Base> and <1st> after a two-way merge and in columns <1st> and
<2nd> after a three-way merge. The possible combinations of these symbols are shown and explained
in Tables 18.4.1 and 18.4.2.
Base 1st Comment
Objects are identical in all projects
A parameter of the object is modied in the
<2nd> project
A parameter of the object is modied in
<1st> project
A new object in the <2nd> project
A new object in <1st> project
Object removed in <2nd> project
Object removed in <1st> project
Modied in both projects but the same
modications in both
Modied in both projects but the modica-
tions are different
Modied in the <1st> project and re-
moved in the <2nd> project
Modied in the <2nd> project and re-
moved in the <1st> project
dentical object added in both projects
Object added in both projects but parame-
ters are different
Object removed in both projects
Table 18.4.2: Possible results after a three-way comparison or merge
For a project merge (i.e. the Merge option was enabled in the command dialogue), the Assigned from
must dene the source project of the changes to implement in the target project. All listed objects must
have an Assignment. If you dont want to implement a certain change in the target; then the target
project must be selected as the source.
You should pay special attention to all results indicated with the conict symbol . This symbol
indicates that objects are different in both compared projects or that another error has occurred. In the
case of conicts, you must always indicate to PowerFactory the source project for the data.
In a two-way merge, the only available sources for assignment are the <Base> (which is also the
target) and <1st>. In a three-way merge, the possible sources are <Base>, <1st> and <2nd>. The
assignment can be made manually by double-clicking on the corresponding cell in the Assigned from
column and selecting the desired source, or double-clicking the <Base>, <1st> or <2nd> cell that you
wish to assign. However, this task can be tedious in large projects where there are many differences.
To rapidly assign many objects, the objects can be multi-selected and then Assign from ... or Assign
with Children from ... can be selected from the context sensitive right-click menu.
Base 1st Comment
The object has been removed in the <1st> project
The object has been added to the <1st> project
A parameter of the object has been modied in <1st> project
The object is identical in both projects
Table 18.4.1: Possible results after a two way comparison or merge
DIgSILENT PowerFactory 15, User Manual 309
CHAPTER 18. DATA MANAGEMENT
After the assignment of all the objects, the projects can be merged by pressing the Merge button. The
changes are then automatically implemented in the target project.
Note: The Comparison and Assignment Window always shows the selected object in the Data Tree
Window in the rst row.
Data Tree Window
The windowon the left side of Figure 18.4.4 shows the Data Tree Window, which is similar in appearance
to the data manager tree. This window shows the compared objects in a normal project tree structure.
At each level of the tree, there is an indication on the right showing the status of the comparison of
the contained objects (and the object itself). The legend for the comparison indication is shown in
Table 18.4.3.
Icon/Text Meaning
Assignments/Comparison is okay
Conicts exist
Mixed/<Base>/<1st>/<2nd> The text indicates the assignments
within by indicating the assigned
project. If assignments within are from
multiple different sources, then Mixed
will show.
Assignments missing
Bold red font three way merge - information will be
lost during the merge two way merge
information could be lost during the
merge
Table 18.4.3: Data Tree Window Legend
Diff Browser Toolbar
As previously mentioned, the objects displayed in the CMT window can be sorted and organized by the
toolbar as shown in Figure 18.4.5. The available buttons are explained in this section.
Figure 18.4.5: Compare and Merge Tool diff browser toolbar
Modications to be shown The Modications to be shown drop-down menu allows the results
in the comparison windows to be ltered according to their comparison status. Possible lter
options for a three way comparison are:
All objects
All modications (default)
All modications in <1st> (show all modications, additions and deletions in the <1st> project)
All modications in <2nd> (show all modications, additions and deletions in the <2nd> project)
All modications in both (show only those objects which exist in both projects and have been
modied in both projects)
310 DIgSILENT PowerFactory 15, User Manual
18.4. COMPARING AND MERGING PROJECTS
All modications in both but different (show only those objects which exist in both projects and
have been modied in both projects to different values)
Added in <1st> (show only objects added in the <1st> project)
Modied in <1st> (show only objects modied in the <1st> project)
Deleted in <1st> (show only objects deleted in the <1st> project)
Added in <2nd> (show only objects added in the <2nd> project)
Modied in <2nd> (show only objects modied in the <2nd> project)
Deleted in <2nd> (show only objects deleted in the <2nd> project)
The following options are available for a two way comparison:
All objects
All modications
Added in <1st>
Modied in <1st>
Deleted in <1st>
Only one option can be selected at a time.
Show all objects inside chosen object This button will list all compared objects and also
all contained objects (at every level of the tree).
Show graphical elements Pressing this button will prevent graphical differences from ap-
pearing in the comparison window. Because graphical changes often occur, and can often be
trivial, for example a slight adjustment to the x-axis position of an object, this button is extremely
useful for organizing the data.
Detail mode and Detail mode class select The functionality of these two buttons is
identical to their function in the data manager.
Show only not assigned Filters the display to show only objects not yet assigned. This lter
is only available when the merge option is used. By default all assigned and unassigned objects
are displayed.
Show only Objects with assignment conicts Only objects with assignment conicts are
displayed. This lter is only available when the merge option is used. By default objects with and
without assignment conicts are displayed.
Group dependent objects If this option is enabled, dependent objects are listed indented
underneath each listed comparison object. A dependent object is dened as an object that is
referenced by another object. For example, a line type (TypLne) is a dependent object of a Line
Element (ElmLne), likewise the cubicles that connect the Line Element to a terminal. If the objects
are grouped and not ltered otherwise, every object has to be listed at least once but can be listed
several times as a dependency. Non-primary objects (such as graphical elements) are only listed
separately if they are not listed as a dependency for another object.
Dependent objects are not ltered. By default, the grouping of dependent objects is not displayed
because this type of display can quickly expand to become unusable because in a typical project
there are many dependencies.
Diff window right-click menu options
DIgSILENT PowerFactory 15, User Manual 311
CHAPTER 18. DATA MANAGEMENT
A context sensitive menu can be activating by right-clicking a cell or object in the tree window
or the comparison and assignment window. The following options are available: Show Object
... A project selection window will appear so that you can show specic object data. After you
choose the reference project, the dialogue of the selected object is then displayed. The displayed
dialogue is read-only.
Output Modication Details This prints a report to the output window showing the details of the
differences for the selected objects. The format of the report is a ASCII table with the modied
parameters as rows and the parameter values in each compared project as columns. The date
and time of the last modication along with the database user who made the last change are
always shown in the rst two rows.
Output Non-OPD Modication Details This option is similar to the Output Modication Details
option, but it only shows the modications that are not classed as Operational Data.
Align Manually This option allows the compared objects to be realigned across the compared
projects. What this means is that disparate objects can instead be compared directly. This could
be useful for example when two different users have added an object to their derived projects but
each has given it a slightly different name, even though the objects are representing the same
real world object. The CMT would see these objects as different objects by default. In this case,
the data administrator might wish to tell PowerFactory that these two different objects are the
same object and this can be completed using the Align Manually function.
Ignore Missing References For every compared object missing references can be optionally
ignored. The assignment check then does not check the references of the object. Missing refer-
ences can also be considered again by using the Consider Missing References option. By default
missing references are not ignored.
Set Marker in Tree A right-click in the data tree window allows you to set a marker within the data
tree. This behaves somewhat like a bookmark and you can return to this point in the data tree at
any time by using the Jump to Marker ... in Tree. Note it is only possible to set one marker at a
time - setting a new marker will automatically over-write the last marker.
Diff window buttons
The various diff window buttons as highlighted in Figure 18.4.6 will now be explained.
Figure 18.4.6: Compare and Merge Tool Diff window with buttons highlighted
312 DIgSILENT PowerFactory 15, User Manual
18.5. HOW TO UPDATE A PROJECT
Check This button checks that all assignments are okay. The following conicts are checked for
all compared objects:
Missing assignment;
Missing parent (Parent object of an assigned object will not exist in the target after merge.)
Missing reference (Referenced object of an assigned object will not exist in the target after merge.)
All conicts are printed as errors to the output window of the CMT. Conicts are listed in groups
and with the icon in the data tree and comparison and assignment window.
Recompare After a realignment, it is necessary to run the CMT again using this button to update
the comparison results.
Merge The merge procedure updates the target by copying objects or parameters or deleting
objects according to the assignments. Before the merge procedure is started an assignment
check is done. The merge procedure is cancelled if the check detects conicts. If no conicts are
detected, the Diff Browser is closed and then the merge procedure is started. After the merge
procedure is complete all data collected by the CMT is discarded.
Info The Info dialogue called by the Info button shows more information about the comparison:
database path of the top level projects/objects that are being compared;
target for merge (only if merge option is active);
selected comparison options;
number of objects compared;
number of objects modied; and
number of objects with conicts (only if merge option is active).
18.5 How to update a Project
There are two common procedures that users and data administrators need to complete when working
with Master Projects and other user projects that are derived from versions of this Master project:
Updating a derived project with information from a new version; and
Updating a Master Project with information from a derived project.
This section explains these two procedures and also tips for working with the CMT.
18.5.1 Updating a Derived Project from a new Version
When a derived project is activated after a new version of the Base project has been created (provided
that the ag Notify users of derived projects was checked when the version was created and that the
derived project option Disable notication at activation is unchecked), then the user will be presented
with the dialogue shown in Figure 18.5.1.
DIgSILENT PowerFactory 15, User Manual 313
CHAPTER 18. DATA MANAGEMENT
Figure 18.5.1: New Version available - dialogue box
The options offered in the notication dialogue are:
Merge new version with derived project and
PowerFactory automatically generates a temporary copy derived of the new version and executes
a 3-way comparison with the base version of the users project (as the Base), the derived project
(as <1st>) and the temporary copy (as <2nd> and target). In the case of a conict, one of the
following actions will be taken:
favor none: The CMT diff browser is displayed, and the user can then resolve the conict(s) by
dening how the changes should be assigned.
favor derived project: Conicts are resolved automatically by favouring the users modications,
thereby discarding modications in the Base.
favor new version: Conicts are resolved automatically by favouring the Bases modications,
thereby discarding the users modications.
Get new version and discard modications in derived project The derived project is auto-
matically replaced by the new version. All user modications will be lost.
Merge manually Use the CMT to merge the modications manually. The results of the compar-
ison are displayed in a CMT diff browser, where the user denes how the changes should be
assigned. After these assignments have been dened, the new version and the derived project
are merged to the temporary copy, when the user clicks on the Merge button. The derived project
is then automatically replaced by the temporary copy (now containing information from the new
version), which is deleted.
Notify me again in... The user enters the desired time for re-notication, and the derived project
is activated according to how it was left in the previous session. The notication is deactivated
for the indicated number of days.
Note: In a multi-user environment, updated versions of the Base project can be released regularly and
the user will often be presented with the new version notication in Figure 18.5.1. In many cases,
the user will not want to apply the updated version because they will be in the middle of a project or
other calculation and dont want to risk corrupting or changing their results. Therefore, the option
Notify me again in... is the appropriate choice because it will leave the users project unchanged.
If the Cancel button is used, the project is activated as it was left in the previous session. The notication
will appear following the next activation.
An alternative way to manually initiate the above procedure is to right-click the derived project and select
the option Merge from base project. This feature is only possible with deactivated projects.
314 DIgSILENT PowerFactory 15, User Manual
18.6. SHARING PROJECTS
18.5.2 Updating a base project from a Derived Project
Changes implemented in derived projects can also be merged to the base project. In this case, the
option Merge to base project must be selected from the context-sensitive menu available by right-
clicking on the derived project. As in previous cases, the CMT is started and you can manually resolve
conicts using the diff browser.
18.5.3 Tips for working with the Compare and Merge Tool
One of the most common uses of the CMT is for merging changes made by users to their derived
projects back into the Master project to create an updated version for all users. Such a task is often
done by the data administrator. For this task it can help to follow the steps as outlined below:
1. Check the users modications with a 2-way merge (derived vs. base; What changes were done?
Are all changes intended? Modications which were made by mistake should be corrected in the
users derived model before continuing with the merge procedure.). The check of the modications
should be done by the user and the data administrator.
2. The data administrator creates a new derived project based on the most recent version of the
Master model.
3. A three way merge is done, selecting the version on which the users derived project is based on
as Base, the derived project created in the previous step as <1st> and the users derived project
as <2nd>. The changes are merged into <1st> (target).
4. The resulting model is then validated. Conicts which could not be solved automatically by the
CMT are corrected manually.
5. The validated model (derived project in data administrator account) is merged to the base model
by using the context sensitive menu entry Merge to Base Project. This will not cause problems if
the master model has not been changed since deriving the model in step 2.
6. A new version is created by the data administrator and the users informed.
Note: The Compare and Merge Tool can be used to compare any kind of object within a PowerFactory
project. The functionality and procedure to follow is similar to that explained in this section for
project comparison and merging.
18.6 Sharing Projects
In PowerFactory , any project can be shared with other users according to the rules dened by its owner.
Projects are shared to groups of users and not directly to individuals. Therefore, users must be part of
a group (created and managed by the data Administrator) in order to access shared projects.
Depending on the access level that the owner assigns to a group, other users can get:
read-only access to the shared project, which allows the copying of objects and the creation of
derived projects from versions within the shared project;
read-write access; This allows users full control over all objects within the project.
Full access. Full access allows the user to modify the sharing properties and create versions.
Each access level includes the rights of the lower levels.
To share a project:
DIgSILENT PowerFactory 15, User Manual 315
CHAPTER 18. DATA MANAGEMENT
1. Open the project dialogue by right-clicking the project name and selecting the option Edit.
2. Select the Sharing tab;
3. Right-click within the Groups or Sharing access level columns on the right side of the Sharing
information table to insert (or append) a row(s);
4. Double-click the Groups cell of the new line and select the group with whom the project is shared
using the data browser;
5. Double-click on the Sharing access level to select the desired access level.
A shared project is marked with the symbol in the Data Manager.
For information regarding users groups and the data administrator, please refer to Chapter 6 (User
Accounts and User Groups).
316 DIgSILENT PowerFactory 15, User Manual
Chapter 19
The DIgSILENT Programming
Language - DPL
19.1 Introduction
The DIgSILENT Programming Language DPL serves the purpose of offering an interface for automating
tasks in the PowerFactory program. The DPL method distinguishes itself from the command batch
method in several aspects:
DPL offers decision and ow commands
DPL offers the denition and use of user-dened variables
DPL has a exible interface for input-output and for accessing objects
DPL offers mathematical expressions
The DPL adds a new dimension to the DIgSILENT PowerFactory program by allowing the creation of
new calculation functions. Such user-dened calculation commands can be used in all areas of power
system analysis, such as
Network optimizing
Cable-sizing
Protection coordination
Stability analysis
Parametric sweep analysis
Contingency analysis
etc.
Such new calculation functions are written as program scripts which may use
Flow commands like if-then-else and do-while
PowerFactory commands (i.e. load-ow or short-circuit commands)
Input and output routines
DIgSILENT PowerFactory 15, User Manual 317
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
Mathematical expressions
PowerFactory object procedure calls
Subroutine calls
19.2 The Principle Structure of a DPL Command
The principle Structure of a DPL script is shown in Figure 19.2.1.
Figure 19.2.1: Principle of a DPL command
The DPL command object ComDpl is the central element, which is connecting different parameter,
variables or objects to various functions or internal elements and then puts out results or changes
parameters.
As the input to the script can be predened input parameters, single objects from the single line dia-
gram or the database or a set of objects/elements, which are then stored inside a so called General
Selection.
These input information can then be evaluated using functions and internal variables inside the script.
Also internal objects can be used and executed, like
a calculation command, i.e. ComLdf, ComSim, etc., especially dened with certain calculation
options
subscripts also released in DPL
lter sets, which can be executed during the operation of the script
Thus the DPL script will run a series of operation and start calculation or other function inside the script.
It will always communicate with the database and will store changed settings, parameters or results
directly in the database objects. There is nearly no object inside the active project, which can not be
accessed or altered.
318 DIgSILENT PowerFactory 15, User Manual
19.3. THE DPL COMMAND OBJECT
During or at the end of the execution of the DPL script, the results can be outputted or parameters of
elements my be changed. There is the possibility to execute a predened output command ComSh or
to dene own outputs with the DPL commands available.
19.3 The DPL Command Object
The DPL command object ComDpl holds a reference to a remote DPL command when it is not a root
command. The example depicted in Figure 19.3.1 is apparently a referring command, since its DPL
script reference is set to the remote command \ Library\ DPL Commands\ CheckVLoading.
Figure 19.3.1: A DPL command
A root command has its own script on the script page of the dialogue.
A referring command uses the script of the remote DPL command.
19.3.1 Creating a new DPL Command
A DPL Command ComDpl can be created by using the New Object ( ) icon in the toolbar of the data
manager and selecting DPL Command and more. Then press OK and a new DPL command is created.
The dialogue is now shown and the parameters, objects and the script can now be specied.
This dialogue is also opened by double-clicking a DPL script, by selecting Edit from the context sensitive
menu or by selecting the script from the list when pressing the icon .
DIgSILENT PowerFactory 15, User Manual 319
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
19.3.2 Dening a DPL Commands Set
The DPL command holds a reference to a selection of objects (General Selection). At rst this general
selection is empty, but there are several ways to dene a special set of object used in the DPL command.
This DPL Commands Set (SetSelect ) can be specied through:
Select one or more elements in the single line diagram. Then right-click the selection (one of the
selected elements) and choose the option Dene. . . DPL Commands Set. . . from the context
sensitive menu.
It is also possible to select several elements in the data manager. Right-click the selection and
choose the option Dene. . . DPL Commands Set. . . from the context sensitive menu.
19.3.3 Executing a DPL Command
To execute a DPL command or to access the dialogue of a script, the icon can be activated. This
will pop up a list of available DPL scripts from the global and local library.
The easiest way to start a DPL command AND dene a selection for it is
To select one or more elements in the single line diagram or in the data manager and then right-
click the selection.
Choose the option Execute DPL Scripts from the context sensitive menu.
Then select a DPL script from the list. This list will show DPL scripts from the global as well as
from the local library.
Select a DPL script, insert/change the variables and then press the button Execute
In this way the selection is combined into a DPL Commands Set and the set is automatically selected
for the script chosen.
Only one single DPL command set is valid at a time for all DPL scripts. This means that setting the DPL
command set in one DPL command dialogue, will change the DPL command set for all DPL commands
in the database.
Note: To choose different sets for various DPL scripts you can either use different selection object Set-
Select like the General Set. Or new DPL command sets can be created and selected inside the
active study case. This is done by pressing , selecting other and the element Set (SetSelect )
and then selecting the set type.
The interface section Input Parameters is used to dene variables that are accessible from outside the
DPL command itself. DPL commands that call other DPL commands as subroutines, may use and
change the values of the interface variables of these DPL subroutines.
The list of External Objects is used to execute the DPL command for specic objects. A DPL command
that, for example, searches the set of lines for which a short-circuit causes too deep a voltage dip at a
specic busbar, would access that specic busbar as an external object. Performing the same command
for another busbar would then only require setting the external object to the other busbar.
19.3.4 DPL Advanced Options
On the Advanced Options page a Remote script can be selected, which is then used by this script
instead of a local dened script on the next page Script. This is a so called referring command. The
root command as described above in the example uses the local dened script.
320 DIgSILENT PowerFactory 15, User Manual
19.4. THE DPL SCRIPT EDITOR
Also there can be Result parameters dened. These parameters are results from the script and they
are stored inside the result object. Hence it is possible to access them through the variable monitor and
display them in a plot.
19.3.5 DPL Script Page
The most important part of a DPL root command is of course the actual DPL program script. That script
is written on the Script page of a DPL root command dialogue, if no Remote script is selected.
On this page the DPL code of a already dened script is shown and/or new command lines can be
inserted for modifying this script or writing a new script. The available commands and the DPL language
are described in the following sections.
The edited program code also features a highlighting specially suited for handling DPL scripts.
19.4 The DPL Script Editor
There is also an own editor available for conveniently writing a DPL script. To activate this editor press
the icon on the bottom side of the Script page of a DPL command dialogue.
Now a new window will be opened in PowerFactory. Here the script can be written in a very convenient
way similar to the programming language C++. The highlighting will be activated automatically.
There are several tools which can be used in this editor:
With this icon Edit Object the edit dialogue of the script is opened and the user can Check the
modied script for errors or one can Execute it.
The script inside the editor and in the dialogue are synchronized each time the script is saved or
edited in the dialogue. If this Disconnect icon is pressed, the scripts will not be synchronized
anymore.
With the search icon the user can activate a Find, a Replace or also a Go To function inside the
editor.
With the search next icon nd/replace/go to the next matching word.
With the search previous icon nd/replace/go to the previous matching word.
With the these icons bookmarks can be set in the editor. Also jump from one bookmark to the next
or previous as well as clear all bookmarks
When nished editing, press the icon and the script will be synchronized with the main dialogue.
One can also jump to the main graphics board by selecting the option Window Graphic. . . from the
main menu.
19.5 The DPL Script Language
The DPL script language uses a syntax quite similar to the C++ programming language. This type of
language is intuitive, easy to read, and easy to learn. The basic command set has been kept as small
as possible.
The syntax can be divided into the following parts:
DIgSILENT PowerFactory 15, User Manual 321
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
variable denitions
assignments and expressions
program ow instructions
method calls
The statements in a DPL script are separated by semicolons. Statements are grouped together by
braces. Example:
statement1;
statement2;
if (condition)
{
groupstatement1;
groupstatement2;
}
19.5.1 Variable Denitions
DPL uses the following internal parameter types
double, a 15 digits real number
int, an integer number
string, a string
object, a reference to a PowerFactory object
set, a container of object
Vectors and Matrices are available as external objects.
The syntax for dening variables is as follows:
[VARDEF] = [TYPE] varname, varname, ..., varname;
[TYPE] = double | int | object | set
All parameter declarations must be given together in the top rst lines of the DPL script. The semicolon
is obligatory.
Examples:
double Losses, Length, Pgen;
int NrOfBreakers, i, j;
string txt1, nm1, nm2;
object O1, O2, BestSwitchToOpen;
set AllSwitches, AllBars;
19.5.2 Constant parameters
DPL uses constant parameters which cannot be changed. It is therefore not accepted to assign a value
to these variables. Doing so will lead to an error message.
The following constants variables are dened in the DPL syntax:
322 DIgSILENT PowerFactory 15, User Manual
19.5. THE DPL SCRIPT LANGUAGE
SEL is the general DPL selection
NULL is the null object
this is the DPL command itself
Besides these global constants, all internal and external objects are constant too.
19.5.3 Assignments and Expressions
The following syntax is used to assign a value to a variable:
variable = expression
variable += expression
variable -= expression
The add-assignment += adds the right side value to the variable and the subtract-assignment -=
subtracts the right-side value.
Examples:
double x,y;x = 0.5
*
pi(); ! x now equals 1.5708
y = sin(x); ! y now equals 1.0
x += y; ! x now equals 2.5708
y -= x; ! y now equals -1.5708
19.5.4 Standard Functions
The following operators and functions are available:
Arithmetic operators: +, -,
, /
Standard functions ( all trigonometric functions based on radians (RAD))
DIgSILENT PowerFactory 15, User Manual 323
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
function description example
sin(x) sine sin(1.2)=0.93203
cos(x) cosine cos(1.2)=0.36236
tan(x) tangent tan(1.2)=2.57215
asin(x) arcsine asin(0.93203)=1.2
acos(x) arccosine acos(0.36236)=1.2
atan(x) arctangent atan(2.57215)=1.2
sinh(x) hyperbolic sine sinh(1.5708)=2.3013
cosh(x) hyperbolic cosine cosh(1.5708)=2.5092
tanh(x) hyperbolic tangent tanh(0.7616)=1.0000
exp(x) exponential value exp(1.0)=2.718281
ln(x) natural logarithm ln(2.718281)=1.0
log(x) log10 log(100)=2
sqrt(x) square root sqrt(9.5)=3.0822
sqr(x) power of 2 sqr(3.0822)=9.5
pow (x,y) power of y pow(2.5, 3.4)=22.5422
abs(x) absolute value abs(-2.34)=2.34
min(x,y) smaller value min(6.4, 1.5)=1.5
max(x,y) larger value max(6.4, 1.5)=6.4
modulo(x,y) remainder of x/y modulo(15.6,3.4)=2
trunc(x) integral part trunc(-4.58823)=-4.0000
frac(x) fractional part frac(-4.58823)=-0.58823
round(x) closest integer round(1.65)=2.000
ceil(x) smallest larger integer ceil(1.15)=2.000
oor(x) largest smaller integer oor(1.78)=1.000
Table 19.5.1: DPL Standard Functions
Constants:
pi() pi
twopi() 2 pi
e() e
Table 19.5.2: DPL Internal Constants
19.5.5 Program Flow Instructions
The following ow commands are available.
if ( [boolexpr] ) [statlist]
if ( [boolexpr] ) [statlist] else [statlist]
do [statlist] while ( [boolexpr] )
while ( [boolexpr] ) [statlist]
for ( statement ; [boolexpr] ; statement ) [statlist]
in which
[boolexpr] = expression [boolcomp] expression
[boolcomp] = "<" | ">" | "=" | ">=" | ">=" | "<>"
[statlist] = statement; | { statement; [statlist] }
Unary operators: .not.
324 DIgSILENT PowerFactory 15, User Manual
19.5. THE DPL SCRIPT LANGUAGE
Binary operators: .and. | .or. | .nand. | .nor. | .eor.
Parentheses: {logical expression}
Examples:
if (a<3) {
b = a
2;
}
else {
b = a/2;
}
while (sin(a)>=b
c) {
a = O:dline;
c = c + delta;
}
if (.not.a.and.b<>3) {
err = Ldf.Execute();
if (err) {
Ldf:iopt lev = 1;
err = Ldf.Execute();
Ldf:iopt lev = 0;
}
}
for (i = 0; i < 10; i = i+1){
x = x + i;
}
for (o=s.First(); o; o=s.Next()) {
o.ShowFullName();
}
Break and Continue
The loop statements do-while and while-do may contain break and continue commands. The
break and continue commands may not appear outside a loop statement.
The break command terminates the smallest enclosing do-while or while-do statement. The exe-
cution of the DPL script will continue with the rst command following the loop statement.
The continue command skips the execution of the following statements in the smallest enclosing do-
while or while-do statement. The execution of the DPL script is continued with the evaluation of the
boolean expression of the loop statement. The loop statement list will be executed again when the
expression evaluates to TRUE. Otherwise the loop statement is ended and the execution will continue
with the rst command following the loop statement.
Example:
O1 = S1.First();
while (O1) {
O1.Open();
err = Ldf.Execute();
if (err) {
! skip this one
O1 = S1.Next;
continue;
}
DIgSILENT PowerFactory 15, User Manual 325
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
O2 = S2.First();
AllOk = 1;
DoReport(0); !reset
while (O2) {
err = Ldf.Execute();
if (err) {
! do not continue
AllOk = 0;
break;
}
else {
DoReport(1); ! add
}
O2 = S2.Next();
}
if (AllOk) {
DoReport(2); ! report
}
O1 = S1.Next();}
19.5.6 Input and Output
The input command asks the user to enter a value.
input(var, string);
The input command will pop up a window with the string and an input line on which the user may enter
a value. The value will be assigned to the variable var.
The output command writes a line of text to the output window.
output(string);
The string may contain =- signs, followed by a variable name. The variable name will then be replaced
by the variables value.
Example:
input(diameter, 'enter diameter');
output('the entered value=diameter');
The example results in the pop up of a window as depicted in Figure 19.5.1.
Figure 19.5.1: The input window
The following text will appear in the output window:
DIgSI/dpl - the entered value=12.3400
326 DIgSILENT PowerFactory 15, User Manual
19.6. ACCESS TO OTHER OBJECTS
The output command is considered obsolete and has been replaced by the more versatile printf and
sprintf functions. Please see the DPL reference for detailed information.
19.6 Access to Other Objects
With the syntax for the parameter denitions, program ow and the input and output, it is already possi-
ble to create a small program. However, such a script would not be able to use or manipulate variables
of external objects. It would not be possible, for instance, to write a script that replaces a specic line
by possibly better alternatives, in order to select the best line type. Such a script must be able to access
specic objects (the specic line) and specic sets of objects (the set of alternative line types).
The DPL language has several methods with which the database objects and their parameters become
available in the DPL script:
The most direct method is to create an object, or a reference to an object, in the DPL command
folder itself. Such an object is directly available as object variable in the script. The variable
name is the name of the object in the database.
The DPL command set may be used. This method is only useful when the order in which the
objects are accessed is not important. The DPL command set is automatically lled when a
selection of elements is right-clicked in either the single line graphic or the data manager and the
option Execute DPL Script is selected.
The list of external objects is mainly used when a script should be executed for specic objects or
selections. The list of external objects is nothing more than a list of aliases. The external object
list is used to select specic objects for each alias, prior to the execution of the script.
19.6.1 Object Variables and Methods
If a database object is known to the DPL command, then all its methods may be called, and all its
variables are available. For example, if we want to change a load-ow command in order to force an
asymmetrical load-ow calculation, we may alter the parameter iopt net. This is done by using an
assignment:
Ldf:iopt net = 1; ! force unbalanced
In this example, the load-ow objects is known as the objects variable Ldf. The general syntax for a
parameter of a database object is
objectname:parametername
In the same way, it is possible to get a value from a database object, for instance a result from the
load-ow calculations. One of such a result is the loading of a line object, which is stored in the variable
c:loading. The following example performs the unbalanced load-ow and reports the line loading.
Example
00. int error;
01. double loading;
02. Ldf:iopt net = 1; ! force unbalanced
03. error = Ldf.Execute(); ! execute load-flow
04. if (error) {
05. exit();
06. } else {
07. loading = Line:c:loading; ! get line loading
08. output('loading=loading'); ! report line loading
DIgSILENT PowerFactory 15, User Manual 327
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
09. }
This examples is very primitive but it shows the basic methods for accessing database objects and their
parameters.
19.7 Access to Locally Stored Objects
Locally stored objects (also called internal objects) can be accessed directly. They are known in the
DPL script under their own name, which therefore must be a valid DPL variable name. It will not be
possible to access an internal object which name is My Load-ow\{}1
, for instance.
Internal objects may also be references to objects which are stored elsewhere. The DPL command
des not distinguish between internal objects and internal references to objects. An example is shown in
Figure 19.7.1, where a DPL script is shown on the left which has a load-ow command and a reference
to a line in its contents folder on the right.
Figure 19.7.1: DPL contents
The example DPL script may now access these objects directly, as the objects Ldf and Line. In
the following example, the object Ldf, which is a load-ow command, is used in line 01 to perform a
load-ow.
00. int error;
01. error = Ldf.Execute();
02. if (error) {
03. output('Load-flow command returns an error');
04. exit();
05. }
In line 01, a load-ow is calculated by calling the method Execute() of the load-ow command. The
details of the load-ow command, such as the choice between a balanced single phase or an unbal-
anced three phase load-ow calculation, is made by editing the object Ldf in the database. Many other
objects in the database have methods which can be called from a DPL script. The DPL contents are
also used to include DPL scripts into other scripts and thus to create DPL subroutines.
19.8 Accessing the General Selection
Accessing database objects by storing them or a reference to them in the DPL command would create
a problem if many objects have to be accessed, for instance if the line with the highest loading is to be
found. It would be impractical to create a reference to each and every line.
A more elegant way would be to use the DPL global selection and ll it with all lines. The data manager
offers several ways in which to ll this object DPL Command Set with little effort. The selection may
328 DIgSILENT PowerFactory 15, User Manual
19.9. ACCESSING EXTERNAL OBJECTS
then be used to access each line indirectly by a DPL object variable. In this way, a loop is created
which is performing the search for the highest loading. This is shown in the following example.
Example
00. int error;
01. double max;
02. object O, Omax;
03. set S;
04.
05. error =
Ldf.Execute();
! execute a load-flow
06. if (error) exit(); ! exit on error
07.
08. S =
SEL.AllLines();
! get all selected
lines
09. Omax = S.First(); ! get first line
10. if (Omax) {
11. max =
Omax:c:loading;
! initialize maximum
12. } else {
13. output('No lines
found in selection');
14. exit(); ! no lines: exit
15. }
16. O = S.Next(); ! get next line
17. while (O) { ! while more lines
18. if
(O:c:loading>max) {
19. max = O:c:loading; ! update maximum
20. Omax = O; ! update max loaded
line
21. }
22. O = S.Next();
23. }
24. output('max
loading=max for line');
!output results
25.
Omax.ShowFullName();
The object SEL used in line 08 is the reserved object variable which equals the General Selection in the
DPL command dialogue. The SEL object is available in all DPL scripts at all times and only one single
General Selection object is valid at a time for all DPL scripts. This means that setting the General
Selection in the one DPL command dialogue, will change it for all other DPL commands too.
The method AllLines() in line 08 will return a set of all lines found in the general selection. This set is
assigned to the variable S. The lines are now accessed one by one by using the set methods First()
and Next() in line 09, 16 and 22.
The line with the highest loading is kept in the variable Omax. The name and database location of this
line is written to the output window at the end of the script by calling ShowFullName().
19.9 Accessing External Objects
The DPL contents make it possible to access external object in the DPL script. The special general
selection object (SEL) is used to give all DPL functions and their subroutines access to a central
selection of objects. i.e. the DPL Command Set.
DIgSILENT PowerFactory 15, User Manual 329
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
Although exible, this method would create problems if more than one specic object should be ac-
cessed in the script. By creating references to those objects in the DPL command itself, the DPL
command would become specic to the current calculation case. Gathering the objects in the general
selection would create the problem of selecting the correct object.
To prevent the creation of calculation-specic DPL commands, it is recommended practice to reserve
the DPL contents for all objects that really belong to the DPL script and which are thus independent
on where and how the script is used. Good examples are load-ow and short-circuit commands, or the
vector and matrix objects that the DPL command uses for its computations.
If a DPL script must access a database object dependent on where and how the DPL script is used, an
External Object must be added to the external object list in the DPL root command. Such an external
object is a named reference to an external database object. The external object is referred to by that
name. Changing the object is then a matter of selecting another object.
In Figure 19.9.1, an example of an external object is given. This external object may be referred to in
the DPL script by the name Bar1, as is shown in the example.
Figure 19.9.1: DPL external object table
Example:
sagdepth = Bar1:u;
19.10 Remote Scripts and DPL Command Libraries
To understand the DPL philosophy and the resulting hierarchical structure of DPL scripts, the following
is important to understand:
330 DIgSILENT PowerFactory 15, User Manual
19.10. REMOTE SCRIPTS AND DPL COMMAND LIBRARIES
A DPL command either executes its own script or the script of another, remote, DPL command.
In the rst case, the DPL command is called a root command and the script is called a local
script. In the second case, the DPL command is called a referring command and the script
is called a remote script.
A root command may dene interface variables that are accessible from outside the script and
which are used to dene default values.
Each root command may dene one or more external objects. External object are used to make
a DPL command run with specic power system objects, selections, commands, etc.
A referring command may overrule all default interface values and all selected external objects of
the remote command.
Each DPL command can be called as a subroutine by other DPL commands.
The use of remote scripts, external objects and interface variables makes it possible to create generic
DPL commands, which may be used with different settings in many different projects and study cases.
The easiest way to develop a new DPL command is to create a new ComDpl in the currently active
study case and to write the script directly in that DPL object. In such a way, a DPL root command is
made. If this root command needs DPL subroutines, then one or more DPL command objects may be
created in its contents. Each of these subroutines will normally also be written as root functions.
The newly written DPL command with its subroutines may be tested and used in the currently active
study case. However, it cannot be executed when another study case is active. In order to use the DPL
command in other study cases, or even in other projects, one would have to copy the DPL command
and its contents. This, however, would make it impossible to alter the DPL command without having to
alter all its copies.
The solution is in the use of remote scripts. The procedure to create and use remote scripts is de-
scribed as follows.
Suppose a new DPL command has been created and tested in the currently active study case. This
DPL command can now be stored in a save place making it possible to use it in other study cases and
projects.
This is done by the following steps:
Copy the DPL command to a library folder. This will also copy the contents of the DPL command,
i.e. with all its DPL subroutines and other locally stored objects.
Generalize the copied DPL command by resetting all project specic external objects. Set all
interface variable values to their default values. To avoid deleting a part of the DPL command,
make sure that if any of the DPL (sub)commands refers to a remote script, all those remote
scripts are also stored in the library folder.
Activate another study case.
Create a new DPL command object (ComDPL) in the active study case.
Set the DPL script reference to the copied DPL command.
Select the required external objects.
Optionally change the default values of the interface variables
Press the Check button to check the DPL script
The Check or Execute button will copy all parts of the remote script in the library that are needed for
execution. This includes all subroutines, which will also refer to remote scripts, all command objects, and
all other objects. Some classes objects are copied as reference, other classes are copied completely.
DIgSILENT PowerFactory 15, User Manual 331
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
The new DPL command does not contain a script, but executes the remote script. For the execution
itself, this does not make a change. However, more than one DPL command may now refer to the same
remote script. Changing the remote script, or any of its local objects or sub-commands, will now change
the execution of all DPL commands that refer to it.
19.10.1 Subroutines and Calling Conventions
A DPL command object may be included in the contents of another DPL command. In that case, the
included DPL subroutine may be called in the script of the enclosing DPL command. In principle, this
is not different from calling, for example, a load-ow command from a DPL script.
As with most other command objects, the DPL command only has one method:
int Execute() ; executes the DPL script.
The difference is that each DPL subroutine has different interface parameters, which may be changed
by the calling command. These interface parameters can also be set directly at calling time, by providing
one or more calling arguments. These calling arguments are assigned to the interface parameters in
order of appearance. The following example illustrates this.
Suppose we have a DPL sub-command Sub1 with the interface section as depicted in Figure 19.10.1.
Figure 19.10.1: Interface section of subroutine
The calling command may then use, for example:
! set the parameters:
Sub1:step = 5.0;
Sub1:Line = MyLine;
Sub1:Outages = MySelection;
! execute the subroutine:
332 DIgSILENT PowerFactory 15, User Manual
19.11. DPL FUNCTIONS AND SUBROUTINES
error = Sub1.Execute();
However, using calling arguments, we may also write:
! execute the subroutine:
error = Sub1.Execute(5.0, MyLine, MySelection);
19.11 DPL Functions and Subroutines
The DPL syntax is very small because it mainly serves the purpose of basic operations like simple
calculations, if-then-else selections, do-while loops, etc..
The strength of the DPL language is the possibility to call functions and to create subroutines. A function
which can be called by a DPL command is called a method. Four types of methods are distinguished:
Internal methods These are the build-in methods of the DPL command. They can always be
called.
Set methods These methods are available for the DPL set variables.
Object methods These methods are available for the DPL object variables.
External methods These are the methods which are available for certain external PowerFactory
objects, such as the load-ow command, the line object, the asynchronous machine, etc.
Please see the Appendix D DPL Reference for a description of these functions including implementation
examples.
DIgSILENT PowerFactory 15, User Manual 333
CHAPTER 19. THE DIGSILENT PROGRAMMING LANGUAGE - DPL
334 DIgSILENT PowerFactory 15, User Manual
Chapter 20
PowerFactoryInterfaces
20.1 Introduction
PowerFactory supports a wide set of interfaces. Depending on the specic data exchange task the user
may select the appropriate interface.
The interfaces are divided as follows:
Interfaces for the exchange of data according to DIgSILENT specic formats:
DGS
StationWare (DIgSILENT GmbH trademark)
API
Interfaces for the exchange of data using proprietary formats:
PSS/E
NEPLAN
MATLAB
Interfaces for the exchange of data according to standardized formats:
UCTE-DEF
CIM
OPC
The above mentioned interfaces are explained in the following sections.
20.2 DGS Interface
DGS (DIgSILENT) is PowerFactorys standard bi-directional interface specically designed for bulk data
exchange with other applications such as GIS and SCADA, and, for example, for exporting calculation
results to produce Crystal Reports, or to interchange data with any other software package.
Figure 20.2.1 illustrates the integration of a GIS (Graphical Information System) or SCADA (Supervisory
Control And Data Acquisition) with PowerFactory via the DGS interface
DIgSILENT PowerFactory 15, User Manual 335
CHAPTER 20. POWERFACTORY INTERFACES
Here, PowerFactory can be congured either in engine or normal mode. When used in engine mode,
PowerFactory imports via DGS the topological and library data (types), as well as operational informa-
tion. Once a calculation has been carried out (for example a load ow or short circuit), the results are
exported back so they are displayed in the original application; which in this example relates to the
SCADA or GIS application. The difference with PowerFactory running in normal mode (see right section
of Figure 20.2.1) is that, besides the importing of data mentioned previously, the graphical information
(single line graphics) is additionally imported, meaning therefore that the results can be displayed di-
rectly in PowerFactory. In this case, the exporting back of the results to the original application would
be optional.
Figure 20.2.1: DGS - GIS/SCADA Integration
Although the complete set of data can be imported in PowerFactory every time a modication has been
made in the original application, this procedure would be impractical. The typical approach in such
situations would be to import the complete set of data only once and afterwards have incremental
updates.
20.2.1 DGS Interface Typical Applications
Typical applications of the DGS Interface are the following:
Importing to PowerFactory
Data Import/Update into PowerFactory from external data sources such as GIS (Network
Equipment), SCADA (Operational Data) and billing/metering systems (Load Data) in order to
perform calculations.
Exporting from PowerFactory
Performing calculations in PowerFactory and exporting back the results to the original appli-
cation.
Integration
Importing data sets to PowerFactory from GIS or SCADA, performing calculations, and ex-
porting back results to GIS or SCADA.
336 DIgSILENT PowerFactory 15, User Manual
20.2. DGS INTERFACE
20.2.2 DGS Structure (Database Schemas and File Formats)
PowerFactory s DGS interface is based on the PowerFactory data model. Data can be imported and
exported with DGS using different le formats and database schemas.
The following database schemas or le formats are supported:
Database Schemas
Oracle DB Server (ODBC client 10 or newer)
Microsoft SQL Server (ODBC driver 2000 or newer)
System DSN (ODBC)
File Formats
DGS File - ASCII
XML File
Microsoft Excel File (2003 or newer)
Microsoft Access File (2003 or newer)
Important to note here is that the content of the les is the same; the only difference being the format.
Note: It is highly recommended to use the latest available DGS version.
The core principle of DGS is to organize all data in tables. Each table has a unique name (within
the DGS le or database/table space) and consists of one or more table columns, where generally all
names are case-sensitive.
For more detailed information on the DGS structure, please refer to the DGS Interface document lo-
cated inside the PowerFactory installation folder (for example C:\DIgSILENT\pf140b523\DGS\). Also
available in the same location are some examples.
20.2.3 DGS Import
To import data via the DGS interface, the general procedure is as follows:
From the main menu go to File Import. . . DGS Format. . . which opens the DGS-Import
dialogue window.
Specify the required options in both the General and Options pages, and click on the Execute
button.
When importing DGS les, the user has two options:
1. Importing into a new project. With this option selected a newly generated project is left activated
upon completion.
2. Importing into an existing project. If an operational scenario and/or a variation is active at the
moment the import takes place, the imported data set will be divided correspondingly. For example
importing breaker status (opened/closed) while an operational scenario is active will store this
information in the operational scenario.
DIgSILENT PowerFactory 15, User Manual 337
CHAPTER 20. POWERFACTORY INTERFACES
The following sections describe each of these options.
General Settings Tab Page
Import into New Project By choosing this option, a project will be created where all the DGS
data will be stored. The user will have the option of specifying a specic name and location (other
than the default).
Import into Existing Project By choosing this option, the DGS data will be imported into an
already existing project. Here, the data can be selective and its not required that the imported
data must be complete. In some cases, most of the objects are already existent and only an
update is required for some of them.
Import from The source of the data to be imported is specied with this option. If a File Format
source is selected then the location and type of data (DGS, XML, MDB or XLS) must be specied.
If a Database Schema source is selected, then a DB service, User and Password information is
required (the SQL server option will require an extra Database information).
Note: The GIS conversion uses millimetre units with respect to the bottom-left origin and A0 paper
format limit (1188 x 840 mm). It could therefore be necessary to transform the GIS coordinates
before creation of the .DGS le.
For more detailed information on the General settings, please refer to the DGS Interface document
located inside the PowerFactory installation folder (for example C:\DIgSILENT\pf140b523\DGS\).
Options Settings Tab Page
Predened Library A predened library located somewhere else in the database can be selected. The
option of copying the library into the project is also available.
Options for DGS version <5.0
Create Switch inside Cubicle In cases where the source data has no switches dened inside
the cubicles, the enabling of this option will create the switches automatically during the import.
If switches already exist in a certain cubicle, the creation of switches in that particular cubicle is
ignored.
Replace non-printable characters If the source data contains not allowed characters (, ?,
etc.), they are replaced by an underscore character.
Use foreign keys (available only with the option Import into Existing Project) Every object in
PowerFactory provides a parameter named Foreign Key which can be used to identify the object
uniquely within its project. The parameter is a character eld with a maximum of 20 characters
and can be found on the Description page of the various property sheets.
If the DGS import interface is used for updating an existing network model the Name column
can be lled with the Foreign Key of an existing object. The object will then be identied by
this Foreign Key and the data dened in the DGS le will overwrite the objects parameters.
Parameters which are not included in the DGS le will remain unchanged.
Additional Parameters This eld is specied for internal use only. No extra information is re-
quired by the user.
For more detailed information on the Optional settings, please refer to the DGS Interface document
located inside the PowerFactory installation folder (for example C:\DIgSILENT\pf140b523\DGS\).
338 DIgSILENT PowerFactory 15, User Manual
20.2. DGS INTERFACE
20.2.4 DGS Export
In contrast to the DGS Import, where it is not relevant if a project is active or not; the DGS Export is
based on what information is active at the moment the export takes place. In other words, only the
active project, with the corresponding active Study Case, active Scenario, and active Variations are
exported (objects are exported in their current state). Furthermore, the export can be fully congured,
meaning that user has the option of selecting the amount of information to be exported per class object.
In general, the following data can be exported:
Element data
Type data
Graphic data
Result data (such as load ow results)
To export data via the DGS interface, the general procedure is as follows:
Import to PowerFactory the le DGS 5.0 Export Denitions.dz located inside the PowerFactory
installation folder (for example C:\DIgSILENT \pf140b523 \DGS\). The selected import location
can be anywhere inside the current user (a typical location would be directly inside the user).
By performing this step, a default variable set denition is imported (denition of the variables to
export via DGS). Instead of the user creating the variable set denition from scratch, the default
denition can be used and modied if required (increase or decreasing the amount of information
to be exported).
Note: In previous versions of PowerFactory (13.2), the default denition set is named DGS Variable-
Sets.dz.
The location however is the same (for example C:\DIgSILENT \pf132b343 \DGS \).
Activate the project to be exported, considering the which Study Case, Scenario and Variations
should be active.
From the main menu go to File Export. . . DGS Format. . . which opens the DGS-Export
dialogue window.
Specify the required options in both the General and Options pages, and click on the Execute
button.
The following sections describe each of these options.
General Settings Tab Page
DGS Version Version of the DGS structure. It is highly recommended to use 5.0 for PowerFactory
V14.0.
Format Output format. Either as ASCII, XML, MS Excel or MS Access le (for Excel or Access,
Microsoft Ofce must be installed on the computer) or as Oracle, MS SQL Server and ODBC
DSN databases (databases format available only for DGS Version 5.0).
Insert Description of Variables If checked, a description of the columns is included (only avail-
able for ASCII, XML and MS Excel).
Variable Sets With this option, the data exported will be according to the variable denitions
specied (see the explanation at the beginning of the section) It is required to select a folder that
contains the monitor variable objects (IntMon) related to each class that is to be exported.
DIgSILENT PowerFactory 15, User Manual 339
CHAPTER 20. POWERFACTORY INTERFACES
Options Settings Tab Page
Settings currently not relevant for DGS 5.0.
For more detailed information on the Variable Sets denitions (IntMon), please refer to the DGS Interface
document located inside the PowerFactory installation folder (for example C:\DIgSILENT \pf140b523
\DGS\).
20.3 PSS/E File Interface
Although both import and export functions for PSS/E les are integrated commands of PowerFactory ,
the export function is licensed separately. For more information on prices and licensing please contact
the sales department at mail@digsilent.de.
PSS/E Import supports versions 23 to 32 and can be performed by going to the main menu and selecting
File Import. . . PSS/E.
In the same manner, and provided the appropriate licensing exists, a project can be exported in PSS/E
format by selecting form the main menu File Export. . . PSS/E.
20.3.1 Importing PSS/E Steady-State Data
PowerFactory is able to convert both steady-state data (for load-ow and short-circuit analyses) and
dynamic data les. It is good practise to rst import the steady-state data (described in this section),
then to add the dynamic models (described in Section 20.3.2: Import of PSS/E le (Dynamic Data).
Before starting the next steps for importing a PSS/E le, please make sure that no project is active.
Once this has been conrmed, please select from the main menu File Import. . . PSS/E. By doing
so, the Convert PSS/E Files command dialogue seen in Figure 20.3.1 will be displayed, asking the user
to specify various options.
General Settings Page
340 DIgSILENT PowerFactory 15, User Manual
20.3. PSS/E FILE INTERFACE
Figure 20.3.1: PSS/E Import - General Settings
Nominal Frequency Nominal frequency of the le to be Converted/Imported.
PSS/E File Type
PSS/E Raw data Location on the hard disk of the PSS/E raw data le. By default the program
searches for
.raw extensions. The user may consider all types of les by typing
.
.
Sequence Data Location of the PSS/E sequence data le. By default the program searches for
.seq extensions. The user may consider all types of les by typing
.
.
Add Graphic Files Location of the PSS/E drw les on the le system. Again by default the
programs searches for les with extension
.drw. The user may consider all types of les by
typing
.
.
Note: After the Conversion/Importing has nished, the resulting project will contain a graphics folder
where all of the PSS/E drw converted graphics will be stored. The user must therefore relocate
each one of them to the corresponding diagram folder.
Save converted data in
Project The project name that will be assigned to the converted/imported le in PowerFactory.
in Location in the data manager tree where the imported le will be stored.
The following topics: Dyn. Models Data, Composite Frame Path, DSL - Model Path, Parameter
DIgSILENT PowerFactory 15, User Manual 341
CHAPTER 20. POWERFACTORY INTERFACES
Mapping; are not used for the import of steady-state data and will be explained in the dynamic import
Section 20.3.2.
Import Options Tab Page
Figure 20.3.2: PSS/E Import - Options
Convert only sequence data le With this option enabled, the converter will only add the se-
quence data to an existing project.
Convert only dynamic models le With this option enabled, the converter will only add the
dynamic data le to an existing project (only for dynamic data import).
Convert only graphic le With this option enabled, the converter will add only a single-line
diagram to an existing project.
Only convert le (no DB action) Internal option used for syntax check and error messages
during conversion. Normally this box should be left unchecked.
Output only used dynamic models Displays a list of used dynamic models (only for dynamic
data import).
Unit of LEN for lines in miles instead of km With this option enabled, all lengths will be
interpreted in miles in the PSS/E raw les.
Consider transformer phase shift With this option enabled, transformer phase shifts will be
considered. This option is recommended and activated by default.
Convert Induction Machines (Generators: P<0) With this option enabled, all generators in the
raw data le that have negative active power will be converted to asynchronous machines. For
transmission grids the option should be disabled for proper modelling of phase shift generators.
Automatic 3-W. Transformer detection/conversion In versions <27, PSS/E does not handle 3-
winding transformers as a dedicated model. In such cases, the 3-winding transformer is modelled
with three 2-winding transformers connected to a busbar. If this option is selected, the converter
342 DIgSILENT PowerFactory 15, User Manual
20.3. PSS/E FILE INTERFACE
will try to detect the existence of three 2-Winding Transformers connected to a busbar. If any can-
didates are available, PowerFactory will replace them by a 3-Winding Transformer. The detection
algorithm uses the impedances and the voltage control of the transformers as reference. From
version 27 onwards PSS/E supports the 3W-transformer model, so that PowerFactory does not
start an automatic detection of 3W-Trf modelled as 2W-Trfs.
Convert capacitive line shunts to line susceptance B If a line has line shunts the converter
adds automatically the line shunt capacitance to the C1 (B1) in the PowerFactory line type.
Convert Common Impedance as Transformer If this option is selected, the Common Impedance
in PSS/E may be converted to a PowerFactory common impedance or to a transformer.
Convert Series Capacitance as Common Impedance Older versions of PSS/E do not handle
series capacitances as a dedicated model. These elements therefore are represented by lines
with negative reactances. During the conversion, PowerFactory detects these branches and con-
verts them to series capacitances (by default) or to common impedances (when this option is
active).
Convert off-nominal turn ratio to transformer tap Transformer ratios different from the rated
ratio are automatically converted to a transformer type using taps, including the correct tap posi-
tion.
Busbar naming: PSSE NAME With this option enabled, the busbars are named similar to the
PSS/E raw data le (without bus number).
Branch naming: BUSNAME1 BUSNAME2 ID With this option enabled, the branches are
named as the name of the busbars + ID.
Additional Parameters This eld is specied for internal use only. No extra information is re-
quired by the user.
Import Graphical Options Tab Page
Figure 20.3.3: PSS/E Import - Graphical Options
Rotate with respect to busbars The converter will rotate the graphical layout in case of the
majority of busbars being in vertical or horizontal position.
Snap coordinates to grid The converter will snap to grid all objects in the single line graphics.
Transformer Symbol according to IEC This options lets the user choose the transformer sym-
bol as IEEE (default) or IEC representation.
Scaling factor The graphic les are scaled according to the scaling factor shown.
DIgSILENT PowerFactory 15, User Manual 343
CHAPTER 20. POWERFACTORY INTERFACES
20.3.2 Import of PSS/E le (Dynamic Data)
As explained in Section 20.3.1 it is good practise rst to import the steady-state data and then to add
the dynamic model data.
Before converting dynamic data, it is recommended to copy the Standard Models library folder located
in the global library into the user directory. The Standard Models dynamic data library folder can be
found under Library\Standard Models. This folder has the structure as shown in Figure 20.3.4.
Figure 20.3.4: Standard Models Library
The following folders and sub folders are of importance in the conversion / importing.
Standard Models This folder contains the information for most typical models; for example, auto-
matic voltage regulators (AVRs), power system stabilizers (PSS), primary controllers (PCO) and
others. The models are constructed in DIgSILENT Simulation Language (DSL). The folders also
may contain user-dened models.
Composite Model Frames This folder contains the composite frames which are basically wired
diagrams.
An important condition for successful le conversion is that all DSL models used during the conversion
process should be stored in the same model library folder. By default, this is the case in the global
PowerFactory library. If the original library should use specic folders for the different types of controllers
(AVR,PCO,PSS, etc.), the user should copy all of the models into the same library folder. After the
conversion, the user may re-arrange the models.
The procedure to start the import of dynamic network data is very similar to the import of steady-state
data. Some parameter adjustments have to be made.
General Settings Tab Page - Dynamic Model Import
In the dialogue of General Settings in Figure 20.3.1 the following topics have to be specied:
344 DIgSILENT PowerFactory 15, User Manual
20.3. PSS/E FILE INTERFACE
Dyn. Models Data Location of the PSS/E Dynamic Models data le. By default the program
searches for
.dyn and *dyr extensions. The user may consider all types of les by typing
.
.
Use Standard Models from global library If this option in enabled, PowerFactory will automat-
ically point to the Standard Models library located in the Global library. There will be no need of
selecting the composite Frame Path and DSL Model Path.
Composite Frame Path Location in the PowerFactory data base where the composite frames
are stored (Standard Models/Composite Models Frames. . . ).
DSL - Model Path Location in the PowerFactory data base where the DSL models are stored
(Standard Models. . . ).
Parameter Mapping Location of the PowerFactory mapping le. This is an option that normally
will not have to be dened by the user. By default PowerFactory will automatically set up its own
internal mapping le. This le denes how to translate the PSS/E internal models into Power-
Factory models, including the mapping of controller parameters. For automated conversion of
user-dened PSS/E controllers the mapping le may be customized. Please contact our support
if you wish to do so.
Import Options Tab Page - Dynamic Model Import
In the dialogue of Import Options in Figure 20.3.1 the following options should be considered:
Convert only dynamic models le With this option enabled, the converter will only add the
dynamic data le to an existing project.
Output only used dynamic models Displays a list of used dynamic models.
20.3.3 Exporting a project to a PSS/E le
This function allows the export of the network model in PSS/E format. The export comprises both
steady-state and dynamic data sets. The correct conversion of dynamic models is only possible for
the standard IEEE models. Models which the user implemented in PowerFactorys DSL can not be
automatically translated and must be modelled as user-dened controller types separately in PSS/E.
To export a project in PSS/E format select File Export. . . PSS/E from the main menu.
Export General Settings Tab Page
Figure 20.3.5: PSS/E Export - General settings
DIgSILENT PowerFactory 15, User Manual 345
CHAPTER 20. POWERFACTORY INTERFACES
RAW Conversion File Path and le name for the PSS/E RAW le, containing the symmetrical
description of the model.
SEQ Conversion File Path and le name for the PSS/E SEQ le, containing the additional de-
scription of the model necessary for unbalanced conditions.
DYN Conversion File Path and le name for the PSS/E DYN le, containing the dynamic models
of the project.
PSS/E Version Version of the exported PSS/E le (25 to 32).
Export Options Tab Page
Figure 20.3.6: PSS/E Export - Options
Convert Motors to Generators if P<0 With this option enabled, all asynchronous machines in
generator mode will be converted to synchronous machines.
Use serial number for bus numbering With this option enabled, the serial number information
stated in the Description page of each terminal will be used for the numbering. If the serial
number eld is empty, the numbering assigned will be according to the name (in ascending
order/alphabetical order).
Convert voltage controlled SVS to generator Selecting this option will convert the SVS models
(only the SVS set to voltage control) to generator models.
Export branch as single equivalent line Selecting this option will convert the branch models to
an equivalent line.
Base Apparent Power Base for the power values given in per-unit system.
Min (Zero) Impedance Branch Minimum impedance for ideal connections.
Export PSS/E-Area index as Here, two options are available:
Girds: The exported le will have the areas dened according to the Grids dened in the Power-
Factory model.
Areas: The exported le will have the areas dened according to the Areas dened in the Pow-
erFactory model.
Additional Parameters This eld is specied for internal use only. No extra information is re-
quired by the user.
346 DIgSILENT PowerFactory 15, User Manual
20.4. NEPLAN INTERFACE
20.4 NEPLAN Interface
PowerFactory offers to the user the option of importing different types of NEPLAN les. The les sup-
ported for importing are the following:
NEPLAN 4
Project File Data (.mcb) containing the topological, electrical and graphical data.
Line Data Type (.ldb) containing the line type information.
NEPLAN 5
Node Table (.ndt) containing the node data, such as rated voltages and loads.
Element table (.edt) containing the branch data, such as lines and transformers.
GIS/NMS Interface (.cde) containing the graphical information of all the networks which are
part of the NEPLAN project.
20.4.1 Importing NEPLAN Data
To import data via the NEPLAN interface, the general procedure is as follows:
From the main menu go to File Import. . . NEPLAN. . . which opens the NEPLAN-Import
dialogue window.
Specify the required options and click on the Execute button.
The NEPLAN data import always creates a new PowerFactory project. Once the import process has
been executed, the newly generated project is left activated upon completion.
Independent of the NEPLAN le version (4 or 5), the user has the option of importing the data with
or without graphical information. That is, if the user selects importing the data without graphical in-
formation, only the topological and electrical data will get imported, and no single line graphic will be
generated.
Importing NEPLAN 4 Files
When importing NEPLAN 4 les, the user has basically two options:
3. Selection of a
.mcb le.
If the user selects this type of le and if a corresponding
.ldb le is present (should be in the same
directory where the
.mcb is stored), then the information of both les gets imported. If only the
.mcb le exists, then only the information regarding this le is imported (which can also contain line
data).
4. Selection of a
.ldb.
If the user selects this type of le only the information regarding this le (line data) is imported.
Importing NEPLAN 5 Files
When importing NEPLAN 5 les, the user is only required to select the
.ndt. By doing so, the corre-
sponding
.edt le is automatically imported also. This basically means that a
.edt le must be present
otherwise the import will not be executed. The
.cde le is however optional. Additionally, all three les
must have the same name and must be in the same directory! As a recommendation, create a separate
folder and place all the les there.
The following section describes each of the NEPLAN import dialogue options.
DIgSILENT PowerFactory 15, User Manual 347
CHAPTER 20. POWERFACTORY INTERFACES
General Settings
Figure 20.4.1: NEPLAN Import - Settings
File Type
Neplan Data Location on the hard disk of the NEPLAN data le. Three types of les are available:
.mcb,
.ldb and
.ndt.
Save converted data in
Project The project name that will be assigned to the converted/imported le in PowerFactory.
in Location in the data manager tree where the imported le will be stored.
Common Conversion Settings
Import Graphic Information If this option is enabled then the graphical information is imported
and the single line diagram is generated. In case of NEPLAN 5 import the
.cde le is required.
Graphic Import Options (only for NEPLAN 5 import)
348 DIgSILENT PowerFactory 15, User Manual
20.5. UCTE-DEF INTERFACE
Additional Rotation Angle for 1-port Elements (deg) If a value different than 0 is stated,
then the single port elements (loads, generators, motors, etc.) are rotated counter clockwise
(degrees) with respect to the original position.
Automatically Scale to A0 If this option is selected, then the graphic is rescaled according
to the A0 page format.
Additional Parameters This eld is specied for internal use only. No extra information is re-
quired by the user.
20.5 UCTE-DEF Interface
In PowerFactory , both export and import of UCTE-DEF (Union for the Co-ordination of Transmission of
Electricity-Data Exchange Format) is supported. The UCTE interface is currently intended for import-
ing/exporting grid data of a country belonging to the former UCTE community.
The data contained in these les correspond basically to load ow and short circuit (3 phase) type data.
Furthermore, it only considers specic UCTE voltage levels according to voltage level codes, as well as
UCTE specic country codes, such as DK for Denmark, P for Portugal, etc.
Important to note here is that from 1
st
of July 2009, ENTSO-E (European Network of Transmission
System Operators for Electricity) took over all operational tasks of the 6 existing TSO associations in
Europe, including the Union for the Coordination of Transmission of Electricity (UCTE).
For more information related to the UCTE format, please refer to the following link:
https://www.entsoe.eu/resources/publications/former-associations/ucte/other-reports/
20.5.1 Importing UCTE-DEF Data
To import data via the UCTE interface, the general procedure is as follows:
From the main menu go to File Import. . . UCTE. . . which opens the UCTE-Import dialogue
window.
Specify the required options and click on the Execute button.
Once the import process has been executed, the project (new or existing) is left activated upon comple-
tion.
The following section describes each of the UCTE import dialogue options.
General Settings
DIgSILENT PowerFactory 15, User Manual 349
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.5.1: UCTE Import - Settings
Import into
New Project By choosing this option, a project will be created where all the UCTE data will be
stored. The user will have the option of specifying a specic name and location (other than the
default).
Existing Project By choosing this option, the UCTE data will be imported into an already existing
project.
File Type
Add UCTE Files Location on the hard disk of the UCTE les. Two types of les are available:
.uct and
.ucte. Additionally, the user may consider all types of les by typing
.
.
Options
Import for DACF process With this setting the user has the option to import the Day Ahead
Forecast.
Convert negative loads to generators With this option enabled, negative loads dened in the
UCTE le will be converted to generators in the PowerFactory model.
350 DIgSILENT PowerFactory 15, User Manual
20.5. UCTE-DEF INTERFACE
Convert transformer equivalent to common impedance With this option enabled, transformer
equivalents dened in the UCTE le will be converted to common impedances in the PowerFac-
tory model.
Automatically Scale to A0 If this option is selected, then the graphic is rescaled according to
the A0 page format.
Additional Parameters This eld is specied for internal use only. No extra information is re-
quired by the user.
20.5.2 Exporting UCTE-DEF Data
As in the other export interfaces, the UCTE Export is based on the active project at the moment the
export takes place. To export data via the UCTE interface, the general procedure is as follows:
Activate the project to be exported, considering the which Study Case, Scenario and Variations
should be active.
From the main menu go to File Export. . . UCTE. . . which opens the UCTE-Export dialogue
window.
Specify the required options, and click on the Execute button.
The following sections describe each of these options.
General Settings
Figure 20.5.2: UCTE Export - Settings
DIgSILENT PowerFactory 15, User Manual 351
CHAPTER 20. POWERFACTORY INTERFACES
File Type
UCTE Data Location on the hard disk where the UCTE les will be stored. Two types of les are
available:
.uct and
.ucte. Additionally, the user may consider all types of les by typing
.
.
Grids Selection of which grids to export.
Export UCTE voltage >= Only the elements having a voltage grater than the UCTE voltage
specied are exported.
Export branch as single equivalent line By enabling this option the export will convert the
PowerFactory branch denitions into single equivalent lines.
Use rst character of characteristic name as branch order code If checked, the characteristic
name (rst character) is used in the branch order code of the exported UCTE le.
20.6 CIM Interface
In PowerFactory , both export and import of CIM (Common Information Model) is supported. The CIM
interface is currently intended for importing/exporting the following prole:
ENTSO-E 2009
CIM is dened in IEC-61970, and its purpose is to allow the exchange of information related to the
conguration and status of an electrical system.
20.6.1 Importing CIM Data
To import data via the CIM interface, the general procedure is as follows:
From the main menu go to File Import. . . CIM. . . which opens the CIM-Import dialogue
window.
Specify the required options and click on the Execute button.
Once the import process has been executed, the project (new or existing) is left activated upon comple-
tion.
The following section describes each of the CIM import dialogue options.
General Settings
352 DIgSILENT PowerFactory 15, User Manual
20.6. CIM INTERFACE
Figure 20.6.1: UCTE Export - Settings
Import into
New Project By choosing this option, a project will be created where all the CIM data will be
stored. The user will have the option of specifying a specic name and location (other than the
default).
Active Project By choosing this option, the CIM data will be imported into the active project.
Import from
Prole Currently the prole ENTSO-E 2009 is supported.
CIM File Location on the hard disk of the CIM les. Two types of les are supported:
.zip and
.xml. Additionally, the user may consider all types of les by typing
.
.
separated Files With this setting the user has the option to import the equipment, topology and
solved state les separately.
Additional Parameters This eld is specied for internal use only. No extra information is re-
quired by the user.
20.6.2 Exporting CIM Data
As in the other export interfaces, the CIM Export is based on the active project at the moment the
export takes place. To export data via the CIM interface, the general procedure is as follows:
Activate the project to be exported, considering which Study Case, Scenario and Variations should
be active.
From the main menu go to File Export. . . CIM. . . which opens the CIM-Export dialogue
window.
Specify the required options, and click on the Execute button.
The following sections describe each of these options.
DIgSILENT PowerFactory 15, User Manual 353
CHAPTER 20. POWERFACTORY INTERFACES
General Settings
Figure 20.6.2: CIM Export - Settings
Export to
Prole Currently the prole ENTSO-E 2009 is supported.
CIM File Location on the hard disk where the CIM les will be stored. Two types of les are
supported:
.zip and
.xml. Additionally, the user may consider all types of les by typing
.
.
separated Files With this setting the user has the option to export the equipment, topology, and
solved state les separately.
Grids Selection of which grids to export.
Border Nodes Grid Selection of the grid which contains the X-nodes.
20.7 MATLAB Interface
For a detailed description on the MATLAB interface please refer to Chapter 25: Stability and EMT
Simulation, Section 25.14: MATLAB Interface.
354 DIgSILENT PowerFactory 15, User Manual
20.8. OPC INTERFACE
20.8 OPC Interface
PowerFactory s OPC (Object Linking and Embedding for Process Control) interface is an asynchronous
communication and data exchange mechanism used in process interaction and is widely applied in
SCADA and control systems.
This OPC-implementation assumes that the PowerFactory software is executed as an OPC-Client while
the OPC Server is controlled via the external source. OPC server libraries are available from various
manufacturers. An example of a freeware OPC-Server is that available from Matrikon (MatrikonOPC
Simulation Server).
Figure 20.8.1 illustrates the integration of a SCADA system with PowerFactory via the OPC interface.
In this OPC-implementation, PowerFactory can be used either in engine or normal mode. Some further
characteristics of this integration include:
OPC-Client/Server exchange of any PowerFactory object parameter as well as any signal (bi-
directional Data Exchange).
PowerFactory listening mode to receive any data or signal from a registered OPC Server.
PowerFactory sending mode to write back any data or signal to a registered OPC Server.
Figure 20.8.1: SCADA -PowerFactory integration via the OPC interface.
The OPC interface can be congured in two different modes:
Ofine
The bi-directional data exchange is carried out through an explicit command given by the user
in PowerFactory. For example, by pressing a button predened by the user in PowerFactory.
Online
The bi-directional data exchange is automatically carried out at a certain frequency rate;
where the frequency rate is determined by the user.
Note: The OPC functionality in PowerFactory is not considered part of the base package. For more
information on prices and licensing please contact the sales department at mail@digsilent.de.
DIgSILENT PowerFactory 15, User Manual 355
CHAPTER 20. POWERFACTORY INTERFACES
20.8.1 OPC Interface Typical Applications
Some typical applications of the OPC Interface are the following:
SCADA Online State Estimation
SCADA Simulation Mode, for example dispatcher load ow, switching validation.
SCADA Training Simulator
Importing to PowerFactory
in order to update the operational data.
in order to reect the Operator actions, such as breaker status and tap positions.
in order to perform state estimation based on the measured network data.
Exporting from PowerFactory
in order to update the SCADA interface with the calculated results.
20.9 StationWare Interface
This chapter describes the StationWareinterface. An introduction into StationWares general philosophy
is given in Section 20.9.1.
The following two sections describe the overall StationWarearchitecture (Section 20.9.2) and the con-
ceptual differences between PowerFactory and StationWare(Section 20.9.3).
Both PowerFactory and StationWarehave to be congured before they can be used together (Sec-
tion 20.9.4).
The Getting Started section (Section 20.9.5) provides a gentle introduction into the most important
features. The complete documentation can be found in the Reference section (Section 20.9.6).
The nal Technical Reference (Section 20.9.7) provides some deeper knowledge how PowerFactory
data is converted to StationWaredata and vice versa.
The terms StationWareand PSMS are used as synonyms throughout the whole chapter. PSMS stands
for Protection Settings Management System, and stresses the more internal and technical part of Sta-
tionWare.
20.9.1 About StationWare
DIgSILENT StationWareprovides a reliable central protection settings database and management sys-
tem for the complete power system substation data, both to manage the various control parameters and
to centrally store substation related information and data, based on latest .NET technology.
StationWarestores and records all settings in a central database, allows modelling of all relevant work
ow sequences, provides quick access to relay manuals, interfaces with manufacturer specic relay
settings software, and integrates with PowerFactory software, allowing for powerful and easy-to-use
settings co-ordination studies.
Modern numerical relays have a large number of settings that are determined, stored and communi-
cated by proprietary software solutions (these may even be suitable for only a particular manufacturer
or even a series or type of relay). This results in a fragmented and distributed settings database.
DIgSILENT StationWareprovides a single system that incorporates all such different device protocols,
356 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
thereby providing one manageable software data storage system, based on modern IT techniques,
facilitating data interfacing and exchange in a transparent and hassle free manner.
PowerFactory s data exchange facility allows it to access the settings stored in StationWare, such that
these may be used as input for the powerful PowerFactory system simulation and protection setting
tools. Settings that are calculated by using these tools may then be transferred back to StationWare.
20.9.2 Component Architecture
DIgSILENT StationWareis a so-called Client-Server Application: the functionality is distributed on at
least two computers: client and server. Figure 20.9.1 gives an overview on the components.
Figure 20.9.1: Architecture overview
Usually there are several clients. One main advantage of this architecture is the fact that the data is
stored in one central database on the server. One client connects to the server and fetches the data
from there, modies them, and afterward stores them back to the server. On other clients these changes
are visible.
DIgSILENT StationWareserver provides two interfaces to access from client machines:
Visualization by means of a standard web browser. The HTML interface can be used with an usual
web browser (e.g. Microsoft Internet Explorer or Mozilla Firefox) as shown in Figure 20.9.2.
The browser displays HTML pages which are created by StationWares HTML front end. The
HTML pages are transferred using the HTTP protocol on top of the TCP/IP internet protocol.
HTML allows to present all kind of data e.g. plain text, tables or images.
Additionally HTML provides concepts to achieve interactivity: by submitting HTML forms or press-
ing on hyperlinks data is sent to the server. The server interprets such requests and creates new
HTML pages which are displayed by the browser again.
DIgSILENT PowerFactory 15, User Manual 357
CHAPTER 20. POWERFACTORY INTERFACES
The web service interface, similar to the HTML interface uses the HTTP protocol to communi-
cate with the web service frontend, though no HTML pages are transferred but lower-level data
(SOAP/XML encoded). The web service client application is responsible to present this data con-
veniently.
PowerFactory is able to play the role of a web service client. It integrates parts of StationWares
data and concepts smoothly into its own world.
The functionality of the HTML interface is covered in the StationWaremanual. The remainder of this
chapter focuses on PowerFactory as client.
Figure 20.9.2: HTML interface
20.9.3 Fundamental Concepts
Though both in StationWareand in PowerFactory the settings and data associated with protective de-
vices, such as relays, CTs, VTs and circuit breakers are stored, the systems provide a different set of
concepts how to deal with this data.
In StationWareit is possible to model a location hierarchy and associate the devices to nodes in this
hierarchy (e.g. substations). This has no equivalent on the PowerFactory side where the devices are
stored inside the parent grid (ElmNet ) object.
On the other side PowerFactory allows to create a topological representation of networks which is not
supported in StationWare.
This section describes the concept mismatch between PowerFactory and StationWare. In order to use
the StationWareinterface its important to know about the differences between both applications.
358 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
Location
In StationWareeach device belongs to exactly one location. There are different location types e.g.
Region, Area, Substation, or Bay. The locations are organized in a hierarchy tree as shown in Fig-
ure 20.9.3.
Figure 20.9.3: StationWarelocations
In PowerFactory the data is organized in projects (IntPrj ). A project may have one or more grids (Elm-
Net ) which in turn contain net elements e.g. terminals, cubicles, and relays (ElmRelay). See Fig-
ure 20.9.4 for a typical PowerFactory project.
Figure 20.9.4: PowerFactory project
StationWares location concept and PowerFactory s project/grid concept hardly t together. Thats the
reason why the data mapping between PowerFactory and StationWarebegins at the device level which
is the subject of the next sections.
Device
DIgSILENT PowerFactory 15, User Manual 359
CHAPTER 20. POWERFACTORY INTERFACES
StationWaremanages a set of devices e.g. relays, CTs, VTs, or Circuit breakers. Each device is
associated to a device type e.g. ABB DPU2000R or SEL421 003. Additionally each device has an
unique ID: the device ID.
In PowerFactory a relay is represented by an ElmRelay object which references exactly one TypRelay
object. The ElmRelay object contains several sub-components e.g. the I>component (a RelToc object),
the Logic component (RelLogic), or the Ios component (RelMeasure). See Figure 20.9.5 for an example.
The device ID is used to link one StationWaredevice to one PowerFactory device. The PowerFactory
device e.g. an ElmRelay object stores the StationWaredevice ID as foreign key.
Figure 20.9.5: PowerFactory relay
Device State
A devices state is in StationWarecalled setting. A setting is a list of attributes, and describes the state
of one device completely. An attribute is a tuple of
attribute name,
attribute type which can be an arbitrary integer or oating point number, optionally with a range
restriction, or a string, or a enumeration type.,
a default value,
an optional unit.
A complex relay may have thousands of attributes. In StationWarethe setting attributes are organized in
so-called setting groups. A setting group groups the attributes together which belong somehow together.
Its often dened by the device manufacturer. Each attribute belongs to exactly one setting group. Inside
a group the attribute name is unique.
360 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
The device type denes which attributes and groups characterize a device. Table 20.9.1 shows an
example of a possible device type. There are two setting groups G and H. Group G has the attributes
a, b, and c, group H has the attributes d and e.
Group Name Type Default Unit
G a integer in [0,10] 0 A
b oat -0.32 l/s
c oat in [0.03, 4.65] 1.0
H d string DEFAULT
e enum yes, no, maybe yes
Table 20.9.1: Settings Denition
According to this attribute denition a device can have settings as shown in tables 20.9.2 or 20.9.3.
Group, Name Value
G,a 7
G,b 23.43
G,c 1.1
H,d abc
H,e maybe
Table 20.9.2: Settings Example 1
Group, Name Value
G,a 8
G,b 0
G,c 1.1
H,d abcdef
H,e yes
Table 20.9.3: Settings Example 2
On the PowerFactory side there are neither setting nor group nor attribute. There is the ElmRelay
object and its sub-objects. These objects can have parameters. See table 20.9.4 for a denition and
table 20.9.5 for an example. The TypRelay type denes components and parameters.
StationWareattributes are somehow mapped to PowerFactory parameters and vice versa. How this ac-
tually is accomplished, is described in Section 20.9.7: Technical Reference. The mapping is non-trivial
since only a small subset of the attributes (the calculation-relevant data) is modelled in PowerFactory
and vice versa. Additionally there is no one-to-one relationship between attributes, and parameters and
a parameter could get calculated out of several attributes.
Component Parameter Type
i> o integer
Logic p string
q enum enabled,disabled
los r oat
s oat
Table 20.9.4: Parameter Denition
Some relays support multiple setting groups (MSG) also called parameter sets. Such relays have the
same group many times (c.f. table 20.9.5). The groups H1, H 2, and H 3 have the same set of attributes
DIgSILENT PowerFactory 15, User Manual 361
CHAPTER 20. POWERFACTORY INTERFACES
(c and d). Some relay models in PowerFactory do not support this concept fully. Instead of modelling all
MSGs, only one instance of the H groups is provided.
In this case a group index parameter denes which of the MSGs actually is transferred from StationWare
to PowerFactory .
Life Cycle Phase
In StationWareeach setting has one life cycle phase e.g. Planning or Applied. At each point in time
a device can have a set of settings e.g. three Planning settings, one Applied setting and 12 Historic
settings.
Component Parameter Value
i>:o 8
Logic:p HIGH
Logic:q enabled
los:r 18,5
los:s 19,5
Table 20.9.5: Parameter Example
Group Name Type Default Unit
G a integer in [0,10] 0 A
b oat -0.32 l/s
H1 c string DEFAULT
d oat in [0.03,1.65] 1.0
H2 c string DEFAULT
d oat in [0.03,1.65] 1.0
H3 c string DEFAULT
d oat in [0.03,1.65] 1.0
Table 20.9.6: Multiple Setting Group Denition
In PowerFactory a device has exactly one state (or setting). Therefore when data is transferred between
PowerFactory and StationWare, always a concrete device setting in StationWaremust be specied.
For PowerFactory purposes a special PowerFactory planning phase is introduced. The transfer direc-
tions are specied as follows:
Imports from StationWareinto PowerFactory are restricted to Applied and PowerFactory set-
tings. Applied denotes the current applied setting (Applied) or a previous applied (Historic)
setting.
Exports from PowerFactory to StationWareare restricted to the PowerFactory setting. (Applied
and Historic settings are read-only and can never be changed).
(Actually PowerFactory s sophisticated variant management is similar to the phase concept, but there
is no obvious way how to bring them together.)
20.9.4 Conguration
In order to transfer data between PowerFactory and StationWareboth systems must be congured.
StationWare Server
362 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
An arbitrary StationWareuser account can be used for the StationWareinterface in PowerFactory. The
user must have enough access rights to perform operations e.g. for the export from PowerFactory to
StationWarewrite-rights must be granted.
The bi-directional transfer of settings is restricted to lifecycle phases with
1. status PLANNING or REVIEW and
2. with a cardinality constraint of 1 i.e. there may exist one or no such setting for one device.
Please ensure that at least one phase fulls these requirements, and there exists a setting of this phase.
PowerFactory Client
The client operating system must allow connections to the server (network and rewall settings etc.).
Nothing has to be done in the PowerFactory conguration itself. The TypRelays in the Library must of
course support StationWare/PowerFactory mapping.
20.9.5 Getting Started
This section is a simple walkthrough and covers the most essential StationWareinterface functionality.
By using a simple PowerFactory project and simple StationWaresubstation, it describes
1. how relays in StationWareand PowerFactory are created,
2. how these relays are linked,
3. how settings can be exported from PowerFactory to StationWare,
4. how settings can be imported again into PowerFactory .
All (especially the more advanced) options and features are described in the reference section (see
Section 20.9.6: Reference).
Prepare substation in StationWare
We begin with the StationWareside. We create a substation and two relays within:
start the web browser,
log on to the StationWaresystem,
create a new substation titled Getting Started,
create two relays named Getting Started Relay 1 and Getting Started Relay 2 in the Getting
Started substation
In the HTML interface the station detail page should look as shown in Figure 20.9.6.
Go to the detail page of the Getting Started Relay 1 (Figure 20.9.7).
Since we have just created the device it has no settings, yet. Later it will contain a PowerFactory setting
which reects the relay state on the PowerFactory side.
DIgSILENT PowerFactory 15, User Manual 363
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.9.6: Substation
Figure 20.9.7: Device
Prepare project in PowerFactory
Create a new PowerFactory project and create a simple grid within
start PowerFactory ,
create a new project titled GettingStarted,
draw a simple grid with two terminals (ElmTerm) connected by a line (ElmLne) as shown in Fig-
ure 20.9.8.
364 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
Figure 20.9.8: Grid
Now add a relay to the upper terminal
right-click the cubicle quadrangle with the mouse. A context menu pops up.
select New Devices. . . /Relay Model. . . as shown in Figure 20.9.9.
A dialogue pops up that allows you to specify the settings of the new relay (ElmRelay).
insert Getting Started Relay 1 as Name
select an appropriate Relay Type which supports StationWareimport/export (see Figure 20.9.10).
press OK
in the same way add a relay Getting Started Relay 2 to the second terminal.
PowerFactory s object lter mechanism gives an overview over all devices inside the current project.
DIgSILENT PowerFactory 15, User Manual 365
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.9.9: Cubicle context menu
Press the icon (Edit Relevant Objects for calculation) in the toolbar and select the icon
(ElmRelay) to lter out all non-relay objects as shown in Figure 20.9.11.
All calculation relevant relays (actually there only the two we created above) are displayed in a table
(see Figure 20.9.12).
Link Relays and establish a Connection
Now the PowerFactory relays must get linked to the StationWarerelays.
mark both relay icons with the mouse,
press the right mouse button.
A context menu pops up as shown in Figure 20.9.13.
select the StationWaremenu item,
select the Select Device ID item.
A Log on to StationWareserver dialogue pops up. Since this is the rst time PowerFactory connects to
the StationWareserver some connection settings must be entered.
366 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
Figure 20.9.10: Relay dialogue
Figure 20.9.11: Relay object lter
enter the Server Endpoint URL of the StationWareserver. The URL should have a format similar
to
http://192.168.1.53/psmsws/psmsws.asmx
enter Username and Password of a valid StationWareuser account.
DIgSILENT PowerFactory 15, User Manual 367
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.9.12: Relay display
Figure 20.9.13: Device context menu
Figure 20.9.14 shows the dialogue settings.
Figure 20.9.14: Log on dialogue
press OK.
368 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
The connection procedure may take some seconds. If the server could be accessed and the user could
be authenticated a success message is printed into the output window
DIgSI/info - Established connection to StationWare server
http://192.168.1.53/psmsws/psmsws.asmxas userpf00002
Otherwise an error dialogue pops up. Correct the connection settings until the connection is successfully
created. The reference section (Section 20.9.6) explains the connection options in detail.
Having established a connection to the server, a browser dialogue pops up which displays the location
hierarchy as known from the StationWareHTML interface. The dialogue is shown in Figure 20.9.15.
navigate to the Getting Started substation,
select the Getting Started Relay 1 device,
press OK.
Figure 20.9.15: Browser dialogue
Now the PowerFactory relay is connected to the StationWaredevice.
in the same way select Getting Started Relay 2 for the second PowerFactory relay.
Export and Import Settings
Having linked PowerFactory to StationWaredevices, the transfer between both systems can be started.
mark the relays with the mouse and right-click to get the relay context menu as shown in Fig-
ure 20.9.13.
select the Export. . . item in the StationWaremenu entry
A ComStationware dialogue is shown which allows to specify the export options (See Figure 20.9.16.
See Export and Import Settings in the Section 20.9.6 Reference section for all export options.
DIgSILENT PowerFactory 15, User Manual 369
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.9.16: ComStationware dialogue
select PowerFactory as Life cycle Phase,
press Execute.
After a few seconds the relay settings are transferred to the server, and the output window contains the
message
DIgSI/info - Exported 2 of 2 device settings successfully
The result can now be observed in the StationWareHTML interface.
370 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
Figure 20.9.17: Device detail page
navigate to the relay detail view of the Getting Started Relay 1 relay (c.f. Fig. 20.9.17)
Observe the new created PF setting. The phase of this setting is PowerFactory.
switch to the settings detail page of the new PF setting (c.f.Fig. 20.9.18).
Figure 20.9.18: Setting detail page
DIgSILENT PowerFactory 15, User Manual 371
CHAPTER 20. POWERFACTORY INTERFACES
The setting values should correspond to the relay state in PowerFactory. In the same way the Getting
Started Relay 2 relay has a new PF setting.
Now try the opposite direction and import a setting from StationWareinto PowerFactory.
modify the PF settings in StationWareby entering some other values
in PowerFactory mark the relays with the mouse and right-click to get the relay context menu as
shown in Figure 20.9.13.
select the Import. . . item in the StationWaremenu entry.
Again the ComStationware dialogue (see Figure 20.9.16) pops up as known from the export.
leave the default settings,
press Execute.
Again the result of the settings transfer is reected in the output window:
DIgSI/info - Imported 2 of 2 device settings successfully
nd ElmRelay object parameters changed according to the changes on the StationWareside
All import options are described in detail in the reference section : Export and Import Settings.
20.9.6 Reference
This section describes all options and features concerning the StationWareinterface.
The Device Context Menu
Almost all functionality can be accessed by the device context menu. Mark one ore more objects which
supports the StationWaretransfer e.g. ElmRelay
in the object lter (Figure 20.9.13)
in the data manager as shown in Figure 20.9.19.
372 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
Figure 20.9.19: Device context menu
The StationWaresubmenu contains the entries as follows:
Import. . . opens the ComStationware dialogue and sets the device selection according to the
above selected device objects. The ComStationware dialogue settings are explained in detail in
section 20.9.6 : The ComStationware Object.
Export. . . does the same for the export direction.
Select Device ID. . . starts the Browser dialogue (Figure 20.9.23) to link this device to a Station-
Waredevice. The dialogue is subject of section 20.9.6 : The Browser Dialogue.
Reset Device ID resets the device ID.
Connect. . . terminates the current StationWaresession if its already existing. Shows a Log On
dialogue. The connection settings are covered by Section 20.9.6. This may be useful when you
are using several StationWareaccounts and want to switch between them.
Disconnect terminates the StationWaresession
Connection
Similar to the HTML interface the StationWareinterface in PowerFactory is session - oriented: when a
user logs on to the system by specifying a valid StationWareaccount (username and password) a new
session is created. Only inside such a session StationWarecan be used. The account privileges restrict
the application functionality e.g. an administrator account is more powerful than a usual user account.
DIgSILENT PowerFactory 15, User Manual 373
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.9.20: Log on dialogue
Working with PowerFactory the rst time the StationWareserver is required the Logon dialogue is shown
as shown in Figure 20.9.20.
The StationWareconnection options are stored in the user settings (Figure 20.9.21). After each suc-
cessful logon the user settings are updated.
Figure 20.9.21: Log on dialogue
As mentioned in the Architecture section (Section 20.9.2) StationWareis a client-server application. The
StationWareserver component is located on a server machine in the internet. The client component is
the PowerFactory application which is running on a client machine.
The technology PowerFactory and StationWareuse to communicate is called web services and is stan-
dardized like many other internet technologies (HTML, HTTP). The server computer (or more exactly
the StationWareservice application on the server computer) has a name by which it can be accessed.
This name is called service endpoint and resembles a web page URL:
http://the.server.name/psmsws/psmsws.asmx
or
http://192.168.1.53/psmsws/psmsws.asmx
http denotes the protocol, the.server.name is the computer name (or DNS) of the server computer and
psmsws/psmsws.asmx is the name of the StationWareapplication.
The connection options are as follows:
Service Endpoint The Service Endpoint denotes the StationWareserver name as described
above
Username/Password Username and Password have to be valid user account in StationWare. A
374 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
StationWareuser account has nothing to do with the PowerFactory user account.
The very same StationWareaccount can be used by two different PowerFactory users. The privileges
of the StationWareaccount actually restrict the functionality. For device import the user requires read-
access rights. For exporting additionally write-access rights are required.
The Browser Dialogue
As mentioned in the Concept description (see Section 20.9.3: Device) the StationWaredevice ID is
stored as Foreign Key in the ElmRelay object dialogue (Description page) as shown in Figure 20.9.22.
Figure 20.9.22: ElmRelay dialogue
A more convenient way is to use the Browser dialogue shown in Figure 20.9.23. The dialogue allows to
browse through the StationWarelocation hierarchy and select a device. The hierarchy data is cached to
minimize network accesses. Due this caching its possible that there may exist newly created locations
or devices which are not displayed in the browser dialogue. The Refresh button empties the cache and
enforces PowerFactory to re-fetch the correct data from the server.
The ComStationware Object
In PowerFactory almost everything is an object: relays are ElmRelay objects, users are IntUser objects,
and grids are ElmNet objects.
What may be on the rst sight confusing is the fact that actions are objects as well: for a short-circuit
calculation a ComShc object is created. The calculation can be performed with several options e.g.
3-Phase, single phase, or 3 Phase to Neutral.
Figure 20.9.23: Browser dialogue
DIgSILENT PowerFactory 15, User Manual 375
CHAPTER 20. POWERFACTORY INTERFACES
You can even specify the fault location. All these calculation options are stored in the ComShc object.
Every action object has an Execute button which starts the action. In fact there is a large number of
parametrized actions like load ow calculation (ComLdf ), simulation (ComSim), there is even a ComExit
object that shuts down PowerFactory. All objects which can do something have the Com prex.
Since the StationWareinterface is actually doing something (it does import data, it does export data) it
is implemented as a ComStationware object.
The ComStationware object is used both for the import (Section 20.9.6) and the export (Section 20.9.6).
It is located in the projects study case according to PowerFactory conventions.
By default the study case of a new project contains no ComStationWare object. It is automatically
created when it is rst needed, as well as the ComShc object is instantiated at the time when the rst
short-circuit calculation is performed.
Import Options
The ComStationware dialogue provides import options as follows (Figure 20.9.24):
Transfer Mode select Import from StationWareas Transfer Mode
Check only Plausibility if the Check only Plausibility ag is enabled the import is only simulated
but not really executed.
Life cycle Phase/Time stam A list of available life cycle phases is shown.
Figure 20.9.24: ComStationware import options
PowerFactory selects the current setting with PowerFactory phase as source setting.
376 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
if Applied is selected the current Applied setting is transferred. If additionally a Timestamp value
is entered the setting that was applied at this time is transferred which may either be Applied or
Historic.
The Timestamp format is in ISO format: e.g. 2005-02-28 22:27:16
The time part may be omitted. Then 00:00:00 AM is assumed.
All Devices If All Devices is enabled, all calculation-relevant devices are imported. Devices not
supported by StationWareare ignored.
Device Selection Unless All Devices is enabled, the Device Selection provides a more subtle
way to specify which devices are to be transferred. The Device Selection parameter can be
an ElmRelay object: this and only this relay is imported
a SetSelect object: a SetSelect is a container that may hold several objects. All of them are
transferred, except the ones not supported by StationWare
a SetFilt object: the SetFilt is the most exible way to specify the device selection e.g. you can
select all devices in the project of type ElmRelay and whose name begin with PW. . . .
Devices outside the activated project are ignored.
The Device Selection is automatically set if the Device Context Menu mechanism (Section 20.9.6
: The Device Context Menu) is used.
All Settings Groups/Group Index This parameter species how multiple settings groups (MSG)
are handled.
If the relay in StationWarehas MSGs and the PowerFactory relay model supports MSGs and
All Settings Groups is enabled: then all groups are transferred
All Settings Groups is disabled: then only the Group Index -th group is transferred.
If the relay in StationWarehas MSGs and the PowerFactory relay model doesnt support MSGs:
then the Group Index-th group is imported.
These parameters are ignored completely if the relay has no MSGs.
The import transfer is started by pressing Execute.
DIgSILENT PowerFactory 15, User Manual 377
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.9.25: ComStationware export options
Export Options
The export options are almost identical to the import options (Figure 20.9.25):
Transfer Mode Select Export as Transfer Mode
Life cycle Phase A list of possible life cycle targets is shown. Please have in mind that a setting
of the life cycle is available. Applied settings can never be changed.
Click Execute to start the data transfer. Then the PowerFactory -relevant parameters are copied upon
the existing target setting.
20.9.7 Technical Reference
The purpose of this section is to describe what happens internally inside PowerFactory when device
settings are exported or imported.
This section also explains how new device types are integrated. PowerFactory is delivered with a library
of relay models. This library cannot contain all relays of all manufacturers. A way how to enhance the
378 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
library for new device types is shown in this section as well. The StationWareinterface is heavily based
on DPL (DIgSILENT Programming Language) which is documented in a separate DPL Manual.
Overview
For each device type (TypRelay) and each transfer direction a separate DPL script is required.
The import DPL script takes the StationWareattributes and a ElmRelay object as input and lls some-
how the ElmRelay objects and its sub-objects parameters.
The export DPL script takes a ElmRelay object as input parameter and calculates some output param-
eters which are the StationWareattributes.
Note: DPLs most important benet is: you can do anything. Thats exactly DPLs most important dis-
advantage as well. Be sure that your DPL scripts do what they should do and not more.
An import script should only set the parameters in the ElmRelay object and its subcomponents.
An export script shouldnt change anything at all (at least within PowerFactory ).
The scripts have to be named PsmsImport.ComDpl and PsmsExport.ComDpl and must be located
in the same folder as the TypRelay object.
Type data like TypRelay objects should be located in a library folder e.g. in the project library. If it is
referenced from several projects, it belongs into a global library. See Figure 20.9.26 for an example
database structure.
Import Scripts
The algorithm used for the import from StationWareto PowerFactory is as follows. Let d be the device
whose setting is to be imported:
1. let t be ds device type
2. let dpl be the PsmsImport.ComDpl object near t
3. initialize dpl s input parameter with the device attributes from StationWare
4. initialize dpl s external object parameter Relay with d
5. execute dpl
DIgSILENT PowerFactory 15, User Manual 379
CHAPTER 20. POWERFACTORY INTERFACES
Figure 20.9.26: Database structure
The execution step actually sets the relay parameters.
We use the StationWaredevice type example shown in table 20.9.1 from the Concept section (Sec-
tion 20.9.3) and the PowerFactory device type as shown in table 20.9.3 The StationWareattributes are
G.a, G.b, G.c, H.d, and H.e, the PowerFactory parameters are I>:o, Logic:p, Logic:q, Ios:r, and Ios:s.
Only the attributes G.a, G.c, and H.d and the parameters I>:o, Logic:p, and Ios:r are mapped. The
others are ignored since there is no equivalent concept on the other system.
The PsmsImport.ComDpl must meet the requirements as follows:
Name must be PsmsImport
General Selection must be empty
Input Parameters this table holds the StationWareattributes. The Name has the format [group
name] [attribute name]
The Type may either be int (for integer numbers), double (for oating point numbers), or string
(for string and enum values).
The Value eld must be empty. The attribute unit has to inserted in the Unit eld if appropriate. A
Description may be inserted, too.
External Object this table contains exactly one entry: an object with the Name Relay. The object
column must be empty.
The Input parameters get initialized with the StationWareattribute values and the External Object with
the current relay.
The second page of the ComDpl script holds the output parameters. They have the meaning as follows.
Remote Script this parameter must be un-set
General Selection the table must have one entry with Name Result of Type String. The DPL
380 DIgSILENT PowerFactory 15, User Manual
20.9. STATIONWARE INTERFACE
script should set this parameter to OK if the import procedure was successful. Otherwise it may
hold an error message which is displayed in the output window.
The code must be a valid DPL program. It should set the relay parameters according to the input
parameters.
Export Scripts
The export direction is almost symmetric to the import process. Be d the device whose setting is to
exported:
1. let t be ds device type
2. let dpl be the PsmsExport.ComDpl object near t
3. initialize dpl s external object parameter Relay with d
4. execute dpl
5. transfer dpl s output parameter to the setting in StationWare
The export DPL script must also meet some requirements:
Name ComDpl.Name must be PsmsExport.
General Selection must be empty
Input Parameters this table must be empty
External Object this table contains exactly one entry: an object with the Name Relay. The object
column must be empty.
The second page of the ComDpl script holds the output parameters. They have the meaning as follows.
Remote Script this parameter must be un-set
Result Parameters the table must have the rst entry with Name Result of Type String.
The DPL script should set this parameter to OK if the import procedure was successful. Other-
wise it may hold an error message which is displayed in the output window.
Below the Result parameter are the StationWareattributes.
The code must be a valid DPL program. It should not change the database.
How to create a new Device Type conversion
This section gives some practical guidelines how to create the conversion scripts for new types. First
create a test environment :
create in StationWarea new substation with one device of the desired device type. Create a
default PowerFactory setting for this device.
create a simple PowerFactory project which contains a device of the desired type
link the PowerFactory device to the StationWaredevice by setting the foreign key to the device ID.
Then write the import script:
create an empty PsmsImport.ComDpl near the TypRelay object.
dene the input and output parameters of the ComDpl object
DIgSILENT PowerFactory 15, User Manual 381
CHAPTER 20. POWERFACTORY INTERFACES
write the DPL code
test the script by importing the PowerFactory setting
Iterate these steps until there are no error messages. Change the setting in StationWareand re-try the
import. In quite the same way create and verify a PsmsExport.ComDpl script.
20.10 API (Application Programming Interface)
For a further detailed description on API, a reference document is available upon request
382 DIgSILENT PowerFactory 15, User Manual
Part IV
Power System Analysis Functions
Chapter 21
Load Flow Analysis
21.1 Introduction
Whenever evaluating the operation and control of power systems, the electrical engineer is typically
encountered with questions such as:
Are the voltages of every busbar in the power system acceptable?
What is the loading of the different equipment in the power system? (transformers, transmission
lines, generators, etc.)
How can I achieve the best operation of the power system?
Does the power system have a weakness (or weaknesses)? If so, where are they located and
how can I countermeasure them?
Although we may consider that the above questioning would arise only when analyzing the behaviour
of existing power systems; the same interrogations can be formulated when the task relates to the
analysis of future systems or expansion stages of an already existing power system; such as evalu-
ating the impact of commissioning a transmission line or a power plant, or the impact of refurbishment
or decommissioning of equipment (for example shutting down a power plant because it has reached its
life expectancy).
DIgSILENT PowerFactory 15, User Manual 385
CHAPTER 21. LOAD FLOW ANALYSIS
Figure 21.1.1: Power System Analysis: System Operation and System Planning
Taking into account these two aspects: 1) Present operation and 2) Future operation, is how power
should be analyzed. From one side, an operation or control engineer requires relevant information to
be available to him almost immediately, meaning he must be able to obtain somehow the behaviour
of the power system under different congurations that can occur (for example by opening or closing
breakers in a substation); on the other side, a planning engineer requires obtaining the behaviour of
the system reecting reinforcements that have not yet been built while considering the corresponding
yearly and/or monthly load increase. Regardless of the perspective, the engineer must be able to
determine beforehand the behaviour of the power system in order to establish, for example, the most
suitable operation conguration or to detect possible weakness and suggest solutions and alternatives.
Figures 21.1.2 and 21.1.3 illustrate the system operation and planning aspects.
Figure 21.1.2: Power System Operation Example
386 DIgSILENT PowerFactory 15, User Manual
21.1. INTRODUCTION
Figure 21.1.3: Power System Planning Example
Load ow calculations are used to analyze power systems under steady-state non-faulted (short-circuit-
free) conditions. Where steady-state is dened as a condition in which all the variables and parameters
are assumed to be constant during the period of observation. We can think of this as taking a picture of
the power system at a given point in time. To achieve a better understanding let us refer to Figure 21.1.4.
Here a 24 hour load demand prole is depicted. The user can imagine this varying demand to be the
demand of a specic area or region, or the demand of a whole network. In this particular case the load
is seen as increasing from early in the morning until it reaches its maximum at around 18:00 hrs. After
this point in time, the total load then begins to decrease. A load ow calculation is stated to be a steady-
state analysis because it reects the system conditions for a certain point in time, such as for instance
at 18:00 hrs (maximum demand). As an example, if we require determining the behaviour of the system
for every hour of the day, then 24 load ows need to be performed; if the behaviour for every second is
required then the number of load ow calculations needed would amount to 86 400. In PowerFactory
, the active power (and/or reactive power) of the loads can be set with a Characteristic so they follow
a certain prole (daily, weekly, monthly, etc.). By doing so, the active power will change automatically
according to the date ant time specied. For more information please refer to Chapter 16(Parameter
Characteristics, Load States, and Tariffs).
DIgSILENT PowerFactory 15, User Manual 387
CHAPTER 21. LOAD FLOW ANALYSIS
Figure 21.1.4: Example of a Load Demand Curve
A load ow calculation will determine the active and reactive power ows for all branches, and the
voltage magnitude and phase for all nodes.
The main areas for the application of load ow calculations can be divided in normal and abnormal
(Contingency) system conditions as follows:
Normal System Conditions
Calculation of branch loadings, system losses and voltage proles.
Optimization tasks, such as minimizing system losses, minimizing generation costs, open tie opti-
mization in distributed networks, etc.
Calculation of steady-state initial conditions for stability simulations or short-circuit calculations
using the complete superposition method.
Abnormal System Conditions
Calculation of branch loadings, system losses and voltage proles.
Contingency analysis, network security assessment.
Optimization tasks, such as minimizing system losses, minimizing generation costs, open tie opti-
mization in distributed networks, etc.
Verication of system conditions during reliability calculations.
Automatic determination of optimal system resupplying strategies.
Optimization of load-shedding.
Calculation of steady-state initial conditions for stability simulations or short-circuit calculations
using the complete superposition method (special cases).
Regarding the above denitions of normal and abnormal system conditions, a distinction should be
made in terms of the manner simulations should be performed:
388 DIgSILENT PowerFactory 15, User Manual
21.2. TECHNICAL BACKGROUND
Simulation of normal operating conditions: Here, the generators dispatch as well as the loads are
known, and it is therefore sufcient for the load ow calculation to represent these generators
dispatch and to provide the active and reactive power of all loads. The results of the load ow
calculation should represent a system condition in which none of the branch or generator limits
are exceeded.
Simulation of abnormal operating conditions: Here a higher degree of accuracy from the models
is needed. It can no longer be assumed that the entire system is operating within limits. The
models must be able to correctly simulate conditions which deviate from the normal operating
point. Hence the reactive power limits of generators or the voltage dependency of loads must be
modelled. Additionally, in many applications, the active power balance cannot be established with
a single slack bus (or machine). Instead, a more realistic representation of the active and reactive
power control mechanisms have to be considered to determine the correct sharing of the active
and reactive power generation.
Besides the considerations regarding abnormal conditions presented above, the assumption of bal-
anced systems may be inappropriate for certain distribution networks. State of the art computational
tools for power systems analysis must be therefore able to represent unbalanced networks for load ow
calculations as well.
The calculation methods and the options provided by PowerFactorys load ow analysis function allow
the accurate representation of any combination of meshed 1-, 2-, and 3-phase AC and/or DC systems.
The load ow tool accurately represents unbalanced loads, generation, grids with variable neutral po-
tentials, HVDC systems, DC loads, adjustable speed drives, SVSs, and FACTS devices, etc., for all AC
and DC voltage levels. With a more realistic representation of the active and reactive power balance
mechanisms, the traditional requirement of a slack generator is left optional to the user.
The most considerable effect of the resistance of transmission lines and cables is the generation of
losses. The conductor resistance will at the same time depend on the conductor operating temperature,
which is practically linear over the normal range of operation. In order to carry out such type of analysis,
PowerFactory offers a Temperature Dependency option, so that the conductor resistance is corrected
according to the specied temperature value.
For very fast and reliable analysis of complex transmission networks, where only the ow of active power
through the branches is considered, PowerFactory offers an additional load ow method, namely DC
load ow (linear), which determines the active power ows and the voltage angles within the network.
The following sections introduce the calculation methods and the options provided with PowerFactorys
load ow tool. This information is a guide to the conguration of the PowerFactory load ow analysis
command
21.2 Technical Background
This section presents the general aspects of the implementation of PowerFactorys load ow calculation
tool. An understanding of the concepts introduced here should be sufcient background to manage the
options presented in the load ow analysis command dialogue. Further technical details related to the
models (Network Components) implemented in PowerFactory for load ow calculations are provided in
the Appendix C: Technical References of Models.
21.2.1 Network Representation and Calculation Methods
A load ow calculation determines the voltage magnitude (V) and the voltage angle () of the nodes,
as well as the active (P) and reactive (Q) power ow on branches. Usually, the network nodes are
represented by specifying two of these four quantities. Depending on the quantities specied, nodes
can be classied as:
DIgSILENT PowerFactory 15, User Manual 389
CHAPTER 21. LOAD FLOW ANALYSIS
PV nodes: here the active power and voltage magnitude are specied. This type of node is used
to represent generators and synchronous condensers whose active power and voltage magnitude
are controlled (synchronous condensers P=0). In order to consider equipment limits under abnor-
mal conditions (as mentioned in the previous section), reactive power limits for the corresponding
network components are also used as input information.
PQ nodes: here the active and reactive power are specied. This type of node is used to repre-
sent loads and machines with xed values. Loads can also be set to change (from their original Po
and Qo values at nominal voltage) as a function of the voltage of the node to which the load itself
is connected. Elements specied as PQ (for example synchronous machines, static generators
PWM converters or SVSs) can be forced by the algorithm so that the P and Q resulting from the
load ow are always within limits.
Slack node: here the voltage magnitude and angle are xed. In traditional load ow calculations
the slack node (associated with a synchronous generator or an external network) carries out the
balancing of power in the system.
Device nodes: special nodes used to represent devices such as HVDC converters, SVSs, etc.,
with specic control conditions (for example the control of active power ow at a certain MW
threshold in a HVDC converter, or the control of the voltage of a busbar by an SVS).
Note: In traditional load ow calculations, asynchronous machines are represented by PQ nodes, as-
suming that the machine operates at a certain power factor, independent of the busbar voltage.
Besides this traditional representation, PowerFactory offers a more accurate slip iteration (AS)
representation based on the model equivalent circuit diagrams. For further information please
refer to the corresponding Technical Reference in the Appendix C.
In contrast to other power system calculation programs, PowerFactory does not directly dene the node
characteristic of each busbar. Instead, more realistic control conditions for the network elements con-
nected to these nodes are dened (see the Load Flow page of each elements dialogue). For example,
synchronous machines are modelled by dening one of the following control characteristics:
Controlled power factor (cos()), constant active and reactive power (PQ);
Constant voltage, constant active power (PV) on the connected bus;
Secondary (frequency) controller (slack, SL).
It is also important to note that in PowerFactory the active and reactive power balance of the analyzed
networks is not only possible through a slack generator (or external network). The load ow calculation
tool allows the denition of more realistic mechanisms to control both active and reactive power. For
further information please refer to Section 21.2.2.
AC Load Flow Method
In PowerFactory the nodal equations used to represent the analyzed networks are implemented using
two different formulations:
Newton-Raphson (Current Equations).
Newton-Raphson (Power Equations, classical).
In both formulations, the resulting non-linear equation systems must be solved by an iterative method.
PowerFactory uses the Newton-Raphson method as its non-linear equation solver. The selection of
the method used to formulate the nodal equations is user-dened, and should be selected based on
the type of network to be calculated. For large transmission systems, especially when heavily loaded,
the standard Newton-Raphson algorithm using the Power Equations formulation usually converges
390 DIgSILENT PowerFactory 15, User Manual
21.2. TECHNICAL BACKGROUND
best. Distribution systems, especially unbalanced distribution systems, usually converge better using
the Current Equations formulation.
In addition to the Newton-Raphson iterations, which solve the network nodal equations, PowerFactory
applies an outer loop when the control characteristic of automatic transformer tap changers and/or
switchable shunts is considered. Once the Newton-Raphson iterations converge to a solution within the
dened tolerance (without considering the setpoint values of load ow quantities dened in the control
characteristic of the tap changers/switchable shunts (see Figure 21.2.1)), the outer loop is applied in
order to reach these target values. The actions taken by the outer iterative loop are:
Increasing/decreasing discrete taps;
Increasing/decreasing switchable shunts; and
Limiting/releasing synchronous machines to/from max/min reactive power limits.
Once the above-listed actions are taken, a new Newton-Raphson load ow iteration takes place in order
to determine the new network operating point.
Figure 21.2.1: Setting of the Control Mode for an Automatic Tap Changer
In the classical load ow calculation approach, the unbalance between phases are neglected. For the
analysis of transmission networks this assumption is generally admissible. In distribution networks this
assumption may be inappropriate depending on the characteristics of the network. PowerFactory allows
for the calculation of both balanced (AC Load Flow, balanced positive sequence) and unbalanced (AC
Load Flow Unbalanced, 3-phase (ABC)) load ows according to the descriptions above.
DIgSILENT PowerFactory 15, User Manual 391
CHAPTER 21. LOAD FLOW ANALYSIS
DC Load Flow Method
In addition to the AC load ow calculations presented in this section, PowerFactory offers a so-called
DC load ow calculation method. The DC load ow should not be interpreted as a method to be used
in case of DC systems given that it basically applies to AC systems.
Some occasions we may require performing fast analysis in complex transmission networks where only
a reasonable approximation of the active power ow of the system is needed. For such situations the DC
load ow can be used. Other applications of the DC load ow method include situations where the AC
load ow has trouble converging (see Section 21.5: Troubleshooting Load Flow Calculation Problems).
In this particular method, the non-linear system resulting from the nodal equations is simplied due to
the dominant relation that exists between voltage angle and active power ow in high voltage networks.
By doing so a set of linear equations is thereby obtained, where the voltage angles of the buses are
directly related to the active power ow through the reactance of the individual components. The DC
load ow does not require an iterative process and the calculation speed is therefore considerably
increased. Only active power ow without losses is considered. Summarizing, the DC load ow method
has the following characteristics:
The calculation requires the solving of a set of linear equations.
No iterations required, therefore fast, and also no convergence problems.
Approximate solution:
All node voltage magnitudes xed at 1.0 per unit.
Only active power and voltage angles calculated.
Losses are neglected.
21.2.2 Active and Reactive Power Control
Active Power Control
Besides the traditional approach of using a slack generator to establish the power balance within the
system, PowerFactory s load ow calculation tool provides other active power balancing mechanisms
which more closely represent the reality of transmission networks (see selection in the Active Power
Control page of the load ow command). These mechanisms are implemented in the steady-state
according to the control processes that follow the loss of large power stations:
As Dispatched: As mentioned at the beginning of this section, the conventional approach in
load ow calculations consists assigning a slack generator, which will establish the power balance
within the system. Besides this traditional approach, PowerFactory offers the option of balancing
by means of a single or a group of loads (Distributed Slack by Loads). Under such assumptions,
the active power of the selected group of loads will be modied so that the power balance is once
again met; while leaving the scheduled active power of each generator unchanged. Other methods
of balancing include considering the participation of all synchronous generators according to their
scheduled active power (Distributed Slack by Generation).
According to Secondary Control: If an unbalance occurs between the scheduled active power
values of each generation unit and the loads plus losses, primary control will adapt (increase/decrease)
the active power production of each unit, leading to an over- or under-frequency situation. The
secondary frequency control will then bring the frequency back to its nominal value, re-establishing
cost-efcient generation delivered by each unit. Secondary control is represented in PowerFactory
s load ow calculations by network components called Power Frequency Controllers (ElmSecctrl ).
If the Active Power Control option According to Secondary Control is selected, the generators con-
sidered by the Power Frequency Controllers establish the active power balance according to their
assigned participation factors (for further information, please refer to the corresponding Technical
Reference in the Appendix C).
392 DIgSILENT PowerFactory 15, User Manual
21.2. TECHNICAL BACKGROUND
According to Primary Control: Shortly following a disturbance, the governors of the units partici-
pating in primary control will increase/decrease their turbine power and drive the frequency close
to its nominal value. The change in the generator power is proportional to the frequency deviation
and is divided among participating units according to the gain (K
pf
) of their primary controllers
and which is depicted in Figure 21.2.2. If the Active Power Control option According to Primary
Control is selected in PowerFactory s load ow command, the power balance is established by
all generators (synchronous generators, static generators and external grids) having a primary
controller gain value different than zero (parameter Prim. Frequency Bias in the Load Flow page
- Figure 21.2.3). The modied active power of each generator is then calculated according to the
following equation:
P
i
= P
idispatch
+ P
i
(21.1)
where,
P
i
is the modied active power of generator i, P
idispatch
is the initial active power dispatch of
generator i and P
i
is the active power change in generator i.
The active power change of each generator (P
i
) will be determined by its corresponding primary
controller gain value (K
pfi
) and the total frequency deviation.
P
i
= K
pfi
f (21.2)
where,
K
pfi
is the primary controller gain parameter of generator i and f is the total frequency devia-
tion. The total frequency deviation (f) can be obtained according to:
f =
P
Tot
K
pf
(21.3)
where P
Tot
corresponds to the active power change sum of every generator:
P
Tot
=
n
j=1
P
j
(21.4)
Figure 21.2.2: Primary Frequency Bias
DIgSILENT PowerFactory 15, User Manual 393
CHAPTER 21. LOAD FLOW ANALYSIS
Figure 21.2.3: Primary Frequency Bias (K
pf
) Setting in the Load Flow Page of the Synchronous Ma-
chine Element (ElmSym)
According to Inertias: Immediately following a disturbance, the missing/excess power is deliv-
ered from the kinetic energy stored in the rotating mass of the turbines. This leads to a deceler-
ation/acceleration and thus to a decrease/increase in the system frequency. The contribution of
each individual generator towards the total additional power required is proportional to its inertia. If
the Active Power Control option According to Inertias is selected in PowerFactory s load ow com-
mand, the power balance is established by all generators. Individual contributions to the balance
are proportional to the inertia/acceleration time constant of each generator (dened on the RMS-
Simulation page of the synchronous generator types dialogue and depicted in Figure 21.2.4). This
relation can be mathematically described as follows:
P
i
= P
idispatch
+ P
i
(21.5)
where,
P
i
is the modied active power of generator i, P
idispatch
is the initial active power dispatch of
generator i and P
i
is the active power change in generator i.
The active power change of each generator (P
i
) will be determined by its corresponding inertia
gain (K
pfi
) and the total frequency deviation, as follows:
P
i
= K
pfi
f (21.6)
where,
394 DIgSILENT PowerFactory 15, User Manual
21.2. TECHNICAL BACKGROUND
f is the total frequency deviation and K
pfi
is the inertia gain parameter of generator i, which
can be calculated as:
K
pfi
= J
n
2 (21.7)
with
J = S
n
T
ags
2
n
(21.8)
where,
J is the moment of Inertia,
n
is the rated angular velocity,
S
n
is the generator nominal apparent power and
T
ags
is the acceleration time constant rated to S
n
Figure 21.2.4: Inertia/Acceleration Time Constant Parameter of the Synchronous Machine Type (Typ-
Sym). RMS-Simulation Page
Figure 21.2.5 illustrates the different type of active power control.
DIgSILENT PowerFactory 15, User Manual 395
CHAPTER 21. LOAD FLOW ANALYSIS
Figure 21.2.5: Frequency Deviation Following an Unbalance in Active Power
Note: The Secondary Control option will take into account the participation factors of the machines de-
ned within a Power-Frequency Controller (ElmSecctrl ) in order to compensate for the frequency
deviation. In such a case, the nal steady state frequency is considered to be the nominal value
(number 1 in Figure 21.2.5). The Primary Control option will take into account the frequency droop
(MW/Hz) stated in every machine in order to determine the active power contribution. Depending
on the power unbalance, the steady state frequency will deviate from the nominal value (number
2 in Figure 21.2.5). The According to Inertias option will take into account the inertia/acceleration
time constant stated in every machine in order to determine its active power contribution. In this
case, depending on the power unbalance, the steady state frequency will deviate from the nominal
value (number 3 in Figure 21.2.5).
Reactive Power Control
The reactive power reserves of synchronous generators in transmission networks are used to control the
voltages at specic nodes in the system and/or to control the reactive power exchange with neighbour-
ing network zones. In PowerFactory s load ow calculation, the voltage regulator of the generators has
a voltage setpoint which can be set manually (dening a PV bus type as introduced in Section 21.2.1),
or from an Automatic Station Controller (ElmStactrl ). This Automatic Station Controller combines sev-
eral sources of reactive power to control the voltage at a given bus. In this case the relative contribution
of each reactive power source (such as generators and SVSs) is dened in the Station Controller dia-
logue. For further details about the use and denition of Automatic Station Controllers please refer to
Appendix C: Technical References of Models, section C.4.4: Station Controller (ElmStactrl ).
21.2.3 Advanced Load Options
Voltage Dependency of Loads
All non-motor loads, as well as groups of non-motor loads that conform a sub-system, for example, a
low-voltage system viewed from a medium voltage system, can be modelled as a general load.
Under normal conditions it is permissible to represent such loads as constant PQ loads. However
under abnormal conditions, for example during voltage collapse situations the voltage-dependency of
the loads should be taken into account.
Under such assumptions, PowerFactory uses a potential approach, as indicated by Equations (21.9)
and (21.10). In these equations, the subscript 0 indicates the initial operating condition as dened in
the input dialogue box of the Load Type.
396 DIgSILENT PowerFactory 15, User Manual
21.2. TECHNICAL BACKGROUND
P = P
0
_
aP
_
v
v
0
_
e aP
+bP
_
v
v
0
_
e bP
+ (1 aP bP)
_
v
v
0
_
e cP
_
(21.9)
where,
cP = (1 aP bP)
Q = Q
0
_
aQ
_
v
v
0
_
e aQ
+bQ
_
v
v
0
_
e bQ
+ (1 aQbQ)
_
v
v
0
_
e cQ
_
(21.10)
where,
cQ = (1 aQbQ)
By specifying the particular exponents (e aP, e bP, e cP and e aQ, e bQ, e cQ) the inherent load be-
haviour can be modelled. For example, in order to consider a constant power, constant current or
constant impedance behaviour, the exponent value should be set to 0, 1 or 2 respectively. In addition,
the relative proportion of each coefcient can be freely dened using the coefcients aP, bP, cP and aQ,
bQ, cQ. For further information, please refer to the General Load technical reference in the Appendix C.
Note: These factors are only considered if the Consider Voltage Dependency of Loads is checked in
the Load-ow Command window. If no Load Type (TypLod) is assigned to a load, and the load
ow is performed considering voltage dependency then the load will be considered as Constant
Impedance.
Feeder Load Scaling
In radially operated distribution systems the problem often arises that very little is known about the
actual loading of the loads connected at each substation. The only information sometimes available
is the total power owing into a radial feeder. To be able to still estimate the voltage prole along the
feeder a load scaling tool is used. In the simplest case the distribution loads are scaled according to
the nominal power ratings of the trans-formers in the substations. Of course, more precise results are
obtained by using an average daily, monthly or annual load.
The previous is explained in Figure 21.2.6. Here, the measured value at the beginning of the feeder is
stated to be 50 MW. Throughout the feeder there are three loads dened, of which only for one of them
the load is precisely known (20 MW). The other two loads are estimated to be at around 10 MW each.
PowerFactory s load ow analysis tool offers a special Feeder Load Scaling option so that the selected
groups of loads (scalable loads) are scaled accordingly in order to meet the measured value.
Figure 21.2.6: Radial Feeder. Feeder Load Scaling Option
DIgSILENT PowerFactory 15, User Manual 397
CHAPTER 21. LOAD FLOW ANALYSIS
In PowerFactory the following options for Feeder Load Scaling are available:
No scaling.
Scaling to measured apparent power.
Scaling to active power.
Scaling to measured current.
Scaling Manually.
Scaling to measured reactive power.
Scaling to measured power factor.
Furthermore, the previous options can be combined; for example, scaling a selected groups of loads in
order to meet a measured active power and power factor.
Note: Loads that are to be scaled must be marked as such (Adjusted by Load Scaling), also the load
scaling must be enabled in the load ow command option (Feeder Load Scaling).
The feeder load scaling process also can take into account the different type of load behaviour repre-
sented. Figure 21.2.7 illustrates just this. Here, a radial feeder consisting of three different type of loads
is depicted (constant power, constant current and constant impedance). Under such assumptions, per-
forming a load ow calculation with the option Consider Voltage Dependency of Loads (see previous
Section), will result in calculated base quantities according to the type of load specied; for example,
Ibase for the constant current load and Zbase for the constant impedance load. If in addition to the
voltage dependency of loads, the Feeder Load Scaling option is enabled, the calculated scaling factor
k is applied according to the type of load dened in the feeder.
Figure 21.2.7: Feeder Load Scaling Factor Considering Different Behaviour of Loads
In PowerFactory , the amount of Feeder denitions is not limited to the amount of radial paths repre-
sented in the model. This means that the user can dene more than one feeder element (ElmFeeder )
along the same radial path, as indicated in Figure 21.2.8 In this particular example, both Feeder 1 and
2 have the same specied orientation (Branch). While Feeder 1 is dened from the beginning of the
radial path, Feeder 2 is dened after load L2. This particular type of feeder representation is termed as
Nested Feeders. Since Feeder 1 is dened from the beginning of the radial path, every load (L1, L2, L3
and L4), as well as every feeder (Feeder 2) along this path will be considered as part of its denition.
Since Feeder 2 is along the path dened for Feeder 1; Feeder 2 is nested in Feeder 1.
398 DIgSILENT PowerFactory 15, User Manual
21.2. TECHNICAL BACKGROUND
In such cases, executing the load ow (with the option Feeder Load Scaling) will treat the two feeders as
independent. Although nested, Feeder 1 will only try to scale loads L1 and L2 according to its setting,
while Feeder 2 will scale loads L3 and L4. If Feeder 2 is placed Out of Service, then Feeder 1 will scale
all the loads along the radial path (L1, L2, L3 and L4).
Figure 21.2.8: Nested Feeder Denition
For further information on Feeder denitions please refer to Chapter 13, Section 13.5 (Feeders).
Load Scaling Factors
Loads can be scaled individually by adjusting the Scaling Factor parameter located in the Load Flow
page of the Load Element.Together with the scaling factor, the actual load is calculated as follows:
P = Scale P
0
(21.11)
Q = Scale Q
0
(21.12)
If voltage dependency of loads is considered then Equations (21.9) and (21.10) become;
P = Scale P
0
_
aP
_
v
v
0
_
e aP
+bP
_
v
v
0
_
e bP
+ (1 aP bP)
_
v
v
0
_
e cP
_
(21.13)
Q = Scale Q
0
_
aQ
_
v
v
0
_
e aQ
+bQ
_
v
v
0
_
e bQ
+ (1 aQbQ)
_
v
v
0
_
e cQ
_
(21.14)
Note: In order to consider a load in the feeder-load-scaling process, the option Adjusted by Load Scal-
ing has to be enabled. In this case, the individual Scaling Factor of the load is not taken into
account but overwritten by the feeder-scaling factor.
Additionally, loads can be grouped in zones, areas or boundaries so the scaling factor can be easily
edited. In case of zones, there will be an additional Zone Scaling Factor.
Coincidence of Low Voltage Loads
In a low voltage system every load may consist of a xed component with a deterministic amount of
power demand plus a variable component comprising many different, small loads, such as lights, refrig-
erators, televisions, etc., whose power varies stochastically between zero and a maximum value. Under
such conditions, PowerFactory uses a probabilistic load ow calculation, which is able to calculate both
DIgSILENT PowerFactory 15, User Manual 399
CHAPTER 21. LOAD FLOW ANALYSIS
maximum and average currents as well as the average losses and maximum voltage drops. The prob-
abilistic load ow calculation used by PowerFactory can be applied to any system topology, including
meshed low-voltage systems.
PowerFactory s probabilistic load ow calculation uses low voltage loads comprised of several cus-
tomers with xed and variable (stochastic) demand components. The maximum value of the variable
component (which is dependent upon the number of customers, n) is described by the following formula:
S
max
(n) = n g(n) S
max
(21.15)
Where S
max
is the maximum variable load per connection (customer) and the function g(n) describes
the maximum coincidence of loads, dependent upon the number of connections, n. If a Gaussian
distribution is assumed, the coincidence function is:
g(n) = g
+
1 g
n
(21.16)
The average value of the variable component is:
g(n) = g
S
max
(21.17)
Note: Low voltage loads can be represented in PowerFactory by Low Voltage Load (ElmLodlv) ele-
ments which can be directly connected to terminals or by Partial Low Voltage Loads (ElmLodlvp)
which are dened along transmission lines/cables (see the Denition of Line Loads section on the
Load Flow page of transmission line/cable elements - ElmLne).
21.2.4 Temperature Dependency of Lines and Cables
The most important effect of the resistance of transmission line and cable conductors is the generation
of losses (I
2
R). Resistance will also affect the voltage regulation of the line due to voltage drop (IR).
The resistance of a conductor is mainly affected by the operating temperature, and its variation can be
considered practically linear over the normal range of operation (an increase in temperature causes an
increase in resistance). In PowerFactory , the load ow calculation has two options for considering the
Temperature Dependency of resistance for lines and cables:
at 20
C: When this option is selected, the load ow calculation uses the resistances (lines and
cables) stated in the Basic Data page of the corresponding component (TypLne, TypCon, TypCab).
400 DIgSILENT PowerFactory 15, User Manual
21.2. TECHNICAL BACKGROUND
Figure 21.2.9: Specication of the Resistance at 20C in the Basic Data page of the line type (TypLne)
at Maximum Operational Temperature: When this option is selected, the load ow calculation
uses the corrected value of resistance, which is obtained with the following equation:
R
max
= R
20
[1 +(T
max
20
C)] (21.18)
where,
R
20
is the resistance at temperature 20
C/68
C
The resistance of each line, conductor and cable will be according to the value stated in the Basic
Data page of their corresponding type (at 20
C).
...at Maximum Operational Temperature
The resistance of each line, conductor and cable will be adjusted according to the equation
(21.18) described in Section 21.2.4 and the Temperature Dependency option stated in its corre-
sponding type (TypLne, TypCon, TypCab).
21.3.2 Active Power Control
As explained in Section 21.2.2, PowerFactory s load ow calculation offers several options for maintain-
ing power balance within the system under analysis. These options are:
as Dispatched:
If this option is selected and no busbar is assigned to the Reference Busbar (Reference Bus and
Balancing section of the Active Power Control tab), the total power balance is established by one
reference generator/external grid (slack-generator). The slack generator can be directly dened
by the user on the Load Flow page of the target element. The program automatically sets a slack
if one has not been already dened by the user.
according to Secondary Control:
Power balance is established by all generators which are considered by a Secondary Controller
as explained in Section 21.2.2. Active power contribution is according to the secondary controller
participation factors.
404 DIgSILENT PowerFactory 15, User Manual
21.3. EXECUTING LOAD FLOW CALCULATIONS
according to Primary Control:
Power balance is established by all generators having a Kpf -setting dened (on the Load Flow
page of a synchronous machine element dialogue), as explained in Section 21.2.2. Active power
contribution is according to the droop of every generator.
according to Inertias:
Power balance is established by all generators, and the contribution of each is according to the
inertia (acceleration time constant) as explained in Section 21.2.2.
Consider Active Power Limits:
Active power limits for generators (as dened on the elements Load Flow tab) participating in
active power balance, will be applied. If this option is disabled, the active power output limits may
be violated, in which case a warning is issued. This option is not available when the Active Power
Control option is set to either as Dispatched or according to Inertias.
Reference Bus and Balancing
If as Dispatched is selected in the Active Power Control section of the tab, further options regarding the
location of the reference busbar and the power balancing method are available:
Balancing by Reference Machine:
For each isolated area, the reference machine will balance the active power.
Balancing by Load at Reference Busbar:
This option is valid only when the reference bus bar has been dened. The load with highest
active power injection at the reference bus will be selected as the slack (such as to balance the
losses).
Balancing by Static Generator at Reference Bus:
As in the case of Balancing by Load, this option is valid only when the reference bus bar has
been dened. The static generator with the highest nominal apparent power at the reference bus
will be selected as the slack (i.e. to balance the losses).
Distributed Slack by Loads:
When this option is selected, only the loads which have the option Adjusted by Load Scaling
enabled in the isolated area will contribute to the balancing. The distribution factor calculated for
a load is determined by the following equation:
K
i
=
P
ini,i
n
j=1
P
ini,j
(21.19)
where,
P
ini
is the initial active power of the load.
DIgSILENT PowerFactory 15, User Manual 405
CHAPTER 21. LOAD FLOW ANALYSIS
Figure 21.3.2: Adjusted by Load Scaling option in the Load Flow page of the Load element (ElmLod)
Distributed Slack by Generation (Synchronous Generators):
All the synchronous generators in the isolated area will contribute to the balancing. As in the
Distributed Slack by Loads option, the distribution factor calculated for a generator is determined
by the following equation:
K
i
=
P
ini,i
n
j=1
P
ini,j
(21.20)
where,
P
ini
is the initial dispatched power of the generator.
Interchange Schedule:
This option is available only when the Distributed Slack by Loads or Distributed Slack by Gener-
ation is selected. It allows the loads or generation in a region to be scaled up or down to control
the interchange of this region. The type of the region could be:
Grids: Available for both distributed load slack and distributed generation.
Zones: Available for both distributed load slack and distributed generation.
Boundaries: Only available for distributed load slack.
In the load ow page of the grid, zone or boundary elements, the following operational parameters
are available:
Consider Interchange Schedule: Enables or disables the Interchange Schedule for this region. By
default this option is not selected.
Scheduled active power interchange: States the expected interchange of the grid, zone or bound-
ary.
406 DIgSILENT PowerFactory 15, User Manual
21.3. EXECUTING LOAD FLOW CALCULATIONS
Figure 21.3.3: Consider Interchange Schedule option in the Load Flow page of the Grid element (Elm-
Net )
Reference Busbar:
A different busbar to the one connecting the slack machine (or network) can be selected as a
reference for the voltage angle. In this case the user must specify the value of the voltage angle
at this selected reference bus, which will be remotely controlled by the assigned slack machine
(or network).
Angle:
User-dened voltage angle for the selected reference busbar. The value will be remotely con-
trolled by the slack machine (external network). Only available if a Reference Busbar has been
selected.
21.3.3 Advanced Options
Load Flow Method
As explained in Section 21.2.1, the nodal equations used to represent the analyzed networks are im-
plemented using two different formulations:
Newton-Raphson (Current Equations)
Newton-Raphson (Power Equations, classical)
In both formulations, the resulting non-linear equation systems must be solved using an iterative method.
PowerFactory uses the Newton-Raphson method as its non-linear equation solver. The selection of the
method used to formulate the nodal equations is user-dened, and should be selected based on the
type of network to be calculated. For large transmission systems, especially when heavily loaded, the
classical Newton-Raphson algorithm using the Power Equations formulation usually converges best.
Distribution systems, especially unbalanced distribution systems, usually converge better using the
Current Equations formulation.
Load Flow Initialisation
DIgSILENT PowerFactory 15, User Manual 407
CHAPTER 21. LOAD FLOW ANALYSIS
No Topology Rebuild
Will speed up large sets of consecutive load ow calculations. Enabling this option means that
the topology of the system will not be rebuilt when calculating the next load ow. If no topological
changes will be made to the system between these consecutive load ow calculations, then this
option may be enabled.
No Initialisation (no at-start)
Initializes a load ow from a previously convergent solution (no at-start).
Consideration of transformer winding ratio
Sets the manner in which voltage initialisation takes place at nodes. Reducing the relaxation
factor results in an increased number of iterations, but yields greater numerical robustness.
Tap Adjustment
Method
The direct method will include the tap controller models in the load ow calculation (i.e. in the
internal loop involving the Newton-Raphson iterations). The new tap positions will then be cal-
culated directly as a variable and are therefore known following a single load ow calculation.
The stepped method will calculate a load ow with xed tap positions, after which the required
tap changes are calculated from the observed voltage deviations and the tap controller time con-
stants. The load ow calculation is then repeated with the new tap positions, until no further
changes are required. These tap adjustments take place in the outer loop of the calculation.
Min. Controller Relaxation Factor
The tap controller time constants are used in the automatic tap changer calculations to determine
the relative speed of the various tap controllers during the load ow iterations. The relaxation
factor can be used to slow down the overall controller speeds (in case of convergence problems,
set a factor of less than 1.0), or to speed them up (for a faster load ow, set a factor of greater
than 1.0).
Station Controller
Available on Advanced tab of the Advanced Options page. The options presented in this eld determine
the reactive power ow from generators participating in station controllers (ElmStactrl ). Please refer to
Appendix C.4.4 (Station Controller (ElmStactrl)) for information on station controllers and their control
modes.
Modelling Method of Towers
with in/output signals
The equations of the lines are modelled in the tower. It should be noted that selecting this option
will result in slower performance.
ignore couplings
Inter-circuit couplings are ignored.
equations in lines
The constant impedance and admittance matrices are calculated by the tower and used to de-
velop the equations of the lines. The equations involving coupling are modelled in the lines;
consequently, using this option results in faster performance than using option with in/output sig-
nals.
Use this load ow for initialization of OPF
408 DIgSILENT PowerFactory 15, User Manual
21.3. EXECUTING LOAD FLOW CALCULATIONS
The results of this load ow calculation are used to initialize the OPF calculation.
21.3.4 Iteration Control
The options on this page relate to the non-linear equation solver and are therefore only available for
PowerFactory s AC load ow calculation methods.
Max. Number of Iterations for
The load ow calculation comprises an inner loop involving the Newton-Raphson method (see Sec-
tion 21.2.1), and an outer loop to determine changes to tap settings and to consider generator reactive
power limits. Default values for the maximum number of iterations for these two loops are 25 iterations
for the inner loop, and 20 iterations for the outer loop.
Newton-Raphson Iteration - itrlx
The inner loop of the load ow involves the Newton-Raphson iterations. This parameter denes
the maximum number of iterations (typically 25).
Outer Loop - ictrlx
The outer loop of the load ow calculation will determine changes to the tap changer (depending
on the tap adjustment method selected), and considers reactive power limits of generators, etc.
These are adjusted in the outer loop and then a new iteration of the inner loop is started again
(see Section 21.2.1). The maximum number of outer loop iterations (typically 20) is set by this
parameter.
Number of Steps - nsteps
Problematic load ows with slow convergence may be improved by starting a load ow calculation
for a low load level, and then increasing the load level in a number of steps. This is achieved by
setting the Number of Stairs to a value greater than one. For example, nsteps = 3 begins a load
ow at a load/generation level of 1/3 and the increases the power to 100% over two further steps.
Max. Acceptable Load Flow Error for
A higher precision or a faster calculation can be obtained by changing the maximum allowable error (i.e.
tolerance). The values of the calculated absolute error for nodes, or the calculated relative errors in the
model equations, e.g. voltage error of voltage controlled generators, are specied here.
Nodes - errlf Maximum Iteration Error of Nodal Equations (typical value: 1 kVA). Model Equations -
erreq Maximum Error of Model Equations (typical value: 0.1%).
Convergence Options
Relaxation Factor
A Newton-Raphson relaxation factor smaller than 1.0 will slow down the convergence speed of
the load ow calculation, but may result in an increased likelihood of convergence for systems
which are otherwise difcult to solve.
Automatic Model Adaptation for Convergency
The PowerFactory load ow calculation will always rst try to nd a solution using non-linear
mathematical power system models. If a solution cannot be found, and this option is enabled, an
adaptive algorithm will change these models slightly to make them more linear, until a solution is
found. Any model adaptations are reported in the output window.
Iteratively, starting from Level 1 up to Level 4, some types of models are adjusted in order to nd
a solution. The adaptations of the models for each level are the following:
DIgSILENT PowerFactory 15, User Manual 409
CHAPTER 21. LOAD FLOW ANALYSIS
Level 1
Loads: All voltage dependency factors are set to minimum 0.5
Generators and external networks: Reactive power limits are disabled
Transformers: tap control is disabled
Motors: The rotor resistance is not allowed to vary
Level 2
Loads: All voltage dependency factors are set to minimum 0.8
Generators and external networks: Reactive power limits are disabled
Transformers: tap control is disabled
Motors: The rotor resistance is not allowed to vary
Level 3
Loads: All voltage dependency factors are set to minimum 2
Generators and external networks: Reactive power limits are disabled
Transformers: tap control is disabled
Motors: The rotor resistance is not allowed to vary
Level 4
Loads: All voltage dependency factors are set to minimum 2
Generators and external networks: Reactive power limits are disabled and voltage equation
are linearized
Transformers: tap control is disabled
Motors: The rotor resistance is not allowed to vary
The models are not only lineralized but also simplied. If the user reached Level 4, he should
better switch to the DC load ow method.
21.3.5 Outputs
Show Outer Loop messages
Will print a report concerning the outer loop iterations, which may be used to solve convergence
problems.
Show Convergence Progress Report
Will print a detailed report throughout the load ow calculation. When enabling this option the
Number of reported buses/models per iteration can be stated. As a result, the required number
of buses and models with the largest error will be reported (e.g. by stating 3, the 3 buses and
models with the largest error will be printed out in the output window). As in the case of Outer
Loop messages, this information can be useful in solving convergence problems.
Show Verication Report
Produces a table in the output window with a list of overloaded power system elements and voltage
violations, according to the following values:
Max. Loading of Edge Element
Reference value of the maximum loading used by the Verication Report.
Lower Limit of Allowed Voltage
410 DIgSILENT PowerFactory 15, User Manual
21.3. EXECUTING LOAD FLOW CALCULATIONS
Reference value for the minimum allowed voltage used by the Verication Report.
Upper Limit of Allowed Voltage
Reference value for the maximum allowed voltage used by the Verication Report.
Output
Displays the report format denition that will be used. The arrow button can be pressed to edit
or inspect the report settings. This option is only available if Show Verication Report is selected.
21.3.6 Low Voltage Analysis
As explained in Sections 21.2.3 and 39.4.1, low voltage loads (ElmLodlv and ElmLodvp) are modelled
in PowerFactory with xed and variable (stochastic) components. The parameters which dene these
xed and variable components are set in both the load ow command dialogue (i.e. globally), and in the
load types dialogues (i.e. locally) according to the settings dened below.
Denition of Fixed Load per Customer
The xed load is the non-stochastic component of the load, which is not subject to coincidence factors.
The active and reactive power dened in this eld, multiplied by the number of customers (dened in the
load element itself), are added to the xed load component dened for each low voltage load (ElmLodlv
and ElmLodvp). For further information about LV loads please refer to the corresponding technical
references in the Appendix C.
Denition of Variable Load per Customer
The variable component of low voltage loads can be globally dened using the parameters in this section
or by specically dening LV load types for the target loads.
The Max. Power per Customer is the independent maximum kVA per customer. This value, multiplied
by the Coincidence Factor (ginf) (see Section 21.2.3), gives the Average Power per customer, which
is used in load ow calculations.
The total maximum variable power per load is calculated using the Max. Power per Customer, the
Coincidence Factor (ginf ), and the number of customers (dened in the load element itself) as described
in Section 21.2.3.
For further information about LV loads please refer to the corresponding technical references in the
Appendix C.
Note: The factors dened in the section Denition of Variable Load per Customer are used as global
data for the load ow calculation. If specic LV load types are dened, the locally-dened data
in the type is used by the corresponding loads. For all other LV loads with no type assigned, the
global data from the load ow command is used.
Voltage Drop Analysis
For the consideration of the stochastic nature of loads, PowerFactory offers two calculation methods:
Stochastic Evaluation
Maximum Current Estimation
The Stochastic Evaluation method is the more theoretical approach, and can also be applied to meshed
network topologies. The Maximum Current Estimation method applies stochastic rules only for the
DIgSILENT PowerFactory 15, User Manual 411
CHAPTER 21. LOAD FLOW ANALYSIS
estimation of maximum branch ows. Based on the maximum current ow in each branch element,
maximum voltage drops are calculated and added along the feeder. Obviously, this method has its
limitations in case of meshed LV networks.
21.3.7 Advanced Simulation Options
This page, as shown in Figure 21.3.4, is not only important for load ow but also for other calculation
functions such as transient simulation. Utilizing the options on this page can result in improved perfor-
mance; i.e. the speed of a transient simulation may improved when protection devices are neglected in
the calculation.
Figure 21.3.4: Advanced Simulation Options in the load ow command dialogue
Consider Protection Devices
Calculates the tripping times for all modelled relays and fuses. This will also show the load
currents in the overcurrent plots and/or the measured impedance in the R-X diagrams. Disabling
this option will speed up the calculations.
Ignore Composite Elements
Disables all controller models. The panes Models Considered and Models Ignored are used to
disable specic groups of controller models. Model names can be moved between these panes
by either double-clicking on them or by selecting them and using the arrow buttons. Enabling this
option may result in faster convergence, or an increased likelihood of convergence for systems
which are otherwise difcult to solve.
21.4 Result Analysis
In PowerFactory the results can be displayed directly in the single line diagram, in tabular form or by
using predened report formats. Also available are several diagram colouring options in other to have a
quick overview of the results.
412 DIgSILENT PowerFactory 15, User Manual
21.4. RESULT ANALYSIS
21.4.1 Viewing Results in the Single Line Diagram
Once a load ow calculation has been successfully executed, the result boxes shown in the single-line
diagram will be populated. There is a result box associated with each side of an element. So for
example a load has one result box, a line two result boxes, and a three-winding transformer three result
boxes. In PowerFactory these elements are collectively called edge elements. In addition, there are
result boxes for nodes or buses.
The information shown inside a result box depends on the element to which it is associated. There
are a few predened formats for edge elements and a few predened formats for buses. In order to
see the selection, rst perform a load ow, then, from the main menu, select Output Results for
Edge Elements or Output Results for Buses. These menu options will show the list of available result
box formats. Alternatively, you can select (click) inside a result box on the single-line diagram, then
right-click and from the context sensitive menu choose Format for Edge Elements or in case of a node
Format for Nodes. Figure 21.4.1 serves as an example.
Figure 21.4.1: Selecting the Result Box from the Single Line Diagram.
Besides these predened formats the result boxes can be formatted in order to display selected vari-
ables.
By right-clicking on one of the result boxes and selecting the option Edit Format for Edge Elements
and afterwards pressing the Input Mode button three options will be available: Predened Variables,
User Selection or Text Editor. The User Selection option will allow the selection of any of the available
variables.
21.4.2 Flexible Data Page
Once a load ow calculation has been successfully executed, pressing the Edit Relevant Objects for
Calculation button ( ) located on the main menu will prompt a submenu with icons for all classes
that are currently used in the calculation. Clicking any of the class-icons will open a browser with all
elements of that class that are currently used in the calculation. The left-most tab-page at the bottom of
the browser is the Flexible Data tab page. Click on this tab page to show the exible data. To change
the columns in the exible page, press the Dene Flexible Data button ( ). This will bring a selection
window where the set of variables can be edited. In the left pane the available variables will be shown
while the right pane will list the selected variables. Pressing the or buttons will move the selected
variable from the one pane to the other pane.
DIgSILENT PowerFactory 15, User Manual 413
CHAPTER 21. LOAD FLOW ANALYSIS
21.4.3 Predened Report Formats (ASCII Reports)
In PowerFactory there are predened report formats also called ASCII reports, available to the user.
These ASCII reports can be created by pressing the Output Calculation Analysis button ( ) located on
the main menu (a load ow must be calculated rst). This will bring a selection window in which the user
can select a specic type of report. Some reports like the Complete System Report will have various
options which the user can set. The report selection window also shows the report denition which will
be used for the selected report. Pressing Execute will write the report to the output window. Although
the reports are already predened, the user has the possibility of modifying the reports if required (by
clicking on the blue arrow pointing to the right of the used format denition).
A Verication Report can be also printed out automatically each time a load ow calculation is executed
(see Section 39.4.2).
21.4.4 Diagram Colouring
When performing load ow calculations, it is very useful to colour the single line-diagram in order to have
a quick overview of the results, for example if elements have a loading above 90% or if the voltages of
the busbars are outside the specied limits. In PowerFactory there is the option of selecting different
colouring modes according to the calculation performed. If a specic calculation is valid, then the
selected colouring for this calculation is displayed. As an example, if the user selects the colouring
mode Zones for No Calculation and Low and High Voltage/Loadings for the load ow calculation, then
the initial colouring will be according to Zones. However, as soon as the load ow is calculated, the
diagram will be coloured according to Low and High Voltage/Loadings. If the load ow calculation is
reset or invalid, the colouring mode switches back to Zones.
The Diagram Colouring has also a 3-priority level colouring scheme also implemented, allowing colour-
ing elements according to the following criteria: 1
st
Energizing status, 2
nd
Alarm and 3
rd
Normal
(Other) colouring.
Energizing Status
If this check box is enabled De-energized or Out of Calculation elements are coloured accord-
ing to the settings in the Project Colour Settings. The settings of the De-energized or Out of
Calculation mode can be edited by clicking on the Colour Settings button.
Alarm
If this check box is enabled a drop down list containing alarm modes will be available. It is
important to note here that only alarm modes available for the current calculation page will be
listed. If an alarm mode is selected, elements exceeding the corresponding limit are coloured.
Limits and colours can be dened by clicking on the Colour Settings button.
Normal (Other) Colouring
Here, two lists are displayed. The rst list will contain all available colouring modes. The sec-
ond list will contain all sub modes of the selected colouring mode. The settings of the different
colouring modes can be edited by clicking on the Colour Settings button.
Every element can be coloured by one of the three previous criteria. Also, every criterion is optional and
will be skipped if disabled. Regarding the priority, if the user enables all three criterions, the hierarchy
taken into account will be the following:
Energizing Status overrules the Alarm and Normal Colouring mode. The Alarm mode overrules
the Normal Colouring mode.
414 DIgSILENT PowerFactory 15, User Manual
21.5. TROUBLESHOOTING LOAD FLOW CALCULATION PROBLEMS
21.4.5 Load Flow Sign Convention
By default, PowerFactory has the following load ow sign convention (Mixed Mode):
Branches:
Power Flow going out of the Busbar is positive while going into the busbar is negative.
Loads:
Power Flow going out of the Busbar is positive while going into the busbar is negative. Here, the
term load considers General Loads, Low-Voltage Loads, Motors, Shunts/Filters and SVS.
A synchronous machine stated as a Motor will have also this sign convention.
Generation:
Power Flow going out of the Busbar is negative while going into the busbar is positive. Here,
the term Generation considers Generators, External Grids, Static Generators and Current
and Voltage Sources. An asynchronous machine stated as a Generator will have also this sign
convention.
21.5 Troubleshooting Load Flow Calculation Problems
In general, if a solution can be found (in other words, the network is mathematically solvable), Pow-
erFactory will nd a solution. In some cases the user may have made an error which will not allow a
solution to be found; such as a large load causing a voltage drop so large that a voltage collapse results.
In a real-world power system the same problem would be found.
When creating a network for the rst time it is best to enter the data for only a small part or path of the
network and solve the network by calculating a load ow. PowerFactory has a data verication process
in which certain checks are performed, such as whether a line is connected between nodes of the same
voltage; and the correct voltage orientation of transformers, etc.
Typical reasons for non-convergence in the load ow are:
Data model problem.
Too many inner loop iterations.
Too many outer loop iterations.
Excessive mismatch.
Tap hunting.
Clearly this is not an exhaustive list of problems, but these are the main causes of non-convergence
and that will be discussed in this section.
21.5.1 General Troubleshooting
The place to search for the causes of the non-convergence problem is in the PowerFactory output
window. Here, there can be three different types of messages printed out, which are the following:
Info messages (green/blue):
DIgSILENT PowerFactory 15, User Manual 415
CHAPTER 21. LOAD FLOW ANALYSIS
Information detailing the load ow convergence (inner and outer loop iterations). Information of
generators with reactive power compensation at output limit. Information on the total number of
isolated areas (see 21.5.3).
Warning messages (dark red):
Warning messages do not need to be corrected for the load ow to solve, however they could
give you an indication of where the problem is. Take note of the warning messages and evaluate
them in terms of your system. Important warnings, such as Exceeding Mvar limit range may not
be acceptable. Unsupplied Areas messages indicate that an isolated area with Consumers
(such as loads and motors) is without a generator, power source or external supply.
Error messages (red):
Error messages must be corrected for a load ow to solve. Error messages could be generated
by PowerFactory s data checking function, which include messages such as DIgSI/err - missing
type! In most cases the messages have links to the data base and graphic. The following options
can be performed in order to trace errors:
Use the data-verication tool ( ).
Once errors have been detected, open the problematic element dialogue window by double click-
ing on the name directly from the output window. Or alternatively, right click mouse button over
the name and select edit, or edit and browse, or mark in graphic.
The amount of information being printed to the PowerFactory output window can be changed by the
user. Once error messages have been analyzed and corrected and the load ow still does not solve,
the user may want to print more detailed information on the convergence progress.
Tick the Show Convergence Progress Report option found in the Outputs page of the load ow dialogue
(refer to Section 39.4.2).
This will print messages to the output window that can provide clues as to where the convergence
problems may lie.
The single line graphic can also be coloured to show low and high voltages and overloadings. This will
also provide a good indication of possible problems. Look at the undervoltage nodes and overloaded
elements and investigate why they are overloaded; look at load setpoints, line lengths and line type data
(the impedances may be too high, for example).
Note: As explained above, there are 3 different types of messages that are printed to the output win-
dow: warning, error and information messages. Only error messages must be corrected for a load
ow to solve. Take note of the warning messages and evaluate them in terms of your system,
however these do not need to be corrected for the load ow to solve. Unsupplied Areas means
that an isolated area with Consumers is without a generator, power source or external supply.
If there is still no convergence then set the option Out of Service for most of the elements (see each
elements Basic Data tab). Following this, bring these elements back into service, one at a time, from
the source element downwards, performing a load ow calculation each time.
When experiencing large unbalances, such as when there are a number of single or dual phase ele-
ments, or when using power electronics elements, select the Newton-Raphson (Current Iteration) option
on the Advanced page of the load ow dialogue.
21.5.2 Data Model Problem
In PowerFactory , there are three different levels of data verication implemented:
416 DIgSILENT PowerFactory 15, User Manual
21.5. TROUBLESHOOTING LOAD FLOW CALCULATION PROBLEMS
Parameter Level:
Checks the consistency of the input parameter; for example, entering a negative value in the
length of the line will prompt an error message. Other verications implemented include checking
if the parameter imputed is within certain limits.
Object Level:
Checks the consistency of the data being imputed from the component itself; for example, check-
ing if the magnetizing losses of a transformers are less that the total magnetizing apparent power
(i.e. magnetizing current), checking if the inputting of the manufactures data results in a feasible
torque-slip characteristic, etc.
System Level:
Checks the consistency of the data being imputed from a system point of view; for example,
checking if lines/cables are connected between the same voltage levels, checking if the HV/MV/LV
side of transformers is compatible with the voltage level of busbars, checking if there are missing
types, etc.
Data model problems can normally be xed easily as the output window message refers directly to the
element causing the problem.
Typical cases of data model problems are:
DIgSI/err - missing type!:
It indicates that input data (electrical data dened in types) is missing. In most cases the mes-
sages have links to the data base and graphic.
DIgSI/err - Check control conditions!:
It normally appears when more than one controller (for example a station controller) is set to
control the same element, such as the same busbar. PowerFactory will print the name of the con-
trolled element to the output window. Starting from the controlled element, access the controllers
to x the problem.
DIgSI/err - Line connected between different voltage levels!
21.5.3 Some Load Flow Calculation Messages
DIgSI/info - Grid split into 182 isolated areas
An isolated area indicates that a busbar or a group of busbars are not connected to the slack
busbar. An isolated generator or an isolated external grid forms an isolated area. An isolated
area refers basically to nodes. Each isolated area is assigned an index (Parameter name b:ipat
under ElmTerm Basic) and needs a load ow reference (slack) of its own. These busbars can
be found colouring the single line graphic according to isolated grids.
DIgSI/wrng - 2 area(s) are unsupplied
An unsupplied area is an isolated area with Consumers (such as loads and motors) without
a generator, power source or external supply. That is U=0 and I=0. Unsupplied areas belong to
the group of isolated areas. The unsupplied areas can be identied by displaying the following
parameter in the Consumers components (loads, synchronous/asynchronous motors):
r : bus1b : ipat. Gives the Index of the isolated area
r : bus1 : b : imode = 0. Indicates there is no slack in the isolated area therefore indicating its
unsupplied.
DIgSILENT PowerFactory 15, User Manual 417
CHAPTER 21. LOAD FLOW ANALYSIS
r : bus1 : b : imode > 0. Indicates the area is supplied.
DIgSI/err - Outer loop did not converge. Maximum number of iterations reached
Fore some hints on this type of error please refer to Section 21.5.5.
21.5.4 Too many Inner Loop Iterations
Too many inner loop iterations are normally related to voltage stability (voltage collapse) problems.
For example, a large load causing voltage drops so high that a voltage collapse results. Also very weak
connections resulting from faults or outages may lead to voltage collapse during contingency analysis.
The problem will not only be found in the simulation but would be found in the real world as well!
The main causes leading to a voltage stability problem can be summarized as follows:
Excessive active power demand leading to a high voltage drop.
Lack of reactive power compensation.
Diagnosis and Solution:
The main source of Information is the output window. Enable the Show Convergence Progress
Report option found in the Outputs page of the load-ow dialogue. Analyze the convergence of
the inner loop iterations: check the progress in the load ow error for nodes and model equations:
Are they increasing or decreasing?
If the error is not continuously decreasing, it could be an indication of a voltage stability problem.
Identify the element (load, generator) with high convergence error. Use the Mark in Graphic
option to identify the zone of the network having the problem.
Several possible countermeasures can be undertaken to x the problem:
Use the Iteration Control options on the load ow command (increasing the number of stairs as
the rst option, typically to 3).
Load shedding: disconnect the load identied as responsible for the high convergence error.
Connect additional reactive power compensation.
Using the exible data page, check if there are any heavily loaded circuits, these indicate weak
connections.
Once the load ow converges, check if there are areas with voltages with high deviation from
operating voltages.
Excessive Mismatch
Where there is a large mismatch between demand and generation (> 15%) the load ow is unlikely to
converge. This is typied by a large number of iterations followed by warnings or errors such as:
No convergence in load flow! Equation system could not be solved. Check
Control Conditions!
418 DIgSILENT PowerFactory 15, User Manual
21.5. TROUBLESHOOTING LOAD FLOW CALCULATION PROBLEMS
Depending on the size of the mismatch, the failure might occur during the initial Newton-Raphson or dur-
ing subsequent outer loop iteration. There may also be a large number of maximum/minimum reactive
power reached and transformer tap statements.
Solution:
Set the option Show Convergence Progress Report on the Outputs page and observe which
elements are having the highest mismatches. These elements should be closely checked.
Check the mismatch on the Reference machine by performing a DC load ow as Dispatched
allowing for normal losses. Rebalancing the network might alleviate convergence problems.
21.5.5 Too Many Outer Loop Iterations
Outer loops iterations are required to calculate discrete tap positions of transformers, number of steps
of switchable reactive power compensation, etc. in order to match the voltage prole or reactive power
control specied by the user.
Too many outer loop iterations is referring to a solution that is too far away from the starting point (default
tap positions) to converge in the allowed number of outer loop iterations.
Diagnosis and Solution: The outer-loop does the following:
Increasing/Decreasing discrete taps.
Increasing/Decreasing switchable shunts.
Limiting/Releasing synchronous machines to/from max/min reactive power limits.
If the outer loop does not converge, it can have the following reasons:
Tap upper and lower limits are too close, so that the voltage can never be kept in the desired
range.
The same with switchable shunts.
Other toggling effects, for example synchronous machine limits and tap positions dont nd a
stable solution.
The main source of Information is the output window. Check rst the following:
Is the number of messages reducing with each outer loop iteration?
The following messages in the output windowmay indicate a problemand lead to a non-convergent
solution.
Maximum/minimum tap position reached
DIgSI/pcl - --------------------------------
DIgSI/pcl - $ \ $ .... $\ $Transformer.ElmTr2:
DIgSI/pcl - Maximum Tap Position reached
DIgSI/pcl - --------------------------------
The message indicates that more/less reactive power is required at this location (the tap is at
maximum/minimum position). The message indicates therefore an area in the network where a
lack/excess of reactive power is likely to happen.
DIgSILENT PowerFactory 15, User Manual 419
CHAPTER 21. LOAD FLOW ANALYSIS
Reactive power limit left
DIgSI/pcl - --------------------------------
DIgSI/pcl - $ \ $.... $\ $ Generator.ElmSym:
DIgSI/pcl - Reactive Power Limit left
DIgSI/pcl - --------------------------------
This will lead to a convergence error. A load ow calculation without considering reactive power
limits may nd a solution. Check then required reactive power at the generator.
Maximum/minimum reactive power reached.
DIgSI/pcl - --------------------------------
DIgSI/pcl - $\ $....$ \ $ Generator.ElmSym:
DIgSI/pcl - Maximum Reactive Power Reached
DIgSI/pcl - --------------------------------
Basically means that there is no regulation margin in the specied generators.
In general the results from the last iteration should be available to view on the output window.
Is the mismatch always in the same (or similar) location?
How far away from the solution was the original starting point?
All actions (except for shunt switching) are displayed in the output window by blue messages.
Observing these messages allows to conclude what the reason for the convergence problem
was, for example if a synchronous machine toggles between limited/released, the problem is
related to this particular machine.
If no toggling can be observed, increasing the maximum number of outer iteration loops may help.
If the load ow converges, improve the convergence of subsequent calculations by saving the tap
positions ( ).
If the load ow does not converge after a large number of iterations then other methods of im-
proving convergence are:
Use the direct method on the advanced options page of the load ow command.
Set the maximum tap changes per iteration to be a small number, for example 1. This will result
in PowerFactory not changing all tap changers at once by several steps but only by maximum of 1
step at once. In larger networks this is often improving the convergence.
Perform a load ow without automatic taps and shunt adjustment. If the load ow does not con-
verge in this case, it could be an indication that the load is exceeding the voltage stability limits,
thus the load is too high.
Tap Hunting
Tap hunting can be easily recognised when one or more transformers oscillate between tap positions
until the number of outer loop iterations is exhausted. This is normally due to the transformer (controller)
target voltage dead band being smaller than the transformer tap step size.
The messages below indicate an example of a single transformer Tap-Hunting:
420 DIgSILENT PowerFactory 15, User Manual
21.6. LOAD FLOW SENSITIVITIES
Figure 21.5.1
This problem of no converging load-ow with the stepped tap changing method is caused by a slightly
different way of the iteration to reach the correct tap position and load-ow results. This might result in
a non-convergence in the outer loop, when the controller range (Vmax-Vmin) of the tap changer is near
to the value of the additional voltage per tap.
Solution:
Change the minimum relaxation factor on the Advanced Options page of the load ow command
to a smaller value. This might help the load ow to converge.
Check if the dead bands of the target or controlled busbars of the corresponding transformers are
correctly set. Also check if the tap changer data on the load ow page of the transformer type is
correct.
Disable the automatic tap changing of the transformers where tap hunting occur. Run the load
ow (it should converge in this case!) and then check the sensitivity of the tap changer increasing
and decreasing the tap position by one step. Verify the results against the dead band of the target
busbar.
21.6 Load Flow Sensitivities
PowerFactorys Load Flow Sensitivities (ComVstab) command is shown in Figure 21.6.1. This com-
mand performs a voltage sensitivity analysis based on the linearization of the system around the oper-
ational point resulting from a load ow calculation (as explained in Section 21.6.3).
The ComVstab command is accessible by the following means:
clicking on the Change Toolbox icon ( )and selecting Additional Tools and then clicking on the
ComVstab icon ( ); or
right-clicking on a busbar/terminal or transformer and selecting Calculate Load Flow Sensitiv-
ities... . In this case the command will be automatically set to calculate the sensitivity to power
injections/tap changes on the selected busbar/transformer. The selected terminal/transformer will
be automatically set in the Busbar (or Transformer ) reference.
DIgSILENT PowerFactory 15, User Manual 421
CHAPTER 21. LOAD FLOW ANALYSIS
Figure 21.6.1: Load Flow Sensitivities Command (ComVstab) Dialogue
21.6.1 Load Flow Sensitivities Options
The options available for the Load Flow Sensitivities command (Figure 21.6.1) are:
Initialization
Load Flow:
Displays which load ow command will be used to initialize the sensitivity analysis. If no load ow
calculation has been executed before opening the Load Flow Sensitivities (ComVstab) command,
or if the calculation has been reset, the Load Flow displays the most recently executed load ow
command in the active study case.
Sensitivities
Diagonal Elements Only:
The effect of the injections of P and Q at each busbar are evaluated for the busbar itself (ef-
fect on voltage magnitude (v
i
/P
i
), (v
i
/Q
i
), and on voltage angle (
i
/P
i
), (
i
/P
i
) for
each busbar) and the corresponding adjacent branches. In this mode, the calculated sensitivi-
ties (P
n
/P
i
), (Q
n
/P
i
), (P
n
/Q
i
), and (Q
n
/Q
i
) in the branches (index n) always refer to
derivations /P
i
and /Q
i
of the adjacent buses (index i). This means that the sensitivities
are calculated for all busbars and for all branches, according to variations in power (P and Q)
at the directly connected busbars.
Sensitivity to a Single Busbar:
The effect of the injections of P and Q at the selected busbar are calculated for the whole
network (i.e. for all buses and branches). The target busbar can be selected using the Busbar
button ( ) located at the bottom of the dialogue. Alternatively, the target bus can be selected
in the single line graphic by right-clicking on it and selecting Calculate Load Flow Sensitivities
from the context-sensitive menu. The sensitivities of all busbars and branches are calculated
according to variations in power (P and Q) at the selected busbar.
Sensitivity to a Single Transformer Tap Position:
422 DIgSILENT PowerFactory 15, User Manual
21.6. LOAD FLOW SENSITIVITIES
This option evaluates the effect of changing the tap position of a selected transformer in the
network. The sensitivities dP/dtap [MW/tapstep], dQ/dtap [Mvar/tapstep] for branches, and
dphi/dtap [deg/tapstep], dv/dtap [p.u./tapstep] for buses are calculated. The target transformer
can be selected using the Transformer button ( ) located at the bottom of the dialogue. Alterna-
tively, the target transformer can be selected in the single line graphic by right-clicking on it and
selecting Calculate Load Flow Sensitivities from the context-sensitive menu.
Modal Analysis:
This option performs an eigenvalue calculation on the sensitivity matrix as explained in Sec-
tion 21.6.3. The number of eigenvalues to be calculated is dened in the Number of Eigenvalues
eld at the bottom of the dialogue. The eigenvalues are always calculated in order of their largest
magnitude, so selecting n eigenvalues will display the n eigenvalues in descending order ac-
cording to magnitude (note that the larger the number of desired eigenvalues, the longer the
calculation will take). In the Display Results for Mode eld, the user can specify the number of
a specic eigenvalue, for which the stability behaviour (i.e. the eigenvectors and participation
factors) is to be analyzed. The algorithm then additionally calculates the (P/Q) , (Q/Q)
(branch sensitivities) and the (v/Q), (/Q) (bus sensitivities) which correspond to the mode
specied (see Section 21.6.3 for further technical background).
21.6.2 Load Flow Sensitivities Execution and Results
When the ComVstab command has been congured and the Execute button has been pressed, the
program calculates several sensitivity factors such as (v
i
/P
i
) ,(v
i
/Q
i
) , (
i
/P
i
), (
i
/Q
i
) etc.,
according to the selected options, for buses and branch elements.
Upon completion of the sensitivity factor calculation, the following message appears in the output win-
dow:
DIgSI/info - Load Flow Sensitivities calculated!
The calculated results can be displayed via the Flexible Data Page (see Section 10.6) by selecting the
sensitivities from the load ow variables (Variable Set: Current, Voltages and Powers). The names of
the variables correspond to the calculated derivations, i. e. the result of the expression (
i
/P
i
) is
stored in the variable named dvdP; and likewise the result of the expression (
i
/Q
i
) is stored in the
variable dphidQ.
When the Modal Analysis option is selected, the calculated eigenvalues are displayed (in descending
order according to magnitude) in the output window. The eigenvectors and participation factors can be
displayed using the Flexible Data Page.
21.6.3 Technical Background
PowerFactory s Load Flow Sensitivities function (ComVstab) performs a static voltage stability calcula-
tion as described below.
Linearizing the load ow equations around the actual operating point leads to the following equation
system:
_
J
P
J
Pv
J
Q
J
Pv
_ _
v
_
=
_
P
Q
_
(21.21)
The equation system in (21.21) shows that changes in the voltage magnitude and angle due to small
changes in the active and reactive power can be directly calculated from the load ow Jacobian matrix.
For example if P is set to 0, the sensitivities of the type dv/dQ are calculated from (21.21) according
to:
DIgSILENT PowerFactory 15, User Manual 423
CHAPTER 21. LOAD FLOW ANALYSIS
v =
J
1
Qv
Q = S
vQ
Q (21.22)
where:
J
Qv
= J
Q
J
1
P
J
Pv
+J
Qv
(21.23)
As can be seen from (21.22), the variation of voltage magnitude at each busbar can be described by a
linear combination of small reactive power variations according to:
v
i
= S
i1
Q
1
+ +S
in
Q
n
(21.24)
In this case the diagonal elements S
i1
of S represent the voltage variation at bus i due to a variation
of reactive power at the same point. The non-diagonal elements S
ij
describe the voltage variation at
busbar i due to the variation in reactive power at a different point on the network.
Positive dv/dQ sensitivity indicates stable operation. High sensitivity means that even small changes in
reactive power cause large changes in the voltage magnitude; therefore the more stable the system,
the lower the sensitivity (high voltage sensitivities are indicative of weak areas of the network).
Note: Recall that in HV networks branches are predominantly reactive. Voltage magnitudes depend
primarily on reactive power ows and voltage angles depend on active power bus injections.
The sensitivity analysis can be extended in order to determine the active and reactive power variations
on branches (in the PowerFactory network model all components carrying a ow, i.e. lines, transformers,
generators are regarded as branches) due to variations in active and reactive power busbar injections.
In this case the sensitivities are calculated using the branch-node Jacobian matrix.
By applying a modal transformation to (21.22) the dV/dQ sensitivity can be expressed as an uncoupled
system of the form:
v = T
1
S
vQ
T
Q =
S
vQ
Q (21.25)
where:
v = T v and Q = T
Q (21.26)
In (21.25),
S
vQ
is a diagonal matrix whose elements correspond to the eigenvalues of the sensitivity
matrix, S
vQ
, from (21.22). Therefore, the voltage variation at each mode depends only on the reactive
power variation at the same mode:
v
i
=
i
Q
i
(21.27)
The eigenvalues
i
, which are real, provide the necessary information about the voltage stability of the
system. If
i
is positive, the modal voltage increase and the modal reactive power variations are in
the same direction and the system is therefore stable. The magnitude of the eigenvalue indicates how
far/close one voltage mode is to instability.
In (21.25), T = [1 . . . n] corresponds to the matrix of right eigenvectors of S
vQ
, while T
1
corresponds
to the left eigenvectors matrix:
424 DIgSILENT PowerFactory 15, User Manual
21.6. LOAD FLOW SENSITIVITIES
T
1
=
_
T
1
T
n
_
_
(21.28)
The participation factor of bus k to mode i is dened by the product of the kth component of the left and
right eigenvector of mode i:
P
ik
=
ik
ik
(21.29)
The sum of the participation factors of all nodes corresponds to the scalar product of the left and right
eigenvector, and is therefore equal to one. In this sense, the participation factor gives an indication of
the extent of the inuence the variation of active power on a node has on a voltage mode.
DIgSILENT PowerFactory 15, User Manual 425
CHAPTER 21. LOAD FLOW ANALYSIS
426 DIgSILENT PowerFactory 15, User Manual
Chapter 22
Short-Circuit Analysis
22.1 Introduction
Power systems as well as industrial systems are designed so that loads are supplied safely and reliably.
One of the major aspects taken into account in the design and operation of electrical systems is the
adequate handling of short-circuits. Although systems are designed to stay as free from short circuits
as possible, they still can occur. A short-circuit condition generally causes large uncontrollable currents
ows, which if not properly detected and handled can result in equipment damage, the interruption of
large areas (instead of only the faulted section) as well as placing personnel at risk. A well-designed
system should therefore isolate the short-circuit safely with minimal equipment damage and system
interruption. Typical causes of short-circuits can be the following:
Lightning discharge in exposed equipment such as transmission lines.
Premature aging of the insulation due mainly to permanent overloadings, inappropriate ventilation,
etc.
Atmospheric or industrial salt Build-Up in isolators.
Equipment failure.
Inappropriate system operation.
One of the many applications of a short-circuit calculation would be to check the ratings of network
equipment during the planning stage. In this case, the planner is interested in obtaining the maximum
expected currents (in order to dimension equipment properly) and the minimum expected currents (to
aid the design of the protection scheme). Short-circuit calculations performed at the planning stage
commonly use calculation methods that require less detailed network modelling (such as methods which
do not require load information) and which will apply extreme-case estimations. Examples of these
methods include the IEC 60909/VDE 0102 method [9], the ANSI method and the IEC 61363 method
[7]. A different eld of application is the precise evaluation of the fault current in a specic situation,
such as to nd out whether the malfunction of a protection device was due to a relay failure or due to the
consequence of improper settings (for example an operational error). These are the typical applications
of exact methods such as the superposition method (also known as the Complete Method), which is
based on a specic network operating point.
The short-circuit calculation in PowerFactory is able to simulate single faults as well as multiple faults
of almost unlimited complexity. As short-circuit calculations can be used for a variety of purposes,
PowerFactory supports different representations and calculation methods for the analysis of short-circuit
currents.
DIgSILENT PowerFactory 15, User Manual 427
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
This chapter presents the handling of the short-circuit calculation methods as implemented in Power-
Factory. Further background on this topic can be found in Section 22.1.
sectionTechnical Background
Beside load ow calculations, short-circuit is one of the most frequently performed calculations when
dealing with electrical networks. It is used both in system planning and system operation (see Fig-
ure 22.1.1, in special cases Methods 2.1 and 2.2 are also used for network planning). Calculation
quantities which have been newly-introduced in PowerFactory Version 14 are shown in Figure 22.1.1,
also a graphical representation of the short-circuit current time function is illustrated in Figure 22.1.2.
The IEC 61363 standard [7] which outlines the procedures for calculating short-circuit currents that may
occur on a marine or off shore a.c. electrical installation is not shown in Figure 22.1.1.
Figure 22.1.1: Areas of Application of Short-Circuit Calculations
According to IEC 60909 [9]the denition of the currents and multiplication factors shown in Figure 22.1.1
are as follows:
Ikks initial symmetrical short-circuit current (RMS),
i
p
peak short-circuit current (instantaneous value),
I
b
symmetrical short-circuit breaking current (RMS),
I
th
thermal equivalent short-circuit current (RMS),
factor for the calculation of the peak short-circuit current,
factor for the calculation of the symmetrical short-circuit breaking current,
m factor for the heat effect of the d.c. component,
n factor for the heat effect of the a.c. component, besides the above currents, the Complete
Method introduces the following current denition:
i
b
peak short-circuit breaking current (instantaneous value).
428 DIgSILENT PowerFactory 15, User Manual
22.1. INTRODUCTION
Figure 22.1.2: short-Circuit Current Time Function
Typical applications examples of short-circuit analysis in system planning include:
Ensuring that the dened short-circuit capacity of equipment is not exceeded with system expan-
sion and system strengthening.
Co-ordination of protective equipment (fuses, over-current and distance relays).
Dimensioning of earth grounding systems.
Verication of sufcient fault level capacities at load points (e.g. uneven loads such as arc fur-
naces, thyristor-driven variable speed drives or dispersed generation).
Verication of admissible thermal limits of cables and transmission lines.
Example applications of short-circuit analysis in system operation include:
Ensuring that short-circuit limits are not exceeded with system reconguration.
Determining protective relay settings as well as fuse sizing.
Calculation of fault location for protective relays, which store fault disturbance recordings.
Analysis of system faults, e.g. misoperation of protection equipment.
Analysis of possible mutual interference of parallel lines during system faults.
The fundamental difference between the assumptions used by the calculation methods is that for system
planning studies the system operating conditions are not yet known, and therefore estimations are
necessary. To this end, the IEC 909 (VDE 0102) method which uses an equivalent voltage source at
the fault location has become generally accepted in Western Europe. A revised version of this was
published as IEC 60909 [9] in July 2001. This method works independently of the load ow (operating
point) of a system. It is based on the nominal and/or calculated dimensions of the operating point of
a system and uses correction factors for voltages and impedances, to give conservative results. For
the calculation of minimum and maximum short-circuit currents, different correction factors are applied.
However, it should be mentioned that both IEC 60909 and VDE 0102 do not deal with single phase
elements (expect single phase elements in the neutral conductor). Another very similar method is the
ANSI method, which is basically used in North America and is accepted in other countries as well. The
ANSI method is based on the IEEE Standards C37.010 [1] which is for equipment applied in mediumand
high voltage systems (grater than 1000 Volts) and C37.13 [4] which is for power circuit breakers in low
DIgSILENT PowerFactory 15, User Manual 429
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
voltage systems (less that 1000 Volts). For short-circuit calculations in a system operation environment,
the exact network operating conditions are well-known. If the accuracy of the calculation according to
IEC 60909 [9] is not sufcient - or to verify the results of this method - the superposition method can be
used. The superposition method calculates the expected short-circuit currents in the network based on
the existing network operating condition. If the system models are correct, the results from this method
are always more exact than the results of the IEC 60909 method. The system analyst is, however,
responsible that she/he has chosen the most unfavourable conditions with respect to the sizing of plant.
In some cases, this might result in extensive studies required. Also available in PowerFactory Version
14 is the IEC 61363 method [?] which outlines the procedure for calculating short-circuit currents on
marine or offshore electrical systems such like ships.
22.1.1 The IEC 60909/VDE 0102 Method
The IEC 60909/VDE 0102 [9] method uses an equivalent voltage source at the faulted bus and is a
simplication of the superposition method (Complete Method). It is illustrated in Figure 22.1.3. The goal
of this method is to accomplish a close-to-reality short-circuit calculation without the need for the pre-
ceding load-ow calculation and the associated denition of actual operating conditions. Figure 22.1.3
illustrates how the equivalent voltage source method can be derived from the superposition method.
The main simplications are as follows:
Nominal conditions are assumed for the whole network, i.e. Ui = Un, i
Load currents are neglected, i.e. IOp = 0.
A simplied simulation network is used, i.e. loads are not considered in the positive and negative
sequence network.
To ensure that the results are conservatively estimated, a correction factor, c, is applied to the volt-
age at the faulted busbar. This factor differs for the calculation of the maximum and the minimum
short-circuit currents of a network.
The short-circuit calculation based on these simplications may be insufcient for some practical ap-
plications. Therefore, additional impedance correction factors are applied to the physical impedances
of the network elements. This method is described in detail in the following section. Please note in
addition that both IEC 60909 [9] and VDE 0102 do not deal with single phase elements (expect single
phase elements in the neutral conductor).
430 DIgSILENT PowerFactory 15, User Manual
22.1. INTRODUCTION
Figure 22.1.3: Illustration of the IEC 60909/VDE 0102(shcgraec.gif) Method
As illustrated in Figure 22.1.1, IEC requires the calculation of the initial symmetrical short circuit current
in order to derive the rest of the physical quantities, each of which is a function of the following:
R/X ratio,
Machine characteristics
Synchronous generator type of excitation system,
Contact parting time,
Type of network (if its radial or meshed),
Determination if the contribution is near to or far from the short-circuit location,
Regarding the type of network, IEC describes three methods for the calculation of (peak short-circuit
current) in meshed networks which are dened as follows:
Method A: Uniform Ratio R/X The factor is determined based on the smallest ratio of R/X of
all the branches contributing to the short-circuit current.
Method B: Ratio R/X at the Short-Circuit Location For this method the factor is multiplied by
1.5 to cover inaccuracies caused by using the ratio R/X from a network reduction with complex
impedances.
DIgSILENT PowerFactory 15, User Manual 431
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
Method C: Equivalent Frequency An equivalent impedance Z
c
of the system as seen from
the short-circuit location is calculated assuming a frequency f
c
= 20Hz (for a nominal frequency
f
c
= 50Hz) or f
c
= 24Hz (for a nominal frequency f
c
= 60Hz). This is the recommended Method
in meshed networks.
Note: In PowerFactory methods B and C are available to the user. Method C is the one recommended
in meshed networks. For more information please refer to Section 22.3.4
IEC Impedance Correction Factors
The IEC method uses only the rated parameters of network elements. This is advantageous in that
only little information is necessary to perform a short-circuit calculation. However, considering that, for
example, the short-circuit contribution of a synchronous generator depends heavily on the excitation
voltage and on the unit transformer tap changer position, the worst-case value of this impedance is
considered by applying a correction factor (< 1).
This idea is illustrated in Figure 22.1.4. The correction factor c should be determined so that I
k
=
I
k,IEC
. The IEC standard denes an equation for the correction factor for each element type.
Figure 22.1.4: Principle of Impedance Correction (IEC/VDE Method)
As the IEC standard includes a worst-case estimation for minimum and maximum short-circuit currents,
some PowerFactory elements require additional data. These elements are:
Lines In their type, the maximum admissible conductor temperature (for minimum short-circuit currents)
must be stated (Figure 22.1.5). Line capacitances are not considered in the positive/negative sequence
systems, but must be used in the zero-sequence system.
Figure 22.1.5: Maximum End Temperature Denition in the Line Type (TypLne)
432 DIgSILENT PowerFactory 15, User Manual
22.1. INTRODUCTION
Transformers Require a ag indicating whether they are unit or network transformers as shown in
Figure 22.1.6. Network transformers may be assigned additional information about operational limits
which are used for a more precise calculation of the impedance correction factor. Unit transformers are
treated differently depending on whether they have an on-load or a no-load tap changer (Figure 22.1.7).
Figure 22.1.6: Unit Transformer Denition in the Transformer Element (ElmTr2)
Figure 22.1.7: On-Load Tap Changer Denition in the Transformer Type (TypTr2)
Synchronous Machines Subtransient impedances are used. Additionally, information regarding the
voltage range must be given as seen in Figure 22.1.8
DIgSILENT PowerFactory 15, User Manual 433
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
Figure 22.1.8: Voltage Range Denition in the Synchronous Machine Element (ElmSym)
Asynchronous Machines The ratio of starting current to rated current is used to determine the short-
circuit impedance (Figure 22.1.9)
Figure 22.1.9: Locked Rotor Current Denition in the Asynchronous Machine Type (ElmAsymo)
Please refer to the IEC 60909 standard to nd detailed information regarding specic equipment models
and correction factors for each element.
22.1.2 The ANSI Method
ANSI provides the procedures for calculating short-circuit currents in the following standards:
ANSI/IEEE Standard C37.010 [1], IEEE Application Guide for AC High-Voltage Circuit Breakers
Rated on a Symmetrical Current Basis.
ANSI/IEEE Standard C37.13 [4] , IEEE Standard for Low-Voltage AC Power Circuit Breakers
Used in Enclosures.
ANSI/IEEE Standard 141 [5], IEEE Recommended Practice for Electric Power Distribution of
Industrial Plants (IEEE Red Book).
ANSI/IEEE Standard C37.5 [2], IEEE Application Guide for AC High-Voltage Circuit Breakers
Rated on a Total Current Basis. (Standard withdrawn).
434 DIgSILENT PowerFactory 15, User Manual
22.1. INTRODUCTION
ANSI C37.010 details the procedure for equipment applied in medium and high voltage systems consid-
ering a classication of the generators as either local or remote depending on the location of the fault,
as well as taking into account motor contribution. The procedure also covers rst cycle and interrupting
time currents, with emphasis on interrupting time currents.
ANSI C37.13 details the procedure for power circuit breakers applied in low voltage systems (less than
1000 Volts), while mainly focusing on rst-cycle currents, impedance of motors and the fault point X/R
ratio. Typically, fuses and low voltage circuit breakers begin to interrupt in the rst half cycle so no
special treatment for interruptive current is given. It could be the case however, that nevertheless the
equipment test include a dc component specication.
Due to the differences in the high and low voltage standards, it would be understandable to say that
two rst-cycle calculations are required. The rst calculation would be for high voltage busbars and a
second calculation would be for low-voltage busbars.
In IEEE/ANSI Standard 141-1993 [5] (Red Book) a procedure for the combination of rst cycle network is
detailed. There is stated that in order to simplify comprehensive industrial system calculations, a single
combination rst-cycle network is recommended to replace the two different networks (high/medium-
voltage and low voltage). This resulting combined network is then based on the interpretation of the
ANSI C37.010 [1], ANSI C37.13 [4] and ANSI C37.5 [2] there given.
Total and Symmetrical Current Rating Basis of Circuit Breakers and Fuses according to ANSI
Standards
Depending on the circuit breaker year of construction different ratings are specied. High-voltage circuit
breakers designed before 1964 were rated on Total current rating while now a days high-voltage circuit
breakers are rated on a Symmetrical current basis. The difference between these two denitions is on
how the asymmetry is taken into account. While a Total current basis takes into account the ac and
dc decay, Symmetrical current basis takes into account only the ac decay. To explain further these
denitions please refer to Figure 22.1.10.
Figure 22.1.10: Asymmetrical Short-Circuit Current
The DC component DC is calculated according to the following equation:
DC =
P1 P2
2
(22.1)
The RMS value of the ac component (RMS) is then calculated as:
DIgSILENT PowerFactory 15, User Manual 435
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
RMS =
P1 +P2
2.828
(22.2)
The total interrupting current in RMS is then:
Tot =
_
DC
2
+RMS
2
(22.3)
From the above, Equation (22.2) corresponds to the Symmetrical current calculation and Equation
(22.3) to the Total current calculation. Some of the main ANSI guidelines for the calculation of short-
circuit currents are the following:
The pre-fault busbar voltage is assumed to be nominal (1.0 p.u.).
The fault point X/R ratio is calculated based on a separate resistance network reduction which is
latter used to calculate the peak and total asymmetrical fault current.
Depending on the location of the fault, the generator currents being fed to the short circuit are
classied as local or remote. A remote source is treated as having only a dc decay, while a local
source is treated as having a dc and ac decay. Depending on this classication, corresponding
curves are used in order to obtain the multiplication factors.
According to ANSI standard, the following short-circuit currents are calculated:
I
symm
symmetrical momentary (rst cycle) short-circuit current (RMS),
I
symi
symmetrical interrupting short-circuit current (RMS),
I
16asymm
asymmetrical momentary (Close and Latch - Duty) short-circuit current (RMS). Obtained
by applying a 1.6 factor to I
symm
I
27peakm
peak short-circuit current (instantaneous value). Obtained by applying a 2.7 factor to
I
symm
,
I
asymm
asymmetrical momentary (Close and Latch - Duty) short-circuit current(RMS). Obtained
by applying a factor to I
sym
m
according to the calculated X/R ratio,
I
peak
m
peak short-circuit current (instantaneous value). Obtained by applying a factor to I
sym
m
,
according to the calculated X/R ratio.
22.1.3 The Complete Method
The complete method (sometimes also known as the superposition method) is, in terms of system
modelling, an accurate calculation method. The fault currents of the short-circuit are determined by
overlaying a healthy load-ow condition before short-circuit inception with a condition where all voltage
supplies are set to zero and the negative operating voltage is connected at the fault location. The
procedure is shown in Figure 22.1.11. The initial point is the operating condition of the system before
short-circuit inception (see Figure 22.1.11a). This condition represents the excitation conditions of the
generators, the tap positions of regulated transformers and the breaker/switching status reecting the
operational variation.
From these pre-fault conditions the pre-fault voltage of the faulted busbar can be calculated. For the
pure fault condition the system condition is calculated for the situation where, the negative pre-fault
busbar voltage for the faulted bus is connected at the fault location and all other sources/generators are
set to zero (see Figure 22.1.11b). Since network impedances are assumed to be linear, the system
condition after fault inception can be determined by overlaying (complex adding) both the pre-fault and
pure fault conditions (see Figure 22.1.11c).
436 DIgSILENT PowerFactory 15, User Manual
22.1. INTRODUCTION
Figure 22.1.11: Illustration of the Complete Method
The Complete Methodfor calculating short-circuits has been improved in PowerFactory Version 14 as
described below. Additionally, the quantities described below are shown in Figure 22.1.1.
A more precise Peak Short-Circuit Current i
p
is calculated based on the accurate subtransient
short-circuit current (which is calculated using the complete method) and the R/X ratio (which is
based on the IEC 60909 standard[9]);
The Short-Circuit Breaking Current I
b
(RMS value) is calculated based on the subtransient short-
circuit current and the transient short-circuit current (both of which are calculated by the complete
method);
The Peak Short-Circuit Breaking Current i
b
is calculated from the RMS short-circuit breaking cur-
rent I
b
and the decaying d.c. component;
The Thermal Equivalent Short-Circuit Current I
th
is calculated based on the IEC standard, using
the m and n factors (see Figure 22.1.1). The n-factor calculation uses the transient current instead
of the steady-state current;
Additionally, loads can have a contribution to the short-circuit current, which can be dened in the
load element (Fault Contribution section of Complete Short-Circuit tab).
DIgSILENT PowerFactory 15, User Manual 437
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
22.1.4 The IEC 61363 Method
The IEC 61363 standard [7]describes procedures for calculating short-circuit currents in three-phase
AC radial electrical installations on ships and on mobile and xed offshore units.
The IEC 61363 standard [7]denes only calculation methods for three phase (to earth) short circuits.
Typically marine/offshore electrical systems are operated with the neutral point isolated from the hull or
connected to it through an impedance. In such systems, the highest value of short-circuit current would
correspond to a three phase short circuit. If the neutral point is directly connected to the hull, then the
line-to-line, or line-to ships hull short-circuit may produce a higher current. Two basic system calculation
approaches can be taken, time dependent and non-time dependent.
According to the IEC 61363 standard [7], PowerFactory calculates an equivalent machine that feeds di-
rectly into the short circuit location. This machine summarizes all active and non-active components
of the grid.
The shot-circuit procedure in IEC 61363 [7] calculate the upper envelope (amplitude) of the maximum
value of the time dependent short-circuit (see Figure 22.1.2). The envelope is calculated using particular
machine characteristics parameters obtainable from equipment manufacturers using recognized testing
methods, and applying the following assumptions:
All system capacitances are neglected.
At the start of the short-circuit, the instantaneous value of voltage in one phase at the fault point
is zero.
During the short-circuit, there is no change in the short-circuit current path.
The short-circuit arc impedance is neglected.
Transformers are set at the main tap position.
The short-circuit occurs simultaneously in all phases.
For generator connected in parallel, all generators share their active and reactive load proportion-
ally at the start of or during the short-circuit.
During each discrete time interval, all circuits components react linearly.
The exact guidelines on how this is achieved is specied in the standard.
Because the standard considers specic system components and models (active and non-active)
some of the models that can be used in PowerFactory will have no description according to the stan-
dard (such as External Grids, Voltage Sources, Static Generators, etc.). How these elements are
considered and transformed to a replacement equivalent machine is described in the corresponding
Technical Reference (appendix C).
According to this method, the following short-circuit values are calculated:
I
k
initial symmetrical short-circuit current,
upper envelope of short-circuit current I
k
(t) ,
i
dc
(t) decaying (aperiodic) component of short-circuit current,
i
p
peak short-circuit current,
I
k
steady-state short-circuit current.
438 DIgSILENT PowerFactory 15, User Manual
22.2. EXECUTING SHORT-CIRCUIT CALCULATIONS
The calculating formulae and methods described produce sufciently accurate results to calculate the
short-circuit current during the rst 100 ms of a fault condition. It is assumed in the standard that during
that short time the control of the generators has no signicant inuence on the short circuit values. The
method can be used also to calculate the short-circuit current for periods longer than 100 ms when
calculating on a bus system to which the generators are directly connected. For time periods beyond
100 ms the controlling effects of the system voltage regulators may be predominant. Calculations
including the voltage regulator effects are not considered in this standard.
In PowerFactory besides the standard IEC 61363 [7] method, an EMT simulation method is available
which considers also the rst 100 ms of a three phase short-circuit.
22.2 Executing Short-Circuit Calculations
There are different methods of initiating the short-circuit calculation command ComShcin PowerFac-
tory , which may result in a different conguration of the command. These methods are described in
Sections 22.2.1 and 22.2.2.
22.2.1 Toolbar/Main Menu Execution
The short-circuit command may be executed from the toolbar or main menu in PowerFactory as follows:
By pressing the icon on the main toolbar; or
By selecting the Calculation Short-Circuit ... option from the main menu.
If the user is performing the short-circuit for the rst time (by using one of the above options), the short-
circuit command will be congured in a certain manner by default; that is the command will be set by
default to execute a short-circuit calculation on all busbars/terminals in the network. If a short-circuit
calculation has been already performed (the command exists in the study case) the settings displayed by
the short-circuit command will be according to the most recent short-circuit calculation. As an example,
if the user performs a short-circuit calculation according to ANSI for only one busbar in the system, the
next time the user executes again the short-circuit, the command will have the most recent settings, that
is, in this case according to ANSI and for the specied busbar.
22.2.2 Context-Sensitive Menu Execution
The short-circuit command may be executed from the context-sensitive menu in PowerFactory by se-
lecting an element(s) in the single-line diagram, right-clicking and selecting one of the following options:
Calculate... Short-Circuit : performs a short-circuit calculation for each element selected by the
user. It should be noted that the short-circuit calculation for each element is carried out completely
independently of the short-circuit calculation for each other element. For this calculation, only the
following combinations of elements may be selected:
Single or multiple terminals/busbars; or
A single line; or
A single branch.
If several terminals/busbars are selected for analysis, the results of each individual short-circuit
calculation will be displayed together on the single-line graphic.
DIgSILENT PowerFactory 15, User Manual 439
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
Calculate... Multiple Faults: performs a short-circuit calculation according to the complete method,
for the simultaneous short-circuit of all elements selected by the user. Any combination of bus-
bars, terminals, lines and branches can be selected for this calculation. Additionally, switch/circuit
breaker open/close operations can also be included in the calculation. When this calculation is
selected, the option Multiple Faults in the ComShc dialogue will be automatically ticked.
22.2.3 Faults on Busbars/Terminals
The short-circuit command should rst be called using one of the methods described in Sections 22.2.1
and 22.2.2. The simplest way to calculate several busbar/terminal short-circuits individually and to then
combine the results into one diagram is to select the option All Busbars (or alternatively, Busbars and
Junction/Internal Nodes) in the Fault Location section of the Short-Circuit Calculation ComShc dialogue,
as displayed in Figure 22.2.1. Note that to access this option, Multiple Faults in the dialogue must be
un-selected.
Figure 22.2.1: Short-Circuit Calculation Command ComShc Dialogue: Faults at All Busbars
If the user would instead like to select from the single-line diagram a single busbar/terminal, or multi-
select several busbars/terminals for calculation, the dialogue will be congured as follows:
When only a single busbar/terminal is selected, and Calculate Short-Circuit is chosen from
the context-sensitive menu, the Fault Location reference (bottom of dialogue) is set to the selected
element.
When two or more busbars/terminals are selected and Calculate Short-Circuit is chosen from
the context-sensitive menu, the Fault Location reference (bottom of dialogue) is set to a so-
called Selection Set SetSelect object, which contains a list of references to the selected bus-
bars/terminals.
In either case, various options for the calculation can be modied. Please refer to Section 22.3 for a
detailed description of the options available. It should be noted that selecting or deselecting the option
Multiple Faults may change the selection of fault locations and may therefore lead to a calculation for
locations other than the busbars/terminals selected in the single line graphic. After pressing the Execute
button, the calculation is executed and, if successful, the results are displayed in the single line graphic.
In addition, a result report is available and may be printed out.
Once a selection of fault locations is made and the short-circuit calculation is performed, it is simple to
execute further calculations based on the same selection of elements. This can be done by the following
alternative means of executing the short-circuit calculation command:
By pressing the icon on the main toolbar; or
By selecting the Calculation Short-Circuit ... option from the main menu.
The short-circuit setup dialogue then shows the previously selected busbars/terminals in the Fault Lo-
cation section under User Selection.
440 DIgSILENT PowerFactory 15, User Manual
22.2. EXECUTING SHORT-CIRCUIT CALCULATIONS
22.2.4 Faults on Lines and Branches
It is not only possible to calculate short-circuits on busbars and terminals, but also on lines and branches.
It should be noted, however, that only a single line or a single branch can be selected at a time, for each
short-circuit calculation. It is not possible to select multiple lines and/or branches for calculation. To
calculate a short-circuit on one of these types of elements, proceed as follows:
From the single-line diagram, select a single line or a single branch where the fault should be
calculated.
Right-click on the element and select Calculation Short-Circuit .... The short-circuit command
ComShc dialogue opens and the user can then dene the location of the fault relative to the ele-
ments length (see Figure 22.2.2), including which terminal the fault distance should be calculated
from. It should be noted that the Short-Circuit at Branch/Line section of this tab is only available
when a line or branch has been selected for calculation.
Clicking the button located in the Short-Circuit at Branch/Line section of the tab will enable the
user to select whether the fault location is dened as a percentage or as an absolute value.
Figure 22.2.2: Conguration of Line/Branch Faults in ComShc Dialogue
When a fault on a line/branch is calculated, a box containing the calculation results is displayed next to
the selected element.
22.2.5 Multiple Faults Calculation
Multiple faults involve the simultaneous occurrence of more than one fault condition in a network. This
option is only available for the complete method. To calculate simultaneous multiple faults, proceed as
follows:
Select two or more elements (i.e. busbars/terminals, lines, ...) and right-click.
Select the option Calculate Multiple Faults. The Short-Circuits dialogue pops up, displaying
the short-circuit event list. A 3-phase fault is assumed by default at all locations in the event list.
Click OK. The Short-Circuit command dialogue then pops up. In this dialogue, the Multiple Faults
option is ticked in combination with the complete short-circuit method.
DIgSILENT PowerFactory 15, User Manual 441
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
Finally, press Execute to start the calculation.
In cases where the event list has to be adapted to reect the intended fault conditions (that is, not
necessarily the calculation of 3-phase faults), please proceed as follows:
Open the short-circuit events object using one of the following methods:
In the Fault Location section of the short-circuit ComShc dialogue, press the Show button
(see Figure 22.2.3; or
Press the icon located on the main tool bar (just besides the short-circuit command but-
ton); or
In a Data Manager window, open the IntEvtshc object from the current study case, also
denoted by the icon.
Figure 22.2.3: Accessing the Short-Circuit Events List
A window opens up which shows the list of events (that is short-circuits at the selected locations).
When double-clicking on one entry in this list (double-clicking on the entire row), a window with a
description of the event is opened.
The short-circuit event settings can now be modied. The list of fault locations consists of a Short-
Circuit Event List(IntEvtshc) object, which holds one or more short-circuit events (EvtShc). Each
of these events has a reference to a fault location (a busbar/terminal, line, etc.) and displays a
short description of the fault type. An example is shown in Figure 22.2.4.
The user could add more fault locations to the Short-Circuit Event List (IntEvtshc) object by right
clicking on addition elements in the single line diagram Add to.. Multiple Faults.
442 DIgSILENT PowerFactory 15, User Manual
22.3. SHORT-CIRCUIT CALCULATION OPTIONS
Figure 22.2.4: A Short-Circuit Event (EvtShc)
Note: To re-use the event list (IntEvtshc) later, this object can be copied to a user-dened folder in the
Data Manager. This will prevent it from being modied during future calculations. When repeating
the calculation with the same conguration, the reference in Calculate Multiple Faults can be
set to this object. The other option would be to copy the events to the Fault Cases folder located
in the Operational Library/Faults folder of the project. The user would then need to press the
From Library button (22.2.3).
22.3 Short-Circuit Calculation Options
The following sections describe the options available in PowerFactorys short-circuit calculation com-
mand. Some of these options are dependent upon the selected calculation method, therefore separate
sections dedicated to each method are presented.
22.3.1 Basic Options (All Methods)
The options presented in this section are common to all implemented calculation methods and are used
to dene the general settings of the short-circuit calculation. The specic options for each method are
presented below in separate sections.
DIgSILENT PowerFactory 15, User Manual 443
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
Figure 22.3.1: IEC Calculation - Basic Options
An example of the short-circuit command dialogue is shown in Figure 22.3.1 (IEC calculation in this
case). The sections of the dialogue which are common to all calculation methods are:
Method
PowerFactory provides the following calculation methods for short-circuit calculation:
according to VDE 0102/0103 [9] (the German VDE standard);
according to IEC 60909 [9] (the International IEC standard);
according to ANSI (the American ANSI/IEEE C37 standard);
complete (superposition method which considers the pre-fault load-owresults (see Section 22.1.3);
according to IEC 61363 [7].
The specic options for each of these methods are available on the Advanced Options page of the
short-circuit command ComShc dialogue.
Fault Type
The following fault types are available:
3-Phase Short-Circuit
2-Phase Short-Circuit
Single Phase to Ground
2-Phase to Ground
1-Phase to Neutral
1-Phase Neutral to Ground
444 DIgSILENT PowerFactory 15, User Manual
22.3. SHORT-CIRCUIT CALCULATION OPTIONS
2-Phase to Neutral
2-Phase Neutral to Ground
3-Phase to Neutral
3-Phase Neutral to Ground
3-Phase Short-Circuit (unbalanced)
The fault types with a neutral conductor should only be used for systems which are modelled using
neutral conductors.
Fault Impedance (Except for IEC 61363)
The fault impedance corresponds to the reactance and the resistance of the fault itself (such as the
impedance of the arc or of the shortening path). This can be dened by means of an enhanced model,
where line to line (Xf(L L), Rf(L L)) and line to earth Xf(L E), Rf(L E)) impedances are
regarded (note: requires option Enhanced Fault Impedance to be enabled). If the option Enhanced
Fault Impedance is not enabled, fault impedances are dened by their equivalent values, Xf and Rf.
Figures 22.3.2 to 22.3.4 illustrate the differences between the enhanced and the simplied represen-
tation of fault impedances for the following fault types: (i) 3-phase short-circuits; (ii) 2-phase faults to
ground; and (iii) 2-phase faults.
Figure 22.3.2: Fault Impedance Denition: 3-Phase Short-Circuit
Figure 22.3.3: Fault Impedance Denition: 2-Phase to Ground Fault
DIgSILENT PowerFactory 15, User Manual 445
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
Figure 22.3.4: Fault Impedance Denition: 2-Phase Fault
Show Output
A textual report is automatically written to PowerFactorys output window when the Show Output Show
Output option of the dialogue is enabled. The command which generates this report is displayed in blue
text next to the Command button . The user can click on this button to select which type of report
will be printed out. Just below the Command button, blue text informs the user of the currently-selected
report type.
Fault Location
The fault location selection options are:
At User Selection: In this case a reference to a single terminal/ busbar/ line/ branch or to a
selection of busbars/ terminals SetSelect, as explained in Sections 22.2.3 and 22.2.4must be
given.
At Busbars and Junctions/ Internal Nodes: For every terminal (ElmTerm) in the network, a
short-circuit calculation is carried out, independently (one after the other).
At All Busbars: For every terminal (ElmTerm) in the network whose Usage is set to Busbar, a
short-circuit calculation is carried out, independently (one after the other).
If the option Multiple Faults has been ticked when the Complete Method is being used, a reference to
a set of fault objects (IntEvtshc), as explained in Section 22.2.5, must be set. This is done in the Fault
Location section of the dialogue; using the Short Circuits reference.
Note: Multiple faults will only be calculated for the Complete Method, when the option Multiple Faults is
enabled. When this option is enabled, a short-circuit calculation is carried out for each individual
fault location, simultaneously. When this option is disabled, cases where more than one fault loca-
tion have been selected (i.e. several busbars/terminals), a sequence of short-circuit calculations
is performed (i.e. each short-circuit calculation is carried out independently of each other short-
circuit calculation).
22.3.2 Verication (Except for IEC 61363)
When enabled (Verication Tab Page), the user can enter thresholds for peak, interrupting and thermal
maximum loading. The Verication option will then write a loading report to the output window with
all devices that have higher loadings than the dened max. values. This report shows the various
maximum and calculated currents for rated devices. Rated devices include, for instance:
Lines which have a rated short-time current in their line type which is greater than zero; and
Breakers or coupling switches which have a type with a valid rated current.
446 DIgSILENT PowerFactory 15, User Manual
22.3. SHORT-CIRCUIT CALCULATION OPTIONS
22.3.3 Basic Options (IEC 60909/VDE 0102 Method)
The Basic Options page of the Short-Circuit Calculation dialogue is shown in the previous section in
Figure 22.3.1. In general, please note that the calculation according to IEC 60909 [9] and VDE 0102
does not take into account line capacitances, parallel admittances (except those of the zero-sequence
system) and non-rotating loads (e. g. ElmLod). Single phase elements are considered only if they are
located in the neutral conductor.
Published
This option offers a sub-selection for the selected Method, where the version of the standard to be
used can be selected according to the year in which it was issued. The most recent standard is 2001,
however 1990 is still available for the verication of documented results.
Calculate
The drop-down list offers the choice between the minimal or maximal short-circuit current. If external
grids are dened, the corresponding maximum or minimum value will be selected automatically. For
example if in the short circuit command you select Calculate according to Maximum Short Circuit
currents, the maximum short circuit value from the external grid is considered for the calculation. The
equivalent voltage source is based on the nominal system voltage and the voltage factor c. The voltage
factor c will depend on the voltage level and on the selection of the Calculate according to stated in
the short-circuit command.
Max. Voltage tolerance for LV systems
In accordance with the IEC/VDE standard, this voltage tolerance is used to dene the respective voltage
correction factor, c. The voltage tolerance is not used when a user-dened correction factor is dened.
Short-Circuit Duration
The value for the Breaker Time is used to calculate the breaking current of a circuit breaker. The value
for the Fault Clearing Time (Ith) is required for the equivalent thermal current.
Note: The elds Method, Fault Type, Fault Impedance, Output and Fault Location are described in
Section 22.3.1.
DIgSILENT PowerFactory 15, User Manual 447
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
22.3.4 Advanced Options (IEC 60909/VDE 0102 Method)
Figure 22.3.5: IEC calculation - Advanced Options
Generally, the Advanced Options page (shown in Figure 22.3.5) is used for settings to tune the various
short-circuit calculation methods. Familiarization with the IEC/VDE standard before modifying these
options is strongly recommended.
Grid Identication
The calculation of the factor kappa is different in the cases of meshed or radial feeding of the short-
circuit. Normally PowerFactory will automatically nd the appropriate setting. The option Always meshed
will force a meshed grid approach.
c-Voltage Factor
The standard denes the voltage factor c to be used for the different voltage levels. In special cases
the user may want to dene the correction factor. In this case, activate the box User-Dened, then a
specic c-factor can be entered.
Asynchronous Motors
Whether the calculation considers the inuence of asynchronous motors on short-circuit currents de-
pends on this setting, which may be Always Considered, Automatic Neglection, or Conrmation of
Neglection.
Conductor Temperature
When activating the User-Dened option, the initial (pre-fault) conductor temperature can be set man-
ually. This will inuence the calculated maximum temperature of the conductors, as caused by the
short-circuit currents.
Decaying Aperiodic Component
Allows for the calculation of the DC current component, for which the decay time must be given. Ac-
cording to the IEC/IEC standard, methods B, C and C
can be selected.
The following nomenclature is used:
448 DIgSILENT PowerFactory 15, User Manual
22.3. SHORT-CIRCUIT CALCULATION OPTIONS
T
b
) Breaker Time (see Short-Circuit command)
f n) Nominal frequency
I
k
) Initial short-circuit current
Method B: Uses the complex calculated equivalent impedance of the network with a security
factor of 1.15:
i
DC
=
2 I
k
e
T
b
R
x
(22.4)
Method C Uses the R/X ratio calculated with the equivalent frequency method. The equivalent
frequency is dependent on the breaking time (see Table 22.3.1). This method is recommended
for maximum accuracy.
I
DC
=
2 I
k
e
T
b
R
f
x
f
(22.5)
R
f
X
f
=
R
c
X
c
f
c
f
nom
(22.6)
The ratio Rc/Xc is the equivalent impedance calculated at the frequency given by:
f
c
=
f
c
f
nom
f
nom
(22.7)
Method C Uses the R/X ratio as for the peak short-circuit current, thus selecting the ratio fc/fn
= 0.4. This option speeds up the calculation, as no additional equivalent impedance needs to be
calculated.
Peak Short-Circuit Current (Meshed network)
In accordance with the IEC/VDE standard, the following methods for calculating kappa can be selected:
Method B Uses the ratio R/X at the short-circuit location.
Method C(1) Uses the ratio R/X calculated at a virtual frequency of 40% of nominal frequency
(20 Hz for fn = 50 Hz, or 24 Hz for fn=60 Hz), based on the short-circuit impedance in the positive
sequence system.
Method (012) Like C(1), but uses the correct short-circuit impedance based on the positive-,
negative- and zero-sequence system.
Calculate Ik
The steady-state short-circuit currents can be calculated using different means to consider asynchronous
machines:
Without Motors Will disconnect all asynchronous motors before calculating the current I
k
.
DIgSILENTMethod Considers all asynchronous motors according to their breaker current. The
breaker opens after the maximum possible time.
f
n
T
b
< 1 < 2.5 < 5 < 12.5
f
c
/f
n
0.27 0.15 0.092 0.055
Table 22.3.1: Breaking Times
DIgSILENT PowerFactory 15, User Manual 449
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
Ignore Motor Contributions Considers asynchronous motor impedances during the calculation,
but will reduce the calculated results for motor contributions.
Consider Protection Devices
This option will calculate measured currents for all protection devices and will evaluate tripping times.
To increase the speed of the calculation, this option can be disabled when protection devices do not
need to be analyzed.
Calculate max. Branch Currents = Busbar Currents
This option is used to check the rating of the circuit breakers against the system breaker currents.
Normally the breaker currents are calculated as maxIbus-Ibranch, Ibranch. If this option is activated,
the busbar short-circuit current is used as the breaker current, which is actually an over-estimation of
the currents.
Automatic Power Station Unit detection
The IEC/VDE standard forces a different impedance correction factor to be applied to separate gen-
erators and transformers than that applied to a unit/block (power station) consisting of a generator
including its step-up transformer. PowerFactory tries to detect power stations. When this option is dis-
abled, block transformers must be marked accordingly by setting the Unit Transformer option available
in the VDE/IEC Short-Circuit page of the transformer element dialogue (Figure 22.1.6).
22.3.5 Basic Options (ANSI C37 Method)
Figure 22.3.6: ANSI calculation - Basic Options
Prefault Voltage
Value of the pre-fault voltage. In ANSI, the pre-fault voltage is the system rated voltage (1.0 p.u.).
Although a higher or lower voltage can be used in the calculation if operation conditions show otherwise.
Consider Transformer Taps
The ANSI standard optionally allows the current tap positions of the transformers to be considered. This
450 DIgSILENT PowerFactory 15, User Manual
22.3. SHORT-CIRCUIT CALCULATION OPTIONS
can be selected here.
NACD Mode
Depending on the location of the fault, ANSI classies the different currents being fed to the short circuit
as local or remote. A remote source is treated as having only a dc decay, while a local source is
treated as having a dc and ac decay. Depending on this classication, corresponding curves are used
in order to obtain the multiplication factors.
In PowerFactory the ANSI short-circuit method has the option of selecting the NACD (No AC Decay)
mode.
The NACDfactor is the ratio of remote current contribution to the total fault current: NACD= I
remote
/I
fault
.
This NACD factor is used to calculate the breaker currents, including the DC component of the current.
The remote current contribution required to evaluate the NACD factor is the sum of all remote generator
contributions (induction generators, synchronous machines, and external grids).
The calculation of the NACD factor can be very time consuming, as the contribution of each generator
is calculated individually. Therefore, different approximation methods can be selected, which represent
the most common interpretations of the ANSI standard:
Interpolated The NACD factor is calculated, and the correction factor for the asymmetrical fault
current is interpolated between the dc decay only and AC/DC decay curves with the following
equation: MF = AC/DCfactor +(DCfactor AC/DCfactor)NACD If (NACD = 1) then only
the DC factor is used; if (NACD = 0) then only the AC/DC factor is used.
Predominant) The the NACD factor is calculated. If the resulting factor is greater than or equal
to 0.5, then the dc decay only curve is used, which means that the remote generation is higher
than the local generation.
All Remote All contributions are set to remote; the NACD factor is not calculated, but assumed
equal to 1 and only the dc decay only curve is used.
All Local All contributions are set to local; the NACD factor is not calculated, but assumed equal to 0
and only the AC/DC decay curve is used.
Current/Voltages for
The calculation mode for the currents and voltages to be evaluated:
LV/Momentary Evaluates the subtransient short-circuit currents.
LV/Interrupting Evaluates the breaker currents.
30 Cycle Evaluates the 30-cycle (steady-state) current.
Note: The elds Method, Fault Type, Fault Impedance, Output and Fault Location are described in
Section 22.3.1.
DIgSILENT PowerFactory 15, User Manual 451
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
22.3.6 Advanced Options (ANSI C37 Method)
Figure 22.3.7: ANSI Calculation - Advanced Options
Calculate
This option is used to select the various currents (according to the ANSI standard) which are to be
calculated. The options are as follows:
Momentary Current (Close and Latch Duties)
Interrupting Current
30 Cycle Current
Low-Voltage Current
Bypass Series Capacitance
Series capacitances may be optionally bypassed for the ANSI short-circuit calculation. Alternatively,
they may be not bypassed, always bypassed/neglected or this option may be set depending on the type
of short-circuit being calculated. The options are as follows:
No Bypassing
All Currents
LV & Interrupting & 30 Cycle Current
30 Cycle Currents
X/R Calculation
The user may select between a complex number X/R ratio calculation, or a calculation which considers
R and X separately. The fault point X/R will determine the system dc time constant and consequently
the rate of decay of the transient dc current. Although in PowerFactory the X/R ration can be calculated
from the complex network reduction, using this approach will not insure a conservative result. In an
attempt to provide a conservative approach, ANSI C31.010 requires that the X/R ratio be determined
by a separate R network reduction.
Consider Protection Devices
452 DIgSILENT PowerFactory 15, User Manual
22.3. SHORT-CIRCUIT CALCULATION OPTIONS
This option will calculate measured currents for the selected protection devices and will evaluate tripping
times. To increase the speed of the calculation, this option can be disabled when protection devices do
not need to be analyzed.
Calculate max. Branch Currents = Busbar Currents
This option is used to check the rating of the circuit breakers against the system breaker currents.
Normally the breaker currents are calculated as maxIbus-Ibranch, Ibranch. If this option is activated,
the busbar short-circuit current is used as the breaker current, which is actually an over-estimation of
the currents.
22.3.7 Basic Options (Complete Method)
Figure 22.3.8: Complete Method - Basic Options
As opposed to the calculation methods according to IEC/VDE and ANSI, which represent short-circuit
currents by approximations, the complete method evaluates currents without using approximations. This
accurate evaluation of the currents takes into account the system conditions immediately prior to the
onset of the fault.
Load Flow
The pre-fault system condition used by the complete method can be determined either by the evaluation
of a load ow, or by means of a simplied method, which initializes the internal voltages of all compo-
nents that contribute to the short-circuit current with their nominal values, multiplied by a scaling factor,
c.
The load ow command used to initialize the short-circuit calculation (when Load Flow Initialization on
the Advanced Options page is selected, see Section 22.3.8) is displayed next to the button labelled
Load Flow ( ). The load ow command can be accessed and modied by pressing this button .
The load ow command displayed here is initially taken from the currently active study case.
Short-Circuit Duration
The value for the Break Time (when set to Global) is used to calculate the breaking current of circuit
breakers. Depending on the user selection, the value used for the break time within the calculation is:
DIgSILENT PowerFactory 15, User Manual 453
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
global When set to Global, the breaking current is calculated according to the Break Time spec-
ied in the short-circuit command.
min. of local When set to min. of local, the breaking current is calculated according to the short-
est Break Time of all circuit breakers (dened in the Complete Short-Circuit page of ElmCoup
objects) connected to the busbars being studied.
local When set to local , the breaking current is calculated for each connected circuit-breaker ac-
cording to its own Break Time (dened in the Complete Short-Circuit page of ElmCoup objects),
however, the busbar results will show the breaking current according to the shortest Break Time
of all circuit breakers.
Note: The elds Method, Fault Type, Fault Impedance, Output and Fault Location are described in
Section 22.3.1.
22.3.8 Advanced Options (Complete Method)
Figure 22.3.9: Complete Method - Advanced Options
Initialization
The user may select to initialize the complete method by one of the following options:
the load ow calculation referred to in the Load Flow eld of the wordBasic Options tab; or
the nominal voltages with a user-dened correction factor (c-Factor ). It should be noted that this
option is only available in the dialogue when Load Flow Initialisation is not selected.
Peak, DC Currents, R/X ratio (ip, ib, idc)
454 DIgSILENT PowerFactory 15, User Manual
22.3. SHORT-CIRCUIT CALCULATION OPTIONS
This option allows the denition of the method used to determine the factor kappa () and the R/X
b
ratio, required for the calculation of the peak and the DC component of the short-circuit current. The
methods available correspond to those given in the IEC/VDE standard.
B Uses the ratio R/X at the short-circuit location. In this case both ratios (R/X
p
for the calculation
of , and R/X
b
) are equal.
C(1) For , the ratio R/X
p
calculated at a virtual frequency of 40% (based on the short-circuit
impedance in the positive sequence system) is used. The R/X
b
ratio is calculated according
to the equivalent frequency method, considering the breaking time and the positive sequence
impedance (as for Method C from the IEC standard, however it should be noted that the IEC
correction factors are not considered).
C(012) Like C(1) described directly above, but uses the correct short-circuit impedance based on
the positive-, negative- and zero-sequence system.
Consider Protection Devices
This option will calculate measured currents for all protection devices and will evaluate tripping times.
This option can be disabled to increase the calculation speed when protection devices do not need to
be analyzed.
Calculate max. Branch Currents = Busbar Currents
This option is used to check the rating of the circuit breakers against the system breaker currents.
Normally the breaker currents are calculated as max(I
bus
I
branch
, I
branch
). If this option is activated, the
busbar short-circuit current is used as the breaker current, which is an over-estimation of the currents.
Overhead Line Modelling: Phase Matrices
For the unbalanced short-circuit calculation, PowerFactory always uses the phase component matrix.
The following options dene which phase matrix is used: Untransposed: the short-circuit calculation
uses the untransposed phase matrix. Symmetrically Transposed: the short-circuit calculation uses
the symmetrically transposed phase matrix for untransposed lines.
DIgSILENT PowerFactory 15, User Manual 455
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
22.3.9 Basic Options (IEC 61363)
Figure 22.3.10: IEC 61363 (EMT) - Basic Options
Calculate Using
In that section the user could select between the options:
Standard IEC 61363 Method
EMT Simulation Method
With the rst option the short-circuit is calculated according to the IEC 61363 standard [7]this is outlined
in section 22.1.4. This short-circuit calculation method is only an approximation and therefore the results
are not exact. When selecting the EMT method PowerFactory calculates for each fault case a three
phase short-circuit with a fault impedance of 0 ohm on the selected locations. This additional, high
precision short-circuit calculation method provides further valuable information, and especially when
power systems objects must be considered, which are not covered by the IEC 61363 standard[7]. The
Break Time input parameter represents the contact separation time for circuit-breakers. The default
setting is 100 ms. If the EMT Simulation Method option is active the conguration of the Simulation and
also the Simulation Results are available. The Simulation option displays the *.ComSim dialogue that is
described in more detail in Chapter 25 (Stability and EMT Simulations). The simulation time is set per
default to 160 ms. This is necessary because the short circuit is started after phase A voltage crosses
zero and because the rst 100 ms after the short-circuit are displayed as results.
The Simulation Results pointer indicates where the results of the EMT short-circuit simulation will be
stored (ElmRes). Typically no changes are required. In another note, this EMT simulation setup (Initial
Conditions and Run Simulation command) is stored separately from the normal EMT simulation in order
to avoid confusion.
Fault Impedance
456 DIgSILENT PowerFactory 15, User Manual
22.4. RESULT ANALYSIS
The Fault Impedance option is disabled since the IEC 61363 [7] standard considers the short-circuit
impedance to be zero.
Create Plots
By enabling the Create Plots option, the user can select between the following:
Show only short-circuit currents at faulted terminal With this option selected, PowerFactory will
create automatically a time domain plot of the short-circuit current at the selected terminal, which
includes its upper envelope and DC component.
Show all short-circuit current contributions With this option selected PowerFactory will create au-
tomatically a time domain plot of the short-circuit current at the selected terminal and a plot for
all connected elements to the faulted terminal. Each created plot will consist of the short-circuit
current, the upper envelope and the DC component.
22.3.10 Advanced Options (IEC 61363)
The settings available on the advanced options page of the IEC 61363 dialogue will depend on the
selected calculation method.
Standard IEC 61363 [7]
With the standard calculation method the pre-load condition can be congured. The available options
are:
use load ow initialization If this option is selected, a load ow calculation is rst carried out (a
reference to the low ow command is shown). If the load ow is successful, the results are then
used to calculate the short circuit.
use rated current/power factor If this option is selected, the preload condition is obtained from the
rated values of the grid elements (no load ow calculation is executed).
neglect preload condition If this option is selected, no preload information is used to calculate the
short circuit.
Furthermore, the user will notice the option Consider Transformer Taps. According to the standard
however, all transformers should be considered with their main position, therefore this option should be
normally disabled.
EMT Simulation Method
If the short-circuit is calculated using the EMT simulation method, in the Advanced Options page the
user will have the option to assume the inertia as innite, meaning that if selected, the acceleration time
constant of all rotating machines will be set to 9999 seconds.
22.4 Result Analysis
In PowerFactory the results can be displayed directly in the single line diagram, in tabular form or by
using predened report formats. Also available are several diagram colouring options in other to have a
quick overview of the results.
DIgSILENT PowerFactory 15, User Manual 457
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
22.4.1 Viewing Results in the Single Line Diagram
Once a load ow calculation has been successfully executed, the result boxes shown in the single-line
diagram will be populated. There is a result box associated with each side of an element. So for
example a load has one result box, a line two result boxes, and a three-winding transformer three result
boxes. In PowerFactory these elements are collectively called edge elements. In addition, there are
result boxes for nodes or buses.
The information shown inside a result box depends on the element to which it is associated. There are
a few predened formats for edge elements and a few predened formats for buses. In order to see
the selection, rst perform a short-circuit, then, from the main menu, select Output Results for Edge
Elements or Output Results for Short-Circuit Buses or Output Results for Short-Circuit Buses.
These menu options will show the list of available result box formats. Alternatively, you can select (click)
inside a result box on the single-line diagram, then right-click and from the context sensitive menu
choose Format for Edge Elements or in case of a node Format for Nodes. Figure 22.4.1 serves as an
example.
Figure 22.4.1: Selecting the Result Box from the Single Line Diagram.
Besides these predened formats the result boxes can be formatted in order to display selected vari-
ables.
By right-clicking on one of the result boxes and selecting the option Edit Format for Edge Elements and
afterwards pressing the Input Mode button two options will be available: User Selection or Format
Editor. The User selection option will allow the selection of any of the available variables.
22.4.2 Flexible Data Page
Once a short-circuit calculation has been successfully executed, pressing the Edit Relevant Objects
for Calculation button ( ) located on the main menu will prompt a submenu with icons for all classes
that are currently used in the calculation. Clicking any of the class-icons will open a browser with all
elements of that class that are currently used in the calculation. The left-most tab-page at the bottom of
the browser is the Flexible Data tab page. Click on this tab page to show the exible data. To change
the columns in the exible page, press the Dene Flexible Data button ( ). This will bring a selection
window where the set of variables can be edited. In the left pane the available variables will be shown
while the right pane will list the selected variables. Pressing the or buttons will move the selected
variable from the one pane to the other pane.
458 DIgSILENT PowerFactory 15, User Manual
22.4. RESULT ANALYSIS
22.4.3 Predened Report Formats (ASCII Reports)
In PowerFactory there are predened report formats also called ASCII reports, available to the user.
These ASCII reports can be created by pressing the Output Calculation Analysis button ( ) located
on the main menu (a short-circuit must be calculated rst). This will bring a selection window in which
the user can select a specic type of report. Some reports like the Currents/Voltages will have various
options which the user can set. The report selection window also shows the report denition which will
be used for the selected report. Pressing Execute will write the report to the output window. Although
the reports are already predened, the user has the possibility of modifying the reports if required
(by clicking on the blue arrow pointing to the right of the User Format denition). A Show Output and
Verication Report can be also printed out automatically each time a short-circuit calculation is executed
(see Section 22.3.1 and 22.3.2).
22.4.4 Diagram Colouring
When performing short-circuit calculations, it is very useful to colour the single line-diagram in order
to have a quick overview of the results, for example if elements have a loading above rated short-time
current or if peak short-circuit currents are higher than the specied values. In PowerFactory there is
the option of selecting different colouring modes according to the calculation performed. If a specic
calculation is valid, then the selected colouring for this calculation is displayed. As an example, if the
user selects the colouring mode Areas for No Calculation and Loading of Thermal/Peak Short-
Circuit Current for the short-circuit calculation, then the initial colouring will be according to Areas.
However, as soon as the short-circuit is calculated, the diagram will be coloured according to Loading
of Thermal/Peak Short-Circuit Current. If the short-circuit calculation is reset or invalid, the colouring
mode switches back to Areas. The Diagram Colouring has also a 3-priority level colouring scheme
also implemented, allowing colouring elements according to the following criteria: 1st Energizing status,
2nd Alarm and 3rd Normal (Other) colouring.
Energizing Status If this check box is enabled De-energized or Out of Calculation elements
are coloured according to the settings in the Project Colour Settings. The settings of the De-
energized or Out of Calculation mode can be edited by clicking on the Colour Settings button.
Alarm If this check box is enabled a drop down list containing alarm modes will be available. It
is important to note here that only alarm modes available for the current calculation page will be
listed. If an alarm mode is selected, elements exceeding the corresponding a limit are coloured.
Limits and colours can be dened by clicking on the Colour Settings button.
Normal (Other) Colouring Here, two lists are displayed. The rst list will contain all available
colouring modes. The second list will contain all sub modes of the selected colouring mode. The
settings of the different colouring modes can be edited by clicking on the Colour Settings button.
Every element can be coloured by one of the three previous criteria. Also, every criterion is optional and
will be skipped if disabled. Regarding the priority, if the user enables all three criterions, the hierarchy
taken account will be the following:
Energizing Status overrules the Alarm and Normal Colouring mode. The Alarm mode overrules
the Normal Colouring mode.
DIgSILENT PowerFactory 15, User Manual 459
CHAPTER 22. SHORT-CIRCUIT ANALYSIS
460 DIgSILENT PowerFactory 15, User Manual
Chapter 23
Harmonics Analysis
23.1 Introduction
One of the many aspects of power quality is the harmonic content of voltages and currents. Har-
monics can be analyzed in either the frequency domain, or in the time-domain with post-processing
using Fourier Analysis. The PowerFactory harmonics functions allow the analysis of harmonics in the
frequency domain. The following functions are provided by PowerFactory:
23.2 Harmonic Load Flow (including harmonic load ow according to IEC 61000-3-6 [6] and icker
analysis according to IEC 61400-21 [11])
23.3 Frequency Sweep
PowerFactorys harmonic load ow calculates actual harmonic indices related to voltage or current dis-
tortion, and harmonic losses caused by harmonic sources (usually non-linear loads such as current
converters). Harmonic sources can be dened by either a harmonic current spectrum or a harmonic
voltage spectrum. In the harmonic load ow calculation, PowerFactory carries out a steady-state net-
work analysis at each frequency at which harmonic sources are dened.
A special application of the harmonic load ow is the analysis of ripple-control signals. For this applica-
tion, a harmonic load ow can be calculated at one specic frequency only.
The harmonic load ow command also offers the option of calculating long- and short-term icker dis-
turbance factors introduced by wind turbine generators. These factors are calculated according to IEC
standard 61400-21 [11], for wind turbines generators under continuous and switching operations.
In contrast to the harmonic load ow, PowerFactorys frequency sweep performs a continuous frequency
domain analysis. A typical application of the frequency sweep function calculates network impedances.
The result of this calculation facilitates the identication of series and parallel resonances in the network.
These resonance points can identify the frequencies at which harmonic currents cause low or high
harmonic voltages. Network impedances are of particular importance for applications such as lter
design.
PowerFactory provides a toolbar for accessing the different harmonic analysis commands. This tool-
bar can be displayed (if not already active) by clicking the Change Toolbox button and selecting
Harmonics/Power Quality.
The Harmonics/Power Quality toolbar provides icons to access two pre-congured command dialogues:
Calculate Harmonic Load Flow
DIgSILENT PowerFactory 15, User Manual 461
CHAPTER 23. HARMONICS ANALYSIS
Calculate Impedance Frequency Characteristics (Frequency Sweep)
These command dialogues can be also accessed via PowerFactory s main menu by selecting:
Calculation Harmonics/Power QualityHarmonic Load Flow. . . ; or
Calculation Harmonics/Power QualityImpedance Frequency Characteristic. . .
Additionally, following the calculation of a harmonic load ow, the icon Filter Analysis on this toolbar
is activated. This icon is used to open the Filter Analysis (ComSh) command dialogue. This command
analyzes results from the most recent harmonic load ow calculation and outputs results to PowerFac-
torys output window. All functions and their usage are described in this chapter.
23.2 Harmonic Load Flow
To calculate a harmonic load ow, click on the Calculate Harmonic Load Flow icon to open the
dialogue for the Harmonic Load Flow (ComHldf ) command as shown in Figure 23.2.1.
Figure 23.2.1: Harmonic Load Flow Command (ComHldf )
For a detailed description of how harmonic injections are considered by PowerFactory, refer to Sec-
tion 23.5 (Modelling Harmonic Sources), in which the analysis and the harmonic indices are described.
The following sections describe the options available in the harmonic load ow command.
23.2.1 Basic Options
Network Representation
Balanced In the case of a symmetrical network and balanced harmonic sources, characteristic
harmonics either appear in the positive sequence component (7th, 13th, 19th, etc.), or in the
negative sequence component (5th, 11th, 17th, etc.). Hence, at all frequencies a single-phase
equivalent (positive or negative sequence) can be used for the analysis.
Unbalanced, 3-phase (ABC) For analyzing non-characteristic harmonics (3rd-order, even-order,
inter-harmonics), unbalanced harmonic injections, or harmonics in non-symmetrical networks,
the Unbalanced, 3-phase (ABC) option for modelling the network in the phase-domain should be
selected.
462 DIgSILENT PowerFactory 15, User Manual
23.2. HARMONIC LOAD FLOW
Calculate Harmonic Load Flow
Single Frequency Selecting this option will perform a single harmonic load ow calculation at the
given Output Frequency (parameter name: fshow) or at the given Harmonic Order (parameter
name: ifshow). A common application for this input mode is the analysis of ripple control systems.
The results of the analysis are shown in the single line diagram, in the same way as for a normal
load ow at the fundamental frequency.
All Frequencies Selecting this option will perform harmonic load ow calculations for all frequen-
cies for which harmonic sources are dened. These frequencies are gathered automatically prior
to the calculation. The results for all frequencies are stored in a result le, which can be used
to create bar chart representations of harmonic indices (see also Section 17.5.2 (Plots)). The
results of the analysis at the given Output Frequency are shown in the single line diagram.
Nominal Frequency, Output Frequency, Harmonic Order
Nominal Frequency The harmonics analysis function in PowerFactory can only calculate har-
monics of AC-systems with identical fundamental frequencies. The relevant nominal frequency
must be entered here (usually 50Hz or 60Hz).
Output Frequency This is the frequency for which results are displayed in the single-line graphic.
In the case of a Single Frequency calculation, this is the frequency for which a harmonic load ow
is calculated. When option All Frequencies is selected, this parameter only affects the display
of results in the single line diagram. It does not inuence the calculation itself. In this case, the
results displayed in the single line diagram are for the dened Output Frequency. A change made
to the Output Frequency will cause the Harmonic Order to be automatically changed accordingly.
Harmonic Order This is the same as the Output Frequency but input as the Harmonic Or-
der (f/fn). The Harmonic Order multiplied by the Nominal Frequency always equals the Output
Frequency. Both oating-point and integer values are valid as inputs. A change made to the
Harmonic Order will cause the Output Frequency to be automatically changed accordingly.
Calculate Flicker
Calculate Flicker When selected, the long- and short-term icker disturbance factors are calcu-
lated according to IEC standard 61400-21. See Section 23.6 (Flicker Analysis (IEC 61400-21))
for more detailed information.
Calculate Sk at Fundamental Frequency
Calculate Sk at Fundamental Frequency When selected, the short-circuit power, Sk, and
impedance angle, psik, are calculated at the point of common coupling (PCC) for all 3-phase
buses in the network being analyzed. This calculation is only performed at the fundamental
frequency. For an unbalanced harmonic load ow, impedance ratios (as described in Sec-
tion 23.7.2.1 (Calculation of Impedance Ratios)) at 3-phase buses are also calculated. See
Section 23.7 (Short-Circuit Power Sk) for more detailed information.
Result Variables and Load Flow
Result Variables This option is available if Calculate Harmonic Load Flow option All Frequencies
has been selected, and is used to select the target result object for storing the results of the har-
monic load ow. See Section 23.8 (Denition of Result Variables) for more information regarding
specifying and dening result variables.
Load Flow This displays the load ow command used by the calculation. Click on the arrow button
to inspect and/or adjust the load ow command settings.
DIgSILENT PowerFactory 15, User Manual 463
CHAPTER 23. HARMONICS ANALYSIS
23.2.2 IEC 61000-3-6
Treatment of Harmonic Sources The alpha exponent values on this page will only be considered
by the harmonic load ow (that is to say that the calculation will be carried out according to the IEC
61000-3-6 standard [6]) if at least one harmonic source in the network is dened as IEC 61000 (see
Section 23.5.1 (Denition of Harmonic Injections)). On this page, if According to IEC 61000-3-6 is
selected, these tables display the alpha exponent values as given in the IEC 61000-3-6 standard, as
read-only values. If User Dened is selected, the denition of the alpha exponent values is user-
denable in terms of integer and/or non-integer harmonic orders.
23.2.3 Advanced Options
Calculate HD and THD
Based on Fundamental Frequency Values (IEEE) All values are based on fundamental fre-
quency values, as dened by IEEE standards.
Based on Total RMS-Values (DIN) All values are based on true RMS-values, as dened by
DIN standards.
Based on Rated Voltage/Current All values are based on the rated voltage/current of the buses
and branches in the network, respectively.
23.3 Frequency Sweep
To calculate frequency dependent impedances, the impedance characteristic can be computed for a
given frequency range using the Frequency Sweep command (ComFsweep). This function is available
by clicking on the Calculate Frequency Impedance Characteristic icon ( ) available in the Harmonics
toolbar. The harmonic frequency sweep command is shown in Figure 23.3.1.
Figure 23.3.1: Frequency Sweep Command (ComFsweep)
Harmonic analysis by frequency sweep is normally used for analyzing self- and mutual- network impedances.
However, it should be noted that not only self- and mutual-impedances can be analyzed and shown.
The voltage source models (ElmVac, ElmVacbi ) available in PowerFactory allow the denition of any
spectral density function. Hence, impulse or step responses of any variable can be calculated in the fre-
464 DIgSILENT PowerFactory 15, User Manual
23.3. FREQUENCY SWEEP
quency domain. One common application is the analysis of series resonance problems. The following
sections describe the options available in the harmonic frequency sweep command.
23.3.1 Basic Options
Network Representation
Balanced, positive sequence This option uses a single-phase, positive sequence network rep-
resentation, valid for balanced symmetrical networks. A balanced representation of unbalanced
objects is used.
Unbalanced, 3-phase (ABC) This option uses a full multiple-phase, unbalanced network repre-
sentation.
Impedance Calculation
The frequency sweep will be performed for the frequency range dened by the Start Frequency and
the Stop Frequency, using the given Step Size. The Automatic Step Size Adaptation option allows an
adaptive step size. Enabling this option will normally speed up the calculation, and enhance the level of
detail in the results by automatically using a smaller step size when required. The settings for step size
adaptation can be changed on the Advanced Options tab.
Nominal Frequency, Output Frequency, Harmonic Order
Nominal Frequency This is the fundamental frequency of the system, and the base frequency
for the harmonic orders (usually 50Hz or 60Hz).
Output Frequency This is the frequency for which the results in the single line diagram are
shown. This value has no effect on the actual calculation.
Harmonic Order This is the harmonic order equivalent of the Output Frequency. The Harmonic
Order multiplied by the Nominal Frequency always equals the Output Frequency. Both oating-
point and integer values are valid as inputs.
Result Variables and Load Flow
Result Variables Used to select the target result object which will store the results of the har-
monic frequency sweep. See Section 23.8 (Denition of Result Variables) for more information
regarding specifying result variables.
Load Flow This displays the load ow command used by the calculation. Click on the arrow
button to inspect and/or adjust the load ow command settings.
The results of PowerFactorys frequency sweep analysis are the characteristics of the impedances over
the frequency range.
23.3.2 Advanced Options
Selecting the option Automatic Step Size Adaptation on the Basic Data page of the frequency sweep
command is one way to increase the speed of the calculation. This option enables the use of the step
size adaptation algorithm for the frequency sweep. With this algorithm, the frequency step between two
calculations of all variables is not held constant, but is adapted according to the shape of the sweep.
When no resonances in the impedance occur, the time step can be increased without compromising
accuracy. If the impedance starts to change considerably with the next step, the step size will be reduced
again. The frequency step is set such that the prediction error will conform to the two prediction error
input parameters, as shown below:
Maximum Prediction Error errmax (typical value: 0.01)
DIgSILENT PowerFactory 15, User Manual 465
CHAPTER 23. HARMONICS ANALYSIS
Minimum Prediction Error errinc (typical value: 0.005)
Step Size Increase Delay ninc (typically 10 frequency steps)
Calculate R, X at output frequency for all nodes Normally, PowerFactory calculates the equivalent
impedance only at selected nodes. When this option is selected, following the harmonic calculation, the
equivalent impedance is calculated for all nodes.
23.4 Filter Analysis
The Filter Analysis command is a special form of the Output of Results command (ComSh), whose
function is to generate a report. It analyzes the results from the previous harmonic load ow and
outputs results to the PowerFactory output window. It outputs a summary of the harmonics for the
terminals/busbars and branch elements at the frequency specied in the Output Frequency eld of the
harmonic load ow command. It also reports the parameters and different variables for the installed
lters.
The lter analysis command can be activated using the Filter Analysis button or by using the Output
Calculation Analysis button on the main menu (see also Section 17.2.3: Output of Results). This will
open the same dialogue as that used for the reporting of harmonic results, as displayed in Figure 23.4.1.
This command can alternatively be launched from the single line graphic, after selecting one or more
elements, and right-clicking and selecting Output Data. . . Results. Results will then be output for
the selected elements. It should be noted that elements should be selected according to the type of
report being generated. This means that for Busbars and Branches only terminals and branches should
be selected, for Busbars/Terminals only terminals should be selected; and for Filter Layout and Filter
Results only shunts should be selected. In the dialogue, the Output Frequency specied in the harmonic
load ow command is displayed in red text (see top of dialogue in Figure 23.4.1).
466 DIgSILENT PowerFactory 15, User Manual
23.4. FILTER ANALYSIS
Figure 23.4.1: Filter Analysis Report Command (ComSh)
There are four different reports available for selection:
Busbars and Branches This displays the results of the harmonic load ow for all node and branch
elements in the network. The distortion for various electrical variables is printed and summarized.
Busbars/Terminals For the electrical nodes, the rated voltage, the voltage at the calculation frequency,
as well as RMS values and distortion at the nodes are displayed.
Filter Layout The lter layout of all active lters in the network is calculated for the given frequency. The
rated values and impedances of the lter as well as the type and vector group are printed to the output
window. Additionally, the currents through the different components are shown, as are the losses.
Filter Results The lter results show the main layout of all lters in the network for the calculation
frequency. For a set of frequencies, the voltages and currents through the lter are tabulated.
Use Selection Results will only be reported for elements dened in a selection. A selection of elements
can be dened by selecting them either in the single line graphic or in the Data Manager, right-clicking
and choosing Dene. . . General Set. This General Set then exists in the Study Case and can be
selected when the Use Selection option is activated.
The default format used for the report in the output window is dened in the Used Format section on the
second page ( )of the dialog and can be set or changed by clicking on the Filter Layout arrow button
.
DIgSILENT PowerFactory 15, User Manual 467
CHAPTER 23. HARMONICS ANALYSIS
23.5 Modelling Harmonic Sources
Every switched device produces harmonics and must therefore be modelled as a harmonic source. In
PowerFactory , harmonic sources can be either current or voltage sources. The following models can
be used to generate harmonics (the PowerFactory element names are given in parentheses):
General loads (ElmLod), if they are modelled as a current source (which can be dened on the
Harmonics/Power Quality page of the loads assigned Type);
Thyristor rectiers (ElmRec, ElmRecmono);
PWM-converters (ElmVsc, ElmVscmono), which are generally modelled as harmonic voltage
sources;
Voltage sources (ElmVac, ElmVacbi ), which may also be used for ripple control applications;
Current sources (ElmIac), with a user-dened spectrum of harmonic injections.
Static generators (ElmGenstat );
Static var systems (ElmSvs).
See Section 23.5.1 (Denition of Harmonic Injections) for information on how to dene harmonic injec-
tions for these sources.
Note: Harmonic injections can be modelled in EMT simulations using the Fourier source object. For
further details please refer to the Technical References in the Appendix C.
23.5.1 Denition of Harmonic Injections
For the following PowerFactory elements, the harmonic injections must rst be dened using the Har-
monic Sources type object (TypHmccur ):
General loads (ElmLod), if they are modelled as a current source (which can be dened on the
Harmonics/Power Quality page of the loads assigned Type);
Thyristor rectiers (ElmRec, ElmRecmono);
PWM-converters (ElmVsc, ElmVscmono);
Current sources (ElmIac);
Static generators (ElmGenstat );
Static var systems (ElmSvs).
When dening the spectrumvia the Harmonic Sources type object, the harmonic infeeds can be entered
according to one of three options: Balanced, Phase Correct or Unbalanced, Phase Correct (shown
in Figures 23.5.1 and 23.5.2, respectively), or IEC 61000 (shown in Figure 23.5.3). The Harmonic
Sources object is a PowerFactory type object, which means that it may be used by many elements
who have the same basic type. Multiple current source loads may, for example, use the same Harmonic
Sources object. Note that PowerFactory has no corresponding element for this type.
Phase Correct Harmonic Sources
For the Balanced, Phase Correct harmonic sources option, in both balanced and unbalanced harmonic
load ows, the magnitudes and phases of positive and negative sequence harmonic injections at integer
harmonic orders can be dened, as shown in Figure 23.5.1.
468 DIgSILENT PowerFactory 15, User Manual
23.5. MODELLING HARMONIC SOURCES
Figure 23.5.1: Balanced, Phase Correct Harmonic Sources Type (TypHmccur )
For the Unbalanced, Phase Correct harmonic sources option, the magnitudes and phases of positive
and negative sequence harmonic injections at integer and non-integer harmonic orders can be dened,
as shown in Figure 23.5.2. In the case of a balanced harmonic load ow, harmonic injections in the zero
sequence are not considered, and harmonic injections at non-integer harmonic orders are considered
in the positive sequence. In the case of an unbalanced harmonic load ow, harmonic injections in the
zero sequence and at non-integer harmonic orders are considered appropriately. See Table 23.5.2 for
a complete summary.
DIgSILENT PowerFactory 15, User Manual 469
CHAPTER 23. HARMONICS ANALYSIS
Figure 23.5.2: Unbalanced, Phase Correct Harmonic Sources Type (TypHmccur )
IEC 61000 Harmonic Sources
The IEC 61000-3-6 standard [6] describes a second summation law, applicable to both voltage and
current, which is described mathematically as:
U
h
=
_
N
m=0
U
h,m
(23.1)
where U
h
is the resultant harmonic voltage magnitude for the considered aggregation of N sources at
order h, and is the exponent as given in Table 23.5.1 [6].
The Harmonic Sources type set to option IEC 61000 (as shown in Figure 23.5.3) allows the denition of
integer and non-integer harmonic current magnitude injections. In the case of balanced and unbalanced
harmonic load ows, zero sequence order injections and non-integer harmonic injections are considered
in the positive sequence. This is summarized in Table 23.5.2. It should be noted that in order to execute
an harmonic load ow according to IEC 61000-3-6, at least one harmonic source in the network
must be dened as IEC 61000 (i.e. as shown in Figure 23.5.3).
Alpha Exponent Value Harmonic Order
1 h < 5
1.4 5 <= h <= 10
2 h > 10
Table 23.5.1: IEC 61000-3-6 Summation Exponents According to Harmonic Order
470 DIgSILENT PowerFactory 15, User Manual
23.5. MODELLING HARMONIC SOURCES
Figure 23.5.3: IEC 61000 Harmonic Sources Type (TypHmccur )
The denition of the spectrum of harmonic injections for the voltage source (ElmVac, ElmVacbi ) and
external grid (ElmXnet ) is done differently to other elements. The harmonic injections are directly input
on the Harmonics/Power Quality page of the element itself via the Harmonic Voltages table, as shown
in Figure 23.5.4.
DIgSILENT PowerFactory 15, User Manual 471
CHAPTER 23. HARMONICS ANALYSIS
Figure 23.5.4: Denition of Harmonic Voltages for Voltage Source Element (ElmVac, ElmVacbi )
Table 23.5.3 describes the consideration of the sequence components of the harmonic orders for the
AC voltage source (ElmVac, ElmVacbi ) and external grid (ElmXnet ).
Additionally, the voltage source allows the following to be input for use in the Frequency Sweep calcula-
tion:
Spectral density of voltage magnitude;
Spectral density of voltage angle;
Frequency dependencies (in the formof a Frequency Polynomial Characteristic). See Section 23.5.4
(Frequency Dependent Parameters) and Chapter 16 (Parameter Characteristics, Load States, and
Tariffs) for further details.
Background Harmonics PowerFactory facilitates the modeling of background harmonics. This is done
using either the external grid element (ElmXnet ) or the AC voltage source element (ElmVac, ElmVacbi ),
on their respective Harmonics/Power Quality pages. If only the harmonic voltage amplitude is known
(and not the angle), the IEC 61000 option can be selected. Table 23.5.3 describes the consideration of
the sequence components of the harmonic orders for the AC voltage source and external grid.
Selection of Type of Harmonic Sources The Harmonic Sources object (TypHmccur ) is independent
of the whether the harmonic source is either a voltage source or a current source. The decision as
to whether harmonic sources are fed into the system as harmonic voltages or as harmonic currents is
made exclusively by the element to which the Harmonic Sources object is assigned. The consideration
by the calculation of the sequence components of harmonic injections is given in Table 23.5.2.
472 DIgSILENT PowerFactory 15, User Manual
23.5. MODELLING HARMONIC SOURCES
Magnitudes and Phase Values The quantities of the spectrum type are rated to current/voltage at the
fundamental frequency in the balanced case. Hence, in the case of a harmonic current source, the
actual harmonic current at frequency f
h
is calculated by:
I
h
= k
h
e
h
I
1
e
1
(23.2)
where
k
h
=
_
_
I
h
/I
1
if balanced
I
ah
/I
a1
if unbalanced phase a
I
bh
/I
b1
if unbalanced phase b
I
ch
/I
c1
if unbalanced phase c
(23.3)
h
=
_
1
if balanced
ah
a1
if unbalanced phase a
bh
b1
if unbalanced phase b
ch
c1
if unbalanced phase c
(23.4)
The values at the fundamental frequency, I
1
and
1
, are taken from a preceding load ow calculation.
A normal load ow calculation is therefore required prior to a harmonic load ow calculation.
In the case of balanced systems in which only characteristic harmonics of orders 5, 7, 11, 13, 17,
etc. occur, the option Balanced, Phase Correct should be selected in the Type of Harmonics Sources
section (as shown in Figure 23.5.1). In this context, Balanced refers to characteristic harmonics. In the
balanced case, the harmonic frequencies are determined by the program (note that in the unbalanced
case, the harmonic frequencies can be freely-dened).
For harmonic sources which produce non-characteristic, unbalanced or inter-harmonics, the option Un-
balanced, Phase Correct should be set in the Type of Harmonics Sources section. In the Unbalanced,
Phase Correct case, the harmonic frequency, magnitude and phase angle of each phase can be cho-
sen individually for each harmonic frequency. This mode therefore caters for every possible kind of
harmonic source.
The problem commonly arises as to how one can represent the harmonic content in a system which
differs to the native modal system (positive, negative or zero sequence system). The following example
illustrates how to represent the 3rd harmonic in a positive or negative sequence system (as opposed to
the native zero sequence system).
In the symmetrical case, the phase shift between the three phases is:
A : 0
B : 120
C : +120
(240
)
For harmonics of order n:
A : 0
B : n 120
C : +n 120
(= 0
)
B : 360
(= 0
)
C : +360
(= 0
)
Consequently, the 3rd harmonic in the ideally balanced case is only in the zero sequence component,
as their native modal system. For representing 3rd harmonics (and multiples thereof) in the positive
DIgSILENT PowerFactory 15, User Manual 473
CHAPTER 23. HARMONICS ANALYSIS
sequence system, the following phase correction needs to be entered:
A : 0
B : +(n 1) 120
C : (n 1) 120
(= 0
)
B : 360
+ 240
(= 120
)
C : +360
240
(= +120
)
Harmonic
Load Flow
Command
Setting
Harmonic
Current
Source
Type
Sequence Components of Harmonic
Injections
Balanced Balanced,
Phase Cor-
rect
Positive (i.e. 4, 7, 10, ...), nega-
tive (i.e. 2, 5, 8, ...);
Integer orders only.
Unbalanced,
Phase Cor-
rect
Positive, negative;
Zero sequence orders (i.e. 3,
6, 9, ...) are ignored and non-
integer harmonic orders (i.e. 5.5,
6.2, 8.35, ...) are in the positive
sequence.
IEC 61000
Positive, negative;
Zero sequence orders and non-
integer harmonics are in the pos-
itive sequence.
Unbalanced Balanced,
Phase Cor-
rect
As for balanced harmonic load
ow.
Unbalanced,
Phase Cor-
rect
Positive, negative, zero;
Integer and non-integer harmon-
ics.
IEC 61000
As for balanced harmonic load
ow.
Table 23.5.2: Consideration of Sequence Components of Harmonic Injections for TypHmccur
474 DIgSILENT PowerFactory 15, User Manual
23.5. MODELLING HARMONIC SOURCES
Harmonic
Load Flow
Command
Setting
ElmVac or
ElmXnet
Setting
Sequence Components of Harmonic
Injections
Balanced
Phase Cor-
rect
Positive (i.e. 4, 7, 10, ...), nega-
tive (i.e. 2, 5, 8, ...);
Non-integer harmonic orders (i.e.
5.5, 6.2, 8.35, ...) are considered
in the positive sequence.
Zero sequence orders (i.e. 3, 6,
9, ...) are ignored (with warning).
IEC 61000
Positive, negative;
Zero sequence orders and non-
integer harmonics are in the pos-
itive sequence.
Unbalanced
Phase Cor-
rect
Positive, negative, zero;
Non-integer harmonics are con-
sidered.
IEC 61000
As for balanced harmonic load
ow.
Table 23.5.3: Consideration of Sequence Components of Harmonic Injections for AC Voltage Source
and External Grid
23.5.2 Assignment of Harmonic Injections
The assignment of harmonic injections to the following elements is done via the individual elements
dialogue on the Harmonics page.
General loads (ElmLod), if they are modelled as a current source (which can be dened on the
Harmonics/Power Quality page of the loads assigned Type);
Thyristor rectiers (ElmRec, ElmRecmono);
PWM-converters (ElmVsc, ElmVscmono);
Current sources (ElmIac);
Static generators (ElmGenstat );
Static var systems (ElmSvs).
This is illustrated in Figure 23.5.5 for the case of a general load.
DIgSILENT PowerFactory 15, User Manual 475
CHAPTER 23. HARMONICS ANALYSIS
Figure 23.5.5: Assignment of Harmonic Current Source to a Load Element (ElmLod)
Harmonic Currents Used to select and display the assigned Harmonic Sources type (TypHmccur ).
Type of Harmonic Sources Displays the type of harmonic source selected in the assigned Harmonic
Sources type (TypHmccur ).
Harmonic current referred to For phase correct sources, the harmonic current may be referred to
either the fundamental current or the rated current. If the harmonic current source type (TypHmccur )
has been selected to be IEC 61000, the harmonic current is always referred to the rated current and
this option is read-only.
Harmonic injections dened for voltage sources (ElmVac, ElmVacbi ) are implicitly assigned, as they
are dened on the elements Harmonics page. No further assignment is therefore necessary. See
Section 23.5.1 (Denition of Harmonic Injections) for further information.
23.5.3 Harmonic Distortion Results
The harmonic load ow calculation in PowerFactory provides a vast number of results for network ele-
ments. Some of the more prominent result variables are described in this section.
The harmonic distortion of a current or of a voltage can be quantied in terms of the Harmonic Distortion
(HD), as described by (23.5). To describe the overall distortion, the Total Harmonic Distortion index THD
(see (23.6)) has been introduced. An alternative, less common index is the Total Arithmetic Distortion
TAD (see (23.7)). All distortion indices are described by their equations (below) for the current, but may
be similarly described for voltage distortion.
HD
I
(f
i
) =
|I
fi
|
|I
f1
|
(23.5)
476 DIgSILENT PowerFactory 15, User Manual
23.5. MODELLING HARMONIC SOURCES
THD
I
=
1
I
ref
_
I
2
RMS
I
2
(f
1
) (23.6)
TAD
I
=
1
I
ref
[I
A
|I(f
1
)|] (23.7)
where I(f
i
) is the component of the current at frequency f
i
and I
ref
is the reference value for the
current. The total RMS value is:
I
RMS
=
_
n
i=1
I
2
(f
i
) (23.8)
and the arithmetic sum value is:
I
A
=
n
i=1
|I(f
i
)| (23.9)
The reference value I
ref
depends on the standard used. The two possible options are the calculation
according to DIN (23.10) and according to IEEE (23.11):
I
ref,DIN
= I
RMS
(23.10)
I
ref,IEEE
= |I(f
1
)| (23.11)
Another value which may be of importance is the Total Power (23.12), which describes the power ab-
sorbed over all frequency components:
P
tot
=
n
i=1
P(f
i
) (23.12)
It should be noted that for networks containing IEC 61000 harmonic current sources, result variables for
the voltage angle and current angle are not applicable (as the angles cannot be known). Additionally,
the following result variables are available:
ku, ki : Voltage and current diversity factors, respectively (always 1 for networks containing only
phase correct sources). The voltage diversity factor is shown in (23.13):
ku =
U
2
h
(|U|)
2
(23.13)
where U
h
is the IEC 61000 harmonic voltage magnitude as dened in (23.1) and |U| is the voltage
magnitude.
HD, THD and TAD for non-integer harmonic orders.
23.5.4 Frequency Dependent Parameters
Due to the skin effect and variations in internal inductance, resistances and inductances are usually
frequency dependent. This can be modelled in PowerFactory by associating a frequency character-
istic with these quantities. Two types of characteristic may be used: either a Frequency Polynomial
Characteristic (ChaPol ) as illustrated in Figure 23.5.6, or a user-dened frequency table (TriFreq and
ChaVec). These kinds of characteristics are then assigned via the Harmonics/Power Quality page of
the corresponding elements dialogue, as illustrated by the example in Figure 23.5.7 for a line type.
DIgSILENT PowerFactory 15, User Manual 477
CHAPTER 23. HARMONICS ANALYSIS
Figure 23.5.6: The Frequency Polynomial Characteristic (ChaPol )
For the frequency polynomial characteristic object illustrated in Figure 23.5.6, the formula given by
(23.14) is used:
y(f
h
) = (1 a) +a (
f
h
f
1
)
b
(23.14)
The parameters a and b are specied in the Frequency Polynomial Characteristic dialogue. Variable y
is usually expressed as a percentage of the corresponding input parameters. For example, the resulting
line resistance is given by (23.15):
R(f
h
) = R y(f
h
) (23.15)
An example of the use of the polynomial characteristic for a line type is shown in Figure 23.5.7.
Figure 23.5.7: Frequency Dependencies in a Line Type
It is also possible to dene frequency dependent characteristics using a vectorial parameter character-
istic (ChaVec). An example for a grid impedance dened with a vectorial parameter characteristic is
shown in Figure 23.5.8.
478 DIgSILENT PowerFactory 15, User Manual
23.5. MODELLING HARMONIC SOURCES
Figure 23.5.8: Frequency Dependent Grid Impedance as Vectorial Characteristic (ChaVec)
DIgSILENT PowerFactory 15, User Manual 479
CHAPTER 23. HARMONICS ANALYSIS
The following objects can have frequency dependent parameters dened using a frequency character-
istic:
Line type (TypLne)
Asynchronous machine type (TypAsmo)
Synchronous machine type (TypSym)
Shunt/lter (ElmShnt )
AC voltage source (ElmVac)
AC voltage source - two terminals (ElmVacbi )
AC current source (ElmIac)
AC current source - two terminals (ElmIacbi )
NEC/NER (ElmNec)
Complex load (TypLodind)
2-W transformer (TypTr2)
3-W transformer (TypTr3)
Lines represented by a tower type (TypTow) are automatically assigned a harmonic characteristic. The
same applies to cables using the detailed cable representation type (TypTow).
23.5.5 Waveform Plot
The waveform plot is used to display the waveform of a voltage or a current following a harmonic load
ow calculation. The harmonics are typically emitted by a harmonic voltage or current source, as
described in Section 23.5 (Modelling Harmonic Sources).
In this plot, a waveform is generated using the magnitude and phase angle of the harmonic frequencies.
With this diagram, a variable such as the voltage or current, which is dened in a harmonic source (i.e.
a power electronic device or a load), can be easily shown as a time-dependent variable. This way the
real shape of the voltage can be seen and analyzed. An example plot of harmonic distortion is shown
in Figure 23.5.9.
480 DIgSILENT PowerFactory 15, User Manual
23.6. FLICKER ANALYSIS (IEC 61400-21)
Figure 23.5.9: Use of the Waveform Plot to display Harmonic Distortion
For a more detailed description of this type of plot, see Section 17.5.6 (The Waveform Plot). For other
types of plots, it should be noted that as the results of the discrete harmonic analysis are discrete,
the plots generated from the result le should have the Bars option enabled. To do this, open the
subplot dialogue by double-clicking on a subplot, going to the Advanced tab, and selecting Bars in the
Presentation frame.
23.6 Flicker Analysis (IEC 61400-21)
The IEC standard 61400-21 [11] describes the measurement and assessment of power quality charac-
teristics of grid connected wind turbine generators (WTGs). One of these power quality characteristic
parameters pertains to voltage uctuations. Voltage uctuations can produce undesirable effects on the
consumer side which may manifest as icker (visible ickering effects from light sources), and voltage
changes (voltage magnitude being too high or too low).
In the assessment of a WTGs power quality in terms of voltage uctuations, the operation of WTGs
can be subdivided into two modes: continuous operation and switching operations (see Sections 23.6.1
(Continuous Operation) and 23.6.2 (Switching Operations) for denitions). These modes of operation
are considered by the PowerFactory icker calculation, which calculates the short-term and long-term
icker disturbance factors. See Section 23.6.6 (Flicker Result Variables) for a list of the icker result
variables available. The calculation of icker is performed optionally as part of the harmonic load ow
command. For a detailed description of how to congure and execute a harmonic load ow, including
the calculation of icker, refer to Section 39.4.1 (Basic Options).
DIgSILENT PowerFactory 15, User Manual 481
CHAPTER 23. HARMONICS ANALYSIS
23.6.1 Continuous Operation
Continuous operation is dened in IEC standard 61400-21 as the normal operation of the wind turbine
generator (WTG) excluding start-up and shut-down operations. The short-term and long-term icker
disturbance factors during continuous operation are dened in [11] as:
P
st
= P
lt
= c(
k
, v
a
)
S
n
S
k
(23.16)
where P
st
is the short-term icker disturbance factor; P
lt
is the long-term icker disturbance factor; c is
the icker coefcient for continuous operation;
k
is the network impedance angle (degrees); v
a
is the
average annual wind speed (m/s); S
n
is the rated apparent power of the wind turbine (VA); and S
k
is the
short-circuit apparent power of the grid (VA).
When more than one WTG exists at the point of common coupling (PCC), the summed short-term and
long-term icker disturbance factors for continuous operation are described in [11] as:
P
st
= P
lt
=
1
S
k
_
N
wt
i=1
(c(
k
, v
a
) S
n,i
)
2
(23.17)
where N
wt
is the number of wind turbine generators at the PCC.
23.6.2 Switching Operations
Switching operations are dened in IEC standard 61400-21 as start-up or switching between wind tur-
bine generators (WTGs). In this mode of operation, the short-term and long-term icker disturbance
factors during switching operations are dened in [11] as:
P
st
= 18 N
10
0.31
k
f
(
k
)
S
n
S
k
(23.18)
where N
10
is the number of switching operations in a 10-minute period; k
f
is the icker step factor;
k
is the network impedance angle (degrees); S
n
is the rated apparent power of the wind turbine (VA); and
S
k
is the short-circuit apparent power of the grid (VA).
P
lt
= 8 N
120
0.31
k
f
(
k
)
S
n
S
k
(23.19)
where N
120
is the number of switching operations in a 120-minute period; k
f
is the icker step factor;
k
is the network impedance angle (degrees); S
n
is the rated apparent power of the wind turbine (VA);
and S
k
is the short-circuit apparent power of the grid (VA).
When more than one WTG exists at the PCC, the short-term icker disturbance factor under switching
operations is dened in [11] as:
P
st
=
18
S
k
_
N
wt
i=1
N
10,i
(k
f,i
(
k
) S
n,i
)
3.2
_
0.31
(23.20)
Likewise, the long-term icker disturbance factor under switching operations is dened as:
P
lt
=
8
S
k
_
N
wt
i=1
N
120,i
(k
f,i
(
k
) S
n,i
)
3.2
_
0.31
(23.21)
where N
wt
is the number of WTGs at the PCC.
The relative voltage change (in units of %) due to the switching operation of a single WTG is computed
as [11]:
d = 100 (k
u
(
k
)
S
n
S
k
(23.22)
482 DIgSILENT PowerFactory 15, User Manual
23.6. FLICKER ANALYSIS (IEC 61400-21)
23.6.3 Flicker Contribution of Wind Turbine Generator Models
The calculation of icker according to IEC standard 61400-21 in PowerFactory considers icker contri-
butions of the following generator models:
Static generator (ElmGenstat )
Asynchronous machine (ElmAsm)
Doubly-fed asynchronous machine (ElmAsmsc)
In order for these models to be able to contribute icker, their icker contributions must rst be dened
and assigned, as described in Sections 23.6.4 (Denition of Flicker Coefcients) and 23.6.5 (Assign-
ment of Flicker Coefcients).
23.6.4 Denition of Flicker Coefcients
Flicker coefcients are dened in PowerFactory by means of the Flicker Coefcients type (TypFlicker ),
as illustrated in Figure 23.6.1. When created, this is stored by default in the Equipment Type Library
folder in the project tree.
Figure 23.6.1: Denition of Flicker Coefcients using the Flicker Coefcients Type (TypFlicker )
The Flicker Coefcients type allows the input of six parameters (all of which are dened in IEC standard
61400-21):
Network Angle, psi (degrees) This is the network impedance angle and must be entered in either the
range [-180,180] (default), or [0,360]. Any mix of these ranges is not permitted. Network angles must
be entered in ascending order.
Coefcient, c(psi) The icker coefcient as a function of the network impedance angle.
Step Factor, kf(psi) The icker step factor as a function of the network impedance angle.
Voltage Change Factor, ku(psi) The voltage change factor as a function of the network impedance
angle.
DIgSILENT PowerFactory 15, User Manual 483
CHAPTER 23. HARMONICS ANALYSIS
Maximum Switching Operations: N10 The maximum number of switching operations in a 10-minute
period.
MaximumSwitching Operations: N120 The maximumnumber of switching operations in a 120-minute
period.
23.6.5 Assignment of Flicker Coefcients
The Harmonics page of these elements dialogues contains a Flicker Contribution section which allows
the assignment of Flicker Coefcients. This is illustrated for the case of an asynchronous machine in
Figure 23.6.2.
Figure 23.6.2: Assignment of Flicker Coefcients in an Asynchronous Machine (ElmAsm)
If Flicker Coefcients is left unassigned, the generator is then considered to be an ideal source for the
icker calculation, as illustrated in Figure 23.6.3.
484 DIgSILENT PowerFactory 15, User Manual
23.7. SHORT-CIRCUIT POWER SK
Figure 23.6.3: Asynchronous Generator (ElmAsm) Model as Ideal Source
23.6.6 Flicker Result Variables
Following the calculation of icker according to IEC 61400-21, the following result variables for every
node in the network are available in the single line graphic. It should be noted that PowerFactory
calculates these icker disturbance factors and relative voltage change for impedance angles with lines
at 20 degrees Celsius and at maximum operation temperature. The following result variables are the
worst-case values in the impedance angle range, which is based on the temperature range:
Pst cont ; Plt cont : short-term and long-term icker disturbance factors for continuous operation
of the wind turbine generator/s;
Pst sw; Plt sw: short-term and long-term icker disturbance factors for switching operations of the
wind turbine generator/s;
d sw: relative voltage change (as a percentage).
For the mathematical denitions of these result variables, refer to Sections 23.6.1 (Continuous Opera-
tion) and 23.6.2 (Switching Operations).
23.7 Short-Circuit Power Sk
For power quality assessment, the network impedance of the grid under normal operating conditions is
usually used as the basis for calculations. This impedance is represented by the short-circuit power, Sk,
of the grid. Hence, for power quality assessment at a point V in the grid, this short-circuit power, SkV ,
under normal operating conditions is used instead of the short-circuit power of the faulted grid according
to short-circuit calculations. If the option Calculate Sk at Fundamental Frequency is enabled (see
Section 39.4.1 (Basic Options)), the short-circuit power of the grid under normal operation is available
in the calculation results.
DIgSILENT PowerFactory 15, User Manual 485
CHAPTER 23. HARMONICS ANALYSIS
23.7.1 Balanced Harmonic Load Flow
For the balanced harmonic load ow, the calculation of the short-circuit power, Sk, at each bus is as
follows:
Sk =
1
|Z
bus
|
(MVA) (23.23)
where Z
bus
is the impedance calculated at the bus.
The calculation of the impedance angle, psik, at each bus is as follows:
psik =
Z
bus
(degrees) (23.24)
where Z
bus
is the impedance calculated at the bus.
23.7.2 Unbalanced Harmonic Load Flow
For the unbalanced harmonic load ow, the calculation of the short-circuit power, Sk, at each bus is as
follows:
Sk =
1
|Z1
bus
|
(MVA) (23.25)
where Z1
bus
is the positive sequence impedance calculated at the bus.
The calculation of the impedance angle, psik, at each bus is calculated as follows:
psik =
Z1
bus
(degrees) (23.26)
where Z1
bus
is the positive sequence impedance calculated at the bus.
23.7.2.1 Calculation of Impedance Ratios
The following impedance ratios are calculated following an unbalanced harmonic load ow (if option
Calculate Sk at Fundamental Frequency has been selected):
z2tz1kV =
|Z2|
|Z1|
(23.27)
x0tx1kV =
X0
X1
(23.28)
r0tx0kV =
R0
X0
(23.29)
23.7.3 Sk Result Variables
Following either a balanced or an unbalanced harmonic load ow calculation with the option Calculate
Sk at Fundamental Frequency selected, the following result variables are available for every 3-phase
bus in the network:
SkV: short-circuit power (MVA)
psikV: impedance angle (degrees)
For the mathematical denitions of these result variables, refer to Section 23.7.1 (Balanced Harmonic
Load Flow), and 23.7.2 (Unbalanced Harmonic Load Flow).
Following an unbalanced harmonic load ow with the option Calculate Sk at Fundamental Frequency
selected, the following additional result variables are available for every 3-phase bus in the network:
486 DIgSILENT PowerFactory 15, User Manual
23.8. DEFINITION OF RESULT VARIABLES
z2tz1kV: Impedance ratio
x0tx1kV: Impedance ratio
r0tx0kV: Impedance ratio
For the mathematical denitions of these impedance ratio result variables, refer to Section 23.7.2.1
(Calculation of Impedance Ratios).
23.7.4 Short-Circuit Power of the External Grid
The external grid element, ElmXnet, allows the calculation of the network impedance to be based on
the short-circuit power, Sk, and impedance angle, psik. This option can be selected in the external
grid element on the Harmonics/Power Quality page, by using the Use for calculation drop-down box
and selecting Sk. User input elds are then available for the short-circuit power, Sk (MVA), impedance
angle, psik (deg), and impedance ratios z2tz1kV, x0tx1kV, and r0tx0kV.
The impedance of the external grid, which is taken into account for power quality assessment, is cal-
culated internally based on either the short-circuit power, Sk, at normal operation; the maximum short-
circuit power, Skmax for faulted operation; or the minimum short-circuit power Skmin for faulted oper-
ation, depending on the users selection.
Data for SkV, psikV, z2tz1kV, x0tx1kV, and r0tx0kV can rst be calculated from a detailed network
model using the Harmonic Load Flow command option Calculate Sk at Fundamental Frequency (refer
to Section 23.7.3 (Sk Result Variables)), performed, for example, by the network operator. A third party,
(i.e. a wind farm planner) could get this information for the point of common coupling (PCC for the
planned wind farm) from the network operator. The planner can then enter the data into the external
grid element, which is a simplied representation of the network as seen from the PCC.
23.8 Denition of Result Variables
In order to record the results of either the Harmonic Load Flow or Frequency Sweep calculation, the
variables of interest must be dened. However, for each of these calculations, a small selection of
variables are recorded by default in the result object dened on each commands Basic Data page by
the Result Variables parameter. For the Harmonic Load Flow the following variables are recorded by
default (PowerFactory variable names are italicized):
Harmonic order (-);
Frequency (Hz);
HD (%) (for terminals);
Voltage across inductor (p.u.) (url ) (for shunts/lters);
Voltage across capacitor (p.u.) (uc) (for shunts/lters);
Current through inductor (A) (IL) (for shunts/lters);
Current through resistor Rp (A) (IRp) (for shunts/lters);
Current through capacitor C (A) (IC) (for shunts/lters);
Voltage across capacitor C1 (A) (uc1) (for shunts/lters);
Voltage across capacitor C2 (A) (uc2) (for shunts/lters);
Voltage across resistor Rp (p.u.) (urp) (for shunts/lters);
DIgSILENT PowerFactory 15, User Manual 487
CHAPTER 23. HARMONICS ANALYSIS
For the Frequency Sweep, the following variables are recorded by default:
Harmonic order (-);
Frequency in Hz (Hz);
In order to dene additional variables to be recorded, a two-step process is required of rstly creating
the desired Variable Set and then selecting the variables for recording within these sets. These steps
are described in Sections 23.8.1 (Denition of Variable Sets) and 23.8.2 (Selection of Result Variables
within a Variable Set), respectively.
23.8.1 Denition of Variable Sets
To dene a Variable Set, right-click on a network component (or multi-select several network compo-
nents and right-click), either in the single-line diagram or in the data manager, and select the option
Dene Variable Set (Harmonic Load Flow); or Dene Variable Set (Frequency Sweep). This will
add a new (but still empty) variable set for the selected object to the result object (referred to by pa-
rameter Result Variables on the Basic Options page of the Harmonic Load Flow or Frequency Sweep
command dialogue).
All results of harmonic analyses, with the exception of the harmonic load ow using option Single Fre-
quency (for which no results are recorded), are stored in a normal result object (ElmRes). This result
object stores the result variables against the frequency for which they were calculated. For more infor-
mation about the result object, see Section 17.2.4 (Result Objects).
To access the variable sets, click on the Edit Result Variables button on the main toolbar. There are
two instances of this button: one associated with the Harmonic Load Flow and one associated with the
Frequency Sweep. Select the button associated with the relevant calculation. The variable set manager
dialogue will open which displays the list of all dened variable sets for that calculation. After the variable
set has been created and its variables have been dened, each variable set contains the variables of
interest for a single object. A window is opened automatically following the denition of a new variable
set, as shown in Figure 23.8.1, displaying the list of variable sets. In Figure 23.8.1, three variable sets
have been dened for three different network elements: one for load element General Load one for
line element Line 1 and one for terminal element Sym-Terminal.
Figure 23.8.1: Example of a List of Variable Sets
A new variable set can also be dened by clicking on the New button , shown in the top left corner
of Figure 23.8.1. By doing this, the Variable Set dialogue will appear as shown in Figure 23.8.2. To
proceed with selecting the result variables for the variable set, see Section 23.8.2 (Selection of Result
488 DIgSILENT PowerFactory 15, User Manual
23.8. DEFINITION OF RESULT VARIABLES
Variables within a Variable Set). For further information on variable sets, refer to Chapter 17: Reporting
and Visualizing Results.
23.8.2 Selection of Result Variables within a Variable Set
The selection of result variables for a variable set can only proceed when the column labelled Object for
any dened variable set (as shown in Figure 23.8.1) is set. This can be done by either double-clicking
the appropriate cell of the Object column, or by right-clicking the cell and selecting Select Element....
This binds the variable set to a specic object or network element.
A single variable set from the variable sets list can be accessed (and the desired variables dened)
by either double-clicking on the icon in the corresponding row, for example in the case of the Sym-
Terminal in Figure 23.8.1), or by right-clicking on the icon and selecting the Edit menu option. The
Variable Set object (IntMon) dialogue opens, as shown in Figure 23.8.2 for the example of the Sym-
Terminal. By selecting the Harmonics/Power Quality page of this dialogue, a list of all result variables
that are available for the selected object (applicable to harmonics analysis or frequency sweep) is then
available for selection. The Object eld in the dialogue in Figure 23.8.2 shows that the variable set is
dened for the network element Sym-Terminal.
Figure 23.8.2: Selection of Harmonics Analysis Result Variables for a Terminal
Result variables may be added or removed from the set of selected variables by highlighting the desired
variable and pressing the left or right arrow buttons . Additionally, different variables are available
for selection depending on the selection made from the Variable Set drop-down list. This drop-down list
is available in the Filter for section on the Harmonics/Power Quality page of the Variable Set dialogue,
as displayed in Figure 23.8.2. For further information on variable sets, refer to Chapter 17: Reporting
and Visualizing Results.
DIgSILENT PowerFactory 15, User Manual 489
CHAPTER 23. HARMONICS ANALYSIS
490 DIgSILENT PowerFactory 15, User Manual
Chapter 24
Flickermeter
24.1 Introduction
In terms of power quality, the term icker is used to describe the phenomenon of unwanted, rapidly
uctuating light levels due to voltage uctuations. The IEC 61000-4-15 standard species the function
and design of apparatus for the measurement of icker, termed the Flickermeter. This Flickermeter
comprises ve functional blocks which, via the use of multipliers, weighting lters, and smoothing and
squaring operations, perform the tasks of simulating the lamp-eye-brain chain response, and statistically
evaluating the icker signal [10]. PowerFactory provides a Flickermeter command for the calculation of
the short-term and long-term icker according to IEC 61000-4-15.
The following sections explain the calculation of short- and long-term icker by the Flickermeter com-
mand, as well as its conguration and handling.
24.2 Flickermeter (IEC 61000-4-15)
24.2.1 Calculation of Short-Term Flicker
The short-term icker value P
st
calculated according to IEC 61000-4-15 is a measure of the severity of
the icker based on an observation period of 10 minutes. It is dened mathematically as follows [10]:
P
st
=
2
_
(0, 0314 P
0.1
) + (0, 0525 P
1s
) + (0, 0657 P
3s
) (24.1)
+(0, 28 P
10s
) + (0, 08 P
50s
)
where the percentiles P
0,1
,P
1
,P
3
,P
1
0 and P
5
0 are the icker levels exceeded for 0.1; 1; 3; 10; and 50%
of the time during the observation period. The subscript s used in the above formula indicates that
smoothed values should be used, which are dened as follows [10]:
P
50s
=
P
30
+P
50
+P
80
3
(24.2)
P
10s
=
P
6
+P
8
+P
10
+P
13
+P
17
5
(24.3)
P
3s
=
P
2,2
+P
3
+P
4
3
(24.4)
DIgSILENT PowerFactory 15, User Manual 491
CHAPTER 24. FLICKERMETER
P
1s
=
P
0,7
+P
1
+P
1,5
3
(24.5)
24.2.2 Calculation of Long-Term Flicker
The calculation of the severity of long-term icker, P
lt
, considers the short-term icker severity values
over a longer period of time and is calculated according to the following equation [10]:
P
lt
=
3
N
i=1
P
3
sti
N
(24.6)
where P
sti
(i = 1, 2, 3, . . .) are the consecutive P
st
values and N is the number of observation periods.
It can be seen from [10] that when N = 1, Plt = Pst.
24.3 Flickermeter Calculation
24.3.1 Flickermeter Command
This command is accessible via the Flickermeter button in the Stability toolbar, which is accessible
by selecting Stability when clicking on the button Change Toolbox . The PowerFactory Flickermeter
command dialogue is shown in Figure 24.3.1.
Figure 24.3.1: Data Source Page of Flickermeter Command (ComFlickermeter )
492 DIgSILENT PowerFactory 15, User Manual
24.3. FLICKERMETER CALCULATION
24.3.2 Data Source
File Input
Import data from Species the type of data le containing the input data. There are ve le
types available for selection.
Filename The name of the input data le.
Result File The name of the input PowerFactory result le.
Conguration File Relevant to ComTrade input les only. The name of the corresponding con-
guration le.
Info A summary of information read from the le.
Use System Separators Relevant to comma-separated value (CSV) input les only. Tick the
checkbox to use the same separators for parsing the le as those used by the operating system.
When unchecked, separators are user-denable.
Separator for columns In the case of a Power Factory Measurement File as the input le type,
this indicates the character used as a separator for the columns in the le. In the case of a User
Dened Text File as the input le type, the separator may be selected as one of Tab, Space or
Other (user-dened).
Decimal Separator Indicates the separator used for decimal numbers. This is user-denable for
a User Dened Text File as the input le type
Selection of Data for Calculation
This table allows the selection of input le data to be analyzed. The leftmost column (with labels y1, . . .,
y24) provides a naming convention for the output of results, indicating which time-series signals from
the input le were analyzed.
Element Relevant only to a Result File input le type. Used to specify the element from the result
le for which a variable to analyze will be selected. This variable is then specied in the Variable
column of the same table
Variable Relevant only to a Result File input le type. Used to specify the variable for the Flicker-
meter command to analyze. This variable is associated with the selected Element (see above).
Column Number Refers to the column/s in the input le which correspond to the time-series
signal/s to be analyzed.
Variable Name For ComTrade les, the variable name is automatically read from the input le
and displayed in the Variable Name column. No variable name is provided for other le types.
Calculate Pst Allows the user to select the signals in the input le for which to calculate the
short-term icker (P
st
). Valid for all input le types with the exception of result les.
24.3.3 Signal Settings
Signal Settings
Signal Type Selection of either EMT or RMS input signal type.
Specify start time User-dened start time at which data should be read from le. This is an
absolute time value that exists within the input le, from which data will be read. If this value
cannot be found in the le, the next time point after the specied start time will be used instead.
DIgSILENT PowerFactory 15, User Manual 493
CHAPTER 24. FLICKERMETER
Resample Data The input data will be resampled by the user-dened New Sampling Rate. If
the time step of the data within the input le is not constant, the Flickermeter calculation will
automatically resample the data at the average sampling rate taken from the input le.
New Sampling Rate User-dened sampling rate at which data will be resampled if option Re-
sample Data has been selected.
Note: The minimum sampling rate required for instantaneous input data is 400Hz, and for RMS input
data is 800Hz.
Calculation Settings
Observation Period The time period over which the icker will be analyzed.
Calculate Plt Perform calculation of long-term icker P
lt
. When this option is checked, a result
le is written.
Observation Periods The number of successive observation periods (or time windows) to an-
alyze.
24.3.4 Advanced Options
Input signals for Flickermeter can be either RMS or EMT signals. The algorithm treats both of these in-
puts the same, with the exception of the weight lter coefcients, scaling factor and the cut-off frequency
used. The weight lter coefcients are preset (see Table 24.3.1), however the scaling factor and cut-off
frequency are user-denable parameters and are described below.
Parameter Denitions
Cut-off Frequency Cut-off frequency of Butterworth lter (Hz). When using an RMS input signal,
the cut-off frequency is set to 50Hz; when using an EMT input signal, its default value is 35Hz but
can be user-dened.
Filter Offset The offset (in seconds) for the lters to stabilize. A positive, non-zero offset should
always be entered. When using an RMS input signal, the lter offset is set to 5s; when using an
EMT input signal its default value is 5s but can be user-dened. A value of 5s is the minimum
amount of time required to initialize the lters and to attenuate the initial transient.
Scaling Factor Calibration parameter. When using an RMS input signal, the scaling factor is set
to 300469,4835 (dened as 2 / (0.0025*0.0025) / 1.065). When using an EMT input signal, its
default value is 303317,5 but can be user-dened.
Set to default Resets the Cut-off Frequency, Filter Offset and Scaling Factor to default values.
Constant Sampling Rate
Variable EMT (from IEC 61000-4-15) RMS
1, 74802 1, 74
2 4, 05981 2 4, 1
1
2 9, 15494 2 9, 15
2
2 2, 27979 2 2, 27979
3
2 1, 22535 2 1, 22535
4
2 21, 9 2 1000
Table 24.3.1: Flickermeter Weight Filter Coefcients
494 DIgSILENT PowerFactory 15, User Manual
24.3. FLICKERMETER CALCULATION
Tolerance Tolerance for determining whether the sampling rate is constant or not. This tolerance
is considered on the Data Source page in the Info frame when displaying the Constant Sampling
Rate parameter.
Result Variables This displays the location of the stored result variables. The result object can be
directly accessed by clicking on the arrow button . It should be noted that the Result Variables
parameter is only visible if the Calculate Plt checkbox on the Signal Settings page has been selected
and the value entered for the Observation Periods on the Signal Settings page is greater than 1.
Report Results of the Flickermeter calculation are displayed in PowerFactory s output window provided
that Report has been selected.
Note: When executing the Flickermeter command within DPL, the command option Report must be
disabled.
Command Displays the command used to output results. The Flickermeter command will write
results to a result le provided that option Calculate Plt on the Signal Settings page has been
selected. The result le used can be accessed via the dialogue which opens when the Command
button is pressed.
Additionally, results of the Flickermeter command can be viewed within the Data Manager as Flexible
Data of the Flickermeter command itself. The relevant variable names for selection when dening the
Flexible Data are b : Pst y1, . . ., b : Pst y24, for short-term icker values; and b : Plt y1, . . ., b : Plt y24
for long-term icker values). In this case, viewing the results of a Flickermeter calculation will appear
similar to that illustrated in Figure 24.3.2. It should be noted that when multiple Observation Periods
have been calculated, only the Plt results will be displayed (Pst results are shown as 0); and for a single
Observation Period the Pst results will be displayed. For further information on dening Flexible Data
in the Data Manager in PowerFactory , refer to Chapter 10: Data Manager, Section 10.6(The Flexible
Data Page Tab).
Figure 24.3.2: Using Flexible Data to Access Flickermeter Results
24.3.5 Input File Types
The Flickermeter command can handle ve different input le types. The conguration of the Flick-
ermeter command for each le type differs slightly, and is therefore described for each case in this
section.
Note: The minimum sampling rate required for instantaneous input data is 400Hz, and for RMS input
data is 800Hz.
ComTrade
DIgSILENT PowerFactory 15, User Manual 495
CHAPTER 24. FLICKERMETER
If a ComTrade le has been selected as input to the Flickermeter command, the command dialogue
will look similar to that shown in Figure 24.3.3. The Conguration File corresponding to the ComTrade
data le is automatically displayed, as is the Sampling Rate as read from the ComTrade conguration
le. The Selection of Data for Calculation table shows the column number and corresponding variable
name as read from the ComTrade conguration le and also a user selection for which the short-term
icker value should be calculated (checkbox in the Calculate Pst column). In the example shown in
Figure 24.3.3, a single variable has been selected for analysis. It can be read from this table that this
variable corresponds to column 1 of recorded data in the ComTrade input data le. See Section 24.3.2
(Data Source) for information on other Flickermeter command options.
Figure 24.3.3: Conguration of Flickermeter Command for ComTrade Input File
Comma Separated Values and User Dened Text Files
If a Comma Separated Values (CSV) le or a user dened text le has been selected as input to the
Flickermeter command, the command dialogue will look similar to that shown in Figure 24.3.4. For a
CSV le or user dened text le, the Selection of Data for Calculation table shows that variables can be
selected for analysis according to their corresponding column number in the input le. In the example
illustrated, data from column 1 has been selected for analysis. See Section 24.3.2 (Data Source) for
information on other Flickermeter command options.
496 DIgSILENT PowerFactory 15, User Manual
24.3. FLICKERMETER CALCULATION
Figure 24.3.4: Conguration of Flickermeter Command for CSV or User Dened Text Input File
PowerFactory Measurement File If a PowerFactory Measurement File has been selected as input to
the Flickermeter command, the command dialogue will look similar to that shown in Figures 24.3.5
and 24.3.6. The PowerFactory Measurement File is a simple ASCII le containing a column of data for
each variable recorded in it. Hence, it can be seen that the variable contained in column 5 of the le will
be analyzed by the Flickermeter command. The PowerFactory Measurement File can be used to record
results from other PowerFactory calculations and then used as input to the Flickermeter command.
For further information on the use of PowerFactory Measurement Files, please refer to Appendix C:
Technical References of Models, section C.6.5: File Object (ElmFile). See Section 24.3.2 (Data Source)
for information on other Flickermeter command options.
DIgSILENT PowerFactory 15, User Manual 497
CHAPTER 24. FLICKERMETER
Figure 24.3.5: Conguration of Flickermeter Command for PowerFactory Measurement File
Figure 24.3.6: Conguration of Flickermeter Command for PowerFactory Measurement File. Signal
Settings
Result File If a Result File has been selected as input to the Flickermeter command, the command
dialogue will look similar to that shown in Figure 24.3.7. Using a PowerFactory result le as the input le
type is practical when the user wants to rst record results from, for example, an EMS/RMS simulation
in a result le, and then analyze the icker contribution of one or more variables from this le. In
the example in Figure 24.3.7, the specied Element in the Selection of Data for Calculation table is a
terminal element (named LV Busbar) recorded in the result le, with its corresponding voltage selected
as the Variable to analyze. See Section 24.3.2 (Data Source) for information on other Flickermeter
command options.
498 DIgSILENT PowerFactory 15, User Manual
24.3. FLICKERMETER CALCULATION
Figure 24.3.7: Conguration of Flickermeter Command for Result File
DIgSILENT PowerFactory 15, User Manual 499
CHAPTER 24. FLICKERMETER
500 DIgSILENT PowerFactory 15, User Manual
Chapter 25
Stability and EMT Simulations
The transient simulation functions available in DIgSILENT PowerFactory are able to analyze the dynamic
behaviour of small systems and large power systems in the time domain. These functions therefore
make it possible to model complex systems such as industrial networks and large transmission grids in
detail, taking into account electrical and mechanical parameters.
Transients, stability problems and control problems are important considerations during the planning,
design and operation of modern power systems. Studies involving electro-magnetic transients and
different aspects of stability may be conducted using time-domain simulations for varying time periods,
or dynamic or small-signal stability analysis tools using (for example) eigenvalue analysis.
A large range of AC and DC systems can be analyzed (i.e. transmission systems with detailed models
of power plants, complex HVDC systems, motor start-up), as well as a combination of both. Applica-
tions such as wind power integration or power electronics constitute new challenges in the analysis of
power systems, and as a result new models and techniques are provided in PowerFactory to meet these
requirements.
For modelling a variety of machines and controller units, as well as the electrical and mechanical compo-
nents of power plants, etc., PowerFactorys global library provides a large number of predened models.
This library includes models of generators, motors, controllers, motor driven machines, dynamic loads
and passive network elements. As an example, this library contains the IEEE standard models of power
plant controllers. Furthermore, the user can model specic controllers and develop block diagrams of
power plants with a large degree of freedom.
A Stability simulation in PowerFactory is started by:
Selecting the Stability toolbar by clicking on the Change Toolbox icon ( );
Calculating the initial conditions for the simulation by either pressing the Initial Conditions on
the main toolbar, or by selecting Calculation StabilityInitial Conditions... from the main menu;
When the initial values have been calculated successfully, the icon on the main toolbar will be
activated and can be pressed to start the simulation.
25.1 Introduction
The study of power system stability involves the analysis of the behaviour of power systems under
conditions before and after sudden changes in load or generation, during faults and outages. The
robustness of a system is dened by the ability of the system to maintain stable operation under normal
and perturbed conditions. It is therefore necessary to design and operate a power system so that
transient events (i.e. probable contingencies), can be withstood without the loss of load or loss of
DIgSILENT PowerFactory 15, User Manual 501
CHAPTER 25. STABILITY AND EMT SIMULATIONS
synchronism in the power system. Transients in electrical power systems can be classied according to
three possible timeframes:
short-term, or electromagnetic transients;
mid-term, or electromechanical transients;
long-term transients.
The multilevel modelling of power system elements and the use of advanced algorithms means that the
functions in PowerFactory can analyze the complete range of transient phenomena in electrical power
systems. Consequently, there are three different simulation functions available:
1. A basic function which uses a symmetrical steady-state (RMS) network model for mid-term and
long-term transients under balanced network conditions;
2. A three-phase function which uses a steady-state (RMS) network model for mid-term and long-
term transients under balanced and unbalanced network conditions, i.e. for analyzing dynamic
behaviour after unsymmetrical faults;
3. An electromagnetic transient (EMT) simulation function using a dynamic network model for elec-
tromagnetic and electromechanical transients under balanced and unbalanced network condi-
tions. This function is particularly suited to the analysis of short-term transients.
In addition to the time-domain calculations, two other analysis functions are available:
Parameter Identication
Modal Analysis or Eigenvalue Analysis
Time-domain simulations in PowerFactory are initialized by a valid load ow, and PowerFactory functions
determine the initial conditions for all power system elements including all controller units and mechan-
ical components. These initial conditions represent the steady-state operating point at the beginning of
the simulation, fullling the requirements that the derivatives of all state variables of loads, machines,
controllers, etc., are zero.
Before the start of the simulation process, it is also determined what type of network representation
must be used for further analysis, what step sizes to use, which events to handle and where to store the
results.
The simulation uses an iterative procedure to solve AC and DC load ows, and the dynamic model
state variable integrals simultaneously. Highly accurate non-linear system models result in exact solu-
tions, including during high-amplitude transients. Various numerical integration routines are used for the
electromechanical systems (including voltage regulators and power system stabilizer) and also for the
hydro-mechanical or thermo-mechanical models.
The process of performing a transient simulation typically involves the following steps:
1. Calculation of initial values, including a load ow calculation;
2. Denition of result variables and/or simulation events;
3. Optional denition of result graphs and/or other virtual instruments;
4. Execution of simulation;
5. Creating additional result graphs or virtual instruments, or editing existing ones;
6. Changing settings, repeating calculations;
7. Printing results.
502 DIgSILENT PowerFactory 15, User Manual
25.2. CALCULATION METHODS
25.2 Calculation Methods
25.2.1 Balanced RMS Simulation
The balanced RMS simulation function considers dynamics in electromechanical, control and thermal
devices. It uses a symmetrical, steady-state representation of the passive electrical network. Using this
representation, only the fundamental components of voltages and currents are taken into account.
Depending on the models of generators, motors, controllers, power plants and motor driven machines
used, the following studies may be carried out:
transient stability (e.g. determination of critical fault clearing times);
mid-term stability (e.g. optimization of spinning reserve and load shedding);
oscillatory stability (e.g. optimization of control device to improve system damping);
motor start-up (e.g. determination of start-up times and voltage drops);
Various events can be included in the simulation, including the following examples:
start-up and/or loss of generators or motors;
stepwise variation of loads;
load-shedding;
line and transformer switching/tripping;
symmetrical short-circuit events;
insertion of network elements;
power plant shut down;
variations of controller setpoint;
change of any system parameter.
Because of the symmetrical network representation, the basic simulation function allows the insertion
of symmetrical faults only.
25.2.2 Three-Phase RMS Simulation
If asymmetrical faults or unbalanced networks have to be analyzed, the three phase RMS simulation
function must be used. This simulation function uses a steady-state, three-phase representation of
the passive electrical network and can therefore compute unbalanced network conditions, either due to
unbalanced network elements or due to asymmetrical faults. Dynamics in electromechanical, control
and thermal devices are represented in the same way as in the basic RMS simulation function.
Asymmetrical electromechanical devices can be modelled, and single-phase and two-phase networks
can also be analyzed using this analysis function.
In addition to the balanced RMS simulation events, unbalanced fault events can be simulated, such as:
single-phase and two-phase (to ground) short-circuits;
phase to phase short-circuits;
DIgSILENT PowerFactory 15, User Manual 503
CHAPTER 25. STABILITY AND EMT SIMULATIONS
inter-circuit faults between different lines;
single- and double-phase line interruptions.
All of these events can be modelled to occur simultaneously or separately, hence any combination of
symmetrical and asymmetrical faults can be modelled.
25.2.3 Three-Phase EMT Simulation
Voltages and currents are represented in the EMT simulation by their instantaneous values, so that the
dynamic behaviour of passive network elements is also taken into account. This is necessary for the
following applications:
DC and harmonic components of currents and voltages;
Exact behaviour of inverter-driven machines;
Exact behaviour of HVDC transmission systems;
Non-linear behaviour of passive network elements such as transformer saturation;
Overvoltage phenomena in switching devices;
Lightning strikes and travelling waves;
Analysis of the exact behaviour of protection devices during faults.
The high level of detail used to represent the modelled network means that all phases and all dened
events (symmetrical and asymmetrical) can be simulated. The EMT function can also be used for the
simulation of longer-term transients. However, due to the passive network elements being represented
dynamically, the integration step size has to be signicantly smaller than in the case of a steady-state
representation and as a result, the calculation time increases.
25.3 Setting Up a Simulation
Based on the results of a load ow calculation, all internal variables and the internal operating status of
connected machines, controllers and other transient models have to be determined. As a result of this
calculation, the synchronous generator excitation voltages and load angles are calculated. Additionally,
all state variables of controllers and power plant models, and any other device which is active and will
affect the time-domain simulation, are also calculated.
The calculation of initial conditions is started by either:
Selecting the stability toolbar, and then pressing the Initial Conditions icon;
Selecting Calculation StabilityInitial Conditions... from the main menu.
In the Initial Conditions command (ComInc) dialogue (see Figure 25.3.1) all simulation settings can be
dened, such as the simulation type (i.e. RMS or EMT, balanced or unbalanced) and simulation step
size settings.
These settings include:
Basic Options The simulation type is selected here (RMS, EMT; balanced, unbalanced), and the load
ow command, the result object and the event list are dened.
504 DIgSILENT PowerFactory 15, User Manual
25.3. SETTING UP A SIMULATION
Step Sizes Maximum and minimum step size are specied for use by the step size algorithms.
Step Size Adaptation Enables the variable step size algorithm.
Advanced Options Includes various error margins, iteration limits, damping factors, etc..
Noise Generation Denes parameters of the noise generation for stochastic applications.
Figure 25.3.1: The Initial Conditions Command (ComInc)Dialogue
25.3.1 Basic Options
The basic options are used to select the simulation type and the network representation. References to
the result object, the event list and the load ow command are available for inspecting or editing these
objects, by clicking on the respective icon.
25.3.1.1 Verify Initial Conditions
If the initial conditions can be fullled, the power system will be in a steady-state condition. When the
Verify Initial Conditions options is enabled, then the condition dx/dt=0 is checked for all state variables.
DIgSILENT PowerFactory 15, User Manual 505
CHAPTER 25. STABILITY AND EMT SIMULATIONS
If one or more of the state variable derivatives does not equal zero, the power system may start moving
from the very beginning of the simulation, even without the application of an external event. In this case
the user should analyze the relevant controller or model and its dened initial conditions carefully.
All warnings or error messages issued in the output window should be checked carefully. Typical prob-
lems are devices which are overloaded or operate above or below signal limitation from the beginning
of the simulation.
The error message displayed in the output window might look as follows:
DIgSI/err - Some models could not be initialized.
DIgSI/err - Please check the following models:
DIgSI/err - Simple Grid AVR Common Model.ElmDsl:
DIgSI/err - Initial conditions not valid !
25.3.1.2 Automatic Step Size Adaptation
This option enables the step size adaptation algorithm, and can be used to speed-up the simulation
considerably. PowerFactory adjusts the step size to the actual course of each state variable at any
moment in time. Based on the local discretisation error, PowerFactory calculates an optimal step size
that keeps the numerical errors within the specied limits. A step size controller adjusts the integration
step size.
As a result, when fast transients have decayed, PowerFactory automatically increases the step size and
speeds up the simulation process considerably. In the case of events (external or internal), the step size
is always set back to the Minimum Step Size. This way, the behaviour of the system during a transient
event is represented with the best accuracy.
If this option is activated, two integration step sizes are available on the Step Size tab of the dialogue:
Electromagnetic Transients/Electromechanical Transients Minimum step size for EMT and RMS
simulations, respectively.
Maximum Step Size Maximum step size for the simulation.
Further parameters to adapt this algorithm can be found on the Step Size Adaptation tab.
25.3.2 Step Sizes
25.3.2.1 Integration Step Sizes
When using a xed step size for the simulation (deactivate Automatic Step Size Adaptation on the Basic
Options tab), the integration step size for EMT or RMS has to be set.
It is often unnecessary to plot every single calculated time step, and this reduction in plotted data can
also result in a reduced simulation time. For this purpose, the step size for the output graphs can be set,
so that not every point in time throughout the simulation time will be drawn on the virtual instruments
plot. By selecting a larger Output step size, the simulation process will speed up without inuencing the
calculation process. It should be noted, however, that fast changes may not be seen in the reported
results.
The parameters which are available for the step size are:
dtemt Electromagnetic Transients (typical value: 0.0001 sec
506 DIgSILENT PowerFactory 15, User Manual
25.3. SETTING UP A SIMULATION
dtgrd Electromechanical Transients (sym, asm, vco, pss) (typical 0.01 sec)
dtout Output (typical equal to dtemt for EMT; and dtgrd for RMS simulation)
25.3.2.2 Start Time
The start time of the simulation. This is typically negative, allowing the rst event to be analyzed to take
place at t=0 s.
Note: When setting up time-domain simulations, it is very important to use the correct time steps for
simulations in order to observe the right phenomena in the results. For the RMS simulation the
minimum time step should always be smaller then the time constants in the system. In controllers
one must consider both the open-loop and the closed-loop time constants. For electromagnetic
transients, e.g. when analyzing travelling waves, the smallest travelling time would be the upper
limit for the minimum time step.
In addition to the Newton-Raphson based algorithm for the solution of weak non-linearities (i.e. satura-
tion effects in synchronous and asynchronous machines), the EMT simulation function allows interrupts
for the simulation of strong non-linearities (i.e. switches, two-slope transformer saturation or thyristors).
These interrupts can also occur between time steps.
In case of such an interrupt, all time dependent variables are interpolated to the instant of interrupt
and the simulation restarts at that point. This prevents numerical oscillations and allows much a lower
integration step size to cater for power electronics devices.
The dynamic model equations of the voltage-controllers (vco) and the power system stabilizers (pss)
are solved simultaneously with the electrical generator and passive network equations (stepsize dtgrd).
25.3.3 Step Size Adaptation
If option Automatic Step Size Adaptation is enabled on the Basic Options tab, further step size options
are available on the Step Size Adaptation tab. These options are:
errmax Maximum Prediction Error (typical value: 0.01)
errinc Minimum Prediction Error (typical value: 0.01)
ninc Delay for Step Size Increase (typical value: 10 time steps)
nc Speed Factor for increasing the time step (default value: 1.5)
fdec Speed Factor for decreasing the time step (default value: 2)
ddtemt max Maximum increase of step size (typical values: 0.05 for RMS; 0.001 sec for EMT)
Note: The simulation time can be very sensitive to some of the parameters. For example when you
increase the maximum time step the duration of calculating transients may not always increase. If
this time step is increased over an optimal time step the simulation time may increase as well.
It is strongly recommended to critically observe the simulation time and the results for different
simulation parameters.
25.3.4 Advanced Options
The advanced options may be used to tune the performance of the simulation algorithm. Less experi-
enced users are recommended to use the default values.
DIgSILENT PowerFactory 15, User Manual 507
CHAPTER 25. STABILITY AND EMT SIMULATIONS
25.3.4.1 Event Control
Resolution Factor
The value entered here (parameter name: kres) determines the time interval used to synchronize
events. Every time an internal or external event occurs (usually between two integration time steps),
PowerFactory interpolates all state variables up to the moment in time at which the event has occurred
and restarts the simulation from there. In the case of large disturbances it is possible that a very large
number of events occur almost simultaneously. As this would slow down the simulation considerably,
PowerFactory executes all events that occur within a time interval of duration kres*dtmin at the same
time. All system variables are then interpolated up to the point in time when the event takes place, and
the simulation is started from there. A higher resolution factor decreases the minimum time interval be-
tween events. The default value of 0.001 is usually sufcient. If an event occurs, there are two different
options available:
Interpolation at user dened events
Calculation of v(t) and v(t+h) as usual. PowerFactory uses special numerical methods to allow this
without numerical oscillations.
Re-Initialize After Event
Calculation of v(t) and v(t+h), hence two values at the same time, one before the occurrence of
the event, and one after. The second method is applied if the option Re-initialize After Event is
enabled.
Further parameters can be changed to control the simulation algorithm.
25.3.4.2 Integration Control
errseq Maximum Error of State Equations (typical value: 0.1
itrpx Maximum Number of Successive State Iterations (typical value: 10)
alpha rms Damping Factor (RMS) (typical value: 1)
alpha emt Damping Factor (EMT) (typical value: 0.99)
25.3.4.3 Iteration Control
errsm Maximum Iteration Error of Nodal Equations (typical value: 10*errlf)
The iteration error errsm depends on the nominal power of the machines and the voltage levels.
As an adequate starting value, errsm should be set to: errsm = 10*errlf, where errlf is the Max.
Allowable Load-Flow Error for each Bus. Checking is best done by plotting some voltages at
generator busbars. If voltage steps are observed, the value of errsm should be reduced.
erreq Maximum Error of Model Equations (typical value: 1
itrlx Maximum Number of Iterations (typical value: 25)
itrlx species the max. number of iterations at each integration step which are allowed to reach
the max. tolerable bus-error errsm. During the transient simulation process, the typical number of
iterations required is between 1 and 5. Under certain conditions - i.e. after switching operations -
up to 25 iterations may be observed.
itrjx Iteration Limit to Recompute Jacobian Matrix (typical value: 5)
508 DIgSILENT PowerFactory 15, User Manual
25.3. SETTING UP A SIMULATION
25.3.4.4 Signal Buffer
25.3.4.5 Reference System
Local/Global Reference System
The PowerFactory stability analysis uses the angle of a reference machine and refers all other angles
to this reference angle. This is a numerically very efcient approach. After running initial conditions, the
reference machine is displayed in the output window. It is usually the Slack-machine of the load-ow
calculation.
In case of several isolated islands, PowerFactory offers the option of using one reference machine for
the whole system (Global Reference System), or to use an individual reference machine for each island.
The rst case should be used if the islands are re-synchronised again later in the simulation. In all other
cases the option (Local Reference System) should be used because it leads to a higher numerical
stability and to faster simulation times.
25.3.4.6 Calculate Maximum Rotor Angle Deviation
PowerFactory can also calculate the maximum deviation between the rotor angles between the syn-
chronous machines in the system. This variable is then called dfrotx and can be chosen and displayed
fromthe variables of all synchronous generators in the system. This variable can be used as an indicator
for the synchronous operation of a large transmission system.
25.3.4.7 A-stable integration algorithm for all models
If you enable this option, PowerFactory uses an A-stable numerical integration algorithms for all mod-
els to solve the simulation. In this case dynamic model equations and network equations are solved
simultaneously. This algorithm is (slightly) slower in case of small step sizes but converges much better
in case of large step sizes. Typical applications are longer term simulations, in which the simulation
step size is increased considerably after fast transients have decayed. Another typical application are
systems with power electronics. Even if power electronics devices are usually equipped with very fast
controls, the A-stable algorithm still allows reasonable step sizes, at which the relaxation method would
fail.
When using a conventional, explicit numerical integration algorithm, such as Runge-Kutta (not an A-
stable algorithm), the integration step size must be adjusted to the eigenvalues of a system. Such a
method (Relaxation Method) means a mutual solution of dynamic model equations and network equa-
tions until convergence is reached: This algorithm is fast for small step sizes but fails to converge when
the step size is increased. Best choice for classical transient stability applications. But if excessively
large step sizes are used, the numerical solution becomes unstable, even if fast modes have fully de-
cayed and are no longer apparent in the system.
With the PowerFactory A-stable algorithm, the step size can be adjusted to the actual course of all state
variables without considering numerical stability. When fast transients have decayed, the step size can
be adjusted to the speed of slower transients, etc.
If some very fast modes are not of interest, a large step size can be selected from the beginning, and
the algorithm will automatically smooth fast variations. A typical application of this type of algorithm is
the simulation of long-term phenomena - where it is necessary to increase the simulation step size to
the range of minutes, even if fast modes are present in the system.
However, if power electronics are involved, characteristic time constants can be extremely short (i.e.
1ms), even if a stability model with steady-state equations for the electrical network is used. Hence,
using a classical integration algorithm would require the use of step sizes signicantly smaller than the
smallest time constant of the system, otherwise it would be numerically instable.
DIgSILENT PowerFactory 15, User Manual 509
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Note: A requirement for using the A-stable integration algorithm is that just true input and output sig-
nal variables are used for exchanging information between different models.
It should be mentioned, that it is also possible to choose the usage of an A-stable algorithm for some
element models only (not for all models), so that it is possible to run just a part of the models with
the A-stable algorithm (for example the power electronic converters or fast controllers). This option is
available in the dialogues of the elements.
With the A-stable algorithm, these systems can be analyzed with reasonable step sizes. Hence, the
A-stable algorithm cannot be described as using simplied models but as a different type of numerical
integration algorithm.
25.3.5 Noise Generation
The Noise Generator element (ElmNoise) can be used in a transient simulation to produce a noise
signal based on random numbers. On the Noise Generation page of the ComInc dialogue, the random
number generation method can be selected. The random number generator can be selected to be
automatic (by selecting option auto), which is the default value and the most commonly used.
Alternatively, the option renew may be selected, in which case the random seed of the noise generator
can be selected manually from A to K. Thus the noise signal will look the same in every simulation,
i.e. the results of a former simulation can be reproduced exactly.
25.3.6 Advanced Simulation Options - Load Flow
There are further options which can inuence the simulation process and its results. In the load ow
command dialogue (ComLdf, see also Chapter 21: Load Flow) on the Advanced Simulation Options tab,
the inuence of protection devices or various controller models can be neglected. Hence the chosen
models or protection devices will be ignored during the simulation as well as in load ow and other
calculations. This is illustrated in Figure 25.3.2.
510 DIgSILENT PowerFactory 15, User Manual
25.4. RESULT OBJECTS
Figure 25.3.2: Advanced Simulation Options in the ComLdf Command Dialogue
The options available for the consideration of protection devices are:
none No protection devices are considered in the calculations
all All protection devices are considered
main Only the protection devices are in operation, which are dened as main devices
backup Only the backup protection devices are considered. According to the controller models,
there is the possibility to ignore all controllers and mechanical elements with the option Ignore
Composite Elements. If there are only some specic model types one would like to neglect in
the simulation, they can be moved from the left window Considered Models to the right window,
Ignored Models.
25.4 Result Objects
During an EMT or RMS simulation, a large number of signal variables are changing over time. To reduce
the available data and to narrow down the number of variables to those necessary for the analysis of
each particular case, a selection of these signals for later use has to be dened.
DIgSILENT PowerFactory 15, User Manual 511
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Therefore, one or more result objects containing the result variables can be congured. The simulation
function needs the reference to a result object to store the results.
The command dialogues for calculation functions, that produce signals, have result object references,
as depicted in Figure 25.4.1 for the Initial Conditions (ComInc) dialogue. See also Figure 25.3.1.
Figure 25.4.1: Result Object Reference
Such a result object reference refers to the currently used result object. The downward arrow button
( ) is used to select or reset the reference, or to edit the contents of the referenced result object.
The right-arrow button ( ) is used to edit the result object itself. When editing the output variables
press this Edit button and then Contents to get access to the list of variables stored inside the result
object. This will pop up the corresponding ElmRes edit dialogue.
An easier way to edit or inspect the result object is to press the icon on the main toolbar, or to select
the Data Stability Result Variables option from the main menu. This will enable the user to edit
the contents of the currently selected Result object in the Initial Conditions command dialogue. Result
objects (ElmRes) are treated in detail in Chapter 17 (Reporting and Visualizing Results).
To add variables of different elements to the result object for RMS and EMT simulations, right-click on
the desired element in the single-line graphic and select Dene Variable Set(Sim)... as shown in
Figure 25.4.2
512 DIgSILENT PowerFactory 15, User Manual
25.4. RESULT OBJECTS
Figure 25.4.2: Dening a Variable Set for a Line Element
This element will then be monitored during the simulation. A browser window is automatically opened,
and by double-clicking on the variable set icon ( ) of the relevant row, the variables of interest to be
recorded can then be selected. See also Section 25.4(Result Objects).
Note: Most of the variables for RMS and EMT simulations are identical. Nevertheless there may exist
variables that are valid for EMT but not for RMS calculations. It is advisable to only use variables
for the calculation which is currently being performed.
25.4.1 Saving Results from Previous Simulations
The variables to be monitored are stored (by default) in the result object All calculations. The results of
the variables in the current simulation are stored in this le also. If the results of two different simulations
are to be displayed, e.g. in one virtual instrument, there is the possibility to save the result object of
a previous simulation simply by copying the result objectAll calculations and renaming it to something
else.
This can be done easily in the data manager. The result object can be found in the currently active
study case. Copy the result object and paste it into the same study case. Following this, a second
result object will be created with the name All calculations(1). If desired, the object can be renamed to
something more appropriate.
In the following simulation, the default result object All calculations will be overwritten with the new
DIgSILENT PowerFactory 15, User Manual 513
CHAPTER 25. STABILITY AND EMT SIMULATIONS
results, but the copied results will not be modied and can be displayed together with the new simu-
lation results in one plot. For further information see Chapter 17: Reporting and Visualizing Results,
Subsection 17.5.2 (Plots).
25.5 Simulation Scan
Simulation Scan modules can be used to monitor frequency, voltage, synchronism, and other variables,
and trigger events accordingly. To perform a simulation scan:
1. On the Calculation of Initial Conditions (ComInc) dialogue select Perform Simulation Scan.
2. select ( ), Edit ( ), or Show the simulation scan Modules.
3. Enter a Name and Description for the Simulation Scan (IntScn) object.
4. Click Modules and then select New Object to dene a Simulation Scan object. Simulation
scan objects are described in the following subsections.
25.5.1 Frequency Scan Module
The frequency scan module (ScnFreq) monitors frequency at all nodes and triggers a display message
or stops the simulation if a limit is violated. Settings are as follows:
Frequency Setting
Dene the frequency settings Nominal Frequency, Maximum Limit, and Minimum Limit.
Activation Time
Dene the time at which monitoring should start (till end) in Hours, Minutes, and Seconds. Set the Time
Step to dene the intervals at which the scan should be performed.
Action
Select whether to Display Message or Stop Simulation if a limit is violated.
25.5.2 Loss of Synchronism Scan Module
The loss of synchronism scan module (ScnSync) monitors the internal generator model signal Out of
Step of all calculation relevant machine (ElmSym). If an out of step condition is detected, it triggers a
display message, stops the simulation, or trips the generator/s that have lost synchronism.
Activation Time
Dene the time at which monitoring should start (till end) in Hours, Minutes, and Seconds. Set the Time
Step to dene the intervals at which the scan should be performed.
Action
Select whether to Display Message, Stop Simulation, or Trip Generator if an out of step condition is
detected.
25.5.3 Variables Scan Module
The variables scan module (ScnVar ) monitors an Element variables and triggers a display message or
stops the simulation if a dened limit is violated. For the variables scan module, an Element (*Elm)
must be selected, and the Variable to be monitored must be entered.
514 DIgSILENT PowerFactory 15, User Manual
25.5. SIMULATION SCAN
Setting
Dene the variables Maximum Limit and Minimum Limit. Optionally select to conduct a Continue Scan
(see section 25.5.5 for details).
Activation Time
Dene the time at which monitoring should start (till end) in Hours, Minutes, and Seconds. Set the Time
Step to dene the intervals at which the scan should be performed.
Action
Select whether to Display Message or Stop Simulation if a limit is violated.
25.5.4 Voltage Scan Module
The voltage scan module (ScnVolt ) monitors voltage at all nodes and triggers a display message or
stops the simulation if a dened limit is violated.
Voltage Limits
If Voltage Limits is checked, dene the Maximum limit and Maximum Voltage Violation Time, and the
Minimum limit and Minimum Voltage Violation Time. Optionally select to conduct a Continue Scan (see
section 25.5.5 for details).
Voltage Recovery
If Voltage Recovery is checked, dene the Recovery Voltage and Voltage Recovery Time. If the voltage
decreases below the Recovery Voltage the start time is recorded. When the voltage recovers to above
the Recovery Voltage, the module checks that the voltage has recovered within the time span limit.
Activation Time
Dene the time at which monitoring should start (till end) in Hours, Minutes, and Seconds. Set the Time
Step to dene the intervals at which the scan should be performed.
Action
Select whether to Display Message or Stop Simulation if a limit is violated.
25.5.5 Simulation scan example
Consider the example simulation response shown in 25.5.1, where a Voltage Scan module has been
dened. The module starts scanning at the Activation Time of 2.0 seconds. If the voltage is below the
Minimum Limit (in this example, 0.72 p.u.) for more than the Minimum Voltage Violation Time, or above
the Maximum voltage (1.1 p.u.) for greater than the Maximum Voltage Violation Time, the selected
Action will be performed. If the voltage is below the Recovery Voltage (0.72 p.u.) for greater than the
Voltage Recovery Time a message will be displayed in the Output Window.
The user can continue the simulation following a Stop Simulation Action by pressing Start Simulation
(ComSim). Depending on whether Continue Scan is selected:
If Continue Scan is not selected, the selected Action will only be performed for the rst of each
violation. For subsequent violations, the simulation will continue without performing the selected
Action.
If Continue Scan is selected, the selected Action will be performed for all violations.
DIgSILENT PowerFactory 15, User Manual 515
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.5.1: Example voltage simulation scan
25.6 Events (IntEvt)
This section provides a general description of Events, as they apply to time-domain simulations. See
Chapter 11: Study Cases, Section 11.9 (Events) for a detailed description of the event types.
There are several ways to access Events objects:
From the Data Manager, in the Simulation Events/Faults object stored within the Study Case.
From the Calculation of Initial Conditions ( ComInc) dialogue, it is possible to select ( ), Edit ( ),
or Show the Selection of Simulation Events.
From the main toolbar by pressing the Edit Simulation Events icon. A list of the currently
dened events will be displayed including the set simulation time, when the event will occur, and
the related object. Figure 25.6.1 shows an example set of events. Note that a duration for the 3p
SC Fault is not specied, rather, another event is created to clear the fault, Clear SC Fault.
516 DIgSILENT PowerFactory 15, User Manual
25.6. EVENTS (INTEVT)
Figure 25.6.1: The Event Object Including a Set of Events
When creating a new event, use the icon in the toolbar, as can be seen in the Simulation Events
object dialogue in Figure 25.6.1 The event type can be chosen from the list in the element selection
dialogue which pops up, as shown in Figure 25.6.2 The events can also be modied during a simulation
by stopping the calculation, editing the events and continuing the simulation.
DIgSILENT PowerFactory 15, User Manual 517
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.6.2: Dening a New Simulation Event
An alternative means of dening events is as follows: upon calculation of the initial conditions ( ), or
when the simulation is already running, double-click on the desired cubicles to create switch events.
Additionally, the user can right-click on an element and then select an element-related event such as
Dene... Switch Event Dene...Load Event or Dene... Short-Circuit Event.
During a simulation all previous events (i.e. events which have already occurred), are displayed in a
grey font style and can no longer be edited or changed. When the simulation is nished or is stopped
manually, the events which are still to come in the simulation can be altered and new events can be
created.
Note: At the end of a simulation the event list shows all events, which are now grey in colour. They
can no longer be modied for this simulation, because the simulation could be restarted from this
point on. To change the events for a new simulation one must rst initialize the calculation again
( ), so the simulation time is reset to the beginning.
25.7 Running a Simulation
Upon successful calculation of the initial conditions (i.e. execution of ComInc ), the icon on the
main toolbar will be activated and can be pressed to start the simulation.
518 DIgSILENT PowerFactory 15, User Manual
25.8. MODELS FOR STABILITY ANALYSIS
The simulation is performed for the time interval between the start time dened in the initial conditions
command ComInc, and the stop time (parameter name: tstop), which can be specied in the simulation
(ComSim) dialogue. After a simulation has nished, it may be continued by pressing the icon again,
and entering a new stop time. In this case, the stop time may also be entered relative to the current
simulation time.
A running simulation may be interrupted by pressing either the icon or the icon on the main
toolbar. Additional events can be created and results may be viewed while the simulation is paused.
The simulation is then continued by pressing the icon again. Pausing and continuing the simulation
may be done as often as required.
25.8 Models for Stability Analysis
Stability analysis calculations are typically based on predened system models. In the majority of cases
the standard IEEE denitions for controllers, prime movers and other associated devices and functions
are used.
For planning purposes, this approach might be acceptable. The predened sets of parameters will allow
a favourable and reasonable behaviour of the analyzed system. This approach is often also applied to
operation analysis, and the system should show a response similar to a real system.
For systems and congurations for which no IEEE models exist, such as wind generators, HVDC-
systems, etc., powerful tools for user dened modelling are required. For this purpose, highly spe-
cialised, exact models can be created in PowerFactory .
In cases when manufacturers are able to supply exact controller models including real parameters, the
system model can be improved by not using the IEEE standard models, but instead building a new block
diagram of the individual controller/mechanical system to represent the device. This facilitates highly
accurate system modelling.
Utilities and consultants often conduct system operation performance and optimization studies, and
therefore have a clear need for accurate methods and tools for creating accurate transient models for
stability analysis.
This includes complex operation analysis and special component planning problems. This demand
led to the development of highly exible and accurate DIgSILENT PowerFactory time-domain modelling
features.
Figure 25.8.1 provides an overview of the PowerFactory modelling approach, as discussed in this chap-
ter. Note: Click on gure labels to link to the relevant section.
DIgSILENT PowerFactory 15, User Manual 519
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.8.1: Overview of Modelling Approach
25.9 System Modelling Approach
System modelling for stability analysis purposes is one of the most critical issues in the eld of power
system analysis. Depending on the accuracy of the implemented model, large-signal validity, available
system parameters and applied faults or tests, nearly any result could be produced and arguments
could be found for its justication.
This is one aspect of the complexity of a transient stability study. The other aspect results from the often
large set of time-domain models that are required, each of which may be a combination of other models.
All these time-domain models are ultimately wired together into one large, single transient model from
which the basic set of system differential equations can be obtained.
Given this complexity of a transient analysis problem, the PowerFactory modelling philosophy is targeted
towards a strictly hierarchical system modelling approach, which combines both graphical and script-
based modelling methods. The basis for the modelling approach is formed by the basic hierarchical
levels of time-domain modelling:
The DSL block denitions, based on the DIgSILENT Simulation Language (DSL), form the basic
building blocks to represent transfer functions and differential equations for the more complex
transient models.
The built-in models and common models. The built-in models or elements are the transient Pow-
erFactory models for standard power system equipment, i.e. for generators, motors, static VAr
compensators, etc. The common models are based on the DSL block denitions and are the
front-end of the user-dened transient models.
The composite models are based on composite frames and are used to combine and interconnect
several elements (built-in models) and/or common models. The composite frames enable the
520 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
reuse of the basic structure of the composite model.
The relation between these models and the way that they are used is best described by the following
example.
Suppose the frequency deviation due to the sudden loss of a fully-loaded 600 MW unit in a particular
network is to be analyzed. Depending on the network and the required detail in the calculated results,
such analysis may ask for a detailed modelling of the voltage controllers, prime movers and primary
controllers, or any other important equipment for all large generators in the system.
Figure 25.9.1: Example of a Composite or Power Plant Model
Figure 25.9.1 shows a typical conguration of a synchronous generator with power system stabilizer,
voltage controller, primary controller, and prime mover model. The primary controller and prime mover
can be summarized as the primary controller unit model. To create this kind of model, the following
actions are required:
1. Transient models for each required controller type or unit type have to be dened (Model/Block
Denition).
2. For each generator, the transient models of the individual controller must be customized by setting
the parameters to the correct values (Common Model ).
3. A diagram has to be made dening the connections between the inputs and outputs of the various
models (Composite Frame).
4. For each generator, the diagram and the customized transient models are to be grouped together
to dene an unique composite generator model (Composite Model ).
It may seem unnecessary to include steps 2 and 3: it would be possible to create customized transient
models for each generator directly, with burned-in parameter settings, and to link these models to a
generator without having to dene a diagram rst. This, however, would mean that one would have to
create a new voltage controller, e.g. for each generator in the system.
Often the design of many of these voltage controllers will be similar. To omit the need of creating copies
of these controllers for each generator and to avoid redundant copies of controllers or also of whole
generator models.
Here the same relationship as that between individual controller (Common Model) and controller deni-
tion (Model Denition) is used; this time between the generic power plant diagram (Composite Frame)
and the individual power plant (Composite Model). DIgSILENT PowerFactory uses two key objects in
creating composite models, which can be compared to the element denition of the different elements:
DIgSILENT PowerFactory 15, User Manual 521
CHAPTER 25. STABILITY AND EMT SIMULATIONS
The Common Model (ElmDsl ) combines general time-domain models or model equations (a block
denition) with a set of parameter values and creates an integrated time-domain model.
The Composite Model (ElmComp) connects a set of time-domain models inside a diagram (a
composite frame) and creates a composite model.
The following diagrams explain the relation between the Composite Model (which is using a Frame as
type) and the Common Model (based on a block diagram as type) in detail.
The Composite Model (ElmComp), Figure 25.9.2, references the denition of a composite frame.
This composite frame is basically a schematic diagram containing various empty slots, in which
controller or elements can be assigned. These slots are then interconnected according to the
diagram, see Section Composite Block Denitions (part of Section 25.11.3: Dening DSL Models).
The slots in the composite frame are pre-congured for specic transient models.
The schematic diagram in Figure 25.9.3 shows a Composite Frame (BlkDef ) which has one slot
for a synchronous machine, one for a primary controller unit (pcu slot), and one for a voltage
controller (vco slot). The composite model, which uses this composite frame, shows a list of
the available slots and the name of the slot. Now the specic synchronous generator, voltage
controller or primary controller unit model can be inserted into these slots.
The synchronous machine that is used in the Composite Model is called a Built-In Model , see
Figure 25.9.4 This means that such elements are pre-congured elements which do not need a
specic model denition. Any kind of element which is able to provide input or output variables,
e.g. converters, busbars, etc, can be inserted into the slots.
The voltage controller, and primary controller unit, however, are user-dened Common Models,
see Figure 25.9.5 The front-end of all user-dened transient models is always a common model
(ElmDsl ), which combines a model denition with specic parameter settings. There are prede-
ned denitions as well, so that the user can create her/his own model denitions.
The common model has a reference to the Model Denition (BlkDef ), which looks similar to
the composite frame (shown in Figure 25.9.6). Here different blocks are dened and connected
together according to the diagram. The input and output variables have to t with the slot denition
of the slot that the model is dened for.
Not all slots of the composite model must necessarily be used. There can also be empty slots. In
such cases, the input of this slot is unused and the output is assumed to be constant over the entire
simulation. The usage of composite models with a composite frame, and the common model with its
block denitions are described in the next sections.
The design and creation of user dened common models using the DIgSILENT Simulation Language
(DSL) can be found in Section 25.11 (User Dened (DSL) Models).
522 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
Figure 25.9.2: Example of a Composite Model Using the Frame Frame Generator
Figure 25.9.3: Composite Frame Frame Generator
DIgSILENT PowerFactory 15, User Manual 523
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.9.4: Generator G1 (Built-In Model)
Figure 25.9.5: Example of a Common Model Using the Denition vco simple
524 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
Figure 25.9.6: Example of a Model Denition vco simple
25.9.1 The Composite Model
A composite model element (ElmComp) can created using the New Object ( ) icon, located in the
toolbar of the data manager and selecting Composite Model from the available options. The next step
is to select the composite frame. The composite frame can be stored either in the global library or in
the local library, and is conceptually similar to a type denition for an electrical element. The composite
model then shows the list of slots in the composite frame as shown in Figure 25.9.7.
Existing controllers or models can be assigned to a slot manually by right-clicking the slot and selecting
Select Element/Type, as depicted in Figure 25.9.7. A data manger window will pop up and the user can
then browse the grid for the element to insert into the selected slot.
DIgSILENT PowerFactory 15, User Manual 525
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.9.7: Editing the Composite Model (ElmComp) Dialogue
When inserting controller models into a slot, it is often the case that the controller element has not
yet been created. To create a new controller element select New Element/Type from the slots context-
sensitive menu. PowerFactory will automatically jump to the project Library and show a list of available
user dened models (ElmDsl ).
Selecting a model denition from the project library or the global library will open the element dialogue
of the newly-created common model, so that its parameters can be dened, similar to (for example) a
transformer element. If no suitable model is found, a block denition has to be selected prior to setting
the model parameters (see Section 25.9.2 (The Composite Frame) and Figure 25.9.6).
If an element is assigned to a slot, it is possible to edit the assigned element by simply right-clicking
and selecting Edit Element/Type. The right-mouse button menu entry Reset Element/Type will reset the
slot, so that it is empty again.
Note: Depending on the settings of the individual slot, the menu entry Reset Element/Type will not only
clear the marked slot but also delete the built-in or common model, if it is stored inside the com-
posite model in the data manager. These settings are explained in detail in Section 25.9.2 (The
Composite Frame).
A faster method for dening standard composite models is to right-click on an object in the single line
diagram and select Dene... from the context menu of the element.
When a standard composite model is available for the selected object, a list of the available controllers
is shown. Selecting a controller will add it to the composite model, which is automatically created when
no composite model yet exists for the selected object.
Standard composite models are available for:
The synchronous motor and generator;
The asynchronous motor and generator;
The static VAr system.
526 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
Slot Update
The Slot Update button in the composite model (ElmComp) dialogue will re-read the slot denitions
from the composite frame and will cancel all invalid slot assignments.
A slot assignment is invalid when a model has been assigned to a slot which is not suited to receive
this kind of model, i.e. a voltage controller cannot be assigned to a slot dened for a primary controller
model.
All built-in models and common models which have been created for a specic composite model are
stored in that composite model itself. The contents of a composite model are shown in the data manager
where the composite model is treated as a normal database folder. Basic power system equipment,
such as synchronous machines or static VAr compensators, are normally not stored in the composite
folder, but in the grid itself.
The slot update will try to re-assign each model found in its contents to the corresponding slot.The
options dened for each slot are important, and are described in the paragraph Classication in Sec-
tion 25.9.2 (The Composite Frame).
Step Response
The Step Response button in the composite model (ElmComp) dialogue will activate the Step Re-
sponse command (ComStepres). The dialogue can be seen in Figure 25.9.8.
Next to the references to the composite model, the template and the target directory, the two step
response tests, which will be created, can be specied. The study case to be activated can also be
selected. When Execute is pressed, PowerFactory will create a new folder in the current project named
Step Response Test. Figure 25.9.9 shows this folder in the data manager.
Figure 25.9.8: Step Response Command (ComStepres) Dialogue
DIgSILENT PowerFactory 15, User Manual 527
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.9.9: Step Response Folder in the Data Manager
Inside the Step Response Test folder, a second folder is created, named according to the composite
model which is to be tested. Here the simple test grid can be found including only the generator, the
complete composite model and a load. Additionally there will be two new study cases in which a step
response for the AVR and the PCU, respectively, of the composite model can be tested.
The user can switch between these two study cases and her/his previously-used study cases by acti-
vating and deactivating them.
Note: There is now no longer any connection between the original elements and the new elements of
the composite model. Therefore, you can change any controller settings without changing your
network.
After testing the controller, the folder Step Response Test can be deleted completely without loss of
information in the original network.
25.9.2 The Composite Frame
A composite frame is a block diagram which denes two or more slots, their input and output signals,
and the connections between them. A composite frame is dened graphically by drawing it.
Drawing a composite model frame is similar to drawing a normal block diagram. The main difference is
that instead of common blocks, only slots may be used.
To create a new composite frame select the Insert New Graphic icon on the main toolbar (in the
graphics window) and then select Block/Frame Diagram and press Execute as shown in Figure 25.9.10
This new block denition will then be automatically created in the local library.
528 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
Figure 25.9.10: Creating a New Composite Frame
An empty diagram of the frame will appear in the graphics window. A slot is then created by selecting
the icon in the graphics toolbox and positioning the slot on the drawing surface by clicking once at
the desired location. This is similar to placing elements in the single-line diagram.
An empty slot will be drawn on the page. To dene the slots input and output signals and different pa-
rameters, edit the slot by double-clicking it. The slot edit dialogue will pop up as shown in Figure 25.9.11.
DIgSILENT PowerFactory 15, User Manual 529
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.9.11: Slot Dialogue (BlkSlot )
25.9.2.1 Name and Sequence
The name of the slot will appear later in the composite model dialogue, and it is therefore recommended
to name this element according to which slot it will be assigned (e.g. vco slot). The Sequence param-
eter denes the order of the slots appearing in the composite model dialogue.
25.9.2.2 Assigning a Block Denition to a Slot
A block denition (BlkDef ) can be assigned directly to a slot. This option will simplify the handling of the
slot and prevent errors due to miss-matched signal names of slot and assigned block.
530 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
To assign the external form of a block denition to the selected slot, edit the slot by double-clicking it
and choose the select button for the Block Denition in the dialogue. Now the block denition can
be selected, e.g. the type of controller or built-in element, which should be assigned to this slot later.
As an example, if the newly-dened slot ought to represent a synchronous machine in the frame di-
agram, a predened block denition can be chosen to insert the input and output signals to this slot
available for the element ElmSym. A controller should, for example, only be assigned to a slot, when
only this type of controller is to be inserted into this slot, and no other model can be.
Some predened block denitions can be found in the global library in the path Library/Models/Built-in.
When the block denition is selected (in our example the ElmSym.BlkDef), the input and output as well
as limiting signals will disappear from the slot dialogue. The lter for the class name will automatically
be entered. When clicking on the Ok button, the slot will then show the right inputs and outputs of the
block denition.
Note: When a block denition is assigned directly to a slot, only the input/output signals are set auto-
matically. The internal equations/denitions of the block denition are not implemented in the slot
and the slot itself remains empty. There is always the need to create a common model, which is
the model inserted into the slot of the composite model. When the slot refers to an outside block
denition, beware that this reference is also inside your project. If the reference to the denition is
invalid or changed, the slot may be changed as well. Therefore, assign a block very carefully.
25.9.2.3 Filter for
Class/Name Filter
There is also the possibility to specify a lter for the class name and/or for the model name to be
inserted. This makes sense when (for example) only synchronous machines should be assigned to
the slot. In this case, the class name ElmSym* would be entered. PowerFactory then will only allow
the element class synchronous machine to be inserted into the slot. A lter for a specic (part of an)
element name can also be dened.
25.9.2.4 Classication
The classication options only effect the external behaviour of the slot.
Linear The slot representation in the frame diagram will be as a linear or non-linear model.
Automatic, model will be created When this option is activated, the function Slot Update (see Sec-
tion 25.9.1: The Composite Model) will automatically create a DSL model and ask for a block
denition from the library.
Local, Model must be stored inside This option is activated by default. This means that when a Slot
Update is executed in the composite model, PowerFactory will only search for elements which are
stored inside the ElmComp. A reference to models which are stored outside, i.e. the synchronous
generator in a plant model, will be removed from the slot.
Not all input or output signals of built-in elements or common models have to be used and dened in
the slot. A slot may only have an input or an output signal.
For example, the voltage or frequency of an AC voltage source ElmVac may be controlled by an external
function. Therefore, the slot for the source will only have two input signals u0 and f0. More information
about drawing composite frame diagrams can be found in Section 25.10.1 (Drawing Composite Block
Diagrams and Composite Frames).
DIgSILENT PowerFactory 15, User Manual 531
CHAPTER 25. STABILITY AND EMT SIMULATIONS
25.9.2.5 Upper and Lower Limitation
Limiting Signals
There is also the possibility to enter limiting signals. These signals are handled by PowerFactory
exactly like normal input signals. The difference is only in the graphical representation in the block
diagram. These signals will be shown as inputs on the top or bottom of the slot.
25.9.2.6 Variables
Input and Output Signals
The input and/or output signal(s) have to be dened for each slot. The available signal names for the
Built-In transient models (Elements) can be found in the corresponding Appendix C: Technical Refer-
ences of Models.
The given input and output signal names in this slot dialogue have to match the input/output signals of
the given transient model exactly, or the signals will not be connected properly and an error message
will result.
Only after one or more input and output signals have been dened for a slot, is it possible to connect
the slot with signal lines to other slots. It is therefore recommended to rst position and edit all slots and
to draw the signal connections thereafter.
25.9.3 The Common Model
The common model element (ElmDsl, is the front-end object for all user-dened block denitions.
This means that user-dened transient models, but also the block diagrams that are ready-shipped with
the PowerFactory program, cannot be used other than through a common model. The common model
combines a model or block denition with a specic set of parameter values. The common model shown
in Figure 25.9.12 uses the block denition vco Simple.
Typically the model denition is implemented as a block denition, such as that shown in Figure 25.9.13.
A model denition contains block references which may in turn either point to a primitive block denition
(see Figure 25.9.14) or to a another composite block denition (see Figure 25.9.15). The structure of
the block denition is thus recursive and the user should check that this recursive structure does not
contain circular references to composite block denitions.
A primitive block denition contains one or more DSL expressions and forms a basic block for more
complex transient models. A description of how to use and create DSL models can be found in Sec-
tion 25.11 (User Dened (DSL) Models).
It is also possible to implement the model denition not as a block denition, but directly as a primitive
block denition (Figure 25.9.14), coded using DSL.
Each block denition generally has one or more parameters which can be changed to dene the models
behavior. Two kinds of parameters are supported:
Scalar parameters, i.e. amplication factors, offsets, setpoints, etc.
Two and three dimensional array parameters, which are used in the DSL lapprox()/lapprox2() and
sapprox()/sapprox2() functions.
532 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
Figure 25.9.12: Common Model for the VCO
DIgSILENT PowerFactory 15, User Manual 533
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.9.13: Block Denition of the VCO, Using a Sub-Denition
Figure 25.9.14: Implementation of the Limiter Block, Using a DSL Routine
534 DIgSILENT PowerFactory 15, User Manual
25.9. SYSTEM MODELLING APPROACH
Figure 25.9.15: Implementation of the Controller, Dening a Sub-Block
To create a common model, use the New Object ( ) icon in the toolbar of the data manager and select
Common Model. The block/model denition has to be selected rst. Similar to the composite frame,
this denition is either stored in the global library or in the local library.
The common model then displays the list of available parameters and arrays from the block diagram,
as shown in Figure 25.9.16. All parameters are listed on the rst page of the common model, and their
values can be specied there.
DIgSILENT PowerFactory 15, User Manual 535
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.9.16: Common Model with Parameter List
If the selected block denition uses one or more arrays in its denition, then these arrays are displayed
on the second page (for simple characteristics) and third page (for two-dimensional characteristics) of
the ElmDsl object. In Figure 25.9.17 an example is shown for a 13x4 array denition.
536 DIgSILENT PowerFactory 15, User Manual
25.10. THE COMPOSITE BLOCK DEFINITION
Figure 25.9.17: Common Model with Array List
The characteristics are dened as follows:
Characteristic In the row labelled Size, insert the number of rows in the rst cell; the number of
columns is set automatically. If the number of rows is changed, jump to the previous page and
back again to update the characteristic.
Two-Dimensional Characteristic In the row labelled Size, insert the number of rows in the rst cell
and the number of columns in the second cell. If one of these numbers is changed, jump to the
previous page and back again to update the characteristic.
25.10 The Composite Block Denition
A composite block diagram of the model denition is a graphical representation of a mathematical
transfer function, which produces one or more output signals as a function of one or more input signals.
A block diagram may also have limits (minimal and maximal values) as input signals.
A block diagram may thus be described as:
(y 0, y 1, ...) = function(u 0, u 1, ...)
where y 0, y 1, ... represent output signals 0, 1, ... and u 0, u 1, ... represent for input signals 0, 1, ....
These signals are all functions of time.
Block diagrams consist basically of the following elements:
DIgSILENT PowerFactory 15, User Manual 537
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Summation Points which produce the single output y=(u 0+u 1+...)
Multipliers which produce the single output y=(u 0*u 1*...)
Divisors which produce the single output y=(u 0/u 1/...)
Switches which produce the single output y=u 0 or y=u 1
Signal Lines which produce one or more outputs from one input: y 0 = y 1 =...= u
Block References which are used to include other block denitions.
Block references can be looked upon as macros that insert a low-level block denition inside a composite
block diagram denition. A block reference may either point to another composite block denition or to
a primitive block denition.
The PowerFactory program is shipped with a large set of primitive block diagrams for most common
controller elements like PID-controllers, Dead Bands, Valve Characteristics, etc., and can be found
in the PowerFactory tree under Database LibraryModelsGlobal Macros. These predened DSL
primitives may be copied and altered for specic needs.
A block reference is created by using the icon in the graphics toolbox. This creates an empty square
which can then refer to any existing block denition in the library.
Note: The composite frame and the model denition are very similar and their usage is almost identi-
cal. When creating one or the other PowerFactory recognizes the class when you place the rst
slot or block. If you place a block () rst, the icon for the slot will become inactive, so the user
cannot inadvertently mix up slots and blocks in one diagram. See also Section 25.10.1 (Drawing
Composite Block Diagrams and Composite Frames).
If the block type is selected, PowerFactory inserts all available parameters of the referred block. The
user may change the name of any parameter, however ensure that the order of the parameters is not
changed. The order is important so that the right parameter is assigned to the parameters inside the
block denition.
Signal lines are directed branches, connecting input and output signals. A single output line may be
branched off and connected to more than one input terminal.
After the block reference has been edited, it will show the input, output and limiting signal connection
points of the referenced block denition as one or more coloured dots on the left and right side, respec-
tively, on the upper and lower side of the box. Signal lines may then be connected to these points. It is
allowed to refer to the block denition more than once in the same block diagram. This way, it is possible
to use a particular PID-controller, for instance, twice or more in the same model denition.
An example of a simple block diagram, comprising a multiplier, a summation point and a standard PI
block, is shown in Figure 25.10.1.
Figure 25.10.1: Example of a Simple Block Diagram
538 DIgSILENT PowerFactory 15, User Manual
25.10. THE COMPOSITE BLOCK DEFINITION
When rebuilding a diagram (by pressing the icon), the DSL representation of the block diagram
is written to the output window. For the example block diagram in Figure 25.10.1, this results in the
following output:
model o1 = MyBlock(i1,i2;x1;Kp,Ti;yi)
s1 = \System\Library\Models\DSL\PI.BlkDef(xe;x1;Kp,Ti;yi)
xe = i1
*
i2
o1 = s1+i2+i1
This simple example shows the whole meaning of the block diagram graphics: it is a convenient way
to dene specic controllers, based on standard components. However, it would also be possible to
dene exactly the same block diagram by entering the above DSL script manually and thereby create a
primitive block denition.
25.10.1 Drawing Composite Block Diagrams and Composite
Although the composite block diagram and the composite frame diagram should be distinguished from
one other, they are drawn in the same way.
The basic distinction between a block diagram and a frame diagram is that the latter contains only slots
and signals, whilst the block diagram must not contain any slots.
A new block or frame diagram can be created in various ways:
Selecting the main menu entry File New or Strg-N and then selecting the option Block/Frame
Diagram from the New command dialogue (ComNew);
By clicking on the Insert New Graphic icon on the toolbar of an open graphic, and selecting
the option Block/Frame Diagram;
By right-clicking on, or inside a (library) folder in the active project in the data manager and select-
ing New... Block/Frame - Diagram from the context-sensitive menu;
By using the New Object icon in the database manager and selecting Block Denition (BlkDef).
Note: The two later options only create a block denition object (BlkDef), but no graphic. This method
is therefore not suitable for creating a composite block or frame diagram, but only for creating
primitive block denitions by entering the DSL code.
In the rst two methods, a graphic will be created and will appear in the open graphics board. A new
graphics board will be created when no graphics board is open. The new block/frame diagram graphic
will show a single rectangular block, which depicts the block or frame. The name of the new diagram
will appear on top of the frame.
Inside this rectangle the following objects can be placed from the graphic toolbox for the block diagram:
Node objects:
block references
summation points
multipliers
divisors
DIgSILENT PowerFactory 15, User Manual 539
CHAPTER 25. STABILITY AND EMT SIMULATIONS
switches
different kinds of graphical objects
Branch objects:
signals lines
Inside a frame diagram only the following elements are allowed:
Node objects:
slots
different kinds of graphical objects
Branch objects:
signals lines
These objects can be selected from the Drawing Toolbox. The toolbox also has buttons for pure graph-
ical add-on objects (lines, polygons, rectangles, texts, etc.) as shown in Figure 25.10.2. It should be
noted that the availability of this toolbox is according to whether or not the graphic is frozen ( ). When
the graphic is not frozen, the toolbox is available, and likewise, when the graphic is frozen for editing,
the toolbox is hidden.
Figure 25.10.2: Block/Frame Diagram Objects
Note: When creating a frame or a block denition, PowerFactory recognizes the type of denition when
you place the rst slot or block. Because a composite frame diagram may only contain slots and
signal lines, creating a slot will disable all other node objects in the drawing toolbox. If you place
a block ( ) rst, the icon for the slot will become inactive, so you cant mix up slot and block
elements in one diagram.
25.10.1.1 Adding a Block Reference
Drawing the block objects and connecting them with signals is done in a similar way as is done with
elements in the single line graphic. A block reference is rst displayed as an empty square which has to
be edited in order to assign a (low level) block diagram to it.
Because of lack of information about the number of inputs and outputs of the new block reference before
a (lower level) block denition is assigned to it, it is not possible to connect signals to the empty block. It
540 DIgSILENT PowerFactory 15, User Manual
25.10. THE COMPOSITE BLOCK DEFINITION
is therefore recommended to rst draw all block references and to assign block denitions to them. The
block references then show all available input and output signal connections.
A block reference is edited by right-clicking on it and selecting Edit from the context-sensitive menu, or
simply by double-clicking on it. The dialogue as displayed in Figure 25.10.3 will pop up.
Figure 25.10.3: Edit Dialogue of the Block Reference
Use the Select button ( in Figure 25.10.3) to select a model denition. Predened standard block
diagrams for your usage are located in the folder Database / Library / Models. It is also possible to
create a block in the graphical Block Denition by dragging Macros from the global library or project
library into the drawing area of the Block Denition, using the Drag & Drop functionality.
25.10.1.2 Adding Calculation Blocks
Summation Point
Every dot can be used as an input to the summation point. The sign of signals at summation
points can be changed by editing the summation point object. The edit dialogue will pop up,
where any connected input connection can be inverted. It should be noted that not all dots have
to be used and only one dot can be dened as an output.
Multiplier
Every grey dot of this block can be used as an input or output of the multiplier. An output of three
input signals will thus be: out=(in 0*in 1*in 2). It should be noted that not all dots have to be used
and only one dot can be dened as an output.
Divisor
DIgSILENT PowerFactory 15, User Manual 541
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Every grey dot of this block can be used as an input or output for the divisor. The rst input will be
the numerator and thus will be divided by the second (and if existing, the third) input. The order
of the signals will be clockwise beginning from the left. An output of three input signals will then
be: out=(in 0/in 1/in 2). Mind that not all dots have to be used and only one dot can be dened
as an output.
Switch
Two input signals can be applied to this block, which will be connected to the output according to
the position of the switch. Additionally a control signal has to be connected to the top, which will
dene the operation of the switch. If the control signal is 0.5 or less, the switch will stay in the
displayed state, whereas a signal greater than 0.5 will cause the switch to change to the upper
signal and the other way round. In the edit dialogue the zero position of the switch may be altered.
25.10.1.3 Connecting Signals
After drawing and dening the block references, slots or other node elements, they can be connected
with signal lines. After selecting the button from the graphical toolbox, a signal line is drawn by rst
clicking on a from node (output of a block/slot), optionally clicking on the drawing surface to make a non-
direct connection, and nally clicking on a to node (input to a block/slot). The input and output terminals
of common blocks and other node elements are depicted with coloured dots (see Figure 25.10.4).
Figure 25.10.4: Block Signal Connections
Green: Input
Red: Output
Blue: Min. Limitation
Pink: Max. Limitation
Gray: Every signal can be connected
The signal lines can also be edited in the corresponding dialogue, which provides the possibility to
change the name of the signal.
25.10.1.4 Multi-Signal Connections
Signals normally connect a single output parameter with a single input parameter. Especially in the
case of three phase signals, as is often the case for voltage or current signals, multi-signal connections
may be used.
A multi-signal is dened by writing two or more signal names together, separated by semicolons, e.g
I A;I B;I C. In Figures 25.10.5 and 25.10.6, the multi-signal output and input of two block denitions
are shown. Both blocks will show a single input or output connection point. They can be connected to
each other by a single signal line, as illustrated in Figure 25.10.7.
542 DIgSILENT PowerFactory 15, User Manual
25.10. THE COMPOSITE BLOCK DEFINITION
Figure 25.10.5: Output Denition of Block1
Figure 25.10.6: Input Denition
Figure 25.10.7: Multi-Signal Connection
Note: The number of variables and their order in the output signal must be equal to the number of
signals in the input signal.
25.10.1.5 Block Diagram Input and Output Denitions
The composite block diagram normally has input, output and limiting signals of its own. Input signal
points are dened by starting a new signal line on the left, top or bottom side of the frame enclosing
block diagram. This will create a new input signal for the composite block denition.
New output signals are dened by ending a signal line by clicking on the right side of the enclosing
rectangle frame.
Signals, which are thus connected to the rectangular frame, have the following meanings:
connected to the left side: Input
connected to the right side: Output
connected to the bottom side: Minimum Limitation
connected to the top side: Maximum Limitation
Note: The names of the input and output signals must be the same as the names of the input and
output signals dened in the slot or block to which it is intended to assign the denition.
25.10.1.6 Resize
If a marked symbol has small black squares at its corners, it can be resized by left clicking one of the
squares, as can be seen in Figure 25.10.8. The cursor will change to a double diagonal arrow, and
DIgSILENT PowerFactory 15, User Manual 543
CHAPTER 25. STABILITY AND EMT SIMULATIONS
moving it (while holding down the left mouse button) resizes the object. Release the mouse when the
new size is correct.
Figure 25.10.8: Resizing an Object
It is also possible to make the object(s) have a new size by clicking on one side of the marking box. The
marked object(s) will only resize in one direction in that case. This is not possible for all objects. Some
objects may only be resized with a xed X/Y- ratio; some other objects cannot be resized at all.
25.10.1.7 Additional Equations
After the internal structure of the block diagram has been dened graphically, the block diagram itself
can be edited. This can be done without having to close the graphical representation of the block
diagram. By left or double-clicking the enclosing rectangular frame, the block diagram edit dialogue will
pop up. This dialogue will show all input, output and internal signals, as have been dened graphically.
On the Equations page, information and equations for the initialization of the block can/has to be en-
tered. Additionally, the name and the unit of the parameters to be dened in the common model can be
specied (see also Section 25.11: User Dened (DSL) Models).
Additional DSL equations can be dened on the second page of the block diagram edit dialogue.
25.11 User Dened (DSL) Models
System modelling for stability analysis purposes is one of the most critical issues in the eld of power
system analysis. Depending on the accuracy of the implemented models, large signal validity, available
system parameters and applied faults or tests, nearly any result could be produced and arguments
could be found for its justication.
A simple example illustrates this. In a 10 GW power system the expected steady-state frequency
deviation when losing a fully loaded 2000 MW unit depends highly on the frequency dependency, K f, of
loads. Assuming a total system droop of 7% and a K f value of 0, the steady-state frequency deviation
will be approximately 700 mHz.
Now with a more realistic coefcient of K
f
= 5%/Hz, the steady-state frequency deviation is expected
to be 596 mHz only. On the other hand, the frequency dependency might be slightly higher or lower,
but the non-linear characteristics of hydro turbine efciencies and steam valve non-linearities could be
more relevant at a certain unit loading point. Consequently, as long as only one or two different loading
scenarios are considered, average values with reasonable simple models may give acceptable results
by tuning only some key parameters like the frequency dependency of loads or droop settings.
544 DIgSILENT PowerFactory 15, User Manual
25.11. USER DEFINED (DSL) MODELS
Thus system model structures and parameter settings are to be best evaluated against the following
main criteria:
System size Large and small systems have different key parameters. Referring to the above exam-
ple, for a smaller power system the frequency dependency of loads is irrelevant, while in large
systems such as UCTE or UPS/IPS, frequency dependency may cover the spinning reserve re-
quirements totally.
Unit size Steady-state and transient behavior of large units is more decisive for the overall system
response than smaller units which might have a very negligible effect on the total system.
System structure Independent of system and unit size, the system structure may be more relevant
than any other factor. This can be easily demonstrated when weak systems with a longitudinal
geographical extension or appropriate substructures are analyzed.
System fault Most relevant to system modelling considerations are the applied faults and related prob-
lems which are to be analyzed. The analysis of system damping and PSS tuning will not neces-
sarily require the boiler dynamics to be considered. On the other hand, load shedding optimization
and frequency restoration would not give appropriate results if mid- and long-term characteristics
of relevant system elements are neglected.
Study purpose In general, for systems which are in the planning stage, typical models and parameters
could be applied as long as there is no specic additional information available. However, a more
detailed representation is necessary for systemextensions, where a detailed model representation
should form part of the performance specication. Special attention has to be paid to the analysis
of operational problems and operation optimization. For these cases, detailed modelling of the
relevant components is critically important.
As soon as a detailed analysis and representation of system models is required, the subsequent ques-
tions to be asked are:
How can the structures and parameters of the model be determined?
Are IEEE models and additional manufacturers block diagrams adequate and accurate?
How could the available information be used within the power system analysis software?
The approach which is presented here and successfully applied in various projects can be called the
Advanced System Modelling Approach (ASMA). Typical applications are:
The analysis of controller problems and relevant malfunctions, especially under disturbance con-
ditions;
Optimization of control parameter settings;
Modelling of unconventional system structures and control concepts often found in industrial sys-
tems;
Study applications for the design and specication phase of components and systems (e.g. power
system stabilizer, generator and HVDC controllers).
For the ASMA approach, the following steps are critically important:
Setup of system models Based on the fundamental equations of engineering and physics, the basic
algebraic and differential equations are to be set up according to the required degree of accuracy.
In addition, all parameters such as time constants and gains which could be also derived from
these basics, are to be calculated with the same degree of accuracy.
DIgSILENT PowerFactory 15, User Manual 545
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Performance of system tests In order to dene all other parameters and, in particular, non-linear
characteristics, system performance tests are the best method. In the majority of cases, fre-
quency response tests will not permit the determination of any non-linear structure and its param-
eters. Special test procedures, which do not interfere with normal operation, have to be applied
to focus on the steady-state characteristics, gains and time constants. These measurements are
preferably executed with a highly accurate digital transient performance measurement system.
System Identication Non-linear, multi-input and multi-output system identication techniques are ap-
plied for system identication procedures. Typically, the mismatch between measured and identi-
ed data should be smaller than 2%.
Comparison of measurements and simulations Besides the analysis of subsystems and compo-
nents, overall system performance is to be compared with the theoretical model for all relevant
operating modes.
Of course, very strict application of the ASMA approach is not necessary for modelling relays and
less complex or digital control functions, as these are clearly dened by their appropriate general and
acceptance test documentation. However, independently of the analyzed system, where the system
representation cannot be matched to a classical IEEE or any other standard model, there is a substantial
need for an easy to use and exible method for the realization of individual models.
25.11.1 Modelling and Simulation Tools
As already indicated, the most critical and decisive factor for reliable simulation results is the accuracy
and completeness of system model representation for identication and simulation purposes. Methods
for solving this task range from the classical and traditional way of using software which allows interfac-
ing of user-dened models at the FORTRAN/C level - typically via connection lists - to the block-oriented
approach which is based on the provision of predened low-level block macros being connected at the
case denition level.
In addition, most modern commercially available general purpose simulation tools may be used for
exible and specic system representation. Unfortunately, this approach does not adequately cover the
special electrical system load ow characteristics.
In order to provide a very exible modelling and simulation tool, which forms part of a stability program,
a control system based simulation language was developed. The following describes the main features
of the DIgSILENT Simulation Language (DSL):
The simulation tool falls into the category of a Continuous System Simulation Languages (CSSL
);
DSL includes a complete mathematical description of (time-) continuous linear and non-linear
systems;
The simulation tool is based upon common control and logic diagrams, leading to a non-procedural
language, as the sequence of elements can be chosen arbitrarily. In other words, a DSL model
can be converted into a graphical representation;
Provision of exible denition of macros, which could be: algebraic equations, basic control ele-
ments like PID, PTn or even complete physical subsystems like valve groups or excitation systems;
Provision of various intrinsic functions such as: select, lim, limits, lapprox, picdrop in order
to provide a complete control of models;
Provision of various formal procedures for error detection and testing purposes such as: algebraic
loop detection, reporting of unused and undened variables and missing initial conditions
546 DIgSILENT PowerFactory 15, User Manual
25.11. USER DEFINED (DSL) MODELS
25.11.2 DSL Implementation: an Introduction
The DIgSILENT Simulation Language is used to dene new dynamic controllers which receive input
signals from the simulated power system and which react by changing some other signals.
DSL itself can be looked upon as an add-on to the transient analysis functionality of PowerFactory .
During the simulation, the model equations of the DSL models are combined with those describing
the dynamic behavior of the power system components. These equations are then evaluated together,
leading to an integrated transient simulation of the combination of the power system and its controllers.
The DSL main interfacing functions are:
Signal input and output channels: Any variable dened within the kernel (currently more than 2500)
and in a DSL model, can be accessed in a read-and-write mode. Main and sub-address features
are implemented allowing the access of any signal existing in the system or to build up complex
structures such as hardware-based modules taking equipment rack and function card struc-
tures into account.
Events: Conditions evaluated by DSL models may cause events to be sent to the programkernel where
they will be scheduled within the event queue.
Output and Monitoring: Conditions may trigger user-dened messages to be displayed in the output
window.
DIgSILENT PowerFactory 15, User Manual 547
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.11.1: Structure of the PowerFactory DSL System
The structure of a DSL model is best explained by an example. This example considers a prime mover
unit model of a simple hydro turbine. This DSL model has been dened graphically, and contains one
embedded DSL macro. This embedded macro models a single integrator and is dened by program-
ming it.
The basic method for designing new DSL models is as follows:
1. A set of basic DSL models is created. These models implement simple, primitive controllers like
a rst order time lag or a PID controller. The PowerFactory program is shipped with a large
number of these primitive controller models. New primitives are created by programming their
differential equations and signal settings, using the DSL language.
2. The more complex controller is created graphically by drawing its block diagram. This kind of
block diagram normally uses references other DSL models which are thus combined into a more
complex controller. Controller references may be used to include DSL primitive models into the
complex model, but may also refer to other graphically dened complex models. Highly complex
controllers may thus be designed in a hierarchical way, by designing sub-models and sub-sub-
models, where the DSL primitives form the lowest level. Section 25.11.3 (Dening DSL Models)
describes these procedures in detail.
548 DIgSILENT PowerFactory 15, User Manual
25.11. USER DEFINED (DSL) MODELS
Figure 25.11.2: Diagram of a Simple Model of a Hydro Turbine
Figure 25.11.2 depicts the model denition that was used to dene the hydro turbine model. The
resulting DSL code, as shown in the output window when a graphical Rebuild ( ) is performed is:
1. model Pt = pmu hydro(At,C;x1;Ti;)
2. pt x = I.BlkDef(xe;x1;Ti;)
3. i3 = i1/i2
4. i1 = At
*
At
5. i2 = pt x
*
pt x
6. i4 = xe
*
pt x
7. xe = i3-C
8. Pt = pt x-i4
The line numbers have been added for readability. The corresponding block denition shows:
Output Signals : Pt
Input Signals : At, C
State Variables : x1
Parameter : Ti
Internal Variables
The example describes a simple hydro turbine model with the input signals A t and C and the output
signal P t.
Figure 25.11.3: Graphical Representation of a DSL Model of an Integrator
Figure 25.11.3 depicts the graphical representation of the embedded primitive DSL model. This primitive
model is included in the hydro turbine (in line 2 of the denition of the hydro). The DSL primitive
implements a single integrator and is programmed as follows:
1. model y = I(xe;x1;Ti;)
2. [Ti] = s
3. limits(Ti) = (0,)
4. inc(x1) = y
5. inc(xe) = 0
6. x1. = xe/Ti
7. y = x1
DIgSILENT PowerFactory 15, User Manual 549
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Line 1 is generated by clicking on the Equations button in the block diagram dialogue. Lines 2..7 were
entered manually.
The block denition dialogue was used to set the following:
Output Signals : y
Input Signals : xe
State Variables : x1
Parameter : Ti
Internal Variables
25.11.2.1 Parts of a DSL Model
Both example DSL models show the two basic parts of any DSL model, primitive or complex:
1. The interface denitions
2. The DSL model description
Interface description
The interface denes the model name, names of input and output signals, model parameters and state
variables. These are shown in the output window in the model heading.
Example (line 1 from the hydro turbine model):
1. model Pt = pmu hydro(At,C;x1;Ti;)
The block diagram dialogue further allows for the denition of limiting parameters and input signals, and
the classication of the model as a linear model and/or as a DSL macro.
Model description
The model description describes the DSL model, based on the signals dened in the interface. The
DSL description includes:
Parameter descriptions: name and unit
Allowed parameter ranges
Initial conditions and functions which are used to calculate initial values.
The algebraic relations which dene the controller.
Example (the integrator):
2. [Ti] = s ! the unit of Ti is seconds
3. limits(Ti) = (0,) ! Ti > 0
4. inc(x1) = y ! initially x1=y
5. inc(xe) = 0 ! initially xe=0
6. x1. = xe/Ti ! equation 1: deltax1 / deltat = xe/Ti
7. y = x1 ! equation 2: y=x1
25.11.2.2 Advanced Features
The numerical integration of DSL models, interrupt scheduling and input-output signal processing is
handled automatically by the program kernel. In addition, if the output of a DSL model is an electric
550 DIgSILENT PowerFactory 15, User Manual
25.11. USER DEFINED (DSL) MODELS
current being added to the appropriate total bus current - which is the case if a load or generator model
is created - all Jacobian elements necessary for the iterative simulation procedure will be calculated
automatically.
Another useful feature of DSL is the algorithm implemented for numerical setup of the system ma-
trix for eigenvalue calculation purposes. Consequently, any model implemented at the DSL level will
be automatically taken into consideration when calculating the system eigenvalues or when applying
the modal network reduction approach (MRT). Of course, any signal limiting functions will be disabled
automatically for this calculation procedure.
In addition, inputs and outputs of model parameters, its organization via windows menus etc. is also
derived automatically from the DSL model.
25.11.3 Dening DSL Models
A new DSL model is created either by entering the DSL code in the equation part of a Block Denition
(BlkDef ) object, or by creating a new Graphical Block Diagram. Both methods will result in a Block
Denition Object which holds the denition of the DSL model.
The block denition objects thus serve two purposes in the process of constructing a DSL model:
They hold the denitions and parts of a graphically constructed composite block denition, and
the diagram graphic which was used to dene the model;
They provide the surrounding in which a new DSL primitive or primitive block denition can be
dened.
25.11.3.1 Composite Block Denitions
To create a new composite block denition:
Use the main menu entry File New or Strg-N and then select the option Block/Frame Diagram
from the New command dialogue (ComNew).
Use the Insert New Graphic icon on the toolbar (of the graphics window) and select the option
Block/Frame Diagram.
To access the dialogue of the block denition (BlkDef ), double-click on the frame box surrounding the
diagram.
Complex block denition objects are conceptually similar to Grid Folders in the PowerFactory database
tree. They are dened by graphically dening a controller block diagram of which they will store the
graphical information and all logic parts. These parts include signals, small standard components
(adders, multipliers, etc.) or DSL primitives.
Although a complex block denition object is created graphically, it allows for additional DSL equations
to dene those aspects of the controller that would be otherwise difcult to enter in a graphical way.
The graphical environment in which a complex block diagram is constructed, is not treated here. Please
refer to Chapter 9 (Network Graphics (Single Line Diagrams)) for more information.
25.11.3.2 Primitive Block Denitions
To create a primitive DSL block denition:
DIgSILENT PowerFactory 15, User Manual 551
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Right-click on or inside a (library) folder in the active project in the data manager and select New. . .
Block/Frame-Diagram from the context-sensitive menu;
Use the New Object icon in the database manager and select Block Denition ( BlkDef);
Double-click an new/empty block reference in an open block diagram and then use the button
to select a block denition. Following this, use the icon to create a new block denition inside
the local library.
DSL primitives are the building blocks from which the more complex controller diagrams are composed.
A DSL primitive, for example, might implement a low pass lter, which may then be used to graphically
construct more complex controllers which include this kind of lter.
Unlike transformers or other power system components, which may be looked upon as power system
primitives, a DSL primitive is only referred to by a complex block diagram and may thus be used in more
than one complex DSL model at the same time.
25.11.3.3 Block Denition Dialogue
When creating a primitive DSL model or by double-clicking on the frame of a composite block denition,
a dialogue will appear, where input and output variables, parameters, state variables and limiting signals
can be dened. Furthermore, additional equations, initial conditions of variables as well as names and
units of parameters can be inserted.
Figure 25.11.4 shows an example dialogue of a PI controller including limiting parameters and a switch
signal.
Figure 25.11.4: Dialogue of the Block Denition
Name and Title will appear in the library folder, where the model is stored.
552 DIgSILENT PowerFactory 15, User Manual
25.11. USER DEFINED (DSL) MODELS
Level of the model representation is only important when using or changing old models. For new
created models the highest level should always be used. For macros, this option does not have any
impact, because the level of the highest block is important, i.e. the controller denition.
Automatic Calculation of Initial Conditions: PowerFactory can calculate the initial conditions auto-
matically. However, if no sequence is found (because of, for example, deadlock situations) there will be
an error message.
Classication:
Linear : This option will only effect the graphical representation of the block in the diagram. If this
option is enabled, the block will be represented as a linear block, otherwise as a non-linear block
with two lines.
Macro: This option is used to identify the block denition as a macro inside the library.
Matlab: Enabling the Matlab tag will show an input dialogue, where a MATLAB (*.m) le can be
dened with which the block denition can communicate during a simulation. For more information
about the MATLAB interface see Section 25.14 (MATLAB Interface).
Limiting Parameter. A constant may be dened, which are dened in the common model dialogue, as
well as limiting signals, which are similar to input signals. The difference is the graphical representation
in the block diagram.
Input and output signals have to be dened for internal use inside the block denition. The number
and their name will then appear in the graphical diagram when the block is used.
State variables are needed when not only linear, but also differential, equations are used. Then for
every rst-order derivative one state variable must be specied.
Parameters will appear in the common model dialogue and can then be specied. The parameter
dened in the block denition will automatically be inserted in the block reference. The names of the
parameters can be different in the block reference and in the block denition. Only the order must be
identical.
Internal variables are only used inside the block denition but can not be set from outside.
There are several buttons on the right side of the dialogue:
Contents
This button will display the (possible) contents of the block denition. This can be the graphically
inserted objects, further block references or the packed macros. This may additionally include,
for example, internally-dened events.
Equations
The Equations button will print the DSL equations to the output window, regardless of whether
they are dened graphically or on the Additional Equations page, as well as variable denitions.
Macro Equat.
This button prints the current block denition DSL equations (including the equations in the used
macros) to the output window.
Check
Check will verify the model equations and output error messages if errors have occurred. Oth-
erwise the following message will occur:
DIgSI/info - Check \TestUser.IntUser\Windparks.IntPrj
DIgSILENT PowerFactory 15, User Manual 553
CHAPTER 25. STABILITY AND EMT SIMULATIONS
\Library\Block Definitions\DFIG\Voltage Control.BlkDef:
DIgSI/info - Block is ok.
Check Inc.
The initial conditions of the block denition will be printed and checked.
Pack
Pack will copy all used DSL models (macros) of a composite model denition to the folder Used
Macros inside the block denition. In this way there will now be references to other projects or
libraries outside the model. Beware: any further changes in the macro library have no inuence;
the macros are copied and no longer linked to the library. So if there is an error in a certain macro
it has to be xed separately in each packed block.
Pack-> Macro
This command will reduce the entire model including DSL blocks and additional equations and
macros into one DSL model containing only equations. All graphical information will be lost. It
should be noted that this command is irreversible.
Encrypt
The Encrypt button is available when Pack-> Macro is activated before. This command en-
crypts all equations inside the model, so that the equations can not be seen or output anymore.
In this way a model containing sensitive or restricted device equations can be delivered without
showing the internal equations. It should be noted that this command is irreversible and a decrypt
function is not available.
In the Equations page the (additional) equations of the DSL model can be dened. Also further informa-
tion e.g. the initial conditions of state variables and the name and unit of parameters can be specied.
Figure 25.11.5 shows the additional equations of the DSL model of the PI controller.
Figure 25.11.5: Dialogue of the block denition - Page 2
The next section describes the handling and usage of the DSL language.
25.12 The DIgSILENT Simulation Language (DSL)
The DSL language is used to program models for the electrical controllers and other components used
in electrical power systems. As for any other simulation or programming language, a special syntax is
provided for the model formulation. This syntax is explained in the following order:
554 DIgSILENT PowerFactory 15, User Manual
25.12. THE DIGSILENT SIMULATION LANGUAGE (DSL)
25.12.1 Terms and Abbreviations
The following terms and abbreviations are used to describe the DSL syntax:
expr
arithmetic expression, not to be terminated with a ;
arithmetic operators: +, -, *, /
constants: all numbers are treated as real numbers
standard functions: sin(x), cos(x), tan(x), asin(x), acos(x), atan(x), sinh(x), cosh(x), tanh(x), exp(x),
ln(x), log(x) (basis 10), sqrt(x) (square root), sqr(x) (power of 2), pow(x,y), abs(x), min(x,y),
max(x,y), modulo(x,y), trunc(x), frac(x), round(x), ceil(x), oor(x).
These standard functions are described in detail in the last chapter.
Parenthesis: (arithmetic expression)
All trigonometric functions are based on radians (RAD).
Example:
A = x1+2.45
*
T1/sin(3.14
*
y)
boolexpr
logical expression, not to be terminated with a ;
Logical relations: <, >, < > (inequality), >=, <=, =.
Unary operators: .not.
Binary operators: .and. .or. .nand. .nor. .eor.
Parentheses: logical expression
Example:
A = x1>0.and..not.x2 <= 0.7.or.T1=0.0
string
anything within ... (single quotation marks). Example: A = this is a string
25.12.2 General DSL Syntax
Line length: The maximal line length is 80 characters. Longer lines have to be broken by using the &
sign in the rst column of the continuing line. A & sign in the rst column joins the current row and its
preceding row.
Example:
y = lapprox(x, 1.674, 7.367, 2.485, 12.479, 5.457, 18.578
& 6.783, 15.54, 8.453, 12.589, 9,569, 6.478)
Line breaking cannot be used within names or strings.
Case sensitivity: All keywords, names, functions, variables, models, macros, etc. are case sensitive.
Blanks: All blanks are removed when the DSL code is processed. Exception: blanks in strings are
kept.
DIgSILENT PowerFactory 15, User Manual 555
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Comments: The ! sign causes the remaining line to be interpreted as a comment. Comments are
removed when the DSL code is processed.
Example:
! comments may start at the beginning of a line
x1. = select(at<>0, ! comments may be used in broken lines
& (1-sqr(x1)/sqr(at))/Tw, 0)
25.12.3 DSL Variables
A DSL model may use ve different types of variables:
Output signals: Output signal variables are available as input signals to more complex DSL models.
Input signals: Input variables may originate from other DSL models or from power system elements.
In the latter case, currents and voltages, as well as any other signal available in the analyzed power
system, become available to the DSL model.
State variables: State variables are time-dependent signals generated and used within the DSL model
itself.
Parameters: Parameters are read only numbers which are set to alter the behavior of the DSL model.
Internal variables: Internal variables are dened and used in the DSL model to ease the construction
of a set of DSL equations.
The following rules may be helpful when interpreting warning and error messages:
A state variable may not be simultaneously used as a state variable and an output variable; if
required, the use of an assignment like y=x1 is recommended.
All parameters are real numbers.
A special parameter array iiii (with up to 4 digits i), with 2*iiii elements is provided to dene
characteristics (see procedure lapprox).
Only the derivatives of state variables can be assigned an expression.
25.12.4 DSL Structure
DSL models are constructed of three parts:
The interface part, which states the model name, title, classication and variable set. This part is
set in the rst page of the block diagram dialogue;
Denition code;
Equation code.
The denition and equation code form the actual controller network denition and are treated in the next
sections.
25.12.5 Denition Code
Denition code in the equation part of a DSL model is used to dene parameter properties and initial
conditions.
556 DIgSILENT PowerFactory 15, User Manual
25.12. THE DIGSILENT SIMULATION LANGUAGE (DSL)
25.12.5.1 Unit and Parameter Description
vardef(varnm) = unitstring;namestring
Unit and name for variable varnm.
Examples:
vardef(Ton) = s;Pick up time for restart !defines unit and name
vardef(Ton) = ;Pick up time for restart !only defines name
vardef(Ton) = s; ! only defines unit
[varnm] = unitstring
Unit for variable varnm, maximum 10 characters wide.
Remark: A macro call causes error messages if the units of the substituted variables do not
match the dened units.
Example:
[Ton] = s ! defines unit
25.12.5.2 Valid Value Ranges
limits(varnm) = [/( minimum value, maximum value ]/)
Denes the valid interval for variable varnm. Violations of the interval limits during simulation will be
reported:
limits(yt)=(,1] is equivalent to output(yt>1,
Maximum exceeded: yt=yt>1)
The ( and ) braces exclude the minimum or maximum value from the interval; the [ and ] braces
include them.
Examples:
limits(x)=[min,max] ! min <= x <= max
limits(x)=(min,max] ! min < x <= max
limits(x)=(,max] ! x = max
limits(x)=(min,) ! min < x
If required and if possible, the program automatically determines the smallest interval under several
intervals of the same variable.
Example:
limits(x)=(1,3) and limits(x)=(2,4] results in 2<x<3.
Macro models often dene limits for certain variables. The model which uses the macro might also
dene limits for the variables which are used in the macro calls. The smallest interval method gives
the calling model thus the freedom to redene parameter limits without violating the internal macro limit
denitions.
25.12.6 Initial Conditions
25.12.6.1 Direct Setting of Initial Conditions
inc(varnm) = expr
DIgSILENT PowerFactory 15, User Manual 557
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Denition of the initial condition of variable varnm. If inc(varnm) is not dened, the normal as-
signment expression will be evaluated (only possible if varnm is of the intern or input type). If
inc(varnm) is dened, it will be evaluated when the model is reset.
inc0(varnm) = expr
Denition of the initial condition of variable varnm, for unconnected output or input variables. This
variant of the inc() statement is used only when the variable varnm could not be initialized through
the initial condition of the connected input or output signal. The inc0() statement is thus used to
make open input or output terminals possible.
incx(varnm) = expr
This variant of the inc() statement is valid only in connection with automatic initialization and is
used to determine the initial values in ambivalent situations. With the incx, one or more variables
can be directly initialized so that other variables can be initialized automatically.
Example:
An AVR model has two inputs, [upss , usetp ], and one output, [uerrs ]. Both inputs cannot
both be initialized automatically by the single output value, which is determined by the connected
machine. Therefore one of the inputs must be initialized as xed, e.g. by incx(upss)=0. The
initial value of usetp is now automatically determined, using upss=0.
25.12.6.2 Iterative Setting of Initial Conditions
Three functions are available for determining initial values iteratively: looping, intervalinc, newtoninc.
These functions are used to nd the initial value for one set of parameters if the initial values of another
set of parameters, which are functions of the rst set of parameters, are known.
The iterative functions are used to nd the (approximated) values for the unknown parameters for which
the known parameter take their initial value.
loopinc(varnm, min, max, step, eps)
Performs a simple linear search for a single value for which the parameter varnm is closest to its
known initial value.
varnm = target variable, whose initial value is known
min = lower limit
max = upper limit
step = stepsize
eps = maximum error
Example:
inc(a) = loopinc(b, -5, 5, 0.01, 0.001)
The initial value of variable a is searched for by evaluating parameter b, beginning at a=-5, ending
at a=5, with an increment of 0.01.
Return value: the value of a for which the deviation of b from its known initial value, takes the
smallest value. A warning is given if the smallest deviation is greater than eps.
Restriction: Can only be used on the right side of an inc() statement
intervalinc(varnm, min, max, iter, eps)
558 DIgSILENT PowerFactory 15, User Manual
25.12. THE DIGSILENT SIMULATION LANGUAGE (DSL)
Performs an interval-division search for a single value for which the parameter varnm is closest
to its known initial value.
varnm = target variable, whose initial value is known
min = lower limit, max = upper limit
iter = maximum number of iterations
s = maximum error
Example:
inc(a) = intervalinc(b, -5, 5, 40, 0.001)
Explanation:
The initial value of the variable a is searched for, within the interval [-5,5] by successively dividing
the interval as long as the deviation of the variable b from its initial value is less than eps. The
iteration stops if the maximum number of iterations is reached, and a warning is given if the
smallest deviation is greater than eps.
Restriction:
May only be used on the right side of an inc() statement
newtoninc (initexpr, start, iter, eps)
Performs a Newton iterative search for one or more parameters by minimizing the errors in a set
of coupled equations.
initexpr = the expression which must equal the parameters whose initial value is sought
start = the starting value for the parameter whose initial value is sought
iter = the maximum allowed number of iterations
eps = the maximum allowed absolute error between initexpr and the parameter whose initial value
is sought.
Example:
qt0 = 0.5
eps = 0.000001
maxiter = 100
inc(hedr) = newtoninc(hw-sqr(qedr)
*
(Rds+Rdr), hw,
maxiter, eps)
inc(qt1) = newtoninc(Pt1/(4
*
dh
*
eta1), qt0, maxiter, eps)
inc(qt2) = newtoninc(Pt2/(4
*
dh
*
eta2), qt0, maxiter, eps)
inc(qt3) = newtoninc(Pt3/(4
*
dh
*
eta3), qt0, maxiter, eps)
inc(qt4) = newtoninc(Pt4/(4
*
dh
*
eta4), qt0, maxiter, eps)
This example shows a part of the initial value denitions for a model where the initial values of
5 parameters (hedr ,qt1 ,..,qt4) are sought simultaneously by setting up a system of coupled
equations and solving that system by the Newton method so that, eventually:
hedr hw
_
qedr (Rds +Rdr) (25.1)
qt1 Pt1/(4 dh eta1) (25.2)
qt2 Pt2/(4 dh eta2) (25.3)
qt3 Pt3/(4 dh eta3) (25.4)
DIgSILENT PowerFactory 15, User Manual 559
CHAPTER 25. STABILITY AND EMT SIMULATIONS
qt4 Pt4/(4 dh eta4) (25.5)
The following guidelines should be considered:
Add the initial conditions to the complex block, as opposed to each primitive (like a rst-order time
lag).
The general initialisation direction is from right to left, i.e. the outputs are normally known and the
inputs (or setpoints) have to be determined.
If initial conditions are not dened for a certain variable, the simulation equations are used instead.
It should be therefore enough to specify the initial conditions of the state variables and input
variables.
The option Automatic Calculation of Initial Conditions requires conguring, but does not require
correct initial conditions for each state/input variable. The initial values are only used to initialize
the iteration process. The incx-function can be used to determine the initial values in ambiguous
situations.
Use the option Verify Initial Conditions to check if the initial conditions lead to the correct result.
25.12.7 Equation Code
Within the equation code, all equations necessary to build up the simulation models are included. The
set of equations denes a set of coupled differential equations which describe the transfer functions
between the input and output signals. These transfer functions may range from simple linear, single-
input single-output functions, to highly complex non-linear, non-continuous, multi-input, multi-output
functions.
DSL is used to describe the direct relationships between signals and other variables. Expressions
may be assigned to a variable, or to the rst derivative of a state variable. Higher order differential
equations have to be thus split up into a set of single order equations by the introduction of additional
state variables.
25.12.8 Equation Statement
The equation statements are used to assign expressions to parameters, thus relating all parameters in
a set of differential equations.
Syntax:
varnm = expr
Assigns expression expr to variable varnm.
Examples:
y = sin(a)+3
*
x1
y = .not. x1>2 .or. a<=3
varnm. = expr
Assigns expression expr to the rst order derivative of the variable varnm.
Examples:
x1. = (xe-x1)/T1
x2. = x1
Remarks
560 DIgSILENT PowerFactory 15, User Manual
25.12. THE DIGSILENT SIMULATION LANGUAGE (DSL)
DSL assignments may occur in any sequence. The sequence does not inuence the evaluation
of the assignments.
All variables are of type oating point, even if assigned to a boolean expression, in which case the
value will be 0.0000 or 1.0000.
When a variable z is used in a logical expression (i.e. y=.not.z), the logical 1 of z is tested by
evaluating (z>0.5):
y1 = .not.z is interpreted and equal to y1 = (z=<0.5)
There is no warning against mixing logical and non-discrete variables in expressions. Conse-
quently the following code will not cause a message to be emitted: depending on y, z will take the
value x1 + 4.0, or just x1:
y = .not. x1>2 .or. a<=3
z = 4.0
*
y + x1
The assignment of a value to a variable takes place in an order which recognizes the connections
between these variables. In the case of the following example, the second line will be evaluated
rst, then line 1:
1. a = b+5
2. b = x1
3. x1. = 1
Algebraic loops are not supported. In the following example, an error message will be displayed:
a = b+5
b = 2
*
a
If there is no assignment to a variable varnm, varnm will keep its initial value. The right side
expression may not contain derivatives. Derivatives may only appear on the left side of the equal
sign. The rst example is correct; the second is false.
x1. = asin(a) ! Correct
a = sin(x1.) ! Not accepted
25.12.9 DSL Macros
A DSL macro is a predened DSL model, complex or primitive, which is meant to be included in higher
level DSL models. The block diagram edit dialogue offers a Macro classication option which can be
set to mark the model as a macro.
A DSL macro is included in a higher level DSL model either by creating a block reference in the block
diagram graphics or by its explicit inclusion in a DSL equation.
Syntax:
varnm1,varnm2,...= macroname(i1, i2,...; s1, s2,..; p1, p2,...;i1, i2,...)
Assigns the output signals of the DSL macro macroname to the variables varnm1, varnm2 ,
... Assigns the input signals of DSL macro to the variables i1, i2,... The macro uses the state
variables s1, s2,... the parameters p1, p2,... and the internal variables i1, i2,...
Example: P1,P2 = \User\I.BlkDef(i1,i2;s1,s2;T1,T2)
This example assigns to P1 and P2 the output of DSL model User n I.BlkDef.
Macro calls are not supported within expressions, even if they only have one output variable.
Correct example:
y = my macro(x1, s1, p1, i1) !
Incorrect example:
y = 3
*
my macro(x1, s1, p1, i1) + 4
DIgSILENT PowerFactory 15, User Manual 561
CHAPTER 25. STABILITY AND EMT SIMULATIONS
which should be replaced by:
y1 = my macro(x1, s1, p1, i1) y = 3
*
y1 + 4
25.12.9.1 DSL Internal Macro Handling
A preparser substitutes each macro call with the equation code of the macro. The variables of the
macro DSL model are then replaced by the variables used in the macro call. The local variable names
of macros thus disappear after the preparation process.
25.12.9.2 DSL Models
In general, there are two basic types of DSL models possible:
1. Models of electrical devices such as generators, loads or HVDC systems. These models are
characterized by their principal output signal complex device current, which is injected to the
electrical grid at a certain busbar. However, in addition to the electrical device currents, there may
be any other variable dened as an output signal. A summary of the available variables of each
element can be seen in the corresponding Appendix C: Technical References of Models.
2. Models with output signals which are not directly injected to the electrical network (general de-
vices). Among these types of models are prime mover units, voltage controllers, relays, calculation
procedures, etc.
25.12.10 Events and Messages
The DSL language provides procedures for the generation of an interrupt event and for sending mes-
sages to the output window:
The procedure fault(boolexpr, event string) generates an event and is evaluated at the beginning
of each time step
The procedure output(boolexpr, message string) outputs a message and is evaluated at the end
of each time step.
The fault and output procedures are evaluated at each time step during the simulation of a model.
The rst time that boolexpr is found to be true, the string will be processed and a message will be
sent to the output window, or an event will be added to the PowerFactory event queue. The fault or
output procedures will be disabled afterwards until the DSL model is reset, to prevent an avalanche of
messages or events. Both procedures are explained in detail in the following paragraphs.
output(boolexpr, message string)
The message string may contain variables and the special function num(boolexpr) or num(expr):
Variable names which appear directly after an = sign will be substituted by their actual values;
hence, the line of code below may generate the message:
maximum exceeded: yt=1.2 > ymax=1.0:
output(yymax,maximum exceeded: yt=yt > ymax=ymax)
The num(expr) or num(boolexpr) will be substituted with the calculated value of the expression,
e.g.:
value=num(a+b) may produce value=3.5000
562 DIgSILENT PowerFactory 15, User Manual
25.12. THE DIGSILENT SIMULATION LANGUAGE (DSL)
value=num(a+b) may produce value=3.5000
fault (boolexpr, event string)
Each DSL model can add events to the event list. A DSL model of a distance relay, for instance,
can open the power switch of a line by adding the correct switch event. Adding an event is done by
executing an existing event object in the PowerFactory database.
Consequently, all events that may be used by the DSL model have to be created together with the DSL
model. They must all be stored inside the common model (ElmDsl ). These DSL events will thus form
an integrated part of the DSL model.
The event string in the fault expression must refer to the name of one of these events. At evaluation,
the event will be thrown onto the event stack if boolexpr is true. As soon as the simulation reaches the
event, it will execute it. Consequently, a delayed event may be thrown by the DSL model by setting the
execution time ahead of the current time.
The parameters of the event can be modied in the fault string by assigning a new value. The mecha-
nism is the same as described above in the output procedure.
Example:
fault(u>1.1,name=MySwitchEvent1 dtime=0.15)
If the variable u exceeds 1.1, the event named MySwitchEvent1 will be thrown onto the event stack
and its variable dtime (relative event time) will be set to 15 milliseconds. The event will thus be delayed
for that amount of time, which, in this case, mimics the time needed to open a switch. The actual switch
that will open is dened in the event object MySwitchEvent1.
Note: The events are accessed or created by opening the edit dialogue of the common model (double-
click on the DSL model in the Data Manager), and then pressing the button Events in the
dialogue. A list of events already dened inside this model is displayed. The events are not added
to the projects global event list unless the event is activated by the DSL model.
25.12.11 Example of a Complete DSL Model
Thermal Double Reheat Turbine with Steam Storage
Controller Model:
model pt,ptmw =
'pmu 1 '(at,sgn,cosn,ngnum;x1,x2,x3,x4;Thp,
Tip,Tlp,alflp,Tspi)
[T1] = 's'
limits(T1) = [0,)
limits(alfhp) = [0,1]
vardef(alfhp) = ;'High pressure turbine ratio';
limits(alflp) = [0,1-alfhp]
vardef(alflp) = ;'Low pressure turbine ratio ';
vardef(Tspi) = s;'Boiler capacity time constant';
limits(Tspi) = (0,)
vardef(Thp) = 's ';'High pressure turbine time constant ';
vardef(Tip) = 's ';'First reheater time constant ';
vardef(Tlp) = 's ';'Second reheater time constant '
inc(x1) = y/K
inc(xe) = y/K
DIgSILENT PowerFactory 15, User Manual 563
CHAPTER 25. STABILITY AND EMT SIMULATIONS
inc(x4) = 1.0
inc(at) = pt
inc(steamflow0) = pt
inc(ylp) = pt
x1. = select(T1>0,(xe-x1)/T1,0)
y = K
*
select(T1>0,x1,xe) ! if T1=0 => y=xe
steamflow = at
*
x4
x4. = (steamflow0 - steamflow)/Tspi ! boiler
yhp = PT1(steamflow;x1;Thp) ! high pressure part
yip = PT1(yhp;x2;Tip) ! medium pressure part
ylp = PT1(yip;x3;Tlp) ! low pressure part
pt = yhp
*
alfhp + ylp
*
alflp+ yip
*
(1.0-alfhp-alflp)
ptmw = pt
*
sgn
*
cosn
*
ngnum ! only for output purposes
The used macro 'PT1 is dened as:
model y = 'PT1'(xe;x1;K,T1;) x1. = select(T1>0,(xe-x1)/T1,0)
y = K
*
select(T1>0,x1,xe) ! if T1=0 => y=xe
inc(x1) = y/K
inc(xe) = y/K
[T1] = 's'
limits(T1) = [0,)
25.13 DSL Reference
25.13.1 DSL Standard Functions
564 DIgSILENT PowerFactory 15, User Manual
25.13. DSL REFERENCE
function description example
sin(x) sine sin(1.2)=0.93203
cos(x) cosine cos(1.2)=0.36236
tan(x) tangent tan(1.2)=2.57215
asin(x) arcsine asin(0.93203)=1.2
acos(x) arccosine acos(0.36236)=1.2
atan(x) arctangent atan(2.57215)=1.2
sinh(x) hyperbolic sine sinh(1.5708)=2.3013
cosh(x) hyperbolic cosine cosh(1.5708)=2.5092
tanh(x) hyperbolic tangent tanh(0.7616)=1.0000
exp(x) exponential value exp(1.0)=2.718281
ln(x) natural logarithm ln(2.718281)=1.0
log(x) log10 log(100)=2
sqrt(x) square root sqrt(9.5)=3.0822
sqr(x) power of 2 sqr(3.0822)=9.5
pow (x,y) power of y pow(2.5, 3.4)=22.5422
abs(x) absolute value abs(-2.34)=2.34
min(x,y) smaller value min(6.4, 1.5)=1.5
max(x,y) larger value max(6.4, 1.5)=6.4
modulo(x,y) remainder of x/y modulo(15.6,3.4)=2
trunc(x) integral part trunc(-4.58823)=-4.0000
frac(x) fractional part frac(-4.58823)=-0.58823
round(x) closest integer round(1.65)=2.000
ceil(x) smallest larger integer ceil(1.15)=2.000
oor(x) largest smaller integer oor(1.78)=1.000
time() current simulation time time()=0.1234
pi() 3.141592... pi()=3.141592...
twopi() 6.283185... twopi()=6.283185...
e() 2,718281... e()=2,718281...
Table 25.13.1: DSL Standard Functions
25.13.2 DSL Special Functions
lim
lim (x, min, max)
Nonlinear limiter function:
Figure 25.13.1
limits
limits(param)=(min, max)
Limiter function used to print a warning message to the Output Window if a parameter is outside
the specied limits. Brackets [ and ] are used to indicate the inclusion of the end points in the
range, ( and ) are used to indicate the exclusion of the end points from the range.
Example:
limits(K)=(0,1]
DIgSILENT PowerFactory 15, User Manual 565
CHAPTER 25. STABILITY AND EMT SIMULATIONS
limstate
limstate (x1, min, max)
Nonlinear limiter function for creating limited integrators.
Example:
x1. = xe/Ti;
y = limstate(x1,min,max);
This was previously realized by using select and lim functions:
x1. = select( x1>=max.and.xe>0
& .or.x1<=min.and.xe<0, 0, xe/Ti);
y = lim(x1,min,max);
delay
delay (x, Tdelay)
Delay function. Stores the value x(Tnow) and returns the value x(Tnow-Tdelay). Tdelay in sec-
onds and larger than 0.0. The expression Tdelay must evaluate to a time independent constant
and may therefore only consist of constants and parameter variables. The expression x(t) may
contain other functions.
Example:
y = delay(xe + delay(x1, 1.0), 2.0)
Resetting a DSL model initializes its delay functions with x(Treset).
select
select (boolexpr, x, y)
Returns x if boolexpr is true, else y. Example:
x1.=select(T1>0, xe/T1, 0.0) !to avoid division by zero
time
time ()
Returns the current simulation time. Example:
t=time()
y = sin(t) or
y = sin(time())
le
le (ascii-parm, expr)
!OBSOLETE! Please use an ElmFile object in the composite model in stead.
picdro
picdro (boolexpr, Tpick, Tdrop)
Logical pick-up-drop-off function useful for relays. Returns the internal logical state: 0 or 1.
Return value:
The internal state:
changes from 0 to 1, if boolexpr=1, for a duration of at least Tpick seconds
changes from 1 to 0, if boolexpr=0, after Tdrop seconds
remains unaltered in other situations.
566 DIgSILENT PowerFactory 15, User Manual
25.13. DSL REFERENCE
ipop
ipop (boolset, boolreset)
Logical ip-op function. Returns the internal logical state: 0 or 1.
Return value:
The internal state:
changes from 0 to 1, if boolset=1 and boolreset=0 (SET)
changes from 1 to 0, if boolset=0 and boolreset=1 (RESET)
remains unaltered in other situations. (HOLD)
Initial value: boolset. The initial condition boolset=boolreset=1 will cause an error message.
aipop
aipop (x, boolset, boolreset)
'Analog'ip-op function. Returns the (old) value for x at SET-time if internal state=1, else returns
the current value of x.
Return value:
The internal state:
changes from 0 to 1, if boolset=1 and boolreset=0 (SET)
changes from 1 to 0, if boolset=0 and boolreset=1 (RESET)
remains unaltered in other situations. (HOLD)
lapprox
lapprox (x, array iiii)
Returns the linear approximation y=f(x), where f is dened by the array iiii. Please consider that
the array has to be sorted in ascending order.
Example:
y = lapprox(1.8, array valve)
invlapprox
invlapprox (y, array iiii)
Inverse lapprox with array.
lapprox2
lapprox2 (xl, xc, matrix iiii)
Returns the linear approximation y=f(xl,xc) of a two-dimensional array, where f is dened by the
matrix iiii. xl represents the line value and xc the column of the matrix. Please consider that the
array has to be sorted in ascending order.
Example:
y = lapprox2(2.5, 3.7, matrix cp)
sapprox
sapprox (x, array iiii)
Returns the spline approximation y=f(x), where f is dened by the array iiii. Please consider that
the array has to be sorted in ascending order.
DIgSILENT PowerFactory 15, User Manual 567
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Example:
y = sapprox(1.8, array valve)
sapprox2
sapprox2 (xl, xc, matrix iiii)
Returns the spline approximation y=f(xl,xc) of a two-dimensional array, where f is dened by the
matrix iiii. xl represents the line value and xc the column of the matrix.
Example:
y = sapprox2(2.5, 3.7, matrix cp)
event
Option 1: calling a predened event in the DSL element
event(Condition, trigger, name = ThisEvent dtime = delay value = val variable=var)
Option 2: target specication, no create parameter
event(Condition, trigger, target=ThisSlot name = ThisEvent dtime = delay value = val vari-
able = var)
Option 3: create and target specication
event(Condition, trigger, create = ThisEvtType target = ThisSlot name = ThisEvent dtime
= delay value = val variabl e =var)
This function can create or call any kind of event for the DSL model itself or elements inside the
network. The event is executed, if the input signal trigger changes sign from - to + with a time
delay of dtime.
Mind: the event command has changed from DSL level 3 to level 4!
Arguments:
int Condition (obligatory)
Boolean expression to activate (=1) or deactivate (=0) the event handling; if Condition is set to 1,
the event can be executed, depending on the trigger signal.
double trigger (obligatory)
The trigger signal, which will enable the execution of the event.
The string format determines the details of the event call, and which of the three options above
applies:
string ThisEvtType (mandatory, only option 3)
Type of event to be created. To specify the type use e.g. EvtParam for parameter event or
EvtSwitch for switch event, etc.
string ThisSlot (mandatory, only options 2 and 3)
If target=this is dened, the event is applied to a signal of the present DSL model. If any other
name is given, the DSL interpreter checks the composite model where the present DSL model
(common model) is used and searches for a slot with the given name. The event is then applied
to the element assigned to that slot.
string ThisEvent (obligatory)
Name of the event created (option 3) or the external event to be started (option 1/2). The external
event must be stored locally in the DSL model. If name=this is set, a parameter event will be
created and executed automatically with the DSL element itself as the target.
double delay (obligatory)
Delay time of the event after triggering.
double val (optional)
568 DIgSILENT PowerFactory 15, User Manual
25.14. MATLAB INTERFACE
Value of the parameter event (only when name=this is set or when a parameter event is created).
double var (optional)
Parameter to which the value is set (only when name=this is set or when a parameter event is
created).
Return value:
void (no return value)
Remark:
If the event()-denition according to options 2/3 is used, the create and target parameters must
be the rst parameters that are listed.
Examples:
The example shows a clock made with DSL using event( , ,name=this ...) which automatically
creates and congures a parameter event. The variable named xclock will be reset to value val=0
within dtime=0, if the integrator output xclock is larger than 1. The input signal is a clock signal
with the time period Tclock.
inc(xclock)=0
inc(clockout)=0
xclock.=1/Tclock
reset clock=select(xclock>1,1,-1)
event(enable,reset clock,name=this value=0
variable=xclock)
clockout=xclock
The following event calls an external event called OpenBreaker, which is stored and dened
inside the DSL element, if yo changes sign from - to +. The delay time is 0.2s.
event(1,yo,name=OpenBreaker dtime=0.2)
The following event is a simple undervoltage load-shedding relay. The element in the slot Load
will be disconnected with a switch event EvtSwitch, when the signal u-umin becomes positive.
The event in the event list will be called TripLoad.
event(1,umin-u,create=EvtSwitch name=TripLoad
target=Load)
25.14 MATLAB Interface
In addition to building controller models using the DIgSILENT Simulation Language (DSL), it is possible
to connect to MATLAB models via a PowerFactory -MATLAB interface. A DSL model (object class
BldDef ) is dened in PowerFactory and set up to have a link to a MATLAB .m le. The DSL model must
have at least one output and at least one state variable. The MATLAB .m le returns the vector t and
the matrices x and y, where t represents a time-vector, x represents a matrix of state-variable values,
and y represents a matrix of output values. From these, PowerFactory calculates the derivatives of the
state variables and outputs. The numerical integration is conducted in PowerFactory . PowerFactory
calls MATLAB with every time step. MATLAB does not run a simulation in parallel with PowerFactory ,
it simulates only one time step and returns two rows in t, x and y, which correspond to the initial and
the nal times of that time step. The matrix x has as many columns as there are state variables, and
the matrix y has as many columns as there are outputs. PowerFactory calculates the derivates and the
outputs at the beginning of the time step, and proceeds with the integration. In the following example
the initial time is 0 s and the nal time is 0.01 s. There are two state variables, and two outputs.
DIgSILENT PowerFactory 15, User Manual 569
CHAPTER 25. STABILITY AND EMT SIMULATIONS
t =
_
0
0.01
_
; x =
_
1.02 2.1
1.03 1.9
_
; y =
_
10 2
11 3
_
(25.6)
PowerFactory calculates the deriviatives from the time step and the initial and nal values of the state
variables, e.g. , and obtains the outputs of the MATLAB model at the beginning of the time-step from
the y-matrix, e.g.
dx
1
dt
=
(1.03 1.02
0.01 0
(25.7)
,and obtains the outputs of the MATLAB model at the beginning of the time-step from the y-matrix, e.g
y1 = 10. To use the MATLAB interface, it must be installed on the same computer as PowerFactory .
When the time-domain simulation in PowerFactory is initialised, it will start an instance of MATLAB the
same version that was used last. The following section provides an example of integrating a MATLAB
model with PowerFactory . In the example a voltage controller is implemented rst using a PowerFactory
model (ElmVco 16) and subsequently using an implementation in MATLAB Simulink. This example can
also be found in the Knowledge area of the DIgSILENT online customer portal.
25.14.1 Example Implementation of Voltage Controller
In this example the grid consists of two generators, one load and one line, as shown in Figure 25.14.1.
Figure 25.14.1: MATLAB example grid
The simulation event is dened for the load, where the reactive power is increased after 0.5 seconds.
The complete example contains three les:
1. Matlab Example.dz is a PowerFactory le.
2. VCOtype16.m is a MATLAB M-le.
This le is an interface to the Simulink model, and it is used as a middle layer in the communication
between PowerFactory and Simulink.
3. vcotype16mod.mdl is a Simulink model and contains Simulink implementation of VCO type 16.
570 DIgSILENT PowerFactory 15, User Manual
25.14. MATLAB INTERFACE
25.14.1.1 Built-in Model
In the base study case, the voltage controller models are represented by the built-in models VCO type
16 (ElmVco 16). The built-in VCO type 16 inside PowerFactory is one excitation control system with
simplied exciter. Both composite models use the AVR inside the IEEE-frame from the global library.
The generators have different VCO parameters set. In Figure 25.14.2 the edit dialogue of the ElmVco
with the parameters of the AVR can be seen.
Figure 25.14.2: Parameters dialogue of the voltage controller
The model representation of the ElmVco 16 is indicated in Figure 25.14.3.
Figure 25.14.3: Parameters dialogue of the voltage controller
The plots resulting from the simulation (Figure 25.14.8) show busbar voltages and excitation voltage for
both generators. The results are stored in result les located under the Results folder of the relevant
study case.
DIgSILENT PowerFactory 15, User Manual 571
CHAPTER 25. STABILITY AND EMT SIMULATIONS
25.14.1.2 MATLAB Model
In the second study case Matlab which is a modication of the base case, VCO type 16 is mod-
elled inside the Simulink package, instead of using a built-in model. The MATLAB console is started
automatically when running the simulation.
To implement a MATLAB model into a current project in PowerFactory it has to be included into a frame
similar to a DSL model denition. This procedure is described in detail in the Section 25.14 (MATLAB
Interface). First a slot inside the frame has to be created, where the controller model should be inserted.
This is done exactly like for implementing built-in models or common models. Then a block denition
BlkDef has to be created inside the library. Instead of programming the transfer function using the DSL
code, there can now the denition of the MATLAB code be imported.
This can be done in the dialogue of the block denition. When creating a primitive DSL model in the
library by
right-clicking a or inside a (library) folder in the active project in the data manager and selecting
New. . . Block/Frame - Diagram from the context menu.
using the New Object icon ( ) in the database manager and selecting Block Denition (BlkDef )
double-clicking an new/empty block reference in an open block diagram and then use the
button to select a block denition. Then The icon can be used to create a new block denition
inside the local library.
Now open the dialogue of the new BlkDef
by double-clicking on the frame of a composite block denition
by double-clicking the denition in side the library or on its icon
Here input and output variables, parameters, state variables and limiting signals have to be dened.
Instead of inserting the equations to describe the different function blocks, a MATLAB le *.m can be
selected, when the option Matlab is activated.
The edit dialogue of the block denition including the parameter denition and the selected le can be
seen in Figure 25.14.4 for the mentioned example.
572 DIgSILENT PowerFactory 15, User Manual
25.14. MATLAB INTERFACE
Figure 25.14.4: Composite model using a special frame
The model representation of the ElmVco 16 in the MATLAB Simulink package is shown in Figure 25.14.5
Figure 25.14.5: Parameters dialogue of the voltage controller
When the block denition is specied, a DSL model has to be created rst. As described in Sec-
tion 25.9.3 (The Common Model), the common model element (ElmDsl, ) is the front-end object for
all user-dened block denitions. This means that all user-dened transient models including built-in
elements or MATLAB models cannot be used other than through a common model.
The common model then combines a model or block denition with specic set of parameter values. The
edit dialogue of the DSL element now looks different to the built-in ElmVco. From Figure 25.14.6 can be
seen, that this dialogue is similar to the normal DSL models. All time constants and other parameters
are the same as for the built-in VCO models.
DIgSILENT PowerFactory 15, User Manual 573
CHAPTER 25. STABILITY AND EMT SIMULATIONS
Figure 25.14.6: Parameters dialogue of the MATLAB voltage controller
Figure 25.14.7 shows the composite model using the special frame with the generator G1 and the
Matlab-AVR inserted into the slots.
574 DIgSILENT PowerFactory 15, User Manual
25.14. MATLAB INTERFACE
Figure 25.14.7: Composite Model using a special frame
These results fromthe simulation of the reactive power step using the built-in VCOmodel (dotted curves)
and using the MATLAB representation (solid curves) can be seen in Figure 25.14.8
Figure 25.14.8: Results of the transient simulation with the Built-In model
DIgSILENT PowerFactory 15, User Manual 575
CHAPTER 25. STABILITY AND EMT SIMULATIONS
25.14.1.3 The MATLAB File
The MATLAB le VCOtype16.m is an interface conguration for the Simulink model, stored in the le
vcotype16mod.mdl, and the PowerFactory DSL model. There the input and output signals, the param-
eters and the state variables are dened, as described below. The transfer function is specied.
The contents of this le is listed here:
function [t, x, y] = VCOtype16
global U Tvm Usetp Upss Vska Tisp Ur1mx Ur1mn Vsex Efdmx
Efdmn ve1 x1 x2
options = simget(VCOtype16mod);
options = simset(InitialState, [x1,x2]);
[t, x, y] = sim(VCOtype16mod, [], options);
PowerFactory inserts the following variables into the MATLAB workspace:
U, Tvm, Usetp, Upss, Vska, Tisp, Ur1mx, Ur1mn, Vsex, Efdmx, Efdmn, ve1, x1, x2
Those variables are necessary to successfully run the Simulink model. There are three input signals
(U, Estop, Upss), one output signal Uerrs and two state variables x1 and x2.
In each step of the PowerFactory simulation the Simulink model is completely evaluated. State variables
(InitialState) are assigned to Simulink model in each step of the simulation. For PowerFactory it is a
simple function call:
[t, x, y] = VCOtype16.
PowerFactory uses only one Simulink model for both generators. To avoid limitation of Simulink, which
allows only one instance of the model running at the same time, PowerFactory must send all parameters
in the each step of the simulation.
To nd appropriate equations for the initial conditions you need to understand the construction of the
transfer function blocks in Simulink. To obtain this understanding you can replace the variables with
actual numbers in the MATLAB Simulink model, set the initial conditions, run it for a few seconds and
monitor the outputs of all transfer functions to see whether the model initialized correctly.
The MATLAB Simulink model (.mdl) and the interface le (.m) le may not have the same name.
The order of the state variables in the interface les statement options = simset(InitialState, [x1, x2,
.]) is important; the order of the elements in the vector [x1, x2, ] must be the same as in the state
variable vector constructed internally by MATLAB. To determine the order of the MATLAB state variable
vector the user may use the command [sizes,x0,xstring]= ModelName in the MATLAB workspace,
where ModelName is the name of the Simulink model (without the .mdl extension and without inverted
commas). The output of the string variable xstring contains the names of the dynamic blocks in the
Simulink model in the desired order. In the case of the above example the rst state variable is in the
measurement block and the second state variable is in the integrator:
xstring =
...VCOtype16 model/Measure/State Space
...VCOtype16 model/Integrator
The names of the variables in the Initial conditions elds in the masks of the Simulink model dynamic
blocks is irrelevant.
The initial conditions are set within PowerFactory . Also, for the purpose of PowerFactory s model
checking mechanisms, the state derivatives equal to zero
The Simulink solver parameters are set to integrate over one small time step, e.g. start time = 0, end
time = 0.01, and step size = 0.01.
576 DIgSILENT PowerFactory 15, User Manual
25.14. MATLAB INTERFACE
The y-matrix returned by MATLAB contains the output variables. If more than one output variable
is dened in the DSL model, then those are sorted alphabetically before assigning the outputs from
MATLAB. For example, if there are two outputs uerrs and output, then the value from the rst column
of the y-matrix is assigned to output and the value from the second column is assigned to uerrs.
25.14.2 Additional notes
DIgSILENT PowerFactory calls MATLAB using the programme identication keys Matlab.Application
and Matlab.Application.Single. PowerFactory will start that same MATLAB installation which was used
last.
Additional information on the calling of MATLAB is available on
http://www.mathworks.com
DIgSILENT PowerFactory 15, User Manual 577
CHAPTER 25. STABILITY AND EMT SIMULATIONS
578 DIgSILENT PowerFactory 15, User Manual
Chapter 26
Modal Analysis / Eigenvalue
Calculation
26.1 Introduction
The Modal Analysis command calculates the eigenvalues and eigenvectors of a dynamic multi-machine
system including all controllers and power plant models. This calculation can be completed at the
beginning of a transient simulation and at every time step when the simulation is stopped. Note that
sometimes in the literature Modal Analysis is referred to as Eigenvalue Calculation or Small Signal
Stability. Throughout, this chapter the calculation will generally be referred to as Modal Analysis.
This chapter provides a brief background on the theory of Modal Analysis, followed by a detailed ex-
planation of how to complete such an analysis in PowerFactory. The various methods of analyzing the
results are also presented. Finally, a troubleshooting section explains what to do when you receive
common errors.
26.2 Theory of Modal Analysis
The calculation of eigenvalues and eigenvectors is the most powerful tool for oscillatory stability stud-
ies. When doing such a study, it is highly recommended to rst compute the natural system oscillation
modes. These are the oscillation modes of the system when all controller and power plant models
are deactivated so every synchronous machine will have constant turbine power and constant excita-
tion voltage. After determining these natural modes, the effects of controllers (structure, gain, time
constants etc.) and other models can be investigated.
After the initial conditions have been calculated successfully, which means that all time-derivatives of
the state variables should be zero (the system is in steady state), or the simulation has been stopped at
a point in time, the modal analysis calculates the complete system A-matrix using numerical, iterative
algorithms. The representation of the electrodynamic network model is equivalent to the representation
used for the balanced RMS simulation, except for the general load model, for which the frequency
dependencies are neglected.
The computation time for the Modal Analysis is approximately proportional to the number of state space
variables to the power of three. Considering, that most power system objects and models will contain
several (perhaps up to a dozen or more for some complex controllers), the calculation time can rapidly
increase as the size of the system being considered increases. For this reason, alternative methods for
calculating the system eigenvalues and eigenvectors must be used when the system grows very large.
PowerFactory supports two types of analysis methods.
DIgSILENT PowerFactory 15, User Manual 579
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
A multi-machine system exhibits oscillatory stability if all conjugate complex eigenvalues making up
the rotor oscillations have negative real parts. This means that they lie in the left complex half-plane.
Electromechanical oscillations for each generator are then stable.
More formally, assuming that one of the conjugate complex pair of eigenvalues is given by:
i
=
i
j
i
(26.1)
then the oscillatory mode will be stable, if the real part of the eigenvalue is negative
i
< 0 (26.2)
The period and damping of this mode are given by:
T
i
=
2
i
(26.3)
d
i
=
i
=
1
T
p
ln
_
A
n
A
n+1
_
(26.4)
where A
n
and A
n+1
are amplitudes of two consecutive swing maxima or minima respectively.
The oscillatory frequencies of local generator oscillations are typically in the range of 0.5 to 5 Hz. Higher
frequency natural oscillations (those that are not normally regulated), are often damped to a greater
extent than slower oscillations. The oscillatory frequency of the between areas (inter-area) oscillations
is normally a factor of 5 to 20 times lower than that of the local generator oscillations.
The absolute contribution of an individual generator to the oscillation mode which has been excited as
a result of a disturbance can be calculated by:
(t) =
n
i=1
c
i
i
e
i
t
(26.5)
where:
i
ith eigenvalue
i
ith right eigenvector
c
i
magnitude of excitation of the ith mode of the system (at
t=0) (depending on the disturbance)
n number of conjugate complex eigenvalues (i.e. number of
generators - 1)
In the following c is set to the unit vector, i.e. c = [1, ..., 1], which corresponds to a theoretical disturbance
which would equally excite all generators with all natural resonance frequencies simultaneously.
The elements of the eigenvectors
i
then represents the mode shape of the eigenvalue i and shows the
relative activity of a state variable, when a particular mode is excited. For example, the speed amplitudes
580 DIgSILENT PowerFactory 15, User Manual
26.2. THEORY OF MODAL ANALYSIS
of the generators when an eigenfrequency is excited, whereby those generators with opposite signs in
i
oscillate in opposite phase.
The right eigenvectors
i
can thus be termed the observability vectors. The left eigenvectors
i
measures the activity of a state variable x in the i-th mode, thus the left eigenvectors can be termed the
relative contribution vectors.
Normalization is done by assigning the generator with the greatest amplitude contribution the relative
contribution factor 1 or -1 respectively.
For a n-machine power system, n-1 generator oscillation modes will exist and n-1 conjugate complex
pairs of eigenvalues
i
will be found. The mechanical speed of the n generators will then be described
by:
_
n
_
_
= c
1
11
12
1n
_
_
e
1
t
+c
2
21
22
2n
_
_
e
2
t
+. . . +c
2
n1
n2
nn
_
_
e
n
t
(26.6)
The problem of using the right or left eigenvectors for analyzing the participation of a generator in
a particular mode i is the dependency on the scales and units of the vector elements. Hence the
eigenvectors
i
and
i
are combined to a matrix P of participation factor by:
P
i
=
_
_
P
1i
P
2i
P
ni
_
_
=
_
1i
i1
2i
i2
ni
in
_
_
(26.7)
The elements of the matrix p
ij
are called the participation factors. They give a good indication of the
general system dynamic oscillation pattern. They can be used to determine the location of eventually
needed stabilizing devices to inuence the system damping efciently. Furthermore, the participation
factor is normalized so that the sum for any mode is equal to 1.
The participation factors can be calculated not only for the generator speed variables, but for all variables
listed in Table 26.2.1.
Name Unit Description
s:speed p.u. Speed
s:phi rad Rotor-angle
s:psie p.u. Excitation-Flux
s:psiD p.u. Flux in D-winding
s:psix p.u. Flux in x-winding
s:psiQ p.u. Flux in Q-winding
Table 26.2.1: Variables accessible for eigenvalue calculation
When are modal analysis results valid?
A modal analysis can be started when a balanced steady-state condition is reached in a dynamic calcu-
lation. Normally, such a state is reached by a balanced load-ow calculation, followed by a calculation
of initial conditions. However, it is also possible to do a balanced RMS simulation and start a modal
analysis after the end of a simulation or during a simulation when you have manually stopped it.
Although, the modal analysis can be executed at any time in a transient simulation it is not recommended
that you do so when the system is not in a quasi-steady state. This is because each modal analysis is
DIgSILENT PowerFactory 15, User Manual 581
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
only valid for a unique system operating point. Furthermore, the theory behind modal analysis shows
that the results are only valid for small perturbations of the system. So although you can complete
a modal analysis during a large system transient, the results obtained would change signicantly if
the analysis was repeated a short time step later when the operating point of the system would be
signicantly different.
26.3 How to Complete a Modal Analysis
This section explains the steps required to complete a Modal Analysis in PowerFactory Completing an
analysis using the default options is explained in the rst sub-section. The second sub-section explains
the various options available in the Modal Analysis command.
26.3.1 Completing a Modal Analysis with the Default Options
To complete a modal analysis in using the default options in PowerFactory , you must follow the steps
below:
1. Use the toolbar selection button to choose the Modal Analysis toolbar. The process is illustrated
in Figure 26.3.1.
Figure 26.3.1: How to select the Modal Analysis toolbar
2. Calculate Initial Conditions using the button to open the command and then press Execute.
Note that the calculation of initial conditions needs a converging load-ow. More information about
the options in the Calculation of Initial Conditions command can be found in Chapter 25: Stability
and EMT Simulations, Section 25.3.
3. If you want to quickly complete the modal analysis and capture all eigenvalues using the default
options, you can press Execute in the subsequent dialogue box and the calculation will proceed.
When the calculation is complete you can view the Modal Analysis results. This is explained in
detail in Section 26.4.
Internal Calculation Procedure
When executing the Modal Analysis command by pressing Execute, the initial conditions of all elements
are calculated rst (assuming that the calculation is initialised from a load-ow rather than during a
RMS simulation). Then the modal analysis constructs a system matrix from the load-ow and the
dynamic data. The eigenvalues and eigenvectors are calculated directly from that matrix. PowerFactory
automatically does the linearization of all relevant system elements because eigenvalue calculations
need linearized models.
582 DIgSILENT PowerFactory 15, User Manual
26.3. HOW TO COMPLETE A MODAL ANALYSIS
26.3.2 Explanation of Modal Analysis Command Basic
Options (ComMod)
The Modal Analysis command dialogue is shown in Figure 26.3.2. This section explains the available
command options.
Figure 26.3.2: Modal Analysis command dialogue
Calculation Method
There are two possible calculation methods for the Modal Analysis, they are:
QR-Method; This method is the classical method for calculating all of the system eigenvalues.
Selective Modal Analysis (Arnoldi/Lanczos); This method only calculates a subset of the system
eigenvalues around a particular reference point. Often this method is used in very large systems
when using the QR-method could be very time consuming. It is especially useful if the user knows
the target area of interest for the eigenvalues. This option needs more conguration as explained
below.
Complex reference point (RP)
Here you must enter the reference point on the real-imaginary plain for the Selective Modal Analysis.
Which Eigenvalues
The selective eigenvalue calculation determines eigenvalues close to the reference point using one of
three different measures for closeness. The options are:
Smallest Magnitude w.r.t RP; If this option is selected, the selective eigenvalue calculation chooses
eigenvalues that are closest to the reference point by magnitude of the eigenvalue.
Smallest Imaginary Part w.r.t RP; If this option is selected, the selective eigenvalue calculation
chooses eigenvalues that are closest to the reference point using only the imaginary part of the
eigenvalue.
DIgSILENT PowerFactory 15, User Manual 583
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
Smallest Real Part w.r.t RP; If this option is selected, the selective eigenvalue calculation chooses
eigenvalues that are closest to the reference point using only the real part of the eigenvalue.
This option can be further claried using a diagram as shown in Figure 26.3.3. The three eigenvalue
pairs are as follows:
A; -0.8 +/- 1.4
B; -0.7 +/- 1.5
C; -0.5 +/- 2.0
Say the reference point was set to the origin (0,0). Then using the rst method above, the closest
eigenvalue pair would be A because this pair has the smallest magnitude. Using method two, the
closest pair would be C because this pair has the smallest real component. Finally, using the third
method, the closest pair would also be A because this pair has the smallest imaginary component.
Figure 26.3.3: Illustration of different eigenvalue selection methods
Number of Eigenvalues
This parameter limits the total number of eigenvalues calculated by the Selective Eigenvalue calculation
method. An eigenvalue pair is dened as one eigenvalue mode for this calculation.
Settings
The Settings button, is a reference (pointer) to the Calculation of Initial Conditions command, also
accessed through the button, that is used by the Modal Analysis command. It is provided here so
that you can easily inspect the selected calculation options.
26.3.3 Advanced Options
The advanced options page for the modal analysis is shown in Figure 26.3.4. This section explains the
options available on this page.
584 DIgSILENT PowerFactory 15, User Manual
26.4. VIEWING MODAL ANALYSIS RESULTS
Figure 26.3.4: Advanced Options tab page of the Modal Analysis command dialogue
Calculate
There are three checkboxes here:
Left Eigenvectors (Controllability); If this option is enabled, the Modal Analysis command will
calculate the Left Eigenvectors. It is enabled by default. The user can visualise the Controllability
for any mode using the Mode Phasor Plot or Mode Bar Plot described in Section 26.4.2.
Right Eigenvectors (Observability); If this option is enabled then the Modal Analysis command will
calculate the Right Eigenvectors (Observability) for each state variable. It is disabled by default.
The user can visualise the Observability for any mode in either the Mode Phasor Plot or Mode
Bar Plot described in Section 26.4.2.
Participation Factors; If this option is enabled then the Modal Analysis command will calculate
Participation Factors for each state variable. It is disabled by default. The user can visualise the
Participation Factors for any mode using the Mode Phasor Plot or Mode Bar Plot described in
Section 26.4.2.
Results
This selection control provides a reference (pointer) to the results object that is used to store the calcu-
lation results of the Modal Analysis. After a completed calculation, these results can be exported to an
external format such as a spreadsheet or text-le using the ASCII result exporter tool as described in
Chapter 17, Section 17.2.4(Result Objects).
By default the Modal Analysis captures results for all state variables from all models active in the cal-
culation. The observability is also calculated by default for the variables shown in table 26.2.1. In
addition, the Modal Analysis command can calculate the Controllability and Participation Factors for
these variables.
26.4 Viewing Modal Analysis Results
There are several ways for the user to view the results of the Modal Analysis calculation, including
through pre-dened reports to the Output Window, using the built-in plots within PowerFactory or us-
ing the spreadsheet like data browser. Additionally, the user can search individual objects within the
database and view the Controllability, Observability, and Participation for a particular mode within the
DIgSILENT PowerFactory 15, User Manual 585
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
familiar data manager or object lters. This section describes how to get results using these four meth-
ods.
26.4.1 Viewing Modal Analysis Reports in the Output Window
This section describes how to view the Modal Analysis results in the PowerFactory Output Window To
do this follow these steps:
1. Left-click the Output Calculation Analysis icon on the main toolbar. The Output of Results
dialogue should be visible.
2. Select the eigenvalues radio button and the dialogue should look as shown in Figure 26.4.1.
3. There are four options for the report. You must choose one of these options in the Output of
Eigenvalues section of the dialogue:
Eigenvalues; This option prints a report of all the calculated eigenvalues.
Controllability/Observability/Participations; Selecting any of these options changes the dia-
logue format to that shown in Figure 26.4.2. The various options are explained as follows:
Select Eigenvalue To print a report showing all eigenvalues and for each eigenvalue a ltered
list of the state variables Controllability, Observability or Participation Factors, then choose the
option Filtered from this drop down menu. Adjust the lter settings in the box below to determine
which eigenvalues will not be shown in the report. Alternatively, to display a report for a single
eigenvalue, choose the eigenvalue index from this box. Note when choosing a single eigenvalue,
the lter settings are not applied to the report.
Variable Selection To show all variables (for example, speed, phi, psiD), select Show all. To lter
the displayed variables according to Controllability, Observability or Participation Factor, choose
Min. contribution and enter the value for the minimum contribution. Alternatively, for greater
control over which variables are displayed, select the User Dened States option. The button
Show shows the currently selected variables. More variables can be added using the Add button
whereas all variables can be removed by using the Remove All button.
4. Press Execute. An example report for eigenvalues is shown in Figure 26.4.3. The results of
the participation factors for a single mode in a small example power system are shown in Fig-
ure 26.4.4. Note the Detailed check-box shows the bar chart in the report, whereas the normal
report shows only numerical values.
586 DIgSILENT PowerFactory 15, User Manual
26.4. VIEWING MODAL ANALYSIS RESULTS
Figure 26.4.1: Output of eigenvalues only
DIgSILENT PowerFactory 15, User Manual 587
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
Figure 26.4.2: Output of Controllability, Observability or Participation Factors
Figure 26.4.3: Output of system eigenvalues
Figure 26.4.4: Output of participation factors for a single mode (detailed)
588 DIgSILENT PowerFactory 15, User Manual
26.4. VIEWING MODAL ANALYSIS RESULTS
26.4.2 Viewing Modal Analysis Results using the built-in Plots
There are three special plot types in PowerFactory for visualising the results of a modal analysis calcu-
lation; the Eigenvalue Plot, the Mode Bar Plot and the Mode Phasor Plot.
Each type of plot can be automatically created by selecting the icon and clicking the desired plot
icon. This section explains how to use each plot and also how these plots can be exported to external
software.
How to use the The Eigenvalue Plot (VisEigen)
Creating the EigenValue Plot
1. Using the plot selection toolbar as shown in Figure 26.4.5, choose the Eigenvalue Plot by clicking
the icon.
2. The Eigenvalue Plot will appear in a new window. Note, every time you select the EigenValue Plot
icon from the drop-down menu, a new plot window will be created.
Figure 26.4.5: Selection of the Modal Analysis plots
Interpreting the EigenValue Plot An example EigenValue Plot is shown in Figure 26.4.6.
The Eigenvalue Plot displays the calculated eigenvalues in a two axis coordinate system. For the
vertical axis, it is possible to select among the imaginary part, the period or the frequency of the
eigenvalue. The horizontal axis shows the real part.
Stable eigenvalues are shown in green (default) and unstable eigenvalues in red (default). Each
eigenvalue can be inspected in detail by right clicking it and selecting Edit Data. This will bring
up a pop-up dialogue where the index, the complex representation, the polar representation and
oscillation parameters of the mode can be inspected as illustrated in Figure 26.4.7.
DIgSILENT PowerFactory 15, User Manual 589
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
Figure 26.4.6: The Eigenvalue Plot
Figure 26.4.7: IntEigen dialogue
Changing the appearance of the EigenValue Plot All settings that control the appearance of
the Eigenvalue Plot can be accessed by double clicking a empty area of the plot. A dialogue as
shown in Figure 26.4.8 will appear. The options available are explained as follows:
Appearance; Here the colour of the stable and unstable eigenvalues can be adjusted. You can
also decide whether to display the plot legend and the stability borders. The so-called Stability
Borders option shades the area of the plot containing all the modes shown on the plot. It is not an
area of stability as such.
Filter Options; Here you can choose to restrict the display of eigenvalues on the plot according to
dened criteria. Eigenvalues can be restricted by range (independently in either the x or y axes)
by selecting the Restrict Range option. The Restrict Indexes options allows the user to choose
from the complete list of eigenvalues, a limited subset to display on the plot. Alternatively, just the
Oscillatory Modes can be displayed by choosing the Show Oscillatory Modes option.
Scale; Here the range of the plot (x and y axes limits) can be dened. Also by enabling the Adapt
Scale option, the x and y axes tick marks will be displayed as integer values, rather than oating
point numbers. For example, the axis marks will be 10.0, 20.0 and 30.0 rather than 9.7988,
19.5976 and 29.3964.
590 DIgSILENT PowerFactory 15, User Manual
26.4. VIEWING MODAL ANALYSIS RESULTS
Figure 26.4.8: The Eigenvalue Plot settings
How to use The Mode Bar Plot (VisModbar)
Creating the Mode Bar Plot
1. Using the plot selection toolbar as shown in Figure 26.4.5 choose the Mode Bar Plot by clicking
the icon.
2. The Mode Bar Plot will appear in a new window. Note, every time you select the Mode Bar Plot
icon from the drop-down menu, a new plot window will be created.
Interpreting the Mode Bar Plot An example Mode Bar Plot is shown in Figure 26.4.9. The
Mode Bar Plot displays the controllability, observability or participation factors of variables for a
user selected eigenvalue in bar chart form. This allows for easy visual interpretation of these
parameters.
Double clicking any of the bars in the plots shows the detailed IntEigstate dialogue as shown
in Figure 26.4.10. This dialogue displays the magnitude, phase and sign of the variables for
controllability, observability and participation in the selected mode. Note, the observability and
participation factors are only shown if these calculations were enabled in the Modal Analysis
Command as described in Section 26.4.2.
DIgSILENT PowerFactory 15, User Manual 591
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
Figure 26.4.9: Example Mode Bar Plot
Figure 26.4.10: Eigenvalue state dialogue
Changing the appearance of the Mode Bar Plot All settings that control the appearance of
the Eigenvalue Plot can be accessed by double clicking a empty area of the plot. A dialogue as
shown in Figure 26.4.11 will appear. The options available are explained as follows:
Mode Selection; Here you must choose the mode displayed on the plot. The observability, con-
trollability or participation factors will then be displayed for this mode. Note, if you are interested in
a mode near a particular value, but dont know the index of the mode, you can enter the real and
imaginary values in the boxes here, and PowerFactory will automatically select the closest mode.
Shown values; Here you can select to display either the Controllability, Observability or Participa-
tion Factors for the selected mode.
Filter Options; Here you can choose to restrict the display of variables on the plot according to
dened criteria. Displayed variables can be restricted to a minimum contribution by selecting the
Min. Contribution option, or for greater control the variables to display can be selected manually
by selecting the User Dened States option and manually choosing the variables to display.
592 DIgSILENT PowerFactory 15, User Manual
26.4. VIEWING MODAL ANALYSIS RESULTS
Appearance; Here you can adjust the colour and style of the bars and choose to show the plot
legend and also the annotation (value) for each bar.
Figure 26.4.11: Mode Bar Plot Dialogue
How to use the Mode Phasor Plot (VisModephasor) Creating the Mode Phasor Plot
1. Using the plot selection toolbar as shown in Figure 26.4.5 choose the Mode Phasor Plot by clicking
the icon.
2. The Mode Phasor Plot will appear in a new window. Note, every time you select the Mode Phasor
Plot icon from the drop-down menu, a new plot window will be created.
Interpreting the Mode Phasor Plot An example Mode Phasor Plot is shown in Figure 26.4.12.
The Mode Phasor Plot displays the controllability, observability or participation factors of variables
for a user selected eigenvalue in polar form. Variables are grouped and coloured identically if their
angular separation is less than a user dened parameter (default 3 degrees).
Double clicking any of the bars in the plots shows the detailed IntEigstate dialogue as shown in
Figure 26.4.10. This dialogue is identical to the dialogue displayed when clicking on one of the
bars in the Mode Bar Plot.
DIgSILENT PowerFactory 15, User Manual 593
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
Figure 26.4.12: The Mode Phasor plot
Changing the appearance of the Mode Phasor Plot All settings that control the appearance of
the Mode Phasor Plot can be accessed by double clicking a empty area of the plot. The dialogue
that appears is very similar to the dialogue for the Mode Bar Plot and the Mode Selection, Filter
Options and Appearance can be altered in the same way. In addition, there are three more
options:
Cluster; Enabling this option will cluster variables with a angular separation less than the param-
eter entered. A cluster shares the same diagram colour.
Show only points; If this parameter is disabled, the vectors will appear as points on the diagram
rather than arrows.
Show unit circle; The unit circle can be removed from the plot by disabling this option.
Exporting a Modal Analysis Plot to External Software Any of the Modal Analysis plots can be ex-
ported to a WMF or BMP le for use in an external software program such as a word processor. It
is recommended to use the WMF format where possible because this format is a vector based format
(which means that the plot looks good regardless of scaling) and is compressed so uses much less disk
space than the BMP le.
To export a Modal Analysis plot follow these steps:
1. From the main PowerFactory le menu, choose the Option File Export ... Windows Metale
(*.WMF). A Save As dialogue will appear.
2. Choose an appropriate File name and disk location and click Save.
594 DIgSILENT PowerFactory 15, User Manual
26.4. VIEWING MODAL ANALYSIS RESULTS
Note: The process of exporting multiple plots can be automated using a DPL script. See the DPL func-
tion WriteWMF() in the Appendix D: DPL Reference for more information.
26.4.3 Viewing Modal Analysis Results using the Modal Data Browser
The Modal Analysis results can be displayed in a convenient data browser specially designed for working
with these results. To display the results in this data browser follow these steps:
1. Click the icon found in the Modal Analysis toolbar. The ComModres dialogue as shown Fig-
ure 26.4.13 will appear.
2. Optional: If you want to display the Modal Analysis results from another Study Case, you need
to select user-dened for Shown Results and select an alternative results object. Normally you
should leave this value on Default
3. The procedure now depends on if you want to view the calculated eigenvalues, or if you want to
view the controllability, observability and participation factors for variables related to a particular
eigenvalue.
If you only want to display the eigenvalues, then leave the Shown Values on Eigenvalues.
If you want to view the controllability, observability and participation factors for a particular
eigenvalue then you must select States and choose the Eigenvalue index.
4. Press the Execute button. The data browser window will appear as shown in Figure 26.4.14 (for
eigenvalues) or as shown in Figure 26.4.15 for a single eigenvalue and the controllability etc for
each variable.
Figure 26.4.13: Displaying modal analysis results in a data browser (ComModres dialogue)
DIgSILENT PowerFactory 15, User Manual 595
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
Figure 26.4.14: Modal analysis results in a data browser (eigenvalues)
Figure 26.4.15: Modal analysis results in a data browser (controllability etc)
Note: The results in the eigenvalue data browser can be sorted or grouped by clicking on the column
heading. Clicking once sorts the column in descending order, a second time in ascending order.
Viewing the Mode Bar Plot or Mode Phasor Plot directly from the Modal Data Browser
When you view the Eigenvalues in the data browser as shown in Figure 26.4.14, you can quickly show
the Mode Bar Plot or Mode Phasor plot of the eigenvalue. To do so follow these steps:
1. Right-click the mode icon on the left most side of the browser. The context sensitive menu will
appear.
For a Mode Phasor Plot choose the option Show Phasor Plot Controllability etc.
For a Mode Bar Plot choose the option Show Bar Plot Controllability etc.
596 DIgSILENT PowerFactory 15, User Manual
26.4. VIEWING MODAL ANALYSIS RESULTS
Exporting the results from the Modal Analysis Data Browser to external software
To export the results shown in the Modal Analysis Data Browser to an external software program (such
as a spreadsheet tool) follow these steps:
1. In the browser window left click and drag a selection of data that you would like to export. To select
all data press CTRL-A.
2. Right-click within the selection and choose the option Spread Sheet Format Copy (with column
headers).
3. Open the external software and paste the data from the windows clipboard.
26.4.4 Viewing Results in the Data Manager Window
The data manager and object lter can be used to view the participation factors, controllability or observ-
ability for power system elements such as synchronous machines after completing an Modal Analysis.
There are three tasks that you might need to complete to show this information. Tasks one and two are
compulsory, whereas task three is only necessary if you are viewing the eigenvalue results in the data
manager or object lters for the rst time.
Task 1: Choosing the Eigenvalue and variable to view
1. Firstly, make sure you have executed a Modal Analysis as described in Section 26.3.
2. From the Modal Analysis toolbar click the Set Eigenvalue icon . The Set Eigenvalue dialogue
(ComSeteval ) should appear as shown in Figure 26.4.16.
Figure 26.4.16: The Set Eigenvalue dialogue
3. Typically, you should leave the Shown results set to Default, unless you wish to view results from
an alternative Study Case.
4. Choose the Eigenvalue index to display results for by entering the number using the keyboard or
by using the increment/decrement control.
5. Choose the State Variable to view the results for by using the drop-down selection menu.
6. Press the Execute button. It will appear as if nothing has happened - this is normal.
Task 2: Viewing the results in the Object lter
1. Select the synchronous machine icon from the object lter menu.
DIgSILENT PowerFactory 15, User Manual 597
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
2. A list of allRelevant synchronous machines will appear in a data manager style window. Select
the Flexible Data tab from the bottom of the window. In Vista/Windows 7 this will be highlighted in
blue.
3. Scroll across the window to view the columns containing the observability, controllability and par-
ticipation factor date. If you dont see these column headings, then you will need to dene the
Flexible data as described in Task Three.
Task 3: Changing the Flexible Data Columns to show the participation factors
1. Click the Dene Flexible Data from the window toolbar. A Variable set browser selection
window will appear.
2. Choose the Modal Analysis page from the left of this window.
3. In the Filter for settings choose the Variable Set Calculation Parameter.
4. In the Available Variables window, scroll to near the bottom until you see the variables p mag
(Participation, Magnitude) etc. Holding shift select this variable and all eight other variables down
to rEVec mags (Observability, Magnitude signed).
5. Click on the variables or on the right arrows icon between the Available Variables and Selected
Variables windows. The screen should look similar to Figure 26.4.17.
6. Press the OK button. Now you can scroll to the right in the exible data page to view the values
of these variables.
Note: The results can only be displayed for one eigenvalue and variable at a time. For instance, eigen-
value 3 and speed. To change the displayed eigenvalue and/or variable, repeat task one above.
You dont need to repeat task three every time because after this has been done the rst time in
the project it will remain congured this way until you change the dened variables in the exible
data page.
Figure 26.4.17: Variable set selection of Controllability, Observability and Participation Factor variables
for Synchronous Machines.
598 DIgSILENT PowerFactory 15, User Manual
26.5. TROUBLESHOOTING MODAL ANALYSIS CALCULATION PROBLEMS
26.5 Troubleshooting Modal Analysis Calculation Problems
There are various things that can go wrong during an attempt at a Modal Analysis and PowerFactory
usually provides error messages to indicate the nature of the problem when it occurs. This chapter
describes some of the common problems that can occur when attempting a Modal Analysis and the
probable solutions.
26.5.1 Models not supported by the QR method
Sometimes the Modal analysis calculation will fail with an error like: The system contains models which
cannot be supported by QR method. Please try Selective Modal Analysis (Arnoldi/Lanczos). There are
several PowerFactory models that are not supported by the QR method such as:
The Asynchronous Machine (ElmAsm);
The PWM converter (ElmVscmono, ElmVsc);
DFIG (ElmAsmsc);
DC machine (ElmDcm);
DC line (ElmLne with type set to DC);
Complex load;
DC shunt;
DC surge arrester;
DC valve (ElmValve);
DC series reactor;
If you get such a message, you have two options for resolving the problem:
1. Place all objects from your project as listed above out of service (you could possibly create a
operation scenario for this purpose so that you can easily revert to the base model for load-ow,
short circuit etc).
2. Use the Arnoldi/Lanczos method. In the majority of cases, this is probably the best option.
26.5.2 The Arnoldi/Lanczos Method is slow
The Arnoldi/Lanczos Method is a selective eigenvalue calculation and should not be used when you
need to calculate all the system eigenvalues. When you need all the system eigenvalues, the QR
method will generally be faster.
The Arnoldi/Lanczos method is generally fast when computing a selective number of eigenvalues
around a desired point. If you need to get a larger number of eigenvalues than the default, it is suggested
that you increase the requested number of values slowly, say starting with 20 then 50 etc.
DIgSILENT PowerFactory 15, User Manual 599
CHAPTER 26. MODAL ANALYSIS / EIGENVALUE CALCULATION
600 DIgSILENT PowerFactory 15, User Manual
Chapter 27
Model Parameter Identication
27.1 Introduction
The process of parameter estimation for power system elements for which certain measurements have
been made is performed with the Parameter Estimation function using the icon .
The ComIdent command object is a high performance non-linear optimization tool, which is capable
of a multi parameter identication for one or more models, given a set of measured input and output
signals. This identication is principally performed in the following way:
A Measurement File object (ElmFile) is created which maps the raw measured data onto one
or more measurement signals. These signals may contain measured excitation and response
signals.
The measurement signals are used as inputs by the models of the power system elements for
which one or more parameters have to be identied, or they may be used to control voltage or
current sources.
The output signals of the power systemelements are fed into a comparator, just as the correspond-
ing measured signals. The comparator is thus given the measured response on the excitation and
the simulated response of the element models.
The comparator calculates an objective function, which is the weighted sum of the differences
between the measured and the simulated response, raised to a whole power (by default to the
power of 2).
The ComIdent command will collect all objective functions from all comparator objects in the
currently active study case and will minimize the resulting overall objective function. To do this,
the ComIdent command is given the list of parameters which are to be identied. The objective
functions are minimized by altering these parameters.
This whole process is visualized in Figure 27.1.1.
DIgSILENT PowerFactory 15, User Manual 601
CHAPTER 27. MODEL PARAMETER IDENTIFICATION
Figure 27.1.1: The identication Principle
Of course, Figure 27.1.1 only visualizes the principle of the identication. To connect measurement
les, power system models and comparator objects to each other, a composite frame is used. This, and
all other details of the PowerFactory identication functions, is described in the following sections.
27.2 Target Functions and Composite Frames
The parameter identication process is performed by minimizing objective functions. These objective
functions are calculated by ElmCompare objects from the difference between measured responses and
calculated responses of one or more power system elements.
To dene an objective function, the measured excitation signals must be connected to the component
models or to voltage or current sources, and the measured and calculated response signals must be
connected to the compare object. All this is done graphically by drawing a Composite Frame, using a
block denition (BlkDef) with slots.
A simple example of an identication block diagram, for the objective function for a voltage controller, is
visible in Figure 27.2.1.
Figure 27.2.1: Simple identication block diagram
The block diagram uses slots which reserve space for the measurement les, the comparator and the
element models.
602 DIgSILENT PowerFactory 15, User Manual
27.2. TARGET FUNCTIONS AND COMPOSITE FRAMES
27.2.1 The Measurement File Slot
The measurement le object (ElmFile) has the following signals available:
Number of Input Signals: 0
Number of Output Signals: 10
Input Signals Names: -
Output Signals Names: y1,..,y10
The measurement le slot in the example of Figure 27.2.1 has the following settings:
Class Name Filter: ElmFile
Output Signals: y1,y2
The fact that the signal is named output2 signals in the case of the measurement le does not im-
plicate that the parameter identication only regards measured response signals (measured outputs)
from power system elements. It only means that the measured excitation signals will be mapped onto
ElmFile signals. The ElmFile will reproduce the measured excitation and response signals during the
identication process.
27.2.2 Power System Element Slot
Power system element slots are used in the identication block diagram in the same way as they are
used to dene composite models.
As in the case of a composite model diagram, the element slots may use any of the available parameters
of the power system element model as input or output. The in- and output signals are dened by stating
the exact variable name (see also Section Composite Block Denitions in Chapter 25: Stability and EMT
Simulations, Section 25.11 (User Dened (DSL) Models)
In the case of the example in Figure 27.2.1, the Vco1 slot has the following parameters set:
Class Name Filter: ElmVco*
Output Signals: uerrs
Input Signals: u
27.2.3 Comparison Slot
The comparison object ElmCompare has the following properties:
Number of Input Signals: 21
Number of Output Signals: 0
Measured Response Signal Names: in1mea,..,in10mea
Simulated Response Signal Names: in1sim,..,in10sim
Weighting Factor: qzpf
DIgSILENT PowerFactory 15, User Manual 603
CHAPTER 27. MODEL PARAMETER IDENTIFICATION
Output Signals Names: -
The calculated value of the objective function will be multiplied by the weighting factor before it is put
out. The weighting factor may be used, for instance, to connect a time-window to the comparison object
which forces the objective function to zero for those moments in time which are not to be used in the
identication process.
In the case of the example in Figure 27.2.1, the Comparison slot has the following parameters set:
Class Name Filter: ElmCompare
Input Signals: in1meas,in1sim
27.3 Creating The Composite Identication Model
The identication block diagram only denes a generalized workbench that is needed for the identica-
tion process. Its function is similar to that of the Composite Frame object. There is also the need to
create a composite model, based on the block diagram, to identify particular parameters of particular
objects.
Suppose having a voltage controller model of which one wants to identify the parameters ka and ta.
Measurements of the behaviour of the physical appliance are available as measured voltage-curves on
the input and output of the controller during a disturbance.
Assuming the example identication block diagram of Figure 27.2.1, a composite model (ElmComp) has
to be created in the active grid folder.
Note: If the identication process only addresses secondary power system element, which are not
directly connected to busbars, the identication process does not require a power system grid.
However, all calculation functions like load-ow or EMT simulation require a calculation target in
the form of an activated grid of system stage folder. Therefore, a grid folder with at least one
DUMMY busbar has to be created when secondary element models are to be identied.
The composite model must be set to use the identication block. It will then show the slots that have
been dened in that block. In the current example, the composite model dialogue will look like Fig-
ure 27.3.1.
604 DIgSILENT PowerFactory 15, User Manual
27.3. CREATING THE COMPOSITE IDENTIFICATION MODEL
Figure 27.3.1: The example composite identication model
In this gure, the three slots have been assigned already. Visible is that the comparison object Compare
Signals is selected, as well as a measurement le and the voltage controller of which to nd the best
possible values for ka and ta.
27.3.1 The Comparison Object
The comparison object calculates the objective function from the connected measured and simulated
responses. It allows for the use of weighting factors and for other powers to raise to. The example in
Figure 27.3.2 shows the default settings.
DIgSILENT PowerFactory 15, User Manual 605
CHAPTER 27. MODEL PARAMETER IDENTIFICATION
Figure 27.3.2: The comparison object dialogue
In this gure, the 10 difference signals are listed, with their weighting factor. By default, these are one,
but they may be edited freely. The power factor equals 2 by default but may be set to any other positive
whole number from 2 to 10.
The objective function calculated by the comparison object equals
n
i=1
[(M
i
S
i
) w
i
]
p
(27.1)
where
M
i
is the measured response (i.e. in1mea)
S
i
the simulated response (i.e. in1sim)
w
i
is the weighting factor (i.e. for the difference signal nr.1)
p is the power
27.4 Performing a Parameter Identication
The identication process is executed by the ComIdent command. This command can be opened by
the icon on the main menu. This icon can be found on the RMS/EMT Simulation toolbar which is
be accessed by selecting the Change Toolbox icon ( ).
The ComIdent dialogue is depicted in Figure 27.4.1.
606 DIgSILENT PowerFactory 15, User Manual
27.4. PERFORMING A PARAMETER IDENTIFICATION
Figure 27.4.1: The ComIdent dialogue
This dialogue shows references to the following objects:
Load-Flow Settings
This reference is automatically set to the load-ow command that will be used during the identi-
cation process.
Initial Conditions
This reference is automatically set to the initial conditions command that will be used during the
identication process.
Simulation
This reference is automatically set to the simulation command that will be used during the identi-
cation process.
The identication process allows for the use of load-ow calculations and/or dynamic simulations. The
Load-Flow and Simulation pages shows the variables that are to be identied, in case of a load-ow
or a dynamic identication. See for example Figure 27.4.2.
Figure 27.4.2: Setting identication parameters
DIgSILENT PowerFactory 15, User Manual 607
CHAPTER 27. MODEL PARAMETER IDENTIFICATION
In this example, one parameter of the voltage controller element identi 1 from the Composite Iden-
tication Model is listed. The identication process will alter this parameter in order to minimize the
objective functions.
The Mode eld in the parameter list determines the parameter constraints:
(0) means not to change the parameter, but to leave it at its initial conditions. This option may be used
to temporarily exclude some parameters from the identication process.
(1) mean to optimize the parameter without restrictions
(2) means to optimize the parameter, given the constraint that the parameter value must always be
greater than zero.
Although the object for which the parameters are optimized in this example is the same object as is
used in the Composite Identication Model, it is allowed to enter any other parameter from any other
element, as long as that element belongs to the active study case. Such may be used to optimize
secondary appliance, where only the behaviour of the primary appliance has been measured.
27.5 Identifying Primary Appliances
A primary appliance, such as a general load, an asynchronous machine or a static var system, do not
have an input signal like a voltage controller or any other secondary appliance. It would therefore not
be possible to connect a measured signal directly to a load model in order to simulate its response.
To identify a primary element model, a small grid model is used to which one or more controllable
voltage sources may be connected. These voltage sources will translate the measured voltage signals
from the measurement le into a normal busbar voltage which will be used in the load-ow or simulation
calculations. The response of the primary element models connected to that busbar may then be
compared to a measured response.
An example of this method is shown in the following gures.
Figure 27.5.1: Identication diagram with primary element
In Figure 27.5.1, a simple Identication Block Diagram is shown in which the measurement le is no
longer connected to the element slot, but to the voltage source slot. The voltage at the busbar at which
608 DIgSILENT PowerFactory 15, User Manual
27.5. IDENTIFYING PRIMARY APPLIANCES
the voltage source will be connected will thus be forced to the measured values during the identication
process.
Figure 27.5.2: Primary element and voltage source
In Figure 27.5.2, a very simple grid is shown to which the load which is to be identied and a voltage
source element are connected. As with the normal identication process, a Common Identication
Model has to be created which uses the Identication Diagram with Primary Element as shown in
Figure 27.5.1. In the ComIdent command dialogue, the unknown parameters of the load may then be
listed.
It is of course possible to mix the identication of both primary and secondary power system elements
at the same time.
DIgSILENT PowerFactory 15, User Manual 609
CHAPTER 27. MODEL PARAMETER IDENTIFICATION
610 DIgSILENT PowerFactory 15, User Manual
Chapter 28
Contingency Analysis
28.1 Introduction
In Chapter 21 (Load Flow Analysis) the general aspects of load ow analysis and its main areas of
application were presented. Additionally, two perspectives were discussed: that of planning and that of
system operation (see Figure 21.1.1). There it was made evident that regardless of the perspective, the
behaviour of the system must be analyzed under both normal and abnormal conditions.
When referring to contingency analysis, we are essentially referring to the analysis of abnormal system
conditions. In general, contingency analysis can be dened as: the evaluation of the violations in
system operating states (if any) that certain contingencies can pose to the electrical power system;
or put in other words, contingency analysis is the execution and evaluation (loading and voltage-wise)
of post-fault load ows; each of which reect the outage of a single or group of elements (such as
transformers, busbars, transmission lines, etc.).
Contingency analyses can be therefore used to determine power transfer margins or for detecting the
risk inherent in changed loading conditions. This chapter deals with deterministic contingency analysis.
28.2 Technical Background
The contingency analysis module available in PowerFactory offers two distinct contingency analysis
methods:
Single Time Phase Contingency Analysis:
The non-probabilistic (deterministic) assessment of failure effects under given contingencies,
within a single time period.
Multiple Time Phase Contingency Analysis:
The non-probabilistic (deterministic) assessment of failure effects under given contingencies, per-
formed over different time periods, each of which denes a time elapsed after the contingency
occurred. It allows the denition of user dened post-fault actions.
Figures 28.2.1 and 28.2.2 illustrate the general sequence of both methods. Here the results of both
pre- and post-fault load ows are compared to the specied loading and voltage limits; based on this
comparison contingency reports are generated.
In Figure 28.2.1 the term Single Time Phase is used because only one post-fault load ow is analyzed
per contingency case.
DIgSILENT PowerFactory 15, User Manual 611
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.2.2 illustrates the multiple time phases contingency analysis method. Here, more than one
post-fault load ow can be analyzed for the same contingency; hence the term Multiple Time Phase.
Furthermore, if required, each time phase can have its own post-fault actions dened. The dened
post-fault actions can be either a single event or a combination of the following events:
Load shedding
Generator re-dispatching
Switching action (opening or closing)
Tap changing
In PowerFactory , the term Fault Case (used in both Figures) is used to dene a contingency.
Figure 28.2.1: Single Time Phase Contingency Analysis Method
612 DIgSILENT PowerFactory 15, User Manual
28.2. TECHNICAL BACKGROUND
Figure 28.2.2: Multiple Time Phase Contingency Analysis Method
Before describing in detail the contingency analysis itself, it is necessary to introduce two basic concepts
which dene the functionality of this tool:
Contingencies: These are objects in PowerFactory of the class ComOutage ( ) which are used
to represent contingencies. They are dened by a set of events which represent the occurrence of
the originating fault(s) over time and the subsequent fault clearing and post-fault actions. It should
be noted that depending on the method selected and the value assigned to the Post Contingency
Time parameter (see Section 28.5.3: Multiple Time Phases), post-fault actions are carried out.
For further information on the denition and use of contingencies please refer to Section 28.5.7
(Dening Time Phases for Contingency Analyses).
Time Phases: These represent points in time at which the steady-state operational point of the
network under analysis is calculated. Each time phase is dened via a user dened Post Con-
tingency Time (see the Multiple Time Phases page of the Contingency Analysis command). The
Post Contingency Time denes the end of a phase; that is, the point in time at which the steady-
state of the network is calculated. For further information regarding the denition of time phases
refer to Section 28.5.7 (Dening Time Phases for Contingency Analyses).
DIgSILENT PowerFactory 15, User Manual 613
CHAPTER 28. CONTINGENCY ANALYSIS
28.2.1 Single Time Phase Contingency Analysis
The single time phase contingency analysis function rst performs a pre-fault (base) load ow calcula-
tion. Following this, for each contingency (stored inside the command itself) it performs a corresponding
post-contingency load ow (for a single time phase), which take one or more primary components out
of service. The command calculates the initial consequences of the contingencies, but does not regard
the operational measures taken to mitigate voltage band problems or supply interruptions.
It is important to mention here that if the contingency analysis command is set to consider Automatic Tap
Adjust of Transformers and Shunt Adjustment, they will only be considered if their time constants are
smaller than the current Post Contingency Time or if the Consider Specic Time Phase ag (Multiple
Time Phases page) is not enabled. Additionally, the operational thermal ratings of branch elements
during the contingency (if short term thermal ratings (12.3.7) have been dened) will depend on the
duration of the contingency i.e. the current Post Contingency Time.
The raw results of the single time phase contingency analysis correspond to the steady-state opera-
tional points of the network being studied, considering each one of the dened contingencies up to
the given Post Contingency Time (see Section 28.4: The Single Time Phase Contingency Analysis
Command for further information on this setting). The reporting facilities available in PowerFactory s
contingency analysis function allow the ltering of results of interest to the user, including maximum
loading of branch elements, exceeded voltage limits, etc. Refer to Section 28.4 (The Single Time
Phase Contingency Analysis Command) for further information on conguring the reporting settings,
and Chapter 11 Study Cases, Section 11.11 (Results Objects) for information on handling result objects
(ElmRes) in PowerFactory.
Note: If the Fault Case contains post-fault actions such as load shedding, generator re-dispatch, tap
changing and switching actions (closing), these are ignored in the Single Time Phase mode, re-
gardless of the specied Post Contingency Time.
28.2.2 Multiple Time Phases Contingency Analysis
As indicated previously, PowerFactory provides tools for the analysis of contingencies over multiple
time phases, allowing the denition of post-fault actions that can lead to the mitigation of voltage band
problems or supply interruptions which are caused by faults in the networks under analysis.
As in the single time phase contingency analysis, the multiple time phases contingency analysis func-
tion rst performs a pre-fault (base) load ow calculation. The major difference here is that for each
contingency (stored inside the command), it loops over the list of dened time phases (also stored
inside the command itself), calculating the corresponding post-contingency load ows. For each load
ow calculation, the events (faults and post-fault actions) whose time of occurrence are earlier than, or
equal to, the corresponding Post Contingency Time, are considered.
Similar to single time phase contingency analysis, the effect of transformer tap changers and switchable
shunts depends on these components corresponding time constants and the current Post Contingency
Time. Controllers are only considered if their time constants are smaller than the current Post Contin-
gency Time. Additionally, the operational thermal ratings of branch elements during the contingency (if
short term thermal ratings (12.3.7) have been dened) will depend on the duration of the contingency
i.e. the current Post Contingency Time.
The raw results of the contingency analysis with multiple time phases correspond to the steady-state
operational point of the network being studied, at every Post Contingency Time for each of the de-
ned contingencies. The reporting features included in the function allows the ltering of problematic
contingencies, according to maximal loading of branch elements, exceeded voltage limits, etc.
614 DIgSILENT PowerFactory 15, User Manual
28.3. EXECUTING CONTINGENCY ANALYSES
28.2.3 Time Sweep Option (Single Time Phase)
PowerFactory provides a special Calculate Time Sweep option for the Single Time Phase method, and
which can be found on the Time Sweep page of the contingency analysis command. When enabled,
the date and time of the active Study Case will be modied according to a list predened by the user.
The application of this option is in situations where the calculation of contingencies is required for a
certain time span; for example, the automatic calculation of contingencies for every hour of the day.
Here it is important to note that in order for the Time Sweep to activate the corresponding scenarios
automatically, a Scenario Scheduler (IntScensched) object needs to rst be created and afterwards
activated. Once the execution of the contingency analysis has nished, the Study Case date and time
are restored to their original setting. For more information on the Scenario Scheduler please refer to
Chapter 14(Operation Scenarios).
In addition, the Time Sweep option can be used in combination with the Parallel Computing option
(Section 28.2.5).
28.2.4 Consideration of Predened Switching Rules
In PowerFactory , the contingency analysis can be setup to consider predened switching rules of sub-
stations (refer to Chapter 9: Network Graphics (Single Line Diagrams), Section 9.2.6 for further infor-
mation). The Switching Rule denes switching actions for different fault locations (arranged in a matrix)
that can be reected at a certain time. These switching actions will always be relative to the current
switch position of every breaker.
28.2.5 Parallel Computing Option (Single Time Phase)
The computation time required to perform a contingency analysis largely depends on two factors:
The size of the power system; and
The number of contingencies considered.
Depending on these factors, the computation time could take from a couple of seconds (or less) up to
several minutes.
With the development of multi-core machines and the existence of Ethernet network technology, the
calculation of contingencies in parallel is now an option in PowerFactory. This feature facilitates the
signicant reduction of required computation time depending on the number of cores being used.
By default, the Parallel Computing option is enabled in each user account; however, the setting can be
modied when the user has logged on as an Administrator.
The following sections provide detailed information regarding the execution and settings of the contin-
gency analysis command in its single or multiple time phase conguration.
28.3 Executing Contingency Analyses
To access the various contingency analysis related functions within PowerFactory , click on the icon
Change Toolbox and select Contingency Analysis.
Figure 28.3.1, shows the Contingency Analysis Toolbar, with all the related functions.
DIgSILENT PowerFactory 15, User Manual 615
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.3.1: Contingency Analysis Related Functions
Both the Single Time Phase and Multiple Time Phases contingency analysis are carried out using the
Contingency Analysis command (ComSimoutage, ). When congured and executed, it performs a
base load ow calculation to determine the operational point of the network under no-fault conditions.
The command contains Contingency Cases (ComOutage objects) which dene one or more elements
that are taken out of service simultaneously. Following the calculation of the base load ow, a contin-
gency load ow for each of these contingencies is calculated. This calculation considers the post-fault
thermal ratings of branch elements (see Chapter 12: Project Library, Section 12.3.7), transformer tap
changer controller time constants and automatic shunt compensators (for further information please
refer to Section 28.4: The Single Time Phase Contingency Analysis Command).
In PowerFactory , contingency cases can be generated by two primary means:
Via the denition and use of Fault Cases and Fault Groups; and/or
Using the Contingency Denition (ComNmink) command, either via its toolbar icon ( ) or by
selecting component(s) in the single-line graphic, right-clicking and selecting Calculate Contin-
gency Analysis. . .
In the rst case, contingency cases can be created using references to user dened Fault Cases and
Fault Groups (introduced in Chapter 12: Project Library, Section 12.3.3) from the Operational Library.
By means of a topological search, PowerFactory determines which circuit breakers must be opened in
order to clear the faults, and generates the corresponding contingency cases. Each contingency case
is generated with its corresponding interrupted components for each fault case/group. Fault cases and
groups reside in the Operational Library folder, and can be reused. Hence there is no need to manually
redene the same contingencies each time a contingency analysis is required. For further information
on creating contingencies from fault cases/groups, please refer to Section 28.6 (Creating Contingency
Cases Using Fault Cases and Groups).
In the second case, contingencies can be created using the Contingency Denition command. This
command is available either via the icon on the main toolbar, or by right-clicking on a selection of
elements in the single line diagram, and selecting the option Calculate Contingency Analysis. . . .
Either an n-1 or an n-2 outage simulation for the selected elements can then be prepared. Additional to
these two options an n-k outage for mutually coupled lines/cables is available. The Contingency Deni-
tion command optionally allows all lines/cables, transformers, series reactors, series capacitors and/or
generators to be selected to create contingencies. For further information on creating contingencies
using the Contingency Denition command, please refer to Section 28.7 (Creating Contingency Cases
Using the Contingency Denition Command).
The following sections provide detailed information regarding the settings and features of the contin-
gency analysis command in its single time phase conguration.
616 DIgSILENT PowerFactory 15, User Manual
28.4. THE SINGLE TIME PHASE CONTINGENCY ANALYSIS COMMAND
28.4 The Single Time Phase Contingency Analysis Command
The settings of the Basic Options page of the contingency analysis command (ComSimoutage ) are
illustrated in Figure 28.4.1.
Figure 28.4.1: Basic Options settings of the Contingency Analysis (ComSimoutage) Command
When executing a contingency analysis, the general sequence of operations performed is as follows:
Execution of a base load ow in order to determine the initial operational point of the network.
This base (pre-fault) load ow is performed according to the settings stated in the load ow com-
mand and which is referenced on the Basic Options page of the contingency analysis command.
Execution of the contingency load ows. That is, for each of the stored contingency cases, it
places the interrupted components (see Section 28.4.8: Representing Contingency Situations
- Contingency Cases) on outage and performs a contingency (post-fault) load ow. Here, the
settings of the post-fault load ows will depend on how the contingency command is congured.
That is, if specied by the user, the pre-fault and post-fault load ows can be executed with different
settings (only a difference in certain settings are allowed). For more information please refer to
Section 28.5.3 (Multiple Time Phases).
The contingency load ow is characterized by the Post Contingency Time parameter (available on the
Multiple Time Phases page of the Contingency Analysis command if either the option Allow different
settings has been enabled, or when the option Consider Specic Time Phase has been selected). This
parameter determines the duration of the interval between the occurrence of the fault(s) which dene the
contingency, and the time when the load ow calculation of the network under the contingency situation
DIgSILENT PowerFactory 15, User Manual 617
CHAPTER 28. CONTINGENCY ANALYSIS
is performed. The Post Contingency Time is a key parameter of the single time phase contingency
analysis because:
1. The actions of transformer automatic tap changers and switchable shunt compensators on the
faulted network are only regarded if the time constants of their controllers are less than the dened
Post Contingency Time (meaning that the controllers are fast enough to operate during the time
phase); and
2. The operational thermal ratings of branch elements during the contingency (if short term thermal
ratings (see Section 12.3.7) have been dened) will depend on the duration of the contingency,
i.e. the Post Contingency Time.
Note: The base and the contingency load ow calculations by default use the same load ow com-
mand (ComLdf object). However, the user can dene different load ow commands for these two
calculations by selecting the option Allow different settings on the Multiple Time Phases page
of the contingency analysis command (ComSimoutage). The actions of automatic tap changers
and switchable shunts are only possible if the corresponding options are selected in the Basic
Options page of the load ow command(s).
The contingency analysis uses a result le object (ElmRes, see Chapter 11 Study Cases, Section 11.11
(Results Objects)) to store the voltages at terminals and the loading of certain branch element classes
(lines, transformers, series capacitances and series reactances). Recording the loadings for all branches
and the voltages for all terminals for every contingency may lead to excessive data storage. Therefore,
in order to minimize data storage, only signicant results are recorded. In contingency analysis, a
calculated parameter is considered to be signicant if the threshold (Limits for Recording) of the cor-
responding component are out of the threshold. Limits can be set individually for each terminal and
branch element (in the Load Flow page of the elements dialogue) or globally in the Limits for Recording
eld of the contingency analysis command. A calculated result is stored in the result le whenever one
of the constraints (individual or global) is violated.
The settings of the contingency analysis command are entered using the dialogue shown in Fig-
ure 28.4.1. The following subsections explain each of the available options.
28.4.1 Basic Options
Calculation Method
AC Load Flow Calculation The contingency analysis uses an iterative AC load ow method to
calculate the power ow and voltages per contingency case.
DC Load Flow Calculation The contingency analysis uses a linear DC load ow method to
calculate the active power ow per contingency case.
DC Load Flow + AC Load Flow for Critical Cases The contingency analysis will perform two
runs (if required). First it will use a linear DC load ow method to calculate the active power ow
per contingency case; if for certain contingencies loadings are detected to be outside a certain
threshold, then for these cases the contingency analysis will recalculate the post-fault load ow
using the iterative AC load ow method. The criteria (threshold) used for the AC recalculation of
critical DC cases is stated on the Advanced Options page.
Limits for Recording
The parameters in this section set the global threshold used to determine whether a calculated result is
recorded in the Results object (object pointed to by the Results for AC or Results for DC eld located in
the bottom section of the Basic Options page). Whenever one of the dened constraints is violated, the
calculated result (for the corresponding contingency case and network component) is recorded.
618 DIgSILENT PowerFactory 15, User Manual
28.4. THE SINGLE TIME PHASE CONTINGENCY ANALYSIS COMMAND
Max. thermal loading of components (%) Maximum thermal loading in percent. Loadings
exceeding this value will be recorded in the result le for the corresponding component.
Lower limit of allowed voltage (p.u.) Minimum admissible voltage in per unit. Voltages lower
than this value will be recorded in the result le for the corresponding terminal.
Upper limit of allowed voltage (p.u.) Maximum admissible voltage in per unit. Voltages higher
than this value will be recorded in the result le for the corresponding terminal.
Maximum voltage step change (p.u.) Maximum (+/-) admissible voltage change in per unit.
Larger voltage changes (pre-fault vs. post-fault) will be recorded in the result le for the corre-
sponding terminal.
Contingencies
The Contingencies section of the Basic Data tab, as shown in Figure 28.4.2, allows the display, creation
and removal of contingencies. These are the contingencies that will be analyzed by the contingency
analysis command.
Figure 28.4.2: Contingencies Section of Contingency Analysis Dialogue
Show Displays a list of all dened contingencies.
Add Cases/Groups This button is used to create the contingency cases (ComOutage objects)
based on fault cases and/or fault groups. A fault case contains events: one for the fault location,
and (optionally) others specifying post-fault actions. Fault groups contain a set of references to
fault cases. In order to use the Add Cases/Groups option, the fault cases and/or groups must
have been previously dened in the Operational Library. If these have been dened, when the
Add Cases/Groups button is pressed, a data browser listing the available fault cases/groups
pops up. The user can then select the desired fault cases/groups from this browser and press
Ok. The corresponding contingencies are then created automatically by PowerFactory. One con-
tingency is created for each selected fault case, and one contingency is created for each fault
case referred to within each selected fault group. For further information on creating contingen-
cies from fault cases/groups, please refer to Section 28.6 (Creating Contingency Cases Using
Fault Cases and Groups).
Remove All Removes all contingency cases (ComOutage objects) stored in the contingency
analysis command.
Results for AC/DC
Depending on the calculation method selected, the reference to the corresponding result le object
(ElmRes) is dened. If, for example, the calculation method DC Load Flow + AC Load Flow for Critical
Cases is selected, two result le objects will be referenced (one for AC calculations and another for DC
calculations). The results stored in this le are ltered according to the global threshold set in the Limits
for Recording section of the Basic Data tab, and also according to the individual limits dened within
each components respective dialogue (such as on the Load Flow page of the elements own dialogue).
For further information on result objects, please refer to Chapter 11 Study Cases, Section 11.11 (Results
Objects).
DIgSILENT PowerFactory 15, User Manual 619
CHAPTER 28. CONTINGENCY ANALYSIS
28.4.2 Effectiveness
The Effectiveness page of the contingency analysis command (Figure 28.4.3), allows the display, addi-
tion and removal of quad boosters and generators in order to calculate their effectiveness.
Figure 28.4.3: Effectiveness Options Settings of the Contingency Analysis Command
Calculate Quad Booster Effectiveness
Show QBs Shows a list of the transformers for which the effectiveness should be calculated.
Add QBs Adds references to transformers for which the effectiveness should be calculated. Only
transformers where the additional voltage per tap is different to 0 and multiples of 180 degrees
will be listed (Load Flow page of the transformer type (TypTr2) Phase of du parameter).
Remove All Removes all references to transformers for which the effectiveness is currently cal-
culated.
Calculate Generator Effectiveness
Show Gen. Shows a list of the generators for which the effectiveness should be calculated.
Add Gen. Adds references to transformers for which the effectiveness should be calculated.
Remove All Removes all references to generators for which the effectiveness is currently calcu-
lated.
28.4.3 Multiple Time Phases
The Multiple Time Phases tab, as shown in Figure 28.4.4, allows the selection of the contingency
method to be performed as well as the corresponding settings.
620 DIgSILENT PowerFactory 15, User Manual
28.4. THE SINGLE TIME PHASE CONTINGENCY ANALYSIS COMMAND
Figure 28.4.4: Multiple Time Phases Option Settings of the Contingency Analysis Command
Method
Single Time Phase Performs the contingency analysis for a single time phase.
Multiple Time Phase Performs the contingency analysis for multiple time phases, allowing the
denition of post-fault actions.
Base Case versus Contingency Load Flow
Use same settings Uses the settings from the base case load ow for the contingency case load
ow.
Allowdifferent settings Allows different settings for the base case load ow and the contingency
case load ow.
Calculation Settings
Base Case Load Flow Only available when option Allow different settings is selected in the Base
Case versus Contingency Load Flow section of the Multiple Time Phases tab. This is a reference
to the load ow command used to calculate the network operational point before the simulation of
contingencies. The settings of this load ow command can be edited by pressing the button.
Contingency Load Flow Only available when option Allow different settings is selected in the
Base Case versus Contingency Load Flow section of the Advanced Options tab. This is a ref-
erence to the load ow command used to assess the network in contingency situations. It is
characterized by the Post Contingency Time, which is dened in the Post Contingency Time
eld, also located in the Calculation Settings section of the dialogue. The contingency load ow
command referred to by the Contingency Load Flow is always stored inside the contingency anal-
ysis command itself. The settings of this load ow command can be edited by pressing the
button. The Contingency Load Flow command settings can be set to those of the currently used
by the Base Case Load Flow command by pressing the button.
Note: If no Contingency Load Flow command is dened, the Base Case Load Flow command is used
to asses the network under contingency situations. In this case the action of automatic transformer
tap changers and switchable shunt compensators is directly considered (provided that the corre-
sponding options are selected in the Basic Options page of the assigned load ow command).
DIgSILENT PowerFactory 15, User Manual 621
CHAPTER 28. CONTINGENCY ANALYSIS
Consider Specic Time Phase Only available when option Use same settings is selected in the
Base Case versus Contingency Load Flow section. This option must be enabled to dene a post
contingency time.
Post Contingency Time (End of Time Phase) This value denes the time phase of the contin-
gencies. This means that all switch-open events with an event time less than or equal to this are
considered in the contingency.
28.4.4 Time Sweep
The Time Sweep settings shown in Figure 28.4.5 allow the automatic modication of the date and time
of the active Study Case according to a list predened by the user. The advantage of this option is
in situations where the contingency analysis needs to be automatically performed taking into account
different system conditions such as considering several load and generation proles (according to the
hour of the day).
Figure 28.4.5: Time Sweep Option Setting of the Contingency Analysis Command
Note: When enabled, the Time Sweep will automatically change the Date and Time of the active Study
Case. However, in order for the Study Case to activate the corresponding scenario automatically,
a Scenario Scheduler (IntScensched) object needs to rst be created and afterwards activated.
Once the execution of the contingency analysis has nished, the Study Case date and time is
restored to its original setting. For more information on the Scenario Scheduler please refer to
Chapter 14(Operation Scenarios)
To add study times to the list, rst enable the Calculate Time Sweep option, then right-click anywhere in
the table and select Insert Rows (alternatively select Append Rows or Append n Rows). To modify the
date and time, double-click on the corresponding Study Time cell. Additionally, the user has the option
to ignore previously dened Study Times by enabling the Ignore ag. This ensures that the contingency
analysis will not take into account the ignored Study Times in the calculation.
622 DIgSILENT PowerFactory 15, User Manual
28.4. THE SINGLE TIME PHASE CONTINGENCY ANALYSIS COMMAND
28.4.5 Advanced Options
Handling of busbar fault
Open both local and remote breakers For a bus fault, not only all local breakers which are
directly connected to this bus, but also relevant remote breakers will be opened to isolate this bus
and isolate the connected branches. Open local breakers only Only the local breakers, which
are directly connected to this bus will be opened to isolate this fault..
Restricted Recording of Contingencies Results
Do not record contingency result if base case is above. . . If in the pre-fault load ow elements
have loadings above this value, then they are not recorded in the results.
Output per Contingency Case
Short Displays only the number of iterations required for each contingency case.
Detailed Displays the full load ow output per contingency case.
Consider Predened Switching Rules of Substations If this option is selected, predened
switching rules which describe switching actions for different fault locations will be considered.
For more information on Switching Rules, please refer to Chapter 9, Section 9.2.6.
Criteria for AC Recalculation of Critical DC Cases If the calculation method DC Load Flow +
AC Load Flow for Critical Cases is selected, the recalculation of critical DC cases using the AC
load ow method is performed whenever:
1. The maximum loading of a component is greater than or equal to the rst value specied; for
example 100% (parameter name: maxLoadAbs); or
2. The maximum loading of a component is greater than or equal to the second value specied; for
example 80% (parameter name: maxLoad) and the maximum relative change of loading com-
pared to the base case is equal to or greater than the value specied; for example 5% (parameter
name: stepLoad).
In addition to these settings, if required, the user can dene a set of components to be ignored
in the AC recalculation or to ignore components if they are already overloaded in the base case.
This set of components is assigned via the Components to be ignored eld.
DIgSILENT PowerFactory 15, User Manual 623
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.4.6: Advanced Options Settings of the Contingency Analysis Command
28.4.6 Parallel Computing
There are two types of settings associated with the Parallel Computing option. The rst and more
general group of settings are the ones related to the management of the parallel computation function
(computing method and the assignments of slaves). To access and modify these settings; log-on rst as
an administrator and afterwards open a Data Manager window. Locate and edit the Parallel Computing
Manager (\System\Conguration \Parallel Computation \) as indicated in Figure 28.4.7.
The users can however dene their own settings by creating a system folder (with key Parallel) under
the folder \\Conguration and then creating the setting object ComParalman. This can only be carried
out when logged on as administrator.
The available options are:
Master Host Name or IP Refers to the machine name or IP address of the master host. If a local
multi-core machine is used, the name localhost can be used.
Parallel Computing Method
1. Local Machine with Multi Cores/Processors: All the slaves will be started in the local machine.
2. Local Machine Plus Remote Machines: The slaves will be started in both the local and remote
machines.
Number of Slaves Denes the number of slaves that will be started in the local machine. This
number should not be greater than the number of cores available in the local machine.
624 DIgSILENT PowerFactory 15, User Manual
28.4. THE SINGLE TIME PHASE CONTINGENCY ANALYSIS COMMAND
Computer Group Species the link to a computer group (number of remote machines) which will
be used for parallel computing.
Figure 28.4.7: Parallel Computing Manager
The second group of settings are the ones related to the execution of the contingency analysis; and
which are located in the Parallel Computing page of the contingency analysis command (Figure 28.4.8).
Enable Parallel Contingency Analysis for AC, DC or Time Sweep If the corresponding option
is enabled, the contingencies will be calculated in parallel; otherwise the contingency analysis is
executed in its default mode (i.e. sequential calculation).
Minimum Number of Contingencies The parallel contingency analysis will be started only if the
number of contingencies is greater than this setting.
Package Size for Optimized Method and Package Size for Standard Method The master
distributes the contingencies to slaves per package. The package size indicates how many con-
tingencies will be calculated by a slave each time. The contingencies can be calculated using
either optimized method or standard method. As the standard method is much slower than opti-
mized method, the package size of the standard method should be smaller than that used for the
optimized method to balance the calculation.
DIgSILENT PowerFactory 15, User Manual 625
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.4.8: Parallel Computing Settings of the Contingency Analysis Command
28.4.7 Calculating an Individual Contingency
To calculate an individual contingency, click on the Show button in the contingency analysis command
dialogue (see Figure 28.4.2) to open the list of contingencies included in the analysis. From here the
user can right-click on a contingency of interest, and select Execute from the context sensitive menu.
Additionally, the corresponding element can be marked in the single line graphic by right-clicking on the
contingency object in the list and selecting Mark in Graphic from the context sensitive menu.
28.4.8 Representing Contingency Situations
Contingency Cases
Contingency cases (ComOutage objects) are objects used in PowerFactory to dene contingency sit-
uations within the analyzed networks. A contingency case determines which components are put on
outage. When a contingency analysis (ComSimoutage) is executed, the contingency analysis com-
mand considers each of the contingency cases stored inside it, taking the corresponding components
out of service and performing a contingency load ow.
As mentioned previously, the contingency cases used by a specic contingency analysis command are
stored inside the command itself. Contingency cases are created either by using Fault Cases and/or
Fault Groups (see Section 28.6), or via the Contingency Denition command ( , see Section 28.7).
Once the contingencies have been dened in the contingency command, the cases can be viewed
by using the Show button available in the dialogue (see Figure 28.4.2). Additionally, the contingency
cases within the active study cases contingency analysis command may be viewed by clicking on
the Show Contingencies icon ( ), located on the main toolbar (only available when the Contingency
Analysis toolbar is selected). In both cases a new data browser showing the dened contingencies
is opened, with the contingencies listed inside. By double-clicking on a contingency from the list, the
corresponding dialogue for that particular contingency is opened (as illustrated in Figure 28.4.9). The
dialogue displayed in Figure 28.4.9 shows the following elds:
Name Name of the contingency case.
Not Analyzed If enabled, the case is not considered by the contingency analysis command.
Number An identication number given to the contingency and which is stored in the results.
This number can be used for reporting purposes.
626 DIgSILENT PowerFactory 15, User Manual
28.4. THE SINGLE TIME PHASE CONTINGENCY ANALYSIS COMMAND
Fault Case Reference to the fault case (if any) from where the contingency case originated.
Fault Group Reference to the fault group (if any) from where the contingency case originated.
This eld is only available if the contingency case has an associated fault group.
Events Used for this Contingency (Multiple Time Phase only) As showed in gure 28.4.10,
the user can specify wether to generate the events based on the fault case denition (automati-
cally), or to use locally dened events. If the user chooses to use locally dened events, then the
ComOutage object which denes the contingency (located in contingency command of the study
case) can be modied independently.
Interrupted Components This is a table showing the components put on outage by the contin-
gency case. The table, which is read-only, is automatically generated when the contingency case
is created.
Fault Type Displays the fault type and the contingency order. See Figure 28.6.1.
Contingency Analysis Reference to the contingency analysis command where the contingency
case is stored.
The Mark in Graphic button highlights the interrupted components in the single line diagram.
Figure 28.4.9: Contingency Cases (ComOutage objects)
DIgSILENT PowerFactory 15, User Manual 627
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.4.10: Contingency Cases (ComOutage objects for Multiple Time Phase)
Normally, contingency cases (ComOutage objects) are analyzed by the contingency analysis command
(ComSimoutage) in which they are stored. However, each contingency case provides the functionality
of a command itself, and can be executed individually using the Execute button at the top right of the
ComOutage dialogue. In this case the actions taken by the circuit breakers, which must switch to clear
the fault, are shown in the single line graphic (only if the contingency case was created using fault
cases/groups).
Note: The Interrupted Components table is updated by the program each time the contingency anal-
ysis is executed.
For further information on contingency cases generated using fault cases and/or fault groups, please
refer to Section 28.6 (Creating Contingency Cases Using Fault Cases and Groups). For information
on contingency cases created using the Contingency Denition (ComNmink) command, please refer to
Section 28.7 (Creating Contingency Cases Using the Contingency Denition Command).
28.5 The Multiple Time Phases Contingency Analysis Command
As explained in Section 28.3 (Executing Contingency Analyses), the multiple time phases contingency
analysis is executed with the same contingency analysis command (ComSimoutage) as that used for
the single time phases contingency analysis. In the multiple time phases conguration it determines the
initial operational condition of the system via a base load ow calculation. Following this, it loops over
the dened time phases for each stored contingency (ComOutage object). Load ow calculations are
performed which consider the contingency events whose time of occurrence is earlier than, or equal to,
the Post Contingency Time, which is set in the corresponding load ow command.
As a result of the execution of the Contingency Analysis command, the steady-state operational point
of the network at the Post Contingency Time, for every contingency, is obtained. The calculated results
628 DIgSILENT PowerFactory 15, User Manual
28.5. THE MULTIPLE TIME PHASES CONTINGENCY ANALYSIS COMMAND
are ltered according to user dened criteria and recorded in the Results (ElmRes) object referred to by
the Contingency Analysis command.
When congured to perform contingency analysis with multiple time phases, the Contingency Analysis
command stores the contingencies to be analyzed within the command itself. If different settings for
the contingency load ow are stated, a folder (named Time Phases) is also stored within the command;
this folder contains the load ow commands that dene the time phases. The user may dene as many
contingencies and time phases as required, following the procedures explained in this section.
The Contingency Analysis command can be accessed via the main toolbar by clicking on the icon
(provided that the Contingency Analysis toolbar has already been selected). The following subsections
present the options available in the dialogue provided that the user has selected the Multiple Time
Phases method in the contingency command (Multiple Time Phases tab).
28.5.1 Basic Options
Calculation Method
This setting is congured as described for Single Time Phase operation. Please refer to Section 28.4.1
(Basic Options). Only AC Load Flow Calculation and DC Load Flow Calculation methods are available
(no DC Load Flow + AC Load Flow for Critical Cases).
Limits for Recording
This setting is congured as described for Single Time Phase operation. Please refer to Section 28.4.1
(Basic Options).
Contingencies
This setting is congured as described for Single Time Phase operation. Please refer to Section 28.4.1
(Basic Options).
Results for AC/DC
This setting is congured as described for Single Time Phase operation. Please refer to Section 28.4.1
(Basic Options).
28.5.2 Effectiveness
These options are only available for the Single Time Phase calculation. Please refer to Section 28.4.2
(Effectiveness).
28.5.3 Multiple Time Phases
The Multiple Time Phases tab, as shown in Figure 28.5.1, allows the selection of the contingency
method as well as its corresponding settings. Although most of the setting descriptions are similar to
those given for the Single Time Phase method, they are reviewed here.
DIgSILENT PowerFactory 15, User Manual 629
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.5.1: Multiple Time Phases Option Settings of the Contingency Analysis Command (Multiple
Time Phases Method)
Method
Single Time Phase Performs the contingency analysis for a single time phase.
Multiple Time Phase Performs the contingency analysis for a multiple time phases, allowing the
denition of post-fault actions.
Base Case versus Contingency Load Flow
Use same settings Uses the settings from the base case load ow for the contingency case load
ow.
Allowdifferent settings Allows different settings for the base case load ow and the contingency
case load ow.
Calculation Settings
Load Flow Only available when option Use same settings is selected in the Base Case versus
Contingency Load Flow section of the Advanced Options tab. This is a reference to the load ow
command used to calculate both the network operational point before the simulation of contin-
gencies, and the contingency load ow(s). The settings of this load ow command can be edited
by pressing the button.
Allow different settings Only available when option Allow different settings is selected in the
Base Case versus Contingency Load Flow section of the Advanced Options tab. This is a ref-
erence to the load ow command used to calculate the network operational point before the
simulation of contingencies. The settings of this load ow command can be edited by pressing
the button.
Time Phase n
Lists the dened time phase(s). The button next to each time phase can be used to remove the
corresponding time phase. If the option Allow different settings has been selected on the Advanced
Options tab, the Time Phase will have its corresponding load ow accessible by pressing the button
next to the dened time phase.
630 DIgSILENT PowerFactory 15, User Manual
28.5. THE MULTIPLE TIME PHASES CONTINGENCY ANALYSIS COMMAND
Add Time Phase Opens an input dialogue to dene the new time phase by entering its Post
Contingency Time. If the option Allow different settings has been selected on the Advanced
Options tab, the previous load ow settings (i.e. those with the preceding occurrence in time) will
be used for the new time phase. In the case that there is no previous time phase load ow, the
base case settings will be used for the new time phase.
Use Base Case Settings for All Copies the settings from the base case load ow to all time
phase load ows.
Post contingency time for order identication
The order of the contingencies stored inside the command is calculated according to the time dened in
this eld. Only the events (actions) taking place before this point in time are considered when calculating
the contingency order.
Note: In PowerFactory a region is dened as a set of topologically connected components. A region is
interrupted if it is energized (topologically connected to a network reference bus) before a fault and
de-energized afterwards. The order of a contingency corresponds to the number of interrupted
regions at the time of its calculation (i.e. the Post contingency time for order identication).
28.5.4 Time Sweep
This option is only available for the Single Time Phase calculation. Please refer to Section 28.4.4 (Time
Sweep).
28.5.5 Advanced Options
This setting is congured as described for Single Time Phase operation. Please refer to Section 28.4.5
(Advanced Options).
28.5.6 Parallel Computing
This option is only available for the Single Time Phase calculation. Please refer to Section 28.4.6
(Parallel Computing).
28.5.7 Dening Time Phases for Contingency Analyses
The time phases of a contingency analysis are dened in the Calculation Settings section of the Multiple
Time Phases page of the Contingency Analysis command, by specifying a Post Contingency Time for
each dened time phase. A specied Post Contingency Time denes the end of a time phase and is
used to determine which events (actions) from the analyzed contingency are considered. If the time of
occurrence of an event from a contingency occurs earlier than or equal to the Post Contingency Time,
the event will be considered in the corresponding load ow calculation.
Each dened time phase uses a corresponding load ow calculation, and by default, this is the same
load ow calculation as that used for the base case load ow. If the option Allow different settings in
the Base Case versus Contingency Load Flow section of the Multiple Time Phases page is selected,
the user can dene individual load ow commands for each time phase, as illustrated in Figure 28.5.2.
Access to each load ow command and its settings is via the button.
DIgSILENT PowerFactory 15, User Manual 631
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.5.2: Different Settings for Base Case and Contingency Load Flows
Note: Transformer tap changer controllers and switchable shunts are only considered by a time phase
if their time constants are smaller than the current Post Contingency Time. The operational ther-
mal ratings of branch elements during a contingency (if short term thermal ratings (see Sec-
tion 12.3.7) have been dened) will also depend on the duration of the contingency (i.e. the
current Post Contingency Time).
The Contingency Analysis time phases (which are essentially just load ow commands) are stored
within a folder inside the ComSimoutage command and can be accessed in several ways. One way is
by clicking on the button next to each dened time phase in the Calculation Settings section of the
Multiple Time Phases tab; by doing so, the edit dialogue of the corresponding load ow command pops
up.
Another way is through the Data Manager. After performing a contingency analysis, a contingency
command object (ComSimoutage) is created inside the current active Study Case. If the contingency
analysis was performed using the Multiple Time Phases method (with different load ow settings), then
a Time Phases folder with the corresponding time phase load ow commands will be created inside the
contingency analysis, as illustrated in Figure 28.5.3.
Figure 28.5.3: Location of the Time Phases Folder
Newtime phases can be dened in the data browser by clicking on the Add Time Phase button. Existing
time phases can be deleted using the button. Note that after several time phases have been dened,
632 DIgSILENT PowerFactory 15, User Manual
28.5. THE MULTIPLE TIME PHASES CONTINGENCY ANALYSIS COMMAND
this list is then scrollable using the up/down arrow buttons ( ) available in the dialogue.
28.5.8 Representing Contingency Situations with Post - Fault Actions
Contingency situations which include post-fault actions are represented in PowerFactory via objects
called contingencies (ComOutage, ). The contingencies are dened by a set of events which repre-
sent:
Faults on the selected components;
The switching actions carried out to isolate the faulty components; and
The post contingency actions taken in order to mitigate the subsequent voltage band problems
and/or supply interruptions.
Contingencies are created based on fault cases dened in the Operational Library. These fault cases
dene the location of the fault events, and may also dene post contingency actions taken to isolate
the fault and mitigate the effects of the outage of the component(s). Whenever a new contingency is
created, a link from the ComOutage object to the fault case is set. New contingencies can be created
in a Contingency Analysis command by clicking on the Add Cases/Groups button in the Conguration
section of the Basic Data page (see Section 28.4.1: Basic Options).
Besides the events which are transferred from the linked fault case during calculation of the contingency
case, the user has the possibility of dening additional post contingency actions in the contingency by
manually creating new events.
The contingencies calculated in a Contingency Analysis, are stored inside the command itself and
can be accessed using the Show button (see Figure 28.4.2). Alternatively, the contingencies in the
Contingency Analysis command contained in the active study case can be viewed by clicking on the
Show Contingencies icon ( ) on the main toolbar. In both cases a new data browser listing the dened
contingencies is shown. By double-clicking on a selected item from the list, the edit dialogue of the
corresponding contingency (Figure 28.4.9) pops up.
Normally, contingency cases are analyzed by the Contingency Analysis command in which they are
stored. However, each case provides the functionality of a command and can be executed individually
using the Execute button at the top right of the ComOutage dialogue (see Figure 28.4.9). In this case,
all of the time phases are executed for the selected contingency considering its associated events. The
results observed in the single line graphic correspond to those from the last time phase, including the
nal states of the network switches.
The events that dene a contingency can be displayed in a list format in a new data browser by pressing
the Events button in the fault case (IntEvt ) dialogue (as shown in Figure 28.6.3). This data browser
can be used to edit and/or delete the listed events. New events can be created by using the New
icon at the top of the opened browser window. Only four different types of events are allowed in the
contingency analysis as post-fault actions, which are:
Load Event (EvtLod)
Dispatch Event (EvtGen)
Switch Event (EvtSwitch)
Tap Event (EvtTap)
It should be noted that events created locally in the contingency object are only considered if the Co-
mOutage option Use locally dened events (User dened) is selected in the Events Used for this Con-
tingency eld.
DIgSILENT PowerFactory 15, User Manual 633
CHAPTER 28. CONTINGENCY ANALYSIS
The Start Trace button ( ) (available on the main toolbar) can be used to follow the behaviour of
the system over time. When this button is pressed, a dialogue opens allowing the user to select a
contingency. Following the selection of a contingency by the user and pressing OK, the contingency
dialogue is closed and the base case load ow is executed. The execution of the rst event(s) and all
subsequent event(s) is initiated by pressing the Next Time Step button ( ) on the main toolbar. At each
time step the load ow calculation results and the state of the network circuit breakers are displayed
in the single line graphic. It should be noted that the Next Time Step evaluates events according
to their time of occurrence, and not according to the time phases dened in the Contingency Analysis
command. After the last time event(s) have been executed, the Next Time Step button becomes inactive.
The Stop Trace button ( ) can be pressed to clear the calculation. Alternatively, the Trace button in
each ComOutage dialogue can be used to initiate the Trace for that particular contingency.
Note: The Trace functionality can be started directly from the main toolbar by pressing the Start Trace
button ( ). In this case a data browser listing all available contingencies (i.e. those stored inside
the Contingency Analysis command of the active study case) is displayed. After the user selects
the desired contingency by double-clicking on it, the Base Case load ow is executed. The sub-
sequent event(s) are then calculated using the Next Time Step button.
28.6 Creating Contingency Cases Using Fault
Cases and Groups
Contingency cases created from fault cases can be regarded as contingency situations produced in
a network as a consequence of the clearing of a fault. Fault cases without switching events (created
following the procedure described in Chapter 12: Project Library, Section 12.3.3: Fault Cases and Fault
Groups) are used to automatically generate contingency cases in the contingency analysis command,
by pressing the Add Cases button and selecting the desired objects from the data browser that pops
up.
For every selected fault case, the calculation automatically detects which circuit breakers must open in
order to clear the dened fault(s). All components which lose their connection to the network reference
bus following the switching actions that clear the fault(s), are regarded as interrupted and are subse-
quently added to the Interrupted Components table of the corresponding contingency case. In other
words, these components are put on outage by the contingency case. Depending on the fault dened
in the fault case that generates a contingency, the Fault Type eld in the contingency case dialogue
(Figure 28.6.1) is set to:
Busbar fault:
If the contingency originates from a fault on a busbar
n-k fault:
With contingency order equal to k (where k >= 0). k corresponds to the number of network
regions (sets of topologically connected components) which are disconnected during a fault, by the
switching actions performed. It should be noted that the switching actions which are considered
depend on the post contingency time used by the update (this time differs between single- and
multiple time phase analyses).
Figure 28.6.1: Fault Type Field in the Contingency Case (ComOutage) Dialogue
634 DIgSILENT PowerFactory 15, User Manual
28.6. CREATING CONTINGENCY CASES USING FAULT
CASES AND GROUPS
Note: In PowerFactory an interrupted component is a network primary element that is energized before
a fault and de-energized afterwards. A component is considered to be energized if it is topologi-
cally connected to a network reference bus. A region is dened as a set of topologically connected
components. Like components, regions can have energized, de-energized and interrupted states,
depending on their connection to a network reference bus.
Contingency cases can be created from fault cases/groups, which reside in the Operational Library, by
pressing the Add Cases/Groups button in the contingency analysis command (see Section 28.4.1 (Ba-
sic Options) and Figure 28.4.2). In the case of creating contingencies from fault group(s), a contingency
case will be generated for each fault case referred to in the selected fault group(s).
Note: The topological search algorithm used by the program to set contingency cases from fault cases
requires the explicit denition of at least one reference bus in the analyzed system. A bus is ex-
plicitly set as a reference if it has connected to it either a synchronous generator (ElmSym), or
an external network (ElmExtnet ) with the option Reference Machine enabled (available on the
elements Load Flow tab).
28.6.1 Browsing Fault Cases and Fault Groups
There are two types of subfolder inside the Faults folder in the Operational Library: Fault Cases and
Fault Groups.
Figure 28.6.2: Contents of the Faults folder in the Operational Library
In order to make a new folder of either of these types, left-click on the Faults folder icon ( ) and then
press the New Object button ( ) on the Data Manager toolbar. In the drop-down list, select whether a
new Fault Cases or Fault Groups folder should be created.
The Fault Cases folder holds every contingency (n-1, n-2, or simultaneous) dened for the system, as
described in Section 28.6.2 (Dening a Fault Case). Alternatively, several fault cases can be selected
and stored in a Fault Group, as described in Section 28.6.3 (Dening a Fault Group).
28.6.2 Dening a Fault Case
To dene a fault case for an element in the grid, select it in the single-line diagram. Then right-click and
choose one of: Dene. . . Fault CaseSingle Fault Case or Dene. . . Fault CaseMultiple Fault
DIgSILENT PowerFactory 15, User Manual 635
CHAPTER 28. CONTINGENCY ANALYSIS
Cases, n-1 (or Multiple Fault Cases, n-2) or Dene. . . Fault CaseMutually Coupled Lines/Cables,
n-k.
If Multiple Fault Cases, n-2 is selected, fault cases will be created for the simultaneous outage of every
unique combination of two elements in the selection. If the user selects Single Fault Case, a fault case
will be created for the simultaneous outage of all elements in the selection.
If Mutually Coupled Lines/Cables, n-k is selected, then fault cases will be created for the simultaneous
outage of each coupled line in the selection.
Alternatively, a lter can be used. This can be done (for example) with the help of the Edit Relevant
Objects for Calculation button ( ), to list all elements for which outages are to be dened. These
elements can then be highlighted and the user can then right-click on the highlighted selection and
choose (for example) Dene. . . Fault Case. . . . The Simulation Events/Fault dialogue opens, as
shown in Figure 28.6.3, where the user can enter the desired name of the fault case in the Name eld.
On the Advanced tab of the Basic Data page of the same dialogue, the user can create the correspond-
ing switch events, by clicking on the Create Switch Events button.
Figure 28.6.3: Creation of Fault Case (IntEvt )
Fault cases can also be dened by the Contingency Denition command, as explained in Section 28.7
(Creating Contingency Cases Using the Contingency Denition Command).
For further background on fault cases, please refer to Chapter 12: Project Library, Section 12.3.3 (Fault
Cases and Fault Groups).
28.6.3 Dening a Fault Group
To dene a fault group, left-click on the Fault Groups folder. Then click on the New Object button ( ).
A Fault Group dialogue pops up as shown in Figure 28.6.4. In this dialogue the user can specify the
name of the fault group in the Name eld, and add fault cases to this new group using the Add Cases
button. Click the Cases button to view existing cases (if any) in the fault group.
Figure 28.6.4: Creation of Fault Group (IntFaultgrp)
636 DIgSILENT PowerFactory 15, User Manual
28.7. CREATING CONTINGENCY CASES USING THE
CONTINGENCY DEFINITION COMMAND
Note: When a fault group is dened and fault cases are added to it, a reference is created to each of
these fault cases. The fault case itself resides in the Fault Cases subfolder. This means that if an
item in the fault group is deleted, only the reference to the fault case is deleted. The fault case
itself is not deleted from the Fault Cases subfolder.
28.7 Creating Contingency Cases Using the
Contingency Denition Command
The Contingency Denition command (ComNmink) is used to automatically generate contingency cases
based on selected components. It is accessible via the Contingency Analysis toolbar ( ) but using the
button. The Contingency Denition command can be used to automatically generate contingency
cases for either (i) a user-dened selection of elements; or (ii) pre-dened sets of elements. These two
approaches are now described.
To generate contingency cases for a user-dened selection of elements:
Select the components to be put on outage either by multi-selecting them in the single line graphic
or the Data Manager.
Right click on the selection and choose Calculate Contingency Analysis. . . from the context
sensitive menu. This command will create a list with references to the selected objects inside the
Contingency Denition command (ComNmink). The command dialogue shown in Figure 28.7.1
will pop up.
Select the required outage level.
Select the Creation of Contingencies option according to howthe contingencies should be handled
(see explanation of options below) and click on Execute.
To generate contingency cases for either the complete system or from pre-dened sets of elements:
Click on the icon on the main toolbar to open the command;
Select the option Whole System in the Create Cases for eld;
Select the required pre-dened set of elements (for example transformers and lines);
Select the Creation of Contingencies option according to howthe contingencies should be handled
(see explanation of options below) and click on Execute.
DIgSILENT PowerFactory 15, User Manual 637
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.7.1: Contingency Denition Dialogue (option: Generate Contingencies for Analysis)
Once the Contingency Denition command is executed, it generates the corresponding contingency
cases according to the options and elements selected. The Contingency Analysis command, which is
automatically created inside the current active Study Case is then automatically opened. The created
contingencies can be analyzed by executing this already-opened Contingency Analysis command. Note
that when a new list of contingencies is created using the Contingency Denition command, the previous
content of the contingency analysis command is overwritten.
It is also possible to open the Contingency Denition command directly from the Contingency Analysis
toolbar, without any previous selection, by clicking on the icon. In this case, contingencies for all
elements within the network (selected according to their class, as described below), can be created.
The Contingency Denition command offers the following options to generate contingency cases from
the selected objects:
Creation of Contingencies
Generate Fault Cases for Library Generates fault cases which are stored in the Operational
Library, in a folder named Faults.
Alarm Generates contingencies which are stored in the contingency analysis command, and
then opens the contingency analysis command (ComSimoutage) dialogue.
Outage Level
n-1 Creates single contingency cases for each of the selected components.
n-2 Creates contingency cases for every unique combination of two selected components.
n-k cases of mutually coupled lines/cables Creates contingency cases for every set of mutu-
ally coupled lines/cables. If for example, three lines are modelled as having a mutual coupling,
by selecting this option a fault case is created considering the simultaneous outage of the three
coupled lines.
Lines/cables
Contingency cases according to the selected outage level will be generated for all lines and cables
638 DIgSILENT PowerFactory 15, User Manual
28.8. COMPARING CONTINGENCY RESULTS
(ElmLne objects) in the system.
Transformers
Contingency cases according to the selected outage level will be generated for all transformers (ElmTr2,
ElmTr3 objects) in the system.
Generators
Contingency cases according to the selected outage level will be generated for all synchronous gener-
ators (ElmSym objects) in the system.
Series Capacitors
Contingency cases according to the selected outage level will be generated for all series capacitors
(ElmScap objects) in the system.
Series Reactors
Contingency cases according to the selected outage level will be generated for all series reactors (Elm-
Sind objects) in the system.
The selection of elements to outage in the Contingency Denition command can also be created by the
use of DPL scripts. Please refer to the ComNmink methods in the appendix DPL Reference.
Note: It is important to note the difference between contingency cases created from fault cases and
contingency cases created with the Contingency Denition command. In the former, the cases are
regarded as the outage of certain network components as a consequence of fault clearing switch-
ing actions, with the fault(s) being dened by the fault case and the switching actions automatically
calculated by the program. In the latter, the cases are regarded as contingency situations gener-
ated by the outage of a selected group of components.
28.8 Comparing Contingency Results
In order to compare contingencies in a fast and easy way, PowerFactory provides a Contingency Com-
parison function ( ). The Contingency Comparison function is only enabled if the user has previously
dened the contingency cases in the Contingency Analysis command, as explained in Sections 28.6
(Creating Contingency Cases Using Fault Cases and Groups) and 28.7 (Creating Contingency Cases
Using the Contingency Denition Command). The general handling of the Contingency Comparison
function is as follows:
1. Dene the contingency cases in the Contingency Analysis command (see Sections 28.6: Creating
Contingency Cases Using Fault Cases and Groups and 28.7: Creating Contingency Cases Using
the Contingency Denition Command).
2. Click on the Contingency Comparison button ( ). A window will pop up allowing the user to select
the required contingency cases (Figure 28.8.1). The selection can correspond to one, several, or
all contingency cases.
DIgSILENT PowerFactory 15, User Manual 639
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.8.1: Selection of Contingency Cases for Comparison
3. By clicking on the OK button, the Comparing of Results On/Off button (Figure 28.8.2) is enabled
and the selected contingency cases are automatically executed.
Figure 28.8.2: Comparing of Results Button
4. The single line graphic result boxes will display the results, based on the comparison mode and
the two compared cases. By default, the comparison is made between the Base Case and the
last selected contingency case in the list.
5. To change the comparison mode and/or the cases to be compared, click on the Edit Comparing of
Results button (Figure 28.8.2). The Compare dialogue will pop up displaying the current settings.
To change the cases to be compared, click on the black arrow pointing down ( ) and select a
different case (Figure 28.8.3).
640 DIgSILENT PowerFactory 15, User Manual
28.9. RESULT ANALYSIS
Figure 28.8.3: Selection of other Cases for Comparison
6. If the contingency analysis is dened with time phases, the compare dialogue will have the option
of selecting the time phase.
7. Once the calculation is reset (for example by either making changes in the model or by clicking on
the Reset Calculation button), the comparison mode will be disabled.
28.9 Result Analysis
28.9.1 Predened Report Formats (Tabular and ASCII Reports)
In PowerFactory the Contingency Analysis function has a special set of predened report formats that
can be launched by clicking on the Report Contingency Analysis Results button ( ), which is illustrated
in Figure 28.8.2. The Report Contingency Analysis Results button will only be enabled if the user has
previously executed the Contingency Analysis command, as explained in Section 28.3 (Executing Con-
tingency Analyses). Once the reporting of results has been launched, the dialogue window illustrated
in Figure 28.9.1 will be displayed.
DIgSILENT PowerFactory 15, User Manual 641
CHAPTER 28. CONTINGENCY ANALYSIS
Figure 28.9.1: Contingency Analysis Reports Dialogue
The following types of report can be selected:
Maximum Loadings:
Only the maximum loaded component (according to the specied loading limit) for each contin-
gency is displayed in a single list.
Loading Violations:
All overloaded components (according to the specied loading limit) for each contingency are
displayed in a single list.
Voltage Steps:
All voltage deviations of terminals (between the base case and the contingency case) for each
contingency are displayed in a single list. Reports the highest voltage deviation of terminals (be-
tween the base case and the contingency case) considering all contingencies. Any such terminal
is reported only once. Only terminals with the highest voltage deviation greater than the specied
maximum voltage step are reported.
Maximum Voltages:
Reports the greatest voltage violation of a terminal (greater than or equal to the specied voltage
limit) considering all contingencies. Any such terminal is reported only once (i.e. it is reported for
the contingency causing this violation).
Minimum Voltages:
Reports the greatest voltage violation of a terminal (less than or equal to the specied voltage
limit) considering all contingencies. Any such terminal is reported only once (i.e. it is reported for
the contingency causing this violation).
Maximum Voltage Violations:
Reports all voltage violations of a terminal (greater than or equal to the specied upper voltage
limit) considering all contingencies.
Minimum Voltage Violations:
Reports all voltage violations of a terminal (less than or equal to the specied lower voltage limit)
considering all contingencies.
642 DIgSILENT PowerFactory 15, User Manual
28.9. RESULT ANALYSIS
Loading Violations per Case:
All overloaded components (according to the specied loading limit) for each contingency are
displayed in separate lists (i.e. one list per contingency case).
Voltage Violations per Case:
All busbars with exceeding voltage (maximum or minimum) are displayed in separate lists.
Generator Effectiveness:
Generators having an effectiveness greater than or equal to the specied value (%) are displayed
in a single list.
Quad-Booster Effectiveness:
Quad-booster transformers having an effectiveness greater than or equal to the specied value
(MW/Tap) are displayed in a single list.
Non-convergent Cases:
The non-convergent cases of the contingency analysis are displayed in a list.
Figure 28.9.2: Tabular Report of Loading Violations
The tabular format (Figure 28.9.2) for reporting has the following sections:
Header:
Identies the report and its data.
Filter:
Represented as drop-down lists, allowing the selection of one item at a time or as Custom.
Table:
Matrix of rows and columns containing cells that can refer to an object and provide actions such as
Edit, Edit and Browse and Mark in Graphic. It also supports copy and paste, scroll features,
page up and down keys as well as Ctrl+Pos1, Ctrl+End and HTML view.
DIgSILENT PowerFactory 15, User Manual 643
CHAPTER 28. CONTINGENCY ANALYSIS
After being executed, the Tabular Report can be exported as HTML format or exported directly to Excel,
by using the Select icon ( ).
Although the tabular reports are already predened, the user can modify them if required (by going to
the second page of the Report Contingency Analysis Results dialogue and clicking on the blue arrow
pointing to the right of the Used Format denition).
644 DIgSILENT PowerFactory 15, User Manual
Chapter 29
Reliability Assessment
29.1 Introduction
Reliability assessment involves determining, generally using statistical methods, the total electric inter-
ruptions for loads within a power system during an operating period. The interruptions are described by
several indices that consider aspects such as:
The number of customers [N].
The connected load, normally expressed in [kW].
The duration of the interruptions, normally expressed in [h] = hours.
The amount of power interrupted, expressed in [kW].
The frequency of interruptions, normally expressed in [1/a] = per annum.
Repair times are normally expressed in [h] = hours.
Probabilities or expectancies are expressed as a fraction or as time per year ([h/a], [min/a]).
Network reliability assessment is used to calculate expected interruption frequencies and annual in-
terruptions costs, and to compare alternative network designs. Reliability analysis is an automation
and probabilistic extension of contingency evaluation. For such analysis, it is not required to pre-dene
outage events, instead the tool can automatically choose the outages to consider. The relevance of
each outage is considered using statistical data about the expected frequency and duration of out-
ages according to component type. The effect of each outage is analyzed automatically such that the
software simulates the protection system and the network operators actions to re-supply interrupted
customers. Because statistical data regarding the frequency of such events is available, the results can
be formulated in probabilistic terms.
Note: Reliability assessment tools are commonly used to quantify the impact of power system equip-
ment outages in economic terms. The results of a reliability assessment study may be used to
justify investment in network upgrades such as new remote control switches, new lines / trans-
formers, or to assess the performance of under voltage load shedding schemes.
This chapter deals with probabilistic Network Reliability Assessment. For information on PowerFactorys
deterministic Contingency Analysis, refer to Chapter 28 (Contingency Analysis).
The reliability assessment functions can be accessed by selecting Reliability toolbar from the Change
Toolbox icon ( ) as illustrated in Figure 29.1.1.
DIgSILENT PowerFactory 15, User Manual 645
CHAPTER 29. RELIABILITY ASSESSMENT
Figure 29.1.1: Reliability Toolbar Selection
The optimal power restoration functions can be accessed by activating the optimal power restoration
toolbar using the icon on the toolbar selection control as illustrated in Figure 29.1.2
Figure 29.1.2: Optimal Power Restoration Selection
The basic user procedure for completing a reliability assessment consists of the following steps as
shown in Figure 29.1.3. Steps on the left are compulsory, while steps on the right are optional and can
be used to increase the detail of the calculation.
646 DIgSILENT PowerFactory 15, User Manual
29.2. PROBABILISTIC RELIABILITY ASSESSMENT
TECHNICAL BACKGROUND
Figure 29.1.3: Reliability Assessment User Procedure
These procedures are explained in detail in the following sections.
29.2 Probabilistic Reliability Assessment
Technical Background
The Reliability Assessment procedure considers the network topology, protection systems, constraints
and stochastic failure and repair models to generate reliability indices. The technical background of the
procedure and Stochastic Models is described in this section.
Note: A quantity is said to be stochastic when it has a random probability distribution. A simple ex-
ample of a stochastic quantity is the expected repair duration for an item of equipment, which is
based on the total number of repairs and repair duration. This measured data can be used to build
Stochastic Models, and perform analysis using statistical calculation methods.
DIgSILENT PowerFactory 15, User Manual 647
CHAPTER 29. RELIABILITY ASSESSMENT
29.2.1 Reliability Assessment Procedure
The generation of reliability indices, using the Reliability Assessment tool also known as reliability
analysis, consists of the following:
Failure modelling.
Load modelling.
System state creation.
Failure Effect Analysis (FEA).
Statistical analysis.
Reporting.
Figure 29.2.1: Reliability Analysis: Basic Flow Diagram
The reliability analysis calculation ow diagram is depicted in Figure 29.2.1. The failure models describe
how system components can fail, how often they might fail and how long it takes to repair them when
they fail. The load models can consist of a few possible load demands, or can be based on a user-
dened load forecast and growth scenarios.
The combination of one or more simultaneous faults and a specic load condition is called a system
state. Internally, PowerFactory s system state generation engine uses the failure models and load
models to build a list of relevant system states. Subsequently, the Failure Effect Analysis (FEA) module
analyzes the faulted system states by simulating the system reactions to these faults. The FEA takes
the power system through a number of post-fault operational states that can include:
Fault clearance by tripping of protection breakers or fuses.
Fault separation by opening separating switches.
Power restoration by closing normally open switches.
Overload alleviation by load transfer and load shedding.
Voltage constraint alleviation by load shedding (only available when Distribution is selected within
the reliability command Basic Options).
648 DIgSILENT PowerFactory 15, User Manual
29.2. PROBABILISTIC RELIABILITY ASSESSMENT
TECHNICAL BACKGROUND
The objective of the FEA function is to determine if system faults will lead to load interruptions and if so,
which loads will be interrupted and for how long.
The results of the FEA are combined with the data that is provided by the system state generation mod-
ule to create the reliability statistics including indices such as SAIFI, SAIDI and CAIFI. The system state
data describes the expected frequency of occurrence of the system state and its expected duration.
However, the duration of these system states should not be confused with the interruption duration. For
example, a system state for a line outage, perhaps caused by a short-circuit on that line, will have a
duration equal to the time needed to repair that line. However, if the line is one of two parallel lines then
it is possible that no loads will be interrupted because the parallel line might be able to supply the full
load current.
Even if the loads are interrupted by the outage, the power could be restored by network recongura-
tion - by fault separation and closing a back-feed switch. The interruption duration will then equal the
restoration time, and not the repair duration (equivalent to the system state duration).
29.2.2 Stochastic Models
A stochastic reliability model is a statistical representation of the failure rate and repair duration time
for a power system component. For example, a line might suffer an outage due to a short-circuit. After
the outage, repair will begin and the line will be put into service again after a successful repair. If two
states for line A are dened as in service and under repair, monitoring of the line could result in a time
sequence of outages and repairs as depicted in Figure 29.2.2.
Figure 29.2.2: Line availability states are described by the status of the line (in service or under repair).
Each of these states lasts for a certain time.
Line A in this example fails at time T1 after which it is repaired and put back into service at T2. It fails
again at T3, is repaired again, etc. The repair durations are also called the Time To Repair or TTR.
The service durations S
1
= T
1
, S
2
= T
3
T
2
, etc. are called the life-time, Time To Failure or TTF.
Both the TTR and the TTF are stochastic quantities. By gathering failure data about a large group of
similar components in the power system, statistical information about the TTR and TTF, such as the
mean value and the standard deviation, can be calculated. The statistical information is then used to
dene a Stochastic Model.
There are many ways in which to dene a Stochastic Model. The so-called homogenous Markov-model
is a highly simplied but generally used model. A homogenous Markov model with two states is dened
by:
A constant failure rate ; and
A constant repair rate .
These two parameters can be used to calculate the following quantities:
mean time to failure, TTF = 1/;
mean time to repair, TTR = 1/;
DIgSILENT PowerFactory 15, User Manual 649
CHAPTER 29. RELIABILITY ASSESSMENT
availability, P = TTF/(TTF+TTR);
unavailability Q, = TTR/(TTF+TTR);
The availability is the fraction of time when the component is in service; the unavailability is the fraction
of time when it is in repair; and P+Q = 1.0.
Reminder: TTR is the Time To Repair, and TTF is the Time To Failure.
Example
If 7500 monitored transformers were to show 140 failures over 10 years, during which a total of 7360
hours was spent on repair, then:
=
140
10 7500
1
a
= 0, 00187
1
a
(29.1)
TTF =
1
= 536a (29.2)
TTR =
7360
140
h = 52, 6h = 0, 006a (29.3)
=
1
TTR
= 167
1
a
(29.4)
P =
536
536 + 0, 006
= 0, 999989 (29.5)
Q =
0, 006
536 + 0, 006
= 6
min
a
(29.6)
i.e. the expected outage duration is 6 minutes per annum.
29.2.3 Calculated Results for Reliability Assessment
The network reliability assessment produces two types of indices:
Load point indices.
System indices.
These indices are separated into frequency/expectancy indices and energy indices. Furthermore, there
are indices to describe the interruption costs.
Load point indices are calculated for each load (ElmLod), and are used in the calculation of many
system indices. This section describes the simplied equations for the reliability indices. However,
note that the PowerFactory reliability assessment calculations use more complex calculation methods.
Nevertheless, the simplied equations shown here can be used for hand calculations or to gain insight
into the reliability assessment results.
650 DIgSILENT PowerFactory 15, User Manual
29.2. PROBABILISTIC RELIABILITY ASSESSMENT
TECHNICAL BACKGROUND
29.2.3.1 Parameter Denitions
In the denitions for the reliability indices, the following parameters are used:
C
i
The number of customers supplied by load point i
A
i
The number of affected customers for an interruption at load point i
Fr
k
The frequency of occurrence of contingency k
pr
k
The probability of occurrence of contingency k
C The number of customers
A The number of affected customers
L
m
The total connected kVA interrupted, for each interruption event, m
r
m
Duration of each interruption event, m
L
T
The total connected kVA supplied
Pc
i
Contracted active power at load point i
29.2.3.2 Load Point Frequency and Expectancy Indices
ACIF: Average Customer Interruption Frequency
ACIT: Average Customer Interruption Time
LPIF: Load Point Interruption Frequency
LPIT: Load Point Interruption Time
LPIC: Load Point Interruption Costs
AID: Average Interruption Duration
TCIF: Total Customer Interruption Frequency
TCIT: Total Customer Interruption Time
TPCONTIF: Total Contracted power Interruption Frequency
TPCONTIT: Total Contracted power Interruption Time
These indices are dened as follows:
ACIF
i
=
k
Fr
k
frac
i,k
Unit : 1/a (29.7)
ACIT
i
=
k
8760 Pr
k
frac
i,k
Unit : h/a (29.8)
LPIF
i
=
k
Fr
k
Unit : 1/a (29.9)
LPIT
i
=
k
8760 Pr
k
Unit : h/a (29.10)
AID
i
=
ACIT
i
ACIF
i
(29.11)
TCIF
i
= ACIF
i
C
i
Unit : C/a (29.12)
DIgSILENT PowerFactory 15, User Manual 651
CHAPTER 29. RELIABILITY ASSESSMENT
TCIT
i
= ACIT
i
C
i
Unit : Ch/a (29.13)
TPCONTIF
i
=
k
Fr
k
frac
i,k
Pc
i
Unit : MW/a (29.14)
TPCONTIT
i
=
k
8760 Pr
k
frac
i,k
Pc
i
Unit : MWh/a (29.15)
where
i is the load point index, k is the contingency index, and frac i,k is the fraction of the load which is lost at
load point i, for contingency k. For unsupplied loads, or for loads that are shed completely, frac i,k=1.0.
For loads that are partially shed, 0.0 <= frac i,k < 1.0.
29.2.3.3 System Indices
SAIFI System Average Interruption Frequency Index, in units of [1/C/a], indicates how often the average
customer experiences a sustained interruption during the period specied in the calculation.
SAIFI P Average Interruption Frequency (Contracted Power), in units of [1/a], indicates how often there
are contracted power interruptions during the period of the calculation.
CAIFI Customer Average Interruption Frequency Index, in units of [1/A/a], is the mean frequency of
sustained interruptions for those customers experiencing sustained interruptions. Each customer
is counted once regardless of the number of times interrupted for this calculation.
ASIFI Average System Interruption Frequency Index, in units of [1/a], The calculation of this index
is based on load rather than customers affected. ASIFI can be used to measure distribution
performance in areas that supply relatively few customers having relatively large concentrations
of load, predominantly industrial/commercial customers
SAIDI System Average Interruption Duration Index, in units of [h/C/a], indicates the total duration of
interruption for the average customer during the period in the calculation. It is commonly measured
in customer minutes or customer hours of interruption.
SAIDI P Average Interruption Duration (Contracted Power), in units of [h/a], indicates the total duration
of contracted power interruptions during the period of the calculation.
CAIDI Customer Average Interruption Duration Index, in units of [h], is the mean time to restore service.
ASIDI Average System Interruption Duration Index, in units of [h/a], is the equivalent of SAIDI but based
on load, rather than customers affected.
ASAI Average Service Availability Index, this represents the fraction of time that a customer is con-
nected during the dened calculation period.
ASUI Average Service Unavailability Index, is the probability of having all loads supplied.
MAIFI Momentary Average Interruption Frequency Index, in units of [1/Ca], evaluates the average fre-
quency of momentary interruptions. The calculation is described in the IEEE Standard 1366 IEEE
Guide for Electric Power Distribution Reliability Indices.
652 DIgSILENT PowerFactory 15, User Manual
29.2. PROBABILISTIC RELIABILITY ASSESSMENT
TECHNICAL BACKGROUND
SAIFI =
ACIF
i
C
i
C
i
Unit : 1/C/a (29.16)
SAIFI P =
TPCONTIF
i
PCONTRACT
i
Unit : 1/a (29.17)
CAIFI =
ACIF
i
C
i
A
i
Unit : 1/A/a (29.18)
SAIDI =
ACIT
i
C
i
C
i
Unit : h/C/a (29.19)
SAIDI P =
TPCONTIT
i
PCONTRACT
i
Unit : h/a (29.20)
CAIDI =
SAIDI
SAIFI
Unit : h (29.21)
ASUI =
ACIT
i
C
i
8760
C
i
(29.22)
ASAI = 1 ASUI (29.23)
ASIDI =
(r
m
L
m
)
L
T
Unith/a (29.24)
ASIFI =
L
m
L
T
Unit1/a (29.25)
MAIFI =
IM
i
N
mi
N
i
(29.26)
29.2.3.4 Load Point Energy Indices
LPENS: Load Point Energy Not Supplied
LPES: Load Point Energy Shed
DIgSILENT PowerFactory 15, User Manual 653
CHAPTER 29. RELIABILITY ASSESSMENT
These indices are dened as follows:
LPENS
i
= ACIT
i
(
Pd
i
+
Ps
i
) in MWh/a (29.27)
LPES
i
= ACIT
i
Ps
i
in MWh/a (29.28)
Where
Pd
i
is the weighted average amount of power disconnected
Ps
i
is the weighted average amount of power shed at load point i.
29.2.3.5 System Energy Indices
ENS Energy Not Supplied, in units of [MWh/a], is the total amount of energy on average not delivered
to the system loads.
SES System Energy Shed, in units of [MWh/a], is the total amount of energy on average expected to
be shed in the system.
AENS Average Energy Not Supplied, in units of [MWh/Ca], is the average amount of energy not sup-
plied, for all customers.
ACCI Average Customer Curtailment Index, in units of [MWh/Ca], is the average amount of energy not
supplied, for all affected customers.
ENS =
LPENS
i
in MWh/a (29.29)
SES =
LPES
i
in MWh/a (29.30)
AENS =
ENS
C
i
in MWh/Ca (29.31)
ACCI =
ENS
A
i
in MWh/Ca (29.32)
29.2.3.6 Load Point Interruption Cost
LPEIC is dened as
LPEIC
i
=
LPEIC
i,k
in $/a (29.33)
where
654 DIgSILENT PowerFactory 15, User Manual
29.2. PROBABILISTIC RELIABILITY ASSESSMENT
TECHNICAL BACKGROUND
LPEIC
i,k
is the average interruption cost for load point i and contingency case k, considering the load point
interruption costs function and the assessed distribution of the durations of the interruptions at
this load point for contingency case k. The interruption costs are calculated differently for different
cost functions. All cost functions express the costs as a function of the interruption duration. For
cost functions expressed in money per interrupted customer, the number of interrupted customers
is estimated for each interruption as the highest number of customers interrupted at any time
during the whole interruption duration.
29.2.3.7 System Interruption Costs
EIC Expected Interruption Cost, in units of [M$/y], is the total expected interruption cost.
IEAR Interrupted Energy Assessment Rate, in units of [$/kWh], is the total expected interruption cost
per not supplied kWh.
EIC =
LPEIC
i
in M$/a (29.34)
IEAR =
EIC
ENS
in $/kWh (29.35)
Additional Calculated Indices for Load Points
AID: Average Interruption Duration [h]
Additional Calculated Indices for Busbars/Terminals
AID: Average Interruption Duration [h]
AIF: Yearly Interruption Frequency [1/y]
AIT Yearly Interruption Time [h/y]
29.2.4 System State Enumeration in Reliability Assessment
In PowerFactory , Reliability Assessment uses a System State Enumeration to analyze all possible sys-
tem states, one by one. A fast topological method is used which ensures that each possible system
state is only analyzed once. State frequencies (average occurrences per year) are calculated by consid-
ering only the transitions from a healthy situation to an unhealthy one and back again. This is important
because the individual system states are analyzed one by one, and the (chronological) connection
between them is therefore lost.
The enumerated calculation method is fast for quick investigation of large distribution networks, but does
not compromise accuracy. Exact analytic averages are calculated. Distributions of reliability indices,
however, cannot be calculated. For example, the average annual unavailability in hours/year can be
calculated, but the probability that this unavailability is less than 15 minutes for a certain year cannot be
calculated.
The state enumeration algorithm can include independent failures, simultaneous (n-2) failures, common
mode failures, numerous load states and planned outages.
DIgSILENT PowerFactory 15, User Manual 655
CHAPTER 29. RELIABILITY ASSESSMENT
An overview ow diagram for the reliability assessment by state enumeration is shown in Figure 29.2.3.
Figure 29.2.3: Overview Flow Diagram for Reliability Assessment by State Enumeration
After the State Enumeration is complete, each simulated system state can be viewed using the tracing
tool on the Reliability Toolbar, see Section 29.4.2 for more information.
29.2.5 Failure Effect Analysis in Reliability Assessment
The simulation of the system response to specic contingencies (ComContingency) is called Failure
Effect Analysis (FEA). The System State Enumeration algorithm uses the FEA engine to analyze the
following steps after a contingency:
Fault Clearance;
Fault Isolation;
Power Restoration;
Overload Alleviation;
Voltage Constraint Alleviation;
656 DIgSILENT PowerFactory 15, User Manual
29.2. PROBABILISTIC RELIABILITY ASSESSMENT
TECHNICAL BACKGROUND
Load Transfer;
Load Shedding;
FEA analysis for the network assessment can consider or ignore constraints. For overload alleviation,
the algorithm uses an AC load ow to search for overloaded branches and if any are identied then it
attempts to resolve them, rstly by load transfer and secondly by load shedding. If constraints are not
considered by the FEA, then a load-ow for each state is not required and consequently the simulation
is much faster.
For every simulated failure, a contingency is created by the FEA algorithm. If the calculation uses load
characteristics, a contingency is created for every combination of failure and load state. Likewise, when
maintenance (planned outages) are considered, there are more states for each outage and contingency
combination.
Fault Clearance
The fault clearance step of the FEA assumes 100% selectivity of the protection. Therefore, it is assumed
that the relays nearest to the failure will clear the fault. If protection/switching failures are considered
in the FEA, it is assumed that the next closest protection device (after the failed device) has 100% se-
lectivity. As described in (Protection/Switch Failures), PowerFactory does not consider separate switch
and protection failures, instead these are lumped together. In the pre-processing phase of the reliability
assessment, all breakers in the system that can be tripped by a relay, or fuse are marked as protection
breakers.
To clear the fault, the FEA starts a topological search from the faulted component/s to identify the closest
protection breaker/s that can clear the fault. These breaker/s are then opened to end the fault clearance
phase of the FEA. If it is not possible to isolate the fault because there are no appropriate protection
breakers, then an error message will be printed and the reliability assessment will end.
Fault Isolation
The next step of the FEA is to attempt to restore power to healthy network sections. It does this by
separating the faulted section from the healthy section by opening sectionalizing switches.
The fault separation procedure uses the same topological search for switches as the fault clearance
phase. The fault separation phase starts a topological search from the faulted components to identify
the closest switches that will isolate the fault. These switches are subsequently opened. Note, all
closed switches can be used to separate the faulted area. The area that is enclosed by the identied
fault separation switches is called the separated area. The separated area is smaller than, or equal to,
the protected area. It will never extend beyond the protected area.
The healthy section which is inside the protected area, but outside of the separated area is called the
restorable area because power can be restored to this area.
Power Restoration
The Power Restoration process of the FEA energizes the healthy areas of the system after the fault
separation process has isolated the faulted area. Note that only open switches that are enabled for use
in power restoration will be considered by PowerFactory as candidate switches for power restoration.
Additionally, PowerFactory uses a smart power restoration procedure that also considers the direction
of the power restoration and the priority (stage) of the switch. The fastest candidate switch is always
selected when there is more than one restoration alternative. Each restorable area that is reconnected
to the supplied network is called a restored area. For more information about the switch conguration
for smart power restoration, see Section 29.3.3.
If switching actions are not possible in order to return loads and terminals in a separated area to service,
then these loads and terminals will remain interrupted for the mean duration of the repair, which is
normally several hours. However, if switching actions are possible to return the loads and terminals
to service, they will only be interrupted for the time needed to open all separators and to close all
DIgSILENT PowerFactory 15, User Manual 657
CHAPTER 29. RELIABILITY ASSESSMENT
power restoration switches. The effects of network upgrades, including improved automation and remote
control of switches (by lowering switch actuation times), can be analyzed.
An Optimal Power Restoration can also be conducted for a single contingency from outside the reliability
calculation through the Optimal Power Restoration command shown in Figure 29.1.2, or by right-clicking
an element and selecting Calculate Optimal Power Restoration.
Overload Alleviation
If the power restoration does not cause any thermal overloads or voltage violations (if applicable), then
the FEA can proceed to calculate the statistics for that state and then analyze the next state. However,
if thermal constraints are enabled, then PowerFactory will complete load-ows to check that all compo-
nents are still within their thermal capability after the power restoration is complete. If necessary, load
transferring, partial or full load shedding might be required to alleviate the thermal over-load. Note load
transferring and partial load shedding are only considered when Transmission is selected in the Relia-
bility command Basic Options. The distribution option considers only discrete switch actions. Therefore,
loads must be fully shed or remain in service.
Voltage Constraint Alleviation (Distribution Option only)
If the Distribution option is selected in Basic Options, voltage constraints for busbars/terminals and
feeders can be considered in addition to thermal constraints. The voltage constraint alleviation process
is similar to the thermal overload alleviation process, where loads will be shed if necessary to maintain
system voltages within the dened limits.
Load Transfer (Transmission Option only)
In some cases, load transfer switches and/or the alternative feeders are not included in the network
model where reliability assessment is completed. In these cases, the automatic power restoration
cannot switch an unsupplied load to an alternative supply. An example is when a (sub-)transmission
network is analyzed and the connected distribution networks are modelled as single lumped loads. In
this scenario, transfer switches that connect two distribution networks will not be visible. Therefore, the
possibility of transferring parts of the lumped load model to other feeders can be modelled by entering
a transfer percentage at each lumped load. This transfer percentage denes the portion of the lumped
load that can be transferred away from the analyzed network, without specifying to which feeder/s the
portion is transferred.
The use of the load transfer percentage (parameter name: Transferable on the load elements Reliability
tab) is only valid when load transfer is not expected to result in an overloading of the feeders which pick
up the transferred loads.
Load transfer is used in the overload alleviation prior to the calculation of power at risk (see the following
section for further information). The power at risk is considered to be zero if all overloads in the post-fault
condition can be alleviated by load transfers alone.
Load Shedding
There are three basic variations of shedding that can be used:
Optimal load shedding.
Priority optimal load shedding.
Discrete optimal load shedding.
Optimal load shedding presumes that all loads can be shed precisely (an innite number of steps).
PowerFactory attempts to nd a solution that alleviates the overload with the lowest amount of load
shed.
PowerFactory uses linear sensitivity indices to rst select those loads with any contribution to overload-
ing. A linear optimization is then started to nd the best shedding option. The resulting minimum amount
658 DIgSILENT PowerFactory 15, User Manual
29.2. PROBABILISTIC RELIABILITY ASSESSMENT
TECHNICAL BACKGROUND
of shed load is called the Power Shed, because it equals the minimum amount of load that must be
shed to alleviate overloads after the power restoration. The power shed is multiplied by the duration
of the system state to get the Energy Shed. The total energy shed for all possible system states is
reported after the reliability assessment is complete, and is referred to as the System Energy Shed
(SES).
Loads are shed automatically based on their allocated priority, with PowerFactory attempting to shed
low priority loads, prior to high priority loads wherever possible. In the transmission reliability option,
loads can be partially or fully shed, whereas in the distribution option, loads can only be fully shed.
Example
Figure 29.2.4 shows a simple network containing four loads, several circuit breakers (CB) and discon-
nectors (DS) and a back-feed switch (BF).
Figure 29.2.4: Short-Circuit on Ln4
Fault clearance
The area isolated by the fault clearance procedure is called the protected area. Figure 29.2.5 shows
the example network after the fault clearance functions have opened the protection breaker CB1. The
protected area is the area containing all switches, lines and loads between CB1 and the back-feed
switch, BF. Therefore, during the clearance of this fault, loads 1, 2, and 3 are interrupted.
Figure 29.2.5: Protected Area
Fault Isolation
DIgSILENT PowerFactory 15, User Manual 659
CHAPTER 29. RELIABILITY ASSESSMENT
Figure 29.2.6 shows the example network with the separation switches, DS2 and DS4 open. The
separated area now only contains the faulted line, Ln4. There are now two restorable areas following
the fault separation; the area which contains load 1, and the area which contains loads 2 and 3.
Figure 29.2.6: Separated Area Highlighted
Power Restoration
After the fault separation phase is complete, the following switch actions are required to restore power
to the two separate restorable areas:
Separation switch DS2 is remote-controlled and has a switching time of 3 minutes.
Power to load 1 is restored by (re)closing the protection breaker, CB1 which is also remote
controlled.
Load 1 is therefore restored in 3 minutes (=0.05 hours).
Power to load 2 and 3 is restored by closing the back-feed switch, BF.
Because the back-feed switch has a actuation time of 30 minutes, loads 2 and 3 are restored in
0.5 hours.
The network is now in the post-fault condition as illustrated in Figure 29.2.7.
Figure 29.2.7: Power Restoration by Back-Feed Switch BF1 and CB1
Overload Alleviation and Load Shedding
660 DIgSILENT PowerFactory 15, User Manual
29.3. SETTING UP THE NETWORK MODEL FOR RELIABILITY ASSESSMENT
Figure 29.2.8 shows a line overload in the post-fault condition in the example network: line Ln1 is
loaded to 113%.
Figure 29.2.8: Overloaded Post-Fault Condition
In this example, loads 1, 2, 3 and 4 all contribute to the line overload on LN1, and consequently load
would be shed based on load shedding options and priorities set by the user to alleviate the constraint.
29.3 Setting up the Network Model for Reliability Assessment
Prior to starting a Reliability Assessment Calculation, you must setup the Network Model with specic
reliability data models. This chapter discusses the following procedures:
How to Dene Stochastic Failure and Repair Models.
How to Create Feeders for Reliability Assessment.
How to Congure Switches for the Reliability Assessment.
Load Modelling for Reliability Assessment.
Considering Multiple System Demand Levels.
Dening Fault Clearance Based on Protection Device Location.
How to Consider Planned Maintenance.
Specifying Individual Component Constraints.
29.3.1 How to Dene Stochastic Failure and Repair models
Stochastic Failure models dene the probability that a component will fail and when it does fail, the mean
time to repair the component. The following Stochastic failure models are supported by PowerFactory:
Busbar/Terminal Stochastic Model.
Line/Cable Stochastic Model.
Transformer Stochastic Model.
Common Mode Stochastic Model.
DIgSILENT PowerFactory 15, User Manual 661
CHAPTER 29. RELIABILITY ASSESSMENT
Protection/Switch Failure Model.
Double Earth Fault Failure Model.
This section describes each of these Stochastic Models and the procedure for dening them.
29.3.1.1 Busbar/Terminal Stochastic Model (StoTypbar)
It is possible to dene a Stochastic Model for every busbar and terminal within the network. The
Stochastic Model can be dened either through the object type or through the object element. If you
want to use the same Stochastic Model for a number of different busbars/terminals then you should de-
ne it through the object type. Alternatively, if you want to use a Stochastic Model for only one element,
then you should dene it through the element Reliability page.
Busbar/Terminal type denition
You can use Stochastic Models dened through types and elements together as required - the element
denition always overrides the type denition.
To dene a Stochastic Model for a busbar type follow these steps:
1. Open the dialogue for the busbar type and select the Reliability tab.
2. Using the Stochastic Model selection control click the black triangle and select the option New
project type. The dialogue for the Bar Type Failures will appear.
3. Enter the failure data for the busbar and the failure data per connection. Note that the probability
of the busbar failure is the sum of these two failure frequencies. For example a busbar with 3
connections, a failure frequency for the busbar of 0.002 and a failure frequency of 0.005 per
connection will have a total probability of failure of 0.002 + 3 0.005 = 0.017.
4. Enter the mean repair duration.
5. Press OK twice to return to the element dialogue.
Busbar/Terminal element denition
To dene a Stochastic Model for a busbar element follow these steps:
1. Open the dialogue for the busbar element and navigate to the Reliability tab.
2. Using the Element model selection control click the black triangle and select the option New
project type. The dialogue for the Bar Type Failures will appear.
3. Enter the failure data and repair time data as described above for the busbar type.
4. Press OK to close the element dialogue.
Note: If you dene a stochastic element model for a busbar/terminal that also has a stochastic type
model within its corresponding type, the element model overrules the type model.
29.3.1.2 Line/Cable Stochastic Model (StoTyplne)
It is possible to dene a Stochastic Model for every line or cable within the network. The Stochastic
Model can be dened either through the object type or through the object element. If you want to use
the same Stochastic Model for a number of different lines/cables then you should dene it through the
662 DIgSILENT PowerFactory 15, User Manual
29.3. SETTING UP THE NETWORK MODEL FOR RELIABILITY ASSESSMENT
object type reliability page. Alternatively, if you want to use a Stochastic Model for only one element,
then you should dene it through the element reliability page.
Cable type denition
To dene a Stochastic Model for a line or cable type follow these steps:
1. Open the dialogue for the line type and select the Reliability tab.
2. Using the Stochastic Model selection control click the black triangle and select the option New
project type. The dialogue for the Line Type Failures will appear.
3. Enter the Sustained Failure Frequency. Note that the probability of the line failure is determined
using this value and the length of the line. For example, a 12 km line with a Sustained failure
frequency of 0.032 (1/(a km)) will have a failure probability of 12 0.032 = 0.384(1/(a)).
4. Enter the mean repair duration in hours.
5. Enter the Transient Fault Frequency. Note this parameter is used for the calculation of the MAIFI
index.
6. Press OK twice to return to the element dialogue.
Cable element denition
To dene a Stochastic Model for a line or cable element follow these steps:
1. Open the dialogue for the line element and navigate to the Reliability tab.
2. Using the element model selection control click the black triangle and select the option New
project type. The dialogue for the Line Type Failures will appear.
3. Enter the failure data and repair time data as described above for the line type.
4. Press OK to return to the element dialogue.
29.3.1.3 Transformer Stochastic Model (StoTyptrf)
It is possible to dene a Stochastic Model for every transformer within the network. The Stochastic
Model can be dened either through the object type or through the object element. If you want to use
the same Stochastic Model for a number of different transformers then you should dene it through the
object type reliability page. Alternatively, if you want to use a Stochastic Model for only one transformer
element, then you should dene it through the element reliability page.
Transformer type denition
To dene a Stochastic Model for a transformer type follow these steps:
1. Open the dialogue for the transformer type and select the Reliability tab.
2. Using the Stochastic Model selection control click the black triangle and select the option New
project type. The dialogue for the Transformer Type Failures will appear.
3. Enter the failure frequency data (1/a).
4. Enter the mean repair duration in hours.
5. Press OK twice to return to the element dialogue.
DIgSILENT PowerFactory 15, User Manual 663
CHAPTER 29. RELIABILITY ASSESSMENT
Transformer element denition
To dene a Stochastic Model for a transformer element follow these steps:
1. Open the dialogue for the transformer element and select the Reliability tab.
2. Using the element model selection control click the black triangle and select the option New
project type. The dialogue for the Transformer Type Failures will appear.
3. Enter the failure data and repair time data as described above for the transformer type.
4. Press OK to return to the element dialogue.
29.3.1.4 Common Mode Stochastic Model (StoCommon)
A common mode failure involves the simultaneous failure of two or more power system components. An
example is a distribution feeder where two lines with different voltages share the same poles. If one or
more poles fail, for example a car hits a pole, then both lines will be interrupted simultaneously: these
lines have a common failure mode. Such a failure will usually be more likely than the probability of the
two lines failing independently at the same time.
In PowerFactory , it is possible to dene a common mode failure object to consider such failures in
the reliability calculation. These Stochastic Models consider the common mode failure probability in
addition to the independent failure mode of each component within the model.
To dene a common mode failure Stochastic Model follow these steps:
1. Using the Data Manager, select the Common Mode failures folder within the Operational Library.
2. Click the New Object button ( ) to create a Stochastic Common Mode failure object (StoCom-
mon). The dialogue for the object should appear.
3. Double click in the rst empty cell of the Name column, to open an object selection browser.
4. Use the browser to nd the rst object that is part of the Common Mode failure that you are trying
to dene.
5. Click OK to return to the Common Mode Failure dialogue.
6. Add a cell below the last full cell by right-clicking within an empty area of the dialogue and selecting
the option Append Rows.
7. Repeat steps 3-6 to add more objects to the Common Mode Failure.
8. Click the Failure Data tab and enter the Sustained Failure Frequency, Mean Outage duration and
Transient Fault Frequency data.
9. Click OK to save the changes.
29.3.1.5 Protection/Switch Failures
PowerFactory can consider the failure of the protection system to clear the fault as a stochastic proba-
bility within the reliability calculation. This is enabled by entering a Probability of Failure into the switch
object. To enter this data:
1. Open the dialogue for the switch object where you want to enter the switch failure probability.
Normally switches are accessed by right clicking their containing cubicle and selecting the option
Edit Devices.
664 DIgSILENT PowerFactory 15, User Manual
29.3. SETTING UP THE NETWORK MODEL FOR RELIABILITY ASSESSMENT
2. On the Reliability tab of the switch object, enter the Fault Clearance: circuit breaker fails to open
probability in percent. For example, a 5 %failure rate means that on average 1 out of 20 attempted
fault clearance operations will fail.
Note: PowerFactory does not distinguish between a protection system failure and a switch failure. For
example, the reason that a switch fails to open could be caused by a faulty relay, a protection
mal-grading or a faulty circuit breaker. The cumulative probability of all these events should be
entered into the switch failure probability.
29.3.1.6 Double Earth Faults
A double earth fault in PowerFactory is dened as follows: a single earth fault on a component followed
by a second simultaneous earth fault on another component.
A double earth fault might occur after voltage rises on healthy phases on a feeder following a single
phase to earth fault on the feeder, causes a second phase to earth fault on the same feeder.
Double earth faults occur on lines, transformers (2 Winding and 3 Winding transformers) and busbars,
and PowerFactory supports adding the conditional probability data for double earth faults for Stochastic
Models of these components. The reliability calculation automatically generates a contingency event for
every double earth fault that meets the following conditions:
Both objects are in the same part of the network (supplied by the same transformers).
The star point of the transformers that supply that part of the network is isolated or compensated
(both star point grounded and Peterson Coil enabled).
The frequency of single earth faults of the rst object is > 0
The probability of double earth fault of the second object is > 0.
The frequency for single earth faults and the probability of the second earth fault data can be entered on
the Earth Fault page of every Stochastic Model. Follow these steps to enter data for a Line Stochastic
Model:
1. Open the Stochastic Failure Model for the line (either through the reliability page of the line type
or the line elements).
2. Select the Earth Fault page.
3. Enable the option Model Earth Faults
4. Enter the data for the frequency of single earth faults
5. Enter the data for the conditional probability of a second earth fault
6. Enter the Repair duration in hours.
7. Close the Stochastic Model.
Note: The double earth fault is a conditional probability. Therefore, the probability of one occurring in
the network is the probability of an earth fault on component A
probability of an double earth
fault on component B
DIgSILENT PowerFactory 15, User Manual 665
CHAPTER 29. RELIABILITY ASSESSMENT
29.3.2 How to Create Feeders for Reliability Calculation
When performing a reliability calculation with the Distribution option set under Basic Options, Power-
Factory requires that feeder/s have been dened in the model.
To create a feeder:
Right click on the cubicle at the head of the feeder and select the option Dene Feeder ; or
for fast creation of multiple feeders right click the bus the feeder/s are connected to and select
the option Dene Feeder. More information on feeders and feeder creation can be found in
Chapter 13: Grouping Objects, Section 13.5(Feeders).
29.3.3 Conguring Switches for the Reliability Calculation
A critical component of the Failure Effect Analysis (FEA), is the behaviour of the switches in the network
model. Switches in PowerFactory are classied into four different categories:
Circuit Breakers; Typically these are automatic and controlled by relays and through remote com-
munications. They are used for clearing faults and for closing back-feeds for power restoration.
Disconnectors; Used for isolation and power restoration.
Load-Break-Switch; Used for isolation and power restoration.
Switch Disconnector; Used for isolation and power restoration.
All switches in PowerFactory are modelled using the StaSwitch or ElmCoup objects. The switch cate-
gory (CB, disconnector etc) is selected on the basic data page of the switch. The actions that the FEA
analysis takes depends on the conguration of these switches and, optionally, the location of protection
devices.
Conguration steps
To congure a switch for reliability analysis follow these steps:
1. Open the dialogue for the switch and select the reliability page. This can be done directly by
editing switches modelled explicitly on the single line diagram, or for switches embedded within a
cubicle, by right-clicking the cubicle and selecting the option edit devices, to access the switch.
2. Select the Sectionalizing option. The following choices are available:
Remote controlled (Stage 1); This option means that the actuation time of this switch is taken
from the global remote controlled switch actuation time. The default time is 1 min but this
can be adjusted within the reliability command, see Section 29.4.1: How to run the Reliability
Assessment.Typically remote controlled switches are circuit breakers controlled by relays or
with communications from a control room.
Indicator of Short Circuit (Stage 2); This option represents a switch that has an external
indication of status on the outside of the switch enclosure. This allows the operator/technician
to easily identify the switch status and actuate the switch.
Manual (Stage 3); These switches need direct visual inspection to determine their status and
therefore take longer to actuate than either stage 1 or stage 2 switches.
3. Select the Power Restoration option. The following choices are available:
Do not use for power restoration; If this option is selected the switch can only be used for
isolation of equipment or load shedding. It will not be used by the FEA calculation to restore
power.
666 DIgSILENT PowerFactory 15, User Manual
29.3. SETTING UP THE NETWORK MODEL FOR RELIABILITY ASSESSMENT
From terminal i to j; If this option is selected, the switch will only be used to restore power if
the post restoration power ow is in the direction from terminal i to terminal j. The switch will
not be used for power restoration in the opposite direction.
From terminal j to i; If this option is selected, the switch will only be used to restore power if
the post restoration power ow is in the direction from terminal j to terminal i. The switch will
not be used for power restoration in the opposite direction.
Independent of direction; If this option is selected the switch will be used to restore power
ow regardless of the direction of the post restoration power ow.
4. Enter the time to actuate switch (Stage 2 and 3 switches only); This eld species the time taken
by the operator to actuate the switch. Note, this excludes the local access and access time if
the switch is within a substation. The total actuation time of such a switch is therefore the switch
actuation time + the substation access time + the local access time.
Note: The Sectionalizing options are only considered when the Distribution reliability analysis option
is selected under Basic Options. If the Transmission mode is selected, then all switches are
assumed to be remote controlled.
29.3.4 Load Modelling for Reliability Assessment
This section provides a general description of the load element parameters that are used by the re-
liability calculation. The rst sub-section describes how to input the number of customers that each
load represents and how to classify each load. The second sub-section describes how to dene load
shedding and transfer parameters.
29.3.4.1 Specifying the Number of Customers for a Load
Many of the reliability indices such as SAIFI and CAIFI are evaluated based on the number of customers
interrupted. Therefore, for accurate calculation of these indices it is important to specify the number of
customers that each load represents. To do this:
1. Open the dialogue for the target load element.
2. Select the Reliability page.
3. In the Number of connected customers eld, enter the number of customers that this load repre-
sents.
4. Repeat this process for each load in the system you are modelling.
Load Classication
Every load can be optionally classied into agricultural, commercial, domestic or industrial load. This
option does not affect the calculation of the reliability indices and is provided for categorisation purposes
only.
29.3.4.2 Specifying Load Shedding and Transfer Parameters
Load transfer and load shedding are used to alleviate violated voltage or thermal constraints caused
by the power restoration process. There is a distinction between load transfer for constraint alleviation,
such as described in this section, and load transfer for power restoration. Load transfer by isolating a
fault and closing a back-stop switch is considered automatically during the fault separation and power
restoration phase of the failure effect analysis.
DIgSILENT PowerFactory 15, User Manual 667
CHAPTER 29. RELIABILITY ASSESSMENT
If a violated constraint is detected in the post-fault system condition, a search begins for the loads
contributing to these overloads. The overloads are then alleviated by either:
Transferring some of these loads, if possible; or
Shedding some of these loads, starting with the lowest priority loads.
To dene the load shedding parameters follow these steps:
1. Open the reliability page of the load element.
2. Enter the number of load shedding steps using the Shedding steps list box. For example, four
shedding steps means that the load can be shed to 25%, 50%, 75% or 100% of its base value.
Innite shedding steps means that the load can be shed to the exact value required to alleviate
the constraint.
3. Enter the Load priority. The reliability algorithm will always try to shed the loads with the lowest
priority rst. However, high priority loads can still be shed if the algorithm determines this is the
only way to alleviate a constraint.
4. Enter the load transfer percentage in the Transferable parameter. This denes the percentage
of this load that can be transferred away from the current network. PowerFactory assumes that
the transferred load is picked up by another network that is not modelled, hence load transferring
in this way is equivalent to load shedding in terms of constraint alleviation. The difference is that
transferred load is still considered as supplied load, whereas shed load is obviously not supplied.
5. Optional: Use the selection control next to Alternative Supply (Load) to specify an alternative
load that picks up all transferred load.
Note: There is a critical difference between the transmission reliability and distribution reliability func-
tions. In distribution reliability all constraint alleviation is completed using switch actions, so loads
can only be fully shed (switched out) or they remain in service. However, by contrast, the trans-
mission reliability option can shed or transfer a percentage of the load.
29.3.5 Modelling Load Interruption Costs
When supply to a load is interrupted, there is a cost associated with the loss of supply. PowerFactory
supports the denition of cost curves for load elements using Energy Tariffs and Time Tariffs. They can
be dened using the Tariff characteristic on the reliability page of the load element, as discussed in
Chapter 16: Parameter Characteristics, Load States, and Tariffs, Section 16.5 (Tariffs).
Projects imported from previous versions of PowerFactory may include Vector Characteristics for the
denition of cost curves, which are discussed in Chapter 16: Parameter Characteristics, Load States,
and Tariffs, Section 16.2.3 (Vector Characteristics with Time Scales).
29.3.6 System Demand and Load States (ComLoadstate)
Considering Multiple System Demand Levels (Optional)
If you have dened time-based characteristics for the feeder loads so that the demand changes depend-
ing on the study case time, then you might want to also consider using these different demand patterns
in the reliability analysis. Because the reliability analysis always analyses a discrete system state, it is
normally not practical to consider every possible demand level because the number of discrete states
in a practical system is usually very large. Instead, the load demand for a one year period is can be
668 DIgSILENT PowerFactory 15, User Manual
29.3. SETTING UP THE NETWORK MODEL FOR RELIABILITY ASSESSMENT
discretized and converted into several so-called load states, and a probability of occurrence for each
state.
The Reliability Command does not automatically generate the load states. Therefore, if you wish to
consider multiple demand levels in your reliability analysis you must rst get PowerFactory to generate
the load states. There are two methods available for producing load states. The rst is by specication
of load characteristics for individual loads, and the second is by specication of load distribution states
for substations. The procedures for each method is described in Chapter 16: Parameter Characteristics,
Load States, and Tariffs; Sections 16.3 (Load States) and 16.4 (Load Distribution States).
29.3.7 Fault Clearance Based on Protection Device Location
The Reliability Calculation has two options for fault clearance:
Use all circuit breakers; or
Use only circuit breakers controlled by protection devices (fuses or relays).
The second option is the more realistic option, because only locations within the network that can
automatically clear a fault will be used by the reliability calculation to clear the simulated faults. However,
you must create protection devices to control each automatic switch for this option to work correctly.
29.3.8 How to Consider Planned Maintenance
The PowerFactory reliability calculation supports the denition and automatic inclusion of planned net-
work maintenance. Maintenance is implemented with a planned outage object. These objects are found
within the Outages sub-folder within the project Operational Library. The following steps describe the
procedure for creating a planned outage:
1. On the single line diagram (or within the data manager), select the object (or objects) that you
would like to dene an outage for.
2. Right-click the selected object/s and from the menu that appears choose the option Dene
Planned Outage. The dialogue box for the planned outage will appear.
3. Using the Start Time selection control ..., enter the time that the outage begins.
4. Using the End Time selection control ..., enter the time that the outage ends.
5. Optional: Adjust the Outage Type. Typically you would leave this on the default Outage of Element
option, but if you wanted to model a generator derating, then you would choose the Generator
Derating option.
Note: When the reliability calculation considers outages it creates a unique contingency case for ev-
ery contingency with the outage applied and also without the outage. For example, for a network
with two planned outages and six contingencies there will be a total of 63 = 18 contingency cases.
29.3.9 Specifying Individual Component Constraints
The reliability calculation can automatically consider voltage and thermal constraints for the power
restoration process. There are two options for specifying constraints applied to branch, terminal, and
feeder objects as follows:
DIgSILENT PowerFactory 15, User Manual 669
CHAPTER 29. RELIABILITY ASSESSMENT
Global Constraints; All network constraints are based on the constraints specied on the constraints tab
of the Reliability Command Dialogue.
Individual Constraints; If Individual Constraints are selected for branches, terminals, and / or feeders,
constraints should be dened by the user for each relevant object by taking the following steps:
1. Open the reliability page of the target terminal, branch (line/transformer), or feeder.
2. Enter the Max and Min Voltage limits, max loading, or voltage drop/rise for the terminal, branch,
or feeder respectively.
3. Click OK to close the dialogue and save the changes.
29.4 Running The Reliability Assessment Calculation
The procedure for using the PowerFactory Reliability Assessment tool and analyzing the results gener-
ated by the tool is described in this section.
29.4.1 How to run the Reliability Assessment
In PowerFactory the network Reliability Analysis is completed using the Reliability Assessment com-
mand (ComRel3 ). This command is found on the Reliability Analysis toolbar. The Optimal Power
Restoration command (ComOptrest ) can be found on the Optimal Power Restoration toolbar , see
Figure 29.1.2.
Alternatively, the commands can be executed for a single element by right-clicking the element and
selecting Calculate Reliability Assessment or Optimal Power Restoration. The options for the
reliability command that are presented within its dialogue are described in the following sub-sections.
29.4.1.1 Basic Options
The following options are available on the Basic Options page Reliability Assessment Command dia-
logue.
Method
Connectivity analysis: This option enables failure effect analysis without considering constraints. A
load is assumed to be supplied if it is connected to a source of power before a contingency, and
assumed to undergo a loss of supply if the process of fault clearance separates the load from all
power sources. Because constraints are not considered, no load-ow is required for this option
and hence the analysis will be faster than when using the alternative load-ow analysis option.
Load ow analysis: This option is the same as the connectivity analysis, except that constraints are
considered by completing load-ows for each contingency. Loads might be disconnected to alle-
viate voltage or thermal constraints. For the transmission analysis option, Generator re-dispatch,
load transfer and load shedding are used to alleviate overloads.
Calculation time period
Complete year: The reliability calculation is performed for the current year specied in the Date/Time
of the Calculation Case. This can be accessed and the date and time changed by clicking the
button.
670 DIgSILENT PowerFactory 15, User Manual
29.4. RUNNING THE RELIABILITY ASSESSMENT CALCULATION
Single Point in Time: The Reliability Calculation is completed for the network in its current state at the
actual time specied by the Date/Time of the Calculation Case.
Note: If load states or maintenance plans are not created and considered, then these options make no
difference because the reliability calculation is always completed at the single specied time.
Load Flow This button is a link to the load-ow calculation command used for the analysis. The load
demand is calculated using this load-ow. In addition, its settings are used for the constraint evaluation
load-ows.
Network
Distribution: The reliability assessment will try to remove overloading at components and voltage vi-
olations (at terminals) by optimizing the switch positions in the radial system. If constraints occur
in the power restoration process, loads will be shed by opening available switches. This option is
the recommended analysis option for distribution and medium voltage networks.
Note: The reliability command optimizes switch positions based on load shedding priorities, and not
network losses.
Transmission: Thermal overloads are removed by generator re-dispatch, load transfer and load shed-
ding. First generator re-dispatch and load transfer is attempted. If these cannot be completed
or do not remove the thermal overload, load shedding actions will occur. Generator re-dispatch
and load transfer do not affect the reliability indices. However, by contrast, load shedding leads to
unsupplied loads and therefore affects the reliability indices.
Automatic Contingency Denition (ComContingency)
The Selection list presents three possible options for the contingency denition. These are:
Whole system: PowerFactory will automatically create a contingency event for every object that
has a Stochastic Model dened.
Single Grid: Selecting this option shows a selection control. Now you can select a single grid and
only contingencies for objects in this grid will be created.
User Dened: Selecting this option shows a selection control. Now you can select a set of objects
(SetSelect), and contingencies will be created for each of these objects that has a Stochastic
Model dened.
In addition to the above contingency denition options, the automatic contingency denition can be
further controlled with the following checkboxes:
Busbars/Terminals; You must enable this ag for PowerFactory to create Busbar and terminal
contingencies.
Lines/Cables; You must enable this ag for PowerFactory to create Line/Cable contingencies.
Transformers; You must enable this ag for PowerFactory to create transformer contingencies.
Common Mode; You must enable this ag for PowerFactory to create Common Mode contingen-
cies. See Common Mode Stochastic Model (StoCommon) for more information.
DIgSILENT PowerFactory 15, User Manual 671
CHAPTER 29. RELIABILITY ASSESSMENT
Independent second failures; You must enable this ag for PowerFactory to consider n-2 outages in
addition to n-1 outages. Caution: n-2 outages for all combinations of n-1 outages are considered.
This means that for a system of n contingencies there are (n (n 1))/2) + n, contingencies to
consider. This equation is quadratic, and so to minimize the required time for computation this
option is disabled by default.
Double-earth faults; You must enable this ag for PowerFactory to consider double-earth faults.
See Double Earth Faults for more information.
Protection/switching failures; You must enable this ag for PowerFactory to consider protection
devices or circuit breakers failure to operate. See Protection/Switch Failures for more information.
29.4.1.2 Outputs
The following options are available on the Outputs tab of the Reliability command.
Results
This option allows the selection of the result element (ElmRes) where the results of the reliability anal-
ysis will be stored. Normally, PowerFactory will create a result object within the active study case.
Perform Evaluation of Result File
The Reliability Analysis automatically writes all simulation results to a result object specied above.
After completing the Reliability Calculation, PowerFactory automatically evaluates the result object to
compute the reliability indices. This button allows you to re-evaluate a results le that has previously
been created by this or another reliability calculation command. The benet of this is that you do not
have to re-run the reliability calculation (which can be time consuming compared to the results object
evaluation) if you only want to recalculate the indices from an already completed calculation.
Output
Displays the form used for the output report. Report settings can be inspected and the format selected
by clicking on the button.
Recording Limits These options dene when PowerFactory will record bus voltages and line loadings
in the reliability assessment result object. For example, if the loading limit is specied as 80%, then line
loadings will only be recorded on lines where the calculated loading is greater than 80%.
29.4.1.3 FEA
A failure effect analysis (FEA) is made for each system state that occurs during the state enumeration.
The conguration options are explained below.
Fault Clearance Breakers
Use all circuit breakers: All switches in the system whose Usage is set to Circuit Breaker can be used
for fault clearance.
Use only circuit breakers with protection device: All circuit breakers in the system which are con-
trolled by a protection device (fuse or relay) can be used for fault clearance.
Fault Separation/Power Restoration
This option will only be enabled if Automatic Power Restoration is enabled on the Advanced Options
Tab.
672 DIgSILENT PowerFactory 15, User Manual
29.4. RUNNING THE RELIABILITY ASSESSMENT CALCULATION
Concurrent Switch Actions: It is assumed that the switching actions can be performed immediately
following the specied switching time. However, a switch can be closed for power restoration only
after the faulted element was disconnected. The analogy for this mode, is if there were a large
number of operators in the eld that were able to communicate with each other to coordinate the
switching actions as quickly as possible. Therefore, this option gives an optimistic assessment of
the smart power restoration.
Sequential Switch Actions: It is assumed that all switching actions are performed sequentially. The
analogy for this mode, is if there is only a single operator in the eld and they are required to
complete all switching. The fault separation and power restoration is therefore slower when using
this mode compared with the concurrent mode.
Consider Sectionalizing (Distribution analysis only) If enabled, the FEA considers the switch sec-
tionalizing stage when attempting fault separation and power restoration. First sectionalizing is
attempted using only stage 1 switches, if this is not successful then stage 1 and 2 switches are
used. Finally, if this is not successful, then stage 1, 2 and 3 switches are used.
Time to open remote controlled switches
The time (in minutes) taken to open remote controlled switches.
29.4.1.4 Costs
Costs for energy not supplied
If this option is selected, an Energy Tariff can be selected. Energy Tariffs are discussed in Chapter 16:
Parameter Characteristics, Load States, and Tariffs, Section 16.5.2(Dening Energy Tariffs).
Costs for loads
If this option is selected, a Global cost curve for all loads can be selected. Alternatively, Individual cost
curve per load may be selected, allowing the user to dene tariffs for individual loads. In both cases,
a Time Tariff or Energy Tariff may be dened, as discussed in Chapter 16: Parameter Characteristics,
Load States, and Tariffs, Section 16.5 (Tariffs).
29.4.1.5 Constraints
The settings for global constraints are dened within this page. The options are as follows:
Consider Thermal Constraints (Loading)
If this option is enabled, thermal constraints are considered by the FEA.
Global constraints for all components: Constraints specied in Max thermal loading of components
apply to all components in percent value.
Individual constraint per component: The maximum thermal loading limit is considered for each
component separately. This loading limit can be found on the Reliability tab of each component.
Consider Voltage Limits (Terminals)
If this option is enabled terminal voltage limits are considered by the FEA.
Global Constraint for all terminals: Constraints specied in Lower and Upper Limit of allowed voltage
in p.u. that will apply to all terminals.
DIgSILENT PowerFactory 15, User Manual 673
CHAPTER 29. RELIABILITY ASSESSMENT
Individual Constraint per terminal: Voltage constraints are considered for each terminal separately.
These constraints can be found on the Reliability tab of each terminal.
Consider Voltage Drop/Rise
If this option is enabled feeder voltage limits are considered by the FEA.
Global Constraint for all feeders: Constraints specied in MaximumVoltage Drop and Rise in percent
value that will apply to all feeders.
Individual Constraint per feeder: Voltage Drop/Rise constraints are considered for each feeder sep-
arately. These constraints can be found on the Reliability tab of each feeder.
Ignore all constraints for
Constraints are ignored for all terminals and components below the entered voltage level.
Nominal voltage below or equal to: The voltage level in kV is specied here if Ignore all constraints
for... is enabled.
Note: Voltage constraints are only available when the Distribution analysis option is selected under
Basic Options. Thermal constraints are available when either the Transmission or Distribution
analysis option is selected.
29.4.1.6 Maintenance
This tab allows you to enable or disable the consideration of Maintenance based on the Planned Out-
ages you have dened. See Section 29.3.9, for more information on dening planned outages. The
following options are available on this page:
Consider Maintenance
If enabled, all maintenance that falls in the selected time period, whether its a year or a single point in
time, is considered.
Show used planned outages: When clicked, this button will show a list of all planned outages that will
be considered by the calculation.
Show all planned outages: When clicked, this button will show a list of all planned outages created
in the project, including those not considered by the analysis because they fall outside of the
selected time period.
29.4.1.7 Load Data
If the Reliability Calculation option Complete Year is selected on the basic options page, then the
following options are available on the Load Data page.
Consider Load States / Consider Distribution States
Enable the relevant ag to consider load states or load distribution states in the reliability calculation.
The reliability calculation does not create load states automatically. If this ag is enabled but the states
have not been created, then an error will be printed to the output window and the reliability calculation
will stop. Otherwise the following two buttons are available.
Update/creation of States
674 DIgSILENT PowerFactory 15, User Manual
29.4. RUNNING THE RELIABILITY ASSESSMENT CALCULATION
Manually: If selected, a button Create load states will be available. When clicked, it launches the
Load state creation command after closing the reliability command (see Chapter 16 for more
information on load state creation).
Automatically before running reliability calculation: When selected, a pointer to the load state cre-
ation command is available.
29.4.1.8 Advanced Options
Failures, correction of forced outage rate
This option performs an automatic correction/normalization of the reliability indices to allow for the fact
that not all unlikely but possible contingencies have been considered in the analysis. For instance, n-3
contingencies have a non-zero probability.
Note: Forced outage refers to the unplanned removal of a primary component from the system due to
one or more failures in the system.
Fault Clearance/ Automatic Power Restoration
Do not save corresponding switch events: Results of internal nodes of substations will not be writ-
ten to the result le. This minimizes the amount of objects created in the database while per-
forming calculations with many contingencies caused by big networks (e.g if independent second
failures or double earth faults are enabled).
Save corresponding switch events: Corresponding switch events will be saved in the database while
performing calculations.
Automatic Power Restoration
If enabled, automatic power restoration will be considered.
Calculate Existing Contingencies (Do not create contingencies)
If enabled, the existing contingencies inside the reliability command will be used in the analysis. Note
that the options for automatic contingency denition on the Basic Options tab disappears.
Trace Functionality (Jump to Last Step)
A user-dened Time delay in animation can be entered to delay the animation of power restorations
when the Jump to Last Step icon ( is pressed.
Switch/Load events
Delete switch events: Removes all switch events associated with the contingencies stored inside the
command.
Delete load events: Removes all load events associated with the contingencies stored inside the com-
mand.
Loadow Analysis, Overloadings
Consider branch if loadings exceeds: If there are overloaded elements in the system, these over-
loadings should be removed through overload alleviation. Branches whose loading exceeds this
limit, are considered by the overload alleviation algorithm.
DIgSILENT PowerFactory 15, User Manual 675
CHAPTER 29. RELIABILITY ASSESSMENT
A reliability assessment will be started when the Execute button is pressed. The calculation time
required for a reliability assessment can range from a few seconds for a small network only considering
n-1 contingencies, to several hours for a large network considering n-2 contingencies. A reliability
assessment calculation can be interrupted by clicking on the Break icon ( ) on the main toolbar.
29.4.2 Viewing the FEA results for a Specic Contingency
After the Reliability Analysis has completed, it is possible to view the fault clearance, fault separation,
power restoration and load shedding actions completed by the algorithm for each contingency. To do
this:
1. Click the Fault Trace button on the Reliability toolbar. A list of available contingencies will
appear in a new window.
2. Select the contingency to consider and click OK. The network will be initialized to the state before
the inception of the fault.
3. Click the Next Step button to advance to the next system state. This will usually show the
system state immediately after the protection has operated and cleared the fault.
4. Click the Next Step button to advance through more steps, each click advances one time step.
5. To stop the fault trace, click the Stop Trace button.
29.4.3 Viewing the Load Point Indices
You can view the Reliability Assessment Load Point Indices in two ways: in the load result boxes in
single line graphic, or in the data browser (data manager or load lter). This sub-section describes both
of these methods.
Method 1 - View the Load Point Indices in the Single Line Diagram
After you have executed the Reliability Assessment Calculation, all loads within the Network Single Line
Graphic, will show the following load point indices:
AID: Average Interruption Duration.
LPIF: Load Point Interruption Frequency.
LPIT: Load Point Interruption Time.
LPIC: Load Point Interruption Costs.
As usual, with PowerFactory result boxes, you can hover the mouse pointer over the result box to show
an enlarged popup of the results. This is demonstrated in Figure 29.4.1
Figure 29.4.1: Single Line Diagram Graphic Showing the Load Point Indices Results
676 DIgSILENT PowerFactory 15, User Manual
29.4. RUNNING THE RELIABILITY ASSESSMENT CALCULATION
Note: You can show any of the calculated load point indices in the load result boxes. To do this mod-
ify the displayed variables as described in Chapter 17: Reporting and Visualizing Results, Sec-
tion 17.4.3(Examples of Variable Selection)
Method 2 - View the Load Point Indices in the Data Browser
To view the load point indices in the Data Browser (as a selectable spreadsheet list), follow these steps:
1. Select the load element icon from the Edit Relevant Objects for Selection button . A list of
all loads considered in the calculation will appear. Calculation
2. Choose the Flexible Data tab. Calculated Load Point Indices for each load will appear in Green
Font text. By default, not all available load point indices will be shown.
3. Optional: Click the Dene Flexible Data button , to show all available variables.
4. Optional: Add more variables to the Selected Variables by double-clicking the variable in the
Available Variables window.
5. Optional: Click OK to view the result variables in the data browser.
29.4.4 Viewing the System Reliability Indices (Spreadsheet format)
The System Reliability Indices can be viewed for the whole system, individual grids, or for individual
feeders. Viewing these results is described in this sub-section.
To View Complete System Reliability Indices
Follow these steps to view the complete system reliability indices:
1. Select the Grids icon from the Edit Relevant Objects for Calculation button located on the
main toolbar. A list of all grids in the network model and a summary grid will appear.
2. Click the Flexible Data tab.
3. Click the Dene Flexible Data button to show the variable selection dialogue.
4. Click the Reliability tab (if not already selected).
5. Choose the variable set Calculation Parameter, from the list selection control in the Filter for
section. A list of available reliability indices will appear.
6. Select the indices that you wish to view, and double click them to move them to the Selected
Variables window.
7. Click OK to view the result variables in the data browser.
Note: Steps 3-7 are only required the rst time you want to view the system reliability indices, or if
you want to change the displayed variables. PowerFactory remembers these settings within each
project.
To View Feeder Reliability Indices
Reliability indices can also be viewed for each Feeder. To do this:
DIgSILENT PowerFactory 15, User Manual 677
CHAPTER 29. RELIABILITY ASSESSMENT
1. Select the Feeder icon from the Edit Relevant Objects for Calculation button located on the
main toolbar. A dialog box with a list of all feeders in the network model will appear.
2. Click the Flexible Data tab.
3. Click the Dene Flexible Data button to show the variable selection dialogue.
4. Click the Reliability tab (if not already selected).
5. Choose the variable set Calculation Parameter, from the list selection control in the Filter for
section. A list of available reliability indices will appear.
6. Select the indices that you wish to view, and double click them to move them to the Selected
Variables window.
7. Click OK to view the result variables in the data browser.
Note: Steps 3-7 are only required the rst time you want to view the Feeder reliability indices, or if
you want to change the displayed variables. PowerFactory remembers these settings within each
project.
29.4.5 Printing ASCII Reliability Reports
PowerFactory has three built-in ASCII Reliability Reports that you can use to show detailed print outs of
the Reliability Calculation results. To do this, follow these steps:
1. Click the Output Calculation Analysis icon on the main toolbar. A dialogue box showing the
available reports will appear.
2. Choose the report that you want to view.
3. Click Execute. The selected ASCII report will be printed to the PowerFactory Output Window.
Note: ASCII reports can be copied into a word processing tool directly from the Output Window. How-
ever, for a more professional look, try printing the report directly to PDF format from the Output
Window.
29.4.6 Using the Colouring modes to aid Reliability Analysis
There are several colouring modes that can aid you when using the reliability assessment functions.
These are:
Colouring according to Feeders; Use this to identify each Feeder and to see which feeder picks
up load when back-feed switches are closed.
Colouring according to Connected Grid Components; Use this to identify de-energized sections
of the network during the fault isolation, separation and power restoration.
Switches, type of usage. Use this mode to check the type of switches in the system when they
are not modelled explicitly in the single line diagram.
To Colour According to Feeders
1. Click the Diagram Colouring button . The Diagram colouring dialog will appear.
678 DIgSILENT PowerFactory 15, User Manual
29.4. RUNNING THE RELIABILITY ASSESSMENT CALCULATION
2. Select the tab for the function you want to show the colouring mode for. For example, if you want
the feeder colouring to appear before a calculation, then select the Basic Data tab. If you want the
colouring to appear after a load-ow choose the load-ow tab.
3. Check the 3. Other box and select Topology from the drop down list.
4. Select Feeders in the second drop down box.
5. Optional: To change the feeder colour settings click the colour settings button. You can double
click the displayed colours in the colour column and select a different colour for each feeder as
desired.
6. Click OK to close the Diagram Colouring dialogue and save your changes.
To Colour According to Connected Grid Components
The Connected Grid Components colouring mode displays all the network components that are elec-
trically connected together in the same colour. Other components are not coloured. To enable this
mode:
1. Click the Diagram Colouring button . The diagram colouring dialog will appear.
2. Select the load-ow tab.
3. Check the 3. Other box and select Topology from the drop down list.
4. Select Connected Grid Components in the second drop down box.
5. Click OK to close the Diagram Colouring dialogue and save your changes.
To Colour According to Switch Type
The Switches: type of usage colouring mode displays all switches in the network with a different colour
depending on their switch type. For instance circuit breakers will be displayed in a different colour to
disconnectors. To enable this mode:
1. Click the Diagram Colouring button . The diagram colouring dialog will appear.
2. Select the tab for the function you want to show the colouring mode for. For example, if you want
the switch type colouring to appear before a calculation, then select the Basic Data tab. If you
want the colouring to appear after a load-ow choose the load-ow tab.
3. Check the 3. Other box and select Secondary Equipment from the drop down list.
4. Select Switches, Type of Usage in the second drop down box.
5. Optional: To change the switch colour settings, click the colour settings button. You can double
click the displayed colours in the colour column and select a different colour for each switch type
as desired.
6. Click OK to close the Diagram Colouring dialogue and save your changes.
29.4.7 Using the Contribution to Reliability Indices Script
It can be useful to analyze the inuence of a particular component or group of components on the
calculated reliability indices. This enables the identication of components that can be targeted for
upgrade to improve reliability, or to examine the impact of improved switch automation for example. This
sub-section describes the built-in DPL script that can be used for these purposes.
To Start the Contribution to Reliability Indices Script
DIgSILENT PowerFactory 15, User Manual 679
CHAPTER 29. RELIABILITY ASSESSMENT
1. Execute a Reliability Assessment Calculation (or ensure that you activate a study case where a
reliability analysis has previously been completed).
2. Click the Edit Relevant Objects for Calculation button from the main toolbar. Depending on
whether you want to view the contributions by Feeder, Grids, Areas or Zone, choose one of the
following icons from the list of icons that appears:
For Grids choose the icon.
For Feeders choose the icon.
For Zones choose the icon.
For Areas choose the icon.
3. In the window that appears, select the object/s that you want to show the reliability indices contri-
butions.
4. Right-click one of the selected object icons. A menu will appear.
5. Choose Execute DPL scripts. A window displaying a list of DPL scripts will appear.
6. Select the Contribution to Reliability Indices Script and click OK. The script dialogue box will
appear. The available options are explained in the next section.
How to Congure and Run the Contribution to Reliability Indices Script
1. Enter 1 in the value column for calcSystemIndices parameter to make the script print the system
indices results. 0 suppresses the printing of the system indices.
2. Enter 1 in the value column for calcEnergyIndices parameter to make the script print the Energy
indices results. 0 suppresses the printing of the Energy indices.
3. Enter 1 in the value column for outputComponentClasses to make the script display contribu-
tions from each class such as lines, cable, transformers. 0 suppresses the printing of the class
information.
4. Enter 1 in the value column for outputIndivComponents parameter to make the script print the
results indices for each object in the selected area. 0 suppresses the printing of the individual
indices.
5. Optional: Enter 1 in the outputPercentages column to display the results from the script in
percent format.
6. Optional: Enter a percent threshold in the outputThreshold column to limit the printed results to
those above a specic threshold.
7. Click Execute to run the script. The results are printed to the PowerFactory output window.
680 DIgSILENT PowerFactory 15, User Manual
Chapter 30
Generation Adequacy Analysis
30.1 Introduction
The ability of the power system to be able to supply system load under all possible load conditions is
known as System Adequacy. Specically this relates to the ability of the generation to meet the system
demand while also considering typical system constraints such as:
Generation unavailability due to fault or maintenance requirements;
Variation in system load on an monthly, hourly and minute by minute basis;
Variations in renewable output (notably wind generation output), which in turn affects the available
generation capacity.
The PowerFactory Generation Adequacy Tool is designed specically for testing of System Adequacy.
Using this tool, it is possible to determine the contribution of wind generation to overall system capacity
and to determine the probability of Loss of Load (LOLP) and the Expected Demand Not Supplied
(EDNS).
Note: The Generation Adequacy Assessment is completed using the Monte Carlo Method (probabilis-
tic)
30.2 Technical Background
The analytical assessment of Generation Adequacy requires that each generator in the system is as-
signed a number of probabilistic states which determine the likelihood of a generator operating at vari-
ous output levels. Likewise, each of the system loads can be assigned a time based characteristic that
determines the actual system load level for any point of time. A simplied general illustration of the
Generation Adequacy assessment is shown in Figure 30.2.1.
In such a small example, it is possible to determine the Generation Adequacy analytically in a relatively
short time. However, as the number of generators, generator states, loads and load states increases,
the degrees of freedom for the analysis rapidly expands so that it becomes impossible to solve in a
reasonable amount of time. Such a problem is ideally suited to Monte Carlo simulation.
DIgSILENT PowerFactory 15, User Manual 681
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Figure 30.2.1: Generation Adequacy Assessment Illustration
Monte Carlo Method
In the Monte Carlo method, a sampling simulation is performed. Using uniform random number se-
quences, a random system state is generated. This system state consists of random generating op-
erating states and of random time points. The generating operating states will have a corresponding
generation power output, whereas the time points will have a corresponding power demand. The value
of Demand Not Supplied (DNS) is then calculated for such state. This process is done for a specic
number of draws (iterations). At the end of the simulation, the values of the Loss of Load Probabil-
ity (LOLP), Loss of Load Expectancy (LOLE), Expected Demand Not Supplied (EDNS), and Loss of
Energy Expectancy (LOEE) indices are calculated as average values from all the iterations performed.
Pseudo Random Number Generator
A Monte Carlo simulation relies on the generation of random numbers of high quality. As all computers
run deterministic code to generate random numbers, a software random number generator is known as
a pseudo random number generator (PRNG). There are various PRNGs available, some of which do not
display appropriate statistical qualities for use in Monte Carlo simulations, where very long sequences
of independent random numbers are required. PowerFactory uses an implementation of the RANROT
PRNG. This generator displays excellent statistical qualities suitable for Monte Carlo simulations and is
also relatively fast.
Example
To illustrate the process of a Monte Carlo simulation, an example is now presented using Figure 30.2.1
682 DIgSILENT PowerFactory 15, User Manual
30.2. TECHNICAL BACKGROUND
as the example network.
For each iteration, the operating state for each generator is randomly selected by generating a uniform
random number. For each of these states, the corresponding power output of the generator is calcu-
lated. The total generation power of the system is calculated by summing all the generator outputs.
For the same iteration, a time point in the system is randomly selected. For this time point, the power
demand of each load is obtained. The total demand of the system is calculated by summing all the load
demands. It is then possible to obtain the Demand Not Supplied (DNS) value for this iteration, where
DNS is dened as shown in Equation (30.1).
DNS =
Demand
Generation (30.1)
For example, in the rst iteration, the generator states might be G1: 100%, G2: 100%, and G3: 75%.
The corresponding outputs would be then G1: 100 MW, G2: 60 MW, and G3: 60 MW. The total gen-
eration output is the sum of all the three generator outputs; 220 MW. Also, a random time point yields
Load A: 85 MW, Load B: 60 MW and Load C: 30 MW. The total system demand is the sum of all the
load demands; 175 MW. Since the generation is greater than the demand, all the demand is supplied
and the value of DNS is zero.
In a second iteration, the generator states might be G1: 0%, G2: 75%, and G3: 75%. The corresponding
outputs would be then G1: 0 MW, G2: 45 MW, and G3: 60 MW. The total generation output is now 105
MW. A second random time point yields say Load A: 60 MW, Load B: 50 MW, and Load C: 20 MW. The
total system demand is now 130 MW. In this case, the generation is smaller than the demand, so there
is demand that cannot be supplied. The demand not supplied is dened as the difference between
demand and generation - 25 MW in this iteration.
Continuing the analysis for a few subsequent iterations yields the results shown in Table 30.2.1:
Iteration six yields a second case where demand is not supplied.
Once the analysis has continued in this way (usually for several tens of thousands of iterations) vari-
ous indices of system adequacy can be calculated. The indices Loss of Load Probability (LOLP) and
Expected Demand Not Supplied (EDNS) are the critical measures. They are calculated as follows:
LOLP =
N
DNS
N
100% (30.2)
EDNS =
DNS
N
(30.3)
Table 30.2.1: Example Monte Carlo Analysis
DIgSILENT PowerFactory 15, User Manual 683
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
where N
DNS
is the number of iterations where DNS > 0 and N is the total number of iterations.
Therefore, for the above example the indices are calculated as follows:
LOLP =
2
6
100 = 33, 33% (30.4)
EDNS =
30
6
= 5MW (30.5)
30.3 Database Objects and Models
There are several database objects in PowerFactory specically related to the Generation Adequacy
Analysis, such as:
Stochastic Model for Generation Object (StoGen);
Power Curve Type (TypPowercurve); and
Meteorological Station.
This section provides information about each of these objects.
30.3.1 Stochastic Model for Generation Object (StoGen)
This object is used for dening the availability states of a generator, an example of which is shown in
Figure 30.3.1. An unlimited number of states is possible with each state divided into:
Availability of Generation (in %)
Probability of Occurrence (in %)
This means that for each state, the total available generation capacity in % of maximum output must be
specied along with the probability that this availability occurs. Note that probability column is automat-
ically constrained, so that the sum of the probability of all states must equal 100 %.
Figure 30.3.1: Stochastic Model for Generation Dialogue Box
The Stochastic model for generation object should reside within the project library, Equipment Type
Library.
684 DIgSILENT PowerFactory 15, User Manual
30.3. DATABASE OBJECTS AND MODELS
Note that the generator maximumoutput is calculated as S
nom
cos where S
nom
is the nominal apparent
power and cos is the nominal power factor.
30.3.2 Power Curve Type (TypPowercurve)
This object is used to specify the wind speed (in m/s) vs nominal power output (p.u or MW) for wind
turbine generators. The dialogue for the curve is shown in Figure 30.3.2.
Figure 30.3.2: Power Curve Type (TypPowercurve)
For wind-speed values between specied curve values, PowerFactory interpolates using the method
specied in the Approximation drop down menu. Interpolation options include:
constant
linear
polynomial
spline and
hermite.
To change the Power unit, go to the conguration tab and choose either p.u or MW by selecting the
appropriate radio button.
30.3.3 Meteorological Station (ElmMeteostat)
It is often the case that groups of wind generators have a wind speed characteristic that is correlated.
PowerFactory can represent such a correlation through the Meteo Station Object. This object is a
grouping element and is located within the project Network Data as shown in Figure 30.3.3.
DIgSILENT PowerFactory 15, User Manual 685
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Figure 30.3.3: Project Data Structure showing the location of the Meteo Station Object
Note that when two wind generators are correlated as members of the same Meteo Station, they may
still have different average wind speeds dened within their Generation Adequacy dialogue. During the
Monte Carlo Analysis, a random wind speed is drawn for each Meteo Station. This wind speed is then
applied to every wind generator in that Meteo Station using the Weibull Stochastic Model. Thus, the
power is calculated according to the individual power curve of the generator.
When the generator is using time characteristics as a wind model, then the correlation is given by the
Monte Carlo drawn time, which is the same for all the generators of the system.
Meteorological stations can be dened either via the element that is to be part of the meteorological
station (from any of the generator elements described in Section 30.4), or via the single line diagram
by right-clicking on an appropriate element and selecting Dene Meteo Station (or Add to Meteo
Station) from the context-sensitive menu. Note that the ability to dene a Meteo Station is dependent
upon whether at least one of the member generators has the options Generator and Wind Generator
selected on its Basic Data page. If these options are not selected, the context menu entry is not visible.
Note: A graphical colouring mode exists for Meteorological Stations, so that they can be visualized in
the single line graphic.
30.4 Assignment of Stochastic Model for Generation Object
For the Generation Adequacy Analysis, there is a distinction between Dispatchable (Conventional) Gen-
eration and Non-dispatchable Generation. Dispatchable generation refers to generation that can be
controlled at a xed output automatically, typically by varying the rate of fuel consumption. This includes
generation technologies such as gas thermal, coal thermal, nuclear thermal and hydro.
Non-dispatchable generation refers to generation that cannot be automatically controlled because the
output depends on some non controllable environmental condition such as solar radiation or the wind
speed. Wind turbine and solar photovoltaic generators are examples of such environmentally dependent
generation technologies.
30.4.1 Denition of a Stochastic Multi-State Model
For both Dispatchable and Non-dispatchable generation it is possible to assign a Stochastic Multi-State
model to dene the availability of each unit. The availability is dened in a number of States each with
a certain probability as described in Section 30.3.1.
686 DIgSILENT PowerFactory 15, User Manual
30.4. ASSIGNMENT OF STOCHASTIC MODEL FOR GENERATION OBJECT
Synchronous machine (ElmSym);
Static generator (ElmGenstat ) set as Fuel Cell, HVDC Terminal, Reactive Power Compensation,
Storage, or other Static Generator ;
Asynchronous machine (ElmAsm); and
Doubly-fed asynchronous machine (ElmAsmsc)
In all cases, the stochastic model object is assigned on the elements Generation Adequacy page, under
Stochastic Multi-State Model. This is illustrated in Figure 30.4.1.
Figure 30.4.1: Generation Adequacy tab with a Stochastic Model for generation selected
Also, to consider the generation as dispatchable, the Wind Generation option in the Basic Data tab page
of the synchronous, asynchronous, and doubly fed machine should be disabled.
Denition of a Stochastic Model for Non-Dispatchable (Wind and Renewable) Generation
As for the dispatchable generation, the following 3-phase models are capable of utilising the stochastic
model for generation object, provided they are dened as generators and not as motors:
Synchronous machine (ElmSym) set as Wind Generator ;
Static generator (ElmGenstat ) set as Wind Generator, Photovoltaic or Other Renewable
Asynchronous machine (ElmAsm) set as Wind Generator ; and
Doubly-fed asynchronous machine (ElmAsmsc) set as Wind Generator
In all cases, the stochastic model object is assigned on the elements Generation Adequacy tab page,
under Stochastic Multi-State Model, as illustrated in Figure 30.4.1.
Objects not considered in Generation Adequacy Analysis External Grids (ElmXnet ), voltage
and current sources (ElmVac, ElmIac) are ignored in the Generation Adequacy analysis.
DIgSILENT PowerFactory 15, User Manual 687
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
30.4.2 Stochastic Wind Model
In addition to the stochastic multi-state model for generation described above, a stochastic wind model
may be dened on the elements Generation Adequacy page (provided that the type of generation is a
wind generator). To enable this, navigate to the Generation Adequacy tab and check the option Wind
Model. The page will appear as shown in Figure 30.4.2.
Figure 30.4.2: Stochastic Wind Model Denition
When the Stochastic Wind Model is selected, the wind generation characteristic is described using the
Weibull Distribution. The mean wind speed, and shape factor (Beta) of the distribution can be adjusted
to achieve the desired wind characteristic for each wind generator.
In addition to describing the Weibull distribution using Mean Wind Speed and Beta, the following alter-
nate methods of data input can be used:
Mean Wind Speed and Variance;
Lambda and Variance;
Lambda and Beta.
The input method can be changed by using the input selection arrow and choosing the desired
method from the input window that appears.
30.4.3 Time Series Characteristic for Wind Generation
If detailed data of wind generation output over time or wind speed over time is available, then this can
be used instead of a Stochastic Model. The data can be read by PowerFactory as either a ChaVec
characteristic or from an external le using the ChaVecFile characteristic. In both cases the information
required is one year of data in hourly intervals - although non integer values can also be specied in the
referenced data.
688 DIgSILENT PowerFactory 15, User Manual
30.4. ASSIGNMENT OF STOCHASTIC MODEL FOR GENERATION OBJECT
If the option Time Series Characteristics of Wind Speed is selected, then the actual wind generator
power output for each iteration is calculated automatically from the Wind Power Curve. If the option,
Time Series Characteristic of Active Power Contribution is selected then no power curve is required.
Data for multiple years can also be used by referencing an additional characteristic for each year. The
Generation Adequacy algorithm then selects a random wind speed or power value from one of the input
data years - essentially there is more data for the random Monte Carlo iteration to select from.
A screenshot showing a wind generator model with three years of data is shown in Figure 30.4.3.
Figure 30.4.3: Wind Model using Wind Output Data
Other Renewable Generation
Static Generators (ElmGenstat ) of category Photovoltaic or Other Renewable cannot have a Stochastic
wind model denition. However, they may still have a Stochastic Multi-State model. Their output is
added to the aggregated non-dispatchable generation as described later in this chapter.
Consideration of Parallel Machines
The Generation Adequacy analysis automatically considers parallel machines dened in the basic data
of the generator object using the variable (ngnum), as shown in Figure 30.4.4. Each of the parallel
machines is treated independently. For example, a random operational state is generated for each of
the parallel machines. Effectively this is the same as if n machines were modelled separately.
DIgSILENT PowerFactory 15, User Manual 689
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Figure 30.4.4: Synchronous machine element with the parameter ngnum (number of parallel machines
highlighted).
30.4.4 Demand denition
Unless a time characteristic is assigned to either the Active Power (plini) or Scale factor (scale0) vari-
ables (highlighted in Figure 30.4.5) of the load element, then the load is treated as xed demand. This
means that the demand value does not change during the entire analysis. Both General Loads (ElmLod)
and LV Loads (ElmLodlv) are considered for the analysis.
Figure 30.4.5: ElmLod object dialogue showing the variables that can have applied time Characteristics
effecting the Generation Adequacy analysis.
690 DIgSILENT PowerFactory 15, User Manual
30.4. ASSIGNMENT OF STOCHASTIC MODEL FOR GENERATION OBJECT
More information about assigning time based characteristics to object variables can be found in Chap-
ter 16: Parameter Characteristics, Load States, and Tariffs.
30.4.5 Generation Adequacy Analysis Toolbar
The selection of the Generation Adequacy toolbar is shown in Figure 30.4.6.
Figure 30.4.6: Generation Adequacy Toolbar selection
Once selected, the available buttons are shown in Figure 30.4.7.
Figure 30.4.7: Generation Adequacy Analysis Toolbar
30.4.6 Generation Adequacy Initialisation Command
(ComGenrelinc)
Before a Generation Adequacy Analysis can be completed, the simulation must be initialised. The
Initialisation dialogue box with the Basic Options tab selected is shown in Figure 30.4.8. The available
options are explained in this section.
DIgSILENT PowerFactory 15, User Manual 691
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Figure 30.4.8: Generation Adequacy Initialisation Command
Network
System Losses; Here a xed percentage of losses can be entered. This value is subtracted from
the total generation at each iteration.
Load Flow Command; This is a reference to the load-ow command that will be used to obtain the
network topology for the analysis. It must be set to AC load-ow balanced, positive sequence or
DC load-ow. A converging load-ow is a requirement for the Generation Adequacy analysis.
Demand Consideration
Fixed Demand Level; If this option is selected, all load time characteristics are ignored and the
total demand is calculated at the initial iteration and used for all subsequent iterations.
Consider Time Characteristics; If this option is selected, any time characteristics assigned to loads
will be automatically considered in the calculation. Therefore, the total demand can vary at each
iteration.
692 DIgSILENT PowerFactory 15, User Manual
30.4. ASSIGNMENT OF STOCHASTIC MODEL FOR GENERATION OBJECT
Consider Maintenance Plans
If this option is enabled then any maintenance plans (out of service or derating) in the project will be
automatically considered. Consequently, when an iteration draws a time that falls within a planned
outage or derating, the outage (or derating) is applied to the target element resulting in a reduction in
available generation capacity.
To dene a maintenance plan, right-click the target object from the single line graphic or from the data
manager and select the option Dene... Planned Outage For more information on Planned Outages
refer to Chapter 12: Project Library, Section 12.3.5 (Planned Outages).
Consider Maintenance Plans
Year of Study; The period considered for the Generation Adequacy analysis is always one year.
However, it is possible for load characteristics to contain information for many years. Therefore,
the year considered by the calculation must be selected. Note that this variable does not inuence
the wind speed or wind power data if the wind model for the generator references time series data
as described in Section 30.4.3 (Time Series Characteristic for Wind Generation). If more than one
years data is available, this simply increases the pool of available data for the analysis.
Months, Days; These checkboxes allow the user to select the time period that will be considered
for the analysis. For instance, if only January is selected then the iteration time will be constrained
to within this month.
Time Intervals
The user can specify up to three time intervals for the time window in which the analysis will be com-
pleted. The time interval starts at the From hour (0 minutes, 0 seconds), and ends at the To hour (0
minutes, 0 seconds) inclusive.
Output options
The output window of the Generation Adequacy Initialisation Command is shown in Figure 30.4.9.
Figure 30.4.9: Output options for the Generation Adequacy Initialisation
Create Plots; If this option is checked, then PowerFactory will automatically create output plots af-
ter the simulation nishes. See Section 30.5 for details of the plots that are automatically created.
Note this will generate a new set of plots for each run of the analysis. So, if you wish for an existing
set of plots to be updated, then leave this option unchecked.
Draws; If this option is checked, then the user can specify a location for the results of the simulation
to be permanently stored within the database. This is the result of each iteration. If this option is
unchecked, then the results are deleted after each simulation run.
DIgSILENT PowerFactory 15, User Manual 693
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Distribution; Here the user can select the storage location for the distribution probabilities for the
entire analysis. This information is always retained in the database.
Advanced Options
The Advanced Options screen is shown in Figure 30.4.10. Here the user can change the option for the
generation of random numbers from auto to renew. If the renew option is selected, then the simulation
can use one of a number of pre-dened random seeds (A-K). As the software pseudo-random number
generator is deterministic, this allows for the exact sequence of random numbers to be repeated.
Figure 30.4.10: Initialisation Command Advanced Options
30.4.7 Run Generation Adequacy Command (ComGenrel)
The Run Generation Adequacy Analysis Command appears in two styles depending on the status of the
calculation. If the calculation is being run for the rst time, then it appears as shown in Figure 30.4.11.
On the other hand, if some iterations are already complete, then the calculation can be continued and
the dialogue appears as shown in Figure 30.4.12.
Figure 30.4.11: Run Generation Adequacy Command Dialogue (new simulation)
Figure 30.4.12: Run Generation Adequacy Command Dialogue (post simulation)
Pressing Execute will run the Generation Adequacy Analysis. The button can be used to interrupt
694 DIgSILENT PowerFactory 15, User Manual
30.5. GENERATION ADEQUACY RESULTS
the analysis before the set number of iterations is complete, if desired. Later, the simulation can be
resumed from the stop point using the Run Generation Adequacy Analysis Command.
Max Number of Iterations
This species the number of iterations to be completed by the Monte Carlo Analysis. The default setting
is 100,000.
Additional Iterations
After one analysis is completed, the Generation Adequacy Analysis can be extended for a number of
Additional Iterations. Especially in very large systems, it may be useful to run the rst simulation with
a smaller number of initial iterations, say 20,000 and then run additional iterations as necessary using
this option.
Generation Adequacy
This reference provides a link to the Generation Adequacy Initialisation Command, so that the calcula-
tion settings can be easily inspected.
30.5 Generation Adequacy Results
Result plots for the Generation Adequacy Analysis are automatically generated if the Create Plots option
is enabled in Initialisation Command output options. Alternatively, the plots can be manually created
using the toolbar plot icons
30.5.1 Draws (Iterations) Plots
This button ( ) draws by default four gures as shown in Figure 30.5.1. Each of the data points on the
plots represents a single Monte Carlo simulation.
DIgSILENT PowerFactory 15, User Manual 695
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Figure 30.5.1: Draws (Iterations) Plots
Figure A displays the following:
Total Available Capacity in MW;
Available Dispatchable Generation in MW;
Total Demand in MW;
Figure B displays the following:
Available Non-dispatchable capacity in MW;
Figure C displays the following::
Total Reserve Generation Capacity in MW;
Figure D displays the following::
Total Demand in MW;
Residual Demand in MW;
30.5.2 Distribution (Cumulative Probability) Plots
This button ( ) draws a distribution plot which is essentially the data from Draws plots sorted in
descending order. The data then becomes a cumulative probability distribution. An example is shown
696 DIgSILENT PowerFactory 15, User Manual
30.5. GENERATION ADEQUACY RESULTS
in Figure 30.5.2.
Figure 30.5.2: Distribution (Cumulative Probability) Plots
Obtaining the LOLP from the Distribution Plots
The LOLP index can be obtained by inspection directly from the Distribution Plots if the demand is
constant. The LOLP can be read directly from the intersection of the Total Generation curve and the
Total Demand curve as demonstrated in Figure 30.5.3.
When the demand is variable, then the LOLP index cannot be inferred from the above diagram. Fig-
ure 30.5.4 shows such a case. There is no intersection point even though the calculated LOLP index in
this case is 20 %. In such cases, the LOLP index must be inferred from the distribution plot of the Total
Reserve Generation. As shown in Figure 30.5.5, the intersection of this curve with the x-axis gives the
LOLP index.
DIgSILENT PowerFactory 15, User Manual 697
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Figure 30.5.3: Inferring the LOLP index directly from the intersection of the Total Generation and Total
Demand
Figure 30.5.4: Variable Demand - distribution of Total Generation and Total Demand
698 DIgSILENT PowerFactory 15, User Manual
30.5. GENERATION ADEQUACY RESULTS
Figure 30.5.5: Total Reserve Generation
30.5.3 Convergence Plots
This button ( ) creates the so-called convergence plots for the LOLP and EDNS. As the number of
iterations becomes large the LOLP index will converge towards its nal value, likewise for the EDNS.
The convergence plots are a way of visualising this process. An example convergence plot is shown in
Figure 30.5.6.
DIgSILENT PowerFactory 15, User Manual 699
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
Figure 30.5.6: Example Convergence Plot
Note: By default, the convergence plot is zoomed to the plot extent and due to the number of iterations
it may be difcult to observe the upper and lower condence limits. It is suggested that the Zoom
Y-axis and Zoom X-axis buttons are used to observe the condence limits in greater detail.
On both plots, the upper and lower condence intervals are also drawn. The sample variance is calcu-
lated as follows:
2
=
1
n 1
n
i=1
(y
i
y)
2
(30.6)
where n is the number of samples,y
i
is the sample and y is the sample mean. The 90 % condence
interval is calculated according to the following formula:
CL = y
n
z (30.7)
where z is the standard inverse probability for the Students t distribution with a condence interval of
90 %. Note z tends to 1.645 (inverse normal) as the number of iterations becomes large.
700 DIgSILENT PowerFactory 15, User Manual
30.5. GENERATION ADEQUACY RESULTS
30.5.4 Summary of variables calculated during the Generation Adequacy Anal-
ysis
Table 30.5.1: Generation Adequacy Calculated Variables
DIgSILENT PowerFactory 15, User Manual 701
CHAPTER 30. GENERATION ADEQUACY ANALYSIS
702 DIgSILENT PowerFactory 15, User Manual
Chapter 31
Optimal Power Flow
31.1 Introduction
The Optimal Power Flow (OPF) module in PowerFactory optimizes a certain objective function in a
network whilst fullling equality constraints (the load ow equations) and inequality constraints (i.e.
generator reactive power limits). The user can choose between interior point and linear optimization
methods. In the case of linear optimization, contingency constraints can also be enforced within OPF.
An OPF calculation in PowerFactory can be initiated by one of the following means:
By going to the main menu and selecting Calculation Optimal Power Flow...; or
By selecting Additional Tools from the Change Toolbox button ( )and then click on the OPF
icon .
In both cases, the calculation is started by pressing the Execute button in the OPF command dialogue.
31.2 AC Optimization (Interior Point Method)
If the AC Optimization method is selected, the OPF performs a non-linear optimization based on a
state-of-the-art interior point algorithm. The following sections explain the selection of objective function
to be optimized, the selection of control variables, and the denition of inequality constraints. The OPF
command in PowerFactory is accessible by going to the main menu and selecting Calculation Optimal
Power Flow..., or via the OPF icon on the main toolbar.
31.2.1 Basic Options
The Basic Options page of the OPF dialogue (AC optimization method) is shown in Figure 31.2.1.
DIgSILENT PowerFactory 15, User Manual 703
CHAPTER 31. OPTIMAL POWER FLOW
Figure 31.2.1: Basic Options page of OPF Dialogue (AC Optimization Method)
31.2.1.1 Method
To perform an AC optimization OPF study, the Method must be set to AC Optimization (Interior Point
Method) as shown in Figure 31.2.1.
31.2.1.2 Objective Function
The OPF command dialogue, congured for AC optimization, has a selection of three distinct objective
functions. These are:
Minimization of Losses
Minimization of Costs
Minimization of Load Shedding
Minimization of Losses
When this objective function is selected, the goal of the optimization is to nd a power dispatch which
minimizes the overall active power losses.
Minimization of Costs
When this objective function is selected, the goal of the optimization is to supply the system under
optimal operating costs. More specically, the aim is to minimize the cost of power dispatch based on
non-linear operating cost functions for each generator and on tariff systems for each external grid.
For this purpose, the user needs to introduce for each generator, a cost function for its power dispatch;
and for each external grid, a tariff system.
704 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
Cost Functions for Generators Imposing an operating cost function on a generator element
is done as follows: on the Optimal Load Flow page of each synchronous machine (ElmSym)
elements dialogue (see Figure 31.2.2), it is possible to specify the operating costs of the unit
with the aid of the Operating Costs table (which relates active power produced (in MW) to the
corresponding cost (in $/h)). This data is then represented graphically beneath the Operating
Costs table, for verication purposes (see Figure 31.2.2). The number of rows that can be entered
in to the table is unlimited. To add or delete table rows, right-click on a row number in the table
and select the appropriate command (i.e. Copy, Paste, Select All ; Insert Rows, Append Rows,
Append n Rows, Delete Rows, etc.). If there are more than two rows, spline interpolation is used.
Tariff Systems for External Grids An external grid contributes to the overall cost function by
a predened tariff system. On the Optimal Load Flow page of each external grid (ElmXnet )
elements dialogue (see Figure 31.2.3), the tariffs can be edited via the Incremental Costs table.
This table relates the cost (in $/MWh) over a certain range of active power exchange. The input
data is represented graphically beneath the Incremental Costs table. In addition, the user can
enter a monthly no load cost (in $/month), which can be interpreted as a vertical shift of the cost
function (see Figure 31.2.3).
In contrast to a synchronous machine, where the cost curve is directly expressed in $/h, the cost curve
of an external grid is dened by means of a tariff which holds within certain intervals. Mathematically
speaking, the cost curve of a synchronous machine is calculated as the interpolation of predened cost
points, whereas the cost curve of an external grid is a piecewise linear function with predened slopes
in each interval.
Figure 31.2.2: Editing the Operating Costs of a Synchronous Machine (ElmSym)
DIgSILENT PowerFactory 15, User Manual 705
CHAPTER 31. OPTIMAL POWER FLOW
Figure 31.2.3: Editing the Incremental Costs of an External Net (ElmXnet )
Note that this piecewise linear function is not differentiable at the interval limits. Since non-differentiable
functions might cause problems within the optimization routine, PowerFactory smooths the cost function
slightly over a small range around the non-differentiable points. The width of this range can be dened
by the user through the Smoothing of Cost Function factor (also shown in Figure 31.2.3). A value of 0%
corresponds to no smoothing of the curve, whereas a value of 100% corresponds to full interpolation.
The default value is 5%. It is recommended to leave this value at its default setting.
Minimization of Load Shedding
The goal of this objective function is to minimize the overall cost of load shedding, such that all con-
straints can be fullled. A typical application for this objective function is Infeasibility Handling. For the
abovementioned objective functions, it may occur that the constraints imposed on the network are such
that no feasible solution exists. This is evidenced by a lack of convergence of the optimization. In such
cases, it is highly likely that not all loads can be supplied due to constraint restrictions. Hence it is
recommended in these situations to rstly perform a Minimization of Load Shedding.
In this (and only this) optimization scenario, all load elements which have the option Allow load shedding
enabled will act as controls. This option is enabled in the load (ElmLod) elements dialogue on the
Optimal Load Flow page in the Controls section. All loads without this option enabled will behave as
they would in a conventional load ow calculation. In order to minimize the overall load shedding, for
each individual load, the user must specify the cost of shedding (in $ per shed MVA).
For each load that participates as a control in the optimization, the scaling factor will be optimized. The
optimization is such that the overall cost of load shedding is minimized. Additionally, the user can specify
the range over which the load may be scaled (options Min. load shedding and Max. load shedding), as
shown in Figure 31.2.4.
706 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
Figure 31.2.4: Editing a Load Element (ElmLod) for Minimization of Load Shedding
31.2.1.3 Controls
The global control parameters can be selected on the Basic Options page of the OPF dialogue. The
user can specify which parameters might serve as potential degrees of freedom for the OPF algorithm;
i.e. which parameters will contribute as controls. The set of potential controls can be grouped into four
categories:
1. Generator Active Power Dispatch (ElmSym)
2. Generator Reactive Power Dispatch (ElmSym)
3. Transformer Tap Positions (for 2- and 3-winding transformers):
2-Winding Transformer (ElmTr2):
Tap Position (continuous or discrete)
3-Winding Transformer (ElmTr3):
HV-Tap Position (continuous or discrete)
LV-Tap Position (continuous or discrete)
MV-Tap Position (continuous or discrete)
4. Switchable Shunts (ElmShnt ):
Number of steps (continuous or discrete)
It should be noted that the load scaling factors will only be taken into account for the Minimization of
Load Shedding objective function. In this case, all loads which allow load shedding are automatically
used as controls.
These global controls determine which element controls will be considered in the optimization. The
general rule is as follows: a parameter will be considered as a control if the corresponding ag is set
on the Optimal Load Flow page of the elements dialogue and if, in addition, the corresponding global
parameter is set on the Basic Options page of the OPF command dialogue (see Figure 31.2.5).
DIgSILENT PowerFactory 15, User Manual 707
CHAPTER 31. OPTIMAL POWER FLOW
For example, if the control parameter Tap Position HV-Side of a 3-winding transformer is enabled (as
shown in Figure 31.2.8), it will only be included in the OPF as a control parameter if the corresponding
option Transformer Tap Positions is enabled in the OPF command dialogue (as shown in Figure 31.2.5).
If enabled, the abovementioned control parameters serve as variable setpoints during the OPF. How-
ever, if a parameter is not enabled as a control parameter, the OPF will treat this parameter according
to the load ow settings.
Figure 31.2.5: Global Controls for OPF (AC Optimization Method)
This could be a xed position or a position found due to the option Automatic Tap Adjust of Transformers
being selected in the load ow command. In this mode, the transformer tap position could be found in
order to control the voltage of a certain node, or to be a slave that is externally controlled by some other
transformer tap.
Setting Individual Model-Based Controls
Each control can be individually selected to take part in the optimization. Specically, for each generator
(ElmSym), each transformer (ElmTr2, ElmTr3), and each shunt (ElmShnt ), the user can check the
corresponding Controls ag on the optimization page of the elements dialogue.
Synchronous Machines
A synchronous machine may contribute two possible setpoints, namely active and reactive power
control (see Figure 31.2.6).
708 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
Figure 31.2.6: Active and Reactive Power Controls of a Synchronous Machine (ElmSym)
2- and 3-Winding Transformers
If a transformer has the Tap Position option selected, the user can further select the associated
Control Mode to be used. This determines whether the tap position will be treated as a continuous
or a discrete control parameter in OPF. Note that a 3-winding transformer has up to three tap
changers which may individually be used as either continuous or discrete control parameters in
OPF.
Figure 31.2.7 shows the Controls section of the dialogue for a 2-winding transformer and Fig-
ure 31.2.8 shows the Controls section of the dialogue for a 3-winding transformer. It should be
noted that the Optimize section with the selection of Pre- and post-fault position or Only pre-fault
position are only considered by the DC OPF.
DIgSILENT PowerFactory 15, User Manual 709
CHAPTER 31. OPTIMAL POWER FLOW
Figure 31.2.7: Tap Position Control (and Loading Constraint) for a 2-Winding Transformer
Figure 31.2.8: Tap Position Control for a 3-Winding Transformer
Shunts
In a similar fashion to transformers, the number of steps for a shunt may serve as either a contin-
uous or a discrete optimization parameter (see Figure 31.2.9).
710 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
Figure 31.2.9: Control Parameter for a Shunt(ElmShnt )
31.2.1.4 Constraints
The user can formulate various inequality constraints for certain system parameters, such that the
OPF solution lies within these dened limits. Since all inequality constraints are considered as hard
constraints, setting constraints may result in no feasible solution being found.
The handling of OPF constraints in PowerFactory is very exible, and various categories of constraints
exist. A constraint is considered in the OPF if and only if the individual constraint ag is checked in the
element and the corresponding global ag is enabled in the OPF dialogue. Figure 31.2.10 shows the
Constraints available for the AC optimization formulation of OPF in PowerFactory.
DIgSILENT PowerFactory 15, User Manual 711
CHAPTER 31. OPTIMAL POWER FLOW
Figure 31.2.10: Constraints Settings for OPF (AC Optimization Method)
The optimization uses further constraints that are automatically imposed as soon as the corresponding
parameter is used as a control. Examples of such constraints are tap position limits and the number of
steps for switchable shunts.
Network elements and their available constraints are listed below:
Busbars and Terminals (ElmTerm):
Minimum Voltage
Maximum Voltage
Lines (ElmLne):
Maximum Loading
2- and 3-Winding Transformer (ElmTr2, ElmTr3):
Maximum Loading
Tap Position range (if corresponding tap is a designated control parameter)
Shunts (ElmShnt ):
Controller Steps range (if switchable steps are designated control parameters)
Generator (ElmSym):
Minimum Active Power
Maximum Active Power
Minimum Reactive Power
Maximum Reactive Power
Boundary (ElmBoundary):
712 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
Minimum Active Boundary Flow
Maximum Active Boundary Flow
Minimum Reactive Boundary Flow
Maximum Reactive Boundary Flow
Branch Flow Limits (max. loading)
Branch ow limits formulate an upper bound on the loading of any branch (ElmLne, ElmTr2, ElmTr3,
etc). The user has to specify a maximum value for the loading on the elements Optimal Load Flow
page (see Figure 31.2.11). If specied as shown in Figure 31.2.11, this constraint is only taken into
consideration if the corresponding ag (Branch Flow Limits (max. loading)) in the OPF dialogue is also
ticked. Loading limits are supported for lines and 2- and 3-winding transformers.
Figure 31.2.11: Max. Loading Constraint of a Line Element (similar for 2- and 3-Winding Transformers)
Active and Reactive Power Limits of Generators and External Grids
For each synchronous machine (ElmSym) and external grid (ElmXnet ), the user may impose up to
four inequality constraints: namely a minimum and maximum value for active power generation; and a
minimum and maximum value for reactive power generation (see Figure 31.2.12). Active power limits
are specied as MW values; reactive power limits may be specied as either absolute values or as per
unit values (i.e. referred to the types nominal apparent power). Alternatively, it is possible to directly use
the reactive power limits specied in the synchronous machines type (TypSym). Again, the user is free
to select any number and combination of the available constraints.
DIgSILENT PowerFactory 15, User Manual 713
CHAPTER 31. OPTIMAL POWER FLOW
Figure 31.2.12: Active and Reactive Power Constraints of a Synchronous Machine (ElmSym)
Voltage Limits of Busbars/Terminals
The maximum and minimum allowable voltages for each terminal or busbar element (ElmTerm) can be
specied in the corresponding elements dialogue (see Figure 31.2.13). Therefore, each terminal or
busbar may contribute at most two inequality constraints to the OPF. Maximum and minimum voltage
limits may be imposed individually; i.e. it is possible to specify an upper limit without specifying a lower
limit.
Figure 31.2.13: Voltage Constraints for a Terminal/Busbar (ElmTerm)
Boundary Flow Limits
714 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
PowerFactory boundary elements (ElmBoundary), icon dene topological regions in a power system
by a user-specied topological cut through the network. Constraints can be dened for the ow of active
and reactive power in a network (over a dened boundary or between internal and external regions
of a boundary), and this constraint can then be enforced in OPF. For detailed information on dening
boundaries, please refer to Chapter 13: Grouping Objects, Section 13.3.
Figure 31.2.14: Dening Boundary Flow Limits (ElmBoundary)
31.2.1.5 Mathematical Background
The non-linear optimization is implemented using an iterative interior-point algorithm based on the
Newton-Lagrange method. Recall that the goal of the optimization is to minimize an objective func-
tion f subject to the equality constraints imposed by the load ow equations and also to the inequality
constraints dened for various power system elements. This is summarised mathematically as follows:
min = f(x)
subject to:
g(x) = 0 h(x) 0
where g represents the load ow equations and h is the set of inequality constraints. Introducing a slack
variable for each inequality constraint, this can be reformulated as:
g(x) = 0 h(x) +s = 0 s 0
We then incorporate logarithmic penalties and minimize the function:
min = f(x)
i
log(s
i
)
where is the penalty weighting factor. In order to change the contribution of the penalty function:
f
pen
=
i
log(s
i
)
to the overall minimization, the penalty weighting factor will be decreased from a user-dened initial
value (
max
) to a user-dened target value (
min
).
The smaller the minimum penalty weighting factor, the less the applied penalty will be for a solution
which is close to the constraint limits. This may result in a solution that is close to the limiting constraint
DIgSILENT PowerFactory 15, User Manual 715
CHAPTER 31. OPTIMAL POWER FLOW
bounds (if necessary). However, a smaller minimum penalty weighting factor will result in a higher
number of iterations required.
31.2.1.6 Results
The presentation of OPF results is integrated into the user interface, in that the OPF solution is available
via the complete set of variables available for conventional load ow calculations. These can be viewed
in the single line diagram or through a data browser. The inclusion of the following variables in the
Flexible Data tab (for synchronous machines and grids) is suggested, as shown in Figure 31.2.15. The
Variable Set must be set to Calculation Parameter as indicated below, and the actual variable names
are given in parentheses.
Synchronous machines:
Active Power (Calculation Parameter P : bus1; this parameter is highlighted in Figure 31.2.15)
Reactive Power (Calculation Parameter Q : bus1)
Apparent Power (Calculation Parameter S : bus1)
Voltage Magnitude (Calculation Parameter u : bus1)
Figure 31.2.15: Denition of Flexible Data for Synchronous Machines (ElmSym)
Grids:
Total Production Cost, including costs through external grids (Calculation Parameter c:cst disp;
see this parameter highlighted in Figure 31.2.16). It should be noted that the production costs
are expressed in the same units utilized in the production cost tables of the individual generator
elements.
Active Power Losses (Calculation Parameter c : LossP)
Reactive Power Losses (Calculation Parameter c : LossQ)
Active Power Generation (Calculation Parameter c : GenP)
Reactive Power Generation (Calculation Parameter c : GenQ)
716 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
Figure 31.2.16: Denition of Flexible Data for Grids (ElmNet )
In addition to these results, the complete set of variables from conventional load ow calculations is
available. For further information on dening Flexible Data in PowerFactory , please refer to Chapter 10:
Data Manager, Section 10.6.
A text report is also available and can be generated by clicking on the Output Calculation Analysis
icon on the main toolbar. This offers various templates for detailed result documentation.
31.2.2 Initialization
The non-linear optimization requires initialization to generate an initial starting condition. The Iteration
page of the OPF dialogue as shown in Figure 31.2.17 allows the user to select the initialization method.
Figure 31.2.17: Initialization Settings for OPF (AC Optimization Method)
Initialization of Non-Linear Optimization
Load Flow Displays the load ow command which is used for initialization in the case that no at
start initialization is used.
Initialize by Flat-Start The user may choose whether the initialization is performed by a load
ow calculation or by a at start. If it is known in advance that the nal solution of the optimization
is close to a valid load ow solution, initialization using a load ow calculation results in faster
convergence.
No Flat Initialization (Use Load Flow Result) If this option is selected, the OPF checks whether
an OPF-initializing load ow result has been calculated prior to the OPF. Here, OPF-initializing
means that the ag Use this load ow for initialization of OPF was enabled in the load ow
command dialogue before execution. This ag can be found on the second page of the Advanced
Options page in the load ow command dialogue. The result of this load ow is then used as a
starting point for the iterative OPF interior-point algorithm. If no valid OPF-initializing load ow
result is found, the OPF will recalculate a new load ow.
DIgSILENT PowerFactory 15, User Manual 717
CHAPTER 31. OPTIMAL POWER FLOW
31.2.3 Advanced Options
Penalty Weighting Factor
The penalty weighting factor determines the amount by which the penalty is applied. For example, the
smaller the specied penalty weighting factor, the less the penalty will be applied for solutions which are
close to constraint limits.
Initial Value Initial value of the penalty weighting factor.
Target Value Target value of the penalty weighting factor.
Reduction Factor A factor by which the current penalty weighting factor will be divided by be-
tween the iterations.
Figure 31.2.18: Penalty Weighting Factor Settings for OPF (AC Optimization Method)
31.2.4 Iteration Control
PowerFactory offers the user exibility in conguring of the number of iterations and the convergence
criteria for OPF. The available options on the Iteration Control page of the OPF dialogue are shown in
Figure 31.2.19.
Figure 31.2.19: Iteration Control Settings for OPF (AC Optimization Method)
The implementation of the Lagrange-Newton method means that the OPF will internally minimize the
718 DIgSILENT PowerFactory 15, User Manual
31.2. AC OPTIMIZATION (INTERIOR POINT METHOD)
resulting Lagrange function:
L(x, s,
) = f(x)
i
log(s
i
) +
T
[g(x) +h(x) +s] (31.1)
with the Lagrange multipliers (
).
The following parameters can be used to alter the stopping criteria for this iterative process. The algo-
rithm stops successfully if the following three criteria are fullled:
1. The maximum number of iterations has not yet been reached.
2. All load ow constraint equations g(x)=0 are fullled to a predened degree of exactness (i.e.
within an allowable tolerance), which means:
all nodal equations are fullled
all model equations are fullled
3. The Lagrange function L converges. This can be achieved if:
either the objective function itself converges to a stationary point, or the gradient of the ob-
jective function converges to zero.
The following parameters are used to congure these stopping criteria. The alteration of the default
values for these parameters is recommended only for advanced users.
Maximum Number of Iterations
Interior-Point Algorithm (Inner Loop) Maximum number of iterations for the interior-point algo-
rithm.
Control Loop (Outer Loop) Maximum number of iterations of the outer loop.
Convergence Criteria
Max. Acceptable Error for Nodes The maximum allowable error for the nodal equations (in
kVA).
Max. Acceptable Error for Model Equations The maximum allowable error for the model equa-
tions (in %).
Max. Change of Objective Function Used when Convergence of Objective Function option
values of objective function become constant is selected. The user enters a value (in %), below
which the Lagrangian is considered to have converged.
Max. Value for Gradient of Objective Function Used when Convergence of Objective Function
option gradient of objective function converges to zero is selected. The user enters an absolute
value, below which the Lagrangian is considered to have converged.
Convergence of Objective Function Options relating to the convergence criteria for the La-
grangian function: either the value of the function itself is required to converge to a stationary
point, or the gradient of the Lagrangian is required to converge, as described below.
Values of objective function become constant If this option is selected, the user is asked to
enter a value for the Max. Change of Objective Function. If the change in value between two
consecutive iterations falls below this value, the Lagrangian is considered to have converged.
Gradient of objective function converges to zero If this option is selected, the user is asked
to enter a value for the Max. Value for Gradient of Objective Function. If the gradient falls below
this value, the Lagrangian is considered to have converged.
DIgSILENT PowerFactory 15, User Manual 719
CHAPTER 31. OPTIMAL POWER FLOW
For reasons of mathematical exactness, it is strongly recommended to select the latter option, gradient
of objective function converges to zero. If the underlying Jacobian matrix is numerically instable, this of-
ten results in oscillatory behaviour in the last iterations. Therefore, the latter method provides assurance
that the result is in fact a minimum.
31.2.5 Output
Prior to the non-linear optimization, the OPF informs the user (in the output window) of the total number
of constraints and controls that will be considered in the subsequent calculation. This information is
detailed such that the imposed constraints and the participating controls are counted for each constraint
and control categories separately. Two options are available to select the level of detail contained in
output messages. These options are available in the Output page of the OPF dialogue and are shown
in Figure 31.2.20 and are described below.
Figure 31.2.20: Output Settings for OPF (AC Optimization Method)
Show Convergence Progress Report
If this ag is checked on the Output page of the OPF dialogue, the user will get a detailed report on
the convergence of the non-linear optimization. For each step of the iteration, the following gures are
displayed in the output window (actual variable names are shown parenthesized in italics):
The current error of the constraint nodal equations (in VA) (Err.Nodes);
The current error of the constraint model equations (Err.ModelEqu);
The current error of the inequality constraints (eInequ);
The current value of the gradient of the Lagrangian function (gradLagFunc);
The current value of the Lagrangian function (LagFunc);
The current value of the objective function f to be minimized (ObjFunc);
The current value of the penalty function fpen (PenFunc);
The current values of the relaxation factors (Rlx1, Rlx2) for the primal and dual variables;
The current value of the penalty factor (PenFac)).
Show Max. Nodal and Model Equation Error Elements
If this ag is checked, the algorithm outputs per iteration, the components which have the largest error in
the equality constraints (i.e. mismatch in the load ow equations). An outer loop is wrapped around the
central non-linear optimization algorithm. This outer loop is required to perform rounding and optimiza-
tion of the evaluated tap and shunt positions to discrete values (if desired by the user). The maximum
number of outer loops is dened on the Iteration Control page of the dialogue. However, if no conver-
gence is reached with the dened number of outer loops, the user will be informed via a message in the
output window that further outer loop iterations are required.
720 DIgSILENT PowerFactory 15, User Manual
31.3. DC OPTIMIZATION (LINEAR PROGRAMMING)
31.3 DC Optimization (Linear Programming)
The following describes the conguration of the DC optimization formulation of OPF in PowerFactory.
Internally, from the settings provided, a linear programming (LP) formulation of the problem is derived.
The load ow is calculated using the linear DC load ow method. For general information regarding
DC load ow, refer to Chapter 21(Load Flow Analysis). PowerFactory uses a standard LP-solver (based
on the simplex method and a branch-and-bound algorithm) which ascertains whether the solution is
feasible. The result of the linear optimization tool includes calculated results for control variables, such
that all imposed constraints are fullled and the objective function is optimized.
Provided that a feasible solution exists, the optimal solution will be available as a calculation result. That
is, the algorithm will provide a DC load ow solution where all generator injections and tap positions are
set to optimal values. The DC load ow solution includes the following calculated parameters (parameter
names are given in italics):
For terminals:
Voltage Angle (phiu [deg])
Voltage Magnitude (u [p.u.]; assumed to be 1.0 p.u. in DC calculation)
Voltage Magnitude (upc [%]; assumed to be 100 % in DC calculation)
Line-Ground Voltage Magnitude (U [kV])
Line-Line Voltage Magnitude (U1 [kV])
For branches:
Active Power Flow (P [MW] )
Active Power Losses (Ploss [MW]; assumed to be 0 MW in DC calculation)
Reactive Power Flow (Q [Mvar]; assumed to be 0 MVAr in DC calculation)
Reactive Power Losses (Qloss [Mvar]; assumed to be 0 MVAr in DC calculation)
Loading (loading [%]; Loading with respect to continuous rating)
The following parameters are calculated in addition to the results found by the DC load ow:
For generators:
c:avgCosts The xed cost factor [$/MWh] used in the objective function (i.e. average cost
considering the costs at the generators active power limits).
c:Pdisp) Optimal power dispatch for generator.
c:cst disp) Production costs in optimal solution: cst disp = costs * Pdisp
For Transformers:
c:nntap Optimal tap position.
For loads:
c:Pdisp Optimal load shedding for load.
DIgSILENT PowerFactory 15, User Manual 721
CHAPTER 31. OPTIMAL POWER FLOW
31.3.1 Basic Options
The Basic Options page of the OPF dialogue (DC optimization method) is shown in Figure 31.3.1.
Figure 31.3.1: Basic Options page of OPF Dialogue (DC Optimization Method)
31.3.1.1 Method
To perform a DC optimization OPF study, the Method must be set to DC Optimization ( Linear Program-
ming LP) as shown in Figure 31.3.1.
31.3.1.2 Objective Function
The user can select a linear optimization objective function using the list box as shown in Figure 31.3.2.
These objective functions are now described.
Figure 31.3.2: Objective Function Selection for OPF (DC Optimization Method)
722 DIgSILENT PowerFactory 15, User Manual
31.3. DC OPTIMIZATION (LINEAR PROGRAMMING)
Feasibility Check
Performs a feasibility check of the network considering the specied controls and constraints (i.e. per-
forms a constrained load ow).
Minimization of Costs
The objective is to minimize generation costs. To perform a cost minimization calculation for each
generator, a cost factor needs to be entered:
Cost curve $/MWh per generator element (ElmSym, see Figure 31.2.2)
The (linear) algorithm uses a xed cost-factor [$/MWh] per generator. This cost factor is the average
cost considering the costs at the generators active power limits. The selection of this objective function
provides the option of calculating the Locational Marginal Prices (LMPs). For further information on this
option refer to: Shadow Prices and Locational Marginal Prices (LMPs).
Min. Generator Dispatch Change
Minimizes the change in generator dispatch from the generators initial value.
31.3.1.3 Controls
The Controls section of the OPF Basic Options page is highlighted in Figure 31.3.3. The basic role of
each control is as described for the AC optimization method in Section 31.2.1 (Basic Options)
Figure 31.3.3: Controls Selection for OPF (DC Optimization Method)
The user can select from the following control variables (the names of the associated PowerFactory
elements are provided in parentheses):
Generator Active Power Dispatch (ElmSym) In generator optimization, for each selected gener-
ator a single control variable is introduced to the system. The total number of generator controls
in this case equals the number of selected generators.
Transformer Tap Positions (ElmTr2, ElmTr3) In tap optimization, for each selected transformer
DIgSILENT PowerFactory 15, User Manual 723
CHAPTER 31. OPTIMAL POWER FLOW
a single control variable is introduced to the system. The total number of tap controls in this case
equals the number of selected transformers.
Allow Load Shedding (ElmLod) A separate control variable is introduced to the system for each
selected load. The total number of load controls in this case equals the number of selected loads.
This control variable can be selected in conjunction with any objective function.
Note: At least one type of control variable in the Controls section of the OPF dialogue must be selected.
31.3.1.4 Constraints
The three constraints shown in Figure 31.3.4 are as described for the AC optimization method in Sec-
tion 31.2.1 (Basic Options).
Figure 31.3.4: Constraints Selection for OPF (DC Optimization Method)
For DC optimization the following constraint is also imposed:
Transformer Tap Constraints (implicitly imposed) Minimum and maximum tap positions (ElmTr2,
ElmTr3) for transformers are considered. These constraints are implicitly imposed when transformer
tap positions are specied as controls in the Controls section of the dialogue (see Figure 31.3.4). This
means that two constraints are introduced to the LP for the base case tap position calculation.
Handling
Active power dispatch constraints can be chosen on an individual basis (via a checkbox) per generator.
See Figure 31.2.17for setting minimum and maximum constraints for generators for optimization. It
should be noted that generator constraints are not implicitly imposed when active power dispatch is
selected as a control. Tap position constraints will be implicitly imposed whenever the corresponding
tap is a designated control variable, as in Figure 31.2.7.
Loading constraints can be chosen on an individual basis (via a checkbox) per line element (ElmLne),
as shown in Figure 31.2.11. If loading constraints are included, the maximum loading limits will be
724 DIgSILENT PowerFactory 15, User Manual
31.3. DC OPTIMIZATION (LINEAR PROGRAMMING)
calculated with respect to the type of the element, or with respect to a thermal rating object (IntThrating,
as shown in Figure 31.3.5). If a thermal rating object is selected, the limits will be calculated with respect
to the Continuous Rating value.
Figure 31.3.5: Thermal Rating Object (IntThrating) Ratings page for Setting Rating Values
Boundary ow constraints can be chosen on an individual basis per boundary element (ElmBoundary),
as shown in Figure 31.2.14.
31.3.1.5 Shadow Prices and Locational Marginal Prices (LMPs)
If the option Calculate Locational Marginal Prices (LMPs) (displayed at bottom of the dialogue in Fig-
ure 31.3.4) is selected, the Locational Marginal Price (LMP) is calculated. The Shadow Price is always
calculated. The LMP represents the change in the systems total production costs based on a unit
change of load at the bus. The calculation of LMP takes into account the network constraints.
The system lambda represents the change in the systems total production costs based on a unit change
of any load in the absence of network constraints.
With the Calculate Locational Marginal Prices (LMPs) option ticked, the execution of the OPF will (on
the y) calculate the LMP for each busbar. The following quantities (current, voltage and powers) are
available for all busbars (i.e. ElmTerm elements with Usage set to Busbar ):
LMP in $/MWh (Locational marginal price)
SysLambda in $/MWh (System lambda)
DIgSILENT PowerFactory 15, User Manual 725
CHAPTER 31. OPTIMAL POWER FLOW
In addition to the LMPs, the DC Optimization always computes the shadow prices. These quantities
are available per component, which introduces a constraint to the system. The shadow price then
represents the change in the objective function if the constraint is released by a unit change. The
shadowprices are available as results for the PowerFactory elements listed below (result variable names
are given followed by their corresponding unit). These result variable names are available as Calculation
Parameters when dening variable sets for each element. For more information on dening variable
sets, refer to Chapter 11: Study Cases, Section 17.4 (Variable Sets).
Line (ElmLne):
ShadowPrice in $/MWh (Shadow price)
2-Winding Transformer (ElmTr2, ElmTr2n):
ShadowPrice in $/MWh Shadow price (loading constraint))
ShadTapMax in $/MWh Shadow price (Maximum Tap constraint))
ShadTapMin in $/MWh Shadow price (Minimum Tap constraint))
3-Winding Transformer (ElmTr3):
ShadowPrice in $/MWh (Shadow price (loading constraint))
ShadTapMaxLV in $/MWh (Shadow price (Maximum Tap constraint (LV)))
ShadTapMinLV in $/MWh (Shadow price (Minimum Tap constraint (LV)))
ShadTapMaxMV in $/MWh (Shadow price (Maximum Tap constraint (MV)))
ShadTapMinMV in $/MWh (Shadow price (Minimum Tap constraint (MV)))
ShadTapMaxHV in $/MWh (Shadow price (Maximum Tap constraint (HV)))
ShadTapMinHV in $/MWh (Shadow price (Minimum Tap constraint (HV)))
Boundary (ElmBoundary):
ShadowMaxP in $/MWh (Shadow price (max. total active power constraint))
ShadowMinP in $/MWh (Shadow price (min. total active power constraint))
Synchronous Machine (ElmSym):
ShadowMaxP in $/MWh (Shadow price (upper limit active power))
ShadowMinP in $/MWh (Shadow price (lower limit active power))
External Grid (ElmXnet ):
ShadowMaxP in $/MWh (Shadow price (upper limit active power))
ShadowMinP in $/MWh (Shadow price (lower limit active power))
General Load (ElmLod):
ShadowMaxP in $/MWh (Shadow price (max. load shedding))
ShadowMinP in $/MWh (Shadow price (min. load shedding))
31.3.2 Initialization
The OPF calculation is initialized by a load ow, which is displayed by the Load Flow parameter on the
Initialization page of the OPF dialogue. The user can inspect the load ow settings by clicking on the
button, as illustrated in Figure 31.3.6. The load ow command contained in the current study case is
set here automatically. Within the load ow command, the Calculation Method will be automatically set
to DC Load Flow (linear) for use by OPF (when Method is set to one of the LP variants).
726 DIgSILENT PowerFactory 15, User Manual
31.3. DC OPTIMIZATION (LINEAR PROGRAMMING)
Figure 31.3.6: Initialization Settings for OPF (DC Optimization Method)
31.3.3 Advanced Options
The Advanced Options page of the OPF dialogue is shown in Figure 31.3.7.
Figure 31.3.7: Advanced Options for OPF (DC Optimization Method)
Load Shedding Options
If Allow Load Shedding is among the selected Controls (see Section 31.3.1: Basic Options) on the
Basic Options tab, an additional term will be added to the objective function. The weight of this term
can be controlled using the Penalty Factor in the Load Shedding Options section of the OPF dialogue.
The following term will be added to the objective function, where is the specied Penalty Factor, and
c is the cost factor of load i:
n
Co
j=1
n
Load
i=1
c
i
|Load
j
i
Load
curr
i
| (31.2)
Transformer Tap Deviation Control
If tap positions are to be optimized, different solutions can yield the same optimal value for the objective
function. One can therefore impose a term to the objective function, which forces the solution to be as
close as possible to the initial transformer tap positions.
DIgSILENT PowerFactory 15, User Manual 727
CHAPTER 31. OPTIMAL POWER FLOW
Use Penalty Factor for Tap Deviation If enabled, the following additional term is added to the
objective function:
n
Tr
i=1
|tap
0
i
tap
curr
i
| (31.3)
Penalty Factor Species the weighting factor for the additional objective function term above.
Calculation of Transformer Tap Positions
Discrete controls (Using direct method) This method calculates discrete tap position values
within the LP (known as the direct method). This method may provide better accuracy, however
will yield fewer solutions.
Continuous controls (Using outer loop rounding) This method calculates continuous tap po-
sition values and then rounds these values to discrete values in the outer loop of the calculation.
This method may be faster but the values may not be optimal.
Additional Settings
Check for Constraint Violations after Optimization This method calculates discrete tap posi-
tion values within the LP (known as the direct method). This method may provide better accuracy,
however will yield fewer solutions.
Use Presolve procedure If selected, the LP is checked for linear dependencies of constraints.
They will be eliminated and only the corresponding (smaller) system is solved.
31.3.4 Iteration Control
Two outer loop settings are available: (i) control of the number of iterations of the algorithm; and (ii)
denition of a constraint tolerance. These settings are shown in Figure 31.3.8 and are described below.
Figure 31.3.8: Iteration Control Settings for OPF (DC Optimization Method)
Outer Loop
Following the solution of the LP problem, it may be the case that loading constraints are not within
their boundaries. The reason is that for taps, the algorithm uses tap sensitivities which assume a linear
728 DIgSILENT PowerFactory 15, User Manual
31.4. CONTINGENCY CONSTRAINED DC OPTIMIZATION (LP METHOD)
change in MW ow per tap step. Since these tap sensitivities depend on the initial tap position, the
result becomes inaccurate if the optimal tap position is far from the initial tap position. This inaccuracy
can be remedied by an additional outer loop. At each iteration, this outer loop starts with the optimized
tap positions which were calculated in the previous loop. The following Outer Loop settings can be
entered on this tab:
Max. Number of Iterations Maximum number of outer loop iterations until all constraints are
fullled (within a dened tolerance).
Max. Acceptable Error for Constraints Maximum relative error (in %) by which a constraint
can be violated while still being considered a feasible solution.).
It should be noted that when Max. Number of Iterations is set to 1, the LP is solved without outer loops.
Limitation of Branch Flow Constraints
This option is useful for avoiding long calculation times for large systems. If selected, the LP is solved
via an iterative procedure which iterates until no further constraint violations are found (with respect to
the Max. Acceptable Error for Constraints parameter). It should be noted that the option Check for
Constraint Violations after Optimization on the Advanced Options page must be selected in order to
utilise this iterative procedure. An initial set of branch ow constraints must be selected by the user, as
described below.
Initial Set of Branch Flow Constraints The set of branch ow constraints to be considered
can either be the set of N most highly loaded components or a user-dened set. In the case
of the set of N most highly loaded components, the program nds these automatically either by
using a contingency analysis calculation (in the case of a contingency constrained DC OPF) or
by using the initial loadow (for the other OPF methods). In the case of a user-dened set, the
user must dene and assign a set of components. A set of components can be dened either via
the single line graphic or data manager, by multi-selecting the desired components, right-clicking
and selecting Dene... General Set.... This set can then be selected and assigned via the
button.
Max. number of additional constraints per iteration
After solving the LP with an initial set of constraints, the solution is checked against all loading
constraints and overloaded components are added to the LP. The parameter Max. number of
additional constraints per iteration species the maximal number of added components.
31.4 Contingency Constrained DC Optimization (LP Method)
The Contingency Constrained DC Optimization performs an OPF using DC optimization (as described
in Section 31.3: DC Optimization (Linear Programming)), subject to various user dened constraints
and subject also to the constraints imposed by a set of selected contingencies.
The Contingency Constrained DC Optimization also considers user-dened post-fault actions. That is,
the optimization can be carried out using contingency cases that include any specied post-fault action.
These actions include switch events, generator redispatch events, load shedding events and tap change
events.
In order for the OPF to consider post-fault actions, the contingency analysis command that is assigned
to the OPF must be set to Multiple Time Phases. The contingency cases can then be dened to contain
post-fault actions. For further information on dening contingency cases with post-fault actions, see
Chapter 28: Contingency Analysis; Section: 28.5 (The Multiple Time Phases Contingency Analysis
Command).
In addition to the result variables available for DC optimization, the contingency constrained OPF offers
the following result variables (as well as those provided by the DC load ow, as described in Sec-
DIgSILENT PowerFactory 15, User Manual 729
CHAPTER 31. OPTIMAL POWER FLOW
tion 31.3: DC Optimization (Linear Programming)):
For generators:
c:Pdisp Optimal generation for each contingency case. The optimum generation for each
contingency case is stored as a parameter event object in the corresponding contingency
object (ComOutage). Thus, each contingency object will hold parameter events for each
selected generator (the name of the parameter event is the name of the generator). The
parameter event reects the optimal generation for that generator in the given contingency
case.
For Transformers:
c:nntap Optimal tap positions for each contingency case. The optimum tap positions for each
contingency case are stored as a parameter event object in the corresponding contingency
case object (ComOutage). Thus, each contingency object (ComOutage) will hold parameter
events for each selected transformer (the name of the parameter event is the name of the
transformer). The parameter event reects the optimal tap position for that transformer in the
given contingency case
c:mxTpChng ( l, m, h) mxTapChng is the maximum tap change deviation between the op-
timal base case tap position and the optimal tap position considering all contingencies. For
3-winding transformers, HV-, MV- and LV-side tap changes are calculated individually.
For loads:
c:Pdisp Optimal load shedding for each contingency case. The optimum load shedding for
each contingency case is stored as a parameter event object in the corresponding contin-
gency case object (ComOutage). Thus, each contingency object will hold parameter events
for each selected load (the name of the parameter event is the name of the load). The pa-
rameter event reects the optimal load shedding for that load in the given contingency case.
31.4.1 Basic Options
The Basic Options page of the OPF dialogue (contingency constrained DC optimization method) is
shown in Figure 31.4.1.
730 DIgSILENT PowerFactory 15, User Manual
31.4. CONTINGENCY CONSTRAINED DC OPTIMIZATION (LP METHOD)
Figure 31.4.1: Basic Options page of OPF Dialogue (Contingency Constrained DC Optimization
Method)
Method
To perform a contingency constrained OPF study, the Method must be set to Contingency Constrained
DC Optimization (LP) as shown in Figure 31.4.1.
Contingency Analysis
This is a reference to the Contingency Analysis (ComSimoutage) command to be used during the
contingency constrained OPF. The user can select and set this contingency analysis command via the
button, and view or edit the contingency analysis command settings using the arrow button . If the
user would like the contingency cases to use post-fault actions, the Method used by the contingency
analysis command must be set to Multiple Time Phases. See Chapter 28: Contingency Analysis;
Section: 28.5 (The Multiple Time Phases Contingency Analysis Command).
Objective Function
The selection of objective function for Contingency Constrained DC Optimization includes the same
objective functions as those provided for DC Optimization (see Section 31.3.1: Basic Options). Two
additional objective functions are provided, which are shown in Figure 31.4.2 and described below.
DIgSILENT PowerFactory 15, User Manual 731
CHAPTER 31. OPTIMAL POWER FLOW
Figure 31.4.2: Objective Function Selection for OPF (Contingency Constrained DC Optimization
Method)
Min. Generator Dispatch Change (Pre-to-Postfault) Minimizes the sum of the generator dis-
patch changes between the base case and each contingency case.
Min. Transformer Tap Change (Pre-to-Postfault) Minimizes the sumof the tap position changes
between the base case and each contingency case.
Controls
The denition of control variables for the contingency constrained DC optimization method differs slightly
from the DC optimization method, however the basic fundamental role of each control is as described
for the AC optimization method in Section 31.2.1 (Basic Options). The Controls section of the OPF
dialogue is highlighted in Figure 31.4.3.
732 DIgSILENT PowerFactory 15, User Manual
31.4. CONTINGENCY CONSTRAINED DC OPTIMIZATION (LP METHOD)
Figure 31.4.3: Controls Selection for OPF (Contingency Constrained DC Optimization Method)
The user can select from the following control variables:
Generator Active Power Dispatch (ElmSym, ElmXnet ) Dispatch in Contingencies
Use base case dispatch: For all contingency cases, use the generator dispatch from the
base case. Using this setting, a single control variable is introduced to the system for each
selected generator. The total number of generator controls in this case equals the number of
selected generators and/or external networks.
Allow different dispatch: For each contingency case, allow a generator dispatch different to
that used in the base case. Using this setting, for each selected generator, a control variable
is introduced for the base case and for each contingency case. This option must be selected
from the drop-down box when the objective function Min. Generator Dispatch Change (Pre-
to-Postfault) has been selected. The total number of generator controls in this case equals:
(number of selected generators) * (1 + number of selected contingencies)
Transformer Tap Positions (ElmTr2, ElmTr3) Tap Positions in Contingencies
Use base case tap positions: For all contingency cases, use the transformer tap positions
from the base case. Using this setting, a single control variable is introduced to the system for
each selected transformer. The total number of tap controls in this case equals the number
of selected transformers.
Allow different tap positions: For each contingency case, allow tap positions different to
those used in the base case. Using this setting, for each selected transformer, a control
variable is introduced for the base case and for each contingency case. This option must be
selected from the drop-down box when the objective function Min. Transformer Tap Change
DIgSILENT PowerFactory 15, User Manual 733
CHAPTER 31. OPTIMAL POWER FLOW
(Pre-to-Postfault) has been selected. The total number of tap controls in this case equals:
(number of selected transformers) * (1 + number of selected contingencies)
Allow Load Shedding (ElmLod) A separate control variable is introduced to the system for the
base case and for each contingency case. This control variable can be selected in conjunction with
any objective function. The total number of load controls equals: (number of selected loads)*(1 +
number of selected contingencies)
Constraints
The Constraints section of the OPF dialogue for the contingency constrained DC optimization method
is shown in Figure 31.4.4.
This formulation of OPF performs a contingency analysis for a predened set of contingencies (Co-
mOutage objects; i.e. a set of interrupted components per contingency case). The Max. Loading
(parameter name: maxload) for lines and transformers (ElmLne, ElmTr2, ElmTr3; (one constraint per
bus)) for each contingency case is considered in the calculation. For each loading constraint, the num-
ber of constraints added to the LP will be: 2*(number of contingencies).
In addition to the constraints provided for DC optimization (for further information see Section 31.3.1:
Basic Options), the contingency constrained DC optimization method offers additional constraints:
Maximum Number of Tap Changes per Contingency If this checkbox is ticked, then for each
contingency, no more than the maximum tap position change steps from the base case to the
contingency case are allowed over all transformers (i.e. for a given contingency, a constraint is
enforced on the sum of all maximum difference of base case to contingency case taps, over all
transformers).
Transformer Tap Constraints (implicitly imposed) Minimum and maximum tap positions for
transformers(ElmTr2, ElmTr3) are considered. These constraints are implicitly imposed when
transformer tap positions are specied as controls in the Controls section of the OPF command
dialogue (see Figure 31.4.4). This leads to two constraints in LP formulation for the base case
tap position calculation, and to: 2 x (1 + number of contingencies) constraints for contingency
case calculations.
734 DIgSILENT PowerFactory 15, User Manual
31.4. CONTINGENCY CONSTRAINED DC OPTIMIZATION (LP METHOD)
Figure 31.4.4: Constraints Selection for OPF (Contingency Constrained DC Optimization Method)
Handling
Active power dispatch constraints can be chosen on an individual basis (via a checkbox) per generator.
See Figure 31.2.12 for setting minimum and maximum constraints for generators for optimization.
Tap position constraints will be implicitly imposed whenever the corresponding tap is a designated con-
trol variable, as illustrated in Figure 31.2.7. The tap position limits are dened in the transformers
assigned Type.
Loading constraints can be chosen on an individual basis (via a checkbox) per line element (ElmLne)
and per transformer element (ElmTr2, ElmTr3), as shown in Figure 31.2.11. Once a loading constraint
for a specic line or transformer is imposed, it will be considered by all contingencies contained in the
contingency list. If loading constraints are included, the maximum loading limits will be calculated with
respect to the type of the element, or with respect to a thermal rating object (IntThrating, as shown
in Figure 31.3.5). If a thermal rating object is selected, the limits will be calculated with respect to the
Continuous Rating value.
Boundary ow constraints can be chosen on an individual basis per boundary (ElmBoundary), as shown
in Figure 31.2.14. Once a boundary constraint for either the maximum total active power limit or min-
imum total active power limit is imposed, it will be considered by all contingencies in the contingency
list.
The list of contingencies to be considered by the OPF is selected by choosing a specic contingency
analysis command (parameter Contingency Analysis in the OPF dialogue, Basic Options tab), which
contains in its folder the contingency objects (ComOutage) to be considered.
DIgSILENT PowerFactory 15, User Manual 735
CHAPTER 31. OPTIMAL POWER FLOW
31.4.2 Initialization
As described for DC optimization. Please refer to Section 31.3.2 (Initialization).
31.4.3 Advanced Options
As described for DC optimization. Please refer to Section 31.3.3 (Advanced Options).
31.4.4 Iteration Control
As described for DC optimization. Please refer to Section 31.3.4 (Iteration Control).
31.4.5 Output
For contingency constrained DC OPF, results can be optionally recorded for those branches which
exceed a selected limit value. This can be done for both the non-optimized results and the optimized
results. For each recording of results (i.e. with optimized or non-optimized values) a separate result le
must be chosen.
Figure 31.4.5: Output Settings for OPF (Contingency Constrained DC Optimization Method)
Contingency Analysis Results
Allows the selection of result les for the contingency analysis results with and/or without optimized
controls.
Results (before optimization) The result le in which to store the non-optimized results.
Results (after optimization) The result le in which to store the calculated (optimized) results.
Limits for Recording
The limits displayed here are set in the selected Contingency Analysis command on the Basic Options
page of the contingency analysis command dialogue. They dene the limits outside of which results
will be written to the result le(s). See Chapter 28: Contingency Analysis, Section 28.4.1 for further
information.
736 DIgSILENT PowerFactory 15, User Manual
31.4. CONTINGENCY CONSTRAINED DC OPTIMIZATION (LP METHOD)
Reports
Following a contingency constrained DC OPF calculation, the Output of Results command button on
the main toolbar becomes active. This command allows the printing of various reports, as illustrated in
Figure 31.4.6. The following reports are offered:
Optimal Solution Prints a detailed report to the output window, showing all optimal settings for
generators, transformers and loads, component-wise, for all contingencies. An additional ag
(Report only Contingency with max. Deviations) can be checked to show only the settings for the
contingency where the maximum deviation occurs.
Optimal Solution (per Contingency) Prints a detailed report to the output window, showing all
optimal settings, on a per-contingency basis.
Maximum Loadings Prints a detailed report to the output window showing the maximum load-
ings of components against the relevant contingency. The user may dene the loading limit for
which to report violations, and may select whether to report only the highest loadings for branch
components. Moreover, this report facilitates the display of results before and after the optimiza-
tion.
Loading Violations Prints a report to the output window showing components with loading vio-
lations, against the relevant contingency. The user may dene the loading limit for which to report
violations, and may select whether to report only the highest loadings for branch components.
Additionally, the reporting of violations in contingency cases may be suppressed if violations al-
ready exist in the base case.
Violations per Case Prints a report to the output window showing components with loading vio-
lations, on a per-contingency case basis. The user may dene the loading limit for which to report
violations, and may select whether to report only the highest loadings for branch components. Ad-
ditionally, the reporting of violations in contingency cases may be suppressed if violations already
exist in the base case.
DIgSILENT PowerFactory 15, User Manual 737
CHAPTER 31. OPTIMAL POWER FLOW
Figure 31.4.6: Output of Results Command for Contingency Constrained DC OPF)
738 DIgSILENT PowerFactory 15, User Manual
Chapter 32
Techno-Economical Calculation
32.1 Introduction
This chapter presents the tools available to perform Techno-Economical Calculations in PowerFactory
. It provides a general description, technical background, description of the command dialogues, and
an example calculation. The Techno-Economical Calculation (ComTececo) can be accessed from the
toolbar as shown in Figure 32.1.1
Techno-economical calculations are used to perform an economic assessment and comparison of net-
work expansions (projects) through an analysis of:
The cost of electrical losses.
The economic impact of failure rates (reliability).
Investment costs, including initial costs, initial value, scrap value, and expected life span.
Project timing.
Figure 32.1.1: How to access the Techno-Economical Calculation
DIgSILENT PowerFactory 15, User Manual 739
CHAPTER 32. TECHNO-ECONOMICAL CALCULATION
32.2 Requirements for Calculation
Prior to conducting a Techno-Economical Calculation, economic data should be dened within each
Expansion Stage (IntSstage). To dene economic data, right-click on the Expansion Stage, click Edit,
and select the Economical Data tab. Parameters to be dened are as follows:
Costs for expansion
Dene the Investment costs in k$, and Additional costs in k$/a.
Commercial equipment value
Dene the Original value in k$, Scrap value in k$, and Expected life span in years a. Note that the
Expected life span is used in the economic calculation, it does not take the Variation out of service at
the end of the expected life span.
32.3 Calculation Options
32.3.1 Basic Options Page
Calculation Points
Select to either Calculate:
once per year. Calculations are executed once per year from the 1st day of the Calculation Period
Start (01.01.XXXX, 00:00:00) to the last day of the year at the calculation period End (31.12.YYYY,
23:59:59).
for every expansion stage. Calculations are executed on the 1st day of the Calculation Period
Start, at the Activation Time of each Expansion Stage.
for user-dened dates. Calculations are executed on the 1st day of the Calculation Period Start,
at each user-dened date. To dene dates, Insert rows to the Calculation Points table and specify
the required dates. To automatically populate the table of calculation points with once per year
dates and for every expansion stage dates, select Get keyAll keyCalculation keyPoints. The dates
can then be edited as required (note that it is not possible to append rows beyond the end date).
Note: Irrespective of the calculation option selected, the results are reported annually. This provides
user-exibility to optimize the performance of the Techno-Economical Calculation, whilst retaining
the ability to compare annual results with different calculation options.
Strategy
Click Show Activated Variations to show Activated Variations. Only Expansion Stages within Activated
Variations, and an Activation Time within the Calculation Period will be considered by the calculation.
Calculatory Interest Rate
Specify the Calculatory Interest Rate to be used in the Net Present Value (NPV) calculations.
Tolerance
Specify a Tolerance for calculation points (in days) for activation of Expansion Stages. If, for example,
a calculation is to be performed once per year, and all Expansion Stages with Activation Times within
January of that year are to be considered as in-service for the entire year, a tolerance of 31 days could
be specied.
Load growth
Optionally Incorporate load growth in the calculation, to consider load growth within each calculation
740 DIgSILENT PowerFactory 15, User Manual
32.3. CALCULATION OPTIONS
interval. In contrast to the case where no load growth is incorporated and costs for a calculation period
are calculated at the beginning of that period, enabling this ag will lead to a second cost calculation at
the end of the current calculation period. Corresponding costs are then calculated based on both values.
Load growth is dened via parameter characteristics (see Chapter 16: Parameter Characteristics, Load
States, and Tariffs for details of how to dene parameter characteristics).
32.3.2 Costs Page
Optionally consider Losses, Interruption Costs, User-dened Costs, and Annual additional costs, and
select whether to Optimize Tie Open Points.
Losses
Optionally modify the Load Flow Calculation options via the pointer to the Load Flow Calculation
command.
Select whether to consider losses for the whole system, or for a user-dened set of substa-
tions/feeders. If more than one feeder or substation is selected, PowerFactory automatically
creates a Set within the active Study Case, by default named Techno-eco. Calc. - Substa-
tions/Feeder Set.
Dene the Costs for Losses (Load) in $/kWh, relating to line losses.
Dene the Costs for Losses (no Load) in $/kWh, relating to transformer no-load losses.
Interruption Costs
Modify the Reliability Assessment options. By default, a new Reliability Assessment command object
is created within the Techno-Economical command. See Chapter 29 for details of how to congure the
Reliability Command options. For a Techno-Economical calculation, it is generally recommended that
the following options are selected in the Reliability Assessment Command:
Basic Options Load ow analysis
Basic Options Distribution (Sectionalizing, Switching actions)
Advanced Options Automatic Power Restoration
Advanced Options Do not save corresponding events
User-dened costs
Optionally select a user-dened DPL Cost Assessment Script. This functionality may be required for
detailed analysis where factors besides losses and outage costs are to be considered in the calculation.
Annual additional costs
Optionally dene Annual additional costs in k$/a. These are costs that are to be applied irrespective
of the network development strategy.
Optimize Tie Open Points
Optionally select to calculate losses from the output of the TOPO calculation. The network open point(s)
will be re-congured during the Techno-Economical Calculation in order to minimize losses, in accor-
dance with the options selected in the TOPO command. By default, a new TOPO command object is
created within the Techno-Economical command. See Section 33.4: Tie Open Point Optimization, for
details on how to congure the TOPO command.
Note: If the costs of losses are not considered by the Techno-Economical command directly, Optimize
Tie Open Points may still be selected so that the impact of network switching conguration is con-
sidered by the calculation, where either Interruption Costs or Additional Costs is selected.
DIgSILENT PowerFactory 15, User Manual 741
CHAPTER 32. TECHNO-ECONOMICAL CALCULATION
32.3.3 Output Page
Results
A reference (pointer) to the result object.
Report
(Optionally) select the format of results printed to the output window. The report includes a summary of
selected calculation options, and annual costs, total costs, and Net Present Value (NPV).
32.4 Example Calculation
Consider the following Techno-Economical Calculation example, which also consolidates functionality
presented on the following topics:
Project Variations: Discussed in Chapter 15 (Network Variations and Expansion Stages).
Reliability: Discussed in Chapter 29 (Reliability Assessment).
Parameter Characteristics and Tariffs: Discussed in Chapter 16 (Parameter Characteristics, Load
States, and Tariffs).
The current year is 2010. There are four 12 MW loads connected to DoubleBusbar/A and Double-
Busbar/B. In the current arrangement the line Existing Line from Sub 1 is lightly loaded (see Fig-
ure 32.4.1).
High load growth is expected from 2010 to 2016, with constant demand thereafter. To model the
changes in demand, a One Dimension - Vector Characteristic from 2010 to 2020 has been dened
for each load. By setting the Study Time to 2014, it has been determined that Existing Line will be
loaded at close to the thermal rating in this year (see Figure 32.4.2).
Based on this, it has been determined that a new substation is required in 2015 to off-load the existing
line. Figure 32.4.3 shows the case with the Study Time set to 2015, and the new substation Sub 2 in
service. Half of the load from Sub 1 has been transferred to Sub 2. Note that the new substation has
been implemented as a PowerFactory Variation, and hence is shown with yellow dashed lines in cases
where the Study Time is prior to 2015.
742 DIgSILENT PowerFactory 15, User Manual
32.4. EXAMPLE CALCULATION
Figure 32.4.1: Example case,study time 2010
Figure 32.4.2: Example case,study time 2014
DIgSILENT PowerFactory 15, User Manual 743
CHAPTER 32. TECHNO-ECONOMICAL CALCULATION
Figure 32.4.3: Example case,study time 2015
However, the previous analysis has not considered the economic impact of interruption costs. In the
2010, when there is an outage of the line from Sub 1 there are no alternative paths to re-establish
supply to either load. With the new line and DoubleBusbar/A and B in service, there is an alternative
path to re-establish supply to loads in the event of an outage on either New Line or Existing Line.
To understand the economic implications of commissioning the project prior to 2015, in particular the
sensitivity of the cost of losses and cost of interruptions to the project commissioning date, a Techno-
Economical Analysis is performed for a number of Activation Times.
To perform the analysis, the Variation activation time T(act.) is varied from 2010 to 2015, and the Net
Present Value (NPV) of the Strategy is calculated over the period 2010 to 2020. In the example, outage
data has been entered for the lines New Line and Existing Line, and a Global Energy Tariff has
been dened for loads from the Reliability command Costs page. Due to the trade-off between Energy
Interruption Costs (increasing in this example due to load growth) and cost-benets associated with
delaying the project (based on the specied interest rate), the optimum year for project commissioning is
determined to be 2011, and not 2015. The NPV is around 11 % lower in 2011 than in 2015. Table 32.4.1
below summarizes the results of the Techno-Economical calculations.
Table 32.4.1: Summary of Calculation Results
Note: To automatically calculate the optimal Activation Time for an Expansion Stage, in the Data Man-
ager, right-click on the Expansion Stage, select Execute DPL Scripts and run the Efciency ratio
calculation script.
744 DIgSILENT PowerFactory 15, User Manual
32.4. EXAMPLE CALCULATION
DIgSILENT PowerFactory 15, User Manual 745
CHAPTER 32. TECHNO-ECONOMICAL CALCULATION
746 DIgSILENT PowerFactory 15, User Manual
Chapter 33
Distribution Network Tools
33.1 Introduction
The chapter presents the PowerFactory tools for assessment and optimization of distribution networks.
The areas of analysis are highlighted in Figure 33.1.1 Each section of this chapter introduces the tool,
presenting a general description, the objective function, the optimization procedure, and the command
dialogues.
Figure 33.1.1: How to access the Distribution Network Optimization tools
33.2 Voltage Sag
The Voltage Sag Table Assessment (ComVsag) can be used to assess the expected frequency and
severity of voltage sags within a network during an operating period, and determine the expected num-
ber of equipment trips due to deep sags. The PowerFactory Voltage Sag tool calculates a short-circuit
at the selected load points within the system and uses the failure data of the system components to
determine the voltage sag probabilities.
Voltage sag analysis is similar to probabilistic reliability analysis, in that it uses fault statistics to describe
the frequency of faults, and then use these statistics to weight the results of each event and to calculate
DIgSILENT PowerFactory 15, User Manual 747
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
the overall effects of failures. However, reliability analysis looks for sustained interruptions as one aspect
of quality of supply, whereas voltage sag analysis calculates the voltage drop during the fault until the
protection system has disconnected the defective component.
This section describes the calculation options, how to perform a Voltage Sag Table Assessment, and
how to view the results.
33.2.1 Calculation Options
33.2.1.1 Basic Options Page
Figure 33.2.1: Voltage Sag Table Assessment - Basic Options
Load selection
Reference to the set of load points. A load point can be dened by a busbar, terminal, or load.
Short-circuit command
Displays the short-circuit command that is used. The options for the short-circuit type will be changed
during the voltage sag calculation, depending on the Advanced Options specied in the ComVsag
dialogue. However, other settings can be inspected or changed by clicking on the Edit button ( ).
Results
Reference to the result le that is used for storage of results.
Exposed area limit
This denes the minimum remaining voltage for the voltage sag calculation to continue calculating short-
circuits at busbars which are further away from the selected load points. If short-circuits at all busbars
(at a certain distance away from all load points) result in voltages at the load points being higher than
this limit, then no further short-circuit will be analyzed.
748 DIgSILENT PowerFactory 15, User Manual
33.2. VOLTAGE SAG
33.2.1.2 Advanced Options Page
Figure 33.2.2: Voltage Sag Table Assessment - Advanced Options
TheAdvanced Options page shows the various short-circuit types that can be analyzed by the voltage
sag assessment command. All components for which a failure model has been dened use the same
short-circuit frequency. The relative frequency for each type of short-circuit is entered uniformly for all
components.
33.2.2 How to Perform a Voltage Sag Table Assessment
A voltage sag table assessment is performed in two phases:
1. A result le with remaining voltages and short-circuit impedances is created by executing the
ComVsag command. This can be done by selecting one or more nodes, right-clicking and execut-
ing the Calculate... Voltage sag table... option, or by initiating the command directly from the
main toolbar by clicking on the Voltage Sag Table Assessment icon ( ).
2. A voltage sag plot is created by selecting one or more of the nodes for which the ComVsag
command was executed, right-clicking and selecting the option Show Voltage Sag Plot...
Alternatively,
The Load selection in the ComVsag dialogue can be completed manually with a set of objects.
A load point is dened by a terminal, a busbar, or by a single-connection element (a load, motor,
generator, etc.). These kinds of elements can be multi-selected from the single-line diagram or
data manager. Once selected, right-click on them and select Dene... General Set from the
context-sensitive menu. This set can then be selected as the Load selection.
A voltage sag plot can be created on a virtual instrument page manually, and the load points can
then be selected from the list of analyzed load points.
If several objects are selected which are all connected to the same busbar, then that busbar will be
added only once to the set of load points.
The Load selection parameter in the voltage sag assessment command should be set to use the SetS-
elect which has the Used for: Voltage sag table ag set. However, any other selection can be assigned
to the Load selection.
The voltage sag analysis simulates various faults at the selected busbars. The calculation starts with
the selected load points, and proceeds to neighbouring busbars until the remaining voltage at all load
DIgSILENT PowerFactory 15, User Manual 749
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
points does not drop below the dened Exposed area limit. The remaining voltages and the short-circuit
impedances for all load points are written to the result le specied by the Results parameter.
After all relevant busbars have been analyzed, the sag table assessment continues by analyzing short-
circuits at the midpoint of all lines and cables that are connected between the relevant busbars. Again,
the remaining voltages and short-circuit impedances for all load points are written to the result le.
After the complete exposed area has been analyzed in this way, the result le contains the values for
Z F1, Z F2, Z F0, Z S1, Z S2, Z S0 and ura, uia, urb, uib, urc, uic for the two ends of all relevant lines
and cables and at their midpoints.
To reduce computation time, the written impedances are interpolated between the ends of a line and the
middle with a second-order polynomial. Then, the remaining voltages and various source impedances
are estimated. These estimated impedances are also interpolated between the ends and the midpoint.
The interpolated impedances are then used to estimate the remaining voltages between the ends and
the midpoints of the lines or cables. This quadratic interpolation gives a good approximation for longer
lines, as well as parallel lines.
33.2.3 Voltage Sag Table Assessment Results
The voltage sag tables are not calculated until a voltage sag plot is constructed. Upon reading the
remaining voltages, short-circuit frequencies and short-circuit impedances from the result le, a voltage
sag table is constructed for each selected load point. Figure 33.2.3 shows the voltage sag plot dialogue.
Figure 33.2.3: Voltage Sag Plot Dialogue
750 DIgSILENT PowerFactory 15, User Manual
33.2. VOLTAGE SAG
Because there is no single denition of a voltage sag, the plot offers a selection of sag denitions:
Minimum of Line-Neutral Voltages.
Minimum of Line-Line Voltages.
Minimum of Line-Line and Line-Neutral Voltage.
Positive Sequence Voltage.
Secondly, the x-variable against which the sag frequency will be shown has to be selected. Possible
x-variables are:
Remaining Voltage.
Nom. Voltage at Shc-Busbar.
Fault Clearing Time.
Short-Circuit Type.
Additionally, the x-variable can be sub-divided according to a split-variable (parameter name: Split Bars
in). Possible split variables are:
no split.
any of the possible x-variables.
The same parameter cannot be selected for the x-variable and the split-variable. An example of the
resulting voltage sag plot, in accordance with the settings shown in Figure 33.2.3 is shown in Fig-
ure 33.2.4.
Figure 33.2.4: Example Voltage Sag Plot
The voltage sag plot always shows the annual frequency of occurrence on the y-axis.
The example plot shows a bar for each load point for each x-variable, which is the Remaining Voltage.
All three loads can be seen to suffer either deep sags (remaining voltage less than 0.4 p.u.), or shallow
DIgSILENT PowerFactory 15, User Manual 751
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
sags, although the values at 0.8 p.u. are also signicant. Each bar is subdivided to the nominal voltage
at SHC-Busbar. The shallow sags are caused by the low voltage network, as well as the deep sags.
The high voltage network seems to cause moderate voltage sags. This is caused by the fact that the
low voltage networks in this example are radially operated and the higher voltage networks are meshed.
More detailed information about a specic value in the voltage sag plot can be viewed in the balloon
help that appears when placing the mouse over a bar or part of a bar (without clicking).
The voltage sag plot dialogue has a Report button (see Figure 33.2.3) which outputs the voltage sag
plot data to the output window. A table for each selected load point will be written in accordance to the
selected Voltage Sag denition, x-Variable and Split Bars in selection.
33.3 Voltage Prole Optimization
The Voltage Prole Optimization (VPO) command (ComVoltplan) is used to optimize distribution trans-
former taps over the expected range of network load and generation conditions. It can be selected from
Distribution Network Tools, as shown in Figure 33.1.1.
The VPO calculation considers two scenarios:
A maximum demand/minimum generation scenario, or Consumption Case.
A minimum demand/maximum generation scenario, or Production Case.
It requires that loads be represented as medium voltage (MV) loads (ElmLodmv). MV load elements in-
clude transformer and LV network parameters, as illustrated in Figure 33.3.1. To show Terminal colour-
ing based on maximum / minimum LV grid voltages, from the main menu select View Diagram
Colouring (or select the Diagram Colouring icon). Under 3. Other select Results Voltages / Loading.
Click on Colour Settings, go to second page of the Voltages / Loading page, and select Consider LV
grid voltages for colouring. In the example below, the minimum voltage is below the lower limit and the
maximum voltage is above the upper limit (the limits set in the colouring options), therefore the terminal
shows two colours.
752 DIgSILENT PowerFactory 15, User Manual
33.3. VOLTAGE PROFILE OPTIMIZATION
Figure 33.3.1: MV load example
Note: The transformer tap changer is represented on the LV side of the MV load.
33.3.1 Optimization Procedure
The optimization procedure is summarized as follows:
1. If Distribution Transformer Tap Limits are specied by the user, limit the tap range of transformers
to within the limits Min. allowed tap position and Max. allowed tap position. This is illustrated in
Figure 33.3.2, where a transformer with seven tap positions is limited to taps -1 to 2 to limit the
transformer voltage rise to 7 % and voltage drop to -5 %. The height of each bar is determined by
the voltage rise and voltage drop across the transformer in the production and consumption cases
respectively.
DIgSILENT PowerFactory 15, User Manual 753
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
Figure 33.3.2: Distribution Transformer Tap Limits
2. Calculate the Upper tap limit and Lower tap limit, based on settings that will keep the range of
expected LV Grid voltages within the Upper voltage limit and Lower voltage limit, as illustrated in
Figure 33.3.3, where the limits are set to between 0.92 pu and 1.10 pu.
3. Both tap positions 0 and 1 would be acceptable, and maintain transformer voltage drop and LV
grid voltages within acceptable limits. The optimization routine selects the lower tap limit (position
0 in Figure 33.3.3) in order to minimize the voltage rise.
754 DIgSILENT PowerFactory 15, User Manual
33.3. VOLTAGE PROFILE OPTIMIZATION
Figure 33.3.3: Voltage Limits for LV Grids
The possible scenarios for optimization are summarized as follows:
1. There is a single tap position that will satisfy both LV grid lower and upper voltage limit -> this tap
is selected.
2. There are tap positions that will satisfy both LV grid lower and upper voltage limits -> the lowest
tap position is selected in order to favour limiting voltage rise in the production case.
3. There are tap positions that will satisfy the LV grid upper voltage limit, but all of them violate the
lower voltage limit -> the highest tap position that will not violate the upper voltage limit is selected.
4. There are tap positions that will satisfy the LV grid lower voltage limit, some of which will violate
the upper voltage limits -> the tap position that will not violate the upper voltage limit is selected,
even if lower voltage limits are violated further as a result.
5. There are no tap position/s that will satisfy both LV grid lower and upper voltage limits -> the
lowest tap position is selected in order to minimize voltage rise in the production case.
Note that Distribution Transformer Tap Limits, if specied in the Advanced Options, take precedence
over the Upper and Lower Voltage limits specied in the Basic Options.
33.3.2 Basic Options Page
Load Flow Calculation
This is a reference (pointer) to the load-ow command used by the optimization algorithm.
Voltage Limits for LV grids
Upper and lower voltage limits for LV grids (in per unit).
DIgSILENT PowerFactory 15, User Manual 755
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
Settings for Consumption Case
MV load and generation scaling factors for the consumption case. Generally, the consumption case will
have high demand (e.g. 100 %) and low generation (e.g. 0 %).
Settings for Production Case
MV load and generation scaling factors for the production case. Generally, the production case is the
opposite of the consumption case, and will have low demand (e.g. 25 %) and high generation (e.g. 100
%).
Show Load ow with optimized Transformer Taps, for
After the optimization of transformer taps for the consumption and production cases, a load ow is
calculated using the optimized tap settings. This radio button selects whether the load ow results
shown are for the consumption or production case.
33.3.3 Output Page
Report
A reference (pointer) to the result report output. It is possible to select the reports to be displayed, and
whether they are shown in Tabular or ASCII format.
33.3.4 Advanced Options Page
Distribution Transformer Tap Limits
Transformer Maximum Allowed Voltage Rise and Maximum Allowed Voltage Drop can optionally be
specied. These limits take precedence over the voltage limits specied on the Basic Options page.
33.3.5 Results of Voltage Prole Optimization
The result of a voltage prole optimization is a tabular or ASCII report with the recommended tap set-
tings, including details of MV loads with Critical Voltage Drop or Rise. An example of the Optimal
Transformer Tap Positions section of the report is shown below in 33.3.4 (results consistent with Fig-
ure 33.3.1, and the discussion in Section 33.3.1).
Figure 33.3.4: Voltage Prole Results
The recommended tap settings are also available from the exible data page of MV loads under the
load-ow calculation parameter c:nntap. To update the network model with the recommended tap
settings, the user may either manually adjust MV load tap positions, or click the Update Database icon
on the main toolbar ( ), and update the case with the calculated Distribution Transformer Taps. To
display a plot of the resultant prole for one feeder for both the consumption and production case, select
the Voltage Prole Plot icon ( ). Figure 33.3.5 shows an example plot, where:
min v and max v are the minimum and maximum transformer HV side voltages.
uminLV and umaxLV are the minimum and maximum transformer LV side voltages.
756 DIgSILENT PowerFactory 15, User Manual
33.4. TIE OPEN POINT OPTIMIZATION
uminLVfeed and umaxLVfeed are the minimum and maximum LV grid voltages.
Figure 33.3.5: Voltage Prole Plot
33.4 Tie Open Point Optimization
The function of the Tie Open Point Optimization (TOPO) (ComTieopt ) is to optimize a radial system
of connected feeders by determining the best location for network open points. An open point can be
moved by the TOPO tool by opening and closing switches on the networks to be optimized.
This chapter is separated into three sub-sections. Firstly, the steps to access the TOPO tool are de-
scribed. Next, the background and function of the TOPO tool is presented and nally the procedure for
running a Tie Open Point Optimization is described. The Tie Open Point Optimization Command can
accessed as shown in Figure 33.1.1
33.4.1 Tie Open Point Optimization Background
The function of the Tie Open Point Optimization (TOPO) tool is best explained using an example. Con-
sider the network illustrated in Figure 33.4.1
DIgSILENT PowerFactory 15, User Manual 757
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
Figure 33.4.1: Example network for Tie Open Point Optimization
The network consists of three feeders, one from each of the three stations. Each feeder begins at a
station and ends at one of the two illustrated open points. The two open points in this network are not
necessarily the optimum open points. For example, it might be more economic (i.e. less network losses
and / or less impact of outages) to shift these open points by closing the open switches and opening
two switches in different positions on the feeders. The purpose of the TOPO tool is determine these
optimum open points automatically. Additionally, the TOPO tool can automatically consider network
voltage and thermal constraints - for instance it might be economic to shift an open point in terms of
reducing systems losses, however doing so might cause a cable to overload.
33.4.2 How to run a Tie Open Point Optimization
This section describes the procedure for running a Tie Open Point Optimization (TOPO) calculation.
The steps are summarized below, and discussed in more detail in the following sections:
How to Create Feeders.
How to congure the Tie Open Point Optimization Command.
How to congure constraints for the Tie Open Point Optimization.
How to congure the Advanced Options.
How to congure Reliability Options.
How to Create Feeders
The TOPO tool requires that feeders are dened for the section of the network that you wish to opti-
mize. Additionally, the TOPO tool only works on radial feeders - mesh systems cannot be optimized
758 DIgSILENT PowerFactory 15, User Manual
33.4. TIE OPEN POINT OPTIMIZATION
automatically. Furthermore, it is recommended that the target feeders for optimization do not have any
overloaded components or voltage violations in the base case.
To dene a feeder, right-click the cubicle at the beginning of the feeder and select the Dene Feeder.
Alternatively, for fast creation of multiple feeders right-click the bus the feeder/s are connected to and
select the option Dene Feeder. More information on feeders and feeder creation can be found in
Chapter 13: Grouping Objects, Section 13.5.
How to congure the Tie Open Point Optimization Command
After a set of feeders has been dened, open the TOPO tool and congure the basic options:
1. Click the Change Toolbox icon ( ) and select Distribution Network Tools.
2. Open the dialogue for the Tie Open Point Optimization tool ( ).
3. Use the selection control for Feeding Points to select previously dened feeder/s, or a feeder
Set. If the Select option is chosen and multiple feeders are selected, a Set of feeders will
automatically be created within the active study case. By default the set will be named Tie Open
Point Optim. - Feeder Set.
Note: It is generally recommended to dene all feeders in the network as Feeders, and to conduct
a TOPO calculation for All Feeders.
4. Select the desired Objective Function to minimize losses and / or reliability indices. If Optimization
of Reliability Indices or Cost Optimization (Losses + Reliability) is selected, complete the required
elds on the Reliability page, see (How to congure Reliability Options).
5. Balanced, positive sequence or Unbalanced network representation can be selected. The
Load-ow command referenced below these radio buttons is automatically adjusted to the correct
calculation method based on this selection.
6. Optional: You can inspect and alter the settings of the load-ow command that is used for deter-
mining the losses and identifying the constraints of the system by clicking the blue selection arrow
next to load-ow command.
7. Optional: Change the Saving of solution option. The two options are as follows:
Change Existing Network (Operation Scenario). This is the default option. The TOPO tool
modies the base network model. Note that if a variation is active, the changes will be
implemented in the variation.
Record to Operation Scenario. If you choose this option a selection control appears and you
can choose an existing operation scenario to save the results of the Optimization procedure
to. Alternatively, you can leave the selection empty and PowerFactory automatically activates
a new Operation Scenario called Tie Open Point Optimization Results. Any changes made
to the network as a result of the optimization procedure are stored within this operation sce-
nario. You can revert to the original network by disabling the scenario.
8. Optional: Disable the Report ag. This control, enabled by default, allows you to turn off the
automatic printing of an ASCII report to the output window.
9. Optional: Select the Before Optimization and After Optimization results objects.
How to congure constraints for the Tie Open Point Optimization
It is optional whether you choose to consider thermal and voltage constraints for the Tie Open Point
Optimization. If you wish to consider constraints follow these steps:
1. Open the Tie Open Point Optimization dialogue and select the Constraints page.
DIgSILENT PowerFactory 15, User Manual 759
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
2. Optional: Choose to enable or disable the option Consider Thermal Constraints. If enabled, the
TOPO tool will automatically consider thermal constraints in the network. Therefore, if an optimal
point were to cause an thermal overload on any system component, then this would not be con-
sidered as a valid open point for reconguration of the system. There are two more options for
thermal constraints:
Global constraint for all components. This is the default option. If enabled you must enter a
maximum thermal loading percentage in the Max. thermal loading of components eld. Note
this option overrides the individual component thermal limits.
Individual constraint per component. Select this option to automatically consider each com-
ponents unique thermal rating. Note, the thermal rating for each component is determined
by the eld Max Loading within the Tie Open Point Optimization page of each component.
3. Optional: Choose to enable or disable the option Consider Voltage Constraints. If this option is
enabled then each terminal in the system is checked against the Lower and Upper limit of allowed
voltage. If a particular open point causes a voltage violation, then such an open point cannot be
considered as optimal. There are two options for conguring the upper and lower voltage limits:
Global constraints for all terminals (absolute value). If you choose this option then you must
enter an upper and lower voltage limit in the two corresponding elds within this dialogue
box.
Individual constraint per terminal. If you choose this option, then each terminal has a unique
voltage limit which is assigned on the Tie Open Point Optimization page of each terminal
(note that this excludes Substation internal nodes).
4. Optional: Choose to enable or disable the option Consider Voltage Drop / Rise. If this option is
enabled then each feeder in the system is checked against the Maximum Voltage Drop / Rise. If
a particular open point causes a voltage violation, then such an open point cannot be considered
as optimal. There are two options for conguring the maximum voltage drop / rise limits:
Global constraints for all feeders (percent). If you choose this option then you must enter the
Maximum Voltage Drop and Maximum Voltage Rise in the two corresponding elds within
this dialogue box.
Individual constraint per feeder. If you choose this option, then each feeder has a unique
voltage drop / rise limit which is assigned on the Tie Open Point Optimization page of each
feeder.
5. Choose the ignore all constraints for... option. You can use these options to optionally ignore
constraints where the nominal voltage is above or below user-dened thresholds entered here.
This can be useful for example to exclude all LV systems (say less than 1 kV) from the constraints
identication process as it may be acceptable to have these systems outside the normal range.
How to congure the Advanced Options
The options in the Advanced page can generally be left on default values. The options are described
as follows:
Switches to be optimized. These options congure the switches / elements considered by the
optimization procedure.
All switches. All switches will participate in the optimization.
Selected switches. Only the selected switch types will participate in the optimization. For
example, if Circuit-Breaker and Load-Breaker-Switch are ticked, then both circuit breakers
and load breakers will be considered by the optimization. The switch type is dened on the
switch element Basic Data page. Similar to Switch type, only the selected control types will
participate in the optimization. The control type is dened in switch element Reliability page
in the Sectionalizing eld. Switches are considered in the optimization only when its switch
type AND the control type satises the selected settings.
760 DIgSILENT PowerFactory 15, User Manual
33.5. BACKBONE CALCULATION
Assume each edge element is switchable. If selected, lines that do not have a switch can
also be switchable (either out of service or in service).
Maximum number of outer loops. This option controls the maximum number of outer loops which
is the total number of times the optimization procedure will be repeated when searching for an
optimal solution.
Maximum change in system losses. This option determines the threshold above which a change
in open point is considered. If the reduction in losses is below this threshold, the iteration will stop.
Constraint Priority options can be selected for the relevant constraints. For example, consider the
following scenario:
The TOPO calculation is to consider Global Thermal constraints, with the Max. thermal
loading of components set to 100 %, and Global Voltage Constraints with a Lower limit of
0.90 pu.
The constraint priorities for loading constraint is set to 1, and for voltage lower limit is set to
3.
In the current conguration, a line is loaded to 102 % of rating.
Shifting the open point causes the voltage at a terminal on an adjacent feeder to decrease 5
% below 0.90 pu (i.e. 0.855 pu).
As a result of the priorities, the thermal loading deviation will be penalized to a greater
extent than the voltage deviation, and the open point will change, despite the resultant voltage
deviation.
How to congure Reliability Options
If Optimization of Reliability Indices is selected, the user may select between optimization of SAIFI or
EPNS indices on the Reliability page. Where:
SAIFI (System Average Interruption Frequency Index) in units of [1/C/a], indicates how often the
average customer experiences a sustained interruption in one year. Note that the number of
customers at each load should be dened on the Reliability page.
EPNS (Expected Power Not Supplied) is in units of [MW]. Multiplying EPNS by the study duration
gives the expected energy not supplied.
Contingency denitions can be optionally considered for Busbar / terminals, Lines / Cables, and Trans-
formers.
If Cost Optimization (Losses + Reliability) is selected, Costs for Losses and Interruption costs per cus-
tomer should be dened, as these are used in the Objective Function calculation to determine the
network conguration that optimizes both Losses and Reliability.
33.5 Backbone Calculation
This section describes the Backbone Calculation command (ComBbone) dialogues and presents an
example calculation. To run a Backbone Calculation, either:
Select the Backbone Calculation icon under Distribution Network Tools as shown in Figure 33.1.1.
From the Data Manager select and then right-click previously dened feeders and click Calculate
Backbone Calculation....
From the main menu, select Calculation Distribution Network ToolsBackbone Calculation.
DIgSILENT PowerFactory 15, User Manual 761
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
The Backbone Calculation is used to determine the main paths between adjacent feeders connected via
open points, that may serve to restore lost load in case of failures inside a feeder. The command creates
objects in the Network Data folder (ElmBbone) with the Backbones constituent network elements. This
simplies visualization of the main path(s) between feeder(s), particularly in large distribution networks
where the main paths may not be apparent from the single line diagram.
Backbone objects are created for all feeders or a user-dened set of feeders based on path load, cross-
section, network structure, or scoring method criteria. The command can optionally consider existing
remote controlled switches at open points, and the availability of connections to alternative transformers
or substations when creating Backbones.
From the Backbone dialogue, the Backbone contents (elements) can be viewed, marked in the graphic,
and checked (see example in Section 33.5.4). The Check Backbone button is used to verify that the
backbone object still denes a valid inter-feeder path matching its calculated parameters.
33.5.1 Basic Options Page
Generate backbones
Specify all feeders or a user-dened set of feeder/s for the Backbone Calculation.
Calculation based on:
Path load: Backbones are determined based on the MVA load on the paths between adjacent
feeders.
(Optional) specify the max. number of backbones per feeder.
Optionally select to Report results to the output window, including details of backbone open
points.
Pointer to load-ow command (note for balanced calculations only).
Note: For calculations based on path load, feeder is supposed to be operated radially must be
selected on the Basic Options page of the Feeder/s selected for the Backbone calculation,
as well as all connected feeders.
Cross section: Backbones are determined based on the cross-section of lines/cables connecting
adjacent feeders.
(Optional) specify the max. number of backbones per feeder.
Choose to determine backbone using either the mean cross section of lines in the path or
the minimum cross section in path.
Optionally select to Report results to the output window, including details of backbone open
points, and minimum and mean cross-section.
Network structure: Backbones are determined based on the network structure. If none of the
options are selected, Backbones are calculated for all feasible inter-feeder paths.
(Optional) create backbones only if path leads to different substation.
(Optional) create backbones only if path leads to different HV/MV-transformer.
(Optional) create backbones only if tie open point is remote-controlled (as specied on the
Reliability page of each switch).
Optionally select to Report results to the output window, including details of backbone open
points.
Scoring method: Backbones are determined using a scoring algorithm based on the restoration
ability of the adjacent feeder. Scoring method settings are entered on the Scoring Settings page.
762 DIgSILENT PowerFactory 15, User Manual
33.5. BACKBONE CALCULATION
(Optional) specify the max. number of backbones per feeder.
Optionally select to Report results to the output window, including details of backbone open
points, and loading/voltages of limiting elements.
Pointer to load-ow command (note for balanced AC calculation only).
Note: For calculations based on scoring method, feeder is supposed to be operated radially must
be selected on the Basic Options page of the Feeder/s selected for the Backbone calculation.
33.5.2 Scoring Settings Page
If scoring method is selected on the Basic Options page, enter scoring settings on the Scoring Set-
tings page. Backbones are determined based on the restoration ability of every inter-feeder path using
Topology, Loading violation, and Voltage violation criteria.
For each criteria satised, the path receives the entered number of points. The path with the greatest
number of points is the winning path.
Topology scoring
Dene scoring settings for Topology scoring criteria:
Path leads to different substation.
Path leads to different HV/MV-transformer.
Tie open point is remote controlled.
Greater than a specied number of remote-controlled switches on path. A path to another Feeder
receives the entered number of points if more (closed) remote-controlled switches than the entered
number are on the path of the Backbone contained in the initial feeder.
Loading violation scoring
Assign Points for loading violations based on individual loading constraints or global loading constraints.
If no element is overloaded, the calculation assigns the specied number of points. If global loading
constraints is selected, then Max. Loading should also be dened.
Dene scoring settings for Loading violation scoring criteria:
Restoring transformer (restoration mode). Consider a path from initial feeder A to feeder B.
Feeder A is de-energized and the connection to feeder B via the tie open point is closed.
A load ow is calculated in this so-called restoring mode and the entered number of points is
assigned if the supplying HV/MV-transformer is not overloaded.
On backbone of restoring feeder (normal mode). Consider a path from initial feeder A to feeder
B. A load ow is calculated (in so-called normal mode) and the entered number of points is
assigned if no element on the potential backbone path contained in feeder B, the restoring
feeder is overloaded in the base case.
On complete backbone (restoration mode). Consider a path from initial feeder A to feeder B.
Feeder A is de-energized and the connection to feeder B via the tie open point is closed. A load
ow is calculated in this so-called restoring mode and the entered number of points is assigned if
no element on the potential backbone path is overloaded.
In complete feeder (restoration mode). Consider a path from initial feeder A to feeder B.
Feeder A is de-energized and the connection to feeder B via the tie open point is closed.
A load ow is calculated in this so-called restoring mode and the entered number of points is as-
signed if no element in the complete resulting feeder is overloaded (not only on the backbone as
for the previous option).
DIgSILENT PowerFactory 15, User Manual 763
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
Voltage violation scoring
Dene scoring settings for voltage violation criteria based on individual voltage drop/rise constraints or
global voltage drop/rise constraints. If global voltage drop/rise constraints is selected, then Max. drop
and Max. rise should also be dened. If no voltage limits are violated, the calculation assigns the
specied number of points.
On backbone of restoring feeder (normal mode). Consider a path from initial feeder A to feeder
B. A load ow is calculated (in so-called normal mode) and the entered number of points is
assigned if no terminal on the potential backbone path contained in feeder B violates its voltage
drop constraint and voltage rise constraint.
On complete backbone (restoration mode). Consider a path from initial feeder A to feeder B.
Feeder A is de-energized and the connection to feeder B via the tie open point is closed. A load
ow is calculated in this so-called restoring mode and the entered number of points is assigned if
no terminal on the potential backbone path violates its voltage drop and rise constraint.
In complete feeder (restoration mode). Consider a path from initial feeder A to feeder B.
Feeder A is de-energized and the connection to feeder B via the tie open point is closed.
A load ow is calculated in this so-called restoring mode and the entered number of points is as-
signed if no terminal in the complete resulting feeder violates its voltage drop and rise constraint
(not only on the backbone as for the previous option).
33.5.3 Tracing Backbones
When a Backbone is calculated, it always contains a connection to another Feeder via a tie open point.
In the worst case of an outage close to the feeding point of the initial feeder, the initial feeder is de-
energized by opening its feeding switch and restored by the second Feeder via the tie open point. These
restoration steps can be simulated for an existing Backbone using the Backbone trace functionality. The
trace buttons are located beside the ComBbone command, and can also be accessed via the main
menu Calculation Distribution Network ToolsStart trace....
33.5.4 Example Backbone Calculation
Consider a case where there are two parallel feeders with multiple open-points. A Backbone calculation
is conducted based on a criteria of minimum cross section in path, and with the Max. number of
backbones per feeder set to 1. Backbone objects are created within the Network Data folder.
To highlight Backbones, from the main menu select View Diagram Colouring (or select the Diagram
Colouring icon). Under 3. Other select TopologyFeeders. Click on Colour Settings, and on the Feeders
page select Highlight backbones.
Figure 33.5.1 shows the result, where the path through Open Point 2 is highlighted as a result of the
cross section of conductors in this path. Refer to section 33.5.3 for details of how to trace the Backbone
restoration steps.
764 DIgSILENT PowerFactory 15, User Manual
33.6. OPTIMAL RCS PLACEMENT
Figure 33.5.1: Example Backbone Calculation
33.6 Optimal RCS Placement
Following a Backbone Calculation (see Section 33.5), an Optimal Remote Control Switch (RCS) Place-
ment can be performed to optimize placement of remote control switches within a feeder/s. The calcula-
tion optimizes placement of a xed number or optimal number of switches per feeder or backbone, with
an objective function that minimizes Energy Not Supplied (ENS), balances ENS, or minimizes Expected
Interruption Costs (EIC). The Optimal RCS Placement command is a heuristic planning tool, and may
precede a detailed reliability analysis.
To conduct an Optimal RCS Placement, reliability data should be specied on the Reliability page of
line elements (outages of other elements are not considered). See Chapter 29: Reliability Assessment,
Section 29.3 for details.
If the cost of interrupted load is to be considered, a global Energy Tariff must be dened, see Chapter 16,
Section 16.5.2: Dening Energy Tariffs for details.
The Optimal RCS command can be selected under Distribution Network Tools, as shown on Fig-
ure 33.1.1 This section describes the Optimal RCS Placement objective function and command dia-
logues, and provides an example calculation.
Note: The Optimal RCS calculation requires that feeder is supposed to be operated radially be se-
lected on the Feeder Basic Options page.
33.6.1 Basic Options Page
Calculate optimal RCS
Specify all Feeders or a user-dened set of Feeder/s for the Optimal RCS calculation. To show the
Backbones to be considered by the calculation, select Active Backbones.
Objective Function :
The objective function of the Optimal RCS Placement command can be set to either:
Minimize ENS by installing a specied number of RCS per feeder / backbone to minimize the
Energy Not Supplied.
DIgSILENT PowerFactory 15, User Manual 765
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
Balance ENS by installing an optimal or xed number of RCS per feeder / backbone to balance
the Energy Not Supplied. This option may be used in some circumstances to plan the network
in a way that considers connections with many (or large) customers and connections with few (or
small) customers equitably.
Minimize EIC by installing an optimal or xed number of RCS per feeder / backbone to minimize
the Expected Interruption Cost.
If this option is selected, a global Energy Tariff must be dened (see Chapter 16, Sec-
tion 16.5.2: Dening Energy Tariffs).
Number of RCS:
With an objective function to Minimize ENS, specify:
Number of new RCS per feeder / backbone.
With an objective function to Balance ENS or Minimize EIC, select to either Optimize number of
RCS or Fix number of new RCS.
Specify the Number or Maximum number of new RCS per feeder / backbone.
If the objective function is set to Minimize EIC, enter the Yearly costs per RCS in $ per annum.
Recording of results
Select calculate results only to perform a calculation without making an modications to the net-
work.
Select save results in variations to save the results to a Variation. Note that by default the variation
will be inactive after running the Optimal RCS Placement.
Select to change existing network to change the existing network. Note that this changes object
data in the base network.
33.6.2 Output Page
Results
A reference (pointer) to the result object.
Report
(Optionally) select the format of results printed to the output window. The report provides details of
the recommended remote control switches and their costs, and depending on the selected objective
function, energy not supplied or interruption costs results.
33.6.3 Advanced Options Page
Determine optimal RCS
Select to either determine optimal RCS per feeder or per backbone. Note that the calculation is con-
ducted once for each feeder in the feeder selection from the Basic Options page.
Optimization of RCS of feeders
Select to either optimize RCS for all backbones, or only for backbones up to a specied order (in which
case, dene the maximum order). Note that if more than one backbone has been created for a feeder,
the main backbone will have order 1, the second best candidate has order 2, and so on.
766 DIgSILENT PowerFactory 15, User Manual
33.6. OPTIMAL RCS PLACEMENT
Consider existing RCS on participating backbones:
Optionally select to consider existing RCS on participating backbones. If not selected, the RCS Place-
ment will be performed from scratch, without considering existing RCSs.
Detailed output of results:
Optionally select detailed output mode to output additional details by Section, such as ENS, FOR, and
EIC (depending on the optimization option selected).
Switching Time:
Set the Time to actuate RCS and Time to actuate manual switches (applied for all switches). These
parameters are used by the calculation to determine ENS and EIC.
Load ow calculation
Pointer to load-ow command (note for balanced calculations only).
33.6.4 Example Optimal RCS Calculation
Consider the simple example shown in Figure 33.6.1 where two feeders with three loads each are
separated via three open points. Line outage rates and load parameters have been dened. To illustrate
line Forced Outage Rates, fromthe main menu select View DiagramColouring (or select the Diagram
Colouring icon). Under 3. Other select Primary Equipment Forced Outage Rate. In the example,
there is a requirement to install a single Remote Control Switch (RCS) on each feeder to minimize the
ENS.
Figure 33.6.1: Example Optimal RCS Model
To calculate the optimal location(s) for remote controlled switches, a Backbone Calculation for all feeders
based on network structure is rst executed (see Section 33.5 for details of how to run the Backbone
Calculation).
DIgSILENT PowerFactory 15, User Manual 767
CHAPTER 33. DISTRIBUTION NETWORK TOOLS
Next, an Optimal RCS calculation is executed for all feeders, with an objective function to Minimize ENS,
limited to 1 RCS per backbone. Note that the calculation will run twice in this example (once for each
feeder), and so two RCSs will be recommended.
The calculation simulates outages of each line, and calculates the ENS for placement of RCSs at each
location. In order to mitigate the impact of outages (in particular, from the problem line Line(1)) the
calculation recommends installation of remote control switches at locations Switch2 and Switch5 to
minimize the ENS.
768 DIgSILENT PowerFactory 15, User Manual
Chapter 34
Optimal Capacitor Placement
34.1 Introduction
The objective of this chapter is to present PowerFactory tools for Optimal Capacitor Placement. Other
Distribution Network Optimization tools are discussed in Chapter 33 (Distribution Network Tools).
34.2 Optimal Capacitor Placement
Optimal Capacitor Placement (OCP) is an automatic algorithm that minimizes the cost of losses and
voltage constraints (optional) in a distribution network by proposing the installation of new capacitors
at terminals along the selected feeder/s. The optimal size and type of capacitor is selected from a
list of available capacitors entered by the user. The algorithm also considers the annual cost of such
capacitors and only proposes new capacitors for installation when the reduction of energy loss and
voltage constraint costs exceeds the annual cost of the capacitor (investment, maintenance, insurance
etc).
To access the OCP tool, select the OCP toolbar from the toolbar selection window as illustrated in
Figure 34.2.1.
Figure 34.2.1: Optimal Capacitor Placement Tools
The buttons in the OCP toolbar are as follows:
DIgSILENT PowerFactory 15, User Manual 769
CHAPTER 34. OPTIMAL CAPACITOR PLACEMENT
The main Optimal Capacitor Placement command is started with the Calculate Optimal Capacitor
Placement icon ( ). The command and the various user-dened options are described in detail
in Sections 35.2.1 to 34.2.6.
After a successful optimization, the list of nodes (terminals) where capacitors are proposed for
installation can be accessed by selecting the Show nodes with New Capacitors icon ( ).
Following a successful OCP, the list of proposed capacitors can be accessed with the Show New
Capacitors icon ( ).
The Remove previous solution icon ( ) deletes the results (removes all placed capacitors) from
a previous OCP routine.
To list all results from the OCP in a ASCII text report printed to the output window use the Output
Calculation Analysis icon ( ). The report also displays the original system losses and voltage
constraint costs and such costs after the installation of the proposed capacitors.
34.2.1 OCP Objective Function
The OCP optimization algorithm minimizes the total annual network cost. This is the sum of the cost of
grid losses, the cost of installed capacitors, and optionally the ctitious penalty cost of voltage violations:
TotalCosts = CLosses +
m
i=1
(CCap
i
) +
n
i=1
(CV oltV iol
i
) (34.1)
Where:
CLosses is the annual cost of grid losses (i.e. including the grid losses, not only the feeder/s
for which the optimal capacitor placement is performed). Essentially, this is the I
2
R loss of all
elements in the network.
CCap
i
is the annual cost of a capacitor (investment, maintenance, insurance), as entered by the
user in the list of possible capacitors. m is the total number of installed capacitors.
CV oltV iol
i
corresponds to a ctitious cost used to penalize a bus (terminal) voltage violation. n
is the total number of feeder terminals with voltage violations.
Note that if the OCP is not able to reduce the Total Costs by installation of a capacitor/s, the following
message will be reported:
DIgSI/err - Costs can not be reduced with the given
"Available Capacitors"
Evaluating the Voltage Violation Cost
As there is no real cost for a voltage violation, if the user wants to consider voltage violations as part
of the OCP algorithm, they must assign a ctitious cost for such violations. The voltage violation cost
is calculated based on the user specied voltage limits and penalty factors. The voltage limits are
dened in the Basic Options tab of the OCP command dialogue (vmin and vmax parameters, see
Section 35.2.1: Basic Options Page). The penalty factors are dened in the Advanced Options tab of
the same command (weight and weight2 elds, see Section 34.2.6: Advanced Options Page). The
penalty values are applied for voltages inside the admissible voltage band (parameter weight: Penalty
Factor 1) and for voltages outside the admissible band (parameter weight2: Penalty Factor 2).
There are two possible situations for a terminal voltage and the calculation for the ctitious voltage
violation cost is slightly different for each situation. The two situations are explained as follows:
770 DIgSILENT PowerFactory 15, User Manual
34.2. OPTIMAL CAPACITOR PLACEMENT
1. In situation one, the voltage U of a terminal is within the allowed voltage band (between vmax and
vmin) but deviates from the nominal voltage of 1 p.u. The penalty cost is calculated as:
CV oltV iol = w1 U (34.2)
where:
U is the absolute deviation from the nominal voltage in p.u. (U = |U U
n
|).
w1 is the penalty factor (parameter weight) inside the admissible voltage band in $/% from the
Advanced Options tab.
2. For situation two, the voltage U is outside the allowed voltage band (greater than vmax or less
than vmin) and the penalty cost is calculated as:
U > U
n
+ U
max
, if voltage is higher than max. limit:
CV oltV iol = w2 (U U
max
) +w1 U
or
U < U
n
U
min
, if voltage is lower than min. limit:
CV oltV iol = w2 (U U
min
) +w1 U
where
U is the absolute deviation from the nominal voltage U
n
in p.u.
U
n
+ U
max
is the higher voltage limit in p.u.
U
n
U
min
is the lower voltage limit in p.u.
w1 is the penalty factor (parameter weight) for voltage inside the admissible voltage band in
$/% from the Advanced Options tab.
w2 is the penalty factor (parameter weight2) for voltage outside the admissible voltage band
in $/% from the Advanced Options tab.
The algorithm can be summarized in as follows:
If the voltages are inside the admissible band the penalty cost applied is equal to w1 U
If the voltages are outside the admissible band the penalty cost applied is equal to the penalty
inside the band (w1 U) plus the factor w2 (U U
lim
, with U
lim
being either the maximum
or the minimum limit value of the admissible band.
Figure 34.2.2 illustrates the concept of the voltage band violation cost.
Figure 34.2.2: Fictitious cost assigned by voltage band violations
DIgSILENT PowerFactory 15, User Manual 771
CHAPTER 34. OPTIMAL CAPACITOR PLACEMENT
34.2.2 OCP Optimization Procedure
To nd the optimal conguration of capacitors, PowerFactory applies the following steps:
First a sensitivity analysis determines the best candidate terminal; This involves evaluating the
impact on the total cost (Losses + Voltage Violations) by connecting the largest available capacitor
from the user-dened list of capacitors to each target feeder terminal. At this stage the cost of the
largest capacitor is excluded.
Terminals are ranked in descending order of total cost reduction. The terminal that provides the
largest cost reduction becomes the best candidate terminal for a new capacitor.
The optimisation routine then evaluates the cost reduction at the candidate terminal using each
available capacitor from the user-dened list including the cost of each capacitor. The best
capacitor is the one that reduces the cost the most when also considering the annual cost of that
capacitor.
Repeat step one but any terminals that have previously been selected as candidates for capacitor
installation are not included in the ranking of candidate terminals. The algorithm stops when all
terminals have had capacitors installed, or the installation of capacitors cannot reduce costs any
further.
Note: If Load Characteristics are considered, then the above algorithm will be completed for every in-
dependent load state. See Section 34.2.5 for how the load states are determined.
34.2.3 Basic Options Page
Figure 34.2.3: Basic Options page for Optimal Capacitor Placement
Feeder
772 DIgSILENT PowerFactory 15, User Manual
34.2. OPTIMAL CAPACITOR PLACEMENT
Here the target feeder for the optimum capacitor placement is selected. The feeder is a special Power-
Factory element that must be created by the user before it can be selected in this dialogue (for informa-
tion about feeders refer to Chapter 13: Grouping Objects 13.5 (Feeders)).
Method
Optimization; This option calculates the optimal placement for capacitors using the methodology
described in Section 34.2.2. The output of the analysis is printed to the output window and any
new capacitors are connected to the target terminal/s if the Solution Action - Install capacitors
is selected.
Sensitivity Analysis; Performs the sensitivity analysis that ranks the candidate terminals according
to their impact on the total loss cost excluding the capacitor cost. The output is presented in the
Output Window. This option provides a quick indication of the most effective place for a single
capacitor. No capacitors are installed if this option is selected.
Network Representation
Here either a Balanced, positive sequence or a Unbalanced network representation can be selected.
The Load-ow command referenced below these radio buttons is automatically adjusted to the correct
calculation method based on this selection.
Constraints
Here the voltage constraint limits (upper and lower) can be entered, along with a limitation for the Total
Reactive Power of all Capacitors that can be added by the Optimal Capacitor Placement tool. The
total reactive power of all capacitors includes all existing capacitors along the feeder plus any more
capacitors proposed by the optimization tool.
Note: The voltage constraints are meaningless if penalty factors for deviations outside of the nominal
range are not entered as discussed in detail in Section 34.2.1: OCP Objective Function.
Energy Costs
The energy cost ($/kWh) can be entered manually or taken from an External Grid. Note, if more than
one External Grid exists in the network, the algorithm takes the rst External Grid by database ID. The
calculation of the cost of the network losses is as follows:
TC = MC 8760 L (34.3)
where:
TC is the total cost per annum in $;
MC is the energy cost of losses in $/kWh; and
L is the total losses in kW.
Note that if characteristics are applied to the loads and the analysis uses the option Consider Load
Characteristics (see Section 34.2.5), then the losses calculation becomes a summation over each time
state considered.
Note: The default energy cost units are $/kWh. However, this can be changed to Euro or Sterling () via
the project settings from the main menu bar. Edit Project. . . Project SettingsInput Variables
tabCurrency Unit.
DIgSILENT PowerFactory 15, User Manual 773
CHAPTER 34. OPTIMAL CAPACITOR PLACEMENT
Solution Action
Report only (do not modify network); The result of the optimisation is a report to the Output
Window only, no modications are made to the network model.
Install capacitors (modify network). If this option is chosen, the capacitors that the optimization
proposes for the network will be automatically installed. However, note that the single line diagram
is not automatically updated, only the network model database. To draw the installed capacitors
in the SLD the option must be selected in the Advanced Options page (see section 34.2.6). The
placed capacitors can be also visualized on the Voltage Prole Plot of the Feeder, see (Viewing
results on the Voltage Prole Plot) in Section 34.2.7.
34.2.4 Available Capacitors Page
Figure 34.2.4: Available Capacitors page for Optimal Capacitor Placement
On this page, the user denes the available capacitors for the OCP command. One capacitor is entered
per row. To add a new capacitor, right-click within any cell and select the option Insert Rows, Append
Rows or Append n Rows. The following elds are mandatory for each row:
Ignored; If this option is checked, then the capacitor specied in this row will be ignored by the
OCP command.
Q per Step Mvar; Here the nominal reactive power of the capacitor in Mvar per step is specied.
Switchable; If this option is enabled then the algorithm can use a capacitor with multiple steps.
Max. Step; If the Switchable option is enabled, then this option species the maximum number of
steps available to the optimisation algorithm. The maximum available reactive power is therefore
Max. Step
Q per Step Mvar.
Technology; Species whether the capacitor is Three-phase or Single-phase.
774 DIgSILENT PowerFactory 15, User Manual
34.2. OPTIMAL CAPACITOR PLACEMENT
Cost; Important. This is the total cost of the capacitor bank per annum. This is a critical parameter
for the OCP command as the capacitor will only be installed if the losses offset by its installation
are greater than the annual cost of the capacitor.
Note: It is theoretically possible to force the installation of a particular capacitor at an optimal location
on a feeder by dening a very low cost for the capacitor, and limiting the number of capacitors to
say, one.
Available Capacitors
Allow use of each capacitor multiple times; This is the default option and it means that every
capacitor in the list can be used at more than one feeder terminal (multiple times).
Use each capacitor only once; If this option is enabled then each capacitor can only be placed at
one terminal along the target feeder.
Treatment of 3-phase capacitors This option allows the specication of the technology type for 3-
phase capacitors. This option is only available when the Network Representation is set to Unbalanced
in the Basic Options page.
34.2.5 Load Characteristics Page
Figure 34.2.5: Load Characteristics Page for Optimal Capacitor Placement
If load characteristics are to be considered by the optimization algorithm, then the option Consider Load
Characteristics should be enabled on this page.
Load States
Two options are available:
DIgSILENT PowerFactory 15, User Manual 775
CHAPTER 34. OPTIMAL CAPACITOR PLACEMENT
1. Use existing Load States; If this option is selected then the system load state that is active in
the system (the load state observed as a result of a single load-ow at the current point in time)
will be used as the load state for the optimization algorithm. For example, if there is a 1 MW load
with a active characteristic that gives the current load value of 0.6 MW, then the load used for the
optimization will be 0.6 MW, not 1 MW.
2. Create Load States; If this option is selected then PowerFactory automatically discretises all load
characteristics into a number of states using a sophisticated algorithm. The algorithm iterates
through every hour of the selected time period to determine the number of unique operating load
states that exist. Every operating state is assigned a probability based on the number of times
that it occurs and this probability is used to determine the cost of losses for each state.
34.2.6 Advanced Options Page
Figure 34.2.6: Advanced Options page for Optimal Capacitor Placement
Candidate Buses
All terminals in feeder; If this option is selected, every terminal in the feeder is considered as a
possible candidate for a new capacitor.
Percentage of terminals in feeder; Selecting this option and entering x percent for the parameter
means the optimization algorithm will only consider x percent of the feeder terminals as targets
(candidates) for new capacitors. The ranking of terminals is according to the Sensitivity Analysis
as described in Section 34.2.2.
Max. Number of Iterations
This parameter determines the maximum number of iterations of the optimization algorithm before it
automatically stops. As a maximum of one capacitor is placed per iteration, this can effectively limit the
total number of capacitors that can be placed by the optimization routine.
776 DIgSILENT PowerFactory 15, User Manual
34.2. OPTIMAL CAPACITOR PLACEMENT
Max. Execution Time
This parameter species the maximum time the optimisation routine can run before it is automatically
interrupted.
Penalty Factors for Voltage Deviation
Factor for Deviation from 1 p.u (weight); This parameter is used to determine the total ctitious
cost for terminals deviating from 1 p.u. The cost is applied to each phase of the terminal. For
example, if a three phase terminal voltage is measured at 0.95 p.u for each phase and the ctitious
cost rate is $10,000/% then the total cost of this deviation is $150,000 (5%
$10,000/%
3).
Note: If no penalty costs are to be applied within the admissible band, this factor should be set to zero.
If this value is greater than zero, the program will add costs to all terminals with voltage different
than 1.0 p.u.
Additional Factor outside range [vmin, vmax] (weight2); This parameter can be used to apply an
additional weighting factor to the rst deviation factor when the terminal voltage falls outside the
voltage limits dened on the Basic Options page. The factor is cumulative, so using the previous
example and a additional factor of 20,000/% with a vmin of 0.975, the ctitious cost becomes
$300,000 (5%
$10,000/% + 2.5%
$20,000/%)
3.
Note: The values for the two voltage penalties weight and weight2 should be carefully chosen be-
cause the target optimization function is a sum of three objective functions (losses, capacitor cost
and voltage deviation cost). If the voltage weights are too high, the algorithm might not consider
the other two objectives. Likewise, if they are very low, the algorithm may not consider voltage
violations at all.
Print report after optimisation
The automatic printing of the optimisation results can be disabled by unchecking this option.
Draw the installed capacitors
This option draw the installed capacitors in the Single Line Diagram when checked.
34.2.7 Results
The last three OCP tool-bar buttons give access to the optimization results.
Show Nodes with New Capacitors
When pressing the Show Nodes with New Capacitors icon ( ), after a successful optimization is com-
plete, a list appears of all terminals where capacitors are proposed for installation.
Show New Capacitors
Pressing the Show New Capacitors icon ( ) shows a list of proposed new capacitors.
Output Calculation Analysis
This Output Calculation Analysis icon ( ) generates a report with the results of the sensitivity analysis
and the nal optimization procedure.
Viewing results on the Voltage Prole Plot
DIgSILENT PowerFactory 15, User Manual 777
CHAPTER 34. OPTIMAL CAPACITOR PLACEMENT
Following a successful optimization, the new capacitors can be visualized on the voltage prole plot of
the feeder. To enable this, navigate to the voltage prole plot display after the optimization and click the
rebuild button. An example of such a plot showing the placed capacitors is shown in Figure 34.2.7.
Figure 34.2.7: Voltage prole plot showing the new capacitors after an Optimal Capacitor Optimisation.
Removing Capacitors Placed by the Optimal Capacitor Placement Routine
The capacitors placed by the OCP command can be removed at any time after the analysis has been
completed by using the Remove previous solution icon ( ). This button is like an Undo for the Optimal
Capacitor Placement.
778 DIgSILENT PowerFactory 15, User Manual
Chapter 35
Cable Sizing
35.1 Introduction
The chapter presents the PowerFactory tools for sizing cables, according to the Cable Reinforcement
method and the International Standards method (IEC 60364-5-52, NF C15-100, BS 7671, NF C13-200).
International Standards Method. Either verify the suitability of the assigned line Types or recom-
mend new line Types according to the selected International Standard.
Cable Reinforcement Method. Either verify the suitability of the assigned line Types or recommend
Types according to user-dened voltage, thermal, and short-circuit constraints.
The optimization may be performed on a network model without any cable/line types yet dened, based
on the load and power ows in the active study case.
To access the Cable Sizing command (ComCabsize), select the Change Toolbox icon ( ), Additional
Tools, and then select the Cable Sizing icon ( ), as illustrated in Figure 35.1.1.
DIgSILENT PowerFactory 15, User Manual 779
CHAPTER 35. CABLE SIZING
Figure 35.1.1: How to access the Cable Sizing command
780 DIgSILENT PowerFactory 15, User Manual
35.2. CALCULATION OPTIONS
35.2 Calculation Options
35.2.1 Basic Options Page
Figure 35.2.1: Basic Options page for Cable Reinforcement Optimization
Method
Select to execute the Cable Sizing command based on either:
International Standards applicable to low-voltage networks up to 1kV, IEC 60364-5-52, NF C15-
100 and BS 7671, or applicable to medium-voltage networks 1kV to 30kV, NF C13-200. Refer to
the standards for further details.
Cable Reinforcement with user-dened types and constraints.
Note: Standards tables for cable ampacity, cross-section, derating factors, and impedances are stored
in the Database SystemModulesCable Sizing folder.
Lines/Feeders
If Method is set to International Standards, specify the Line/s for the Cable Sizing analysis.
If Method is set to Cable Reinforcement, specify the Feeder/s for the Cable Reinforcement analy-
sis.
Mode
DIgSILENT PowerFactory 15, User Manual 781
CHAPTER 35. CABLE SIZING
If Verication is selected, then the command will assess the suitability of the existing line types:
For the International Standards Method, the command will verify the suitability of the line/cable
in accordance with the selected standard.
For the Cable Reinforcement Method, the command will verify the suitability of the line/cable
in accordance with the selected constraints and / or network consistency criteria. At least
one of Thermal Loading Limits, Consider Voltage Drop Per Terminals, Consider Voltage Drop
Along Feeder, Short Circuit Loading Limits, and Network Consistency must be selected.
If Recommendation is selected:
For the International Standards Method, the command will create new cable types for the low
voltage and medium voltage grids according to the selected international standard. The cable
derating factor will be set based on the installation method, specied on the Line Elements
Cable Sizing page. Types will be created in the target folder, or if no folder is selected, inside
the Equipment Type Library.
For the Cable Reinforcement Method, the command will recommend line/cable types for
those lines without Types yet dened, and those that cause violations of the specied con-
straints. Reference to a folder that contains the overhead / cable types to be considered
should be provided. This may be a global library, however it is recommended that the avail-
able types be stored in a local project library. PowerFactory will automatically select the
lines/cables with a voltage rating suitable for the line element.
Note: Line/cable cost data in $/km is entered on the Cable Sizing page of the line type.
Network Representation
Balanced, positive sequence or Unbalanced network representation can be selected. The Load-ow
command referenced below these radio buttons is automatically adjusted to the appropriate calculation
method based on this selection.
Load Flow, Short Circuit
These are a references (pointers) to the load-ow command and short-circuit command (if applicable)
used by the optimization algorithm. For a Cable Reinforcement calculation in Verication Mode, the user
can optionally consider Short Circuit Loading Limits. The Short Circuit Calculation command will also
be automatically adjusted based on the calculation method selected. However, if switching between
Balanced and Unbalanced representation, the user should ensure that the short-circuit calculation is
set to the required fault type.
782 DIgSILENT PowerFactory 15, User Manual
35.2. CALCULATION OPTIONS
35.2.2 Constraints Page
Figure 35.2.2: Constraints page for Cable Reinforcement Optimization
Constraints options are only applicable if Cable Reinforcement is selected on the Basic Options page.
Thermal Loading Limits
Optionally select to consider Thermal Loading Limits. There are two options for thermal constraints:
Global Constraints For All Lines. This is the default option, where individual component thermal
limits are ignored. If enabled, a maximum thermal loading percentage must be entered in the
Maximum Thermal Loading eld.
Individual Constraint Per Line. Select this option to automatically consider each components
unique thermal loading limit. Note, the thermal rating is specied in the eld Max Loading within
the Load Flow tab of each line.
Consider Voltage Drop Per Terminals
Optionally select to Consider Voltage Drop Per Terminals. There are two options for terminal voltage
drop constraints:
Global Constraints For All Terminals (absolute value). If selected, a lower voltage limit must be
entered in the Lower Limit of Terminal Voltage eld.
Individual Constraint Per Terminal. Note, the voltage limit is specied in the Load Flow tab of each
terminal.
Consider Voltage Drop Along Feeder
For balanced calculations, optionally select to Consider Voltage Drop Along Feeder. The voltage drop
DIgSILENT PowerFactory 15, User Manual 783
CHAPTER 35. CABLE SIZING
is calculated as the absolute voltage difference between the source terminal of the feeder and the nal
terminal of the feeder. There are two options for feeder voltage drop constraints:
Global Constraints For All Feeders. If this option is selected, then the maximum voltage drop must
be entered in the Maximum Voltage Drop led.
Individual Constraint Per Feeder. Note, the maximum voltage drop is specied in the Load Flow
tab of each feeder.
Short Circuit Loading Limits
When the Mode is set to Verication, optionally select to consider Short Circuit Loading Limits. Con-
straints can be entered in the Maximum Loading eld as a percentage of the rated short-circuit current
in the Type data for lines and terminals, etc.
Note: Depending on the system topology, on the loads and on the length of the feeder, it might not be
possible to avoid voltage drop violations of some terminals or feeders. This can be mitigated by
the installation of a capacitor/s during a post-processing optimization. See Chapter 34: Optimal
Capacitor Placement.
35.2.3 Output Page
Figure 35.2.3: Output options page for Cable Reinforcement Optimization
Output
Various output options for the optimization results are possible.
Report Only: Any new line types are listed in a pre-dened report displayed in the Output Window.
784 DIgSILENT PowerFactory 15, User Manual
35.2. CALCULATION OPTIONS
Modication of Cables Type in the Existing Network: If this option is selected, the Report will be
generated and the optimization routine will update the network model with the proposed types.
Note that this option is only available when the Mode is set to Recommendation on the Basic
Options tab.
Create a New Variation with Recommended Cables: If this option is selected, the Report will be
generated and the optimization routine will create a Variation with the proposed modications.
Note that this option is only available when the Mode is set to Recommendation on the Basic
Options tab.
Report
This is a reference (pointer) to the result report output, which details calculation settings, and results
of the verication or recommendation. For more information about the result language format see
Chapter 17: Reporting and Visualizing Results, Section 17.2.
Results
This is a reference (pointer) to the results output. It is possible to select an alternative results le.
Results are indexed as follows for the Cable Reinforcement method:
0. Initial value - Initial calculation of all parameters of feeder, ComCabsize, lines and terminals.
1. Thermal lines verication - Only those lines variables are written which violate the thermal con-
straint.
2. Thermal lines recommendation - Only those lines variables are written, for which a new cable
type is recommended during thermal recommendation process. The cost of improvement is also
written.
3. Thermal lines cannot be solved - Only those lines variables are written, that are unsolvable and
still violate thermal constraints after thermal recommendation process.
4. Voltage verication - Only those terminals variables are written which violate voltage constraints.
5. Voltage recommendation - Only those lines variables are written, for which a new cable type is
recommended during voltage recommendation process. The cost of improvement is also written.
6. Terminals cannot be solved - Only those terminals variables are written which are unsolvable and
still violate voltage constraints after the voltage recommendation process.
7. Consistency verication - Only those terminals variables are written which violate network consis-
tency.
8. Consistency recommendation - Only those lines variables are written, for which a new cable type
is recommended during the consistency improvement process. The cost of improvement are also
written.
9. Consistency violation - Only those terminals variables are written that are unsolvable and still
violate network consistency after the recommendation process.
10. Changed cables - Only those lines variables are written, for which a new cable type is recom-
mended after the complete load ow optimization process.
11. Short-circuit verication - Only those lines variables are written which violate short-circuit con-
straints.
Results are indexed as follows for the International Standards method:
100. Pre-verication results.
101. Post-verication results.
102. Pre-recommendation results.
103. Post-recommendation results.
DIgSILENT PowerFactory 15, User Manual 785
CHAPTER 35. CABLE SIZING
35.2.4 Advanced Options Page
35.2.4.1 International Standards Method
If International Standards and Recommendation is selected on the Basic Options page, then congure
the Advanced Options as follows.
Figure 35.2.4: Advanced Options page for Cable Sizing International Standards Method
Cable Sizing
Dene the Safety margin for the cable current capacity in percent. If a non-zero safety margin is
entered, a cable with higher capacity is selected.
Optionally select to Set cable electrical parameters according to the IEC 60909 to set cable resis-
tance and reactance parameters from conductor cross-section and material according to the IEC
60909 calculation.
Select whether to Use design parameters of the Cable Sizing command, in which case a new type
will be created according to the type design parameters from the command. Or, select to Use
design parameters of the assigned cable type, in which case a new type will be created according
to the existing line type from its rated values (only current and cross-section values could be
different). This is only applicable if the analyzed line has a type assigned. Otherwise, a new type
will be created according to the command parameters.
786 DIgSILENT PowerFactory 15, User Manual
35.2. CALCULATION OPTIONS
35.2.4.2 Cable Reinforcement Method
If Cable Reinforcement is selected on the Basic Options page, then congure the Advanced Options as
follows.
Figure 35.2.5: Advanced Options page for Cable Sizing - Cable Reinforcement Method
Network Consistency
This option, if enabled, forces the optimization routine to complete a nal consistency check of the
Line Type rated nominal current based upon one of two criteria:
1. Sum of feeding cables >= Sum of leaving cables; or
2. Smallest feeding cable >= Biggest leaving cable.
To explain what is meant by feeding cable and leaving cable consider the example feeder shown in
Figure . This network is dened as a single feeder that begins at the Source terminal. Consider now
Terminal A. This terminal is supplied by Line A and is also connected to two other lines, Line B and
Line C. In this case, for Terminal A, Line A is considered as a feeding cable and lines B and C as
leaving cables.
Considering now Terminal B, Lines B and C are feeding cables whereas Lines D and E are leaving
cables. Feeding cables are dened as those cables with a power ow direction that is into the con-
necting node. For a radial feeder with no embedded generation, this is generally the cables closest to
the beginning of the feeder. All other cables are dened as leaving cables.
In consistency check option 1, the cross sectional area (or nominal current) of the feeding cables are
summated and compared with the sum of the cross sectional area (or nominal current) of the leaving
cables for each terminal. If the sum of the leaving cables is greater at any terminal then the network is
considered non-consistent.
DIgSILENT PowerFactory 15, User Manual 787
CHAPTER 35. CABLE SIZING
For consistency check option 2, the smallest feeding cable is compared with the largest leaving cable
for each terminal. If the largest leaving cable is bigger than the smallest feeding cable, then the network
is considered non-consistent.
Figure 35.2.6: Example feeder network
Recommended Options
Available when Mode is set to Recommendation on the Basic Options tab.
Specify the Max. Voltage Deviation in Type Selection in percent. If 0% is entered, the rated
voltage on the cable type should match the rated voltage of the terminal to which it connects. If a
non-zero value is entered, the rated voltage of the cable type can differ by the dened percentage.
Optionally select to Assign Missing Line Types. Note that for low voltage networks (less than 1kV)
the line type rated voltage should be equal to 1kV.
788 DIgSILENT PowerFactory 15, User Manual
35.2. CALCULATION OPTIONS
35.2.5 Type Parameters
Figure 35.2.7: Type Parameters page for Cable Reinforcement Optimization
If the Method International Standards and Mode Recommendation is selected, congure the cable Type
parameters.
Cable Type Parameters
Conductor Material. Select either Copper or Aluminium.
Insulation Material. Select either PVC, XLPE, Mineral, Paper, or EPR. Note that paper is valid only
for NF C13-200, and Mineral is valid only for 0.5kV and 0.75kV systems and copper conductors).
Cable Cores. Select either multi-core (2 or 3 conductors) or single-core (1 conductor).
With Sheath. Select if the cable has a sheath cover. If mineral insulation is selected and this frame
is not checked, it is considered that the cable is bare with a metallic sheath.
Sheath Type. Select metallic or non-metallic.
Sheath Insulation. Select either PVC, XLPE, or EPR.
Armoured Cable. If checked, an armoured cable type will be created, otherwise a non-
armoured cable type is created.
Radial Cable Screen. If checked then each conductor has its own screening. This is valid
only for multi-core cables, since single-core cables always have radial screening.
Exposed to touch. For copper conductors with mineral insulation, select if the cable is ex-
posed to touch.
DIgSILENT PowerFactory 15, User Manual 789
CHAPTER 35. CABLE SIZING
35.3 Cable Sizing Line Parameters
35.3.1 Cable Sizing Line Type Parameters
Figure 35.3.1: Cable Sizing Line Type parameters
Line Type parameters relevant to the Cable Sizing command are dened on the Cable Sizing page of the
Line Type TypLne, which includes a simplied image of the cable. See section 35.2.5 for a description
of the parameters.
790 DIgSILENT PowerFactory 15, User Manual
35.4. SYSTEM TECHNOLOGY CHECK
35.3.2 Cable Sizing Line Element Parameters
Figure 35.3.2: Cable Sizing Line Element parameters
Line Element parameters relevant to the Cable Sizing command are dened on the Cable Sizing page of
the Line Element ElmLne, ElmLnesec. The page includes details of the laying arrangements, installation
method, and a simplied image of the cable installation. When the Cable Sizing command is executed,
the line derating factor (on the Basic Data page) is updated based on the parameters from this page.
35.4 System Technology Check
The Cable Sizing command performs a system technology check, whereby the technology type of
terminals (the number of phases and neutrals) determines the technology type of line types added to
line elements:
For balanced networks, terminals, lines, and line types should be 3 phase (see also third point
regarding neutrals).
For unbalanced networks, lines and line sections are assumed to have a number of phases equal
to the minimum number of phases of the element to which it connects. For example, if a line
connects from a 3 phase terminal (phase technology ABC, as dened on the Terminals Basic
Data page) to a 2 phase terminal (phase technology 2PH), the line element is assumed to be 2
phase. The line type must have the same number of phases.
For lines and line sections, if there is a neutral connection at both ends, the line is assumed to
have a neutral, and therefore the line type must have a neutral. If end connections do not have
neutrals, or only one end connection has a neutral, the line is considered to not have a neutral.
DIgSILENT PowerFactory 15, User Manual 791
CHAPTER 35. CABLE SIZING
792 DIgSILENT PowerFactory 15, User Manual
Chapter 36
Motor Starting
36.1 Introduction
The chapter presents PowerFactory tools for performing motor starting simulations using the Motor
Starting command (ComMot ). A Motor Starting analysis typically includes an assessment of the fol-
lowing:
Voltage sag.
Ability of motor to be started against the load torque.
Time required to reach nominal speed.
Supply grid loading.
Starting methodology (Direct Online, Star-Delta, Variable Rotor Resistance, Reactor, Auto Trans-
former).
The Motor Starting command makes use of the PowerFactory stability module by providing a pre-
congured shortcut for easy-to-use motor starting analysis. Pre-selected and pre-congured plots (VIs)
are automatically created and scaled with full exibility for user-conguration. In PowerFactory , there
are two Simulation Types that may be used to perform a motor starting simulation:
1. Dynamic Simulation, which will execute a time-domain motor starting simulation.
2. Static Simulation, which will execute a load ow calculation when the motors are disconnected
from the system. Then, it will execute a short-circuit calculation, using the complete method,
simultaneously with the occurrence of the motors being connected to the network. Finally, a load
ow calculation will be executed after the motors have been connected to the system.
36.2 How to dene a motor
To dene the starting method of a motor, a Type must rst be selected. This sub-section describes how
to dene a motor and (optionally) dene a motor driven machine (mdm).
36.2.1 How to dene a motor Type and starting methodology
A comprehensive library of low-voltage, medium-voltage, and high-voltage motor Types are available in
the PowerFactory Global Library. Typical motors supported are: single- and double-cage asynchronous
DIgSILENT PowerFactory 15, User Manual 793
CHAPTER 36. MOTOR STARTING
machines and squirrel motors.
To dene a motor Type and starting methodology for a dynamic simulation:
1. On the asynchronous machine Basic Data page, press select ( ) and then choose an existing
or dene a new asynchronous machine Type. Press OK twice.
2. From the Data Manager or single line graphic, double-click the asynchronous machine to open
the element dialogue.
3. Depending on whether a dynamic or static motor starting simulation is to be executed:
For a dynamic starting simulation, navigate to the RMS-Simulation page, Advanced tab.
For a static starting simulation, navigate to the Complete Short-Circuit page.
4. Check Use Motor Starting Method.
5. Use radio buttons to select a starting method (see below).
Directly Online
For the direct online starting method, select Directly Online.
Star-Delta
For star-delta starting:
1. Select Star-Delta.
2. For a dynamic motor starting simulation, on the RMS-Simulation page, Advanced tab:
Select Triggered by... either Time or Speed.
Enter a simulation time for the motor to switch from the star winding to the delta winding
Switch to D after, or a speed for the motor to switch from the star winding to the delta
winding Switch to D at Speed >=.
Variable Rotor Resistance
For variable rotor resistance starting:
1. Select Variable Rotor Resistance.
2. For a static motor starting simulation, on the Complete Short-Circuit page:
Enter the Additional Rotor Resistance.
3. For a dynamic motor starting simulation, on the RMS-Simulation page, Advanced tab:
Select Triggered by... either Time or Speed.
In the Variable Rotor Resistance table, enter additional rotor resistance, and the time (or
speed) at which the rotor resistance should be added.
For additional entries, right-click and Append or Insert rows as required. Note that a minimum
of two-points must be entered.
Reactor
For reactor starting:
1. Select Reactor.
2. For a static motor starting simulation, on the Complete Short-Circuit page:
Enter the Rated Apparent Power and Reactance.
794 DIgSILENT PowerFactory 15, User Manual
36.2. HOW TO DEFINE A MOTOR
3. For a dynamic motor starting simulation, on the RMS-Simulation page, Advanced tab:
Select Triggered by... either Time or Speed.
Enter the Rated Apparent Power, Reactance.
Enter the time at which the reactor should be removed Bypass after, or speed at which the
reactor should be removed Bypass at Speed >=.
Auto Transformer
For auto transformer starting:
1. Select Auto Transformer.
2. For a static motor starting simulation, on the Complete Short-Circuit page:
Enter the Rated Apparent Power, Reactance, and Tap.
3. For a dynamic motor starting simulation, on the RMS-Simulation page, Advanced tab:
Select Triggered by... either Time or Speed.
Enter the Rated Apparent Power, Reactance, and Tap.
Enter the time at which the star contactor should be released Release Star Contactor after
and the time at which the auto-transformer should be bypassed Bypass after, or the speed
at which the star contactor should be released Release Star Contactor at Speed >= and the
speed at which the auto-transformer should be bypassed Bypass at Speed >=.
36.2.2 How to dene a motor driven machine
Selection of a motor driven machine model provides enhanced exibility to dene the torque-speed
characteristic of the motor. A motor driven machine can be user-dened, or selected from a range
of Compressors, Fans, and Pumps available in the PowerFactory Global Library. Refer to the asyn-
chronous machine Technical Reference Asynchronous Machine and motor driven machine Technical
Reference for further details Motor Driven Machine.
To dene a motor driven machine, in a Data Manager or on the Single Line Graphic, right-click on the
asynchronous machine and:
For a new motor driven machine:
1. Select Dene... New Motor Driven (mdm) machine.
2. Select a motor driven machine element (Type 1, Type 3, or Type 5).
3. Enter the torque-speed characteristic.
For a motor driven machine from the library:
1. Select Dene... Motor Driven (mdm) machine from library.
2. Select an existing motor driven machine from the project library, or global library Database
LibraryMotor Driven Machine.
Note: Motor driven machines may also be dened for Synchronous motors by selecting the Composite
Type Sym frame (or creating a user-dened frame). Refer to the mdm Technical Reference for
further details: Motor Driven Machine.
DIgSILENT PowerFactory 15, User Manual 795
CHAPTER 36. MOTOR STARTING
36.3 How to run a Motor Starting simulation
To run a motor starting simulation:
1. Select the motor or group of motors for the motor starting simulation.
2. Right-click a selected motor and select Calculate Motor Starting.
3. Enter the command options (see following subsections for a description of the command options).
36.3.1 Basic Options Page
36.3.1.1 Motor(s)
The motors selected for the Motor Starting command.
36.3.1.2 Simulation Type
Select either:
Dynamic Simulation to initiate a dynamic motor starting simulation.
Static Simulation to initiate a static motor starting simulation.
Note: Load Flow, Initial Conditions, Run Simulation, Simulation Events, Short-Circuit and Results De-
nitions objects in the active study case will be overwritten by the Motor Starting command.
36.3.1.3 Simulation Method
Either:
If User dened simulation settings is not checked:
1. Select to run either a Balanced or Unbalanced Motor Starting simulation.
2. Enter the Simulation Time in seconds.
If User dened simulation settings is checked:
1. Dene the variables to be monitored.
2. Modify Load Flow Calculation command (ComLdf ) settings as required.
3. Modify Initial Conditions command (ComInc) settings as required. Note that motor start-
ing events are automatically created, and that previously dened events are not deleted.
Similarly, user-dened variable sets are merged with the Motor Starting command default
variables.
4. Modify Simulation command (ComSim) settings as required.
36.3.1.4 Monitoring
Click Select ( ) and select the Additional Terminals to be monitored for the Motor Starting simulation.
796 DIgSILENT PowerFactory 15, User Manual
36.3. HOW TO RUN A MOTOR STARTING SIMULATION
36.3.1.5 Check Thermal Limits of Cables and Transformers
Optionally select to Check Thermal Limits of Cables and Transformers. When this option is selected,
the feeding cables and transformers of every motor will automatically be gathered, and its thermal limit
will be checked.
The calculation of the thermal limits is performed depending on the type of simulation selected.
Dynamic Simulation
Given the rated thermal overcurrent limit of the cable at 1 second (I
thr1s
), the thermal overcurrent
limit of the line at the starting time of the motor (I
thrTs
) is calculated according to equation 36.1:
I
thrTs
=
_
I
thr1s
T
start
(36.1)
Where:
T
start
= is the time calculated during the Motor Starting simulation.
The calculated thermal energy (I
2t
) during the motor starting is dened as:
I
2t
=
_
T
start
0
I
2
dt
T
start
0
I
2
t (36.2)
Where:
t = is the integration step size of the simulation.
The calculated thermal current (I
thrcalc
) is then calculated as follows:
I
thrcalc
=
_
I
2t
T
start
(36.3)
Finally, the thermal loading is calculated as the relation between rated thermal current and calcu-
lated thermal current at starting time:
ThermalLoading =
I
thrcalc
I
thrTs
(36.4)
Static Simulation
Given the rated thermal overcurrent limit of the cable at 1 second (I
thr1s
), the thermal overcurrent
limit of the line at the starting time of the motor (I
thrTs
) is calculated according to equation 36.5 :
I
thrTs
=
_
I
thr1s
T
start
(36.5)
The starting time is the variable tstart specied in the Protection page of the Asynchronous and
the Synchronous Machine dialogues.
The calculated thermal current is the positive-sequence current calculated at the motor starting
I
thrcalc
= I
start
(36.6)
DIgSILENT PowerFactory 15, User Manual 797
CHAPTER 36. MOTOR STARTING
Finally, the thermal loading is calculated as the relation between rated thermal current and calcu-
lated thermal current at starting time:
ThermalLoading =
I
thrcalc
I
thrTs
(36.7)
36.3.2 Output Page
36.3.2.1 Dynamic Simulation
Report
Check Report to report results to the output window. By default, report results include voltage be-
fore starting, minimum voltage during starting, voltage after starting, starting current and power factor,
successful start, and starting time. The user can optionally modify report Settings.
Starting Tolerance for Simplied Models
Dene the Max. Speed Tolerance, the maximum deviation from nominal speed at which the motor is
considered to be successfully started. This applies only to simplied (i.e. synchronous) motors.
36.3.2.2 Static Simulation
Report
Optionally modify report Settings and Results. Figure 36.3.1 shows an example of a Static Simulation
Report with the option Check Thermal Limits of Cables and Transformers selected.
Figure 36.3.1: Report Example
Starting Tolerance for Simplied Models
Dene the Max. Voltage Drop at which the motor is considered to be successfully started. This applies
only to simplied models.
Simplied models are:
798 DIgSILENT PowerFactory 15, User Manual
36.3. HOW TO RUN A MOTOR STARTING SIMULATION
All synchronous motors.
Asynchronous motors with type Asynchronous Machine Type (TypAsmo), and without the Type
option Consider Transient Parameter (i trans) checked.
Asynchronous motors with any Type other than Asynchronous Machine Type (TypAsmo).
Detailed models are: Asynchronous motors with type Asynchronous Machine Type (TypAsmo), and
which have the option Consider Transient Parameter checked on the VDE/IEC Short-Circuit page or
Complete Short-Circuit page of the Type dialog. This provides a more precise result for the motor
starting time.
Display results for
Select to display results on the Single Line Graphic:
After motor start up.
During motor start up.
Before motor start up.
36.3.3 Motor Starting simulation results
36.3.3.1 Dynamic simulation results
Following a motor starting simulation, PowerFactory will automatically create a plot (VI) for each motor
showing the active power (m:Psum:bus1), reactive power (m:Qsum:bus1), current (m:I1:bus1), speed
(s:speed), mechanical and electrical torques (c:xmt and c:xmem) and voltage of the motor terminal
(m:u1). A second plot is created showing the voltage of monitored Terminals. Flexible data results
variables available following a dynamic Motor Starting simulation are found on the motor data Motor
Starting Calculation page.
The Motor Starting calculation variables are as follows:
Terminal voltage before Starting, Magnitude (c:uprestart).
Motor voltage during Starting, Magnitude (c:ustart).
Motor voltage after Starting, Magnitude (c:upoststart).
Starting current, Magnitude in kA (c:Istart).
Starting current, Magnitude in p.u. (c:istart).
Starting Power Factor (c:cosphistart).
Successfully Started (c:started).
Approx. Starting Time (c:Tstart).
The criterion of a successful start is as follows:
Synchronous motors: Successful start if Actualspeed >= Synchronousspeed Tolerance, where
Actualspeed is the value of variable s:speed, and Tolerance is the value specied in the input
eld Max. Speed Tolerance (tolspeed).
Asynchronous motors: Successful start if Actualspeed >=Nominalspeed Slip, where ActualSpeed
is the value of variable s:speed, and Slip is the value of variable t:aslkp of the asynchronous
motor.
DIgSILENT PowerFactory 15, User Manual 799
CHAPTER 36. MOTOR STARTING
36.3.3.2 Static simulation results
Following a motor starting simulation, new calculation variables are available for asynchronous (El-
mAsm) and synchronous (ElmSym) motors. For the Static Simulation, these variables are found on the
Motor Starting Calculation page. Results variables are described in the preceding sub-section.
The criterion of a successful start is as follows:
Simplied models: Successful start if Voltage During Starting >= Voltage Before Starting *(1
- Voltage Tolerance), where Voltage Before Starting is the voltage value at the terminal before
the motor is connected to the system, Voltage During Starting is the transient positive-sequence
voltage value at the terminal during the motor start, and Voltage Tolerance is the value specied
in the input eld Max. Voltage Drop (tolvolt).
Detailed models: The electrical and mechanical torque are calculated for the minimum voltage
value during the motor start up. A detailed model is considered to be successfully started up if the
mechanical torque is always smaller than the electrical torque from zero speed up the peak of the
electrical torque.
36.3.4 Motor Starting Example
Consider the following dynamic motor starting example for a single 6.6kV asynchronous motor shown
in Figure 36.3.2.
Figure 36.3.2: Motor Starting example Single Line Graphic
The Variable Rotor Resistance starting method has been selected, with three values of time-dependent
resistance, as shown in Figure 36.3.3.
800 DIgSILENT PowerFactory 15, User Manual
36.3. HOW TO RUN A MOTOR STARTING SIMULATION
Figure 36.3.3: Motor starting methodology options
A dynamic, balanced Motor Starting simulation is executed and run to 10 seconds, with Source Bus
selected as an Additional Terminal to be monitored, as shown in Figure 36.3.4.
Figure 36.3.4: Motor starting Basic Options
Following execution of the command, PowerFactory automatically produces plots showing motor quanti-
ties of interest (as described in section 36.3.3.1) and monitored voltage results as shown in Figure 36.3.5
and Figure 36.3.6.
DIgSILENT PowerFactory 15, User Manual 801
CHAPTER 36. MOTOR STARTING
Figure 36.3.5: Motor starting example motor results
Figure 36.3.6: Motor starting example voltage results
802 DIgSILENT PowerFactory 15, User Manual
Chapter 37
Arc-Flash Hazard Analysis
37.1 Introduction
This chapter presents the tools available in PowerFactory to perform arc-ash hazard analysis, including
technical background, a description of the Arc-Flash Hazard Analysis command dialogues, and an
example calculation. The Arc-Flash Hazard Analysis command (ComArcash) can be accessed on the
Main Toolbar under the Protection group by selecting the Arc-Flash Hazard Analysis icon .
Note: DIgSILENT accepts no responsibility for the use of the Arc-Flash Hazard Analysis command, or
for the consequences of any actions taken on the basis of the results. Use the Arc-Flash Hazard
Analysis command at your own risk.
Note: By default, results are entered and displayed in SI units. To change to British Imperial units, on
the Main Menu, select Edit Project Data Project, select the pointer to Project Settings, and
on the Input page, select the Units as English-Transmission or English-Industry.
37.2 Arc-Flash Hazard Analysis Background
37.2.1 General
Arc-Flash Hazard Analysis calculations are performed to determine ...the arc-ash hazard distance and
the incident energy to which employees could be exposed during their work on or near electrical equip-
ment [IEEE1584-2002][12]. One outcome of an Arc-Flash Hazard Analysis is to determine employee
Personal Protective Equipment (PPE) requirements.
Arc-Flash calculations can be conducted in PowerFactory in accordance with IEEE-1584 2002[12] and
NFPA 70E 2008 [14] standards. The Arc-Flash Hazard Analysis command builds on the existing short-
circuit calculation capabilities of PowerFactory , and requires the following additional data, depending
on the method used:
IEEE-1584: Conductor Gap, Distance Factor, Working Distance, and Enclosure type.
NFPA 70E: Working Distance.
When an Arc-Flash hazard analysis is conducted using the IEEE-1584 method, PowerFactory calcu-
lates the arcing current based on the equations presented in the standard. Internally, PowerFactory
DIgSILENT PowerFactory 15, User Manual 803
CHAPTER 37. ARC-FLASH HAZARD ANALYSIS
calculates the arc resistance required to limit the fault current to the calculated value. When the NFPA
method is selected, the bolted fault current is used for the calculation. For either method, when the
user selects to use relay tripping times, a second calculation is performed at a reduced fault current (as
specied by the user) and the associated (generally longer) clearing time. PowerFactory compares the
results of these two cases and reports on the worst case result.
37.2.2 Data Inputs
The IEEE-1584 Standard provides guidance on the selection of Conductor Gap and Distance Factor.
Figure 37.2.1 shows the recommended values from the standard.
Figure 37.2.1: Factors for Equipment and Voltage Classes [IEEE1584-2002][12]
Figure 37.2.2 shows the Terminal Element dialogue where parameters required for the Arc-Flash Hazard
Analysis Calculation are entered. If Accessible Location is selected, the user may enter the required
input parameters for Arc-Flash calculations. If the Terminal resides within a Substation, Equipment Data
can be set to either Local Values or From Substation. When From Substation is selected, a pointer to
the relevant substation is shown in the dialogue.
804 DIgSILENT PowerFactory 15, User Manual
37.3. ARC-FLASH HAZARD ANALYSIS CALCULATION OPTIONS
Figure 37.2.2: Arc-Flash Data Required for Terminal Objects
Additional data required for Fault Clearing Times is discussed later in the chapter.
37.3 Arc-Flash Hazard Analysis Calculation Options
This section describes the Arc-Flash Hazard Analysis calculation options.
37.3.1 Arc-Flash Hazard Analysis Basic Options Page
Calculation Method
Select either:
according to IEEE-1584[12], or
according to NFPA 70E[14].
Fault Location
Select either:
At User Selection, and select a single location, or a pre-dened Set of locations.
All Accessible Locations, i.e. all Terminals where Accessible Location is selected on the Protection
page of the Element dialogue.
DIgSILENT PowerFactory 15, User Manual 805
CHAPTER 37. ARC-FLASH HAZARD ANALYSIS
Fault Clearing Times
Select either:
Use Fixed Times. In which case, detailed protection models are not required by the calculation,
and the following should be dened:
If Get Time from Global is selected, then dene the Protection Tripping Time and Breaker
Opening Time.
If Get Time from Local is selected, then dene the Maximum Time, the maximum fault clear-
ing time used by the Arc-Flash command. The clearing times used by the arc-ash command
are taken from the Protection page of (ElmCoup) and (ElmSwitch) Elements, with Switch
Type set to Circuit Breaker on the Basic Data page.
Use Relay Tripping. In which case, the tripping time is based upon the relay characteristic en-
tered in the protection model (provided that on the relay(s) Description tab, the Status is set to
Approved). The Arc-Flash Hazard Analysis command performs Incident Energy calculations us-
ing this tripping time, and the tripping time based on a reduced fault current, as specied on the
Advanced Options page (parameter Arcing Current Variation). If Use Relay Tripping is selected,
then select to:
Get Time from either:
*
Initial, in which case the arc-ash command determines the fault clearing time based
on the longest fault clearing time of any element connected to the faulted terminal. For
example, if two parallel lines are connected to a faulted terminal, and the rst line has a
fault clearing time of 1 s, and the second line has a fault clearing time of 2s (where both
clearing times are based on the Initial fault current) the arc-ash command will take 2 s
as the fault clearing time.
*
Iteration, in which case the arc-ash command determines the fault clearing time from
a Short-Circuit Trace calculation. For example, if two parallel lines are connected to a
faulted terminal, and the rst line has a fault clearing time of 1s. Then, after the rst line
is cleared, the second line sees a higher fault current, and subsequently clears the fault
at 1.5 s. The arc-ash command takes 1.5 s as the fault clearing time.
Dene the Maximum Time, the maximum fault clearing time used by the Arc-Flash command.
Short-Circuit Calculation
Pointer to the Short-Circuit Calculation command.
Show Output
If selected, the pointer to the Output of Results can be modied. See Section 37.4 for details.
Note: When there are multiple sources of fault current to a faulted Terminal with different fault clearing
times, PowerFactory takes the maximum clearance time of the connecting branch for all branches.
37.3.2 Arc-Flash Hazard Analysis Advanced Options Page
Arc-Flash Calculation Options
Dene the Arcing Current Variation, that is, the percentage the bolted-fault current is reduced by
for the second calculation (see 37.3.1).
Dene the Energy at Flash-Protection Boundary.
PPE-Ratings
Select either:
806 DIgSILENT PowerFactory 15, User Manual
37.4. ARC-FLASH HAZARD ANALYSIS RESULTS
Acc. to NFPA 70E[14], in which case default values from the standard are used.
User-Dened, in which case user-dened Category values can be entered in the PPE-Categories
table after inserting or appending rows. Note that values should be entered in ascending order.
37.4 Arc-Flash Hazard Analysis Results
37.4.1 Viewing Results in the Single Line Graphic
Results Boxes
Terminals can be coloured according to calculated PPE category, and the calculated ash protection
boundary. To set the diagram colouring mode, select the Diagram Colouring icon, and then under 3.
Other, select Results, and then the desired colouring mode.
Diagram Colouring
To show the default set of Arc-Flash results on the Single Line Graphic (Boundary Distance, PPE Cate-
gory, and Incident Energy), right-click the Terminal results box and select Format for Short Circuit Nodes
Arc-Flash. Arcing Current and Fault Clearing Time results can also be displayed.
37.4.2 Arc-Flash Reports Dialogue
The Arc-Flash Reports (ComArcreport ) dialogue can be used to congure the output of tabular results
from an Arc-Flash calculation. Additionally, Database and Template les can be selected in order to
facilitate the preparation of Arc-Flash Hazard warning labels. The following inputs are available in the
Arc-Flash Reports dialogue.
Create Label Database
If selected, Database and Template lenames should be specied. By default, a default Template is
selected by PowerFactory. Note that the Database Excel le should not be open when Create Label
Database is checked and the command is executed.
Available Variables and Selected Variables
Variables to be included in the Tabular report can be selected or deselected (in which case they will be
on the Available Variables pane.
Create Tabular Report
Select whether to Create Tabular Report, and dene the Min. PPE-Category and Min. Incident Energy
to be included in the Tabular report. Once the tabular report is created, Min. PPE-Category and Min.
Incident Energy can be modied if required.
After being executed, the Tabular Report can be exported as HTML format or exported directly to Excel,
by using the Select icon ( ).
Note: If the incident energy exceeds the incident energy at the maximum PPE category, the result is
N/A.
37.4.3 Arc-Flash Labels
The Create Label Database option, handled by a DPL script, triggers an export of the selected vari-
ables to a Microsoft Excel le at the selected location. After the export of label data, a copy of the given
label template will be stored at the same location as the Excel le and renamed accordingly. (i.e. if the
Excel le is called ArcFlash.xls, the copy of the template will be called ArcFlash.doc). If a template
DIgSILENT PowerFactory 15, User Manual 807
CHAPTER 37. ARC-FLASH HAZARD ANALYSIS
le with this name already exists, the user will be prompted if it should be overwritten. The template
copy will be opened after the export is completed. The user can use the mail merge feature of Microsoft
Word to create a series of labels based on the template and the Excel data le. To link the template
copy with the database:
Go to the Mailings tab, in the Start Mail Merge group, and click on Select Recipients.
From the drop down menu, select Use Existing List..., and then select the label database Excel
le.
Still on the Mailings tab, in the Preview Results group, click on Preview Results to view the
label(s).
To store or print the nished labels, still on the Mailings tab, in the Finish group, click on Finish
& Merge.
For more information about the mail merge and how to create a template, refer to the MS-Word help.
Also note that data can be copied from the Flexible Data tab of the Data Manager for post-processing
and creation of labels.
37.5 Example Arc-Flash Hazard Analysis Calculation
Consider the example network shown in Figure 37.5.1, where there are two parallel lines connected to
a Terminal Terminal. For this example, the two lines have different protection characteristics, as shown
in Figure 37.5.2.
Figure 37.5.1: Example Network Single Line Graphic
808 DIgSILENT PowerFactory 15, User Manual
37.5. EXAMPLE ARC-FLASH HAZARD ANALYSIS CALCULATION
Figure 37.5.2: Example Network Single Line Graphic
Arc-Flash calculations are conducted using each method:
With Use Fixed Times and Get Time from Global selected, and with a total fault clearing time of
0.12 s, the key results are as follows:
Incident Energy: 58 J\cm
2
.
Boundary Distance: 583 mm.
PPE Category: 3.
With Use Fixed Times and Get Time from Local selected, and with a total fault clearing time of
0.10 s, the key results are as follows:
Incident Energy: 49 J\cm
2
.
Boundary Distance: 624 mm.
PPE Category: 3.
With Use Relay Tripping and Get Time from Initial selected, the key results are as follows:
Incident Energy: 37 J\cm
2
.
Boundary Distance: 544 mm.
PPE Category: 3.
With Use Relay Tripping and Get Time from Iteration selected, the key results are as follows:
Incident Energy: 24 J\cm
2
.
Boundary Distance: 441 mm.
PPE Category: 2.
Of particular interest is the difference between the results for the case where Get Time from Initial is
selected, versus Get Time from Iteration. The former case gives conservative results (in this example),
whilst in the latter case, the fault clearing time is faster due to recalculation of the fault current (as
discussed in Section 37.3.1), and thus the calculated PPE requirement is lower.
DIgSILENT PowerFactory 15, User Manual 809
CHAPTER 37. ARC-FLASH HAZARD ANALYSIS
A label is produced for Terminal (as described in 37.4), for the method where Relay Tripping, and Get
Time from Initial is selected. The resultant label is shown in Figure 37.5.3.
Figure 37.5.3: Example Arc-Flash Warning Label
810 DIgSILENT PowerFactory 15, User Manual
Chapter 38
Protection
38.1 Introduction
PowerFactory enables the user to dene a protection scheme by integrating protective devices into the
system dened by a projects network model. The software can be used to assist with the coordination
of protective devices and for generating graphical representations of protection system characteristics.
Models of both generic and manufacturer specic relays are available for use with the software. Graph-
ical plots of the following characteristics are possible:
Current vs time plots
Distance vs time plots
Impedance plots
This chapter will describe how to use the protection analysis functions included in the PowerFactory
software.
38.2 General approach to protection modelling in PowerFactory
This section shall provide an overview of the modelling philosophy behind protection devices in Pow-
erFactory. Although it is not entirely necessary for the user to have an understanding of the modelling
approach in order to use PowerFactorys basic protection functions an understanding will help the user
to appreciate the structure of the dialogues encountered whilst setting up a protection scheme. Users
who wish to move straight into the creation of a protection scheme may wish to skip this section.
38.2.1 The Modelling Structure
Protection devices form a group of highly complex and non-uniform power system devices. Any program
tasked with modelling these devices faces a difcult dilemma. On the one hand, the relay models should
be as exible and versatile as possible to ensure that all types of protection relays can be modelled with
all of their features. On the other hand, the relay models should be as simple as possible in order to
reduce the amount of work and knowledge needed to dene power system protection devices.
This dilemma is solved in PowerFactory by modelling protection devices in three different levels. These
levels are:
DIgSILENT PowerFactory 15, User Manual 811
CHAPTER 38. PROTECTION
the relay frame
the relay type
the relay element
Each of these levels fulll a different role in the modelling of a protection device. Figure 38.2.1 shows
the relation of these three levels graphically.
Figure 38.2.1: Modelling structure for protection devices
The Relay Frame
The relay frame species the general relay functionality using a diagram in which functional blocks
known as slots are connected by signals. Slots for timers, measurement and logic elements can be
dened. It denes how many stages the relay consists of and how these stages interact. However, the
relay frame has no intelligence, as it does not specify any algorithmic details. Each slot is merely dened
by the number of input and output signals. The signal lines dene how these slots are interconnected.
Relay frames are similar to the frames of composite models and are created in the same way. See
Chapter 25:Stability and EMT Simulations, Section 25.9.2 (The Composite Frame) for more information.
Figure 38.2.2 shows an example of a relay frame for a two stage overcurrent relay. The illustrated
relay frame contains a measurement slot, two instantaneous overcurrent slots (each representing one
stage of the overcurrent relay) and a logic slot. Connections between slots are illustrated by lines with
arrowheads.
812 DIgSILENT PowerFactory 15, User Manual
38.2. GENERAL APPROACH TO PROTECTION MODELLING IN POWERFACTORY
Figure 38.2.2: Typical relay frame
The Relay Type The relay type associated with a specic relay frame, is dened by selecting a block
denition for each slot of the frame. Assigning a block denition to a slot converts the slot to a block,
representing a mathematical function which describes the behaviour of a physical element. For example
the type of lter used for processing the input signals, or the type of relay operating characteristic. Since
many relays support more than one type of characteristic a set of characteristics or functions can be
dened. In addition, the relay type species the ranges for the various relay settings, including whether
the parameters are set continuously or in discrete steps.
The relay type denes the library information for a specic manufacturers relay, which does not yet
have any settings applied to it. The complete information described in the data sheet and manual is
contained in the relay type. An advantage of this split concept is the possibility of re-using a relay frame
for more than one relay type.
Figure 38.2.3 shows the type dialogue associated with an instantaneous overcurrent slot as an example.
Parameters that normally can not be inuenced by the user, like the Pick-up Time, are dened in the
type as well.
DIgSILENT PowerFactory 15, User Manual 813
CHAPTER 38. PROTECTION
Figure 38.2.3: Type dialogue of an instantaneous overcurrent block
The Relay Element
The relay element models the actual relay in a power system. It refers to a relay type in the library, which
provides the complete relay structure including the setting ranges for all parameters. The actual settings
of the relay, e.g. reach or the pick-up settings, form part of the relay element settings, considering the
range limitations dened by the relay type.
CT and VT models form the input link between a relay element and the electrical network. For the relay
output a tripping signal is sent directly from the relay element to a breaker in the modelled system. To
simulate busbar protection, or any tele-protection schemes, a relay element can operate more than one
breaker.
Figure 38.2.4 shows the block element dialogue belonging to the type dialogue in Figure 38.2.3.
Figure 38.2.4: Element dialogue of an instantaneous overcurrent relay
814 DIgSILENT PowerFactory 15, User Manual
38.3. DEFINING A PROTECTION SCHEME
- A BRIEF OVERVIEW
38.3 Dening a protection scheme
- a brief overview
In order to dene a protection scheme it is rst necessary to construct a model of the network to be
protected. Once this is complete, it is possible to begin.
A scheme is dened by adding relays (or fuses) and any corresponding instrument transformers at
appropriate places within the single line graphic. Once the hardware has been dened relay settings
and any relay output logic are dened.
The PowerFactory protection modelling features have been designed to support both general and de-
tailed denition and analysis of power system protection schemes.
For general denition and analysis the software offers a global library containing a suite of predened
generic relays, fuses and instrument transformers which may be used to design schemes without mak-
ing reference to the specic details of any particular relay manufacturers range of products. This can
often be of use during the early stages of the denition of a protection scheme. By modelling with
generic protection devices the user can conrm the general functionality of a scheme before relay pro-
curement decisions have been nalised.
For detailed denition and analysis, the user may implement detailed manufacturer and relay specic
models. In many cases, models of specic relays are available predened and access to these models
can be offered to the user. In some instances a model will not exist. If this is the case, advanced users
may be able to dene their own relay models.
The remainder of this section will briey explain how to add predened protective devices to a network
model.
38.3.1 Adding protective devices to the network model
Protection devices must be placed within cubicles. Editing or creating protection devices in a cubicle
can be done in several ways:
by right-clicking a switch-symbol in the single line graphic as illustrated in Figure 38.3.2. This will
bring a pop up menu with the options Edit Devices and New Devices.
by editing the object which is to be protected (line, transformer, load, etc.) and pressing the
button at the cubicle eld. See Figure 38.3.2 for example. The option Edit Devices will open a list
of all protection devices in the cubicle. New devices may then be created with the icon.
by opening a detailed graphic of a substation and right clicking on the specic part of the substation
to which the relay should be added. This will bring a pop up menu with the options Edit Devices
and New Devices. The areas which can be right clicked in a typical detailed substation graphic
are ringed in Figure 38.3.2.
Note: To add a device by right-clicking on a switch, make sure the element associated with the switch
is deselected before right-clicking directly on the switch. If successfully completed, only half of the
element will be marked as selected.
DIgSILENT PowerFactory 15, User Manual 815
CHAPTER 38. PROTECTION
Figure 38.3.1: Adding a new relay to a single line diagram
816 DIgSILENT PowerFactory 15, User Manual
38.3. DEFINING A PROTECTION SCHEME
- A BRIEF OVERVIEW
Figure 38.3.2: Editing line protection devices
Figure 38.3.3: Adding a new protective device to a detailed substation graphic
DIgSILENT PowerFactory 15, User Manual 817
CHAPTER 38. PROTECTION
In all cases, selecting the option to create a new protection device will open up a list with the following
options:
Relay Model (ElmRelay)
Fuse (RelFuse)
Current Transformer (StaCt )
Voltage Transformer (StaVt )
If selected, each of these options will open a dialogue to setup the device that is to be created.
38.3.2 Locating Devices which have been added to
the network model
Once placed in the network there are three main ways to locate protective devices.
Locating protective devices in the single line diagram
The single line diagram can be coloured to indicate the location of protective devices. To do this click
the diagram colouring button from the local graphics window icon bar, then select:
protection tab 3. Otherssecondary equipment Relays, current and voltage transformers.
The location of these devices should now be indicated in the single line diagram. If the protection tab is
not present within the dialogue which appears when the diagram colouring button is pressed, select:
tools User settingsthe functions tabCheck the protection checkbox.
Locating protective devices using the object lter
Protective devices can be located by selecting the edit relevant objects for calculation button from the
main icon bar and browsing through the relay elements and types in the object lter.
Marking relays in the single line diagram
A relay entry in the data manager or object lter may be used to locate the relay in the single line graphic.
This is achieved by right clicking on the relay entry and selecting mark in graphic from the contextual
menu which appears. The relay will then be selected in the single line diagram.
38.4 Setup and analysis of an overcurrent
protection scheme
Section 38.3.1: Adding protective devices to the network model, explained the initial steps that should
be taken in order to create a new protective device. When a new device is created within a network
model there are a number of parameters to dene in the dialogue which appears. This section will
describe the basic steps that should be completed in order to specify these parameters for overcurrent
relays and fuses. The section will also describe how to perform graphical analysis in the form of a
time-overcurrent plot.
38.4.1 Overcurrent relay model setup - basic data tab
818 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
The basic data page in the relay model (ElmRelay) dialogue is used to select the precise relay type and
the settings to apply to the relay. It can also be used to select the instrument transformer(s) through
which it will interface with the power system. See Fig. 38.4.1 for an example of the basic data page
dialogue.
Before the relay can be congured the relay type must be selected. This is achieved by pressing the
button at the Relay Type eld and selecting a device from the appropriate library. The settings to be
applied to the relay and the instrument transformers are dened within the slot denition list. Without a
specied type the Slot Denition list is empty and the relay is not functional. After a relay type has been
selected, the Slot Denition list will be lled automatically with the correct slot elements corresponding
with the functionality of the selected relay.
Editing the settings of the relay model is done by editing the settings of the listed slot elements. Double-
clicking a slot element in the Slot Denition list will open the dialogue of that element.
Instrument transformers can be assigned to relays in numerous ways. If the cubicle in which the relay
has been installed does not contain any instrument transformers then create VT and create CT buttons
will appear at the bottom of the dialogue once the relay type has been selected. By clicking on these
buttons it is possible to create and select an appropriate device which will be assigned to the same
cubicle as the relay by default. Alternatively, if instrument transformers already exist in the cubicle
then these will be assigned to the relevant relay slot element automatically. If the default instrument
transformer selected in the slot element needs to be changed, this can be achieved by double clicking
on the slot element.
The Application and Device Number elds are for documentation purposes only. The Location eld
is automatically read from the cubicle the relay is stored in. By default PowerFactory will assign the
relay with control of a switch element which is installed in the same location as the relay. In some
circumstances the switch which should be controlled is not in the same location as the relay. If this
is the case the relay can be assigned with a reference location corresponding with the location of the
switch which should be controlled.
38.4.2 Overcurrent relay model setup - max/min fault
currents tab
This tab can be used to enter the minimum and/or maximum fault currents occurring at the location
of the relay. These values are used to scale the Time-Overcurrent plot according to the given fault
currents. They can be entered either manually or calculated with the Short-Circuit-Command.
Note: The currents entered on this page will not affect the relay model. They are for plotting purposes
only.
DIgSILENT PowerFactory 15, User Manual 819
CHAPTER 38. PROTECTION
Figure 38.4.1: Relay model dialogue with selected type
38.4.3 The Current Transformer
A new current transformer (CT) can be created as described in section 38.3.1 (Adding protective devices
to the network model). Alternatively a CT can be created by using the Create CT button in the relay
model dialogue. The dialogue as depicted in Figure 38.4.2 will then pop up.
820 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Figure 38.4.2: The Current Transformer dialogue
When a CT is created it is stored in the cubicle that was right-clicked or in the cubicle the relay is stored
in. The Location elds Busbar and Branch will be set automatically in both cases.
A current transformer needs a current transformer type if it is required to have a tap ratio. Otherwise,
the only ratio available is 1A/1A, as depicted above.
The top Location eld is used either
to select the cubicle the CT is located in. For instance, the CT may actually be located in a different
cubicle than the relay it was created with.
to select the preceding CT in the case of an auxiliary CT.
After selecting the type and the setting of the current transformer, its set ratio is shown in the dialogue
(Ratio). In very special cases CTs may be connected in series, that is the output of one CT may be
used as the input of the second CT. In this application the second CT will show a Ratio (the actual ratio
of the CT) and a Complete Ratio, (the ratio between the primary branch ow and the secondary CT
current, which is the overall ratio of all CTs connected in series).
The primary connection type is only available for the case of an auxiliary CT. The number of phases can
be set to 3, 2 or 1. For a 3- or 2-phase CT, the secondary connection type can be set to D or Y. For a
1-phase CT, the phase can be set to
a, b or c phase current
N = 3 I
0
I
0
= I
0
The primary and secondary tap settings are limited to the values dened in the current transformer type.
The Current Transformer Type The current transformer type dialogue, as depicted in Figure 38.4.3,
denes the single phases of a CT. The information about the connection of these phases (Y or D) is
dened in the CT element that uses the CT type.
DIgSILENT PowerFactory 15, User Manual 821
CHAPTER 38. PROTECTION
Figure 38.4.3: The Current Transformer Type dialogue
The current transformer type denes the primary and secondary taps of the transformer. The Additional
Data page of the CT Type is only for documentation purposes.
The accuracy parameters to be set are:
The accuracy class
The accuracy limit factor
either
The apparent power (acc. to IEC)
The burden impedance (ANSI-C)
The voltage at the acc. limit (ANSI-C)
The Additional Data page of the CT element is used only when the detailed model tick box is selected
and can be used to enter saturation data of the CT element.
38.4.4 The Voltage Transformer
A new voltage transformer (VT) can be created as described in section 38.3.1 (Adding protective devices
to the network model). Alternatively a VT can be created by using the Create VT button in the relay
model dialogue. The dialogue as depicted in Figure 38.4.4 will then pop up.
822 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Figure 38.4.4: The Voltage Transformer dialogue
When a VT is created it is stored in the cubicle that was right-clicked or the cubicle the relay is stored
in.
A voltage transformer needs a voltage transformer type, if it is required to have a tap ratio. The Location
eld is used either
to select the cubicle the VT is located in. For instance, the VT may actually be located in a different
cubicle than the relay it was created with.
to select the preceding VT in the case of an auxiliary VT
After selecting the type and the setting of the VT, its set ratio is shown in the dialogue (Ratio).
The primary winding is dened by selecting a tap and a connection type. The available tap range is
dened in the voltage transformer type.
The secondary winding is dened by the secondary winding type, the tap setting and the connection
type. The available tap range is dened in the secondary winding type. A voltage transformer has at
least one secondary winding. If no type is selected for the rst secondary winding, it is assumed to be
ideal and has the standard tap range 100V-130V available. More windings can be dened by pressing
the button Additional Secondary Windings. This will bring a list of all previously dened secondary
windings. New windings can be created by pressing the icon.
The connection type O for the secondary windings is the Open Delta connection, as depicted in Fig-
ure 38.4.5.
DIgSILENT PowerFactory 15, User Manual 823
CHAPTER 38. PROTECTION
Figure 38.4.5: The open delta (O) winding connection
Figure 38.4.6: The V winding connection
The VT Secondary Winding A secondary winding element is needed when a voltage transformer with
two or more secondary windings has to be modelled. The edit dialogue for the voltage transformer
provides parameters to dene the rst secondary winding.
Figure 38.4.7: The VT secondary winding dialogue
The secondary winding element requires a type and a reference to the voltage transformer. The tap
settings range is dened by the windings type.
824 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
The Voltage Transformer Type The voltage transformer type, as depicted in Figure 38.4.8 denes
the primary winding of the voltage transformer. The secondary windings are dened in the voltage
transformer element.
Figure 38.4.8: The voltage transformer type dialogue
The VT Secondary Winding Type The secondary winding type, as depicted in Figure 38.4.9, denes
the burden and tap range for one phase of a voltage transformer. The phase connection type (Y, D,
etc.) is dened in the secondary winding element. The secondary tap settings dened in the secondary
winding type determine the available taps for the secondary winding element.
Figure 38.4.9: The VT secondary winding type dialogue
DIgSILENT PowerFactory 15, User Manual 825
CHAPTER 38. PROTECTION
38.4.5 Fuse model setup - basic data tab
The fuse model is implemented as a special instantaneous overcurrent relay which does not need a
current transformer. Typically a fuse will provide single phase tripping when the current in the fuse
element exceeds the current specied by the fuses melt characteristic. Optionally, three phase tripping
can be offered whereby the tripping of all phases will occur if the current in any one fuse element
exceeds the current specied by the fuses melt characteristic.
The user can choose whether the total clear curve or the minimum melt curve is used to calculate fuse
operating times. An example of these curves is shown in Figure 38.4.11.
Figure 38.4.10: The Fuse model Basic Data dialogue
38.4.6 Fuse model setup - optimization tab
In the optimization page, the fuse can be excluded from the open-tie-optimization-algorithm (see Chap-
ter 33, Section 33.4: Tie Open Point Optimization). This option is to be considered only if the Fuse Type
is set to something other than Fuse.
826 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Figure 38.4.11: Fuse melt characteristics
38.4.7 Basic relay blocks for overcurrent relays
As discussed in section 38.2 (General approach to protection modelling in Power Factory) all relay mod-
els contain slots which are placeholders for block denitions. There are many types of block denition
and each type has a different function. By interconnecting different slots containing block denitions
in different ways, and offering the user the ability to ne tune the block denition by entering their own
parameters, it is possible to produce relay models with a large variety of operating characteristics. It is
even possible for the user to dene their own types of protection device. The creation of user dened
protection devices is covered in the section 38.8 (Building a Basic Overcurrent Relay Model).
The blocks contained within a relay are listed in the slot denition section of the relay model dialogue.
In general the user will need to dene parameters within these relay blocks. The settings dialogue can
be reached by double clicking on the block of interest in the net elements column.
If the user is interested in viewing a graphical representation of the interconnection of slots for a partic-
ular relay then the user should nd the following icon associated with the relay in the data manager.
By right clicking on this icon and selecting show graphic, a graphical representation of the relay frame
will appear in a new window.
The measurement block The measurement block uses the raw signals produced by the current or
voltage transformers to calculate measured signals.
The measurement block allows for setting the nominal current and voltage. Both are limited by the
measurement unit type. If a relay does not need a nominal voltage (i.e. in the case of an overcurrent
relay) or if there is only one nominal value to choose from, the nominal voltage and/or current eld will
normally be disabled.
DIgSILENT PowerFactory 15, User Manual 827
CHAPTER 38. PROTECTION
Figure 38.4.12: Measurement block
The directional block The directional block calculates the angle between a polarization voltage or
current phasor and an operating current phasor. The relative angular position of the polarization current
or voltage phasor can be selected. A tripping condition is considered to be present if the angle between
the operating and polarization phasor is less than 90
pol
denes a half plane which forms the
rst tripping condition. The second tripping condition whereby the magnitude of the operating quantity
must be in excess of a setting threshold is illustrated by the dashed semicircle.
More details about the polarization methods and the tripping conditions can be found in the Appendix C:
Technical References of Models. An example of a directional block dialogue can be seen in Fig-
ure 38.4.14.
Typically directional blocks are combined with overcurrent blocks.
828 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Figure 38.4.14: Directional block
The instantaneous overcurrent block The instantaneous overcurrent block allows for the setting of
the pickup current and the time setting. The setting ranges are dened by the type. See Figure 38.4.15.
Figure 38.4.15: Instantaneous overcurrent block
The instantaneous overcurrent block is a combination of a direct overcurrent relay and an optional time
delay. The pickup time Ts is the minimum time needed for the relay to react. Additionally, a time dial
Tset may be specied. The block will not trip unless the current exceeds the pickup current Tsetr for at
least Ts+Tset. See Figure 38.4.16.
DIgSILENT PowerFactory 15, User Manual 829
CHAPTER 38. PROTECTION
Figure 38.4.16: Instantaneous overcurrent tripping area
The block will not reset until the current drops under the reset level, which is specied by the relay type
in percent of the pickup current: Ireset=IpsetKr/100%. See Figure 38.4.17 for a typical timing diagram.
Figure 38.4.17: Instantaneous overcurrent timing diagram
The time overcurrent block The time-overcurrent block allows selection of one of the I-t characteristic
which are available for the selected relay type. Furthermore, a pickup current and a time setting should
be specied. The setting ranges are dened by the type. See Figure 38.4.18 for an example.
830 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Figure 38.4.18: Time overcurrent block
The time dial settings will scale the I-t curve in the Time vs. I/Ip plot, according to the curve denition.
See Figure 38.4.19 for example.
Figure 38.4.19: I-t curves for different time dials
The pickup current denes the nominal value Ip which is used to calculate the tripping time. The I-t
curve denition states a minimum and a maximum per unit current. Lower currents will not trip the relay
(innite tripping time), higher currents will not decrease the tripping time any further. These limits are
shown in Figure 38.4.20.
DIgSILENT PowerFactory 15, User Manual 831
CHAPTER 38. PROTECTION
Figure 38.4.20: I-t curve limits
The pickup current may be dened by the relay type to be a per unit value, or a relay current. The
nominal current dened by the measurement unit (see section 38.4.7 (The measurement block)) is
used to calculate Ip. In the case of a per unit value, the relay current value already equals Ip.
Altering the pickup current will thus not change the I-t curve, but will scale the measured current to
different per unit values. The following example may illustrate this:
Suppose the minimum current dened by the I-t curve is imin=1.1 I/Ip.
Suppose the measurement unit denes Inom=5.0 rel.A.
Suppose pickup current Ipset=1.5 p.u.
relay will not trip for I < 1.10 1.5 5.0rel.A = 8.25rel.A
Suppose pickup current Ipset=10.0 rel.A
relay will not trip for I < 1.1 10.0rel.A = 11.0rel.A
The logic block The logic block is the front end part of a relay conguration. It combines all internal
trigger signals by successive AND and OR operations and produces one single output. The block type
species the logical operation, the logic block itself species the switches which will be opened when
the relay trips. If the relay is located in a cubicle and no switch has been specied, the breaker in the
cubicle will be opened by default. See Figure 38.4.21 for an example of the logic block settings dialogue.
832 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Figure 38.4.21: Logic block
38.4.8 The time-overcurrent plot
The plot VisOcplot can be used for graphical analysis of an overcurrent protection scheme to show
multiple relay and fuse characteristics on one time-overcurrent plot. Additionally thermal damage curves
and other characteristic currents of electrical equipment in the network can easily be superimposed on
the plot. These plots can be used to determine relay tripping times as well as to assist with the selection
of relay settings and fuses characteristics.
There are several ways to create a time-overcurrent plot (VisOcplot ):
Select a switch, where overcurrent relays or fuses are installed. Right-click the switch to open
the context sensitive menu. This will show the options Create Time-Overcurrent Plot and Add to
Time-Overcurrent Plot. PowerFactory will then create a new diagram showing the time-overcurrent
plot for all relays selected.
Right-click a path element and select Path . . . Time-Overcurrent Plot from the context sensitive
menu. Refer to section 38.5.5 (The time-distance plot) for more information on dening paths.
A relay element ElmRelay can be chosen from the list of calculation-relevant objects or in the data
manager. Right-click the relay on the right side of the data manager or in the list of relays. Then
select Show Time-Overcurrent Plot to create a new plot or Show Add to Time-Overcurrent
Plot to add the characteristic to an existing plot.
Other elements such as one or more transformers, cables or motors can be selected and right-
clicked. The context sensitive menu will showthe options Show Time-Overcurrent Plot to create
a new plot and Show Add to Time-Overcurrent Plot to add the characteristic to an existing plot.
Note: To show the relay locations and thus to visualize the switches with relays denitions these can
be highlighted by setting the colour representation of the single-line diagram to Relay Locations.
By right-clicking these elements the option Show Time-Overcurrent Plot is available and can
be chosen.
In all these cases, it is also possible to select the option Add to Time-Overcurrent Plot. This will open a
list of previously dened over current plots from which any one can be selected.
The overcurrent plot shows
DIgSILENT PowerFactory 15, User Manual 833
CHAPTER 38. PROTECTION
the time-current characteristics of relays
the damage curves of transformers or lines
motor starting curves
the currents calculated by a short-circuit or load-ow analysis and the resulting tripping times of
the relays
See Figure 38.4.22 for an example.
Figure 38.4.22: A time-overcurrent plot with short-circuit results
The time-overcurrent plot shows the results of the short-circuit or load-owanalysis as a vertical x-value
line across the graph. Because the currents differ for each particular relay, a current line is drawn for
each relay. The intersection of the calculated current with the time-overcurrent characteristic is labelled
with the tripping time. A grading margin line, which shows the difference between the tripping times,
may be added by right-clicking the plot and selecting Show Grading Margins.
It is also possible to create a user dened x-value by right-clicking the graph and selecting the Set
Constant x-value option. The vertical line will show the values at the intersections of all displayed
characteristics. To move the line left, drag it with the mouse.
38.4.8.1 Overcurrent plot settings
The time-overcurrent plot settings can be accessed by selecting the Options from the context-sensitive
menu. The dialogue shows the following options:
Current Unit The current unit may be set to either primary or secondary (relay) amperes.
834 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Show Relays This option is used to display only certain types of relay characteristics.
Recloser Operation The different recloser stages can be shown simultaneously or switched off in the
diagram.
Display automatically This option is used to select how the calculated load-ow or short-circuit cur-
rents will be displayed. Either the current lines, the grading margins, both or none may be selected.
Voltage Reference Axis More than one current axis may be shown, based on different voltage levels.
All voltage levels found in the path when a time overcurrent plot is constructed are shown by
default. A user dened voltage level may be added. Optionally, only the user dened voltage level
is shown.
Cut Curves at normally the curves of different relay zones cut at the same tripping current.
Show Grading Margins while Drag&Drop When dragging curves, the grading margins of the curve
will be shown according to the margin entered.
Figure 38.4.23: Overcurrent Plot Settings
The advanced options are:
Drag & Drop Step Sizes These are used to set the step change in the relay settings when a time-
overcurrent plot is dragged with a continuous time dial or pickup current.
Time Range for Step Sizes Enter the tripping time range for the y-axis.
Colour for Out of Service Units The characteristics for units that are out of service are drawn invisi-
ble by default. However, a visible colour may be selected.
Brush Style for Fuses This denes the ll style for fuse curves
Number of points per curve The number of points can be changed to either rene the plotted curves
for more detail, or to speed up the drawing of the diagram.
DIgSILENT PowerFactory 15, User Manual 835
CHAPTER 38. PROTECTION
38.4.8.2 Changing Tripping Characteristics
The time overcurrent plots may also be used to change the relay characteristics graphically. Since a
relay characteristic is normally constructed from at least two sub-characteristics, it must rst be split so
that the setting associated with each of the sub-characteristics may be altered separately.
A characteristic is split by
right-clicking the characteristic
enable the split option
The relay characteristics can also be split by opening the edit dialogue of the plot and enabling the
option Split Relay in the table Relays, where all relays are listed.
The sub-characteristics are now visible. Each of them can be left clicked and dragged along the time-
overcurrent plot area. However, they cannot be dragged outside the allowed range which has been
dened for the relay type. After the relay sub-characteristics have been changed, they can be combined
again into one single characteristic by disabling the split option.
If the user wishes to alter the relay characteristics by entering numerical settings parameters this can be
achieved by double clicking directly on the relay characteristic and altering the settings in the dialogue
that appears.
The plot option dialogue, which is opened by right-clicking the plot area and selecting Options, has
an option for showing the grading margins. When this option is selected, the grading margins will
appear whenever a time overcurrent characteristic is dragged. The grading margin is set to a xed time
which denes an envelope around the characteristic. The upper limit of the envelope is dened by the
characteristic operating time plus the grading margin and the lower limit of the envelope is dened by
the characteristic operating time minus the grading margin. See Figure 38.4.24 for an example: the
original characteristic is labelled 1, the new position as 2, and the grading margins are labelled a.
Figure 38.4.24: Grading margins when Moving a characteristic
38.4.8.3 Equipment Damage Curves
Equipment damage curves are used to aid the positioning of relay and fuse time-current characteristics
to ensure that thermal damage to equipment is minimized in the event of an overload or short circuit.
836 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Damage curves can be created in the following ways:
Via the context-sensitive menu of the single-line diagram or the data manager (Show sub-
menu).
Via the context-sensitive menu of the Time-Overcurrent Plot itself (Add submenu)
Types of damage Curves
The following types of damage curves exist:
Conductor damage curve
Transformer damage curve
Motor starting curve
Equations
This section describes the underlying equations and references the respective standards.
Note: The equations in this section are given with respect to the rated current of the equipment. For
the correct drawing in the overcurrent plot, the currents will be rated to the reference voltage of
the plot.
I = I
rat
U
rat
U
ref
(38.1)
Conductor Damage Curve
The conductor damage curve consists of four parts.
Rated Current Curve
The rated current curve represents the nominal operation limits of the conductor.
I(t) = I
rat
(38.2)
Where:
I
rat
rated current of the line [A]
Short-Time Withstand Curve
The short-time withstand curve represents the maximum amount of (short-circuit) current the conductor
can withstand for short time periods (typically 1s) without taking damage.
There are two separate equations for this curve, both are drawn for 0,1s t 10s
Using the rated short-time withstand current:
I(t) = I
thr
_
T
thr
t
(38.3)
DIgSILENT PowerFactory 15, User Manual 837
CHAPTER 38. PROTECTION
Where:
I
thr
rated short-time current of the line [A]
T
thr
rated short-time duration of the [s]
Using material data (only available for the generic type):
I(t) =
F
ac
k A
t
(38.4)
Where:
F
a
lateral conductivity [-]
A conductor cross-sectional area [mm
2
/kcmil]
k conductor/insulation parameter [
A
s
mm
2
/
A
s
mm
2
kcmil]
The conductor/insulation parameter can be provided by the user or calculated according to the stan-
dards equations as follows:
IEC/VDE equations [13]:
k = c
1
_
ln(1 +
f
i
c
2
+
i
) (38.5)
ANSI/IEEE equations [3]:
k =
_
c
1
log
f
+c
2
i
+c
2
(38.6)
Where:
c
1
material constant [-]
c
2
material constant [-]
f
max. short-circuit temperature [
C]
i
initial temperature [
C]
Note: Both equations for the conductor/insulation parameter are slightly adapted (from the original form
in the standards) to t into the same form of equation.
The values for the material constants can be taken from the table below.
Standard IEC/VDE ANSI/IEEE
Conductor Material Copper Aluminium Copper Aluminium
c
1
226 148 0,0297 0,0125
c
2
234,5 228 234 228
Table 38.4.1: Material Constants for Short-Term Withstand Calculation
838 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
The initial temperature and nal temperature
i
and
f
mainly depend upon the insulation of the con-
ductor. The initial temperature is usually the maximum allowable continuous current temperature, whilst
the nal temperature is the maximum allowable short circuit temperature. Typical values for
i
and
f
are given in gure 38.4.25.
Figure 38.4.25: Typical cable initial temperature and nal temperature values (data from the BICC
Electric Cables Handbook 3rd edition)
The option user dened may also be selected in the calculate K eld of the dialogue, allowing the user
to enter a value for K manually. The dialogue for doing this is illustrated in gure 38.4.26.
Figure 38.4.26: Conductor/Cable damage curve
Alternatively, rated short-circuit current and time may be entered if Rated Short-Time Current is entered
DIgSILENT PowerFactory 15, User Manual 839
CHAPTER 38. PROTECTION
as the input method.
If the user wishes to dene an alternative conductor/cable damage curve this can be achieved by se-
lecting User Dened curve New project type.
Skin effect ratio or ac/dc ratio is a constant as dened in the NEC electrical code. The value is used
when carrying out calculations to IEEE/ANSI standards and is not typically referred to by IEC/VDE
standards. However, the user is given the option to specify this value when using either set of standards.
Long time overload curve
The overload page allows the user to dene the overload characteristic of the conductor. If an overload
characteristic is required, it is necessary to ensure that the draw overload curve checkbox is selected
as illustrated in gure 38.4.27.
Figure 38.4.27: Overload curve settings
The user then has the option to dene the overload curve according to ANSI/IEEE standards by select-
ing the relevant checkbox. The equation used is as follows:
I
E
I
N
=
_
T
E
T
0
T
N
T
0
_
I
0
I
N
_
2
e
t
k
1 e
t
k
T
M
+T
N
T
M
+T
E
(38.7)
Where,
I
E
= Max overload temperature
I
N
= Normal current rating
I
0
= Preload current
T
E
= Max overload temperature
T
N
= Max operating temperature
840 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
T
0
= Ambient temperature
T
M
= Zero resistance temperature value, (234 for copper, 228 for aluminium)
k = A constant dependant on cable size and installation type.
Note that the value for TM is derived from the material assigned in the short circuit page which is only
visible when the eld calculate k is set to ANSI/IEEE or IEC/VDE.
If the checkbox is left unchecked the equation used is as follows:
I
E
I
N
=
_
1
_
I
0
I
N
_
2
e
t
k
1 e
t
k
(38.8)
Where the variables are the same as in the previous equation. A constant designated as tau is re-
quested in the dialogue. This is identical to the constant k except k has units of hours, while tau has
units of seconds.
Inrush Curve
The inrush curve represents the amount of current that will ow into the conductor when the conductor
is energised. The curve consists of one point only.
I(T
inrush
) = I
rat
I
inrush
I
nom
(38.9)
Where:
I
rat
rated current of the line or the damage curve input value [A]
I
inrush
I
nom
inrush current to nominal current ratio [-]
T
inrush
inrush duration [s]
Transformer Damage Curve A transformer damage curve dialogue is illustrated in gure 38.4.28, the
user is able to add a damage curve in accordance with ANSI/IEEE C57.109. This standard differentiates
between the damage curve of a transformer which is expected to be subjected to frequent faults and
one that is subjected to infrequent faults. In the former case, mechanical damage at high short circuit
levels can be of signicant concern. For category II and III transformers in particular, accounting for
mechanical damage, signicantly alters the damage characteristic of the transformer. An example
of a time-overcurrent plot with two relay characteristics and a category II transformer damage curve
for a transformer subjected to frequent faults is shown in Figure 38.4.29. The mechanical damage
characteristic is ringed in the gure.
If the user wishes to dene an alternative damage curve this can be achieved by selecting User Dened
curve New project type, in the dialogue.
DIgSILENT PowerFactory 15, User Manual 841
CHAPTER 38. PROTECTION
Figure 38.4.28: Transformer damage curve
Figure 38.4.29: Transformer damage curve
The transformer damage curve consists of four parts.
Rated Current Curve
The rated current curve represents the nominal operation limits of the transformer.
842 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
I(t) = I
rat
=
S
rat
U
ref
(38.10)
Where:
I
rat
rated current of the line or the damage curve input value [A]
S
rat
inrush current to nominal current ratio [kVA]
U
rat
inrush duration [kV]
Thermal and Mechanical Damage Curve
The thermal and mechanical damage curve represents the maximum amount of (short-circuit) current
the transformer can withstand for a given amount of time without taking damage. The transformer is
classied into one of four possible groups, depending on its rated apparent power and the insulation
type (see Table 38.4.2). Dry-type transformers can only be category I or II.
Classication Three-Phase Single-Phase
Category I S
rat
0, 5MV A S
rat
0, 5MV A
Category II S
rat
5, 0MV A S
rat
1, 667MV A
Category III S
rat
30, 0MV A S
rat
10, 0MV A
Category IV S
rat
> 30, 0MV A S
rat
> 10, 0MV A
Table 38.4.2: Categories for Transformers
The thermal damage part of the curve is identical for all categories of the respective insulation type and
is shown in Table 38.4.3. (taken from IEEE Standards Board, IEEE Guide for Liquid-Immersed Trans-
former Through-Fault-Current Duration, New York: The Institute of Electrical and Electronics Engineers,
Inc., 1993. and IEEE Guide for Dry-Type Transformer Through-Fault Current Duration, New York: The
Institute of Electrical and Electronics Engineers, Inc., 2002. )
Liquid-Immersed Dry-Type
I/I
rat
t[s] I/I
rat
t[s]
25 2 25 2
11,3 10 3,5 102
6,3 30
4,75 60
3 300
2 1800
Table 38.4.3: Thermal Withstand Capabilities
ANSI Mechanical Damage Curve
The mechanical part of the ANSI damage curve is only available for transformers of category II and
higher. For transformers of categories II and III this part is optional and depends on expected number
of fault currents owing through the transformer over the transformers lifetime. Typically the mechanical
part should be considered if the transformer is expected to carry fault current more than 10 (category
II) or 5 (category III) times during its lifecycle. For category IV transformers the mechanical part of the
curve is always considered. See IEEE Standards Board, IEEE Recommended Practice for Protection
and Coordination of Industrial and Commercial Power Systems, New York: The Institute of Electrical
and Electronic Engineers, Inc., 1999, Page 426.
DIgSILENT PowerFactory 15, User Manual 843
CHAPTER 38. PROTECTION
The mechanical part of the damage curve is a shifted part of the thermal damage curve. The three
points necessary to draw the mechanical damage curve can be calculated as follows:
I
1
) = I
rat
1
u
k
; t
1
= 2, 0s (38.11)
I
2
) = I
rat
c
f
u
k
; t
2
=
K
I
2
2
=
I
1
2
t
1
I
2
2
=
2, 0s
c
f
2
(38.12)
I
3
= I
2
; t
3
= intersection with thermal curve
Where:
I
rat
rated current of the transformer [A]
u
k
short-circuit voltage of the transformer [%]
k heating constant with
I
I
rat
t = K = const.
c
f
fault current factor [-] c
f
= 0.7 for category II and c
f
= 0.5 for categories III and IV
ANSI Curve Shift
The damage curve is based on a three phase short-circuit on the LV-side of the transformer. In case
of unbalanced faults (Ph-Ph, Ph-E, Ph-Ph-E) the phase current on the HV side may be distributed over
multiple phases, depending on the vector group of the transformer. The standard (IEEE Standards
Board, IEEE Recommended Practice for Protection and Coordination of Industrial and Commercial
Power Systems, New York: The Institute of Electrical and Electronic Engineers, Inc., 1999.) therefore
suggests to multiply the rated current of the transformer by a shifting factor, thus enabling the engineer
to archive proper protection of a transformer for unbalanced faults. While the shift is only applicable
for Dyn vector-groups (according to the cited standard) and single-phase to ground faults, the same
principle of current reduction on the HV side also applies to other vector groups. The resulting shifting
factors and the corresponding fault type can be taken from Table 38.4.4.
Vector Group(s) Shift Factor Fault Type
Dd 0,87 Ph-Ph
Dyn/Dzn 0,58 Ph-E
Yyn/Zyn/Zzn 0,67 Ph-E
Table 38.4.4: ANSI Curve Shift Factors
IEC Mechanical Damage Curve
The mechanical part of the IEC damage curve is only available for the element specic damage curve
and consists of one point only [8]:
I(2, 0s) = I
rat
1
u
k
(38.13)
Where:
I
rat
rated current of the transformer [A]
844 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
u
k
short-circuit to nominal current ratio [%]
Cold Load Curve
The cold load curve represents the maximum amount of current a transformer can withstand for a short-
time (typically several minutes) before taking damage. The curve is specic for each transformer and
the supplied loads and has to be provided by the user as a series of (I/t) pairs.
Inrush Curve
The inrush curve represents the amount of current which ows into the transformer when the transformer
is energised. The curve is represented by a straight line between the following two points:
I(T
[1]
inrush
) = I
rat
I
[1]
inrush
I
nom
(38.14)
I(T
[2]
inrush
) = I
rat
I
[2]
inrush
I
nom
(38.15)
Where:
I
rat
rated current of the transformer [A]
I
inrush
I
nom
inrush current to nominal current ratio [-]
T
inrus
inrush duration [s]
Note: If only one of the two points is given, only this point is drawn.
Three Winding Transformers
The transformer damage curve can be used for 3-winding transformers. On the protection page of the
NetElement, a drop-down box is available which allows the user to select which set of values (HV-MV
(default), HV-LV, MV-LV) should be used to calculate the curve. The equations remain identical, as there
are normally only two windings within a coordination path.
Motor Starting Curve A motor starting curve is illustrated in gure 38.4.30.
DIgSILENT PowerFactory 15, User Manual 845
CHAPTER 38. PROTECTION
Figure 38.4.30: Motor start curve edit dialogue
The characteristic currents and durations given in the edit dialogue result in a step wise motor start
current plot, as depicted in Figure 38.4.31.
Figure 38.4.31: The motor start curve
The motor starting curve consists of three parts.
846 DIgSILENT PowerFactory 15, User Manual
38.4. SETUP AND ANALYSIS OF AN OVERCURRENT
PROTECTION SCHEME
Rated Current Curve
The rated current curve represents the nominal operation limits of the motor and is drawn for T
start
< t.
I(t) = I
rat
=
S
rat
U
rat
(38.16)
Where:
I
rat
rated current time of the motor [A]
S
rat
rated apparent power (electrical) of the motor [kVA]
U
rat
rated voltage of the motor [kV]
T
stat
starting time of the motor [s]
Motor Starting Curve
The motor starting curve represents the maximum amount of current that will ow into the motor while
it accelerates. The curve is drawn for T
inrush
< t T
start
:
I(t) = I
rat
=
I
lr
I
nom
(38.17)
Where:
I
rat
rated current of the motor [A]
I
lr
I
nom
ratio of locked rotor current to nominal current of the motor [-]
T
start
starting time of the motor [s]
T
inrush
inrush duration [s]
Motor Inrush Curve
The motor inrush curve represents the amount of current that will ow into the motor when it is ener-
gised. The curve is drawn from 0,01 s t T
inrush
:
I(t) = I
rat
=
I
inrush
I
nom
(38.18)
Where:
I
rat
rated current of the motor [A]
I
tr
I
nom
ratio of inrush current to nominal current of the motor [-]
T
inrush
inrush duration [s]
Motor Damage Curve
The motor damage curve represents the maximum amount of current the motor can withstand for a
given time without taking damage. There are two curves available, one representing the damage char-
acteristic of the cold motor, one representing the damage characteristic of the hot motor. The hot curve
DIgSILENT PowerFactory 15, User Manual 847
CHAPTER 38. PROTECTION
must be lower than the cold curve. The curve would actually follow an inverse current-time characteris-
tic but is reduced to a vertical line to indicate the damage region without cluttering the plot. The motor
damage curve is drawn from T
hot
t T
cold
:
I(t) = I
rat
I
lr
(38.19)
Where:
I
rat
rated current of the motor [A]
I
lr
ratio of locked rotor current to rated current of the motor [-]
T
hot
stall time for the hot motor [s]
T
cold
stall time for the cold motor [s]
Motor Starting Curve
The motor starting curve can be created for elements set to Motor.
Synchronous Motors
The motor starting curve can be created for synchronous motors. Since synchronous motors are started
in asynchronous operation, the curve is identical to the asynchronous motor starting curve. The param-
eter mapping for the synchronous machine is as follows:
Motor Starting
Curve
Asynchronous
Motor
Synchronous
Motor
Parameter Parameter Parameter
Rated Power Srat t:sgn t:sgn
Rated Voltage Urat t:ugn t:ugn
Locked Rotor
Current (Ilr/In)
aiazn t:aiazn 1 / (t:xdsss)
Table 38.4.5: Synchronous Motor Parameter Mapping
Note: By default the subtransient reactance (t:xdss) is used. If the ag Use saturated values in the
machine type is set, the saturated subtransient reactance (t:xdsss) is used.
38.5 Setup and analysis of a distance protection scheme
In Section 38.3.1: Adding protective devices to the network model, the initial steps that should be
taken in order to setup a protection scheme were explained. When a new device is created within a
network model there are a number of parameters to dene in the dialogue which appears. This section
will describe the basic steps that should be completed in order to specify these parameters for distance
protection relays. The section will also describe how to perform graphical analysis of distance protection
schemes using time-distance plots and impedance plots.
38.5.1 Distance relay model setup - basic data tab
The basic data page in the relay model (ElmRelay) dialogue is used to select the precise relay type and
the settings to apply to the relay. It can also be used to select the instrument transformer(s) through
848 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
which it will interface with the power system. See Fig 38.5.1 for an example of the basic data page
dialogue.
Before the relay can be congured the relay type must be selected. This is achieved by pressing the
button at the Relay Type eld and selecting a device from the appropriate library. The settings to be
applied to the relay and the instrument transformers are dened within the slot denition list. Without a
specied type the Slot Denition list is empty and the relay is not functional. After a relay type has been
selected, the Slot Denition list will be lled automatically with the correct slot elements corresponding
with the functionality of the selected relay.
Editing the settings of the relay model is done by editing the settings of the listed slot elements. Double-
clicking a slot element in the Slot Denition list will open the dialogue of that element.
Instrument transformers can be assigned to relays in numerous ways. If the cubicle in which the relay
has been installed does not contain any instrument transformers then create VT and create CT buttons
will appear at the bottom of the dialogue once the relay type has been selected. By clicking on these
buttons it is possible to create and select an appropriate device which will be assigned to the same
cubicle as the relay by default. Alternatively, if instrument transformers already exist in the cubicle
then these will be assigned to the relevant relay slot element automatically. If the default instrument
transformer selected in the slot element needs to be changed, this can be achieved by double clicking
on the slot element.
The Application and Device Number elds are for documentation purposes only. The Location eld
is automatically read from the cubicle the relay is stored in. By default PowerFactory will assign the
relay with control of a switch element which is installed in the same location as the relay. In some
circumstances the switch which should be controlled is not in the same location as the relay. If this
is the case the relay can be assigned with a reference location corresponding with the location of the
switch which should be controlled.
DIgSILENT PowerFactory 15, User Manual 849
CHAPTER 38. PROTECTION
Figure 38.5.1: Distance relay model dialogue with selected type
38.5.2 Distance relay model setup - max./min. fault currents tab
This tab can be used to enter the minimum and/or maximum fault currents occurring at the location
of the relay. These values are used to scale the Time-Overcurrent plot according to the given fault
currents. They can be entered either manually or calculated with the Short-Circuit-Command.
Note: The currents entered on this page will not affect the relay model. They are for plotting purposes
only.
38.5.3 Instrument Transformers for distance protection
In PowerFactory the application of instrument transformers for distance protection is identical to the
application of these devices for overcurrent protection. Please refer to the descriptions in section 38.4.3:
The Current Transformer and section 38.4.4: The Voltage Transformer.
38.5.4 Basic relay blocks used for distance protection
As discussed in section 38.2 (General approach to protection modelling in Power Factory) all relay mod-
els contain slots which are placeholders for block denitions. There are many types of block denition
and each type has a different function. By interconnecting different slots containing block denitions
in different ways, and offering the user the ability to ne tune the block denition by entering their own
850 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
parameters, it is possible to produce relay models with a large variety of operating characteristics. It is
even possible for the user to dene their own types of protection device. The creation of user dened
protection devices is covered in the section 38.8 (Building a Basic Overcurrent Relay Model).
The blocks contained within a relay are listed in the slot denition section of the relay model dialogue.
In general the user will need to dene parameters within these relay blocks. The settings dialogue can
be reached by double clicking on the block of interest in the net elements column.
If the user is interested in viewing a graphical representation of the interconnection of slots for a partic-
ular relay then the user should nd the following icon , associated with the relay in the data manager.
By right clicking on this icon and selecting show graphic, a graphical representation of the relay frame
will appear in a new window.
In this section, the relay blocks that can be found in most standard distance relay models are described.
38.5.4.1 The measurement block
The measurement block uses the raw signals produced by the current or voltage transformers to cal-
culate measured signals.
The measurement block allows for setting the nominal current and voltage. Both are limited by the
measurement unit type. If a relay does not need a nominal voltage (i.e. in the case of an overcurrent
relay) or if there is only one nominal value to choose from, the nominal voltage and/or current eld will
normally be disabled.
Figure 38.5.2: Measurement block
38.5.4.2 The polarizing block
The polarizing block is similar to the directional block described in section 38.4.7: Basic relay blocks for
overcurrent relays. It is used to calculate the angle between a polarization voltage or current phasor
and an operating current phasor. The relative angular position of the polarization current or voltage
phasor can be selected. A tripping condition is considered to be present if the angle between the
operating and polarization phasor is less than 90 and if the magnitude of the phasors are above a
setting threshold. This principle is shown in Figure 38.5.3.
DIgSILENT PowerFactory 15, User Manual 851
CHAPTER 38. PROTECTION
Figure 38.5.3: Polarizing relay principle diagram
The polarization quantity A
pol
is rotated over the angle M
T
, known as the Max. Torque Angle which is
set in the relay edit dialogue. The rotated polarization quantity Apol denes a half plane which forms the
rst tripping condition. The second tripping condition whereby the magnitude of the operating quantity
must be in excess of a setting threshold is illustrated by the dashed semicircle.
Polarizing blocks allow for settings of earth fault and mutual earth fault compensation parameters to
be applied if these features are available in the relay model. This is the main difference between a
polarizing block and a directional block.
More details about the polarization methods and the tripping conditions can be found in the Appendix C:
Technical References. An example of a polarizing block dialogue can be seen in Figure 38.5.4.
Typically polarizing blocks are combined with distance blocks whilst directional blocks are usually com-
bined with overcurrent blocks.
852 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
Figure 38.5.4: Polarizing block
38.5.4.3 The starting block
The starting block is used exclusively in distance relays, as a means to detect fault conditions. It sends
the starting signal to all timer blocks in the relay, if the fault conditions are met. The selectable fault
conditions range from simple overcurrent detection to complex impedance polygons. For an example
of a simple overcurrent starting block, see Figure 38.5.5. For detailed information please refer to the
Appendix C: Technical References of Models.
DIgSILENT PowerFactory 15, User Manual 853
CHAPTER 38. PROTECTION
Figure 38.5.5: Starting block
38.5.4.4 The distance polygon block, distance mho block and the distance blinder block
These blocks are used to model limits of each of the different zones of distance protection relays. The
shape of the zone modelled by the block depends on the block class. Available polygons range fromMho
circles, for modelling of older electro-mechanical distance relays, to polygons with load encroachment
as are used by modern digital protection devices. Polygon blocks have the class name RelDispoly, Mho
blocks have the class name RelDismho and Blinder blocks have the class name RelDisbl. Depending
on the kind of polygon, the block allows for the setting of reactive and resistive reach, high resistance
ground fault reach and different angles for different edges of the polygon. Figure 38.5.6 shows an
example using a rectangular polygon. The Blocks can also be congured to be directional.
The reach setting of the distance polygon and distance mho blocks can be set in terms of primary
Ohms or secondary Ohms. Note that the unit of one of the two quantities is underlined according to the
conguration of the relay. On the advanced options page of the corresponding relay type (TypRelay)
there is an option to select Denition of impedance ranges to either Secondary Ohms or Primary Ohms.
If selected to Secondary Ohms, the CT ratios used to convert between Primary and Secondary ohms will
be automatically selected as described on the Current/Voltage transformer page of the Relay Element
(ElmRelay). If selected to Primary Ohms, the user can specify an alternative VT and CT ratio on the
Current/Voltage transformer page of the Relay Element (ElmRelay)
Note: In order to function properly, there has to be a directional block present in the relay and con-
nected to the polygon block. This is indicated by the active button Directional Unit, next to the
drop down menu. Otherwise the block will never trip, since it cant receive directional information.
854 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
The Impedance section at the bottom of the dialogue shows the reach of the zone in absolute values,
as well as relative to the element directly connected to the cubicle where the relay is dened. The R
and X values of this element are also shown as a reference for the setup of the zone.
Since the distance polygon block does not have a time dial itself, it needs an extra timer block that
controls the tripping time of a zone. The timer block connected to the zone can be selected with the
Timer button.
Note: If the Timer button of a zone is greyed out, this means there is no timer block directly connected
to the zone. This can be the case, if the zone is designed for instantaneous tripping.
Figure 38.5.6: Distance polygon block
38.5.4.5 The timer block
In distance relay models the timer block is used to either control the tripping time of distance polygon
blocks or to realize other time delays in the relay, that cant be realized inside a block. For an example,
see Figure 38.5.7. If the timer block is used to control a distance polygon, the delay is started with a
signal from the starting block.
DIgSILENT PowerFactory 15, User Manual 855
CHAPTER 38. PROTECTION
Figure 38.5.7: Timer block
38.5.4.6 The logic block
For distance relays as for overcurrent relays, the logic block is the front end part of a relay conguration.
It combines all internal trigger signals by successive AND and OR operations and produces one single
output. The block type species the logical operation, the logic block itself species the switches which
will be opened when the relay trips. If the relay is located in a cubicle and no switch has been specied,
the breaker in the cubicle will be opened by default. See Figure 38.5.8 for an example of the logic block
settings dialogue.
Figure 38.5.8: Logic block
38.5.5 The time-distance plot
The time-distance plot VisPlottz shows the tripping times of the relays as a function of the short-circuit
location. It is directly connected to a path denition so it can only be created if a path is already dened.
A path in a single line diagram is dened by selecting a chain of two or more busbars or terminals and
inter-connecting objects. The pop-up menu which opens when the selection is right-clicked will show a
Path . . . option. This menu option has the following sub-options:
New this option will create a new path denition
Edit this option is enabled when an existing path is right-clicked. It opens a dialogue to alter the colour
and direction of the path
Add To this option will add the selected objects to a path denition. The end or start of the selected
path must include the end or start of an existing path.
856 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
Remove Partly This will remove the selected objects from a path denition, as long as the remaining
path is not broken in pieces
Remove This will remove the rstly found path denition of which at least one of the selected objects
is a member
There are a number of ways to create a time-distance diagram but it is should be noted that in each case
a path must rst be dened and furthermore, highlighted in the single line diagram. The elements which
belong to a particular path can be highlighted by setting the colour representation of the single-line
diagram to Protection tab Other GroupingsPaths. To create the diagram either:
Right-click an element which is already added to a path denition. From the context sensitive
menu the option Show Time-Distance Diagram can be selected. PowerFactory will then create
a new object VisPlottz showing the time-distance plot for all distance relays in the path.
Right-click a path element and select Path. . . Time-Distance Diagram from the context sensi-
tive menu. As above, this will create a new object VisPlottz.
Path object SetPath can be chosen in the data manager under Database \Projectname \Paths.
Select the Paths folder and right-click the path object on the right side of the data manager. Then
select Show Time-Distance Diagram from the context sensitive menu.
38.5.5.1 Forward and reverse plots
Figure 38.5.9: A forward time-distance plot
Figure 38.5.9 illustrates a forward direction time-distance plot. The diagram shows all relay tripping
times in the forward direction of the path. It is also possible to display diagrams which show in the
reverse direction. There are three different options for displaying the diagrams. These are:
DIgSILENT PowerFactory 15, User Manual 857
CHAPTER 38. PROTECTION
Forward/Reverse Both diagrams are shown.
Forward Only forward direction diagram
Reverse Only reverse direction diagram
38.5.5.2 The path axis
Figure 38.5.10: A path axis
The path axis in Figure 38.5.10 shows the complete path with busbar and relay locations. Bus-
bars/Terminals are marked with a tick and the name. The coloured boxes represent relays and the
left or right alignment represents their direction.
38.5.5.3 Methods of calculating tripping times
There are several methods to calculate the tripping times shown in the plot. To change the method,
select the Method option in the context sensitive menu or double-click the plot to access the time-
distance plot dialogue and edit the Methods option on the Relays page.
The methods differ in exactness and speed. The set of possible units for the x-Axis depends on the
method used. The methods are:
Short-circuit sweep method The short-circuit sweep method is the most accurate method for charting
the variation in relay tripping time with fault position. A routine is followed whereby short circuits
are assumed to occur at numerous positions between the rst and the last busbar in the path. At
each short-circuit location the relay tripping times are established. The user can control the dis-
tance between simulations to ensure adequate resolution. Furthermore there is a control strategy
employed within the routine to ensure that step changes in operation time are not missed. The
disadvantage of this method is its low speed. Whenever the rebuild button of the graphics window
is pressed the sweep is recalculated. The possible units for the short-circuit location are position
in km, reactance in primary ohms or reactance in relay ohms.
Kilometrical method This method is the fastest but can in certain circumstances be less accurate than
the short-circuit sweep method. Tripping time is determined at each position where the impedance
characteristic of the path intersects the relay characteristics. The impedances used for calculation
are the impedances of the device. If there is more than one intersection at the same impedance
the smallest tripping time is used. Although extremely useful for fast calculations in simple network
scenarios, care must be taken to ensure that the results achieved are accurate. For instance, this
method will not account for the starting characteristic of a distance relay and a plot may therefore
be produced that does not reect the true time current plot. The possible units for the short-circuit
location are position in km or reactance, resistance and impedance, each in primary or relay ohm.
858 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
Figure 38.5.11: The Time-Distance plot edit dialogue
The kilometrical method is applicable only for the following paths:
Where there are no parallel branches in the path.
Where the path is fed from only one side or there is no junction on the path.
38.5.5.4 Short-circuit calculation settings
If the method for the calculation of the time-distance plot is set to Short-Circuit Sweep, the short-circuit
sweep command object ComShcsweep is used. The command can be accessed by the option Shc-
Calc... in the context menu of the plot or by the Shc-Calc... button in the Time Distance Plot edit
dialogue.
Some of the settings in the command are predened by the time-distance plot. These settings are
greyed out when the sweep command is accessed through the plot. The short-circuit command for the
calculation is set in the sweep command. To change the short-circuit method, i.e. from IEC60909 to
Complete, open the sweep command and edit the short-circuit dialogue.
Note: The easiest way to recalculate the short-circuit sweep for the time-distance plot is by simply
pressing the button . This is only needed when using the Short-Circuit Sweep method.
38.5.5.5 The distance axis units
There are number of possible distance axis units available depending on the method used. See
the methods description for details. The short-circuit sweep method needs a relay to measure the
DIgSILENT PowerFactory 15, User Manual 859
CHAPTER 38. PROTECTION
impedance which is named the reference relay. If there is no reference relay selected, the distance is
measured from the beginning of the path.
The options available for the distance axis units are:
Length Distance axis is shown in km depending on the line/cable length from the reference relay.
Impedance (pri.Ohm) Distance axis shows the primary system impedance from the reference relay to
the remote end of the path.
Reactance (pri.Ohm) Distance axis shows the primary system reactance from the reference relay to
the remote end of the path.
Impedance (sec.Ohm) Distance axis shows the secondary impedance from the reference relay to the
remote end of the path.
Reactance (sec.Ohm) Here the secondary reactance from the reference relay is measured on the
secondary side.
38.5.5.6 The reference relay
The distance axis positions or impedances are calculated relative to the beginning of the path. If a
reference relay is set the positions/impedances are relative to the reference relay. The sweep method
always needs a reference relay. If no reference relay is set, the rst relay in the diagrams direction is
taken to be the reference relay.
The busbar connected to the reference relay is marked with an arrow.
The reference relay is set using either the graphic or by editing the Time Distance Diagram dialogue.
Changing the reference relay graphically is done by clicking with the right mouse button on the relay
symbol and selecting Set reference relay in the context menu. If there is more than one relay connected
to the selected busbar, PowerFactory offer a list of relays which can be used. In the dialogue of the
Time Distance Relay the Reference Relay frame is located at the bottom.
38.5.5.7 Capture relays
The Capture Relays button enables the user to easily add relays in the selected path to the time-
distance diagram. In order to delete a relay from the diagram, the respective line in the relay list has to
be deleted.
38.5.5.8 Double-click positions
The following positions can be double-clicked for a default action:
Axis Edit scale
Curve Edit step of relay
Relay box Edit relay(s)
Path axis Edit Line
Any other Open the Time Distance edit dialogue
860 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
38.5.5.9 The context sensitive menu
If the diagram is right-clicked at any position, the context sensitive menu will pop up similar to the
menu described in Chapter 17: Reporting and Visualizing Results, Section 17.5.2 (Plots) for the virtual
instruments.
There are some additional functions available in addition to the basic VI-methods for the time-distance
plot.
Grid Shows the dialogue to modify the grid-lines.
Edit Path Opens the dialogue of the displayed path denition (SetPath).
Method Sets the method used for calculation of tripping times.
x-Unit Sets the unit for the distance axis, km impedances,...
Diagrams Select whether diagrams show forward, reverse or both.
Consider Breaker Opening Time
Report This option prints out a report for the position of the relays, their tripping time as well as all
calculated impedances in the output window.
Shc-Calc... Show Short-Circuit Sweep command dialogue.
38.5.6 The impedance plot
The impedance or R-X plot VisDraw shows the impedance characteristics of different distance protec-
tion relays in one or more R-X plots. Additionally the impedance of connected lines and transformers
in the network near to the protection equipment can easily be shown. Thus the impedances of the dif-
ferent zones of the relay and the tripping time can easily be adjusted and checked to ensure adequate
protection of the equipment.
There are several ways to create a relay plot (VisDraw):
Select one cubicle where a distance relay is installed. Right-click the switch to open the context-
sensitive menu. This will show the options Create R-X Plot and Add to R-X Plot. PowerFactory
will then create a new diagram showing the R-X plot for all relays in the selected cubicle.
Right-click an element which belongs to a dened protection path and select Path. . . R-X Plot
from the context-sensitive menu.
A distance relay element ElmRelay can be chosen from the list of calculation-relevant objects or
in the data manager. Right-click the relay on the right side of the data manager or in the list of
relays. Then select Show R-X Plot to create a new plot or Show Add to R-X Plot to add the
characteristic to an existing plot.
The R-X plots show
the impedance characteristics of selected distance relays including the different zones.
impedance curve of the lines and transformers near the relay location.
the location of other distance relay nearby.
the short-circuit impedance depending on the location and the fault impedance.
the tripping time of the relay.
DIgSILENT PowerFactory 15, User Manual 861
CHAPTER 38. PROTECTION
Figure 38.5.12: A R-X plot with short-circuit results and two relays
In Figure 38.5.12 an example is shown for the R-X plot, where two relay characteristics and the trans-
mission line impedances are displayed.
The location of the short-circuit or load-ow calculation as an equivalent impedance point in the plot
is also shown. For every relay displayed in the graph, a legend is also shown, containing the relevant
information regarding the short-circuit calculation of each relay. This includes:
name of the relay,
measured impedances seen from the relay location,
the fault type,
the actual tripping time of the relay,
which zone is tripped.
The information shown may be changed in the relay plot settings. For details please refer to Chapter 17:
Reporting and Visualizing Results, Section 17.5.2 (Plots).
38.5.6.1 Modifying the relay settings
862 DIgSILENT PowerFactory 15, User Manual
38.5. SETUP AND ANALYSIS OF A DISTANCE PROTECTION SCHEME
From the R-X plot the characteristics of the relays shown can easily be changed according to the
impedances of the electrical equipment which is to be protected.
By double-clicking the characteristic of a relay zone the settings dialogue of the zone will be opened and
can be modied. Here the relay specic information of the impedance characteristic can be entered.
The information for the line branch connected to the relay in the forward direction is also shown in the
dialogue. If the OK button is selected the characteristic of the relay will be updated.
It is also possible to edit the lines or transformer elements shown in the plot. Holding the mouse pointer
over the element for a second will show the name of the element in a balloon help box. If one of the
lines is double-clicked, the edit dialogue of the element pops up like in the single-line graphics. In this
way the line impedances can easily be accessed.
38.5.6.2 Relay plot settings
The R-X plot settings can be accessed by selecting Options from the context-sensitive menu or by
pressing the Options button in the edit dialogue of the plot.
38.5.6.3 Basic options
The dialogue shows the following options:
Unit The impedance unit may be set to either primary or secondary (relay) Ohm.
Relays Units This option is used to display only certain types of relay characteristics.
Zones Here the zone can be selected which is to be shown. Also All zones of the relays can be
displayed in one graph (default).
Display This option is used to select how the calculated load-ow or short-circuit current/equivalent
impedance will be displayed. Either as a short-circuit arrow, a cross or none may be selected.
Colour out of service units Out of service zones can be shown in a different colour.
DIgSILENT PowerFactory 15, User Manual 863
CHAPTER 38. PROTECTION
Figure 38.5.13: R-X-Plot Settings
Additionally, the show/hide option for the starting, overreach zones, power swing units and the complete
shape of the diagrams can be selected in the dialogue.
38.5.6.4 Branch impedances
There are special options to modify the appearance of the branch impedances:
Number of Relay Locations Only the branches are shown up to the specied number of relay loca-
tions. If zero, no branches are shown at all.
Branches, max. Depth Maximum number of branches shown from each relay location. If zero, no
branches are shown at all.
Ignore Transformers Transformer impedances are ignored when activated.
Method Method for determining the line impedances. There are two methods for determining the
branch impedance. The rst, the Input Data Method simply uses the impedance data that the
user selects when dening the branch. The second method, the Calculated Impedance Method
effectively carries out a short circuit sweep similar to that described in the section (Methods of
calculating tripping times) except, that impedances are calculated rather than tripping times. One
scenario where this method is more accurate is when protection of a section of network with
multiple infeeds is to be modelled. Greater accuracy is achieved at the expense of calculation
time.
Show Branch Options Here the line style and width can be selected.
864 DIgSILENT PowerFactory 15, User Manual
38.6. ACCESSING RESULTS
38.5.6.5 Legend
In the legend belonging to each relay different information and calculation results are displayed. Here
the user can choose, which results are to be shown.
38.6 Accessing results
After all protection devices have been congured and graded, it is often desirable to create reports for
future reference. Aside from exporting the time-overcurrent, R-X or time-distance plots as graphical
les (see Chapter 17: Reporting and Visualizing Results, Section 17.5.9: Tools for Virtual Instruments),
there are several other methods to report the relay settings.
38.6.1 Tabular protection setting report
A report command specically for protection can be accessed by either clicking on the Output of Pro-
tection Settings icon on the Protection toolbar or alternatively via the Output entry in the main menu.
The Output of protection settings command dialogue (ComProtreport) has three pages:
Basic Options
Common Options
Specic Options
Basic Options
The Basic Options page is illustrated in Figure 38.6.1:
DIgSILENT PowerFactory 15, User Manual 865
CHAPTER 38. PROTECTION
Figure 38.6.1: Basic options page of ComProtreport dialogue
In this page the user chooses which equipment to generate reports for. First the user chooses general
classes of equipment from the options below:
Instrument Transformers
Overcurrent Protection
Distance Protection
Voltage Protection
Frequency Protection
any combination of the above options may be selected. Each option which is selected will result in the
generation of a separate tabular report. I.e. if all ve options are selected, ve tabular reports will be
generated.
In the lower section of the page the user can choose to consider all protection devices in the active grid
or only a specic user dened subset. The following objects may be selected as a user dened subset:
SetSelect, SetFilt, ElmNet, ElmArea, ElmZone, ElmFeeder, ElmSubstat and ElmTrfstat. Additionally a
single protection device (ElmRelay, RelFuse) can also be selected.
Common Options
866 DIgSILENT PowerFactory 15, User Manual
38.6. ACCESSING RESULTS
The Common Options page is illustrated in Figure 38.6.2:
Figure 38.6.2: Common options page of the ComProtreport dialogue
The decimal precision section can be used to dene the number of decimal places to which results are
given in the tabular reports. The precision for each unit can be dened individually.
The layout options section is used to congure the layout for each report. Depending on whether they
are selected, Device, Location and Branch will be the rst three columns of the report.
If the show instrument transformers option is selected, additional columns will be added to the overcur-
rent, distance, voltage and frequency protection reports showing details of the instrument transformers.
If the Report settable blocks only option is selected, blocks which have no user congurable settings
will not be displayed in the report.
If the Arrange stages vertically option is selected, additional rows will be added to the report for each
protection stage, rather than including additional stages as additional columns.
If the Show ANSI code option is selected, each stage column will include the relevant ANSI code as
dened by IEEE (ANSI) C37-2.
Specic Options
The Specic Options page is illustrated in Figure 38.6.3:
DIgSILENT PowerFactory 15, User Manual 867
CHAPTER 38. PROTECTION
Figure 38.6.3: Specic options page of the ComProtreport dialogue
The Over-/Undercurrent and Over-/Undervoltage sections of this page can be used to dene whether
settings should be displayed in primary units, secondary units, or per unit. Any combination of the 3
options is possible.
This page is also used to limit the report for each type of protection to a specied number of phase and
earth fault protection stages.
One the ComProtreport dialogue has been congured it can be executed.
The Tabular Report
An example of a tabular report generated when the ComProtreport dialogue is executed is illustrated in
Figure 38.6.4:
868 DIgSILENT PowerFactory 15, User Manual
38.6. ACCESSING RESULTS
Figure 38.6.4: ComProtreport Tabular report
Relay models (and sometimes stages depending on the setting detailed above) are listed vertically while
settings are listed horizontally.
The downward pointing triangular icon at the top of the page can be used to export the report either as
HTML format or in excel spreadsheet format.
It is also possible to interact with the data within the report. For instance, if you double click on a
particular stage (or right click and select edit it is possible to edit the settings dialogue for that stage.
Data within this table may also be copied and pasted if required, with or without column headers.
38.6.2 Results in Single Line Graphic
The names of the relays or the tripping times may be made visible in the single line graphic by selecting
the following options in the main menu.
Output - Results for Edge Elements - Relays
Output - Results for Edge Elements - Relay Tripping Times
The rst option (Relays), which is always available, will show the names of the relays in all cubicles.
The second option will show the tripping times of the relays after a load-ow or short-circuit calculation
has been carried out. If a relay does not trip, then a tripping time of 9999.99 s is shown.
It is also possible to colour the single line graphic depending on the tripping time of the protective
devices installed. This feature can be activated by clicking the diagram colouring button from the local
graphics window icon bar, then selecting: the protection tab 3. Others Results Fault clearing
time.
DIgSILENT PowerFactory 15, User Manual 869
CHAPTER 38. PROTECTION
38.7 Short Circuit Trace
The Short circuit trace is a tool based on the complete short circuit calculation method that allows the
user to examine the performance of a protection scheme in response to a fault or combination of faults;
where the response is examined in time steps and where at each time step, the switching outcomes of
the previous time step and the subsequent effect on the ow of fault current, is taken into consideration.
Consider a network as illustrated in Figure 38.7.1:
Figure 38.7.1: Short circuit trace example
Suppose that for a particular fault at bus 4, the relay controlling circuit breaker 1 trips signicantly faster
than the relays controlling circuit breakers 2 and 3. Once circuit breaker 1 trips, the fault is not cleared
but the fault current is reduced, since the contribution from the external grid is removed. To clear the
fault completely, circuit breaker 2 or circuit breaker 3 must trip. Due to the dynamic variation in the fault
current, the tripping times of the two circuit breakers are not immediately obvious. Ideally a dynamic
870 DIgSILENT PowerFactory 15, User Manual
38.7. SHORT CIRCUIT TRACE
simulation method should be used to accurately calculate the respective tripping times of the two circuit
breakers. However, a dynamic simulation is not always practicable and where the user is willing to
accept a reduced level of accuracy in exchange for a faster, simpler calculation result, then the Short
circuit trace should be considered.
Consider again the network illustrated in Figure 38.7.1 with a fault occurring at bus 4, all relays are
overcurrent relays with the relay controlling circuit breaker 1 having a signicantly faster tripping time
than the other 2 relays. The Short Circuit Trace calculation proceeds as follows.
Time Step 1 (t = 0): The fault occurs at bus 4. Fault current ows from both synchronous gen-
erators according to the complete short circuit method of calculation. The relay controlling circuit
breaker 3 sees the fault current from both sources. The relays controlling circuit breakers 1 and
2 see only the fault current from the sources present in their particular branch of the network.
The tripping time of each of the relays can be evaluated based on the respective magnitudes
of the current components seen by the relays and with reference to each of the relays tripping
characteristics.
Time Step 2 (t = 0+t1): According to the tripping times calculated at Time Step 1 it is established
that the relay controlling circuit breaker 1 will trip rst in time t1. Therefore at stage 2 circuit breaker
1 is opened and a the complete short circuit method calculation is once again carried out for a
fault at bus 4. This time, the current seen by circuit breaker 3 only includes contribution from the
generator and not from the external grid. The tripping times of the relays are reevaluated based
on the new current distribution. The effects of the Time Step 1 current distributions are ignored.
For the purposes of this example it is assumed that circuit breaker 2 is established to be the next
quickest to operate.
Time Step 3 (t = 0 + t2): According to the tripping times calculated at Time Step 2 it is estab-
lished that the relay controlling breaker 2 is the next to trip and trips in time t2. Since the fault is
now isolated from all connected sources, fault current no longer ows and the short circuit trace
calculation is complete.
Fromthe above, a sequence of operation for the protection scheme is established and specic protection
operating times are calculated, taking account of the variation in network topology that occurs during
the ongoing response of a protection scheme to a fault situation.
The following subsection describes the handling of the Short Circuit Trace function.
38.7.1 Short Circuit Trace Handling
A command specically for the Short Circuit Trace feature can be accessed by clicking on the Start
Short-Circuit Trace icon on the Protection toolbar.
The Short-Circuit Trace command dialogue (ComShctrace) has one only one page called Basic Options
Basic Options
The Basic Options page is illustrated in Figure 38.7.2:
DIgSILENT PowerFactory 15, User Manual 871
CHAPTER 38. PROTECTION
Figure 38.7.2: Basic options page of the ComShctrace dialogue
A link to the short circuit command (ComShc) to be used for the calculation is automatically generated.
This command is described in detail in the Chapter 22. Please note that for the Short Circuit Trace
function, some options are xed. For instance, only the complete short circuit method may be selected.
The Short-Circuits part of the page is used to dene the short circuit events to be applied at the begin-
ning of the calculation. The following kinds of events may be specied.
Intercircuit Fault Events (EvtShcll)
Outage Events (EvtOutage)
Short-Circuit Events (EvtShc)
Switch Events (EvtSwitch)
Once the simulation is ready to begin press the execute button. At this point the simulation is initialised
and the short circuit events specied in the Basic Options page are applied to the network. The user
can advance through the simulation time step by time step or to the end of the simulation by clicking on
the relevant icons on the Protection toolbar. Further there is an additional icon to stop the simulation at
any time. The icons are illustrated in Figure 38.7.3.
Figure 38.7.3: Short Circuit trace icons
38.8 Building a basic overcurrent relay model
Some advanced users may need to build their own relay models. This section will outline the procedure
for building a basic overcurrent relay model.
1. Create a new block denition for the relay frame
Select le NewBlock Diagram / Frame...
A dialogue as illustrated in gure 38.8.1 will appear.
872 DIgSILENT PowerFactory 15, User Manual
38.8. BUILDING A BASIC OVERCURRENT RELAY MODEL
Figure 38.8.1: BlkDef basic data dialogue
Give the relay frame an appropriate name.
Select Level to Level 2: Level 1 + sort parameter user dened.
Select classication to linear.
Click ok. This creates a block denition object within the User Dened Models section of
the project library.
2. Construct the relay frame.
Select the slot icon from the drawing toolbox located on the right side of the screen and place
6 slots within the block denitions arranged as illustrated in gure 38.8.2 below.
DIgSILENT PowerFactory 15, User Manual 873
CHAPTER 38. PROTECTION
Figure 38.8.2: Arrangement of slots
3. Congure the BlkSlot dialogue for slot A.
Slot A will be congured to be a CT slot. Double click on the slot symbol and the BlkSlot
dialogue will appear.
Enter an appropriate name for the slot eg. CT 3ph.
Enter the class name as StaCt*.
Ensure that only the box linear is checked in the classication eld.
Enter the following output signals under the variables eld: I2r A; I2i A, I2r B; I2i B, I2r C;
I2i C. These signals will represent real and imaginary secondary currents for phases A, B
and C.
The way in which the signal list above is dened inuences the way the signals are repre-
sented in the relay frame. Signals can be grouped together and represented by a common
terminal by separating the signals to be grouped with a semicolon. Where a group of signals
or a single signal is to be given its own terminal representation in the relay frame then the
signal or group of signals should be distinguishing from any other signals by separation with
a comma.
The congured dialogue is illustrated in gure 38.8.3.
Once congured, click ok. The CT slot should now be marked with three terminals, one for
each phase.
874 DIgSILENT PowerFactory 15, User Manual
38.8. BUILDING A BASIC OVERCURRENT RELAY MODEL
Figure 38.8.3: CT BlkSlot dialogue
4. Congure the BlkSlot dialogue for slot B.
Slot B will be congured to be a Measurement slot. Double click on the slot symbol and the
BlkSlot dialogue will appear.
Enter an appropriate name for the slot eg. Measurement.
Enter the class name as RelMeasure*.
In the classication eld, ensure that only the boxes linear and Automatic, model will be
created are checked
Enter the following output signals under the variables eld: I A, I B, I C. These represent
RMS values of current for each phase.
Enter the following input signals under the variables eld: wIr A; wIi A, wIr B; wIi B, wIr C;
wIi C. These are real and imaginary current signals supplied by the CT block.
The congured dialogue is illustrated in gure 38.8.4.
Once congured click ok.
DIgSILENT PowerFactory 15, User Manual 875
CHAPTER 38. PROTECTION
Figure 38.8.4: Measurement BlkSlot dialogue
5. Congure the BlkSlot dialogues for slots C, D and E.
Slots C,D and E will be congured to be time overcurrent blocks with each one representing
a different phase. Double click on the slot C symbol and the BlkSlot dialogue will appear.
Enter an appropriate name for the slot eg. TOC phase A.
Enter the class name as RelToc*.
In the classication eld, ensure that only the boxes linear and Automatic, model will be
created are checked
Enter the following output signals under the variables eld: yout.
Enter the following input signals under the variables eld: Iabs. This represents the RMS
current signal for phase A supplied by the measurement block.
The congured dialogue is illustrated in gure 38.8.5.
Once congured click ok.
Repeat the steps above for slot D and E. Name these slots TOC phase B and TOC phase C.
876 DIgSILENT PowerFactory 15, User Manual
38.8. BUILDING A BASIC OVERCURRENT RELAY MODEL
Figure 38.8.5: TOC BlkSlot dialogue
6. Congure the BlkSlot dialogue for slot F.
Slot F will be congured to be a Logic slot. Double click on the slot symbol and the BlkSlot
dialogue will appear.
Enter an appropriate name for the slot eg. Logic.
Enter the class name as RelLogic*.
In the classication eld, ensure that only the boxes linear and Automatic, model will be
created are checked
Enter the following output signals under the variables eld: yout.
Enter the following input signals under the variables eld: y1, y2, y3.
The congured dialogue is illustrated in gure 38.8.6.
Once congured click ok.
DIgSILENT PowerFactory 15, User Manual 877
CHAPTER 38. PROTECTION
Figure 38.8.6: Logic BlkSlot dialogue
All block dialogues should now be congured.
7. Connect the blocks together using signals.
Select the signal icon from the drawing toolbox located on the right side of the screen.
Connect blocks by clicking on the output terminal of the rst block then by clicking on the
input terminal of the receiving block. If a route for the signal is required which is not direct,
intermediate clicks may be used.
If a signal is intended to be passed outside of the model then a signal should be terminated
on the box which surrounds the frame. In this instance the output from the logic block will be
passed outside of the model.
Connect the blocks in the frame as illustrated in gure 38.8.7.
878 DIgSILENT PowerFactory 15, User Manual
38.8. BUILDING A BASIC OVERCURRENT RELAY MODEL
Figure 38.8.7: Signal route denition
8. Rebuild the block denition
Press the rebuild button on the local graphics window icon bar. Rebuilding the model will
capture all the internal signals (signals dened between slots) and external signals (signals
passed outside of the model) within the BlkDef model dialogue. This concludes denition of
the relay frame. The next step is to dene a relay type.
9. Create a relay type object
Within the data manager go to the Equipment Type library folder in the project library and
select the new object icon.
In the dialogue which appears select Special Type Relay Type (TypRelay) as illustrated in
gure 38.8.8.
DIgSILENT PowerFactory 15, User Manual 879
CHAPTER 38. PROTECTION
Figure 38.8.8: Creating a new relay type
In the TypRelay dialogue that appears give the relay type an appropriate name.
In the relay denition eld select the relay frame constructed earlier from the User Dened
Models section of the project library.
Select the category as overcurrent relay.
10. Dene the CT type
The CT type can be selected by double clicking in the type column associated with the CT
row.
The desired CT should be selected from the data manager.
11. Dene the measurement type
The measurement type can be selected by double clicking in the type column associated with
the measurement row. For this example select the following options:
Select Type to 3ph RMS currents
Select nominal current to discrete with a value of 5.
Select measuring time to 0.001
Ensure no check boxes are selected.
12. Dene the TOC types
The TOC types can be selected by double clicking in the type column associated with the
rows of each of the three TOC slots. For this example select the following options for each
TOC type:
Select IEC symbol I>t and Ansi symbol 51.
Select type to phase A, B or C current depending on the slot.
Select directional to none.
880 DIgSILENT PowerFactory 15, User Manual
38.9. APPENDIX - OTHER COMMONLY USED RELAY BLOCKS
Select current range to range type: stepped, minimum: 0.5, maximum: 2 and step size: 0.25.
Check the characteristic includes pickup time box and set pickup time: 0.01s, Reset time:
0.04s and Reset Characteristic Conguration: Disabled.
Select an existing relay characteristic from another relay or create a new relay characteristic
by creating a TypChatoc object.
On the Total clear curve tab ensure no boxes are checked.
On the blocking page, select consider blocking to disabled.
Select release blocking time range to range type: stepped, minimum: 0 maximum: 10000
and step size: 0.01.
13. Dene the Logic types
The Logic type can be selected by double clicking in the type column associated with the
logic row.
Select Breaker event to open.
Select number of inputs to 4.
Select number of block inputs to 4.
Select a logical OR operation.
This concludes denition of the relay type.
To use the relay type a relay must be created within the network. The relay type can then be selected,
and the relay element parameters dened.
38.9 Appendix - Other commonly used relay blocks
The frequency measurement block The frequency measurement unit is used to calculate the electrical
frequency for the given Measured Voltage. The Nominal Voltage is needed for per unit calculations. The
Frequency Measurement Time denes the time used for calculating the frequency gradient.
Figure 38.9.1: Frequency measurement block
The frequency block The frequency block either trips on an absolute under-frequency (in Hz), or on
a frequency gradient (in Hz/s). Which condition is used depends on the selected type. The type also
denes the reset time, during which the dened frequency conditions must be present again for the
relay to reset.
The time delay set in the relay element denes the time during which the dened frequency condition
must be violated for the relay to trip. See Figure 38.9.2.
DIgSILENT PowerFactory 15, User Manual 881
CHAPTER 38. PROTECTION
Figure 38.9.2: Frequency block
The under-/overvoltage block The under-/overvoltage relay type may dene the block to trip on either
One of the three phase line to line voltages
One particular line to line voltage
The ground voltage U
0
.
The positive sequence voltage U
1
The negative sequence voltage U
2
The relay element allows only for setting of the pickup voltage and the time delay. See Figure 38.9.3.
Figure 38.9.3: Under-/Overvoltage block
882 DIgSILENT PowerFactory 15, User Manual
Chapter 39
Network Reduction
39.1 Introduction
This chapter explains how to use the PowerFactory Network Reduction tool. A typical application of
Network Reduction is when a network that is part of or adjacent to a much larger network must be
analyzed, but cannot be studied independently of the larger network. In such cases, one option is
to model both networks in detail for calculation purposes. However, there might be situations when
it is not desirable to do studies with the complete model. For example, when the calculation times
would increase signicantly or when the data of the neighbouring network is condential and cannot be
published.
In these cases, it is common practice to provide a simplied representation of the neighbouring network
that contains only the interface nodes (connection points). These can then be connected by equivalent
impedances and voltage sources, so that the short circuit and load-ow response within the kept (non
reduced) system is the same as when the detailed model is used.
PowerFactory s Network Reduction algorithm produces an equivalent representation of the reduced part
of the network and calculates its parameters. This equivalent representation is valid for both load ow
and short-circuit calculations, including asymmetrical faults such as single-phase faults.
The chapter is separated into ve parts. Firstly, the technical background of the PowerFactory Network
Reduction algorithm is explained. Section 39.3 discusses the steps needed to run a Network Reduction
and Section 39.4 explains in detail each of the options of the PowerFactory Network Reduction tool.
The penultimate part, Section 39.5, presents a simple example and the nal section provides some tips
and tricks to consider when working with the Network Reduction tool.
39.2 Technical Background
Some additional technical background on the Network Reduction tool is provided in the following sec-
tions.
39.2.1 Network Reduction for Load Flow
Network reduction for load ow is an algorithm based on sensitivity matrices. The basic idea is that the
sensitivities of the equivalent grid, measured at the connection points in the kept grid, must be equal to
the sensitivities of the grid that has been reduced. This means that for a given (virtual) set of P and
Q injections in the branches, from the kept grid to the grid to be reduced, the resulting u and
DIgSILENT PowerFactory 15, User Manual 883
CHAPTER 39. NETWORK REDUCTION
(voltage magnitude and voltage phase angle variations) in the boundary nodes must be the same for
the equivalent grid as those that would have been obtained for the original grid (within a user dened
tolerance).
39.2.2 Network Reduction for Short-Circuit
Network reduction for short-circuit is an algorithm based on nodal impedance / nodal admittance ma-
trices. The basic idea is that the impedance matrix of the equivalent grid, measured at the connection
points in the kept grid, must be equal to the impedance matrix of the grid to be reduced (for the rows
and columns that correspond to the boundary nodes). This means that for a given (virtual) additional
I injection (variation of current phasor) in the boundary branches, from the kept grid to the grid to be
reduced, the resulting u (variations of voltage phasor) in the boundary nodes must be the same for
the equivalent grid, as those that would have been obtained for the original grid (within a user dened
tolerance).
This must be valid for positive sequence, negative sequence, and zero sequence cases, if these are to
be considered in the calculation (unbalanced short-circuit equivalent).
39.3 How to Complete a Network Reduction
This section explains the process for running a Network Reduction. There are several steps that you
must complete to successfully reduce a network:
1. Create a boundary and dene the interior and exterior regions.
2. Create a backup of the project intended for reduction (optional).
3. Activate the additional tools toolbar and congure the Network Reduction Tool options.
4. Run the Network Reduction Tool.
You must dene a boundary before you can proceed further with the Network Reduction. This process is
described in detail in Chapter 13 Grouping Objects, Section 13.3 (Boundaries). However, to summarize,
the boundary divides the network into two regions, the area to be reduced which is referred to as the
interior region and the area to be kept which is referred to as the exterior region. The following section
describes the process of backing up the project, running the Network Reduction tool using the default
options and describes the expected output of a successful network reduction. For more information
about the options available within the Network Reduction tool, see Section 39.4: Network Reduction
Command.
39.3.1 How to Backup the Project (optional)
By default, the Network Reduction tool keeps all the original network data and the modications needed
to reduce the network are stored within a new expansion stage that is part of a new variation. It will
only destroy the original data if the associated option within the command is congured for this (see
Section 39.4.2: Outputs).
However, if you want extra security to guarantee against data loss, in case for instance you accidently
select the option to modify the original network, then you should make a backup copy of the project
before completing the Network Reduction. There are three possible ways to do this:
make a copy of the whole project and paste/store it with a name different to that of the original
project; or
884 DIgSILENT PowerFactory 15, User Manual
39.3. HOW TO COMPLETE A NETWORK REDUCTION
export the project as a *.dz- or *.pfd le (for information about exporting data please refer to
Section 8.1.5: Exporting and Importing of Projects); or
activate the project and create a Version of the project. For information about Versions please
refer to Section 18.2 (Project Versions).
39.3.2 How to run the Network Reduction tool
This sub-section describes the procedure you must followto run the Network Reduction using the default
options. Proceed as follows:
1. Activate the base Study Case for the project you wish to reduce.
2. Dene a boundary that splits the grid into the part to be reduced (interior region), and the part to
be kept (exterior region). See Section 13.3 (Boundaries) for the procedure.
3. Open the boundary object and use the Check Split button in the ElmBoundary dialogue to check
that the boundary correctly splits the network into two regions. See Section 13.3 (Boundaries) for
more information about boundaries.
4. Select the Change Toolbox button from the main toolbar. This is illustrated in Figure 39.3.1.
5. Press the Network Reduction icon from the Additional Tools bar (Figure 39.3.1). This opens
the dialogue for Network Reduction Command (ComRed).
6. Select the boundary you previously dened using the selection control .
7. Optional: If you wish to modify the settings of the command, do so in this dialogue. The settings
and options are explained in Section 39.4 (Network Reduction Command). However, the default
options are recommended, unless you have a specic reason for changing them.
8. Press the Execute button to start the reduction procedure.
Figure 39.3.1: The Network Reduction Button in the Additional Tools Icon Bar
39.3.3 Expected Output of the Network Reduction
This sub-section describes the expected output of the network reduction tool after successfully execut-
ing it. The output varies depending on whether the reduced project was created in V13.2 or earlier
DIgSILENT PowerFactory 15, User Manual 885
CHAPTER 39. NETWORK REDUCTION
and contains system stages, or if it was created in V14.0 or higher. Both output scenarios are ex-
plained in the following sections. Also, the additional objects that the Network Reduction tool creates
are explained.
Changes to the network model for projects created in V14.0 or higher
The default behaviour of the Network Reduction command is to create a Variation containing a single
Expansion Stage called Reduction Stage. For more information see Chapter 15: Network Variations
and Expansion Stages. The Variation will be named automatically according to the reduction options
selected in the Basic Options page of the Network Reduction command. For example, for the default
options the Variation will be named Equ-LF [EW] - Shc[sym] @ Boundary. Figure 39.3.2 shows an
example of a network data model after a successful Network Reduction.
Figure 39.3.2: Project Data tree showing the network model after a successful Network Reduction using
the default options.
The Network Reduction tool also creates a new Study Case with a name that matches the new Variation
name. To return to your original network, all you need to do is activate the original study case that you
used to initiate the Network Reduction.
Note: The Variation and Study Case created by the Network Reduction tool are automatically activated
when the tool is run. To return to your original model you need to reactivate the base Study Case.
Changes to the network model for projects created in V13.2 or lower
For projects imported from V13.2, if they contain System Stage(s) (superseded by Variations in V14.0),
then the Network Reduction does not create a Variation in the project. Instead, a system stage is
created within each active grid. Therefore, if there are n active grids when the Network Reduction
process is initiated, there will be n System Stages created. The naming convention for the System
Stage(s) is the same as the naming convention for the Variations described above. The new System
Stage(s) will be automatically activated in the created study case.
If one or more single line graphic diagrams were in the System Stage(s) within the original grid, these
886 DIgSILENT PowerFactory 15, User Manual
39.4. NETWORK REDUCTION COMMAND
graphics will also be kept in the new System Stage(s) within the combined (partly kept and partly re-
duced) grid. The rst time that the new study case is activated (automatically, at the end of Network Re-
duction procedure), the graphics will be displayed. The elements contained in the part of the grid which
was reduced (if any of them were previously shown), will appear grey in colour, as ghost elements.
Deactivating and re-activating the project will make them disappear permanently (they are graphic ele-
ments only, and have no corresponding elements in the database in the new System Stage(s)).
New objects added by the Network Reduction command
Depending on the network conguration and the options chosen within the Network Reduction com-
mand, during the Network Reduction process some new objects might be created. There are two
possible new object types:
AC Voltage Source (ElmVac) ; and
Common Impedance (ElmZpu)
By default, there will be one voltage source created for every boundary node and one common impedance
between every pair of boundary nodes (unless the calculated mutual impedance is greater than the
user-dened threshold described in Section 39.4.3). These objects are stored in the database but are
not automatically drawn on the single line graphic. If you need to see these objects on the single line
diagram, you must add them manually using the PowerFactory tool Draw Existing Net Elements, which
is explained in Section 9.5 (Drawing Diagrams with Existing Network Elements).
39.4 Network Reduction Command
In this section, the Network Reduction command options are explained.
39.4.1 Basic Options
This section describes the options on the Basic Options page of the Network Reduction command as
shown in Figure 39.4.1.
DIgSILENT PowerFactory 15, User Manual 887
CHAPTER 39. NETWORK REDUCTION
Figure 39.4.1: Network Reduction Command (ComRed) Basic Options
Boundary
This selection control refers to the boundary that denes the part of the grid that shall be reduced by
the reduction tool. Note, the project Boundaries folder might contain many boundaries, but you must
select only one boundary from this folder. This selected boundary must separate the original grid into
two parts, the part that shall be reduced (interior region) and the part that shall be kept (exterior region).
For more information about boundaries, please refer to Section 13.3 (Boundaries).
Load Flow
Calculate load ow equivalent If this option is enabled, the load ow equivalent model will be
created by the reduction tool. This option is enabled by default.
Equivalent Model for Power Injection The load owequivalent is composed of mutual impedances
between boundary nodes and power injections (and shunt impedances) at boundary nodes. The
power injection can be represented by different models. For the load ow equivalent there are
three options (models) available:
Load Equivalent: a load demand.
Ward Equivalent: an AC voltage source which is congured as a Ward Equivalent.
Extended Ward Equivalent: an AC voltage source which is congured as an Extended
Ward Equivalent.
Short-Circuit
Calculate short-circuit equivalent If this option is enabled, the short-circuit equivalent model
will be created by the Network Reduction tool. Currently, only the complete short-circuit calcula-
tion method is supported.
Asymmetrical Representation This option is used to specify whether an unbalanced short-
circuit equivalent will be created. If this option is disabled, only a balanced short-circuit equivalent
will be created, valid for the calculation of 3-phase short-circuits. If this option is enabled, an
888 DIgSILENT PowerFactory 15, User Manual
39.4. NETWORK REDUCTION COMMAND
unbalanced short-circuit equivalent is created, valid for the calculation of single-phase and other
unsymmetrical short-circuits. This means the network representation must include zero sequence
and negative sequence parameters, otherwise the unbalanced calculation cannot be done.
39.4.2 Outputs
The section describes the options available on the Outputs page of the Network Reduction command
as shown in Figure 39.4.2. These options dene how the Network Reduction command modies the
network model.
Figure 39.4.2: Network Reduction Command - Outputs
Calculation of Parameters Only The equivalent parameters are calculated and reported to the
output window. If this option is selected then the Network Reduction command does not modify
the network model.
Create a new Variation for Reduced Network (Default) The equivalent parameters are calcu-
lated and a Variation will be automatically created to store the reduced network model. If the
project already includes System Stage(s) (from PowerFactory version 13.2 or earlier versions)
then System Stage(s) will be created instead of a Variation.
Reduce Network without Creating a New Variation The Network Reduction command will
directly modify the main network model if this options is selected. Therefore, this option will
destroy data by deleting the interior region of the selected boundary, and replacing it with its
reduced model, so this option should be used with care. To avoid losing the original grid data,
backup the project as described in Section 39.3.1 (How to Backup the Project (optional)).
39.4.3 Advanced Options
This section describes the Advanced Options for the Network Reduction command as shown in Fig-
ure 39.4.3.
Figure 39.4.3: Network Reduction Command - Advanced Options
Mutual Impedance (Ignore above) As part of the Network Reduction process equivalent branches
(represented using Common Impedance elements) will be created between the boundary nodes,
DIgSILENT PowerFactory 15, User Manual 889
CHAPTER 39. NETWORK REDUCTION
to maintain the power-ow relationship between them. If such branches have a calculated
impedance larger than this parameter they will be ignored (not added to the network model).
By default, the number of these branches created will be N*(N-1)/2, where N is the number of
boundary nodes. A boundary node is dened for each boundary cubicle. Therefore, the number
of created branches can be very high. Normally many of these equivalent branches have a very
large impedance value, so their associated power ows are negligible and the branch can be
ignored.
The default value for this parameter is 1000 p.u (based on 100 MVA).
Calculate Equivalent Parameters at All Frequencies This option enables the calculation of
frequency-related parameters. By default, the short-circuit equivalent parameters are calculated
at all frequencies relevant to short-circuit analysis (equivalent frequencies for calculating the d.c.
component of the short-circuit current):
f = f
n
f/f
n
= 0.4
f/f
n
= 0.27
f/f
n
= 0.15
f/f
n
= 0.092
f/f
n
= 0.055
f
n
is the nominal frequency of the grid (usually 50 Hz or 60 Hz).
If only transient and sub-transient short-circuit currents are important in the reduced network, the
calculation of frequency-related parameters can be skipped by unchecking this option.
39.5 Network Reduction Example
This section presents a Network Reduction example using a small transmission network feeding a distri-
bution system from bus 5 and bus 6 as shown in Figure 39.5.1. The distribution system is represented
by Load A and Load B and the corresponding two transformers. As a user you would like to study
the distribution system in detail but are not concerned with the detailed power ow within the transmis-
sion system. Therefore, the Network Reduction tool can be used to create a equivalent model for the
transmission system.
The interior region (the area that shall be reduced) is shown shaded in grey, whereas the non-shaded
area is the exterior region that shall be kept. The procedure for completing the Network Reduction
according to these parameters is as follows (you can repeat this example yourself using the nine bus
system within the PowerFactory Examples - the network used in the example is slightly modied from
this):
890 DIgSILENT PowerFactory 15, User Manual
39.5. NETWORK REDUCTION EXAMPLE
Figure 39.5.1: Example System with Original Network
1. Select cubicles that will be used to dene the boundary. These are highlighted in Figure 39.5.2.
(Use the freeze mode to make selection of the cubicles easier.)
DIgSILENT PowerFactory 15, User Manual 891
CHAPTER 39. NETWORK REDUCTION
Figure 39.5.2: Cubicles used for the boundary denition.
2. Right-click one of the selected cubicles and choose the option Dene Boundary ... The bound-
ary dialogue appears.
3. Alter the boundary cubicle orientations so that the Interior region is correctly dened. The cubicle
orientation for the T4 and T5 cubicles should be set to Busbar. This means that the boundary
interior is dened by looking back at the bus from these cubicles. The orientation for the Line 1
and Line 6 cubicles remains on Branch (looking into the branch).
4. Open the Network Reduction command dialogue and select the boundary dened in steps 1-3
using the selection control.
5. Press Execute. The Network Reduction tool will reduce the system.
6. Optional: draw in the three new common impedance elements and three equivalent ward voltage
source objects using the Draw Existing Net Elements tool. The result of the Network Reduction is
shown in Figure 39.5.3.
A load ow calculation or a short-circuit calculation in the reduced network gives the same results for
the distribution network as for the original (non-reduced) network.
892 DIgSILENT PowerFactory 15, User Manual
39.6. TIPS FOR USING THE NETWORK REDUCTION TOOL
Figure 39.5.3: Example System with Reduced Network
39.6 Tips for using the Network Reduction Tool
This section presents some tips for using the Network Reduction tool and some solutions to common
problems encountered by users.
39.6.1 Station Controller Busbar is Reduced
Sometimes a interior region might be dened such that it contains the reference bus of a station con-
troller. The generators belonging to this station controller are in the exterior region. During the reduction
process the reference bus will be reduced (removed) from the model, yet the station controller and gen-
erators will remain part of the new system. In such a situation, attempting to run a load-ow after the
reduction will fail with an error message similar to that shown in Figure 39.6.1.
Figure 39.6.1: Error message showing a station controller error
There are two possible solutions to this problem:
DIgSILENT PowerFactory 15, User Manual 893
CHAPTER 39. NETWORK REDUCTION
Modify the boundary denition slightly such that the station controller bus is excluded from the
exterior region; or
Set the station controller out of service and the generators to local PV mode.
39.6.2 Network Reduction doesnt Reduce Isolated Areas
By default, the boundary denition search stops when encountering an open breaker. This means that
isolated areas can sometimes be excluded from the interior region and therefore are not reduced by the
Network Reduction tool. The solution to this problem is to disable the boundary ag Topological search:
Stop at open breakers. This option is enabled by default in all boundary denitions. It is recommended
to disable it before attempting a Network Reduction.
A related problem occurs with the project setting (Edit Project Project Settings Advanced Cal-
culation Parameters) Automatic Out of Service Detection. It is recommended that this option is disabled
before attempting a Network Reduction. However, it is disabled by default, so if you have not made
changes to the default project settings you should not need to make any changes to this setting.
39.6.3 The Reference Machine is not Reduced
The Network Reduction tool will not reduce a reference machine dened within the interior region. It
also leaves all network components that are topologically one bus removed from the reference machine
(and of non-zero impedance). For example, if the reference machine is a typical synchronous ma-
chine connected to the HV system through a step up transformer, then the reduction tool will leave the
synchronous machine, the LV bus, the step up transformer and the HV bus within the reduced network.
It is recommended that the reference machine is found within the exterior region before attempting a
Network Reduction. The reference machine can be identied by checking the output window following
a successful load-ow calculation as illustrated in Figure 39.6.2.
Figure 39.6.2: Output window showing the load-ow command output and the indication of the reference
machine
894 DIgSILENT PowerFactory 15, User Manual
Chapter 40
State Estimation
40.1 Introduction
The State Estimator (SE) function of PowerFactory provides consistent load ow results for an entire
power system, based on real time measurements, manually entered data and the network model. Be-
fore any further analysis, such as contingency analysis, security checks etc. can be carried out, the
present state of a power system must be estimated from available measurements. The measurement
types that are processed by the PowerFactory State Estimator are:
Active Power Branch Flow
Reactive Power Branch Flow
Branch Current (Magnitude)
Bus Bar Voltage (Magnitude)
Breaker Status
Transformer Tap Position
Unfortunately, these measurements are usually noisy and some data might even be totally wrong. On
the other hand, there are usually more data available than absolutely necessary and it is possible to
prot by redundant measurements for improving the accuracy of the estimated network state.
The states that can be estimated by the State Estimator on the base of the given measurements vary
for different elements in the network:
Loads
Active Power, and/or
Reactive Power, or
Scaling Factor, as an alternative
Synchronous Machines
Active Power, and/or
Reactive Power
Asynchronous Machines
Active Power
DIgSILENT PowerFactory 15, User Manual 895
CHAPTER 40. STATE ESTIMATION
Static var System
Reactive Power
2- and 3-winding transformers
Tap Positions (for all but one taps).
40.2 Objective Function
The objective of a state estimator is to assess the generator and load injections, and the tap positions
in a way that the resulting load ow result matches as close as possible with the measured branch
ows and bus bar voltages. Mathematically, this can be expressed with a weighted square sum of all
deviations between calculated (calVal ) and measured (meaVal ) branch ows and bus bar voltages:
f(x) =
n
i=1
w
i
|calV al
i
(x) meaV al
i
|
2
(40.1)
The state vector x contains all voltage magnitudes, voltage angles and also all variables to be estimated,
such as active and reactive power injections at all bus bars.
Because more accurate measurements should have a higher inuence to the nal results than less
accurate measurements, every measurement error is weighted with a weighting factor wi to the standard
deviation of the corresponding measurement device (+transmission channels, etc.).
In this setting, the goal of a state estimator is to minimize the above given function f under the side
constraints that all load ow equations are fullled.
40.3 Components of the PowerFactoryState Estimator
The State Estimator function in PowerFactory consists of several independent components, namely:
1. Preprocessing
2. Plausibility Check
3. Observability Analysis
4. State Estimation (Non-Linear Optimization)
Figure 40.3.1 illustrates the algorithmic interaction of the different components. The rst Preprocessing
phase adjusts all breaker and tap positions according to their measured signals.
896 DIgSILENT PowerFactory 15, User Manual
40.3. COMPONENTS OF THE POWERFACTORY STATE ESTIMATOR
Figure 40.3.1: Variation of the PowerFactory state estimator algorithm
The Plausibility Check is sought to detect and separate out, in a second phase, all measurements with
some apparent error. PowerFactory provides various test criteria for that phase of the algorithm.
In a third phase, the network is checked for its Observability. Roughly speaking, a region of the network
is called observable, if the measurements in the system provide enough (non-redundant) information to
estimate the state of that part of the network.
Finally, the State Estimation itself evaluates the state of the entire power system by solving the above
mentioned non-linear optimization problem. PowerFactory provides various ways for copying with non-
observable areas of the network.
In order to improve the quality of the result, observability analysis and state estimation can be run in a
loop. In this mode, at the end of each state estimation, the measurement devices undergo a so-called
Bad Data Detection: the error of every measurement device can be estimated by evaluating the differ-
ence between calculated and measured quantity. Extremely distorted measurements (i.e. the estimated
error is much larger than the standard deviation of the measurement device) are not considered in the
subsequent iterations. The process is repeated until no bad measurements are detected any more.
In the following, the distinct components of the PowerFactory state estimator are explained in detail.
40.3.1 Plausibility Check
In order to avoid any heavy distortion of the estimated network-state due to completely wrong mea-
surements, the following Plausibility Checks can be made before the actual State Estimation is started.
Every measurement that fails in any of the listed Plausibility Checks will not be considered.
DIgSILENT PowerFactory 15, User Manual 897
CHAPTER 40. STATE ESTIMATION
Check for consistent active power ow directions at each side of the branch elements.
Check for extremely large branch losses, which exceed their nominal values.
Check for negative losses on passive branch elements.
Check for large branch ows on open ended branch elements.
Check whether the measured branch loadings exceed the nominal loading value of the branch
elements.
Node sum checks for both, active and reactive power.
Each test is based on a stochastic analysis which takes into account the measurements individual
accuracy. The strictness of the above mentioned checking criteria can be continuously adjusted in the
advanced settings.
The result of the Plausibility Check is reported, for each measurement, on a detailed error status page
(see Section 40.6).
40.3.2 Observability Analysis
A necessary requirement for an observable system is that the number of available measurements is
equal or larger than the number of estimated variables. This verication can easily be made at the
beginning of every state estimation.
But it can also happen that only parts of the network are observable and some other parts of the system
are not observable even if the total number of measurements is sufcient. Hence, it is not only important
that there are enough measurements, but also that they are well distributed in the network.
Therefore, additional verications are made checking for every load or generator injection whether it
is observable or not. The entire network is said to be observable if all load or generator injections
can be estimated based on the given measurements. PowerFactory does not only solve the decision
problem whether the given system is observable or not: If a network is not observable, it is still useful
to determine the islands in the network that are observable.
The Observability Analysis in PowerFactory is not purely based on topological arguments; it heavily
takes into account the electrical quantities of the network. Mathematically speaking, the Observability
Check is based on an intricate sensitivity analysis, involving fast matrix-rank-calculations, of the whole
system.
The result of the Observability Analysis can be viewed using the data manager. Besides, PowerFac-
tory offers a very exible colour representation both for observable and unobservable areas, and for
redundant and non-redundant measurements (see Section 40.6.4).
Observability of individual states
The Observability Analysis identies not only, for each state (i.e., load or generator injections) whether
it is observable or not. It also subdivides all unobservable states into so-called equivalence-classes.
Each equivalence-class has the property that it is observable as a group, even though its members (i.e.,
the single states) cannot be observed. Each group then can be handled individually for the subsequent
state estimation.
Redundancy of measurements
Typically, an observable network is overdetermined in the sense that redundant measurements exist,
whichfor the observability of the systemdo not provide any further information. During the Observability
Analysis, PowerFactory determines redundant and non-redundant measurements. Moreover, it subdi-
vides all redundant measurements according to their information content for the systems observability
status. In this sense, PowerFactory is even able to calculate a redundancy level which then indicates
898 DIgSILENT PowerFactory 15, User Manual
40.4. STATE ESTIMATOR DATA INPUT
how much reserve the network measurements provide. This helps the system analyst to precisely
identify weakly measured areas in the network.
40.3.3 State Estimation (Non-Linear Optimization)
The non-linear optimization is the core part of the State Estimator. As already mentioned in the intro-
duction, the objective is to minimize the weighted square sum of all deviations between calculated and
measured branch ows and bus bar voltages whilst fullling all load ow equations.
PowerFactory uses an extremely fast converging iterative approach to solve the problem based on
Lagrange-Newton methods. If the Observability Analysis in the previous step indicates that the entire
power system is observable, convergence (in general) is guaranteed.
In order to come up with a solution for a non-observable system, various strategies can be followed:
One option is to reset all non-observable states, such that some manually entered values or historic
data is used for these states. An alternative option is to use so-called pseudo-measurements for non-
observable states. A pseudo-measurement basically is a measurement with a very poor accuracy.
These pseudo-measurements force the algorithmto converge. At the same time, the resulting estimated
states will be of correct proportions within each equivalence-class.
In the remaining sections of this guide of use, the instructions related to Data Entry, Options and Con-
straints, and Visualization of Results are presented.
40.4 State Estimator Data Input
The main procedures to introduce and manipulate the State Estimator data are indicated in this section.
For applying the PowerFactory State Estimator, the following data are required additional to standard
load ow data:
Measurements
Active Power Branch Flow
Reactive Power Branch Flow
Branch Current (Magnitude)
Bus Bar Voltage (Magnitude)
Breaker Status
Transformer Tap Position
Estimated States
Loads: Active Power (P) and/or Reactive Power (Q), or the Scaling Factor, as an alternative.
Synchronous Machines: Active Power (P) and/or Reactive Power (Q)
Asynchronous Machines: Active Power (P)
Static var Systems: Reactive Power (Q)
Transformers: Tap Positions
For the measurements listed above, PowerFactory uses the abbreviated names P-measurement, Q-
measurement, I-measurement, V-measurement, Breaker-measurement, and Tap position-measurement.
Similarly, as a convention, the four different types of estimated states are shortly called P-state, Q-state,
Scaling factor-state, and Tap position-state.
DIgSILENT PowerFactory 15, User Manual 899
CHAPTER 40. STATE ESTIMATION
40.4.1 Measurements
All measurements are dened by placing a so-called External Measurement Device inside a cubicle.
For this purpose, select the device in the single-line graphic and choose from the context menu (right
mouse button) New Devices and then External Measurements... (see Figure 40.4.1). Then, the new
object dialogue pops up with a predened list of external measurements. Please select the desired
measurement device among this list (see Figure 40.4.2).
Figure 40.4.1: External Measurements that are located in a cubicle
900 DIgSILENT PowerFactory 15, User Manual
40.4. STATE ESTIMATOR DATA INPUT
Figure 40.4.2: Dening new external measurements
The following measurement devices are currently supported
(External) P-Measurement (StaExtpmea)
(External) Q-Measurement (StaExtqmea)
(External) I-Measurement, current magnitude (StaExtimea)
(External) V-Measurement, voltage magnitude (StaExtvmea)
(External) Breaker Signalization Breaker Status (StaExtbrkmea)
(External) Tap-Position Measurement Tap Position (StaExttapmea)
Any number of mutually distinct measurement devices can be dened in the cubicle.
Branch Flow Measurements
Any branch ow measurement (StaExpmea, StaExtqmea) is dened by the following values (see g-
ures 40.4.3 and 40.4.4):
Measured value (e:Pmea or e:Qmea, respectively)
DIgSILENT PowerFactory 15, User Manual 901
CHAPTER 40. STATE ESTIMATION
Multiplicator (e:Multip)
Orientation (e:i gen)
Accuracy class and rating (e:Snom and e:accuracy)
Input status (to be found on the second page of the edit object, see Figure 40.4.4):
E.g., tele-measured, manually entered, read/write protected,. . . (e:iStatus). It is important to
note that the state estimator takes into account only measurements, for which the read-Status is
explicitly set and for which the Neglected by SE-Status is unset.
Figure 40.4.3: Dialogue for an external P-measurement
The accuracy class and the rating are used for weighting the measurement element. In case of re-
dundant measurements, a more accurate measurement will be higher weighted than a less accurate
measurement.
Using the ag orientation, it is possible to dene the meaning of the active or reactive power sign.
Load orientation means that a positively measured P or Q ows into the element, generator orientation
denes a positive ow as owing out of an element. With the multiplicator, a measured quantity can
be re-rated. E.g., if a measurement instrument indicates 150kW (instead of 0.15MW), the multiplicator
can be set to 0.001 and the measured value is set to 150 resulting in a correct value.
It is important to note, that External P- and Q-measurements have the additional feature to possibly
serve as a so-called (externally created) pseudo-measurement. This feature is activated by checking the
corresponding box (e:pseudo). Pseudo-measurements are special measurements which are ignored
during the regular calculation. They are activated in a selective manner only if the observability check
found unobservable states in the network (see Section 40.5.1: Basic Setup Options for details).
Current Measurements
The External I-measurement (Staextimea) plays a special role and slightly differs from the External
P- and Q-measurements (see Figure 40.4.5): Besides specifying the measured current magnitude
(e:Imea), the user is asked to enter an assumed (or measured) value for the power factor cos
(e:cosphi and e:pf recapr).
902 DIgSILENT PowerFactory 15, User Manual
40.4. STATE ESTIMATOR DATA INPUT
Figure 40.4.4: Second page Status of the dialogue for an external P-measurement
Internally, the measured current magnitude is then additionally transformed into two further measure-
ments, namely an active and a reactive current. This is due to the fact that current magnitude does not
provide information on the direction of the ow, which on the other hand is essential to avoid ambiguous
solutions in the optimization.
In this sense, an external I-measurement may play the role of up to three measurements:
1. as a current magnitude measurement.
2. as a measurement for active current.
3. as a measurement for reactive current.
The decision which of these measurements shall participate in the state estimator is left to the user
by checking the boxes (e:iUseMagn,e:iUseAct, and/or e:iUseReact). In any case, the cor-
responding ratings for the used measurement types need to be specied. This is done (accord-
ingly to the ow measurements) by entering the pairs of elds (e:SnomMagn,e:accuracyMagn),
(e:SnomAct,e:accuracyAct), and (e:SnomReact,e:accuracyReact), respectively).
Voltage Measurements
Voltage measurements (StaExvmea) need to be placed in cubicles as well. The measurement point
then is the adjacent terminal.
DIgSILENT PowerFactory 15, User Manual 903
CHAPTER 40. STATE ESTIMATION
Figure 40.4.5: Dialogue for an external I-measurement
A voltage measurement basically has the same properties as a ow measurement, except, for the
rating, only a single value for the accuracy needs to be specied. The corresponding internal reference
is the nominal voltage of the terminal which serves as measurement point.
Breaker and Tap Position Measurements
Both breaker and tap position measurements are assumed to measure the corresponding discrete
breaker status and tap position signal accurately. Hence, no ratings needs to be specied.
Tap position measurements have a conversion table as extra feature. The conversion table allows
any discrete translation mapping between external tap positions (Ext. Tap) and tap positions used by
PowerFactory (PF Tap).
40.4.2 Activating the State Estimator Display Option
To access and enter data for State Estimator calculations in the appropriate elements of the grid, the
pertinent Display Options must be selected as follows:
a) Click the icon , or select from the main menu Options User Settings. Change to the page
Functions. The window shown in Figure 40.4.6 will appear.
b) Enable the Display Function State Estimator as shown below.
c) Exit the window clicking the OK button.
904 DIgSILENT PowerFactory 15, User Manual
40.4. STATE ESTIMATOR DATA INPUT
Figure 40.4.6: User Settings for State Estimation
With this display function enabled, a new page called State Estimator appears in the State Estimator
related elements of the grids in the activated project. The State Estimator data manipulation of the
different elements is indicated below.
40.4.3 Editing the Element Data
In addition to the measurement values, the user has to specify which quantities shall be considered as
states to be estimated by the SE. Possible states to be optimized whilst minimizing the sum of the
error squares over all measurements are all active and/or reactive power injections at generators and
loads and all tap positions.
Loads
For each load (ElmLod), the user can specify whether its active and/or reactive power shall be estimated
by the state estimator. Alternatively, the state estimator is able to estimate the scaling factor (for a
given P and Q injection). The specication which parameter shall be estimated, is done by checking
corresponding boxes on the State Estimator page of the load (see Figure 40.4.7). When these options
are disabled, the load is treated as in the conventional load ow calculation during the execution of the
SE.
DIgSILENT PowerFactory 15, User Manual 905
CHAPTER 40. STATE ESTIMATION
Figure 40.4.7: Editing element data for load
Synchronous Machines
Similarly, for synchronous machines (ElmSym), the active and reactive power can be selected as a
control variable for being estimated by the state estimator. Again, the user will nd corresponding check
boxes on the State Estimator page of the element.
If the corresponding check box(es) are disabled, the synchronous machine behaves as in the conven-
tional load ow calculation.
Asynchronous Machines
For asynchronous machines (ElmAsm), the active power may serve as a state to be estimated. Once
again, the corresponding box has to be checked on the State Estimator page.
If the corresponding check box is disabled, the asynchronous machine behaves as in the conventional
load ow calculation.
Static var Systems
For static var systems (ElmSvs), the reactive power may serve as a state to be estimated. Again, the
corresponding box has to be checked on the State Estimator page.
If the corresponding check box is disabled, the static var system behaves as in the conventional load
ow calculation.
Transformers
In the 2-winding transformer elements (ElmTr2), the tap position can be specied as a state to be
estimated by the State Estimator (see Figure 40.4.8). Tap positions will be estimated in a continuous
way (without paying attention to the given tap limits).
For 3-winding transformers, any two of the three possible tap positions (HV-, MV-, and LV-side) can be
selected for estimation (see Figure 40.4.9).
The corresponding check boxes are found on the State Estimator page of the transformers. If the check
box is disabled the State Estimator will treat the tap position of the transformers as in the conventional
906 DIgSILENT PowerFactory 15, User Manual
40.5. RUNNING SE
load ow calculation.
Figure 40.4.8: Editing element data for 2-winding transformers
Figure 40.4.9: Editing element data for 3-winding transformers
40.5 Running SE
The following steps should be performed to execute the State Estimator:
Start from a case where the conventional power ow converges successfully.
Select Additional Tools from the Change Toolbox button ( )
DIgSILENT PowerFactory 15, User Manual 907
CHAPTER 40. STATE ESTIMATION
Execute the SE by clicking the icon .
Select the desired options for the State Estimator run (see below).
Select Execute.
40.5.1 Basic Setup Options
Recall that the State Estimator in PowerFactory consists of three different parts (Plausibility Check,
Observability Analysis, State Estimation (non-linear optimization)) and an additional precedent Pre-
processing step (see Figure 40.3.1). This variation is reected in the Basic Options dialogue (see
Figure 40.5.1).
Figure 40.5.1: Editing the basic options page of the ComSe
40.5.1.1 Preprocessing
The algorithm distinguishes between breaker- and tap position-measurements on the one hand, and P-
,Q-,I-, and V-measurements on the other hand. Breaker- and tap position-measurements are handled
in the preprocessing step, whereas the latter types are processed in the subsequent parts or the state
estimator.
Adapt breaker measurements
If this check box is marked, all measured breakers statuses will be set to the corresponding measured
signal values.
Adapt tap position measurements
If this check box is marked, all measured tap positions will be set to the corresponding measured values.
908 DIgSILENT PowerFactory 15, User Manual
40.5. RUNNING SE
40.5.1.2 Plausibility Check
The algorithm offers various kinds of plausibility checks to validate measurements. Each measurement
undergoes the checks selected by the user. If a measurement fails any of the required tests, it will be
marked as erroneous and will be neglected in all subsequent steps. A complete error report can be
obtained via the error status page of each measurements (see Section 40.6).
The following checks can be enabled by marking the corresponding check boxes.
Consistent active power ow direction at each branch
Checks for each passive branch, whether all connected P-measurements comply with a consistent
power ow direction. More precisely, if some ow out of a passive element is measured while, at the
same time, no ow into the element is measured, then all P-measurements connected to this element
fail this test. For this check, a P-measurement is said to measure a non-zero ow if the measurement
value is beyond a value of rating, where and rating are the accuracy and the rating, respectively,
of the measurement.
Branch losses exceed nominal values
Checks for each passive branch, whether the measured active power loss exceeds the nominal loss of
the branch by a factor of 1 + . This check only applies to passive branches which have P-measurements
Pmea
1
, . . . ,Pmea
r
in each of its r connection devices. The threshold , by which the nominal loss
shall not be exceeded, is given by: =
r
i=1
i
rating
i
, where
i
and rating
i
are the accuracy and the
rating, respectively, of measurement Pmea
i
.
Negative losses on passive branches
Checks for each passive branch, whether the measured active power loss is negative, i.e., if a passive
branch is measured to generate active power. This check only applies to passive branches which have
P-measurements Pmea
1
, . .. , Pmea
r
in each of its r connection devices. The measured power loss of
the branch is said to be negative if it is below the threshold (
r
i=1
i
rating
i
).
Large branch ows on open ended branches
Checks for each connection of the element, whether the connection is an open end (i.e., switch is open,
or it is connected to only open detailed switches). If the connection is open and there exists a (P-, Q-,
or I-) measurement which measures a non-zero ow, then the corresponding measurement fails the
test. Again, a measurement is said to measure a non-zero ow if the measurement value is beyond a
value of rating.
Branch loadings exceed nominal values
Checks for each connection of the element, if the measured complex power (which is computed by the
corresponding P- and/or Q-measurements) exceeds the rated complex power value by a factor of 1 + s.
Here, s is the accuracy of the P- and/or Q-measurement(s).
Node sum checks for active and reactive power
This check applies to P- and/or Q-measurements. Checks, for each node of the network, if the node
sum of the measured values in the adjacent branches is zero. If this is not the case, i.e., if the P- and/or
Q-sum exceeds a certain threshold value, all adjacent P- and/or Q-measurements fail the test. Again,
not being zero means that the sum of the measured values of the adjacent P-measurements Pmea
1
,
... , Pmea
r
has magnitude below the threshold
r
i=1
i
rating (similarly for Q-measurements).
40.5.1.3 Observability Analysis
The Observability Analysis is an optional component of the State Estimator. If activated, it checks
whether the specied network is observable, i.e., whether the remaining valid P-, Q-, V-, and I-measurements
(which successfully passed the plausibility checks) sufce to estimate the selected P-, Q-, Scaling
Factor-, and Tap position-states. In addition, the Observability Analysis detects redundant measure-
ments. Redundancy, in general, yields more accurate results for the following state estimation.
Moreover, if the Observability Analysis detects non-observable states, upon user selection, it tries to x
DIgSILENT PowerFactory 15, User Manual 909
CHAPTER 40. STATE ESTIMATION
this unobservability by introducing further pseudo-measurements.
Check for observability regions
If the corresponding check box is marked by the user, the execution of the State Estimator will run the
Observability Analysis (prior to the state Estimation optimization).
Treatment of unobservable areas
In case of unobservable states, the user has different options to cope with the situation:
Stop if unobservable regions exist: The algorithmterminates with the detection of unobservable
states. The Observability Analysis groups all non-observable states into different equivalence
classes. Each equivalence class consists of states that carry the same observability information
through the given measurements. In other words, the given measurements can only distinguish
between different equivalence classes, but not between various states of a single equivalence
class. The results can be viewed by the user (see Section 40.6 Results).
Use P-, Q-values as specied by model:: If this option is selected, the algorithm internally drops
the to be estimated ag of each non-observable state and uses the element specications of the
load ow settings instead. For example, if a P-state of a load is unobservable, the algorithm will
use the P-value as entered on the load ow page. Hence, the network is made observable by
reducing the number of control variables.
Use predened pseudo-measurements: Using this option, the algorithm repairs the unob-
servability of the network by increasing the degrees of freedom. For that purpose, at the location
of each non-observable state, the algorithm tries to activate a pseudo-measurement of the same
kind. Hence, if a P- (Q-)state is non-observable in some element, the algorithm searches for a
P-(Q-)pseudo-measurement in the cubicle of the element carrying the non-observable state. In
case of a non-observable scaling-factor both, a P- and a Q-pseudo-measurement are required.
The introduced pseudo-measurements remain active as long as needed to circumvent unobserv-
able areas.
Use internally created pseudo-measurements: This option is similar to the previous one, ex-
cept the algorithm automatically creates and activates a sufcient number of internal pseudo-
measurements to guarantee observability. More precisely, internal pseudo-measurements are
created at the locations of all elements that have non-observable P-(Q-, scaling factor-)state. For
each such element, the pseudo-measurement value for P (Q, P and Q) is taken from the elements
load ow specication. All internally created pseudo-measurements use a common setting for
their rating and accuracy, which can be specied on the advanced setup options page for the ob-
servability check.
Use predened and internally created meas: This mode can be considered as a mixture of
the latter two options. Here, in case of a non-observable state, the algorithm tries to activate a
predened pseudo-measurement of the same kind. If no corresponding pseudo-measurement
has been dened, then the algorithm automatically creates an internal pseudo-measurement.
40.5.1.4 State Estimation (Non-Linear Optimization)
The non-linear optimization is the central component of the State Estimator. The underlying numerical
algorithm to minimize the measurements overall error is the iterative Lagrange-Newton method.
Run state estimation algorithm
Check this box to enable the non-linear optimization. Note that after convergence of the method,upon
user settings on the advanced state estimation option pagePowerFactory performs a bad data check
which eliminates the worst P-,Q-,V-, and I-measurements among all bad data. Observability Analysis
and State Estimation are run in a loop until no further bad measurements exist (recall the algorithm
variation as shown in Figure 40.3.1).
910 DIgSILENT PowerFactory 15, User Manual
40.5. RUNNING SE
40.5.2 Advanced Setup Options for the Plausibility Check
Each Plausibility Check allows for an individual strictness setting. Note that all checks rely on the
same principle: namely, the given measurement values are checked against some threshold. Recall,
for example, that the node sum check for P tests whether the active power sum at a node is below
a threshold of =
r
i=1
i
rating. The user has the possibility to inuence the strictness of this
threshold. Therefore, the settings provide to enter so-called exceeding factors fac > 0 such that the
new threshold is fac instead of . E.g., in the case of the node sum check for P, the user may dene
the corresponding factor fac ndSumP.
The higher the exceeding factor, the less strict the plausibility test will be. Similar exceeding factors can
be specied for any of the given tests.
40.5.3 Advanced Setup Options for the Observability Check
Rastering of sensitivity matrix
Internally, the Observability Check is based on a thorough sensitivity analysis of the network. For that
purpose, the algorithm computes a sensitivity matrix that takes into account all measurements, on the
one hand, and all estimated states on the other hand. This sensitivity matrix is discretized by rastering
the continuous values.
The user can specify the precision of this process by dening the number of intervals into which the
values of the sensitivity matrix shall be rastered (SensMatNoOfInt), the threshold below which a
continuous value is considered to be a 0 (SensMatThresh) in the discrete case, and the mode of
rastering (iopt raster). It is highly recommended to use the predened values here.
Settings for internally created pseudo-measurements
If, on the basic option page, the mode for the treatment of unobservable regions is set to use only
internally created pseudo-measurements or to use predened and internally created pseudo - mea-
surements, the user may specify a default power rating (SnomPseudo) and a default accuracy class
(accuracy Pseudo). These default values are used for all automatically created internal pseudo-
measurements.
40.5.4 Advanced Setup Options for Bad Data Detection
Recall that the state estimator loops Observability Analysis and State Estimation as long as no further
bad measurement is found (see Figure 40.3.1). The following settings allow the user to control the
number of iterations performed by the loop.
Maximum number of measurements to eliminate
The variable iBadMeasLimit species an upper limit on the number of bad measurements that will be
eliminated in the course of the State Estimation.
Tolerance factors for bad measurement elimination
A measurement is declared to be bad, if the deviation of measured against calculated value exceeds
the measurements accuracy, i.e., if
calcV al meaV al
rating
accuracy
100
(40.2)
where calVal and meaVal are the calculated value and the measured value, respectively. The user
DIgSILENT PowerFactory 15, User Manual 911
CHAPTER 40. STATE ESTIMATION
may modify this denition by adjusting tolerance factors for bad measurements. More precisely, a mea-
surement is declared to be bad, if the left-hand side in equation (40.2) exceeds facErr accuracy/100.
Here facErr > 0 is a factor which can be specied by the user for each group of measurements
individually. Use the factors facErrP, facErrQ, facErrV, facErrIMagn, facErrIAct, and
facErrIReact for P-, Q-, V-measurements, and the three types of the I-measurements (magnitude
measure, active current measure, reactive current measure).
40.5.5 Advanced Setup Options for Iteration Control
Initialization
The non-linear optimization requires an initialization step to generate an initial starting conguration.
Initialization of non-linear optimization
The user may specify whether the initialization shall be performed by a load ow calculation or by some
at start. If it is known in advance that the nal solution of the optimization part is close to a valid load
ow solution, initializing by a load ow calculation pays off in a faster convergence.
Load Flow
Species the settings of the load ow command which is taken for initialization in case no at start is
used.
Stopping criteria for the non-linear optimization
The non-linear optimization is implemented using an iterative Newton-Lagrange method. Recall that
the goal of the optimization is to minimize the objective function f (i.e., the square sum of the weighted
measurements deviations) under the constraint that all load ow equations are fullled. Mathematically
speaking, the aim is to nd
min f(x) (40.3)
under the constraint that
g(x) = 0 (40.4)
where g is the set of load ow equations that need to be fullled. By the Lagrange-Newton method, we
thus try to minimize the resulting Lagrange function
L(x,
) = f(x) +
T
g(x) (40.5)
with the Lagrange multipliers
.
The following parameters can be used to adapt the stopping criteria for this iterative process. The
algorithm stops successfully if the following three issues are fullled:
a) The maximum number of iterations has not yet been reached.
b) All load ow constraint equations g(x) = 0 are fullled to a predened degree of exactness, which
means:
912 DIgSILENT PowerFactory 15, User Manual
40.6. RESULTS
(a) all nodal equations are fullled.
(b) all model equations are fullled.
c) The Lagrange function L(x,
mea
e:cMeaVal: measured value (including multiplier)
e:Xcal: calculated value
e:Xdif: deviation in % (based on given rating as reference value)
e:Xdif mea: deviation in % (based on the measured value as reference value)
e:Xdif abs: absolute deviation in the measurements unit
Here X is a placeholder for P, Q, or U in the case of a P-, Q-, or V-measurement.
Recall that a StaExtimea plays a special role, since a current measurement may serve as up to three
measurements (for magnitude, for active current, and/or for reactive current). Hence, a current mea-
surement has the above listed variables (with X being replaced by I) for each of the three measurement
types. In order to distinguish between the three types, for a StaExtimea, the variables carry the sufxes
Magn (for magnitude measurement), Act (for active current measurement), and React (for reactive
current measurement).
914 DIgSILENT PowerFactory 15, User Manual
40.6. RESULTS
Figure 40.6.2: For description page for external measurements (StaExtvmea, StaExtqmea,
StaExtvmea).
Error Status
All measurements (StaExt*meas) which possibly participate in the Plausibility Checks, the Observ-
ability Analysis, or the State Estimation provide a detailed error description page (see gures 40.6.2
and 40.6.3) with the following information:
General Errors:
Is unneeded pseudo-measurement (e:errUnneededPseudo)
Its input status disallows calculation, i.e., input status does not allow Read or is already
marked as Wrong Measurement (e:errStatus)
Measurement is out of service (e:errOutOfService)
Plausibility Check Errors:
Fails test: Consistent active power ow direction at each side of branch (e:errConsDir)
Fails test: Large branch losses
(e:errExcNomLoss)
Fails test: Negative losses on passive branches
(e:errNegLoss)
Fails test: Large branch ows on open ended branches
(e:errFlwIfOpn)
Fails test: Branch loadings exceed nominal values
(e:errExcNomLoading)
Fails test: Node sum check for P (e:errNdSumP)
Fails test: Node sum check for Q (e:errNdSumQ)
Observability Analysis Errors:
DIgSILENT PowerFactory 15, User Manual 915
CHAPTER 40. STATE ESTIMATION
Measurement is considered to be redundant for observability of the network, i.e., observ-
ability is already guaranteed even without this measurement. Nevertheless redundant mea-
surements are used in the non-linear optimization since, in general, they help to improve the
result (e:errRedundant).
For redundant measurements, also the redundancy level is indicated on this page (e:RedundanceLevel).
The higher the redundancy level, the more measurements with a similar information content
for the observability analysis exist.
State Estimation Errors:
Measurement is detected to be bad, has been removed and was not considered in last non-
linear optimization loop (e:errBadData)
This detailed error description is encoded in the single parameter e:error that can be found on the
top of the error status page. Again, we have the convention that, for a StaExtimea, the variables
e:errRedundant, e:RedundanceLevel and e:errBadData carry the sufxes Magn (for magnitude
measurement), Act (for active current measurement), and React (for reactive current measurement).
40.6.3 Estimated States
Which states participated as control variables?
Recall that depending on the selected treatment of unobservable regions not all states that were
selected for estimation (see Section 40.4.3: Editing the Element Data) will necessarily be estimated by
the algorithm: In case of non-observability, it may happen that some control variables need to be reset.
To access the information which states were actually used as control variables, PowerFactory provides
a ag for each possible state. These ags are called c:iP,Q,Scale,TapSetp for P-, Q-, Scaling
factor-, and Tap-states, respectively. They can be accessed through the Flexible Data Page as Load
Flow calculation parameters for the following elements: ElmLod, ElmAsm, ElmSym, ElmSvs, ElmTr2,
and ElmTr3.
Observability of individual state
The Observability Analysis identies, for each state, whether it is observable or not. Moreover, if
the network is unobservable, it subdivides all unobservable states into equivalence-classes. Each
equivalence-class has the property that it is observable as a whole group, even though its members
(i.e., the single states) cannot be observed. The equivalence classes are enumerated in ascending
order 1, 2, 3, . . . .
916 DIgSILENT PowerFactory 15, User Manual
40.6. RESULTS
Figure 40.6.3: Detailed error description page for external current measurements (StaExtimea).
For this purpose, the Observability Analysis uses the ags c:iP, Q, Scale, Tap obsFlg for P-,
Q-, Scaling factor-, and Tap-states, respectively. These parameters exist for all elements which carry
possible states (ElmLod, ElmAsm, ElmSym, ElmSvs, ElmTr2, ElmTr3). The semantics is as follows:
a value of -2 means that the correspond state is not estimated at all.
a value of -1 means that the correspond state is unsupplied.
a value of 0 means that the corresponding state is observable.
a value of i > 0 means that the correspond state belongs to equivalence-class i.
40.6.4 Colour Representation
In addition, PowerFactory provides a special colouring mode State Estimation for the single line dia-
gram which takes into account the individual measurement error statuses and the states to be estimated
(see Figure 40.6.4). The colouring can be accessed by clicking the icon on the task bar.
The colour representation paints the location of measurements (of a specic type) and the location of
states (of a specic type) simultaneously.
DIgSILENT PowerFactory 15, User Manual 917
CHAPTER 40. STATE ESTIMATION
Figure 40.6.4: Colouring of measurement error statuses and estimated states.
Estimated States
The user selects to colour states of a specic type (P-, Q-, Scaling factor-, or Tap position-states). Dis-
tinct colours for observable, unobservable, non-estimated states, and states with unclear observability
status can be chosen.
External Measurement Locations
The user selects to colour measurements of a specic type (P-, Q-, V-, or I-measurements). Distinct
colours for valid, redundant and invalid measurements can be chosen. A measurement is said to be
valid if its error code (e:error) equals 0.
Besides, measurements with a specic error code can be highlighted separately using an extra colour.
To select such a specic error code press the Error Code button and choose from the detailed error
description list any AND-combination of possible errors.
918 DIgSILENT PowerFactory 15, User Manual
Part V
Appendix
Appendix A
Glossary
Appliance
A specic physical, installed, power system component: a specic generator, transformer, busbar, etc.
Example: a piece of NKBA 0.6/1kV 4 x 35sm cable, 12.4 meters long.
Base Case
A Base Case is considered to be the basic power system design, from which one or more alternative
designs may be created and analyzed. When working with system stages, the Base Case is considered
to be the highest level in a tree of hierarchical system stage designs.
Block Denition
A block denition is a mathematical model which may be used in other block denitions or in a composite
model. Examples are all default controllers (i.e. VCOs, PSSs, MDMs), and all additional user-dened
DSL models. A block denition is called primitive when it is directly written in DSL, or complex when
it is build from other block denitions, by drawing a block diagram.
Block Diagram
A block diagram is a graphical representation of a DSL model, i.e. a voltage controller, a motor driven
machine model or a water turbine model. Block diagrams combine DSL primitive elements and block
denitions created by drawing other block diagram. The block models thus created may (again) be used
in other block diagrams or to create a Composite Frame. See also: DSL primitive, Composite Frame
Branch Elements
A one port element connected to a node, such as a load or a machine. See also nodes, edge elements.
Busbars
Busbars are particular representations of nodes. Busbars are housed in a Station folder and several
busbars may be part of a station.
Class
A class is a template for an element, type or other kind of objects like controller block diagrams, object
lters, calculation settings, etc. Examples:
The TypLne class is the type model for all lines and cables
The ElmLne class is an element model for a specic line or cable
The ComLdf class is a load-ow command
DIgSILENT PowerFactory 15, User Manual 921
APPENDIX A. GLOSSARY
The EvtSwitch class is an event for a switch to open or close during simulation
Composite Frame
A composite frame is a special block diagram which denes a new stand-alone model, mostly without
in- or outputs. A composite frame is principally a circuit in which one or more slots are connected to
each other.
A composite frame is used to create composite models by lling the slots with appropriate objects. The
composite frame thus acts as template for a specic kind of composite models.
See also: Block Diagram, Slot
Composite Model
A composite model is a specic combination of mathematical models.These models may be power
system elements such as synchronous generators, or block denitions, such as voltage controllers,
primary mover models or power system stabilizers.
Composite models may be used to create new objects, such as protection devices, to dress-up power
system elements such as synchronous machines with controllers, prime movers models, etc., or for the
identication of model parameters on the basis of measurements.
Cubicle
A cubicle is the connection point between a edge or branch element and a node (represented by a
busbar or terminal). It may be visualized as a bay in a switch yard or a panel in a switchgear board.
Elements such as CTs, protection equipment, breakers and so forth, are housed in the cubicle, as one
would expect to nd in reality.
DAQ
Abbreviation for Data Acquisition.
Device
A certain kind of physical power systemcomponents: certain synchronous machines, two-winding trans-
formers, busbars, or other kinds of equipment. Example: a NKBA 0.6/1kV 4 x 35sm cable.
DGS
Abbreviation for DIgSILENT Interface for Geographical Informations Systems.
DOLE
Abbreviation for DIgSILENT Object Language for Data Exchange. DOLE was used in previous Pow-
erFactory versions, but replaced by DGS meanwhile. Now, use DGS instead, please.
The DOLE import uses a header line with the parameter name. This header must have the following
structure:
The rst header must be the class name of the listed objects.
The following headers must state a correct parameter name.
DPL
Abbreviation for DIgSILENT Programming Language. For further information, please refer to Chap-
ter 19 (The DIgSILENT Programming Language - DPL).
Drag & Drop
922 DIgSILENT PowerFactory 15, User Manual
Drag&Drop is a method for moving an object by left clicking it and subsequently moving the mouse
while holding the mouse button down (dragging). Releasing the mouse button when the new location
is reached is called dropping. This will move the object to the new location.
DSL
Abbreviation for DIgSILENT Simulation Language. For further information, please refer to Chap-
ter 25.12 (The DIgSILENT Simulation Language (DSL)).
DSL primitive
A DSL primitive is the same as a primitive block denition. A DSL primitive is written directly in DSL
without the use of a block diagram.
Examples are PID controllers, time lags, simple signal lters, integrators, limiters, etc. DSL primitives
are normally used to build more complex block denitions.
See also: Block Denition, Block Diagram
Edge Elements
The elements between two nodes. May also be termed two port element. Source, topological studies;
picture a 3 dimensional box, the corners of the box would be called the nodes, and the edges between
corners are hence edges. See also nodes, branch elements.
Element
A mathematical model for specic appliances. Most element models only hold the appliance-specic
data while the more general type-specic data comes from a type-reference. Example: a model of a
piece of NKBA 0.6/1kV 4 x 35sm cable, 12.4 meters long, named FC 1023.ElmLne.
Graphics Board Window
The graphics board window is a multi document window which contains one or more graphical pages.
These pages may be single line graphics, virtual instrument pages, block diagrams etc.
The graphics board shows page tabs when more than one page is present. These tabs may be used to
change the visible page or to change the page order by drag&drop on the page tab.
See also: Virtual Instrument, Block Diagram, Page Tab, Drag&Drop
Grid
A Grid is a collection of power system elements which are all stored in one so-called Grid Folder in
the database. Normally, a grid forms a logical part of a power system design, like a the MV distribution
system in a province, or the HV transport system in a state.
Object
An object is a specic item stored in the database. Examples are specic type or element models which
have been edited to model specic devices or appliances. Examples: the element FC 1023.ElmLne,
the type NKBA 4x35.TypLne, the load-ow command 3Phase.ComLdf
Node
The mathematical or generic description for what are commonly known as busbars in the electrical
world. In PowerFactory nodes may be represented by Busbars or Terminals of various kinds. These
are treated in the same manner in mathematical terms but treated slightly differently in the database.
As far as possible the user should use terminals as Busbars can be somewhat inexible. See also
Busbars, Edge Elements, Branch Elements.
Operation Scenario
DIgSILENT PowerFactory 15, User Manual 923
APPENDIX A. GLOSSARY
An Operation Scenario denes a certain operation point of the system under analysis, such as dif-
ferent generation dispatch, low or high load, etc.Operation Scenarios are stored inside the Operation
Scenarios folder.
Page Tab
Page tabs are small indexes at the edge (mostly on the top or bottom) of a multi-page window. The tabs
show the titles of the pages. Left-clicking the page tab opens the corresponding page. Page tabs are
used in object dialogues, which often have different pages for different calculation functions, and in the
Graphics Board Window, when more than one graphical page is present.
Project
All power system denitions and calculations are stored and activated in a project. The project folder
therefore is a basic folder in the users database tree. All grids that make out the power system design,
with all design variants, study cases, commands, results, etc. are stored together in a single project
folder.
Result Object
A result object keeps one or more lists of parameters which are to be monitored during a calculation.
Results objects are used for building calculation result reports and for dening a virtual instrument.
See also: Virtual Instrument
Slot
A slot is a place-holder for a block denition in a composite frame. A composite model is created from
a composite frame by lling one or more slots with an appropriate object.
See also: Block Denition, Composite Frame.
Study Case
A study case is a folder which stores a list of references or shortcuts to grid or system stage folders.
These folders are (de)activated when the calculation case folder is (de)activated.
Elements in the grid folders that are referenced by the study case form the calculation target for all
calculation functions. Elements in all other, non-active, grid folders are not considered for calculation.
Besides the list of active folders, the calculation case also stores all calculations commands, results,
events, and other objects which are, or have been, used to analyze the active power system.
See also: Grid, System Stage
System Stage
A system stage is an alternative design or variation for a particular grid. A system stage is stored in
a system stage folder, which keeps track of all differences from the design in the higher hierarchical
level. The highest level is formed by the base grid folder. It is possible to have system stages of system
stages.
See also: Grid, Base Case
Type
A mathematical model for devices: general models for two-winding transformers, two-winding trans-
formers, busbars, etc. A type model only contains the non-specic data valid for whole groups of power
system elements. Example: a NKBA 0.6/1kV 4 x 35sm cable type, named NKBA 4x35.TypLne
See also: System Stage, Grid
924 DIgSILENT PowerFactory 15, User Manual
Variation
A Variation denes an expansion plan composed of one or more expansion stages, and which are
chronologically activated. Variations, like all other network data, are stored inside the Network Data
folder.
Virtual Instrument
A virtual instrument is a graphical representation of calculation results. It may be a line or bar graph, a
gauge, a vector diagram, etc. A virtual instrument gets its values from a result object.
See also: Result Object.
Virtual Instrument Panel
Virtual instrument panels are one of the possible types of pages in a graphics board window. Virtual
instrument panels are used to create and show virtual instruments. Each virtual instrument panel may
contain one or more virtual instruments.
See also: Graphics Board Window, Virtual Instrument
DIgSILENT PowerFactory 15, User Manual 925
APPENDIX A. GLOSSARY
926 DIgSILENT PowerFactory 15, User Manual
Appendix B
Hotkeys Reference
B.1 Calculation Hotkeys
Combination Description
F10 Perform Load Flow calculation
F11 Perform Short-Circuit calculation
Ctrl + F10 Edit Load Flow calculation options
Ctrl + F11 Edit Short-Circuit calculation options
F12 Reset Calculation
Table B.1.1: Calculation Hotkeys
B.2 Graphic Windows Hotkeys
Combination Where/When Description
Ctrl + -
Single Line Graphic,
Block Diagrams, Vis
Zoom out
Ctrl + +
Single Line Graphic,
Block Diagrams, Vis
Zoom in
Ctrl + Scrollen
Single Line Graphic,
Block Diagrams, Vis
Zoom in/out
Ctrl + Double-
click
Busbar system
Open detailed graphic of
substation
Press Mouse
Scroll Wheel +
Moving
Single Line Graphic,
Block Diagrams, Vis
Panning, Moving the visi-
ble part of the graphic
Alt + Rubberband
Only textboxes inside the
rubber band are marked,
no parent objects
Alt + Left-click Textbox
Textbox und Parent-
Object are marked
Alt + Left-click
(multiple times)
Element
All the connected ele-
ments will be marked
DIgSILENT PowerFactory 15, User Manual 927
APPENDIX B. HOTKEYS REFERENCE
Combination Where/When Description
Ctrl + A All elements are marked
Ctrl + Alt + Shift +
P
Element Dialogue
Save a screenshot of
the complete moni-
tor as bitmap under
C:\Digsi\snapshots
Ctrl + Alt + Mov-
ing
Marked Object
Single Objects from a
Busbar system can be
moved
Ctrl + Alt + Mov-
ing
Marked Busbar
Single objects from a
Busbar System can be in-
creased or reduced (size)
Ctrl + Alt + Mov-
ing
Block
The stub length of blocks
in block diagrams remains
when shifting
Ctrl + Alt + Mov-
ing
Marked Terminal
Line-Routes will move to
the terminal, instead of
terminal to the line
Ctrl + Alt + Mov-
ing
Marked Node
Symbol of the connected
branch element will not be
centred
Ctrl + C Marked Element
Ctrl + L
Single Line Graphic,
Block Diagrams
Will open the Dene
Layer dialogue to create
a new layer
Ctrl +Left-click Element
Multiselect elements,
all clicked elements are
marked
Ctrl + Left-click
Inserting
Loads/Generators
Rotate element 90
Ctrl + Left-click
Inserting Bus-
bars/Terminals
Rotate element 180
.
Arguments:
int iside (obligatory) :
-1: For ElmTr2/ElmTr2n: default value,
For ElmTr3: default value, will return '1'if transformer has phase shift angle not equal to 0 modulo 180
at side HV.
1: For ElmTr3: will return '1'if transformer's phase shift angle is not equal to 0 modulo 180
at side MV.
2: For ElmTr3: will return '1'if transformer's phase shift angle is not equal to 0 modulo 180
at side LV.
Return value:
'1'if quadbooster, else '0'
DIgSILENT PowerFactory 15, User Manual 1207
APPENDIX D. DPL REFERENCE
Example:
set objsTr2, objsTr3;
object obj;
int isQB;
objsTr2 = AllRelevant('
*
.ElmTr2');
objsTr3 = AllRelevant('
*
.ElmTr3');
printf('This is a list of QB in the network:');
for (obj = objsTr2.First(); obj; obj = objsTr2.Next()){
{
isQB = obj.IsQuadBooster();
if(isQB=1)
{
obj.ShowFullName();
}
}
isQB = obj.IsQuadBooster(0);
if(isQB=1)
{
obj.ShowFullName();
printf('at side HV');
}
isQB = obj.IsQuadBooster(1);
if(isQB=1)
{
obj.ShowFullName();
printf('at side MV');
}
isQB = obj.IsQuadBooster(2);
if(isQB=1)
{
obj.ShowFullName();
printf('at side LV');
}
}
D.8.17 Zone (ElmZone)
GetAll Returns all objects in this zone.
GetBuses Returns all buses in this zone.
GetNodes Returns all nodes in this zone.
GetBranches Returns all branches and buses in this zone.
GetObjs Returns all objects of the given class in this zone.
D.8.17.1 ElmZone.GetAll
set ElmZone.GetAll ()
Returns all objects which belong to this zone.
Arguments:
none
1208 DIgSILENT PowerFactory 15, User Manual
D.8. ELEMENTS
Return value:
The set of objects
Example:
set aAll,aZones;
object pPrj,pZone,pObj;
! output elements in the zone
pPrj = GetActiveProject();
if (pPrj) {
aZones = pPrj.GetContents('
*
.ElmZone',1);
aZones.SortToVar(0,'loc name');
for (pZone=aZones.First(); pZone; pZone=aZones.Next()) {
printf('Elements in zone %s',pZone:loc name);
aAll = pZone.GetAll();
for (pObj=aAll.First(); pObj; pObj=aAll.Next()) {
printf('%s\\
%s',pObj:r:fold id:loc name,pObj:loc name);
}
}
}
D.8.17.2 ElmZone.GetBuses
set ElmZone.GetBuses ()
Returns all buses which belong to this zone.
Arguments:
none
Return value:
The set of objects
D.8.17.3 ElmZone.GetNodes
set ElmZone.GetNodes ()
Returns all nodes which belong to this zone.
Arguments:
none
Return value:
The set of objects
Example:
set aAll,aZones;
object pPrj,pZone,pObj;
! output elements in the zone
pPrj = GetActiveProject();
if (pPrj) {
DIgSILENT PowerFactory 15, User Manual 1209
APPENDIX D. DPL REFERENCE
aZones = pPrj.GetContents('
*
.ElmZone',1);
aZones.SortToVar(0,'loc name');
for (pZone=aZones.First(); pZone; pZone=aZones.Next()) {
printf('Nodes in zone %s',pZone:loc name);
aAll = pZone.GetBuses();
for (pObj=aAll.First(); pObj; pObj=aAll.Next()) {
printf('%s\\%s',pObj:r:fold id:loc name,pObj:loc name);
}
}
}
D.8.17.4 ElmZone.GetBranches
set ElmZone.GetBranches ()
Returns all branches which belong to this zone.
Arguments:
none
Return value:
The set of objects
Example:
set aAll,aZones;
object pPrj,pZone,pObj;
! output elements in the zone
pPrj = GetActiveProject();
if (pPrj) {
aZones = pPrj.GetContents('
*
.ElmZone',1);
aZones.SortToVar(0,'loc name');
for (pZone=aZones.First(); pZone; pZone=aZones.Next()) {
printf('Branches in zone %s',pZone:loc name);
aAll = pZone.GetBranches();
for (pObj=aAll.First(); pObj; pObj=aAll.Next()) {
printf('%s\\%s',pObj:r:fold id:loc name,pObj:loc name);
}
}
}
D.8.17.5 ElmZone.GetObjs
set ElmZone.GetObjs (string classname)
Returns all objects of the given class which belong to this zone.
Arguments:
string classname (obligatory) : name of the class.
Return value:
The set of objects
Example:
1210 DIgSILENT PowerFactory 15, User Manual
D.8. ELEMENTS
set aAll,aZones;
object pPrj,pZone,pObj;
! output cubicles in the zone
pPrj = GetActiveProject();
if (pPrj) {
aZones = pPrj.GetContents('
*
.ElmZone',1);
aZones.SortToVar(0,'loc name');
for (pZone=aZones.First(); pZone; pZone=aZones.Next()) {
printf('Cubicles in zone %s',pZone:loc name);
aAll = pZone.GetObjs('StaCubic');
for (pObj=aAll.First(); pObj; pObj=aAll.Next()) {
printf('%s\\%s',pObj:r:fold id:loc name,pObj:loc name);
}
}
}
D.8.18 Switch (StaSwitch)
Close Closes the switch.
Open Opens the switch.
IsOpen Checks if the switch is open.
IsClosed Checks if the switch is closed.
D.8.18.1 StaSwitch.Close
int StaSwitch.Close ()
Closes the switch.
Arguments:
none
Return value:
0 on success
Example:
The following example gathers all open switches before closing them.
int opn;
set S, So;
object O;
S = Switches.AllElm();
O = S.First();
while (O) {
opn = O.IsOpen();
if (opn) {
O.Close();
So.Add(O);
};
}
DIgSILENT PowerFactory 15, User Manual 1211
APPENDIX D. DPL REFERENCE
D.8.18.2 StaSwitch.Open
int StaSwitch.Open ()
Opens the switch.
Arguments:
none
Return value:
0 on success
Example:
The following example gathers all closed switches before opening them.
int cl;
set S, Sc;
object O;
S = Couplers.AllElm();
O = S.First();
while (O) {
cl = O.IsClosed();
if (opn) {
O.Open();
Sc.Add(O);
};
}
D.8.18.3 StaSwitch.IsOpen
int StaSwitch.IsOpen ()
Checks if the switch is open.
Arguments:
none
Return value:
1 when open, 0 when closed
Example:
See StaSwitch.Close D.8.18.2 for an example.
D.8.18.4 StaSwitch.IsClosed
int StaSwitch.IsClosed ()
Checks if the switch is closed.
Arguments:
none
1212 DIgSILENT PowerFactory 15, User Manual
D.9. TYPES
Return value:
1 when closed, 0 when open
Example:
See StaSwitch.Open D.8.18.1 for an example.
D.8.19 Bay (ElmBay)
D.8.19.1 ElmBay.Disconnect
set ElmBay.GetAll ()
This function gets all switches referencing the bay the function is called on.
Arguments:
none
Return value:
Set containing all switches (ElmCoup) referencing the bay
Example:
set sRet;
object oSwitch;
object oBay;
sRet = oBay.GetAll();
for (oSwitch=sRet.First(); oSwitch; oSwitch=sRet.Next()) {
oSwitch.ShowFullName();
}
D.9 Types
Some object methods are specic for a type of object class. The general syntax for an object method is
the same as that used for a set method:
object . [OBJMETHOD] (arguments) ;
For Feeder Methods please refer to Section D.6.3 Feeder (SetFeeder) Methods.
For Path Methods please refer to Section D.6.4 Path (SetPath) Methods.
D.9.1 Induction Machine Type (TypAsm)
D.9.1.1 TypAsm.Disconnect
int TypAsm.CalcElParams ()
Calculates the electrical parameters from the input data.
DIgSILENT PowerFactory 15, User Manual 1213
APPENDIX D. DPL REFERENCE
Arguments:
none
D.9.2 Induction Machine Type (TypAsmo)
D.9.2.1 TypAsmo.CalcElParams
int TypAsmo.CalcElParams ()
Calculates the electrical parameters from the input data.
Arguments:
none
D.9.3 Line Type (TypLne)
IsCable Checks if the line type is a cable type.
SetNomCurr Sets the nominal current of the line type.
D.9.3.1 TypLne.IsCable
int TypLne.IsCable ()
Checks if the line type is a cable type.
Arguments:
none
Return value:
1 when the line type is a cable type, otherwise 0.
Example:
The following example reports all cable types.
set S;
object O;
int i;
S = AllRelevant();
O = S.Firstmatch('TypLne');
while (O) {
i = O.IsCable();
if (i) O.ShowFullName();
O = S.Nextmatch();
}
D.9.3.2 TypLne.SetNomCurr
int TypLne.SetNomCurr ()
1214 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
Sets the nominal current of the line type, according to IEC364-5-523.
Arguments:
none
Return value:
0 on success, 1 on error.
Example:
The following example sets the correction factor.
BuriedLineType.SetNomCurr();
D.10 Additional Objects (Int*)
D.10.1 IntEvt Methods
D.10.1.1 IntEvt.CreateCBEvents
void IntEvt.CreateCBEvents ([int iRemoveExisting])
Creates switch events for the boundary circuit breakers.
Arguments:
int iRemoveExisting (optional):
-1: Query user if circuit breaker events exist.
0: Do not create circuit breaker events if circuit breaker events are already dened events exist (default)
1: Remove existing circuit breaker events.
Return value:
none
D.10.2 IntForm Methods
SetText Sets the format text.
WriteOut Write the report to the output window.
D.10.2.1 IntForm.SetText
int IntForm.SetText (string Text)
Sets the format text of a report form.
Arguments:
string Text (obligatory) : The format text string
Return value:
DIgSILENT PowerFactory 15, User Manual 1215
APPENDIX D. DPL REFERENCE
0 on success
Example:
The following example sets a format string and writes the report for two sets
set SLines,SLoads;
... fill SLines and SLoads ...
OvlReport.SetText('
| Loading of lines: |$H
$LOOP, EXTERNAL
|# #.# |$N,loc name,loading
$END ');
OvlReport.WriteOut(SLines, SLoads);
See also IntForm.WriteOut
D.10.2.2 IntForm.WriteOut
int IntForm.WriteOut (set ListSet [, set PoolSet, int Landscape])
Write the report to the output window.
The report form object will write a report to the output window, based on the format text, for the objects
in the ListSet and the PoolSet. The ListSet is used in the EXTERNAL macro. All format lines between
the $LOOP, EXTERNAL and the $END macro's will be written for each object in the Listset, which is
therefore called the 'sequential set'. In the format text itself, objects from the PoolSet may be referenced
directly by the ACC(x) macro, which is replaced by the x'th object in the PoolSet. The PoolSet is
therefore called the 'random access set'. The ListSet or PoolSet may be empty.
The command object that is normally reached by the macro DEF in report forms will always return
the main DPL command that is running at the moment, even when the 'WriteOut'call is made in a DPL
subscript.
Arguments:
set ListSet (obligatory) : The sequential set of objects
set PoolSet (optional) : The random access set of objects
int Landscape (optional) : Sets the page orientation used to calculate the number of lines tting on a
printed page
0 = Portrait, 1 = Landscape; default: Landscape
Return value:
0 on success
Example:
The following example reports the loading of a list of objects for a certain load condition. The objects
for the loading are sequentially listed. The load conditions are reported for a special set of loads, which
are given as a pool of objects.
set SLines,SLoads;
... fill SLines and SLoads ...
OvlReport.WriteOut(SLines, SLoads);
If OvlReport has the following format string:
1216 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
---------------------$H,
| command : # |$H,DEF:loc name
| Load settings: |$H| # #.# |$H,ACC(2):loc name,ACC(2):plini
| # #.# |$H,ACC(3):loc name,ACC(3):plini
---------------------$H,
| Loading of lines: |$H
$LOOP, EXTERNAL
| # #.# |$N,loc name,loading
$END
---------------------$F,
the following report could be the result:
---------------------|
command : FindWL |
| Load settings: |
| Ld12a 3.43 |
| Ld14b 2.52 |
---------------------
| Loading of lines: |
| Ln1 95.6 |
| Ln2 92.1 |
| Ln3 90.4 |
| Ln4 85.3 |
| Ln5 84.7 |
| Ln6 84.2 |
| Ln7 82.6 |
| Ln8 62.5 |
---------------------
See also IntForm.SetText D.10.2.1
D.10.3 IntMat Methods
Note: Data are only stored permanently in an IntMat object, if another attribute of this object (e.g. the
name) is also changed.
ColLbl Sets the label of the C'th column.
Get Returns the (row, col) value.
Init Initializes the matrix.
Invert Inverts a matrix.
Multiply Multiplies two matrixes and stores the result in the matrix.
NCol Returns the number of columns in the matrix.
NRow Returns the number of rows in the matrix.
Resize Resizes the matrix.
RowLbl Sets the label of the R'th row.
Set Set the value at position (row,col).
SortToColumn Sort the matrix alphanumerically according to a column.
D.10.3.1 IntMat.ColLbl
string IntMat.ColLbl ([string S,] int C)
Sets or reads the label of the C'th column.
DIgSILENT PowerFactory 15, User Manual 1217
APPENDIX D. DPL REFERENCE
Arguments:
string S (optional) : Label to set
int C (obligatory) : Number of the column index (rst column has index 1)
Return value:
Assigned or read column label
Example:
The following example labels some columns.
Mat.ColLbl('transformers',1);
Mat.ColLbl('lines',2);
Mat.ColLbl('busbars',3);
The following example assigns the label of the rst column to the string aLabel
string aLabel;
aLabel = Mat.ColLbl(1);
D.10.3.2 IntMat.Get
double IntMat.Get (int row, int col)
Returns the (row, col) value from the matrix. An run-time error will occur when 'row'or 'col'are out of
range.
Arguments:
int row (obligatory) : row in matrix: 1..NRow()
int col (obligatory) : column in matrix: 1..NCol()
Return value:
Value in matrix.
Example:
The following example multiplies two matrices
int r,c,z,s,s1r,s2c;
double v1,v2,v;
s = M1.NCol();
r = M2.NRow();
if (s<>r) exit();
s1r = M1.NRow();
s2c = M2.NCol();
M3.Init(s1r,s2c);
r=1;
while (r<=s1r) {
c=1;
while (c<=s2c) {
z=1; v=0.0;
while (z<=s) {
v1=M1.Get(r,z);
v2=M2.Get(z,c);
1218 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
v+=v1
*
v2;
z+=1;
}
M3.Set(r,c,v);
c+=1;
}
r+=1;
}
D.10.3.3 IntMat.Init
int IntMat.Init (int NRows, int NCols [, double dInit])
Initializes the matrix with given size and values, regardless of the previous size and data.
Arguments:
int NRows (obligatory): number of rows
int NCols (obligatory): number of columns
double dInit (optional): All elds of the matrix will be initialised with this value. Matrix is initialized with
zero values if ommited.
Return value:
1: always
Example:
See IntMat.Get D.10.3.2 for an example.
D.10.3.4 IntMat.Invert
int IntMat.Invert ()
Inverts a matrix. This operation is performed in memory only and therefore the modied matrix is not
updated in the database.
Arguments:
none
Return value:
0: success, the original matrix will be overwritten by its inversion
1: error, inversion not possible. Original matrix was not changed.
Example:
! for a given matrix 'Matrix.IntMat'
int err;
err = Matrix.Invert();
if (err){
printf('Matrix %o is not invertible', Matrix);
}
else{
DIgSILENT PowerFactory 15, User Manual 1219
APPENDIX D. DPL REFERENCE
printf('Matrix %o successfully inverted', Matrix);
}
D.10.3.5 IntMat.Multiply
int IntMat.Multiply (object A, object B)
Multiplies 2 matrixes and stores the result in the matrix. This operation is performed in memory only
and therefore the modied matrix is not updated in the database.
Arguments:
object A (obligatory): Matrix 1 to be multiplied.
object B (obligatory): Matrix 2 to be multiplied.
Return value:
0: success, the original matrix will be overwritten by the matrix multiplication A * B
1: error, multiplication not possible. Original matrix was not changed.
Example:
! for given matrixes 'mtrx A', 'mtrx B', 'mtrx AB'
int err;
err = mtrx AB.Multiply(mtrx A, mtrx B);
if (err){
printf('Matrix %o and %o could not be multiplied.', mtrx A, mtrx B);
}else{
printf('Matrixes successfully multiplied.');
}
D.10.3.6 IntMat.NCol
int IntMat.NCol ()
Returns the number of columns in the matrix. The function NCol() replaces the obsolete function
SizeY().
Arguments:
none
Return value:
The number of columns
Example:
See IntMat.Get D.10.3.2 for an example.
D.10.3.7 IntMat.NRow
int IntMat.NRow ()
Returns the number of rows in the matrix. The function NRow() replaces the obsolete function SizeX().
1220 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
Arguments:
none
Return value:
The number of rows
Example:
See IntMat.Get D.10.3.2 for an example.
D.10.3.8 IntMat.Resize
int IntMat.Resize (int NRows, int NCols [, double dInit])
Resizes the matrix to a given size. Existing values will not be changed. Added values will be set to the
optional value, otherwise to 0.
Arguments:
int NRows (obligatory) : number of rows
int NCols (obligatory) : number of columns
double dInit (optional) : Value for the initialisation of the additional elds of the matrix. Additional elds
are set to 0 if ommited.
Return value:
1: always
Example:
The following example gets a value from the matrix, possibly resizing it rst.
int Nc,Nr,x,y;
Nr = Mat.NRows();
Nc = Mat.NCols();
x=5;y=3;
if (x>Nr.or.y>Nc) {
Mat.Resize(x,y);
}
v = Mat.Get(x,y);
D.10.3.9 IntMat.RowLbl
IntMat.RowLbl
string IntMat.RowLbl ([string S ,] int R)
Sets or reads the label of the R'th row.
Arguments:
string S (optional) : Label, required to set
int R (obligatory) : Number of the row index (rst row has index 1)
DIgSILENT PowerFactory 15, User Manual 1221
APPENDIX D. DPL REFERENCE
Return value:
Assigned or read row label
Example:
The following example labels some rows.
Mat.RowLbl('overloaded',1);
Mat.RowLbl('overvoltage',2);
Mat.RowLbl('undervoltage',3);
The following example assigns the label of the rst row to the string aLabel
string aLabel;
aLabel = Mat.RowLbl(1);
D.10.3.10 IntMat.Set
int IntMat.Set (int row, int col, double V)
Set the value at position (row,col) in the matrix to V. The matrix is automatically resized if necessary.
Arguments:
int row (obligatory) : row number: 1..NRows()
int col (obligatory) : col number: 1..NCols()
double V (obligatory) : value
Return value:
0 on success
Example:
See IntMat.Get D.10.3.2 for an example.
D.10.3.11 IntMat.SortToColumn
int IntMat.SortToColumn (int ColumnIndex)
Sort the matrix alphanumerically according to a column, which is specied by the input parameter.
Arguments:
int ColumnIndex (obligatory) : The index of the column, which starts from 0.
Return value:
0: success
1: error. Original matrix was not changed.
Example:
! for given matrixes 'mtrx'
int err;
1222 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
int column;
column = 0;
err = mtrx.SortToColumn(column);
if (!err){
printf('Matrixes is sorted according to the column: %d\n.', column);
}
D.10.4 IntMon Methods
PrintVal Prints the values of the selected variables.
PrintAllVal Prints a description for all variables.
NVars Returns the number of selected variables.
GetVar Returns the n'th selected variable name.
RemoveVar De-selects a variable.
ClearVars Clears the selected variable names.
AddVar Selects a variable name.
D.10.4.1 IntMon.PrintVal
void IntMon.PrintVal ()
Prints the values of the selected variables to the output window.
Arguments:
none
Return value:
none
D.10.4.2 IntMon.PrintAllVal
void IntMon.PrintAllVal ()
Prints a description for all available variables to the output window.
Arguments:
none
Return value:
none
D.10.4.3 IntMon.NVars
int IntMon.NVars ()
Returns the number of selected variables or, more exact, the number of lines in the variable selection
text on the second page of the IntMon dialogue, which should contain one variable name per line.
Arguments:
DIgSILENT PowerFactory 15, User Manual 1223
APPENDIX D. DPL REFERENCE
none
Return value:
The number of selected variables.
D.10.4.4 IntMon.GetVar
string IntMon.GetVar (int row)
Returns the variable name on the given row of the variable selection text on the second page of the
IntMon dialogue, which should contain one variable name per line.
Arguments:
int row: Given row
Return value:
The variable name.
D.10.4.5 IntMon.RemoveVar
int IntMon.RemoveVar (string name)
Removes the variable name from the list of selected variable names.
Arguments:
The variable name.
Return value:
1 when the variable name was not found, 0 otherwise.
D.10.4.6 IntMon.ClearVars
int IntMon.ClearVars ()
Clears the list of selected variable names.
Arguments:
none
Return value:
none
D.10.4.7 IntMon.AddVar
int IntMon.AddVar (string name)
Appends the variable name to the list of selected variable names.
Arguments:
1224 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
The variable name.
Return value:
none
D.10.5 IntThrating Methods
GetRating Returns the rating in MW.
GetCrticalTimePhase Returns the smallest time phase for which the ow is be-
yond the rating.
D.10.5.1 IntThrating.GetRating
double IntThrating.GetRating (double Preload, double PostTime)
This function returns the rating in MWaccording to the thermal rating table, the input parameters Preload
and PostTime.
Arguments:
double Preload (obligatory) : Preload in the load ow (for base case or post contingency case, in %.
double PostTime (obligatory) : Post contingency time phase, in s unit.
Return value:
Rating in MW according to the terminal rating table, the input parameters Preload and PostTime.
Example:
double Rating, Preload, PostTime;
IntThrating.GetRating(Rating, Preload, PostTime);
printf('The Rating at Post Contingency time %10.3f s when the preload is %10.3f:
%10.3f'MW', PostTime, Preload, Rating);
D.10.5.2 IntThrating.GetCriticalTimePhase
double IntThrating.GetCriticalTimePhase (double Flow, double PrefaultLoading)
This function returns the smallest time phase for which the ow is beyond the rating. In case that no
rating is violated, the function should return -1.
Arguments:
double Flow(obligatory) : The active power in load ow calculation (base case or post contingency
case), in MW
double PrefaultLoading (obligatory) : The prefault rating, in MW
Return value:
Smallest time phase for which the ow is beyond the rating.
-1: In case that no rating is violated.
DIgSILENT PowerFactory 15, User Manual 1225
APPENDIX D. DPL REFERENCE
Example:
double dtime, dFlow, dPrefaultloading;
dtime = IntThrating.GetCriticalTimePhase(dFlow, dPrefaultloading);
printf('The critical time phase for which the active power %10.3f beyond the
loading (prefault loading %10.3f) is %10.3f', dFlow, dPrefaultloading, dtime);
D.10.6 IntUser Methods
Purge Purges the storage of all projects that need purging.
SetPassword Sets the password for the user the function is called on.
D.10.6.1 IntUser.Purge
void IntUser.Purge ()
Purges the storage of all projects that need purging.
Arguments:
none
Return value:
none
D.10.6.2 IntUser.SetPassword
void IntUser.SetPassword (string newpassword)
Sets the password for the user the function is called on.
Note: A normal user is allowed to set the password for himself only. The administrator user is allowed
to set passwords for every user.
Arguments:
string newPassword (obligatory): User password to set
Return value:
none
Example:
set users, groups;
object user, group, userman, obj;
int i;
string name;
userman = GetUserManager();
!create a new user group
group = userman.CreateGroup('Users');
printf('Group %o created.', group);
1226 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
!create users
for (i = 1; i <= 5; i+= 1){
name = sprintf('User%d', i);
user = userman.CreateUser(name);
!set password to user name (case sensitive!)
user.SetPassword(name);
printf('User %o created.', user);
!add user to newly created group
obj = group.CreateObject('IntRef');
obj:obj id = user;
}
D.10.7 IntUserman Methods
GetGroups Provides access to all available user groups.
GetUsers Provides access to all available users.
CreateGroup Creates a new user group of given name.
CreateUser Creates a new user of given name.
D.10.7.1 IntUserman.GetGroups
set IntUserman.GetGroups ()
These function provides access to all available user groups.
Note: Only the administrator user is allowed to call this function.
Arguments:
none
Return value:
Set of all available user groups
Example:
set users, groups;
object user, group, userman;
userman = GetUserManager();
!listing of all groups
printf('Existing Groups:');
groups = userman.GetGroups();
for (group = groups.First(); group; group = groups.Next()){
printf('%o', group);
!list users of that group
users = group.GetContents();
for (user = users.First(); user; user = users.Next()){
printf('- %o', user:obj id);
}
}
printf('\n\n');
!listing of all users
printf('Existing Users:');
users = userman.GetUsers();
for (user = users.First(); user; user = users.Next()){
DIgSILENT PowerFactory 15, User Manual 1227
APPENDIX D. DPL REFERENCE
printf('%o', user);
}
D.10.7.2 IntUserman.GetUsers
set IntUserman.GetUsers ()
These function provides access to all available users.
Note: Only the administrator user is allowed to call this function.
Arguments:
none
Return value:
Set of all available users
Example:
set users, groups;
object user, group, userman;
userman = GetUserManager();
!listing of all groups
printf('Existing Groups:');
groups = userman.GetGroups();
for (group = groups.First(); group; group = groups.Next()){
printf('%o', group);
!list users of that group
users = group.GetContents();
for (user = users.First(); user; user = users.Next()){
printf('- %o', user:obj id);
}
}
printf('\n\n');
!listing of all users
printf('Existing Users:');
users = userman.GetUsers();
for (user = users.First(); user; user = users.Next()){
printf('%o', user);
}
D.10.7.3 IntUserman.CreateGroup
object IntUserman.CreateGroup (string name)
Creates a new user group of given name.
There is no group created if a group of that name does already exist. In this case, the existing group is
returned.
Note: Only Administrator user is allowed to call this function.
Arguments:
string name (obligatory): Given name of the user group
Return value:
1228 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
Created user group (IntGroup)
Example:
set users, groups;
object user, group, userman, obj;
int i;
string name;
userman = GetUserManager();
!create a new user group
group = userman.CreateGroup('Users');
printf('Group %o created.', group);
!create users
for (i = 1; i <= 5; i+= 1){
name = sprintf('User%d', i);
user = userman.CreateUser(name);
!set password to user name (case sensitive!)
user.SetPassword(name);
printf('User %o created.', user);
!add user to newly created group
obj = group.CreateObject('IntRef');
obj:obj id = user;
}
D.10.7.4 IntUserman.CreateUser
object IntUserman.CreateUser (string name)
Creates a new user of given name.
There is no user created if a user of that name does already exist. In this case, the existing user is
returned.
Note: Only Administrator user is allowed to call this function.
Arguments:
string name (obligatory): Given name of the user
Return value:
Created user (IntUser)
Example:
set users, groups;
object user, group, userman, obj;
int i;
string name;
userman = GetUserManager();
!create a new user group
group = userman.CreateGroup('Users');
printf('Group %o created.', group);
!create users
for (i = 1; i <= 5; i+= 1){
name = sprintf('User%d', i);
user = userman.CreateUser(name);
!set password to user name (case sensitive!)
DIgSILENT PowerFactory 15, User Manual 1229
APPENDIX D. DPL REFERENCE
user.SetPassword(name);
printf('User %o created.', user);
!add user to newly created group
obj = group.CreateObject('IntRef');
obj:obj id = user;
}
D.10.8 IntVec Methods
Note: Data are only stored permanently in an IntVec object, if another attribute of this object (e.g. the
name) is also changed.
Get Returns the value at index i.
Set Sets the value at index i.
Init Initializes the vector
Resize Resizes the vector.
Size Returns the size of the vector.
D.10.8.1 IntVec.Get
double IntVec.Get (int i)
Returns the value at index i.
Arguments:
int i (obligatory) : Vector index.
Return value:
Value at index i.
Example:
The following example adds two vectors.
int i,j;
double v1,v2;
i = Vec1.Size();
j = Vec2.Size();
if (i<>j) {
output('invalid operation');
exit();
}
Vec3.Init(i);
i=1;
while (i<=j) {
v1 = Vec1.Get(i);
v2 = Vec2.Get(i);
Vec3.Set(i,v1+v2);
i+=1;
}
1230 DIgSILENT PowerFactory 15, User Manual
D.10. ADDITIONAL OBJECTS (INT*)
D.10.8.2 IntVec.Set
void IntVec.Set (int i, double V)
Sets the value at index i to V. Valid indexes are in [1, IntVec.Size()].
Arguments:
int i (obligatory) : Vector index.
double V (obligatory) : The value to set.
Return value:
none
Example:
See IntVec.Get D.10.8.1 for an example.
D.10.8.3 IntVec.Init
void IntVec.Init (int Size)
Initializes the vector. Sets the length to Size and all values to 0.
Arguments:
int Size (obligatory) : The initial size.
Return value:
none
Example:
See IntVec.Get D.10.8.1 for an example.
D.10.8.4 IntVec.Resize
void IntVec.Resize (int Size)
Resizes the vector. Added values are set to 0.0.
Arguments:
none
Return value:
none
Example:
The following example adds a value to a dynamically scaled vector.
int i,s;
i = 5;
s = Vec.Size();
DIgSILENT PowerFactory 15, User Manual 1231
APPENDIX D. DPL REFERENCE
if (i>s) {
Vec.Resize(i);
}
Vec.Set(i,V);
See also
General Functions and Methods
Data Container
D.10.8.5 IntVec.Size
int IntVec.Size ()
Returns the size of the vector.
Arguments:
none
Return value:
The size of the vector
Example:
See IntVec.Get D.10.8.1 for an example.
D.11 DDE Functions
ddeOpen Establishes a DDE connection to a topic of an application.
ddeClose Closes the DDE link.
ddeExe Starts command in the current dde opened topic.
ddePoke Sends data to an item in the currently opened DDE topic.
ddeRequest Receives data from an item in a previously opened DDE
topic.
D.11.0.6 ddeOpen
int ddeOpen(string sPath, string sAppName, string sTopic)
Establishes a DDE connection to a topic of an application.
Arguments:
string sPath (obligatory) :Path to application to start. If empty ('') the application must be started manu-
ally by the user. If path is given, ddeOpen will start the application if it not already running.
string sAppName (obligatory) : Application name.
string sTopic (obligatory) : Topic; The topic of a DDE conversation can be either the name of a open
document or the special topic System. A document can be either a regular document in the application,
a template, or a macro
1232 DIgSILENT PowerFactory 15, User Manual
D.11. DDE FUNCTIONS
Return value:
0 on success, != 0 on errors
Example:
The following example establishes a DDE connection to topic Systemof Excel and closes the connection
if successfully established.
int ierr;
! open a DDE connection to Excel :
ierr = ddeOpen(s, 'Excel', 'System');
if (.not.ierr) {
! ok, excel can be opened.
! ...
ddeClose();
}
See also ddeClose D.11.0.7
D.11.0.7 ddeClose
void ddeClose()
Closes the DDE link.
Arguments:
none
Return value:
none
Example:
The following example establishes a DDE link to topic named 'System'of Excel and closes the connec-
tion if successfully established.
int ierr;
! open a DDE connection to Excel :
ierr = ddeOpen(s, 'Excel', 'System');
if (.not.ierr) {
! ok, excel can be opened.
! ...
ddeClose();
}
See also ddeOpen D.11.0.6
D.11.0.8 ddeExe
int ddeExe (string sCmd)
Starts command in the currently opened topic. A command can be a visual basic command, too.
Commands are usually sent to the topic named 'System'.
DIgSILENT PowerFactory 15, User Manual 1233
APPENDIX D. DPL REFERENCE
Arguments:
string sCmd (obligatory): Command to execute
Return value:
<0 if the dde connection was not established before calling ddeExe, =0 if ddeExe successfully executed,
> 0 if ddeExe failed
Example:
The following example looks for a sheet named 'Sheet1'. A new sheet is created if Sheet1 was not
found. Then the DDE link to the page is established.
int ierr;
ierr = ddeOpen('', 'Excel', 'System');
if (.not.ierr) {
! excel can be opened. Now close and connect to a specific sheet
ddeClose();
ierr = ddeOpen('', 'Excel', 'Sheet1');
if (ierr) {
Info('No Sheet1 yet, creating one...');
ierr = ddeOpen('', 'Excel', 'System');
if (ierr) {
printf('Cannot open DDE to Excel');
} else {
! create a new sheet
ddeExe('[New(1)]');
ddeClose();
ierr = ddeOpen('', 'Excel', 'Sheet1');
}
}
}
if (ierr) {
Error('Could not open DDE connection');
exit();
}
D.11.0.9 ddePoke
int ddePoke (string sItem, string sData)
Sends data to an item in the currently opened DDE topic.
Arguments:
string sItem: the item receiving the data. Examples for an item are a cell in excel or a named bookmark
in word.
string sData: the data to send.
Return value:
<0 if the dde connection was not established before calling ddePoke, =0 if the ddePoke was successfully
executed, >0: if the ddePoke failed.
Example:
1234 DIgSILENT PowerFactory 15, User Manual
D.11. DDE FUNCTIONS
The following example writes data to some cells on the worksheet named 'Sheet1'in Excel. It is assumed
that Excel is already running when starting the dpl command.
int ierr, i;
double x,y,z;
string s,s1,s2;
Warn('This example assumes an English Excel');
Warn('Other languages should translate the Excel commands');
Warn('like concatenate"');
! open a DDE connection to Sheet1 :
ierr = ddeOpen('', 'Excel', 'System');
if (.not.ierr) {
! excel can be opened. Now close and connect to a specific sheet
ddeClose();
ierr = ddeOpen('', 'Excel', 'Sheet1');
if (ierr) {
Info('No Sheet1 yet, creating one...');
ierr = ddeOpen('', 'Excel', 'System');
if (ierr) {
printf('Cannot open DDE to Excel');
} else {
! create a new sheet
ddeExe('[New(1)]');
ddeClose();
ierr = ddeOpen('', 'Excel', 'Sheet1');
}
}
}
if (ierr) {
Error('Could not open DDE connection');
exit();
}
! write some numbers
x = 3;
while (x<7) {
y = 5;
while (y<14) {
z = x+y/100;
s1 = sprintf('R%dC%d',x,y);
s2 = sprintf('%f',z);
ddePoke(s1,s2); ! poke the numbers in the sheet
y+=1;
}
x+=1;
}
See also ddeRequest D.11.0.10
D.11.0.10 ddeRequest
int ddeRequest (string sItem, string sStringData, double dNumVal)
Receives data from an item in a previously opened DDE topic
Arguments:
DIgSILENT PowerFactory 15, User Manual 1235
APPENDIX D. DPL REFERENCE
string sItem: The item. Examples for an item are a cell in excel or a named bookmark in word
string sStringData:The data received from the topic as string (return value=2)
double dNumVal:The data received from the topic as a number (if sStringData is a number, return
value=2)
Return value:
<0 if the dde connection was not established before calling ddeRequest, =0 if the ddeRequest failed,
=1 if value is a number, =2 if value is a string.
Example:
The following is a small code fragment where data is read from an Excel sheet. The code fragment runs
ne, in case that the currently opened DDE topic is an Excel sheet.
i = ddeRequest('R12C2',s,x); ! get the contents of a cel
if (i=1) printf('%f', x); ! i=1 means a number
i = ddeRequest('R5C2',s,x);
if (i=2) printf('%s', s); ! i=2 means a string
See also ddePoke D.11.0.9
1236 DIgSILENT PowerFactory 15, User Manual
Appendix E
The DIgSILENTOutput Language
When more than just the variable name, value and unit has to be displayed, if the use colours is pre-
ferred, or other special formats, the DIgSILENT Output Language can be used.
By selecting the Format Editor input mode, the editor is activated (see Figure E.0.1).
Figure E.0.1: The Form text editor
Almost all textual output that is produced in PowerFactory , is dened by a report form. The use of
report forms range from the simple and small result forms that specify the contents of the single line
result boxes to large and complex forms that are used to print out complete system reports.
In all cases, the text in the editor eld of a IntForm object species the report that is to be generated. For
result boxes, that text is normally created automatically in the IntForm dialogue by selecting Predened
Variables, or any other set of variables, and some extras such as the number of decimals and if an unit
or name should be shown. These options will automatically create a report form. That automatic form
is normally used as it is, but it may be altered manually. This is shown in Figure E.0.1, where report
format is changed such that the variable name of the loading factor is deleted and replaced by the xed
DIgSILENT PowerFactory 15, User Manual 1237
APPENDIX E. THE DIGSILENT OUTPUT LANGUAGE
text ld, because the variable name loading is felt too long compared with the names of the other two
variables (P and Q). The shown format will produce result boxes like
P 12.34 MW
Q 4.84 Mvar
ld 103.56 %
Dening single line result boxes only asks for a basic understanding of the DIgSILENT output language.
For more complex reports, many different variables from all kinds of objects have to be printed as
listings or tables. Such a report would require macro handling, container loops, selection of parameters,
headers, footers, titles, colours, etc. The DIgSILENT output language offers all this, and more.
The basic syntax, which is primary used for dening result boxes is given in the following overview.
Format string, Variable names and text Lines
Placeholders
Variables, Units and Names
Colour
Advanced Syntax Elements
Line Types and Page Breaks
Predened Text Macros
Object Iterations, Loops, Filters and Includes
E.1 Format string, Variable names and text Lines
A standard line consists of three parts (see Figure E.1.1):
1. A format string, containing placeholders, macros and/or user dened text.
2. An end of line character like $N, $E or $F
3. Variable names, separated by commas, which are used to ll in the placeholders.
Figure E.1.1: Basic parts of the report format
The format string is normally much longer.
E.2 Placeholders
A placeholder for strings like variable names or whole numbers is a single #-sign. For real numbers,
the placeholder consists of
a single # for the integer part
a point or comma
one or more #-signs for the fractional part
The number of #-signs after the decimal point/comma denes the number of decimals. The #-sign
itself can be included in user-dened text by typing \#.
1238 DIgSILENT PowerFactory 15, User Manual
E.3. VARIABLES, UNITS AND NAMES
E.3 Variables, Units and Names
The variable name can be used to display the name of the variable, its value or its unit. The possible
formats are (xxx = name of variable):
xxx returns the value
%xxx returns the long variable name, as used in the edit dialogues
&xxx returns the short variable name, as used in the database browser
[xxx returns the unit
xxx the object dependent name of the variable (default name)
%width.precision,xxx
uses special formatting.
The special formatting %width.precision is explained by the following examples:
%.60,TITLE:sub1z outputs TITLE:sub1z 60 column width, left aligned.
@:%1.0,s:nt inserts s:nt as an integer at the placeholders position
%1.3,s:nt writes s:nt with 3 digits precision at the placeholders position
The centring code may be used in front of the formatting code for centring at the placeholder, for
example "|%.60,TITLE:sub1z".
The insertion code is used to switch to insert mode, for example,
|#|$N,:loc name
will output
|aElmSym|.
The cformat string may be used to alternatively reserve place for a value or text. A cformat of %10.3
will reserve 10 characters for a number with 3 decimals. The rst number can be omitted for text: %.6
will reserve 6 characters for the text eld. The cformat syntax allows for centring text by adding the
-sign to the %-sign:
%.10 will reserve 10 characters and will centre the text.
Free, language dependent text can be dened by use of the format
{Ea text;Gein Text}. This will produce a text when the user has selected the English language
(see the user settings dialogue), and ein Text when the language has been chosen to be German.
Special commands for access of Elements
OBJECT(cls)
Gets Element of class cls. Used to access a variable name or unit without actually accessing
such an object. Used in header lines.
argument
cls (obligatory): The name of the class
example:
[OBJECT(ElmTerm):m:Skss
writes the unit of the busbar variable Skss
EDGE
Gets an arbitrary object with at least one connection, i.e. a Load, a Line, etc. Used to access a
variable name or unit without actually accessing such an object.
DIgSILENT PowerFactory 15, User Manual 1239
APPENDIX E. THE DIGSILENT OUTPUT LANGUAGE
example:
%EDGE:m:U1:bus1
writes description of the variable U1
CUBIC(idx)
Returns the cubicle (StaCubic) at bus index idx of branch
argument
idx: index of branch, the currently set bus index is used when idx0
example:
CUBIC(0):e:loc name
returns name of cubicle at busindex 0
TITLE
Gets the title that is set in the output command (ComSh or ComDocu)
example:
TITLE:e:annex
writes annex of title
VARIANT
Gets the active variant in which the current object is stored
example:
VARIANT:e:loc name
writes the name of the variant
NET
Gets the grid in which the current object is stored
example:
NET:e:loc name
writes the name of the grid
CMD
Returns the last calculation command, i.e. a Short-Circuit (ComShc), Load-ow (ComLdf ),...
example:
CMD:pabs
writes the short-circuit position on the line after calculation of a short-circuit.
CASE
Returns the currently active calculation case
example:
CASE:e:loc name
writes the name of the active calculation case
1240 DIgSILENT PowerFactory 15, User Manual
E.4. COLOUR
DEF
Returns the default object. The default object depends on the currently processed output.
example:
DEF:e:loc name
writes the name of the default object
STALNE
Returns the station if the current object is a busbar. Returns a line if the current object is a
terminal between line routes. Otherwise, nothing is returned, and the entry will be ignored.
example:
STALNE:e:locname
writes the name of the line or station.
RES
Returns the currently active results object (ElmRes) used by simulation, harmonics or other cal-
culation modules
example:
RES:e:desc
writes the rst line of the description of the results object
E.4 Colour
A line can be set to another colour by adding a LCOL(c) command directly after the $N, marker. This
will colour the whole line according to the colour number c.
a black i gray
b black j lightgray
c red k bordeaux
d green l darkred
e blue m darkgreen
f brown n lightgreen
g cyan o marine
h magenta p darkblue
Table E.4.1: Colour Codes
A single item can be coloured by using the COLOR(Variable name; color code).
E.5 Advanced Syntax Elements
The advanced syntax is mainly used for writing forms for larger and more complex reports. An example
is a short-circuit result form, which lists all the short-circuit parameters for all busbars and for each
busbar for all connected elements.
DIgSILENT PowerFactory 15, User Manual 1241
APPENDIX E. THE DIGSILENT OUTPUT LANGUAGE
E.6 Line Types and Page Breaks
The character $ ends a format line. A line without this ending will be interpreted as a normal $N line
type. The following line type are available:
$N Normal line
$H Header on the top of each page
$F Footer on the bottom of each page
$T Title line, only appears on top of the rst page
$C Comment line (not used for output)
$R Marker that make that the line will only be used when the specied results are valid
The line type $H, $F and $T will be treated as normal ($N) line types when used inside a loop
command. Line type codes may be made language dependent by adding a E, for English lines or a G
for German lines, i.e. $HG species a German header line.
A report format must at least contain one normal ($N) line.
The following commands are used for page and line controls. They can only be used directly behind the
line type codes $N, $F or $H.
PAGEBREAK Forces a page break after the current line
AVAILBREAK Enables page breaking after the current line (default)
NOBREAK Disables page breaking directly after the current line
LCOL(c) Disables page breaking directly after the current line
OBJ(ClsNam) The current line will only be used for objects from the class ClsNam.
BUS(inum) The current line will only be used for objects which connect to exactly inum nodes
FIRST The current line will only be used when the loop index is 0 (rst passage)
NFIRST The current line will only be used when the loop index is not 0 (all but the rst passages)
IF(boolean expression) The current line will only be written when the expression is true. Example:
IF(m:u:bus1>0.95)
IFNOT(boolean expression) The current line will only be written when the expression is false. Exam-
ple: \IF(m:u:bus1<0.95)
Example:
| #.## # #.## # #.## |$R, NOBREAK, ..
E.7 Predened Text Macros
The following macros will produce specic names or other texts.
DATE(c) present date: c=e give the English format, c=g the German one.
TIME present time
VERSION version number of the DIgSILENT PowerFactory software.
BUILD build number of the DIgSILENT PowerFactory software.
1242 DIgSILENT PowerFactory 15, User Manual
E.8. OBJECT ITERATIONS, LOOPS, FILTERS AND INCLUDES
VERBUILD combines VERSION and BUILD
ORDER order title, if a title has been dened previously
CLASS class name of the object
LINE current line number in page
ALLLINE current line number in report
PAGE current page number
LOCALBUS name of the local busbar
CALC(c) name of last performed calculation. c=1 returns a long description.
SHORT short object name
FSHORT short name of parent object
CLS class name without the Elm, Sta, Typ, etc. part.
ANNEX the annex number
NGB neighbourhood depth
TEXT(E text;G Text) language dependent text (E=English, G=German)
E.8 Object Iterations, Loops, Filters and Includes
To create a report that creates a table with the voltages for all busbars, command are needed to lter the
busbar objects and to create a loop that outputs a line of text for each busbar. A loop or lter command
consists of the following parts:
the keyword "$LOOP" or "$CLOOP"
the lter or loop name
the format text
the keyword "$END"
DIgSILENT PowerFactory 15, User Manual 1243
APPENDIX E. THE DIGSILENT OUTPUT LANGUAGE
1244 DIgSILENT PowerFactory 15, User Manual
Appendix F
Element Symbol Denition
F.1 Introduction
The symbols used in the graphic windows of PowerFactory are dened by the so called Symbol objects
(IntSym). DIgSILENT provides a complete set of symbols to represent any of the dened network
components; additionally the users have the possibility to dene their own symbols and use them in the
graphical windows of their projects.
In the proceeding sections the variables used to dene symbol objects are presented.
F.2 General Symbol Denition
The general denitions of the symbols are given in the General page of the objects dialogue.
Symbol Description
The description of a symbol is shown in the list of symbols when Show Layer. . . is used and a
symbol has to be selected on the page Conguration
Object Type
Class name of the element which shall be represented.
Type of Representation
Branch or node object
ID
The icon ID of the icons from the graphic toolbar. If this value is set the symbol will be used when
a new element is inserted. In case of 0 the symbol will not be used as default.
Width/Height
The width and height is denes the range of the fang. The marking of an element in the graphic
makes this range visible.
Visible
Visibility of the symbol
Mirror
Denes if the symbol can be mirror (right mouse button entry)
Allow Moving
Allows moving in graphic
DIgSILENT PowerFactory 15, User Manual 1245
APPENDIX F. ELEMENT SYMBOL DEFINITION
Show Connection Attributes
Shows the square (resulting state of composite switches) at the end of connection lines
Insertion Reference
Denes the insertion point of an element (e.g. rectangular terminal = 4 top left).The following
matrix describes the relation between the insertion points and the insertion numbers:
4 3 2
5 0 1
6 7 8
Additional Attributes
Only used for elements whose representation shall be able to alter via specic changes of the
element parameters (e.g. shunts, couplers)
Connection Points
Denes the position on the symbol where the connection lines start. The number of connection
points is dened by the number of lines unequal (-9999,-9999). The points should be located on
the grid, i.e. they should be a multiple of 4.375 (mm)
Contents
Containing objects of type SetVitxt dening the layout of the text boxes. The names must be
unique. Labels beginning with Label... and result boxes beginning with Res. . . . The name of
symbol must also be part of the name of the SetVitxt.
F.3 Geometrical Description
The geometrical description of the symbol is given in the Geometry page of the dialogue. The geometry
can be specied by means of geometrical primitives in the Geometrical Components and Attributes
eld.
Circle (C,iStyle,rWidth,iFill,iColor,iRsz,nPts,rMx,rMy,rPx,rPy)
Denes a Circle by the center (rMx, rMy) and a point on the edge (rPx,rPy). Parameter nPts must
be 2.
Arc (A,iStyle,rWidth,iFill,iColor,iRsz,nPts,rMx,rMy,rPx1,rPy1,rPx2,rPy2)
Denes an arc by the center (rMx,rMy) and 2 points (rPx1,rPy1) (rPx2,rPy2) on the edge, drawn
clockwise. nPts must be set to 3.
Polyline (L, iStyle,rWidth,iFill,iColor,iRsz,iRot,nPts,rPx,rPy)
Denes an open polygonal line with nPts points. rPx andrPy are the coordinates of peg points.
iRot can be dened as:
n random
y only rotatable to the bottom and the right (used in symbols)
Polygon (G, iStyle,rWidth,iFill,iColor,iRsz,nPts {,rPx,rPy})
Denes a closed polygonal line with nPts points. rPx and rPy are coordinates of peg points
Text (T, iColor,iRsz,iFont,iAlign,rHeight,iOri,iRot,sString,rPx,rPy)
Denes a text with the following attributes:
1246 DIgSILENT PowerFactory 15, User Manual
F.3. GEOMETRICAL DESCRIPTION
iFont font number ( > 0)
iAlign insertion point (0 = left top, 2 = center)
rHeight height ( > 0 )
iOri orientation ( 0 = horizontal , 1 = vertical )
iRot rotate text with object ( 0 = no, 1 = yes, 2 = vert./
horiz.,3 = only to the bottom and right, used in
symbols only )
sString text (max. 80 characters)
rPx,rPy coordinates of insertion point
iRsz resize Mode (0=not possible,
1=shift only, 2=keep ratio, 3=any
(RS NONE,RS SHIFTONLY,RS KEEPXY,
RS FREE)
All geometrical elements have the following attributes in common:
iStyle (Line style)
1 = normal line
2 = dotted
3 = dashed
4 = dotted and dashed
rWidth (Line widht in mm ( > 0))
iFill (Fill style)
0 = not lled
1 = lled 100%
2 = horiz. stripes
3 = vertical stripes
4 = horizontal and vertical stripes
5 = diagonal from left bottom to right top
6 = diagonal from right bottom to left top
7 = diagonal grid of stripes
8 = lled 25%
9 = lled 50%10 = lled 75%
iColor (Colour)
-1 = colour of object
0 = white
1 = black
2 = bright red
3 = bright blue
4 = bright green
5 = yellow
6 = cyan
7 = magenta
8 = dark grey
9 = grey
10 = red
11 = dark rot
12 = dark green
13 = green
14 = dark blue
15 = blue
16 = white
17 = bright grey
Resize mode)
0 = not resizable
DIgSILENT PowerFactory 15, User Manual 1247
APPENDIX F. ELEMENT SYMBOL DEFINITION
1 = shift only
2 = keep ratio
3 = resizable in any direction
In version 13.0 additional parameters were added:
iSB
No. of area (1..32, can only be used if set in source code, e.g. vector groups
iLay
No. of graphic layer
iSN
Connection number (0..4)
iIP
Object is used for calculation of intersections (=1 only for node objects)
xOff, yOff
Offset used when object is inserted (optional)
F.4 Including Graphic Files as Symbols
Graphic les in WMF and bitmap format can be selected as Symbol File. The denitions of the geo-
metrical primitives are not used if a Symbol File is dened.The picture will be adapted to the size of
symbol in the single line diagram. After selection of a WMF le in the top entry eld for the Symbol File
(not rotated) a button Create all other les appears which allows to create automatically WMF les in
the same folder with a rotation of 90, 180 and 270 degrees. Additionally pictures for open devices with
the same angles can be entered in the bottom lines.
1248 DIgSILENT PowerFactory 15, User Manual
Appendix G
Standard Functions DPL and DSL
function description example
sin(x) sine sin(1.2)=0.93203
cos(x) cosine cos(1.2)=0.36236
tan(x) tangent tan(1.2)=2.57215
asin(x) arcsine asin(0.93203)=1.2
acos(x) arccosine acos(0.36236)=1.2
atan(x) arctangent atan(2.57215)=1.2
sinh(x) hyperbolic sine sinh(1.5708)=2.3013
cosh(x) hyperbolic cosine cosh(1.5708)=2.5092
tanh(x) hyperbolic tangent tanh(0.7616)=1.0000
exp(x) exponential value exp(1.0)=2.718281
ln(x) natural logarithm ln(2.718281)=1.0
log(x) log10 log(100)=2
sqrt(x) square root sqrt(9.5)=3.0822
sqr(x) power of 2 sqr(3.0822)=9.5
pow (x,y) power of y pow(2.5, 3.4)=22.5422
abs(x) absolute value abs(-2.34)=2.34
min(x,y) smaller value min(6.4, 1.5)=1.5
max(x,y) larger value max(6.4, 1.5)=6.4
modulo(x,y) remainder of x/y modulo(15.6,3.4)=2
trunc(x) integral part trunc(-4.58823)=-4.0000
frac(x) fractional part frac(-4.58823)=-0.58823
round(x) closest integer round(1.65)=2.000
ceil(x) smallest larger integer ceil(1.15)=2.000
oor(x) largest smaller integer oor(1.78)=1.000
time() current simulation time time()=0.1234
pi() 3.141592... pi()=3.141592...
twopi() 6.283185... twopi()=6.283185...
e() 2,718281... e()=2,718281...
Table G.0.1: DSL Standard Functions
These functions are present in both DPL and DSL, click on the link to go to the corresponding chapter.
Stability and EMT Simulations (DSL)
DIgSILENT PowerFactory 15, User Manual 1249
APPENDIX G. STANDARD FUNCTIONS DPL AND DSL
The DIgSILENT Programming Language (DPL)
1250 DIgSILENT PowerFactory 15, User Manual
Bibliography
[1] IEEE std. c37.010 IEEE Application Guide for AC High-Voltage Circuit Breakers Rated on a Sym-
metrical Current Basis, 1979.
[2] IEEE std. c37.5 IEEE Guide for calculation of Fault Currents for Application of AC High-Voltage
Circuit Breakers Rated on a Total Current Basis, 1979.
[3] IEEE std. 242. IEEE Recommended Practice for Protection and Coordination of Industrial and
Comercial Power Systems. Buff Book, 1986.
[4] IEEE std. c37.13 IEEE Standard for Low Voltage Power Circuit Breakers Used in Enclosures, 1990.
[5] IEEE std. 141. IEEE Recommended Practice for Electric Power Distribution for Industrial Power
Plants. Red Book, 1993.
[6] IEC 1000-3-6 Electromagnetic Compatibility (EMC) - Part 3: Limits - Section 6: Assessment of
emission limits for distorting loads in MV and HV power systems - Basic EMC publication, 1996.
[7] IEC 61363-1 Electrical installations of ships and mobile and xed offshore units - Part 1: Proce-
dures for calculating short-circuit currents in three-phase a.c., 1998.
[8] IEC 60076-5 Power transformers - Part 5: Ability to withstand short circuit, 200.
[9] IEC 60909 Short-circuit currents in three-phase A.C. systems, 2001.
[10] IEC 1000-4-15 Electromagnetic Compatibility (EMC) - Part 4: Testing and measurement tech-
niques - Section 15: Flickemeter - Functional and desing specications, 2003.
[11] IEC 61400-21 Wind turbines - Part 21: Measurement and assessment of power quality character-
istics of grid connected wind turbines, 2008.
[12] IEEE. IEEE 1584-2002. Guide for Performing Arc-Flash Hazard Calculations.
[13] R. L.Heinhold. Kabel und Leitungen fuer Starkstrom. Pirelli Kabel und Systeme GmbH & Co, 2005.
[14] NFPA. NFPA 70E. Standard for Electrical Safety. Requirements for Employee Workplaces. 2000
Edition.
DIgSILENT PowerFactory 15, User Manual 1251
BIBLIOGRAPHY
1252 DIgSILENT PowerFactory 15, User Manual
Index
About this Guide, 3
abs
DPL, 324
DSL, 564
AC OPF, 703
Advanced Options, 718
Basic Options, 703
Initialization, 717
Iteration Control, 718
Output, 720
ACCI (Reliability Analysis), 654
ACIF (Reliability Analysis), 651
ACIT (Reliability Analysis), 651
acos
DPL, 324
DSL, 564
ActiveCase, 1040
Administrator, 42
AENS (Reliability Analysis), 654
aipop
DSL, 567
AID (Reliability Analysis), 655
AllRelevant, 996
API Interface, 382
Appliance, 921
Arcash, 803
Area, 179
ASAI (Reliability Analysis), 652
asin
DPL, 324
DSL, 564
ASUI (Reliability Analysis), 652
atan
DPL, 324
DSL, 564
Autotransformer, 939
Background Harmonics, 472
Base Case, 921
Basic Project Denition, 59
Befehl Pr, 138
Befehl Rd, 138
Befehl Stop, 138
Befehl Wr, 138
Block Denition, 537, 921
Block Denition Dialogue (DSL), 552
Block Diagram, 103, 537, 921
Boolean
Expressions, 324
Boundary, 182
Branch Elements, 921
break
DPL, 325
Busbars, 921
Cable Size Optimization
Advanced Options, 786
Line Element Parameters, 791
Line Parameters, 790
Line Type Parameters, 790
Objective Function, 765
Technology Check, 791
Type Parameters, 789
Cable Sizing, 779
CAIDI (Reliability Analysis), 652
CAIFI (Reliability Analysis), 652
Calculation
Compare Results, 244
Update Database, 246
Calculation Time, 149
CASE
DIg Output Language, 1240
ceil
DPL, 324
DSL, 564
ChaPol, 477
ChaVecle, 221
CIM Interface, 352
Circuit, 183
Class, 921
ClearCommands, 1140
ClearOutput, 1018
CMD
DIg Output Language, 1240
ComCabsize, 779
Objective Function, 765
Optimization Procedure, 753
ComCapo, 769
Available Capacitors, 774
Basic Options, 772
Load Characteristics, 775
ComCimExp, 353
ComCimimp, 352
ComContingency
Contingency analysis with multiple time phases,
611
DIgSILENT PowerFactory 15, User Manual 1253
INDEX
ComDbupd, 246
ComDiff, 244
ComDocu, 238
ComDpl, 319
ComDpl (DPL Methods), 1153
Execute, 1153
ComEd, 137
ComExport, 339
ComExppsse, 345
ComFlickermeter, 492
ComFsweep, 464
ComGenrel, 694
ComGenrelinc, 691
ComHldf, 462
ComIdent, 601
ComImport, 337
ComImport (DPL Methods), 1153
GetCreatedObjects, 1153
GetModiedObjects, 1154
ComInc, 504
ComInc (DPL Methods)
Execute, 1143
ComLdf, 402
ComLdf (DPL Methods), 1140
Execute, 1141
ComLink (DPL Methods), 1160
ReceiveData, 1161
SendData, 1160
ComLoadstate, 225
ComMerge, 304
ComMerge (DPL Methods), 1154
ComMerge (DPl Methods)
CheckAssignments, 1156
Compare, 1155
CompareActive, 1155
ExecuteRecording, 1156
ExecuteWithActiveProject, 1155
GetCorrespondingObject, 1158
GetModication, 1159
GetModicationResult, 1159
GetModiedObjects, 1159
Merge, 1157
PrintComparisonReport, 1156
PrintModications, 1158
Reset, 1157
SetAutoAssignmentForAll, 1156
SetObjectsToCompare, 1158
ShowBrowser, 1157
WereModicationsFound, 1158
ComMod, 583
Advanced Options, 584
How to Complete a Modal Analysis, 582
ComModres, 595
Common Mode Failure, 664
Common Model, 532
Structure, 532
ComNeplan, 347
ComNew, 88
ComNmink, 637
ComNmink (DPL Methods), 1148
AddRef, 1148
Clear, 1149
GetAll, 1149
ComOp, 137
ComOpf, 703
ComOptrest, 670
ComOutage, 626
ComOutage (DPL Methods), 1144
GetObject, 1144
RemoveEvents, 1145
SetObjs, 1144
ComPause, 137, 138
Composit Frame, 528
Composite Block Denition, 537
Composite Block Denitions (DSL), 551
Composite Frame, 922
Additional Equations, 544
Block Denition, 530
Drawing, 539
Multi Signal Connection, 542
Signal Connection, 542
Signals, 532
Composite Model, 520, 525, 922
Slot Update, 527
Step Response, 527
ComPr, 137
ComPsse, 340
ComRd, 137
ComRed, 883
ComRel3
Network reliability assessment, 670
ComRel3 (DPL Methods), 1150
AnalyseElmRes, 1151
CreateFaultCase, 1152
Execute, 1150
RemoveEvents, 1151
RemoveOutages, 1150
ComRes, 243, 291
ComRes (DPL Methods), 1143
ExportFullRange, 1143
FileNmResNm, 1144
ComSe, 908
ComSeteval, 597
ComSh, 466
ComShc, 443
ComShc (DPL Methods), 1141
Execute, 1142
ComSim, 518
ComSimoutage, 617
ComSimoutage (DPL Methods), 1146
AddCntcy, 1147
Execute, 1146
ExecuteCntcy, 1147
ReportObjs, 1148
Reset, 1146
SetLimits, 1147
1254 DIgSILENT PowerFactory 15, User Manual
INDEX
ComStationware, 356
ComStepres, 527
ComStop, 137
ComTablereport (DPL Methods), 1099
AddColumn, 1100
AddCurve, 1101
AddHeader, 1101
AddInvisibleFilter, 1102
AddListFilter, 1102
AddListFilterEntries, 1103
AddPlot, 1103
AddRow, 1104
AddTable, 1104
AddTextFilter, 1104
AddXLabel, 1105
DisableAutomaticRowNumbering, 1105
EnableAutomaticRowNumbering, 1106
SetBarLimits, 1106
SetCellAccess, 1106
SetCellEdit, 1107
SetCellValueToBar, 1107
SetCellValueToCheckbox, 1108
SetCellValueToDate, 1108
SetCellValueToDouble, 1109
SetCellValueToInt, 1109
SetCellValueToObject, 1110
SetCellValueToString, 1111
SetColumnHeader, 1111
SetCurveValue, 1112
SetDialogSize, 1112
SetListFilterSelection, 1113
SetNumberFormatForPlot, 1113
SetSorting, 1113
SetStatusText, 1114
SetTextAxisDistForPlot, 1114
SetTicksForPlot, 1114
SetTitle, 1115
ComTieopt, 757
ComUcte, 349
ComUcteexp, 351
ComUcteexp (DPL Methods), 1161
BuildNodeNames, 1161
ComVsag, 747
ComVstab, 422
ComWr, 137
Contact, 5
Contingency Analysis, 611
Comparing Results, 639
Contingency Cases, 626
Creating Contingencies using Contingency Def-
initions, 637
Creating Contingencies using Fault Cases and
Fault Groups, 634
Executing Contingency Analyses, 615
Reslut Analysis, 641
Single Time Phase, 617
Technical Background, 611
Contingency Case, 626
Contingency Constrained DC OPF, 729
Advanced Options, 736
Basic Options, 730
Initialization, 736
Iteration Control, 736
Output, 736
Reports, 737
Contingency Denition, 637
Contingency OPF, 729
continue
DPL, 325
Convergence
Iteration Control, 409
LF Troubleshooting, 415
cos
DPL, 323
DSL, 564
cosh
DPL, 323
DSL, 564
Cost Functions, 705
CSSL, 546
CUBIC
DIg Output Language, 1240
Cubicle, 922
Curve Input
Context-sensitive Menu, 281
Create Diagram, 280
DAQ, 922
Data Management, 297
Data Manager, 117
Database Browser, 117
Database Tree, 119
Settings, 53
Database
Multi-User, 43
Single-User, 42
DC OPF, 721
Advanced Options, 727
Basic Options, 722
Initialization, 726
Iteration Control, 728
DDE Functions, 1232
ddeClose, 1233
ddeExe, 1233
ddeOpen, 1232
ddePoke, 1234
ddeRequest, 1235
DEF
DIg Output Language, 1241
Dening Element Symbols, 1245
delay
DSL, 566
Device, 922
DGS Interface, 335
Diagram Colouring, 106
DiaGrfopts, 97
DiaPagetyp, 88
DIgSILENT PowerFactory 15, User Manual 1255
INDEX
DIg Output Language, 1237
Color, 1241
Format, 1238
Includes, 1243
Line Types, 1242
Loops, 1243
Page Breaks, 1242
Placeholder, 1238
Text Macros, 1242
Variables, 1239
DIgSILENT Programming Language, 317
Distribution Network Tools, 747
do() while{}
DPL, 324
Documentation, 7
DPL, 317
Access to Objects, 327
Assignments, 323
break, 325
coninue, 325
Constant Parameters, 322
External Objects, 329
Functions & Subroutines, 333
General Functions and Methods, 970
General Object Functions and Methods, 970
General Set Functions and Methods, 995
input, 326
Local Objects, 328
Object Variables & Methods, 327
output, 326
Standard Functions, 323
String Functions, 1005
Subroutines, 332
Variable Denitions, 322
DPL (DIgSILENT Programming Language), 317
DPL Advanced Options, 320
DPL Command Execute, 320
DPL Command Libraries, 330
DPL Command Object, 319
DPL Command Set, 319
DPL Internal Methods, 333
DPL Reference, 949
DPL Script Editor, 321
DPL Script Language, 321
DPL Script Page, 321
Drag and Drop, 922
DSL, 554
Advanced Features, 550
Dening Models, 551
Denition Code, 556
Equation Code, 560
Events, 547
Example, 563
Expression, 560
General Syntax, 555
Implementation, 547
inc, 557
inc0, 557
incx, 557
Initial Conditions, 558
intervalinc, 558
loopinc, 558
Macro Handling, 562
Macros, 561
Model Description, 550
newtoninc, 558
Output, 547
Special Functions, 565
Standard Functions, 564
Structure, 547
DSL Block Denition, 520
DSL Model Components, 550
DSL Models, 544
DSL Primitive, 923
DSL Reference, 564
DSL Structure, 556
DSL Variables, 556
e
DPL, 324
DSL, 564
EchoOff, 1028
EchoOn, 1027
EDGE
DIg Output Language, 1239
Edge Elements, 923
EIC (Reliability Analysis), 655
Eigenvalue Bar Plot, 257
Eigenvalue Calculation, 579
Eigenvalue Plot, 589
Element, 923
ElmAsm, 942
ElmAsm (DPL Methods), 1163
GetAvailableGenPower, 1163
ElmAsmsc, 942
ElmAsmsc (DPL Methods), 1164
GetAvailableGenPower, 1164
ElmBay (DPL Methods), 1213
GetAll, 1213
ElmBoundary, 182
ElmBoundary (DPL Methods), 1168
IsSplitting, 1168
ElmCabsys, 941
ElmClock, 947
ElmComp, 525
ElmComp (DPL Methods), 1171
Slotupd, 1171
ElmCompare, 602
ElmCoup (DPL Methods), 1171
Close, 1172
GetRemoteBreakers, 1174
IsBreaker, 1173
IsClosed, 1173
IsOpen, 1173
Open, 1172
ElmDcdc, 945
ElmDci, 946
1256 DIgSILENT PowerFactory 15, User Manual
INDEX
ElmDsl, 532
ElmFeeder, 184
GetObjs, 1168
ElmFeeder (DPL Methods), 1165
GetAll, 1165
GetBranches, 1167
GetBuses, 1166
GetNodesBranches, 1167
ElmFft, 948
ElmFile, 947
ElmFsrc, 946
ElmFuse, 826
ElmGenstat, 942
ElmLne, 940
ElmLne (DPL Methods), 1174
CreateFeederWithRoutes, 1178
FitParams, 1180
GetType, 1176
GetY0m, 1179
GetY1m, 1179
GetZ0m, 1178
GetZ1m, 1179
HasRoutes, 1175
HasRoutesOrSec, 1175
IsCable, 1176
IsNetCoupling, 1177
SetCorr, 1177
SetDetailed, 1178
ElmLnesec, 940
ElmLod, 943
ElmLodlv, 943
ElmLodlvp, 943
ElmMdm, 944
ElmMeteostat, 685
ElmNec, 945
ElmNet (DPL Methods), 1162
Activate, 1162
CalculateInterchangeTo, 1163
Deactivate, 1162
ElmPhi, 947
ElmRec, 944
ElmRecmono, 944
ElmReg, 947
ElmRelay, 814
ElmRes, 241
ElmRes (DPL Methods), 1180
AddVars, 1181
Clear, 1181
Draw, 1182
Flush, 1182
GetObj, 1183
GetResData, 1183
Init, 1184
LoadResData, 1184
ReleaseResData, 1185
ResFirstValidObject, 1187
ResFirstValidObjectVar, 1188
ResFirstValidVar, 1188
ResIndex, 1186
ResNextValidObject, 1189
ResNextValidObjectVar, 1189
ResNextValidVar, 1190
ResNval, 1190
ResNvars, 1191
SetAsDefault, 1191
Write, 1191
WriteDraw, 1192
ElmSamp, 947
ElmScap, 942
ElmShnt, 945
ElmSind, 942
ElmStactrl, 396, 945
ElmStactrl (DPL Methods), 1192
GetControlledHVNode, 1193
GetControlledLVNode, 1194
GetStepupTransformer, 1192
ElmSubstat (DPL Methods), 1194
GetSplit, 1195, 1200
GetSplitCal, 1197
GetSplitIndex, 1196
OverwriteRA, 1199
SaveAsRA, 1198
SetRA, 1199
ElmSvs, 945
ElmSym, 943
ElmSym (DPL Methods), 1200
Disconnect, 1200
GetAvailableGenPower, 1202
IsConnected, 1201
Reconnect, 1201
ElmTerm (DPL Methods), 1203
GetMinDistance, 1205
GetNextHVBus, 1203
IsElectrEquivalent, 1205
IsEquivalent, 1203
ElmTow, 940
ElmTow (DPL Methods), 1206
FitParams, 1206
PrintFreqDepParams, 1207
ElmTr (DPL Methods), 1207
IsQuadBooster, 1207
ElmTr2, 938
ElmTr2n, 938
ElmTr3, 938
ElmTrb, 939
ElmTrigger, 948
ElmVac, 890, 946
ElmVar, 945
ElmVdc, 946
ElmVsc, 944
ElmVscmono, 944
ElmWindzone, 685
ElmXnet, 946
psik, 487
Sk, 487
ElmZone (DPL Methods), 1208
DIgSILENT PowerFactory 15, User Manual 1257
INDEX
GetAll, 1208
GetBranches, 1210
GetBuses, 1209
GetNodes, 1209
GetObjs, 1210
ElmZpu, 890, 942
EMT Simulation, 501
EMT Simulations, 501
ENS (Reliability Analysis), 654
Equipment Type Library, 159
Equivalent Network, 883
Error, 1018
Event, 516
Inter-Circuit, 153
Load, 153
Outage, 153
Parameter, 154
Short-Circuit, 154
Switching, 154
Synchronuos Machine, 155
event
DSL, 568
Events, 516
EvtLod
Data Model, 152
EvtOutage
Data Model, 152
EvtParam
Data Model, 152
EvtShc
Data Model, 152
EvtShcll
Data Model, 152
EvtSym
Data Model, 152
Exe, 1139
Execute, 1138
exit, 1028
exp
DPL, 324
DSL, 564
Expansion Stages, 201
Export
Curve Data, 291
to Spreadsheet Programs, 139
Failure Effect Analysis, 656
fault
DSL, 562
Fault Case, 635
Fault Clearing (Reliability Analysis), 657
Fault Group, 636
Fault Isolation (Reliability Analysis), 657
fclose, 1023
FEA (Failure Effect Analysis), 656
Feeder, 184
fush, 1024
le
DSL, 566
Filter Analysis, 466
Flexible Data Page, 135
Flicker Analysis (IEC 61400-21), 481
Assignment of Flicker Coefcients, 484
Continuous Operation, 482
Denition of Flicker Coefcients, 483
Flicker Contribution of Wind Turbines, 483
Result Variables, 485
Switching Operations, 482
Flickermeter, 491
Advanced Options, 494
Calculation of Long-Term Flicker, 492
Calculation of Short-Term Flicker, 491
Data Source, 493
Flickermeter Command, 492
Signal Settings, 493
ipop
DSL, 567
oor
DPL, 324
DSL, 564
fopen, 1024
Format Editor, 235
Predened Variables, 235
Text Editor, 235
User Selection, 235
Format String Syntax, 1006
FormatDateLT, 1014
FormatDateUTC, 1014
fprintf, 1025
frac
DPL, 324
DSL, 564
fRand, 1029
Frequency Dependent Parameters, 477
Frequency Sweep, 464
Advanced Options, 465
Basic Options, 465
fscanf, 1025
fscanfsep, 1026
fWrite, 1025
General Selection (DPL), 328
GetActiveNetworkVariations, 1041
GetActiveProject, 1037
GetActiveScenario, 1043
GetActiveStages, 1042
GetActiveStudyCase, 1041
GetBorderCubicles, 1030
GetCaseCommand, 1139
GetDataFolder, 1038
GetFlowOrientation, 1037
GetGlobalLib, 1037
GetGraphBoard, 1055
GetLanguage, 1031
GetLocalLib, 1038
GetPageLen, 1031
GetProjectFolder, 1039
GetRecordingStage, 1042
1258 DIgSILENT PowerFactory 15, User Manual
INDEX
GetSettings, 1031
GetSystemTime, 1016
GetTime, 1016
GetUserManager, 1032
Glossary, 921
Graphic
Already Existing Network Elements, 90
Attributes, 97
Balloon Help, 111
Colour, 106
Edit Result Box, 112
Imported Data, 92
Insert, 96
Interconnect, 72
Layers, 99
Legend Block, 110
Mark Element, 70
Options, 97
Print, 95
Rebuild, 96
Reference Point, 112
Remove Page, 96
Rename Page, 97
Result Box, 111
Result Boxes, 98
Title Block, 109
Toolboxes, 89
Zoom, 94
Graphic Board Window, 923
Graphic Window
New, 88
Page Tab, 89
Graphic Windows
Settings, 52
Graphics Board, 85
Grid, 923
Grouping Objects, 179
Harmonic Calculation
Denition of Result Variables, 487
Modeling
Assignment of Harmonic Injections, 475
Background Harmonics, 472
Denition of Harmonic Injections, 468
Frequency Dependent Parameters, 477
Harmonic Distortion Results, 476
IEC 61000 Harmonic Sources, 470
Magnitudes and Phase Values, 473
Phase Correct Harmonic Sources, 468
Waveform Plot, 480
Modeling Harmonic Sources, 468
Waveform Plot, 480
Harmonic Impedance, 464
Harmonic Load Flow, 462
Advanced Options, 464
Basic Options, 462
IEC 61000-3-6, 464
Result Variables, 463
Harmonic Sources, 468
Harmonics Analysis, 461
Denition of Result Variables, 487
Filter Analysis, 466
Flicker Analysis (IEC 61400-21), 481
Frequency Sweep, 464
Harmonic Load Flow, 462
Modeling Harmonic Sources, 468
psik, 485
Balanced Harmonics Analysis, 486
Unbalanced Harmonics Analysis, 486
Sk, 485
Balanced Harmonics Analysis, 486
Result Variables, 486
Unbalanced Harmonics Analysis, 486
Help, 7
HMC, 461
Hotkeys, 927
Hotkeys References, 927
Housekeeping, 36
IEAR (Reliability Analysis), 655
IEC 61000-3-6, 464
IEC 61000-4-15), 491
Advanced Options, 494
Calculation of Long-Term Flicker, 492
Calculation of Short-Term Flicker, 491
Data Source, 493
Signal Settings, 493
IEC 61400-21, 481
Assignment of Flicker Coefcients, 484
Continuous Operation, 482
Denition of Flicker Coefcients , 483
Flicker Contribution of Wind Turbines, 483
Result Variables, 485
Switching Operations, 482
if(){}
DPL, 324
if(){}else{}
DPL, 324
Import
to Spreadsheet Programs, 141
inc
DSL, 557
inc0
DSL, 557
incx
DSL, 557
Info, 1019
Input, 1032
input
DPL, 326
IntBoundary, 182
IntCase, 147
The Study Case Edit Dialogue, 150
IntCase (DPL Methods), 1048
Activate, 1048
Deactivate, 1049
Reduce, 1049
IntDplmap (DPL Methods), 1127
DIgSILENT PowerFactory 15, User Manual 1259
INDEX
Clear, 1127
Contains, 1127
First, 1128
GetValue, 1128
Insert, 1129
Next, 1129
Remove, 1130
Size, 1130
Update, 1130
IntDplvec (DPL Methods), 1134
Clear, 1134
Get, 1134
IndexOf, 1135
Insert, 1135
Remove, 1135
Size, 1136
Sort, 1136
Interconnect, 72
Interfaces, 335
API, 382
CIM, 352
CIM Data Export, 353
CIM Data Export General Settings, 354
CIM Data Import, 352
CIM Data Import General Settings, 352
DGS, 335
DGS Export, 339
DGS Export General Settings, 339
DGS Import, 337
DGS Import General Settings, 338
DGS Structure, 337
MATLAB, 354
NEPLAN, 347
NEPLAN Import, 347
NEPLAN Import General Settings, 348
OPC, 355
PSS/E, 340
PSS/E Dyn.Data Import, 344
PSS/E Dyn.Data Import General Settings, 344
PSS/E Dyn.Data Import Options, 345
PSS/E Export, 345
PSS/E Export General Settings, 345
PSS/E Export Options, 346
PSS/E Import, 340
PSS/E Import General Settings, 340
PSS/E Import Graphical Options, 343
PSS/E Import Options, 342
StationWare, 356
UCTE-DEF, 349
UCTE-DEF Data Export, 351
UCTE-DEF Data Export General Settings, 351
UCTE-DEF Data Import, 349
UCTE-DEF Data Import General Settings, 349
Interior Point Method, 703
intervalinc
DSL, 558
IntEvt (DPL Methods), 1215
CreateCBEvents, 1215
IntEvtshc, 441
IntForm, 235
IntForm (DPL Methods), 1215
SetText, 1215
WriteOut, 1216
IntGrfnet, 96
Options, 96
IntLogon, 33
IntMat (DPL Methods), 1217
ColLbl, 1217
Get, 1218
Init, 1219
Invert, 1219
Multiply, 1220
NCol, 1220
NRow, 1220
Resize, 1221
RowLbl, 1221
Set, 1222
SortToColumn, 1222
IntMon, 157, 247
IntMon (DPL Methods), 1223
AddVar, 1224
ClearVars, 1224
GetVar, 1224
NVars, 1223
PrintAllVal, 1223
PrintVal, 1223
RemoveVar, 1224
IntMonsel, 135
IntNewobj, 120
IntPlot (DPL Methods), 1086
SetAdaptY, 1089
SetAutoScaleY, 1088
SetScaleY, 1086
IntPrj, 61
IntPrj (DPL Methods), 1043
Activate, 1044
Deactivate, 1044
GetLatestVersion, 1044
GetVersions, 1045
HasExternalReferences, 1045
Migrate, 1046
Purge, 1046
UpdateStatistics, 1046
IntPrjfolder (DPL Methods), 1047
GetProjectFolderType, 1047
IsProjectFolderType, 1048
IntScenario, 189
IntScenario (DPL Methods), 1053
Activate, 1054
Apply, 1054
Deactivate, 1054
GetObjects, 1055
Save, 1055
IntScensched, 197
IntScheme, 201
IntScheme (DPL Methods), 1053
1260 DIgSILENT PowerFactory 15, User Manual
INDEX
IntScn, 514
IntSscheduler, 204
IntSstage, 201
IntSstage (DPL Methods), 1052
IntSubset, 199
IntSym, 1245
IntTemplate, 174
IntThrating (DPL Methods), 1225
GetCriticalTimePhase, 1225
GetRating, 1225
IntUser (DPL Methods), 1226
Purge, 1226
SetPassword, 1226
IntUserman (DPL Methods), 1227
CreateGroup, 1228
CreateUser, 1229
GetGroups, 1227
GetUsers, 1228
IntVariant (DPL Methods), 1051
Activate, 1051
Deactivate, 1052
Reduce, 1052
IntVec (DPL Methods), 1230
Get, 1230
Init, 1231
Resize, 1231
Set, 1231
Size, 1232
IntVersion, 297
invlapprox
DSL, 567
Iterations
Iteration Control, 409
LF Troubleshooting, 415
lapprox
DSL, 567
lapprox2
DSL, 567
lim
DSL, 565
limits
DSL, 565
Limits (Active and Reactiv Power), 713
limstate
DSL, 566
Linear Programming, 721
LMPs, 725
ln
DPL, 324
DSL, 564
Load Flow Analysis, 385
Active Power Control, 404
Advanced Load Options, 396
Advanced Options, 407
Advanced Simulation Options, 412
Basic Options, 403
Coincidence of Low Voltage Loads, 399
Executing LF, 402
Feeder Load Scaling, 397
Iteration Control, 409
Load Scaling Factors, 399
Low-Voltage Analysis, 411
Output, 410
Reactive Power Control, 403
Result Analysis, 412
Sensitivities, 421
Technical Background, 389
Temperature Dependency, 400
Troubleshooting, 415
Voltage Dependency of Loads, 396
Load Shedding (Reliability), 658
Load Transfer (Reliability), 658
Load-Flow
Optimizing, 703
Locational Marginal Prices, 725
log
DPL, 324
DSL, 564
Log-on, 33
Logon
Advanced Settings, 36
Long-Term-Flicker, 492
loopnic
DSL, 558
LPEIC (Reliability Analysis), 654
LPENS (Reliability Analysis), 653
LPES (Reliability Analysis), 653
LPIF (Reliability Analysis), 651
LPIT (Reliability Analysis), 651
Macro
DSL, 561
MATLAB Interface, 354, 569
Concept, 572
Matlab File, 576
Model Implementation, 570
max
DPL, 323
DSL, 564
min
DPL, 323
DSL, 564
Modal Analysis, 579
Exporting a Modal Analysis Plot to External
Software, 594
Exporting Results to External Software, 597
How to Complete a Modal Analysis, 582
Participation Factor, 579
Result Plots, 589
Showing the Modal Analysis Data Browser, 595
Theory, 579
Validity of Results, 581
Viewing Modal Analysis Results, 585
Viewing Results in the Data Browser, 595
Modal Analysis Command
Advanced Options, 584
Basic Options, 583
DIgSILENT PowerFactory 15, User Manual 1261
INDEX
Mode Bar Plot, 591
Mode Phasor Plot, 593
Model Parameter Identication, 601
Modelling and Simulation Tools, 546
modulo
DPL, 323
DSL, 564
Motor Starting, 793
NEPLAN Interface, 347
NET
DIg Output Language, 1240
Network Model
Variations, 201
Network Reduction, 883
Example, 890
Handling, 884
Options, 887
Network Variations, 201
newtoninc
DSL, 558
Node, 923
NoFinalUpdate, 1033
NULL, 322
OBJECT
DIg Output Language, 1239
Object, 923
object (DPL Methods), 970
AddCopy, 971
CreateObject, 972
Delete, 972
Edit, 973
GetCaseObject, 973
GetChildren, 974
GetClass, 975
GetConnectedElms, 976
GetConnectionCount, 975
GetContents, 976
GetControlledNode, 977
GetCubicle, 978
GetFullName, 978
GetNet, 979
GetNode, 979
GetOperator, 980
GetOwner, 980
GetParent, 980
GetReferences, 981
GetSize, 981
GetUserAttribute, 982
GetVal, 983
HasResults, 984
Inom, 993
IsClass, 984
IsEarthed, 985
IsEnergized, 985
IsInFeeder, 986
IsNode, 986
IsOutOfService, 987
IsReducible, 987
IsRelevant, 988
lnm, 993
MarkInGraphics, 988
Move, 989
PasteCopy, 989
SetSize, 989
SetVal, 990
ShowFullName, 991
ShowModalSelectTree, 991
snm, 995
StochEvt, 992
unm, 994
Unom, 994
VarExists, 992
Objects
Edit, 87
Filtering, 128
Search, 127
Sorting, 127
OPC Interfaces, 355
Open Tie Optimization, 757
Operation Scenario, 189, 923
Operation Scenarios
Scenario Scheduler, 197
Operational Data, 161
Operator, 186
OPF, 703
Opt.Capacitor Placement
Avaible Capacitors, 774
Basic Options, 772
Load Characteristics, 775
Objective Function, 770
Optimization Procedure, 772
Voltage Violation Cost, 770
Optimal Capacitor Placement, 769
Optimal Power Flow, 703
Optimization Procedure, 753
output
DPL, 326
DSL, 562
Output of Device Data, 238
Documentation, 239
Filter/Annex, 239
Output of Results, 240
Output Window, 25
Context Sensitive Menu, 26
Copy, 28
Legend, 27
Settings, 54
Overload Alleviation (Reliability Analysis), 658
Owner, 187
Page Tab, 924
Parallel Computing, 624
Parameter Characteristics, 215
Parameter Identication, 601
Application, 608
Comparison Plot, 603
1262 DIgSILENT PowerFactory 15, User Manual
INDEX
Measurement File, 603
Model Creation, 604
Performing, 606
Target Function, 602
ParseDateLT, 1016
ParseDateUTC, 1017
Path, 187
pi
DPL, 324
DSL, 564
picdro
DSL, 566
plots, 255
PostCommand, 1139
pow
DPL, 323
DSL, 564
Power Restoration (Reliability Analysis), 657
PowerFactory Overview, 9
Primitive Block Denition (DSL), 551
Print Graphic, 95
printf, 1020
Program Administration, 33
Program Conguration, 33
Program Installation, 33
Project, 924
Basic Denition, 59
Validity Period, 64
Project Library, 159
Project Overview, 62
Project Settings, 64
Protection, 811
psik, 485
PSSE/E Interface, 340
PWM Converter, 944
Random, 1033
Rebuild, 1034
Rectier/Inverter, 944
Reducing Network, 883
Reduction, 883
Reference System, 509
RelDir, 828
RelFmeas, 881
RelFrq, 881
RelFuse, 826
Reliability Analysis
Advanced Options, 675
Basic Options, 670
Calculated Results, 650
FEA Options, 672
Options, 676
Outputs, 672
State Enumeration, 655
Stochastic Models, 649
Reliability Assessment, 645
Technical Background, 647
Reliability Model
Interruption Cost, 668
RelIoc, 829
RelLogic, 832
RelMeasure, 827
RelToc, 830
RelUlim, 882
Remote Scripts (DPL), 330
Reporting Results, 235
RES
DIg Output Language, 1241
ResetCalculation, 1138
Result Box
Edit, 111
Result Comparison
Setup, 244
Result Export, 243
Result Object, 241, 924
Results, 235
RMS Simulation, 503
round
DPL, 324
DSL, 564
SAIDI (Reliability Analysis), 652
SAIDI P (Reliability Analysis), 652
SAIFI (Reliability Analysis), 652
SAIFI P (Reliability Analysis), 652
sapprox
DSL, 567
sapprox2
DSL, 568
SaveScenarioAs, 1043
ScnFreq, 514
ScnSync, 514
ScnVar, 514
ScnVolt, 515
SearchObjectByForeignKey, 974
SEL, 322
select
DSL, 566
Sensitivity Analysis, 422
SES (Reliability Analysis), 654
Set (DPl Methods), 995
Add, 997
Clear, 997
Count, 998
First, 998
FirstFilt, 999
Firstmatch, 999
IsIn, 999
MarkInGraphics, 1000
Next, 1000
NextFilt, 1001
Nextmatch, 1001
Obj, 1001
OutputFlexibleData, 1002
Remove, 1002
ShowModalBrowser, 1003
ShowModalSelectBrowser, 1003
ShowModelessBrowser, 1003
DIgSILENT PowerFactory 15, User Manual 1263
INDEX
SortToClass, 1004
SortToName, 1004
SortToVar, 1005
SetColscheme, 106
SetCondmg, 836
SetConsistencyCheck, 1034
SetCrvlt, 290
SetDesktop (DPL Methods), 1090
AddPage, 1090
DoAutoScaleX, 1092
GetPage, 1091
SetAdaptX, 1093
SetAutoScaleX, 1093
SetResults, 1094
SetScaleX, 1094
SetXVar, 1095
Show, 1096
WriteWMF, 1096
SetDiffMode, 1034
SetDisplt, 862
SetFeeder (DPL Methods), 1123
GetAll, 1123
GetBranches, 1123
GetBuses, 1123
SetFilt, 127
SetFilt (DPL Methods), 1115
Get, 1115
SetGraphicUpdate, 1056
SetGrfpage, 99
SetLevelVis, 99
SetLevelvis (DPL Methods), 1097
AdaptWidth, 1097
Align, 1097
ChangeFont, 1098
ChangeFrameAndWidth, 1098
ChangeLayer, 1098
ChangeRefPoints, 1099
Mark, 1099
Reset, 1099
SetLineFeed, 1021
SetMotorst, 845
SetOcplt, 834
SetOutputWindowState, 1021
SetPath, 856
SetPath (DPL Methods), 1124
AllBreakers, 1125
AllClosedBreakers, 1126
AllOpenBreakers, 1126
GetAll, 1124
GetBranches, 1125
GetBusses, 1124
SetPrj, 64
SetRandSeed, 1035
SetSelect (DPL Methods), 1116
AddRef, 1117
All, 1116
AllAsm, 1120
AllBars, 1119
AllBreakers, 1121
AllClosedBreakers, 1122
AllElm, 1118
AllLines, 1118
AllLoads, 1119
AllOpenBreakers, 1122
AllSym, 1120
AllTypLne, 1121
Clear, 1118
GetAll, 1117
SetShowAllUsers, 1036
SetTime, 149
SetTime (DPL Methods), 1048
Date, 1049
SetTime, 1050
SetTimeUTC, 1050
Time, 1051
Settings
Data Manager, 53
Directories, 55
Editor, 55
Functions, 54
General, 51
Graphic Windows, 52
Output Window, 54
SetTitm, 109
SetTrfdmg, 841
SetTrigger, 157
SetUser, 51
SetValue, 126
SetVilytaxis, 293
SetVilytpage, 293
SetVilytplot, 295
SetViPage, 257
SetVipage (DPL Methods), 1056
DoAutoScaleX, 1062
DoAutoScaleY, 1062
GetScaleObjX, 1065
GetVI, 1057
SetAdaptX, 1064
SetAutoScaleX, 1063
SetDefScaleX, 1061
SetResults, 1058
SetScaleX, 1060
SetStyle, 1057
SetTile, 1058
SetXVar, 1059
Shadow Prices, 725
Short-Circuit Analysis, 427
Adv.Options ANSI, 452
Adv.Options Complete M., 454
Advanced Options IEC/VDE, 448
Basic Options (All Methods), 443
Basic Options ANSI, 450
Basic Options Complete M., 453
Basic Options IEC 61363, 456
Basic Options IEC/VDE, 447
Calculation Method, 443
1264 DIgSILENT PowerFactory 15, User Manual
INDEX
Calculation Options, 443
Executing SC, 439
Explanation ANSI Method, 434
Explanation Complete Method, 436
Explanation IEC/VDE Method, 430
Fault Type, 444
IEC Correction Factors, 432
Line Faults, 441
Multiple Faults, 441
Result Analysis, 457
Technical Background, 428
Verication, 446
Short-Term Flicker, 491
Simulation Results, 513
sin
DPL, 324
DSL, 564
Single Line Graphics, 86
Single Time Phase Contingency Analysis, 611
sinh
DPL, 324
DSL, 564
Sk, 485
Result Variables, 486
Slot, 924
sprintf, 1007
sqr
DPL, 323
DSL, 564
sqrt
DPL, 323
DSL, 564
sscanf, 1008
sscanfsep, 1009
Stability Analysis
Models, 519
Stability and EMT Simulations, 501
Stability Simulation, 501
StaCt, 820
StaCubic (DPL Methods), 1169
GetAll, 1170
GetConnectedMajorNodes, 1169
StaImea, 946
STALNE
DIg Output Language, 1241
StaPqmea, 946
StaSwitch (DPL Methods), 1211
Close, 1211
IsClosed, 1212
IsOpen, 1212
Open, 1212
State Enumeration, 655
State Estimation, 895
Basic Options, 908
Components of SE, 896
Data Input, 899
Executing SE, 907
Objective Function, 896
Result Analysis, 913
StaExtpmea, 914
StaExtqmea, 914
StaExtvmea, 914
Stationware Interface, 356
StaVmea, 947
StaVt, 822
StaVtsec, 824
Step-Size Adaption, 506, 507
Stochastic Models
Busbar, 662
Cable, 662
Common Mode, 664
Line, 662
Terminal, 662
Transformer, 663
StoCommon, 664
StoGen, 684
StoTypbar, 662
StoTyplne, 662
StoTyptrf, 663
strchg, 1011
strcmp, 1010
strcpy, 1010
strftime, 1012
strlen, 1012
strstr, 1010
strtok, 1012
Study Case, 147, 924
Study Time, 149
Study Cases, 147
Study Time, 149
Subplot (VI), 255
SummaryGrid, 1041
Support, 5
Symbols, 1245
Symbols of Elements
Editing and Changing, 110
System Stage, 924
Converting into Variations, 210
tan
DPL, 323
DSL, 564
tanh
DPL, 323
DSL, 564
Tariff Systems for External Grids, 705
Techno Economical Calculation, 739
TechRef, 937
The DIgSILENT Output Language, 1237
The Graphics Editor, 67
this, 322
time
DSL, 564
Time Domain
Reference System, 509
Time Domain Simulation
3 phase EMT Simulation, 504
DIgSILENT PowerFactory 15, User Manual 1265
INDEX
3-phase RMS Simulation, 503
Advanced Options, 507
Balanced RMS Simulation, 503
Basic Options, 505
Calculation Methods, 503
Events, 516
Load Flow, 510
Noise Generation, 510
Result Objects, 511
Run, 518
Setup, 504
Step Size Adaption, 506
Time Domain Simulations, 501
Time Phases, 613
TITLE
DIg Output Language, 1240
Toolbar Denitions, 22
ToStr, 1008
Trace, 633
Transient Analysis, 501
Transients
electromagnetical, 501
electromechanical, 501
long term, 501
TriCont, 220
TriDisc, 219
TriFreq, 220
Trival, 218
trunc
DPL, 323
DSL, 564
TTF (Reliability Analysis), 649
TTR (Reliability Analysis), 649
twopi
DPL, 324
DSL, 564
TypAsm (DPL Methods), 1213
CalcElParams, 1213
TypAsmo (DPL Methods), 1214
CalcElParams, 1214
TypCab, 941
TypCon, 941
TypCt, 821
Type, 924
TypFlicker, 1259
TypGeo, 940
TypHmccur, 468
TypLne, 940
TypLne (DPL Methods), 1214
IsCable, 1214
SetNomCurr, 1214
TypLod, 943
TypLodind, 943
TypPowercurve, 685
TypRec, 944
TypSym, 943
TypTow, 940
TypVt, 825
TypVtsec, 825
UCTE-DEF Interface, 349
User Accounts, 41
User Groups, 41
User Interface, 20
User Settings, 51
Vadility Period, 64
validLDF, 1140
validRMS, 1142
validSHC, 1141
validSIM, 1142
Variable Selection, 247
VARIANT
DIg Output Language, 1240
Variation, 201, 925
Variations (DPL Methods), 1052
CreateStageObject, 1052
GetActiveScheduler, 1053
Vector Diagram
Changing the object, 273
Changing the Variables, 274
Coordinates, 273
Editing the Unit/Tick, 273
Label of Vectors, 273
Origin, 273
X and Y Axes, 272
VecVis, 271
Version, 297
VI
Constant Value, 288
Curve Filter, 290
Curve Input, 280
Dening Styles, 293
Edit Dialogues, 285
Embedded Graphic Windows, 284
Export Curve Data, 291
Export Curve Graphic, 291
FFT Plot, 271
Format Label, 287
Labelling Plots, 285
Plot Style, 295
Pre-dened Style, 296
Status Bar, 285
Straight Line, 290
Styles, 293
Text Label, 286
Tools for Virtual Instruments, 285
User-dened Styles, 293
Value Label, 286
Vector Diagram, 271
Voltage Prole Plot, 274
Waveform Plot, 278
X-Y-Plot, 270
VI Panel
Automatic Arrangement, 258
Automatic Scale Buttons, 258
Background, 261
1266 DIgSILENT PowerFactory 15, User Manual
INDEX
Context Sensitive Menu, 261
Create Virtual Instruments, 261
Default Styles, 261
Dening Styles, 293
Edit, 258
Moving and Resizing, 259
Page Format, 259
Plots, 262
Results, 260
Title Block, 260
Variables of Plots, 259
Virtual Instrument, 925
Virtual Instrument Panel, 925
Virtual Instrument Panels, 257
Virtual Instruments, 235
Types, 255
Types Feeders, 256
Types Harmonics, 257
Types Protection, 256
Virtual Power Plant, 179
VisDefcrv, 280
VisDraw, 861
VisEigen, 589
Viseigen, 589
VisFft, 271
VisFft (DPL Methods), 1085
DoAutoScaleX, 1085
VisHrm, 278
VisLabel, 287
VisModbar, 257, 591
VisModephasor, 593
VisOcplot, 833
VisPath, 274
Creating a Voltage Prole Plot, 274
Custumizing a Voltage Prole Plot, 275
Interpreting a Voltage Prole Plot, 275
Schematic Visualization, 277
VisPlot, 262
Curves, 268
Editing Subplots, 263
Setting the X-Axis, 264
Setting the Y-Axis, 266
VisPlot(2 Y-Axes, 269
VisPlot (DPL Methods), 1066
AddResVars, 1068
AddVars, 1066
Clear, 1068
DoAutoScaleX, 1074
DoAutoScaleY, 1075
DoAutoScaleY2, 1076
GetScaleObjX, 1081
GetScaleObjY, 1083
SetAdaptX, 1079
SetAdaptY, 1080
SetAutoScaleX, 1077
SetAutoScaleY, 1078
SetCrvDesc, 1085
SetDefScaleX, 1073
SetDefScaleY, 1074
SetScaleX, 1070
SetScaleY, 1071
SetXVar, 1069
VisPlot2, 269
VisPlottz, 858
VisValue, 286
VisXvalue, 288
VisXZPlot, 270
Voltage Prole Plot
Creating a Voltage Prole Plot, 274
Custumizing a Voltage Prole Plot, 275
Interpreting a Voltage Prole Plot, 275
Voltage Sag, 747
Advanced Options, 749
Basic Options, 748
Results, 750
Warn, 1022
Waveform Plot, 480
while(){}
DPL, 324
Write, 1022
Zone, 188
DIgSILENT PowerFactory 15, User Manual 1267
INDEX
1268 DIgSILENT PowerFactory 15, User Manual
D
I
G
SILENT
Power Fac t or y
DIgSILENT GmbH
Heinrich-Hertz-Strae 9
72810 Gomaringen
Germany
T +49 7072 9168-0
F +49 7072 9168-88
mail@digsilent.de
www.digsilent.de
DIgSILENT GmbH
Company Profle
DIgSILENT GmbH is a consulting and software
company providing engineering services in
the feld of electrical power systems for
transmission, distribution, generation and
industrial plants.
DIgSILENT GmbH was founded in 1985 and
is a fully independent, privately owned
company located in Gomarigen/Tbingen,
Germany. DIgSILENT continued expansion
by establishing offces in Australia, South
Africa, Italy, Chile, Spain and France, thereby
facilitating improved service following the
world-wide increase in usage of its software
products and services. DIgSILENT has
established a strong partner network in
many countries such as Mexico, Malaysia,
UK, Switzerland, Colombia, Brazil, Peru,
China and India. DIgSILENT services and
software installations have been conducted
in more than 110 countries.
DIgSILENT PowerFactory
DIgSILENT develops the leading integrated
power system analysis software PowerFactory,
which covers the full range of functionality
from standard features to highly sophisticated
and advanced applications including wind
power, distributed generation, real-time
simulation and performance monitoring for
system testing and supervision. For wind
power applications, PowerFactory has
become the power industrys de-facto standard
tool, due to PowerFactory models and
algorithms providing unrivalled accuracy and
performance.
DIgSILENT StationWare is a reliable central
protection settings database and management
system, based on latest .NET technology.
StationWare stores and records all settings
in a central database, allows modelling of
relevant workfow
sequences, provides quick access to relay
manuals, interfaces with manufacturer
specifc relay settings and integrates with
PowerFactory software, allowing for powerful
and easy-to-use settings co-ordination studies.
PowerFactory Monitor is a fexible performance
recording and monitoring system that copes
easily and effciently with the special require-
ments for system test implementation, system
performance supervision and the determination
and supervision of connection characteristics.
Numerous Monitoring Systems installed at
various grid locations can be integrated to a
Wide-Area-Measurement-System (WAMS).
PowerFactory Monitor fully integrates with
PowerFactory software.
DIgSILENT Consulting
DIgSILENT GmbH is staffed with experts of
various disciplines relevant for performing
consulting services, research activities, user
training, educational programs and software
development. Highly specialised expertise is
available in many felds of electrical engi-
neering applicable to liberalised power mar-
kets and to the latest developments in power
generation technologies such as wind power
and distributed generation. DIgSILENT has
provided expert consulting services to several
prominent wind-grid integration studies.