Chapter 5

Database and Project Management

ETAP organizes an electrical system into a single project. Within this project, ETAP creates three major
system components:

Presentation - Unlimited, independent graphical presentations of the one-line diagram that

represent design data for any purpose (such as impedance diagram, study results, or plot plan).

Configuration - Unlimited, independent system configurations that identify the status of

switching devices (open and closed), motors and loads (continuous, intermittent, and spare),
Generator Operating Modes (swing, voltage control, reactive power control, power factor control)
and MOVs (open, closed, throttling, and spare).

Revision Data - Base Data and unlimited Revision Data IDs that keep track of the changes and
modifications to the engineering properties (for example, nameplate or settings) of elements.

These three system components are organized in an

orthogonal fashion to provide great power and
flexibility in constructing and manipulating your
ETAP project. Using this concept of Presentation,
Status Configuration, and Revision Data, you can
create numerous combinations of networks of
diverse configurations and varying engineering
properties that allow you to fully investigate and
study the behavior and characteristics of the
electrical networks using one database. This means
that you do not need to copy your database for
different system configurations, “What If” studies,
etc.

ETAP relies on a three-dimensional database concept to implement all Presentations, Configurations, and
Base and Revision Data. The use of this multi-dimensional database concept allows you to independently
select a particular Presentation, Configuration Status, or Revision Data within the same project database.
These selections can be used in conjunction with multiple loading categories and multiple Study Cases to
quickly and efficiently perform system design and analysis, while avoiding inadvertent data discrepancies
created when multiple copies of a single project file are used to maintain a record of various system
changes.

ETAP 5-1 ETAP 16.0 User Guide

Multi-Dimension Database Presentations

5.1 Presentations
When a new project is created, a one-line diagram presentation named OLV (one-line view) is be created
and displayed in your ETAP window. This is where you build a one-line diagram presentation of your
electrical system. ETAP supports the creation of an unlimited number of presentations of a one-line
diagram. This powerful feature provides you with the ability to customize each one-line diagram
presentation to generate different graphical representations, as shown below. One presentation may have
some or all protective devices visible, while another presentation may have a completely different layout
best suited for displaying load flow results, and so on.

Three Different Presentations of the same One-Line Diagram

ETAP 5-2 ETAP 16.0 User Guide

Multi-Dimension Database Presentations

5.1.1 Presentation Customization Features

One-line diagram presentations have the following features:

Graphical location of elements and connectors

Graphical representation of connectors based on Phase type (i.e. 3-Phase, 1-Phase)
Sizing of elements (five sizes)
Sizing of buses (five sizes)
Colors of elements and connectors
Ground grid elements
Symbols (ANSI and IEC Standard symbols for AC and DC elements)
Element grouping including connectors
Element orientation (0, 90, 180, and 270 degrees)
Annotation orientation (-90, -45, 0, 45, and 90 degrees)
Visibility options (hide and show) for switching and protective devices
Display options of Annotations (results, AC, AC-DC, and DC elements)
Display options for each Operating Mode (for example, Edit, Load Flow, or Short-Circuit)
Grid display and size option
Continuity check option (on or off)
Status configuration association
Print options (such as print size, centering, printer type, or paper size)
OLE objects independent of each presentation
ActiveX object independent of each presentation
Themed Appearance

Additionally, each presentation stores the last configuration, Operating Mode, zoom ratio, view location,
print setup, etc.

5.1.2 Adding Elements to a Presentation

When you add an element to one presentation, the same element with identical engineering properties will
automatically be added to each of your other presentations. Modification of the engineering properties of
an element in one presentation will be reflected in all presentations, because all presentations share a
common database.

5.1.3 Creating New Presentations

You can create new one-line diagram presentations by copying any one of the existing one-line diagram
presentations.

1. You can make a copy of a presentation by using one of these two techniques:

Click the New Presentation button on the Presentation toolbar. ETAP displays the Create
Presentation dialog box, or:

In the System Manager window, right-click the One-Line Diagrams folder (under the
Presentations folder), then select the Create New command. ETAP displays the Create
Presentation dialog box.

ETAP. 5-3 ETAP 16.0 User Guide

Multi-Dimension Database Presentations

OR

In the From drop-down list, select the existing one-line diagram presentation that you want to
copy. The new presentation will be assigned OLV1 by default, or you can enter a new name in
the To text box.

2. Click OK. ETAP displays the new presentation.

ETAP. 5-4 ETAP 16.0 User Guide

Multi-Dimension Database Presentations

5.1.4 Changing Presentation Names

A presentation name can be changed at any time by double-clicking the one-line diagram window’s
background while you are in Edit Mode. Using the One-Line Diagram dialog box, enter the new name in
the Name text box. You can change the presentation name to any name that is 25 or less alphanumeric
characters in length.

5.1.5 Purging Presentations

The purging of a presentation can only be accomplished from the System Manager. Once you purge a
presentation, it is permanently deleted from the project, so use caution. To purge a presentation, do the
following:

1. In the System Manager window under the Presentations folder, expand the folder that contains
the presentation you want to purge.

2. Right-click the presentation folder you want to purge, and then select the Purge command. ETAP
will require you to confirm that you want to purge the presentation.

ETAP. 5-5 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Status Configurations

5.2 Status Configurations

ETAP possesses a powerful configuration capability that allows you to configure the operating status of
each of the various electrical elements included in the one-line diagram of your project. Electrical
components such as circuit breakers, fuses, and switches can be set to open or closed status. Loads and
motors may be operating continuously, intermittently, or can be assigned as spares. Power sources can be
operating in swing, voltage control, Mvar control, or power factor control modes. Implementation of this
configuration concept follows the guidelines described below:

When you attach a configuration to a one-line diagram presentation, all elements in that
presentation assume its predefined status, just as if they have been saved under that configuration.

Each configuration is independent of all others since the status of elements can be set
independently for each configuration.

Any configuration can be attached to any one-line diagram presentation. Conversely, any or all
one-line diagram presentations can be attached to the same configuration simultaneously.

You can create an unlimited number of configurations.

To attach or associate a configuration to a presentation, make the presentation window active, and
select a configuration status from the Configuration toolbar. The figure below shows the changes
in presentation when changed from Normal to TSEvents configuration.

Switching Status Configuration from Normal to Stage 1

By using this status configuration feature, it becomes unnecessary to maintain several copies of one
project to perform electrical system studies for different configurations. In addition, when you modify
engineering properties or add new elements to the one-line diagram, the changes will be automatically
saved for all configurations.

ETAP 5-6 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

5.2.1 Changing the Status of Devices

The status of switching devices (fuse, contactor, HV circuit breaker, LV circuit breaker, switch, double-
throw switch, and the panel’s main disconnect) can be changed from their editors, the configuration
manager or from the menu displayed when you right-click the device on the one-line diagram.

ETAP. 5-7 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Status Change of a Switching Device for Configuration “Normal”

ETAP. 5-8 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

The status of load devices (synchronous motor, induction motor, lumped load, MOV, static load,
capacitor, and filter) can be changed from their editors, as shown in the figure below.

Status Change of Load Device for Configuration Normal

ETAP. 5-9 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

The status of source devices (power grids and synchronous generators) can be changed from their editors,
as shown in the figure below.

ETAP. 5-10 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

5.2.2 Configuration Manager (Project Editor Access Level)

The purpose of the configuration manager is to provide an interface for the following capabilities:

Viewing the configuration status of each device in the active project in a tabular fashion
Ability to change the configuration status of any PD / Source / Load in the project
Ability to track changes in the configuration status of any PD / Source / Load in the project
Ability to check (checker) configuration status any PD / Source / Load in the project

The configuration manager can be accessed by clicking on the Configuration Manager button on the main
ETAP interface, as shown below.

The configuration manager may also be accessed from System Manager as shown below.

The configuration manager interface is shown below:

ETAP. 5-11 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Configuration List
This list contains all existing configurations in the project. If the Project Editor has deleted checked
configurations they will not show up in this list because they have been hidden. The configuration view
will show the configuration status for only the selected configurations from the configuration list.

The following devices (AC and DC) are considered by the configuration manager and tracked for the
checker
a. HVCB
b. LVCB
c. SPST Switch
Protective / Switching Devices
d. SPDT Switch
e. Fuse
f. Contactor
g. Induction Motor
Motors
h. Synchronous Motor
i. Lumped Load
j. MOV
k. Static Load
l. Capacitor Loads
m. Panels
n. Harmonics Filters
o. Phase Adapter
p. UPS
q. Charger AC / DC
r. Inverter
s. Synchronous Generator Sources
t. Power Grid / Utility

ETAP. 5-12 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Device Selection
Devices shown in the configuration view may be filtered based on the following categories:

a. AC
b. DC
c. AC & DC

Based on your selection, the following device lists are displayed. By default, AC elements are always
shown in the configuration view.

AC DC AC & DC
All AC Elements All DC Elements All Elements
All Protective Devices All DC Protective Devices All Protective Devices
All Loads All DC Loads All Loads
All Motors DC Circuit Breakers All Motors
All Sources DC Fuses All Sources
All AC/DC DC Lumped Loads All AC/DC
Circuit Breakers, HV DC Motors Circuit Breakers, HV
Circuit Breakers, LV DC Static Loads Circuit Breakers, LV/DC
Switches, Single-Throw DC Switches, Double-Throw Switches, Single-Throw
Switches, Double-Throw DC Switches, Single-Throw Switches, Double-Throw
Fuses Fuses
Contactors Contactors
Induction Motors Induction Motors
Synchronous Motors Synchronous Motors/DC Motors
Lumped Loads Lumped Loads
MOVs MOVs
Panels Panels
Phase Adapters Phase Adapters
Harmonic Filters Harmonic Filters
Static Loads Static Loads
Capacitors Capacitors
Generators, Synchronous Generators, Synchronous
Power Grids, Utility Power Grids, Utility
UPS’s UPS’s
Chargers Chargers
Inverters Inverters

ETAP. 5-13 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Configuration View
When a device is selected from the device selection list, corresponding device ID’s are shown in the
configuration view (column 1). For example, if ‘All Devices’ is selected then all device ID’s will be
shown that are included and controlled by your various configurations.

Clicking on the device ID will trigger an automatic search for that device on the active one-line diagram.
ETAP will show the selected device in Red even if it exists in nested / composite networks. This can be
accomplished without having to close the configuration manager.

Since the configuration view lists the status of each device, the user can change the status of any device
from the configuration manager rather than having to go to the individual Device Editor. Select the
required status (open or close in case of circuit breaker) and click OK to apply the changes.

ETAP. 5-14 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Show Normal Status

Selecting this option causes the normal status of all devices to be displayed in the configuration view.
Unselecting this option will filter the configuration view and show the off-normal or alternate status for
all selected devices. The table below lists devices displayed in the configuration view based on their
operating status.

Show Normal Status (Checked) Show Normal Status (Unchecked)

Circuit Breakers - Closed Circuit Breakers – Open
DT Switches – Position A DT Switches – Position B
Switches – Closed Switches – Open
Fuses – Closed Fuses – Open
Generator – Voltage Control Generator – Swing / Mvar Control / PF Control
Power Grid – Swing Power Grid – Voltage Control / Mvar Control/ PF Control
Load Demand Factor – Continuous Load Demand Factor – Intermittent / Spare
MOVs – Open MOVs – Closed / Throttle / Spare
Panel – Closed Panel – Open
Phase Adapter – Closed Phase Adapter – Open
Harmonic Filter – Continuous Harmonic Filter – Intermittent / Spare

ETAP. 5-15 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Show Differences
Selecting this option will compare the selected configurations from the configuration list and show only
those devices with differences between their configurations. For instance, the example below shows that
three configurations have been selected (Normal, Stage 1 and TSEvents). When Show Difference is
selected, based on your device selection (All AC Elements), ETAP will be displaying the differences
across all selected configurations, and CB2 and CB10 have different status across at least two of the three
selected configurations.

The results of selecting Display Changed Data in Red and Show Normal Status logic are summarized in
the table shown below:
Device ID Config 1 Config 2 Config 3 Config 4
CB1 Open Open Open Open
CB2 Closed Closed Closed
CB3 Closed Closed
CB4 Open Open Open Open
M1 Continuous Continuous
M2 Intermittent Intermittent Intermittent Intermittent
G1 Swing Swing Swing Swing
G2 VoltControl VoltControl VoltControl VoltControl
Config Open Close Open Close Open Close Open Close
Change
Show Normal Status Show Normal Status Don’t Show Normal Don’t Show Normal
Don’t display Display changed data Status Status
changed data in Red in Red Don’t Display Display changed data
changed data in Red in Red

ETAP. 5-16 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Creating New Configurations

You can create new status configurations in the follow manner:

On the Configuration Manager, click the New button. ETAP then displays the New Configuration dialog
box. From this dialog box you can create a new configuration using default settings, as shown in the
following figure:

In the System Manager, right-click the Status folder under Configurations folder, and select Create New.
ETAP displays the New Configuration dialog box along with the status of the elements for your new
configuration.

Create a New Status Configuration

ETAP. 5-17 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Copying Existing Configurations

You can copy existing status configurations using one of the two following methods:

On the Configuration Manager, click the Copy button. The Copy From option allows you to copy an
existing configuration. From the drop-down list, select the configuration you want to duplicate. The
Create a New Configuration with Default Settings option allows you to create a new configuration with
the default settings listed in the dialog box. Enter a name for the new configuration in the To text box.

If you right-click the specific configuration you want to duplicate and select the Duplicate command,
ETAP displays the Copy From option and allows you to create a new configuration based on an existing
one.

ETAP. 5-18 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Delete Configurations
Click to delete the selected configuration(s) from the project. If these configurations were previously
checked then they will be hidden in access levels other than checker access level. If the configurations
were not checked previously, then they will be deleted permanently. Confirmation dialog is provided
when deleting a configuration.

Once you choose to accept the delete action, the configuration will be permanently removed and another
configuration with the same name can be created once the configuration manager is closed and reopened.
Note that if the configuration was checked then it will not be permanently removed from the system even
if the project is closed. Such a configuration can only be deleted if the checker approves the delete action.

ETAP. 5-19 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Rename Configurations
Clicking the Rename button will bring up the “Rename Configuration” Editor, as shown below.

Print Configurations
Click OK to export the configuration settings to a Microsoft Excel file.

ETAP. 5-20 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

5.2.3 Configuration Manager (Checker Access Level)

When the checker access level is accessed, the following screen will appear. Checking information for
configurations can be accessed by selecting “Configuration” option. Make sure the “Display
Configuration Manager” option is selected to display configuration manager in checker access level. The
purpose of the configuration checker is to validate changes made to configuration settings of various
devices in a project. This is similar to the checker for engineering properties. The Configuration Manager
Editor is similar to the one described for Project Editor Access Level with just a few limitations and
modifications, as shown in the figure below.

Edited By
The previous user name (ID) and the Date are displayed here for the selected configuration.

Checked By
Clicking on the Check button will insert your user name (ID) and the date in the Checked By area for the
selected configuration.

Skip Checked Configurations

Use this filter if checked configurations should not be included in the configuration list.

Display Configuration Manager

Click this checkbox to display the configuration manager. All changes or modifications of individual
configuration status are displayed in red by the configuration manager.

ETAP. 5-21 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

Check / Uncheck Data

When you click on the Check button, the color changes to blue, and a red check mark appears in the
corner. If you click again, the selected element will be unchecked.

Restore
The Restore function will only be active for configurations that were previously checked and then deleted.
These configurations have been hidden from the Project Editor (because they were deleted) however they
are visible in Checker Access Level. The Checker can choose to permanently delete these configurations
by checking them, i.e. accepting the delete action or by clicking on the restore button to unhide them in
Project Editor Access Level.

In the example below “BatterySize” is a checked configuration that has been deleted by the Project
Editor.

When you (as checker) log into this project, ETAP will display all configurations (Normal, NewConfig,
and Stage 1) that must be checked in addition to the “BatterySize” configuration since this was a checked
configuration that was deleted by the Project Editor.

ETAP. 5-22 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

You can check the BatterySize configuration, in which case this configuration will be permanently
deleted from the project, or you can chose to restore this configuration name along with the status for
every device. To restore a configuration, click on the BatterySize configuration column and then click
Restore. ETAP will prompt you with the confirmation dialog shown below:

ETAP. 5-23 ETAP 16.0 User Guide

Multi-Dimension Database Status Configuration

5.2.4 Reserved Configurations

Some status configurations are reserved for ETAP Real-Time and cannot be renamed or purged. These
configurations are active when ETAP is online and include the following:

Reserved Configurations Mode

On-Line On-line Monitoring

Playback Playback

Advisory Advisory Control

Supervisory Supervisory Control

ETAP. 5-24 ETAP 16.0 User Guide

Multi-Dimension Database Revision Data

5.3 Revision Data

Revision Data is the third orthogonal system component provided by ETAP. The engineering data
associated with the elements in your project are stored in the project database. ETAP provides ready
access to an unlimited number of unique engineering Revision Data associated with each element.

ETAP establishes a revision level of zero for the data used as Base Data. You may assign a revision at
any time to distinguish the engineering parameters associated with any or all of the elements on the one-
line diagram without impacting or changing the Base Data. An element cannot exist in Revision Data
without also existing in the Base Data. ETAP constrains your project to using the engineering data in one
Revision Data ID (name) at a time. You must be working with the Base Data to add or delete system
elements or to make connectivity changes to your one-line diagram. Also, the Base Data must be active
(instead of Revision Data being active) for you to be able to save or close a project.

5.3.1 Using “What If” Studies

The primary use for Revision Data is to enable you to run “What If” studies for an electrical system
where you vary the engineering data of the network’s components and compare these results with the
Base Data or other Revision Data. For example, you can change the impedance of a transformer in the
Revision Data (leaving the Base Data untouched) and compare the short-circuit results with the Base
Data.

Other applications of Revision Data allow the creation of future modifications of the system without
changing your Base Data. For example, you can add a new substation to an existing system and keep all
of your modifications in Revision Data. In this example, the Base Data represents your existing system
and the Revision Data represents your design for future modifications.

To take this example further, first add the new elements for the substation to the Base Data and flag them
as Out of Service so they will not affect the study results of the existing system. In the Revision Data, you
then set the flag to In Service and enter all other required properties. When the new substation is
commissioned, merge the Revision Data to Base Data to implement and save the modification.

5.3.2 Changing Engineering Data in Revisions

To exchange engineering data for Revision Data, you need to activate the Revision Data in your system.
This is accomplished through the Revision toolbar (located on the top left hand corner of the ETAP
window by default). From the Revision toolbar drop-down list, select the Revision Data ID (name) you
want to modify. ETAP 11 onwards, new projects only have Base revision, instead of the default 15
Revision Data IDs, but you can add an unlimited number of new IDs to your project.

After selecting the Revision Data ID, you can modify device data just as you would while in the Base
Data. The changes you make will not affect the Base Data, unless they are changes common to all
Revision Data (such as configurations, Study Cases, and presentations).

Revision Data is integrated with user access control to keep users from manipulating Base Data. Only
users with the access level of Project Editor or Base Editor can manipulate Base Data. User access
restrictions insure that specific sections of the project can only be altered by those authorized to make
changes.

ETAP keeps track of delta differences between Revision Data and the Base Data. The delta is zero when
you activate a Revision Data ID for the first time. When you are in Revision Data and you change a single

ETAP. 5-25 ETAP 16.0 User Guide

Multi-Dimension Database Revision Data

property of an element, that element (with its new engineering properties) is saved for that Revision Data
ID. In our future substation example, the delta between this Revision Data ID and the Base Data is one
element only. Any subsequent change to the properties of this element in the Base Data will not affect the
element’s properties in the Revision Data. However, any changes to the Base Data for other elements that
have not been altered in this Revision Data will be used when you run studies with this Revision Data ID
active.

5.3.3 Identifying Changed Elements

The ETAP System Manager displays the delta difference between Revision Data and the Base Data.
Changed elements and the folders in which they are stored are colored green. In the example below, Gen3
is flagged as an element that has parameters that differ from the Base Data. Also note that the Cable
folder is colored green with the integer 2 added to it, meaning that there are two cables under this
Revision Data ID that are different from the Base Data. ETAP includes a Data Manager that can also be
used to identify changed elements as well as changed properties. See Data Manager section of this chapter
for more details.

ETAP. 5-26 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4 Data Manager

The purpose of the data manager is to provide an interface for the following:

View engineering properties of each device in a tabular fashion for each revision
Ability to merge complete revisions
Ability to merge individual devices
Ability to reset / remove delta for entire revision
Ability to reset / remove delta for individual devices
Ability to print difference report based on device type
Filter properties based on engineering studies and/or non-engineering data

The data manager can be accessed by clicking on the data manager button on the main ETAP interface as
shown below.

The data manager interface is shown below:

ETAP. 5-27 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Revision Control Selection

The revision control selection allows the user to view and organize the revision control list based on
Revision Name, Change # or Group #.

All Data Revisions

Select this option to view list of all available data revisions in the project. The revision control list will be
populated with revision names in alphabetically order.

Change #
Select this option to view list of all available Change #’s in the project. The dropdown list displays the
available Change # in the current project. For the selected Change #, the revision control list is populated
with revisions that are members or part of the selected Change #.

ETAP. 5-28 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Group #
Select this option to view list of all available Group #’s in the project. The dropdown list displays the
available Group # in the current project. For the selected Group #, the revision control list is populated
with revisions that are members or part of the selected Group #.

Revision Control List

This list contains all existing revisions in the project including base. If the project editor has deleted some
revisions they will be hidden and will not show up in this list. The revision view will show the revision
data for only the selected revisions from the revision control list. Default: Nothing Checked. When data
manager is closed these selections are saved so that the next time the data manager is launched the
previously saved selections are recalled. The selections are saved in the data manager based on active
ETAP session. Selection settings would be reset to default whenever ETAP is restarted.

ETAP. 5-29 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

All AC and DC one-line elements that have engineering properties associated with them are tracked by
the data manager.

Device Selection
Devices shown in the data manager may be filtered based on the following categories:

a. AC
b. DC
c. AC & DC

ETAP. 5-30 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Based on your selection, the following device lists are displayed. By default, AC elements are always
shown in the configuration view.

AC DC AC & DC
All AC Elements All DC Elements All Elements
All Protective Devices All DC Protective Devices All Protective Devices
All AC Loads All DC Loads All Loads
All AC Motors All DC Branches All Motors
All Sources DC Circuit Breakers All Sources
All AC/DC DC Circuit Breakers All AC/DC
Circuit Breaker, HV DC Fuses Circuit Breakers, HV
Circuit Breaker, LV DC Lumped Loads Circuit Breakers, LV/DC
AC Switches, Single-Throw DC Motors Switches, Single-Throw
AC Switches, Double-Throw DC Static Loads Switches, Double-Throw
AC Switches, Ground DC Switches, Double-Throw AC Switches, Ground
AC Fuses DC Switches, Single-Throw Fuses
Contactors VFDs Contactors
Recloser Batteries Reclosers
Induction Motors DC Buses Induction Motors
Synchronous Motors DC Converters Synchronous Motors/DC
MG Sets DC Composite CSD Motors
AC Lumped Loads DC Impedances MG Sets
MOVs DC CSD Wires Lumped Loads
AC Static Loads DC CSD Contacts, Macro- MOVs
Capacitors Ctrl Static Loads
Panels DC CSD Contacts Capacitors
Phase Adapters DC CSD Push Buttons Panels
Grounding/Earthing Adapter DC CSD Control Cables Phase Adapters
Harmonic Filters Grounding/Earthing
Generators, Synchronous Adapter
Power Grids, Utility Harmonic Filters
UPSs Generator, Synchronous
Chargers Power Grids, Utility
Inverters UPSs
PV Array Chargers
AC Buses Inverters
AC Cables PV Array
Impedance Branch AC Buses
Bus Duct AC Cables
Ammeters Impedance Branches
Multi-Meters Bus Ducts
Voltmeters Ammeters
Reactor, Current Limiting Multi-Meters
Relays, Frequency Voltmeters
Relays, Reverse Power Reactors, Current Limiting
Relays, Solid State Trip Relays, Frequency
Relays, Voltage Relays, Reverse Power
Relays, Multi-Function Relays, Solid State Trip

ETAP. 5-31 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Transformers, 2W Relays, Voltage

Transformers, 3W Relays, Multi-Function
Transformers, Current Transformers, 2W
Transformers, Potential Transformers, 3W
Transmission Lines Transformers, Current
Ground Grids Transformers, Potential
Overload Heaters Transmission Lines
DC Link, High-Voltage Ground Grids
Static Var Compensators Overload Heaters
Wind Turbine Generators DC Link, High-Voltage
Static Var Compensators
Wind Turbine Generators
VFDs
Batteries
DC Buses
DC Converters
DC Composite CSD
DC Impedances
DC CSD Wires
DC CSD Contacts, Macro-
Ctrl
DC CSD Contacts
DC CSD Push Buttons
DC CSD Control Cables

ETAP. 5-32 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Revision View
When a device selection is made from the device selection list (for example All AC Motors),
corresponding devices (all AC motors, induction and synchronous) are shown in the revision view
(elements column).

Clicking on the device ID will trigger an automatic search for that device on the active one-line diagram.
ETAP will show the selected device in Red even if it exists in nested / composite networks. This can be
accomplished without having to close the data manager.

Display Options
Use the display options in order to select between element status information or individual element
engineering properties. This section also allows the user to view differences across multiple revisions for
multiple elements in the ETAP project as well as perform advanced filtering on engineering properties.

ETAP. 5-33 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Elements
When this option is selected, the data manager revision view shows the list of elements based on the
device selection (AC, DC or AC & DC).

When Elements is selected corresponding drop down list shows additional filters

- Engineering Data
- Service
- State
- Lock
- Edited By
- Checked By
- Unchecked
Engineering Data
When Engineering Data is selected, the data manager shows the list of elements based on device selection
filters. Further it color codes the cells in Red whenever it encounters a revision record set for each
displayed element. For example Cable 9 data is not revisioned however Cable 13 has revisioned data in
2007 and 2010 revisions. Note that revisioned properties based on this engineering data are shown with
red color in the cell background color.

ETAP. 5-34 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Rev. Data Exists

Whenever this checkbox is clicked, the data manager displays elements with revision record sets, i.e.,
elements that are not revisioned (based on revision control selection) are discarded from the list. For
example, Cable 9 was not revisioned and hence it will be removed from the list when Rev. Record Exists
option is checked.

Service
When Service is selected, then the data manager displays “In / Out / Same As Base” condition for each of
the displayed elements. In Service is shown as ‘In’ and Out of Service is displayed as ‘Out’. Same as
Base implies that the element in revision inherits the same service condition as base. “In/Out/Same As
Base” condition can be setup from the individual property editor. Note that revisioned properties based on
this engineering data are shown with red color in the cell background color.

ETAP. 5-35 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Changing Service Information from Data Manager

The data manager can also be used to directly change the “In/Out/Same As Base” condition directly from
the data manager element grid. Click on row to select a particular element, for example LUMP1.

Click “In” in the Base column in order to change the condition from In to Out of Service. A drop down
list will be provided with the appropriate options.

ETAP. 5-36 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

The following reflects the new base information for LUMP1. Not only is the element out of service in the
data manager but the continuity check now reflects that this equipment is indeed not in service. Since all
the other revisions are set to “Same As Base”; all revisions will now inherit this out of service status
automatically for LUMP1. In order to independently change the condition in other revisions, the same
steps as above can be followed to switch from “Same As Base” to any other condition without having to
go to the property editor.

Show Default
When the Show Default option is selected, the data manager shows elements that are Out of Service as
‘Out’ for Base and any other selected revisions. Elements that are ‘In Service’, i.e. ‘In’ have the text
blanked out and not displayed.
Differences
When this checkbox is clicked then the data manager displayed only those elements that have differences
in their service status for the selected revisions.
In / Out / Same As Base (Filters)
Filters are a quick and efficient way of viewing the information most important. In / Out / Same As Base
state of the elements can be used to filter the elements displayed in the data manager. If ‘In’ is unchecked
then the data manager will only show elements that have ‘Out’ and ‘Same As Base’ settings.

ETAP. 5-37 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

State
Equipment states are available in ETAP 11 onwards. States allow the user to not only define engineering
states of various equipment in the network but also connect the In/Out of Service condition of the
equipment with its state.

State In / Out of Service Intended Usage

Engineering properties in the data revision is based on nameplate
As-Built In or Out
information found in the system.
Engineering properties in the data revision as well as In/Out Service
New In or Out condition are based on the fact that this is new equipment added to the
system.
Engineering properties in the data revision as well as In/Out Service
Future In or Out condition are based on the fact that this is equipment that is to be
added in the future.
Engineering properties in the data revision as well as In/Out Service
Moved In or Out condition are based on the fact that this is equipment that is moved to
a different location in the system.
Engineering properties in the data revision as well as In/Out Service
Modified In or Out condition are based on the fact that this is equipment nameplate or
other parameters have been modified.
Engineering properties in the data revision as well as Service
condition is based on the fact that this is equipment has been removed
Removed Out
from the system and will automatically not participate in any system
calculations.
Engineering properties in the data revision as well as Service
condition is based on the fact that this is equipment is in a warehouse
Warehouse Out
and has not been installed in the system. This equipment will
automatically not participate in any system calculations.
Engineering properties in the data revision as well as Service
condition is based on the fact that this is equipment is not in service
Abandoned Out permanently or equipment is not in commission (ENIC). The
equipment however may still be on its skid / pad but disconnected
from the electrical system.
Engineering properties in the data revision as well as Service
Repair condition is based on the fact that this is equipment has been removed
Out
Shop temporarily for maintenance / repairs. This equipment will
automatically not participate in any system calculations.
Other Out Any other reasons not covered by the above status

ETAP. 5-38 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

When State is selected, then the data manager displays the state (one of 10) for each of the displayed
elements and whether the revision data for the element is different or ‘same as base’. Note that revisioned
properties based on this engineering data are shown with red color in the cell background color. The
following states are fixed in ETAP and have the following In / Out of Service condition associated with
each one.

Changing State Information from Data Manager

Just like service condition, data manager can also be used to directly change the State information directly
from the data manager element grid. Click on row to select a particular element, for example LTG Load.

ETAP. 5-39 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Click “Same As Base” in any of the revision columns in order to change the state. A drop down list will
be provided with the state options.

ETAP. 5-40 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Once the selection is made, Base and Revision will not be the same and the state of the element will be
revisioned and displayed in a red color.

As-Built / New / Future (Filters)

Filters are a quick and efficient way of viewing the information most important. State filters (As-Built,
Future, Moved, etc.) can be used to filter the elements displayed in the data manager. If “As-Built” is
unchecked then the data manager will only show elements that have other states. Note that if only Base is
selected then the filters automatically hide/show elements based on the filter selection. If Base and
Revision(s) are selected together then the “Same As Base” filter may need to be unchecked first in order
to effectively utilize the other filters.

ETAP. 5-41 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Lock
When Lock is selected, then the data manager displays the lock / unlock status for each of the displayed
elements. Note that different properties based on this engineering data are shown with red color in the cell
background color. The equipment can be locked / unlocked from the individual property editor as well as
the data manager.

Lock / Unlock are available in ETAP 11 onwards. This functionality allows a user with
Project/Base/Revision editor privileges, the ability to show that their changes to an Elements’ Property
Editor are finalized by disabling property fields on the Editor. This excludes Service and State fields
(In/Out/State/SameAsBase), Configuration fields (Open/Close), as well as the OK Button. Below is an
example of the new Property Lock in the locked state in the Base Revision and below that, an example of
the Property Lock in the unlocked state in a Revision without revision data.

The lock button toggles a Browser-like-level access on an Elements’ Property Editor. The difference
being that the Configuration Fields (Open/Close) and OK button are still active. The lock is enabled when
the user is a Project or Base Editor in the Base Revision, and when the user is a Project, Base, or Revision
Editor in a Revision with revision properties.

When the Editor is in the locked state, the Property Editor restricts direct user modification of property
fields. In a revision, if the revision has no saved properties and is the same as the base revision; then the
property lock will be unlocked and disabled. The reasoning behind this is that there are no revision
properties to lock and thus the user should not be able to lock/unlock.

ETAP. 5-42 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Changing Lock/Unlock Information from Data Manager

Just like service and state, data manager can also be used to directly change the lock/unlock information
from the data manager element grid.

ETAP. 5-43 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Show Default
This option is unchecked by default. Default is “Unlocked”. When this option is unchecked then any Base
or Revision with this status will show blank cells and the text “Unlock” will not be displayed.
Differences
When this checkbox is clicked then the data manager displayed only those elements that have differences
in their lock status for the selected revisions.
Lock / Unlock (Filters)
If “Lock’ is unchecked then the data manager will show elements that are unlocked, i.e. in state other than
“Lock” across Base and Revision.
Edited By
When Edited By is selected, then the data manager displays the account names who have edited
properties for each of the displayed elements. Note that revisioned properties based on this engineering
data are shown with red color in the cell background color. Edited by information cannot be changed from
the data manager.

Differences
When this checkbox is clicked then the data manager displays only those elements that have differences
in their edited by status.

ETAP. 5-44 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Edited By Account (Filters)

If any of the accounts is unchecked then the data manager will show elements that are edited by the
remaining accounts. For example if OTI is unchecked then all elements not modified by OTI will be
displayed.
Checked By
When Checked By is selected, then the data manager displays the account names that have checked
properties for each of the displayed elements. Note that revisioned properties based on this engineering
data are shown with red color in the cell background color.

Differences
When this checkbox is clicked then the data manager displays only those elements that have differences
in their checked by status.
Account Filters
If any of the accounts is unchecked then the data manager will show elements that are checked by the
remaining accounts. For example if “Checker” is unchecked then all elements not modified by “Checker”
will be displayed.
Unchecked
When unchecked is selected, then the data manager displays elements that are not checked.

ETAP. 5-45 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Differences
When this checkbox is clicked then the data manager displays only those elements that have differences
in their unchecked status.

ETAP. 5-46 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Properties
When an element is selected and “Properties” option is selected then the data manager grid switches from
element list and displays properties for the elements as found in the project database.

If only Base is selected, then based on the device selection, the property grid can show data for individual
element or data for all elements within one specific device type. This concept is illustrated with a few
examples.

Example Revision Control Device Selection

1 Base Only All AC Elements

Note that in this example, all AC elements are displayed with element IDs in a drop-down list and the
property for each element is arranged row-wise.

ETAP. 5-47 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Example Revision Control Device Selection

2 Base Only Circuit Breakers, HV

Note that in this example, all HVCB are displayed with element IDs arranged row-wise and the property
for each element is arranged column-wise.

Study Filters
When any of the study filters is checked then the properties used for the selected study will be displayed
and all others will be hidden. The following study filters are available in ETAP 14.

Non-Engineering Data – Lists all properties for selected element that is not associated with any
analysis / calculation
Load Flow - Lists all properties for selected element that is associated with load flow analysis. In
addition, generation categories for power sources are also properties used for load flow type
studies. Generation categories will be added to this list in the future.
Short Circuit - Lists all properties for selected element that is associated with short circuit
analysis
Arc Flash - Lists all properties for selected element that is associated with arc flash analysis
Motor Acceleration - Lists all properties for selected element that is associated with motor
acceleration. In addition, generation categories for power sources are also properties used for
motor starting studies. Generation categories will be added to this list in the future.
Other Studies - Lists all properties for selected element that are associated with all other
engineering studies
Differences
When this checkbox is clicked then the data manager displays only those elements that have differences
in their properties across Base and selected revisions.
Rev Data Only
When this option is selected, then the drop down element list is narrowed to show list of elements that
have revisioned properties. For example if Bus1 is not revisioned then it will be removed from the list
completely.

ETAP. 5-48 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4.1 Find Tool

The data manager includes a find button similar to those within the element property editors. The find
button automatically closes the data manager, stores any selections made and finds the selected element
on the active single line diagram. The element is then highlighted using the selected element color (can be
set from the theme manager). This color is red by default.

5.4.2 Export
The data manager exports the data being viewed in the grid / spreadsheet view into Excel while
maintaining the color codes of revisioned data. The Excel output is WYSIWYG hence it is possible to
export all the properties for individual device types into this format. The spreadsheet view also allows you
to export the data to Excel by selecting the grid (using mouse to highlight the rows) and using Copy
(CTRL+C) and paste (CTRL+V) into any other document such as Excel.

ETAP. 5-49 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4.3 Creating Revisions

In ETAP 7.5 and prior releases, you can create revisions from the revision control toolbar or from the
RevControl Menu. ETAP 11 onwards you can create new revisions from the RevControl menu or the
Data Manager. All data in a new revision is identical to the Base Data (delta is equal to zero), until you
begin to make changes.

1. You can create a new Revision Data ID by selecting any of the actions listed below:

From the RevControl menu, select the Create command.

From the Data Manager

ETAP displays the Create version of the Project Revision Control dialog box. In this dialog box,
you can create a new Revision Data ID or copy an existing one and use it as a base for your new
revision. For information about copying revision data for a new revision, see the Copying
Revision Data Section below.

ETAP. 5-50 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Project Revision Control Dialog Box – Create Version

2. In the From Revision Data group, make sure the New option is selected.
3. In the New option text box, enter the new Revision Data ID.
4. Enter the revision information in the text boxes on the right, including Change # (design change
notification number), Group # (design group number), Authorization, Description, Schedule, and
Remarks.

Note: When you want to merge Revision Data, you can merge by specifying the Revision Data
ID, Change #, or Group # entered in this dialog box. For more information about merging
Revision Data, see the Merging Revision Data Section below.

5. Click OK. ETAP adds the Revision Data ID to the Revision toolbar’s drop-down list.

ETAP. 5-51 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Create revision records based on:

ETAP property editors such as bus and protective devices are updated with short circuit and arc flash
values. These values are stored with the property editor and hence revisioned in the event the analysis
results are different between Base and any other revision. This option allows the user to force ETAP to
create revision records based on Star and Arc Flash updates.

ETAP. 5-52 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4.4 Copying Revision Data

You can create new revisions by copying Revision Data from existing Revision Data IDs (names). All
data in a copied revision is identical to the revision from which it was copied, until you begin to make
changes. You can also copy revisions by using the Data Manager Copy button.

1. From the RevControl menu, select the Copy command.

ETAP displays the Copy version of the Project Revision Control dialog box. In this dialog box, you can
also create a new Revision Data ID by copying the Base Data. For information about copying the Base
Data for a new revision, see Creating Revisions section above.

ETAP. 5-53 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

2. In the From Revision Data group, make sure the Existing option is selected.

3. Select the Revision Data ID you want to copy from the drop-down list.

4. In the text box under the To Revision Data group, enter the name of the new Revision Data ID.

5. Edit the revision information as required in the text boxes on the right, including Change #
(design change notification number), Group # (design group number), Authorization, Description,
Schedule, and Remarks. Change # and Group # can be any alphanumeric combination up to 36
characters.

Note: When you want to merge Revision Data, you can merge by the Revision Data ID, Change
#, or Group # entered in this dialog box. For more information about merging Revision Data, see
the Merging Revision Data Section below.

6. Click OK. ETAP adds the Revision Data ID to the Revision toolbar’s drop-down list.

ETAP. 5-54 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4.5 Edit Revision Data ID Name and Information

You can rename a Revision Data ID and edit any of its information by doing the following:

1. From the RevControl menu, select the Edit command. ETAP displays the Edit version of the
Project Revision Control dialog box.

Project Revision Control – Edit Version

2. Edit the Revision Data ID name and information as required, and then click OK to save the
changes.

You can also edit the revision ID and information from the data manager using the edit button.

Note: The Revision Data ID information includes Change # (design change notification number) and
Group # (design group number), which may be used to merge Revision Data. For more information
about merging Revision Data, see the Merging Revision Data Section below.

5.4.6 Merging Revision Data

You can merge Revision Data to study the effects of multiple revisions’ changes and modifications on the
project simultaneously. When you merge Revision Data, the combined revision will consist of the
elements and engineering properties from the Base Data, except where properties of the Revision Data
have been changed. In those cases, the merged revision uses the Revision Data properties instead. Where
the same changed properties differ between two revisions, the revision that is being merged into is the one
that has its properties overwritten.

You can use the following three Revision Data types to merge Revision Data:

Revision Data ID (name)

Change # (design change notification number)
Group # (design group number)

ETAP. 5-55 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4.7 Merging by Revision Data ID

You can merge one revision into another revision by using their Revision Data IDs. Where the same
changed properties differ between two revisions, the revision that is being merged into is the one that has
its properties overwritten. However, the merged revision keeps the Revision Data Info values of the
revision that is being merged into.

You can also merge Revision Data into the Base Data, if you have project, base, or Revision Editor logon
access. When you merge Revision Data into the Base Data, that Revision Data is deleted because there is
no longer any delta difference between it and the Base Data.

Note: You cannot merge the Revision Data of one ID into the same ID (for example, Revision 1 into
Revision 1).

To merge one revision into another revision, follow these steps:

1. From the RevControl menu, select Merge. ETAP displays the Merge version of the Project
Revision Control dialog box.

Project Revision Control – Merge Version

2. In the From Revision Data group, select the ID option.

3. In the To Revision Data group, select the name of the Revision Data ID into which you want to
merge the selected Revision Data.

4. Click OK to merge.

ETAP. 5-56 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

To merge one revision into another revision, these steps can be followed as well.

1. Launch the Data Manager

2. Click the Merge button. ETAP displays the Merge version of the Project Revision Control dialog
box.

3. In the From Revision Data group, select the ID option.

4. In the To Revision Data group, select the name of the Revision Data ID into which you want to
merge the selected Revision Data.

5. Click OK to merge.

ETAP. 5-57 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4.8 Individual Element Merge

Merging using the Data Manager can be done graphically as well. Not only does the data manager allow
for complete data revision merges, it may also be used to merge individual elements as well.

Graphical merge of base / revision to another

1. Launch the Data Manager

2. Set the Display Options to Elements
3. Select the Base / Revision you want to review or merge
4. Drag the Base / Revision column name to the destination Revision / Base.

5. A confirmation dialog is displayed indicating the From and To Data Revisions that will be merge.
Click Yes to continue with the merge.

ETAP. 5-58 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Graphical merge of base / revision data for individual element to another

1. Launch the Data Manager

2. Set the Display Options to Elements
3. Select the Base / Revision you want to review or merge
4. Find the element you want to merge between data revisions
5. Drag and drop the cell corresponding to the element from one data revision column to another

6. A confirmation dialog is displayed indicating the From and To Data Revisions that will be merge.
Click Yes to continue with the merge.

ETAP. 5-59 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

7. If confirmation dialog is not required then you may check the option “ Do Not Ask for
Confirmation (This Session Only)”. When this option is checked, as long as the Data Manager is
not restarted, this confirmation dialog will not be displayed again.

5.4.9 Merging by Change # or Group #

The Change # (design change number) and Group # (design group number) options are used to merge
together phases of design projects. Each Revision Data ID can have both a Change # and a Group #
assigned and each can be considered a phase of a project.

For example, you can use Change # to associate the revisions of a project. If you want to study how the
phases (revisions) of the project are working together, you can merge all the revisions assigned to that
particular Change #. Then, you can use Group # to merge common revisions between one or more
projects to study how the projects work together.

In the above example, Group # is a meta-variable of Change #. However, you can use Change # and
Group # interchangeably to match the needs of a design project and the structure of your design group.
Either one can be used for any level of projects that have more than one design revision associated with
them, as long as you are consistent with the project levels where you are using them.

To merge revisions by Change # or Group #, do the following:

1. From the RevControl menu, select Merge. ETAP displays the Merge version of the Project
Revision Control dialog box.

ETAP. 5-60 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Project Revision Control – Merge Version

2. In the From Revision Data group, select the Change # or Group # option. Depending on your
option selection, ETAP displays one of the following versions of the Project Revision Control
dialog box.

Change # Option

ETAP. 5-61 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

Group # Option

3. In the Change # or Group # drop-down list, select the change number or group number whose
associated revisions you want to merge. ETAP displays the Revision Data IDs of all the revisions
that have the selected change or group number in the Revision Data box.

Note: Since both Revision 1 and Revision 2 were assigned Change # 1 and Group # A, both
revisions appear in the Revision Data box of the figures above when either Change # 1 or Change
# A is selected.

4. In the To Revision Data group, select the Revision Data ID of the revision into which you want to
merge the displayed Revision Data.

5. Click OK to merge.

6. The Merge function can also be launched from the data manager.

ETAP. 5-62 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard Data Manager

5.4.10 Deleting Revision Data

If you are logged on at the project, base, or Revision Editor access level, you can delete Revision Data by
specifying the Revision Data ID. You cannot delete the Base Data.

Note: Once you have deleted Revision Data, it is not retrievable. Deleted Revision Data is not put into the
dumpster.

To delete a Revision Data ID, follow these steps:

1. From the RevControl menu, select the Delete command. ETAP displays the Delete version of the
Project Revision Control dialog box.

2. From the Revision Data Info drop-down list, select the Revision Data ID you want to delete.

3. Click OK to delete.

The delete function can also be launched from the Data Manager.

ETAP. 5-63 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

5.5 ETAP Wizards

ETAP includes time-saving project management tools called the ETAP Wizards, which allow you to
record and run any study at any time. The ETAP Wizards include the Scenario Wizard, Study Wizard,
and Project Wizard. All three are described in more detail below.

Using the ETAP Wizards, you will be able to combine the orthogonal tools (Presentations,
Configurations, and Revision Data), study types, Output Reports, and Study Cases (the loading and
generation system operation factors together with solution parameters) to perform a complete system
study with the click of a button.

Scenario Wizard

The three ETAP Wizards are located on Study Wizard

the lower portion of the System toolbar.

Project Wizard

ETAP. 5-64 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

5.5.1 Scenario Wizard

A scenario allows you to group all study options into one place. For this reason, scenarios are useful
anytime you want to record a study for execution. Every project file contains a Scenario Wizard.
Scenarios are created and recorded in the Scenario Wizard and can be run individually at any time. A
project can have an unlimited number of scenarios. Scenarios are composed of the following parameters:

System (Network Analysis, UGS Analysis, or CSD Analysis)

Presentation (for example, one-line diagram, UGS, or CSD)
Revision Data (Base or Revision Data)
Configuration Status (for example, Normal, Stage 1, or TSEvents)
Study Mode (for example, LOAD FLOW or SHORT-CIRCUIT)
Study Case (loading and generation system operation factors and solution parameters)
Study Type (vary depending on Study Mode)
Output Report (vary depending on Study Mode)

When a scenario is run in a project, it will automatically create an Output Report or overwrite an existing
report with the same name.

ETAP. 5-65 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Scenario Wizard Editor

You can create a scenario either by selecting parameters in the Scenario Wizard or by recording options
you have already selected for your study in the one-line view. To record the options already selected in
your study in the one-line view, follow these steps:

ETAP. 5-66 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

1. Open the Scenario Wizard

2. Click on the New button

ETAP sets up the options in the Scenario Wizard based on the selected Study Case, report, presentation,
revision, and Study Mode.

Scenario
Scenario ID
The Scenario ID is displayed in this text box. You can rename a scenario by deleting the old ID and
entering a new one. The Scenario ID can be up to 30 alphanumeric characters long. Use the navigator
buttons at the lower left of the dialog box to page through the existing scenarios.
New
Click the New button to save the current setup of the editor as a new study. In effect, a new scenario will
be created based on the existing System, Presentation, Revision Data, Config. Status, Study Mode, Study
Case, and Output Report settings. If there are multiple Study Types under the same Study Mode
parameter, the Study Type will default to the first type.

Note: When you click the New button, the Scenario ID is incremented by one to maintain an unique ID.
You can navigate to the previous or next scenario by using the navigator buttons at the lower left of the
editor.
Copy
Click the Copy button to copy the existing scenario. The Scenario ID is incremented by one to preserve
ID uniqueness. After copying the scenario you can modify and save any of the settings.
Delete
Click the Delete button to delete the selected scenario. There is one exception to this, you cannot delete
the last scenario in the project. There must be at least one scenario in a project.
Rename
Click the Rename button to rename the selected scenario. ETAP will save the System, Presentation,
Revision Data, Config. Status, Study Mode, Study Case, Study Type, and Output Report settings
specified in the Scenario Wizard under the new scenario name.

Run
Click the Run button to execute the selected scenario. ETAP will use the System, Presentation, Revision
Data, Config. Status, Study Mode, Study Case, Study Type, and Output Report settings specified in the
current scenario.

ETAP. 5-67 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Project & Library

Project File
The path to where the project is stored.

ETAP Default Library

Path to where the ETAP default library is located. Please note that this path location will be dynamically
updated for every release of ETAP once this option is selected. This means that if this option is selected,
the program will automatically select the library provided with the current release of ETAP being used
run the project file (i.e., C:\ETAP xxxx\LIB\Etaplibxxxx.lib).

Project Specific Library

Path to where the library being used for this project is stored. The program will always look in the
specified path for the library to be used to run this project file.

Parameters
In this group you can select the parameter values ETAP will use when you execute this scenario.
System
This parameter is accessible from the drop-down list. Use it to select either the Network Analysis or CSD
Analysis system. The system selected determines the Study Mode and Study Type parameters that are
available.
Presentation
Use the drop-down list to select any of the presentations available under the system selected. The selected
presentation will be used when the scenario is executed.
Revision Data
Use the drop-down list to select any of the Revision Data IDs available under the system selected. The
selected Revision Data will be used when the scenario is executed. The button to the left of the drop down
menu will open the Data Manager to modify, delete or add revisions.
Config. Status
When you select the Network Analysis System, use the drop-down list to select any of the available
configurations. This option is only available under Network Analysis, since it is the only system that uses
configurations. The button to the left of the drop down menu will open the Configuration Manager to
modify, delete or add configurations.
Study Mode
Use the Study Mode drop-down list to select one of the available modes. The Study Modes available are
dependent on the system selected. If you select CSD Analysis under the System parameter, only CSD is
available under the Study Mode parameter. If you select UGS Analysis or Network Analysis under the
System parameter, the figure below shows the available Study Modes (and the available study types for
each):

ETAP. 5-68 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Study Case
Study Cases include the loading and generation system operation factors in combination with solution
parameters. Use the drop-down list to select any of the Study Cases available under the selected Study
Mode. The button to the left of the drop down menu can edit the study case.
Study Type
Use the Study Type drop-down list to select one of the available values. These study types are dependent
on the System and Study Mode values selected. If you select CSD Analysis under the System parameter,
only Voltage Drop is available under the Study Type parameter. If you select UGS Analaysis or Network
Analysis under the System parameter, the available Study Type parameters depend on the Study Mode
parameter selected, as shown in the figure in the Study Mode Section above.
Output Report
Enter an Output Report name or select a Study Mode and choose one from the drop-down list of reports
that are available there. When a scenario is executed in a project, ETAP will automatically create the
Output Report or overwrite an existing report of the same name.

ETAP. 5-69 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Preferences/Ini File
Editing the ini entries through this editor will supersede the existing entries set globally in the etaps.ini
file or under the Options Preferences editor for the selected scenario. A list of all INI settings can be
found by using the Add button when the Edit button is selected.

Note: To include the ini updated in this field, the study must be run from the scenario wizard. If the study
is run from the study toolbar, the ini entry will not be considered.

“What-If” Studies
Editing the “What-If” studies through this editor will supersede the conditions in the Configuration
Manager.
Remarks
Enter any remarks you want saved with the current scenario.

ETAP. 5-70 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

5.5.2 Study Wizard

Macros reduce the time it takes to run several scenarios. Every project file contains a Study Wizard. The
Study Wizard enables you to sequentially group existing scenarios into study macros. You must have
created the scenarios that will be included in the study macro before you can create the macro. You create
these scenarios using the Scenario Wizard. (See the Scenario Wizard Section above for additional
information.)

A project may include an unlimited number of study macros. When you run a study macro, all of the
scenarios included in it are run, and create new Output Reports or overwrite existing Output Reports,
much the same way as if they were run individually. For example, it is possible to group scenarios related
to load flow or a specific type of load flow into one study macro.

ETAP. 5-71 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Study Wizard Editor

To create a study macro, follow these steps:

1. Open the Study Wizard.

2. Click in the Scenario box, and then select the scenario you wish to run first.
3. Repeat Step 2 for the next empty row and repeat for each scenario you wish to include.
4. When you are finished selecting scenarios, click OK to save the study macro.

Study Macro
New
Click the New button to create a new study macro.

Note: When you click the New button, the macro ID is incremented by one to maintain a unique ID. You
can navigate to the previous or next scenario by using the navigator buttons at the lower left of the editor.
Delete
Click the Delete button (located at the top of the dialog box) to delete a selected macro. There is one
restriction, you cannot delete the last macro in the project. There must be at least one macro in a project.

ETAP. 5-72 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Copy
Click the Copy button to copy the existing study macro. A new macro is created with the selected macro
settings. The macro ID is incremented by one to maintain an unique ID. Once you have copied the macro
you can modify and save any of its settings.
Rename
Click the Rename button to rename the selected study macro. ETAP will save the current settings under
the new macro name.

Run
Click the Run button to execute the selected macro. ETAP will use the System, Presentation, Revision
Data, Configuration Status, Study Mode, Study Case, Study Type, and Output Report settings specified in
the first scenario and then move to the next scenario according to the sequence recorded in the macro.

Parameters
Order
This defines the sequence in which the macros will be executed.
Active
Select this to activate the row. Any scenario not activated will be skipped during the execution of the
macro.
Scenario
Select one of the scenarios available in the project from the drop-down list.
Pause
Select Pause to cause macro execution to stop at the current scenario. This option allows you to
automatically stop the execution of the macro when you want to review the results after running the
scenario.
UP / DOWN
Select a row and click the Up and Down buttons to change the sequence in which the scenarios are
executed.
Add
The Add button allows you to add a new row so that a new scenario can be added to the current study
macro.
Delete
Click on this button to delete the selected scenario from the current study macro. Please note that this
action simply removes the scenario from the current study macro list, but does not remove the scenario
from the project.
Insert
This button allows you to insert a new row above the selected one. This allows you to insert an scenario at
any point in the study macro list.

ETAP. 5-73 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

5.5.3 Project Wizard

The Project Wizard is project independent and is saved within the ETAP folder. It enables the user to
group existing study macros into project macros. You should use a project macro when you have several
projects from which you want to run multiple study macros and their scenarios simultaneously. This
feature automates opening and closing project files and individually executing study macros and their
scenarios.

ETAP. 5-74 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Project Wizard Editor

You create a project macro in the following manner:

1. Open the Project Wizard.

2. Click the macro field, and then select the study macro you want to execute first.
3. Repeat Step 2 for the next empty row and repeat for each study macro you wish to include.
4. When you are finished adding study macros, to save the project macro, click OK.

Project Wizard
New
Click the New button to create a new project Wizard.

Note: When you click the New button, the Project Wizard ID is incremented by one to maintain a unique
ID. You can navigate to the previous or next project macro by using the navigator buttons at the lower left
of the editor.

ETAP. 5-75 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Delete
Click the Delete button located at the top of the dialog box to delete the selected project wizard. There is
one restriction, you cannot delete the last project wizard (i.e. there must be at least one project wizard in
the list).
Copy
Click the Copy button to copy the existing project wizard. A new project wizard is created with the
current settings. The project wizard ID is increased by one to preserve ID uniqueness. After copying the
project wizard you can modify it and save any of the its settings.
Rename
Click the Rename button to assign a new name to the selected project wizard. ETAP will save the current
settings under this new project wizard name.

Run
Click the Run buttons to execute the selected project wizard. ETAP will run the scenario settings
specified in the first study macro then move to the next one according to the sequence recorded in the
project macro.
Run Selected
When the Run Selected button is selected, the study will only run the selected projects. Selected projects
may or may not be active.
Run Active
When the Run Active button is selected, the study will only run the projects which have the active
checkbox marked.

Study Wizard Selection

Order
Defines the sequence in which the study macros will be executed.
Active
Select Active to activate the row. Uncheck this box if you want to skip the execution of this study macro
for the current project wizard.
Path
Enter the path to the project that contains the study macro you wish to run. If you do not know the path,
use the Browse button on the right to locate the project wizard and the desired study macro.
Project
Enter the name of the project that contains the study macro you wish to run. If you do not know the
project name, use the Browse button on the Right to locate the project wizard and the desired study
macro.
Study Macro
From the Macro drop-down list, select one of the study macros available in the selected project wizard.
Pause
Select to pause at the current study macro. This option allows you to automatically stop the execution of
the project macro when you want to review the results after running the study macro.

Note: If you include study macros that contain scenarios that have been set to pause during execution of
the study macro, the project macro will also pause after that scenario.

ETAP. 5-76 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

UP / DOWN
Select a row and click these buttons to change the sequence in which the study macros are executed.
Browse
If you do not know the project name that contains the study macro you wish to run, use the Browse button
on the Right to locate the project wizard and the desired study macro.
Delete
The Delete button on the right side of the dialog box will delete the selected row.
Insert
Select a row and click the Insert button to insert a row above the selected row.

Add
Click on this button to add a new row to the current project wizard. This will allow you to specify a new
study macro.
Add Multiple
Click on this button to add multiple study macros to the current project wizard. The following editor
allows you to specify the path of the study macros you want to add. The “Include Subfolders” allows the
program to search all the subdirectories within the path specified. If there is any study macro in the
subdirectories, it will be added to the current project wizard.

ETAP. 5-77 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

5.5.4 Wizard Example

This example illustrates how you can create macros for previously executed Load Flow, Short-Circuit
(Three-Phase Duty), and Reliability Study Cases and save yourself time later on. For this example, the
project file contains the following items:

Two sets of data (Base and Revision1)

Three configurations
Two different generation categories
Two different loading categories

According to these parameters, the example includes 24 different scenarios for each study.

Scenario Setup
As a first step, you would create the 72 scenarios (24 for each Study Case) using the Scenario Wizard. For
example, one of the scenarios would be a load flow analysis using Base Data, Config1 status, and
maximum loading and generation categories. To create this scenario, you would set it up normally from
within the one-line view, and then open the Scenario Wizard and click New. ETAP will automatically
capture all of the parameters and conditions related to the study.

You would then create the remaining scenarios by repeating the above actions, or by selecting New from
the Scenario Wizard and then specifying the parameters manually.

ETAP. 5-78 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

For example, you would run this load flow study with the following options:

Two Loading Conditions (Summer Load and Winter Load)

Two optional settings on Generation (Generators set to Power Factor Control or Voltage Control)
Two options for a Transformer Size (10MVA and 30 MVA)

For the above conditions, you would set up the following options in ETAP:

Two Study Cases:

LF-Case1 set to use Summer Load
LF-Case2 set to use Winter Load

Two Configurations:
Config-1 with generators set to Power Factor Control
Config-2 with generators set to Voltage Control

Two Revisions:
Revision-1 with Transformer set to 10 MVA
Revision-2 with Transformer set to 30 MVA

Given the above settings, in the Load Flow Mode you would select one case from the following, or any
other combination:

LF-Case1, Config-1, Revision1, and name the Output Report (Case1)

LF-Case2, Config-1, Revision1, and name the Output Report (Case2)
LF-Case3, Config-1, Revision1, and name the Output Report (Case3)

If you were to repeat the setup of these cases without the Study Wizard, you would have to remember all
of this setup information. Using the Study Wizard you can create multiple scenarios for each case. For the
example above, there would be one scenario for each combination of options.

Next, using the Study Wizard, you would organize the 72 scenarios into three study macros based upon
Analysis Type. For example, the first study macro would contain the 24 Load Flow scenarios and be
named LF_Study. To create the LF_Study macro, you would open the Study Wizard, click New, and then
add the 24 Load Flow scenarios.

ETAP. 5-79 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

The other two study macros can be created by clicking New and adding the respective scenarios.

Next, you would link the three study macros, by opening the Project Wizard and adding the three study
macros.

ETAP. 5-80 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

After completing all of the required steps for the ETAP Wizard, you have the choice of running all
scenarios using the Project Wizard, running only the scenarios related to a specific study using the Study
Wizard, or running one or more scenarios individually using the Scenario Wizard.

The more configurations and studies you have within a project, the more valuable ETAP Wizards will
become for you in terms of increased efficiency and time savings, time that might otherwise be expended
performing repetitive setup tasks.

ETAP. 5-81 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

5.5.5 Output Database Comparison Program

The Output Database Comparison Program (DB Compare Program) is a console designed to compare two
SQL Server Compact Database File (SDF) files as instructed by a third SDF file (instruction database).
This console has been designed to interface with the scenarios in ETAP to allow the comparison of
current ETAP output database results against results from a benchmark Output Report database. The
benchmark results could have been generated using a previous version or the same version of ETAP.

This comparison console can be used for different purposes:

1) It can be used as a raw database comparison utility. In this form, it can compare all the tables
inside a database (current results) against the same tables in another database (benchmark).
Depending on the results of the comparisons, the program will generate pass/fail reports for each
table/database being compared.

2) It can be used as an automatic validation tool to compare ETAP results generated in one computer
against the same results generated from a different machine. This can be the case with the
installation tests required for ETAP under a high impact software program (i.e. nuclear grade
software application ETAP installation tests).

3) It can be used to compare the deviation on ETAP results between different scenarios (i.e.
deviation caused by using different Study Case parameters, configurations, revisions, preferences
(options) etc.

The DB compare program has the following components:

1) The Output Report database file: This Output Report database file is created by ETAP upon
execution of the current scenario.

2) The benchmark report database file: This Output Report database is the benchmark file. The DB
compare console compares the output database against this database to create the comparison
results.

3) The comparison instruction database file: This database contains instructions on the comparison
that should be executed. This instruction database tells the DB compare console what tables to
compare and/or which tables to skip. It also has command instructions on how each table should
be compared as well as what deviation is allowed.

4) The comparison results databases: These databases are created at the time the output database and
the benchmark database are compared. They contain the specific results of the comparison
including pass/fail items and the reasons for the failures (deviation report and global summary
report databases).

Output Data Comparison Editor

The Compare Output (Output Database Comparator) Editor can be accessed from the Scenario Wizard
window.
Output Data Comparison Checkbox
You must check the “Output Data Comparison” checkbox in order to enable the “Edit” button. Clicking
on the Edit button will bring up Compare Output Editor:

ETAP. 5-82 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Compare
The Output Report comparison is launched automatically from this button. You can launch the
comparison by clicking on this button once you have setup the “Compare Output Editor” options and you
have specified which Output Report SQL Server Compact Database is to be considered the benchmark in
the comparison.
Edit
The edit button opens the “Compare Output” Editor window. This is where all the comparison
preferences and instruction databases can be specified.
View
The view button allows you to quickly open the Output Report comparison result database. This database
contains the results of the comparison.
Benchmark File Path
This path shows the name and directory which contains the benchmark Output Report database. This path
is display only and can be changed from the “Compare Output” Editor window.

ETAP. 5-83 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Compare Output Editor (DB Compare Console)

Database Comparison
The “Compare Output” Editor allows you to setup the DB compare program so that it can automatically
compare the newly generated Output Report database from the scenario against the benchmark database.
Selected Report
This is the path of the current output result database to be generated by the current scenario. Once the
scenario finishes generating this report database, it will be compared to the benchmark database. This
path is automatically selected by the program once the scenario is configured and you have selected an
Output Report name for the particular scenario.
Benchmark Report
This is the Output Report database which serves as the benchmark in the comparison. This means that the
comparison is taken as:

ETAP. 5-84 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

View (selected report)

This button allows you to open the Output Report database. Once this button is clicked, the program
opens the SQL Server Compact Database file (SDF) directly. Once the viewer is open, click File, then
select the report to be viewed from the menu. The report will open in a new report viewer window. This
serves as a quick way to open the selected Output Report database (instead of using windows explorer
and/or launching it directly from a copy of SQL Server Management Studio).
Browse (for benchmark report path)
This button opens a browse window so that the path to the benchmark Output Report database can be
specified.
View (benchmark report)
This button allows you to open the selected benchmark Output Report database. Once this button is
clicked, the program opens the SQL Server Compact Database file (SDF) directly. This serves as a quick
way to open the selected benchmark Output Report database (instead of using windows explorer and/or
launching it directly from a copy of SQL Server Management Studio).

Comparison Results
This section allows you to specify the name and location of the databases which contain the results of the
Output Report database comparisons.
Deviation Report (Comparison Results Database)
This path points to the location of the database which contains the detail results of the comparison
between the output and benchmark report databases. This path is automatically selected by the program
faster setup; however, it can be modified by specifying a new path and name by clicking on the Browse
button.
Browse (deviation report)
This button opens a browse window in which you can specify the name and location of the Deviation
Report database (comparison results database).
View (deviation report)
This button allows you view the Deviation Report (comparison results database) using the SQL Viewer.
Generate Excel Plot Comparison
By selecting this option, it compares Transient Stability plots for devices selected and saves a report in
excel. The report will consist of a summary of all the devices that were selected in the TS study case and
an individual report of each type of plot. Once the selected report, benchmark report and this option is
checked, it will compare all the devices that were plotted and will have separate excel sheets based on the
type of plot (I.E- Slip, Accel Power, MWe, etc.). The browse button adjacent to this field opens a browse
window that can specify the name and location of the excel plot comparison report.
Global Summary (Pass/Fail) Report
This path points to the location of the database which contains the global results of the comparison
between the output and benchmark report databases. This path is automatically selected by the program
and it defaults to the ETAP installation directory under a file called “GlobalSummaryReport.sdf.” The
DB Compare Console will write the location path of the Global Summary Report Database into the
ETAPS.ini file. Once this is done, all the global comparison results for each scenario will be created in
that location. This means that if you set this path and report name, the program will utilize it for any
scenario unless it is changed again.
Browse (Global Summary)
This button opens a browse window in which you can specify the name and location of the Global
Summary (Pass/Fail) Report Database.

ETAP. 5-85 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

View (Global Summary)

This button allows you view the Deviation Report (comparison results database) using SQL Viewer.

DB Compare Options
This section has the purpose of providing global comparison options for the DB Compare Console. These
options allow you to skip comparing some parameters such as project names, database versions, and dates
which do not need to be compared since they are not part of any calculation results.
Skip Records that Pass with Deviation < 0.1%
If this box is selected, The DB Compare Program will not report any comparison result whose deviation
is less than 0.1%. This means that all records with a percent deviation less than 0.1% automatically will
pass and will not be reported in the deviation report. The records with a deviation percentage higher than
0.1 % will be reported as failures in the deviation report. It is recommended to use a default value of 0.1%
as the default for the comparison values to allow for different calculation precision and small deviations
in significant figures.
Skip Project Information
The project information for the load flow Output Report database will not be compared. Please note that
this option only applies to load flow Output Report database. The project information is typically
included inside a table called “Header”. This checkbox instructs the program to automatically skip the
comparison of the fields inside this table. However, for some other modules, the project information may
be contained inside of a table with slightly different name like “HeaderRA”, HeaderTS, etc. and thus this
option only applies to LF Output Report databases.

The instruction database provided with the current version of ETAP already provides specific instructions
for skipping the comparison of the project information for all modules including load flow. Because of
this situation, this option may not have any impact on the comparison results.
Compare All Database Tables (Global)
Once selected, the instruction database will be used and then all database tables for each Output
Report Database will be compared. If this option is not selected, the comparison tool will only compare
the tables listed in the Instruction database and ignore the other tables listed in the Output Report
database.

Plot Compare Options

This section is used to set a limit, based on percentage, for pass and fail criteria. If the percentage is above
the limit set, the plot compare results will print Pass or Fail.
Max Plot Diff
Set the maximum limit for each point in the plot for passing criteria. If difference is higher than the value
entered, the summary report will list that device and plot type as a failure.

Total Plot Diff

Set the total limit for all points in a single plot for passing criteria. Example of this is plotting Mtr 7’s
MWelectrical. If the sum of benchmark points and the sum of all generated points are compared, the delta
difference of the sum will be the total limit.) If difference is higher than the value entered, the summary
report will list that device and plot type as a failure.

ETAP. 5-86 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Instructions Database
This section allows you to specify the name and location of the specific comparison instructions for the
DB Compare Console. The comparison instructions are provided in the form of a SQL Server Compact
Database and also certain comparison instructions can be entered directly through the command-line
instructions (for advanced users)
Instruction Database Path
The instruction database contains the instructions for comparing the Output Report databases. The DB
Compare program has a default comparison instruction database provided with all versions of ETAP from
7.0.0 onwards. It is located under “C:\ETAP (Version #)\ DB_CompareInstr.sdf”. This instruction
comparison database has been configured by ETAP engineers to assist in the comparison of ETAP results.
Browse (Instruction database)
This button opens a browse window in which you can specify the name and location of the Comparison
Instruction Database. This path only needs to be specified once since the DB Compare program stores this
location in the ETAPS.INI file. The program will use the same set of instructions for all the scenarios that
are executed (from the Study Wizard or Project Wizard).
Command-Line Instructions
This command line input field allows you to provide specific instructions to the DB Compare Console for
comparing the results and benchmark databases.

The following command can be added in this version of the DB Compare Console:

-daction = Instructs the DB Compare program to compare only the tables listed in the comparison
instruction database Comparator Table. If a table is not listed in the Comparator table, then the program
will not compare it. This command can be very useful when you do not want to specify each table in the
comparator table (either to skip or compare), and you only want to compare the tables for which you add
specific instructions.

Comparison Instruction Database Setup

This section describes the commands which can be setup inside of the comparison instruction database.
This database contains two tables. The first table is called the “Comparator” table and it contains the
specific comparison instructions. The second table is called the “LookupTable” and it contains
translations for each of the table column headers (field names). These translations attempt to give a more
meaningful description of the data in each field (since the database may be abbreviated or has not so
meaningful names which may be hard to understand).

ETAP. 5-87 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Comparator Table
This table has the following fields: “TableName”, “FieldName”, “Action”, “CompType”,
“CompMethod”, “CompVariance” and “DoOrderBy”.

The structure of the table and the possible commands which can be entered into this table are shown
below:

Comp Comp
TableName FieldName Action CompType DoOrderBy
Method Variance
Name of the N/A (leave C (Compare) N/A (leave N/A N/A fieldname1, fieldname2,
table in the blank) S (Skip) blank) (leave (leave fieldname3
database to CSN blank) blank)
which this (compare Applies to table entry only.
entry skip new) Specifies the sort order of the
applies. table in the Results and
Benchmark database. If no
entry, the primary key is used if
there is one. If no primary key,
the program guesses. Add
NOSORT for “side-by-side”
comparison.

The following is a sample database comparison instruction “Comparator” table:

The following indicates how you would interpret the instructions on the second line of the Comparator
table:

The table name field specifies the name of the table for which the specific instructions apply. The action
field indicates that the “AlertDeviceSum” table will be compared based on CSN criteria. CSN stands for
compare but skip new. This means that this table will be compared but any new fields in the results table
which do not exist in the benchmark table will be ignored. Only the fields that exist in both the results and
benchmark Output Report database Alert table are to be compared.

The DoOrderBy field indicates which fields can be used by the program to create unique records to be
compared. In this case, the “DeviceID” and “DeviceType” fields can be used to establish unique records
for the comparison. If no unique records can be created (i.e. the table does not contain any fields which
can be used as unique keys to identify each row in the table), then the DB compare program cannot make
a comparison and the end result will be a failure in comparing this table. However, another command
called “NOSORT” can be added along with any field name to tell the DB compare program to continue
the comparison of this table on a record by record basis without establishing unique keys.

ETAP. 5-88 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

The NOSORT command will work in most cases as long as the sorting of the rows in the result and
benchmark tables remains the same. If the sorting is different, then this will result in a failure in
comparing the table.

Actions:

C = Compare = specifies that a table is to be compared. If there is any new field in the results database
which does not exist in the benchmark database, then the comparison will result in a failure.

CSN = Compare Skip New = Specifies that a table is to be compared, but any new fields which exist only
in the results database and do not exist in the benchmark database will be skipped. This may help to
compare tables between different versions of ETAP. In newer versions of ETAP, new fields may have
been added to a particular table. Since these fields do not exist in previous versions, there is no need to
compare them (or there is nothing to compare against).

S = Skip = specifies that this table is not to be compared. This can be specified for any table which
contains project information or data which is not calculation related.

Field Name = Specifies the name of the table for the specific instructions

CompType = Specifies the type of comparison to be performed. This value can be left blank. Numbers
are treated as float comparisons and text as string comparisons.

CompMethod = Specifies the method of specifying the deviation results. This value can be left blank.
The default for this value is percent.

CompVariance = Specifies the deviation allowed for this table. This value can be left blank. The
variation allowed can be specified globally from the Compare Output Editor for each scenario. The
default is 0.1%.

DoOrderBy = DoOrderBy applies to tables only. The Do Order By field allows you to specify which
columns can be used to establish unique records in a table. If DoOrderBy includes an entry of NOSORT,
a different algorithm is used for selecting what rows to compare. NOSORT causes the DB Compare
program to start at the top of the table and compare the rows of each table in order, as if it were looking at
side-by-side printouts of the two tables. The purpose of the NOSORT instruction is to handle table
comparisons that have no unique keys.
LookupTable
The lookup tables in the comparison instruction database serve the purpose of translating the field names
(column names) to more meaningful descriptions.

ETAP. 5-89 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

As you can see in the image above, the LookupTable contains different output names for the field names
in different ETAP Output Report database. As an example, the table called “BusArcFlash” in the report
database is called “Arc Flash Analysis and Summary” in the Comparison Results Reports.

You can fully customize the comparison instruction table or the lookup table to whatever preferences you
may have by simply replacing the values.

Deviation Report (Comparison Result Database)

This deviation results or comparison results database contains the results of all the comparisons
performed by the DB Compare program. This database is divided into three tables and reports:

Summary Results
Table Results
Detail Results

ETAP. 5-90 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

The DB compare program names the deviation report by default using the name of the result database
being compared. For example if the results database being compared is called “LFReport”, then the
deviation report will be automatically named “LFReport_DBCompare.sdf.” The browse button next to
the deviation report path can be used to change the name and location of the Deviation Report.
Summary Results
This table/report contains a summary of the comparisons for this test case. It indicates an overall pass or
failure for the comparison on the result and benchmark Output Report databases.

Summary Report

ETAP. 5-91 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Test Results Summary Table

This table/report can be accessed from the view button on the Compare Output and/or Scenario Wizard
Editors.
Table Results
This table/report contains a summary of pass/fail results for each compared table.

Table Comparison Summary Report

Table Comparison Results

This table/report can be accessed from the view button on the Compare Output and/or Scenario Wizard
Editors.

ETAP. 5-92 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Detail Results
This table/report contains detailed summary results for each comparison performed for each field in every
table compared. This summary can be shortened to only include the results with a deviation higher than
the specified value. This can be accomplished by selecting the option to skip records that pass with a
deviation < %Dev. This option is located in the Options section of the Compare Output Editor.

Detailed Results Report

Detailed Results Table

ETAP. 5-93 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Global Summary Report Database

The Global Summary Report database contains the results of the comparison for the entire database. If all
the tables compared in the Output Report database for a particular scenario match the benchmark tables,
then a “Pass” result will be written in the global summary database for this scenario. In the same fashion,
if any the tables in the database fails the comparison, then the overall result will be a **FAIL**.

The Global Summary Report can be accessed directly once the comparison process is complete by
clicking on the View button next to the Global Summary (Pass/Fail) Report path.

The image below shows the global summary report and table:

Global Summary Results Report

Global Summary Results Table

ETAP. 5-94 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

Setup of DB Compare for Example-ANSI

All versions of ETAP beginning with 7.0.0 and onward have a sample project called “Example-ANSI”.
This project has been configured to run for multiple scenarios on different ETAP modules. This section
shows you step by step how to configure the DB Compare program to compare all the scenarios in this
example against the benchmark reports contained within a directory called output. This example assumes
that ETAP has been installed under the default installation directory C:\ETAP (Version #).

1) Open the Example-ANSI project:

2) Open the Scenario Wizard Editor and open the Output Compare Editor by clicking on the Edit
button for any scenario. In this case LFReport:

3) The Database comparison section has been configured to automatically compare the selected
report “LFreport.LF1S” against the benchmark report with the same name inside of the “Output”
directory as shown in the image below:

ETAP. 5-95 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

4) By default the deviation report should also be named “LFreport_DBCompare.sdf”.

5) By default the Global Summary Report field will be blank. Click on the Browse button next to the
path for the global summary and name as follows: “C\ETAP (Version
#)\GlobalSummaryReport.sdf”.

6) The options to skip records that pass with deviation less than 0.1% and to skip project
information should be selected.

7) The name and location of the instruction database may be blank. Click on the Browse button to
specify the following name and location “C:\ETAP (Version #)\DB_CompareInstructions.sdf”.

ETAP. 5-96 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

8) At this point you can close the Output Compare Editor and Scenario Editor. Click OK to save all
of your changes.

9) Open the Study Wizard. Select Phase-1 Macro and execute it (click on Run button). You must
wait until all the scenarios finish running and all the comparisons have completed. The DB
Compare program places some icons on the task bar during execution. You should also wait until
all the icons have been removed from the task bar before opening the global summary or
deviation results databases. The comparisons could take a considerable amount of time depending
on the size of the Output Report databases being compared.

10) You can reduce the number of scenarios to be executed by creating a new study macro or by
simply de-activating the scenarios that do not apply to your license. For example, you may only
want to run load flow and short-circuit calculation in one study macro.

11) If your installation directory is different from C:\ETAP (Version #), then you may need to
reselect the name and location of the benchmark Output Report databases for each scenario you
want to run with the DB Compare tool. To do this, simply click on the Browse button and click
on select the name of the benchmark report. The best way to setup the comparisons is to place all
the benchmark reports inside of a directory called “output” inside of the current project that
contains the reports you want to compare.

Click on this button to select the benchmark report to compare against the currently selected Output
Report.

ETAP. 5-97 ETAP 16.0 User Guide

Multi-Dimension Database & Wizard ETAP Wizards

ETAP. 5-98 ETAP 16.0 User Guide

 Chapter 6

User Access Management

ETAP provides program security by relying on two tiers of user access control. The first level is
controlled by the operating system under which ETAP is running (Windows 7, Windows 8 and Windows
10). The user must be an authorized user as determined by the operating system administrator.

ETAP provides the second level of access control by assigning one or more of the nine access level
permissions to an authorized user for each individual project. These access levels are listed in the
following table.

ETAP 6-1 ETAP 16.0 User Guide