The Electrical Template: a ready power system solution with symbols, equipment models, operator dialogs and demo diagrams.

Modules → Electrical Pack → Electrical Template


Create a solution from the template

  1. Open Solution Center and click New Solution.

  2. Select the Windows platform (.NET 4.8). The Electrical Template is a Windows solution and is not listed for Multiplatform.

  3. Select Electrical Template.

  4. Enter the solution name and location, and click Create.

The new solution is a copy of the template. The template file in the installation folder never changes.

The Electrical Template is listed when the license includes the Electrical Pack, the Electrical Pack is installed, and the Windows platform is selected. See Electrical Pack.

What comes ready

Layouts and navigation

Layout

Regions

Startup

Header at the top, Menu on the left, BottomAlarm at the bottom, MainPage in the content region

WithoutAlarm

The same without the alarm bar

Solution content

First run

  1. Start the runtime from Runtime → Startup.

  2. The client opens on MainPage, the SE Northfield 230/69 kV substation. It energizes a few seconds after the display opens.

  3. Log on from the header to operate equipment.

To start your own project, remove the demo displays, simulator tasks and tags you do not need (see Demo diagrams), then follow Single Line Diagrams and Power Flow.

Demo diagrams

Each demo is a single line diagram driven by its own simulator task, with buttons for fault scenarios. Scenario 9 restores the normal state.

MainPage: SE Northfield 230/69 kV substation

SingleLine: a simple example

A 230 kV line, a 230/69 kV transformer and one 69 kV feeder. It is the diagram built step by step in Single Line Diagrams and Power Flow. It has no simulator: turn on SIMULATION to operate it.

Solar PV: 120 MWp plant

Mining: 138/13.8 kV main substation

Data Center: Tier III 2N

Operation pages

Display

Menu

Content

TrendNew

Graphics

Trend with a tag tree for pen selection, zoom, pan, real time and pause, annotations and saved pen groups

AlarmsNew

Alarm/History

Online alarms, history and audit trail, with filters and acknowledge

About

Info

Solution name, path, last change, build, computer name and IP address

Architecture

(not in the menu)

A network architecture page built with the Architecture symbols

Removing a demo

Delete its display, its simulator task and its tags. The Solar, Mining and Data Center simulators also stop when their SimEnabled tag is 0.

Symbols

The electrical symbols are in the Symbols panel of the Draw editor, under In Solution. An electrical symbol is a regular symbol with three extra traits:

Equipment symbols

Equipment

Symbols

UserType

Terminals

Generator or source

Generator, Generator_H, Generator_V, Generator1, Generator_Transmission (a line from the grid), Generator_Continue, Generator_LineColor

Generator

1

Circuit breaker

Breaker, Breaker_H, Breaker_V

Breaker

2

Disconnector

Switch, Switch_V

Switch

2

Fuse

Fuse, Fuse_Type2

Fuse

2

Transformer, two windings

Transformer, Transformer_H, Transformer_V, Transformer_Type2

Transformer

2

Transformer, three windings

Transformer3, Transformer3_H, Transformer3_V, Transformer3_Type2

Transformer3

3

Reactor

Reactor, Reactor_H, Reactor_V

Reactor

2

Rectifier or UPS

Rectifier, Rectifier_H, Rectifier_V

Rectifier

2

Capacitor bank

Capacitor

Capacitor

2

Busbar

Bar, Bar_Node

(none)

Any number; all terminals are the same node

Directional busbar

BusBar

BusBar

98: odd nodes 1 to 95 on top are inputs, even nodes 2 to 96 at the bottom are outputs, nodes 97 and 98 at the ends tie bus couplers

Load, ground, continuation

Standard_Load, Standard_Load2, Standard_Ground, Standard_Continue_Out

(none)

1

Line crossing without connection

Jumper

(none)

2

_H and _V are horizontal and vertical drawings of the same equipment. Type2 variants use an alternative drawing.

Properties set on equipment symbols

Property

Meaning

BaseVoltage, BaseVoltage1 to BaseVoltage3

Source voltage (generator) or winding voltage (transformer). Choose a level from Tag.Enum.Voltage, for example @Enum.Voltage.kV_230.

TypeConnector1 to TypeConnector3

Winding connection: Delta, Wye or WyeGrounded

DlgDetails.Name

Dialog opened when the operator clicks the symbol (default DlgDetails)

DlgDetails.ItemsPerColumn

Rows per column before the dialog adds a column

DlgDetails.AlarmObj, DlgDetails.AlarmPerItem

Show the equipment alarm list in the dialog, and an alarm indicator on each point

BtnInterlock.*

Expressions that lock command buttons. See Equipment dialogs.

DlgInterlock.Open, DlgInterlock.Close

Permissive logic drawn in the interlock diagram

Other symbols

Equipment data model

Each piece of equipment is one tag whose type is the equipment UserType, for example Tag.Substation1/CB1 of type Breaker. Its points are members of the tag, for example Tag.Substation1/CB1.CmdBreakerPosition. Map the field points to your devices; the power flow engine and the dialogs work on the same members.

Naming convention

Prefix

Meaning

Mapped to the field

Example

Cmd

Command. A command with an enabled SLT twin is sent as select before operate.

Yes (output)

CmdBreakerPosition, CmdBreakerPositionSLT

In

Position input of a switching device

Yes

InBreakerPosition1, InBreakerPosition2

Dg

Digital state or status

Yes

DgState, DgEnableOpening

Pt

Protection function pickup or trip

Yes

PtPhZone1DistanceTrip

An

Analog measurement

Yes

AnActivePower, AnCurrentPhaseA

T

Internal: colors and voltages written by the power flow engine, dialog settings copied from the symbol, interlock results

No

TCurrentColor1, TVoltage1

Equipment UserTypes

UserType

Members

Content

Generator

18

Start, stop and emergency stop commands, running state, manual or automatic, start failure, low fuel, abnormal voltage, base voltage

Breaker

186

Commands, position inputs, digital states, protection points (distance zones, overcurrent, over and undervoltage, lockouts 86, 86L and 86BF, reclosing 79, synchronism 25, teleprotection 85), and three phase measurements

Switch (disconnector)

33

Open and close command, position inputs, releases, local or remote, internal fault, command failure, pole and position discrepancy

Fuse

14

Fuse state and command

Transformer

204

Tap changer (raise, lower, manual and automatic), forced air stages, paralleling, 86T reset, Buchholz, pressure relief, temperatures, oil level, differential and overcurrent protection, measurements per winding

Transformer3

216

As Transformer, with a third winding

Reactor

124

Buchholz, pressure relief, temperatures, protection trips, currents, 86T reset

Rectifier

21

State, fault, AC and DC abnormal, ground leakage, battery discharging

Capacitor

13

Energization and color on both terminals

Bar

3

Bus lockout 86B state and reset

BusBar

9

Directional busbar: base voltage and color

Standard

6

Voltage, state and color of a load or ground

What decides which points the dialog shows

The power flow engine reads the Disable flag of three members as wiring settings:

  • Breaker.InBreakerPosition2 and Switch.InSwitchPosition2: enabled means a double point position (state = 2 × Position2 + Position1); disabled means a single address (state = Position1).

  • Fuse.DgFusePosition: when disabled, the engine does not read the fuse state and the fuse keeps its initial state.

Key members

Equipment

Members

Role

Generator

CmdState, DgState, CmdEmergencyStop

Start and stop command, running state (1 energizes the generator terminal at its base voltage), emergency stop

Breaker

CmdBreakerPosition, InBreakerPosition1, InBreakerPosition2

Open and close command; position read by the engine (0 intermediate, 1 closed, 2 open, 3 inconsistent). Closed passes power, open blocks it.

Breaker, Switch

DgEnableOpening, DgEnableClosing, DgLocalRemoteRelay

Open and close releases from the IED and the relay local or remote state, used by the default interlocks

Switch

CmdSwitchPosition, InSwitchPosition1, InSwitchPosition2

As the breaker

Fuse

DgFusePosition, CmdFusePosition

Fuse state and command

Transformer

CmdTapValueUp, CmdTapValueDown, CmdTapAuto, CmdTapMan, AnTap, AnVoltage

Tap changer raise, lower and mode, tap position and regulated voltage

All

TTicket

The safety ticket of the equipment

Extending a UserType

Equipment dialogs

The template has one equipment dialog, the DlgDetails display. Every time it opens, it builds itself from the points of the equipment that was clicked, so a breaker, a transformer and a generator get different dialogs from the same display, and new equipment is ready to operate as soon as its symbol is placed and bound.

How the dialog opens

When the operator clicks an equipment symbol, the symbol writes the equipment tag name to Tag.UI.TagNameDlg, copies its dialog settings and interlock expressions into the equipment tag, and opens the display named in DlgDetails.Name. One equipment dialog is open at a time per client; drag it by its title bar.

Layout

Area

Content

Title bar

Equipment type and name, safety ticket button, close

Equipment block

A live copy of the equipment symbol with its main commands, each with a lock icon

Digitals

The Dg points with their state text. Transformers group them in sections set by DlgDetails.DigitaisSections; a point joins a section when its Display Text starts with #Section#.

Analog

The An points with value and unit

Commands

One block per Cmd point; button captions come from the point enumeration

Special blocks

Three position protection transfer on breakers; tap changer mode and raise and lower with voltage and tap position on transformers

Alarms (optional)

The equipment alarm list and acknowledge, when DlgDetails.AlarmObj is Visible

Commands and select before operate

  1. The operator clicks a command button. A red lock means the command is blocked and nothing happens.

  2. The confirmation dialog asks to confirm the command.

  3. Yes sends it. When the command point has an enabled SLT twin, the select is written first and then the operate; disable the SLT point for direct commands.

The state shown comes back from the field through the Dg and In points. Without field devices, turn on SIMULATION in the header so the engine echoes commands to states.

Interlocks

Each command button has a boolean expression, set on the symbol, that locks the button while it is true. The dialog shows a red lock (blocked) or a green lock (free).

Symbol property

Locks

Default

BtnInterlock.Open

Open

me.DgEnableOpening = Enum.Blocked OR me.TTicket.Color = Enum.Red

BtnInterlock.Close

Close

me.DgEnableClosing = Enum.Blocked OR me.TTicket.Color = Enum.Red

BtnInterlock.Cmd

Other commands

Breaker: me.DgLocalRemoteRelay = Enum.Local

BtnInterlock.TAPUp, BtnInterlock.TAPDown

Raise, lower

Tap changer in automatic, or at its limit

BtnInterlock.ForceVent

Forced ventilation

me.DgForcedAirRemote = Enum.Local

In an expression, me. is the equipment bound to the symbol, Enum.<State> is a state constant, and AND, OR, ! and parentheses combine conditions. A point of another equipment is written @Tag.<path>.<point>.

Releases read Blocked until the IED reports them. With no field data, Open and Close show a red lock: this is the expected safe state.

Clicking the lock next to Open or Close opens DlgInterlock, a ladder drawing of the permissive logic in DlgInterlock.Open or DlgInterlock.Close: AND conditions in series, OR conditions as parallel branches, inverted conditions on a red node, and each node with its point label and current state.

Safety tickets

The ticket button in the title bar opens DlgTicket for the equipment. A ticket has a title, a note and a color: White is a caution ticket, Red is a lockout ticket that locks Open and Close in the default interlocks. The last edit time and user are filled in automatically, and adding or removing a ticket writes an Audit Trail entry.

Using your own dialog

Set DlgDetails.Name on a symbol to another display, and in that display read the equipment from Tag.UI.TagNameDlg as DlgDetails does.


In this section...