CAPE Interface Basics

Prepared for CAPE Users’ Group

Revised July 2016
 Copyright 2003-2016 by Electrocon International, Inc.
All rights reserved.
This document is the sole property of Electrocon International, Inc. and is provided to the CAPE Users’ Group for their own use only. It may not
be supplied to any third party, or copied or reproduced in any form, without the express written permission of Electrocon International, Inc. All
copies and reproductions shall be the property of Electrocon International, Inc. and must bear this ownership statement in its entirety.
CAPE Interface Basics Table of Contents

Table of Contents

I. Installation .........................................................................................................1
A. Support for Multiple Versions of CAPE on Same PC ..................................... 1
B. Registry Items .................................................................................................2
C. EII CAPE Directories ......................................................................................2
II. Interface Features ..............................................................................................3
A. Toolbar .............................................................................................................4
B. Action Bar ........................................................................................................4
C. Data Tree .........................................................................................................4
D. Text Formatting ..............................................................................................5
E. Command Line ................................................................................................5
F. Command History ...........................................................................................6
G. Status Bar .......................................................................................................6
H. Standard Windows Menus ..............................................................................7
I. Online Help .....................................................................................................9
J. Configuration Files and User Preferences.................................................... 12
K. Print Commands ........................................................................................... 13
L. Mouse Usage.................................................................................................. 13
M. Executive Module Dialogs and Features ...................................................... 16
N. Coordination Graphics Module Dialogs and Features ................................. 20
O. One-Line Diagram Module Dialogs and Features ........................................ 22
P. Short Circuit Module Dialogs and Features ................................................. 24
Q. Keyboard Shortcuts (“Hot Keys”).................................................................. 27
III. Updating CAPE ................................................................................................ 28
A. Updating the CAPE Program ....................................................................... 28
1. Troubleshooting: ............................................................................................ 30
2. Updating CAPE when you don’t have Internet access: ................................ 31
3. Updating CAPE when you have multiple copies installed: .......................... 31
4. Updating CAPE in unattended mode:........................................................... 31
B. Updating the Database Schema ................................................................... 32
C. Updating Your Relay Library ....................................................................... 34
IV. Reporting Bugs ................................................................................................. 37
CAPE 14 Interface Basics CAPE Training Notes

I. Installation

Thanks for your decision to use CAPE. This booklet will orient you to the general
CAPE environment and will emphasize features of its Visual C++ interface.

It is very easy to install CAPE, but please read the

page of instructions at the first tab of the Getting
Started booklet. You should have Windows 7 or 8.

CAPE Installation is in three easy parts from the

menu that appears when you load the CAPE CD:
(1) CAPE Application Files, which you may
load on your own PC (often placed in \cape) or
on any PC you can reach over a network, such
as a file server;
(2) CAPE User Files, which you must install
on your own PC or any PC from which you will
run CAPE (often placed in \cape\dat);
(3) Firebird 2.5, the open-source DBMS
required by CAPE, which must be installed on
any PC that will hold a database file you plan to
access. Firebird 2.5 is required with CAPE 14
but, if you are a longtime CAPE user who has
installed InterBase previously, please check the
CAPE 14 Installation Instructions on this
subject before switching to Firebird. There is a
backward compatibility issue to be aware of.
Load the application files first, followed by the user files. Firebird may be installed
anytime from the CAPE CD.

CAPE 14 currently uses database schema 3.55, and the documentation is based on
this level.

A. Support for Multiple Versions of CAPE on Same PC

New versions of CAPE are available over the Internet every one to two months to
those holding a maintenance contract. Alternatively, you may request an update by
CD at any time. The present CAPE release, CAPE 14, uses a different location in
the registry than the CAPE 2010 version, and so it will co-exist with an earlier
version. However, if you ever need to have two versions of CAPE on the same PC at
the same time, you will need to set the CAPE environment variables within separate
xcape.bat files in each of your two user file directories to avoid conflicts between the
two versions. (CAPE 2010 and CAPE 14 do not share the same registry,
fortunately.) For example, if the previous version is now in \cape, you could install
the latest version in \cape_14 and create the file \cape_14\dat\xcape.bat with these
statements:

1
CAPE 14 Interface Basics CAPE Training Notes

set CapeHomeDir=c:\cape_14
set CapeUserDir=c:\cape_14\dat
set CapeConfigDir=c:\cape_14\dat
set CapeShortCutsDir=c:\cape_14\dat
set CapeHelpDir=c:\cape_14\help
c:\cape_14\progs\wcape.exe

Otherwise, it is not necessary to launch CAPE from a DOS window at all. The
installation procedure does not create an xcape.bat file.

B. Registry Items

The size, location and font information of most CAPE windows are saved in the
system registry under the key:

HKEY_CURRENT_USER\Software\Electrocon\CAPE

The sub key, Interface, contains settings for the Windows interface.

C. EII CAPE Directories

Electrocon files in all of the following directories are overwritten during installation
and changes made in delivered files by users will be lost during subsequent
installations. Files that you have created in these directories will not be touched.

auto_select popup command lists for each module with a graphics

window
cape_files CAPE configuration files, menus, shortcuts
ckt_breakers raw data files for low-voltage/molded-case circuit
breakers
doc online HTML help files
equip_damage macros for plotting transformer damage and inrush
curves
help full set of CAPE documentation in pdf format
macros collection of useful macros
op_forms examples of the available Order Production forms
progs all bus program executables and supporting dlls
rc_fault_set_files supporting macros for the Relay Checking fault set
definition command
rc_sensitivity_check_files supporting files for the RC check sensitivity command
reclosers raw data files for reclosers; now superseded by full
recloser models in the CAPE library
rs_selection_files relay selection macros
rs_set_alg_files sample relay setting algorithm macros
sql_procedures sample SQL procedures
ss_fault_macros supporting System Simulator macros

2
CAPE 14 Interface Basics CAPE Training Notes

II. Interface Features

CAPE has a multiple document interface. It is important to realize that there is

only one execution thread and all modules share only one set of internal data
structures. While you can have two or more modules visible at the same time, only
one of them will be active. For example, if RC is in the middle of a large study, you
won’t be able to switch to another module. Most commands operate on the active
window pane only. The active window pane will be highlighted. The current form of
highlighting is to lighten the background of a text area and to show the scroll bars
only for the active pane. You can switch between modules by clicking the tab of the
module or making a selection from the Cape Modules menu. The main window title
bar changes to reflect the active module.

Each text and graphics area of each module can be split into two or four panes, if you
wish. Highlight the window and then click Window | Split. The panes all use the
same fonts but can be scrolled to different locations. The panes can be “frozen”; that
is, not written or drawn to. A frozen pane cannot be scrolled until it is “unfrozen.”
Use the Window menu for this.

The number and size of the panes as well as the current font information are saved
in the registry for use the next time CAPE is started.

3
CAPE 14 Interface Basics CAPE Training Notes

A. Toolbar

Each module has a slightly different toolbar containing seven to ten small icons.
Tool-tip help messages are provided as you hover over an icon. Magnifying glass
icons with “+” and “-” change the graphics zoom level in a module.

1 2 3 4 5 6 7 8 9 10

The Short Circuit Toolbar comprises icons 1 to 10 above.

Use icon 1 to read the log file.

Use icon 2 to print the graphic window pane using the default graphic setup.
Use icon 3 to print the text window pane using the default text setup.
Use icon 4 to magnify a graphic.
Use icon 5 to make a graphic smaller.
Use icon 6 to return to the previous magnification.
Use icon 7 to draw the graphic so that it all fits in the available space.
Use icon 8 to apply a fault. (SC only)
Use icon 9 to re-enter the fault reporting loop. (SC only)
Use icon menu 10 to choose one of six predefined fault current displays. (SC only)

B. Action Bar

Each module has an Action Bar in which we have placed up to six of the most
commonly used commands of that module. (A second Action Bar is optional.) All the
commands may also be found in the regular menus above the bar, but this bar gives
one-click access. The example here is from the One Line Diagram module. The
contents of each button are under your control through the file “ActionButtons.txt”
in your \cape\cape_files directory. If you don’t like our choices, you are welcome to
customize this bar at your convenience.

C. Data Tree

All user network and protection data is compactly displayed and

easily accessed with an intuitive structure called the Data Tree.
Similar to the Windows Explorer tool for displaying folders and
files, the Data Tree offers a natural way to find, edit, or add data
without moving to the Database Editor. You search top-down
beginning with the substation associated with the equipment of
interest. (For large networks, click Search to start.) For example,
you might next expand the Buses choice by clicking the “+” box
next to that choice followed by one of the buses that have been

4
CAPE 14 Interface Basics CAPE Training Notes

revealed. (Choosing a bus will cause the OL diagram to center on that bus if the
switch in “Options” is toggled on.) You could then right-click the bus to obtain a
context menu of available actions for the bus, such as viewing or editing its data in
the database. Or, you could expand the “+” box beneath it for Lines and perform
similar actions on a line. When you click a particular title or network object, an
“Add” button at the top of the tree will allow you to add a new object of that type. To
delete an object, right-click on it, call up the edit form, and choose the “-” button at
the top of the form just as you would in the Database Editor.

Many of the same things can be done by clicking objects on a one-line diagram, of
course. The advantage of the Data Tree is that you never need a network diagram
to see your data. OL diagrams are good for working with parts of the network but,
owing to limited space on the screen, are less useful for displaying all the protection
devices and supporting equipment that may be at a given location. When the OL
diagram is integrated with the Data Tree, it could hardly be easier to interact with
your system. For details on Data Tree features, click Help | Help Table of
Contents | CAPE Introduction | Build a New Network Model (page 7).

D. Text Formatting

Use the pull-down list boxes to change the typeface or font size for the active pane.
Select the Bold button to use a bold font. The +/- symbols change the font size too.
This tool works in the CG graphics panes as well. When a text pane is active, the
size corresponds to a point size. When a CG or OL graphics pane is active, the size
is relative to the world coordinate system.

E. Command Line

While the command line can be toggled from the View menu, our strong
recommendation is to leave it visible. There are some infrequently used commands
without a pop-up dialog that require it.

1 2 3 45 6
Typed commands will automatically appear in the command line list box, 1. You can
select previously typed commands using the pull down arrow. You can also use the
up and down arrow keys, the Page Up and Page Down keys, and the <shifted> Home
and End keys. The command line automatically matches previously typed
commands. The visible command can be executed with the Enter key or the <<
(Process) button (2).

Command sequences can be terminated by typing an “x”, or clicking the X (Cancel)

button (3).

5
CAPE 14 Interface Basics CAPE Training Notes

Whenever the I (Interrupt) button (4) is active (it will be red), selecting it will cancel
the current operation.

Selecting the H (History) button (5), or typing <ctrl>h, will activate the Command
History dialog. The L (Lookup) button (6) turns the type-ahead feature on and off.

F. Command History

This resizable, modeless (active at the same time as CAPE) dialog can be positioned
to the side of the CAPE window. It contains a running list of all commands issued
including those typed into the command line as well as those from dialogs. The list
below resulted from selecting the OK button on the Short Circuit Preferences dialog.

To re-execute a single command from this list,

just double click on the desired command.

If you single click on a command, it is

transferred to the command line, where it can
be edited and then executed with the “<<”
(Process) button or the enter key.

You can select multiple commands by using

the well-known “<Ctl>-click” or “click <Shift>-
click” sequences with your mouse. They can
all be processed with the “Process Selected
Commands” button.

Multiple selections can also be saved as a

macro or file with the “Save Selected as a
Macro” and “Save Selected to a File” buttons.
You will be prompted for a macro name. The
entered name will appear in the
Macros&Sets/Run Macros list.

Use the “Clear” button to empty the list when

it becomes too long.

The “Hide” button will remove the form from

view, but not empty the list.

G. Status Bar

The status bar displays important messages on the left and displays the currently
attached database and one-line diagram on the right. The current cumulative

6
CAPE 14 Interface Basics CAPE Training Notes

number of OL diagram changes since the graphics file was last saved is also shown
there. Even though the Status Bar can be toggled from the View menu, our
recommendation is to leave it visible.

H. Standard Windows Menus

All CAPE modules have text and graphics areas and all have eight standard menus:
File, Shortcuts, Edit, View, Cape Modules, Graphics, Macros&Sets, and Window.
Except for Shortcuts, these menus are identical from module to module.

As in all Windows programs, the File Menu is a

starting place, providing support for: selecting a
database, reading data, selecting a OL diagram file,
input of files of commands, reading files, accessing
options, saving things like reports, and printing.

The Shortcuts
Menu is a user-
controlled menu.
You may insert
submenus and
commands
simply by making
entries in the file
\cape\dat\
xx_shortcuts,
where “xx” is the
two-letter
abbreviation for
the module, e.g., sc_shortcuts for Short Circuit. Files of
the same names are supplied by us in \cape\cape_files,
and contain commands to load and run many of the
useful macros we or other CAPE users have written.
The example here is from Short Circuit.

The Edit Menu contains commands specific to the scrollable

text area. You can also right click M2 in a text window to get
a context menu with similar commands.

7
CAPE 14 Interface Basics CAPE Training Notes

The View Menu allows one to toggle the

visibility status of all parts of the user
interface. The check mark indicates that
the item is currently visible.

The Cape Modules Menu lets you activate any CAPE

module. Normally, you bring up a module only the first time
this way and thereafter you would click the module tab to
bring it to the front.

If you right-click on a module tab, the context menu will let

you move the tab group to the left, right, or bottom.

The Graphics Menu contains the most commonly

used commands for working with a one-line diagram
that has already been created.

The Window Menu contains commands for arranging, tiling,

and splitting the on-screen windows.

8
CAPE 14 Interface Basics CAPE Training Notes

I. Online Help

The Help Menu contains features to search and select virtually all CAPE manuals,
the “How Do I...” directives, and the About Cape box. Clicking “Help Table of
Contents” leads to the list of on-line manuals, tutorials, and UGM handouts.
Clicking “How Do I...” lists common operations an infrequent user will find handy.
Each of the listed operations leads to a popup with step-by-step instructions.
Selecting the Help Search entry from the Help menu will activate the keyword
search feature that will find key phrases anywhere in the entire CAPE library
almost instantaneously.

The Help Table of Contents leads to the hyperlinked menu on the following page.

9
CAPE 14 Interface Basics CAPE Training Notes

Choosing Help Search yields this first form and then the second. Clicking any choice
pops up the actual document with the search phrase highlighted.

10
CAPE 14 Interface Basics CAPE Training Notes

Selecting the How Do I... entry from the Help menu leads to a list of commonly
performed functions specific to the presently active module. For example, in Short
Circuit, you would choose from this list:

and receive a popup like this that will float above your work as you perform the
steps.

11
CAPE 14 Interface Basics CAPE Training Notes

Selecting the About CAPE entry from the Help menu will activate the Help About
box. You can visit our web page or send us email from this dialog.

J. Configuration Files and User Preferences

CAPE reads a configuration file upon startup to set its options. There are actually
two files; one that we supply (|CapeHomeDir|\cape_files\cape.cfg) and an initially
empty one that you may edit (|CapeUserDir|\cape.cfg). The actual commands in
these configuration files have not changed from earlier versions (with a few
exceptions – see below). They can contain any valid CAPE command. The
configuration files are read when each module is started. The program scans
forward from the beginning of the file to find the bracketed module name, e.g., [SC]
when starting the Short Circuit module. CAPE will then process all the commands
it finds until the “return” statement. The section in the user configuration file for
each module contains these two strings:

%Auto Overwrite Area Begins

%Auto Overwrite Area Ends

When requested (by clicking “Set as Default” on a particular Preferences form or by

clicking the Executive | File | Save | Preferences command), CAPE will write the

12
CAPE 14 Interface Basics CAPE Training Notes

current values of all options for each module that has been initialized in between
these two lines.

Place commands that you do not want changed by Save | Preferences after this
block, but before the “return” statement.

Preferences (or Options, if you prefer that term) are accessed from the File |
Preferences menu of each module. You can also just click “Preferences” on the
Action Bar to activate the dialog.

K. Print Commands

Print Graphics Area and Print Text Area submenus are in the File menu. Each of
these has four commands: Page Setup, Print Preview, Print, and Print Direct. The
Page Setup popup contains the expected choices for printing in color, orientation
(portrait and landscape), and margin size. The print command will print the
contents of the graphics or text pane, as appropriate, after first popping up a
standard print menu. Print Direct avoids popping up that menu and, instead, prints
directly to the default device using default settings. The Print Graphics Area menu
has a fifth command, Copy to Clipboard, whose action is similar to the Print Scrn
key restricted to the graphics area.

L. Mouse Usage

Single click and hold the left mouse button for interactive dragging of objects. For
example, you may reposition a bus or text in the OL diagram with this technique.

Double click the left mouse button to edit data. For example, you may double-click a
transmission line in the OL diagram or its entry in the Data Tree to pop up the DBE
edit form for the line. Double click a displayed device characteristic in CG to
activate the appropriate change settings form.

Single click the right mouse button on an object to receive a list of actions for that
object. For example, you may right-click on a line and temporarily outage it by
selecting Network Changes | Outage Line from the context menu in SC.

Single click the right mouse button in the graphics area background to get a list of
miscellaneous commands for that module, e.g., Change displayed text [on the one-
line diagram].

Single click the right mouse button in the text area background to get a list of
commands specific to scrollable text areas.

There is a choice of methods for panning and zooming the drawing. You can decide
whether CAPE should pan the drawing when you press the left-mouse button down

13
CAPE 14 Interface Basics CAPE Training Notes

while dragging the mouse, or whether CAPE should perform a draw-zoom operation
to the outlined rectangle. You can also separately change the behavior of the mouse
scroll wheel. You can specify that mouse wheel movement either zooms in or out, or
scrolls the drawing up or down.

These modes are set by right-clicking on the diagram background in the OL module,
and selecting “Mouse Button and Scroll Wheel Modes” from the context menu.

• M1 Down and Drag: pans drawing (hand pointer). In this mode,

moving the mouse with the left mouse button pressed will pan the
drawing in the direction of the mouse movement.

• M1 Down and Drag: draws outlined rectangle (arrow pointer). In

this mode, moving the mouse with the left mouse button pressed will
outline a rectangle on the screen. When the mouse button is released, the
contents of the outlined rectangle will be redrawn, filling the screen.

For both of the above modes, the left mouse button must be pressed while the
pointer is on the drawing background, away from any object. If the pointer is over
an object, that object will be moved.

14
CAPE 14 Interface Basics CAPE Training Notes

• Scroll Wheel Rotation: zooms in/out about center. In this mode,

rotating the mouse wheel will zoom the drawing in or out about the center
of the view area regardless of where the cursor is. The Page Up/Down
keys will also zoom in or out.

• Scroll Wheel Rotation: zooms in/out about cursor. In this mode,

rotating the mouse wheel will zoom the drawing in or out about the cursor
location. The Page Up/Down keys will also zoom in or out.

• Scroll Wheel Rotation: scrolls drawing up/down. In this mode,

rotating the mouse wheel will scroll the drawing up or down. Pressing
the SHIFT key while rotating the wheel will scroll the drawing left or
right. The Page Up/Down keys will scroll the drawing up/down. Pressing
the SHIFT key in addition to the Page Up/Down keys will scroll the
drawing left or right.

• M3 (mouse wheel) Down & Drag: continuous pan. In this mode, the
scroll wheel is depressed while the user moves the cursor once to the left,
right, up or down to establish a direction of continuous window
movement. An arrow appears to show the direction of drawing
movement. If the initial cursor movement was just a small amount, the
movement is slow; if it was a large amount, the panning movement is
faster. Movement stops when M3 is released.

• M3 (mouse wheel) Down & Drag: single pan. In this mode, the
depressed scroll wheel will perform exactly like the “M1 Down and
Drag: pans drawing (hand pointer)” option described above.

15
CAPE 14 Interface Basics CAPE Training Notes

Regardless of the mouse or wheel modes currently selected, the following keys
always have these actions.

Key Action
Arrows Pan in direction of arrow
Home Zoom to Fit
[Ctrl] + i Zoom in
[Ctrl] + o Zoom out
[Ctrl] + [Shift] + left Center drawing under pointer and
mouse click zoom in
[Ctrl] + [Shift] + right Center drawing under pointer and
mouse click zoom out
[Ctrl] + mouse wheel Zoom in / out
[Shift] or [Ctrl] + left As you drag the cursor toward one of
mouse button down the graphics borders, the display will
pan slowly in the direction of the drag
motion. This is ideal for minor
adjustments.
Middle mouse button Causes the drawing to scroll in the
down direction of the mouse movement.
Scrolling continues until the mouse
button is released.

The left mouse button and scroll wheel modes are saved in the registry and any
changes become the default value when CAPE is restarted.

M. Executive Module Dialogs and Features

1. Edit Equipment Categories Dialog (Action Menu)

Categories are special labels that are defined by you with the Database Editor by
clicking System | Equipment Status Labels. If you assign components of your
network to one or more categories, you may tell CAPE how much of your network to
read whenever you attach a database or later click Setup_SC_Network (File
menu). The Session Setup form will let you tell CAPE which categories to include
and which ones to exclude. Exclusion always takes precedence when a network
component has been assigned both to included and excluded categories.

16
CAPE 14 Interface Basics CAPE Training Notes

Use this form to edit the assignments to equipment categories. First, select a
category and an equipment type.

Use the “Remove all...” button to remove all items from the selected category.

Use the “Add all...” button to add all items to the selected category.

You can also move only selected items. Select any number of items by clicking them.
The familiar <click><Ctl-click> and <click><Shift-click> sequences are very helpful
here. You can then use the “Remove selected...” or “Add selected...” buttons.

17
CAPE 14 Interface Basics CAPE Training Notes

2. Set Definition Dialog (Macros&Sets menu)

To define a set, first select the desired set type. You can edit an existing set by
selecting it from the list, or use the “New Set” button to define a new one. There are
three ways to add items to a set. The “Add One” button activates the appropriate
search form for adding items one at a time. The “Add Group” button activates a
form where one can build an expression, e.g., “Base_kV > 115”, or “Bus_Area = 2”,
for easily adding multiple items. Use the “Add Existing Set” to add the contents of
an existing set.

The requested changes are made immediately to the set, hence there is no OK or
Cancel button; select Done when finished.

Use the “List Set” button to list the contents of the currently selected set.

With the “Remove One,” “Remove Group” and “Remove Existing Set” buttons, items
can be removed from sets in the same manner in which they can be added.

Use the “Remove All” button to empty all items from a set, but retain the empty set.

Use the “Erase Set” button to completely remove a set.

The “Sort Bus Set” button allows an up-to-four-level sort of any bus set.

18
CAPE 14 Interface Basics CAPE Training Notes

3. Preferences

Each module has only one Preference dialog where all options can be viewed and
modified. The dialog is invoked from the File | Preferences command, or from the
Action Bar. The preferences can be saved to the user’s cape.cfg file by clicking “Set
as Default” on the form or from the File | Save | Preferences command. The latter
command will save the options for all modules that have been initialized.

19
CAPE 14 Interface Basics CAPE Training Notes

N. Coordination Graphics Module Dialogs and Features

1. Context Menus

Use mouse button 1 to identify and drag a device curve. Double click M1 to activate
the Change Settings Form. Lists of available actions that are relevant to the curve
are given in context menus that are activated by clicking mouse button 2 on a device
curve. The top part of the menu, above the separator, contains only labels. It is not
deactivated because doing so makes it hard to read, but selection of these labels is
ignored. Make a selection with either mouse button. You can press the Escape key
or click mouse button 1 elsewhere to remove the context menu without making a
selection. If you click M2 away from a device you will get a menu of miscellaneous
commands.

After clicking M2 on the zone 1 curve

20
CAPE 14 Interface Basics CAPE Training Notes

2. Colors and Styles Dialog

Use the tabs to change the various color and style values. To change a color value,
simply click on the colored button. Changes are not made until the OK button is
selected. The current colors and styles can be saved in a file with the “Save To File”
button. The default file suffix is “.cgc”. Saved files can be easily recalled with the
“Load From File” button. A file selected in this manner is automatically read into
and applied to CG, and the dialog is exited.

3. Magnifying a Graphic Display

Zoom operations are simple. Click and hold mouse button 1 at one corner of the
region you wish to enlarge; then drag the zoom box to the opposite corner and let go.
You may also enlarge in increments by using the magnifying glass icons:

The “plus” and “minus” magnifying glass operations may also be issued from the
keyboard with <Ctl>-I and <Ctl>-O. The empty magnifying glass reverts the display
to the previous magnification level. The boxed magnifying glass (Zoom-to-Fit)
displays the whole drawing within the available window.

21
CAPE 14 Interface Basics CAPE Training Notes

O. One-Line Diagram Module Dialogs and Features

The One-Line Diagram function is designed to allow you to build and maintain both
your network and protection system data together, graphically. For example, you
may add buses, transformers, relays, etc. by clicking the appropriate icons in the OL
toolbars, moving the mouse into the diagram, and “dropping” the component. See
the One-Line Diagram User Guide for instructions.

When using the OL diagram in other modules, such as Short Circuit, there are a
number of OL-related functions worth reviewing here. Access them from the
Graphics menu or the miscellaneous area context menu.

1. Colors and Styles Dialog

The OL Colors and Styles dialog is similar to the CG dialog described above. One
difference is that the default suffix for OL color files is “olc”.

2. Change Text Style Via Toolbar

One way to change the fault quantities displayed on the one-line diagram is to make
a quick choice from the Toolbar:

22
CAPE 14 Interface Basics CAPE Training Notes

3. Change Text Styles via Dialogs

Type <Ctrl>-T from the keyboard or right-click away from any object and choose
Change displayed text. The above form appears although you may have different
choices available. Click Edit Selection to change the label or text style file for any
item in the list. Click Advanced>> to define your own display:

Use the tabs to modify the text style for real buses, branches, etc. Select new values
to display by clicking the ? next to the Value box. To adjust its format, click in the

23
CAPE 14 Interface Basics CAPE Training Notes

Format field of interest and then click Format Help. Formats can be typed directly
by experienced users.

As a formatting example, the above form is for specifying the format of a real
number.

Text styles can be saved to a file or loaded from a file. The default file extension is
“olt”.

P. Short Circuit Module Dialogs and Features

1. The Reports | Bus Report dialog from the bus context menu is resizable and
contains a Print button. The dialog also remembers its location and size as
well as typeface and point size.

24
CAPE 14 Interface Basics CAPE Training Notes

2. CAPE enters a bus reporting loop after a fault has been applied using the
menus or by clicking Reports | Bus. It has this dialog:

3. The Apply Fault dialog allows specification of fault impedance for selected
faults. The impedance can be specified for line-to-line, double-line-to-ground,
single-line-to-ground, and three-phase faults. Additionally, the faulted
phases can be specified for line-to-line, double-line-to-ground, and single-line-
to-ground faults. To see user-created fault definitions, click the box “Show
Advanced Faults.”

25
CAPE 14 Interface Basics CAPE Training Notes

4. You may plot a relay characteristic for the current fault from a one-line
diagram in SC of SS by using a choice in the context menu for lines. You will
see it if you right click on a transmission line and then click Coordination
Graphics Actions | Display Device Curves | Initialize CG Display.
This will cause control to be passed to CG, and the element search form to be
initialized with LZOP’s for the selected branch.

5. Graphics Menu

The Graphics menu is shared by all modules.

Note that the draw and zoom commands work on the active pane only. Some user
actions, like dragging a bus, result in an automatic “Refresh_All_Panes” command.

26
CAPE 14 Interface Basics CAPE Training Notes

Q. Keyboard Shortcuts (“Hot Keys”)

Keyboard shortcuts provide a quick way to issue commands from the one-line
diagram and are controlled by the Global Preference, Keyboard_Shortcuts. When
“On,” and an object is highlighted on the one line diagram, single typed characters
are interpreted as commands. When “Off,” or when no object is identified, typed
characters are sent to the command line. Actions are for all modules unless
specified. The following characters are recognized:

Highlighted Character Action Module

Object
Bus T three-phase fault
S single-phase fault
D double line ground fault
L line to line fault
r rotate clockwise 90° if bus is detailed; OL
regular buses change from vertical to
horizontal
R rotate counterclockwise 90° if bus is detailed; OL
regular buses change from vertical to
horizontal
Bus tie I or C Close
O Open
Logical I or C Close
breaker
O Open
Transformer I or C close all windings
O open all windings
Shunt I or C Restore
O Outage
Line I or C Restore
O Outage
M insert midline node
T three-phase midline fault
S single-phase midline fault
D double line ground midline fault
L line to line midline fault
P add point to line segment OL
Fault symbol V vary fault impedance
R remove fault
S simulate fault SS
Point on line D delete point OL

27
CAPE 14 Interface Basics CAPE Training Notes

III. Updating CAPE

A. Updating the CAPE Program

CAPE is always delivered initially on a CD. An authorized user will have all CAPE
files (data and program) following an initial installation. Meanwhile, Electrocon is
continually adding new features, relay models, corrections, etc. as time goes on.
How can a CAPE customer receive these updates? The best and fastest way today is
to download new versions of CAPE over the Internet. Any customer whose company
holds either the initial year warranty or a subsequent maintenance and upgrade
service agreement is entitled to download newer versions or to request a new CD
from Electrocon, if Internet downloads are not convenient, i.e. not permitted by the
almighty IT group’s policies. However, Internet access is available to most users.

The program |CapeHomeDir|\progs\update_cape.exe can be used to update your

CAPE installation to a newer version. This program is normally invoked from the
CAPE program group by clicking Check for CAPE update on the Internet.

The update process begins when the user clicks the Check For Update button on
the update program. The basic process is as follows:

28
CAPE 14 Interface Basics CAPE Training Notes

1. The update program checks to see if update files already exist in

|CapeHomeDir|\updates. If these files do exist, and they are newer than
your existing CAPE installation, then the update program will offer to install
these existing updates. This process can be done without Internet access.

2. After installing any existing updates, the update program sends your
company name+registration key to the CAPE update server
(capeupdates.com). If your company has an up-to-date maintenance contract,
then the update server returns a session key.

3. Using the session key, the update program downloads an updated copy of
|CapeHomeDir|\updates\updates_14.txt. This is a list of names and dates
of the program files that are in the newest version of CAPE.

4. A comparison is then made between the files referenced in updates_14.txt

with the files located in |CapeHomeDir|\*.

5. If updates_14.txt references files with a newer date than those found in your
CAPE installation, then the user is shown a screen allowing selection of the
desired updates.

The first 2 items “CAPE Miscellaneous” and “CAPE Program Files” are
required, so they cannot be de-selected. The other items are optional.

6. The update program then downloads a copy of each required file from the
CAPE update server. The files are downloaded in ZIP format, and are stored
in |CapeHomeDir|\updates\*. The structure of
|CapeHomeDir|\updates\* will parallel the structure of
|CapeHomeDir|\*.

7. After all newer files are downloaded, a check is performed to make sure that
the update program has sufficient file permissions to replace your outdated
files with new ones.

29
CAPE 14 Interface Basics CAPE Training Notes

8. If no problems are detected, then the update program will offer to install the
new updates. The “install” is a simple file replacement. The new ZIP files
are un-zipped, and the new file is copied over your existing outdated file.

1. Troubleshooting:

If you have an Internet connection and a valid CAPE maintenance contract, then
you should be able to download updates.

If you have a direct connection to the Internet (no proxy server), then you should not
need to make any configuration changes to the update program. However, if your
connection to the Internet goes through a proxy server, then you may need to supply
additional proxy information. This information can be entered on the “Connection
Configuration” screen.

Information about your proxy server can be entered in the “Proxy Settings” region
on the right side of the screen. The proxy information is company-specific, so you
may need to contact your IT department for assistance. Sometimes, the update
program is able to detect the proxy “host” and “port,” and all you need to supply is a
user name and password. Usually, the same user name and password as you use to
login to Windows will work here. After entering valid proxy information, you should
be able to click “Test Connection” and see the message “Connection test to
"http://capeupdates.com/" was successful!”. Once this connection is successful, you
should be able to “Check For Update” in the main update screen and successfully
download updates.

30
CAPE 14 Interface Basics CAPE Training Notes

2. Updating CAPE when you don’t have Internet access:

If you have CAPE installed on a machine that does not have Internet access, you can
still update CAPE. To do this, you must have at least ONE machine that has
Internet access and can download the updates.

- Download the updates on the machine that has Internet access. After
downloading the files, the directory |CAPEHomeDir|\updates will contain a set
of updated files in ZIP format.

- Copy the entire |CAPEHomeDir|\updates folder from the successfully updated

machine to another machine that does not have Internet access.

- Run update_cape on the machine without Internet access. It will detect that new
files exist in the |CAPEHomeDir|\updates folder, and it will offer to install
them for you, without requiring Internet access.

3. Updating CAPE when you have multiple copies installed:

When update_cape runs, it needs to know where the CAPE installation is located so
it can update the correct files. It determines this by looking in the system registry,
and reading the CAPEHomeDir value. If you have more than one copy of CAPE
installed, then you must manually override this value for one of the installations.
This can be done easily if you run update_cape from a command prompt, and specify
some additional information.

update_cape /home c:\cape_copy_2

The command-line switch “/home” will force update_cape to consider

“c:\cape_copy_2” to be the location of CAPE that you want to update.

4. Updating CAPE in unattended mode:

The update_cape program does support some command line options. This means
you could set up a script that would run periodically and at a time that is convenient
for you. The following are the command line options available to you.

Option Explanation
/reg <value> Specifies the registry key
\HKCU\Software\Electrocon\<value> - used if you want to
have multiple company/registration key values stored and
use a specific one.
/home <directory> Changes location of "CAPEHomeDir". Can be used when
multiple copies of CAPE are installed and you want to
update a specific one.
/help <directory> Makes \cape\help file updates go to this directory. Useful if
your help is somewhere other than \cape\help.

31
CAPE 14 Interface Basics CAPE Training Notes

/updatedir <directory> Specifies the directory to use in place of \cape\updates.

/nonet Forbids internet access. Used when updating from a pre-
existing \cape\updates directory and you specifically don't
want to hit the "real" update site.
/force Tells the program to download EVERY file that is available,
even if you already have an up-to-date copy.
/proxy_host <value> Sets the proxy host.
/proxy_port <value> Sets the proxy port.
/proxy_userid <value> Sets the proxy user.
/proxy_password <value> Sets the proxy password.
/go Simulates a click on the "check for updates" button
immediately when the program runs.
/automatic Similar to /go, but no user interaction is needed. Program
will download/apply updates/close all automatically.

B. Updating the Database Schema

New features often require enhancement of the internal structures of a CAPE

database. For example, new data fields within some existing tables may be needed
to hold the data that will support the new feature. Rarely, a whole new table could
be required. Each user’s CAPE database is self-contained. That is a great
convenience, but how can it be updated?

As you might expect, we provide a special program to do this. The changes to be

made in the internal structures of your database are normally proscribed in a file
(CAPESchema.gdb) that the Internet update of CAPE gave you.

Here are the steps for updating the schema of your database:

1. The first step is always to make a safe copy of your database. This
protects you if something goes wrong during a schema update. One
reason for something going wrong has been special security
restrictions a user may have imposed independently and which block
the update_schema program.

2. Click Start | Programs | CAPE | Update Schema. You will see

this pop-up:

32
CAPE 14 Interface Basics CAPE Training Notes

Enter “SYSDBA” for the User Name and enter “masterkey” for the
Password. This universal user name and password will work unless
your company has implemented the additional security features that
Firebird supports.

3. You will see the Update_Schema program form similar to the one
below. Using the indicated button, search for and choose the database
to be updated. Likewise, using the down-arrow button, choose the
schema level to be applied. Normally, the form will be showing you
the recommended schema level already; you won’t actually have to
choose it. Then click Update.

You will be reminded to make a copy of your database before

proceeding. Woe to you who ignore this warning. You may well
receive the dreaded “Your database is toast” message. It’s not, of
course. We can almost always fix a partially updated database, but
we’d rather be doing something more productive!

4. The update process may take several minutes depending partly on

the size of your database. When the update is complete, the form will
look like this:

33
CAPE 14 Interface Basics CAPE Training Notes

C. Updating Your Relay Library

A CAPE database is a self-contained body of data sufficient to run virtually all

CAPE functions. This includes the detailed models of the relays you are using. If
every database had all the relay models in our master library, it would be wasting a
lot of disk space. Instead, you should have in your database library only the relays
you actually use. How do they get in there in the first place?

The answer is, you import what you need from our master library,
\cape_14\cape_files\masterlibrary.fdb. In addition to economizing on space, this
technique provides a simple way for you to obtain corrected or enhanced data models
in the future. The import procedure explained here is ideal for both importing new
models and overwriting old ones. Instances of relays that you have placed in your
network model are immediately updated because they all point to their counterparts
in your db library.

1. To import relays, invoke the Database Editor. Then click Library

| Import | Relay Catalog.

34
CAPE 14 Interface Basics CAPE Training Notes

2. You will be prompted to choose a source database, which is

normally \cape_14\cape_files\masterlibrary.fdb, but may be any
database that has the model you want.

3. Then you will receive a relay search form like the one below:

35
CAPE 14 Interface Basics CAPE Training Notes

Choose the Manufacturer, Relay Type, and then either the Relay
Model or the Relay Model and Relay Style that you wish to import. If
you choose a Model, you will import all the Styles below it and all the
information at the higher levels needed to support them. It is often
more economical to simply choose the single Style you need. (If you
overdo it, be advised there is a Library Liposuction command you can
apply later to trim the fat.)

4. For each import you conduct, the DBE log file will appear to report
the progress. Except for certain overweight digital relays, the import
will be a matter of seconds.

36
CAPE 14 Interface Basics CAPE Training Notes

IV. Reporting Bugs

The easiest way to report a program malfunction is to send an email with the details
to:
[email protected]

Give us your name, company, and telephone number in addition to the email
address that will be part of your email. Remember, we can’t help much if we can’t
reproduce what you have experienced. The following information can be important:

(a) Description of what happened.

(b) What commands you had just entered or actions you did before the bug
appeared.
(c) Any messages received from CAPE at the time of the bug.
(d) We may ask for your log file. If the program is still running after the bug,
click File | Copy Log. This lets you save the present log file in a safe
place if we need it.
If the program has bombed out, do not restart it until you have copied the
file \cape\dat\temp\ex_log0 to a safe place. Restarting CAPE
automatically overwrites the log file.
(e) We may need to ask for a zipped copy of your database.

37