PSS SINCAL Database Interface and...
Transcript of PSS SINCAL Database Interface and...
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 1/162
PSS®SINCAL Database Interface and Automation
This document describes the organization and the structure of the PSS SINCAL database, shows you how to
fill the database with external programs and explains the automation functions of the calculation methods.
1 General Remarks 2
2 Structure of PSS SINCAL Database 4
2.1 PSS SINCAL Networks 4
2.2 Data Model Design Guidelines 5
2.3 Structure of the Database 7
2.4 Database Analysis with the Help of an Example Network 9
2.5 Tables of Network Graphics 18
2.6 Results in the Database 26
3 Filling in the PSS SINCAL Database 29
3.1 Example Program for Filling the Database 29
3.2 Help Program for Creating PSS SINCAL Database 37
4 Automation of the Calculation Methods 42
4.1 Available Automation Functions 48
4.2 Calculation Objects and their Attributes 103
4.3 Parameters of Calculation Methods 145
5 Reference 159
5.1 Documentation 159
5.2 PSS SINCAL Architecture 160
5.3 Ready-Made Solutions 160
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 2/162
1 General Remarks
One of the most important characteristics of PSS SINCAL is the complete transparency of the data.
With standard methods, you can access input data and calculation results at any time, even if you
are not using PSS SINCAL. This transparency is reached by saving all data in a relational database,
necessary for the network planning. Unlike other network planning systems that you only fill when
you "export", PSS SINCAL uses the database as the central storage medium for all your data.
Calculation methods are relatively easily to use for individual solutions because of their open
architecture. Normally, you use an existing PSS SINCAL network that you analyze with a "tool" you
have created. The "tool" can take advantage of all the functions of the PSS SINCAL calculation
methods. You can use any programming or script language you want for your individual solution. The
only prerequisite is that you must be able to access COM functions.
If you use a relational database, you can even couple to a Geographic Information System (GIS),
a Network Information System (NIS) or a network management system. Basically, you distinguish
between a pure calculation solution and one that exports all the data to PSS SINCAL. Which solution
you choose depends on what you want to achieve.
Pure Calculation Solution
The pure calculation solution is also known as the engine solution. Coupling frequently needed for
basic calculation methods (such as, for example, load flow and short circuit) are implemented. Most
of the calculations can be started and used from the source system. In this case, maintaining data,
presenting and displaying results and coloring are all done in the source system.
In this solution, only the technical data from the source system are exported to the PSS SINCAL.
Finally, automation is used to start the desired PSS SINCAL calculation method. The calculation
results are displayed in the source system.
Data Export to PSS SINCAL
The data from the source system are exported to the PSS SINCAL database. Normally, both the
technical data for the equipment and the graphic location data are exported.
This solution uses PSS SINCAL to plan and evaluate networks. The complete range of functions of
the product can be used.
The following illustration shows Mettenmeier GmbH’s coupling solution (see Reference – Ready-
Made Solutions). This is a connection to Smallworld GIS. The illustration shows the same network
area in the GIS and in PSS SINCAL.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 3/162
Generally speaking, this coupling solution is more difficult to implement, since a network diagram has
to be generated in addition to the technical data of the equipment. Even determining the appropriate
amount of detail is difficult: Detailing is normally much greater in GIS than in a network planning
system. A large amount of data might even interfere with the planning. Coupling requires the
appropriate amount of detail for processing and planning in PSS SINCAL to be productive.
The advantages of this solution are, however, in particular in its universality. Here – as mentioned
above – the full PSS SINCAL range of functions for the planning and evaluation of the networks can
be used.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 4/162
2 Structure of PSS SINCAL Database
This chapter describes the structure of the PSS SINCAL database and explains the data model in
detail with the help of a small example network.
2.1 PSS SINCAL Networks
A PSS SINCAL network is made up of a folder pair containing a SIN file and an additional directory.
• {networkname}.sin
• {networkname}_files
The file with extension ".sin" is a PSS SINCAL User Interface help file to simplify network
management. Most network-specific settings of the user interface and the supplementary graphics
objects of the network are stored in this file. When a network is opened with the Open dialog box, this
file is selected.
The directory with the suffix "_files" has all the additional network data. This directory stores the
actual network database, the diagram files, various log files and files with the results.
Example Ele1.sin Example Ele1_files | database.ini | database.mdb | database.dia | \---NETO network.bat network.ctl ...
The file with the ending ".ini " is a configuration file that lets you configure how PSS SINCAL will use
the database.
The file with the extension ".mdb" is the network database in Microsoft Access format. All data that
describe the network are stored in this file.
If you use a server database system such as ORACLE or SQL Server, for example, there is no MDB
file. In this case, the program stores network data directly in the central server database.
Supported Database Systems
Currently following database management systems are supported:
• Microsoft Access
• SQLite 3.x
• Oracle 9i
• Oracle 10g
• Oracle 11g
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 5/162
• SQL Server 2008, SQL Server Express 2008
• SQL Server 2008 R2, SQL Server Express 2008 R2
• SQL Server 2012, SQL Server Express 2012
• SQL Server 2014, SQL Server Express 2014
• SQL Server 2016, SQL Server Express 2016
2.2 Data Model Design Guidelines
The PSS SINCAL Data Model was developed using the following criteria:
• The PSS SINCAL Data Model is object-oriented.
• All objects are unique and respond to the primary key.
• The standardized layout used through most of the program reduces redundancies and simplifies
the search for, and control of, consistency.
• The PSS SINCAL Data Model is separated into categories to simplify evaluations and
management.
• There are no limitations as to how the selected data model is implemented in all the
PSS SINCAL Relational Database Management systems.
Table Names
Appropriate English terms have been selected as table names. PSS SINCAL uses upper- and lower-
case letters to improve legibility.
Essentially, the names of tables differentiate among input data, graphic data, and results.
All tables for input data have appropriate simple names:
• Line
• Infeeder
• TwoWindingTransformer
• etc.
All tables with graphic data begin with "Graphic":
• GraphicElement
• GraphicLayer
• etc.
The tables for result data begin with an abbreviation for the calculation method and end with
"Result":
• LFNodeResult
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 6/162
• LFBranchResult
• SC1NodeResult
• SC1BranchResult
• etc.
Keys
Most of the tables in the PSS SINCAL Data Model have primary keys to uniquely identify data. The
primary key in a table contains the name of the table and has the ending "_ID".
References in the PSS SINCAL Data Model have a secondary key. It includes the name of the
reference table and has the ending "_ID".
The data type of keys is always "LongInteger".
Examples of primary and secondary keys:
• Table Element
Primary key: Element_ID
Secondary key: VoltLevel_ID, Variant_ID
• Table Terminal
Primary key: Terminal_ID
Secondary key: Element_ID, Node_ID
Note: PSS SINCAL uses special algorithms for the management of the key fields. Therefore it is
important to ensure that the IDs are generated ascending starting with the smallest possible ID (1).
Gaps in the IDs are easily possible, but it should be avoided to store very large numbers, because
otherwise problems with PSS SINCAL GUI functions and variant management have to be expected.
Also the direct storage of unique GIS IDs in the primary key fields is not allowed. For this purpose,
the special MasterResource mapping table is available.
Attribute Names
• Whenever possible, attribute names are the same as the corresponding formula sign.
• Attribute names are kept as language-neutral as possible or English terms are used.
• Attribute names are both unique and case-sensitive.
• Numbers replace superscripts and commas (e.g. ' > 1 “ > 2).
• Underscoring ("_") is used as a placement marker for slashes and to connect expressions.
• External and primary keys end with "_ID" (e.g. Element_ID Variant_ID).
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 7/162
2.3 Structure of the Database
The following illustration shows the basic structure of the PSS SINCAL Data Model on the basis of
some selected tables.
Element
PK Element_ID
PK Variant_ID
VoltLevel_ID
EcoStation_ID
EcoField_ID
Flag_Variant
Group_ID
Name
ShortName
Type
Flag_Input
Flag_State
ci
Cs
cm
coo
Ti
Tl
Ts
Load
PK Element_ID
PK Variant_ID
Flag_Variant
Typ_ID
Flag_Load
Flag_LoadType
Flag_Lf
P
Q
u
Ul
S
I
cosphi
Line
PK Element_ID
PK Variant_ID
Flag_Variant
Flag_LineTyp
LineTyp
Typ_ID
Flag_Typ_ID
q
l
r
x
c
Un
ParSys
Flag_Vart
Flag_Mat
Flag_Cond
va
Ith
fn
I1s
Flag_Z0_Input
X0_X1
R0_R1
r0
x0
c0
q0
Terminal
PK Terminal_ID
PK Variant_ID
Element_ID
Node_ID
Flag_Variant
TerminalNo
Flag_State
Flag_Terminal
Node
PK Node_ID
PK Variant_ID
Group_ID
BusbarType_ID
SwitchBay1_ID
SwitchBay2_ID
VoltLevel_ID
Flag_Variant
Flag_Type
Name
ShortName
Un
Ik2
Ip
Uul
Ull
Uref
InclName
The Node table describes the basic network topology. Terminal tables attach node and branch
elements to a node and are used to construct the entire network topology.
At the center of the data model, you have the Element table. This describes the actual network
elements. This table is assigned an additional table for the detailed description of the particular
network element:
• Line: Element + Line
• Consumer: Element + Load
• etc.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 8/162
Input Data Status
The data tables for the elements summarize the data for different calculation methods to keep the
data model from becoming too complex. The data table for the Line, for example, contains the data
for the load flow calculations, short circuit calculations, harmonic calculations, etc.
All network element attributes are separated into categories. This means that, although data supply
summary information in a shared table, data can be selected for a specific calculation method or the
present status of the data can be seen.
The table Element tables have a Flag_Input attribute that stores the current status of the data input
for each category. Flags show what data have or have not been entered. Flags for different
categories can be created with the help of the bit-wise OR-operator.
Electrical Networks
• Bit 0: Short circuit data
• Bit 1: Load flow data
• Bit 2: Zero-phase sequence data
• Bit 3: Negative-phase sequence data
• Bit 4: Harmonics data
• Bit 5: Dynamics data
• Bit 6: Protection data
• Bit 7: Regulator data
• Bit 8: Reliability data
• Bit 9: Supplementary data
• Bit 10: Measurement data
• Bit 11: Motor start-up data
• Bit 12: Transformer regulator data
• Bit 13: Distance protection data
• Bit 14: Generator unit data
• Bit 15: Transformer unit data
• Bit 16: Direct feeder data for generator
• Bit 17: Equivalent element data
• Bit 39: Dynamic data
Pipe Networks
• Bit 24: Flow data
• Bit 25: Water data
• Bit 26: Gas data
• Bit 27: Heating/Cooling data
• Bit 28: Static data
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 9/162
• Bit 30: Equivalent element data
Example for coding short circuit and load flow data for electrical networks:
Bit 0 + Bit 1 = 1 + 2 = 3
2.4 Database Analysis with the Help of an Example Network
The following is an explanation of the data model with the help of a small example network. The
PSS SINCAL user interface is used to create a network and analyze the database.
The network displayed here is created step by step. To see how the data model works, the contents
of the database are analyzed after each processing step. The following steps are needed to create
the example network:
• Step 1: Create a new network
• Step 2: Create network levels
• Step 3: Create busbars
• Step 4: Create the infeeder
• Step 5: Attach the two-winding transformer
• Step 6: Create the line
• Step 7: Attach the consumer
Step 1: Create a New Network
A new schematic electrical network is created in the PSS SINCAL user interface. First File – New is
clicked in the menu.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 10/162
For the example network, the Schematic type of drawing has been selected and the page format set
to A3 Landscape.
Step 2: Create Network Levels
In PSS SINCAL, the network elements need to be assigned to a network level. The network level is
used to specify globally valid data for network elements (e.g. rated voltage in electrical networks).
As a default when you generate a new network, PSS SINCAL automatically creates a network level.
This is filled with standard values and can be customized. Select Insert – Network Level in the
menu.
For the example network, the following network levels are created: LV = 1kV , HV = 10kV
Once the network levels have been created, the VoltageLevel table contains the following values:
VoltageLevel
VoltLevel_ID Name ShortName Un Uop c cmax … Flag_Variant Variant_ID
1 LV 1.0 kV 1,0 1,0 1,1 1,1 1 1
2 HV 10.0 kV 10,0 10,0 1,1 1,1 1 1
Step 3: Create Busbars
Now the nodes or busbars can be created. To do so, click Insert – Node/Busbar – Busbar in the
menu. Finally, both the busbars N1 and N2 are created in the Graphics Editor.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 11/162
Once both busbars have been created, the Node table contains the following values.
Node
Node_ID Group_ID VoltLevel_ID Name Un … Flag_Variant Variant_ID
1 1 2 N1 10,0 1 1
2 1 1 N2 1,0 1 1
Here you can already see the nodes/busbars (Node) are assigned to the network levels
(VoltageLevel) with the secondary key. The busbar N1 has been assigned to the 10 kV network level
HV and given the ID 2. The busbar N2 has been assigned to the 1 kV network level LV and given the
ID 1.
Step 4: Create the Infeeder
The next step is to create an infeeder. PSS SINCAL has various network elements to simulate
infeeders. The following example creates a network infeeder. Click Insert – Node Element –
Infeeder in the menu to start this process.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 12/162
The infeeder is a network element with one single terminal. This network element is therefore
designated as a node element. In the database, the infeeder is described with the following tables:
• Element: This is the basic record for the network element.
• Infeeder: This table contains the specific attributes for the infeeder.
• Terminal: This table creates the connection between the network element and the
nodes/busbars.
Element
Element_ID VoltLevel_ID Group_ID Name Type Flag_Input … Flag_Variant Variant_ID
1 2 1 I1 Infeeder 3 1 1
The basic data for the network element are stored in the Element table. The record contains the
primary key for the network element in the Element_ID field. This assures the network element is
uniquely identifiable.
The VoltLevel_ID field creates a connection to the network level. In this case, this is the 10 kV
network level HV: VoltLevel_ID = 2
The Type field stores the type of network element. This is an ASCII field and contains exactly the
name of the data table for the network element: types = "Infeeder"
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 13/162
The Flag_Input field has the code for the network element’s input status. The binary value 3 is for
the Bit 0 + Bit 1 → short circuit data + load flow data
Infeeder
Element_ID Typ_ID Flag_Typ_ID Flag_Typ Sk2 cact R X …
1 0 0 2 1000,0 1,0 0,0 0,0
The specific data for network supply are stored in the Infeeder table. The secondary key Element_ID
creates the connection to the table Element: Element_ID = 1
Terminal
Terminal_ID Element_ID Node_ID TerminalNo Flag_State … Flag_Variant Variant_ID
1 1 1 1 1 1 1
The Terminal table connects the network element to the nodes/busbars. Use the Element_ID and
Node_ID fields for this. In our example, the infeeder I1 is attached to the busbar N1: Element_ID = 1
, Node_ID = 1
The TerminalNo field is a counter for the connection number. In network supply (= node element)
this is always 1, since this element only has one terminal.
Step 5: Attach the Two-Winding Transformer
Now a two-winding transformer is created between both busbars. Click Insert – Branch Element –
Two-Winding Transformer in the menu to create the element in the Graphics Editor.
The two-winding transformer is a branch element. This means it has two terminals connecting it to
two nodes/busbars. In our example, these are the busbars N1 and N2.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 14/162
This branch element is described in the database with the following tables:
• Element: This is the basic record for the network element.
• TwoWindingTransformer: This table contains the specific attributes of the two-winding
transformer.
• Terminal: This table creates the connection between the network element and the
nodes/busbars.
Element
Element_ID VoltLevel_ID Group_ID Name Type Flag_Input … Flag_Variant Variant_ID
1 2 1 I1 Infeeder 3 1 1
2 2 1 2T2 TwoWinding Transformer
3 1 1
The data in the element table for the two-winding transformer are the same as those previously
described for the infeeder.
As with the infeeder, the Type field stores the network element: Type = "TwoWindingTransformer"
TwoWindingTransformer
Element_ID Typ_ID Flag_Typ_ID Un1 Un2 Sn uk …
2 0 0 10,0 1,0 0,63 8,0
The input data for the two-winding transformer are stored in the TwoWindingTransformer table. The
secondary key Element_ID creates the connection to the table element: Element_ID = 2
Terminal
Terminal_ID Element_ID Node_ID TerminalNo Flag_State … Flag_Variant Variant_ID
1 1 1 1 1 1 1
2 2 1 1 1 1 1
3 2 2 2 1 1 1
The table Terminal is used to create the connection between the network element and the
nodes/busbars. Use the Element_ID and Node_ID fields for this.
The two-winding transformer is a branch element and thus has two terminals. These attach the
transformer 2T2 to the busbars N1 and N2:
• Terminal 1 (Terminal_ID = 2): Element_ID = 2, Node_ID = 1, TerminalNo = 1
• Terminal 2 (Terminal_ID = 3): Element_ID = 2, Node_ID = 2, TerminalNo = 2
Step 6: Create the Line
In the next step, a line is attached to the 1.0 kV busbar. Click Insert – Branch Element – Line in the
menu to create the element in the Graphics Editor.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 15/162
The line is a branch element just like the two-winding transformer. This means this is attached to two
nodes/busbars. In our example, these are the busbar N2 and the node N3.
This branch element is described in the database with the following tables:
• Element: This is the basic record for the network element.
• Line: This table contains the specific attributes for the line.
• Terminal: This table creates the connection between the network element and the
nodes/busbars.
The structure and semantics of the tables are the same as above. For this reason, the tables are only
displayed briefly here. So these are easier to recognize, the new records are colored.
Element
Element_ID VoltLevel_ID Group_ID Name Type Flag_Input … Flag_Variant Variant_ID
1 2 1 I1 Infeeder 3 1 1
2 2 1 2T2 TwoWinding Transformer
3 1 1
3 1 1 L3 Line 3 1 1
Line
Element_ID Typ_ID Flag_Typ_ID q l ParSys Flag_Vart …
3 0 0 0,0 1,0 1 1
Terminal
Terminal_ID Element_ID Node_ID TerminalNo Flag_State … Flag_Variant Variant_ID
1 1 1 1 1 1 1
2 2 1 1 1 1 1
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 16/162
3 2 2 2 1 1 1
4 3 2 1 1 1 1
5 3 3 2 1 1 1
Node
Node_ID Group_ID VoltLevel_ID Name Un … Flag_Variant Variant_ID
1 1 2 N1 10,0 1 1
2 1 1 N2 1,0 1 1
3 1 1 N3 1,0 1 1
Step 7: Attach the Consumer
With attaching a consumer, creating the example network is finished. Click Insert – Node Element –
Load in the menu to create the element in the Graphics Editor.
The consumer is a node element. In our example, this is attached to the node N3.
This node element is described in the database with the following tables:
• Element: This is the basic record for the network element.
• Load: This table contains the specific attributes of the consumer.
• Terminal: This table creates the connection between the network element and the
nodes/busbars.
The structure and semantics of the tables are the same as above.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 17/162
2.4.1 Complete Example Network
The example network presented step by step is now complete.
Below the contents of the important tables are displayed briefly to help illustrate the references of the
data records once again. To make them easier to recognize, network element records are colored
according to their allocation:
• Infeeder: I1
• Two-Winding Transformer: 2T2
• Line: L3
• Consumer: LO4
Node
Node_ID Group_ID VoltLevel_ID Name Un … Flag_Variant Variant_ID
1 1 2 N1 10,0 1 1
2 1 1 N2 1,0 1 1
3 1 1 N3 1,0 1 1
Element
Element_ID VoltLevel_ID Group_ID Name Type Flag_Input … Flag_Variant Variant_ID
1 2 1 I1 Infeeder 3 1 1
2 2 1 2T2 TwoWinding Transformer
3 1 1
3 1 1 L3 Line 3 1 1
4 1 1 LO4 Load 3 1 1
Terminal
Terminal_ID Element_ID Node_ID TerminalNo Flag_State … Flag_Variant Variant_ID
1 1 1 1 1 1 1
VoltageLevel
VoltLevel_ID Name ShortName Un Uop c cmax … Flag_Variant Variant_ID
1 LV 1.0 kV 1,0 1,0 1,1 1,1 1 1
2 HV 10.0 kV 10,0 10,0 1,1 1,1 1 1
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 18/162
2 2 1 1 1 1 1
3 2 2 2 1 1 1
4 3 2 1 1 1 1
5 3 3 2 1 1 1
6 4 3 1 1 1 1
Infeeder
Element_ID Typ_ID Flag_Typ_ID Flag_Typ Sk2 cact R X …
1 0 0 2 1000,0 1,0 0,0 0,0
TwoWindingTransformer
Element_ID Typ_ID Flag_Typ_ID Un1 Un2 Sn uk …
2 0 0 10,0 1,0 0,63 8,0
Line
Element_ID Typ_ID Flag_Typ_ID q l ParSys Flag_Vart …
3 0 0 0,0 1,0 1 1
Load
Element_ID Flag_Load Flag_LoadType P Q u UI …
4 1 2 0,07 0,03 100.0 0.0
2.5 Tables of Network Graphics
The graphics tables describe the network graphic display. This information is, however, only needed
for visualization and processing in the user interface. The graphics tables are not needed for the
network calculations. This means that if you are only using PSS SINCAL calculation methods (e.g.
for an engines solution), you do not need to fill in the graphics tables.
The following list shows the most important PSS SINCAL graphics tables:
• Basic tables for graphics elements
o GraphicNode: Graphics for nodes/busbars
o GraphicElement: Graphics for network element symbols
o GraphicTerminal: Graphics for terminals of network elements
• Additional tables
o GraphicBucklePoint: Buckle points
o GraphicText: Texts
• Basic structures
o GraphicAreaTile: Area and tile
o GraphicLayer: Layers
o GraphicObjectType: Object types
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 19/162
2.5.1 Basic Tables for Graphic Elements
A network's structure is described by its nodes and branches. The branches connect two nodes to
each other. A branch (or branch element) goes from the starting node to the end node. Node
elements are connected to the nodes.
The simple network elements are nodes and busbars. They have only one symbol and text. All
node elements and branch elements are connected to these.
Network elements are more complex graphics elements. They are composed of symbols, terminals
and text.
In our example, a branch element – a two-winding transformer – is selected. As can be seen in this
example, components of the network elements are easy to recognize: the displayed branch element
consists of a symbol, both terminals (linking the symbol to the node) and texts.
Node elements consist of one terminal, a symbol and text.
Branch elements consist of two terminals, a symbol and text.
A special form of branch elements is the three-winding transformer. Unlike all other branch elements,
it connects to three, rather than two, nodes or busbars.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 20/162
GraphicNode (Graphics for Nodes/Busbars)
This table describes the graphics attributes for nodes/busbars.
Attribute name Data type Unit Description
GraphicNode_ID Long Integer Primary Key – Graphic Node
GraphicLayer_ID Long Integer Secondary Key – Layer
GraphicType_ID Long Integer Secondary Key – Object Type
GraphicText_ID1 Long Integer Secondary Key – Text 1
GraphicText_ID2 Long Integer Secondary Key – Text 2
Node_ID Long Integer Secondary Key – Node
FrgndColor Long Integer RGB Line Color
BkgndColor Long Integer RGB Background Color
PenStyle Integer Pen Style 0: Straight line 1: Small dotted 2: Dotted 3: Straight line – point – straight line 4: Straight line – point – point – straight line
PenWidth Integer 0.25mm Pen Width
NodeSize Integer 0.25mm Symbol Size Factor
NodeStartX Double m Node Start X-Coordinate
NodeStartY Double m Node Start Y-Coordinate
NodeEndX Double m Node End X-Coordinate
NodeEndY Double m Node End Y-Coordinate
SymType Integer Node Symbol Type 0: No symbol 1: Circle 2: Rectangle 3: Busbar
Flag Long Integer Flag
Variant_ID Long Integer Secondary Key – Variant
Flag_Variant Integer Element of Current Variant 0: No 1: Yes
GraphicArea_ID Long Integer Secondary Key – Graphic Area/Tile
The secondary key GraphicText_ID1 assigns a graphic text object. This means an individual text
object will be displayed in the Graphics Editor with its own position and graphics attributes. If you
wish, you can initialize the field with "NULL". Then PSS SINCAL will display the text with default
attributes in the Graphics Editor, but the text cannot be edited manually.
The secondary key GraphicText_ID2 is not implemented at this time and should therefore always be
initialized with "NULL".
GraphicElement (Graphics for Network Element Symbols)
This table describes the graphics attributes for network element symbols.
Attribute name Data type Unit Description
GraphicElement_ID Long Integer Primary Key – Graphic Element
GraphicLayer_ID Long Integer Secondary Key – Layer
GraphicType_ID Long Integer Secondary Key – Object Type
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 21/162
GraphicText_ID1 Long Integer Secondary Key – Graphic Text 1
GraphicText_ID2 Long Integer Secondary Key – Graphic Text 2
Element_ID Long Integer Secondary Key – Element
SymbolDef Long Integer Set Symbol Properties as Default
FrgndColor Long Integer RGB Line Color
BkgndColor Long Integer RGB Background Color
PenStyle Integer Pen Style 0: Straight line 1: Small dotted 2: Dotted 3: Straight line – point – straight line 4: Straight line – point – point – straight line
PenWidth Integer 0.25mm Pen Width
SymbolSize Integer 0.25mm Symbol Size Factor
SymCenterX Double m Symbol Center X-Coordinate
SymCenterY Double m Symbol Center Y-Coordinate
SymbolType Long Integer Symbol Type Electrical Networks: 9: Synchronous machine 10: Power unit 11: Infeeder 12: Asynchronous machine 13: Load 15: Shunt impedance
16: Shunt reactor 17: Shunt capacitor 18: Static compensator 19: Line 20: Two-winding transformer 21: Three-winding transformer 22: Serial reactor 23: Serial capacitor 24: Shunt ripple control transmitter 25: Serial ripple control transmitter 26: Shunt RLC circuit 27: Serial RLC circuit 29: Harmonic resonance network 193: DC Infeeder 194: DC Serial element 123: Variable Shunt Element 124: Variable Serial Element Symbol Type Pipe Networks: 9: Water Tower 10: Infeeder Pump 11: Infeeder Gas 12: Infeeder Heating/Cooling 13: Consumer 14: Pressure Buffer 15: Leakage 16: Temperature Regulator 17: Line 18: Pressure Increase Pump 19: Const. Pressure Decrease/Const. Flow 20: Pressure Regulator 21: Compressor 22: Heat Exchanger 23: Sliding Valve/Non-Return Valve
SymbolNo Integer Symbol Number
Flag Long Integer Flag
Variant_ID Long Integer Secondary Key – Variant
Flag_Variant Integer Element of Current Variant 0: No 1: Yes
GraphicArea_ID Long Integer Secondary Key – Graphic Area/Tile
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 22/162
The SymbolType field is particularly important here. It needs to be properly initialized or the graphic
data will not be assigned – or they will be assigned incorrectly – to network element data in the
PSS SINCAL user interface.
The SymbolDef field is used to enhance the control of the network element symbols. For coupling
solutions this should be initialized with "-1".
The secondary key GraphicText_ID1 assigns a graphic text object. This means an individual text
object will be displayed in the Graphics Editor with its own position and graphics attributes. If you
wish, you can initialize the field with "NULL". Then PSS SINCAL will display the text with default
attributes in the Graphics Editor, but the text cannot be edited manually.
The secondary key GraphicText_ID2 is not implemented at this time and should therefore always be
initialized with "NULL".
GraphicTerminal (Graphics for Terminals of Network Elements)
This table describes the graphics attributes for network element terminals.
Attribute name Data type Unit Description
GraphicTerminal_ID Long Integer Primary Key – Graphic Terminal
GraphicElement_ID Long Integer Secondary Key – Graphic Element
GraphicText_ID Long Integer Secondary Key – Graphic Text
Terminal_ID Long Integer Secondary Key – Terminal
PosX Double m X-Coordinate
PosY Double m Y-Coordinate
FrgndColor Long Integer RGB Line Color
PenStyle Integer Pen Style 0: Straight line 1: Small dotted 2: Dotted 3: Straight line – point – straight line 4: Straight line – point – point – straight line
PenWidth Integer 0.25mm Pen Width
SwtType Integer Switch Type 0: No Type 1: Type 1 2: Type 2 3: Type 3 4: Type 4 5: Type 5 6: Type 6
SwtAlign Integer Switch Direction 0: Automatic 1: Position 1 2: Position 2 3: Position 3 4: Position 4
SwtNodePos Double 0.25mm Switch Distance to Node
SwtFactor Integer 0.25mm Switch Size Factor
SwtFrgndColor Long Integer RGB Switch Line Color
SwtPenStyle Integer Switch Pen Style 0: Straight line 1: Small dotted 2: Dotted 3: Straight line – point – straight line 4: Straight line – point – point – straight line
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 23/162
SwtPenWidth Integer 0.25mm Switch Pen Width
SymbolType Integer Symbol Type
SymbolAlign Integer Symbol Direction
SymbolNodePos Double 0.25mm Symbol Distance to Node
SymbolFactor Integer Symbol Size Factor
SymbolFrgndColor Long Integer RGB Symbol Line Color
SymbolPenStyle Integer Symbol Pen Style
SymbolPenWidth Integer 0.25mm Symbol Pen Width
TextAlign Integer Adjust Text
Flag Long Integer Flag
Variant_ID Long Integer Secondary Key – Variant
Flag_Variant Integer Element of Current Variant 0: No 1: Yes
GraphicArea_ID Long Integer Secondary Key – Graphic Area/Tile
The fields Pos_X and Pos_Y define the connection point between the terminal and the node or the
busbar. With a node, this is always the center. With a busbar, this can be anywhere on the busbar.
The secondary key GraphicText_ID assigns a graphic text object. This means an individual text
object will be displayed in the Graphics Editor with its own position and graphics attributes. If you
wish, you can initialize the field with "NULL". Then PSS SINCAL will display the text with default
attributes in the Graphics Editor, but the text cannot be edited manually.
2.5.2 Additional Tables
GraphicText (Text Objects)
This table specifies individual text objects for nodes/busbars and network elements.
Attribute name Data type Unit Description
GraphicText_ID Long Integer Primary Key – Graphic Text
GraphicLayer_ID Long Integer Secondary Key – Layer
Font Text (20) Font
FontStyle Integer Style 16: Standard 17: Fat 18: Cursive
FontSize Integer Text Height
TextAlign Integer Text Alignment 0: Left 1: Middle 2: Right
TextOrient Integer 0,1 ° Text Orientation
TextColor Long Integer RGB Text Color
Visible Integer Visible 0: No 1: Yes
AdjustAngle Integer Adjust Text Angle 0: None 1: Horizontal or vertical 2: Direction of element
Angle Double ° Text Angle
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 24/162
Pos1 Double m Distance X-Direction
Pos2 Double m Distance Y-Direction
Flag Long Integer Flag
RowTextNo Integer 1 Number of Rows
AngleTermNo Integer 1 Partial Terminal Align Number
Variant_ID Long Integer Secondary Key – Variant
Flag_Variant Integer Element of Current Variant 0: No 1: Yes
Caution: A text object may only be used once. You cannot use the same text object for different
elements!
GraphicBucklePoint (Bends for Terminals)
This table specifies bends for network element terminals.
Attribute name Data type Unit Description
GraphicPoint_ID Long Integer Primary Key – Buckle Point
GraphicTerminal_ID Long Integer Secondary Key – Graphic Terminal
NoPoint Integer 1 Buckle Point Number
PosX Double m Buckle Point X-Coordinate
PosY Double m Buckle Point Y-Coordinate
Variant_ID Long Integer Secondary Key – Variant
Flag_Variant Integer Element of Current Variant 0: No 1: Yes
The fields PosX and PosY define the graphic position of the bend.
The NoPoint field determines the sequence of the bends. The bends are numbered sequentially
from the network element’s symbol point to the connection point at the node/busbar.
2.5.3 Basic Structures
GraphicAreaTile (Worksheet Settings)
This table describes the worksheet. Basically, both the page size and the scale are defined.
Attribute name Data type Unit Description
GraphicArea_ID Long Integer Primary Key – Area/Tile
AreaWidth Double cm Page Width
AreaHeight Double cm Page Height
VectorX Double m Zero-Coordinate Placement X
VectorY Double m Zero-Coordinate Placement Y
GridWidth Integer 0.25mm Grid Spacing Width
GridHeight Integer 0.25mm Grid Spacing Height
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 25/162
Scale1 Integer Predefined Scale 0: 1:100000000 1: 1:10000000 2: 1:1000000 3: 1:100000 4: 1:10000 5: 1:1000 6: 1:100 7: 1:10 8: 1:1
Scale2 Integer Display Unit 0: mm 1: cm 2: m 3: km 4: Inch 5: Feet 6: Yards 7: Miles
Flag Long Integer Network Working Mode 1: Geographical 2: Schematic
Variant_ID Long Integer Secondary Key – Variant
ScalePaper Double Scale Paper
ScaleReal Double Scale Real
Name Text (50) Name of View
TileIndex Text (8) Index of Tile
In a PSS SINCAL network, more than one worksheet can be created. Simply create multiple records
in this table. In all graphics tables, the GraphicArea_ID is available as a secondary key. This
specifies which worksheet the respective graphic is assigned to.
GraphicLayer (Graphic Layer)
This table specifies a graphic layer. All screen elements are assigned to a graphic layer. The graphic
layer lets you control which network elements are displayed on the screen.
Attribute name Data type Unit Description
GraphicLayer_ID Long Integer Primary Key – Layer
Name Text (50) Layer Name
Visible Integer Visible 0: Not visible 1: Visible on screen 2: Visible on print 3: Visible on screen and print
Locked Integer Locked for Working 0: No 1: Yes
Type Integer Plot Header 0: No 1: Yes
Flag Long Integer Order Flag
Variant_ID Long Integer Secondary Key – Variant
Flag_Variant Integer Element of Current Variant 0: No 1: Yes
VisibleZF Integer Visible at Zoom Factor
GraphicArea_ID Long Integer Secondary Key – Graphic Area/Tile
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 26/162
GraphicObjectType (Object Type)
An object type is assigned to all graphic network elements. This object type can help control the
legend scope in the network diagram.
Attribute name Data type Unit Description
GraphicType_ID Long Integer Primary Key – Object Type
ParentType_ID Long Integer Secondary Key – Higher-Level Object Type
Name Text (50) Object Type Name
Visible Integer Visible Object Type 0: No 1: Yes
Locked Integer Locked Object Type
Type Integer Object Type
Flag Long Integer Flag (not in use)
Variant_ID Long Integer Secondary Key – Variant
Flag_Variant Integer Element of Current Variant 0: No 1: Yes
VisibleZF Integer Visible at Zoom Factor
2.6 Results in the Database
PSS SINCAL stores calculation results in the database in the same way as input data. This is done
automatically, once a calculation has been performed successfully. The results in the database can
be accessed at any time by your own applications.
The most important tables showing the results for electrical networks are:
• Load flow
o LFNodeResult: Load flow node results
o LFBranchResult: Load flow branch results
o ULFNodeResult: Unbalanced load flow node results
o ULFBranchResult: Unbalanced load flow branch results
o LFGroupResult: Load flow area results
o LFParNetLossesResult: Load flow subnetwork losses results
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 27/162
o LFAccurResult: Load flow accuracy results
• Short circuit
o SC3NodeResult: Node results – 3-phase short circuit
o SC3BranchResult: Branch results – 3-phase short circuit
o SC1NodeResult: Node results – 1-phase short circuit
o SC1BranchResult: Branch results – 1-phase ground fault
• Optimizations
o SeparationResult: Separation results
o InstallCompResult: Compensation power results
• Harmonics and ripple control
o HarBranchResult: Harmonics branch results
o HarNodeResult: Harmonics node results
o HarFilterResult: Harmonics filter results
o RCBranchResult: Branch results – ripple control
o RCNodeResult: Node results – ripple control
o RCTransmitterResult: Transmitter results – ripple control
• Reliability
o RelResult: Reliability node results
o RelNetResult: Reliability network results
o RelGroupResult: Reliability group results
The basic structure of the result tables is displayed according to load flow results. For a detailed
description of all available result tables with their attributes, see the Database Description Manual.
LFNodeResult (Load Flow Node Results)
This table contains node results from load flow calculations. Node results are assigned by the
secondary key Node_ID.
Attribute name Data type Unit Description
Result_ID Long Integer Primary Key – Result
Node_ID Long Integer Secondary Key – Node
Variant_ID Long Integer Secondary Key – Variant
U Double kV Node Voltage
U_Un Double % Node Voltage/Rated Node Voltage
phi Double ° Angle – Slack Voltage
P Double MW Active Power
Q Double Mvar Reactive Power
S Double MVA Apparent Power
t Integer h Key for Time
tdiag Double s Time – Direct Diagram Connection (22:00 = 22 * 3600)
Flag_Result Integer Result Type 0: Load flow 1: Load profile 2: Load development
ResDate Date
ResTime Double h Time
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 28/162
Flag_State Integer State 1: Ok 2: Limit reached
Loading Double 1 Factor due to Extended Calculation
Uph Double kV Phase Node Voltage
Uph_Unph Double % Node Phase Voltage/Rated Node Phase Voltage
phi_ph Double ° Angle – Slack Phase Voltage
U_Uref Double % Voltage/Reference Voltage
Uph_Urefph Double % Phase Voltage/Reference Voltage
LFBranchResult (Load Flow Branch Results)
This table contains branch results from load flow calculations. The results are provided for individual
terminals. Results for network elements are assigned by the secondary key Terminal1_ID.
Attribute name Data type Unit Description
Result_ID Long Integer Primary Key – Result
Terminal1_ID Long Integer Secondary Key – Connection
Terminal2_ID Long Integer Secondary Key – Neighbor Terminal
Variant_ID Long Integer Secondary Key – Variant
P Double MW Active Power
Q Double Mvar Reactive Power
S Double MVA Apparent Power
cos_phi Double pu Power Factor
I Double kA Current
Inb Double % Basic Rating
Pl Double MW Active Power – Losses
Ql Double Mvar Reactive Power – Losses
Sl Double MVA Apparent Power Losses
dU Double kV Series Voltage Drop
deltaphi Double ° Phase Rotation
Sn Double MVA Basic Apparent Power
S_Sn Double % Apparent Power/Basic Apparent Power
Inp Double kA Basic Current – Side 1 (primary)
I_Inp Double % Current/Basic Current – Side 1(primary)
Ins Double kA Basic Current – Side 2 (secondary)
I_Ins Double % Current/Basic Current – Side 2 (secondary)
t Integer h Key for Time
tdiag Double s Time – Direct Diagram Connection (22:00 = 22 * 3600)
Flag_Result Integer Result Type 0: Load flow 1: Load profile 2: Load development
ResDate Date
ResTime Double h Time
Flag_State Integer State 1: Ok 2: Limit reached
Inb1 Double % First Additional Rating
Inb2 Double % Second Additional Rating
Inb3 Double % Third Additional Rating
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 29/162
3 Filling in the PSS SINCAL Database
This chapter explains how to fill the PSS SINCAL database manually with your own applications.
3.1 Example Program for Filling the Database
When you install PSS SINCAL, there is an example program that teaches you how to fill the
database. The example program has been written in VBS (Visual Basic Script). This can be executed
with the standard Windows Scripting Host and without any additional software on all current Windows
platforms.
The "ImportDB.vbs" example program is in the PSS SINCAL "Batch" directory.
Simply enter the example program at the prompt to start. If you do not add any additional
parameters, PSS SINCAL will display hints on how to use this:
>cscript.exe ImportDB.vbs Usage: cscript.exe ImportDB.vbs ImportDB.mdb SincalDB.mdb MODE MODE: E ... Import data for Electricity MODE: W ... Import data for Water This program reads data from ImportDB and writes the data into the SincalDB.
To import data, you need a prepared database with import data ImportDB.mdb and the appropriate
PSS SINCAL network database SincalDB.mdb. The MODE parameter differentiates between
electrical networks and pipe networks.
Start "ImportDB.vbs" with the correct parameters:
>cscript.exe ImportDB.vbs EleData.mdb EleTest.mdb E Init IDs... Reading Nodes... Reading Lines... Reading Loads... Reading Transformers... Writing Data... Node: 27/27 Element: 48/48 Terminal: 82/82 Line: 32/32 TwoWindingTransformer: 2/2 Load: 14/14 GraphicNode: 27/27 GraphicTerminal: 82/82 GraphicElement: 48/48 Successfully finished import to D:\Network\_Import\GIS\EleTest.mdb. Inserted 362 records in 0.01 seconds.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 30/162
3.1.1 How the Example Program Works
The basic sequence of functions in the example program is relatively simple:
• First common initializations are performed.
• Then data from the sources database are read out and converted to appropriate data structures.
• Finally, data are written to the PSS SINCAL network database using SQL instructions.
In the source text, this looks as follows:
' Execute the selected option Select Case strParam Case "E" bElectro = True Call InitIDs() Call ReadNodes( 1 ) Call ReadLines( 1 ) Call ReadLoads( 1 ) Call ReadTransformers( 1 ) Case "W" bElectro = False Call InitIDs() Call ReadFlowNodes( 1 ) Call ReadFlowLines( 1 ) Case Else Call Usage() End Select If ErrorCheck( "Error while reading input data!" ) Then WScript.Quit ' Write data from arrays to SINCAL database Call WriteSINCAL() If ErrorCheck( "Error while writing data!" ) Then WScript.Quit
Perform Initializations – InitIDs
InitIDs determines the initial values for the primary keys. The corresponding PSS SINCAL network
database tables are opened and the maximum value for the primary key is determined. These values
are then stored as global variables.
'------------------------------------------------------------------------------ ' Init startIDs for DB & Init base table names '------------------------------------------------------------------------------ Sub InitIDs WScript.Echo "Init IDs..." Call OpenDatabase( strSINCALdb ) If bElectro = True Then strTableNode = "Node" strTableElement = "Element" strTableTerminal = "Terminal" strTableGraphicText = "GraphicText" strTableGraphicNode = "GraphicNode" strTableGraphicElement = "GraphicElement" strTableGraphicTerminal = "GraphicTerminal" Else strTableNode = "FlowNode" strTableElement = "FlowElement" strTableTerminal = "FlowTerminal" strTableGraphicText = "FlowGraphicText" strTableGraphicNode = "FlowGraphicNode" strTableGraphicElement = "FlowGraphicElement" strTableGraphicTerminal = "FlowGraphicTerminal"
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 31/162
End If iNodeID = 1 + ReadMaxID( strTableNode, "Node_ID" ) iElementID = 1 + ReadMaxID( strTableElement, "Element_ID" ) iTerminalID = 1 + ReadMaxID( strTableTerminal, "Terminal_ID" ) iGraphicTextID = 1 + ReadMaxID( strTableGraphicText, "GraphicText_ID" ) iGraphicNodeID = 1 + ReadMaxID( strTableGraphicNode, "GraphicNode_ID" ) iGraphicElementID = 1 + ReadMaxID( strTableGraphicElement, "GraphicElement_ID" ) iGraphicTerminalID = 1 + ReadMaxID( strTableGraphicTerminal, "GraphicTerminal_ID" ) Call CloseDatabase() End Sub
Read out Node Data from the Database – ReadNodes & AddNode
ReadNodes reads the node data from the sources database and converts this to PSS SINCAL
format. When the data are converted, they generate the proper SQL command at the same time.
'------------------------------------------------------------------------------ ' Read Node data from IMPORT DB '------------------------------------------------------------------------------ Sub ReadNodes( iMode ) ' iMode = 1 ... Normal Mode, 0 ... Only init Dim rsNode If iMode = 0 And iCntNode > 0 then Exit Sub WScript.Echo "Reading Nodes..." Call OpenDatabase(strIMPORTdb) Call OpenRecordset( "SELECT Name AS ID, Name, ShortName, NodeType, NetworkLevel, … & "FROM Node", rsNode ) If Not rsNode.EOF And Not rsNode.BOF Then Dim iRet rsNode.MoveFirst Dim pt Set pt = New Point Do While Not rsNode.EOF ' Names Dim strName, strShortName strName = CStr( rsNode("Name") ) strShortName = Left( rsNode("ShortName"), 8 ) ' VoltageLevel/NetworkLevel & NetworkGroup Dim iLevelID, iGroupID iLevelID = GetVoltageLevel( CDbl( rsNode("Un") ) ) iGroupID = 1 ' Type of Node Dim iType iType = GetNodeType( rsNode("NodeType") ) ' Position & Height Dim dSh dSh = 1.0 pt.SetXY CDbl( rsNode("hr") ), CDbl( rsNode("hh") ) ' Add data of node to internal arrays iRet = InsertIntoNodeArray( CStr( rsNode("ID") ), iNodeID, pt, iLevelID ) if iMode = 1 Then Dim iNID iNID = AddNode( strName, strShortName, iLevelID, iGroupID, iType, pt.x, …
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 32/162
If Not pt.IsEmptyPoint Then iRet = AddGraphicNode( iNID, 1, pt, pt ) End If Else iNodeID = iNodeID + 1 End If rsNode.MoveNext Loop Set pt = Nothing End If Call CloseRecordset( rsNode ) Call CloseDatabase() End Sub
Records are selected from the ImportDatabase with following SQL command:
Call OpenRecordset( "SELECT Name AS ID, Name, ShortName, NodeType, NetworkLevel, Un, hr, hh " _ & "FROM Node", rsNode )
These records are processed in a loop and stored to an internal list using AddNode.
'------------------------------------------------------------------------------ ' Add Node '------------------------------------------------------------------------------ Function AddNode( strName_, strShortName_, iVoltLevelID_, iGroupID_, iType_, dHr_, dHh_, dSh_ ) Dim iRet If bElectro Then iRet = InsertIntoArray( arrNode, iCntNode, _ "insert into " & strTableNode & "( Node_ID, VoltLevel_ID, Group_ID, Name, … & iNodeID & "," _ & iVoltLevelID_ & "," _ & iGroupID_ & "," _ & "'" & strName_ & "'," _ & "'" & strShortName_ & "'," _ & iType_ & "," _ & dHr_ & "," _ & dHh_ & "," _ & dSh_ & "," _ & "1,1 )" ) Else iRet = InsertIntoArray( arrNode, iCntNode, _ "insert into " & strTableNode & "( Node_ID, NetworkLevel_ID, Group_ID, Name, … & iNodeID & "," _ & iVoltLevelID_ & "," _ & iGroupID_ & "," _ & "'" & strName_ & "'," _ & "'" & strShortName_ & "'," _ & iType_ & "," _ & dHr_ & "," _ & dHh_ & "," _ & dSh_ & "," _ & "1,1 )" ) End If AddNode = iNodeID iNodeID = iNodeID + 1 End Function
AddNode is actually very simple. At each call, the parameters generate a SQL string that is entered
in the arrNode array. The SQL commands that are generated look as follows:
insert into Node( Node_ID, VoltLevel_ID, Group_ID, Name, ShortName, Flag_Type,
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 33/162
hr, hh, sh, Variant_ID, Flag_Variant) values ( 1,2,1,'K1','K1',2,7750,21500,1,1,1 ) insert into GraphicNode( GraphicNode_ID, GraphicLayer_ID, GraphicType_ID, GraphicText_ID1, Node_ID, NodeStartX, NodeStartY, NodeEndX, NodeEndY, SymType, FrgndColor, BkgndColor, PenStyle, PenWidth, NodeSize, Flag, Flag_Variant, Variant_ID ) values ( 1,1,1,1,1,7750,21500,7750,21500,1,0,-1,0,2,4,0,1,1 ) insert into GraphicText( GraphicText_ID, GraphicLayer_ID, Font, FontStyle, FontSize, TextAlign, TextOrient, TextColor, Visible, AdjustAngle, Angle, Pos1, Pos2, Flag, RowTextNo, AngleTermNo, Variant_ID, Flag_Variant ) values ( 1,1,'Arial',17,11,3,0,0,1,0,0,0.25,0.25,0,0,0,1,1 )
This command show that you do not need to fill in all the table attributes. It is sufficient to fill the key
attributes (highlighted above). Basically, these are the primary key, secondary key and the variant
code. PSS SINCAL automatically fills in all the other attributes with the default values (if they have
not already been filled in).
Read out Line Data from the Database – ReadLines
ReadLines reads out the line data from the sources database and converts this to PSS SINCAL
format. As with ReadNodes, it generates the appropriate SQL commands when it converts the data.
Reading out and processing the network element data is, however, more complicated, since more
tables need to be filled as with lines.
'------------------------------------------------------------------------------ ' Read Line data from IMPORT db '------------------------------------------------------------------------------ Sub ReadLines( iMode ) ' iMode = 1 ... Normal Mode, 0 ... Only init Dim rsLine Call ReadNodes( 0 ) WScript.Echo "Reading Lines..." Call OpenDatabase(strIMPORTdb) Call OpenRecordset( "SELECT Node1 AS Node_ID1, Node2 AS Node_ID2, Name AS ID, Name, " _ & "'' As ShortName, "0 As Nr, l AS LineLength, r, x, c, Un, " _ & Ith, 'ON' AS Status, 'ON' AS Switch1, 'ON' AS Switch2 " _ & "FROM Line", rsLine ) If Not rsLine.EOF and Not rsLine.BOF Then Dim iRet rsLine.MoveFirst Dim iTempNodeID iTempNodeID = 0 Dim Node1, Node2 Set Node1 = New Node Set Node2 = New Node Do While Not rsLine.EOF Dim bIsVaid bIsVaid = True Set Node1 = dctNodes.Item( CStr( rsLine("Node_ID1") ) ) Set Node2 = dctNodes.Item( CStr( rsLine("Node_ID2") ) ) ' Skip bad objects If IsEmpty( Node1 ) Or IsEmpty( Node2 ) Or Node1.iID = Node2.iID Then bIsVaid = False
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 34/162
End If If IsNull( rsLine("LineLength") ) Then bIsVaid = False End If If bIsVaid Then ' VoltageLevel/NetworkLevel & NetworkGroup Dim iLevelID, iGroupID iLevelID = Node1.iLevel iGroupID = 1 ' Check if there are multiple line segments – in this case we must add new nodes Dim strName, strShortName, strFullName, iNr, iCntNr strName = CStr( rsLine("Name") ) strShortName = Left( rsLine("ShortName"), 8 ) strFullName = CStr( rsLine("Node_ID1") & "|" & rsLine("Node_ID2") & "|" … If dctLineSegments.Exists( strFullName ) Then iCntNr = dctLineSegments.Item( … If Not IsNull( rsLine("Nr") ) Then iNr = CLng( rsLine("Nr") ) Else iNr = 0 … Dim iInternalID1, iInternalID2 iInternalID1 = Node1.iID iInternalID2 = Node2.iID If iCntNr > 1 Then If iNr = 1 Then iTempNodeID = iNodeID iInternalID2 = iTempNodeID ElseIf iNr = iCntNr Then iInternalID1 = iTempNodeID iTempNodeID = 0 Else iInternalID1 = iTempNodeID iTempNodeID = iNodeID iInternalID2 = iTempNodeID End If Else iTempNodeID = 0 End If If iTempNodeID > 0 Then Dim strTempName strTempName = "K" & iNodeID iRet = AddNode( strTempName, strTempName, iLevelID, iGroupID, 1, 0.0, … End If ' Process standard type mapping Dim iStandardType, iFlagStandardType iStandardType = 0 iFlagStandardType = 0 ' Map the input status of the element Dim iState iState = GetElementState( rsLine("Status") ) ' Get Switches Dim iTermState1, iTermState2 iTermState1 = GetSwitchState( CStr( rsLine("Switch1") ) ) iTermState2 = GetSwitchState( CStr( rsLine("Switch2") ) ) Dim iEleID, iTermID1, iTermID2 iEleID = AddElement( "Line", strName, strShortName, iLevelID, iGroupID, … iTermID1 = AddTerminal( iEleID, iInternalID1, 1, 7, iTermState1 ) iTermID2 = AddTerminal( iEleID, iInternalID2, 2, 7, iTermState2 ) iRet = InsertIntoArray( arrLine, iCntLine, _ "insert into Line ( Element_ID, Typ_ID, Flag_Typ_ID, l, r, x, c, " _ & "Un, Ith ) values ( " _ & iEleID & "," _ & iStandardType & "," _ & iFlagStandardType & "," _
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 35/162
& rsLine("LineLength") & "," _ & rsLine("r") & "," _ & rsLine("x") & "," _ & rsLine("c") & "," _ & rsLine("Un") & "," _ & rsLine("Ith") _ & " )" ) If Not Node1.IsPosEmpty() And Not Node2.IsPosEmpty() Then Dim iGraEleID, iGraTermID1, iGraTermID2 iGraEleID = AddGraphicElement( iEleID, 19, Node1.ptPos, Node2.ptPos ) iGraTermID1 = AddGraphicTerminal( iTermID1, iEleID, iGraEleID, Node1.ptPos ) iGraTermID2 = AddGraphicTerminal( iTermID2, iEleID, iGraEleID, Node2.ptPos ) End If End If rsLine.MoveNext Loop Set Node1 = Nothing Set Node2 = Nothing End If Call CloseRecordset( rsLine ) Call CloseDatabase() End Sub
The following SQL command reads out the line data from the import database:
Call OpenRecordset( "SELECT Node1 AS Node_ID1, Node2 AS Node_ID2, Name AS ID, Name, " _ & "'' As ShortName, "0 As Nr, l AS LineLength, r, x, c, Un, " _ & Ith, 'ON' AS Status, 'ON' AS Switch1, 'ON' AS Switch2 " _ & "FROM Line", rsLine )
Records selected in this way are processed in a program loop. For each line record, it creates the
appropriate SQL insert commands. Basically, the following commands are used:
iEleID = AddElement( "Line", strName, strShortName, iLevelID, iGroupID, 3, iState ) iTermID1 = AddTerminal( iEleID, iInternalID1, 1, 7, iTermState1 ) iTermID2 = AddTerminal( iEleID, iInternalID2, 2, 7, iTermState2 ) iRet = InsertIntoArray( arrLine, iCntLine, _ "insert into Line ( Element_ID, Typ_ID, Flag_Typ_ID, l, r, x, c, " _ & "Un, Ith ) values ( " _ & iEleID & "," _ & iStandardType & "," _ & iFlagStandardType & "," _ & rsLine("LineLength") & "," _ & rsLine("r") & "," _ & rsLine("x") & "," _ & rsLine("c") & "," _ & rsLine("Un") & "," _ & rsLine("Ith") _ & " )" )
The network diagram for the line is generated with the following commands:
iGraEleID = AddGraphicElement( iEleID, 19, Node1.ptPos, Node2.ptPos ) iGraTermID1 = AddGraphicTerminal( iTermID1, iEleID, iGraEleID, Node1.ptPos ) iGraTermID2 = AddGraphicTerminal( iTermID2, iEleID, iGraEleID, Node2.ptPos )
The SQL commands that are generated to create line data look as follows:
insert into Element( Element_ID, VoltLevel_ID, Group_ID,
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 36/162
Name, ShortName, Type, Flag_Input, Flag_State, Variant_ID, Flag_Variant ) values ( 1,1,1,'L10','','Line',3,1,1,1 ) insert into Line( Element_ID, Typ_ID, Flag_Typ_ID, l, r, x, c, Un, Ith ) values ( 1,0,0,2.934134593,0.05,0.21,0,10,0.35 ) insert into Terminal( Terminal_ID, Element_ID, Node_ID, TerminalNo, Flag_Terminal, Flag_State, Variant_ID, Flag_Variant ) values ( 1,1,2,1,7,1,1,1 ) insert into Terminal( Terminal_ID, Element_ID, Node_ID, TerminalNo, Flag_Terminal, Flag_State, Variant_ID, Flag_Variant ) values ( 2,1,4,2,7,1,1,1 ) insert into GraphicElement( GraphicElement_ID,GraphicLayer_ID,GraphicType_ID, GraphicText_ID1,Element_ID,SymbolDef, FrgndColor,BkgndColor,PenStyle,PenWidth,SymbolSize, SymCenterX,SymCenterY,SymbolType,SymbolNo,Flag, Variant_ID,Flag_Variant) values ( 1,1,1,28,1,-1,0,-1,0,1,100,12250,22125,19,0,1,1,1 ) insert into GraphicTerminal( GraphicTerminal_ID, GraphicElement_ID, GraphicText_ID, Terminal_ID, PosX, PosY, FrgndColor, PenStyle, PenWidth, SwtType, SwtAlign, SwtNodePos, SwtFactor, SwtFrgndColor, SwtPenStyle, SwtPenWidth, SymbolType, SymbolAlign, SymbolNodePos, SymbolFactor, SymbolFrgndColor, SymbolPenStyle, SymbolPenWidth ,TextAlign, Flag, Variant_ID, Flag_Variant ) values ( 1,1,29,1,11250,21500,0,0,1,0,4,20,80,-1,0,1,0,4,40,80,-1,0,1,292,0,1,1 ) insert into GraphicTerminal( GraphicTerminal_ID, GraphicElement_ID, GraphicText_ID, Terminal_ID, PosX, PosY, FrgndColor, PenStyle, PenWidth, SwtType, SwtAlign, SwtNodePos, SwtFactor, SwtFrgndColor, SwtPenStyle, SwtPenWidth, SymbolType, SymbolAlign, SymbolNodePos, SymbolFactor, SymbolFrgndColor, SymbolPenStyle, SymbolPenWidth ,TextAlign, Flag, Variant_ID, Flag_Variant ) values ( 2,1,30,2,13250,22750,0,0,1,0,4,20,80,-1,0,1,0,4,40,80,-1,0,1,292,0,1,1 ) insert into GraphicText( GraphicText_ID, GraphicLayer_ID, Font, FontStyle, FontSize, TextAlign, TextOrient, TextColor, Visible, AdjustAngle, Angle, Pos1, Pos2, Flag, RowTextNo, AngleTermNo, Variant_ID, Flag_Variant ) values ( 28,1,'Arial',17,11,3,0,0,1,0,0,0.25,0.25,0,0,0,1,1 ) insert into GraphicText( GraphicText_ID, GraphicLayer_ID, Font, FontStyle, FontSize, TextAlign, TextOrient, TextColor, Visible, AdjustAngle, Angle, Pos1, Pos2, Flag, RowTextNo, AngleTermNo, Variant_ID, Flag_Variant ) values ( 29,1,'Arial',17,11,3,0,0,1,0,0,0.25,0.25,0,0,0,1,1 ) insert into GraphicText( GraphicText_ID, GraphicLayer_ID, Font, FontStyle, FontSize, TextAlign, TextOrient, TextColor, Visible, AdjustAngle, Angle, Pos1, Pos2, Flag, RowTextNo, AngleTermNo, Variant_ID, Flag_Variant ) values ( 30,1,'Arial',17,11,3,0,0,1,0,0,0.25,0.25,0,0,0,1,1 )
Save Read out Data – WriteSINCAL
WriteSINCAL writes data already read out and converted to SQL insert commands to the
PSS SINCAL network database.
'------------------------------------------------------------------------------ ' Insert data into SINCAL database
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 37/162
'------------------------------------------------------------------------------ Sub WriteSINCAL() WScript.Echo "Writing Data..." Call OpenDatabase( strSINCALdb ) ' Nodes Call InsertRecords( iCntNode, arrNode, "Node: " ) ' Element & Terminal Call InsertRecords( iCntElement, arrElement, "Element: " ) Call InsertRecords( iCntTerminal, arrTerminal, "Terminal: " ) ' Lines Call InsertRecords( iCntLine, arrLine, "Line: " ) ' Transfomer Call InsertRecords( iCntTransformer, arrTransformer, "TwoWindingTransformer: " ) ' Load & Customer data Call InsertRecords( iCntLoad, arrLoad, "Load: " ) ' Graphics Call InsertRecords( iCntGraphicNode, arrGraphicNode, "GraphicNode: " ) Call InsertRecords( iCntGraphicText, arrGraphicText, "GraphicText: " ) Call InsertRecords( iCntGraphicTerminal, arrGraphicTerminal, "GraphicTerminal: " ) Call InsertRecords( iCntGraphicElement, arrGraphicElement, "GraphicElement: " ) Call CloseDatabase() End Sub
3.2 Help Program for Creating PSS SINCAL Database
For your own coupling solutions, you need to fill a blank PSS SINCAL network database with your
own data. For this purpose, PSS SINCAL installation has the SinDBCreate.exe help program.
SinDBCreate lets you create PSS SINCAL network databases as well a standard and protection
device databases without the PSS SINCAL user interface.
The program must be started in a command prompt. There is no graphic user interface, i.e. start
parameters control the program. Different settings from the PSS SINCAL Registry are also used (e.g.
Oracle database configuration), if these have not been entered as parameters.
When you the start the program without parameters, PSS SINCAL displays the following information:
C:\> SinDBCreate.exe Usage: SinDBCreate /DBSYS:xxx /FILE:xxx /TYPE:xxx [Options] Create a new SINCAL-Database. SinDBCreate /LIST /DBSYS:xxx /ADMIN:User/Password /SRV:xxx List all Databases on a server. SinDBCreate /DELETE /DBSYS:xxx /FILE:xxx /ADMIN:User/Password /SRV:xxx Delete a SINCAL-Database on a database server. /DBSYS:{ACCESS|SQLITE|ORACLE|SQLSERVER|SQLEXPRESS} Database-System /FILE:{Database} MS Access: Path and FileName of the MDB-File SQL Server Express: Path and Filename of the MDF-Datafile SQLITE: Path and Filename of the DB-Datafile ORACLE: User/Password@Instance SQL Server: Database@Instance
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 38/162
/ADMIN:User/Password Administrator-Login for Database-Servers /USER:User/Password Login Information for Database-Servers /SRV:Instance Database Service Name/Server Name /TYPE:{E|W|G|H} Network-Type (E)lectro|(W)ater|(G)as|(H)eating [/DB:{NET|STD|PROT}] Database-Type (Network-Database is default] [/DATA] Fills STD-DB and Prot-DB with default data [/LANG:{ENG|GER}] Language for database (default is ENG) [/SIN:Filename] Path and filename of the SIN-file.
Create a PSS SINCAL Database
The main function of SinDBCreate is to create PSS SINCAL databases. All the settings needed for
this must be indicated as parameters.
SinDBCreate /DBSYS:xxx /FILE:xxx /TYPE:xxx [Options] Create a new SINCAL-Database.
Required Parameters
/DBSYS:{ACCESS|SQLITE|ORACLE|SQLSERVER|SQLEXPRESS} Database-System /FILE:{Database} MS Access: Path and FileName of the MDB-File SQL Server Express: Path and Filename of the MDF-Datafile SQLITE: Path and Filename of the DB-Datafile ORACLE: User/Password@Instance SQL Server: Database@Instance /ADMIN:User/Password Administrator-Login for Database-Servers /USER:User/Password Login Information for Database-Servers /SRV:Instance Database Service Name/Server Name /TYPE:{E|W|G|H} Network-Type (E)lectro|(W)ater|(G)as|(H)eating
Optional Parameters
[/DB:{NET|STD|PROT}] Database-Type (Network-Database is default] [/DATA] Fills STD-DB and Prot-DB with default data [/LANG:{ENG|GER}] Language for database (default is ENG) [/SIN:Filename] Path and filename of the SIN-file.
The DBSYS parameter determines which database system is used. You can select between
ACCESS (Microsoft Access), SQLITE, ORACLE, SQLSERVER (SQL Server) and SQLEXPRESS
(SQL Server Express).
The FILE parameter designates the PSS SINCAL database name. Depending on which database
system is used, this parameter must be entered in different ways. In Microsoft Access, SQLite and
SQL Server Express, you need the complete path and file name. In Oracle, you need the user name,
password and server name in the format "User/Password/@Server". When you use the SQL Server,
you need the database name and server name in the format "DBName@Server".
ADMIN is required for Oracle and SQL Server database systems. This is needed for the main user
managing the PSS SINCAL networks. This parameter is defined in the format "User/Password". If
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 39/162
this parameter has not been entered, the settings are loaded from the PSS SINCAL registry.
USER is required when the SQL Server is used as a database system. This provides information on
who is using the SQL Server and is defined in the format "User/Password".
SRV is used to explicitly enter the database server. If this parameter has not been entered, the
server name is loaded from the PSS SINCAL registry.
The TYPE parameter indicates the network type. You can select E (electricity), W (water), G (gas)
and H (district heating/district cooling) networks.
All other parameters are optional and control the generation procedure.
To define the type of database to be created, use the parameter for DB. The default is network
database (NET). Additional values for these parameters are STD for standard type database and
PROT for protection device database.
The DATA parameter fills the standard database or protection-device database with standard types
or standard devices.
LANG lets you select the language (English, German) of the network database.
SIN lets you enter the PSS SINCAL network file. This parameter is only for creating network
databases.
Example of Creating a Network Database
C:\> SinDBCreate.exe /DBSYS:ACCESS /FILE:C:\Temp\dbnet.mdb /TYPE:E
The above example creates the Access database "dbnet.mdb" for an electrical network in the
"C:\Temp" directory in English.
Example of Creating a Standard Database
C:\> SinDBCreate.exe /DBSYS:ORACLE /FILE:OraSTDFL/pwd123@ORA10 /TYPE:W /ADMIN:SINCAL/SINCAL /DB:STD /DATA
In the above example, an Oracle standard database has been created for pipe networks in English.
This database has "OraSTDFL" for the Oracle user and the password "pwd123". Additionally the
database is filled with standard types.
Example of Creating a Protection Devices Database
C:\> SinDBCreate.exe /DBSYS:ACCESS FILE:C:\Temp\stdprot.mdb /TYPE:E /DB:PROT
The above example creates an Access protection device database for electrical networks in English.
The "stdprot.mdb" database is created in the directory "C:\Temp". An empty database is created.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 40/162
List PSS SINCAL Databases
In addition to creating PSS SINCAL databases, the SinDBCreate help program can be used to list all
the databases at a database server. Switch ON this function with the LIST parameter.
SinDBCreate /LIST /DBSYS:xxx /ADMIN:User/Password /SRV:xxx List all Databases on a server.
Required Parameters
/DBSYS:{ORACLE|SQLSERVER} Database-System /ADMIN:User/Password Administrator-Login for Database-Servers /SRV:Instance Database Service Name/Server Name
The DBSYS parameter determines which database system is used. You can select between
ORACLE and SQLEXPRESS (SQL Server).
ADMIN is required for Oracle and SQL Server database systems. This is needed for the main user
managing the PSS SINCAL networks. This parameter is defined in the format "User/Password". If
this parameter has not been entered, the settings are loaded from the PSS SINCAL registry.
SRV is used to explicitly enter the database server. If this parameter has not been entered, the
server name is loaded from the PSS SINCAL registry.
Example
C:\> SinDBCreate /LIST /DBSYS:ORACLE /ADMIN:SINCAL/SINCAL /SRV:ORA10
The above example lists all available PSS SINCAL databases. First of all a connection to the
ORACLE instance with the name "ORA10" and the user "SINCAL" is established. If the connection is
successful the available databases are displayed line by line.
Delete a PSS SINCAL Database
In addition to creating PSS SINCAL databases, the SinDBCreate help program can be used to delete
a PSS SINCAL database at a database server. Switch this function ON with the DELETE parameter.
SinDBCreate /DELETE /DBSYS:xxx /FILE:xxx /ADMIN:User/Password /SRV:xxx Delete a SINCAL-Database on a database server.
Required Parameters
/DBSYS:{ORACLE|SQLSERVER} Database-System /FILE:{Database} ORACLE: User SQL Server: Database /ADMIN:User/Password Administrator-Login for Database-Servers /SRV:Instance Database Service Name/Server Name
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 41/162
The DBSYS parameter determines which database system is used. You can select between
ORACLE and SQLSERVER (SQL Server).
The FILE parameter designates the PSS SINCAL database name. Depending on which database
system is used, this parameter must be entered in different ways. When using Oracle, enter the user
name. When using the SQL Server, enter the database name.
ADMIN is required for Oracle and SQL Server database systems. This is needed for the main user
managing the PSS SINCAL networks. This parameter is defined in the format "User/Password". If
this parameter has not been entered, the settings are loaded from the PSS SINCAL registry.
SRV is used to explicitly enter the database server. If this parameter has not been entered, the
server name is loaded from the PSS SINCAL registry.
Example
C:\> SinDBCreate /DELETE /DBSYS:ORACLE /FILE:SINCAL_TEST /ADMIN:SINCAL/SINCAL /SRV:ORA10
The above example deletes the PSS SINCAL "SINCAL_TEST" database. First of all a connection to
the ORACLE instance with the name "ORA10" and the user "SINCAL" is established. Deleting the
PSS SINCAL database cannot be undone.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 42/162
4 Automation of the Calculation Methods
The PSS SINCAL architecture is based on a system of different components that use COM functions
to communicate (see Reference – PSS SINCAL Architecture). This chapter explains how the
calculation methods can be integrated into own applications with the help of COM functions.
Excerpts of codes and examples are explained with the help of the Windows Scripting Host (WSH),
since this has the simplest syntax and is normally available directly in the current operating systems.
Any programming language that supports COM functions (e.g. VisualBasic, VBA, C++, etc.) can be
used for the automation functions.
The calculation methods' open design can help you solve a variety of different problems. Basically,
however, you need to differentiate between integration into external applications and the use in
own solutions.
Integrating the Calculation Methods into External Applications
This type of automation is primarily used for integrated solutions in GIS, NIS or SCADA systems. You
start the PSS SINCAL calculations directly from the respective source system. All the data
maintenance and processing and the visualization of the results is done directly in the source
system.
This automation solution integrates the calculation methods directly into the source system. They are
connected by COM interface, where the calculation methods can be used either as an External
Server (with separate processes) or as an In-Process Server (within the same process).
For high performance solutions, you can administer all the network data and, of course, the results in
"virtual tables" directly in the PSS SINCAL calculations. The structure of these virtual tables is exactly
like the PSS SINCAL data model. COM interfaces write network data, get results and control the
calculation methods.
For a C++ sample program that shows how calculation methods are integrated into external
applications and how virtual tables are used, see the PSS SINCAL installation structure
("Batch\SimAuto.zip").
Client Application Process
COM Interface
PSS SINCAL Simulation
"Simulate.dll"
Client Application Process
COM Interface
SimulateSrv.exe
PSS SINCAL Simulation
"Simulate.dll"
External Server In-Process Server
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 43/162
Integrating the Calculation Methods in own Solutions
The idea is to use PSS SINCAL calculation methods (load flow, short circuit, etc.) as a basis for
individual solutions and analyses. Normally, you use an existing PSS SINCAL network and then
analyze this with own solutions.
A simple example: In a network, you need to examine the effect of a load increase. You increase a
load value step by step and check the voltage level at the node at the same time.
For this problem, the small sample program "VoltageDrop.vbs" in the PSS SINCAL installation
structure is available.
'------------------------------------------------------------------------------ ' File: VoltageDropBatch.vbs ' Description: Small sample for simulation automation. ' A load at a node is constatly increased until a specified ' voltage drop occurs. ' Author: SS, GM ' Modified: 14.03.2008 '------------------------------------------------------------------------------ Option Explicit const siSimulationOK = 1101 Dim strDatabase ' Database of sincal network strDatabase = "D:\Network\_Test\Example Ele.mdb" Dim strProtDatabase ' Database with protection devices strProtDatabase = "D:\Server-Setup\Database\ProtectionDB.mdb" Dim strLoad ' Name of Load to be changed strLoad = "LO8" Dim strLF ' Load flow procedure strLF = "LF_NR" ' Set locale to US -> necessary because '.' is required for SQL commands! SetLocale( "en-gb" ) '------------------------------------------------------------------------------ ' Start of the script '------------------------------------------------------------------------------ If Not UCase( Right(WScript.Fullname,11) ) = "CSCRIPT.EXE" Then Call Usage() WScript.Quit End If ' Create an simulation object as "in process server" Dim SimulateObj Set SimulateObj = WScript.CreateObject( "Sincal.Simulation" ) If SimulateObj is Nothing Then WScript.Echo "Error: CreateObject Sincal.Simulation failed!" WScript.Quit End If ' Setting databases and language SimulateObj.DataSourceEx "DEFAULT", "JET", strDatabase, "Admin", "" SimulateObj.DataSourceEx "PROT", "JET", strProtDatabase, "Admin", "" SimulateObj.Language "US" ' Enable simulation batch mode: load from phys. database, store to virtual database SimulateObj.BatchMode 1 ' Load from database and generating calculation objects SimulateObj.LoadDB CStr( strLF )
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 44/162
' Getting calculation object load for modifying Dim LoadObj Set LoadObj = SimulateObj.GetObj( "LOAD", CStr( strLoad ) ) If LoadObj is Nothing Then WScript.Echo "Error: Load " & strLoad & " not found!" WScript.Quit End If ' Getting calculation object node of load Dim NodeID NodeID = LoadObj.Item( "TOPO.NODE1.DBID" ) Dim LoadNode Set LoadNode = SimulateObj.GetObj( "NODE", NodeID ) ' Getting virtual database object Dim SimulateNetworkDataSource Set SimulateNetworkDataSource = SimulateObj.DB_EL If SimulateNetworkDataSource Is Nothing Then WScript.Echo "Error: getting virtual database object failed!" WScript.Quit End If '------------------------------------------------------------------------------ ' Perform special voltage drop analysis '------------------------------------------------------------------------------ Dim iLoop, iLoopErr iLoop = 0 iLoopErr = 0 WScript.Echo vbCrLf & "Start load flow calculation (" & strLF & ")" Do While iLoop < 1000 WScript.Echo vbCrLf & "-------- " & CStr( iLoop ) & " --------" ' We modify the load by adding 0.1 MW in each loop Call ModifyLoad( LoadObj, 0.1 ) ' Start loadflow simulation SimulateObj.Start strLF If SimulateObj.StatusID <> siSimulationOK Then WScript.Echo "Load flow failed!" Exit Do End If ' Getting load flow result for node If LoadNode Is Nothing Then Else Dim LFNodeResultLoad Set LFNodeResultLoad = LoadNode.Result( "LFNODERESULT", 0 ) If LFNodeResultLoad Is Nothing Then Else Dim u_un u_un = LFNodeResultLoad.Item( "U_Un" ) WScript.Echo "Node voltage at modified load U/Un = " & FormatNumber( u_un ) & "%" Set LFNodeResultLoad = Nothing End If End If ' Display some golbal result information Call OutputLFAccurResult( SimulateNetworkDataSource ) iLoop = iLoop + 1 Loop ' Write calculation messages Call WriteMessages( SimulateObj ) ' Release used objects Set SimulateNetworkDataSource = Nothing Set LoadObj = Nothing Set LoadNode = Nothing
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 45/162
Set SimulateObj = Nothing Set SimulateObj = Nothing '------------------------------------------------------------------------------ ' Modify load '------------------------------------------------------------------------------ Sub ModifyLoad( ByRef LoadObj_, ValAdd ) ' Modify load by increasing P and Q Dim P P = LoadObj_.Item( "P" ) + ValAdd LoadObj_.Item( "P" ) = P Dim Q Q = LoadObj_.Item( "Q" ) + ValAdd LoadObj_.Item( "Q" ) = Q WScript.Echo "Set load " & strLoad & " to P = " & P & "MW, Q = " & Q & "Mvar" End Sub '------------------------------------------------------------------------------ ' Output some data of LFAccurResult to console '------------------------------------------------------------------------------ Sub OutputLFAccurResult( ByRef SimulateNetworkDataSource ) ' Get datbase object LFAccurResult from virtual database Dim LFAccurResult Set LFAccurResult = SimulateNetworkDataSource.GetRowObj( CStr( "LFAccurResult" ) ) If LFAccurResult Is Nothing Then WScript.Echo "Error: cant get objects in LFAccurResult!" WScript.Quit End If ' Open table LFAccurResult Dim hr hr = LFAccurResult.Open If hr <> 0 Then WScript.Echo "Error: cant open LFAccurResult!" WScript.Quit End If ' Move cursor to first row Dim bRead_next_data bRead_next_data = LFAccurResult.MoveFirst If bRead_next_data = 0 Then ' Get attribut Iteration Number Dim IterCnt IterCnt = LFAccurResult.Item( "IT" ) ' Get attribute Power Node Balance Dim PNB PNB = LFAccurResult.Item( "PNB" ) ' Get attribute Power Node Balance Dim PNBre PNBre = LFAccurResult.Item( "PNBre" ) 'Get attribute Voltage Mesh Balance Dim VLB VLB = LFAccurResult.Item( "VLB" ) 'Get attribut Voltage Mesh Balance Dim VLBre VLBre = LFAccurResult.Item( "VLBre" ) 'Output to console WScript.Echo "IT = " & IterCnt & ", Power Accuracy PNBre = " & FormatNumber( PNBre / 1000.0 ) & "kW" End If
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 46/162
' Release datbase object LFAccurResult Set LFAccurResult = nothing End Sub '------------------------------------------------------------------------------ ' Write simulation messages '------------------------------------------------------------------------------ Sub WriteMessages( ByRef SimulateObj ) WScript.Echo vbCrLf & "Simulation Messages:" & vbCrLf Dim objMessages Set objMessages = SimulateObj.Messages Dim strType Dim intMsgIdx For intMsgIdx = 1 To objMessages.Count Dim Msg Set Msg = objMessages.Item( intMsgIdx ) Select Case Msg.Type case 1 ' STATUS case 2 ' INFO case 3 ' WARNING WScript.Echo Msg.Text case 4 ' ERROR WScript.Echo Msg.Text End Select Set Msg = Nothing Next Set objMessages = Nothing End Sub '------------------------------------------------------------------------------ ' Show usage '------------------------------------------------------------------------------ Sub Usage() Dim strUsage strUsage = "Usage: cscript.exe VoltageDropBatch.vbs" _ & vbCrLf & vbCrLf _ & "A load at a node is constatly increased until a specified " _ & "voltage drop occurs." _ & vbCrLf WScript.Echo strUsage End Sub
Start the sample program at the prompt as follows:
> cscript.exe VoltageDrop.vbs
After the program starts, PSS SINCAL normally displays an error message. The reason for this is
simple. The sample program statically stores the PSS SINCAL network database to be used in the
calculations. These global preliminary settings need to be adapted for individual experiments.
Dim strDatabase ' Database of sincal network strDatabase = "D:\Network\_Test\Example Ele.mdb" Dim strProtDatabase ' Database with protection devices strProtDatabase = "D:\Server-Setup\Database\ProtectionDB.mdb" Dim strLoad ' Name of Load to be changed strLoad = "LO8"
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 47/162
First, modify the contents of the strDatabase variable. Enter the network to be calculated.
Then change the strProtDatabase variable. This defines the database for global protection devices
and can be found in the PSS SINCAL Installation "database" directory.
The strLoad variable specifies the load to be increased. In our example, this is the load with the
name "L08".
When you restart the sample program after you have modified the database paths, PSS SINCAL
displays the following text.
>cscript.exe VoltageDrop.vbs -------- 0 -------- Set load LO8 to P = 0.5MW, Q = 0.4Mvar Node voltage at modified load U/Un = 92.37% IT = 9, Power Accuracy PNBre = 0.00kW -------- 1 -------- Set load LO8 to P = 0.6MW, Q = 0.5Mvar Node voltage at modified load U/Un = 91.75% IT = 9, Power Accuracy PNBre = 0.00kW -------- 2 -------- Set load LO8 to P = 0.7MW, Q = 0.6Mvar Node voltage at modified load U/Un = 91.13% IT = 10, Power Accuracy PNBre = 0.00kW ... -------- 33 -------- Set load LO8 to P = 3.8MW, Q = 3.7Mvar Node voltage at modified load U/Un = 55.96% IT = 10, Power Accuracy PNBre = 0.00kW -------- 34 -------- Set load LO8 to P = 3.9MW, Q = 3.8Mvar Load flow failed! Simulation Messages: W 2714: Element data not physically meaningful E 3101: Load flow: no convergence break after 200 iterations E 1070: Please have a look at System Manual – Technical Reference – Messages from Calculations – Errors for further error information
Now the program executes without errors. 34 load flow calculations are performed. Before every
calculation, the load value of "L08" increases by 0.1 MW. The 33rd time around, a convergence with a
node voltage of 55.96 was still possible. The 34th time, no convergence is possible. This means the
maximum load value permitted is P = 3.8 MW and Q = 3.7 Mvar.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 48/162
4.1 Available Automation Functions
Automation objects in the calculation methods are structured hierarchically. Objects are instantiated
from the higher-level object to the lower-level objects. The objects themselves have different
methods and functions.
Overview of the Available Automation Functions
Simulation Object:
• BatchMode: Activate virtual database
• DataSourceEx: Set the databases
• Database: Set the databases
• SQLUser: Set the SQL user
• DataFile: Set the data file
• MacroPath: Paths for models
• Language: Set the language
• Currency: Set the currency
• SetInputState: Set the input state
• LoadDB: Load the input data from database
• SaveDB: Save the results to database
• SaveDBDump: Save the database in dump file
• AddDBDump: Add dump to the calculation
• AddObjID: Add objects
• ResetObjID: Reset objects
• Parameter: Set and query global parameters
• DoCommand: Execute commands
• Start: Start calculation
• StatusID: Status code of calculation procedure
• GetObj: Access calculation objects
Simulation Object
Calculation Results Object
Calculation Object
Tabular Object
Database Object
Message Data Object
Message Object
Diagram Page Object
Diagram Object
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 49/162
• GetObjById, GetObjByGUID: Access calculation objects using the ID
• DB_EL, DB_FLOW: Access database objects
• Messages: Access message objects
• GetVirtualScenario: Access virtual scenario
• Charts: Access diagram object
• CheckLicense: License check
• GetLicenseErrorText: Last license error
Calculation Object:
• Count: Number of possible attributes
• Name: Determine attribute names
• Item: Access attributes
• Result: Access calculation results object
Calculation Results Object:
• Count: Number of possible attributes
• Name: Determine attribute names
• Item: Access attributes
Diagram Object:
• SaveToFile: Save the diagrams in the file
• LoadFromFile: Load from a binary file
• Count: Number of diagram pages
• Item: Access diagram pages
Diagram Page Object:
• Count: Number of graphs
• Item: Calling of a Graph
• Id, Type, IdType: ID, type or additional information of the diagram page
• Name, Title: Name and title of the diagram page
Diagram Graph Object:
• SetCount: Number of graph compilations
• CurrentSet: Current compilation
• Count: Number of data vectors
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 50/162
• Item: Calling of a data vector
• ItemEx: Calling of a data vector
• Id, Type, IdType: ID, type or additional information of the graph
• Name: Name of the graph
Data vector object:
• Count: Number of data values
• Item: Calling of a data value
• Array: Calling of data values
• Id, Type, IdType, State, FlagFill, AddData: ID, type or additional information of the data vector
• Name, Unit: Name and unit of the data vector
• Skippoints: Sections to ignore
• ExtendPoints – Extension of a data point
Database Object:
• GetRowObj: Determine instance for a tabular object
Tabular Object:
• Open: Open the tabular object
• Close: Close a tabular object
• CountRows: Determine the number of records
• MoveFirst, MoveNext: Position in the data
• Count: Number of possible attributes
• Name: Determine attribute names
• Item: Access attributes
Message Object:
• Count: Number of possible messages
• Item: Access message data object
Message Data Object:
• Text: Message text
• Type: Message type
• CountObjectIds: Number of network elements
• ObjectIdAt, ObjectTypeAt: Network element data
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 51/162
Szenario Object:
• Clear: Delete existing scenario files
• AddScenarioFile: Add a scenario file
• AddScenarioFileEx: Add a scenario file with operating state, establishment date and shutdown
date
• Active: Activate/deactivate scenario
Attributes of Calculation Objects:
• Attributes for electrical networks
• Attributes for pipe networks
4.1.1 Simulation Object
This object creates the basis for all further automation functions. It is a duplicate of the PSS SINCAL
calculation module and, as such, is the main object of any automation. Simulation objects can be
instantiated as either Local Servers or In-Process Servers.
Local Server
Local servers are executable programs that implement COM components. When a COM component
is instantiated, this program starts as its own background process.
For communication between the processes, PSS SINCAL uses a special RPC log (Remote
Procedure Call) to slow down the speed in the data exchange. The advantage is that completely
separate processes and storage models are used. This means that even serious program errors do
not influence any other processes.
The following starts the calculations as a new process.
Set SincalSimSrv = WScript.CreateObject( "Sincal.SimulationSrv" ) If SincalSimSrv Is Nothing Then WScript.Echo "Error: CreateObject Sincal. SincalSimSrv failed!" WScript.Quit End If
The simulation object is accessed with the COM interface.
Set SincalSim = SincalSimSrv.GetSimulation If SincalSim Is Nothing Then WScript.Echo "Error: GetSimulation failed!" WScript.Quit End If
In-Process Server
In the case of an in-process server, PSS SINCAL provides the interfaces in a DLL. If you instantiate
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 52/162
a COM component of an in-process server, PSS SINCAL loads the appropriate server into the
current process. In-process servers are particularly fast, since the functions of the interfaces are
accessed within the limits of the process.
The following instantiates the calculations in the "current" process as an additional COM component.
Set SincalSim = WScript.CreateObject( "Sincal.Simulation" ) If SincalSim Is Nothing Then WScript.Echo "Error: CreateObject Sincal.Simulation failed!" WScript.Quit End If
BatchMode – Activate Virtual Database
Changes the database mode of the calculations.
SimulateObj.BatchMode iMode
Parameters
iMode (Integer)
Database mode for the calculations. The mode is a numerical value from 0 to 2.
Code Description
0 Load from a real database, save in a real database
1 Load from a real database, save in a virtual database
2 Load from a virtual database, save in a virtual database
4 Load from a real in a virtual database, save in a virtual database
Comments
In normal simulation, the output data are stored directly in the database. The Batchmode function,
however, sends the output data to a virtual database. This greatly increases the speed, since you do
not lose time making entries in the database. The results are kept only in the virtual database of the
main memory for the calculations.
With virtual databases no variants are available in the calculation.
Example
' Enable virtual database. SimulateObj.BatchMode 1
DataSourceEx – Set the Databases
Defines the databases used in the calculations.
SimulateObj.DataSourceEx strDBType, strDBSystem, strDatabase, strUser, strPassword
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 53/162
Parameters
strDBType (String)
Predefined sign for the database type.
Database type Description
"DEFAULT" Network database
"PROT" Global protection device database
"PROT_USR" Local protection device database
strDBSystem (String)
Predefined sign for the database system.
Database system Description
"JET" Microsoft Access
"ORACLE" Oracle
strDatabase (String)
Complete path and file name of the database.
strUser (String)
User name for the database.
strPassword (String)
Password for the database.
Comments
This function is obsolete and no longer recommended for use. It is only included for reasons of
compatibility and should be replaced by the Database – Set the Databases function.
Example
' Set database filename and path. SimulateObj.DataSourceEx "DEFAULT", "JET", strDatabase, "Admin", "" SimulateObj.DataSourceEx "PROT", "JET", strProtDatabase, "Admin", ""
Database – Set the Databases
Defines the databases used in the calculations.
SimulateObj.Database strConnection
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 54/162
Parameters
strConnection (String)
Database connection.
Code Description
"TYP" Database type
"MODE" Database system
"INSTANCE" Database server
"NAME" Database name
"USR" User name
"PWD" Password
"SYSUSR" PSS SINCAL administration user
"SYSPWD" Password of the PSS SINCAL administration user
"FILE" File name of database
"SINFILE" File name of PSS SINCAL file
The "TYP" code can have the following values.
Database type Description
"NET" Network database
"PROT" Global protection device database
"PROT_USR" Local protection device database
"STD" Global standard database
"STD_USR" Local standard database
The "MODE" code can have the following values.
Database system Description
"JET" Microsoft Access
"SQLITE" SQLite
"ORACLE" Oracle
"SQLSERVER" SQL Server
"SQLEXPRESS" SQL Server Express
Comments
Database connections are entered as pairs with field=value and ";" or as short forms in the complete
sequence.
Pairs:
TYP=NET;MODE=JET;...
Short form:
TYP;MODE;FILE;INSTANCE;NAME;USR;PWD;SINFILE;SYSUSR;SYSPWD;
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 55/162
Example
Depending on the database system, different connection codes are used.
' Set database connection string depending on database system. ' ACCESS: SimulateObj.Database "TYP=NET;MODE=JET;FILE=C:\Temp\Example Ele_files\database.mdb;USR=Admin;PWD=;SINFILE=C:\Temp\Example Ele.sin;" ' SQLITE: SimulateObj.Database "TYP=NET;MODE=SQLITE;FILE=C:\Temp\Example Ele_files\database.db;USR=Admin;PWD=;SINFILE=C:\Temp\Example Ele.sin;" ' ORACLE: SimulateObj.Database "TYP=NET;MODE=ORACLE;USR=ORA_ELE1;PWD=ORA_ELE1;INSTANCE=ORA11;SINFILE=C:\Temp\Example Ele.sin;SYSUSR=sincal;SYSPWD=sincal;" ' SQLEXPRESS: SimulateObj.Database "TYP=NET;MODE=SQLEXPRESS;FILE=C:\Temp\Example Ele_files\database.mdf;NAME=Example Ele;SINFILE=C:\Temp\Example Ele.sin;" ' SQLSERVER: SimulateObj.Database "TYP=NET;MODE=SQLSERVER;NAME=SQLSRV_ELE1;INSTANCE=SQLSRV;USR=username;PWD=password;SINFILE=C:\Temp\Example Ele.sin;SYSUSR=sincal;SYSPWD=sincal;"
SQLUser – Set the SQL User
Defines the user name and the password for the SQL Server.
SimulateObj.SQLUser strUser, strPassword
Parameters
strUser (String)
SQL user name.
strPassword (String)
SQL password.
Example
' Set the SQL user. SimulateObj.SQLUser "User", "Password"
DataFile – Set the Data File
Defines the data file needed by import or export.
SimulateObj.DataFile strDataFile
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 56/162
Parameters
strDataFile (String)
Complete path and file name of the data file.
Example
' Set the datafile for imports or exports. SimulateObj.DataFile "C:\Test\CIM\CIMExample.xml"
MacroPath – Paths for Models
Defines the local and global path, from which models are used.
SimulateObj.MacoPath strGlobalPath, strLocalPath
Parameters
strGlobalPath (String)
Complete path of the directory, where global models are stored.
strLocalPath (String)
Complete path of the directory, where local models are stored.
Example
' Set global and local path for models. SimulateObj.MacroPath "C:\GlobalMacros", "C:\LocalMacros"
Language – Set the Language
Determines the language for the calculations and calculation messages.
SimulateObj.Language strLanguage
Parameters
strLanguage (String)
Predefined code for the language to be set.
Code Description
"DE" Output language: German
"US" Output language: English
Example
' Select language for messages. SimulateObj.Language "DE"
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 57/162
Currency – Set the Currency
Determines the currency sign for the calculations and the calculation results.
SimulateObj.Currency strCurrency
Parameters
strCurrency (String)
Currency sign to be set.
Example
' Set currency. SimulateObj.Currency "EUR" SimulateObj.Currency "€"
SetInputState – Set the Input State
Sets the input status for the data considered in the calculations.
SimulateObj.SetInputState lInputMask
Parameters
lInputMask (Long Integer)
Bitwise form with predefined codes for input states.
Code Description
Electrical networks
0x00000001 Load Flow
0x00000002 Short Circuit
0x00000004 Harmonics
0x00000008 Motor Start-Up
0x00000010 Low-Voltage Dimensioning
0x00000020 Multiple Faults
0x00000040 Protection
0x00000080 Distance Protection
0x00000100 Optimization
0x00000200 Dynamics
0x00000400 Unbalanced Load Flow
0x00000800 Reliability
0x00001000 Economic Efficiency
0x00002000 Load Assignment
0x00004000 Arc Flash
Pipe networks
0x00080000 Steady-State Calculations
0x00100000 Dynamic Calculations
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 58/162
0x00200000 Geo-Stationary Calculations
Example
const CalcMethod_LF = &H00000001 const CalcMethod_SC = &H00000002 ' Set input data mask. SimulateObj.SetInputState CalcMethod_LF Or CalcMethod_SC
LoadDB – Load the Input Data from Database
Loads the database to the main memory and creates the network model for the calculations.
SimulateObj.LoadDB strMethod
Parameters
strMethod(String)
Predefined sign for the calculation method. For a complete list of permissible values, see the function
Start – Start Calculation.
Comments
When you select a specific calculation method, PSS SINCAL loads only the data required by this
calculation method from the database.
Example
' Load input data for load flow calculations from database. SimulateObj.LoadDB "LF_NR"
SaveDB – Save the Results to Database
Stores the virtual results or the entire virtual database in the physical database so these are available
for additional evaluations in the database after the automation solution.
SimulateObj.SaveDB strMethod
Parameters
strMethod (String)
Predefined sign for the calculation method or if ALL is specified, the entire virtual database is stored
in the physical database.
For a complete list of permissible values, see the function Start – Start Calculation.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 59/162
Example
' Save results to database. SimulateObj.SaveDB "LF_NR" ' Save virtual database into physical database. SimulateObj.SaveDB "ALL"
SaveDBDump – Save the Database in Dump File
Saves the loaded database to a dump file which can be loaded by a PSS SINCAL calculation.
SimulationObj.SaveDBDump strFile
Parameters
strFile (String)
Path of the dump file.
Example
' Save database into dump. SimulationObj.SaveDBDump ".\Dump.dmp"
AddDBDump – Add Dump to Calculation
Adds the dump to the calculation. If a database or a dump is already present, the newly added dump
is treated as an Include database.
SimulationObj.AddDBDump strFile
Parameters
strFile (String)
Path of the dump file.
Example
' Add dump to the calculation. SimulationObj.AddDBDump ".\Dump.dmp"
AddObjID – Add Objects
Defines objects for the calculation method for further special editing. The kind of editing depends on
the respective calculation method as well as the control setting.
SimulateObj.AddObjID( lRowType, lDBID, eMode )
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 60/162
Parameters
lRowType (Long Integer)
Database type of the object.
lDBID (Long Integer)
Database ID of the object.
eMode (Enum)
Predefined code for using objects in the calculations.
Enumeration Code Description
ADDOBJ_LF_NONE 0
ADDOBJ_LF_MALF 1 Contingency Analysis
ADDOBJ_OBJ_SC 2 Short Circuit at Object
ADDOBJ_OBJ_EXP 3 Netomac Export – Determining Machines
ADDOBJ_OBJ_MOT_SIMPLE 4 Simple Motor Start-Up
ADDOBJ_LF_ALLOC 5 Load Allocation
ADDOBJ_LF_RESUP 6 Restoration of Supply
ADDOBJ_FLOW_H2O_MALF 7 Contingency Analysis Water
ADDOBJ_FLOW_GAS_MALF 8 Contingency Analysis Gas
ADDOBJ_FLOW_HEAT_MALF 9 Contingency Analysis Heating/Cooling
ADDOBJ_OPT_CAP 10 Capacitor Placement
ADDOBJ_GEN_PV 11 PV Curves
ADDOBJ_FLOW_H2O_LEAK 12 Fire Water
ADDOBJ_LF_MALF_RECON 13 Contingency Analysis – Reconnection
ADDOBJ_OPT_NET 14 Optimal Network Structure
ADDOBJ_ECO 15 Economic Efficiency
ADDOBJ_NETRED_INCLUDE 16 Not currently used
ADDOBJ_NETRED_EXCLUDE 17 Elements not to be reduced
ADDOBJ_NETRED_BOUNDARY 18 Boundary lines for network reduction
ADDOBJ_OPT_VOLT_VAR 19 VoltVar Optimization
ADDOBJ_PROT_ANALYSIS 20 Elements of Protection Analysis
ADDOBJ_HAR_FILTER 21 Node for Filter Design
Example
' Set object for further usage. const ADDOBJ_OBJ_SC = 2 Simulation.AddObjID( 4, 1, ADDOBJ_OBJ_SC );
ResetObjID – Reset Objects
Removes the calculation objects.
SimulateObj.ResetObjID
Example
' Remove objects.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 61/162
Simulation.ResetObjID
Parameter – Set and Query Global Parameters
Sets a global parameter for the calculation method.
SimulateObj.Parameter( strParameter ) = Value Value = SimulateObj.Parameter( strParameter )
Properties
Parameter (Variant)
Value of the parameter.
Parameters
strParameter (String)
Predefined name of the parameter. Different calculation methods have different parameters. For a
detailed list of parameters, see the chapter on Parameters of Calculation Methods.
Example
' Set ShortName as default for object access. SimulateObj.Parameter( "Sim.Identification" ) = "ShortName" ' Set Name as default for object access. SimulateObj.Parameter( "Sim.Identification" ) = "Name"
DoCommand – Execute Commands
Performs a predefined command in the calculations.
SimulateObj.DoCommand strCommand, vtParameter1, vtParameter2
Parameters
strCommand (String)
Predefined sign of the command to be executed.
Command Description
"CHANGEVARIANT" Change variant
"DELETERESULTS" Deleting all the results in the database
vtParameter1, vtParameter2 (Variant)
Additional parameter, depending on the command.
"CHANGEVARIANT" – Change Variant
Parameter Data type Description
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 62/162
vtParameter1 String or Long Integer Name of the variant or DB-ID of the variant
vtParameter2 Boolean Change variant of the Include networks
The use of the instruction "CHANGEVARIANT" forces a complete loading of the database. All
automation objects of the calculation (network elements, results, …) are also reset and become
invalid.
"DELETERESULTS" – Deleting all the Results in the Database
Parameter Data type Description
vtParameter1 String or Long Integer Name of the variant or DB-ID of the variant
vtParameter2 Boolean Is not used
Example
' Change variant to Base. SimulateObj.DoCommand "CHANGEVARIANT", "Base", False
Start – Start Calculation
Starts the calculations.
SimulateObj.Start strMethod
Parameters
strMethod (String)
Predefined sign for the calculation method.
The following table lists the parameters that can be used to specify the calculation method.
Calc. method Description
Electrical networks
LF Load Flow according to Settings for Calculation Parameters
LF_NR Load Flow Newton Raphson
LF_YMAT Load Flow Admittance Matrix
LF_CI Load Flow Current Iteration
LF_USYM Unbalanced Load Flow (MGN)
LF_YMAT_RST Unbalanced Load Flow (RST)
LF_NETO Load Flow Netomac
LF_PSSE Load Flow PSS E
LF_MALF Malfunction of Selected Network Elements
LF_TRIM Load Assignment
LF_ALLOC Load Allocation
LF_BAL Load Balancing
LF_RESUP Restoration of Supply
LF_TAP Tap Zone Detection
LF_INC Load Development
LF_OP Operating Points
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 63/162
LF_SCN Scenario Calculation
LC Load Profile
LC_MAX Load Profile Maximum
GEN_PV PV Curves
OPT_LF Load Flow Optimization
OPT_BR Optimal Branching
OPT_COMP Compensation Power
OPT_CAP Capacitor Placement
OPT_NET Optimal Network Structure
COND Contingency Analysis
SC1 1-Phase Ground Fault
SC2 2-Phase Short Circuit
SC3 3-Phase Short Circuit
SC1 [NodeID] 1-Phase Ground Fault at Node
SC2 [NodeID] 2-Phase Short Circuit at Node
SC3 [NodeID] 3-Phase Short Circuit at Node
GC2 2-Phase Ground Fault
MF Multiple Faults
DIM Low-Voltage Dimensioning
HAR Harmonics
HAR_FILTER Harmonics – Filter Design
HAR_VAR Harmonics – Frequency Scan
RC Ripple Control
ECO_SUM Economic Efficiency
MOT Motor Start-Up
MOT_SIMPLE Simple Motor Start-Up
NETO_STAB Stability
NETO_TSTAB Transient Stability
NETO_EW Eigenvalues
REL Reliability
REL_EVAL Reliability Evaluations
PROT SC1 [FaultID] Protection Coordination – 1-Phase Ground Fault
PROT SC2 [FaultID] Protection Coordination – 2-Phase Short Circuit
PROT GC2 [FaultID] Protection Coordination – 2-Phase Ground Fault
PROT SC3 [FaultID] Protection Coordination – 3-Phase Short Circuit
PROT MF [FaultID] Protection Coordination – Multiple Faults Fault Event
PROT STAB Protection Coordination – Stability
PROT STAB_SC1 [FaultID] Protection Coordination – Stability 1-Phase Ground Faultpoliger Erdschluss
PROT STAB_SC2 [FaultID] Protection Coordination – Stability 2-Phase Short Circuit
PROT STAB_GC2 [FaultID] Protection Coordination – Stability 2-Phase Ground Fault
PROT STAB_SC3 [FaultID] Protection Coordination – Stability 3-Phase Short Circuit
PROT STAB_MF [FaultID] Protection Coordination – Stability Fault Event
PROT_DET Determining Fault Locations
PROT_SET DI Device – Settings
PROT_SET_CHART DI Device – Charts
PROT_ROUTE SC1 Route – 1-Phase Ground Fault
PROT_ROUTE SC2 Route – 2-Phase Ground Fault
PROT_ROUTE GC2 Route – 2-Phase Short Circuit
PROT_ROUTE SC3 Route – 3-Phase Short Circuit
PROT_ANALYSIS SC1 [FaultID] Protection Analysis – 1-Phase Ground Fault
PROT_ANALYSIS SC2 [FaultID] Protection Analysis – 2-Phase Short Circuit
PROT_ANALYSIS GC2 [FaultID] Protection Analysis – 2-Phase Ground Fault
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 64/162
PROT_ANALYSIS SC3 [FaultID] Protection Analysis – 3-Phase Short Circuit
PROT_CHK Check OC Settings
ARCFL Arc Flash
DES Verify Connection Conditions
ICA Hosting Capacity
OPT_VOLTVAR VoltVar Optimization
RED Dynamic Network Reduction
RED_STAT Static Network Reduction
TC Transfer Capacity
MCALC Multiple Calculations
Water networks
FLOW_H2O Steady-State
FLOW_H2O_TM Time Series
FLOW_H2O_OP Operating Series
FLOW_H2O_COND Contingency Analysis
FLOW_H2O_MALF Contingency Analysis (Selected Elements)
FLOW_H2O_FWP Fire Water Pressure
FLOW_H2O_FWQ Fire Water Amount
FLOW_H2O_LEAKP Fire Water Pressure (Selected Elements)
FLOW_H2O_LEAKQ Fire Water Amount (Selected Elements)
FLOW_MCALC Multiple Calculations
Gas networks
FLOW_GAS Steady-State
FLOW_GAS_TM Time Series
FLOW_GAS_OP Operating Series
FLOW_GAS_COND Contingency Analysis
FLOW_GAS_MALF Contingency Analysis (Selected Elements)
FLOW_MCALC Multiple Calculations
Heating/cooling networks
FLOW_HEAT Steady-State
FLOW_HEAT _TM Time Series
FLOW_HEAT _OP Operating Series
FLOW_HEAT_COND Contingency Analysis
FLOW_HEAT_MALF Contingency Analysis (Selected Elements)
FLOW_MCALC Multiple Calculations
The following table lists the parameters that can be used to specify the import and export functions.
Import/export Description
Electrical networks
CIM_IMP CIM Import
CIM_EXP CIM Export
PSSE_IMP PSS E Import
PSSE_EXP PSS E Export
NETO_EXP NETOMAC Export
HUB_IMP HUB Import
UCTE_IMP UCTE Import
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 65/162
UCTE_EXP UCTE Export
DGS_IMP DGS Import
DGS_EXP DGS Export
DVG_IMP DVG Import
DVG_EXP DVG Export
CYMDIST_IMP CYMDIST Import
CYMDIST_EXP CYMDIST Export
DINIS_IMP DINIS Import
Example
' Start load flow simulation. SimulateObj.Start "LF_NR" If SimulateObj.StatusID = 1101 Then WScript.Echo "Simulation finished without errors!" Else WScript.Echo "Error: Load flow failed!" Exit Do End If
StatusID – Status Code of Calculation Procedure
Queries the status of the calculation procedure.
lStatus = SimulateObj.StatusID
Properties
StatusID (Long Integer)
Status code for the calculation procedure.
Enumeration Description
1100 Calculation started
1101 Calculation completed without errors
1102 Calculation completed with errors
1103 Calculation aborted
1500 Loading/saving of data successfully completed
1501 BatchMode function was called with an unknown number
1502 Loading of database was faulty
1503 Saving of database was faulty
Example
' Check if the simulation was finished without any errors. If Not ( SimulateObj.StatusID = 1101 ) Then WScript.Echo "Error: Simulation failed!" End If
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 66/162
GetObj – Access Calculation Objects
Returns an instance for a calculation object that lets you directly access "internal" objects created in
the calculations.
Set LoadObj = SimulateObj.GetObj( strObjectType, strName ) Set LoadObj = SimulateObj.GetObj( strObjectType, lDBID )
Parameters
strObjectType (String)
Object type of the network element. This is the name of the database table where the element data
are stored.
lDBID (Long Integer)
Database ID of the network element.
strName (String)
Name of the network element. A global parameter can be assigned to use the name or the short
name for identification.
Return Value
Object (Object)
Automation object of a network element created in the calculations.
Example
' Get SimulationObject of type "LOAD" with name "LO8". Dim LoadObj Set LoadObj = SimulateObj.GetObj( "LOAD", CStr( "LO8" ) ) If LoadObj is Nothing Then WScript.Echo "Error: Load not found!" WScript.Quit End If
GetObjById, GetObjByGUID – Access Calculation Objects Using the ID
Returns an instance for a calculation object that lets you directly access "internal" objects created in
the calculations.
Set SimObj = SimulateObj.GetObjByID( lID ) Set SimObj = SimulateObj.GetObjByGUID( strGUID )
Parameters
lID (Long Integer)
Internal number of the calculation object. See the topology data of the calculation objects for this
"Internal ID".
strGUID (String)
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 67/162
Master Resource of the calculation object.
Return Value
SimObj (Object)
Automation object of a network element created in the calculations.
Comments
The GetObjByGUID function requires the MasterResource table to be loaded. This can be defined
via the "DB_LOAD_MASTERRESOURCE" parameter. The parameter must be set before
Simulation.DBLoad is called.
' Indicates if the simulation will load the MasterResource table from database ' 1 ... Load the table MasterResource ' 0 ... Ignore the table MasterResource and all GUIDs [default] SimulateObj.Parameter("DB_LOAD_MASTERRESOURCE") = 1
Example
' Get SimulationObject with internal ID 8. Dim SimObj Set SimObj = SimulateObj.GetObjByID( 8 ) If SimObj Is Nothing Then WScript.Echo "Error: Object not found!" WScript.Quit End If ' Get SimulationObject with Master Resource ID. Dim SimObj Set SimObj = SimulateObj.GetObjByGUID( "289DAFC1-8541-4abb-AE9F-1C47E6A2D32B" ) If SimObj Is Nothing Then WScript.Echo "Error: Object not found!" WScript.Quit End If
DB_EL, DB_FLOW – Access Database Objects
Lets you access the input data and results of the simulation.
Set SimulateDatabase = SimulateObj.DB_EL Set SimulateDatabase = SimulateObj.DB_FLOW
Properties
DB_EL (Object)
Database object for electrical networks.
DB_FLOW (Object)
Database object for pipe networks.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 68/162
Comments
This property is read-only.
Example
' Get the database object. Dim SimulateDatabase Set SimulateDatabase = SimulateObj.DB_EL If SimulateDatabase Is Nothing Then WScript.Echo "Error: Getting database object failed!" WScript.Quit End If ' ... Set SimulateDatabase = Nothing
Messages – Access Message Objects
Lets you access messages generated by the calculations.
Set objMessages = SimulateObj.Messages
Properties
Messages (Object)
Automation object for the calculation messages.
Comments
This property is read-only.
Example
' Get message object. Dim objMessages Set objMessages = SimulateObj.Messages ' Release message object. Set objMessages = Nothing
Charts – Access Diagram Object
Provides the diagram object as an automation object.
Set objCharts = Simulation.Charts
Return Value
objCharts (Object)
Automation object of the diagrams.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 69/162
Comments
This property is read-only.
Example
' Get chart object from simulation Dim objCharts Set objCharts = Simulation.Charts
GetVirtualScenario – Access Virtual Scenario
Lets you access virtual scenarios.
Set vScn = SimulateObj.GetVirtualScenario()
Example
' Get virtual scenario object. Dim vScn Set vScn = SimulateObj.GetVirtualScenario() ' Release message object. Set vScn = Nothing
CheckLicense – License Check
Carries out a license check for the entered module.
iStatus = CheckLicense( strComponent, strModule )
Parameters
strComponent (String)
License component (EL, H2O, GAS, HEAT, MODELS).
Component Description
El Electrical networks
H2o Water networks
Heat Heating/cooling networks
Gas Gas networks
Pdms PSS PDMS
Models Models
strModule (String)
Module and model ID (LF, SC1, SC2, …).
Module Description
Electrical Networks
LF Load flow
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 70/162
ULF Load flow unbalanced
SC1 Short circuit 1-phase
SC2 Short circuit 2-phase
SC3 Short circuit 3-phase
LF_INC Load development
LF_TRIM Load assignment
LF_BAL Load balancing
LC Load profile
OPT_LF Load flow optimization
OPT_BR Optimal branching
OPT_COMP Compensation optimization
OPT_NET Optimal network structure
OPT_VOLTVAR VoltVar optimization
COND Contingency analysis
TC Transfer capacity
ARCFL Arc Flash calculation
DIM Low voltage dimensioning
MF Multiple faults
HAR Harmonics
RC Ripple control
MOT Motor start-up
REL Reliability
RED Dynamic network reduction
ECO Cost calculation
DES Verify connection conditions
ICA Hosting capacity
PROT_SIM Protection simulation
PROT_SET Distance protection
PROT_ANALYSIS Protection analysis
PROT_DEV_OC OC devices
PROT_DEV_DI DI devices
STAB Stability
EMT Electromagnetic transients
EVS Eigenvalue screening
NETRED Dynamic network reduction
NEVA Eigenvalues/modal analysis
LEIKA Line constants
GMB GMB
Pipe networks
FLOW_H2O Water steady-state
FLOW_H2O_TM Water time series
FLOW_H2O_OP Water operation series
FLOW_H2O_FL Water tower filling
FLOW_H2O_FW Water fire water
FLOW_H2O_COND Water contingency analysis
FLOW_HEAT Heating steady-state
FLOW_HEAT_TM Heating time series
FLOW_HEAT_OP Heating operation series
FLOW_HEAT_COND Heating contingency analysis
FLOW_COOL Cooling steady-state
FLOW_COOL_TM Cooling time series
FLOW_COOL_OP Cooling operation series
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 71/162
FLOW_COOL_COND Cooling contingency analysis
FLOW_GAS Gas steady-state
FLOW_GAS_TM Gas time series
FLOW_GAS_OP Gas operation series
FLOW_GAS_COND Gas contingency analysis
Return Value
Status of the license check.
Code Description
-1 A general license system error occurred
1 The license file couldn't be found
2 Invalid license file
3 Update of the license information is not possible
4 Start on this computer not allowed
5 License has expired
6 The module cannot be started
Example
' Test some modules iStatus = Simulation.CheckLicense( "EL", CStr("LF") ) iStatus = Simulation.CheckLicense( "EL", CStr("SC") ) iStatus = Simulation.CheckLicense( "EL", CStr("HAR") )
GetLicenseErrorText – Last License Error
Supplies the last license error as readable text.
strText = GetLicenseErrorText()
Return Value
strText (String)
Status/error of the last license check.
Example
iStatus = Simulation.CheckLicense( "EL", CStr("HAR") ) If iStatus <> 0 Then WScript.Echo " --> " & Simulation.GetLicenseErrorText() End If
4.1.2 Calculation Object
This object directly accesses "internal" objects in the calculations that describe the network model.
This object represents the network element display in the main memory of the calculations.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 72/162
The calculation object lets you directly manipulate input data in the calculations. For example, you
can modify values for a load’s active and reactive power without loading data from the database. The
calculation object even has functions to simplify accessing the results of the network elements.
For a list of attributes addressed by the calculation object, see the chapter on Attributes of
Calculation Objects.
Simulation objects with the GetObj function create an instance for a calculation object.
Example
' Get simulation object of type "Load" with name "LO8". Dim LoadObj Set LoadObj = SimulateObj.GetObj( "LOAD", "LO8" ) If LoadObj Is Nothing Then WScript.Echo "Error: Load not found!" WScript.Quit End If ' Release the simulation object. Set LoadObj = Nothing
Count – Number of Possible Attributes
Returns the number of the possible attributes for the respective object.
lCnt = LoadObj.Count()
Return Value
lCnt (Long Integer)
Number of possible attributes.
Example
' Get the number of available attributes. Dim Cnt Cnt = LoadObj.Count()
Name – Determine Attribute Names
Returns the name of an attribute.
strName = SimObj.Name( iAttribute )
Properties
Name (String)
Name of the attribute.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 73/162
Parameters
iAttribute (Long Integer)
Number of the attribute.
Example
' Display the names of all available attributes for the object. Dim iAttr, lCnt lCnt = SimObj.Count() For iAttr = 1 To lCnt Dim strName strName = SimObjObj.Name( iAttr ) WScript.Echo iAttr & ": " & strName Next
Item – Access Attributes
Lets you access the different input and output data for a calculation object.
Value = SimObj.Item( lAttribute ) Value = SimObj.Item( strAttribute ) SimObj.Item( lAttribute ) = Value SimObj.Item( strAttribute ) = Value
Properties
Item (Variant)
Value of the attribute.
Parameters
iAttribute (Long Integer)
Numerical index of the attribute.
strAttribute (Long Integer)
Name of the attribute.
Comments
What attributes are actually available depends on the object. All objects have identical topology
attributes. These topology attributes uniquely identify nodes and network elements and are used to
switch them ON and OFF.
For a detailed presentation of all the objects and their available attributes, see the chapter
Calculation Objects and their Attributes.
Example
' Get P from the object and set a new value for this attribute. Dim Val
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 74/162
Val = SimObj.Item( "P" ) SimObj.Item( "P" ) = P * 2 ' Get the value with the index 3 and assign a new value. Dim Val Val = SimObj.Item( 3 ) SimObj.Item( 3 ) = Val * 2
Result – Access Calculation Results Object
Lets you access the results object of a calculations object.
Set ResultObj = SimObj.Result( strResult, iTerminalNo )
Parameters
strResult (String)
SQL name of the desired results table.
iTerminalNo (Integer)
Connection number for the desired results.
Return Value
ResultObj (Object)
Automation object for the results.
Comments
PSS SINCAL provides network element results for each terminal. Node elements (such as
generators, asynchronous machines and loads) have one terminal and branch elements (such as
lines, transformers and serial reactors) have two terminals.
Example
' Get load flow results on the first terminal of object. Dim ResultObj Set ResultObj = SimObj.Result( "LFBRANCHRESULT", 1 ) If ResultObj Is Nothing Then WScript.Echo "Error: No result available!" End If
4.1.3 Calculation Results Object
Calculation results objects are virtual objects that simplify accessing results for individual network
elements.
Calculation objects with the Result function produce an instance of a calculation results object.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 75/162
Example
' Get the load flow result object for a load. Dim LFBranchResultLoad Set LFBranchResultLoad = LoadObj.Result( "LFBRANCHRESULT", 1 ) If LFBranchResultLoad Is Nothing Then WScript.Echo "Error: Cant get result object!" End If
If the instance of the automation object is not used any longer, it must be released with the following
instruction.
' Relase the result object. Set LFBranchResultLoad = Nothing
Count – Number of Possible Attributes
Returns the number of the possible attributes for the respective results object.
lCnt = ResultObj.Count()
Return Value
lCnt (Long Integer)
Number of possible attributes.
Example
' Get the number of available attributes. Dim Cnt Cnt = ResultObj.Count()
Name – Determine Attribute Names
Returns the name of an attribute.
strName = ResultObj.Name( lAttribute )
Properties
Name (String)
Name of the attribute.
Parameters
lAttribute (Long Integer)
Number of the attribute.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 76/162
Example
' Display the names of all available attributes for the object. Dim iAttr, lCnt lCnt = ResultObj.Count() For iAttr = 1 To lCnt Dim strName strName = ResultObj.Name( iAttr ) WScript.Echo iAttr & ": " & strName Next
Item – Access Attributes
Lets you access the output data for a results object.
Value = ResultObj.Item( lAttribute ) Value = ResultObj.Item( strAttribute )
Properties
Item (Variant)
Value of the attribute.
Parameters
iAttribute (Long Integer)
Numerical index of the attribute.
strAttribute (Long Integer)
Name of the attribute.
Comments
This property is read-only.
The calculation results object is exactly the same as the results tables in the PSS SINCAL database.
This means the attribute names are the same as the field names in the results table. For detailed
documentation of all results tables, see the PSS SINCAL Database Description.
Example
' Getting load flow result for node. Dim LFNodeResult Set LFNodeResult = NodeObj.Result( "LFNodeResult", 0 ) If LFNodeResult Is Nothing Then Else Dim u_un u_un = LFNodeResult.Item( "U_Un" ) WScript.Echo "Node voltage at node U/Un = " & u_un & "%" Set LFNodeResult = Nothing End If
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 77/162
4.1.4 Diagram Object
This object forms the basis for all other automation functions of the diagrams and is a collection of
individual diagram pages. The diagram pages can be called from 1 to number.
The diagram object is provided via the simulation object.
Set Pages = SimulateObj.Charts
SaveToFile – Save the Diagrams in the File
Saves all diagram pages in the collection in a binary file.
Pages.SaveToFile strFile
Parameters
strFile (String)
Path and file name.
Example
' Save all diagram pages to a binary file. Pages.SaveToFile "C:\Temp\Charts.cht"
LoadFromFile – Load from a Binary File
Loads all diagram pages from a binary file.
Pages.LoadFromFile strFile
Parameters
strFile (String)
Path and file name.
Example
' Load diagram pages from file. Pages.Load "C:\Temp\Charts.cht"
Count – Number of Diagram Pages
Returns the number of diagram pages.
iPages = Pages.Count
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 78/162
Return Value
iPages (Integer)
Number of diagram pages.
Comments
This property is read-only.
Example
' Get number of diagram pages in the collection. iPages = Pages.Count
Item – Access Diagram Pages
Enables access to a diagram page and returns this as an automation object.
Set ChartPage = Pages.Item(iIndex)
Parameters
iIndex (Long Integer)
Index of the required diagram page – starting from 1 to n (Count – number of diagram pages)
Return Value
ChartPage (Object)
Automation object of the diagram page.
Comments
This function can only be read accessed.
Example
' Loop through all diagram pages in the collection For i=1 To Pages.Count Set ChartPage = Pages.Item(i) ... Next
4.1.5 Diagram Page Object
The diagram page object displays a single diagram page with one or more diagrams (diagram
graphs).
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 79/162
Count – Number of Graphs
Returns the number of graphs on the diagram page.
iGraphs = ChartPage.Count
Return Value
iGraphs (Long Integer)
Number of graphs on the diagram page.
Example
' Get the number of graphs on the current chart page. iGraphs = ChartPage.Count
Item – Calling of a Graph
Provides the required graph as an automation object.
Set ChartGraph = ChartPage.Item(iIndex)
Parameters
iIndex (Long Integer)
Index of the graph – starting from 1 to number (Count).
Example
' Loop through all graphs on the page For iGraph = 1 To ChartPage.Count Set ChartGraph = ChartPage.Item(iGraph) ... Next
Id, Type, IdType – ID, Type or Additional Information fo the Diagram Page
Returns the ID, the type or the additional information of the diagram page or defines it.
lID = ChartPage.Id lType = ChartPage.Type lIdType = ChartPage.IdType
Parameters/Return Value
lId (Long Integer)
Identification of the diagram page.
IdType (Long Integer)
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 80/162
Additional information of the diagram page. The value corresponds to a binary mask. Masking out the
value with 0XFFF obtains the database type to which the diagram page is assigned.
Type (Long Integer, Enum)
Unique ID of the diagram page.
Enumeration Code
siChartPageZERO 0
siChartPageHarFreq 1
siChartPageHarNode 2
siChartPageHarVoltageLevel 3
siChartPageMotorStartUp 4
siChartPageMotorHeyland 5
siChartPageMotorNodeVoltage 6
siChartPageMotorNodeActivePower 7
siChartPageMotorNodeReactivePower 8
siChartPageMotorChar 9
siChartPageProtTripChar 10
siChartPageProtTripArea 11
siChartPageProtDeviceChar 12
siChartPageProtDeviceArea 13
siChartPageLCNodeVoltage 14
siChartPageLCNodeActivePower 15
siChartPageLCNodeReactivePower 16
siChartPageLCElemUtilization 17
siChartPageLCElemActivePower 18
siChartPageLCElemReactivePower 19
siChartPageProtRoutePlanRoute 20
siChartPageProtRoutePlanProt 21
siChartPageProtRouteImpRatio 22
siChartPageProtRouteImpMeasure 23
siChartPageFlowSupply 24
siChartPageFlowReturn 25
siChartPageFlowAll 26
siChartPageLCNetLosses 29
siChartPageLCNetEnergy 30
siChartPageLCNetViolation 31
siChartPageLFVoltageCurve 32
siChartPageLCGeneral 33
siChartPageProtSetRoute 34
siChartPageProtRouteImpRatioX 35
siChartPageProtSetRouteX 36
siChartPageFlowWaterTower 37
siChartPageFlowNodeTmSupply 38
siChartPageFlowNodeTmReturn 39
siChartPageFlowNodeTmAll 40
siChartPageFlowElemTmSupply 41
siChartPageFlowElemTmReturn 42
siChartPageFlowOpSupply 43
siChartPageFlowOpReturn 44
siChartPageFlowOpAll 45
siChartPageLCOpSerAbs 46
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 81/162
siChartPageLCOpSerRel 47
siChartPageLfIncElement 48
siChartPageLfIncSecurePower 49
siChartPageLfIncSeriesAbs 50
siChartPageLfIncSeriesRel 51
siChartPageMotorNEMA 52
siChartPageMotorNode 53
siChartPageFlowOpBehaviourSupply 54
siChartPageFlowOpBehaviourReturn 55
siChartPageFlowOpBehaviourAll 56
siChartPageHarResNet 57
siChartPageLFPVBehaviour 58
siChartPageTapZoneEvaluation 59
siChartPageLCNode 60
siChartPageLCElement 61
siChartPageLCSmartNode 62
siChartPageLCSmartElement 63
siChartPageLCSmartNetLosses 64
siChartPageLCSmartNetEnergy 65
siChartPageLCSmartNetViolation 66
siChartPageLCSmartEnergyStorage 68
siChartPageLCEnergyStorage 67
siChartPageLfIncNode 69
siChartPageOptVoltVar 70
siChartPageLFOperatingPoint 71
siChartPageSIZE 72
siChartPageStabilityFmt1 900
siChartPageStabilityFmt2 901
siChartPageStabilityFmt3 903
siChartPageStabilityFmt4 904
siChartPageFormat1 905
siChartPageFormat2 906
siChartPageFormat3 907
siChartPageFormat4 908
siChartPageStabilityFmt5 909
siChartPageStabilityFmt6 910
siChartPageFormat5 911
siChartPageFormat6 912
siChartPageFormat7 913
siChartPageFormat8 914
siChartPageFormat9 915
siChartPageFormat10 916
siChartPageFormat11 917
siChartPageFormat12 918
siChartPageFormat13 919
siChartPageFormat14 920
siChartPageMotorStartUp1 1000
siChartPageMotorStartUp2 1001
siChartPageMotorStartUp3 1002
siChartPageMotorChar1 1003
siChartPageMotorChar2 1004
siChartPageMotorChar3 1005
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 82/162
siChartPageProtTripCharPhase 1006
siChartPageProtTripAreaPhase 1007
siChartPageProtDeviceCharPhase 1008
siChartPageProtDeviceAreaPhase 1009
siChartPageProtTripCharGround 1010
siChartPageProtTripAreaGround 1011
siChartPageProtDeviceCharGround 1012
siChartPageProtDeviceAreaGround 1013
siChartPageMotorTorque 1014
siChartPageMotorBranchPowerFlow 1015
siChartPageStabilityData 1016
siChartPageStability 1017
siChartPageStabilityTransData 1019
siChartPageStabilityTrans 1020
siChartPageProtDocumentation 1021
siChartPageInputData 1022
siChartPageUserData 1023
siChartPageProtDocumentation2 1024
siChartPageDynamicSimulationData 1025
siChartPageDynamicSimulation 1026
siChartPageLCResults 1027
siChartPageLCNetwork 1029
siChartPageLoadDevelopmentResults 1031
siChartPageFlowTimeSeries 1032
siChartPageReliabilityData 1033
siChartPageReliability 1034
siChartPageMotorStartUpResults 1035
siChartPageEND 1035
siChartPageLCSmartResults 1028
siChartPageLCSmartNetwork 1030
Name, Title – Name and Title of the Diagram Page
Returns the name and the title of the diagram page or defines it.
strName = ChartPage.Name
Parameters/Return Value
strName (String)
Name of the diagram page.
4.1.6 Diagram Graph Object
The diagram graph is a collection of diagram sets (compilations) and their diagram signals (diagram
vectors).
The data vectors that are compiled in a data set always have the same number of points.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 83/162
The first data vector in a data set always corresponds to the X axis.
SetCount – Number of Graph Compilations
Returns the number of compilations in the graph.
iCount = ChartPage.SetCount
Return Value
iCount (Long Integer)
Number of compilations in the graph.
Example
' Get the number of sets in the current datagraph. iSets = ChartGraph.SetCount
CurrentSet – Current Compilation
Returns the active compilation or defines it.
ChartPage.CurrentSet = iIndex iSet = ChartPage.CurrentSet
Parameters/Return Value
iIndex (Long Integer)
1-based index of the compilation.
Count – Number of Data Vectors
Returns the number of signals/data vectors in the current Data set.
iCount = ChartPage.Count
Return Value
Long Integer
Number of data vectors in the graph.
Example
' Get the number of graphs on the current chart page. iData = ChartGraph.Count
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 84/162
Item – Calling of a Data Vector
Provides the required data vector as an automation object.
Set ChartVector = ChartGraph.Item(iIndex)
Parameters
iIndex (Long Integer)
Index of the graph – starting from 1 to number (Count).
Example
' Loop through all graphs on the page For iGraph = 1 To ChartPage.Count Set ChartGraph = ChartPage.Item(iGraph) ... Next
ItemEx – Calling of a Data Vector
Provides the data vector as an automation object.
Set ChartVector = ChartGraph.Item(iDataSet, iVectorIndex)
Parameters
iDataIndex (Long Integer)
1-based index of the compilation – starting from 1 to number DataSet (SetCount).
iVectorIndex (Long Integer)
1-based index of the data vector – starting from 1 to number (Count).
Return Value
Automation object of the data vector.
Id, Type, IdType – ID, Type or Additional Information of the Graph
Returns the ID, the type or the additional information of the graph or defines it.
lID = ChartGraph.Id lType = ChartGraph.Type lIdType = ChartGraph.IdType
Parameters/Return Value
lId (Long Integer)
Identification of the graph.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 85/162
IdType (Long Integer)
Additional information of the graph. The value corresponds to a binary mask. Masking out the value
with 0XFFF obtains the database type to which the graph is assigned.
Type (Long Integer, Enum)
Unique ID of the graph.
Enumeration Code
siChartGraphZERO 0
siChartGraphHarFreqImpedance 1
siChartGraphHarFreqAngle 2
siChartGraphHarFreqLocusCurve 3
siChartGraphHarFreqResonance 4
siChartGraphHarFreqNode 5
siChartGraphHarFreqNodeWeight1 6
siChartGraphHarFreqNodeWeight2 7
siChartGraphHarFreqNodeWeight3 8
siChartGraphHarFreqVoltage 9
siChartGraphHarFreqVoltageWeight1 10
siChartGraphHarFreqVoltageWeight2 11
siChartGraphHarFreqVoltageWeight3 12
siChartGraphMotorSpeedTorque 13
siChartGraphMotorPower 14
siChartGraphMotorVoltage 15
siChartGraphMotorHeyland 16
siChartGraphMotorNodeVoltage 17
siChartGraphMotorNodeActivePower 18
siChartGraphMotorNodeReactivePower 19
siChartGraphMotorCharLoad 20
siChartGraphMotorCharTorque 21
siChartGraphMotorCharStartUpCurrent 22
siChartGraphProtTripChar 23
siChartGraphProtTripArea 24
siChartGraphLCNodeVoltage 25
siChartGraphLCElemUtilization 28
siChartGraphProtRoutePlanRoute 31
siChartGraphProtRoutePlanProt 32
siChartGraphProtRouteImpRatio 33
siChartGraphProtRouteImpMeasure 34
siChartGraphProtDeviceDIAreaPhase 35
siChartGraphProtDeviceDIAreaGround 36
siChartGraphProtDeviceOCCharPhase 37
siChartGraphProtDeviceOCCharGround 38
siChartGraphFlowSupply 39
siChartGraphFlowReturn 40
siChartGraphFlowAll 41
siChartGraphLCNetLosses 42
siChartGraphLCNetEnergy 43
siChartGraphLCNetViolation 44
siChartGraphLFVoltageCurve 45
siChartGraphLCSimultaneousness 46
siChartGraphLCConsumerPower 47
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 86/162
siChartGraphProtSetRoute 48
siChartGraphProtRouteImpRatioX 49
siChartGraphProtSetRouteX 50
siChartGraphFlowWaterTower 51
siChartGraphFlowNodeTmSupply 52
siChartGraphFlowNodeTmReturn 53
siChartGraphFlowNodeTmAll 54
siChartGraphFlowElemTmSupply 55
siChartGraphFlowElemTmReturn 56
siChartGraphFlowOpSupply 57
siChartGraphFlowOpReturn 58
siChartGraphFlowOpAll 59
siChartGraphLCOpSerAbs 60
siChartGraphLCOpSerRel 61
siChartGraphLfIncElemUtilization 62
siChartGraphLfIncSecurePower 63
siChartGraphLfIncSeriesAbs 64
siChartGraphLfIncSeriesRel 65
siChartGraphMotorNEMA 66
siChartGraphFlowOpBehaviourSupply 67
siChartGraphFlowOpBehaviourReturn 68
siChartGraphFlowOpBehaviourAll 69
siChartGraphHarResNet 70
siChartGraphLFPVBehaviour 71
siChartGraphTapZoneEvaluation 72
siChartGraphLCNodePower 73
siChartGraphLCElementPower 74
siChartGraphLCEnergyStorage 75
siChartGraphLfIncElementPower 76
siChartGraphLfIncNodeVoltage 77
siChartGraphLfIncNodePower 78
siChartGraphOptVoltVar 79
siChartGraphLFOperatingPoint 80
siChartGraphSIZE 81
siChartGraphMotorSpeedTorque1 1000
siChartGraphMotorSpeedTorque2 1001
siChartGraphMotorSpeedTorque3 1002
siChartGraphMotorPower1 1003
siChartGraphMotorPower2 1004
siChartGraphMotorPower3 1005
siChartGraphMotorVoltage1 1006
siChartGraphMotorVoltage2 1007
siChartGraphMotorVoltage3 1008
siChartGraphMotorSpeedCurrent1 1009
siChartGraphMotorSpeedCurrent2 1010
siChartGraphMotorCharTorque1 1011
siChartGraphMotorCharTorque2 1012
siChartGraphMotorCharStartUpCurrent1 1013
siChartGraphMotorCharStartUpCurrent2 1014
siChartGraphMotorTorque 1019
siChartGraphMotorBranchPowerFlow 1020
siChartGraphLCNetViolationUmin 1021
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 87/162
siChartGraphLCNetViolationUmax 1022
siChartGraphLCNetViolationImax 1023
siChartGraphLCNetViolationSum 1024
siChartGraphStabilityData 1025
siChartGraphStability1 1026
siChartGraphStability2 1027
siChartGraphStability3 1028
siChartGraphStability4 1029
siChartGraphStability5 1030
siChartGraphStability6 1031
siChartGraphStability7 1032
siChartGraphStability8 1033
siChartGraphInputData 1034
siChartGraphProtDocumentation 1035
siChartGraphDataInrush 1036
siChartGraphDataMotorStartup1 1037
siChartGraphDataThermalDamage1 1038
siChartGraphReliabilityData 1039
siChartGraphDataMotorStartup2 1040
siChartGraphDataMotorStartup3 1041
siChartGraphDataThermalDamage2 1042
siChartGraphDataMechanicalDamage 1043
siChartGraphDataDecayCurrent 1044
siChartGraph1 1047
siChartGraph2 1048
siChartGraph3 1049
siChartGraph4 1050
siChartGraph5 1051
siChartGraph6 1052
siChartGraph7 1053
siChartGraph8 1054
siChartGraph9 1055
siChartGraph10 1056
siChartGraph11 1057
siChartGraph12 1058
siChartGraph13 1059
siChartGraph14 1060
siChartGraphLCResults 1500
siChartGraphLoadDevelopmentResults 1501
siChartGraphFlowTimeSeries 1502
siChartGraphMotorStartUpResults 1503
siChartGraphUserData 2000
Name – Name of the Graph
Returns the name of the graph or defines it.
strName = ChartPage.Name
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 88/162
Parameters/Return Value
strName (String)
Name of the diagram page.
4.1.7 Data Vector Object
The data vector object contains the data values.
Count – Number of Data Values
Returns the number of data values in the data vector.
iCount = ChartVector.Count
Return Value
Long Integer
Number of the data points.
Example
' Get the number of sets in the current datagraph. iCount = ChartVector.Count
Item – Calling of a Data Value
Provides the required data vector as an automation object.
dValue = ChartGraph.Item(iIndex)
Parameters
iIndex (Long Integer)
Index of the data point – starting from 1 to number (Count).
Return Value
dValue (Double)
Data value.
Example
' Loop through all datapoints in the vector For idx = 1 To ChartVector.Count dValue = ChartVector.Item(idx) ... Next
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 89/162
Array – Calling of Data Values
Provides an array for all data points.
arValues = ChartGraph.Array()
Parameters
iDataIndex (Long Integer)
1-based index of the compilation – starting from 1 to number of DataSet (SetCount).
iVectorIndex (Long Integer)
1-based index of the data vector – starting from 1 to number (Count).
Id, Type, IdType, State, FlagFill, AddData – ID, Type or Additional Information of the
Data Vector
Returns the ID, the type or the additional information of the graph or defines it.
lID = ChartVector.Id lType = ChartVector.Type lIdType = ChartVector.IdType lState = ChartVector.State lFlagFill = ChartVector.FlagFill lAddData = ChartVector.AddData
Parameters/Return Value
lId (Long Integer)
Identification of the data vector.
IdType (Long Integer)
Additional information of the data vector. The value corresponds to a binary mask. Masking out the
value with 0XFFF obtains the database type to which the data vector is assigned.
Type (Long Integer, Enum)
Unique ID of the data vector.
Enumeration Code Description
siChartVectorZERO 0
siChartVector_n_1_min 1 Speed [1/min]
siChartVector_Q_VAr 2 Reactive power [VAr]
siChartVector_P_W 3 Active power [W]
siChartVector_S_VA 4 Apparent power [VA]
siChartVector_t_s 5 Time [s]
siChartVector_Slip_1 6 Slip [1]
siChartVector_Urel_pzt 7 Voltage [%]
siChartVector_Uabs_V 8 Voltage [V]
siChartVector_Irel_pzt 9 Current [%]
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 90/162
siChartVector_Iabs_A 10 Current [A]
siChartVector_Ireal_A 11 Current real [A]
siChartVector_Iimag_A 12 Current imaginary [A]
siChartVector_Z_Ohm 13 Resistance [Ohm]
siChartVector_R_Ohm 14 Active resistance [Ohm]
siChartVector_X_Ohm 15 Reactive resistance [Ohm]
siChartVector_Phi_Grad 16 Angle [degree]
siChartVector_f_Hz 17 Frequency [Hz]
siChartVector_Ord_1 18 Ordinal number [1]
siChartVector_M_Nm 19 Torque [Nm]
siChartVector_Mot_M_Nm 20 Motor torque [Nm]
siChartVector_Mot_L_Nm 21 Load torque [Nm]
siChartVector_s_m 23 Path [m]
siChartVector_h_m 24 Node height [m]
siChartVector_h_bar 25 Node height [bar]
siChartVector_Pabs_m 26 Pressure absolute [m]
siChartVector_Prel_m 27 Pressure relative [m]
siChartVector_Pabs_bar 28 Pressure absolute [bar]
siChartVector_Prel_bar 29 Pressure relative [bar]
siChartVector_PrelSatt_bar 30 Saturated steam pressure relative [bar]
siChartVector_Temp_GradC 31 Temperature [°C]
siChartVector_NodeID_1 32 Node ID
siChartVector_Nr_1 33 General number
siChartVector_E_Ws 34 Energy [Ws]
siChartVector_ViolUmin_1 35 Umin violations [1]
siChartVector_ViolUmax_1 36 Umax violations [1]
siChartVector_ViolImax_1 37 Imax violations [1]
siChartVector_ViolSum_1 38 Total of violations [1]
siChartVector_G_pzt 39 Simultaneity [%]
siChartVector_PabsSatt_bar 40 Saturated steam pressure absolute [bar]
siChartVector_ProtLocID_1 41 ProtLocationID
siChartVector_level_m 42 Filling height [m]
siChartVector_space_m3 43 Volume [m3]
siChartVector_Q_ls 44 Flow [l/s]
siChartVector_Q_th 45 Flow [t/h]
siChartVector_Q_mw 46 Flow [MW]
siChartVector_Q_norm 47 Flow [mn3]
siChartVector_Q_work 48 Flow [m3]
siChartVector_SecureP_W 51 Secure power [W]
siChartVector_AktuellP_W 52 Actual power [W]
siChartVector_Course_Rel 53 Characteristic curve, relative [pu]
siChartVector_Course_P 54 Characteristic curve, active power [W]
siChartVector_Course_Q 55 Characteristic curve, active power [W]
siChartVector_n_pu 56 Speed [pu]
siChartVector_m_pu 57 Torque [pu]
siChartVector_i_pu 58 Current [pu]
siChartVector_eta_pu 59 Efficiency [pu]
siChartVector_PressureRel 61 Pressure relative
siChartVector_P_MW 62 Active power [MW]
siChartVector_Q_MVAr 63 Reactive power [VAr]
siChartVector_E_MWh 64 Energy [MWh]
siChartVector_DateTime 65 Date time (double/DBTIMESTAMP)
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 91/162
siChartVector_Date 66 Date (double/DBTimeStamp)
siChartVector_Course_U 67 Characteristic curve voltage [V]
siChartVector_t_Add_s 68 Additional time series [s]
lState (Long Integer)
Status of the data vector.
lFlagFill (Long Integer)
Filling option of the data vector.
lAddData (Long Integer)
Additional information of the data vector.
Name, Unit – Name and Unit of the Data Vector
Returns the name and the unit of the data vector or defines it.
strName = ChartPage.Name
Parameters/Return Value
strName (String)
Name of diagram page.
Skippoints – Sections to Ignore
Provides an array with sections to be ignored. The entered points (index) are not drawn.
ExtendPoints – Extension of a Data Point
Identifies a data point, which is extended to the maximum X value in the GUI if required.
4.1.8 Database Object
This object lets you access the individual database tables.
Example
' Database object. Dim SimulateDatabase Set SimulateDatabase = SimulateObj.DB_EL If SimulateDatabase Is Nothing Then WScript.Echo "Error: Getting database object failed!" WScript.Quit End If
If the instance of the automation object is not used any longer, it must be released with the following
instruction.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 92/162
' Release the tabular object. Set SimulateDataBase = Nothing
GetRowObj – Determine Instance for a Tabular Object
Provides an instance for a tabular object.
Set TableObj = SimulateDatabase.GetRowObj( strTable )
Parameters
strTable (String)
Name of the database table.
Return Value
TableObj (Object)
Automation object of the database table.
Example
' Get the load flow node result tabular object. Dim LFNodeResult Set LFNodeResult = SimulateDatabase.GetRowObj( "LFNodeResult" ) If LFNodeResult Is Nothing Then WScript.Echo "Error: Getting LFNodeResult object failed!" WScript.Quit End If
4.1.9 Tabular Object
This object contains all the data from a database table. The data in the tabular object are organized
in lines and columns, similar to a calculation table. Each line represents a unique record and each
column a field or attribute within the record.
The database object creates an instance of a tabular object.
Example
' Get the load flow node result tabular object. Dim LFNodeResult Set LFNodeResult = SimulateDataBase.GetRowObj( "LFNodeResult" ) If LFNodeResult Is Nothing Then WScript.Echo "Error: Getting LFNodeResult object failed!" WScript.Quit End If
If the instance of the automation object is not used any longer, it must be released with the following
instruction.
' Release the tabular object. Set LFNodeResult = Nothing
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 93/162
Open – Open a Tabular Object
Opens the database table for a tabular object so you can access the records.
hr = TableObj.Open()
Return Value
hr (HRESULT)
Status code of the command.
Example
' Open a database table. Dim hr hr = TableObj.Open() If hr <> 0 Then WScript.Echo "Error: Open failed!" WScript.Quit End If
Close – Close a Tabular Object
Closes a database table of a tabular object.
TableObj.Close
Comments
Once you close the database table, you must not access the tabular object any longer. The instance
of the tabular object also needs to be released.
Example
' Close a database table and release it. TableObj.Close Set LFNodeResult = Nothing
CountRows – Determine the Number of Records
Provides the number of the records in a tabular object.
lCnt = TableObj.CountRows
Properties
CountRows (Long Integer)
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 94/162
Number of the records in a tabular object.
Example
' Open a database table and determine the count of records in it. Dim hr hr = TableObj.Open() If hr <> 0 Then WScript.Echo "RecordCount: " & TableObj.CountRows End If
MoveFirst, MoveNext – Position in the Data
Positions the data cursor inside the data.
hr = TableObj.MoveFirst() hr = TableObj.MoveNext()
Return Value
hr (HRESULT)
Status code of the command.
Comments
MoveFirst positions the data cursor at the beginning of the table. MoveNext moves the data cursor
to the next record.
Example
' Move to the first record and start reading. Dim hr hr = LFNodeResult.MoveFirst() Do While hr = 0 ' Your own code is here ... ' Move to next records. hr = LFNodeResult.MoveNext() Loop
Count – Number of Possible Attributes
Returns the number of the attributes for the tabular object.
lCnt = TableObj.Count
Return Value
lCnt (Long Integer)
Number of possible attributes.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 95/162
Comments
This property is read-only.
Example
' Get the number of available attributes. Dim lCnt lCnt = TableObj.Count
Name – Determine Attribute Names
Returns the name of an attribute.
strName = TableObj.Name( iAttribute )
Properties
Name (String)
Name of the attribute.
Parameters
iAttribute (Long Integer)
Number of the attribute.
Example
' Display the names of all available attributes for the object. Dim iAttr, lCnt lCnt = TableObj.Count For iAttr = 1 To lCnt Dim strName strName = TableObj.Name( iAttr ) WScript.Echo iAttr & ": " & strName Next
Item – Access Attributes
Provides access to the individual attributes (fields) for the current line of data.
Value = TableObj.Item( lAttribute ) Value = TableObj.Item( strAttribute )
Properties
Item (Variant)
Value of the attribute.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 96/162
Parameters
iAttribute (Long Integer)
Numerical index of the attribute.
strAttribute (Long Integer)
Name of the attribute.
Example
' Get U_Un from the table. Dim Val Val = TableObj.Item( "U_Un" )
4.1.10 Message Object
The message object accesses the messages generated during the calculations.
Use the simulation object to access the message object. The following example shows how to
display all the calculation messages with a program loop.
Example
' Get messages from simulation. Dim objMessages Set objMessages = SimulateObj.Messages Dim strType Dim intMsgIdx For intMsgIdx = 1 To objMessages.Count Dim Msg Set Msg = objMessages.Item( intMsgIdx ) Select Case Msg.Type case 1 ' STATUS case 2 ' INFO case 3 ' WARNING WScript.Echo Msg.Text case 4 ' ERROR WScript.Echo Msg.Text End Select Set Msg = Nothing Next ' Release message object if not longer needed. Set objMessages = Nothing
Count – Number of Possible Messages
Returns the number of the messages.
Cnt = objMessages.Count
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 97/162
Properties
Count (Long Integer)
Number of available messages.
Comments
This property is read-only.
Example
' Get the number of available messages. Dim Cnt Cnt = objMessages.Count WScript.Echo "Number of Messages: " & intMsgCnt
Item – Access Message Data Object
Provides access to a message data object.
Set Msg = objMessages.Item( iMsgIndex )
Properties
Item (Object)
Automation object of a message.
Parameters
iMsgIndex (Long Integer)
Numerical index of the message. Permitted indices start with "1" and end with the number of
messages.
Comments
This property is read-only.
Example
' Get a message. Dim Msg Set Msg = objMessages.Item( 1 )
4.1.11 Message Data Object
This object represents a message used to call up the message text, the message type and other
data for the message.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 98/162
Example
' Get the first message and display the message type and text. Dim Msg Set Msg = objMessages.Item( 1 ) Select Case Msg.Type case 1 ' STATUS WScript.Echo "Status: " & Msg.Text case 2 ' INFO WScript.Echo "Info: " & Msg.Text case 3 ' WARNING WScript.Echo "Warning: " & Msg.Text case 4 ' ERROR WScript.Echo "Error: " & Msg.Text End Select
Text – Message Text
Lets you access the text of a calculation message.
strText = Msg.Text
Properties
Text (String)
Message text.
Comments
This property is read-only.
Example
' Get the first message and display the message text. Dim Msg Set Msg = objMessages.Item( 1 ) WScript.Echo Msg.Text
Type – Message Type
Specifies the type of the message.
iType = Msg.Type
Properties
Type (Integer)
Predefined code for the type of message.
Code Message type Description
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 99/162
1 Status The calculation methods display status messages while they perform different functions.
2 Info Information messages contain general information (number of isolated nodes, etc.).
3 Warning Warnings show tolerable errors in the calculations.
4 Error Error messages show serious errors in the calculations and indicate that the calculations could not be completed properly.
Example
' Get the first message and display the message type. Dim Msg Set Msg = objMessages.Item( 1 ) Select Case Msg.Type case 1 ' STATUS WScript.Echo "Status" case 2 ' INFO WScript.Echo "Info" case 3 ' WARNING WScript.Echo "Warning" case 4 ' ERROR WScript.Echo "Error" End Select
CountObjectIds – Number of Network Elements
Specifies how many network elements the message refers to.
lCntElements = Msg.CountObjectIds
Properties
CountObjectIds (Long Integer)
Number of network elements.
Comments
This property is read-only.
Example
' Loop over all objects of the current message. If Msg.CountObjectIds > 0 Then Dim i For i = 1 To Msg.CountObjectIds ' ... Next End If
ObjectIdAt, ObjectTypeAt – Network Element Data
Provides the Object ID and the object type for a network element.
lObjID = Msg.ObjectIdAt( lIndex )
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 100/162
iObjType = Msg.ObjectTypeAt( lIndex )
Parameters
lIndex (Long Integer)
Numerical index starting with 1.
Properties
ObjectIdAt (Long Integer)
Network element ID.
ObjectTypeAt (Integer)
Database and type of the network element in a screen form.
Comments
The object type is stored in the first 12 bits and the database type in the highest 4 bits. To determine
the object type, the bit mask has to be combined with 0FFF. You get the database type by moving
the bits 12 spaces to the right.
These properties are read-only.
Example
' Loop over all objects of the current message. If Msg.CountObjectIds > 0 Then Dim i Dim strObjects For i = 1 To Msg.CountObjectIds If strObjects <> "" Then strObjects = strObjects & ", " End If ' Determine database and object type. Dim sDBType Dim sRowType sDBType = Msg.ObjectTypeAt( i ) \ &H1000 sRowType = Msg.ObjectTypeAt( i ) And &H0FFF strObjects = strObjects & Msg.ObjectIdAt( i ) & "(" & sRowType & ")" Next WScript.Echo strObjects End If
4.1.12 Scenario Object
This object enables scenarios to be calculated which are created in the script. If this scenario object
is active, the scenarios are not used in the real network. To make the changes to the scenario
effective, LoadDB must be called.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 101/162
Example
' Get virtual scenario object Dim vScn Set vScn = SimulateObj.GetVirtualScenario() ' Activate virtual scenario calculation vScn.Active = true ' Add a scenario file vScn.AddScenarioFile "./Case1.xml" ' Calculate with active scenario: Case1.xml SimulateObj.Start "LF" ' Remove the scenario files vScn.Clear ' Add a scenario file with operating state off vScn.AddScenarioFileEx "./Case2.xml", CInt(0), empty, empty ' Add a scenario file with an establishment date vScn.AddScenarioFileEx "./Case3.xml", empty, CDate("June 1, 2016"), empty ' Add a scenario file with a shutdown date vScn.AddScenarioFileEx "./Case4.xml", CInt(0), empty, CDate("June 1, 2017") ' Calculate with active scenarios: Case2.xml, Case3.xml, Case4.xml SimulateObj.Start "LF" ' Deactivate virtual scenario calculation vScn.Active = false ' Calculate without scenarios SimulateObj.Start "LF"
Clear – Delete Existing Scenario Files
Deletes scenario files in the scenario.
vScn.Clear
Example
' Remove the scenario files vScn.Clear
AddScenarioFile – Add a Scenario File
Adds the scenario file to the scenario.
vScn.AddScenarioFile ( strFile )
Parameters
strFile (String)
File name of the scenario file.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 102/162
Example
vScn.AddScenarioFile "./PQ Right.xml"
AddScenarioFileEx – Add a Scenario File with Operating State, Establishment Date
and Shutdown Date
Inserts the scenario file with the specified options in the scenario.
vScn.AddScenarioFile ( strFile, iOpState, dtEstablishment, dtShutdown )
Parameters
strFile (String)
File name of the scenario file.
iOpState (Integer)
Operating state is set for all elements of the scenario file. 0 deactivates the elements and 1 activates
them.
dtEstablishment (Datum)
Time of establishment is set for all elements in the scenario file.
dtShutdown (Datum)
Time of shutdown is set for all elements in the scenario file.
Example
dim iOpState ' Operating State Dim dtEst ' Establisment Date Dim dtShut ' Shutdown Date opOn = CInt(1) dtEst = CDate("June 1, 2016") dtShut = CDate("June 1, 2026") vScn.AddScenarioFileEx "./Scenario.xml", iOpState, dtEst, dtShut
Active – Activate/Deactivate Scenario
Activates or deactivates the scenario object.
vScn.Active = false
Properties
Type (Boolean)
State of the scenario object.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 103/162
Example
' Deactivate virtual scenario calculation vScn.Active = false
4.2 Calculation Objects and their Attributes
4.2.1 Available Calculation Objects
The following tables show the calculation objects that are available for the different network types.
Electrical Networks
Object type Description
General Data
CalcParameter Calculation settings
VoltageLevel Network level
NetworkGroup Network area
Nodes/Busbars
Node Node
Node Elements
SynchronousMachine Synchronous machine
PowerUnit Power unit
Infeeder Infeeder
DCInfeeder DC Infeeder
AsynchronousMachine Asynchronous machine
Load Load
ShuntImpedance Shunt impedance
ShuntReactor Shunt reactor
ShuntCondensator Shunt capacitor
VarShuntElement Variable serial element
HarResNet Shunt Harmonics Resonance Network
Branch Elements
TwoWindingTransformer Two-winding transformer
ThreeWindingTransformer Three-winding transformer
Line Line
VarSerialElement Variable shunt element
SerialReactor Serial reactor
SerialCondensator Serial capacitor
HarBranchResNet Serial Harmonics Resonance Network
Additional Elements
ProtOCFault Fault observation
ProtLocation Protection location
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 104/162
Water Networks
Object type Description
General Data
FlowCalcParameter Calculation settings
FlowNetworkLevel Network level
FlowNetworkGroup Network area
Nodes/Busbars
FlowNode Node
Node Elements
FlowWaterTower Water tower
FlowPump Pump
FlowConsumer Consumer
FlowPressureBuffer Pressure buffer
FlowLeakage Leakage
Branch Elements
FlowLine Line
FlowValve Sliding valve/non-return valve
FlowPumpLine Pressure increase pump
FlowConstLine Const. pressure decrease/const. flow
FlowPressureReg Pressure regulator
Gas Networks
Object type Description
General Data
FlowCalcParameter Calculation settings
FlowNetworkLevel Network level
FlowNetworkGroup Network area
Nodes/Busbars
FlowNode Node
Node Elements
FlowInfeederG Infeeder gas
FlowConsumer Consumer
FlowPressureBuffer Pressure buffer
FlowLeakage Leakage
Branch Elements
FlowLine Line
FlowValve Sliding valve/non-return valve
FlowConstLine Const. pressure decrease/const. flow
FlowPressureReg Pressure regulator
FlowCompressor Compressor
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 105/162
Heating/Cooling Networks
Object type Description
General Data
FlowCalcParameter Calculation settings
FlowNetworkLevel Network level
FlowNetworkGroup Network area
Nodes/Busbars
FlowNode Node
Node Elements
FlowInfeederH Infeeder heating/cooling
FlowPump Pump
FlowConsumer Consumer
FlowPressureBuffer Pressure buffer
FlowLeakage Leakage
Branch Elements
FlowLine Line
FlowValve Sliding valve/non-return valve
FlowPumpLine Pressure increase pump
FlowConstLine Const. pressure decrease/const. flow
FlowPressureReg Pressure regulator
FlowThermoReg Temperature regulator
FlowHeatExchanger Heat Exchanger
4.2.2 General Topology Attributes
General topology attributes are available for both nodes and network elements. They let you query
important basic information such as names and connection phases as well as establishment and
shutdown times.
Attribute State Description
Node
TOPO.ID Read Internal ID – Node
TOPO.DBID Read Database ID – Node (Node_ID)
TOPO.Name Read Name – Node
TOPO.ShortName Read Short Name – Node
TOPO.Phase Read Connection Phase (is determined dynamically by the attached elements) 1: L1 2: L2 3: L3 4: L12 5: L23 6: L31 7: L123
TOPO.TI Read/Write Establishment Time
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 106/162
TOPO.TS Read/Write Shutdown Time
Network Elements
TOPO.ID Read Internal ID – Network Element
TOPO.DBID Read Database ID – Network Element (Element_ID)
TOPO.Name Read Name – Network Element
TOPO.ShortName Read Short Name – Network Element
TOPO.State Read/Write Operational State – Network Element 0: Out of service 1: In service
TOPO.TI Read/Write Establishment Time
TOPO.TS Read/Write Shutdown Time
TOPO.Node1.ID Read Internal ID – 1. Node (up to 3 nodes are possible)
TOPO.Node1.DBID Read Database ID – 1. Node
TOPO.Terminal1.ID Read Internal ID – 1. Terminal (up to 3 terminals are possible)
TOPO.Terminal1.DBID Read Database ID – 1. Terminal
TOPO.Terminal1.State Read/Write Switching State – 1. Terminal 0: Switches opened 1: Switches closed
TOPO.Terminal1.Phase Read Connection Phase 1: L1 2: L2 3: L3 4: L12 5: L23 6: L31 7: L123
Additional Elements
TOPO.ID Read Internal ID – Additional Element
TOPO.DBID Read Database ID – Additional Element (Element_ID)
TOPO.Name Read Name – Additional Element
The ID attribute has a unique key for the unique identification of every object in the calculation
methods.
DBID has the Database ID of the specific node, network element or terminal.
The State attribute is a special feature for network elements and their terminals. This attribute shows
the operating status of the network element or the tripping status of the respective terminal. Simply
changing this attribute can switch network elements ON or OFF.
4.2.3 Attributes of Calculation Objects for Electrical Networks
Calculation Settings (CalcParameter)
Attribute name Data type Unit Description
ViewDate Double View Date
LoadDataDate Double Load Data Date
EstablishmentDate Double Establishment Date
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 107/162
StoreRes Integer Store Results in Database 0: Due to method 1: Completely 2: Violations 3: All elements in case of violations 4: Marked 5: Marked or violations
CreateDiagram Integer Diagram Creation 0: None 1: Completely 2: Marked 3: Violations 4: Marked or violations
Rating Integer Determine Rating 1: Base rating 2: First additional rating 3: Second additional rating 4: Third additional rating
IncreaseLoads Integer Use Load Data 0: Base Data 1: Load Increase 2: Load Profile 3: Load Increase/Load Profile 4: Load Profile in Load Development
UsymElm Integer Voltage Unbalance 1: V2/V1 2: V0/V1 3: NEMA 4: IEC 61000-2-2 5: IEC 61000-2-4 6: IEC 61000-4-30
ContrAdjustment Integer Controller Adjustment 1: Discrete 2: Continuous
MaxParProc Double Max. Parallel Processes for Calculation
FrqNet Double Hz Frequency
Sref Double MVA Reference Power
Uref Double kV Reference Voltage
LFZ0 Integer Mode Zero-Phase Impedance 1: Input data 2: Z0 equals Z1 3: Ze equals Zl 4: Z0 blocking 5: Z0 equals Z1 and Npt
LockR0 Double Ohm Active Part – Lock Impedance
LockX0 Double Ohm Imaginary Part – Lock Impedance
Load Flow
LFMethod Integer Load Flow Procedure 1: Current iteration 2: Newton-Raphson 3: Admittance matrix 5: Unbalanced (comp.) 8: Unbalanced (phases)
LFExtCalc Integer Extended Calculations 0: None 1: Load factor 2: Nodal transmission loss factor
LFFlatStart Integer Flat Start 0: No 1: Yes
LFChangeMethod Integer Change Load Flow Method at Convergence Problems 0: Off 1: On
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 108/162
LFPreCalc Integer Pre-Calculate 0: No 1: Yes
LFImpLoad Integer Impedance Load Conversion 0: No 1: Normal 2: Extended
LFControl Integer Enable Automatic Controller Change 0: No 1: Yes
LFITmax Long Integer Maximum Number of Iterations
LFIsland Integer Island Operation 0: No 1: Yes
LFvred Double % Voltage Limit Load Reduction
LFSpeedFactor Double 1 Load Flow Speed Factor
LFPowerAcc Double % Power Accuracy
LFPNB Double MVA Min. Power Accuracy
LFVLB Double % Mesh Accuracy
LFVDN Double % Node Accuracy
LFvll Double % Voltage Lower Limit
LFvul Double % Voltage Upper Limit
LFUtilElm Double % Load Profile – Utilization Limits Branch Element
LFUtilLine Double % Line Utilization Limit
LFCtrlTransformer Integer Activate Transformer Tap Changer 0: Off 1: On
LFCtrlShunt Integer Activate Shunt Element Tap Changer 0: No 1: Yes
LFLoadShedding Integer Activate Load Shedding 0: No 1: Yes
LFCtrlGenerator Integer Activate Generator Controlling 0: No 1: Yes
LFCtrlArea Integer Activate Area Interchange 0: Off 1: On
LFPowerTransfer Integer Activate Redistribute Power between Supply Sources 0: No 1: Yes
Load Flow ext.
StartTime Double h Start Time Load Profile
Duration Double h Duration Load Profile
TimeStep Double h Time Step Load Profile
LPTrim Integer Enable Trim in Load Profile Calculation 0: No 1: Yes
CAReportLimit Integer Reporting Limit
IncrStartDate Double Start Date
IncrEndDate Double End Date
EcoInLD Integer Economics in Load Development Calculation 0: No 1: Yes
EcoInflation Double % Inflation Rate
Short Circuit
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 109/162
SCPreL Integer Short Circuit Method 1: VDE 0102/1.90 – IEC 909 2: VDE 0102/IEC 909 (initial load) 3: VDE 0102/2002 – IEC 909/2001 4: IEC 61363-1/1998 5: IEC 61363-1/1998 (initial load) 6: ANSI C37 7: G74 8: VDE 0102/2016 – IEC 909/2016 9: GOST R 52735/2007 – GOST 28249/1993
SCType Integer Kind of Short Circuit Data Type 1: User Defined 2: Minimum 3: Maximum
SCModel Integer Network Model for Short Circuit 0: Sym. Components 1: Phase Values
SCTempDim Double °C Temperature at End of Short Circuit
SCPeakCurrent Integer
Peak Short Circuit Current Calculation Type 1: Ratio R/X at fault location 2: Radial Network 3: Equivalent frequency 4: Uniform ratio R/X 5: Ratio R/X at fault location R/X < 0.3
SCTrippCurrent Integer Breaking Current Calculation Type 1: IANEU VDE0102/1.90 – IEC 909 2: IAALT VDE0102/10.71
SCtmin Double s Global Switch Delay
SCANSIMethode Integer Solve Method 1: E/Z 2: E/X
SCANSINACD Integer NACD Option 1: All remote 2: Predominant 3: Interpolated
SCANSITrf Integer Modeling of Transformers 1: Actual data 2: Rated data
SCANSILine Integer Modeling of Lines 1: Use capacity 2: Ignore capacity
SCfIp Double Safety Factor for Peak Current
SCUseArc Integer Use Arc Data 0: No 1: Yes
SCCalcRX Integer Peak Current Calculation 1: Equivalent Impedance (Normal Frequency) 2: Equivalent Impedance (Equivalent Frequency) 3: Equivalent Resistance/Reactance (Normal Frquency)
SCSmAsm Integer Join Asynchronous and Synchronous Motors 0: No 1: Yes
SCDC Integer Join Photovoltaic in VDE 2016 0: No 1: Yes
SCWind Integer Join Windpower in VDE 2016 0: No 1: Yes
SCTrafoCorrection Integer Join Trafo Correction Factor in VDE 2016 0: No 1: Yes
Harmonics
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 110/162
HarWeighting Double Harmonic Weighting Type 0: None 1: IEEE 519 (Telephone influence factor) 2: THFF (Telephone high frequency factor) 3: NY x VNY 4: IEC 61000-2-4 class 1 5: IEC 61000-2-4 class 2 6: IEC 61000-2-4 class 3
HarDetFactor Double Detuning Factor
HarFrequency Integer
Frequency Response at Node 1: For all same values 2: Individual values
HarStartFrequency Double Hz Initial Frequency
HarEndFrequency Double Hz End Frequency
HarDeltaFreqMax Double Hz Large Frequency Step
HarDeltaFreqMin Double Hz Small Frequency Step
HarWaveResistance Integer Wave Resistance Equations for Lines 0: No 1: Yes
HarResonanceNetwork Integer Include Resonance Network in Frequency Response 0: No 1: Yes
HarIgnoreConsumer Integer Ignore Consumer 0: No 1: Yes
HarConsiderVoltAngle Integer Voltage Angle Consideration 0: No 1: Yes
Dynamics
DynTs Double s Starting Time
DynTe Double s Stopping Time
DynDt Double s Time Step
DynDtPlo Double s Plot Time Step
DynProt Integer Consider Protection Devices 0: No 1: Yes
DynLoadAngMin Double ° Load Angle Minimum
DynLoadAngMax Double ° Load Angle Maximum
DynSimMethod Integer Simulation Method for Transient Stability Limit 1: Stability 2: EMT
DynQacc Double MVA Reactive Power Accuracy
DynRmax Double Ohm Minimal Branch Impedance
DynModel Integer Model Formation 1: 0 Hz to 300 Hz 2: 50 Hz to 20 kHz 3: 10 kHz to 1 MHz 4: 500 kHz to 50 MHz
DynForceUnsym Integer Force Single Phase Model 0: No 1: Yes
DynReadable Integer Create Readable Files for PSS NETOMAC 0: None 1: Completely 2: No plotdef.
DynOutput Integer Additional Output 0: None 1: Comtrade (ASCII) 2: Comtrade (binary) 3: Plot File
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 111/162
DynLFSolve Integer Load Flow Help 0: None 1: NSN 2: SINCAL
Eigenvalues
EvaMethod Integer Eigenvalue Analysis Method 0: QR 1: Subspace 2: Dom. Pole
EvaZeta Double % Zeta
EvaZetaChart Double % Zeta Chart
EvaOmegaMin Double rad/s Minimum Omega
EvaOmegaMax Double rad/s Maximum Omega
EvaSigmaMin Double rad/s Minimum Sigma
EvaSigmaMax Double rad/s Maximum Sigma
EvaSigmaStart Double rad/s Sigma Start
EvaTs Double s Start Time for Eigenvalues
Network Level (VoltageLevel)
Attribute name Data type Unit Description
Un Double kV Rated Voltage
Uop Double kV Network Operating Voltage
f Double Hz Frequency
Temp_Line Double °C Overhead Line Conductor Temperature
Temp_Cabel Double °C Cable Conductor Temperature
Short Circuit
CalcSC Integer Calculate Short Circuit 0: No 1: Yes
CalcNpt Integer Calculate Current through Neutral Points 0: No 1: Yes
FlagUsc Integer Voltage Data due to VDE/IEC 1: c-value 2: Source voltage
c Double 1 c Value
Uk Double kV Source Voltage
ts Double s Switch Delay
Ipmax Double kA Maximum Admissible Peak Current
Ibrkmax Double kA Maximum Admissible Break Current
Flag_Toleranz Integer Voltage Tolerance – Low Voltage Networks 1: 6 % 2: 10 %
Upre Double pu Pre-Fault Voltage due to ANSI/IEEE
Harmonics
fRD Double Hz Ripple Control Frequency
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 112/162
Network Area (NetworkGroup)
Attribute name Data type Unit Description
Alagic Integer Transfer Active 0: No 1: Yes
PDS Double MW Interchange Leasing the Area
Pol Double MW Interchange Tolerance Bandwidth
Contingency Analysis
Flag_CausedForeign Integer Marked for Caused Malfunction 0: No 1: Yes
Flag_Malfunc Integer
Malfunction 0: None 1: All elements 2: Loaded elements 3: All lines 4: Loaded lines 5: All lines and transformers 6: Loaded lines and transformers
Flag_Connectors Integer Consider Connectors in Malfunction and Caused Malfunction 0: No 1: Yes
Util_BaseLimit Double % Base Utilization Limit
Flag_CausedMalfunc Integer Caused Malfunction 0: None 1: Marked areas 2: Own area
Flag_CausedElem Integer Caused Elements 1: Loaded elements 2: Loaded lines 3: Loaded lines and transformers
Util_CausedLimit Double % Caused Utilization Limit
Flag_Util Integer Show Elements outside Limits 0: None 1: Elements and nodes 2: Elements 3: Lines, transformers and nodes 4: Lines and transformers 5: Lines and nodes 6: Lines
Node (Node)
Attribute name Data type Unit Description
Marked Integer Marked 0: No 1: Yes
Simulation Data
Uref Double kV Voltage Target Value
StartU Double kV Initial Voltage
StartPhi Double ° Angle – Initial Voltage
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 113/162
FlagPhase Integer Preferred Fault Phase 1: L1 2: L2 3: L3 4: L12 5: L23 6: L31 7: L123
Ik2 Double kA Maximum Admissible Short Circuit Current
Ip Double kA Maximum Admissible Peak Short Circuit Current
Ibmax Double kA Maximum Admissible Breaking Current
uul Double % Voltage Upper Limit
ull Double % Voltage Lower Limit
uul1 Double % Additional Voltage Upper Limit
ull1 Double % Additional Voltage Lower Limit
Synchronous Machine (SynchronousMachine)
Attribute name Data type Unit Description
Flag_Machine Integer Type of Machine 1: Turbo generator 2: Hydro gen. (amort.) 3: Hydro generator 4: Condenser 5: Non-interconnected equivalent 6: Power station equivalent 7: Transmission system equivalent 8: Distribution system equivalent
Sn Double MVA Rated Apparent Power
Un Double kV Rated Voltage
R_X Double pu Ratio R/X – Positive-Phase Sequence
xd2sat Double % Saturated Subtransient Reactance
xd1sat Double % Saturated Transient Reactance
xi Double % Internal Reactance
Ugmax Double % Maximum Generator Voltage
Ikp Double kA Sustained Short Circuit Current of Compound Machines
Flag_LF Integer Load Flow Type 1: |I| and phi 2: P and Q 3: |usrc| and delta 4: |S| and cosphi 5: |Usrc| and delta 6: P and |u| 7: P and |U| 8: |uterm| and delta 9: |Uterm| and delta
I Double kA Basic Current Source
P Double MW Active Power
Q Double Mvar Reactive Power
delta Double ° Voltage Angle
u Double % Generator Voltage Percentage
S Double MVA Apparent Power
cosphi Double 1 Power Factor
Ug Double kV Generator Voltage Absolute
Zero- and Negative-Phase Sequence
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 114/162
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
X22 Double % Saturated Reactance – Negative-Phase Sequence
R2_X2 Double pu Ratio R/X – Negative-Phase Sequence
Converter
Flag_Converter Integer Converter Data Active
IskPF Double kA Maximum Source Current at 3-Phase Fault from Manufacturer
Isk2PF Double kA Maximum Source Current at 2-Phase fault from Manufacturer
Isk1PF Double kA Maximum Source Current at 1-Phase fault from Manufacturer
IkPF Double kA Steady-State Current at 3-Phase Fault from Manufacturer
R2_PF Double Ohm Negative Sequence Resistance due to Controlling
X2_PF Double Ohm Negative Sequence Reactance due to Controlling
Controller
Unode Double % Controlled Voltage at Controlled Node
Control Range
Umin Double % Voltage Lower Limit
Umax Double % Voltage Upper Limit
Pmin Double MW Active Power – Lower Limit
Pmax Double MW Active Power – Upper Limit
Qmin Double Mvar Reactive Power – Lower Limit
Qmax Double Mvar Reactive Power – Upper Limit
cosphi_lim Double Limit Power Factor
Dynamics
xd2 Double pu Subtransient Reactance
Reliability
Flag_LP Integer Switching Priority 1: High 2: Medium 3: Normal 4: Small 5: Low
CustCnt Long Integer 1 Number of Supplied Customers
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 115/162
Power Unit (PowerUnit)
Attribute name Data type Unit Description
Flag_Machine Integer Type of Machine 1: Turbo generator 2: Hydro gen. (amort.) 3: Hydro generator 4: Condenser 5: Non-interconnected equivalent 6: Power station equivalent 7: Transmission system equivalent 8: Distribution system equivalent
Sn Double MVA Rated Apparent Power
Un Double kV Rated Voltage
R_X Double pu Ratio R/X – Positive-Phase Sequence
xd2 Double % Subtransient Reactance
xi Double % Internal Reactance
Ugmax Double % Maximum Generator Voltage
Ug Double kV Rated Voltage Generator
cosphin Double 1 Rated Power Factor
Ikp Double kA Sustained Short Circuit Current of Compound Machines
xd1sat Double % Saturated Transient Reactance
xd2sat Double % Saturated Subtransient Reactance
Un2 Double kV Rated Voltage Transformer – Network Side
Un1 Double kV Rated Voltage Transformer – Generator Side
Snt Double MVA Rated Apparent Power Transformer
Smax Double MVA Full Load Power
ur Double % Short Circuit Voltage – Ohmic Part
Flag_LF Integer Load Flow Type 1: |I| and phi 2: P and Q 3: |usrc| and delta 4: |S| and cosphi 5: P and |u| 6: |Usrc| and delta 7: P and |U| 8: |uterm| and delta 9: |Uterm| and delta
phi Double ° Phase Angle
I Double kA Basic Current Source
P Double MW Active Power
Q Double Mvar Reactive Power
delta Double ° Voltage Angle
S Double MVA Apparent Power
cosphi Double 1 Power Factor
u Double % Generator Voltage Percentage
Zero- and Negative-Phase Sequence
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 116/162
X22 Double % Saturated Reactance – Negative-Phase Sequence
R2_X2 Double pu Ratio R/X – Negative-Phase Sequence
Converter
Flag_Converter Integer Converter Data Active 0: No 1: Yes
IskPF Double kA Maximum Source Current at 3-Phase Fault from Manufacturer
Isk2PF Double kA Maximum Source Current at 2-Phase fault from Manufacturer
Isk1PF Double kA Maximum Source Current at 1-Phase fault from Manufacturer
IkPF Double kA Steady-State Current at 3-Phase Fault from Manufacturer
R2_PF Double Ohm Negative Sequence Resistance due to Controlling
X2_PF Double Ohm Negative Sequence Reactance due to Controlling
Controller
Flag_Roh Integer State – Tap Position 1: Fixed 2: Variable
roh Double 1 Present Tap Position
rohl Double 1 Minimum Tap Position
rohu Double 1 Maximum Tap Position
alpha Double ° Additional Voltage Angle
Unode Double % Controlled Voltage at Controller Node
Control Range
Umin Double % Voltage Lower Limit
Umax Double % Voltage Upper Limit
Pmin Double MW Active Power – Lower Limit
Pmax Double MW Active Power – Upper Limit
Qmin Double Mvar Reactive Power – Lower Limit
Qmax Double Mvar Reactive Power – Upper Limit
cosphi_lim Double Limit Power Factor
Infeeder (Infeeder)
Attribute name Data type Unit Description
Flag_Typ Integer State – Input Values 1: R and X 2: R/X and Sk2
R_X Double pu Resistance/Reactance
xi Double % Internal Reactance
Flag_LF Integer Load Flow Type 1: |I| and phi 2: P and Q 3: |usrc| and delta 4: |S| and cosphi 5: P and |u| 6: |Usrc| and delta 7: P and |U| 8: |uterm| and delta 9: |Uterm| and delta
I Double kA Basic Current Source
P Double MW Active Power
Q Double Mvar Reactive Power
delta Double ° Voltage Angle
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 117/162
u Double % Voltage
S Double MVA Apparent Power
cosphi Double 1 Power Factor
Ug Double kV Voltage
Zero- and Negative-Phase Sequence
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Controller
Unode Double % Controlled Voltage at Controller Node
Control Range
Umin Double % Voltage Lower Limit
Umax Double % Voltage Upper Limit
Pmin Double MW Active Power – Lower Limit
Pmax Double MW Active Power – Upper Limit
Qmin Double Mvar Reactive Power – Lower Limit
Qmax Double Mvar Reactive Power – Upper Limit
cosphi_lim Double Limit Power Factor
DC Infeeder (DCInfeeder)
Attribute name Data type Unit Description
Flag_Input_Type Integer DC Input 1: P and Q 2: P and cosphi 3: Inverter
P Double MW Active Power
Q Double Mvar Reactive Power
cosphi Double 1 Power Factor
DC_power Double kW Installed DC Power
fDC_power Double 1 Factor Installed DC Power
fP Double 1 Multiplication Factor – Active Power
fQ Double 1 Multiplication Factor – Reactive Power
DC_losses Double % Losses until Inverter
Eta_Inverter Double % Efficiency – Inverter
Umin_Inverter Double % Minimum Voltage – Inverter
Umax_Inverter Double % Maximum Voltage – Inverter
t_off Double s Switch Off Time
Q_Inverter Double % Reactive Power Demand – Inverter
Ctrl_power Double W Controller Power
Flag_Connect Integer Type of Connecting 1: Directly 2: Transformer
Tr_UrNet Double kV Rated Voltage Netside – Transformer
Tr_Sr Double kVA Rated Apparent Power – Transformer
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 118/162
Tr_uk Double % Reference Short Circuit Voltage – Transformer
Tr_rx Double pu Ratio R/X – Transformer
Converter
Flag_Converter Integer Converter Data Active 0: No 1: Yes
IskPF Double kA Maximum Source Current at 3-Phase Fault from Manufacturer
Isk2PF Double kA Maximum Source Current at 2-Phase fault from Manufacturer
Isk1PF Double kA Maximum Source Current at 1-Phase fault from Manufacturer
IkPF Double kA Steady-State Current at 3-Phase Fault from Manufacturer
R2_PF Double Ohm Negative Sequence Resistance due to Controlling
X2_PF Double Ohm Negative Sequence Reactance due to Controlling
Harmonics
Flag_I Flag_I Control Current State 0: Not active at load flow 1: Active at load flow
Ireg Ireg kA Control Current
pk pk 1 Reference Compensation Power
Asynchronous Machine (AsynchronousMachine)
Attribute name Data type Unit Description
Flag_Typ Integer Input Type of Asynchronous Machine 1: Pn 2: In 3: NEMA
Pn Double MW Rated Active Power
Un Double kV Rated Voltage
Speedn Double 1/min Rated Speed
pol Double 1 Pole Pair Number
cosphin Double pu Rated Power Factor
etan Double pu Rated Efficiency
IaIn Double pu Current Ratio At Start-Up
R_X Double pu Ratio R/X – Positive-Phase Sequence
Inm Double kA Rated Current
Flag_LF Integer Load Flow Type 1: P and Q 2: P and cosphi 3: P/Pn and cosphi 4: U, I und cosphi 5: DFIG (P, Q and Slip)
P Double MW Active Power
Q Double Mvar Reactive Power
cosphi Double 1 Power Factor
ppn Double pu Utilization
I Double kA Basic Current Source
Slip Double % Slip
Flag_SC Integer Short Circuit Behavior 1: Ik'' + ip / I1c + Iint 2: ip / I1c 3: Ignore
Zero- and Negative-Phase Sequence
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 119/162
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Ia2In Double pu Current Ratio at Start-Up
R2_X2 Double pu Ratio R/X – Negative-Phase Sequence
Characteristics
TA Double s Starting Time Power Unit Data
GD2 Double Mpm² Momentum Power Unit Data
Motor Start-Up
ConStart Integer Circuitry for Start-Up 1: Wye 2: Delta 3: Wye/delta
ConRun Integer Circuitry for Nominal Data 1: Wye 2: Delta
Flag_StartUpCtrl Integer Start Up Control 0: None 1: Current 2: Auto transformer 3: Current and auto transformer 4: Capacitor 5: Current and capacitor
Reliability
CustCnt Long Integer 1 Number of Supplied Customers
Load (Load)
Attribute name Data type Unit Description
Flag_LoadType Integer Load Flow Type 1: Z constant 2: P and Q constant 3: I constant 4: P and Q scaled 5: I scaled
Flag_LF Integer Load Input 1: P, Q and (v) 2: P, Q and (V) 3: S, cosφ and v 4: S, cosφ and V 5: I, cosφ and v 6: I, cosφ and V 7: P and I 8: E, cosφ and t 9: EP and EQ 10: Pi and Qi 11: P, cosφ and v 12: P, cosφ and V 13: Pi, Qi and (v) – star 14: Pij, Qij and (v) – delta 15: P, Q and (v) – delta
P Double MW Active Power
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 120/162
Q Double Mvar Reactive Power
u Double % Voltage
Ul Double kV Voltage
S Double MVA Apparent Power
cosphi Double pu Power Factor
I Double kA Current
P1 Double MW Active Power L1
Q1 Double Mvar Reactive Power L1
P2 Double MW Active Power L2
Q2 Double Mvar Reactive Power L2
P3 Double MW Active Power L3
Q3 Double Mvar Reactive Power L3
P12 Double MW Active Power L12
Q12 Double Mvar Reactive Power L12
P23 Double MW Active Power L23
Q23 Double Mvar Reactive Power L23
P31 Double MW Active Power L31
Q31 Double Mvar Reactive Power L31
Zero- and Negative-Phase Sequence
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Pneg Double MW Active Power – Negative-Phase Sequence
Qneg Double Mvar Reactive Power – Negative-Phase Sequence
Dynamics
ResFlux1 Double pu Residual Flux Phase L1
ResFlux2 Double pu Residual Flux Phase L2
ResFlux3 Double pu Residual Flux Phase L3
Shunt Impedance (ShuntImpedance)
Attribute name Data type Unit Description
Un Double kV Rated Voltage
R Double Ohm Active Resistance
X Double Ohm Reactance
Zero-Phase Sequence
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 121/162
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Dynamics
ResFlux1 Double pu Residual Flux Phase L1
ResFlux2 Double pu Residual Flux Phase L2
ResFlux3 Double pu Residual Flux Phase L3
Shunt Reactor (ShuntReactor)
Attribute name Data type Unit Description
Sn Double MVA Rated Reactive Power
Vcu Double kW Copper Losses
Vfe Double kW Iron Losses
Un Double kV Rated Voltage
Zero-Phase Sequence
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Controller
Flag_Roh Integer Controller State 1: Fix 2: Variable – node 3: Variable – terminal
roh Integer 1 Present Tap Position
rohl Integer 1 Minimum Tap Position
rohu Integer 1 Maximum Tap Position
deltaS Double Additional Reactive Power
uul Double % Voltage Upper Limit
ull Double % Voltage Lower Limit
Qmin Double Mvar Minimum Total Reactive Power
Qmax Double Mvar Maximum Total Reactive Power
CosPhiMin Double 1 Cosinus Phi Minimum
CosPhiMax Double 1 Cosinus Phi Maximum
Dynamics
ResFlux1 Double pu Residual Flux Phase L1
ResFlux2 Double pu Residual Flux Phase L2
ResFlux3 Double pu Residual Flux Phase L3
Shunt Capacitor (ShuntCondensator)
Attribute name Data type Unit Description
Sn Double MVA Rated Reactive Power
Vdi Double kW Dielectric Losses
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 122/162
Un Double kV Rated Voltage
Zero-Phase Sequence
Flag_Z0 Integer Grounding 0: Not grounded 1: Fixed grounded 2: Grounded w. impedances
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Controller
Flag_Roh Integer Controller State 1: Fix 2: Variable – node 3: Variable – terminal
roh Integer 1 Present Tap Position
rohl Integer 1 Minimum Tap Position
rohu Integer 1 Maximum Tap Position
deltaS Double Additional Reactive Power
uul Double % Voltage Upper Limit
ull Double % Voltage Lower Limit
Qmin Double Mvar Minimum Total Reactive Power
Qmax Double Mvar Maximum Total Reactive Power
CosPhiMin Double 1 Cosinus Phi Minimum
CosPhiMax Double 1 Cosinus Phi Maximum
Variable Shunt Element (VarShuntElement)
Attribute name Data type Unit Description
Flag_LF Integer Load Flow Input 1: Power 2: Impedance 3: Model 4: Mixed power 5: Function
Flag_LoadType Integer Load Flow Type 1: Z constant 2: P and Q constant 3: I constant
Plf Double MW Active Power Load Flow
Qlf Double Mvar Reactive Power Load Flow
Ulf Double kV Voltage Load Flow
Rlf Double Ohm Resistance Load Flow
Xlf Double Ohm Reactance Load Flow
Flag_Macro_LF Integer Model Type Load Flow 0: None 1: Controller 2: Equivalent circuit
fPk Double pu Factor Constant Active Power
fPi Double pu Factor Current Dependent Active Power
fPu Double pu Factor Voltage Dependent Active Power
fQk Double pu Factor Constant Reactive Power
fQi Double pu Factor Current Dependent Reactive Power
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 123/162
fQu Double pu Factor Voltage Dependent Reactive Power
f_p_1 Double pu Factor 1 Active Power
f_p_2 Double pu Factor 2 Active Power
f_p_3 Double pu Factor 3 Active Power
e_p_1 Double pu Exponent 1 Active Power
e_p_2 Double pu Exponent 2 Active Power
e_p_3 Double pu Exponent 3 Active Power
f_q_1 Double pu Factor 1 Reactive Power
f_q_2 Double pu Factor 2 Reactive Power
f_q_3 Double pu Factor 3 Reactive Power
e_q_1 Double pu Exponent 1 Reactive Power
e_q_2 Double pu Exponent 2 Reactive Power
e_q_3 Double pu Exponent 3 Reactive Power
Rsc Double Ohm Resistance Circuit Input
Xsc Double Ohm Reactance Circuit Input
Zero- and Negative-Phase Sequence
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Pneg Double MW Active Power – Negative-Phase Sequence
Qneg Double Mvar Reactive Power – Negative-Phase Sequence
Shunt Harmonics Resonance Network (HarResNet)
Attribute name Data type Unit Description
Un Double kV Rated Voltage
R Double Resistance at Network Frequency
X Double Reactance at Network Frequency
Faktor Double Initial Value Factor
Impedance Integer Determine Impedance 1: Vmax 2: Imax
FlagZ0 Integer Zero Sequence Data 0: Not grounded 1: Fixed grounded
Two-Winding Transformer (TwoWindingTransformer)
Attribute name Data type Unit Description
Un1 Double kV Rated Voltage (Side 1)
Un2 Double kV Rated Voltage (Side 2)
Sn Double MVA Rated Apparent Power
Smax Double MVA Full Load Power
Smax1 Double MVA First Additional Full Load Power
Smax2 Double MVA Second Additional Full Load Power
Smax3 Double MVA Third Additional Full Load Power
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 124/162
uk Double % Reference Short Circuit Voltage
ur Double % Short Circuit Voltage – Ohmic Part
Vfe Double kW Iron Losses
i0 Double % No Load Current
VecGrp Integer Vector Group 1: DD0, 2: DZ0, 3: DZN0, 4: YNY0, 5: YNYN0, 6: YY0, 7: YYN0, 8: ZD0, 9: ZND0, 10: DYN1, 11: DZ1, 12: DZN1, 13: YD1, 14: YND1, 15: YNZN1, 16: YZ1, 17: YZN1, 18: ZD1, 19: ZND1, 20: ZNYN1, 21: ZY1, 22: ZYN1, 23: DY5, 24: DYN5, 25: YD5, 26: YND5, 27: YNZ5, 28: YNZN5, 29: YZ5, 30: YZN5, 31: ZNY5, 32: ZNYN5, 33: ZY5, 34: ZYN5, 35: DD6, 36: DZ6, 37: DZN6, 38: YNY6, 39: YNYN6, 40: YY6, 41: YYN6, 42: ZD6, 43: ZND6, 44: DY7, 45: DYN7, 46: DZ7, 47: DZN7, 48: YD7, 49: YND7, 50: YNZN7, 51: YZ7, 52: YZN7, 53: ZD7, 54: ZND7, 55: ZNYN7, 56: ZY7, 57: ZYN7, 58: DY11, 59: DYN11, 60: YD11, 61: YND11, 62: YNZ11, 63: YNZN11, 64: YZ11, 65: YZN11, 66: ZNY11, 67: ZNYN11, 68: ZY11, 69: ZYN11, 70: DY1, 71: Y0, 72: YN0, 73: D0, 74: ZNY1, 75: ZNY7, 76: DDN0, 77: DND0, 78: DNYN1, 79: DNYN11, 80: YNDN1, 81: YNDN11
uk_ct Double % Ref. Short Circuit Voltage Half Winding
ur_ct Double % SC Voltage – Ohmic Part Half Winding
Zero-Phase Sequence
FlagZ0Input Integer Zero Data Input 1: Z0/Z1 and R0/X0 2: R0 and X0 3: R0/R1 and X0/X1 4: ZABNL, ZBANL and ZABSC
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
X0_X1 Double pu Ratio Zero-Phase to Positive-Phase Reactance
R0_R1 Double pu Ratio Zero-Phase to Positive-Phase Resistance
ZABNL Double Ohm R/X Ratio of Impedance between A and B in No Load
ZBANL Double Ohm R/X Ratio of Impedance between B and A in No Load
ZABSC Double Ohm R/X Ratio of Impedance between A and B in Short Circuit
Controller
FlagConNode Integer Controller Node 1: Side 1 2: Side
Flag_Roh Integer State – Tap Position 1: Fixed 2: Node 3: Impedance 4: Active power 5: Reactive power 6: Control Charact.
Flag_Tap Integer Individual Tap Positions 0: No 1: Yes
roh Double Present Tap Position
roh1 Double Present Tap Position Winding 1
roh2 Double Present Tap Position Winding 2
roh3 Double Present Tap Position Winding 3
rohl Double Minimum Tap Position
rohm Double Main Tap Position
rohu Double Maximum Tap Position
alpha Double ° Additional Voltage Angle
ukr Double % Additional Voltage per Tap Position
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 125/162
phi Double ° Voltage Phase Shift per Tap Position
ukl Double % Short Circuit Voltage at Minimum Tap Position
uku Double % Short Circuit Voltage at Maximum Tap Position
ull Double % Voltage Lower Limit
uul Double % Voltage Upper Limit
Plp Double MW Active Power Lower Limit for Controller
Pup Double MW Active Power Upper Limit for Controller
Qlp Double Mvar Reactive Power Lower Limit for Controller
Qup Double Mvar Reactive Power Upper Limit for Controller
Dynamics
ResFlux1 Double pu Residual Flux Phase L1
ResFlux2 Double pu Residual Flux Phase L2
ResFlux3 Double pu Residual Flux Phase L3
Three-Winding Transformer (ThreeWindingTransformer)
Attribute name Data type Unit Description
Un1 Double kV Rated Voltage (Side 1)
Un2 Double kV Rated Voltage (Side 2)
Un3 Double kV Rated Voltage (Side 3)
Sn12 Double MVA Rated Apparent Through Power (Side 1-2)
Sn23 Double MVA Rated Apparent Through Power (Side 2-3)
Sn31 Double MVA Rated Apparent Through Power (Side 3-1)
Smax1 Double MVA Full Load Power (Side 1)
Smax2 Double MVA Full Load Power (Side 2)
Smax3 Double MVA Full Load Power (Side 3)
Smax1_1 Double MVA First Additional Full Load Power (Side 1)
Smax1_2 Double MVA Second Additional Full Load Power (Side 1)
Smax1_3 Double MVA Third Additional Full Load Power (Side 1)
Smax2_1 Double MVA First Additional Full Load Power (Side 2)
Smax2_2 Double MVA Second Additional Full Load Power (Side 2)
Smax2_3 Double MVA Third Additional Full Load Power (Side 2)
Smax3_1 Double MVA First Additional Full Load Power (Side 3)
Smax3_2 Double MVA Second Additional Full Load Power (Side 3)
Smax3_3 Double MVA Third Additional Full Load Power (Side 3)
uk1 Double % Reference Short Circuit Voltage (Side 1-2)
uk2 Double % Reference Short Circuit Voltage (Side 2-3)
uk3 Double % Reference Short Circuit Voltage (Side 3-1)
ur1 Double % Ohmic Short Circuit Voltage (Side 1-2)
ur2 Double % Ohmic Short Circuit Voltage (Side 2-3)
ur3 Double % Ohmic Short Circuit Voltage (Side 3-1)
i0 Double % No Load Current
Vfe Double kW Iron Losses
phi1 Double ° Additional Phase Rotation (Side 1)
phi2 Double ° Additional Phase Rotation (Side 2)
phi3 Double ° Additional Phase Rotation (Side 3)
VecGrp1 Integer Vector Group (Side 1) 1: Y0, 2: YN0, 3: Y6, 4: YN6, 5: D1, 6: D5, 7: D7, 8: D11, 9: Z1, 10: ZN1, 11: Z5, 12: ZN5, 13: Z7, 14: ZN7, 15: Z11, 16: ZN11, 17: ATN, 18: AT
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 126/162
VecGrp2 Integer Vector Group (Side 2) 1: Y0, 2: YN0, 3: Y6, 4: YN6, 5: D1, 6: D5, 7: D7, 8: D11, 9: Z1, 10: ZN1, 11: Z5, 12: ZN5, 13: Z7, 14: ZN7, 15: Z11, 16: ZN11, 17: ATN, 18: AT
VecGrp3 Integer Vector Group (Side 3) 1: Y0, 2: YN0, 3: Y6, 4: YN6, 5: D1, 6: D5, 7: D7, 8: D11, 9: Z1, 10: ZN1, 11: Z5, 12: ZN5, 13: Z7, 14: ZN7, 15: Z11, 16: ZN11
Zero-Phase Sequence
FlagZ0Input Integer Input 1: Z0/Z1 and R0/X0 2: R0 and X0 3: R0/R1 and X0/X1
Z0_Z1_12 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
Z0_Z1_23 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
Z0_Z1_31 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0_12 Double pu Ratio R/X – Zero-Phase Sequence
R0_X0_23 Double pu Ratio R/X – Zero-Phase Sequence
R0_X0_31 Double pu Ratio R/X – Zero-Phase Sequence
R0_12 Double Ohm Resistance – Zero-Phase Sequence
R0_23 Double Ohm Resistance – Zero-Phase Sequence
R0_31 Double Ohm Resistance – Zero-Phase Sequence
X0_12 Double Ohm Reactance – Zero-Phase Sequence
X0_23 Double Ohm Reactance – Zero-Phase Sequence
X0_31 Double Ohm Reactance – Zero-Phase Sequence
X0_X1_12 Double pu Ratio Zero-Phase to Positive-Phase Reactance
X0_X1_23 Double pu Ratio Zero-Phase to Positive-Phase Reactance
X0_X1_31 Double pu Ratio Zero-Phase to Positive-Phase Reactance
R0_R1_12 Double pu Ratio Zero-Phase to Positive-Phase Resistance
R0_R1_23 Double pu Ratio Zero-Phase to Positive-Phase Resistance
R0_R1_31 Double pu Ratio Zero-Phase to Positive-Phase Resistance
Controller
Flag_Roh1 Integer State – Tap Position (Side 1) 0: None 1: Fixed 2: Node 3: Impedance 4: Active power 5: Reactive power
Flag_Roh2 Integer State – Tap Position (Side 2) 0: None 1: Fixed 2: Node 3: Impedance 4: Active power 5: Reactive power
Flag_Roh3 Integer State – Tap Position (Side 3) 0: None 1: Fixed 2: Node 3: Impedance 4: Active power 5: Reactive power
roh1 Double Present Tap Position (Side 1)
roh2 Double Present Tap Position (Side 2)
roh3 Double Present Tap Position (Side 3)
rohl1 Double Minimum Tap Position (Side 1)
rohl2 Double Minimum Tap Position (Side 2)
rohl3 Double Minimum Tap Position (Side 3)
rohm1 Double Main Tap Position (Side 1)
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 127/162
rohm2 Double Main Tap Position (Side 2)
rohm3 Double Main Tap Position (Side 3)
rohu1 Double Maximum Tap Position (Side 1)
rohu2 Double Maximum Tap Position (Side 2)
rohu3 Double Maximum Tap Position (Side 3)
Dynamics
ResFlux1 Double pu Residual Flux Phase L1
ResFlux2 Double pu Residual Flux Phase L2
ResFlux3 Double pu Residual Flux Phase L3
Line (Line)
Attribute name Data type Unit Description
Flag_LineTyp Integer Line Type 1: Cable 2: Overhead line 3: Connector
FlagMat Integer Line Material 1: Al 2: Cu
Len Double km Length
ParSys Double 1 Number of Parallel Systems
R Double Ohm/km Resistance
X Double Ohm/km Reactance
C Double nF/km Capacitance
va Double kW/km Leakage Losses to Ground
FrqNenn Double Hz Rated Frequency
Ith Double kA Thermal Limit Current
Ith1 Double kA First Additional Limit Current
Ith2 Double kA Second Additional Limit Current
Ith3 Double kA Third Additional Limit Current
alpha Double 1/°C Temperature Coefficient for Temperature Dependent Resistance Change
Zero-Phase Sequence
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: X0/X1 and R0/R1 2: r0 and x0
R0_R1 Double pu Ratio Zero-Phase to Positive-Phase Resistance
X0_X1 Double pu Ratio Zero-Phase to Positive-Phase Reactance
R0 Double Ohm/km Resistance – Zero-Phase Sequence
X0 Double Ohm/km Reactance – Zero-Phase Sequence
C0 Double nF/km Capacitance in Zero-Phase Sequence
rR Double Ohm/km Resistance – Return Conductor
xR Double Ohm/km Reactance – Return Conductor
Variable Serial Element (VarSerialElement)
Attribute name Data type Unit Description
Flag_LF Integer Load Flow Input 1: Impedance 2: Model
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 128/162
Ur1 Double kV Rated Voltage Side 1
Ur2 Double kV Rated Voltage Side 2
R12lf Double Ohm Resistance Load Flow
X12lf Double Ohm Reactance Load Flow
R21lf Double Ohm Resistance Load Flow
X21lf Double Ohm Reactance Load Flow
PhiLf Double ° Phase Rotation Load Flow
Flag_Macro_LF Integer Model Type Load Flow 0: None 1: Controller 2: Equivalent circuit
R12sc Double Ohm Resistance Short Circuit
X12sc Double Ohm Reactance Short Circuit
R21sc Double Ohm Resistance Short Circuit
X21sc Double Ohm Reactance Short Circuit
PhSc Double ° Phase Rotation Short Circuit
Zero-Phase Sequence
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: Z0/Z1 and R0/X0 2: R0 and X0
Z0_Z1 Double pu Ratio Zero-Phase to Positive-Phase Sequence Impedance
R0_X0 Double pu Ratio R/X – Zero-Phase Sequence
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Dynamics
Flag_Macro_SC Integer Impedances for Dynamics 1: Load flow 2: Short circuit
Harmonics
Flag_Har Integer State – Harmonics 0: No frequency dependency 1: Quality – R constant 2: Quality – X/R constant 3: Impedance characteristic
qr Double 1 Quality – R Constant
ql Double 1 Quality – X/R Constant
Serial Reactor (SerialReactor)
Attribute name Data type Unit Description
Flag_CoInput Integer Input Data 1: Reference coil voltage 2: Inductance
uD Double % Reference Coil Voltage
L Double mH Inductance
Un Double kV Rated Voltage
InD Double kA Rated Current
Ith1 Double kA First Additional Limit Current
Ith2 Double kA Second Additional Limit Current
Ith3 Double kA Third Additional Limit Current
R_X Double Ratio R/X – Positive-Phase Sequence
Zero-Phase Sequence
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 129/162
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: R0/R1 and X0/X1 2: R0 and X0 3: R0 and L0
X0_X1 Double Ratio Zero-Phase to Positive-Phase Reactance
R0_R1 Double Ratio Zero-Phase to Positive-Phase Resistance
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
L0 Double mH Inductance in Zero-Phase Sequence
Dynamics
ResFlux1 Double pu Residual Flux Phase L1
ResFlux2 Double pu Residual Flux Phase L2
ResFlux3 Double pu Residual Flux Phase L3
Serial Capacitor (SerialCondensator)
Attribute name Data type Unit Description
C Double nF/km Capacitance
XC Double Ohm Capacitive Reactance
Un Double kV Rated Voltage
Smax Double MVA Full Load Power
Smax1 Double MVA First Additional Full Load Power
Smax2 Double MVA Second Additional Full Load Power
Smax3 Double MVA Third Additional Full Load Power
R_X Double pu Ratio R/X – Positive-Phase Sequence
Zero-Phase Sequence
Flag_Z0Input Integer Zero-Phase Sequence Input Data 1: R0/R1 and X0/X1 2: R0 and X0 3: R0 and C0
X0_X1 Double Ratio Zero-Phase to Positive-Phase Reactance
R0_R1 Double Ratio Zero-Phase to Positive-Phase Resistance
R0 Double Ohm Resistance – Zero-Phase Sequence
X0 Double Ohm Reactance – Zero-Phase Sequence
Serial Harmonics Resonance Network (HarBranchResNet)
Attribute name Data type Unit Description
Un Double kV Rated Voltage
R1 Double Ohm Resistance at Network Frequency
X1 Double Ohm Reactance at Network Frequency
Impedance Integer Determine Impedance 1: Vmax 2: Imax
RCData Integer Ripple Control Impedance 0: No 1: Yes
R1rc Double Ohm Resistance at Ripple Control Frequency
X1rc Double Ohm Reactance at Ripple Control Frequency
Zero-Phase Sequence
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 130/162
FlagZ0 Integer Input Data Zero-Phase Sequence System 1: Blocking 2: Z0 identical Z1 3: R0/R1 and X0/X1 4: R0 and X0
R0 Double Ohm Resistance Zero-Phase Sequence System
X0 Double Ohm Reactance Zero-Phase Sequence System
R0_R1 Double 1 Ratio Zero-Phase to Positive-Phase Resistance
X0_X1 Double 1 Ratio Zero-Phase to Positive-Phase Reactance
Fault Observation (ProtOCFault)
Attribute name Data type Unit Description
Flag_State Integer Operating State 0: Off 1: On
Node_ID Long Integer Sets the node
Element_ID Long Integer Sets the branch
Flag_FaultPhase Integer Faulty Phases 1: L1 2: L2 3: L3 4: L23 5: L31 6: L12 7: L123 0: None
Flag_InterruptPhase Integer Interrupted Phases 1: L1 2: L2 3: L3 6: L12 4: L23 5: L31 7: L123 0: None 8: N 9: L123N
len Double Distance
Flag_FaultReturn Integer Fault to Return Conductor 1: Short Circuit 2: Return Circuit 3: Ground Circuit 4: Return and Ground Circuit
Flag_FaultGround Integer Fault to Ground 1: Short Circuit 2: Return Circuit 3: Ground Circuit 4: Return and Ground Circuit
Dynamics
Flag_RefPhase Integer Reference Phase 0: None 1: L1 2: L2 3: L3
Flag_CondFaultOn Integer Conditions Fault On 0: None 1: Default 2: Time 3: Voltage 4: Voltage and time delay
ton Double Time On
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 131/162
On_NodeID Long Integer On Node
Flag_PhaseOn Integer On Phase 1: L1 2: L2 3: L3
Flag_Val Integer On Voltage 1: Minimum 2: Maximum 3: User-defined
Uon Double On Voltage
dT1 Double On Time Delay – Next Phase
dT2 Double On Time Delay – Previous Phase
Flag_CondFaultOff Integer Conditions Fault Off 0: None 1: Default 2: Time 3: Current 4: Current and time delay
toff Double Time Off
Current Double Off Current
Protection Location (ProtLocation)
Attribute name Data type Unit Description
Flag_State Integer Active 0: Off 1: On
4.2.4 Attributes of Calculation Objects for Pipe Networks
Water Networks
Calculation Settings (FlowCalcParameter)
Attribute name Data type Unit Description
ITmax Integer Maximum Number of Iterations (Non-Linear)
ITmax2 Integer Maximum Number of Iterations (Linear)
MeshAccuracy Double bar Mesh Accuracy
NodeAccuracy Double l/s Node Accuracy
FlowStep Double l/s Maximum Step for Flow
Flag_Operate Integer Check Operating Conditions 0: Warning 1: Error
fCharCurve Double pu Characteristic Curve Factor
SpecDensity Double kg/m³ Specific Density
KinematicVis Double mm²/s Kinematic Viscosity
Flag_Pump Integer Parallel Pumps 0: No 1: Yes
Geo-stationary
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 132/162
Flag_Result Integer Store Results in Database 0: None 1: All 2: Restricted elements only 3: All elements in case of restrictions
StartTime Double s Starting Time
Duration Double s Duration
TimeStepGeo Double s Time Step Geo-stationary
Network Level (FlowVoltageLevel)
Attribute name Data type Unit Description
pRated Double bar Rated Pressure
vMax Double m/s Maximum Flow Velocity
pMin Double bar Minimum Operating Pressure
pMax Double bar Maximum Operating Pressure
Network Area (FlowNetworkGroup)
Attribute name Data type Unit Description
Flag_MarkedForCaused Integer Marked for Caused Malfunction 0: No 1: Yes
Flag_Malfunc Integer Malfunction 0: None 1: All elements 2: All lines 3: All restricted elements 4: All restricted lines
Speed_BaseLimit Double m/s Base Speed Limit
Flag_CausedMalfunc Integer Caused Malfunction 0: None 1: Marked areas 2: Own area
Speed_CausedLimit Double m/s Caused Speed Limit
Flag_CausedElem Integer Caused Elements 1: Restricted elements 2: Restricted lines
Flag_Report Integer Reporting 0: None 1: Elements and nodes 2: Lines and nodes 3: Elements 4: Lines 5: Nodes
Flag_FireWater Integer Join Fire Water Simulation 0: No 1: Yes
ConLineLength Double m Connection Line Length
ConLineDiameter Double mm Connection Line Diameter
ConLineRoughness Double mm Connection Line Sand Roughness
ConLineZeta Double Connection Line Sand Zeta Value
dsh Double m Delta Elevation
QFireWater Double l/s Fire Flow
pFireWater Double bar Fire Pressure
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 133/162
tFireWater Double h Fire Time
pRelMinLimit Double bar Minimum Pressure – Relative at Fire Water Simulation
Const. Pressure Decrease/Const. Flow (FlowConstLine)
Attribute name Data type Unit Description
Flag_Typ Integer Line Type 1: Constant pressure drop 2: Constant flow
PressureDecr Double bar Pressure Drop
Consumer (FlowConsumer)
Attribute name Data type Unit Description
Q Double l/s Constant Consumption
Flag_ConControl Integer Pressure Dependent Consumption Decrease 0: No 1: Yes
pDiffMin Double bar Minimum Pressure Difference
pRelMin Double bar Minimum Relative Pressure
Pressure Regulator (FlowPressureReg)
Attribute name Data type Unit Description
Flag_PessInc Integer Function 1: Pressure increase 2: Pressure drop 3: Pressure increase and drop
pInlet Double bar Pressure at Inlet Node
pOutlet Double bar Pressure at Outlet Node
pDevation Double bar Maximum Pressure Deviation
Pressure Increase Pump (FlowPumpLine)
Attribute name Data type Unit Description
Flag_Type Integer Pump Type 1: Centrifugal pump 2: Reciprocating pump
QOutput Double l/s Output Flow
FlowStep Double l/s Maximum Flow
uPump Double 1/min Characteristic Pump Speed
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 134/162
Sliding Valve/Non-Return Valve (FlowValve)
Attribute name Data type Unit Description
Flag_Type Integer Valve Type 1: Sliding valve 2: Non-return valve
Pos Integer Valve Position 0: Close 1: Open
Opening Double % Degree of Opening
Diameter Double mm Valve Diameter
Leakage (FlowLeakage)
Attribute name Data type Unit Description
OutputSurface Double mm² Output Surface
fFlow Double pu Flow Number
FlowStep Double l/s Maximum Step for Flow
ConLineLength Double m Connection Line Length
ConLineDiameter Double mm Connection Line Diameter
ConLineRoughness Double mm Connection Line Sand Roughness
ConLineZeta Double Connection Line Sand Zeta Value
dsh Double m Delta Elevation
QFireWater Double l/s Fire Water Flow
pFireWater Double bar Fire Water Pressure
tFireWater Double h Fire Water Time
Pressure Buffer (FlowPressureBuffer)
Attribute name Data type Unit Description
PMax Double bar Maximum Pressure
Pump (FlowPump)
Attribute name Data type Unit Description
Flag_Type Integer Pump Type 1: Centrifugal pump 2: Reciprocating pump
QOutput Double l/s Output Flow
FlowStep Double l/s Maximum Flow
uPump Double 1/min Characteristic Pump Speed
Flag_Limits Integer Limit Type 0: None 1: Flow
QOutputmin Double l/s Minimum Output Flow
QOutputmax Double l/s Maximum Output Flow
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 135/162
Water Tower (FlowWaterTower)
Attribute name Data type Unit Description
hWaterLevel Double m Water Level
Flag_Level Integer Level Data 0: No 1: Yes
Flag_Limits Integer Limit Type 0: None 1: Flow
Qmin Double l/s Minimum Flow
Qmax Double l/s Maximum Flow
Geo-stationary
hFillStart1 Double m Filling Level 1 Start
hFillStop1 Double m Filling Level 1 Stop
uPump1 Double 1/min Secondary Key – Pump Characteristics 1
hFillStart2 Double m Filling Level 2 Start
hFillStop2 Double m Filling Level 2 Stop
uPump2 Double 1/min Secondary Key – Pump Characteristics 2
hFillStart3 Double m Filling Level 3 Start
hFillStop3 Double m Filling Level 3 Stop
uPump3 Double 1/min Secondary Key – Pump Characteristics 3
Line (FlowLine)
Attribute name Data type Unit Description
LineLength Double m Length
Diameter Double mm Diameter
SandRoughness Double mm Sand Roughness
fLength Double % Length Allowance Factor
fCurve Double Curve Factor
Zeta Double Zeta Value
LeakageRate Double l/sm Leakage Rate
fRoughnessAn Double % Annual Roughness Increase
fDiameterAn Double % Annual Diameter Reduction
Node (FlowNode)
Attribute name Data type Unit Description
Sh Double m Elevation
Gas Networks
Calculation Settings (FlowCalcParameter)
Attribute name Data type Unit Description
ITmax Integer Maximum Number of Iterations (Non-Linear)
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 136/162
ITmax2 Integer Maximum Number of Iterations (Linear)
MeshAccuracy Double bar Mesh Accuracy
NodeAccuracyG Double m³/h Node Accuracy
FlowStepG Double m³/h Maximum Step for Flow
Flag_Operate Integer Check Operating Conditions 0: Warning 1: Error
SpecDensity Double kg/m³ Specific Density
HeatingAmount Double MJ/kg Energy Content
pAir Double bar Air Pressure
SutherlandConst Double K Sutherland Constant
AdiabaticExp Double Adiabatic Exponent
fConst Double Constant Factor
fLinear Double Linear Factor
Geo-stationary
Flag_Result Integer Store Results in Database 0: None 1: All 2: Restricted elements only 3: All elements in case of restrictions
StartTime Double s Starting Time
Duration Double s Duration
TimeStepGeo Double s Time Step Geo-stationary
Network Level (FlowVoltageLevel)
Attribute name Data type Unit Description
pRated Double bar Rated Pressure
TGas Double °C Gas Temperature
TAir Double °C Air Temperature
vMax Double m/s Maximum Flow Velocity
pMin Double bar Minimum Operating Pressure
pMax Double bar Maximum Operating Pressure
Network Area (FlowNetworkGroup)
Attribute name Data type Unit Description
Flag_MarkedForCaused Integer Marked for Caused Malfunction 0: No 1: Yes
Flag_Malfunc Integer Malfunction 0: None 1: All elements 2: All lines 3: All restricted elements 4: All restricted lines
Speed_BaseLimit Double m/s Base Speed Limit
Flag_CausedMalfunc Integer Caused Malfunction 0: None 1: Marked areas 2: Own area
Speed_CausedLimit Double m/s Caused Speed Limit
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 137/162
Flag_CausedElem Integer Caused Elements 1: Restricted elements 2: Restricted lines
Flag_Report Integer Reporting 0: None 1: Elements and nodes 2: Lines and nodes 3: Elements 4: Lines 5: Nodes
Compressor (FlowCompressor)
Attribute name Data type Unit Description
pInlet Double bar Maximum Pressure Deviation
pDevation Double bar Pressure at Inlet Node
pOutlet Double bar Pressure at Outlet Node
Const. Pressure Decrease/Const. Flow (FlowConstLine)
Attribute name Data type Unit Description
Flag_Typ Integer Line Type 1: Constant pressure drop 2: Constant flow
PressureDecr Double bar Pressure Drop
FlowGas Double mN³/h Flow
Consumer (FlowConsumer)
Attribute name Data type Unit Description
Flag_Q Integer Consumption Type 1: Standard 2: Operating Conditions 3: Power
Q1 Double m³/h Constant Consumption – Standard
Q2 Double m³/h Constant Consumption – Operating Cond.
Q3 Double MW Constant Consumption – Power
pDiffMin Double bar Minimum Pressure Difference
pRelMin Double bar Minimum Relative Pressure
Pressure Regulator (FlowPressureReg)
Attribute name Data type Unit Description
Flag_PessInc Integer Function 1: Pressure increase 2: Pressure drop 3: Pressure increase and drop
pInlet Double bar Pressure at Inlet Node
pOutlet Double bar Pressure at Outlet Node
pDevation Double bar Maximum Pressure Deviation
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 138/162
QReturn Double m³/h Maximum Return Flow
Sliding Valve/Non-Return Valve (FlowValve)
Attribute name Data type Unit Description
Flag_Type Integer Valve Type 1: Sliding valve 2: Non-return valve
Pos Integer Valve Position 0: Close 1: Open
Leakage (FlowLeakage)
Attribute name Data type Unit Description
OutputSurface Double mm² Output Surface
fFlow Double pu Flow Number
FlowStpG Double m³/h Maximum Step for Flow
Infeeder Gas (FlowInfeederG)
Attribute name Data type Unit Description
Flag_Typ Integer Infeeder Type 1: Pressure supply 2: Flow supply
QReturn Double m³/h Maximum Return Flow
pConst Double bar Constant Excess Pressure
FlagQ Integer Flow Supply Type 1: Flow supply 2: Operating Conditions 3: Power
Q1 Double m³/h Constant Supply – Standard
Q2 Double m³/h Constant Supply – Operating Condition
Q3 Double MW Constant Supply – Power
Flag_Limits Integer Limit Type 0: None 1: Flow
Qmin Double Minimum Supply
Qmax Double Maximum Supply
Pressure Buffer (FlowPressureBuffer)
Attribute name Data type Unit Description
PMax Double bar Maximum Pressure
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 139/162
Line (FlowLine)
Attribute name Data type Unit Description
LineLength Double m Length
Diameter Double mm Diameter
SandRoughness Double mm Sand Roughness
fLength Double % Length Allowance Factor
fCurve Double Curve Factor
Zeta Double Zeta Value
fRoughnessAn Double % Annual Roughness Increase
fDiameterAn Double % Annual Diameter Reduction
Node (FlowNode)
Attribute name Data type Unit Description
Pres Double bar Pressure Reservation
Sh Double m Elevation
Heating/Cooling Networks
Calculation Settings (FlowCalcParameter)
Attribute name Data type Unit Description
ITmax Integer Maximum Number of Iterations (Non-Linear)
ITmax2 Integer Maximum Number of Iterations (Linear)
MeshAccuracy Double bar Mesh Accuracy
NodeAccuracy Double l/s Node Accuracy
FlowStep Double l/s Maximum Step for Flow
Flag_Operate Integer Check Operating Conditions 0: Warning 1: Error
qSpec Double J/kgK Specific Thermal Capacity
Flag_MalFunc Integer Circuit for Malfunction 1: Supply line 2: Return line 3: Supply and return line
Geo-stationary
Flag_Result Integer Store Results in Database 0: None 1: All 2: Restricted elements only 3: All elements in case of restrictions
StartTime Double s Starting Time
Duration Double s Duration
TimeStepGeo Double s Time Step Geo-stationary
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 140/162
Network Level (FlowVoltageLevel)
Attribute name Data type Unit Description
pRated Double bar Rated Pressure
TRated Double °C Rated Temperature
TAir Double °C Air Temperature
vMax Double m/s Maximum Flow Velocity
pMin Double bar Minimum Operating Pressure Supply Line
pMax Double bar Maximum Operating Pressure Supply Line
TSupplyLine Double °C Temperature Supply Line
pMinR Double bar Minimum Operating Pressure Return Line
pMaxR Double bar Maximum Operating Pressure Return Line
TReturnLine Double °C Temperature Return Line
Network Area (FlowNetworkGroup)
Attribute name Data type Unit Description
Flag_MarkedForCaused Integer Marked for Caused Malfunction 0: No 1: Yes
Flag_Malfunc Integer Malfunction 0: None 1: All elements 2: All lines 3: All restricted elements 4: All restricted lines
Speed_BaseLimit Double m/s Base Speed Limit
Flag_CausedMalfunc Integer Caused Malfunction 0: None 1: Marked areas 2: Own area
Speed_CausedLimit Double m/s Caused Speed Limit
Flag_CausedElem Integer Caused Elements 1: Restricted elements 2: Restricted lines
Flag_Report Integer Reporting 0: None 1: Elements and nodes 2: Lines and nodes 3: Elements 4: Lines 5: Nodes
Const. Pressure Decrease/Const. Flow (FlowConstLine)
Attribute name Data type Unit Description
Flag_Typ Integer Line Type 1: Constant pressure drop 2: Constant flow
PressureDecr Double bar Pressure Drop
FlowHeating Double t/h Flow
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 141/162
Consumer (FlowConsumer)
Attribute name Data type Unit Description
Q Double l/s Constant Consumption
Flag_ConTyp Integer Consumption Type 1: Constant consumption 2: Constant power consumption 3: Sum of consumption and power
Q3 Double MW Constant Consumption – Power
Q4 Double t/h Constant Consumption
Power Double MW Constant Consumption – Power
Flag_ConControl Integer Pressure Dependent Consumption Decrease 0: No 1: Yes
pDiffMin Double bar Minimum Pressure Difference
Flag_Temp Integer Temperature Type 1: Return temperature 2: Difference of temperature
T Double °C Temperature
Heat Exchanger (FlowHeatExchanger)
Attribute name Data type Unit Description
Flag_Typ Integer Heat Exchanger Type 1: Hydraulic uncoupling 2: Power apply
Power Double MW Power
Efficiency Double % Efficiency
Flag_ConControl Integer Primary Pressure Dependent Consumption Decrease 0: No 1: Yes
pDiffMin Double bar Primary Minimum Pressure Difference
Flag_Master Integer Leading Supply 0: No 1: Yes
Flag_Temp Integer Temperature Type 1: Return temperature 2: Difference of temperature sup – ret 3: Difference of temperature sec – prim
tPrim Double °C Primary Temperature
tFeed Double °C Secondary Supply Temperature
Flag_Maint Integer Pressure Maintenance Type 1: Medium pressure, difference and parts 2: Supply pressure and difference 3: Return pressure and difference 4: Pump data and parts 5: Supply pressure and pump data 6: Return pressure and pump data
pMedium Double bar Medium Pressure
pSupRet Double bar Difference Pressure
pSupplyMaint Double bar Supply Pressure
pReturnMaint Double bar Return Pressure
SupplyPart Double % Part – Supply Pressure
ReturnPart Double % Part – Return Pressure
uPump Double 1/min Characteristic Pump Speed
QOutput Double l/s Output Flow
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 142/162
FlowStep Double l/s Maximum Step for Flow
Pressure Regulator (FlowPressureReg)
Attribute name Data type Unit Description
Flag_PessInc Integer Function 1: Pressure increase 2: Pressure drop 3: Pressure increase and drop
pInlet Double bar Pressure at Inlet Node
pOutlet Double bar Pressure at Outlet Node
pDevation Double bar Maximum Pressure Deviation
Flag_PressDif Integer Difference Pressure Regulator 0: No 1: Yes
pSupRet Double bar Difference Pressure
Pressure Increase Pump (FlowPumpLine)
Attribute name Data type Unit Description
Flag_Type Integer Pump Type 1: Centrifugal pump 2: Reciprocating pump
QOutput Double l/s Output Flow
FlowStep Double l/s Maximum Flow
uPump Double 1/min Characteristic Pump Speed
Sliding Valve/Non-Return Valve (FlowValve)
Attribute name Data type Unit Description
Flag_Type Integer Valve Type 1: Sliding valve 2: Non-return valve
Pos Integer Valve Position 0: Close 1: Open
Opening Double % Degree of Opening
Diameter Double mm Valve Diameter
Leakage (FlowLeakage)
Attribute name Data type Unit Description
OutputSurface Double mm² Output Surface
fFlow Double pu Flow Number
FlowStep Double l/s Maximum Step for Flow
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 143/162
Temperature Regulator (FlowThermoReg)
Attribute name Data type Unit Description
tMin Double °C Minimum Temperature
tMax Double °C Maximum Temperature
TempAccuracy Double °C Temperature Accuracy
FlowStep Double t/h Maximum Step for Flow
Infeeder Heating/Cooling (FlowInfeederH)
Attribute name Data type Unit Description
Flag_Typ Integer Infeeder Type 1: Pressure supply 2: Power Supply 3: Pressure maintenance
pSupply Double bar Pressure Supply
Flag_SupTyp Integer Power Supply Type 1: Constant supply 2: Constant supply power
Q Double t/h Constant Supply Volume
Power Double MW Constant Power Supply
Flag_ConControl Integer Pressure Dependent Supply Decrease 0: No 1: Yes
pDiffMin Double bar Minimum Pressure Difference
Flag_T Integer Temperature Type 1: Supply temperature 2: Difference of temperature
T Double °C Temperature
Flag_Maint Integer Pressure Maintenance Type 1: Medium pressure, difference and parts 2: Supply pressure and difference 3: Return pressure and difference 4: Pump data and parts 5: Supply pressure and pump data 6: Return pressure and pump data
pMedium Double bar Medium Pressure
pSupRet Double bar Difference Pressure
pSupplyMain Double bar Supply Pressure
pReturnMain Double bar Return Pressure
SupplyPart Double % Part – Supply Pressure
ReturnPart Double % Part – Return Pressure
Flag_Limits Integer Limit Type 0: None 1: Flow 2: Power
Qmin Double t/h Minimum Flow
Qmax Double t/h Maximum Flow
Pmin Double MW Minimum Power
Pmax Double MW Maximum Power
QOutput Double l/s Output Flow
uPump Double 1/min Characteristic Pump Speed
FlowStep Double l/s Maximum Step for Flow
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 144/162
Flag_Master Integer Leading Supply 0: No 1: Yes
Pressure Buffer (FlowPressureBuffer)
Attribute name Data type Unit Description
PMax Double bar Maximum Pressure
Pump (FlowPump)
Attribute name Data type Unit Description
Flag_Type Integer Pump Type 1: Centrifugal pump 2: Reciprocating pump
QOutput Double l/s Output Flow
FlowStep Double l/s Maximum Flow
uPump Double 1/min Characteristic Pump Speed
tSupply Double °C Supply Temperature
Flag_Limits Integer Limit Type 0: None 1: Flow
QOutputmin Double l/s Minimum Output Flow
QOutputmax Qmax l/s Maximum Output Flow
Line (FlowLine)
Attribute name Data type Unit Description
LineLength Double m Length
Diameter Double mm Diameter
SandRoughness Double mm Sand Roughness
fLength Double % Length Allowance Factor
fCurve Double Curve Factor
Zeta Double Zeta Value
LeakageRate Double l/sm Leakage Rate
HeatingCond Double W/Mk Thermal Conductivity
Node (FlowNode)
Attribute name Data type Unit Description
PDiffMin Double bar Minimum Pressure Difference
Sh Double m Elevation
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 145/162
4.3 Parameters of Calculation Methods
Different calculation methods have different parameters.
Globale Parameters
Parameter Data type Description
"Sim.Identification" String Name identifying the objects
"Name" = identification by a name "ShortName" = identification by a short name
Determines whether the name ("Name") or short name ("ShortName") is used to identify an object.
"GRAPHIC_VIEWID" Integer The graphic view using for the calculations (GraphicAreaTile_ID)
Contingency Analysis
Parameter Data type Description
"CA_MODE" String Specifies the calculation mode
"NORMAL" = normal calculation
"REDUCED" = reduced calculation
"PRE_ANALYSE" = preanalysis
"CA_PRE_ANALYSE_MODE" String Specifies the calculation method for the pre-analysis
"VOLT" = voltage change
"ISOL_POWER" = not delivered power
"ISOL_ELEMENTS" = not supplied elements
"ISOL_CONSUMERS" = not supplied loads
"CA_PRE_ANALYSE_COUNT" Integer Number of malfunctions to be calculated
"CA_WITH_RESUPPLY" Integer Perform resupply
0 = no
1 = yes
Restoration of Supply
Parameter Data type Description
"LF_RESUP_MODE" Integer Specifies the mode
0 = standard
1 = feeder based
"LF_RESUP_RESUPPLYCNT_ACT" Integer Activation of the maximum number of restorations of supply
0 = not activated
1 = activated
"LF_RESUP_RESUPPLYCNT" Integer Maximum number of resupplies
"LF_RESUP_SWITCHCNT_ACT" Integer Activation of the maximum number of switching actions
0 = not activated
1 = activated
"LF_RESUP_SWITCHCNT" Integer Maximum number of switching actions
"LF_RESUP_LOADSHEDDING_ACT" Integer Activation of load shedding
0 = not activated
1 = activated
"LF_RESUP_VIOLATION_ACT" Integer Activation of limit violations
0 = not activated
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 146/162
1 = activated
"LF_RESUP_SWITCHCNT_FACTOR" Double Weighting for switching actions
"LF_RESUP_LOADSHEDDING_FACTOR" Double Weighting for load shedding
"LF_RESUP_VIOLATION_FACTOR" Double Weighting for violations
"LF_RESUP_PHYSICALSWITCH_ACT" Integer Consider only physical switches
0 = not activated
1 = activated
"LF_RESUP_RESUPPLYGRP_ID" Integer Database ID of the resupply to be recalculated
"LF_RESUP_NOTFEDCONSUMERS_FACTOR" Double Weighting of unsupplied consumers
"LF_RESUP_NOTSUPPLIEDPOWER_FACTOR" Double Weighting of unsupplied power
PV Curves
Parameter Data type Description
"GEN_PV_P" Double Maximum active power
"GEN_PV_Q" Double Maximum reactive power
VoltVar
Parameter Data type Description
"OPT_VOLTVAR_CAP_SN" Double Rated apparent power for the capacitor
"OPT_VOLTVAR_TRAFO" Integer Activation of the transformer
0 = not activated
1 = activated
"OPT_VOLTVAR_TRAFO_SN" Double Rated apparent power for the transformer
"OPT_VOLTVAR_TRAFO_UK" Double Reference short circuit voltage for the transformer
"OPT_VOLTVAR_LIMIT_LOWER" Double Voltage lower limit in %
"OPT_VOLTVAR_LIMIT_UPPER" Double Voltage upper limit in %
"OPT_VOLTVAR_MINMAX_MODE" Integer Specifies the calculation mode
0 = factor
1 = operating point
"OPT_VOLTVAR_MIN_FACTOR" Double Factor for minimum
"OPT_VOLTVAR_MAX_FACTOR" Double Factor for maximum
"OPT_VOLTVAR_MIN_OPID" Integer Operating point for minimum
"OPT_VOLTVAR_MAX_OPID" Integer Operating point for maximum
"OPT_VOLTVAR_MODE" Integer Algorithm
1 = Heuristic
2 = Ant method
"OPT_VOLTVAR_MAX_CAPO" Integer Maximum number of capacitors
"OPT_VOLTVAR_PER_PHASE" Integer Capacitor placement
1 = Per phase
2 = Symmetrical
"OPT_VOLTVAR_COMPENSATION_FIX" Integer Compensation power
1 = Fix
2 = Automatic
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 147/162
Hosting Capacity
Parameter Data type Description
"ICA_FILE“ String Parameter/result file
"ICA_ANALYSINGAREA" Integer Area of observation
1 = Network area
2 = Network element group
"ICA_AREAID" Integer Database ID of network area/network element group depending on area of observation
"ICA_VOLTAGELEVELIDS" String Database IDs of the network levels
"ICA_ONLYMARKEDNODES" Integer Consider only marked nodes
0 = not activated
1 = activated
"ICA_ELEMENTDATATYPE" Integer Element to be installed
1 = DC infeeder
2 = Load
"ICA_POWERINPUTTYPE"
Integer Terminal apparent power
1 = S and cos
2 = P and Q
"ICA_SMIN" Double Minimum apparent power
"ICA_COSPHIMIN" Double Minimum power factor
"ICA_SMAX" Double Maximum apparent power
"ICA_COSPHIMAX" Double Maximum power factor
"ICA_PMIN" Double Minimum active power
"ICA_QMIN" Double Minimum reactive power
"ICA_PMAX" Double Maximum active power
"ICA_QMAX" Double Maximum reactive power
"ICA_SACC" Double Accuracy
"ICA_FACTORK" Double Short circuit factor
"ICA_PHIK" Double Short circuit angle
"ICA_OPERATINGUMIN" Double Minimum operating voltage for DC infeeder
"ICA_OPERATINGUMAX" Double Maximum operating voltage for DC infeeder
"ICA_TOFF" Double Switch off for DC infeeder
"ICA_OBSERVATIONTYPE" Integer Observation type
1 = Current state
2 = Load profile
3 = Operating Points
"ICA_UMIN" Double Minimum voltage in the area of observation
"ICA_UMAX" Double Maximum voltage in the area of observation
"ICA_USWI" Double Maximum voltage difference in the area of observation
"ICA_IDH" Double Maximum utilization in the area of observation
"ICA_IATOIAMAX" Double Maximum break current
"ICA_IPTOPIPMAX" Double Maximum surge current
"ICA_TRAFOREVERSEFEED" Integer Allow reverse feed across transformers
0 = not activated
1 = activated
"ICA_PROTCHECK" Integer Verify protection settings
0 = not activated
1 = activated
"ICA_KMIN" Double Minimum k factor (only when protection setting is checked)
"ICA_LOADTRIPPINGCHECK“ Integer Check overload tripping
0 = not activated
1 = activated
"ICA_CHECKIATOIAMAX" Integer Check maximum tripping current
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 148/162
0 = no
1 = yes
"ICA_CHECKIDH" Integer Check maximum utilization in the area of observation
0 = no
1 = yes
"ICA_CHECKIPTOIPMAX" Integer Check maximum surge current
0 = no
1 = yes
"ICA_CHECKKMIN" Integer Check minimum k factor
0 = no
1 = yes
"ICA_CHECKUSWI" Integer Check maximum voltage difference in the area of observation
0 = no
1 = yes
"ICA_CHECKVOLTLIMITUMAX" Integer Check maximum voltage in the area of observation
0 = no
1 = yes
„ICA_CHECKVOLTLIMITUMIN“ Integer Check minimum voltage in the area of observation
0 = no
1 = yes
„ICA_DETECTRATEDCURR" Integer Extended determination of the protection device rated current
0 = no
1 = yes
"ICA_SCMETHOD" String Short circuit method
"ICA_SIMPLIFIEDNETWORK" Integer Use cluster for parallel calculation
0 = no
1 = yes
"ICA_ADMDISTANCE" Double Permissible distance (if clusters are activated)
"ICA_ADMVOLTAGEDIFF" Double Permissible voltage difference (if clusters are activated)
ICA_LIMITINGELEMCOUNT Integer Number of limiting elements per result criterion
Multiple Calculations
Parameter Data type Description
"SCN_VARIANT_ID" Integer Database for created base variant for the scenarios
"SCN_VARIANT_NAME" String Name of base variant for scenarios
"SCN_BASEVARIANT" Integer Database ID of base variant
"MCALC_METHODS" String Calculation methods separated with "|"
z.B.: "LF_NR|SC3|SC2"
"MCALC_MODE" Integer Calculation mode
0: Variants
1: Scenarios
"MCALC_VARIANTS" String Database IDs of variants separated with "|"
e.g.: "2|3|4"
Harmonics – Filter Design
Parameter Data type Description
"HAR_FILTER_MAXNUMBER" Integer Maximum number of filters per node
"HAR_FILTER_MARGIN" Double Safety margin
"HAR_FILTER_RESISTANCE" Double Damping resistance
"HAR_FILTER_TYPE" Integer RLC type for filter
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 149/162
0 = High pass R
1 = High pass C
Harmonics – Frequency Scan
Parameter Data type Description
"HAR_VAR_MODE" Integer Variation mode
0 = Single
1 = Combinations
"HAR_VAR_GROUPID" Integer Database ID of network element group used fort he network variations.
"HAR_VAR_ORDERNR" String Order numbers
"HAR_VAR_CONTROLLER" Integer Consider controller
0 = no
1 = yes
Load Assignment
Parameter Data type Description
"LFASSIGN_MODE" Integer Method
0 = Radial network
1 = Meshed network
2 = Network area
"LFASSIGN_MIN_VALUES" Integer Use minimum values
0 = no
1 = yes
"LFASSIGN_ALL_LOADS" Integer Include all loads
0 = no
1 = yes
Load Profile
Parameter Data type Description
"LFASSIGN_PARAM" Integer Use load determination
0 = no
1 = yes
"LFASSIGN_MODE" Integer Method
0 = Radial network
1 = Meshed network
2 = Network area
"LFASSIGN_MIN_VALUES" Integer Use minimum values
0 = no
1 = yes
"LFASSIGN_ALL_LOADS" Integer Include all loads
0 = no
1 = yes
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 150/162
Check OC Settings
Parameter Data type Description
"PROT_CHK_MODE" Integer Check mode
0 = Default settings
1 = Settings
2 = k Factor
"PROT_CHK_AREASELECTED" Integer Use selection
0 = no
1 = yes
"PROT_CHK_NETWORKGROUP" Integer Selected network element group
"PROT_CHK_FEEDERSELECTED" Integer Use feeder determination
0 = no
1 = yes
"PROT_CHK_SELECTION" String Amount of selection in the following syntax:
NodeID|ElementID;NodeID|ElementID;
Used for PROT_CHK_AREASELECTED and
PROT_CHK_FEEDERSELECTED
"PROT_CHK_TIMESELECT" Integer Check time selectivity
0 = no
1 = yes
"PROT_CHK_CURRSELECT" Integer Check current selectivity
0 = no
1 = yes
"PROT_CHK_MINTIMEDIFF" Double Minimum time difference which has to be observed between protection settings of different protection areas
"PROT_CHK_SCMETHOD" String Short circuit method for k Factor determination
"PROT_CHK_MINKFKT" Double Minimum k Factor
"PROT_CHK_CHKLOADTRIP" Integer Check load tripping
0 = no
1 = yes
"PROT_CHK_DETECTRATEDCURR" Integer Extended determination of the protection device rated current
0 = no
1 = yes
"PROT_CHK_EXCLUDES" String Protection devices excluded from the check
Protection Analysis
Parameter Data type Description
"PROTANALYSIS_SCMETHOD" String Short circuit method for fault calculation
"PROTANALYSIS_DISTANCE" Double Distance between the faults on a protection route
"PROTANALYSIS_FAULTPHASE" Integer Fault phase
"PROTANALYSIS_ADDFAULTDATA" Integer ID of the additional fault data
"PROTANALYSIS_SELECTION" Integer Type of the area to be calculated
0 = All
1 = Selection
2 = Network element group
"PROTANALYSIS_NETELEMGROUP" Integer ID of the network element group
"PROTANALYSIS_CHECKEXT" Integer Extended check type
0 = None
1 = Max. clearing time
2 = Destruction of conductors
"PROTANALYSIS_MAXFAULTCLEARTIME" Double Max. clearing time
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 151/162
"PROTANALYSIS_BWDROUTES" Integer Activate backward routes
0 = no
1 = yes
"PROTANALYSIS_DIFFDEV" Integer Use differential protection devices
0 = no
1 = yes
"PROTANALYSIS_MALFUNCTION" Integer Activate malfunction
0 = no
1 = yes
"PROTANALYSIS_MACHINEPROT" Integer Include machine protection
0 = no
1 = yes
"PROTANALYSIS_STOPATTRAFO"
Integer Stop at transformers
0 = no
1 = yes
Determining Fault Locations
Parameter Data type Description
"PROT_DET_CALC_TYPE" Integer Calculation type
1 = Data from protection device
2 = Data from measurement data
"PROT_DET_LOCATION_ID" Integer Location ID for recalculating the error
Static Network Reduction
Parameter Data type
Description
"STATNETRED_USESOURCEDB" Integer
Defines whether the original database is to be changed or the reduced network written to a second database.
0 = Fill second database with reduced network
1 = Carry out change of the original database
"STATNETRED_SINFILE" String Complete file name of the SIN file of the second database.
e.g.: "D:\Network\Red-RS.sin"
"STATNETRED_DATABASE" String Database definition for the second database.
e.g.: "TYP=NET;MODE=JET;FILE=D:\Network\Red-RS_files\database.mdb;USR=Admin;SINFILE=D:\Network\Red-RS.sin;"
"STATNETRED_CREATEGRAPHIC" Integer Activates the graphic generation of the boundary nodes when using two separate databases.
0 = Do not generate a graphic
1 = Generate graphic
"STATNETRED_SC1" Integer Activates the determination of the zero-phase sequence data in the reduced network for asymmetrical short circuit calculations.
0 = Do not determine any zero-phase sequence data
1 = Determine zero-phase sequence data
"STATNETRED_SC2" Integer Activates the determination of the modelling of boundary injections.
1 = Complex impedance (R+jX)
2 = Only one reactance (jX)
"STATNETRED_SC3" Integer Activates the determination of short circuit data in the reduced network.
0 = Do not determine any short circuit data
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 152/162
1 = Determine short circuit data
"STATNETRED_EXTWARD_MODELING" Integer Activates the determination of boundary injections with the Extended Ward procedure.
0 = Do not generate Extended Wards
1 = Generate Extended Wards
"STATNETRED_EXTWARD_MAXIMP" Double Maximum impedance
"STATNETRED_EXTWARD_MAXFRCHAR" Double Maximum frequency characteristics
"STATNETRED_EXTWARD_NEGLECT_LINES"
Integer Lines in positive and negative system
0 = Neglect not
1 = Neglect
"STATNETRED_EXTWARD_NEGLECT_TRANSF"
Integer Transformers in positive and negative system
0 = Neglect not
1 = Neglect
"STATNETRED_EXTWARD_NEGLECT_SHUNTS"
Integer Passive shunt impedances in positive and negative system
0 = Neglect not
1 = Neglect
"STATNETRED_EQUIV_MODELING" Integer Activates the determination of modelling of boundary branches
1 = Complex impedance (R+jX)
2 = Only one reactance (jX)
"STATNETRED_EQUIV_MAXIMP" Double Maximum frequency characteristics
"STATNETRED_XMLFILE" String Full path and file name XML reduction file
"STATNETRED_RESULT" Integer Handling of reduction results
0 = Write to database
1 = Export as CIM in _Files directory
2 = Deactivate simulation objects
"STATNETRED_ONLYBOUNDARY" Integer Only applies if STATNETRED_RESULT = 2.
Deactivate everything except boundary objects
0 = no
1 = yes
"STATNETRED_DETERMINEBOUNDARY" Integer Only applies if an XML reduction file is used.
Self-determination of boundary objects
0 = no
1 = yes
Dynamic Network Reduction
Parameter Data type
Description
"DYNNETRED_USESOURCEDB" Integer Defines whether the original database is to be changed or the reduced network written to a second database.
0 = Fill second database with reduced network
1 = Carry out change of the original database
"DYNNETRED_SINFILE" String Complete file name of the SIN file of the second database.
e.g.: "D:\Network\Red-RS.sin"
"DYNNETRED_DATABASE" String Database definition for the second database.
e.g.: "TYP=NET;MODE=JET;FILE=D:\Network\Red-RS_files\database.mdb;USR=Admin;SINFILE=D:\Network\Red-RS.sin;"
"DYNNETRED_CREATEGRAPHIC" Integer Activates the graphic generation of the boundary nodes when using two separate databases:
0 = Do not generate a graphic
1 = Generate graphic
"DYNNETRED_TIMESTART" Double Start time in seconds for the correlation functions
"DYNNETRED_TIMEEND" Double End time in seconds for the correlation functions
"DYNNETRED_LOWERLIMIT" Double Lower limit value for the correlation factor
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 153/162
"DYNNETRED_MACHINES" Integer Number of coherent machines to be generated in the reduced network. If "0" is entered, the number is determined automatically.
"DYNNETRED_FUNCTION" Integer Determines which signal is used for the correlation functions.
1 = slip
2 = load angle
3 = active power
4 = reactive power
5 = voltage
It is a good idea to always select "Slip" as this provides the best results.
"DYNNETRED_REFNODE" Integer NodeID of the reference node in the subnetwork to be reduced
"DYNNETRED_REFVOLTAGE" Double Ref. voltage for net equivalent in kV
"DYNNETRED_MAXPOWER" Double Max. power of equivalent line in MW
"DYNNETRED_POWERIGNORE" Double Power of machines to be ignored in MW
"DYNNETRED_PREFIX" String Any name prefix for reduced elements
"DYNNETRED_NODEMODELNET" Integer Internal display of the nodes in the network reduction
1 = PQ Type
2 = I Type
5 = PQ Type (neg. machines)
6 = I Type (neg. machines)
"DYNNETRED_NODEMODELMACHINES" Integer Internal display of the machines in the network reduction
1 = PQ Type
2 = I Type
3 = PV Type
"DYNNETRED_NODEMODELCOUPLING" Integer Internal display of coupling nodes in the network reduction
1 = PQ Type
2 = I Type
3 = PV Type
4 = S Type
"DYNNETRED_KEEPNAMES" Integer Name of individual machines retained
0 = no
1 = yes
"DYNNETRED_REDCONTROLLER" Integer Machines in the network to be reduced without controller
0 = no
1 = yes
"DYNNETRED_NOTREDCONTROLLER" Integer Machines in the network not to be reduced without controller
0 = no
1 = yes
"DYNNETRED_KEEPCONTROLLER" Integer Controller of individual machines retained
0 = no
1 = yes
"DYNNETRED_PSSCONTROLLER" Sting Name of the PSS controller
"DYNNETRED_EXCITER" String Name of the voltage controller
"DYNNETRED_GOVERNOR" String Name of the turbine governor
CIM Export
Parameter Data type Description
"CIM_FORMAT" String CIM version
"CIM_V10"
"CIM_V11"
"CIM_V12"
"CIM_V14"
"CIM_V15"
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 154/162
"CIM_PROFILE" String CIM profile
"CIM_STANDARD" = CIM Standard
"CIM_PLANNING" = CIM for Planning
"CIM_ENTSOE" = CIM for ENTSO-E
"FILENAME"
"FILENAME_###"
String Complete path and file name for the first file as well as the subsequent files. ### specifies the file number, ranging from 2 up to – at the very most – the number indicated under FILENAME_CNT.
"FILENAME_FLAG"
"FILENAME_FLAG_###"
String File type for the first data file as well as the subsequent files, ### specifies the file number, ranging from 2 up to – at the very most – the number indicated under FILENAME_CNT.
"DATA" = CIM input file
"BOUNDARY" = CIM boundary file
"CONFIG" = CIM configuration file
"CIM_NAME" Integer Determines what CIM attribute is used as the name. Valid indicators are:
0 = none
1 = cim:IdentifiedObject.Name
2 = cim:IdentifiedObject.AliasName
3 = cim:IdentifiedObject.Description
"CIM_SHORTNAME" Integer Determines what CIM attribute is used as the short name. Valid indicators are:
0 = none
1 = cim:IdentifiedObject.Name
2 = cim:IdentifiedObject.AliasName
3 = cim:IdentifiedObject.Description
"CIM_SPLITFILES" Integer Export to multiple XML files
1 = export to multiple files
0 = export to a single file
"CIM_CREATEZIP" Integer Create ZIP archive
0 = no
1 = yes
"CIM_MRID" String Type of ID used
"SINCALID" = ID generated by PSS SINCAL
"UUID" = Universal Unique ID
"GUID" = Global Unique ID
"CIM_LFRESULTS" Integer Export load flow results
0 = do not export any results
1 = export load flow results
"EXPORT_GRAPHIC" Integer, String
Export graphics
0, "NONE" = no graphic export
1, "AUTOMATIC" = automatic graphic export
2, "SINCAL" = simple graphic export
3, "EXTENDED" = extended graphic export
"CIM_GENERATEDNAMES" Integer Export generated names
0 = no export
1 = also export generated names
"CIM_EXPORTSINCALDATA" Integer Export additional PSS SINCAL data
0 = no
1 = yes
"CIM_GEOGRAPHICMODE" Integer Deactivate lat/long conversion
0 = no
1 = yes
CIM Import
Parameter Data type Description
"FILENAME_CNT" Integer Number of file names to be imported
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 155/162
"FILENAME"
"FILENAME_###"
String Complete path and file name for the first file as well as the subsequent files. ### specifies the file number, ranging from 2 up to – at the very most – the number indicated under FILENAME_CNT.
"FILENAME_FLAG"
"FILENAME_FLAG_###"
String File type for the first data file as well as the subsequent files, ### specifies the file number, ranging from 2 up to – at the very most – the number indicated under FILENAME_CNT.
"DATA" = CIM input file
"BOUNDARY" = CIM boundary file
"CONFIG" = CIM configuration file
"CIM_FORMAT" String CIM version
"CIM_V10"
"CIM_V11"
"CIM_V12"
"CIM_V14"
"CIM_V15"
"CIM_PROFILE" String CIM profile
"CIM_STANDARD" = CIM Standard
"CIM_PLANNING" = CIM for Planning
"CIM_ENTSOE" = CIM for ENTSO-E
"BASE_FREQUENCY" Double Basic frequency
"LENGTH_FACTOR" Double Conversion factor for entries for length
"CIM_NAME" Integer Determines what CIM attribute is used as the name. Valid indicators are:
0 = none
1 = cim:IdentifiedObject.Name
2 = cim:IdentifiedObject.AliasName
3 = cim:IdentifiedObject.Description
"CIM_SHORTNAME" Integer Determines what CIM attribute is used as the short name. Valid indicators are:
0 = none
1 = cim:IdentifiedObject.Name
2 = cim:IdentifiedObject.AliasName
3 = cim:IdentifiedObject.Description
"IMPORT_GRAPHIC" Integer Import graphics
0 = no
1 = yes
"GRAPHIC_MODE" Integer Graphics mode
0 = schematic
1 = geographical
"GRAPHIC_INDIVIDUAL_TEXT" Integer Individual text for network elements and node
1 = individual text
0 = no individual text
"GRAPHIC_SCALE_FACTOR" Double Scaling factor of the graphics
"GRAPHIC_SYMBOLSIZE" Integer Size of the symbol of the network elements
"GRAPHIC_OFFSETX" Double X-offset of the graphics
"GRAPHIC_OFFSETY" Double Y-offset of the graphics
"IMPORT_VIRTUAL_DATABASE" Integer Allow import in virtual database
0 = Do not allow
1 = Allow
"CIM_IMPORT_MODE" String Import mode
"Strict" = Strict mode
"Extended" = Extended mode
"CIM_GEOGRAPHICMODE" Integer Deactivate lat/long conversion
0 = no
1 = yes
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 156/162
PSS E Export
Parameter Data type Description
"EXPORT_NAME" Integer Export name or short name
0 = name
1 = short name
"EXPORT_NAME_KEY" Integer Use nodes’ short names as "BUS Number"
0 = yes
1 = no
"PSSE_VERSION" Integer Version number
Permissible are: 32 and 33
PSS E Import
Parameter Data type Description
"FILENAME_CNT" Integer Number of the data files
"FILENAME"
"FILENAME_###"
String Complete path and file name for the first data file as well as for all subsequent files. ### specifies the file number, ranging from 2 up to – at the very most – the number indicated under FILENAME_CNT.
"PSSE_VERSION" Integer Version number
Permissible are: 29, 30, 31, 32, 33 and 0 (Auto)
"PSSE_SEQ_FILENAME" String Complete path and file name of the sequence file
"PSSE_MODE" Integer Import mode
0 = standard mode
1 = enhanced import
"BASE_FREQUENCY" Double Basic frequency
"LENGTH_FACTOR" Double Scaling factor for lengths
"ZERO_IMPEDANCE" Integer Import lines without impedance
0 = no
1 = yes
"ZERO_IMPEDANCE_MIN_VALUE" Double Minimum impedance from which lines are considered to be connections without impedance
"PSSE_REFVOLTAGE" Double Reference rated voltage (for nodes and elements with 0.0 kV)
"GRAPHIC_FILENAME_CNT" Integer Number of the graphics files
"GRAPHIC_FILENAME"
"GRAPHIC_FILENAME_###"
String Complete path and file name for the first graphics file as well as for all subsequent files. ### specifies the file number, ranging from 2 up to – at the very most – the number indicated under GRAPHIC_FILENAME_CNT.
"IMPORT_VIRTUAL_DATABASE" Integer Allow import in virtual database
0 = Do not allow
1 = Allow
"PSSE_ABSIMP" Integer Use absolute impedance
0 = no
1 = yes
"PSSE_HAR_FILENAME" String Full path and file name of HAR file
"PSSE_DYR_FILENAME" String Full path and file name of DYR file
"PSSE_IEC_FILENAME" String Full path and file name of IEC file
PSS NETOMAC Export
Parameter Data type Description
"EXPORT_NAME" Integer Export name or short name
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 157/162
0 = name
1 = short name
"EXPORT_NETOMAC_SV" Integer Option whether a SV file should be created
0 = no
1 = yes
UCTE Export
Parameter Data type Description
"EXPORT_NAME" Integer Export name or short name
0 = name
1 = short name
"EXPORT_NAME_KEY" Integer Use nodes’ short names as "BUS Number"
0 = yes
1 = no
UCTE Import
Parameter Data type Description
"UCTE_IMPORT_CREATE_ZONES" Integer Create network zones
1 = yes
0 = no
"UCTE_IMPORT_DEFAULT_NAMES" Integer Create Default names
1 = yes
0 = no
"UCTE_IMPORT_CREATE_REGIONS" Integer Create Network groups
1 = yes
0 = no
"UCTE_IMPORT_CREATE_SUBSTATIONS" Integer Create substations
1 = yes
0 = no
"IMPORT_VIRTUAL_DATABASE" Integer Allow import in virtual database
0 = Do not allow
1 = Allow
DVG Export
Parameter Data type Description
"EXPORT_NAME" Integer Export name or short name
0 = name
1 = short name
"MAPPING_FILE" String Mapping file for import/export key
DVG Import
Parameter Data type Description
"FILENAME" String Complete path and file name of the data file
"DVG_IMPORT_MODE" Integer Import mode (behavior during problems and errors)
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 158/162
0 = strict mode, abort if there are errors
1 = error-tolerant import, problems and errors are documented
"GRAPHIC_FILENAME_CNT" Integer Number of the graphics files
"GRAPHIC_FILENAME"
"GRAPHIC_FILENAME_###"
String Complete path and file name for the first graphics file as well as for all subsequent files. ### specifies the file number, ranging from 2 up to – at the very most – the number indicated under GRAPHIC_FILENAME_CNT.
"IMPORT_VIRTUAL_DATABASE" Integer Allow import in virtual database
0 = Do not allow
1 = Allow
"MAPPING_FILE" String Mapping file for import/export key
CYMDIST Import
Parameter Data type Description
"CYMDIST_SWITCHSTATE" Integer Import only switch state
0 = no
1 = yes
"CYMDIST_EXTBREAKERMODE" Integer Assign switch to network elements
0 = no
1 = yes
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 159/162
5 Reference
5.1 Documentation
The complete PSS SINCAL documentation is available as online help. You can also find these
documents in the "Doc\English\Sincal" directory of the installation package as PDF files.
User Interface
For a comprehensive description of all the functions of the PSS SINCAL user interface, see the
System Manual.
New users should refer to the chapter on Using an Example to Work on a Network. This outlines,
step by step, how to create, process, calculate and display the results for an electrical network.
Simulation Procedure
The technical manuals for electrical networks contain detailed descriptions of the various
calculation methods for electrical networks and their input data. These manuals have two parts:
• Input data:
Description of the input data for all simulation procedures.
• Technical manual for the respective simulation procedure:
Comprehensive descriptions of the simulation procedure. The manuals are titled according to the
specific procedure: Load Flow, Short Circuit, etc.
The technical manuals for pipe networks contain detailed descriptions of the various calculation
methods for pipe networks and their input data. The following manuals are available: Water, Gas and
Heating/Cooling.
Network Database
For detailed information about the network database structure, see the Database Description
Manual. This manual presents the PSS SINCAL data model in detail. It explains both the structure
and the semantics of the data model, and has detailed tables (relations) with their attributes.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 160/162
5.2 PSS SINCAL Architecture
The following illustration shows the basic PSS SINCAL architecture.
Config
Graphic User Interface
Servers (COM)
Simulation
Graphics Editor Tabular View
based on Stingray with
extensions
Charts
based on Quinn Curtis
with extensions
Screen FormsReports
based on Crystal
Tool Library Network Planning Tools UI Controls Database API
Au
tom
atio
n In
terf
ace
s (
CO
M)
Meta Model Manager
Network
Database
Type
DB
Meta Model
Files
External
Applications
(using COM)
Au
tom
atio
n In
terf
ace
s (
CO
M)
External
Applications
(using COM)
Network Model
(Electro, Flow, Standard-
Types)
Variant Manager UNDO Manager Message Manager Chart Manager
Electricity Calculation
Methods
Import & Export
FunctionFlow Calculation
Methods
NETOMAC & NEVA
Interfaces
ZUBER
Interfaces
Electricity Network
Model
Flow Network
Model
Import & Export
ToolsDatabase API Meta Model Manager
PSS™SINCAL
As can be seen in the illustration above, there are two important components:
• Graphic User Interface
This is the real PSS SINCAL user interface. This interface is used to process networks, modify
data, evaluate the results, etc.
• Simulation
This component contains all the PSS SINCAL calculation methods. The calculation component
can also be used stand-alone (without the user interface).
Between these, the Servers (COM) component for internal data exchange is available. The entire
database can be accessed with this component.
COM Interfaces
All PSS SINCAL components have COM interfaces. A differentiation is made between internal and
external COM interfaces. The internal interfaces are only used within PSS SINCAL. They are not
documented and as such not designed for external use. The external interfaces are documented and
can also be used in your own applications. This lets you, for example, automize work sequences or
integrate calculation methods into your own applications.
5.3 Ready-Made Solutions
In the area of GIS coupling, our partners offer ready-made solutions that can be tailored to meet your
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 161/162
specific needs. Varied PSS SINCAL clients have successfully implemented these solutions.
L&Mark Informatika Kft.
L&MARK Informatika Kft. is your partner in the implementation of PSS SINCAL GIS integration
worldwide. The company is partner of AED-SICAD and has existing solutions on several GIS
platform (ESRI ArcFM, ArcFM-UT, Sicad/open, SICAD-UTE, Intergraph GNET, etc.).
L&MARK Informatika Kft.
Mrs Andrea Lisziewicz
Margit krt. 43-45. 4/5.
1024 Budapest
Hungaria
Fon +36 1 201 7725
Fax +36 1 201 2817
e-mail [email protected]
http://www.lmark.hu
Mettenmeier GmbH
Mettenmeier GmbH is a software consultant, service and solution provider with corporate
headquarters in Paderborn, Germany, supporting clients in the gas, water and electric industries. We
are dedicated to enabling the owners and operators of utility assets to plan and manage their
networks more successfully.
Mettenmeier GmbH provides a SIEMENS certified interface between the Smallworld standard
Network Resource Managers and PSS SINCAL.
Mettenmeier GmbH Utility Solutions
Mr Benjamin Pehle
Klingenderstr. 10 – 14
33100 Paderborn
Germany
Fon +49 5251 150-375
Fax +49 5251 150-366
e-mail [email protected]
http://mettenmeier.de
Khatib & Alami – C.E.C.
Khatib & Alami – Consolidated Engineering Company (K&A) is a multi-disciplinary company
specialized in consulting engineering studies, design and construction supervision of architectural,
structural, civil, electrical, mechanical, industrial, environmental, transportation, telecommunication,
information technology and geographic information systems (GIS) projects.
SIEMENS PSS SINCAL Database Interface and
Automation
October 2018 162/162
K&A provides an interface between ArcGIS and PSS SINCAL. This interface is for electricity
transmission and distribution networks.
Khatib & Alami – C.E.C.
GIS Services Division
Mr Bilal A. Hassan
P.O. Box 2732, Abu Dhabi – UAE
Fon +971-2-6767300 X202
Fax +971-2-6767070
e-mail [email protected]
http://www.khatibalami.com