You are on page 1of 162

Instruction

Conductor Series

Grafx Display Editor

Preface
This instruction covers the configuration and operation of the
1.6, 2.3, and 3.2 versions of the Grafx editor. Grafx is used to
configure graphic models for Conductor NT and Process Portal
human system interfaces (HSI).
NOTE: Features that apply to just one or two versions of Grafx are designated
accordingly. Features not specifically marked apply to all versions of Grafx.

WBPEEUI340020B1

List of Effective Pages


Total number of pages in this instruction is 156, consisting of the following:
Page No.

Change Date

Preface
List of Effective Pages
iii through xii
1-1 through 1-3
2-1 through 2-80
3-1 through 3-13
4-1 through 4-6
A-1 through A-30
B-1 through B-8
C-1
Index-1 through Index-3

Original
Original
Original
Original
Original
Original
Original
Original
Original
Original
Original

NOTE: Changed text or tables are indicated by a vertical bar adjacent to the changed area. Changed figures are indicated by a vertical bar next to the figure caption. The date appears beside the page number.

WBPEEUI340020B1

Table of Contents
Section 1 Introduction ..................................................................................................1-1
Overview .................................................................................................................. 1-1
Intended User .......................................................................................................... 1-1
How to Use this Instruction...................................................................................... 1-1
Installation .............................................................................................................. 1-1
Document Conventions ............................................................................................ 1-2
Glossary of Terms and Abbreviations ....................................................................... 1-2

Section 2 Description and Operation .........................................................................2-1


Introduction............................................................................................................. 2-1
Accessing the Grafx Editor ....................................................................................... 2-1
Exiting the Grafx Editor ........................................................................................... 2-2
Standard Color Palette ............................................................................................. 2-2
Position 0 to 31 .................................................................................................... 2-2
Position 32 to 95 .................................................................................................. 2-2
Position 96 to 255 ................................................................................................ 2-3
Position 256 to 511 .............................................................................................. 2-3
Position 512 to 998 .............................................................................................. 2-3
Creating Models ....................................................................................................... 2-3
Toolbar Buttons ................................................................................................... 2-4
Model Creation Environment ................................................................................ 2-4
Opening a Window ........................................................................................... 2-5
Multiple Windows ............................................................................................. 2-5
Working View ................................................................................................... 2-6
Working View Grid............................................................................................ 2-6
Snap Mode ....................................................................................................... 2-6
Aligning Multiple Objects.................................................................................. 2-7
Select Mode ...................................................................................................... 2-7
Redrawing the Working View ............................................................................ 2-8
Adjusting the View (Zoom/Pan)......................................................................... 2-8
Zoom Operations - In, Out, Pick, Fit, Default .................................................... 2-9
Toolbars................................................................................................................. 2-10
Status Bar ............................................................................................................. 2-10
Shape Toolbar........................................................................................................ 2-11
Fill Mode Button ................................................................................................ 2-11
Straight Lines..................................................................................................... 2-11
Rectangles.......................................................................................................... 2-12
Circles................................................................................................................ 2-12
Markers ............................................................................................................. 2-13
Polylines ............................................................................................................ 2-13
Splines............................................................................................................... 2-14
Closed Splines.................................................................................................... 2-15

WBPEEUI340020B1

iii

Table of Contents (continued)


Section 2 Description and Operation (continued)
Creating Arcs......................................................................................................2-15
Polygons .............................................................................................................2-16
Text Objects........................................................................................................2-17
Text Rectangles...................................................................................................2-18
Submodels..........................................................................................................2-18
Design ............................................................................................................2-19
Running..........................................................................................................2-19
Human System Interface.................................................................................2-20
Finding Submodels .........................................................................................2-20
Creating Submodel Instances..........................................................................2-21
Bitmap Image Files (Grafx Version 2.3 and 3.2 Only) ..........................................2-21
Accessing ........................................................................................................2-21
Importing ........................................................................................................2-22
Configuring Object Graphic Attributes ....................................................................2-22
Settings Window .................................................................................................2-23
Setting the Fill Attributes ................................................................................2-23
Fill Pattern......................................................................................................2-23
Fill Color.........................................................................................................2-24
Line ................................................................................................................2-24
Text ................................................................................................................2-24
Background Color ...........................................................................................2-25
Grid Attributes................................................................................................2-26
Properties Window ..............................................................................................2-27
Selecting and Manipulating Objects ........................................................................2-27
Selecting Individual ............................................................................................2-28
Selecting Multiple ...............................................................................................2-28
Grouping and Ungrouping .................................................................................2-28
Depth and Grouped ...........................................................................................2-29
Extent ................................................................................................................2-29
Moving................................................................................................................2-29
Copying ..............................................................................................................2-30
Scaling ..............................................................................................................2-30
Changing a Reference Point ................................................................................2-30
Rotating..............................................................................................................2-31
Changing the Drawing Order ..............................................................................2-31
Mirroring ............................................................................................................2-32
Deleting ..............................................................................................................2-33
Object Point Operations..........................................................................................2-33
Moving (Point Mode)............................................................................................2-33
Changing ............................................................................................................2-34
Adding ................................................................................................................2-34
Deleting ..............................................................................................................2-35

iv

WBPEEUI340020B1

Table of Contents (continued)


Section 2 Description and Operation (continued)
Object Placement Example ..................................................................................... 2-35
Menu Bar............................................................................................................... 2-36
Graphic and Submodel Files .............................................................................. 2-36
File Menu........................................................................................................... 2-37
Opening Files ................................................................................................. 2-37
Saving Files - Save and Save As ...................................................................... 2-38
Set To Running .............................................................................................. 2-38
Applying Submodel Changes .......................................................................... 2-38
Cross Reference.............................................................................................. 2-39
Deleting a Model............................................................................................. 2-39
Remove from Running .................................................................................... 2-40
Favorites (Grafx Version 3.2 Only) .................................................................. 2-41
Edit Menu .......................................................................................................... 2-41
Undoing and Redoing ..................................................................................... 2-42
Selecting Objects ............................................................................................ 2-42
Specifying Model Type .................................................................................... 2-42
Using Model Variables ........................................................................................ 2-42
Window Operations................................................................................................ 2-43
Dynamics............................................................................................................... 2-43
Configuring Dynamic Attributes ......................................................................... 2-44
Configuring the Expression ............................................................................ 2-45
Expression True ............................................................................................. 2-48
Grouped Objects and Expressions .................................................................. 2-48
Multiple Expressions ...................................................................................... 2-49
Dynamic Attribute Settings............................................................................. 2-50
Configuring Submodels ...................................................................................... 2-58
Custom Dynamics .............................................................................................. 2-59
Creating Custom Dynamics ............................................................................ 2-59
DynProp Syntax ............................................................................................. 2-60
DynProp Examples ......................................................................................... 2-62
Configuring Model Variables ........................................................................... 2-62
Declaring Variables in Submodels .................................................................. 2-65
Naming Variables ........................................................................................... 2-65
Dynamic Configuration Examples....................................................................... 2-68
Example 1 - Single Expression........................................................................ 2-69
Example 2 - Multiple Expressions................................................................... 2-69
Example 3 - Using the True Expression .......................................................... 2-70
Example 4 - Creating a New Submodel with Dynamics ................................... 2-70
Example 5 - Configuring Dynamic Submodels ................................................ 2-71
Example 6 - Simulating Motion Using the Blink Attribute ............................... 2-71
Example 7 - Using Text to Indicate Conditions................................................ 2-74
Example 8 - Model Port Development.............................................................. 2-75

WBPEEUI340020B1

Table of Contents (continued)


Section 2 Description and Operation (continued)
HSI Submodels.......................................................................................................2-76
Faceplate Submodels..............................................................................................2-77
Expressions as Submodel Variables........................................................................2-77
HSI Symbols...........................................................................................................2-79
Custom Models for Point and Group Displays .........................................................2-79

Section 3 Example Configuration ...............................................................................3-1


Introduction .............................................................................................................3-1
Process Operation ....................................................................................................3-1
Assumptions and Conditions ....................................................................................3-2
Display Configuration...............................................................................................3-2
Create Model ........................................................................................................3-3
Insert Mixing Tank................................................................................................3-3
Insert Valves.........................................................................................................3-4
Insert Pumps ........................................................................................................3-4
Insert Agitator ......................................................................................................3-4
Draw Pipes ...........................................................................................................3-5
Configure Pipes.....................................................................................................3-6
Configure Pump 1-1..............................................................................................3-6
Configure Pump 1-2..............................................................................................3-7
Configure Valves...................................................................................................3-7
Configure Agitator.................................................................................................3-8
Configure Mixing Tank..........................................................................................3-8
Enter Text ............................................................................................................3-9
Configure Value Monitoring ................................................................................3-11
Conclusion .........................................................................................................3-13

Section 4 DynProp Code ..............................................................................................4-1


Introduction .............................................................................................................4-1
Dynamic Actions ......................................................................................................4-1
Formatting Strings ...................................................................................................4-4
Expression Operators ...............................................................................................4-5
C-Library Functions .................................................................................................4-6

Appendix A Graphics Submodels .............................................................................. A-1


Introduction ............................................................................................................ A-1
FP_DYbargraph ....................................................................................................... A-2
FP_DYbargraph_ec .................................................................................................. A-3
FP_DYctrlpb ............................................................................................................ A-4
FP_DYdial................................................................................................................ A-4

vi

WBPEEUI340020B1

Table of Contents (continued)


Appendix A Graphics Submodels (continued)
FP_DYentertextpb .................................................................................................... A-5
FP_DYentervaluepb .................................................................................................. A-6
FP_DYgroupmod ...................................................................................................... A-6
FP_DYHisttrend ....................................................................................................... A-7
FP_DYHorizbar......................................................................................................... A-7
FP_DYHoriztrend ..................................................................................................... A-8
FP_DYhslider ........................................................................................................... A-9
FP_DYmeter ........................................................................................................... A-10
FP_DYmpoppb ....................................................................................................... A-11
FP_DYpointmod ..................................................................................................... A-12
FP_DYpump_lf ....................................................................................................... A-12
FP_DYpump_rt....................................................................................................... A-13
FP_DYput1pb......................................................................................................... A-15
FP_DYputpb........................................................................................................... A-15
FP_DYputpbstat..................................................................................................... A-17
FP_DYputpbstat2 ................................................................................................... A-18
FP_DYstatpb .......................................................................................................... A-19
FP_DYtagpb ........................................................................................................... A-20
FP_DYtank............................................................................................................. A-21
FP_DYtank_ec ........................................................................................................ A-22
FP_DYtoggle ........................................................................................................... A-23
FP_DYTrendpb ....................................................................................................... A-24
FP_DYvalue............................................................................................................ A-24
FP_DYvectorpb....................................................................................................... A-25
FP_DYVertbar ........................................................................................................ A-26
FP_DYverttrend...................................................................................................... A-27
FP_DYvslider.......................................................................................................... A-29
FP_DYwheel ........................................................................................................... A-30

Appendix B Symbols ................................................................................................... B-1


Introduction.............................................................................................................B-1
Symbol Illustrations.................................................................................................B-4

Appendix C Faceplates and Point Displays .............................................................. C-1


Introduction.............................................................................................................C-1

WBPEEUI340020B1

vii

List of Figures
No.

2-1.
2-2.
2-3.
2-4.
2-5.
2-6.
2-7.
2-8.
2-9.
2-10.
2-11.
2-12.
2-13.
2-14.
2-15.
2-16.
2-17.
2-18.
2-19.
2-20.
2-21.
2-22.
2-23.
2-24.
2-25.
3-1.
3-2.
3-3.
3-4.
A-1.
A-2.
A-3.
A-4.
A-5.
A-6.
A-7.
A-8.
A-9.
A-10.
A-11.
A-12.
A-13.
B-1.

viii

Title

Page

Example Grafx Editor Display Window.......................................................2-4


Toolbar Buttons ........................................................................................2-5
Straight Line ...........................................................................................2-11
Rectangle ................................................................................................2-12
Circle ......................................................................................................2-13
Markers...................................................................................................2-13
Polylines..................................................................................................2-14
Spline......................................................................................................2-14
Closed Spline ..........................................................................................2-15
Arc ..........................................................................................................2-16
Polygon ...................................................................................................2-16
Text Object ..............................................................................................2-17
Text Rectangle .........................................................................................2-18
Submodel Selection Window ....................................................................2-19
Import Bitmap File Window .....................................................................2-22
Settings Window......................................................................................2-23
Object and Mirrored Copy........................................................................2-32
Object and Inverted Copy ........................................................................2-33
Object Placement Example ......................................................................2-36
Open Model Window ................................................................................2-37
Remove Model From Running Window .....................................................2-40
Edit Custom Dynamics Window...............................................................2-60
Submodel Variable Configuration Window ...............................................2-72
Pushbutton Submodel .............................................................................2-76
Model Ports Example ...............................................................................2-76
Layout of Example Process ........................................................................3-1
Example Model (Partially Complete) ...........................................................3-6
Example Model (Mostly Complete)............................................................3-11
Example Model (Complete).......................................................................3-13
Dynamic Bar Graph (FP_DYbargraph)....................................................... A-2
Dial Submodel (FP_DYdial) ....................................................................... A-4
Dynamic Horizontal Bar (FP_DYHorizbar) ................................................. A-7
Horizontal Trend Submodel (FP_DYHoriztrend) ......................................... A-8
Meter Submodel (FP_DYmeter)................................................................ A-10
Dynamic Pump - Left (FP_DYpump_lf)..................................................... A-12
Dynamic Pump - Right (FP_DYpump_rt) ................................................. A-14
Dynamic Tank Submodel (FP_DYtank).................................................... A-21
Dynamic Value (FP_DYvalue) .................................................................. A-25
Dynamic Vertical Bar (FP_DYVertbar)...................................................... A-26
Vertical Trend Model (FP_DYVerttrend) ................................................... A-28
Vertical Slider Submodel (FP_DYvslider).................................................. A-29
Dynamic Wheel (FP_DYwheel) ................................................................. A-30
Non ISA Symbols ...................................................................................... B-4

WBPEEUI340020B1

List of Figures (continued)


No.

B-2.
B-3.
B-4.
B-5.
B-6.
B-7.
B-8.

Title

Page

Valves and Actuators ................................................................................B-5


Containers and Vessels .............................................................................B-5
Rotating and Reciprocating Equipment .....................................................B-6
Mixing and Material Handling Equipment .................................................B-6
Electrical Equipment.................................................................................B-7
Filters, Scrubbers, Precipitators and Separators........................................B-7
Heat Transfer Devices and HVAC Equipment ............................................B-8

List of Tables
No.

1-1.
2-1.
2-2.
2-3.
2-4.
2-5.
2-6.
2-7.
2-8.
2-9.
2-10.
2-11.
2-12.
2-13.
4-1.
4-2.
4-3.
4-4.
A-1.
B-1.
B-2.
B-3.
B-4.
B-5.
B-6.
B-7.
B-8.
B-9.

WBPEEUI340020B1

Title

Page

Terms and Abbreviations .......................................................................... 1-3


32 to 95 Range of Colors ........................................................................... 2-2
View Size Information ............................................................................... 2-8
View Size Information ............................................................................... 2-9
Process Portal Submodel Types ............................................................... 2-37
Operator Usage - Description and Examples ........................................... 2-45
Operators in Order of Precedence ............................................................ 2-47
Operator Aliases ..................................................................................... 2-48
Attribute Default Value ........................................................................... 2-52
Attribute Default Value ........................................................................... 2-52
Blink Settings ......................................................................................... 2-72
Input Conditions..................................................................................... 2-74
Expressions and Settings ........................................................................ 2-74
Blink Settings ......................................................................................... 2-74
Dynamic Actions ....................................................................................... 4-1
Formatting Control Codes ......................................................................... 4-4
Expression Operators................................................................................ 4-5
Standard C Library Functions ................................................................... 4-6
Process Portal Submodel Types ................................................................. A-1
Values and Actuators................................................................................B-1
Containers and Vessels .............................................................................B-2
Rotating Equipment (Pumps and Blowers).................................................B-2
Reciprocating Equipment ..........................................................................B-2
Mixing Equipment.....................................................................................B-2
Material Handling Equipment ...................................................................B-3
Electrical Equipment.................................................................................B-3
Filers ........................................................................................................B-3
Scrubbers and Precipitators ......................................................................B-3

ix

List of Tables (continued)


No.

B-10.
B-11.
B-12.
B-13.
C-1.

Title

Page

Separators................................................................................................ B-3
Heat Transfer Devices............................................................................... B-4
HVAC Equipment ..................................................................................... B-4
Miscellaneous........................................................................................... B-4
Harmony Faceplate Submodels................................................................. C-1

WBPEEUI340020B1

Support Services

ABB will provide assistance in the operation and repair of its


products. Requests for sales or application services should be
made to your nearest sales or service office. ABB can also
provide installation, repair and maintenance contract services.
When ordering parts, use nomenclature or part numbers and
part descriptions from equipment manuals. Parts without a
description must be ordered from the nearest sales or service
office. Recommended spare parts lists, including prices are
available through the nearest sales or service office.
ABB has modern training facilities available for training your
personnel. On-site training is also available. Contact your
nearest ABB sales office for specific information and
scheduling.
Additional copies of this instruction, or other instructions, can
be obtained from the nearest ABB sales office at a reasonable
charge.

WBPEEUI340020B1

xi

Trademarks and Registrations


Registrations and trademarks used in this document include:
Windows
Composer
Symphony

xii

Registered trademark of Microsoft Corporation.


Trademark of ABB.
Trademark of ABB.

WBPEEUI340020B1

Introduction

Section 1

Overview
The Grafx editors are used to create process graphic displays
for Conductor NT and Process Portal human system interfaces
(HSI). Process graphic displays provide a graphical interface to
the process, and a convenient, efficient way to access process
data and perform control operations. Animated process graphics can be configured using a Grafx editor. The Grafx editor is
also used for interactive creation of static background,
dynamic display points, control points, and display vectoring.

Intended User
This instruction is intended for use by personnel engaged in
the development of Conductor NT and Process Portal graphics.
Familiarity with the ABB control systems is necessary.

How to Use this Instruction


To attain optimum use of all available features and functions,
it is important to become familiar with the entire contents of
the instruction before configuring a human system interface
display.
This instruction limits the information presented in each section to only specific items required to complete the desired
task. The organization enables finding specific information
quickly, and permits using this instruction as a reference after
becoming fully familiar with Grafx editors.

Installation
Choose the appropriate option during software installation to
load the Grafx editor.

WBPEEUI340020B1

1-1

Document Conventions

Document Conventions
This document uses standard text conventions to represent
keys, display items and user data inputs:
Display item

Any item displayed on a screen appears as italic text. Example:


Running

User data input

Bold - Identifies any part of a command line that is not


optional or variable and must be entered exactly as shown.
Italic - Identifies a variable parameter entered in a command
line.
[ ] - Indicates an optional parameter; text within the brackets
follows the previously described conventions.
Example:
CUP [port] [baud] [file_name.CSP]
SPECIAL KEYS - Identifies a specific key that is not alphabetic,
numeric or punctuation. Examples:
Press ENTER.
Press ESC V M. (Press and release each key in sequence.)
Press CTRL-ALT-SHIFT-DEL. (Press all keys in sequence without
releasing any one key until you have pressed them all.)

File names

Name - Indicates a file or directory name. Example:


file1.exe
c:\new

Revision variable

A ? indicates a value that may change depending on the version of an item. Example:
Part number: 1234567?0
Part number: 1234567??

Glossary of Terms and Abbreviations


Table 1-1 contains those tTerms and abbreviations that are
unique to ABB or have a definition that is different from
standard industry usage are listed below..

1-2

WBPEEUI340020B1

Glossary of Terms and Abbreviations


Table 1-1. Terms and Abbreviations
Term
Atom

Definition
A single data element in a server tag. Atoms can exist in various forms,
including (but not limited to) a single bit (auto/manual), a floating point number,
a tag name or a multi-character legend; there is no predefined limit to the size
of an atom.

Control module

Directs field processes through an I/O module.

GMS

Graphical modeling system. GMS is used to create system graphical displays.

Model

When used in the graphical context of GMS, a model is an object or group of


objects. Models can be used as objects in other models.

Object

When used in the graphical context of GMS, an entity such as a circle,


rectangle, or text field.

Symbol

A drawing element. Using symbols for commonly used drawing elements


eliminates redrawing.

WBPEEUI340020B1

1-3

WBPEEUI340020B1

Description and Operation

Section 2

Introduction
Process graphic displays provide a graphical interface to the
process, and a convenient, efficient way to access process data
and perform control operations. Animated process graphics
can be configured using the Grafx editors. The Grafx editors
are used for interactive creation of static background, dynamic
display points, control points and display vectoring.
Graphics are configured in a two-step process: first, static
objects such as circles, lines, rectangles and text strings are
placed on the display, creating a model. Various dynamic
attributes, such as visibility, fill color, and edge color, can then
be assigned to any object (or combination of objects) on the
graphic. These dynamic attributes can be linked to atoms configured in the human system interface (HSI) database. A
change in the status of an atom can then trigger a visible
change in the graphical object.
A model can be saved as either a graphic or a submodel, once
saved submodels can be used and reused as objects within
other models as needed.
Both the placement of graphic objects and assignment of
dynamic attributes are accomplished using the Grafx Editor.
This application maintains visual and functional consistency
with other Windows based applications currently available.
Many Windows 2000 commands and shortcuts are available in
the Grafx editors.

Accessing the Grafx Editor


The Grafx editors are accessed from several ABB applications.
However accessed, the appropriate Grafx editor will be displayed. Only one type of Grafx editor application can be loaded
at a time but multiple instance of the application are possible.

WBPEEUI340020B1

2-1

Exiting the Grafx Editor

Exiting the Grafx Editor


To exit a Grafx editor, select File > Exit. If no changes have
been made to the current model, the display will be exited
immediately. If changes have been made, a small window
queries:
Save changes to Graphic graphic name?
- or Save changes to Submodel submodel name?
Click Yes to save changes, click on No to abandon changes.

Standard Color Palette


The color palette consists of 999 colors arranged in five
distinct groups that provide a range of colors used for a variety
of design techniques. The standard color palette allows
consistency of colors that help maintain a common look and
reusability of submodel shapes and operator models.

Position 0 to 31
The first range of colors is used for system environment
attributes such as windows, menus, alarm configuration, etc.
This range is locked and cannot be configured.

Position 32 to 95
The second range of colors is used for user development such
as submodels, models, process piping, dynamic colors, etc.
This range is not locked and can be configured. The default
colors for this range are the equivalent of the Composer colors. The Composer colors have been arranged as shown in the
following tTable 2-1.
Table 2-1. 32 to 95 Range of Colors
Order

2-2

Example

Color

Bright

Red (bright)

Color 34

Light

Red (light)

Color 42

Medium

Red (medium)

Color 50

Dark

Red (dark)

Color 58

WBPEEUI340020B1

Creating Models

When configuring the second range of colors, four options are


available:

Use this color range as the default.

Edit this color range to suit project configuration


standards.

Remap this color range with colors from existing


configuration.

Use Conductor NT/PWC90 default colors.

Position 96 to 255
The third range of colors is used for shading and 3D effects
such as vessels, pushbuttons, menu bars, charts, equipment,
etc. This range is locked and cannot be configured.

Position 256 to 511


The fourth range of colors is used for alarm priority colors.
These colors are set in the system definition object of the
system. Refer to the appropriate instruction for more
information.

Position 512 to 998


The fifth range of colors contains additional colors that can be
used to further enhance the displaying of information.

Creating Models
The Grafx editors are a multiple document interface applications. This means that once the Grafx window is opened, multiple windows or model windows can be opened within the
Grafx window. This allows multiple models to be edited
simultaneously.
The Grafx window (Fig. 2-1) contains a number of discrete
parts which when used together, allow the creation of objects,
models, submodels and graphics. These parts include:

WBPEEUI340020B1

Menu bar (across the top).

Main toolbar (below the menu bar).

2-3

Creating Models

TC00967B

Figure 2-1. Example Grafx Editor Display Window

Shape toolbar (down the left side of the window).

View toolbar (down the right side of the window).

Status bar (bottom right corner).

Toolbar Buttons
Figure 2-2 displays the toolbar icon buttons referred to in this
instruction.
NOTE: Toolbars may vary slightly between versions of the editor.

Model Creation Environment


Each window in the Grafx window is a graphic drawing area,
where objects are placed during configuration. When the Grafx
window is first opened, a single window is opened. Additional
windows can be opened, allowing multiple models to be edited
simultaneously. Objects can be copied from one window to
another.

2-4

WBPEEUI340020B1

Creating Models

S TA N D A R D TO O L B A R
CUT
C O P Y TO C LIP B O A R D
PA S T E
S N A P TO G R AV ITY
S N A P TO G R ID

S AV E
OPEN

UNDO

SNAP O FF

NEW

REDO

R E D R AW

F IL L S E T T IN G S

S H A P E TO O L B A R

V IE W TO O L B A R

L IN E S E T T IN G S
TE X T S E T T IN G S

S E LE C T O B JE C T S

B AC K G R O U N D C O L O R
L IN E
R E C TA N G L E
C IR C LE
P O LY L IN E
S P LIN E
P O LY G O N

Z O O M IN
ZO O M O U T

G R ID S T Y L E
Z O O M P IC K
Z O O M TO F IT
Z O O M D E FAU LT
R A IS E
LOW ER

C LO S E D S P L IN E
GROUP
ARC
UNGROUP
M ARKER
SELEC T DEEPER
TEXT
T E X T R E C TA N G L E
SUBM ODEL
B IT M A P

L E F T A L IG N
R IG H T A L IG N
TO P A L IG N
B O T TO M A L IG N

F IL L -M O D E O N /O F F
F L IP LE F T-TO -R IG H T
F L IP U P S ID E -D O W N
T03340 A

Figure 2-2. Toolbar Buttons

Opening a Window
To open a new, empty, unnamed window, select File > New, or
click on the corresponding icon on the main toolbar.
To open an existing model for configuration, select File > Open,
or click on the corresponding icon from the main toolbar. A
selection dialog box will open. Select a model from this dialog
box to display it in a new window.

Multiple Windows
No restriction is placed on the number of windows that can be
opened. Each window consumes computer resources. To conserve resources, it is a good idea to close a model window when
it is no longer required. If the editor is typically used with a

WBPEEUI340020B1

2-5

Creating Models

window maximized, it is easy to forget that there may be a


number of other windows hidden behind the active window.
NOTE: The same model in two different windows cannot be opened using File
> Open; attempting to do so will cause the original window containing the
model to go to the top level and become active.

Working View
The drawing space in a window is called the working view. It
uses coordinates from (0,0) to (100,75) by default; these coordinates can be changed via the zoom and pan operations. This
is a relative coordinate system for placement of objects in the
window, rather than a set of absolute screen coordinates.
When a model is first loaded in the window, a zoom to fit operation is automatically performed so that the entire graphic is
displayed. Once zoom and pan operations have been performed, the window may contain only a portion of the entire
model.
NOTE: Grafx editors maintain an aspect ratio four wide by three high, to
maintain correct proportions of models during scaling operations.

Working View Grid


The grid used in the working view area of a window aids in the
construction of models. Use the grid the same as a piece of
graph paper, as a guide in designing objects. The grid size, line
style and grid color can all be configured using the grid tab on
the settings window (refer to Grid Attributes).
Although the grid is useful by itself, it is much more powerful
when snap mode is set to the grid selection.

Snap Mode
Snap mode is a valuable tool which aids in the selecting of
points and aligning objects. Snapping helps select the same or
similar points while building objects. Snap mode can have one
of three possible values, selected by clicking on the appropriate main toolbar button: snap off, snap to grid, or snap to
gravity. by default, snap mode is set to snap to grid.
In snap to grid mode, every point that is selected is adjusted to
the nearest grid intersection, whether the grid is visible or not,
and always works with the current grid size. This is useful

2-6

WBPEEUI340020B1

Creating Models

when creating horizontal or vertical lines, button arrays, or


other symmetric displays.
Objects created using the Grafx editor and submodels provided by ABB contain predefined points. Predefined points can
be used to rotate, scale, and make connections to the object.
Selecting snap to gravity causes the point selection to snap to
the closest predefined point of an object. Clicking a point on or
very near an object causes the nearest predefined point in the
object to be selected. For example, if a point near the corner of
an existing rectangle is picked while the user is creating a new
object, the predefined point at the corner of the rectangle will
be used in the new object. Snap to gravity helps pick points to
connect objects together.
Snap to gravity can be used in conjunction with the reference
point of an object to aid in the placement and interconnection
of objects and submodels on a graphic. Refer to Changing a
Reference Point and Object Placement Example for more
information on reference points.

Aligning Multiple Objects


The alignment buttons become available when more than one
object is selected (refer to Selecting Multiple.) The last object
selected is the one with which all of the selected objects will be
aligned. There are four alignment options available: align left,
align right, align top, and align bottom.

Select Mode
The select objects button is used to change to select mode.
Entering select mode is also possible by right clicking on an
empty space in a window. In this mode, the pointer changes to
an arrow shape, and can be used to select one or more objects
which have been placed on a submodel or graphic. This is useful for configuring attributes for an object, or for grouping
objects together, etc.
The creation of any type of object is terminated by clicking on
the select objects button, on another toolbar button, or by
right clicking when the pointer is in the working view of a
window.

WBPEEUI340020B1

2-7

Creating Models

Redrawing the Working View


Click the redraw button to redraw the working view of the
active window.

Adjusting the View (Zoom/Pan)


The following options are available to change the contents of
the working view:

Scroll bars in the window frame control the portion of the


graphic that is visible in the working view area of the active
window. This operation is referred to as panning.

Zoom buttons on the view toolbar control the amount of


coordinate space which can be visible in the working view,
known as the view size

The view size always has an aspect ratio four (wide) by three
(high), to maintain correct proportions of models during scaling operations. The default view size is 100 by 75 units. The
maximum view size is 400 by 300 units. The available area for
a graphic is actually 16 times the size of the default view size.
The user can maintain the same view size and use the scroll
bars to see additional areas of the coordinate space, or use the
zoom options to increase/decrease the view size in the working
view.
Coordinates for the minimum, maximum and default view
sizes are shown in the following tTable 2-3.
Table 2-2. View Size Information
View Size

Number of
Units

Lower Left
Coordinates

Upper Right
Coordinates

Default

100 x 75

0,0

100, 75

Maximum

400 x 300

-150, -112.5

250, 187.5

Minimum

20 x 15

Can be located anywhere within the


maximum view size coordinates.

NOTE: The use of grid mode (Grid Attributes) is unaffected by zoom and pan
operations.

2-8

WBPEEUI340020B1

Creating Models
Table 2-3. View Size Information
View Size

Number of
Units

Lower Left
Coordinates

Upper Right
Coordinates

Default

100 x 75

0,0

100, 75

Maximum

400 x 300

-150, -112.5

250, 187.5

Minimum

20 x 15

Can be located anywhere within the


maximum view size coordinates.

Zoom Operations - In, Out, Pick, Fit, Default


The zoom operations change the view size of the working view,
but do not change the model which is being edited. These
operations are performed using the following buttons found on
the view toolbar: zoom in, zoom out, zoom pick, zoom to fit,
zoom default.
Each time zoom in is clicked, the view size is reduced by 62
percent. The center of the view remains unchanged. Objects in
the model which are visible appear correspondingly larger, but
are not actually modified. This operation magnifies only a portion of the graphic. If the view has been fully zoomed in, no
further change occurs to the view size.
Each time zoom out is clicked, the view size is enlarged by 62
percent. The center of the view remains unchanged. Objects in
the model which are visible appear smaller, but are not actually modified. This operation allows the entire graphic to be
displayed in the working view. If the view has been fully
zoomed out, no further change occurs to the view size.
Click the zoom to fit button to adjust the view size by automatically zooming out or in so that the entire model is visible and
fills the working view. When a model is initially loaded into the
working view, a zoom to fit operation is automatically performed if there are objects outside the default view size (100 by
75 units); otherwise, the default view size will be used.
The dimensions of the default view size are enclosed in a rectangle with solid lines. When zooming or panning outside the
default view dimensions, this rectangle or portions of it may be
visible within the working view. This rectangle is for reference
only; it is not part of the model and will not be visible when the
graphic is displayed in an operator window. To adjust the view
to the default view size, click the zoom default button.

WBPEEUI340020B1

2-9

Toolbars

The zoom pick button allows the user to select the diagonal
corners of a box representing the desired view size. The rectangle resulting from these selections is called the zoom box. If a
zoom box smaller than the minimum view size is selected, the
minimum view size is used, with the same center as the
selected zoom box.
NOTE: The contents of the working view after a pick operation may not reflect
exactly the contents of the zoom box used to make the selection. This is
because the working view is restricted to an aspect ratio of four (wide) by three
(high), while the zoom box is not. In order to reconcile the two, the 4 by 3
aspect ratio is applied to the largest dimension of the zoom box selected.

Toolbars
Three toolbars are provided with the Grafx editors: shape,
main, and view. These movable and dockable toolbars are
typically located as shown in Figure 2-1.
Detach a toolbar from the frame of the Grafx editor window
using the standard Windows drag and drop method.
When detached from the window frame, a toolbar has its own
title bar and exit button. It can be reshaped by dragging on the
edges of the toolbar window.

Status Bar
The status bar is located at the bottom of the Grafx window.
Information about operations in the active window displays in
the left portion of the status bar.
The select, depth, and cursor information fields are also
located in the status bar. The select field reflects the number of
objects on the screen which are selected and will consequently
be affected by any configuration action. The depth field indicates how deep within groups an object can be selected. The
cursor field provides the coordinates of the pointer in the
active window.
The view menu controls the visibility of the status bar. A check
mark next to the status bar option on the view menu indicates
that it is visible. Click this menu item to toggle between the on
and off states for the status bar.

2 - 10

WBPEEUI340020B1

Shape Toolbar

Shape Toolbar
The shape toolbar provides tools to create objects, select
existing objects, and set the fill mode for filled objects.
To create a new object, first select the type of object from the
shape toolbar. In a window, position the cursor at a starting
point and drag the pointer to define the points of the object.
Continue to add objects of the selected type until a different
toolbar button is chosen, or enter select mode.
The following sections provide more detail about shape toolbar
buttons, and how to create objects using them.

Fill Mode Button


The manner in which some shape toolbar buttons work is
affected by the state of the fill mode button, which is found at
the bottom of the shape toolbar. Buttons representing closed
objects such as circles, rectangles, polygons and closed splines
can be created as filled or unfilled objects. When this button
appears pressed in, fill mode is set to on, and any closed
objects created will be filled in. The fill color used depends on
the fill color currently selected in the properties window. This
button appears raised when fill mode is off, and any closed
objects created in this mode will not be filled.

Straight Lines
Create straight lines by using the line button. Straight lines
have only two points in the following figure(a and b in Fig. 2-3).
If a third point is picked, it is the beginning point of the next
line.
a

b
T 022 82A

Figure 2-3. Straight Line

1. Click the line button.


2. Position the pointer where the line is to begin (point a).
3. Drag the pointer.

WBPEEUI340020B1

2 - 11

Shape Toolbar

4. Release the pointer at the second pointpoint b to end the


line. The line appears on the screen.
5. Terminate the procedure by choosing a different toolbar
button.

Rectangles
Create rectangles by using the rectangle button and choosing
two opposing corners (Fig. 2-4).
a

b
T 02 2 83 A

Figure 2-4. Rectangle

1. Click the rectangle button.


2. Position the pointer where the first corner of the rectangle
is to be placed (a).
3. Drag the pointer to the opposite corner of the rectangle (b).
4. Release the mouse button. The rectangle appears on the
screen.
5. Terminate the procedure by choosing a different toolbar
button.

Circles
Create circles by using the circle button. The location and size
of the circle are indicated by picking the center and a point on
the edge (Fig. 2-5).
1. Click the circle button.
2. Position the pointer over the point to be the center of the
circle (a).
3. Drag the pointer to the location for the edge of the circle
(b).
4. Release the mouse button. A circle appears on the screen.

2 - 12

WBPEEUI340020B1

Shape Toolbar

b
T02284A

Figure 2-5. Circle

5. Terminate the procedure by choosing a different toolbar


button.

Markers
Create markers by using the marker button. Markers are
small dots used to indicate positions of single points. Markers
are used while constructing objects to help in placement. They
are created by picking points in the working view (Fig. 2-6).
c

d
a

b
T022 85A

Figure 2-6. Markers

1. Click the marker button.


2. Position the pointer over the location for the marker (a),
then click it once. A marker appears on the screen.
3. Terminate the procedure by choosing a different toolbar
button.

Polylines
Polylines add multiple straight lines to a model. Polylines differ
from lines in that lines have only two points, while polylines

WBPEEUI340020B1

2 - 13

Shape Toolbar

can have more than two points connected by straight lines.


Create polylines by using the polyline button, choosing a starting point, then adding as many additional points as needed. A
straight line is displayed between each pair of points chosen
(Fig. 2-7).
c

d
b

T 022 86A

Figure 2-7. Polylines

1. Click the polyline button.


2. Click the first point (a), followed by the second (b), third (c)
fourth (d), and so on.
3. Terminate the procedure by choosing a different toolbar
button.

Splines
Create splines by using the spline button. The Grafx editor
uses the points picked to make the smoothest appearing
curved line (spline) which passes through these points. Points
are connected by a polyline as they are selected. When the procedure is ended, the polyline is redrawn as a spline (Fig. 2-8).

f
T 02 27 3 A

Figure 2-8. Spline

1. Click the spline button.

2 - 14

WBPEEUI340020B1

Shape Toolbar

2. Click the first point (a), then the second (b), third (c), and
so on.
3. Terminate the procedure by choosing a different toolbar
button. The polyline connecting the chosen points is replaced
by a spline.

Closed Splines
Create closed splines by using the closed spline button. The
Grafx editor connects the points with a polyline until the procedure is terminated. This signals the editor to connect the
end points of the polyline and convert it to a closed spline
(Fig. 2-9).

d
e

c
a

b
f

T 0227 4A

Figure 2-9. Closed Spline

1. Click the closed spline button.


2. Click the first point (a), then the second (b), third (c), fourth
(d) points, and so on.
3. Terminate the procedure by choosing a different toolbar
button. The polyline connecting the chosen points is replaced
by a closed spline.

Creating Arcs
Create an arc by using the arc button. Arcs are portions of a
circle and are constructed by picking the two endpoints of the
arc, then picking a point along the edge of the arc (Fig. 2-10).
1. Click the arc button.

WBPEEUI340020B1

2 - 15

Shape Toolbar

a
b

T0 2 2 75 A

Figure 2-10. Arc

2. Click the first endpoint of the arc (a).


3. Click the second endpoint of the arc (b).
4. Click a point along the edge of the arc (c). An arc will
appear on the screen.
5. Terminate the procedure by choosing a different toolbar
button.

Polygons
Create polygons by using the polygon button. Polygons are
many-sided objects which can be added to a model (Fig. 2-11).
The Grafx editor automatically connects the first point chosen
with the last point.
e

T 02299 A

Figure 2-11. Polygon

1. Click the polygon button.


2. Click the first point (a).

2 - 16

WBPEEUI340020B1

Shape Toolbar

3. Click the second point (b).


4. Click the third point (c), and so on.
5. Terminate the procedure by choosing a different toolbar
button. The first and last points are automatically connected,
and the polyline connecting the chosen points is replaced by a
polygon.

Text Objects
There are two selections on the shape toolbar for creating text
objects, the text and text rectangle buttons. Text only objects
are added using the text button. A text object is created by
clicking on a point in the working view where the text is to be
positioned (Fig. 2-12).
1. Click the text button.
2. Pick the point to position the text.
3. Enter the characters and press RETURN.
4. Terminate the procedure by choosing a different toolbar
button.

Th is Text Is C e nter Justifie d


T 02 30 0 A

Figure 2-12. Text Object

Modifications to the text attributes can be made using the


settings and properties windows, which are described in
Configuring Object Graphic Attributes. To modify the content
of a text object after it has been created, double click on the
text object, then make the changes in the entry box which
appears in the status bar. Use the expand entry button on the
status bar for editing text with multiple lines.
NOTE: The general tab on the properties window can also be used to enter
multiline text objects. Refer to Properties Window for information on this
feature.

WBPEEUI340020B1

2 - 17

Shape Toolbar

Text Rectangles
Create text rectangles by using the text rectangle button. Text
rectangles are filled rectangles with text written on top of them
(Fig. 2-13).
NOTE: Text is not prevented from appearing outside of a text rectangle. Text
appearing outside the filled rectangle is not erased when text inside the rectangle is changed. It is important that a large enough text rectangle be used. Use
the properties window to enter multiline text, or click on the expand entry
button in the status bar.

SYMPHONY
T 02 28 7 A

Figure 2-13. Text Rectangle

1. Click the text rectangle button.


2. Modify text attributes, if necessary (refer to Properties
Window and Settings Window).
3. Position the pointer at the first corner of the rectangle.
4. Drag the pointer to the location of the opposite corner and
release the mouse button. A filled rectangle appears on the
screen.
5. Enter characters. Text appears positioned within the
rectangle.
6. Terminate the procedure by choosing a different toolbar
button.

Submodels
Graphics can be composed of objects (such as rectangles, lines
and circles), bitmaps, and submodels (such as valves and
pumps). A submodel is a collection of objects which has been
saved using the model type submodel. (The model type can be
defined by selecting Edit > Model Type from the Grafx window
menu bar.) Including a submodel in a graphic is referred to as
making an instance of the submodel. There can be many
instances of the same submodel in a graphic.

2 - 18

WBPEEUI340020B1

Shape Toolbar

Submodels have their own attributes such as fill color and


edge color. These attributes can be dynamic. The submodels
created with the Grafx editor are external submodels. When
the submodel is altered, all models containing instances of
that submodel will reflect the change. Submodels cannot be
altered directly from the settings or properties windows. Both
static and dynamic attributes of submodels are altered using
selections from the dynamics menu (refer to Dynamics).
Submodels are accessed using the submodel button in the
shape toolbar. Selecting this button causes the select
submodel window to appear. An example window, with a
submodel selected, is shown in Figure 2-14.

TC02463A

Figure 2-14. Submodel Selection Window

A selection box allows choosing from the available model


types. When a model type is selected, a list of submodels
available for that model type will appear in the list box area of
the window. Model types include:

Design
Design submodels include all user configured, non running
submodels available on the system (refer to Graphic and Submodel Files).

Running
Running submodels include all user configured submodels
which have been set to running on the system, via

WBPEEUI340020B1

2 - 19

Shape Toolbar

File > Set Running. Only running submodels can be used in


running graphics (refer to Graphic and Submodel Files).

Human System Interface


HSI submodels are those which have been supplied with the
HSI software. Several different types of HSI submodels are provided. The prefix of the submodel name indicates the type of
the submodel.
Dynamic submodels contain preconfigured dynamic
attributes. The names of these submodels are prefixed by the
string FP_DY. For a description of the available submodels,
refer to Appendix A for a description of the available submodels.
Dynamic submodels are used:

To display dynamic data from the database, using various


forms such as valves and bar graphs.

For the control of modules.

For the assignment of display vectoring.

The assignment of database points to the dynamic attributes is


accomplished through the configure submodel menu (refer to
Dynamics).
Symbol submodels are standard static submodels, preconfigured and supplied with the Process Portal software. Symbols
are objects which represent standard items such as vessels,
tanks and storage bins. Symbols which correspond to those
defined by the Instrument Society of America (ISA) have the
prefix ISA_. Non ISA symbols contain the prefix FP_ST. Refer to
Appendix B for a complete list of these submodels. Dynamic
attributes can be assigned to these submodels via the Dynamic
Attributes menu item (refer to Dynamics).
Internal submodels are models used for purposes internal to
displays, and are prefixed with the string FP_IN.

Finding Submodels
The Filter field in the select submodel window allows searching
for a particular string of alphanumeric characters occurring in
file names, or for a particular file. The search operation is not
case sensitive. Click directly on the filter box. Type in the
2 - 20

WBPEEUI340020B1

Shape Toolbar

string or file name for which to search, then press RETURN.


Asterisks will automatically be placed at the beginning and
end of the string. The list box will display the names of all files
containing the string. For example, searching the submodels
category for the string *AGIT* will yield ISA_AGIT and
ISA_AGIT_MOTR in the list box.

Creating Submodel Instances


When creating an instance of a submodel, a version of it is
placed in a particular graphic or another submodel.
NOTE: If the preview box is checked, selecting a submodel name causes that
submodel to be displayed in the preview box.
To create one or more instances of a submodel:
1. Click the model name in the list box, then click Instantiate
(or double click on the model name in the list).
2. Move the pointer to the appropriate window. Extent
indicators appear to aid in placement of the submodel.
3. Move the extent indicators to the desired location.
4. Click the desired location.
5. If multiple instances of the same submodel are desired on
the graphic, repeat Steps 3 and 4.
Double click on a submodel instance to open the configuration
window (refer to Configuring Submodels).

Bitmap Image Files (Grafx Version 2.3 and 3.2 Only)


Bitmap images can be included on graphic displays configured
for an HSI. Including a bitmap in a graphic is referred to as
making an instance of the bitmap. There can be multiple
instances of the same bitmap in a graphic.

Accessing
Click the bitmap button in the shape toolbar. Select a bitmap
type to display a list of bitmaps available for that type.
Typically, bitmaps are supplied by the customer.

WBPEEUI340020B1

2 - 21

Configuring Object Graphic Attributes

Select an entry, then click Instantiate. On the graphic, use the


extent markers to position the instance, then click it. Right
click to terminate the operation.

Importing
Bitmaps supplied by the user can be imported by selecting the
Bitmaps type. Click Import (Fig. 2-15).

TC01778A

Figure 2-15. Import Bitmap File Window

Specify the drive, directory and name of the bitmap file to be


imported. Click OK. The selected file will be added to the list in
the selection window, and the file will be copied to the
directory containing the files for the Bitmaps file type.

Configuring Object Graphic Attributes


The graphic attributes of an object can be configured. Examples of such properties are fill color, line color, line width, font
style, text size, and text alignment. The type of attributes
available for an object depend on the object type.
Object attributes are controlled via the settings configured in
the settings and properties windows. The settings window is
primarily intended to configure attributes that will be used
when a new object is created; it does not necessarily reflect the
graphic attributes of selected objects. If objects are selected
when changes to the settings are made, the changes will affect
them. The properties window is used to display or change the
attributes of a single, selected object.

2 - 22

WBPEEUI340020B1

Configuring Object Graphic Attributes

Settings Window
Open the settings window by clicking on the fill settings, line
settings, text settings, BG color, or grid style buttons. These
buttons are grouped together on the main toolbar.
The settings window can also be opened using Grafx menu
options. Select View > Settings, then choose one of the
following options: Fill, Line, Text, Background or Grid.
The settings window (Fig. 2-16) contains a tab for each of these
attributes. Each tab display contains all the available settings
for the selected attribute. Which toolbar button used to open
the settings window determines which tab is selected when the
settings window opens. The tabs can be used to move between
attribute setting displays without closing the settings window.

TC00846A

Figure 2-16. Settings Window

Setting the Fill Attributes


If fill mode is on when a closed object (circles, rectangles) is
created, it will be filled. (The fill mode button is found on the
shape toolbar (refer to Shape Toolbar). The fill color and pattern used to fill closed objects are determined by the selections
made using the Fill selection.

Fill Pattern
An assortment of fill patterns, including None and solid, is provided on the fill display of the settings window. This feature
allows specification of the fill pattern for selected and
subsequent objects.

WBPEEUI340020B1

2 - 23

Configuring Object Graphic Attributes

Examples of available fill patterns are displayed in rectangles,


each accompanied by an indicator box. The fill pattern is
changed by clicking the rectangle containing the desired fill
pattern, or the box next to it. The box of the selected fill pattern is filled in, and any selected objects will reflect the
change. The fill pattern remains in effect for all objects created
subsequently, until a different selection is made.

Fill Color
There are 999 colors available, numbered zero through 998.
There are 32 pages of 32 colors each, which are displayed one
page at a time. To move between the pages of color buttons,
use the arrow buttons found in the fill color settings display.
Click a color; all selected objects will be changed to the
selected color. The selected color remains in effect for all closed
objects created, until a different color selection is made.
Definitions for colors 32 through 95 can be altered via the
color tab of the system definition object. Refer to the
appropriate system configuration instruction.

Line
The Lines tab window sets the desired width and style of a line
or the edge of an object. This display is used to select from six
widths and five styles. To select a style, click on the example or
on the indicator box next to the example. The indicator box
next to the selected style or width is filled in, and the selected
line or edge of the selected object will reflect the change. Only
one edge style and one edge width can be in effect at any one
time. These attributes will remain in effect for all subsequent
objects, until a different selection is made.

Text
The Text tab controls the following characteristics (attributes)
of text objects: size, font, direction, alignment and text color.
Text size is changed by moving the size slider. Move it right to
increase the font size, or left to decrease the font size.
Text font is changed using the font selection box. Click the
arrow to display a menu of available fonts. Click a font name
in the list. The selected name will be displayed in the text
portion of the box.

2 - 24

WBPEEUI340020B1

Configuring Object Graphic Attributes

Text direction (vertical or horizontal) is changed by clicking on


the appropriate direction arrow (right arrow or down arrow)
labeled dir. The arrows indicate in which direction the selected
text is to be displayed.
Text alignment determines the offset of the text object, relative
to the point chosen for positioning the text object in the model
or graphic. By default, a text object is left aligned. A grid of
nine position points allows specifying where the original positioning point will remain, relative to the text object. The
selected alignment setting remains in effect for all text objects
created subsequently, until a different selection is made.
To edit the content of existing text, double click on the text
object, then make the changes in the entry box which appears
in the status bar. Use the expand entry button on the status
bar for editing text with multiple lines.

Background Color
Black is the default background color for graphic displays and
models. This may not be the ideal choice in all circumstances.
For example, to use the background color of a graphic to
identify the plant area to which the graphic applies.
The BG tab is used to change the background color of the
graphic being configured. To change the background color of
the graphic in the active window, click the button of the
desired color from the palette. The background of the graphic
will change to that color (refer to Fill Color).
The background color is assigned during configuration. If the
background color is changed, the graphic must be reconfigured and set to running again. When configuring dynamic
submodels, background color is configurable as the erase
color, the color used to replace portions of the drawings when
they are removed from the submodel. When a color is assigned
to a submodel via the BG tab on the settings window, the
following message will be displayed in the status bar:
erase color = n
where n is the number of the color selected from the color palette. When an instance of a submodel is made on a graphic,
the instance assumes the background color of the graphic.
When portions of the submodel are erased, the background

WBPEEUI340020B1

2 - 25

Configuring Object Graphic Attributes

color assigned during submodel configuration is displayed in


place of the original color. A good example of this is a dynamic
submodel such as a tank when used in a larger graphic display. As the level decreases in the tank, the color representing
the ingredients is replaced by the background color selected
for the tank, instead of the background color of the graphic.
NOTE: This feature is for use only on graphic displays, and does not allow
changing the background color of other display types (such as point, group,
trend and summary displays). The background colors of these display types
were chosen to provide the best contrast with other colors used in these
displays.

Grid Attributes
The grid used in the working view area of a window aids in the
construction of models. The grid size, line style (lines, dots,
hidden) and grid color can all be configured using the Grid tab.
Configurable attributes for the grid are style, size, and color.
The grid style is selected from a selection box. The choices are
Lines, Dots and Hidden.
Grid size choices are 1x1, 2x2 and NxN. The numbers represent working view units; the default working view is 100 units
wide by 75 units high, regardless of the size of the window or
the display screen. The 1x1 option will cause the grid to reflect
this and divide the working view into 100 by 75 units. The 2x2
option provides a grid with a line drawn every two units. To
make the selection, click on either the description or the
associated indicator box.
The choice NxN allows specification of the size grid units.
When this option is selected, the entry box associated with it
becomes available. Enter a value from 0.2 to 10. The grid size
will be adjusted accordingly. If a value outside these limits is
entered, the grid will be resized using the closest available size.
To change the color of the grid in the active window, choose a
button from the grid color palette. The grid lines will change to
the selected color. Two hundred fifty-six colors are available,
numbered zero through 255. These are contained on eight
pages of 32 colors each, which are displayed one page at a
time. To move between the pages of color buttons, use the
arrow buttons found in the grid color settings display. The

2 - 26

WBPEEUI340020B1

Selecting and Manipulating Objects

selected color remains in effect for all windows opened


subsequently, until a different color selection is made.
Although the grid is useful by itself, it is much more powerful
when snap mode is set to the grid selection. Snap mode is a
valuable tool which aids in selecting points and aligning
objects. Snapping helps select the same or similar points while
building objects (refer to Snap Mode).

Properties Window
The properties window is used to display or change the
attributes of a single, selected object. To open the properties
window, right click on a single object, then select the Properties option from the resulting menu. If some properties do not
apply to the selected object, (for example, text attributes do not
apply to a line object), the corresponding tab in the properties
window cannot be selected.
Fill, line and text properties for a selected object are configured
as described in Settings Window.
A set of attributes unique to the properties window is accessed
via the General tab. Items included on this tab display include
the Type, Text and Name for the selected object.
The object type is not configurable; it simply reports the type of
object which has been selected.
The entry box is used to modify the text content, and is only
available when a text or text rectangle object is selected.
The name entry box is used to assign a name to the individual
object for purposes of identification. The object name is also
used with the Select by Name option on the edit menu (refer to
Edit Menu).

Selecting and Manipulating Objects


The Grafx editors allow selection and manipulation of objects,
typically via operations similar to those used by other Windows
based applications. Such Grafx editor operations include moving, copying, resizing, deleting objects, and selecting multiple
objects.

WBPEEUI340020B1

2 - 27

Selecting and Manipulating Objects

The selection and manipulation of graphic objects is


performed with the Grafx editor in select mode.

Selecting Individual
To select an individual object, click on it. Alternatively, from
the menu bar select Edit > Select By Name. Enter the object
name in the resulting window, then click OK.

Selecting Multiple
To select multiple objects, press and hold SHIFT, then click on
each object. The number of selected objects is shown by the
Sel indicator in the status bar.
If an object has been selected, clicking on it a second time
while holding down SHIFT will remove it from the select list.
Objects can also be selected by extent. To select objects by this
method, click on a starting location, then drag the pointer
until the resulting box encloses all of the objects to be selected.
When the mouse button is released, all the objects completely
within the extent of the box are selected.
To deselect all objects, click on the select arrow button in the
shape toolbar, or position the pointer on an empty area of the
working view and right click.

Grouping and Ungrouping


A group of objects and submodels can be configured so that
they are all affected by the same operations (move, delete) or
expressions).
Grouping should be done prior to selecting the Dynamic
Attributes item, described in Dynamics. Holding SHIFT down,
click on all objects that are to be grouped. When all objects
have been selected, click on the group button on the view
toolbar.
A group can be changed back to a collection of individual
objects. Click the group, then click on the ungroup button on
the view toolbar. Any dynamics attached to the group via the
dynamic attributes entry will be deleted.

2 - 28

WBPEEUI340020B1

Selecting and Manipulating Objects

Depth and Grouped


A collection of objects can be saved as a group. This group in
turn can become part of another group, and so on. The use of
groups within groups is the concept of depth.
The select deeper button on the view toolbar permits selection
of objects within a group. Each time this button is clicked on,
the Depth= indicator in the status bar is incremented by one.
This number indicates how deep within groups an object can
be selected. The default level is zero. Level one permits selecting objects within groups, level two allows selecting an object
which is inside a group which is inside another group, and so
on.
To reset the depth to the default of zero, click on the select
arrow button in the shape toolbar, or position the pointer on
an empty area of the working view and right click.

Extent
The extent of an object, also known as an extent rectangle, is
the smallest rectangle, with a horizontal base, which completely encloses all parts of an object. The extent of an object is
used to determine the location of the object center. The center
of any object is also the center of the object extent.

Moving
Position the pointer over an object; the pointer will change to a
four headed arrow shape. Drag and drop the object to the new
location.
Alternatively, the pointer can be positioned over the object to
be moved, then press and hold the right mouse button while
dragging the extent indicators to the new location. Release the
right mouse button and select Move Here.
The operations move an object by its extent. It is also possible
to choose a specific point in an object and move it to a specific
location (refer to Object Point Operations).

WBPEEUI340020B1

2 - 29

Selecting and Manipulating Objects

Copying
Any of the following three methods can be used to copy an
object.
Method 1

Click an object; click Copy, then Paste from the main toolbar.
Place the pointer on the location which is to be the new center
of the object and click. Click Paste and repeat the positioning
operation for each additional copy of the object needed. This
operation will also work if Cut on the main toolbar is used
instead of Copy, if the original object is to be deleted.

Method 2

Position the pointer over the object. Press and hold the right
mouse button while dragging the extent indicators to the new
location. Release the right mouse button and select Copy Here.

Method 3

Hold down CTRL while dragging an object to a new location. A


copy of the object will be made in the new location.

Scaling
Scaling is the action of making objects larger or smaller. To
resize an object select the object. A box appears around the
object to indicate that it is selected. Resize handles, displayed
as small squares, appear at each corner and at the midpoint of
each side of the box. Click one of the resize handles, and drag
it to a new position.
By default, scaling is unequal; that is, objects can be distorted
as they are scaled. For example, if a circle is scaled unequally,
an ellipse is created.
When scaled equally, objects are increased or decreased in
height or width by the same proportion. To scale an object
equally in both the X and Y dimensions, press and hold SHIFT
prior to selecting a handle.
To scale an object relative to its center, press and hold CTRL
prior to selecting the resize handle. To scale an object equally
around its center, press and hold both SHIFT and CTRL while
dragging one of the resize handles.

Changing a Reference Point


Each object has one reference point. By default, the reference
point of an object is defined as the center of the object extent.

2 - 30

WBPEEUI340020B1

Selecting and Manipulating Objects

To change the reference point of a selected object, right click


on the object. Select Points > Change Ref then click on a point
other than the center of the object. If a single object is on the
select list when the change reference function is invoked, this
change in reference point remains in effect permanently for
the instance of that submodel in the graphic. If more than one
object has been selected, however, the change in reference
point is in effect only while the objects are selected.
Use Reset Ref on the points menu to set the reference point of
each object on the select list back to its default.
The reference point can be used in conjunction with point
snap mode to aid in the placement and interconnection of
objects and submodels on a graphic. Refer to Object Placement Example in this section.

Rotating
The rotate feature rotates selected objects. An object rotates
around its reference point, which by default is the center of the
object extent. Position the pointer on the object to be rotated,
then right click and choose Rotate.
A dashed reference line appears, with the left end of this line at
the reference point of the object. The reference line is an aid for
choosing the angle of rotation. The angle to rotate the selected
objects is chosen by clicking a point relative to the reference
point and reference line. The number of degrees between the
reference line and the selected point, calculated
counterclockwise, determines the angle of rotation.
The object can also be rotated by entering degrees in the input
box found in the status bar (lower right): positive equals
clockwise, negative equals counterclockwise.

Changing the Drawing Order


The raise button on the view toolbar is used to modify the
order in which objects are drawn on the screen. Objects are
normally drawn in the order in which they are created. If two
objects overlap, the object which was created more recently is
drawn later, and therefore appears on top of the older object.

WBPEEUI340020B1

2 - 31

Selecting and Manipulating Objects

Use the raise button to put the currently selected object at the
end of the drawing order; they will then be drawn last, and will
appear on top of all other objects which overlap.
NOTE: The above discussion of the raise button applies to the drawing order of
static objects. However, when a model is displayed in an operator window, and
the attributes of an object in the model are modified according to the dynamics
defined for that object (for example, the fill color of the object is changed in
response to some change in a tag name.atom), the object must be redrawn,
which places it on top of other objects. For this reason, it is recommended that
no objects be placed on top of dynamic objects. If it is necessary to do so,
dynamics must be also configured for the objects on top, so that all objects
involved are redrawn when a dynamic change occurs.
The lower button on the view toolbar performs in a manner
opposite to that of the raise item. Use lower to put the currently selected objects at the beginning of the drawing order.
They will then be drawn first, and will appear beneath all other
objects which overlap.

Mirroring
An object (or set of objects that have been grouped together)
can be reversed horizontally or vertically. To mirror an object
horizontally, select the item, then click on the flip left-to-right
button on the view toolbar. The item will be converted to a mirror image of the original. The following figureFor example, Figure 2-17 shows a polygon and a copy which was reversed
using the flip left-to-right button.

TC00823A

Figure 2-17. Object and Mirrored Copy

Objects (or a set of grouped objects) can also be mirrored vertically, using the flip upside down button from the view toolbar.
When an object is selected and this button is clicked, the
object will be inverted, top to bottom. The following figureFig-

2 - 32

WBPEEUI340020B1

Object Point Operations

ure 2-18 illustrates an arc and a copy which was inverted


using the flip upside-down button.

TC00824A

Figure 2-18. Object and Inverted Copy

In both cases, the object or group is reversed about the center


of its extent, so that the extent box of the selected object or
group is the same, both before and after flipping.
NOTE: Using either of these buttons with a text object that uses any font other
than VECTOR1 and is not center aligned can produce unexpected and undesirable results (repeatedly reversing such an object will cause it to eventually
migrate across the working view).

Deleting
To delete an object, click on it, then press DELETE. Alternatively,
click on an object, then right click and click Delete.

Object Point Operations


Individual points in an object can be used to position the
object. It is also possible to move points within an object, add
points to an object and delete points from an object. To access
point operations, right click on an object.

Moving (Point Mode)


When an object is moved as described in Moving, it is moved
by extent, relative to the pointer location when the object was
selected. An object can also be moved in point mode. In this
mode, a specific gravity point in an object, or a point in an
object extent can be positioned in a specific location.

WBPEEUI340020B1

2 - 33

Object Point Operations

To move an object in this mode, right click on the object and


select one of the following:

Move (By Grav Pnts).


Mover (By Extent Box).

Selecting Move (By Grav Pnts) causes handles to be drawn on


each of the gravity points and the reference point, in the
selected object. With the snap to grid button on the main toolbar selected, select a gravity point in the object and move it to
a new location. This method is useful when realignment of a
specific point in an object with the grid is required. Double
click on a point to open a window that allows entry of the
coordinates of a new location for the point.
Selecting Move (By Extent Box) caused handles to be drawn at
each corner of an object extent box, at the midpoints of each
side of the extent box, at the reference point of the object.
Select one of these points and move the object relative to it.
Use the snap to grid or snap to gravity buttons from the main
toolbar to align the selected object with the grid or with a
gravity point of another object.
NOTE: These operations will move the selected object without changing its shape.
To redefine individual points in an object, refer to Changing.

Changing
The points used to define an object can be moved to change
the size and shape of the object. To move such a point in an
object, right click on the object and select Points > Change
Points. Circular handles drawn over the points that define the
object denote that the object is in point mode. The points can
then be dragged to new locations. This method is useful when
alignment of points in an object with specific locations on the
grid is required.
Double click on a point to open a window that allows entry of
the coordinates of a new location for the point.

Adding
To add a point to an object, right click on the object and select
Points > Add Point. Position the pointer over the location for the
new point and click. The shape of the object will change to
include the new point.

2 - 34

WBPEEUI340020B1

Object Placement Example

Deleting
To delete a specific point in an object, right click on the object
and select Points > Delete Point. Click the point to be deleted.
The point will be deleted and the shape of the object changed
accordingly.

Object Placement Example


A number of features are available to assist with the arrangement of objects in a submodel or on a graphic. These include
the grid in the working view of a window, the snap to grid and
snap to grav buttons, and gravity points in an object and on an
object extent.
The following example illustrates the steps required to create a
submodel instance and align a specific gravity point of the
submodel with the grid.
1. Create an instance of ISA_VLVE_ACTR in a Grafx editor
window. When created, an object may not be positioned
exactly as desired. For example, if snap off is selected when
the object is created, or if the object is scaled, it may not be
aligned with the grid; or the wrong gravity point may be
aligned with the grid.
2. Move the valve to a different position, if necessary.
3. Zoom in to get a closer view of the object, if necessary.
4. Be sure the grid is displayed; use the Grid tab on the
settings window, if necessary.
5. Select the snap to grid button on the main toolbar.
6. Right click on the object, and select Move (By Grav Pnts).
This allows the gravity points of the object to be displayed.
7. Place the pointer over the gravity point on the center of the
left side of the valve body, drag the gravity point to the desired
grid intersection.
This reference point change allows for lines to be easily
connected to the sides of the valve body (Fig 2-19).

WBPEEUI340020B1

2 - 35

Menu Bar

TC00825A

Figure 2-19. Object Placement Example

Menu Bar
The menu bar of the Grafx editor window provides access to
numerous Grafx editor features. The menus are used to perform file operations, editing functions, and adjustments to the
Grafx editor interface.

Graphic and Submodel Files


Two types of graphics and submodels are available on the
human system interface: running versions and design
versions. Running graphics and submodels are operational.
Having design versions of these graphics and submodels permits the user to modify them without affecting the operational
versions.
Once created, a graphic or submodel is saved as a file. The file
containing the graphic will be stored as an design graphic in a
location on the HSI hard disk reserved for design graphics.
Graphics are set to running via the file menu in the Grafx editor (select File > Set Running). The set running process moves
the file containing the graphic from the design disk location to
a disk location which contains only running graphics.
Only running submodels can be used in running graphics. A
running submodel is one which has been set to running. The
set running process moves the file containing the submodel to
the disk location which contains only running submodels.
When a graphic is set to running, and contains references to a
design submodel, a prompt will ask if those submodels should
also be set to running.

2 - 36

WBPEEUI340020B1

Menu Bar

File Menu
Click File on the menu bar of the Grafx editor window to view
the file menu. The choices on this menu are used to perform
various file operations.

Opening Files
To open a new, empty, unnamed window, select File > New
from the Grafx window menu bar, or click on the
corresponding button on the main toolbar.
Click Open to open an existing graphic or submodel for further
configuration (Fig. 2-20). This window is used to specify the
type of model to be opened, and provides a scrollable list containing the names of all available models of the chosen model
type. The letters at the beginning of names of models supplied
by ABB reflect the type of the model, as shown in the following
tableTable 2-4.

TC00835A

Figure 2-20. Open Model Window


Table 2-4. Process Portal Submodel Types
Model Name Prefix
FP_DY_

WBPEEUI340020B1

Model Type
Dynamic submodels

FP_ST_

Static submodels

ISA_

ISA standard symbols

FP_CW_

Control submodels

FP_IN_

Submodels for internal use

2 - 37

Menu Bar

It is recommended that user-created submodels be given


names different from ABB submodels. If created models are
given the same names as those supplied by ABB, and
user-created models are set to running, they will be used by
the HSI, and the ABB supplied versions will be ignored. This
can create problems in the hierarchical displays, other graphics, and submodels which have already been created which
reference the ABB supplied versions.
To select a model, double click on the desired file name in the
list box, or click on the desired file name, then click Open. A
model can be selected by clicking Model Name, then typing in
the model name. The filter edit box can also be used to locate
file names containing a specific string.
If the preview check box is selected, an image of the selected
submodel appears in the preview box when a submodel name
is selected.

Saving Files - Save and Save As


When changes have been made to the current working graphic
or submodel, and have not yet been saved, an asterisk (*) will
be displayed after the file name of the graphic or submodel in
the title bar of the window. To save the current working
graphic or submodel, click File > Save. To rename and save the
current working graphic or submodel, click File > Save As.

Set To Running
Once a model has been configured, it can be set to running for
use. Select File > Set Running.
NOTE: If the model has not yet been saved, a save as window will be displayed next. Assign a name to the model using this window. If the model has
already been saved, this step will be omitted.
The model is set to running immediately.

Applying Submodel Changes


Reload is used to reload a currently displayed graphic or submodel in the working view of the selected window, applying any
changes that have been made to the submodels it references.
For example, assume that two windows are open within the
Grafx editor window. In window one there is a graphic called

2 - 38

WBPEEUI340020B1

Menu Bar

BUTTON_PAD which contains ten pushbuttons, all created


using a submodel named toggle_pb. To change the face color of
all buttons which reference this submodel, it is necessary only
to change the configuration of the submodel. Select window
two and load the submodel toggle_pb. Next, change the face
color definition via submodel configuration (refer to Configuring Submodels) and save the changes. The instances of the
submodel in the graphic BUTTON_PAD in window one still
reflect the original button face color. Select window one, then
File > Reload. The face color will be changed on all
pushbuttons which reference submodel toggle_pb.
NOTE: A graphic or submodel must have been saved before the reload operation can be performed successfully.
If several windows are open which reference the same
submodel, use Reload All to update the multiple windows.

Cross Reference
Select File > Cross Ref to display a cross reference list of all
ABB and user-defined models which:

Are used as components of the current model.


Use the current model as a component.

The cross reference window displays the model name. The list
of submodels which are components of the current model are
found in a list box labeled References To. The list of models
which use the current submodel as a component are found in
a list box labeled Referenced By.
Clicking the name of a referenced model opens a new window
containing that model.

Deleting a Model
To delete a model (design or running, graphic or submodel),
click File > Delete. The delete model window is displayed.
Select the model category (design submodel, running submodel, and so on). In the list box, click on the item to be
deleted. Click Delete. A window will appear which states:
Looking for references to submodel.
If no references to the running submodel are found, the window will close and the submodel will be deleted. If references
WBPEEUI340020B1

2 - 39

Menu Bar

are found, the cancel window will close and a warning window
will appear with text similar to the following:
WARNING! submodel_name is referenced by:
graphics: reference_1, reference_2, reference_3
submodels: reference_1, reference_2, reference_3
Delete submodel_name?
Click No to exit without deleting the submodel, or click Yes to
delete it.
NOTE: Once the submodel is deleted, it will no longer be available for use by
other submodels and graphics which reference it.

Remove from Running


Remove from Running is used to remove a graphic from operational use. To do so, click File > Remove from Running
(Fig. 2-21). Select the type of model (running graphic and running submodel) to be removed from running from the look in
selection box.

TC02464A

Figure 2-21. Remove Model From Running Window

A list of models for the selected type appears. Highlight the


name of the model to be removed from running. Double click
on the model name or click Remove.
Click Yes to continue removing the model from running (or
click No to exit the operation without removing anything). If

2 - 40

WBPEEUI340020B1

Menu Bar

Yes is selected, the model will be moved to the appropriate list


of design submodels or graphics.
When a submodel is to be removed from running, the HSI software first determines whether it is used by any other graphic
or submodel. A window appears which states:
Looking for references to submodel.
If references are found, a confirmation box is displayed, which
indicates which models reference the submodel:
Warning! selected_submodel_name is referenced by
submodel_name
graphic_name
Remove selected_submodel_name?
Click Yes to remove the selected submodel from running, or
click No to abandon operation.
NOTE: Once the submodel is removed from running, it will no longer be visible
in running graphics viewed in an operator window. It will still be visible in other
submodels and graphics which reference it when they are viewed in the Grafx
editor.

Favorites (Grafx Version 3.2 Only)


Select File > Favorites to display a preconfigured model containing a number of frequently used submodels. Drag submodels from this model and drop them into a new model to
save configuration time. Customize this display by adding to it
any submodels that are frequently used.
If adding to the favorites display, save it as a graphic or a submodel. To return to the original set of favorite submodels, just
delete the favorites graphic or submodel version created. The
next time File > Favorites is selected the original version will be
displayed.

Edit Menu
Click Edit on the Grafx window menu bar to view the edit
menu.

WBPEEUI340020B1

2 - 41

Menu Bar

Undoing and Redoing


The first item found on the edit menu, Undo, is used to undo
up to 20 previous actions. It is functionally equivalent to the
undo button found on the main toolbar. For example, if an
object is accidentally deleted from the display, select
Edit > Undo (or click undo) to retrieve the object.
Redo on the edit menu complements Undo. Use Redo to perform up to 20 previous actions that were undone. The redo
button on the main toolbar is functionally equivalent to Redo.

Selecting Objects
If a name has been configured for an object, select the object
by name. Choose Select by Name on the edit menu. Enter the
name of the object to be selected, then click OK. A dotted white
line with resize handles will appear around the selected object.
The Select All option selects all objects in the current model.

Specifying Model Type


After a model has been created and saved as a graphic, it may
later be used as a submodel. To convert a model from a
graphic to a submodel, perform the following:
1. Load the graphic into the Grafx editor.
2. Select Edit > Model Type > Submodel.
3. Click Save As > File. Enter a name that is different from
the name that was used to load the graphic, and click OK. The
model will be saved as a submodel with this name.
NOTE: It is important to use a new name for the submodel during the save as
operation. If the name of the original graphic is used, a graphic and a submodel
with the same name will exist, which can cause confusion.

Using Model Variables


Model Variables, on the edit menu, provides a way to incorporate dynamic data from the global database into graphic displays. Model variables works in conjunction with the Custom
Dynamics menu item (refer to Creating Custom Dynamics).

2 - 42

WBPEEUI340020B1

Window Operations

Window Operations
Window on the Grafx window menu bar provides features
which allow control of the number and arrangement of
windows. Click Window.
New Window

To open another window containing the same contents as the


currently selected window, select Window > New Window from
the Grafx window menu bar.
The windows opened in this way are multiple views of the
same graphic, and an identifying number is appended to the
file name in the title bar to differentiate the views; for example:
agitator:1, agitator:2, and agitator:3. These views are interdependent; changes made to the graphic in one view will be
reflected in any other open views of the graphic.

Cascade

Cascade and Tile are used to rearrange windows so that all are
visible in the Grafx editor window. The cascade option causes
the windows to overlap so that each title bar is visible.

Tile

Click Tile to arrange the open windows in smaller sizes to fit


next to each other in the Grafx editor window.

Arrange Icons

If windows have been iconified, use Arrange Icons to arrange


the icons neatly within the Grafx editor window.

Window List

The bottom portion of the window menu contains a list of windows which are currently open in the graphics configuration
window. The number of the window, the name of the submodel
or graphic it contains, and the model type (graphic or submodel) are included in the list. If unsaved changes have been
made in the window, an asterisk (*) will be displayed following
the model type. When one of the entries in the list is clicked
on, the associated window will be selected; it will also be
raised, if necessary.

Dynamics
Dynamics are specifications for changes in graphic objects.
These changes can be in response to changes in variables such
as atoms in a controller. For example, when an atom changes
state or value, this can be translated into a graphical change
in a screen object, such as a color change of a filled rectangle.

WBPEEUI340020B1

2 - 43

Dynamics

Dynamics can also specify nongraphic actions, to be


performed in response to user actions, such as vectoring to a
different display or changing the set point of a control module.
Dynamics can be configured by several methods. To access a
menu, right click on the object for which dynamic attributes
are to be configured. The following options are used in
configuring dynamic attributes.
Configure Submodel

Dynamics defined in a submodel can be configured (customized) for an instance of that submodel.

Dynamic Attributes

Dynamics which affect a limited set of graphic attributes of an


object or submodel, based on the value of a user-defined
expression.

Custom Dynamics

Custom dynamics can be created, using the GML language.

Configuring Dynamic Attributes


To configure dynamic attributes for an object. Right click on
the object and select Dynamic Attributes. The expression
dynamics window will be displayed.
The expression entry box on the expression dynamics window
allows entering mathematical operators, parentheses, variables and data values in a syntax like that of the C programming language, to create an expression which can be true (1)
or false (0). Below the expression entry box are two sets of
attributes with associated toggle buttons and entry boxes. The
first set of attributes is True; the second set is False. This
allows the dynamic attributes of an object to be configured
separately for both true and false conditions, after the expression has been configured. Dynamic attributes which can be
configured via the expression dynamics window include:

2 - 44

Visibility.
Text.
Text color.
Fill.
Fill color.
Fill pattern.
Line color.
Line style.
Line width.
Blink.

WBPEEUI340020B1

Dynamics

Spin.

Examples are provided in Dynamic Attribute Settings.


NOTE: Configuring an expression (or set of expressions) which exceeds 3500
bytes for a given object will cause an error message to be displayed.

Configuring the Expression


Operators are symbols used in expressions to represent arithmetic, logical, or relational operations. An expression consists
of operators and operands, or values. Operands used in these
expressions can be of the following types:

Database point (in the form tag name.atom) - the current


value of the atom is used in the expression.

Numeric constant.

Variable name, such as length, can be used if the model


loaded in the Grafx editor is a submodel (if the entry for the
less than operator the example could be written
LENGTH < 100, instead of LIC-454.PV < 100).

In the examples in the following tableTable 2-5, several database points are used as operands.
Table 2-5. Operator Usage - Description and Examples
Operator Description

Usage

Example

<

Less than

Evaluates two expressions and is true if the LIC-454.PV < 100


one on the left is less than the one on the
right.

<=

Less than or Evaluates two expressions and is true if the LIC-454.PV <= 100.7
equal to
one on the left is less than or equal to the
one on the right.

>

Greater
than

Evaluates two expressions and is true if the LIC-454.PV > LIC-454.SP


one on the left is greater than the one on
the right.

>=

Greater
than or
equal to

Evaluates two expressions and is true if the LIC-454.PV > = 0.25


one on the left is greater than or equal to
the one on the right.

==

Equal

Evaluates two expressions and is true if the FIC-477.INHB == 0


one on the left is equal to the one on the
right.

WBPEEUI340020B1

2 - 45

Dynamics
Table 2-5. Operator Usage - Description and Examples (continued)
Operator Description

Usage

Example

!=

Not equal

Evaluates two expressions and is true if


they are not equal.

Add

Causes the two values on either side of it to LIC-454.PV + LIC-454.SP


be added together yielding the sum of the
> 500
two values.

Subtract

Number after the - sign is subtracted from


the number before the sign.

FIC-477.OUTPUT LIC-454.SP == 0

Multiply

Multiplies the values on either side of it,


yielding the product of the two values.

LIC-454.PV * 0.5 < 4658.0

Divide

Value to the left of the / is divided by the


value to the right.

(LIC-454.PV + 500) / 2 >


FIC-477.OUTPUT

Minus

Indicate or change the algebraic sign of a


value. This is a unary operator which takes
just one operand.

FIC-477.OUTPUT > -50

Logical not

Evaluates the expression on the right and is !FIC-477.UNACK


true if that expression is false, and vice
versa.

&&

Logical and

Evaluates two expressions and is true if and FIC-477.UNACK&&FIC-47


only if both are true.
7.INHB

Logical or

Evaluates two expressions and is true if


either one or both are true.

||

FIC-477.UNACK= 0

LIC-454.PV - LIC-454.SP <


0.5 || LIC-454.SP LIC-454.PV < 0.5

Because expressions can be complex, and often include multiple operators and operands, a set of rules exists to determine
which operators get performed first, which get performed second, third, and so on. This order is known as precedence.
Some operators, such as * (multiply) and / (divide) have equal
precedence. If operators of equal precedence are used in an
expression, they are performed according to the order in which
they appear in the expression, left-to-right. The unary
operators ! (logical not) and - (minus) are exceptions to this
rule and are evaluated right-to-left; unary operators act on
just one operand. All other operators which can be used in a
DYNAMICS expression are binary operators, and act on two
operands.

2 - 46

WBPEEUI340020B1

Dynamics

Precedence is an important concept to remember, as its effects


on the evaluation of an expression can confuse the unwary.
For example, consider the following expression:
2+3*4
The resulting value of this expression is 14, not 20. Because
the* (multiplication) operand has a higher precedence than the
+ (addition) operand, the multiplication portion of the
expression (3*4) is performed first. If the expression were
written:
(2 + 3) * 4
the value of the expression would be 20, because expressions
contained within parentheses are evaluated first.
The following table 2-6 contains a list of the operators which
can be used in a dynamics expression. In this table, the operators with equal precedence are grouped together. Operator
groups with higher precedence are located higher in the table.
Table 2-6. Operators in Order of Precedence
Symbol
()

Parentheses

Logical not (unary)

Minus (unary)

Multiply

Divide

Add

Subtract

<

Less than

<=

Less than or equal

>

Greater than

>=

Less than or equal

==

Equal

!=

Not equal

&&
ll

WBPEEUI340020B1

Description

Logical AND
Logical OR

2 - 47

Dynamics

In addition to the symbols listed in Table 2-6, aliases exist for


some operators. These aliases, listed in the following tableTable 2-7, are provided as an aid to the user. They can only be
used when creating an expression. Once the expression has
been saved, the aliases will be replaced by the standard operator symbols. Aliases must be entered in upper case letters, and
must be separated from adjacent operands by spaces.
Table 2-7. Operator Aliases
Alias

Standard Symbol

GT

>

GE

>=

LT

<

LE

<=

EQ

==

==

NE

!=

OR

ll

AND

&&

NOT

Expression True
Entering a single tagname.atom or mathematical expression,
as described previously, allows the user to configure dynamic
attributes for selected objects. Type the word TRUE in the
entry box. Change the attributes of the submodel by entering
values in the row of attribute setting boxes labeled True.
It is also possible to configure the static attributes of submodels via the expression dynamics window. This is not recommended, however, as this method is time consuming and
inefficient when compared with object configuration performed
directly from the Settings Window and Properties Window
described in this section.

Grouped Objects and Expressions


A group of objects and submodels can be configured so that
they are all affected by the same expression. Items should be
grouped prior to selecting the Dynamic Attributes item. To
group objects together, hold SHIFT down and click on all objects

2 - 48

WBPEEUI340020B1

Dynamics

to be in the group, then click on the group button on the view


toolbar.
Once a set of objects has been placed in a group, any
operations will be performed on all objects in the group.
The ungroup item on the view toolbar will remove all objects
from the group. Any dynamics attached to the group via the
dynamic attributes entry will be deleted.

Multiple Expressions
More than one expression can be configured for an object. This
is useful if the object attributes should change under more
than one condition. For example, a filled rectangle can be
configured to be:

Green when the value of a database point is less than 50.


Yellow when the value is between 50 and 100.
Red when the value is above 100.

To add another expression, click New in the expression


dynamics window. The label above the expression entry box
will change to:
Expression(n of m)
where m is the total number of expressions for this object, and
n is the expression currently displayed. Use the Prev and Next
buttons to move between configured expressions.
To delete the expression currently on display, click Clear.
To make permanent any changes to the expression dynamics
window, click OK or Apply.
To view a list which summarizes all the expressions and associated attribute settings which have been configured for an
object, click List. The expressions window will be displayed.
Click an expression in the list to displayed it in the expression
dynamics window. To close the expressions window, click OK.
NOTES: It is not necessary to configure both True and False attribute settings
for an expression.
An expression is considered active when it evaluates to true
and has settings for true, or when it evaluates to false and has
settings for false. While expressions can be configured so that

WBPEEUI340020B1

2 - 49

Dynamics

only one expression is active at a time, it is also possible to


configure expressions so that this is not the case.
Example 1

An object has more than one active expression. The expressions are evaluated, and their settings applied, in the order in
which they were defined. This means that the effects of an
expression with a low number may be overridden by an
expression with a higher number.

Example 2

An object has no active expressions. If none of the expressions


with True, settings are true, and none of the expressions with
False, settings are false, then the object is not changed.

Dynamic Attribute Settings


Below the expression entry box are two rows of attribute setting boxes. The first row is labeled True; a text description and
toggle button are located at the top of each attribute setting
box. Assignments configured here control the appearance of
the selected object or submodel when the expression in the
expression entry box evaluates to true (1).
Below this section of the expression dynamics window is a second row of attribute setting boxes, identical to the first, except
these are labeled False. These assignments control the
appearance of the selected item when the expression in the
expression entry box evaluates to false (0).
A value or variable can be entered in each of the attribute setting boxes which contains a entry box. If a variable is entered
in an attribute setting box, and the object is saved as a submodel, that variable can later be used via the Configure Submodel menu item to assign the attribute independently, for
each instance of the submodel. This is particularly useful
when a submodel is used more than once when creating a new
submodel. For example, if a submodel called FP_DYbargraph
contains a variable called TagAtom, and FP_DYbargraph is
used twice on a new submodel, this variable could be assigned
the variable name TagAtom1 in the first instance, and
TagAtom2 in the second instance.
Some attribute setting boxes contain a button instead of an
entry box. Click this button to configure the attribute setting.
In some attribute setting boxes, the button toggles between
two states (Yes and No), while in others the button provides
access to additional configuration windows.

2 - 50

WBPEEUI340020B1

Dynamics

Click in the Text/Toggle button portion or in the Button/Text


entry portion to select the attribute for configuration. If neither
portion of the attribute setting box is clicked on, the attribute
will remain unaffected. If the attribute is selected but no entry
is made in the entry box, the attribute definition will use the
attribute default value.
Each attribute has a default value, and except for the text
attribute, and some blink and spin attribute parameters, a
minimum and maximum permitted value. The default value is
used when the attribute entry box has been clicked on but no
entry is made, or when the value entered is outside the range
of the permitted values (less than the minimum or greater

WBPEEUI340020B1

2 - 51

Dynamics

than the maximum). Default values for the attributes are


shown in the following tableTable 2-9.
Table 2-8. Attribute Default Value
Attribute

Default

Minimum

Maximum

Blink color 1

1 (white)

511

Blink color 2

0 (black)

511

Blink duration 1

1 (blink periods)

None

Blink duration 2

1 (blink periods)

None

Blink period

5 (tenths of a second)

None

Blink phase

0 (blink periods)

None

Fill color

0 (black)

511

Filled

1 (filled)

Line color

0 (black)

511

Line style

1 (solid line)

Line width

1 (narrow)

Pattern

1 (solid fill)

Spin angle

20 (degrees)

-180

+180

Spin period

5 (tenths of a second)

None

Steady color

7 (white)

Text

Empty string ( )

511

None

None

Text color

0 (black)

511

Visible

1 (visible)

NOTE: It is possible to configure dynamic attributes which are unnecessary for


an object; configuration of such items will have no effect on the object. For
example, if the object is a straight line, and the Filled attribute is configured, it
will have no effect on the appearance of the line.
Table 2-9. Attribute Default Value
Attribute

2 - 52

Default

Minimum

Maximum

Blink color 1

1 (white)

511

Blink color 2

0 (black)

511

Blink duration 1

1 (blink periods)

None

Blink duration 2

1 (blink periods)

None

Blink period

5 (tenths of a second)

None

Blink phase

0 (blink periods)

None

WBPEEUI340020B1

Dynamics
Table 2-9. Attribute Default Value

(continued)

Attribute

Default

Minimum

Maximum

Fill color

0 (black)

511

Filled

1 (filled)

Line color

0 (black)

511

Line style

1 (solid line)

Line width

1 (narrow)

Pattern

1 (solid fill)

Spin angle

20 (degrees)

-180

+180

Spin period

5 (tenths of a second)

None

Steady color

7 (white)

Text

Empty string ( )

511

None

None

Text color

0 (black)

511

Visible

1 (visible)

Text Attributes. The text attribute is used to change the text


string in a text object or filled text rectangle. It does not change
text size or font, and it cannot be used to change text in a previously configured submodel. If the attribute box is selected
and nothing is entered, the string defaults to an empty string
( ).
Visible Attributes. The visible attribute is used to configure the
selected object to be visible, invisible, or redrawn when the
expression evaluates to true or false. If the toggle button for
the attribute is selected, the face of the selection button will
display the word Yes (visible, the default), Redraw, or No
(invisible). Clicking the selection button will cause it to cycle
through these three states. The visible/invisible attributes are
useful, for example, if an object containing a warning message
is to be visible only under certain conditions. The redraw
attribute is equivalent to the yes attribute, but with the additional feature that the object will be redrawn each time the
value of the expression (or any tag name or variable used in
the expression) which governs it changes. This is useful for
objects which overlap and must remain on top of some
dynamic object.
Filled Attributes. Use the filled attribute to configure the selected
object to be filled or unfilled when the expression evaluates to
true or false. If the toggle button for the attribute is selected,

WBPEEUI340020B1

2 - 53

Dynamics

the face of the selection button will display the word Yes (the
default) or No. Clicking the selection button will cause it to
toggle back and forth between Yes (filled) and No (unfilled).
Fill Color Attributes. Use the fill color attribute to configure the fill
color of the selected object. With the toggle button for the
attribute selected, open the settings or properties window and
make sure the Fill tab is selected.
Click the desired color in the color palette. The number of the
selected color will appear in the entry box portion of the fill
color attribute setting box. Alternatively, the number of the
desired color can also be entered by typing the number in the
fill color entry box. If this attribute is selected and no entry is
made in this entry box, the attribute will default to black
(zero).
Line Color Attributes. The line color attribute affects both lines and
edges of objects in the selected object. With the toggle button
for the attribute selected, open the settings or properties
window and make sure the Lines tab is selected.
Click the desired color in the color palette. The number of the
selected color will appear in the entry box portion of the line
color attribute setting box. Alternatively, the number of the
desired color can also be entered by typing the number in the
line color entry box. If this attribute is selected and no entry is
made in this entry box, the attribute will default to black
(zero).
Text Color Attributes. The text color attribute affects text in the
selected object. With the toggle button for the attribute
selected, open the settings window and make sure the Text tab
is selected.
Click the desired color in the color palette. The number of the
selected color will appear in the entry box portion of the text
color attribute setting box. Alternatively, the number of the
desired color can also be entered by typing the number in the
text color entry box. If this attribute is selected and no entry is
made in this entry box, the attribute will default to black
(zero).
Line Style Attributes. The line style attribute affects edges and
lines in the selected object. The Lines tab on both the settings
and properties windows contains examples of the five different

2 - 54

WBPEEUI340020B1

Dynamics

line/edge styles, which are labeled from zero to four, and also
contains an indicator for each style. Enter the number of the
desired style in the line style entry box, by clicking on the
appropriate indicator in the settings or properties window, or
by entering the number. If this attribute is selected and no
entry is made in this entry box, the attribute will default to
solid line (one).
Line Width Attributes. Like the line style attribute, the line width
attribute affects edges and lines in the selected object. The
Lines tab on the settings and properties windows contains a
selection box which allows specifying a line/edge width by
selecting a number from one (the narrowest) to six (the widest).
Enter the number of the desired width in the line width entry
box, by clicking on the appropriate indicator in the settings or
properties window, or by entering the number. If this attribute
is selected and no entry is made in this entry box, the attribute
will default to narrow (one).
Pattern Attributes. The pattern attribute allows the user to specify
a fill pattern to be used in filled objects. Examples of available
fill patterns are displayed on the Fill tab of the settings and
properties windows. The patterns are labeled from zero to five.
Enter the number of the desired pattern in the pattern entry
box, by clicking on the appropriate indicator in the Fill tab of
the settings or properties window, or by entering the pattern
number. If this attribute is selected and no entry is made in
this entry box, the attribute will default to solid fill (one).
NOTE: To observe changes to submodel dynamics on a graphic in an operator
window, the graphic must be saved and set to running.
Blink Attributes. The multiphase blink attribute (available only on
objects in graphic displays) is used to cause an object to alternate between two colors when the expression is true, or to be
displayed steadily in a third color when the expression is false.
Click within the blink attribute setting box to select the
attribute; the blink window will appear.
Use the entry boxes in the blink window to enter values for the
following parameters:

WBPEEUI340020B1

Period.
Phase.
Blink color 1.

2 - 55

Dynamics

Duration 1.
Blink Color 2.
Duration 2.
Steady Color.
Fill Only.

The Period is the blink period, which is measured in tenths of a


second. The number entered here defines how many tenths of
a second are in the blink period for this object. The minimum
value for the period is one (one tenth of a second); the default
value for the period is five ( second).
The Phase is the initial delay time (in blink periods) which
elapses before blinking starts after the expression becomes
true. By using different phase values for different objects,
motion can be simulated. The phase value is multiplied by the
period to determine how long (in tenths of a second) to delay
the start of blinking. Both the minimum and default value for
this parameter is zero.
Blink Color 1 is the first of the two blink colors between which
the object will alternate. Enter this value by clicking on the
desired color in the color palette on any tab display in the
settings or properties windows, or by typing it in.
The value entered for Duration 1 is multiplied by the Period to
determine how long (how many tenths of a second) the object
will be displayed in Blink Color 1. Both the minimum value and
default value for this parameter are one.
Blink Color 2 is the second of the two blink colors between
which the object will alternate. Enter this value by clicking on
the desired color in the color palette on any tab display in the
settings or properties windows, or by typing it in.
The value entered for Duration 2 is multiplied by the Period to
determine how long (how many tenths of a second) the object
will be displayed in Blink Color 2. Both the minimum value and
default value for this parameter are one.
The Steady Color parameter is used to define the non blinking
color in which the object will be displayed when the expression
is false. Like Blink Colors 1 and 2, this value can be entered by
clicking on the desired color in the color palette on any tab display in the settings or properties windows, or by typing it in.
As discussed in Multiple Expressions, multiple expressions

2 - 56

WBPEEUI340020B1

Dynamics

can be configured for an object or group of objects. Expressions are evaluated in the order that they were defined. This
means that the effects of Expression one may be overwritten
by a subsequent expression 10. When multiple color-controlling expressions have been defined for an object, assigning the
value -1 to the steady color parameter causes the object to be
displayed in the last color used (when the expression controlling the blink attribute evaluates to False). The default setting
for the steady color parameter is -1.
The Fill Only parameter is designed for use with objects that
belong to the same group. If the Fill Only parameter is set to
false (0), then all portions of all objects in the group (the fill
color, line color and text color [if any]) will change color when
either Blink or Steady Color parameters are in effect. If the Fill
Only attribute is set to true (1), then only the fill color of
objects in the group will be changed, while other attributes of
objects (line color, text color) remain unaffected. The Fill Only
parameter is visible on the blink configuration window only
when a group of objects is being configured. The default
setting for the Fill Only parameter is true (1).
Spin Attribute. The Spin attribute causes an object to be rotated
about its reference point in periodic increments, for as long as
the expression is true. Click within the Spin box to select the
attribute. The spin configuration window will appear.
Use the spin configuration window to enter values for the
following parameters:

Period.
Angle.

As in the Blink attribute, the Period parameter for the Spin


attribute is measured in tenths of a second. The number
entered for this parameter defines the length of time it will take
(in tenths of a second) for the object to be moved the number of
degrees specified in the Angle parameter. The minimum value
for the spin period is three (tenths of a second), the default is
five ( second).
The number entered in the Angle parameter entry box specifies
the number of degrees the object will turn per period. A positive number results in counterclockwise movement, while a

WBPEEUI340020B1

2 - 57

Dynamics

negative number causes clockwise movement. When the


expression is false, the object returns to its original position.
NOTE: The spin feature is already incorporated in the dynamic submodels
FP_DYwheel, FP_DYpump_rt and FP_DYpump_lf, which are supplied by ABB.
Combining Attributes. When either the Blink or Spin attribute is
selected, all other attributes are stippled out and made
unavailable. It is possible to combine the Blink and Spin
attributes with the other dynamic attributes and with each
other by using multiple expressions, and creating a separate
expression each for the Blink attribute, the Spin attribute and
all other attributes. Avoid configuring two different sets of
Blink (or Spin) dynamics (for the same object) which could be
true simultaneously, as this can cause unpredictable results.

Configuring Submodels
A submodel may already contain internal dynamics, configured by ABB or during an earlier configuration session. The
submodel configuration window is used to assign values which
can be in the form of database points to dynamic variables.
Use one of the following methods to display this window:

Double click on the desired submodel.


Click the submodel, right click, select Configure Submodel.
Select Edit > Object > Configure Submodel.

The selected submodel will be highlighted by a surrounding


rectangle.
On the submodel configuration window, all variable names in
the submodel dynamics are listed on the left. Next to each
variable is an entry box, which contains any value which has
been assigned to the variable during configuration. If no value
has been assigned to a variable, the entry box is blank.
The value which can be assigned to a variable can be one of
the following types:

2 - 58

A numeric constant.

A string constant.

A point (tagname.atom).

WBPEEUI340020B1

Dynamics

A different variable type (if the current model type is


defined as submodel).

An expression.

Following each entry box is Expand Entry. To view the complete text string or expression, click on this button. A window
will be displayed. This window contains an enlarged, scrollable
version of the associated entry box. The variable value can be
edited in this window, and can be up to 128 characters in
length. Click OK to exit and save any changes.
Example 4 in Dynamic Configuration Examples, shows the
configuration of a user-created submodel. The list of dynamic
ABB submodels and their variables can be found in
Appendix A for a list of dynamic ABB submodels and their
variables.

Custom Dynamics
As described above, Iit is possible to configure complex
dynamic properties for an object using the Dynamic Attributes
menu item. The dynamics which can be configured using this
method may not be adequate for all applications. However, the
context menu item, Custom Dynamics, allows configuration of
additional dynamic properties.

Creating Custom Dynamics


Custom dynamic properties can be configured using DynProps
to give an object dynamic properties which are not available
using the methods described previously. Configuration using
DynProps, however, is also more complex. DynProps are text
statements containing descriptions of dynamic behavior, written using the GML language syntax. Section 4 for a provides
descriptions of the DynProp code functions available for custom dynamics.
Configuring DynProps. Select the Create Custom Dynamics item
from the dynamics menu to display the DynProp, if any,
attached to the currently selected object. The text of the
DynProp is displayed in the edit custom dynamics window
(Fig. 2-22).
Modify the DynProp by adding or deleting text, then click OK.
If the syntax of the DynProp is correct, the edit custom dynam-

WBPEEUI340020B1

2 - 59

Dynamics

TC00193A

Figure 2-22. Edit Custom Dynamics Window

ics window will close. If the syntax is incorrect, an error message will appear and the window will remain on display. Refer
to DynProp Syntax for syntax information.
Click Format to automatically indent the DynProp text
according to convention. This function will not change the text.
DynProp Variables. A DynProp will contain references to variables.
For example, the fill color of an object in a submodel can be
changed using the following DynProp.
(* (fcolor bar_color))
In this example, bar_color is a variable. The DynProp is then
saved by clicking OK and exiting the edit custom dynamics
window. The submodel must be saved using Save, Save As or
Install Current from the file menu.
After this submodel is inserted into a graphic, the variable
bar_color will appear in the list of variables in the submodel
configuration window for this submodel. Enter a valid color
index number in the entry box to assign that number as the
value of the variable.
In other cases, it may be desirable to have the value of a variable retrieved from the tag database when the graphic is displayed in the operator window. In such cases, use a variable
name as the value.

DynProp Syntax
There are three types of syntax available for custom dynamics.
Refer to DynProp Examples for syntax format examples.

2 - 60

WBPEEUI340020B1

Dynamics
Unconditional (Direct)

(*
(action <argument >)
(...))

In an unconditional dynamic the action is performed when any


change to the argument occurs.
Conditional with a Value

(reference
(= value
(action <argument >)
(...)))

A conditional dynamic using a value in the logical statement is


performed when the value of the reference causes a true
result.
Conditional with an
Asterisk

(reference
(= *
(action <argument >)
(...)))

When an asterisk (*) is used in place of a value in a conditional


dynamic, the action is performed when any change to the
argument occurs.
Conditional with a Value
Range

(reference
(= value1:value2
(action <argument >)
(...)))

A conditional dynamic with a value range statement is performed


when the reference value is within the specified value range.
The reference is a name which includes letters A through Z or
a through z, digits zero through nine, or characters $, _, and #.
The reference must begin with an alphabetic or a $. The characters $ and # have special meanings when used within Conductor NT. The # character is an escape character used to
specify characters that would be invalid (#d is the decimal
point). The $ character is used as a string delimiter, specifying
a name used within a symbol which must be replaced by an
actual value when the symbol is used in a graphic.
Also the reference could be a function call from the standard C
language math library (sin, cos, tan). Refer to Section 4 for a
list of the C Math functions.
Lastly the reference can be a mathematical expression. This
expression can contain variables and constants. The constants
WBPEEUI340020B1

2 - 61

Dynamics

can be integer or real numbers but when used with variables


they must correspond to the variable type. A list of operators
for the mathematical expressions can be found in Section 4 for
a list of operators for the mathematical expressions. To declare
variables, refer to Configuring Model Variables.
The value is a numeric value or a variable. When a range of
values is used the values can be a mix of variables and numerics (10:100, 10:_pHiLimit, or _pLowLimit:100).
The action is any of the actions listed in Section 4 for a list of
any of the actions. A dynamic description can have more than
one action. In a multiple action statement the actions are performed in the order that they are read.

DynProp Examples
The following examples of DynProps are theoretical and
assume the variable names are configured and all values are
available for use.
Example 1

An unconditional direct DynPop that changes the percent fill of a filled


rectangle when the value of the variable pressure changes:
(*
(fpercent pressure))

Example 2

A conditional DynPop that changes the color of a filled rectangle to red when
the value of the variable pressure exceeds the value of 90:
(pressure
(> =90
(fcolor 1)))

Example 3

A conditional DynProp, with a value range, that will return the color of the
filled rectangle to green when the pressure is between the values of 20 and
90, and change the fill percent of the rectangle to the pressure value.
(pressure
(=20:90
(fcolor 2)
(fpercent pressure)))

Configuring Model Variables


Model Variables, found on the edit menu, provides a way to
incorporate dynamic data from the global database into
graphic displays. Model Variables works in conjunction with
Custom Dynamics. For example, a text object can be config-

2 - 62

WBPEEUI340020B1

Dynamics

ured to display the value of a set point (SP) atom in the global
database on a graphic display. This could also be done using
the FP_DYvalue submodel., described in Appendix A for a
description. To do so, first configure the DynProp for the text
object as follows:
(* (stext _psetpoint "%.1f"))

For this example, the tag name used for the point in the global
database is PIC-1515.
Next, the value of the variable _psetpoint must be tied to the
value of the desired tag.atom in the global database (this
example, uses PIC-1515.SP). To do so, click on the Model
Variables menu item. The variables window will be displayed.
The variables window contains a list box. Once a variable has
been configured, it will occupy a line in the list box, with the
private name of the variable on the left side of the entry, and
the corresponding public name on the right. The private name
of a variable is the name used in the DynProp, ( _psetpoint in
this example). The public name of a variable defines the
global database point which supplies the value for the variable
(PIC-1515.SP in this example).
To create a new variable, click Add. The declare variables
window appears.
The top of this window contains the entry boxes: Private Name,
Public Name, and Suffix. Enter the private name in the first
box; it must begin with the prefix _p. If this prefix is not
entered by the user, it will be prepended automatically.
Enter the public name in the second box. If the model being
configured is a graphic, the public name is automatically
enclosed in quotation marks, and should be a tag.atom.
The third box, Suffix, is used when multiple variables using
the same tag name, but different atoms, are configured. It provides a user-friendly alternative to the string substitution feature described in Naming Variables in this section. The string
to be used at the end of the variable name is entered in the
Suffix box. This can be an atom name only (SP), or can include
a standardized ending to a tag name (101.SP).

WBPEEUI340020B1

2 - 63

Dynamics

If no period is detected in either the public name or the suffix,


then one will automatically be placed between the two strings
at run-time.
The declare variables window is also used to specify how the
value should be collected from the global database, once the
configured graphic is on display in the operator window. A set
of three type buttons is used to specify the type of value to be
collected. The available types include:

Float.
Integer.
Text string (tag names, legends, and so on).

Use the type Float (the default) if the variable type is numeric
but could be either floating point or integer. For the purposes
of this example, the SP atom has a floating point value, so type
float would be selected.
Below the type selection area is an entry box, Size, which is
used to specify array variables. Entering a value greater than
one declares an array the size of the value entered. If the size is
one (the default), then the variable is not an array. For the
purposes of this example, a size of one would be used.
Below the size entry box is the collection definition area. The
selections available here include:

Normal.
One shot.

These choices, each of which is accompanied by a button, are


used to specify how often the value is to be collected from the
global database. A normal collection is performed once each
second (or every two seconds if the model is in an operator
window which does not have keyboard focus). A one shot collection is performed only once, when the graphic is first called
up in an operator window. In this example, the value of
PIC-1515.SP is to be updated, so a Normal collection would be
chosen. Click OK to complete the variable declaration and exit
the window.
Once a variable is declared, it will appear in the list box in the
variables window. To change a variable declaration, select the
desired item on this list, then click Edit. A window will display
the parameters of that declaration.

2 - 64

WBPEEUI340020B1

Dynamics

To see how many objects in a model have DynProps that reference a variable, select the variable by clicking on it in the list
box, then click References. A window will display the count of
such objects.
To delete a variable, click on the appropriate entry in the list
box, then click Delete. A variable can be deleted only if it is not
referenced by any object in the model; otherwise an
error message will appear.

Declaring Variables in Submodels


When declaring a variable in a graphic, the public name of the
variable must be the name of a point in the global database (a
tag.atom). This is not necessary when declaring a variable in a
submodel. Here, the public name can be a generic name. This
allows the public name to be assigned to a tag.atom or a
constant each time an instance of the submodel is configured
on a graphic.
NOTE: Quotation marks should not be placed around the public name if the
model being configured is a submodel unless it is the name of a tag.atom.
When configuring dynamic objects on a submodel, the type submodel should
be specified via the Model Type option on the edit menu before attempting to
use the Model Variables menu item. If this order is not followed, quotation
marks will automatically be placed around the public name and will cause an
error.
No change is required to the DynProp; the following version
remains a valid example:
(* (stext _psetpoint "%.1f"))

The name _psetpoint would remain the private name for the
variable, but the public name would now be configured as
some generic name such as setpoint instead of PIC-1515.SP.
When an instance of a submodel is configured on a graphic
(using Configure Submodel), setpoint will appear in the list of
variables for the submodel. Assign the name of a tag.atom, or
a numeric constant will be assigned to the variable.

Naming Variables
The following naming conventions apply to variable names:

WBPEEUI340020B1

A variable name can be up to 60 characters in length.

2 - 65

Dynamics

The first character of a variable name must be a letter.


A variable name cannot contain spaces.

Subsequent characters can be letters, numbers, or the underscore character. With few exceptions (described below), no
other characters should be used. The dash (-) is especially to
be avoided, since that character is interpreted as the subtraction operator.
Exceptions to the above naming conventions are:

The private name of a variable must begin with _p.

Pairs of dollar sign ($) characters can be used in the public


name of a variable in a submodel, as part of the string
substitution feature described below.

When an instance of a submodel is configured on a graphic,


supply values for the submodel variables, as described in
Configuring Submodels and Declaring Variables in Submodels.
A string substitution feature is available which allows configuration of multiple variables which share a characteristic, such
as the same tag name, or the same atom type.
NOTE: When declaring multiple variables in a submodel, provision is made in
the declare variables window to enter the public name and suffix separately
before applying them. This ability provides an alternative to the string
substitution method described here.
The string substitution feature also provides a way to configure a submodel that will display several different atoms from
the same tag name. If the atom names are known, the string
substitution feature can be used to declare variables for the
submodel in such a way that only the tag name must be
supplied when an instance of the submodel is configured.
To use this feature, the part of the variable name that will
assume the same value in all cases must be enclosed between
$ characters. In example 1, the following variables names
could be configured for a submodel, using the declare
variables window:
Example 1:

2 - 66

$tag$PV
$tag$SP
$tag$OUTPUT

WBPEEUI340020B1

Dynamics

Save the submodel, then place an instance of it on a graphic


and select the instance. Select Context > Configure Submodel.
When the submodel configuration window is displayed, only
the string tag will appear as a variable that needs to be configured, rather than a separate entry for each atom. Enter the tag
name followed by a period (.), (PIC-1515). In the submodel, this
will result in the replacement of the string tag with the string
PIC-1515 in each of the three variables, as follows.
$tag$PV = PIC-1515.PV
$tag$SP = PIC-1515.SP
$tag$OUTPUT = PIC-1515.OUTPUT
All three variables were configured in the submodel by
supplying one value, namely the value of the string for tag.
The period (.) must be entered after the tag name, otherwise
erroneous values such as PIC-1515PV would result. While the
period (.) alone cannot be included in the variable name
($tag.$PV is not a legal variable name), it can be used when
preceded by a backslash character ( \.). Alternatively, the
sequence #d can be used in the variable name to represent a
period. Both of these methods are shown in example 2.
Example 2:

$tag$\.PV
or
$tag$#dPV
$tag$\.SP
or
$tag$#dSP
$tag$\.OUTPUT or
$tag$#dOUTPUT
If these variable names are used, only the tag name (PIC-1515)
has to be supplied when configuring the submodel.
A submodel could be designed to show the value of the same
atom from 10 different tag names. Since the atom name is the
same in all 10 cases, string substitution could be used in
naming the variables, as follows:
$tag1$#d$atom$
$tag2$#d$atom$
$tag3$#d$atom$
.
.
.
$tag10$#d$atom$
When an instance of this submodel is configured, the submodel configuration window will contain 11 variables to configure, one named atom and the 10 tagn variables. If the #d

WBPEEUI340020B1

2 - 67

Dynamics

sequence is not used, the period (.) should be supplied as part


of the atom name. It is necessary to enclose both the atom and
tagn portions of the variable names between $ characters, so
that both portions of the variable name can be configured.
It may be necessary to include an array index number in a
variable name. Like the period, the square brackets ([ ]) cannot
be included directly in variables; they can, however, be used
when each is preceded by a backslash character. For example,
\[n\] can the used to represent an array index, where n represents the index number. Alternatively, #n can also be used to
represent the array index. The following examples show two
possible alternatives to represent the same item:
$tag$\.PV\[3\] or $tag$#dPV#3

The array index number represented by n must be an integer.


NOTE: The index number can, like the tag name, be assigned as a variable
($tag$\.PV\[$INDEX$\] or $tag$#dPV#$INDEX$).
In this case, both tag and index can be assigned values when
configuring an instance of the submodel which uses this
variable.
It is important to remember that string substitution in variable
names, as described in this subsection, occurs at the time an
instance of a submodel is configured on a graphic. If the submodel itself is later changed to use additional variables containing the same or other substitute strings, then all instances
of that submodel will need to be reconfigured on graphics
which use the submodel.
If the only change made to the submodel was to add variable
names using the same substitute string ($tag$) as used previously in the submodel, then for each graphic the user needs
only to select each instance of the submodel, select
Context > Configure Submodel, click OK in the submodel
configuration window, then install the graphic.

Dynamic Configuration Examples


The following sections provide practical examples of
configuring dynamics for submodels.

2 - 68

WBPEEUI340020B1

Dynamics

Example 1 - Single Expression


Process Conditions:

A valve has one limit switch (tag name VLV101). VLV101 is


closed (VLV101.OUTPUT=1) when the valve (VLV101) is open
(VLV101.OUTPUT=0).

Objective:

Assign dynamics to an instance of submodel ISA_VLVE_ACTR


on a graphic so that the submodel instance is filled in white
when the valve is open and is unfilled (filled with black) when
the valve is closed.

Procedure:

1. Make an instance of symbol ISA_VLVE_ACTR on a graphic.


2. With the submodel still selected, select
Dynamics > Configure Attributes in the graphic configuration
window menu bar. The expression dynamics window will
appear.
3. Configure the expression and settings from the following
table:
Expression
VLV101.OUTPUT

True

False

Fill color = 7

Fill color = 0

Example 2 - Multiple Expressions


Process Conditions:

A valve has two limit switches (tag names VLV101 and


VLV102). VLV101 is closed (VLV101.OUTPUT=1) when the
valve is open and VLV102 is closed (VLV102.OUTPUT=1) when
the valve is closed.

Objective:

Assign dynamics to an instance of the submodel


ISA_VLVE_ACTR on a graphic so that the submodel instance is
filled in white when the valve is open, unfilled when the valve
is closed, and filled in yellow when the state is unknown (both
limit switches open or closed).

Procedure:

1. Make an instance of symbol ISA_VLVE_ACTR on a graphic.


2. With the submodel still selected, select
Dynamics > Configure Attributes in the graphic configuration
window menu bar. The expression dynamics window will
appear.
3. Configure the expressions and settings from the following
table:

WBPEEUI340020B1

2 - 69

Dynamics

No.

Expression

True

False

VLV101.OUTPUT=1 &&
VLV102.OUTPUT=0

Fill color = 7

None

VLV102.OUTPUT=1 &&
VLV101.OUTPUT=0

Fill color = 0

None

VLV101.OUTPUT=0 &&
VLV102.OUTPUT=0

Fill color = 3

None

VLV101.OUTPUT=1 &&
VLV102.OUTPUT=1

Fill color = 3

None

Example 3 - Using the True Expression


Process Conditions:

None.

Objective:

Make a static instance of the submodel ISA_VLVE_ACTR. Set


the color of the valve to cyan.

Procedure:

1. Make an instance of symbol ISA_VLVE_ACTR on a graphic.


2. With the submodel still selected, select
Dynamics > Configure Attributes in the graphic configuration
window menu bar. The expression dynamics window will
appear.
3. Configure the expression and settings from this table.
Expression
TRUE

True
Fill color = 6

False
None

Example 4 - Creating a New Submodel with Dynamics


Process Conditions:

None.

Objective:

Create a new submodel, DynamicValue, with the same dynamics as the submodel instance shown in Example 2 - Multiple
Expressions. Use variable names in place of control system
database points so that instances of dynamic value can be
configured for different control system database points.

Procedure:

1. From the file menu in the graphic configuration window


menu bar, open the symbol ISA_VLVE_ACTR. The Model Type
changes to Submodel.
2. Select Select > All.

2 - 70

WBPEEUI340020B1

Dynamics

3. Select Edit > Group.


4. Select Dynamics > Configure Attributes. In the resulting
expression dynamics window, configure the expressions and
settings from the following table.
No.

Expression

True

False

Fill color=7

None

closed_switch=1 && open_switch=0

Fill color=0

None

open_switch=0

&& closed_switch=0

Fill color=3

None

open_switch=1

&& closed_switch=1

Fill color=3

None

open_switch=1

&& closed_switch=0

5. Select File > Save As and enter the name DynamicValve


when prompted for the model name. The new submodel is now
placed in the disk location dedicated to storage of design
custom submodels (the design submodel directory).
6. Select File > Set Running.
NOTE: The submodel must be set to running before it can be used in an
running graphic.

Example 5 - Configuring Dynamic Submodels


Process Conditions:

Same as example 2.

Objective:

Configure an instance of the submodel dynamic valve that was


built in example 4.

Procedure:

1. Make an instance of dynamic valve on a graphic (from the


list of running submodels).
2. With the submodel still selected, select
Dynamics > Configure Submodel. The submodel configuration
window will appear. Configure the variables as shown in
Figure 2-23.

Example 6 - Simulating Motion Using the Blink Attribute


Process Conditions:
Objective:
Procedure:

WBPEEUI340020B1

None; true is used in all expressions in this example.


Simulate motion in a particular direction.
1. Create a new graphic model; select Options > File > New
> Graphic, if necessary.

2 - 71

Dynamics

2. Create instances of the items which will be used to emulate


motion. For the purposes of this example, create six short,
consecutive lines. Use the grid setting for the Snap option to
aid in keeping them neatly in line.

TC00196A

Figure 2-23. Submodel Variable Configuration Window

3. Click the first object, then select


Dynamics > Configure Attributes from the graphic
configuration window.
4. Configure the Expression in the expression dynamics window. For purposes of this example, enter TRUE. The same
expression should be used for all objects in the group
simulating motion.
5. Select Blink from the Settings When True area. Configure
the settings for each of the objects using settings listed in the
Table 2-10, repeating Steps 3 and 4 as necessary.
Table 2-10. Blink Settings
Line
Segment

Expression

Period

Phase

Blink
Color 1

Duration
1

Blink
Color 2

Duration
2

Steady
Color

TRUE

15

15

TRUE

15

15

TRUE

15

15

2 - 72

WBPEEUI340020B1

Dynamics
Table 2-10. Blink Settings
Line
Segment

Expression

Period

Phase

Blink
Color 1

Duration
1

Blink
Color 2

Duration
2

Steady
Color

TRUE

15

15

TRUE

15

15

TRUE

15

15

6. Select File > Save and enter a name such as DynamicLine


when prompted for the model name. The new graphic is now
placed in the disk location dedicated to storage of design
graphics (the design graphics directory).
7. Select File > Set Running to set the model as a running
graphic display.
8. If the graphic set to running in Step 7 is displayed in an
operator window, it will appear as a gray line with a blue pulse
along it.
NOTE: The only setting which differs between the six objects is the phase setting; each segment is assigned a consecutively higher phase number, which
means that the blink cycle for that object will begin a tenth of a second after
that of its predecessor. Also, the values entered for duration one and duration
two added together equal the number of segments in the line. This allows the
first pulse to end just before the next begins.
Variations:

1. To make the blue pulse appear to move more slowly,


increase the length of the Period for all six segments (change
the value entered for this parameter from one to a higher
number).
2. To have two blue pulses move along the line in this example, decrease the value of duration two by changing the value
entered from five to two or three.
NOTE: After becoming more familiar with the Grafx editor, the number of steps
necessary to create a graphic such as this one can be decreased. For example, to create the original line with a color pulse, configure first line segment,
configure dynamics from scratch, and copied to create the additional five segments of the line. It is then only necessary to change the values configured in
the phase parameter for each segment.

WBPEEUI340020B1

2 - 73

Dynamics

Example 7 - Using Text to Indicate Conditions


Process Conditions:

Objective:

Switches on a tank indicating high level (LI101HL.OUTPUT)


and high high level (LI101HHL.OUTPUT) indicate alarm
conditions.
Display a text message on a graphic to indicate the condition
of these switches, using the parameters in Table 2-11.

Table 2-11. Input Conditions


Input Condition

Text

Color

LI101HL.OUTPUT = 0 and LI101HHL.OUTPUT = 0

Normal

Green

LI101HL.OUTPUT = 1 and LI101HHL.OUTPUT = 0

Hi level

Yellow

LI101HL.OUTPUT = 1 and LI101HHL.OUTPUT = 1

Hi hi level

Red

LI101HL.OUTPUT = 0 and LI101HHL.OUTPUT = 1

Unknown

White flash

Procedure:

1. Put a text object on a graphic.


2. With the object still selected, select
Dynamics > Configure Attributes in the graphic configuration
window. The expression dynamics window will appear.
3. Configure the expression and settings from Tables 2-12
and 2-13.
Table 2-12. Expressions and Settings
Number

Expression

True

False

LI101HL.OUTPUT == 0 &&
LI101HHL.OUTPUT == 1

-Blink (see below)

None

LI101HL.OUTPUT == 0 &&
LI101HHL.OUTPUT == 0

Text = normal
Text color = 2

None

LI101HL.OUTPUT == 1 &&
LI101HHL.OUTPUT == 0

Text = hi level
Text color = 3

None

LI101HL.OUTPUT == 1 &&
LI101HHL.OUTPUT == 1

Text = hi hi level
Text color = 1

None

LI101HL.OUTPUT == 0 &&
LI101HHL.OUTPUT == 1

Text = unknown
Text color = 7

None

Table 2-13. Blink Settings


Period

Phase

Blink Color 1

Duration 1

Blink Color 2

Duration 2

Steady Color

2 - 74

WBPEEUI340020B1

Dynamics

Example 8 - Model Port Development


Objective:

To create a reserved rectangular area in which a faceplate can


be loaded for process control.

Procedure:

Use the FP functions CreateMPort and LoadMPort to accomplish this task. The faceplate will be loaded in the designated
area by selecting the tag pushbuttons that may be located
anywhere within the model. There may be as many pushbuttons on the model as are needed, and each pushbutton will
load the faceplate for a given tag into the reserved area. It is
also possible to have multiple reserved areas, if needed, but
this could restrict the usable work area for process control elements. Another option to avoid this problem would be to place
the reserved area (rectangle) outside the default view window
(0,0 - 100,75) although this will have an effect on the model
scale when opened in the operator window.
CreateMPort: The CreateMPort function is assigned to a rectangle
and defines a model port into which a submodel can be
dynamically loaded. An ID is assigned for the port to a private
variable that is used by the LoadMPort function to locate the
faceplate popup area.
NOTE: The model port ID must be unique for all rectangles used for the
CreateMPort function.
1. Draw a rectangular box and place it in the desired location.
2. Select a custom dynamics and enter the following code:
(__INIT (=1(call CreateMPort(&_PPort1))))
NOTE: The CreateMPort function will load the specified faceplate and scale it
to fit the rectangular area defined as the port window. It is important to make
sure the size of the faceplate and port window are relatively the same size
based on an x-y scale or the scaled faceplate may not be visually acceptable.

WBPEEUI340020B1

2 - 75

HSI Submodels

LoadMPort: The LoadMPort function is assigned to a pushbutton


(Fig. 2-24) and specifies a submodel to load into a model port,
plus the tag name for that specific submodel.

TC00873A

Figure 2-24. Pushbutton Submodel

1. Place the pushbutton submodel in the desired location.


2. Select custom dynamics and enter the following code:
(#(call LoadMPort(_pport1, FP_DYgroupmod, tagname)))
In Figure 2-25, the model ports have been assigned ID
_pport1 for POPUP TAG #1 and 2 and _pport 2 for POPUP
TAG #3.
NOTE: The LoadMPort function is intended to be used only as a pushbutton
input callback (that is, as part of an # dynprop statement). If used in any other
type of dynprop, unexpected developments will result which may cause other
dynamic elements within the model to execute improperly.

TC00874A

Figure 2-25. Model Ports Example

HSI Submodels
HSI submodels are submodels which have been supplied with
the HSI software and contain preconfigured dynamic
attributes. These submodels are used:

2 - 76

WBPEEUI340020B1

Faceplate Submodels

To display dynamic data from the database, using various


forms such as valves and bar graphs.

For the control of modules, and for the assignment of display vectoring (the ability to call up a specific display
directly from another display).

For detailed information on HSI submodels, refer to


Appendix A for detailed information on HSI submodels.

Faceplate Submodels
Faceplate submodels are submodels created by ABB which
provide access to the same submodels used to create point and
group (hierarchical) displays. If these submodels are being
used in a custom process graphic, the tag name should be followed by a period. Refer to Appendix C for a list of faceplate
submodels.

Expressions as Submodel Variables


Values are assigned to a variable of a submodel when a
graphic is configured. The values assigned are of two
types: static and dynamic. In the HSI submodel examples,
variables which can be assigned a tag name (tagatom, tag
name, tag) are dynamic variables. All other variables which
can be assigned for the submodel, such as font, face_color,
etc., are static variables.
NOTE: In the case of non HSI submodels, dynamic variables are those which
have been declared so that they can be assigned tag names. Refer to Custom
Dynamics for information on creating custom dynamics and declaring
variables
The value assigned to a static variable must be a numeric or
string constant. For example, the submodel FP_DYputpb has a
static variable named button_label. This variable must be
assigned a string constant, such as Press Here.
The value assigned to a dynamic variable can be a numeric or
string constant, but can also be the name of a tag.atom. For
example, the submodel FP_DYvalue has a dynamic variable
named TagAtom. If the name of a tag.atom such as
PIC-1515.SP is assigned to this variable, the value of

WBPEEUI340020B1

2 - 77

Expressions as Submodel Variables

PIC-1515.SP will appear on the graphic when it is displayed in


an operator window.
Additionally, an expression can be configured as the value of a
dynamic variable. The expression can include:

Constants.
Tag.atom names.
Arithmetic operators.
Logical operators.

For example, the following expression could be assigned to the


TagAtom dynamic variable of the FP_DYvalue submodel. The
expression would cause the value of PIC-1515.SP to be
converted from degrees Centigrade to Fahrenheit before it is
displayed on a graphic:
9/5 * PIC-1515.SP + 32

The following rules govern the use of expressions assigned to


submodel dynamic variables.

An expression can include tag.atoms, constants,


arithmetic, and logical operators, and parentheses.

Operators should be surrounded by spaces. For example,


the following expression is invalid:
PIC-1515.SP+10
The expression should be written as follows:
PIC-1515.SP + 10

2 - 78

The set of rules which determines which operators are performed first is known as precedence, and is described in
Configuring the Expression. Precedence can be controlled
using parentheses. Operator precedence used here follows
the C language (with the exception of the exponentiation
operator (^), which is not available in C). The operators
available for use in expressions assigned to submodel variables are listed in Table 2-6. Operators grouped together
have equal precedence. Higher precedence operator groups
are located higher in the list.

Expressions are limited to 120 alphanumeric characters.


For example, the following expression contains 21
characters: (PIC-1515.SP + 10).

WBPEEUI340020B1

HSI Symbols

Syntax errors in expressions are not detected by the Grafx


editor. They are detected when the graphic is displayed in
an operator window.

Expressions must be enclosed in quotes. This is done


automatically if the model being edited is a graphic, but
must be done when a submodel is being edited.

Submodel variables cannot be included in expressions. For


example, the following expression is invalid:
_px + 10
NOTE: This section describes the assignment of expressions to submodel
dynamic variables. This should not be confused with the Dynamic Attributes
feature of the Grafx editor. The Dynamic Attributes feature allows the use of
another form of expression to configure dynamics which affect a limited set of
graphic attributes of an object or submodel. The expression used in the
Dynamic Attributes feature is governed by a different set of rules (refer to
Dynamic Configuration Examples).

HSI Symbols
HSI symbols are standard static submodels preconfigured and
supplied by ABB. Symbols are objects which represent standard items such as vessels, tanks and storage bins. Symbols
which correspond to those defined by the Instrument Society
of America (ISA) have the prefix ISA_. Non ISA symbols created
by ABB contain the prefix FP_ST. Dynamic attributes can be
assigned to these submodels via the Dynamic Attributes menu
item. For a complete listing of the provided HSI symbols, refer
to Appendix B for a complete listing of the provided HSI symbols.

Custom Models for Point and Group Displays


Custom models can be created for use as point and group displays. The module/model assignment feature is used to make
assignments between the models and modules.
To create custom models intended for use as point or group
displays.
1. Configure the model as a submodel, using the instructions
and data provided in the preceding sections.

WBPEEUI340020B1

2 - 79

Custom Models for Point and Group Displays

2. Use a generic name for the public name when declaring a


variable for the tag name to be used in the submodel. This
allows the public name to be assigned to a tag name each time
an instance of the submodel is configured on a graphic. Refer
to Dynamics for details on declaring and naming variables in
submodels. When naming the generic tag name variable, the
string $TAG$ should be used, and upper case letters should
be used.
3. Set the model running as a submodel; the setting of graphics and submodels to running is described in Set To Running.
4. Remember that group models should be configured in the
appropriate shape, so that they fit correctly on a group display
which also contains models for other points.

2 - 80

WBPEEUI340020B1

Example Configuration

Section 3

Introduction
This section describes the configuration of a simple model.
This model Configuration of a model is based on the process
shown below.in Figure 3-1.
IN P U T
VA LVE
1 -1

FT 1

P U M P 1 -1
C H E M IC A L A
IN P U T
VA LVE
1 -2

LT 1

P U M P 1 -2
C H E M IC A L B

FT 2

O U T PU T
VA LVE
1 -3

M IX IN G
TA N K 1

M IX T U R E
O U T PU T

F T3
T 02 24 7 A

Figure 3-1. Layout of Example Process

Process Operation
The process functions as follows:
1. Input valve 1-1 is opened.
2. Pump 1-1 is started.
3. The level of chemical A in the mixing tank is allowed to rise
until a specific level is reached.
4. Pump 1-1 is stopped.
5. Input valve 1-1 is closed.
6. Input valve 1-2 is opened.
7. Pump 1-2 is started.

WBPEEUI340020B1

3-1

Assumptions and Conditions

8. The level of the combined chemicals is allowed to rise until


a specific level is reached.
9. Pump 1-2 is stopped.
10. Input valve 1-2 is closed.
11. The agitator is started and allowed to run for a preset time
period.
12. The agitator is stopped.
13. Output valve 1-3 is opened.
14. The level in the tank is allowed to drop until a specific level
is reached.
15. Output valve 1-3 is closed.
16. The process starts over again with Step 1.

Assumptions and Conditions


The following statements detail conditions that must already
exist and information that must already be known:

Configurations for any HSI and controllers that manage


the process are known (if not already configured).

The processes that supply and are supplied by this process


are shown in other models.

All components, except the agitator, not in operation or in


the closed position (valves) are shown in white. The
agitator is shown in gray when not in operation.

All components in operation or in the open position are


shown in green.

The tank level is shown in blue.

Display Configuration
The creation of a display for this process is divided into 14
parts. These parts are:

3-2

Create model.
Insert mixing tank.

WBPEEUI340020B1

Display Configuration

Insert valves.
Insert pumps.
Insert agitator.
Draw pipes.
Configure pipes.
Configure pump 1-1.
Configure pump 1-2.
Configure valves.
Configure agitator.
Configure mixing tank.
Enter text.
Configure value monitoring.

Create Model
To create a model for the previous process shown in Figure 3-1
using the stated assumptions and conditions:
1. Right click the HSI server that will contain this model.
2. Select Open.
3. Select Edit > Model Type.
4. Enter Mixing_Room_1 in the Model Name: field.
5. Set the model type to Graphic.
6. Click OK.

Insert Mixing Tank


To insert mixing tank 1:
1. Select Edit > Shapes > Submodel.
2. Select EB Submodels in the Look in: field.
3. Select the FP_DYtank submodel from the list.
4. Click Instantiate.
5. Position the tank slightly right of center and near the
bottom of the model and click.

WBPEEUI340020B1

3-3

Display Configuration

Insert Valves
To insert valve 1-1, 1-2, and 1-3:
1. Select Edit > Shapes > Submodel.
2. Select the ISA_VLVE_ACTR submodel from the list.
3. Click Instantiate.
4. Position the valve to the right and near the bottom of the
tank and click. This is valve 1-3.
5. Position a second valve to the left and near the top of the
tank and click. This is valve 1-1.
6. Position a third valve just below the second valve and click.
This is valve 1-2.

Insert Pumps
To insert pumps 1-1 and 1-2:
1. Select Edit > Shapes > Submodel.
2. Select the FP_DYpump_rt submodel from the list.
3. Click Instantiate.
4. Position a pump to the left of valve 1-1 and click. This is
pump 1-1.
5. Position a second pump just below pump 1-1 and click.
This is pump 1-2.

Insert Agitator
To insert the agitator:
1. Select Edit > Shapes > Submodel.
2. Select the ISA_AGIT_MOTR submodel from the list.
3. Click Instantiate.
4. Position an agitator in the center of the tank with the
motor just above the top of the tank and click.

3-4

WBPEEUI340020B1

Display Configuration

Draw Pipes
To draw the pipes:
1. Select Edit > Shapes > Line.
2. Position the cursor at the left edge of the model window in
line horizontally with pump 1-1 and click it.
3. Drag the cursor to the left edge (centered) of pump 1-1 and
release the button.
4. Position the cursor at the left edge of the graphic window in
line horizontally with pump 1-2 and click it.
5. Drag the cursor to the left edge (centered) of pump 1-2 and
release the button.
6. Position the cursor at the output of pump 1-1 and click it.
7. Drag the cursor to the left edge (centered) of valve 1-1 and
release the button.
8. Position the cursor at the output of pump 1-2 and click it.
9. Drag the cursor to the left edge (centered) of valve 1-2 and
release the button.
10. Position the cursor at the right edge (centered) of valve 1-1
and click it.
11. Drag the cursor to the left edge of the tank somewhere near
the top and release the button.
12. Position the cursor at the right edge (centered) of valve 1-2
and click it.
13. Drag the cursor to the left edge of the tank just below the
previous line and release the button.
14. Position the cursor at the lower right corner of the tank
and click it.
15. Drag the cursor to the left edge (centered) of valve 1-3 and
release the button.
16. Position the cursor at the left edge (centered) of the valve
1-3 body and click it.

WBPEEUI340020B1

3-5

Display Configuration

17. Drag the cursor to the right edge of the graphic and release
the button.
The model should look like the following.that in Figure 3-2.

TC00781A

Figure 3-2. Example Model (Partially Complete)

Configure Pipes
To configure the pipes:
1. Select all the lines.
2. Select Edit > Grouping > Group.
3. Select Edit > Object > Properties.
4. Select the lines tab.
5. Set the line width to 6.
6. Click Close.

Configure Pump 1-1


To configure pump 1-1:
1. Select pump 1-1.

3-6

WBPEEUI340020B1

Display Configuration

2. Select Edit > Object > Configure Submodel.


3. Enter the tagname.atom of a Composer database point (or
a constant value) that starts pump 1-1 in the on_tagatom field.
4. In the on_value field, enter the value the previous field
must be equal to before the pump submodel is considered on.
5. Enter a 5 in the period field.
6. Enter a 7 in the pump_off_color field.
7. Enter a 10 in the pump_on_color field.
8. Enter a 7 in the wheel_color field.
9. Click OK.

Configure Pump 1-2


To configure pump 1-2:
1. Select pump 1-2.
2. Select Edit > Object > Configure Submodel.
3. Enter the tagname.atom of a Composer database point (or
a constant value) that starts pump 1-2 in the on_tagatom field.
4. In the on_value field, enter the value the previous field
must be equal to before the pump submodel is considered on.
5. Enter a 5 in the period field.
6. Enter a 7 in the pump_off_color field.
7. Enter a 10 in the pump_on_color field.
8. Enter a 7 in the wheel_color field.
9. Click OK.

Configure Valves
To configure valves 1-1, 1-2, and 1-3:
1. Select valve 1-1.
2. Select Edit > Object > Dynamic Attributes.

WBPEEUI340020B1

3-7

Display Configuration

3. Enter an expression (in the Expression field) that is true


only when this valve is open.
4. Select visible and filled for both true and false conditions.
5. Select fill color and enter a 10 for the true condition.
6. Select fill color and enter a 7 for the false condition.
7. Select line color and enter a 10 for the true condition.
8. Select line color and enter a 7 for the false condition.
9. Click OK.
10. Repeat Steps 1 through 9 for valves 1-2 and 1-3.

Configure Agitator
To configure the agitator:
1. Select the agitator.
2. Select Edit > Object > Dynamic Attributes.
3. Enter an expression (in the Expression field) that is true
only when this agitator is functioning.
4. Select visible and filled for both true and false conditions.
5. Select fill color and enter a 10 for the true condition.
6. Select fill color and enter a 20 for the false condition.
7. Select line color and enter a 10 for the true condition.
8. Select line color and enter a 20 for the false condition.
9. Click OK.

Configure Mixing Tank


To configure the mixing tank:
1. Select the tank.
2. Select Edit > Object > Dynamic Attributes.
3. Enter an expression (in the Expression field) that is true
only when this valve is open.

3-8

WBPEEUI340020B1

Display Configuration

4. Select visible and filled for both true and false conditions.
5. Select fill color and enter a 10 for the true condition.
6. Select fill color and enter a 7 for the false condition.
7. Select line color and enter a 10 for the true condition.
8. Select line color and enter a 7 for the false condition.
9. Click OK.

Enter Text
To enter the graphic text:
1. Select Edit > Shapes > Text.
2. Place the cursor near the top center of the model and click.
3. Type:

Mixing Tank 1

4. Select Edit > Object > Select.


5. Select the text.
6. Select Edit > Object > Properties.
7. Select the Text tab.
8. Select the largest text size.
9. Select the horizontal and vertical centered alignment.
10. Click Close.
11. Select Edit > Shapes > Text.
12. Position the cursor on open space and click.
13. Type:

Chemical A

14. Select Edit > Object > Select.


15. Select the text.
16. Select Edit > Object > Properties.
17. Select the Text tab.
18. Select the next smallest text size.

WBPEEUI340020B1

3-9

Display Configuration

19. Click Close.


20. Select Edit > Shapes > Text.
21. Position the cursor on open space and click.
22. Type:

Chemical B

23. Repeat Steps 21 and 22 for the following text strings:


Pump 1-1
Pump 1-2
Input Valve 1-1
Input Valve 1-2
Output Valve 1-3
Mixing Tank
24. Select Edit > Shapes > Select.
25. Select the Chemical A text object.
26. Move the text to the correct location as specified in
Figure 3-1.
27. Repeat Steps 25 and 26 for all the text objects.
The model should look like that shown in the following fFigure
3-3.

3 - 10

WBPEEUI340020B1

Display Configuration

TC00782A

Figure 3-3. Example Model (Mostly Complete)

Configure Value Monitoring


To establish a means of monitoring tank input and output
flows:
1. Select Edit > Shapes > Text.
2. Position the cursor on open space and click.
3. Type:
Chemical A Flow
4. Repeat Steps 2 and 3 for the following text strings.
Chemical B Flow
Mixing Time Remaining
Output Flow
5. Select Edit > Shapes > Select.
6. Select the Chemical A Flow text object.
7. Move the object to a position just above input valve 1-1.
8. Select the Chemical B Flow text object.

WBPEEUI340020B1

3 - 11

Display Configuration

9. Move the object to a position just below input valve 1-2.


10. Select the Mixing Time Remaining text object.
11. Move the text object to a position just to right of the top of
the tank.
12. Select the Output Flow text object.
13. Move the text object to a position just above the tank
output pipe.
14. Select Edit > Shapes > Submodel.
15. Select the FP_DYvalue submodel from the list.
16. Click Instantiate.
17. Position the value box just to the right of the Chemical A
Flow text object and click.
18. Position the value box just to the right of the Chemical B
Flow text object and click.
19. Position the value box just to the right of the Mixing Time
Remaining text object and click.
20. Position the value box just to the right of the Output Flow
text object and click.
21. Select Edit > Shapes > Select.
22. Select the box next to the Chemical A Flow text object.
23. Select Edit > Object > Configure Submodel.
24. Enter the tagname.atom that reports the output of flow
transmitter 1 in the TagAtom field.
25. Click OK.
26. Select the value box next to the Chemical B Flow text
object.
27. Select Edit > Object > Configure Submodel.
28. Enter the tagname.atom that reports the output of flow
transmitter 2 in the TagAtom field.
29. Click OK.

3 - 12

WBPEEUI340020B1

Display Configuration

30. Select the value box next to the Mixing Time Remaining text
object.
31. Select Edit > Object > Configure Submodel.
32. Enter the tagname.atom that reports the output of the
timer used during the mixing phase in the TagAtom field.
33. Click OK.
34. Select the value box next to the Output Flow text object.
35. Select Edit > Object > Configure Submodel.
36. Enter the tagname.atom that reports the output of flow
transmitter 3 in the TagAtom field.
37. Click OK.

Conclusion
The model is now fully configured and should look like what is
shown belowin Figure 3-4. Save the model and then set it to
running in the HSI system.

TC00783A

Figure 3-4. Example Model (Complete)

WBPEEUI340020B1

3 - 13

WBPEEUI340020B1

DynProp Code

Section 4

Introduction
This section contains tables that describe the Different codes
are available for creating custom dynamics. Knowledge of the
control systems being used is also a requirement for creating
custom dynamics.

Dynamic Actions
Dynamics can be achieved by assigning dynamic actions to
objects. The dynamic actions are triggered by changes in variables assigned to them. The following table 4-1 contains the
dynamic actions available and the types of variables they are
assigned.
Table 4-1. Dynamic Actions
Category
Attribute
changes

WBPEEUI340020B1

Action

Description

bcolor int

Background text color.

closed int

Closure of an edge object;


0=unclosed, 1=closed.

detect int

Delectability;
0=not detectable, 1=detectable.

ecolor int

Edge color.

estyle int

Edge style.

ewidth real

Edge width.

fcolor int

Fill color.

fdir int

Fill direction;
0=bottom, 1=left, 2=top, 3=right.

finter int

Fill interior pattern;


0=hollow,1=solid, 2=pattern, 3=hatch.

fpercent real

Fill percent; ranges from 0 to 100.

fstyle int

Fill interior style;


Workstation-dependent.

filled int

Filling of a closed object;


0=unfilled, 1=filled.

4-1

Dynamic Actions
Table 4-1. Dynamic Actions (continued)
Category
Dynamic
actions

Transformations

4-2

Action

Description

mcolor int

Marker color.

msize real

Marker size.

mstyle int

Marker style.

stext [intlreallstring]
format-string

Text content; real arg formatted using format-string, type


must match code in format string.

talign x y

Text alignment (x, y) (integer args).

tcolor int

Text color.

tfont int

Text font.

theight real

Text height.

tpath int

Text path;
1=right, 2=down.

tprec int

Text precision;
0=raster,1=vector, 2=hershey.

trepl [intireallstring]
format-string

Equivalent to stext.

tsize x y

Text size (x, y) (integer args).

vis int

Visibility;
0=invisible, 1=visible, 3=force update.

vispart int

Visibility turned on a part indexed by int; indexed part of


group is made visible while all other parts are made invisible.

arclength real

Angle representing length of sectors or pies.

move x y

Relative move (real args).

movey real

Relative move in x direction.

radius real

Radius of Circles, Pies, or Sectors.

rotate real

Relative rotate around reference point.

rrotz real

Equivalent to rotate.

scale real

Even-scaling around reference point.

scalex real

Scaling around reference point in x dimension only.

scaley real

Scaling around reference point in y dimension only.

startangle real

Starting angle of sectors or pies.

WBPEEUI340020B1

Dynamic Actions
Table 4-1. Dynamic Actions (continued)
Category
Graph
changes

Action

Description

majorspacing real

Setting of major tick spacing on a GraphicAxis.

minorspacing real

Setting of minor tick spacing on a GraphicAxis.

plotclear

Clearing of the coordlimits area of a graph.

plotdata x_data y_data

Plotting of data with a GraphTrace (real args).

plotreset

Removal of all the points in a GraphTrace.

plotshiftx real

Shifting of GraphTrace points in the horizontal direction.

plotshifty real

Shifting of GraphTrace points in the vertical direction.

tracelength int

Setting of the number of points in a GraphTrace.

valuelimits min max

Setting of value limits (range) on a GraphAxis (real args).

xvaluelimits xmin xmax Setting of x value limits on a GraphTrace (real args).


yvaluelimits ymin ymax Setting of y value limits on a GraphTrace (real args).
Special
actions

batcherase

Erasure and redrawing of parts of groups or models; no


effect on primitives.

call function_ptr( )

Calling of a predefined function in the application (sin() or


abs( )) or a user-defined function in the application.

dbflag int

Enable (1) or disable (0) software double-buffering1.

dynarray

Enables use of implicit array indices; sets the G_DYNARRAY


flag.

dynerase

Equivalent to batcherase.

noerase

Flagging an object with no erase when any dynamic changes


occur.

redraw

Redrawing without erasure.

userdata string

Setting of the UserData field to string.

userword int

Setting of the UserWord field to int.

NOTE:
1. The double-buffer flag is saved with the object when it is written to a file. Once set, there is no need to reset the flag. Thus,
once an object has been marked for double-buffering, the re-execution of this action will have no effect. That is, it is wasteful to
continue executing a DynProp with dbflag 1 on an object. This should be done only at initialization if possible.

WBPEEUI340020B1

4-3

Formatting Strings

Formatting Strings
The following table 4-2 contains control codes which permit
the formatting of the variable text in graphics.
Table 4-2. Formatting Control Codes
Type

Code

Integer variable %d, %i

Description
Write integer variable as a signed decimal number.

%u

Write integer variable as an unsigned decimal number.

%o

Write integer variable as an octal number without a leading zero.

%#o

Write integer variable as an octal number with a leading zero.

%x, %X, %p Write integer variable as a hexadecimal number using "abcdef" for
%x and %p or "ABCDEF" for %X.
%#X

Write integer variable as a hexadecimal number using


"ABCDEF" and preface "0X" to non zero result.

%c

Write as a character.

%f

Write float variable as a signed decimal number with decimal point.

%e, %E

Write float variable using scientific notation (1.2345e+01 for %e or


1.2345E+01 for %E).

%g, %G

Write float variable using either %f or %e (or %E for %G),


whichever is shorter.

String variable

%s1

Write as a string until \0 is reached or until the number of


characters indicated by the precision has been printed.

No variable

%%

Write a literate percent sign.

escape quotation mark inside string.

\n

Generate multi-line text.

Floating point
variable

NOTE:
1. A character array of size 1 should use %1.1s as the formatting code.

4-4

WBPEEUI340020B1

Expression Operators

Expression Operators
The following table 4-3 contains a complete list of valid expression operators available for DynProps.
Table 4-3. Expression Operators
Category

Operator

Address

&

Arithmetic

Addition

Subtraction

Multiplication

**

Raise to the power of

Logical

WBPEEUI340020B1

Description
Address of

Division

Remainder (modulo division)

Negation (logical NOT)

>

Greater than

<

Less than

>=

Greater than or equal to

<=

Less than or equal to

==

Equivalent

!=

Not equal

&&

Logical AND

||

Logical OR

4-5

C-Library Functions

C-Library Functions
The following table 4-4 contains C-Library functions recognized in DynProps.
Table 4-4. Standard C Library Functions

4-6

Function

Return
Value

Function

Return
Value

abs(arg)

Integer

hypot(arg1, arg2)

Real

acos(arg)

Real

log(arg)

Real

asin(arg)

Real

log10(arg)

Real

atan(arg)

Real

pow(arg1, arg2)

Real

atan2(arg1, arge2)

Real

sin(arg)

Real

ceil(arg)

Real

sqrt(arg)

Real

cos(arg)

Real

strcmp(arg1, arg2)

Integer

exp(arg)

Real

strlen(arg1, arg2)

Integer

fabs(arg)

Real

strncmp(arg1, arg2)

Integer

floor(arg)

Real

tan(arg)

Real

WBPEEUI340020B1

Graphics Submodels

Appendix A

Introduction
Graphics submodels are supplied by ABB and contain
preconfigured dynamic attributes. These submodels are used:

To display dynamic data from the tag database, using


various forms such as valves and bar graphs.

For the control of distributed control system (DCS) tags.

For the assignment of display vectoring (the ability to call


up a specific display directly from another display).

The following table A-1 groups the submodels by their functionality. The rest of this section contains descriptions of each
submodel in alphabetical order.
Table A-1. Process Portal Submodel Types
Type
Submodels with dynamic values
Bar graphs

Submodels for control and data entry

Submodels
FP_DYvalue
FP_DYbargraph

FP_DYtank

FP_DYbargraph_ec

FP_DYtank_ec

FP_DYHorizbar

FP_DYVertbar

FP_DYctrlpb

FP_DYput1pb

FP_DYentervaluepb

FP_DYputpbstat

FP_DYentertextpb

FP_DYputpbstat2

FP_DYhslider

FP_DYstatpb

FP_DYmpoppb

FP_DYvslider

FP_DYputpb

FP_DYtoggle

Display vectoring

FP_DYtagpb

FP_DYvectorpb

Trends

FP_DYHisttrend

FP_DYtrendpb

FP_DYHoriztrend

FP_DYVerttrend

Hierarchical displays

FP_DYgroupmod

FP_DYpointmod

Miscellaneous displays

FP_DYdial

FP_DYmeter

Rotating equipment displays

FP_DYpump_lf

FP_DYwheel

FP_DYpump_rt

WBPEEUI340020B1

A-1

FP_DYbargraph

FP_DYbargraph
bar graph

Purpose:

The following submodel FP_DYbargraph (Fig. A-1) represents


the value of a dynamic process variable in the form of a rectangular bar.

T 02 1 10 A

Figure A-1. Dynamic Bar Graph (FP_DYbargraph)


Submodel:
Variable

FP_DYbargraph
Description

tagatom

Tag.atom of the DCS server tag database point (or a constant value) that is used
to determine the length of the bar (FIC-447.PV).

edge_color

Number of the desired outline color of the bar.


Default: 7 (white)

edge_width

Number of the desired thickness of the outline of the bar (enter range 0 - 3).
Default: 1

fill_color

Number of the desired fill color of the bar.


Default: 0 (black)

fill_dir

Number representing the direction that the bar fills as the value of Tag.atom
increases from lower_limit to upper_limit.
Up - 0, Right - 1, Down - 2, Left - 3
Default: 0

lower_limit

Tag.atom of the DCS server tag database point or the constant value that
represents the lower limit of the bar (FIC-447.LOWLIM).
Default: none

A-2

WBPEEUI340020B1

FP_DYbargraph_ec

Variable
upper_limit

Description
Tag.atom of the DCS server tag database point or the constant value that
represents the upper limit of the bar (FIC-447.HIGHLIM).
Default: none

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYbargraph_ec
bar graph

Purpose:

Submodel:
Variable

Like FP_DYbargraph, the submodel FP_DYbargraph_ec


(Fig. A-1) represents the value of a dynamic process variable in
the form of a rectangular bar, with one additional feature. As
portions of the bar graph are erased due to changes in the process variable which controls the level of the fill color, the color
defined as the erase color will replace the fill color. (For
FP_DYbargraph, the erase color is the background color of the
graphic on which it appears).
FP_DYbargraph_ec
Description

tagatom

Tag.atom of the database point (or a constant value) that is used to determine the
length of the bar (FIC-447.PV).

edge_color

Number of the desired outline color of the bar.


Default: 7 (white)

edge_width

Number of the desired thickness of the outline of the bar (enter range 0 - 3).
Default: 1

erase_color

Number of the color to be used in portions of the bar where the fill_color is erased.
Default: 0 (black)

fill_color

Number of the desired fill color of the bar.


Default: 0 (black)

fill_dir

Number representing the direction that the bar fills as the value of Tag.atom
increases from lower_limit to upper_limit.
Up - 0, Right - 1, Down - 2, Left - 3
Default: 0

lower_limit

Tag.atom of the database point or the constant value that represents the lower limit
of the bar (FIC-447.LOWLIM).
Default: none

upper_limit

Tag.atom of the database point or the constant value that represents the upper
limit of the bar (FIC-447.HIGHLIM).
Default: none

WBPEEUI340020B1

A-3

FP_DYctrlpb

Variable

Description

NOTE:
1. The bar graph model is sized as a 10 x 10 unit rectangle. To change its size, change its reference point to one of its corners
using the change reference menu item and then scale it to fit in the desired area.
2. Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYctrlpb
pushbutton

Purpose:

Submodel:

The submodel FP_DYctrlpb is a model of a pushbutton that


displays the appropriate group display model for the configured tag database point, allowing for control of that point from
a graphic.
FP_DYctrlpb

Variable

Description

TagName

Tag name of the tag database point to be displayed when the button is pressed.

FP_DYdial
miscellaneous display

Purpose:

The following submodel FP_DYdial (Fig. A-2) represents the


value of a tag database point in the form of a dial. The white
dial hand represents the process variable, while the red hand
represents a set point.
1 00 0.0

0.0

DEG F
53 0 .1
T02111 A

Figure A-2. Dial Submodel (FP_DYdial)


Submodel:

A-4

FP_DYdial

WBPEEUI340020B1

FP_DYentertextpb

Variable

Description

tagatom

Tag.atom of the database point (or a constant value) that is to be displayed


(FIC-447.PV).

lower_limit

Tag.atom of the database point or the constant value that represents the lower limit
of the dial (FIC-447.LOWLIM).
Default: none

setpoint

Tag.atom of the database point (or a constant value) that represents the set point
of the dial (FIC-447.SP).
Default: none

units

ASCII string describing the Engineering Units (DEG C).


Default: eun

upper_limit

Tag.atom of the database point or the constant value that represents the upper
limit of the dial (FIC-447.HIGHLIM).
Default: none

FP_DYentertextpb
pushbutton

Purpose:

Submodel:
Variable

The submodel FP_DYentertextpb is a pushbutton that displays


in a window a means of entering an ASCII string into a
Conductor NT Tag.atom.
FP_DYentertextpb
Description

tagatom

Tag.atom of the database point to which the data will be written


(REACTOR-01A.TEXTSTR).

Title

Label to be displayed in the title bar of the window. (Enter the text:).
Default: none

button_label

Label to be displayed on the button (SP).


Default: none

face_color

Number of the desired face color of the button.


Default: 26

low_color

Number of the desired lower edge color of the button.


Default: 29

txt_color

Number of the desired text color of the button label.


Default: 4

up_color

Number of the desired upper edge color of the button label.


Default: 23

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

WBPEEUI340020B1

A-5

FP_DYentervaluepb

FP_DYentervaluepb
pushbutton

Purpose:

Submodel:

The submodel FP_DYentervaluepb is a pushbutton that displays in a window a means of entering a floating point value
into a DCS server tag.atom.
FP_DYentervaluepb

Variable

Description

tagatom

Tag.atom of the database point to which the data will be written


(FIC-477.SP).

button_label

Label to be displayed on the button (SP).


Default: none

face_color

Number of the desired face color of the button.


Default: 26

low_color

Number of the desired lower edge color of the button.


Default: 29

txt_color

Number of the desired text color of the button label.


Default: 4

up_color

Number of the desired upper edge color of the button label.


Default: 23

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYgroupmod
hierarchical display

Purpose:

Submodel:
Variable
TAG

A-6

The submodel FP_DYgroupmod is used to display the model of


a tag database point as used on a group display. In the Grafx
editor, FP_DYgroupmod appears simply as an unfilled rectangle which covers the extent of the submodel. Refer to the
appropriate HSI configuration instruction for information on
configuring group displays.
FP_DYgroupmod
Description

Tag name of the database point that is to be displayed.

WBPEEUI340020B1

FP_DYHisttrend

FP_DYHisttrend
trend

Purpose:

Submodel:

In the Grafx editor, FP_DYHisttrend appears simply as an


unfilled rectangle which covers the extent of the submodel.
Refer to the appropriate HSI configuration instruction for
information on configuring trend displays.
FP_DYHisttrend

Variable
trend_index

Description
Index number of the historical trend to be displayed.

FP_DYHorizbar
bar graph

Purpose:

The following submodel FP_DYHorizbar (Fig. A-3) represents


the value of a dynamic process variable in the form of a horizontal bar graph with a scale.

100 0

900

800

700

600

500

400

300

200

100

T 02 1 12 A

Figure A-3. Dynamic Horizontal Bar (FP_DYHorizbar)


Submodel:
Variable

FP_DYHorizbar
Description

tagatom

Tag.atom of the DCS server (or a constant value) that is used to determine the
length of the bar (FIC-447.PV).

axis_color

Number of the desired color of the x-axis.


Default: 0 (black)

bar_color

Number of the desired fill color of the bar.


Default: 7 (white)

direction

Number from the table below representing the direction that the bar fills as the value
of Tag.atom increases from lower_limit to upper_limit.
Right - 1
Left - 0
Default: 1

WBPEEUI340020B1

A-7

FP_DYHoriztrend

Variable

Description

label_color

Number of the desired color of the x-axis labels.


Default: 0 (black)

lower_limit

Tag.atom of the tag database or the constant value that represents the lower limit of
the bar (FIC-447.LOWLIM).
Default: none

upper_limit

Tag.atom of the tag database or the constant value that represents the upper limit of
the bar (FIC-447.HIGHLIM).
Default: none

x_ticks

Number of tick marks to be displayed on the scale.


Default: 0

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYHoriztrend
trend

Purpose:

The following submodel FP_DYHoriztrend (Fig. A-4) displays a


current trend for a database point. The trace is drawn from the
right of the submodel. The data is scanned once every second
and is not stored historically. The data is plotted on the y-axis
and the number of samples is plotted on the x-axis.
10 0 0

80 0

60 0

40 0

20 0

0
1 00

90

80

70

60

50

40

30

20

10

0
T 02 1 13 A

Figure A-4. Horizontal Trend Submodel (FP_DYHoriztrend)

A-8

WBPEEUI340020B1

FP_DYhslider
Submodel:

FP_DYHoriztrend

Variable

Description

tagatom

Tag.atom of the database point that is to be trended (FIC-447.PV).

num_points

Number of samples displayed on the trend.

axis_color

Number of the desired axis color.


Default: 0 (black)

label_color

Number of the desired label color.


Default: 0 (black)

trace_color

Number of the desired trace color.


Default: 7 (white)

x_ticks

Number of tick marks on the X axis.


Default: 0

y_ticks

Number of tick marks on the Y axis.


Default: 0

lower_limit

Tag.atom of the database point or the constant value that represents the lower limit
of the trace (FIC-447.LOWLIM).
Default: none

upper_limit

Tag.atom of the database point or the constant value that represents the upper limit
of the trace (FIC-477.HIGHLIM).
Default: none

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYhslider
slider

Purpose:

The following submodel FP_DYhslider provides a horizontal


slider for control of database points. The following example
changes the output of a controller module.

TC00229A

Submodel:

WBPEEUI340020B1

FP_DYhslider

A-9

FP_DYmeter

Variable

Description

display_atom Tag.atom of the database point represented by the position of the solid arrow
(FIC-447.OUTPUT).
lower_limit

Tag.atom of the database point or the constant value that represents the lower limit
of the slider (FIC-447.LOWLIM).
Default: none

target_atom

Tag.atom of the database point to be changed when the slider is released. The
value is represented by the position of the hollow arrow (FIC-447.OUTPUT).
Default: none

upper_limit

Tag.atom of the database point or the constant value that represents the upper limit
of the slider (FIC-447.HIGHLIM).
Default: none

FP_DYmeter
miscellaneous display

Purpose:

The following submodel FP_DYmeter (Fig. A-5) displays an


analog meter representation of the value of a database point.

0.0

100 0.0
D EG F

530 .1

T 02 11 4 A

Figure A-5. Meter Submodel (FP_DYmeter)

Submodel:
Variable

FP_DYmeter
Description

tagatom

Tag.atom of the database point (or a constant value) that is to be displayed


(FIC-447.PV).

lower_limit

Tag.atom of the database point or the constant value that represents the lower limit
of the dial (FIC-447.LOWLIM).
Default: none

A - 10

WBPEEUI340020B1

FP_DYmpoppb

Variable

Description

units

ASCII string describing the engineering units (DEG C).


Default: eun

upper_limit

Tag.atom of the database point or the constant value that represents the upper limit
of the dial (FIC-447.HIGHLIM).

FP_DYmpoppb
pushbutton

Purpose:

The following submodel FP_DYmpoppb is a pushbutton that


displays a model, chosen by the user, in a window.

TC00230B

Submodel:
Variable

FP_DYmpoppb
Description

button_label

Label to be displayed on the button.


Default: none

face_color

Number of the desired face color of the button.


Default: 26 (Also used for FP_DYctrlpb).

low_color

Number of the desired lower edge color of the button.


Default: 29 (Also used for FP_DYctrlpb).

model

Name of the model that will appear in the window when the button is pressed. (The
model name should be that of an installed (online) graphic or submodel). User must
define variable.
Default: 0

scroll_flag

Enter a 1 if a narrow window is desired; Enter a 0 if a wide window is desired.


Default: 0

tag

Tag name of any variable in the model that uses the variable $TAG$ (refer to
Configuring Model Variables in Section 2 for a discussion on declaring variables
in submodels).

txt_color

Number of the desired text color of the button label.


Default: 4 (Also used for FP_DYctrlpb).

up_color

Number of the desired upper edge color of the button.


Default: 23 (Also used for FP_DYctrlpb).

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

WBPEEUI340020B1

A - 11

FP_DYpointmod

FP_DYpointmod
hierarchical display

Purpose:

Submodel:

The submodel FP_DYpointmod displays the point display of a


database point. In the Grafx editor, FP_DYpointmod appears
simply as an unfilled rectangle which covers the extent of the
submodel.
FP_DYpointmod

Variable
TAG

Description
Tag name of the tag database point that is to be displayed.

FP_DYpump_lf
rotating equipment
display

Purpose:

The following submodel FP_DYpump_lf (Fig. A-6) is a pump


with an outlet on the left. The submodel can be configured to
change fill color dynamically, and also contains a wheel which
can be animated so that it appears to spin in a counter-clockwise direction.

T 02 11 5 A

Figure A-6. Dynamic Pump - Left (FP_DYpump_lf)


Submodel:

A - 12

FP_DYpump_lf

WBPEEUI340020B1

FP_DYpump_rt

Variable

Description

on_tagatom

Tagname.atom of a DCS database point (HS-5441.PV). The value of this point


will be used by the variable on_value (described below) to initiate the spin
dynamic and change the fill color in the submodel.

on_value

Value compared with the value of the DCS server database point configured in
the variable on_tagatom. When the value of the tagname.atom matches the
value configured here for on_value, the color of the pump will change to that
defined in the variable pump_on_color and the wheel portion of the submodel
will appear to spin.

period

Frequency at which the wheel spokes will appear to change position. The period
is measured in tenths of a second; the number entered here defines how many
tenths of a second are in the period (a 5 entered here means the period would
be 0.5 seconds in duration).
Default: 1 (One tenth of a second).

pump_off_color

Number of the fill color to be used for the pump submodel when the DCS server
database point configured in the variable on_tagatom is not equal to the value
configured in the variable on_value.
Default: 0 (black)

pump_on_color

Index number of the fill color to be used for the pump submodel when the DCS
server point configured in the variable on_tagatom is equal to the value
configured in on_value.
Default: 0 (black)

spoke_color

Index number of the color to be used for the spokes of the wheel portion of the
submodel.
Default: 0 (black)

wheel_color

Index number of the color to be used for the interior of the wheel portion of the
submodel.
Default: 0 (black)

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYpump_rt
rotating equipment
display

Purpose:

WBPEEUI340020B1

The following submodel FP_DYpump_rt (Fig. A-7) is a pump


with an outlet on the right. The submodel can be configured to
change fill color dynamically and contains a wheel which can
be animated so that it appears to spin in a clockwise direction.

A - 13

FP_DYpump_rt

T 02 11 6 A

Figure A-7. Dynamic Pump - Right (FP_DYpump_rt)


Submodel:
Variable

FP_DYpump_rt
Description

on_tagatom

Tagname.atom of a DCS database point (HS-5441.PV); the value of this point


will be used by the variable on_value (described below) to initiate the spin
dynamic and change the fill color in the submodel.

on_value

Value compared with the value of the DCS database point configured in the
variable on_tagatom. When the value of the tagname.atom matches the value
configured here for on_value, the color of the pump will change to that defined in
the variable pump_on_color and the wheel portion of the submodel will appear
to spin.

period

Frequency at which the wheel spokes appear to change position. The period is
measured in tenths of a second; the number entered here defines how many
tenths of a second are in the period (a 5 entered here means the period would
be 0.5 seconds in duration).
Default: 1

pump_off_color

Number of the fill color to be used for the pump submodel when the tag
database point configured in the variable on_tagatom is not equal to the value
configured in the variable on_value.
Default: 0 (black)

pump_on_color

Index number of the fill color to be used for the pump submodel when the tag
database point configured in the variable on_tagatom is equal to the value
configured in on_value.
Default: 0 (black)

spoke_color

Index number of the color to be used for the spokes of the wheel portion of the
submodel.
Default: 0 (black)

wheel_color

Index number of the color to be used for the interior of the wheel portion of the
submodel.
Default: 0 (black)

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

A - 14

WBPEEUI340020B1

FP_DYput1pb

FP_DYput1pb
pushbutton

Purpose:

The following submodel FP_DYput1pb is a pushbutton that


writes a numeric value or ASCII character into one tag database point. The following example shows an instance of
FP_DYput1pb configured to start the motor MCV-R01A01
(RCM tag) when the button is pressed (clicked on).

TC00231B

NOTE: FP_DYput1pb is basically a simpler version of FP_DYputpb,


and can be used in cases where one value is to be written to one tag database
point. (FP_DYputpb allows up to four values to be written to as many as
four tag database points).

TC00231B

Submodel:
Variable

FP_DYput1pb
Description

button_label

Label to be displayed on the button (Start).


Default: none

put_tagatom

Tag.atom of the tag database point to which the data configured in put_value will
be written (MCV-R01A01.PV).
Default: none

put_value

Value to be written to the tag database point configured in put_tagatom (1).


Default: none

FP_DYputpb
pushbutton

Purpose:

WBPEEUI340020B1

The following submodel FP_DYputpb is a pushbutton that


writes numeric values and ASCII text into up to four tag database points. The following example shows an instance of
FP_DYputpb configured to start the motor MCV-R01A01 (RCM
tag) when the button is pressed (clicked on).

A - 15

FP_DYputpb

TC00231B

Submodel:
Variable

FP_DYputpb
Description

button_label

Label to be displayed on the button (Start).


Default: none

face_color

Number of the desired face color of the button.


Default: 26

low_color

Number of the desired lower edge color of the button.


Default: 29

put_tagatom

Tag.atom of the tag database point to which the data configured in put_value will
be written (MCV-R01A01.PV).
Default: none

put_tagatom2 Tag.atom of the tag database point to which the data configured in put_value2 will
be written.
Default: none
put_tagatom3 Tag.atom of the tag database point to which the data configured in put_value3 will
be written.
Default: none
put_tagatom4 Tag.atom of the tag database point to which the data configured in put_value4 will
be written.
Default: none
put_value

Value to be written to the tag database point configured in put_tagatom (1).


Default: none

put_value2

Value that will be written to the tag database point configured in put_tagatom2.
Default: none

put_value3

Value that will be written to the tag database point configured in put_tagatom3.
Default: none

put_value4

Value that will be written to the tag database point configured in put_tagatom 4.
Default: none

txt_color

Number of the desired text color of the button label.


Default: 4

up_color

Number of the desired upper edge color of the button label.


Default: 23

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

A - 16

WBPEEUI340020B1

FP_DYputpbstat

FP_DYputpbstat
pushbutton

Purpose:

The following submodel FP_DYputpbstat is a pushbutton that


writes values into up to four tag database points and shows a
red status light when the status of a tag database point is set
to a configurable value. The following example shows an
instance of FP_DYputpbstat configured to put the STATION tag
FIC477 into auto mode when the button is clicked. Additionally, when the AUTO atom of the controller is set, the status
light appears in red.

TS00232B

Submodel:
Variable

FP_DYputpbstat
Description

button_label

Label to be displayed on the button (A).


Default: none

on_value

Value of the tag database point configured in the variable statatom that will set the
status light on.
Default: 0

put_tagatom

Tag.atom of the tag database point to which the data configured in put_value will
be written (FIC-447.AUTO).
Default: none

put_tagatom2 Tag.atom of the tag database point to which the data configured in put_value2 will
be written.
Default: none
put_tagatom3 Tag.atom of the tag database point to which the data configured in put_value3 will
be written.
Default: none
put_tagatom4 Tag.atom of the tag database point to which the data configured in put_value4 will
be written.
Default: none
put_value

Value that will be written to the tag database point configured in put_tagatom (1).
Default: none

put_value2

Value that will be written to the tag database point configured in put_tagatom2.
Default: none

put_value3

Value that will be written to the tag database point configured in put_tagatom3.
Default: none

WBPEEUI340020B1

A - 17

FP_DYputpbstat2

Variable

Description

put_value4

Value that will be written to the tag database point configured in put_tagatom4.
Default: none

statatom

Tag.atom of the tag database point that sets the status light on when its value is
equal to on_value (FIC-447.AUTO).
Default: none

FP_DYputpbstat2
pushbutton

Purpose:

The following submodel FP_DYputpbstat2 is a pushbutton that


writes values into up to four tag database points. The button
label changes color and an asterisk is displayed based on the
value of a tag database point. The following example shows an
instance of FP_DYputpbstat2 configured to put the STATION
tag FIC477 into auto mode when the button is clicked. Additionally, when the AUTO atom of the controller is set, an asterisk (*) is displayed to the right of the label, and the label Auto
appears in red.

TC00233B

Submodel:
Variable

FP_DYputpbstat2
Description

button_label

Label to be displayed on the button (Auto).


Default: none

face_color

Number of the desired face color of the button.


Default: 26

low_color

Number of the desired lower edge color of the button.


Default: 29

off_color

Number of the desired color of the button label when the tag database point
configured in statatom is not equal to the value configured in on_value.
Default: 0 (black)

on_color

Number of the desired color of the button label when the tag database point
configured in statatom is equal to the value configured in on_value.
Default: 0 (black)

A - 18

WBPEEUI340020B1

FP_DYstatpb

Variable

Description

on_value

Value of the tag database point configured in the variable statatom that will cause
an asterisk to be displayed on the button face and cause the button label to be
displayed in the color configured in on_color.
Default: 0

put_tagatom

Tag.atom of the tag database point to which the data configured in put_value will
be written (FIC-447.AUTO).
Default: none

put_tagatom2 Tag.atom of the tag database point to which the data configured in put_value2 will
be written.
Default: none
put_tagatom3 Tag.atom of the tag database point to which the data configured in put_value3 will
be written.
Default: none
put_tagatom4 Tag.atom of the tag database point to which the data configured in put_value4 will
be written.
Default: none
put_value

Value that will be written to the tag database point configured in put_tagatom
(i.e.,1).
Default: none

put_value3

Value that will be written to the tag database point configured in put_tagatom3.
Default: none

put_value4

Value that will be written to the tag database point configured in put_tagatom4.
Default: none

statatom

Tag.atom of the tag database point that is sets the status light on when its value is
equal to on_value (FIC-447.AUTO).
Default: none

up_color

Number of the desired upper edge color of the button label.


Default: 23

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYstatpb
pushbutton

Purpose:

WBPEEUI340020B1

The following submodel FP_DYstatpb is a pushbutton that


writes a value into a single tag database point and shows a red
status light when the status of a tag database point is set to
put_value. The following example shows an instance of
FP_DYstatpb configured to put the STATION tag FIC-477 into
auto mode when the button is clicked. Additionally, when the

A - 19

FP_DYtagpb

AUTO atom of the controller is set, the status light appears in


red.

TC00232B

NOTE: FP_DYstatpb is basically a simpler version of FP_DYputpbstat,


and can be used in cases where a value is to be written to only one tag database point. (FP_DYputpbstat allows up to four values to be written to as
many as four tag database points).

TC00232B

Submodel:

FP_DYstatpb

Variable

Description

button_label

Label to be displayed on the button (A).


Default: none

put_tagatom

Tag.atom of the tag database point to which the data configured in put_value will
be written (FIC-447.AUTO). This tag.atom also sets the status light on when its
value is equal to put_value (FIC-447.AUTO).
Default: none

put_value

Value that will be written to the tag database point configured in put_tagatom (1);
this is also the value used by put_tagatom to set the status light on.
Default: none

FP_DYtagpb
pushbutton

Purpose:

The following submodel FP_DYtagpb is a pushbutton containing the tag name of a tag database point that changes the display in the operator window to the point display for the tag
name.

TC00234A

Submodel:

A - 20

FP_DYtagpb

WBPEEUI340020B1

FP_DYtank

Variable

Description

TagName

Tag (Tagname.atom) of the tag database point to be displayed when the button is
pressed.

face_color

Number of the desired face color of the button.


Default: 26

low_color

Number of the desired lower edge color of the button.


Default: 29

txt_color

Number of the desired text color of the button label.


Default: 4

up_color

Number of the desired upper edge color of the button label.


Default: 23

tagnum

For use by summary display only. User input not required.

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYtank
tank

Purpose:

The following submodel FP_DYtank (Fig. A-8) is a tank with a


rounded bottom and top. The fill in both the rounded bottom
and the rectangular vessel body is based on the value of a
dynamic process variable.

T 02 11 7 A

Figure A-8. Dynamic Tank Submodel (FP_DYtank)


Submodel:

WBPEEUI340020B1

FP_DYtank

A - 21

FP_DYtank_ec

Variable

Description

tagatom

Tag.atom of the tag database point (or a constant value) that is used to determine
the height of the tank fill (FIC-447.PV).

fill_color

Number of the desired fill color of the tank.


Default: 0 (black)

lower_limit

Tag.atom of the tag database point or the constant value that represents the lower
limit of the rectangular area (FIC-447.LOWLIM).
Default: none

upper_limit

Tag.atom of the tag database point or the constant value that represents the upper
limit of the rectangular area (FIC-447.HIGHLIM).
Default: none

low level

Tag.atom of the tag database point or the constant value that represents the value
above which the rounded bottom is filled (0).
Default: none

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYtank_ec
tank

Purpose:

Submodel:
Variable

Like FP_DYtank, the submodel FP_DYtank_ec (Fig. A-8) is a


tank with a rounded bottom and top. The fill in both the
rounded bottom and the rectangular vessel body is based on
the value of a dynamic process variable. An additional feature,
erase color, allows configuration of a color to be used in portions of the submodel where the fill_color is erased. (For
FP_DYtank, the erase color is the background color of the
graphic on which it appears).
FP_DYtank_ec
Description

tagatom

Tag.atom of the tag database point (or a constant value) that is used to determine
the height of the tank fill (FIC-447.PV).

fill_color

Number of the desired fill color of the tank.


Default: 0 (black)

lower_limit

Tag.atom of the tag database point or the constant value that represents the lower
limit of the rectangular area (FIC-447.LOWLIM).
Default: none

upper_limit

Tag.atom of the tag database point or the constant value that represents the upper
limit of the rectangular area (FIC-447.HIGHLIM).
Default: none

A - 22

WBPEEUI340020B1

FP_DYtoggle

Variable

Description

low level

Tag.atom of the tag database point or the constant value that represents the value
above which the rounded bottom is filled (0).
Default: none

erase_color

Number of the color to be used in portions of the bar where the fill_color is erased.
Default: 0 (black)

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYtoggle
toggle

Purpose:

The following submodel FP_DYtoggle is a pushbutton that toggles the value of a tag database point between one and zero.
The color and text of the button label changes based on the
value of a tag database point. The following example shows an
instance of FP_DYtoggle configured to toggle the state of an
RCM tag C_DPV bit when the button is clicked.

TC00235B

Submodel:
Variable

FP_DYtoggle
Description

tagatom

Tag.atom of the tag database point that is to be toggled between one and zero.

face_color

Number of the desired face color of the button.


Default: 26

low_color

Number of the desired lower edge color of the button.


Default: 29

off_color

Enter the number of the desired color of the button label when the tag database
point configured in tagatom is not equal to the value configured in on_value.
Default: 0 (black)

off_label

Text to appear on the button face when the tag database point configured in
tagatom is not equal to the value configured in on_value.
Default: none.

on_color

Number of the desired color of the button label when the tag database point
configured in tagatom is equal to the value configured in on_value.
Default: 0 (black)

WBPEEUI340020B1

A - 23

FP_DYTrendpb

Variable

Description

on_label

Text to appear on the button face when the tag database point configured in
tagatom is equal to the value configured in on_value.
Default: none.

on_value

Value of the tag database point configured in the variable tagatom that will change
the button label to the text defined in the variable on_label.
Default: 0

up_color

Number of the desired upper edge color of the button label.


Default: 23

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYTrendpb
pushbutton

Purpose:

The following submodel FP_DYtrendpb is a pushbutton that


displays the historical trend with which it has been configured.

TC00236B

Submodel:
Variable
trend_index

FP_DYtrendpb
Description

Index number of the historical trend to be displayed when the button is clicked.

FP_DYvalue
dynamic value

Purpose:

A - 24

The following submodel FP_DYvalue (Fig. A-9) is used for the


dynamic display of data from a tag database point. It is used
for both numeric and ASCII data types.

WBPEEUI340020B1

FP_DYvectorpb

TC00237A

Figure A-9. Dynamic Value (FP_DYvalue)


Submodel:

FP_DYvalue

Variable

Description

tagatom

Tag.atom of the tag database point (or a constant value) to be displayed


(FIC-447.PV).

Type

Native - Displays the data in the format configured in the tag module (based on the
FMT atom for floating point values). This format is always used to display text data.
Value - Allows for user configurable format (refer to Decimal places).
Default: native

Decimal
places

Number of digits to the right of the decimal place. Used only when Value is
selected as the type; otherwise this item is not displayed.
Default: 2

Color

Number of the desired color as displayed in the color attribute control panel.
Default: 7 (white)

Font

Number of the desired font as displayed in the text attribute control panel.
Default: 7 (Helvetica bold)

Size

Size of the displayed data; 4.0 is the largest size and 1.0 is the smallest.
Default: 2.0

Align

Left - The first (left) digit of the dynamic value will be aligned with the starting
location (left border) of the box which defines this submodel for positioning on the
Grafx editor display.
Center - The dynamic value will be centered on the starting location (left border) of
the box which defines this submodel for positioning on the Grafx editor display.
Right - The last (right) digit of the dynamic value will be aligned with the starting
location (left border) of the box which defines this submodel for positioning on the
Grafx editor display.
Default: left

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYvectorpb
pushbutton

Purpose:

WBPEEUI340020B1

The following submodel FP_DYvectorpb is a pushbutton which


causes the display in an operator window to change to a new
display, specified by the user via configuration. By default, this

A - 25

FP_DYVertbar

change occurs in the window in which the vector pushbutton


is located. Use the drag and drop method to cause the new
display to appear in a different operator window.

TC00238B

Submodel:

FP_DYvectorpb

Variable

Description

Display type

Select the type of display to vector to. User must define variable

Index

Select the index of the desired display type or the tag name from the window that
appears following the selection of the display type.

FP_DYVertbar
bar graph

Purpose:

The following submodel FP_DYVertbar (Fig. A-10) represents


the value of a dynamic process variable in the form of a vertical bar graph with a scale.
100 0

800

600

400

200

0
T 02 11 8 A

Figure A-10. Dynamic Vertical Bar (FP_DYVertbar)


Submodel:

A - 26

FP_DYVertbar

WBPEEUI340020B1

FP_DYverttrend

Variable

Description

tagatom

Tag.atom of the tag database point (or a constant value) that is used to determine
the length of the bar (FIC-447.PV).

bar_color

Enter the number of the desired fill color of the bar.


Default: 7 (white)

axis_color

Enter the number of the desired color of the y-axis.


Default: 0 (black)

direction

Number from the table below representing the direction that the bar fills as the
value of Tag.atom increases from lower_limit to upper_limit.
Up - 1
Down - 0
Default: 1

label_color

Number of the desired color of the y-axis labels.


Default: 0 (black)

lower_limit

Tag.atom of the tag database point or the constant value that represents the lower
limit of the bar (0).
Default: none

upper_limit

Tag.atom of the tag database point or the constant value that represents the upper
limit of the bar (100).
Default: none

y_ticks

Number of tick marks to be displayed on the y axis.


Default: 0

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYverttrend
trend

Purpose:

WBPEEUI340020B1

The following submodel FP_DYVerttrend (Fig. A-11) displays a


current trend for a tag database point. The trace is drawn from
the top of the submodel. The data is scanned once every second and is not stored historically. The data is plotted on the
x-axis and the number of samples is plotted on the y-axis.

A - 27

FP_DYverttrend

100 0

900

800

700

600

500

400

300

200

100

0
0

20

40

60

80

100
T 02 1 19 A

Figure A-11. Vertical Trend Model (FP_DYVerttrend)


Submodel:

FP_DYVerttrend

Variable
tagatom

Description
Tag.atom of the tag database point that is to be trended (FIC-447.PV).

num_points Number of samples displayed on the trend.


axis_color

Number of the desired axis color.


Default: 0 (black)

label_color

Number of the desired label color.


Default: 0 (black)

trace_color

Number of the desired trace color.


Default: 7 (white)

x_ticks

Number of tick marks on the X axis.


Default: 0

y_ticks

Number of tick marks on the Y axis.


Default: 0

lower_limit

Tag.atom of the database point or the constant value that represents the lower limit
of the trace (FIC-447.LOWLIM).
Default: none

A - 28

WBPEEUI340020B1

FP_DYvslider

Variable

Description

upper_limit

Tag.atom of the database point or the constant value that represents the upper limit
of the trace (FIC-477.HIGHLIM).
Default: none

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

FP_DYvslider
slider

Purpose:

The following submodel FP_DYvslider (Fig. A-12) provides a


vertical slider for control of tag database points. The following
example changes the set point of a controller module.

TC00239A

Figure A-12. Vertical Slider Submodel (FP_DYvslider)


Submodel:
Variable

FP_DYvslider
Description

display_atom Tag.atom of the tag database point represented by the position of the solid arrow
(FIC-477.SP).
lower_limit

Tag.atom of the tag database point or the constant value that represents the lower
limit of the slider (FIC-447.LOWLIM).
Default: none

target_atom

Tag.atom of the tag database point to be written to when the slider is released. The
value is represented by the position of the hollow arrow (FIC-477.SP).
Default: none

upper_limit

Tag.atom of the tag database point or the constant value that represents the upper
limit of the slider. (FIC-447.HIGHLIM).
Default: none

WBPEEUI340020B1

A - 29

FP_DYwheel

FP_DYwheel
rotating equipment
display

Purpose:

The following submodel FP_DYwheel (Fig. A-13) is an animated


wheel that can be configured so that it appears to spin.

T 02 12 0A

Figure A-13. Dynamic Wheel (FP_DYwheel)


Submodel:
Variable

FP_DYwheel
Description

dir

Tag.atom of a point in the tag database, or enter the value representing the
direction in which the wheel will spin.
Clockwise - 1
Counterclockwise - 0

on_tagatom

Tag.atom of a point in the tag database (HS-5441.PV); the value of this point is
used by the variable on_value (described below) to activate the spin dynamic
attribute of the submodel.

on_value

Value entered will be compared with the value of the tag database point configured
in the variable on_tagatom. When the value of the tag.atom matches the value
configured for on_value, the wheel will appear to spin.

period

Frequency at which the wheel spokes will appear to change position. The period is
measured in tenths of a second; the number entered here defines how many
tenths of a second are in the period (a 5 entered here means the period would
be.5 seconds in duration).
The higher the number used to define the period, the slower the object will appear
to spin.
Default: 1 (one tenth of a second).

spoke_color

Index number of the color to be used for the wheel spokes.


Default: 0 (black)

wheel_color

Number of the color to be used for of the wheel interior.


Default: 0 (black)

NOTE: Color numbers can be found on the color palettes in the settings or the properties window.

A - 30

WBPEEUI340020B1

Symbols

Appendix B

Introduction
Symbols are standard static submodels preconfigured and
supplied by ABB. Symbols are objects which represent standard items such as vessels, tanks and storage bins. Symbols
which correspond to those defined by the Instrument Society
of America (ISA) have the prefix ISA_. Non ISA symbols created
by ABB contain the prefix FP_ST. (Dynamic attributes can be
assigned to these submodels via the Dynamic Attributes menu
item.)
The following topics contain tables which list the available ISA
and non ISA symbols by category. Each table lists the name of
the symbol, followed by a brief description.
Table B-1. Values and Actuators
Symbol Name

Description

Illustration

FP_STvlv3

3 way valve body

Figure B-1, Item A

FP_STvlv3actr

3 way valve with on/off actuator

Figure B-1, Item B

FP_STvlv3matr

3 way valve with manual actuator

Figure B-1, Item C

FP_STvlv3tact

3 way valve with throttling actuator

Figure B-1, Item D

ISA_ACTR

On/off actuator

Figure B-2, Item A

ISA_BVLV

Butterfly valve

Figure B-2, Item H

ISA_CVLV

Check valve

Figure B-2, Item F

ISA_MATR

Manual actuator

Figure B-2, Item B

ISA_RVLV

Relief valve

Figure B-2, Item E

ISA_TACT

Throttling actuator

Figure B-2, Item C

ISA_VLV3

3 way valve body

Figure B-2, Item G

ISA_VLV3_ACTR

3 way valve with on/off actuator

Figure B-2, Item M

ISA_VLV3_MATR

3 way valve with manual actuator

Figure B-2, Item L

ISA_VLVE

Valve body

Figure B-2, Item D

ISA_VLVE_ACTR

Valve with on/off actuator

Figure B-2, Item I

ISA_VLVE_MATR

Valve with manual actuator

Figure B-2, Item K

ISA_VLVE_TACT

Valve with throttling actuator

Figure B-2, Item J

WBPEEUI340020B1

B-1

Introduction
Table B-2. Containers and Vessels
Symbol Name

Description

Illustration

FP_STcyltank

Cylindrical tank

Figure B-1, Item E

ISA_ATNK

Atmospheric tank

Figure B-3, Item E

ISA_BINN

Storage bin

Figure B-3, Item F

ISA_DTWR

Distillation tower

Figure B-3, Item A

ISA_FTNK

Floating roof tank

Figure B-3, Item G

ISA_GHDR

Gas holder

Figure B-3, Item H

ISA_JVSL

Jacketed vessel

Figure B-3, Item D

ISA_PVSL

Pressure storage vessel

Figure B-3, Item I

ISA_RCTR

Reactor

Figure B-3, Item B

ISA_VSSL

Vessel

Figure B-3, Item C

ISA_WHPR

Weigh hopper

Figure B-3, Item J

Table B-3. Rotating Equipment (Pumps and Blowers)


Symbol Name

Description

Illustration

ISA_BLWR_LF

Blower - outlet on left

Figure B-4, Item B

ISA_BLWR_RT

Blower - outlet on right

Figure B-4, Item A

ISA_CMPR

Compressor

Figure B-4, Item F

ISA_PUMP_LF

Pump - outlet on left

Figure B-4, Item C

ISA_PUMP_RT

Pump - outlet on right

Figure B-4, Item D

ISA_TURB

Turbine

Figure B-4, Item E

Table B-4. Reciprocating Equipment


Symbol Name
ISA_RECP

Description
Reciprocating compressor

Illustration
Figure B-4, Item G

Table B-5. Mixing Equipment


Symbol Name

B-2

Description

Illustration

ISA_AGIT

Agitator

Figure B-5, Item E

ISA_AGIT_MOTR

Agitator with motor

Figure B-5, Item F

ISA_IMIX

Inline mixer

Figure B-5, Item G

WBPEEUI340020B1

Introduction
Table B-6. Material Handling Equipment
Symbol Name

Description

Illustration

ISA_CNVR

Conveyor

Figure B-5, Item A

ISA_Mill

Mill

Figure B-5, Item D

ISA_RFDR

Rotary feeder

Figure B-5, Item B

ISA_RSTD

Roll stand

Figure B-5, Item C

ISA_SCNV

Screw conveyor

Figure B-5, Item H

Table B-7. Electrical Equipment


Symbol Name

Description

Illustration

ISA_CBRK

Circuit breaker

Figure B-6, Item A

ISA_DLTA

Delta connection

Figure B-6, Item B

ISA_FUSE

Fuse

Figure B-6, Item C

ISA_MCTR

Manual contactor

Figure B-6, Item D

ISA_MOTR

Motor

Figure B-6, Item E

ISA_MOTOR_BASE

Motor with base

Figure B-6, Item F

ISA_STAT

State indicator

Figure B-6, Item G

ISA_WYEC

WYE connection

Figure B-6, Item I

ISA_XFMR

Transformer

Figure B-6, Item H

Table B-8. Filers


Symbol Name

Description

Illustration

ISA_LFLT

Liquid filter

Figure B-7, Item A

ISA_VFLT

Vacuum filter

Figure B-7, Item D

Table B-9. Scrubbers and Precipitators


Symbol Name

Description

Illustration

ISA_EPCP

Electrostatic precipitator

Figure B-7, Item B

ISA_SCBR

Scrubber

Figure B-7, Item C

Table B-10. Separators


Symbol Name
ISA_CSEP

WBPEEUI340020B1

Description

Illustration

Cyclone separator

Figure B-7, Item E

ISA_RSEP

Rotary separator

Figure B-7, Item F

ISA_SDRY

Spray dryer

Figure B-7, Item G

B-3

Symbol Illustrations
Table B-11. Heat Transfer Devices
Symbol Name

Description

Illustration

ISA_FAXR

Forced air exchanger

Figure B-8, Item D

ISA_FURN

Furnace

Figure B-8, Item C

ISA_KILN

Rotary kiln

Figure B-8, Item E

ISA_XCHG1

Exchanger

Figure B-8, Item A

ISA_XCHG2

Exchanger

Figure B-8, Item B

Table B-12. HVAC Equipment


Symbol Name

Description

Illustration

ISA_CTWR

Cooling tower

Figure B-8, Item F

ISA_EVPR

Evaporator

Figure B-8, Item G

ISA_FNXR

Finned exchanger

Figure B-8, Item H

Table B-13. Miscellaneous


Symbol Name

Description

Illustration

FP_STfillarrow

Filled arrowhead

Not Shown

FP_STrtarrow

Right arrow

Not Shown

Symbol Illustrations
The following illustrations provide examples of the
preconfigured symbols described in the preceding section.

A . F P _S T vlv3

B. F P _S T v lv 3actr

E. F P _S T cy lta nk

C. FP _S Tv lv3m atr

D. F P _S T v lv3tact

T 02 12 1 A

Figure B-1. Non ISA Symbols

B-4

WBPEEUI340020B1

Symbol Illustrations

A. ISA _AC T R

E. ISA _RVLV

J. IS A_V LVE _TAC T

B. IS A_ M AT R

F. IS A _C V LV

C. ISA _TA C T

G . IS A_V LV3

K. ISA _V LV E _M AT R

D. ISA _VLV E

H . ISA _BV LV

I. ISA _VLV E_AC T R

L. ISA _VLV 3_M ATR

M . ISA _VLV 3_AC T R


T 02 12 2 A

Figure B-2. Valves and Actuators

A. IS A_D T W R

B. IS A_ R C T R

C. ISA _VS SL

D. ISA _JV SL

E. IS A_AT N K

F. ISA _B IN N

G . IS A_F T N K

H . ISA _G H D R

I. ISA _PV SL

J. IS A_W H P R
T 02 1 23 A

Figure B-3. Containers and Vessels

WBPEEUI340020B1

B-5

Symbol Illustrations

A. IS A _B LW R _ RT

E. IS A _T U R B

B. IS A_ B LW R _LF

C. IS A _P U M P_L F

F. ISA _C M P R

D. IS A_ P U M P_RT

G . IS A _R E C P
T 02 12 4 A

Figure B-4. Rotating and Reciprocating Equipment

A. ISA _C N V R

B. IS A_ R FD R

C. ISA _R ST D

D. ISA _M ILL

E. ISA _AG IT

F. ISA _AG IT_ M OT R

G . IS A_IM IX

H . ISA _SC N V

T 02 1 25 A

Figure B-5. Mixing and Material Handling Equipment

B-6

WBPEEUI340020B1

Symbol Illustrations

A. ISA _C B R K

B. IS A_ D LTA

C. ISA _F U SE

E. ISA _M O T R

F. ISA _M O T R _B AS E

H . ISA _XF M R

I. ISA _W V EC

D. ISA _M C T R

G . IS A_S TAT

T 02 1 26 A

Figure B-6. Electrical Equipment

A. ISA _LF LT

E. ISA _C S EP

B. IS A_ EP C P

C. ISA _SC B R

F. ISA _R S EP

D. ISA _VF LT

G . IS A_S D RY
T 02 1 27 A

Figure B-7. Filters, Scrubbers, Precipitators and Separators

WBPEEUI340020B1

B-7

Symbol Illustrations

A. ISA _X C H G 1

E. ISA _K ILN

B. IS A_ XC H G 2

C. ISA _F U R N

F. ISA _C T W R

H . ISA _F N XR

D. ISA_ FA XR

G . IS A_E VP R

T 02 12 8 A

Figure B-8. Heat Transfer Devices and HVAC Equipment

B-8

WBPEEUI340020B1

Faceplates and Point Displays

Appendix C

Introduction
Harmony faceplates and point displays are supplied by ABB
and contain preconfigured dynamic attributes. These models
are used to configure faceplates and to display point data from
the Harmony devices in the Symphony system. Refer to the
following tableTable C-1 for a list of faceplate and point display
submodels.
Table C-1. Harmony Faceplate Submodels
Tag Type
Analog

Point Display
tuneHarm_ANALOG

FacePlate
Harm_ANALOG

Analog (annunciator faceplate)

Harm_ANALOG

Analog (enhanced)

tuneHarm_ENANALOG

Harm_ENANALOG

Analog export

tuneHarm_ANALOGEXP

Harm_ANALOGEXP

Data acquisition analog (DAANG)

tuneHarm_DAANG

Harm_DAANG

Data acquisition digital (DADIG)

tuneHarm_DADIG

Harm_DADIG

DCS server

Harm_HSCANNER

Device driver (DD)

tuneHarm_DEVDR

Harm_DEVDR

Digital

tuneHarm_BOOLEAN

Harm_BOOLEAN

Digital (annunciator faceplate)

tuneHarm_DIGITAL

Harm_BOOLEAN

Digital (enhanced)

tuneHarm_ENDIGITAL

Harm_ENDIGITAL

Digital export

tuneHarm_DIGEXP

Harm_DIGEXP

Module status

Harm_MODULESTAT

Multi-state device driver (MSDD)

tuneHarm_MSDD

Harm_MSDD

PHASEX

Harm_PHASE_X

Remote control memory (RCM)

tuneHarm_RCM

Harm_RCM

Remote manual set constant (RMSC)

tuneHarm_RMSC

Harm_RMSC

Remote motor control block (RMCB)

tuneHarm_RMCB

Harm_RMCB

Station

tuneHarm_DCS

Harm_DCS

Text selector

tuneHarm_TEXT1

Harm_TEXT

Text string

tuneHarm_TEXTSTR1

Harm_TEXTSTR

WFPEEUI200001C0

C-1

WFPEEUI200001C0

Index
A
Accessing grafx editor .............................. 2-1
Adding a point......................................... 2-34
Adjusting view of model ............................ 2-8
Aligning multiple objects ........................... 2-7
Applying submodel changes................... 2-38
Arcs ........................................................ 2-15
Arrange icons ......................................... 2-43

B
Background color.................................... 2-25
Blink attribute .......................................... 2-55

C
Changing a point .................................... 2-34
Circles..................................................... 2-12
Color palette
Fifth range of colors 512-998................. 2-3
First range of colors 0-31....................... 2-2
Fourth range of colors 256 to511........... 2-3
Implementation ...................................... 2-3
Second range of colors 32-95................ 2-2
Third range of colors 96 to 255.............. 2-3
Configure dynamic attribute settings ...... 2-50
Configuring dynamic submodels............. 2-71
Configuring submodels ........................... 2-58
Copy ....................................................... 2-30
CreateMPort ........................................... 2-75
Creating custom dynamics ..................... 2-59
Creating models ....................................... 2-3
Cross reference ...................................... 2-39
Custom ................................................... 2-79
Custom models for point/group............... 2-79

D
Deleting .................................................. 2-33
Deleting a point....................................... 2-35
Deleting models ...................................... 2-39
Depth/grouped objects ........................... 2-29

WBPEEUI340020B1

Description and Operation ........................2-1


Drawing order..........................................2-31
Dynamic configuration examples ............2-68
Multiple expressions.............................2-69
Single expression.................................2-69
Dynamics ................................................2-43
Blink attribute .......................................2-55
Configure attributes for objects ............2-44
Configure dynamic attribute settings ....2-50
Configure expression ...........................2-45
Configure submodel .............................2-44
Custom dynamics.................................2-44
Dynamic attributes ...............................2-44
Expression dynamics window ..............2-44
Expression true ....................................2-48
Fill color attribute..................................2-54
Filled attribute.......................................2-53
Grouped objects and expressions........2-48
Line color attribute................................2-54
Line style attribute ................................2-54
Line width attribute ...............................2-55
Multiple expressions.............................2-49
Operators and operands ......................2-45
Pattern attribute....................................2-55
Spin attribute ........................................2-57
Text attributes ......................................2-53
Text color attribute ...............................2-54
DynProp
Examples .............................................2-62
Syntax ..................................................2-60
Variables ..............................................2-60

E
Edit menu ................................................2-41
Selecting objects ..................................2-42
Specifying model..................................2-42
Undoing previous actions .....................2-42
Example graphic configuration..................3-1
Exiting .......................................................2-2
Expression true .......................................2-48
Expressions as submodel variables........2-77

Index - 1

Index (continued)
F
Favorites .................................................2-41
File menu ................................................2-37
Favorites options..................................2-41
Set running...........................................2-38
Fill attributes............................................2-23
Fill color attribute.....................................2-54
Fill pattern selection ................................2-23
Filled attribute..........................................2-53

G
Glossary ....................................................1-2
Graphic attributes of objects ...................2-22
Grid attributes..........................................2-26
Grouped objects and expressions...........2-48
Grouping/ungrouping ..............................2-28

H
How to use this instruction ........................1-1
HSI Submodels .......................................2-76

I
Installation .................................................1-1
Intended user ............................................1-1

L
Line attributes .........................................2-24
Line color attribute...................................2-54
Line style attribute ...................................2-54
Line width attribute ..................................2-55
LoadMPort ..............................................2-76

M
Markers ...................................................2-13
Menu bar .................................................2-36
Model port development..........................2-75
Move .......................................................2-29
Moving object in point mode ...................2-33

Index - 2

Multiple expressions ............................... 2-49


Multiple windows ...................................... 2-5

N
New window ........................................... 2-43

O
Object placement example ..................... 2-35
Opening windows ..................................... 2-5
Operators and operands......................... 2-45

P
Point operations...................................... 2-33
Adding a point...................................... 2-34
Changing a point ................................. 2-34
Deleting a point.................................... 2-35
Moving an object ................................. 2-33
Polygons................................................. 2-16
Polylines ................................................. 2-13
Properties window .................................. 2-27

R
Rectangles.............................................. 2-12
Redrawing the working view..................... 2-8
Remove from running ............................. 2-40
Reversing ............................................... 2-32
Rotate an object ..................................... 2-31

S
Scaling (resizing) .................................... 2-30
Select mode.............................................. 2-7
Selecting objects ........................... 2-27, 2-42
Changing drawing order ...................... 2-31
Copying an object ................................ 2-30
Deleting ............................................... 2-33
Depth, grouped objects ....................... 2-29
Extent of an object ............................... 2-29
Grouping and ungrouping.................... 2-28

WBPEEUI340020B1

Index (continued)
Individual objects ................................. 2-28
Moving object....................................... 2-29
Multiple objects .................................... 2-28
Reversing............................................. 2-32
Rotating ............................................... 2-31
Scaling ................................................. 2-30
Set running ............................................. 2-38
Settings window...................................... 2-23
Background color................................. 2-25
Fill attributes ........................................ 2-23
Fill pattern selection............................. 2-23
Grid attributes ...................................... 2-26
Line attributes ...................................... 2-24
Text attributes ...................................... 2-24
Shape toolbar ......................................... 2-11
Arcs...................................................... 2-15
Circles.................................................. 2-12
Closed splines ..................................... 2-15
Creating straight lines .......................... 2-11
Fill mode button ................................... 2-11
Markers................................................ 2-13
Polygons .............................................. 2-16
Polylines .............................................. 2-13
Rectangles........................................... 2-12
Splines ................................................. 2-14
Submodels........................................... 2-18
Text objects ......................................... 2-17
Text rectangles .................................... 2-18
Simulating motion using blink attribute ... 2-71
Snap mode ............................................... 2-6
Specifying model type ............................ 2-42
Splines .................................................... 2-14
Splines, closed ....................................... 2-15
Status bar ............................................... 2-10
Straight lines ........................................... 2-11
Submodels.............................................. 2-18
Creating instances ............................... 2-21

WBPEEUI340020B1

Design ..................................................2-19
Filter option ..........................................2-20
HSI submodels .....................................2-20
Running................................................2-19

T
Text attribute ...........................................2-53
Text attributes .........................................2-24
Text color attribute ..................................2-54
Text objects.............................................2-17
Text rectangles........................................2-18
Toolbar icon buttons..................................2-4

U
Undoing previous actions........................2-42
Using model variables.............................2-42
Using text to indicate conditions..............2-74
Using the true expression .......................2-70
Using true expression .............................2-70

V
Visible attribute........................................2-53

W
Window menu .........................................2-43
Arrange icons .......................................2-43
Cascade ...............................................2-43
New window .........................................2-43
Tile .......................................................2-43
Window list ...........................................2-43
Window operations..................................2-43
Working view grid......................................2-6

Index - 3

WBPEEUI340020B1

WBPEEUI340020B1 Litho in U.S.A. Mar2002


Copyright 2002 by ABB. All Rights Reserved
Registered Trademark of ABB.
Trademark of ABB.

http://www.abb.com/control
Automation Technology Products
Wickliffe, Ohio, USA
www.abb.com/processautomation
email: industrialitsolutions@us.abb.com

Automation Technology Products


Vsters, Sweden
www.abb.com/processautomation
email: processautomation@se.abb.com

Automation Technology Products


Mannheim, Germany
www.abb.de/processautomation
email: marketing.control-products@de.abb.com