Gfk1260f - Cimplicity Hmi Trend and Xy Chart

GE Fanuc Automation
CIMPLICITY Monitoring and Control Products
CIMPLICITY HMI
Trend and XY Chart
Operation Manual
GFK-1260F
April 1999
GFL-002
Warning
Warning notices are used in this publication to emphasize that hazardous voltages, currents, temperatures, or other
conditions that could cause personal injury exist in the equipment or may be associated with its use.
In situations where inattention could cause either personal injury or damage to equipment, a Warning notice is used.
Caution
Caution notices are used where equipment might be damaged if care is not taken.
Note
Notes merely call attention to information that is especially significant to understanding and operating the equipment.
This document is based on information available at the time of publication. While efforts have been made to be accurate,
the information contained herein does not purport to cover all details or variations in hardware or software, not to provide
for every possible contingency in connection with installation, operation, or maintenance. Features may be described
herein which are not present in all hardware and software systems. GE Fanuc Automation assumes no obligation of
notice to holders of this document with respect to changes subsequently made.
GE Fanuc Automation makes no representation of warranty, expressed, implied, or statutory with respect to, and assumes
no responsibility for the accuracy, completeness, sufficiency, or usefulness of the information contained herein. No
warranties of merchantability or fitness for purpose shall apply.
CIMPLICITY is a registered trademark of GE Fanuc Automation North America, Inc.

Windows, Windows NT and Windows 95 are registered trademarks of Microsoft Corporation
This manual was produced using Doc-To-Help, by WexTech Systems, Inc.
Copyright 1995-1998 GE Fanuc Automation North America, Inc.

All rights reserved
ii
Preface
GFK-1260F
Preface
Contents of this Manual

Chapter 1. Introducing Trends: Gives a brief description of CIMPLICITY HMI
Trending.
Chapter 2. Creating A Trend Chart: Shows how to create a trend chart on a
CimEdit screen.
Chapter 3. Trend Methods: Describes methods available for Trending and how to
implement them on a CimEdit screen.
Chapter 4. Creating a Quick Trend: Describes how to quickly trend a point
through the CIMPLICITY HMI Workbench
Chapter 5. Introducing XY Charts: Gives a brief description of CIMPLICITY
HMI XY Charts
Chapter 6. Designing an XY Chart: Describes how to design an XY Chart in
detail by using the XY Control Properties dialog box.
Chapter 7. Using XY SmartObject Charts: Describes how to quickly design an
effective XY Chart.
Related Publications
For more information, refer to these publications:
CIMPLICITY HMI Base System Users Manual (GFK-1180)
GFK-1260F
iii
Contents
Introducing Trends
1-1
Trend Introduction ................................................................................................................. 1-1

About Trends.......................................................................................................................... 1-1
Trend Chart Display............................................................................................................... 1-2
Runtime Actions..................................................................................................................... 1-5
Changing Chart Properties at Runtime..................................................................... 1-5
Zooming into a Specific Area .................................................................................. 1-6
Analyzing Data at a Selected Point in Time............................................................. 1-7
Scrolling Lines Forward and Backward ................................................................... 1-8
Configuring A Trend Chart
2-1
About Trend Charts................................................................................................................ 2-1

Inserting a Trend Chart Control Chart ..................................................................... 2-1
Resizing a New Trend Control Chart....................................................................... 2-2
The CIMPLICITY Trend Chart Properties Dialog Box......................................................... 2-4
Opening the CIMPLICITY Trend Chart Properties Dialog Box ............................. 2-4
Trend Control Line................................................................................................................. 2-5
Using Quick Lines to Create a Trend Chart Line..................................................... 2-5
Creating a New Trend Chart Line (Overview of Detailed Method)......................... 2-6
Configuring an Expression Line............................................................................... 2-8
Configuring a Logged Line ...................................................................................... 2-9
Configuring a Logged Expression Line ................................................................. 2-10
Configuring a CSV File Line ................................................................................. 2-12
Configuring a Reference Line ................................................................................ 2-14
Specifying Line Display Styles .............................................................................. 2-18
Mapping Axes to a Line......................................................................................... 2-19
Axis Configuration ............................................................................................................... 2-21
Configuring the X-axis........................................................................................... 2-21
Configuring the Y-axis........................................................................................... 2-25
Chart Properties.................................................................................................................... 2-29
Configuring Basic Chart Properties ....................................................................... 2-29
Configuring Advanced Chart Properties ................................................................ 2-31
Legend Properties................................................................................................................. 2-33
Grid Properties ..................................................................................................................... 2-35
Runtime Actions................................................................................................................... 2-36
Array Point Trends............................................................................................................... 2-37
Color and Font Choices on a Trend Chart............................................................................ 2-38
Selecting a Basic Color .......................................................................................... 2-38
Creating a Custom Color........................................................................................ 2-38
Modifying a Color.................................................................................................. 2-40
Choosing a Font ..................................................................................................... 2-41
GFK-1260F
Trend Methods
3-1
About Trend Methods ............................................................................................................ 3-1

Method Configuration ............................................................................................................ 3-3
Naming A Trend Control ......................................................................................... 3-3
Creating an Invoke Method Action .......................................................................... 3-3
Line Display Methods ............................................................................................................ 3-6
AddLoggedLine Method .......................................................................................... 3-6
AddLoggedPointLine Method.................................................................................. 3-8
AddPointLine Method............................................................................................ 3-10
DeleteTrendLine Method ....................................................................................... 3-11
SetLineAutoupdate Method ................................................................................... 3-12
SetLineDisplay Method.......................................................................................... 3-13
SetLineVisible Method .......................................................................................... 3-17
WriteReferenceFile Method................................................................................... 3-18
Methods for the Legend........................................................................................................ 3-20
SetLegendState Method ......................................................................................... 3-20
X-axis (Time Related) Methods ........................................................................................... 3-21
JumpToCurrentTime Method................................................................................. 3-21
PauseUpdates Method............................................................................................ 3-23
ScrollLines Method................................................................................................ 3-24
SetXDuration Method ............................................................................................ 3-25
SetXStartTime Method .......................................................................................... 3-26
Y-axis Methods .................................................................................................................... 3-28
SetLineYAxis Method............................................................................................ 3-28
SetYAxisVisible Method ....................................................................................... 3-30
SetLineUseChartY Method .................................................................................... 3-31
Visual Aid Methods.............................................................................................................. 3-33
ResetZoom Method................................................................................................ 3-33
SetGridState Method.............................................................................................. 3-33
Wait State Methods and Events............................................................................................ 3-35
EnableOutstandingLoggedRequestStateEvent Method .......................................... 3-35
DisableOutstandingLoggedRequestStateEvent Method......................................... 3-36
EnteringOutstandingLoggedRequestState Event.................................................... 3-37
LeavingOutstandingLoggedRequestState Event .................................................... 3-38
Other Methods...................................................................................................................... 3-39
AboutBox Method.................................................................................................. 3-39
SetCimplicityProject Method................................................................................. 3-39
Creating a Quick Trend
4-1
About Quick Trends ............................................................................................................... 4-1

Starting Quick Trends .............................................................................................. 4-1
Configuring a Quick Trend Chart ............................................................................ 4-3
Using Popup Menus to Make Quick Changes.......................................................... 4-4
Introducing XY Plots
5-1
About XY Plots ...................................................................................................................... 5-1
vi
CIMPLICITY HMI Trending and XY Chart Operation ManualApril 1999
GFK-1260F
Designing an XY Plot
6-1
About XY Plot Design ........................................................................................................... 6-1

Inserting an XY Plot Control ................................................................................... 6-2
Resizing a New XY Plot Control ............................................................................. 6-3
Opening the CIMPLICITY XY Plot Properties Dialog Box ................................... 6-4
Color and Font Choices for an XY Plot Control .................................................................... 6-5
Selecting a Basic Color ............................................................................................ 6-5
Creating a Custom Color.......................................................................................... 6-6
Modifying a Color.................................................................................................... 6-7
Choosing a Font ....................................................................................................... 6-8
XY Plot Foreground, Background and Chart Colors ............................................................. 6-9
XY Plot Axes Properties ...................................................................................................... 6-11
Finding the Axes Properties ................................................................................... 6-11
Designing XY Plot Axes........................................................................................ 6-11
XY Plot Series Properties..................................................................................................... 6-20
Finding the Series Properties ................................................................................. 6-20
Designing a Series.................................................................................................. 6-20
XY Plot Slider Properties..................................................................................................... 6-27
Finding the Sliders Properties ................................................................................ 6-27
Designing a Slider.................................................................................................. 6-27
XY Plot Grid Properties....................................................................................................... 6-32
Finding the Grid Properties.................................................................................... 6-32
Designing the Grid ................................................................................................. 6-32
XY Plot Legend Properties .................................................................................................. 6-34
Finding the Legend Properties ............................................................................... 6-34
Designing the XY Plot Legends............................................................................. 6-35
XY Plot Title Properties....................................................................................................... 6-40
Finding the XY Plot Title Properties ..................................................................... 6-40
Designing an XY Plot Title.................................................................................... 6-41
XY Plot Updates .................................................................................................................. 6-42
Plotting XY Data
7-1
About Plotting XY Data......................................................................................................... 7-1

Creating a Series of Data Values ............................................................................. 7-1
Scripting Examples for XY Plots ........................................................................................... 7-2
Resizing Series Vectors ........................................................................................... 7-3
Setting Individual Data Values ................................................................................ 7-3
Pushing one or more Data Values ............................................................................ 7-5
Pushing Values from Points ..................................................................................... 7-8
Setting one or more Data Values ............................................................................. 7-9
Setting Values from Points..................................................................................... 7-12
Using XY Plot SmartObjects
8-1
About XY Plot SmartObjects ................................................................................................. 8-1

XY Plot SmartObject Placement............................................................................................ 8-2
XY Plot SmartObject Configuration ...................................................................................... 8-3
Configuring the XY Plot SmartObject Series .......................................................... 8-3
Configuring the XY Plot SmartObject Axes ............................................................ 8-6
Configuring an XY Plot SmartObject Name and Colors ......................................... 8-9
Configuring an XY SmartObject Grid ................................................................... 8-10
GFK-1260F
Index
vii
XY Plot SmartObject Enhancements.................................................................................... 8-11

Configuring an XY Plot 1 Example ....................................................................... 8-12
Configuring the Plot 2 Example............................................................................. 8-15
Index
viii
GFK-1260F
Introducing Trends
Trend Introduction
CIMPLICITY HMI provides you with the ability to look at data from several different
perspectives. The charts that enable you to do this are:
Trend chartsIn which you can review, evaluate and log point point values over
time
XY chartsIn which you can plot values for one or more series, using two or more
axes.
About Trends
CIMPLICITY HMI provides you with extensive capabilities to trend data that is in several
different formats.
You can trend:
Runtime values
Data from a CIMPLICITY Database Logger
Combined runtime values and logged data
Data from a .CSV file
Data from a reference file that was created during runtime and can be recalled and
displayed. This reference trend can be displayed and compared with other
comparable data.
Arrays
CIMPLICITY HMI provides even more capability by letting you and / or a user:
GFK-1260F
Display trends with:

Multiple Y-axes so a user can display different parameter types in the same chart
Data from different time periods so a user can compare different production
periods in the same chart.
Different time duration so that a user can compare production periods of
differing length in the same chart.
Auto update enabled so that the most recently logged data is automatically
retrieved from disk while the trend is displayed.
Zoom and pan through logged data to locate data of particular interest.
Compare relative values with a slider that updates a legend with actual values.
Display long time periods in compressed format where the plotted data is the
average, minimum, maximum, first, or last element from a sample.
1-1
Trend Chart Display

You have considerable control over what your trend control chart displays and its appearance.
For information, you can:
Create a trend chart that displays:

Only the trend lines you choose to display
Minimum detail so a user can quickly view relative values from a data source,
based on time
All the details a user needs to fully analyze any of the trend lines
Allow a runtime user, for the one runtime session, specify what
Lines should display
Details should display
For display, you can choose the colors, line types and fonts that you think will work best. You
can also let a runtime user make changes during their runtime session.
Trend Chart Configuration Options
Display yaxis ticks /
numbersOptional
Choose chart
color
Choose chart
background color
Show/hide lines
Choose
Step
or
smooth curve
Choose line
style / color
Display x-axis ticks /
numbersOptional
Display page scroll
Optional
Display legend title
Optional
Slider
Specify font
and style
Display legend
and specific
detailsOptional
Display status bar

and specific
detailsOptional
Specify
percent
scroll
Display sparse detail
1-2
CIMPLICITY HMI Trend and XY Chart Operation ManualApril 1999
GFK-1260F
You can choose to display or hide:

Display feature
Choose to Display or Hide
Ticks and numbers
For the Y-axis

For the X-axis
Grid
Gridlines
Lines
Each line
Legend
Entire legend
Legend features
Specific features:
Title
Line ID
Y value at slider
Engineering units
Time at slider
Date at slider
Y-axis limits
Current point value
Array status
Autoupdate status
Entire status bar
Status bar
Status bar features
GFK-1260F
Introducing Trends
Specific features:
Status line
Current date
Current time
Status title
Slider date
Slider time
1-3
You can also specify how the charts many display features will appear.
Display feature
Other Configuration Options
Chart area
Choose the color
Chart background
Choose the color
Grid
The number of horizontal and /or vertical lines
Lines
Specify:
Style
Color
Specify the percent a line will scroll (forward / backward)
when the buttons are pressed
Percent scroll buttons

Page scroll buttons
Fonts
1-4
Specify to display or hide them
Choose font, style and size

You configure this powerful feature in CimEdit and display it in CimView. Because
it is a CIMPLICITY HMI ActiveX control, it has an easy to use CIMPLICITY Trend
Control Properties dialog box. On six straightforward tabs, you can customize the
trend chart exactly to your specifications.
GFK-1260F
Runtime Actions
During runtime if you, the trend chart designer allow it, a user can change the amount of detail
being viewed and even change the way it is displayed.
In addition a runtime user can easily:
Magnify (Zoom into) a specific area of the trend chart

Analyze data at a selected point in time
Scroll to data not currently on the chart
Changing Chart Properties at Runtime

The trend chart designer can allow a runtime user to change any or all of the chart properties
for the specific runtime session.
To change a trend charts properties during runtime:
1.
2.
3.
4.
Double click the trend chart. The CIMPLICITY Trend Control Properties dialog box
appears.
Select the tab that contains the propertys configuration specifications.
Change the propertys configuration.
Apply the change by doing one of the following:
Move to a different tab in the dialog box. The changes made on the previous tab
take effect.
Click Apply. Changes on the current tab take effect.
Click OK. All changes take effect and the CIMPLICITY Trend Control
Properties dialog box closes.
Important: The changes you make remain in effect while the trend is being displayed. If you
close the CimView window displaying the trend, then reopen it, the trend reverts to the
original properties configured for it in CimEdit.
GFK-1260F
Introducing Trends
1-5
Zooming into a Specific Area

When you display the chart, CIMPLICITY HMIs zoom feature lets you examine areas of the
trend more closely.
To zoom in on an area of the trend chart:
1.
2.
3.
Place the mouse cursor in the chart area at one corner of the area you wish to
examine in more detail.
Hold down the left mouse key and slide the mouse cursor diagonally, making a
rectangle enclosing the area you wish to examine.
Lift the mouse button.
The chart will be redrawn to display the area you selected in a scale that fits the chart
area.
Note: While you are zoomed in, the auto update and run-time timers are ignored. The
zoomed portion of the screen remains unchanged until you zoom out again, at which point
new values are drawn and the timers are used again.
To return to your normal chart display:
1.
2.
3.
1-6
Place the mouse cursor in the chart area.

Hold down the left mouse key and slide the mouse out of the trend control area.
Lift the mouse button
The chart redraws in normal mode.
GFK-1260F
Analyzing Data at a Selected Point in Time

A slider is a vertical line that extends over the chart area. Every trend control chart has one. If
the chart legend displays the Y values, dates, and times, they will be updated as the slider
moves across the chart.
To use the slider:
Method 1Move the slider
Point to the slider. (the cursor changes to
location you want.
when you are in position.) and drag the slider to
Method 2Attach the chart slider to the most recent update data:
Drag the slider off the right edge of the chart.
The slider will then attach to the most recently plotted data and move as new values are
plotted.
Method 3Turn off the most recent update mode
Do one of the following:
GFK-1260F
Drag the slider to a new position

Zoom into an area
Display the CIMPLICITY Trend Control dialog box
Introducing Trends
1-7
Scrolling Lines Forward and Backward

Trending provides four scroll buttons, two forward and two backward, to make it easy for the
user to view past trending information and to return to current trending.
Scrolling Options
To scroll one page:
buttons to scroll backward or forward one page on the chart.
Use the
To scroll a percent of the visible chart:

Use the
buttons to move the line back or forward a specified percent.
The percent is specified by the trend control designer in the CIMPLICITY Trend Control
Properties dialog box. (in the Scroll Percentage field in the Advanced dialog box on the
Chart property tab)
Non-array Data Scrolling

The type of data line you are scrolling determines how much information you see when you
scroll. Scrolling also behaves differently for non-array and array data.
Line Scrolled
You will see:
Point data from the current time:

Back to the past
Only runtime data that has been accumulated up

to one chart page worth of data. You can
continue scrolling but no data is displayed where
it is not available.
Into the future
No data because it has not been received yet.
Logged point data:

Back to the past
Runtime data that has been accumulated up to

one chart page worth of data. Whenever runtime
data is not available, logged data is displayed, if
available.
Into the future
Logged or CSV data
1-8
Back to the past
Data if it is available from the database or the

CSV file.
Into the future
Only logged data if it is available for that future

time span
GFK-1260F
Array Data Scrolling

If a line is an array, whenever the array data changes, the old line is erased and a new one,
representing the new data, is drawn.
Arrays display, as follows:
1.
2.
3.
4.
Full arrays are shown with the first array element drawn at the left edge of the chart.
The elements of the array are equally spaced across the length of the chart.
If an array line:
A. Is in its own X-axis, the:
Axis labels displayed are the element indexes rather than based on the time
span.
Time of the array values can be seen on the legend.
B. Shares its X-axis with another line, the axis labels displayed are based on the
time span.
The space between the last element and the end of the chart is equal to the space
between the first two elements.
The type of array line you are scrolling determines how much information you see
when you scroll. Scrolling also behaves differently for non-array and array data.
Array Line Scrolled
You will see:
Point arrays from the current time:

Current
Available array values that are closest to the new

X-axis end time.
Back to the past
No values will be displayed in a point line if the

scroll is for the entire duration of the chart.
Into the future

Logged point arrays
Current

X-axis end time, giving preference to runtime
data.
Back to the past
Array (logged) values if they are available in the

database if the scroll is for the entire duration of
the chart,
Into the future
Logged array data:
GFK-1260F
Current

X-axis end time.
Back to the past
Array values if they are in the database.
Into the future
Only logged data if it is available for that future

time span.
Introducing Trends
1-9
About Trend Charts

Trend Control charts that you configure in CimEdit are viewed during runtime in CimView.
Because the Trend chart control is a CIMPLICITY HMI ActiveX control, you can place it on
any CimEdit screen by simply clicking the Trend button on the CimEdit toolbar.
In addition, the CIMPLICITY Trend Control Properties dialog box provides you with tabs to
customize every aspect of the trend chart.
The tabs in the CIMPLICITY Trend Control Properties dialog box are:
Line
Displays the associated point or expression data
Axis
Defines the X and Y axes on the Trend.
Chart
Defines the chart characteristics of the Trend.
Legend
Defines the chart legend for the Trend.
Grid
Defines the grid display for the Trend.
Runtime Actions
Let you perform runtime actions when viewing the chart
Inserting a Trend Chart Control Chart

To insert the Trend Chart Control on a CimEdit screen:
Method 1
Click the Trend button on the OLE toolbar.
Method 2
1.
Click the OLE button on the Tools toolbar.
2.
Place the ActiveX Placement cursor where you want the top left corner of the control
to be located. You can move the control any time you want.
3.
Click the left mouse button.

The Insert Object dialog box opens.
4.
GFK-1260F
Select the ActiveX tab.
2-1
5.
Select CIMPLICITY Trend Control.
CIMPLICITY Trend Control
6.
Click OK. A new Trend control is placed at the position you selected in your
CimEdit screen.
The Trend control looks like this initially:
Resizing a New Trend Control Chart

You can resize a trend control chart quickly and /or precisely.
To resize a trend control chart:
Method 1Quick
1.
Grab one of the objects handles and move it.
Increase width
Increase in proportion
Increase height
2-2
GFK-1260F
Method 2Precision
1.
Select Edit on the menu bar.
2.
Select Properties.
Go to "Continue (after choosing from Methods 2-4)"
Method 3-Precision
Click the Properties button on the Format toolbar.
Method 4Precision
1.
Hold down the right mouse button.
2.
Select Properties from the drop-down menu.

The Properties Object dialog box displays when you use Methods 2-4.
Continue (after choosing from Methods 2-4)

1.
Select the Geometry tab.
2.
Enter the width and / or height for the trend chart in the Width field and Height
field.
Tip: Click the right mouse button in any area of the Trend control to display a popup menu
that is related to that area.
GFK-1260F
2-3
The CIMPLICITY Trend Chart Properties Dialog Box

After you insert a Trend control on your CimEdit screen, you can display and change its
properties, including:
Line
Displays the associated point or expression data
Axis
Defines the X and Y axes on the Trend.
Chart
Defines the chart characteristics of the Trend.
Legend
Defines the chart legend for the Trend.
Grid
Defines the grid display for the Trend.
Runtime Actions
Let you perform runtime actions when viewing the chart
You do this entire configuration in the CIMPLICITY Trend Chart Properties dialog box.
There are several methods for opening the CIMPLICITY Trend Chart Properties dialog box.
Opening the CIMPLICITY Trend Chart Properties Dialog Box

To open the CIMPLICITY Trend Chart Properties dialog box:
Method 1
Double-click the trend control.
Method 2
1.
Select the trend control.
2.
3.
Select CIMPLICITY Trend Control Object.
4.
Select Properties from the cascading menu.
Method 3
1.
2.
3.
Select CIMPLICITY Trend Control Object from the drop-down menu.
4.
Note: Any fields that do not apply to the Trend you are defining will be grayed out.
2-4
GFK-1260F
Trend Control Line

When you configure lines in Trending, you can quickly configure a points trend line by using
Quick Lines.
You can also take advantage of Trendings many features to define each line in detail.
Trending currently supports the following data sources for trend lines:
Expressions
Logged data
Logged Expressions
CSV files
Reference files
Using Quick Lines to Create a Trend Chart Line

Trending provides you with a way to quickly add lines that trend point values to your chart.
Once added, you can use them as they are, or further define them with detailed configuration.
To quickly create a Line:
1.
Open the CIMPLICITY Trend Chart Properties dialog box.
2.
Select the Lines tab.
Example: Lines Tab Using Quick Lines

Lines grid
Press to open
Select a Point browser
3.
GFK-1260F
Click the Quick Lines button
Line Display
(style)
dialog box
. The Select a Point dialog box opens.
2-5
4.
Select a Point ID.
The Line ID:
Appears in the Line ID column with an associated color
Will appear on the legend
The line will be visible.
5.
(Optional) Click Display to open the Line Display dialog box and change the line
display style.
6.
Either:
Continue until you have all the lines that you need.
Configure some lines with the detailed method.
Creating a New Trend Chart Line (Overview of Detailed Method)

The Line tab provides several tools, in addition to the Quick Lines button, to add a new line
to the Trend Chart.
To specify how lines appear on a Trend Chart:
1.
2.
Select the Lines tab.
Example: Lines Tab Filled In
Lines Grid
Line Types
Point
(Expression)
Logged
Logged Point
(Expression)
.CSV
Reference
Color palette
Creates blank
entry for new
line
Line Display
dialog box
Copies
selected line
configuration
Deletes line
Line - Axis Mapping

dialog box
Move line up
/ down in list
Quick Lines
Opens Select a Point
Browser
2-6
3.
Click the New button
4.
Select the Line type.
GFK-1260F
5.
Enter the required information for CIMPLICITY to associate data with that line type.
See each line types section for more information.
6.
Either:
A. Press Enter on the keyboard.
B. Click the Line ID column The Line ID appears in the Lines grid.
7.
Specify line characteristics in the Lines grid.

A. Select a color. Either:
Click the Color Palette button

(the Color Palette opens.) or,
Double click a unique line color.
, on the lines row in the Color column.
B. (Optional) Check In Legend to list the name of the associated data in the
Legend.
C. Check Visible to make the line visible.
8.
(Optional) Click Display to open the Line Display dialog box and change the line
display style.
9.
Continue to add lines as follows:

A. Click the New button
to enter completely new information for another line.
to copy the selected line. You can then modify the

B. Click the Copy button
entry. This is particularly useful if you want to display variations in an
expression.
10. Click the Delete button
to delete any unnecessary lines.
11. Click the

arrows to move a selected point up or down in the list. The
position in which it is displayed in the Properties dialog box is the position in which
it is displayed in the Legend during runtime.
Note: If the Visible line option is cleared, the In Legend line option is ignored. This means
that the line will not show up on the legend, unless the Legend show all chart option is
checked. See "Configuring Advanced Chart Properties" in this chapter.
GFK-1260F
2-7
Configuring an Expression Line

Expression lines display data reported by the CIMPLICITY Point manager. This type of
trend is also called a current trend, because all the information comes from current data.
Expression Line Configuration

To configure an Expression line:
1.
Select Expression in the Line type field.
Expression Line TypeCurrent Trend

Edit
Expression
Enter one or more Point IDs and
mathematical operators that can
be evaluated.
Expression
menu
Line Display dialog box
2.
Enter, in the Expression field, one or more Point IDs and mathematical operators
that can be evaluated.
Procedure to Disable Expression Line Scrolling

By default, expression lines scroll.
To disable expression line scrolling:
1.
Select the Chart tab.
2.
Click Advanced.
3.
Clear the Allow runtime scrolling check box.
Qualified Points and Expression Lines

If you do not specify a project, the Base project is used.
If you change the Base project on the Chart tab of the CIMPLICITY Trend Control
Properties dialog box and:
If a Point ID
Trending
Is fully qualified
Continues to draw the line using the same data source.
Is not fully qualified
Trending assumes the data is coming from the base

project. If you change the base project, Trending attempts
to find the point in the new base project.
This feature is useful if you have two or more projects with the same Point ID (for example,
BLDG_1 project and BLDG_2 project) and you want to be able to switch between them.
2-8
GFK-1260F
Configuring a Logged Line

Logged lines display data from a CIMPLICITY Database Logger group table. This type of
trend is also called an historical trend because all the information comes from logged data.
Logged Line Configuration

To configure a logged line:
1.
Select Logged in the Line type field.
Logged Line TypeHistorical Trend
Select the ODBC data source

(Default is CIMPLICITY Point
Logging)
Group log Table ID
Table/Column
browser
Column in group log table
Clear to keep the same

historical information as a
reference
Line Display
dialog box
2.
Select the ODBC data source from the Datasource drop down menu.
3.
Open the Table/Column browser to select the:

A. Table ID in the data source.
B. Column ID in the table.
4.
Specify the update status in the Auto update check box:

Check
Clear
Specify auto update

Keep the same historical information as a
reference
Logged lines can always be scrolled. If you leave Auto update blank, the line will update
when it is scrolled.
Important: The source for a Logged line is always a column in a group log table.
A group log table has one column per point, one row for all points.
See the Using the Database Logger chapter in the CIMPLICITY HMI for Windows NT and
Windows 95 Base System Users Manual (GFK-1180) for more information.
Note: Engineering Units will not be displayed with logged trends.
GFK-1260F
2-9
Configuring a Logged Expression Line

Lines using logged and runtime data display a combination of runtime and logged data.
Runtime data is reported by CIMPLICITY Point Management.
Logged data comes from a CIMPLICITY Log table.
Logged Expression Line Configuration

To configure a logged expression line:
1.
Select Logged expression in the Line type field.
Logged Point Line TypeCurrent and Historical Trend

Enter one or more Point IDs and
mathematical operators that can
be evaluated.
Point browser
Point ID
popup
Select the ODBC data source

(Default is CIMPLICITY Point
Logging)
Group log Table ID
Table/
Column
browser
Line Display
dialog box
2.
Enter, in the Point Expression field, one or more Point IDs and mathematical
operators that can be evaluated.
3.
Select the ODBC data source from the Datasource drop down menu.
4.
Open the Table/Column browser to select the:

A. Table ID in the data source.
B. Column ID in the table.
Procedure to Disable Logged Expression Line Scrolling

By default, logged expression lines scroll.
To disable expression logged line scrolling:
2-10
1.
Go to the Chart tab.
2.
Click Advanced.
3.
Clear the Allow runtime scrolling check box.
GFK-1260F
Logged Expression Lines and Scrolling Configuration

The behavior of the logged expression line type depends on how scrolling is configured on the
Chart tab as follows:
Allow runtime-scrolling
Behavior
Not selected
The Scroll Percentage determines the amount of run-time

data used. The rest of the data comes from the log table.
Example
Configure a chart to display a two (2) hour time
duration.
Set the Scroll Percentage to 25.
During the display the:
First hour and a half (1 ) comes from the log table
Last half-hour ( ) comes from run-time data.
You cannot scroll logged expression lines when Allow
runtime scrolling is not selected. In addition, the Trend
will always draw in Jump Scroll mode.
Selected
The Scroll Percentage no longer determines the amount

of run-time data used. The line displays up to one chart
page worth of run-time data. The rest of the data comes
from the log table.
You can scroll logged expression lines when Allow
runtime scrolling is selected.
Logged Expression Lines and Qualified Points

If you do not specify a project, the Base project is used.
If you change the Base project on the Chart tab of the CIMPLICITY Trend Control
Properties dialog box and:
If a Point ID
Trending
Is fully qualified
Continues to draw the line using the same data source.
Is not fully qualified
Trending assumes the data is coming from the base

project. If you change the base project, Trending attempts
to find the point in the new base project.
This feature is useful if you have two or more projects with the same Point ID (for example,
BLDG_1 project and BLDG_2 project) and you want to be able to switch between them.
Note: One of the sources for a Logged expression line is always a column in a group log
table. See the Using the Database Logger chapter in the CIMPLICITY HMI for Windows NT
and Windows 95 Base System Users Manual (GFK-1180) for more information.
GFK-1260F
2-11
Configuring a CSV File Line

CSV File lines display data from a specific .CSV file.
A .CSV file is a text file in which the fields are separated by commas.
CSV File Configuration

To configure a .CSV file line:
1.
Select CSV File in the Line type field.
CSV Line TypeData from CSV File Trend

Name of .CSV file
containing the data
Select a File
dialog box
Column ID in .CSV
file up to 64
characters long
Table/Column
browser

values as a reference
Line Display
dialog box
2.
Open the Select a File dialog box.
3.
Select the .CSV file that contains the trend data
4.
Open the Table/Column browser.
5.
Select the column in the .CSV file that contains the trend data.
CSV lines can be always be scrolled.

Guidelines for CSV files used by Trends include:
2-12
1.
Create a separate directory for your .CSV files.
2.
Give a CSV file used by Trends one of two formats. Choose the format, as follows:
Format
When
Common Time Stamp
All data has a common time stamp
3.
Unique Time Stamp

Each data column has a unique time stamp
The time stamp column(s) should use the date and time format indicated in the
International settings on your Control Panel. In the examples here, the format is
mm/dd/yy hh:mm:ss.
4.
Name columns using:
Either case. Columns are not case sensitive.
Up to 64 characters.
5.
Enter up to 255 columns in a .CSV file.
6.
Allow only the same data type within each column.
GFK-1260F
Example of data type
7.
If:
The data type of the column Float
Then:
All rows should have float values for that column.
Give CSV files names that fit the 8.3 format. The ODBC Text driver cannot open a
file with a filename greater than 12 characters.
Example
largest1.csv Can be a .CSV file name
Common Time Stamp Format for .CSV Lines

If all data columns in the file share a common time stamp, the file can have the following
format:
"Val1", "Val2", "_time",
10.75,1,9/19/95 8:32:00
10.83,2,9/19/95 8:33:00
The first line consists of the column names enclosed in double quotes, and separated by the
International settings list separator (in this case, a comma). The column that designates the
time stamp must be labeled "_time". The rows following the column names are the rows of
data.
Unique Time Stamp Format for .CSV Lines

If each data column is associated with a unique time stamp, then the file has the following
format:
"Val1", "Val1_time", "Val2", "Val2_time",
10.75,9/19/95 8:32:00,1,9/19/95 8:30:10
10.83,9/19/95 8:33:00,2,9/19/95 8:30:20
The first line consists of the column names enclosed in double quotes and separated by the
International settings list separator (a comma in this example). The column name which
designates the time stamp associated with a data column is "_time" concatenated to the data
column name (for example, " Val1_time"). The rows following the column names are the
rows of data.
GFK-1260F
2-13
Configuring a Reference Line

Creating a line as a reference for other lines can be useful in many instances.
A reference line is a horizontal line that will be updated.
Reference lines can be created from:
An expression
A reference file that is created by the Trending module through the Runtime Actions
tab in the CIMPLICITY Trend Control Properties dialog box.
Reference Line Types

Reference Line TypeReference Data or Trend
Choose A or B.
A
Enter one or more
Point IDs and
mathematical operators
that can be evaluated.
B
Name of .REF file
containing the data
values as a reference
Select a File
dialog box
Table/Column
browser
Line Display
dialog box
A Reference line is updated, as follows:

Reference Line
Value Source
2-14
How Trending Updates the Reference Line
Expression
Trending takes the latest value of the expression and draws a

horizontal line with the value. If the value of the expression
changes, Trending updates the reference line.
Reference file
Retrieves values from a reference file that are exported into the
reference file at runtime.
GFK-1260F
Reference Line Axes

Following is a description of reference line axes behavior:
Expression reference lines default to use the charts X-axis and Y-axis.
Reference file lines default to use their axes. They are named using the line ID with a
_X and _Y suffix respectively. The axis configuration is based on the contents of the
reference file. The X-axis defaults to no scroll.
Reference File Configuration

Although reference file configuration is very easy, it requires a few steps.
Important: Reference files are currently available only on the Intel Windows 95 and Intel
Windows NT platforms.
To configure a reference file to be used for a reference line:
1.
Select the Runtime Actions tab of the CIMPLICITY Trend Control Properties dialog
box.
Runtime Display Dialog Box

Export to
reference file...
enabled during
runtime
Check to make
the dialog box
available
Check to enable
the Runtime
action tab during
runtime
2.
Make sure the Show property pages at runtime and Runtime actions check
boxes are checked.
3.
During runtime:
A. Open the CIMPLICITY Trend Control Properties dialog box.
B. Select the Runtime Actions tab.
C. Click Export reference file The Save Reference File dialog box displays.
GFK-1260F
2-15
Select one or
more lines to
reference
Enter a path
including a
directory and
file name
Browse a
Windows 95/NT
Save As dialog
box
D. Click on each line that you want to write to the reference file.
E. Enter a directory and file name in the File Name field.
F.
It is better to create a separate directory for the file. However, if you do not
select a directory, the file is saved in the last directory you accessed with the
File Save dialog box. The default filename extension is .REF.
Click OK to write the reference file, or click Cancel to cancel your request.
When you click OK, all the data currently visible on the trend for the lines you
selected will be written to the reference file.
Important: The ODBC Text driver cannot open a file with a filename greater than 12
characters. For best results, enter a name that fits the 8.3 format. That is, the file name
should be eight characters or less, followed by a period and an extension of three characters or
less (for example, "largest1.txt").
2-16
GFK-1260F
Reference File Rows

Contents in Reference file rows include:
Row
Contains
Column names in double quotes and separated by the

International settings list separator (usually a
comma).
The column name that designates the time stamp
associated with a data column is a concatenation of
the data column name and "_TIME".
The minimum value and time for each line in the file.
The maximum value and time for each line in the file.
Remaining
The value and time each time the lines value changes
over the time period.
"Soap","Soap_TIME"
211,"03-01-1996 18:19:34.000"
506,"03-01-1996 18:24:34.000"
476,"03-01-1996 18:18:54.230"
474,"03-01-1996 18:19:16.570"
470,"03-01-1996 18:19:17.770"
467,"03-01-1996 18:19:19.040"
464,"03-01-1996 18:19:20.480"
461,"03-01-1996 18:19:31.220"
457,"03-01-1996 18:19:32.460"
If you selected more than one line to save, the value and time information for each line is
stored independently, as in the following example:
"Soap","Soap_TIME","Wax","Wax_TIME"
1,"03-01-1996 19:29:34.000",1,"03-01-1996 19:29:34.000"
575,"03-01-1996 19:34:34.000",575,"03-01-1996 19:34:34.000"
183,"03-01-1996 19:29:01.840",476,"03-01-1996 19:25:19.270"
179,"03-01-1996 19:29:02.850",472,"03-01-1996 19:25:20.280"
175,"03-01-1996 19:29:03.850",468,"03-01-1996 19:25:21.580"
172,"03-01-1996 19:29:04.860",467,"03-01-1996 19:25:22.590"
169,"03-01-1996 19:29:14.890",466,"03-01-1996 19:25:32.980"
165,"03-01-1996 19:29:15.900",462,"03-01-1996 19:25:34.000"
If the reference file is for an array point, the second line contains the first array element, the third line
contains the last array elements, and the rest of the rows contain the rest of the array elements. All array
elements have the same time value. For example:
"Step", "Step_TIME"
100, "03-01-1996 18:19:34.000"
105, "03-01-1996 18:19:34.000"
101, "03-01-1996 18:19:34.000"
102, "03-01-1996 18:19:34.000"
103, "03-01-1996 18:19:34.000"
104, "03-01-1996 18:19:34.000"
GFK-1260F
2-17
Specifying Line Display Styles

To change the display style of a line:
1.
Select a line in the Lines grid.
2.
Click Display.
The Line Display dialog box opens.

Line Display Dialog Box
Choose a solid line.

Specify the width.
Choose a non-solid line.
The width is fixed.
Value to represent
a group of values
None
Average
First
Last
Minimum
Maximum
Check to hide the

line at runtime
Steprecommended for runtime lines

Smooth
3.
Select the line:

A. Style.
B. Width if the line style is solid. If it is not solid, the width is fixed.
4.
Select how data should be displayed if the number of data points to be plotted
exceeds the display area (available pixels).
If a compression type is selected:
A. The group size is automatically determined by Trending software.
B. The selected compression method (for example, average) is applied to that
group.
C. All the data points in that group are plotted as a single data point.
If no compression is selected, multiple data points are plotted along a vertical line.
2-18
GFK-1260F
5.
Select how the points should be connected. The choices are

Step
(Recommended for runtime display) Connects

data points with a stepped line
Smooth
6.
Connects data points with a straight line. The

legend will always display the last actual value
to the left of the cursor. That is, the value in the
legend does not reflect the line interpolation.
(Optional) Check the Hidden check box if you do not want the line to be displayed
on the chart at run-time.
Mapping Axes to a Line

If you have more than one Y-axis or X-axis, you can specify which axes will explain each
line.
To specify what axis will explain a trend line:
Method 1: Properties dialog box
Method 2: Popup menus
Continue: Following Method 1 or 2
Method 1Properties dialog box
1.
Click the Line Axis Mapping button
Go to "Continue (following Method 1 or 2)".

Method 2 Popup menus
1.
Place the cursor over either the Y-axis or X-axis.
2.
Click the right mouse button. A popup menu displays.

Example: X-axis Popup
3.
Select Line/Axis Mapping.

Go to "Continue (following Method 1 or 2)"
The Line-Axis Mapping dialog box appears when you use either method.
GFK-1260F
2-19
Example: Line-Axis Mapping

Lines associated with the
selected axis display in the
Lines box.
X-axis for selected line
Y-Axis for selected line.
Continue (following Method 1 or 2)

Do any or all of the following:
1.
Select an axis in the Show lines for axis field to see what lines it represents.
2.
Select a line in the Lines field.

A. Select an X-axis in the Configured X-axis field to associate with the line.
B. Select a Y-axis in the Configured Y-axis field to associate with the line.
Note: Y Chart Axis and X Chart Axis are the default axes.
2-20
GFK-1260F
Axis Configuration
Your trend chart has to have at least on X-axis and one Y-axis. At times, you may want to
configure more that can be used instead of either default axis.
To begin axis configuration:
1.
Open the CIMPLICITY TREND Chart Properties dialog box.
2.
Select the Axis tab.
Example: Axis Tab Filled In
Axis Grid
Fields change
between X-axis
and Y-axis
Creates blank
entry for new
axis
Copies
selected axis
configuration
Deletes any
axis, except
the default
Line - Axis Mapping

dialog box
Ticks and labels
for selected axis
Font dialog box
Configuring the X-axis

For each X-axis, you:
1.
2.
Configure the timing either in one of the following:
CIMPLICITY Trend Control Properties dialog box.
An X Axis Time dialog box that opens through a right mouse button popup
menu.
Configure other details in the CIMPLICITY Trend Control Properties dialog box.
Methods to Configure X-axis Timing

Access the X-axis timing either through the:
CIMPLICITY Trend Control dialog box, Axis tab
An X Axis Time dialog box that opens through a right mouse button popup menu.
To configure the X-axis timing:
GFK-1260F
2-21
Method 1CIMPLICITY Trend Control dialog box

1.
Select an X-axis in the Configured axes grid of the CIMPLICITY Trend Control
Properties dialog box.
2.
The Duration field and Start time box appear.

Example: X-axis Time Configuration in Trend Control Properties Dialog Box
Fields change based

on selection
Method 2Popup Menu

1.
Position the cursor over the X-axis.
2.
Click the right mouse button. A popup menu appears.
3.
Select Time.
X-axis Popup
An X Axis Time dialog box appears.
2-22
GFK-1260F
Continue (following Method 1 or Method 2)

1.
2.
Enter the Duration of time the X-axis represents. The format is ddd:hh:mm:ss
where:
Letters
Represent
ddd
day number: 0365
hh
Hours: 059
mm
minutes: 059
ss
seconds: 059
Configure the Start time from the following choices:
Example: X Axis Timing

ddd= 0 -365
hh = 0 - 23
mm = 0 - 59
ss = 0 - 59
A. Show most recent
ddd:hh:mm:ss
mm/dd/yy
Clear to allow
runtime scroll
hh:mm:ss
B. Start date
C. Now minus days
ddd
hh:mm:ss
A. Show most recent

No other entry is required. This is the same as selecting Now minus 0 days and
Now minus time with a time that is equal to the
duration.
B. Start date requires:
Start date
Enter an Absolute date in mm/dd/yy format
Now minus days
Number that specifies the number of days before the

current date. For example, enter 5 to begin the
display five (5) days before the current date.
C. Start time requires:
GFK-1260F
Start time
Absolute time in hh:mm:ss format
Now minus time
Number that specifies the number or hours, minutes

and seconds before the current time. The number is
specified in hh:mm:ss format. For example, enter
1:30:05 for a starting time1 hour 30 minutes and 5
seconds earlier than when the trend is first displayed.
2-23
Detailed X-axis Configuration

The several X-axis features, in addition to the time it represents, can be configured in the
To configure the X-axis details:
1.
Select an X-axis in the Configured axes grid.
Axis Grid
Fields change
when a different
axis is selected
Creates blank
entry for new
axis
Copies
selected axis
configuration
Deletes any
axis, except
the default
2.
Line - Axis Mapping

dialog box
Ticks and labels
for selected axis
Font dialog box
(Optional) Click the Font button
to display the Font dialog box.
Change the font to your specification. The font you choose will be used for all X and
Y-axes.
3.
Specify the axis characteristics in the Configured axis grid.

A. Select a color.

The Color Palette opens.
B. (Optional) Check Visible to make the X-axis visible.

4.
(Optional) Configure a label and ticks for the axis:

A. Enter a label in the Label field. The label you enter will be the axis title.
B. Select the number of ticks in the Ticks box that you want the X-axis to display.
You can select through 100.
C. Check the Numbered checkbox to label the tick marks.
D. Check the No scroll check box if you do not want users to scroll the X-axis at
run-time.
2-24
GFK-1260F
Configuring the Y-axis

For each Y-axis, you:
1.
2.
Configure the limits either in the:
Y-axis Limits dialog box
Configure other details in the CIMPLICITY Trend Control Properties dialog box.
Methods to Configure Y-axis Limits

Access the Y-axis timing either through the:
CIMPLICITY Trend Control dialog box, Axis tab
Trend Control popup menu
To configure Y-axis limits:

Method 1Detailed CIMPLICITY Trend Control dialog box
1.
Select a Y-axis in the Configured axes grid.

The Limits box appears.
Example: Y-Axis Limits Configuration in Trend Control Properties Dialog Box
Order of priority when

all options are selected:
2
If there are no
Point Limits
1
3 Each time a value
goes above or
below the existing
limit.
Method 2Popup Menu Configuration
1.
Position the cursor over the Y-axis area.
2.

Y-axis Popup
3.
Select Limits.
A Y Axis Limits dialog box appears.
GFK-1260F
2-25
Example: Y-Axis Configuration from Popup Menu
3
2
Each time a value goes
1 above or below the

existing limit.
Continue (following Method 1 or 2)

1.
Enter one, two or all options for the Y-axis limits

A. Enter numeric values in the Default lower limit and Default upper limit fields.
B. Check the Use Point Limits check box to have Trending use the points limits
specified in the ConfigurationPoint dialog box.
If Trending cant find limits in the ConfigurationPoint dialog box, it will use
the values you enter in the Default lower limit and Default upper limit fields.
C. Check the Autoscale check box to have Trending automatically change the Yaxis limits each time a value goes above or below the existing limit.
Autoscale functions as follows:
1. The highest and lowest values are found from all lines associated with the
axis.
2.
The decimal base is calculated for both highest and lowest values.
Examples
The decimal base of 150 is 100.
3.
The decimal base of 7654 is 1000.

The high limit is the number closest to the highest number on the high side,
using the calculated decimal base from the highest value as multiple.
The low limit is the number closest to the highest number on the low side,
using the calculated decimal base from the lowest value as a multiple.
Example
Given 478 and 7891 as the lowest and highest values found, the calculated
low and high limit for the axis is 400 and 8000. This is because 400 is the
closest value to 478 on the low side that uses a multiple of 100 and because
8000 is the closest value to 7891 on the high side that uses a multiple of
1000
2-26
GFK-1260F
Guidelines for the order of priority if you select all the limit options
Trending:
1.
Increments the upper or lower limit each time a value goes above or below the
existing limit.
2.
Uses the limits specified in the Points Configuration dialog box.
3.
Uses the limits specified in the Default lower limit and Default upper limit fields.
Detailed Y-axis Configuration

The several Y-axis features, in addition to the time it represents, can be configured in the
To configure the Y-axis details:
1.
Select A Y-axis in the Configured axes grid in the CIMPLICITY Trend Control
Properties dialog box.
Axis Grid
Fields change
between X-axis
and Y-axis
Creates blank
entry for new
axis
Copies
selected axis
configuration
Deletes any
axis, except
the default
2.
Line - Axis Mapping

dialog box
Ticks and labels
for selected axis
Font dialog box
(Optional) Click the Font button
to display the Font dialog box.
Change the font to your specification. The font you choose will be used for all X
and Y-axes.
GFK-1260F
2-27
3.
Specify axis characteristics in the Configured axis grid.

A. Select a color.
i.

The Color Palette opens.
ii.
iii. (Optional) Check Visible to make the Y-axis visible.

4.
(Optional) Configure a label and ticks for the axis:

A. Select the number of ticks in the Ticks box that you want the Y-axis to display.
You can select through 100.
B. Check the Numbered checkbox to label the tick marks.
5.
Continue to add axes as follows:

A. Click the New button
axis.
to enter completely new information for another
B. Click the Copy button

to copy the selected axis. You can then modify the
entry. This is particularly useful if you want to follow variations in an
expression.
C. Click the Delete button
to delete any axis beyond the primary X-Axis and
Y-axis that you decide you dont want.
2-28
GFK-1260F
Chart Properties
There are several details about the chart itself from its color to how many pixels away can a
cursor be from the slider and still grab it.
These details are configured in the Chart tab of the CIMPLICITY Trend Control Properties
dialog box and then in the Advanced dialog box that is accessed through the Chart tab.
Configuring Basic Chart Properties

The basic details including the chart color and auto update interval are configured in the main
Chart tab of the CIMPLICITY Trend Control Properties dialog box.
To configure basic chart properties:
1.
2.
Select the Chart tab.
Example: Chart tab filled in
Open Color palette Display scroll buttons

If checked, lines:
1. Draw left to right
2. Update across the
chart area.
3. Scroll when the
right edge is
reached
4. Continue update
from left to right.
Interval for:
Chart update
Chart redrawn
(hh:mm:ss)
If checked, lines:
1. Update at the right
edge
2. Scroll each time an
update is received
Project used for

unqualified
points, can be
changed at
runtime.
Open Advanced
dialog box
3.
4.
Click each color fields Color Palette button
to configure the charts colors:
Field
Selects color for the:
Foreground color
Slider, legend and chart X and Y-axes
Background field
Area surrounding the trend chart
Chart color
Solid color for the trend chart area
Enter the time between one new data update and the next in the Auto Update Interval
field. The format is hh:mm:ss.
Example
10 equals ten seconds; 1:00 equals one minute.
GFK-1260F
2-29
Note: Auto update will only occur for lines that have Auto Update selected on the Line tab
of the CIMPLICITY Trend Control Properties dialog box.
5.
Enter the time between one time that the chart redraws itself and the next in the Auto
Refresh Interval field. The format is hh:mm:ss.
6.
Select the CIMPLICITY project to be used for any unqualified Point IDs. The
default is provided by CimView, but it may be changed at run-time.
7.
(Optional) Check the Show buttons check box to display the scroll buttons.
8.
Choose an update style

Jump Scroll
The line:
Starts at the left of the chart
Updates across the chart area.
Is automatically scrolled by the scroll percentage,
specified in the Advanced dialog box, when the right
edge is reached
Continues to update from left to right.
Strip Chart
The line:
Updates at the right edge of the chart
Scrolls each time an update is received
9.
2-30
(Optional) Continue configuration in the Advanced Properties dialog box.
GFK-1260F
Configuring Advanced Chart Properties

The Advanced chart properties let you configure the Y-axis display, scroll percentage, slider
grab margin and other miscellaneous chart features.
To open the Advanced dialog box for chart properties:
1.
Select the Chart tab of the CIMPLICITY Trend Control Properties dialog box.
2.
Click the Advanced button.

The Advanced dialog box appears.
Choose
Multiple (default): All
nonhidden Y-axes
Single: Y-axis only
Percent Configured:
0100 Scale
Number of pixels
from slider in which
the slider can still be
grabbed
(110)
Amount of data scroll

when scroll buttons
are pressed
All lines use a single

time period and
duration
Legend shows visible

and hidden lines
Jump to current time
at next runtime or
auto update
All lines use a single

time period
Chart Y-Axis
3.
Scroll point and

logged point lines
Determine what Y-axis to display in the Y-axis display field. Choices are:
Multiple (Default)
Display all the currently configured Y-axes that are

not hidden
Single
Display the chart Y-axis only
Percent Configured
4.
Display a single Y-axis going from 0 to 100 percent.

All the lines are displayed on a scale of 0 to 100
percent of their ranges as configured on the Axis
property page.
Enter a percent in the Scroll percentage field to define the:
Time duration that the chart data will Scroll backward or forward when the
or
button is pressed during runtime.
Length of the jump when the drawing reaches the right edge of the chart if you
set the Update style to Jump scroll in the basic Chart tab.
Example of button scroll
A chart displays a two (2) hour time duration
Enter 25 in this field.
GFK-1260F
2-31
5.
6.
The chart will scroll backward or forward by a half-hour (25% of two (2) hours)
when the scroll button is pressed.
Enter the number (010) of pixels from the slider that a mouse cursor can move and
still grab the slider, in the Slider grab margin field..
(Optional) Check the Single X-axis check box if you want the chart to be displayed
with a single X-axis called the Chart X Axis. All lines will use the Chart X Axis.
In the case of Line charts that represent time, this option is mutually exclusive with
the Single Time Duration option. Therefore, if you select this option, the Single
time duration check box is unavailable.
7.
(Optional) Check the Single Y-axis check box if you want the chart to be displayed
with a single Y-axis called the Chart Y-axis. All lines will use the Chart Y-axis.
If you select this option, the Y-axis display is disabled.
8.
Check the Single time duration check box if you want all the lines in the chart to
use a single time duration. The time duration is the Chart X Axis duration. For
example, you want to view the data for all lines for a span of two hours, regardless of
start time.
For Line charts that represent time, this option is mutually exclusive with the Single
X-axis option.
9.
Check the Legend show all check box to display the legend information for all
visible and hidden lines on the chart.
Clear this check box to display information for only the visible lines on the chart.
Use the Legend tab to define the legend elements.
10. Check the Jump to current value check box to make the trend display
automatically jump back to the current time at the next run-time or auto update timer
interval whenever you scroll the chart.
Clear this check box to scroll manually to return to the current time. If one of the
objects on the CimView screen has a JumpToCurrentTime method configured for the
chart, you can use that method to scroll forward to the current time.
11. Check the Allow Runtime Scrolling check box to scroll Expression and Logged
Expression lines in the chart at run-time. You can see for:
Expression lines
Up to one chart page of data in the past. Beyond

that, no data is displayed
Logged Expression lines
Up to one chart page of run-time data in the past.

Beyond that, logged data is displayed if
available.
Clear the Allow Runtime Scrolling checkbox to prevent Expression and Logged
Expression lines from scrolling. See "Logged Expression Lines and Scrolling
Configuration" in this chapter for more information about how logged expressions
behave when this option is not checked.
2-32
GFK-1260F
Legend Properties
The Legend properties define the legend information for the lines on the chart.
To define the legend properties:
Method 1Properties dialog box
1.
2.
Select the Legend tab.
Example: Legends Tab
Display
Legend
Title
Open Font
dialog box
Single column
Two columns
Check to
display for
each line on
the chart
Number of
legend lines
Move item up /
down in list
3.
Check to display in
status line
(Optional) Check the Show legend check box to display the legend on the chart.
If you clear the check box, you have completed configuration of this tab.
4.
Check the Show title check box to display a title line for the legend.
5.
Check the items that will display for each line on the chart in the Line items box.
6.
Use the
7.
Select one and two columns in the Display format field for legend data display.
8.
Enter the number of legend lines to display in the Display height field
buttons to create the order in which you want the items displayed.
If you have more lines than can be displayed in the legend area, you can use the
vertical scroll bar to the right of the legend area to display the additional information.
9.
Check the information in the Status line box to display on the status line.
10. Click Font to select the font, font style, size and script for the legend and status bar.
GFK-1260F
2-33
Method 2Popup Menu in the Legend area

1.
Place the cursor over the X-axis.
2.

Example: Legend Popup
Check to show item
3.
Check Legend to display the legend.
4.
Select Show Fields. An extended menu appears.
5.
Check any fields you want to display in the Legend.
6.
Select Add Lines. An extended menu appears.
7.
Select the lines you want to display n the Legend.
8.
Check Status to display the status bar.
Method 3Popup menu in Status line

1.
Place the cursor over the Status area.
2.

Example: Status Popup
Check to show item
2-34
3.
Check Status to display the status line.
4.
Select Show Fields. An extended menu appears.
5.
Check the fields you want to display in the Status line.
6.
Check Legend to display the legend.
GFK-1260F
Grid Properties
You can display grid lines that divide your chart into sections. You do this on the Grid tab of
the CIMPLICITY Trent Control Properties dialog box.
To display gridlines on a chart:
Method 1: CIMPLICITY Trend Chart Properties dialog box
1.
2.
Select the Grid tab.

Check to display grid
Line Display Dialog Box
Choose a nonsolid line.

The width is
fixed
Enter the
number of
grid lines
Choose a
solid line.
Specify the
width
Display grid based on a selected
(or nearest) lines axis
3.
(Optional) Check the Show grid check box to display a grid on the chart.
If you clear the check box, you have completed configuration of this tab.
4.
Configure the gridline by selecting the:

A. Color
B. Style
C. Width, if the line style is solid. If it is not solid, the width is fixed.
5.
GFK-1260F
Enter the number of gridlines to display. Choose one of two alternatives:

Fixed
Enter the number of horizontal and vertical gridlines

to display
Axis ticks from line
Select an axis whose ticks will determine the grid

lines. If you select Use nearest axis, the first axis
with tick marks is used to determine the grid lines.
2-35
Method 2Popup menu in chart area (CimEdit or CimView)

1.
Place the cursor anywhere in the chart area.
2.
Click the right mouse button.
Example: Chart Popup
Check to show item
3.
Select Show. An extended menu displays.
4.
Select Grid.
The grid that you configured on the Grid tab displays.
Runtime Actions
Whether or not an operator can access one or more of the tabs or even open the CIMPLICITY
Trend Control Properties dialog box during runtime is under your control.
To enable/disable tabs in the CIMPLICITY Trend Control Properties dialog box
for runtime:
1.
Open the CIMPLICITY TREND Chart Properties dialog box.
2.
Select the Runtime Actions tab.

Export to
reference file...
enabled during
runtime
Check to enable
tab at runtime
Clear to
prohibit dialog
box display
during runtime
Axis tab disabled

during runtime
2-36
GFK-1260F
3.
Check the Show property pages at runtime check box to let an operator open the
CIMPLICITY Trend Control Properties dialog box during runtime. If you clear the
check box, you have completed configuration of this tab.
4.
Check the tabs that an operator can change during runtime in the Pages enabled at
runtime box.
Important: It you are using a reference file, you need to enable at least the Runtime Actions
tab so the operator can export data to the reference file. It is on this tab that the export button,
which is disabled during configuration, is enabled during runtime.
Array Point Trends

Array elements are numbered from zero (0) to one (1) less than the number of elements in the
array.
For example, if ARRAY has ten elements, the individual elements are ARRAY[0]
through ARRAY[9].
You may trend a single element of an array just as you can trend an ordinary line.
To trend a single element in an array:
1.
Enter the array name
2.
Write the elements number in square brackets at the end of the array name.
For example, to look at the first element in ARRAY, enter ARRAY[0].

To trend an entire array at a single instant in time:
Enter the array name only.
The resulting display depends on the Line Type you have chosen.
Logged data
The whole array is drawn as it was at the axis

end time.
Reference file
The time of the array is provided in the file.
Expression
The most recent data for the array is displayed.
Whenever the array data changes, the old line is erased and a new one, representing the new
data, is drawn.
Arrays display, as follows:
GFK-1260F
1.
Full arrays are shown with the first array element drawn at the left edge of the chart.
2.
The elements of the array are equally spaced across the length of the chart.
3.
The space between the last element and the end of the chart is equal to the space
between the first two elements.
2-37
Color and Font Choices on a Trend Chart

You can specify color or font characteristics in several parts of a Trend Chart. The methods
you use to accomplish each are the same in all instances.
Selecting a Basic Color

When you are asked to specify a color, you can select one from Trendings easy to use color
palettes.
To select a basic color:
1.
Click the drop-down list button to the right of the Color input field.
Basic Palette
Palette tab
Special tab
Click one to select a baic

color
Double click a blank box

to create a custom color
Right click an existing
customized color to edit it.
2.
Double click the color of your choice on the Palette tab.
Creating a Custom Color

CIMPLICITY HMI lets you create as many custom colors as you want; 16 custom colors at
any one time.
To create a custom color:
1.
2.
Double click an empty box at the bottom of the Palette tab.

The Color (custom color) Palette opens.
2-38
GFK-1260F
Color Palette: To create Customized Color
Color picker
Luminosity picker
Actual color selected (example

is dithered)
Closest solid color available
Double click Solid to choose it
Change a single colors index

value, to change its luminance
in the mix
Solid double clicked
The picker positions and color

box reflect the change
Press to select color and add

it to the basic palette
3.
Hue=red, green and blue proportions based on their entered values

Saturation=Defines color vividnes (amount of gray)
Luminance=Amount of light in the color (0=Black)
Do one or more of the following until you have created the color you want. You can
see the exact color and the solid color that is closest to it in the Color|Solid box.
A. Move the Color picker around to change the color.
B. Enter exact Index values for any or all of the colors in the color fields.
0 for all colors = Black.
0 for one color = Black for that value
255 for all colors = White
255 for one color = Pure red, green or blue for that value
The color that displays reflects the combination of the three entries
C. Move the Luminosity picker up and down to change the amount of light
(absence of black) in the color.
D. Enter an exact value that specifies the amount of light in the color in the Lum
field.
0 = Black (The colors values will change to 0)
240 = White (The colors values will change to 255.
Any changes you make in this value will affect all the colors.
E. Specify how vivid the color specified by the balance of the three basic colors
should be in the Sat field.
0 = Gray
F.
GFK-1260F
240 = No gray.
Specify the balance of red, green and blue that you want in the Hue field. This
balance is calculated against the values that are already in the Color fields.
2-39
4.
Decide whether to use the exact color or the solid color displayed in the Color|Solid
box. possibilities are:
A. The exact color is the same as the solid color.
B. The exact color is dithered, a pattern of dots that simulates the color. Only the
solid portion of a dithered color will display in a pattern.
C. The solid color that is closest to exact color.
5.
Select the option you want.

A. Double click the Solid side of the Color|Solid box to add the solid color. The
box changes to the solid color.
B. Click Add Color when in the Color|Solid box if:
Both the exact and solid display. The exact color will be selected.
Only the solid color displays. The solid color will be selected.
Modifying a Color
You can modify any color on the palette. If you choose a standard color to modify, the
customized color appears in the customized section of the palette.
To modify a color:
1.
2.
Select a color in the customized color section.
3.
4.
The Color (custom color) Palette opens.
5.
Proceed as you would if you were creating a new color.

When you have edited the color, the new color appears in the custom color box that
the edited color used to occupy.
2-40
GFK-1260F
Choosing a Font
Whenever you have to specify a font and its characteristics in Trending, you can do so in a
basic Windows 95/NT Font dialog box.
To specify a font for a Trending text item:
1.
Choose one of the following:
Click the Font button
on the Axis tab.

in the Axis or Legend tab.
The Font dialog box opens.
GFK-1260F
2.
Select the font. If you use TrueType fonts, users can resize a screen in CimView and
still have the text be displayed in proportion to the rest of the objects on the screen.
3.
Select the font style and size.
2-41
Trend Methods
About Trend Methods

Because the trend chart is an object in CimEdit, you can specify events that trigger actions.
Trending offers you a list of methods to use for a particular action, Invoke method that can
be triggered by an event.
A method is a function that operates on a Trend control in CimView.
You can customize one or all of these methods, so that when theyre associated event occurs
they will change or enable/disable an aspect of the trend chart, as follows:
Invoke method
Item
Method
On the CimView Trend Chart, to:
Line
AddLoggedLine
Add a specified logged line
AddLoggedPointLine
Add a specified logged expression line
AddPointLine
Add a specified expression line
DeleteTrendLine
Delete a specified line
SetLineAutoupdate
Change the auto-update status of one or all nonruntime lines
SetLineDisplay
Set the color, compression and expansion of a

given line.
SetLineVisible
WriteReferenceFile
Toggle the line visibility in both the chart and

legend for one or all lines.
Write a reference file for specified lines.
SetLegendState
Make the legend visible/invisible
Legend
X-axis (Time Related)
GFK-1260F
JumpToCurrentTime
Set the chart time to the current time.
PauseUpdates
Pause or resume updates
ScrollLines
Scroll the chart by the given percentage
SetXDuration
SetXStartTime
Change the X-axis duration.

Change the Chart X-axis for one or all lines.
3-1
Y-axis
SetLineYAxis
Change the Y-axis settings.
SetYAxisVisible
SetLineUseChartY
Change the visibility of one or all Y axes

Toggle the use of the Chart Y-axis for a line.
Visual Aids
ResetZoom
SetGridState
Reset zoom in the Trend Control to 100%.

Change the grid visibility for the Trend Control.
Wait State
EnableOutstandingLoggedRequestStateEvents
Enables the firing of logged data wait state
events in the Trend control.
DisableOutstandingLoggedRequestStateEvents
Disables or turns off the firing of logged data
request wait state events in the Trend control.
Other
AboutBox
Display the Help About dialog box for the

CIMPLICITY Trend Control.
SetCimplicityProject
Set the CIMPLICITY project for the Trend

Control.
In addition to methods, Trending offers you a list of events you can select in CimView as
events of type ActiveX Event.
An event is a way for the Trend object to notify CimView that something has occurred.
You can use one or all of the following events to perform an action in CimView when they
occur:
Event
On the CimView Trend Chart, when:
EnteringOutstandingLoggedRequestState
The Trend control has determined that it has
logged data requests that have been outstanding
(waiting) for longer than the number of seconds
determined by the threshold.
LeavingOutstandingLoggedRequestState
The Trend control has determined that it no
longer has any logged data requests that are
outstanding.
3-2
GFK-1260F
Method Configuration
Naming A Trend Control
Before you can invoke a method for a Trend control, the control must have its Object name
defined.
To name a trend control:
1.
2.
3.
4.
5.
Select the Trend control.

From the Edit menu, select Object properties.
Select the General properties of the Object Properties window.
Enter a name for the Trend control in the Object name field.
Click OK to save your changes and close the Object Properties window.
You can now select the control when you create an Invoke Method action.
Creating an Invoke Method Action

You can create an Invoke method action for a trend object the same way you would for any
object or group that allows you to define procedures.
All methods require basic configuration.

Methods that contain arguments also require advanced configuration.
Basic Entries for Invoking a Method

The procedure to get to the Invoke method action is the same as any other action.
To create an Invoke Method action:
1.
2.
3.
4.
5.
6.
7.
8.

Select Properties from the popup menu. The Properties Object dialog box opens.
Select the Events tab.
Select the type of event that will trigger the action in the Events field.
Select New procedure.in the Action fields popup menu.
Click New in the Procedure Information dialog box.
Select Invoke method in the Action type field.
When you select the Invoke method action, the center of the Events tab changes to
look like this:
Example: Trending Method

Select the object to
which the method will
be assigned
Select the method to

implement
Check to require
confirmation at
runtime
GFK-1260F
Trend Methods
Press to open the

Edit Method
dialog box box
3-3
9.
Click Advanced if the button is enabled. This means the function returns a value
that contains output arguments.
The Edit Method dialog box opens.
10. Click OK when you have completed configuration to save the event.
Advanced Entries for Invoking a Method

If you select a function to invoke a method and the function returns a value that contains
arguments, you will have to do some easy, but advanced, configuration. In these instances, the
Advanced button on the Edit tab of the Properties dialog box will be enabled.
To enter information in the Edit Method dialog box:
1.
Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens.
Example: Entry in Edit Method Dialog Box for an Invoke Method Action
EnabledIf the method returns a status value:
Enter a setpoint that contains the status value

(optional). Use a device or global Point ID with
the correct Point Type
DisabledNot available
Displays help text for

the method, if available
Expresion
dialog box
Point ID
popup
Expresion
dialog box
Point ID
popup
Methods
parameters
Parameter
type
NoNot optionalAn
entry is required in
the Value column
YesOptional
Enter the value format specified in the Type

column
DisabledSetpoint not allowed
SelectedEnter a single writeable Point ID
in the Value field

ClearedEnter a Point ID or an expression
in the Value field
3-4
GFK-1260F
2.
Enter an expression in the Value column that will pass as the argument for each
argument in the Name column. Your options are:
A. You must make an entry for each parameter that has a No in the Optional box.
If the argument is optional, you will see Yes in the Optional box.
Choose one of the following to pass argument values to a method:
Type
Enter
Integer
An expression or Point ID that evaluates to a numeric

value.
String
Choose one or a combination of the following:

1.
Point ID that refers to a text point
2.
Constant string enclosed in double quotes
3.
If/Then/Else condition where:
If is A (from either 1 or 2 on the list)

Then is B (a text expression)
Else is C (a text expression)
A short hand If/Then/Else is A?B:C
3.
4.
5.
6.
B. If the argument can be used as an output argument, the Do Setpoint checkbox

will be enabled. To assign the output value of the argument to a CIMPLICITY
Point when the function exits, enter the Point ID in the expression field.
Currently the Do Setpoint checkbox is not enabled for any Trending methods.
(Optional if enabled) Enter a setpoint in the Method result field if the function
returns a value. You can use a device or global Point ID with the correct Point Type
for the status value.
Click OK to save your changes and return to the Actions tab.
Click OK to save the procedure information and return to the Events tab.
Click OK to save the event.
Note: Some argument types are not supported (for example, IDispatch*, and IUnknown*).
These will appear as <Bad type> in the Type column and the Expression field will be
disabled. If the unsupported argument is required, you will not be able to configure this
method for invocation.
If you plan to pass a parameter via the contents of a CIMPLICITY Point ID, the contents of
the Point ID will be converted to match that of the parameter.
The valid ranges for each type used by Trend methods are:
GFK-1260F
Type
Valid Range
BOOL
Boolean with a value or 0 or 1.
BSTR
Any string. Numbers will be converted to strings.
double
Floating point number in the range (2.2250738585072014e308 to 1.7976931348623158e+308)
long
Long integer in the range -2147483648 to 2147483647
short
Short integer in the range -32768 to 32767
Trend Methods
3-5
Line Display Methods

You can cause any kind of line to be added to a trend chart when the Invoke Method
action is triggered by an event, in addition to changing its display characteristics and
even making it visible or invisible.
The methods to do this are:
Invoke method
Method
AddLoggedLine
Add a specified logged line
AddLoggedPointLine
Add a specified logged expression line
AddPointLine
Add a specified expression line
DeleteTrendLine
Delete a specified line
SetLineAutoupdate
Change the auto-update status of one or all non-point

lines
SetLineDisplay
Set the color, compression and expansion of a given line.
SetLineVisible
Toggle the line visibility for one or all lines.
WriteReferenceFile
Write a reference file for specified lines.
AddLoggedLine Method
Purpose: To add a specified logged line to the runtime Trend Control when Invoke Method is
triggered by an event.
Lines using Logged data display data from a CIMPLICITY Database Logger group
table. This type of trend is also called a historical trend because all the information
comes from logged data.
To configure the AddLoggedLine method:
1.
Select AddLoggedLine Method for the Invoke method Action type.
The Edit Method dialog box opens displaying AddLoggedLine.
3-6
GFK-1260F
(Optional) A setpoint that contains the status

valuedevice or global Point IDBoolean point
Setpoint not allowed
A.
B.
Entry is required
3.
A. Identifies line, in legend

B. ODBC source details
Enter the following:

A. A string that provides a name for the Line ID. The name will appear in the
Legend to identify the added line.
B. Strings that Trending will evaluate to find the:
ODBC data source in which CIMPLICITY will find the table and column
for the line display. If you require a User ID and password enter them on
this line.
Including "DSN=" is optional. In either case, the UID= and PWD= must
appear after the DSN.
Example
Either of the following is correct:
CIMPLICITY Point Logging;UID=Administrator;PWD=98403
"DSN=CIMPLICITY Point Logging;UID=Administrator;PWD=98403
4.
Table in the Database Logger where the line data will be found.
Column in the Database Logger table that contains the lines data.
(Optional) Enter a Method result. Use a Point ID in the Boolean Point Class with a
Data Structure Type of BOOL. You can use a device or global Point ID.
When you invoke the method, the optional Method result contains one of the
following values.
Value
Method Result
The line was successfully added to the trend.
The line was not added to the trend.
Note: The source for a Logged line is always a column in a group log table. For more
information about group log tables, see Using the Database Logger in the CIMPLICITY HMI
for Windows NT and Windows 95 Base System Users Manual (GFK-1180).
GFK-1260F
Trend Methods
3-7
AddLoggedPointLine Method
Purpose: To add a specified logged expression line to the runtime Trend Control when Invoke
Method is triggered by an event.
Lines using logged and runtime data display a combination of run-time and logged
data. Runtime data is reported by CIMPLICITY Point Management. Logged data
comes from a CIMPLICITY Log table. The behavior of the logged point line type
depends on the Allow Runtime Scrolling property
To configure the AddLoggedPointLine method:
1.
Select AddLoggedPointLine Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying AddLoggedPointLine.

A.
B.
C.
Entry is required
3-8

B. Point to trend.
C. ODBC source details
GFK-1260F
3. Enter the following:

A. A string that provides a name for the Line ID. The name will appear in the
legend to identify the added line.
B. A string that evaluates to a Point ID. Trending creates the trend based on the
specified points values.
C. Strings that Trending will evaluate to find the:
ODBC data source in which CIMPLICITY will find the table and column
for the line display. If you require a User ID and password enter them on
this line.
Including "DSN=" is optional. In either case, the UID= and PWD= must
appear after the DSN.
Example
Either of the following is correct:
CIMPLICITY Point Logging;UID=Administrator;PWD=98403
"DSN=CIMPLICITY Point Logging;UID=Administrator;PWD=98403
4.
Table in the Database Logger where the line data will be found.
Column in the Database Logger table that contains the lines data.
following values.
Value
Method Result
Note: The source for a Logged line is always a column in a group log table. For more
information about group log tables, see "Using the Database Logger" in the "CIMPLICITY
HMI for Base System Users Manual" (GFK-1180).
GFK-1260F
Trend Methods
3-9
AddPointLine Method
Purpose: To add a specified expression line to the runtime Trend Control when Invoke Method is
Lines using runtime data display data reported by the CIMPLICITY Point Manger.
The line cannot be scrolled as all information comes from current data. This type of
line is also called a current trend.
To configure the AddPointLine method:
1.
Select AddPointLine Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying AddPointLine.

valuedevice or global Point ID Boolean point
A.
B.
Entry is required
A. Point to trend.
B. Identifies line, in legend

A. A string that provides a name for LineID. The name will appear in the legend to
identify the added line.
B. A string that evaluates to a Point ID. Trending creates the trend based on the
identified values.
3-10
GFK-1260F
4.
following values.
Value
Method Result
DeleteTrendLine Method
Purpose: To delete a specified point line from the runtime Trend Control when Invoke Method is
To configure the DeleteTrendLine method:
1.
Select DeleteTrendLine Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying DeleteTrendLine.

valuedevice or global Point IDAnalog point
Entry is required
3.
4.
GFK-1260F
Identifies line to delete
Enter a string that evaluates to an existing Line ID. Trending will delete the specified
line when the method is invoked.
(Optional) Enter a Method result. Use a Point ID in the Analog Point Class. You
can use a device or global Point ID.
Trend Methods
3-11
When you invoke the method, the Method result displays one of the following:
The number of lines deleted from the chart

A dialog box with an appropriate error message, if an existing line cannot be
deleted
Zero, if the line does not exist on the chart
SetLineAutoupdate Method
Purpose: To change the autoupdate status of one or all non-point lines on the Trend Control.
Important: This method has no effect on Point or Logged Point lines.

To configure the SetLineAutoupdate method:
1.
Select the SetLineAutoupdate Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetLineAutoupdate.
(Optional) A setpoint containing the status

valuedevice or global Analog point
A.
B.
Entry is required

B. 0 Update off
1 Update on
3-12
GFK-1260F
3.

A. One of the following to identify what line or lines should be automatically
updated.
Value
Identifies
All non-point lines on the chart
String for a Line ID The line to autoupdate

B. An expression or Point ID for nOffOnToggle that evaluates to the numeric
value:
Value
Trending will:
4.
Turn off selected line(s) autoupdate
Make selected line(s) start autoupdating
2
Toggle the current state of the line(s)
When you invoke the method, the Method result display contains the count of the
number of lines that were changed.
SetLineDisplay Method
Purpose: To set the color, compression and expansion, and display method for a particular Line ID.
To configure the SetLineDisplay method:
GFK-1260F
1.
Select SetLineDisplay Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetLineDisplay.
Trend Methods
3-13

valuedevice or global Boolean point
Setpoint not
allowed
A.
B.
C.
D.
Entry is required
B. RGB Color Values

D. 0Step mode
C. 0None
1Smooth mode
1Average
2First point
3Last point
4Minimum point
5Maximum point

A. A string that identifies the Line ID whose display parameters you want to
change.
B. An RGBColor value from either the Standard RGBColor Values Table or
calculate your own. See RGBColor Values and Standard RGBColor Table
in this chapter.
C. An expression or Point ID for NoneAvgFirstLastMinMax that evaluates to one
of the following numeric values:
Value
Trending will:
0
Not do any compression
Plot the average of the values in the group
Plot the first data point in the group
Plot the last data point in the group
Plot the data point from the group with the smallest value
Plot the data point from the group with the largest value
If you are using compression, Trending automatically determines the group size.
D. An expression or Point ID for StepSmooth that evaluates to one of the
following numeric values:
Value
Trending will:
0
4.
3-14
Display the line in step mode
1
Display the line in smooth mode
following values:
GFK-1260F
Value
Method Result
The change was successfully made.
The change was not made.
RGB Color Values

You can change a line to one of as many colors as your video is set to display by entering an
RGBColor value on the RGBColor row. You find the value for your entry by:
Using an easy RGBColor value formula

Consulting the Standard RGBColor Value Table (in this section).
Each RGB color is:
Made up of a balance of red, green and blue luminosity values ranging from 0 to
255.
Example
If you apply a luminosity value of:
0 to each of the basic RGB colors (red, green and blue), the color that you
see will be Black.
255 to each of the basic RGB colors, the displayed color that you see will
be White.
Single Color
Value
Red
Green Blue
Displayed
Color
0
Black
Black
Black
Black
255
Red
Green Blue
White
Has a calculated value with the following formula:
RGBColor Value =
255 (To represent Red; The selected number can be 0-255) +
(256 * a Green luminosity number) +
(65536 * a Blue luminosity number) +
Example
RGBColor =
255 +
(256*105) +
(65536*255) = 16738815 (the RGBColor value)
You can use the Custom Colors palette in CimEdit to determine the Red, Green,
and Blue values for the color you want to use.
GFK-1260F
Trend Methods
3-15
Example: Customized Color Palette Providing Luminosity for RGB Calculation
(255) +
(105 * 256) +
(255 * 65536) = 16738815
Legend in runtime trend
Standard RGB Color Value Table
3-16
White
16777215
Black
Gray
8421504
Silver
12632256
Red
255
Yellow
65535
Lime
65280
Aqua
16776960
Blue
16711680
Fuchsia
16711935
Maroon
128
Green
32768
Olive
32896
Navy
8388608
Purple
8388736
Teal
8421376
GFK-1260F
SetLineVisible Method
Purpose: To change one or all lines on the Trend Control visible or invisible.
To configure the SetLineVisible method:
1.
Select SetLineVisible Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetLineVisible.

A.
B.
A. Identifies line for
Entry is required
visibility on/off
B. 0Line off
1Line on

A. One of the following for LineID to identify the line or lines you want to become
invisible or visible:
Value
Identifies
All the lines
An existing Line ID A single line

B. An expression for nOffOnToggle that evaluates to one of the following
numeric values.
Value
Trending will:
0
4.
GFK-1260F
Make selected line(s) invisible
1
Make selected line(s) visible
Optional) Enter a Method result. Use a Point ID in the Boolean Point Class with a
Trend Methods
3-17
following values:
Value
Method Result
The line is visible.
The line is invisible.
Note: When the line is made invisible, it is removed from the chart. If you did not check the
Always visible legend option, the line description is also removed from the legend.
Even thought the line is removed from the display, the Trend Control still collects data and
performs calculations for the line.
WriteReferenceFile Method
Purpose: To write data for all lines on the chart to the reference file you designate.
Important: This method is available only on Intel Windows 95 and Intel Windows NT
platforms.
To configure the WriteReferenceFile method:
3-18
1.
Select WriteReferenceFile Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying WriteReferenceFile.
GFK-1260F

valuedevice or globalAnalog point
A.
B.
C.
D.
Entry is required
A. LInes included in file

B. Evaluate to 0
C. File location details

A. A null terminated string to identify what Lines values Trending should include
in the Reference file when the method is invoked.
Value
Identifies
All the lines on the chart
Comma separated list of line Ids

Specific lines to export
4.
GFK-1260F
B. The number of lines specified in A.

C. Identify the file and location:
The Path where the reference file will be located. It is recommended that
you put the reference file in its own directory.
A name for the reference File.
When you invoke the method, the Method result displays 0.
Trend Methods
3-19
Methods for the Legend

You can give a Trend user the ability to make the Legend visible or invisible with
the SetLegendState method.
SetLegendState Method
Purpose: To change the visibility of the legend for the trend.
To configure the SetLegendState method:
1.
Select SetLegendState Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetLegendState.

Entry is required
3.
3-20
0 Legend off
1 Legend on
Enter an expression or Point ID for nOffOnToggle that evaluates to one of the

following numeric values.
Value Trending will:
0
Hide the legend
Show the legend
Toggle the visibility of the legend
GFK-1260F
4.
(Optional) Enter a Method result. Use a Point ID in the Boolean Point Class. You
When you invoke the method, the Method result displays:
Value
Method Result
Legend is visible
Legend is invisible
X-axis (Time Related) Methods

Trending offers you several methods to change how a runtime trend chart deals with
time. The methods are
Invoke Method
Method
JumpToCurrentTime

Set the chart time to the current time.
PauseUpdates
Pause or resume updates
ScrollLines
Scroll the chart by the given percentage
SetXDuration
Change the X-axis duration.
SetXStartTime
Change the Chart X-axis for one or all lines.
JumpToCurrentTime Method
Purpose: To move the axis of a specified line, and associated lines, so that the current time is within
the visible time span on the trend. This lets you see the latest incoming values if the line has
run-time information.
To configure the JumpToCurrentTime method:
GFK-1260F
1.
Select the JumpToCurrentTime Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying JumpToCurrentTime.
Trend Methods
3-21
(Optional) A setpoint that contains the

status valuedevice or global Point ID
Analog point
Entry is required
3.
Enter one of the following for LineID to name what lines should jump to the current
time.
Entry
Identifies
4.
3-22
Identifies line, in legend
All X-axes with runtime and/or auto updating lines
Existing Line ID
The X-axis associated with the line
(Optional) Enter a Method result. Use a Point ID in the Analog Point Class with a
When you invoke the method, the Method result contains the number of lines that
jumped to the current time.
GFK-1260F
PauseUpdates Method
To pause or resume updates in the trend.
To configure the PauseUpdates method:
1.
Select PauseUpdates Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying PauseUpdates.

valuedevice or global Point ID Boolean
point
Entry is required
3.
4.
0 resume trending
1 pause the trend
2 toggle the current pause
state
Enter a Point ID or expression for nNoYesTog that evaluates to one of the

Value
Trending will:
0
Resume the trend.
Pause the trend.
2
Toggle the current pause state of the trend.
When you invoke the method, the Method result contains 0.
While the trend is paused, "PAUSED" displays in the upper left corner of the chart.
GFK-1260F
Trend Methods
3-23
ScrollLines Method
Purpose: To scroll all lines that can be scrolled on the chart by the indicated percentage.
To configure the ScrollLines method:
1.
Select ScrollLines Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying ScrollLines.

A.
B.
A. 0 scroll left
Entry is required
1 scroll right
B. Percent scroll
between 0 and100

A. An expression or Point ID for NLeftRight that evaluates to one of the following
numeric values:
Value
Trending will:
0
1
Scroll left
Scroll right
B. An expression or Point ID for nPercent that evaluates to a percentage value

between 0 and 100.
3-24
GFK-1260F
4.
following values:
Value
Method Result
Parameters are good and scroll performed.
Parameters are bad.
SetXDuration Method
Purpose: To change the X-axis duration settings for a single line or all lines on the chart that use the
chart X-axis and scrolls lines to beginning of chart.
To configure the SetXDuration method:
1.
Select SetXDuration Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetXDuration.

A.
B.
A. Identifies line for x-axis
Entry is required
GFK-1260F
Trend Methods
duration change
B. (Seconds x Time) and
additional milleseconds
3-25

A. Enter one of the following for Line ID to name what lines should have the
duration of the X-axis changed:
Entry
Identifies
The Chart X Axis
An existing Line ID The axis that belongs to the line

B. Enter the duration of the X-axis for:
i. Seconds.
4.
Multiply minutes by 60; hours by 3600

ii. Milliseconds in addition to seconds, for the X duration.
following values.
Value
Method Result
The X-axis duration was successfully changed.
The X-axis duration was not changed.
SetXStartTime Method
Pupose: To specify a start time of the X-axis for the chart or indicated line and redraw the trend.
To configure the SetXStartTime method:
3-26
1.
Select SetXStartTime Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetXStartTime.
GFK-1260F

A.
B.
C.
A. Identifies line for x-axis
duration change
Entry is required
B. mm/dd/yy hh:mm:ss AM/PM

C. To the millesecond

A. Enter one of the following for Line ID to name what lines should have the
duration of the Y-axis changed:
Entry
Identifies
The Chart X Axis

B. The following format for the DateTime string.
"<day> <month> <year> <hh>:<mm>[:<ss>] <pp>"
For
Enter the:
<day>
Number of the day of the month
<month>
Three-character abbreviation for the month
<year>
Two digits for the year
<hh>
Hour of the 12-hour clock
<mm>
Two digits for the minutes
<ss>
<pp>
(Optional) Two digits for the seconds

Either AM or PM.
Example:
"02 Feb 1997 07:00 AM"
"15 Mar 1997 3:45:15 PM"
4.
GFK-1260F
C. Enter a number from 0 through 999 for nMilliseconds.

following values:
Value
Method Result
The X-axis start time was successfully changed.
The X-axis start time was not changed.
Trend Methods
3-27
Y-axis Methods
Trending provides you with the following methods to let a Trend user change the yaxis during runtime:
Invoke method
Method
SetLineYAxis
Change the Y-axis settings.
SetYAxisVisible
Change the visibility of one or all Y axes
SetLineUseChartY
Toggle the use of the Chart Y-axis for a line.
SetLineYAxis Method
Purpose: To change the Y-axis settings for a single line or all lines that use the chart Y-axis.
To configure the SetLineYAxis method:
3-28
1.
Select SetLineYAxis Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetLineYAxis.
GFK-1260F

A.
B.
C.
D.
A. Identifies line for
y-axis change
Entry is required
B. Y-axis Lower ,
Upper Limit s
C. 0Invisible
1Visible
D. 0Disable autoscaling
1Enable autoscaling

A. One of the following for LineID to identify for what lines Trending should
change the Y-axis parameters
Value
Identifies
The Chart Y Axis

B. A minimum Y-axis value for Lower and maximum value for Upper.
C. An expression or Point ID for Visible that evaluates to one of the following
numeric values.
Value
Trending will:
0
1
Make the Y-axis invisible

Make the Y-axis visible
D. An expression or Point ID for Autoscale that evaluates to one of the following

numeric values.
Value
Trending will:
0
1
GFK-1260F
Trend Methods
Not Autoscale
Perform Autoscaling
3-29
4.
following values:
Value
Method Result
The Y-axis has been set.
The Y-axis was not set.
SetYAxisVisible Method
Purpose: To change the visibility of one or all Y-axes on the Trend Control.
To configure the SetYAxisVisible method:
1.
Select SetYAxisVisible Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetYAxisVisible.

A.
B.
Entry is required
3-30
A. Identifies line whose

y-axis visibility is
on/off
B. 0Y-axis off
1Y-axis on
GFK-1260F

A. One of the following for LineID to identify for what lines Trending should
make the y-axis invisible or visible.
Value
Identifies
The Chart Y Axis

B. An expression or Point ID for nOffOnToggle that evaluates to one of the
following numeric values.
Value
Trending will:
4.
Make the selected axis invisible
1
2
Make the selected axis visible

Toggle the current state of the axis
following values:
Value
Method Result
The Y-axis has been made visible.
The Y-axis has been made invisible.
Note: Make sure your trend has Y-axis display type of Multiple if you want more than one
Y-axis visible at the same time.
SetLineUseChartY Method
Purpose: To change the lines Y-axis to either the Chart Y Axis or an axis whose ID is the lines ID
plus a _Y suffix.
To configure the SetLineUseChartY method:
GFK-1260F
1.
Select SetLineUseChartY Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetLineUseChartY.
Trend Methods
3-31

A.
B.
A. Identifies line whose Chart
Entry is required
3.
y-axis visibility is used/not

used
B. 0Chart-Y axis not used
1Chart-Y axis used

A. A string that evaluates to an existing Line ID.
B. Enter an expression or Point ID for UseChartYAxis that evaluates to one of the
Value
Trending will:
0
4.
Not use the Chart Y-axis
1
Use the Chart Y-axis
following values:
Option 1 If the line was using the Chart Y Axis and UseChartYAxis is 0, when
the method is invoked, Trending disables and Chart Y-axis and maintains the
current settings.
Option 2 If the line was not using the Chart Y Axis and UseChartYAxis is 1,
then when the method is invoked the Chart Y Axis is enabled and the current
chart axis settings are used.
Value
Method Result
3-32
The method executed successfully.
The method failed.
GFK-1260F
Visual Aid Methods

Trending provides you with the following methods to let a Trend user use visuals aids when
looking at the chart.
Invoke method
Method
ResetZoom
Reset zoom in the Trend Control to 100%.
SetGridState
Change the grid visibility for the Trend Control.
ResetZoom Method
Purpose: To reset the zoom on a trend to 100%.
To configure the ResetZoom method:
Select ResetZoom Method for the Invoke method Action type.
Check to require
confirmation at
runtime
Edit Method dialog box

not required
Advanced configuration is not required.
SetGridState Method
Purpose: To change the grid visibility for the Trend Control.
To configure the SetGridState method:
GFK-1260F
1.
Select SetGridState Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetGridState.
Trend Methods
3-33

Entry is required
3.
4.
3-34
0 Grid off
1 Grid on
Enter an expression or Point ID that evaluates to one of the following numeric

values:
Value
Trending will:
0
Hide the grid
1
2
Show the grid

Toggle the current state of the grid
(Optional) Enter a Method result. Use a Point ID in the Boolean Point Class with
a Data Structure Type of BOOL. You can use a device or global Point ID.
following values:
Value
Method Result
Grid is visible
Grid is not visible
GFK-1260F
Wait State Methods and Events

Trend has an option to fire events that allow you to know if the Trend control is
waiting for logged data from the database. One of the events is fired when the Trend
enters a state where the Trend is waiting for logged data that is taking longer than a
configurable threshold (in seconds). Once the data is received, another event is fired
to let the screen know that the Trend has left the waiting state.
These events are particularly useful when retrieving data that takes a long time to
retrieve so that the CimView screen can either disable buttons or have a flashing
light that lets the user know that the Trend is working on getting the data.
The following methods allow you to enable or disable the wait state events:
Invoke method
Method
EnableOutstandingLoggedRequestStateEvents
Enables the firing of logged data wait state events in the
Trend control.
DisableOutstandingLoggedRequestStateEvents
Disables or turns off the firing of logged data request wait
state events in the Trend control.
EnableOutstandingLoggedRequestStateEvent Method
Purpose: To enable the firing of logged data wait state events in the Trend control.
To configure the EnableOutstandingLoggedRequestStateEvent method:
GFK-1260F
1.
Select EnableOutstandingLoggedRequestStateEvent Method for the Invoke method

Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying
EnableOustandingLoggedRequestStateEvent.
Trend Methods
3-35
A.
B.
A. Seconds Trend checks logged
Entry is required
3.
requests outstanding for longer

than the threshold
B. Seconds that request is
outstanding

A. An expression or Point ID for the RefreshRate that evaluates to a numeric
value. This value is the interval, in seconds, at which the Trend control checks if
it has any logged requests that have been outstanding for more than the
Threshold.
B. An expression or Point ID for the Threshold that evaluates to a numeric value.
This value is the wait time, in seconds, at which a request is considered
outstanding.
DisableOutstandingLoggedRequestStateEvent Method
Purpose: To disable the firing of logged data wait state events in the Trend control.
To configure the DisableOutstandingLoggedRequestStateEvent method:
1.
Select DisableOutstandingLoggedRequestStateEvent Method for the Invoke method

Action type.
3-36
GFK-1260F
EnteringOutstandingLoggedRequestState Event
Purpose: Fired when the Trend control has determined that it has logged data requests that have been
outstanding (waiting) for longer than the number of seconds determined by the threshold.
To configure the EnteringOutstandingLoggedRequestState event:
1.
Create an ActiveX Event and select the EnteringOutstandingLoggedRequestState

Event.
EnteringOutstandingLoggedRequestState
Events drop
down list
Procedure
associated
with selected
event
New / edit
procedure
popup
2.
GFK-1260F
Create an Action for the event. This action can be either a script or a procedure in
CimView.
Trend Methods
3-37
LeavingOutstandingLoggedRequestState Event
Purpose: Fired when the Trend control has determined that it no longer has any logged data requests
that are outstanding.
To configure the LeavingOutstandingLoggedRequestState event:
1.
Create an ActiveX Event and select the LeavingOutstandingLoggedRequestState

Event.
LeavingOutstandingLoggedRequestState
Events drop
down list
Procedure
associated
with selected
event
2.
3-38
New / edit
procedure
popup
Create an Action for the event. This action can be either a script or a procedure in
CimView.
GFK-1260F
Other Methods
Trending also provides you with methods to:
Invoke method
Method
AboutBox
Display the Help About dialog box for the CIMPLICITY

Trend Control.
SetCimplicityProject
Set the CIMPLICITY project for the Trend Control.
AboutBox Method
Purpose: To display the Help About dialog box for the CIMPLICITY Trend control.
To configure the AboutBox method:
Select AboutBox Method for the Invoke method Action type.
Check to require
confirmation at
runtime
Edit Method dialog box

not required
SetCimplicityProject Method
Purpose: To set the CIMPLICITY project that will be used by the Trend Control when it displays
data.
To configure the SetCimplicityProject method:
GFK-1260F
1.
Select SetCimplicityProject Method for the Invoke method Action type.
2.
Click Advanced.
The Edit Method dialog box opens displaying SetCimplicityProject.
Trend Methods
3-39
Entry is required
3.
Project name
Enter a string that names the project CIMPLICITY should use for the Trend Control.
Note: When you invoke this method, the selected project will be used for all point lines
where the Point ID is not fully qualified.
3-40
GFK-1260F
About Quick Trends

CIMPLICITY HMI provides you with the ability to instantly review a selected points trend
through the Workbench.
You do this by starting a trend chart for a selected point by selecting Quick Trend on the
point's popup menu. When the trend chart opens the chart begins to trend the point's values.
You can manipulate the chart by:
Using the same CIMPLICTY Trend Control Properties dialog box as you use in
CimEdit.
Creating quick changes to the display by using Quick Trends several popup menus.
Adding more trend lines for other data sources
You can even save your configured chart for future reference.
Starting Quick Trends

While you are working in the Workbench, you can start a quick trend for any point.
To start a Quick Trend:
1.
2.
3.
4.
GFK-1260F
Make sure your project is running.

Select a point in the Workbench.
Select Quick Trends from the popup menu.
4-1
Workbench Popup for Quick Trend
A Quick Trend chart opens.
4-2
GFK-1260F
Configuring a Quick Trend Chart

Quick Trends offers you the same CIMPLICITY Trend Control Properties dialog box that you
use in CimEdit.
To open the CIMPLICITY Trend Control Properties dialog box in Quick Trends:
1.
2.
3.
4.
5.
Select Edit on the Quick Trends menu bar.

Select Properties.
The CIMPLICITY Trend Control Properties dialog box opens.
Configure the chart the same as you would through CimEdit.
(Optional) Save the file, as follows:
A. Select File on the trend charts menu bar.
B. Select Save. The Save File dialog box open.
C. Select its directory.
D. Name the trend.
Example: Quick Trend After Several Configuration Changes
Added lines
Changes include:
Chart color
Line:
w Color
w Style
w Width
Axes font size
Background color
Legend:
w Font
w Display
Status display
Note: The most recent four trends that are saved, appear on the File drop down menu
GFK-1260F
4-3
Using Popup Menus to Make Quick Changes

Popup menus that are available in CimEdit and CimView are also available in Quick Trends.
To open a popup menu on the Quick Trend chart:
1.
2.
Place the cursor over the area you want to modify, including:
Chart
Legend
Status bar
X-axis
Y-axis
A popup menu, with items that relate to the area you selected, appears.
See the "Configuring a Trend Chart" in this manual for more information about the popup
menus.
4-4
GFK-1260F
About XY Plots
XY Plots provide you with the ability to visually represent values in relation to each other.
For example, you can plot real data vs. calculated date, or elements such pressure vs.
temperature.
XY Plots provides you with:
An extensive XY Plot object model with which you can script XY Plots that are as
easy or as complex as you need.
A CIMPLICITY XY Control Properties dialog box to make detailed chart design

selections.
A SmartObject XY Control with which you can quickly create an effecty XY Plot.
You have considerable control over what an XY Plot displays and its appearance using any of
the tools that XY Plot provides.
You can create an XY Plot that displays:
One or several XY series
One or more X,Y axes
Minimum detail so a user can view quickly view the pattern of relative values
All the details a user needs to fully analyze any of the XY series
Allow a runtime user, for the one runtime session, specify what should display.
For display, you can choose the colors, line types and fonts that you think will work best.
GFK-1260F
5-1
XY Chart Configuration Options Example

Display yaxis ticks /
numbersOptional
Choose chart
color
Display titles
Choose chart
background color
Show/hide lines
Choose
Step, scatter
or
smooth curve
Choose line
style / color
Display x-axis ticks
/ numbersOptional
Display scroll
buttonsOptional
Slider
Color
of
Series
Sliders
Display Slider
legend and
specific details
Optional
Display Series
Specify font and style
legend and
specific details Display sparse detail
Optional
Overview of Available Features for XY Plots

You can choose to display or hide:
Display feature
Choose to Display or Hide
Ticks and numbers
For the Y-axis

For the X-axis
Grid
Gridlines
Lines
Each line
Legends
Entire legend
Legend features
Axes
5-2
Series legend
Slider legend
Specific features:
Title
Series value at the slider
Series value at an index
Sliders value
One or more X or Y-axes
GFK-1260F
You can also specify how the charts many display features will appear.
Display feature
Other Configuration Options
Colors
Change for several chart elements
Series
Display the associated point or expression data
Axes
Add or remove
Sliders
Add or remove
Fonts
Change the style and size
You configure this powerful feature in CimEdit and display it in CimView. The XY Plot is an
ActiveX control that you can configure as follows.
1.
Insert the control into a CimEdit screen.

XY provides an XY toolbar button that you simply click.
2.
Configure the chart's design.

A CIMPLICITY Plot Control dialog box provides a long list of design choices.
3.
Specify runtime data criteria.

XY comes with XY properties and methods that you can use in scripts to manipulate
runtime. You can also design the chart by using scripts in addition to, or instead of,
the CIMPLICITY Plot Control dialog box.
If you want to begin with a chart that is pre-configured, you can take advantage of the XY
SmartObject. The SmartObject provides you with
GFK-1260F
5-3
About XY Plot Design

XY Charts that you configure in CimEdit are viewed during runtime in CimView. Because
the XY Plot control is a CIMPLICITY HMI ActiveX control, you can place it on any CimEdit
screen by simply clicking the XY Plot button on the CimEdit toolbar.
You can specify the design criteria for the XY Plot using either or both of the following XY
tools:
CIMPLICITY XY Control Properties dialog box to make design selections, for

example, chart color, line width
XY properties and methods in scripts See the "Plotting XY Data" chapter in this
manual or more information
You will discover that two types of attributes are common to several of the chart parts. You
can use the same methods to configure them in all instances. They are.
Colors
Fonts
Chart design includes specifying the attributes for the:
GFK-1260F
Plot foreground, background and chart colors
Axes
Series
Sliders
Grid
Legend
Title
6-1
Inserting an XY Plot Control

To insert the XY Plot control on a CimEdit screen:
1.
Click the OLE button on the Tools toolbar.
2.
Place the ActiveX Placement cursor where you want the top left corner of the control
to be located. You can move the control any time you want.
3.
Click the left mouse button.

The Insert Object dialog box opens.
4.
Select the ActiveX tab.
5.
Select CIMPLICITY XY Plot control.
6.
Click OK. A new XY Plot control is placed at the position you selected in your
CimEdit screen.
CIMPLICITY XY Plot
Control
6-2
GFK-1260F
The XY Plot control looks like this initially:
Resizing a New XY Plot Control

You can resize an XY Plot control chart quickly and /or precisely.
To resize an XY plot control:
Method 1Quick
1.
Grab one of the objects handles and move it.
Increase width
Increase in proportion
Increase height
Method 2Precision
1.
2.
Select Properties.
Method 3-Precision
Click the Properties button on the Format toolbar.
GFK-1260F
6-3
Method 4Precision
1.
2.
Select Properties from the drop-down menu.

The Properties Object dialog box displays when you use Methods 2-4.
Continue (after choosing from Methods 2-4)

1.
Select the Geometry tab.
2.
Enter the width and / or height for the XY Plot in the Width field and Height field.
Opening the CIMPLICITY XY Plot Properties Dialog Box

To open the CIMPLICITY XY Plot Control Properties dialog box:
Method 1
1.
Select the XY Plot control.
2.
3.
Select CIMPLICITY XY Plot control Object.
4.
Method 2
6-4
1.
Select the XY control.
2.
3.
Select CIMPLICITY XY Plot Control Object from the drop-down menu.
4.
GFK-1260F
The XY Plot Properties dialog box opens when you use any method.
Color and Font Choices for an XY Plot Control

You can specify color or font characteristics in several parts of an XY Chart. The methods
you use to accomplish each are the same in all instances.
Selecting a Basic Color

When you are asked to specify a color, you can select one from XYs easy to use color
palettes.
To select a basic color:
1.
Click the drop-down list button that is to the right of a Color input field.
Basic Palette
Palette tab
Special tab
Click one to select a baic

color
Double click a blank box

to create a custom color
Right click an existing
customized color to edit it.
2.
GFK-1260F
Double click the color of your choice on the Palette tab.
6-5
Creating a Custom Color

CIMPLICITY HMI lets you create as many custom colors as you want; 16 custom colors at
any one time.
To create a custom color:
1.
2.
Double click an empty box at the bottom of the Palette tab.

The Color (custom color) palette opens.
Color Palette: To create Customized Color
Color picker
Luminosity picker
Actual color selected (example

is dithered)
Closest solid color available
Double click Solid to choose it
Change a single colors index

value, to change its luminance
in the mix
Solid double clicked
The picker positions and color

box reflect the change
Press to select color and add

it to the basic palette
3.
Hue=red, green and blue proportions based on their entered values

Saturation=Defines color vividnes (amount of gray)
Luminance=Amount of light in the color (0=Black)
Do one or more of the following until you have created the color you want. You can
see the exact color and the solid color that is closest to it in the Color|Solid box.
A. Move the Color picker around to change the color.
B. Enter exact Index values for any or all of the colors in the color fields.
0 for all colors = Black.
0 for one color = Black for that value
255 for all colors = White
255 for one color = Pure red, green or blue for that value
The color that displays reflects the combination of the three entries
C. Move the Luminosity picker up and down to change the amount of light
(absence of black) in the color.
6-6
GFK-1260F
D. Enter an exact value that specifies the amount of light in the color in the Lum
field.
0 = Black (The colors values will change to 0)
240 = White (The colors values will change to 255.
Any changes you make in this value will affect all the colors.
E. Specify how vivid the color specified by the balance of the three basic colors
should be in the Sat field.
0 = Gray
240 = No gray.
F. Specify the balance of red, green and blue that you want in the Hue field. This
balance is calculated against the values that are already in the Color fields.
4.
Decide whether to use the exact color or the solid color displayed in the Color|Solid
box. possibilities are:
A. The exact color is the same as the solid color.
B. The exact color is dithered, a pattern of dots that simulates the color. Only the
solid portion of a dithered color will display in a pattern.
C. The solid color that is closest to exact color.
5.
Select the option you want.

A. Double click the Solid side of the Color|Solid box to add the solid color. The
box changes to the solid color.
B. Click Add Color when in the Color|Solid box if:
Both the exact and solid display. The exact color will be selected.
Only the solid color displays. The solid color will be selected.
Modifying a Color
You can modify any color on the palette. If you choose a standard color to modify, the
customized color appears in the customized section of the palette.
To modify a color:
1.
2.
Select a color in the customized color section.
3.
4.
The Color (custom color) palette opens.
5.
Proceed as you would if you were creating a new color.

When you have edited the color, the new color appears in the custom color box that
the edited color used to occupy.
GFK-1260F
6-7
Choosing a Font
Whenever you have to specify a font and its characteristics in XY, you can do so in a basic
Windows 95/NT Font dialog box.
To specify a font for an XY Plot text item:
1.
on any Font line.
The Font dialog box opens.
2.
Select the Font. If you use TrueType fonts, users can resize a screen in CimView and
still have the text display in proportion to the rest of the objects on the screen.
3.
Select the fonts:
4.
Style
Size
Script
Check the Strikeout and/or Underline check boxes to display the font with those
effects.
Note: The font color is the foreground color. The color in the Font dialog box, therefore does
not apply to the XY Plot fonts.
6-8
GFK-1260F
XY Plot Foreground, Background and Chart Colors

For an XY Plot background, chart and foreground colors, you can:
Specify the colors individually
Use the ambient colors specified for the CimEdit screen on which you are
configuring the XY Plot.
Colors Selected for an XY Chart Background and Foreground
Click the Palette button on

each row to select a color
Background
Foreground
Chart
To specify an XY Plot control background, chart and foreground colors:

1.
Open the CIMPLICITY XY Plot control Properties dialog box.
2.
Click the Palette button
on any or all of the following rows.
BackgroundColor
ChartColor
ForegroundColor
The CIMPLICITY HMI palette opens.
3.
Select the color you want.
The XY Plot control provides properties that enable you to use CimEdit ambient colors as the
XY Plot background, chart and foreground colors. The default, for these properties, is True.
When you specify a color XY automatically changes using the ambient to False.
GFK-1260F
6-9
Ambient Colors Selected for an XY Chart Background and Foreground
Automatically changes to False

when a color other than the ambient
is specified. Resetting to True
restores the ambient.
To use the CimEdit ambient colors for the XY Plot background, chart and
foreground colors:
1.
Open the CIMPLICITY XY Plot Control Properties dialog box.
2.
Specify the value as True for any of the following properties. (The default is True.)
UseAmbientBackgroundColor
UseAmbientChartColor
UseAmbientForegroundColor
6-10
GFK-1260F
XY Plot Axes Properties

XY Plots provides you with several options for configuring one or more X-axes and Y-axes.
Finding the Axes Properties

To find the axes properties in the XY Plot Control Properties dialog box:
1.
Open the XY Plot Control Properties dialog box.
2.
Scroll down to either the letter X or Y.
CIMPLICITY XY Plot Control Properties Dialog Box: X or Y-axes
Designing XY Plot Axes

Following are eight quick steps to customize every property on an X or Y-axis::
Step 1: Expand the tree under X or Y. (You can collapse whatever you expand.)
Step 2: Expand a selected axis.
Step 3: Choose the location of and data flow direction along the axis.
Step 4: Define the data format type.
Step 5: Design the axis line (pen).
Step 6: Configure the ticks.
Step 7: Configure the limits, mode and scroll properties.
Step 8: (Optional) Add additional axes.
Step 9: Configure properties to prioritize the axis and identify it.
Step 10: (Optional) Remove axes.
GFK-1260F
6-11
Step 1: Expand the tree under X or Y:

1.
Do one of the following to expand the tree under X or Y:

Method 1
Click the
Method 2
to the left of either the X or Y.
A. Click the right mouse button.

B. Select Expand on the popup menu
.
Method 3
Double click X or Y.
When you use any method, the tree expands to display:
Count (Read only)
2.
The number of X or Y-axes that have been

configured for the chart.
Item
The properties appear in a tree under Item.
Use any of the methods you used for X or Y to expand Item. (Choose Expand from
the popup menu list, if you choose that method.)
Note: Follow any of the three methods when the tree is expanded to collapse the tree. Select
Collapse from the popup menu.
Step 2: Expand a selected X or Y-axis:

1.
Select a number, e.g. 0, under the X or Y-axis Item.
2.
Use any of the three methods described in Step 1 to expand the axis tree and to
expand properties in the tree that have a
to their left. (Choose Expand from the
popup menu list, if you choose that method.)
Step 3: Choose the location of and data flow direction along an X or Y-axis:
1.
6-12
Select Orientation under XItem or YItem to specify the location of the axis on an
XY Plot.
Orientation
Orients the axis on a chart toward the:
apOrientationBottom
Lower part. (X-axis only)
apOrientationLeft
Left side. (Y-axis only)
apOrientationRight
Right side. (Y-axis only)
apOrientationTop
Upper side. (X-axis only)
GFK-1260F
2.
Select the Direction in which data will flow.

Direction
Specifies the flow or direction to be:
apDirectionForward
Standard (Upward for a Y-axis, rightward for an Xaxis)
apDirectionBackward
Alternate (Downward for a Y-axis, leftward for an Xaxis)
Step 4: Define the data format type for an X or Y-axis:

1.
Choose the Type of format in which the data will be reported.

Type
Does the following:
apNumberInteger
Displays a number as an integer. If the actual number

is fractional, it will be rounded.
apNumberFixed
Displays a fixed real number with a specified number

of decimal places.
apNumberScientific
Displays a number in scientific notation with a

specified number of decimal places. The default is 6
if precision is not specified.
apNumberCompact
Defines an automatic way to use either

apNumberFixed or apNumberScientific formats
based on the size of the value. Precision information
indicates the exponent to start displaying in scientific
format.
apNumberAbsoluteTime
Interprets a number as the number of seconds since

00:00 GMT on January 1, 1970.
apNumberRelativeTime
Interprets a number as an elapsed time value in

seconds.
apNumberCustom
2.
Uses a format string in the standard C language

format notation to display a number.
Make additional entries, when they apply, to more precisely define the selected
Type.
A. For apNumberAbsoluteTime, select the item, Absolute Time. Specify the time
format string. Choose your specific entries from the following list. The letters
must be in uppercase or lowercase as shown (for example, ss, not SS).
Characters in the format string that are enclosed in single quotation marks will
appear in the same location and unchanged in the output string.
GFK-1260F
Entry
Displays
Day of month as digits with no leading zero for

single-digit days.
dd
Day of month as digits with leading zero for

single-digit days.
ddd
Day of week as a three-letter abbreviation.
dddd
Day of week as its full name.
Month as digits with no leading zero for singledigit months.
MM
Month as digits with leading zero for single-digit

months.
MMM
Month as a three-letter abbreviation.
6-13
MMMM
Month as its full name.
Year as last two digits, but with no leading zero

for years less than 10.
yy
Year as last two digits, but with leading zero for

years less than 10.
yyyy
Year represented by full four digits.
Hours with no leading zero for single-digit hours

(12-hour clock).
hh
Hours with leading zero for single-digit hours

(12-hour clock).
Hours with no leading zero for single-digit hours

(24-hour clock).
HH
Hours with leading zero for single-digit hours

(24-hour clock).
Minutes with no leading zero for single-digit

minutes.
mm
Minutes with leading zero for single-digit

minutes.
Seconds with no leading zero for single-digit

seconds.
ss
Seconds with leading zero for single-digit

seconds.
One character time marker string, such as A or P.
tt
Multicharacter time marker string, such as AM

or PM.
Example
To display 01/01/1999 12:05:00 AM
Use the format string: MM/dd/yyyy hh:mm:ss tt.
B. For apNumberCustom, select the item Custom. Use a format string in the
standard C language format notation to display a number.
C. For apNumberScientific or apNumbercompact, select Precision if you need to
change it from the default of 6.
D. For apNumberRelativeTime, select RelativeTime. Choose one:
6-14
Entry
Displays relative time as:
apTimeDDHHMMSS
Day:hours:minutes:seconds
apTimeHHMMSS
Hours:minutes:seconds.
apTimeHHTenths
Hours and tenths
apTimeMMSS
Minutes:seconds.
apTimeMMTenths
Minutes and tenths
GFK-1260F
Step 5: Design the line (pen) for an X or Y-axis:

1.
Select Pen under XItem or YItem.
2.
Click the
3.
Select a Color for the axis.
to expand the tree.
A. Click the Palette button
to the right of the displayed color.
B. Select a color from the palette that appears.

4.
Choose the line's Style.

Style
Displays
apPenDash
apPenDashDot
apPenDashDotDot
4.
apPenSolid (Default)
Specify the line Width.
A value of 1 is equivalent to 1/100th of a millimeter. This equivalence applies in
CimView only when the screen is at 100% zoom.
The value of this property defaults to 0, which corresponds to a 1 pixel width
regardless of the graphical device (e.g display versus a printer).
Step 6: Configure the ticks on an X or Y-axis:

1.
Select Ticks under the XItem or YItem.
2.
Click the
3.
Specify if AutoCount should be:

True
to expand the tree.
The label count is automatically calculated.
4.
False (Default)
The label count is manually specified.
Select Count to specify how many ticks should appear. The default is 2.
5.
Configure the Font for the label.

A. Select Font in the tree under Ticks.
B. Either
GFK-1260F
i.
Click the Font Dialog Box button

and configure the font in the Font
dialog box. The font you configure will be used.
ii.
Set UseAmbientFont to True. The ambient font for the CimEdit screen will
be used. The default is True.
6-15
Step 7: Configure the limits, mode and scroll properties on an X or Y-axis:

1.
Select the Mode under X-Item or Y-Item in which the axis limits will perform during
runtime.
Mode
Defines an axis where the:
apAxisAutoscaled
Low and high limits change to fit all the data values
of all the series that use the axis.
The increment used on the high limit is based on the
decimal base of the largest series data value.
The decrement used on the low limit is based on the
decimal base of the smallest series data value.
If the largest data value increments between 1 and 9,
the high limit increments in single digits because the
decimal base is 1.
When the value reaches 10, the limit increments in
double digits, 10, 20 ,30, etc. When the value reaches
100, the limit incrments in triple digits, 100, 200,
300, etc. The same principle works for the low limit.
apAxisFixed
Low and high limits are fixed. They do not change

regardless of the values of all the series that use the
axis. This means that only those data values that fall
between the fixed limits are displayed.
apAxisScrolled
3.
High limit is set to the maximum data value of all the

series plus the scroll percent of the original axis
width. The low limit is set to the high limit minus the
original axis width. The original axis width is the
initial high limit minus the initial low limit. This
mode is very useful for incremental flow data.
Specify the High and Low Limits. During runtime the limits will display in response
to the mode you specified. The defaults are:
High
4.
100
Low
0
If apAxisScrolled is selected, configure the Backward and Forward scroll buttons.
A. Click the
to the left of BackwardScroll under XItem or YItem.
B. Specify whether or not to display the Full Backward Scroll button, e.g.
when the X-axis is in the Forward direction.
i.
Click the
ii.
Set Visible to True to display the button, False to hide the button.
to the left of Full.
C. Specify whether or not to display the Partial Backward Scroll button, e.g.
6-16
i.
Click the
ii.
to the left of Partial.
GFK-1260F
D. Specify whether or not to display the Full Forward Scroll button,

e.g.
i.
Click the
ii.
to the left of Full.
E. Specify whether or not to display the Partial Forward Scroll button,

e.g.
iii. Click the
to the left of Partial.
iv. Set Visible to True to display the button, False to hide the button.
Step 8: (Optional) Add additional axes:
1.
Select Item under X or Y.
2.
3.
Select Add from the popup menu.
The Add Method Arguments dialog box opens.

4.
Enter a name for the axis in the Value column.

Enter an axis name
5.
Click OK.
A next number up from the number of existing X or Y-axes appears under Item.
Example
You had one X-axis. You add a second. The first X-axis appears in the list under
Item as 0. The second will be listed as 1.
GFK-1260F
6-17
Automatically displays the total number

of X or Y-axes
New X-axis
6.
Original X-axis
Expand the new axis and configure it using the same steps you used for the previous
axis.
Important: When you select Add, XY immediately adds an axis. It does not wait for you to
click the Apply button.
Step 9: Configure properties to prioritize an axis and identify it:
1.
Specify the Order of priority in which the axis will be addressed by the XY Plot. The
default is the lowest priority.
Example
The XY Plot has three axes. You add a fourth.
The fourth axis default order will be 3 (0, 1, 2, 3).
2.
Enter a Name for the axis.
3.
Configure a Title for the axis.

A. Configure the Font for the Title.
i.
Select Font in the tree under Title.
ii.
Either
a.
Click the Font Dialog Box button

and configure the font in the
Font dialog box. The font you configure will be used.
b.
Set UseAmbientFont to True. The ambient font for the CimEdit screen
will be used.
B. Specify the title content.
i.
Select Value.
ii.
Enter the text that you want to display. The default is X Axis under the X
and Y Axis under the Y.
C. Select True for Visible in the tree under Title to display the title. The default is
True.
4.
6-18
Select True for Visible (in the path under XItem or YItem) to display the axis. The
default is True.
GFK-1260F
Step 10: (Optional) Remove axes:

Remove all X or Y-axes
1.
Select Item.
2.
3.
Select Remove All.
Remove a selected axis

1.
Select the axis number that you want to remove.
2.
3.
Select Remove.
Important: When you select Remove All or Remove, XY Plot immediately makes the
removal. It does not wait for you to click the Apply button. Therefore, select those two
options very carefully. (If you saved the CimEdit screen before you accidentally remove an
item, close the CIMPLICITY XY Plot Control Properties dialog box and the CimEdit screen
without saving it. The screen will re-open with the last saved features, including the features
you removed.)
GFK-1260F
6-19
XY Plot Series Properties

The focus of the XY Plot is a series.
A series consists of one or more values based on an X or Y specification. For example, a
series can report the pressure verses temperature for a turbine engine. The values display by
means of a marker and/or a line.
Finding the Series Properties

To find the series properties in the XY Plot Control Properties dialog box:
1.
2.
Scroll down to Series.
CIMPLICITY XY Plot Control Properties Dialog Box: Series
Designing a Series
Following are some quick steps to customize every property for a series.
Step 1: Add additional series.
Step 2: Configure properties that identify the series.Step 3: (Optional) Remove series.
Step 4: Expand the tree under Series. (You can collapse whatever you expand.)
Step 5: Expand a selected series.
Step 6: Select the type of series.
Step 7: Configure a fill (brush) for a series.
Step 8: Configure the markers.
Step 9: Configure the line (pen).
Step 10: Configure the X and Y-axes for the series.
Step 11: Specify if a series values should be in the legend.
6-20
GFK-1260F
Step 12: (Optional) Enter X and Y values for the series.

Step 1: Add additional series:
1.
Select Item under Series.
2.
3.
The Add Methods dialog box opens.

4.
Enter a name for the series in the Value column.
5.
Select a Series Type. The default is apSeriesStandard.

Enter an series name
Select the series

type from the drop
down menu
6.
Click OK.
A next number up from the number of existing series appears under Item.
Example
You had one Series. You add a second. The first series appears in the list under Item
as 0. The second will be listed as 1.
of series
New series
7.
GFK-1260F
Original series
Expand the new series and configure it using the same steps you used for the
previous series.
6-21
Step 2: Configure properties that identify the series:

1.
Enter a Name for the series.
2.
Select True for InLegend to have the series should appear in the legend. The default
is True.
3.
Select True for Visible (in the tree under the SeriesItem) to display the series. The
default is True.
Step 3: (Optional) Remove series:

Remove all series
1.
Select Item.
2.
3.
Select Remove All.
Remove a selected series

1.
Select the axis number that you want to remove.
2.
3.
Select Remove.
Important: When you select Remove All or Remove, XY Plot control immediately makes
the removal. It does not wait for you to click the Apply button. Therefore, select those two
options very carefully.
Step 4: Expand the tree under Series:
1.
Do one of the following to begin expanding the list under Series:

Method 1
Click the
Method 2
to the left of Series.

B. Click the Expand popup menu
6-22
GFK-1260F
Method 3
Double click Series.
The tree expands to display:
Count (Read only)
3.
The number of series that have been configured for

the chart.
Item
Use any of the methods you used for Series to expand Item. (Choose Expand from
Note: Follow any of the three methods when the tree is expanded to collapse the tree. The
popup menu displays as Collapse
.
Step 5: Expand a selected Series:
1.
Select a number, e.g. 0, under the Series Item.
2.
Step 6: Select the type of series:

Choose one of the following Types under SeriesItem.
Type
Defines
apSeriesScatter
A series that has no lines
apSeriesStandard (Default)
A standard series, which is a line between two data

values (connects the dots).
apSeriesStep
An X-based step that flows horizontally, then

vertically from one data value to the next.
Step 7: Configure a fill (brush) for a series marker:

1.
Select Brush under SeriesItem.
2.
Select a color for the marker's fill.


3.
GFK-1260F
Select the brush Type.

Type
Fills the series with a:
apBrushSolid
Solid color
apBrushHatch
Hatch (pattern)
6-23
4.
Select a HatchStyle for the brush if you selected apBrushHatch as the type.
apHatchBackwardDiagonal
apHatchCross
apHatchDiagonalCross
apHatchForwardDiagonal
apHatchHorizontal
apHatchVertical
Step 8: Configure the markers for a series:

1.
Select Marker under SeriesItem.
2.
Select the Type of marker.

Type
Displays a:
apMarkerCircle
Circle
apMarkerSquare
Square
apMarkerTriangle
Triangle
3.
Select True for Visible (in the tree under Markers) to make the markers for the series
visible.
4.
Specify the marker's Width.

The value of this property defaults to 250.
Step 9: Configure the line (pen) for a series:

1.
Select Pen under SeriesItem.
2.
Select a Color for the series line.

to the right of the displayed Color.

3.
Select the series' line (pen) Style.

Style
Displays
apPenDash
apPenDashDot
apPenDashDotDot
6-24
GFK-1260F
4.
Select line Width for the series line.

Step 10: Configure the X and Y-axes for a series:

1.
Right click X or Y under SeriesItem if you want an X or Y-axis to associate a

specific axis with the series.
2.
Select Set from the popup menu.
The X or Y Available Values dialog box opens.
3.
Select the axis that you want to associate from the list of available axes. See the "XY
Series Properties" section in this chapter for procedures to configure an X or Y-axis.
Step 11: Specify if a series values should appear in the legend:

1.
Expand a selected series under SeriesItem.
2.
Set InLegend to True to display the series' values in the Series Legend; False to
omit the series from the legend.
Note: You specify the type of value to display under Legends in the CIMPLICITY
XY Plot Control Properties dialog box.
Step 12: (Optional) Enter X and Y values for a series:
GFK-1260F
1.
Expand Data under SeriesItem.
2.
Enter, in the Count field, the number of X,Y points (represented by markers) that
you want to display.
3.
Expand X.
4.
Expand Item.
6-25
The number you entered in the DataCount field, displays in the X-Count field.
The list of X numbers (coordinates), for which you can enter values totals the Count
value.
5.
Enter a value for each X coordinate.
6.
Repeat the process for Y.

Example
Series (Manual) Data Entry Example
1 The number of X, Y coordinates (Count) is 5.
2 X and Y values are entered for each coordinate

Y column
X column
3 The XY Chart displays the entered values.
6-26
GFK-1260F
XY Plot Slider Properties

You can use a slider to:
Select data on the chart for which you want values
Move data backward and display data that might no longer be on the chart
Move data forward
Finding the Sliders Properties

To find the slider properties in the XY Plot Control Properties dialog box:
1.
2.
Scroll down to Sliders.
CIMPLICITY XY Plot Control Properties Dialog Box: Sliders
Designing a Slider
Following are four quick steps to customize every property for a slider.
Step 1: Expand the tree under Sliders. (You can collapse whatever you expand.)
Step 2: Expand a selected Slider..
Step 3: Select the Type of Slider.
Step 4: Configure the line (pen) for a slider.
Step 5: Specify the sliders initial position and its visibility.
Step 6: Specify if a sliders values should be in the legend.
Step 7: (Optional) Add additional sliders.
Step 8: Configure properties to prioritize a slider and identify it.
Step 9: (Optional) Remove sliders.
GFK-1260F
6-27
Step 1: Expand the tree under Sliders:

1.
Do one of the following to expand the tree under X or Y:

Method 1
Click the
Method 2
to the left of Sliders.

B. Click the Expand popup menu.
Method 3
Double click X or Y.
When you use any method, the tree expands to display:
Count (Read only)
2.
The number of sliders that have been configured for

the chart.
Item
Use any of the methods you used for Sliders to expand Item. (Choose Expand from
Step 2: Expand a selected slider:

1.
Select a number, e.g. 0, under the Series Item.
2.
Step 3: Select the Type of Slider:

Under SliderItem, select either:
Type
Displays the:
apSliderVertical (Default)
Interesected Y data value shows. This is because a

vertical slider moves across the X axis. Therefore, for
each X data value that the slider is at, you have a Y
data value on the series data vector.
If there is more than one intersected Y data value, the
data value that is displayed is the first intersected data
value found from the end to the beginning of the data
vector.
6-28
GFK-1260F
apSliderHorizontal
Interesected X data value shows. This is because a

horizontal slider moves across the Y axis. Therefore,
for each Y data value that the slider is at, you have an
X data value on the series data vector.
If there is more than one intersected X data value, the
data value that is displayed is the first intersected data
value found from the end to the beginning of the data
vector.
Step 4: Configure a slider line (pen) for a slider:

1.
Select Pen under SliderItem.
2.
Select a Color for the series line.

C. Click the Palette button
to the right of the displayed Color.
D. Select a color from the palette that appears.

3.
Select the slider's line (pen) Style.

Style
Displays
apPenDash
apPenDashDot
apPenDashDotDot
4.
Select line Width for the slider line.
Step 5: Specify the sliders initial position and its visibility:

1.
Specify the slider's Position as a percent (0 to 100). This is the position the slider will
be at whenever the XY Plot is opened.
The designated percent indicates the position from left to right for a vertical slider;
bottom to top, for a horizontal slider.
2.
Select True for Visible (in the tree under the SlidersItem) to display the slider. The
default is True.
Step 6: Specify if a sliders values should appear in the legend:

1.
Expand a selected slider under SliderItem.
2.
Leave the InLegend default of True to display the slider's values in the Slider
Legend; set it to False to omit the slider from the legend.
Note: You specify the type of value to display under Legends in the CIMPLICITY
XY Plot Control Properties box.
GFK-1260F
6-29
Step 7: (Optional) Add additional sliders:

1.
Select Item under Sliders.
2.
3.
The Add Methods dialog box opens.

4.
Enter a name for the series in the Value column.
5.
Select a Slider Type. The default is apSliderVertical.
Select the slider type from the

drop down menu
6.
Click OK.
A next number up from the number of existing series appears under Item.
Example
You had one slider. You add a second. The first slider appears in the list under Item
as 0. The second will be listed as 1.
of slider
New slider
7.
6-30
Original slider
Expand the new slider and configure it using the same steps you used for the
previous slider.
GFK-1260F
Step 8: Configure properties to prioritize a slider and identify it:

1.
Specify the Order of priority in which the slider will be addressed by the XY Plot.
The default is the lowest priority.
Example
The XY Plot has three sliders. You add a fourth.
The fourth sliders default order will be 3 (0, 1, 2, 3).
2.
Enter a Name for the slider.
3.
Leave Visible as True to display the slider; select False to hide it.
Step 9: (Optional) Remove sliders:

Remove all X or Y-axes
1.
Select Item.
2.
3.
Select Remove All.
Remove a selected slider

1.
Select the slider number that you want to remove.
2.
3.
Select Remove.
Important: When you select Remove All or Remove, XY Plot immediately makes the
removal. It does not wait for you to click the Apply button. Therefore, select those two
options very carefully.
GFK-1260F
6-31
XY Plot Grid Properties

If your chart will be enhanced by displaying a grid, you can easily select to display one, in
addition to specifying its style and density.
Finding the Grid Properties

To find the Grid properties in the XY Plot Control Properties dialog box:
1.
2.
Scroll down to Grid.
CIMPLICITY XY Plot Control Properties Dialog Box: Grid
Designing the Grid

Following are four quick steps to customize every property on a grid:
Step 1: Expand the tree under Grid.

Step 2: Design the line (pen) for a grid.
Step 3: Specify the grid density.
Step 4: Specify the grids visibility.
Step 1: Expand the tree under Grid:
Do one of the following to expand the tree under Grid:
Method 1
Click the
6-32
to the left of Grid.
GFK-1260F
Method 2
B. Click the Expand popup menu.
Method 3
Double click Grid.
The tree expands to display the grids property options.
popup menu displays as Collapse.
.
Step 2: Design the line (pen) for a grid:
1.
Select Pen under Grid.
2.
Click the
3.
Select a Color for the axis.
to expand the tree.

4.
Choose the lines Style.

Style
Displays
apPenDash
apPenDashDot
apPenDashDotDot
5.
Specify the line Width.
GFK-1260F
6-33
Step 3: Specify the grid density:

1.
Specify the number of horizontal gridlines.

A. Select HorizontalCount under Grid.
B. Enter the number of horizontal lines that will display.
2.
Specify the number of vertical gridlines.

A. Select VerticalCount under Grid.
B. Enter the number of vertical lines that will display.
Step 4: Specify the grids visibility:

Select True for Visible (in the tree under Grid) to display the grid. The default is False.
XY Plot Legend Properties

You can display legends for the XY Plot Series and Sliders. XY Plots offers you options for
the types of values to display as well as configuration options.
Finding the Legend Properties

To find the legend properties in the XY Plot Control Properties dialog box:
1.
2.
Scroll down to Legend.
CIMPLICITY XY Plot Control Properties Dialog Box: Legend
6-34
GFK-1260F
Designing the XY Plot Legends

Following are quick steps to customize every property for Series and Slider Legends.
Step 1: Expand the tree under Legends.
Step 2: Make the Legends visible.
Step 3: Specify the legends location (orientation) relative to the XY Plot.
Step 4: Design the Series legend.
Step 5: Design the Slider legend.
Step 1: Expand the tree under Legends:
Do one of the following to expand the tree under Legends:
Method 1
Click the
Method 2
to the left of Legends.

.
Method 3
Double click Legends.
The tree expands to display the titles property options.
popup menu displays as Collapse.
.
Step 2: Make the legends visible:
1.
Select Visible under Legends.
2.
Select True.
3.
Press Apply.
Step 3: Specify the legends location (orientation) relative to the XY Plot:

1.
GFK-1260F
Select Orientation under Legends.
6-35
2.
Select one of the following to place the legend relative to the chart.
Location relative to the chart
apOrientationBottom (default)
Bottom
apOrientation Left
Left
apOrientationRight
Right
apOrientationTop
Top
Step 4: Design the Series legend:

1.
Expand Series under Legends.
2.
Specify if the series header should be visible.

A. Select HeaderVisible under LegendsSeries.
B. Select True to make it visible, False to hide it.
3.
Configure the font to display in the series header.

A. Select Font under LegendsSeries.
B. Either:
Click the Font button on the LegendSeries Font row and open the Font
dialog box to configure the font, or
Set UseAmbientFont under LegendsSeries to True.
4.
Select a fill for the header's background.

A. Select Brush under LegendsSeries.
B. Select a color for the header background.
Select a color from the palette that appears.

C. Select the brush Type.
Type
Fills the series legend with a:
apBrushSolid
Solid color
apBrushHatch
Hatch (pattern)
D. Select a HatchStyle for the brush if you selected apBrushHatch as the type.
apHatchCross
apHatchHorizontal
apHatchVertical
6-36
GFK-1260F
5.
Configure the Series legends columns for the XY Plots series.

A. Expand Columns under LegendsSeries.
The number of columns currently in the header appears (grayed out) in the
Count row. You can add additional columns or delete existing ones.
B. Expand Item.
Each number that appears represents a column in the order that it displays, from
left to right, e.g. 0 represents the column that is furthest left.
C. Set Visible to True to make the column visible; False to hide it.
D. Specify the type of series value that appears in the legend column. The options
are:
Option
Shows the
apLegendColor
Series color
apLegendSeriesName
Series name
apLegendSeriesValueAtSlider
Data value that is intersected by a particular

slider
apLegendSeriesValueAtIndex
Data value at a particular index in a series

data vector
E. Make specifications when apLegendSeriesValueAtIndex is selected.
i.
Select True for ShowX to display the series X values; False to display the
series Y values.
ii.
Enter an Index value that contains the index to the series data value that
you want to display.
Example
If you enter 0 in the Index row, the column will display the first data value
(X or Y, depending on the value of ShowX.
F. Enter text that displays as the column header in the Header row. The text
normally describes the type of value the column is reporting.
G. Specify the column width.
Set AutoWidth to True to make the column width expand or contract to
accommodate the width of its values, or
Set AutoWidth to False and enter a value in the Width row.
A value of 1 is equivalent to 1/100th of a millimeter (when a CimView
screen is at 100% zoom).
H. Enter a number in the Order row that defines the order in which the column
should appear in the legend, from left to right. For example, 0 is the first column
at the left of the legend; 1 is to Column 0s right.
I.
GFK-1260F
Select a fill for a selected column.

i.
Expand Brush under ColumnItem <number>.
ii.
Click the Palette button on the Color row to select a color.
6-37
J.
(Optional) Add additional columns.

i.
Select Item under LegendsSeries.
ii.
iii. Select Add from the popup menu.

6.
Format the Series Legend's rows for the XY Plot series.

A. Expand Row under LegendsSeries.
The number of rows currently in the Series Legend appears (grayed out) in the
Count row.
B. Enter the maximum number of Series Legend rows that can be visible during
runtime in the VisibleCount row.
Step 5: Design the Slider legends column heading:

1.
Expand Slider under Legends.
2.
Specify if the slider's header should be visible.

A. Select HeaderVisible under LegendsSlider.
B. Select True to make it visible, False to hide it.
3.
Configure the font to display in the series header.

A. Select Font under LegendsSlider.
B. Either:
5.
i.
Click the Font button on the LegendSlider Font row and open the Font
dialog box to configure the font, or
ii.
Set UseAmbientFont under LegendsSlider to True.
Select a fill for the header's background.

A. Select Brush under LegendsSlider.
B. Select a color for the header background.
i.
ii.
Select a color from the palette that appears.
C. Select the brush Type.
6-38
Type
Fills the series with a:
apBrushSolid
Solid color
apBrushHatch
Hatch (pattern)
GFK-1260F
D. Select a HatchStyle for the brush if you selected apBrushHatch as the type.
apHatchCross
apHatchHorizontal
5.
apHatchVertical
Configure the legends columns for the XY Plots slider.
A. Expand Columns under LegendsSlider.
The number of columns currently in the header appears (grayed out) in the
Count row. You can add additional columns or delete existing ones.
B. Expand Item.
Each number that appears represents a column in the order that it displays, from
left to right, e.g. 0 represents the column that is furthest left.
C. Set Visible to True to make the column visible; False to hide it.
D. Specify the type of sliders value that appears in the legend. The options are:
Option
Shows the
apLegendName
Slider name
apLegendSliderValue
Value of a slider relative to an axis
E. Make specifications when apLegendSliderValue is selected.
Enter an Index value that specifies the axis you want to use. The index is the
position of the axis in the X or Y-axis collection. For a vertical slider the axis
F.
must be an X-axis; for a horizontal slider, a Y-axis.

Enter text that displays as the column header in the Header row. The text
normally describes the type of value the column is reporting.
G. Specify the column width.

i.
Set AutoWidth to True to make the column width expand or contract to

accommodate the width of its values, or
ii.
Set AutoWidth to False and enter a value in the Width row.
A value of 1 is equivalent to 1/100th of a millimeter (when a CimView

screen is at 100% zoom).
H. Enter a number in the Order row that defines the order in which the column
should appear in the legend, from left to right. For example, 0 is the first column
at the left of the legend; 1 is to Column 0s right.
GFK-1260F
6-39
I.
(Optional) Add additional columns.

i.
Select Item under LegendsSlider.
ii.
iii. Select Add from the popup menu.

J.
6.
Select a fill for a selected column.

i.
Expand Brush under ColumnItem <number>.
ii.
Click the Palette button on the Color row to select a color.
Format the Slider Legends rows for the XY Plot series.

A. Expand Row under LegendsSlider.
The number of rows currently in the Slider Legend appears (grayed out) in the
Count row.
B. Enter the maximum number of Slider Legend rows that can be visible during
runtime in the VisibleCount row.
XY Plot Title Properties

In addition to creating chart titles directly on the CimEdit screen, you can specify a title that
will appear directly on the XY Plot.
Finding the XY Plot Title Properties

To find the title properties in the XY Plot Control Properties dialog box:
1.
2.
Scroll down to Title.
CIMPLICITY XY Plot Control Properties Dialog Box: Title
6-40
GFK-1260F
Designing an XY Plot Title

Following are three quick steps to customize an XY Plot title.
Step 1: Expand the tree under Title. (You can collapse whatever you expand.)
Step 2: Specify the title content.
Step 3: Configure the Font for the title.
Step 4: Make the title visible.
Step 1: Expand the tree under Title:
Do one of the following to expand the tree under Title:
Method 1
Click the
Method 2
to the left of Title.

.
Method 3
Double click Title.
The tree expands to display the titles property options.
popup menu displays as Collapse
.
Step 2: Specify an XY title content:
1.
Select Value under Title.
2.
Type the title on the Value row.
Step 3: Configure the font for an XY title:

1.
Select Font in the tree under Title.
2.
Either
A. Click the Font Dialog Box button
and configure the font in the Font dialog
box. The font you configure will be used.
B. Set UseAmbientFont to True. The ambient font for the CimEdit screen will be
used. The default is True.
GFK-1260F
6-41
Step 4: Make an XY title visible:

Select True for Visible (in the tree under Title) to display the title. The default is True.
XY Plot Updates
When you make a change in an XY Plot, it automatically updates by default.
Turning of the automatic update stops a chart from being refreshed by your configuration.
However, other actions, such as moving the dialog box over the chart will invalidate the
current settings and cause the screen to refresh itself. This will update the chart to the most
current settings.
This feature is most useful if you are doing complicated scripting and want to minimize the
screen updates.
To specify an XY Plots update method:
6-42
1.
Open the CIMPLICITY XY Plot Control Properties dialog box.
2.
Select AutoUpdate.
3.
Select one of the following:

True (Default)
XY will automatically update
False
Updates are not automatic
GFK-1260F
Plotting XY Data
About Plotting XY Data

CIMPLICITY XY Plot Control allows you to plot one or more series of data values in its
chart region. Each data value is a pair of coordinates in a two-dimensional plane (hence, XY
coordinates). In order to plot series in the chart region, you need to provide the values through
the controls object model.
The object model is a hierarchy of objects and properties that allow you to modify the
configuration of the control through an automation implementation. CimEdit Scripts are an
example of an automation implementation.
See the "XY Plot Object Model" help file for detailed descriptions of the XY Plot automated
objects.
See the Using CimEdit Scripts chapter in the CIMPLICITY HMI CimEdit Operation
Manual GFK-1396 for more information about CimEdit scripts.
Creating a Series of Data Values

The XY Plot control object model provides you with methods to add, retrieve and remove one
or more series of data values from its configuration.
See the Designing a Series Section in the Designing an XY Plot chapter in this manual
for details on how to add and remove series from the control properties.
Scriptiing examples for creating a series of data values include:
Example 1: Create a series for an XY Plot control object:
Series name: Series 1 (displays in an XY Plot control object in a CimView screen)
Scripting purpose: Create a series through an XY Plot Control object model
Procedure:
1.
Open the CimEdit Properties dialog box for the XY Plot control object.
2.
Display the Edit Script tab.
3.
Write the following Basic excerpt within a subroutine.

Add the series:
cimOleObj.Series.Add "Series 1", apSeriesStandard
GFK-1260F
7-1
Example 2: Create a series through an object other than the XY Plot control
object:
Series name: Series 1 (displays in an XY Plot control object in a CimView screen)
Scripting purpose: Create a series through and object other than the XY Plot Control object
model
Procedure:
1.
2.
Display the General tab.
3.
Enter XY in the Object name field.
4.
Open the CimEdit Properties dialog box for and object that is not an XY Plot control.
5.
6.

Access the XY Plot control object:
Dim xyPlot As CimGraphLib.DCimGraph
Dim screenObjects As GefObjects
Set screenObjects = CimGetScreen().Object.Objects
Set xyPlot = screenObjects("XY").OleObject
Add the series:

xyPlot.Series.Add "Series 1", apSeriesStandard
Scripting Examples for XY Plots

XY Plot interfaces include:
CimSeries is
The XY Plot control series interface.
Stores its two-dimensional data values in two vectors, X and Y, of fixed size.
CimPairData is
The interface that groups the X and Y vectors.
Is accessed through the Data property in CimSeries.
CimData is
The interface that defines each vector.
Is accessed through either the X or the Y property in CimPairData.
CimPairData and CimData have properties and methods that allow you to perform various
operations on the data values. You can:
7-2
Resize the series vectors
Access, retrieve and modify vectors individual values
Insert one or more values either from the end of the vector or at a specific location
within the vector within the same operation.
GFK-1260F
Resizing Series Vectors

CimPairData has a property called Count.
Count allows you to set the number of data values in both the X and Y vectors.
Scripting examples for resizing a series vector include:
Example 1: Write a subroutine in the XY Plot control objects Properties dialog
box:
Series name: Series 1
Pupose: Set the X and Y vector sizes to 500
Procedure:
1.
2.
3.

Access the series object:
Dim series as CimSeries
Set series = cimOleObj.Series("Series 1")
Access the pair of vectors:

Dim data as CimPairData
Set data = series.Data
Resize the vectors:

data.Count = 500
Setting Individual Data Values

CimData, the interface for both the X and Y series vectors, has a property called Item.
Item:
GFK-1260F
Allows you to get and set individual data values within the vector.
Is the default property of CimData. It can be invoked without having to write its
name.
Returns a single variant type when retrieving data and expects a single variant type
when setting the data.
Plotting XY Data
7-3
This variant type can be a single value of any of the following Basic types that result
in a numeric value including:
Integer
Long
Single
Double
Decimal
Boolean
Byte
Variant
String
To invoke the Item property to retrieve data you can use either of the following two formats:
X = CimData.Item(n)
X = CimData(n)
where
n is the location of the data value you are retrieving.
To invoke the Item property to set data you can use either of the following two
formats:
CimData.Item(n) = X
CimData(n) = X
where
n is the location of the data value you are setting.
Scripting examples for setting individual data values include:
Example 1: Access individual data values from the series vectors:
Script purpose: Set a point to the third Y data value
Procedure:
1.
2.

Define the point:
Dim x As New Point
x.Id = "X_POINT"
Set the point to the third Y data value in the series:

x.SetValue = cimOleObj.Series("Series 1").Data.Y(2)
7-4
GFK-1260F
Example 2: Set individual data values from the series vectors to a particular
value:
Script purpose: Set the fifth X data value to the value of a point
Procedure:
1.
2.
3.

Define the point:
Dim x As New Point
x.Id = "X_POINT"
Set the fifth X (which has an index of 4)

data value in the series:
cimOleObj.Series("Series 1").Data.X(4) = x.GetValue
Example 3: Set individual data values from the series vectors to unavailable:
Script purpose: Set the fourth y data value to null, the fourth X data value to empty
Both operations result in the value being unavailable.
Procedure:
1.
2.

Set the fourth X and Y data values to unavailable
(either null or empty):
cimOleObj.Series("Series 1").Data.Y(3) = Null
cimOleObj.Series("Series 1").Data.X(3) = Empty
Pushing one or more Data Values

CimPairData provides a method called Push.
Push:
GFK-1260F
Allows you to insert one or more pairs of X and Y data values through the end of the
X and Y vectors. This is particularly useful if your series plots a continuous flow of
data. An example of continuous flow of data is a function curve such as cosine of an
incremental variable.
Plotting XY Data
7-5
Expects the variant type for the type of X and Y values

This variant type can be a single or array value of any of the following Basic types
that result in a numeric value including:
Integer
Long
Single
Double
Decimal
Boolean
Byte
Variant
String
Example: Push one or more data values:

You have a series whose X and Y values are the following:
X
10
15
20
25
30
22
17
-7
22
41
You push the following X and Y values:

X
35
40
45
50
59
37
21
The series X and Y values are now the following:

X
25
30
35
40
45
50
22
41
59
37
21
The first four pairs of XY values have been removed from the series because the size of the X
and Y vectors is fixed.
Scripting examples for pushing single and array values include:
Example 1: Push one X and one Y value through the end of the series vectors
Example 2: Push arrays of X and Y values through the end of the series vectors
Example 1: Push one X and one Y value through the end of the series vectors
Script purpose: Push an integer and a double value into Series 1
Procedure:
7-6
1.
2.
GFK-1260F
3.

Create an integer and a double value:
Dim x as Integer
x = 7
Dim y as Double
Y = 22.74
Push the data into the series object:

cimOleObj.Series("Series 1").Data.Push x, y
Example 2: Push arrays of X and Y values through the end of the series vectors
Script purpose: Create an array of variant values and an array of double values and push
them into Series 1
Procedure:
1.
2.
3.

Create an array of variant values:
Dim x(4) As Variant
x(0) = 1
x(1) = Null
x(2) = 4.78
x(3) = Empty
x(4) = "5.78"
Create an array of random double values:

Randomize
Dim y(4) As Double
For i = 0 To 4
y(i) = Random(0, 50)
Next i

cimOleObj.Series("Series 1").Data.Push x, y
GFK-1260F
Plotting XY Data
7-7
Pushing Values from Points

CimEdit Scripts provide you with a type called Point.
Point can be used to set and get CIMPLICITY point management information for:
For
You can use:
Single (1 element) points
GetValue or a combination of Get and Value to get a

single value and push it into a series.
Array points
GetSafeArray or a combination of Get and SafeArray

to get a single value and push it into a series.
Example for Single Points

To push the values of two single points
Option 1
Use the following format to push the values of single points using GetValue:
CimPairData.Push Point.GetValue, Point.GetValue
Option 2
Use the following format to push the values of two points using a combination of Get
and Value:
Point.Get
CimPairData.Push Point.Value, Point.Value
Example for Array Points

To push the values of two array points:
Option 1
Use the following format to push the values of two points using GetSafeArray.
CimPairData.Push Point.GetSafeArray, Point.GetSafeArray
Option 2
Use the following format to push the values of two points using a combination of Get
and SafeArray.
Point.Get
CimPairData.Push Point.SafeArray, Point.SafeArray
Scripting examples for pushing values from single points and array points include:
Example 1: Push one X and one Y value through the end of a series vectors:
Script purpose: Push the single values of two CIMPLICITY points into Series 1
Procedure:
7-8
1.
2.
GFK-1260F
3.

Get two point values:
Dim x As New Point
x.Id = "X_POINT"
Dim y As New Point
y.Id = "Y_POINT"

cimOleObj.Series("Series 1").Data.Push x.GetValue, y.GetValue
Example 2: Push arrays of X and Y values through the end of a series vectors
Script purpose: Push the array values of two CIMPLICITY HMI points into Series 1
Procedure:
1.
2.
3.

Dim x As New Point
x.Id = "X_ARRAY_POINT"
Dim y As New Point
y.Id = "Y_ARRAY_POINT"
Get the series object:

Push the array data into the series object:

series.Data.Push x.GetSafeArray, y.GetSafeArray
Setting one or more Data Values

CimPairData provides a method called Set.
Set allows you to set one or more X and Y data values starting at a specified location. The
location is an index from 0 to the size of the number of data values in the series minus 1. For
example, if the series has 5 data values, you can specify a location between 0 and 4.
The specified data values are either:
GFK-1260F
Single values or
Arrays of any size.
Plotting XY Data
7-9
The number of data values actually set is the smallest of either the:
Size of the given arrays or
Number of data values between the specified index and the end of the series vector.
Set expects
An index location of variant type.

This variant type can be a single value of any of the following Basic types that result
in a numeric value including:
Integer
Long
Single
Double
Decimal
Boolean
Byte
Variant
String
The value must correspond to a valid location within the series X and Y vectors.
X and Y values of variant type.

This variant type can be a single or array value of any of the following Basic types
that result in a numeric value including:
7-10
Integer
Long
Single
Double
Decimal
Boolean
Byte
Variant
String
GFK-1260F
Example: Set one or more data values:

You have a series whose X and Y values are the following:
X
10
15
20
25
30
22
17
-7
22
41
You set the following X and Y values starting at location 2 (index 1):
X
35
40
45
50
59
37
21
The series X and Y values are now the following:

X
35
40
45
50
30
22
59
37
21
41
The XY values at locations 2 through 5 are updated with the new values.
Scripting examples for setting single and array values include:
Example 1: Set the fifth location in a series
Example 2: Create an array of variant values in a series
Example 1: Set the fifth location in a series:
Scripting purpose: Set the fifth location (index 4) in Series 1. The X is set to an integer and
the Y to a double value.
Procedure:
1.
2.
3.

Create an integer and a double value:
Dim x as Integer
x = 7
Dim y as Double
Y = 22.74
Set the data in the series object:

cimOleObj.Series("Series 1").Data.Set 4, x, y
GFK-1260F
Plotting XY Data
7-11
Example 2: Create an array of variant values in a series:

Scripting purpose: Create an array of variant values and an array of double values in Series
1. In addition, set the X and Y elements starting with the fifth element (index 4) through the
ninth. (It goes all the way through the ninth element because the arrays being pushed have
five elements.)
Procedure:
1.
2.
3.

Create an array of variant values:
Dim x(4) As Variant
x(0) = 1
x(1) = Null
x(2) = 4.78
x(3) = Empty
x(4) = "5.78"
Create an array of random double values:

Randomize
Dim y(4) As Double
For i = 0 To 4
y(i) = Random(0, 50)
Next i

cimOleObj.Series("Series 1").Data.Set 4, x, y
Setting Values from Points

CimEdit Scripts provide you with a type called Point.
Point can be used to set and get CIMPLICITY point management information.
7-12
For
You can use:
Single (1 element) points
GetValue or a combination of Get and Value to get a

single value and set it into a series.
Array points
GetSafeArray or a combination of Get and SafeArray

to get a single value and set it into a series.
GFK-1260F
Example for Single Points

To set the values of two single points
Option 1
Use the following format to set the values of single points using GetValue:
CimPairData.Set Index, Point.GetValue, Point.GetValue
Option 2
Use the following format to set the values of two points using a combination of Get and
Value:
Point.Get
CimPairData.Set Index Point.Value, Point.Value
Example for Array Points

To set the values of two array points:
Option 1
Use the following format to set the values of two points using GetSafeArray.
CimPairData.Set Index, Point.GetSafeArray, Point.GetSafeArray
Option 2
Use the following format to set the values of two points using a combination of Get and
SafeArray.
Point.Get
CimPairData.Set Index, Point.SafeArray, Point.SafeArray
Scripting examples for setting values from single points and array points include:
Example 1: Set the first location in a series:
Scripting purpose: Set the first location (index 0) in Series 1. The values of two
CIMPLICITY points are used.
Procedure:
1.
2.
3.

Dim x As New Point
x.Id = "X_POINT"
Dim y As New Point
y.Id = "Y_POINT"

cimOleObj.Series("Series 1").Data.Set 0, x.GetValue, y.GetValue
GFK-1260F
Plotting XY Data
7-13
Example 2: Set a series with the array values of two CIMPLICITY HMI points:
Scripting purpose: Set Series 1 with array values of two CIMPLICITY HMI points. The set
starts at the first location up to the smaller of either: the size of the array points or the number
of available locations in the series.
Procedure:
1.
2.
3.

Dim x As New Point
x.Id = "X_ARRAY_POINT"
Dim y As New Point
y.Id = "Y_ARRAY_POINT"
Get the series object:

Set the array data in the series object:

series.Data.Set 0, x.GetSafeArray, y.GetSafeArray
7-14
GFK-1260F
About XY Plot SmartObjects

XY provides you with an XY Plot SmartObject that streamlines your XY chart design time
and enables you to enter data into the plot control by simply entering the point IDs and /or
expressions that you want to plot. There is no scripting involved.
To create an XY chart using an XY Plot SmartObject, you simply:
1.
Place the XY Plot SmartObject in your CimEdit screen.
2.
Make a few quick entries on the tabs of the XY Plot SmartObject dialog box. The
tabs let you configure the XY charts:
Series
Axes
Name and colors
Grid
When you complete your initial configuration, you can continue at any time.
GFK-1260F
Double click the XY Plot Control to re-open the XY Plot SmartObject dialog box.
Click the right mouse button to display the popup menu that leads you to the
CIMPLICITY XY Plot Control Properties dialog box. See the "Designing an XY
Plot" chapter in this manual for more information about the CIMPLICITY XY Plot
Control Properties dialog box.
8-1
XY Plot SmartObject Placement

The XY Plot SmartObject is in the Object Explorer.
To place an XY Smart Object Control:
1.
Click the Object Explorer button
2.
Select CIMPLICITY SmartObjects.
3.
Select XY Plot.
4.
Double click the XY SmartObject.
on the CimEdit toolbar.
Object Explorer: Section with XY SmartObject
A blank Series dialog box opens.
8-2
GFK-1260F
XY Plot SmartObject Configuration

The SmartObject Plot Control provides you with several tabs on which you can quickly
configure an XY Plot Control. You can, of course, change all of the defaults. However, you
will frequently discover that you need to modify very few options to get a meaningful XY
Plot Control up and running.
The XY Plot SmartObject dialog box tabs represent the main features you will configure for
the XY Plot Control. The tabs are for an XY Plot are:
Series
Axes
Name and colors
Grid
When you finish your initial configuration, you can easily modify or enhance the Plot Control
whenever you want.
Configuring the XY Plot SmartObject Series

Use the following steps to configure an XY Plot series:
Step 1: Add a series to the Series dialog box.
Step 2: Name the Series.
Step 3: Specify the data for the series.
Step 4: Specify the series display features.
Step 5: Apply your series configuration.
GFK-1260F
8-3
XY SmartObject Chart Dialog Box: Series Tab

Series box
Add a series
Delete a series
Move a series in
the list
w Up
w Down
Series data
Update criteria
X and Y-axis
assignments
Display the Series

Appearance tab
Quick options for a
series appearance
Step 1: Add a series to the Series dialog box:

1.
Click the Add button.

SeriesX appears in the Series box.
where
X equals the next number above the highest SeriesX.
The first series created is Series0.

When a series displays in the Series box, the fields in the right side of the Series
dialog box become active and ready for configuration.
2.
Check the Visible box if you want the series to display on the XY Plot Control.
Step 2: Name the Series:

1.
Select the series to be named in the Series box.
2.
Enter a name in the Name field.
When you click the Apply button the name will change in the Series box to reflect your
entry.
Step 3: Specify the data for the series:
1.
Configure the X-axis expression. Either:

A. Enter an expression in the X Expression field, or
8-4
GFK-1260F
B. Select a point to represent the expression or be included in an expression.

i.
Click the Select a Point button to the right of the X Expression field.
ii.
Select a Point ID.
iii. (Optional) Enhance the Point ID with an expression operator found in the
CimEdit.
Example
Point ID can be \\CIMPDEMO\DEV1550
2.
Point ID in an Expression can be SQR(\\CIMPDEMO\DEV1550)

Configure the Y-axis expression by repeating the procedure to configure the X-axis
expression.
3.
Specify the Expression Update method. the options are:

Timed
Enter the number of one of the following options

found in the drop down menu:
Milleseconds (Ms)
Seconds (Sec)
Minutes (Min)
Hours (Hour)
On X expression update
How frequently the X expression updates depends

how the expression values are configured. e.g. A
Point ID that is updated On Change, will update the
XY Plot Control whenever it changes.
On Y expression update
How frequently the Y expression updates depends

how the expression values are configured. e.g. A
Point ID that is updated On Change, will update the
XY Plot Control whenever it changes.
Step 4: Specify the series display features:

1.
Click the Display button under the Series box.

The Series Appearance dialog box opens.
2.
3.
Select the series Type:

Select:
For a:
Standard (Default)
A standard series, which is a line between two data

values (connects the dots).
Step
An X-based step that flows horizontally, then

vertically from one data value to the next.
Scatter
Select the line Style.
A series that has no lines
Solid (Default)
Dashed
Dotted
Dashed-Dotted
Dashed-DoubleDotted
GFK-1260F
8-5
4.
Select the marker (Dot) from the three options:

A. Circle
B. Square
C. Triangle
5.
Select the Width for the line and the Marker (dot) edge.
6.
Click Apply to return to the XY Plot SmartObject dialog box.
Step 5: Apply your series configuration:

Click the Apply button
to apply your configuration.
Configuring the XY Plot SmartObject Axes

You can configure a series X and Y-axis in the following steps.
Step 1: Select an X and Y-axis for configuration.
Step 2: Specify the X or Y-axis name and limits.
Step 3: Specify the X or Y-axis format and orientation.
Step 4: Apply your axis configuration.
Step 5: Configure the other axis.
Step 6: (Optional) Add additional axes.
Step 7: Apply the axis configuration..
XY SmartObject Chart Dialog Box: AxisTab
Axis box displays either the X or Y-axis
Check to reverse direction of data

Initial limits flow from the standard direction
Axis location
Show X Axes
Show Y Axes
8-6
Axis scaling options
Axis value format
GFK-1260F
Step 1: Select an X and Y-axis for configuration:

1.
Click the Axes button on the bottom of the Series tab.

The Axes tab displays with Axis0 displaying in the Axis box.
2.
Check either the Show X Axes or Show Y Axes check box.

The Axis0 represents the axis you select, e.g. if you checked the Show X Axes
checkbox, Axis0 becomes the X-axis.
Step 2: Specify the X or Y-axis name and limits:

1.
Enter a name for the axis in the Name field.

When you click the Apply button, the name will replace Axis0 in the Axis box.
2.
Check the Visible check box to display the axis on the XY Plot.
3.
Enter an axis title in the Title field.
4.
Check the Visible Title check box to display the title you entered on the XY Plot.
5.
Enter a Lower and/or Upper limit if you want either to be different from the default
of 0 and 100.
6.
Specify how the axis should scale during runtime, as follows:

Scale Selection
During Runtime
Fixed
The limits remain fixed to the values entered in the

Lower Limit and Upper Limit fields.
Autoscale
XY automatically change the axis limits each time a

value goes above or below the existing limit.
7.
Scroll
Check the Ticks checkbox to display ticks on the axis being configured.
8.
Enter the number of ticks to display. The default is 2.
Step 3: Specify the X or Y-axis format and orientation:

1.
Specify the direction of the data flow.

A. Leave the Reversed check box blank if you want the data to flow in the
standard direction. (upward for a Y-axis, rightward for an X-axis).
B. Check the Reversed check box if you want the data flow in the opposite
direction (downward for a Y-axis, leftward for an X-axis).
2.
Select the location for the X or Y-axis.

A. For the X-axis, check the Top or Bottom button.
B. For the Y-axis, check the Left or Right button.
GFK-1260F
8-7
3.
Select the format in which the labels will display. The choices with default precision
entries are:
Format
Precision
Result
Integer (default)
NA
33
Fixed
33.33333
Scientific
33.33333e+001
Compact
33.333
Absolute Time
h:mm:ss:tt
7:00:33 PM
Relative Time
NA
0.5
Custom
%d
33
Step 4: Apply your axis configuration:

Step 5: Configure the other axis:

1.
Check the Show Y Axis or Show X Axis button, whichever represents the axis
that still needs to be configured.
Axis0 displays in the Axis box.
Tip: Check the Show button that represents the axis you just configured. You will see that
the name in the Axis box has changed to the name you entered in the Name field for that
axis.
Step 6: (Optional) Add additional axes:
1.
Click the Add button
underneath the Axis box.
A dialog box displays asking you whether you want to create an X or Y-axis.
2.
Click the axis you want to create.

An AxisN displays
where
N is the next number up from the last AxisN (unnamed) axis.
Example
If a named axis and an Axis0 exists, then the next axis created will initially display
as Axis1.
3.
8-8
Configure the new axis in the same manner that you configured the primary X and
Y-axes.
GFK-1260F
Step 7: Apply your configuration:

Configuring an XY Plot SmartObject Name and Colors
You can easily enter a title for the XY Plot SmartObject.

You can also specify whether the XY Plot SmartObject should use the CimEdit ambient
colors. If you decide to choose colors for the Plot Control, you can easily do so in the
CIMPLICITY XY Plot Control dialog box.
See the "XY Plot and Background Colors" section in the "Designing an XY Plot" chapter in
this manual.
To name and color an XY Plot SmartObject:
1.
Click the Chart button
at the bottom of the Axis tab.
The Chart tab displays.

2.
Enter a title in the Title field.
3.
Specify whether to use CimEdit ambient colors.

A. (Optional) Check one or more of the Ambient check boxes to use the CimEdit
ambient colors.
B. Choose any non-ambient color when you complete using the XY Plot
SmartObject dialog box and refine your configuration using the CIMPLICITY
XY Plot Control dialog box.
GFK-1260F
8-9
Configuring an XY SmartObject Grid

If your XY Plot Control will benefit by displaying a grid, you can easily configure one in the
XY Plot SmartObject dialog box.
XY SmartObject Chart Dialog Box: Grid Tab
Enter the number of

vertical and horizontal lines
that will display as the grid
Select the grid line

style
Select the width if a

solid line style is
selected
To configure a grid for an XY Plot SmartObject:

1.
Click the Grid button

SmartObject dialog box.
on the bottom of the Chart tab in the XY Plot
The Grid tab of the XY Plot SmartObject dialog

2.
Check the Show Grid check box to display the grid on the XY Plot Control.
3.
Select the Style from the Style drop down menu.
4.
SolidSelect the line width in the Width drop down menu if you choose this
option
Dashed
Dotted (default)
Dash Dotted
Dash Double Dot
Configure the grid's density.

A. Enter the number of vertical ticks (lines) that should display for the XY Plot
Control grid in the Vertical field.
B. Enter the number of horizontal ticks (lines) that should display for the XY Plot
Control grid in the Horizontal field.
5.
8-10
Click the Match Axes button

vertical grid lines.
to display the two horizontal and two
GFK-1260F
XY Plot SmartObject Enhancements

Using the XY Plot SmartObject dialog box, you can create an XY Plot Control that will
display the data you specify during runtime. You may, however, want to modify and enhance
your configuration. You can easily make modifications and enhance your chart without using
scripts. You can either:
1.
Re-open the XY Plot SmartObject dialog box by double clicking the XY Plot
Control, or
2.
Open the .
A. Click the right mouse button over the XY Plot Control.
B. Select CIMPLICITY XY Plot Control Object from the popup menu.
C. Select Properties from the extended menu.
The following example displays two views of the same values.

Each chart was configured first in the XY Plot SmartObject dialog box and then enhanced
through the CIMPLICITY XY Plot Control Properties dialog box.
See the beginning of this chapter for detailed information about the XY Plot SmartObject
dialog box.
See the chapter "Designing an XY Plot" for detailed information about the options available
in the CIMPLICITY XY Plot control Properties dialog box.
GFK-1260F
8-11
XY Plot: Two Views of the Same Data
Plot 1
X and Y-axes: autoscaled
X initial: 0 to 1000000
Y initial: 0 to 1000
Series markers: None
Slider initial position: 75
Series pen: Solid, Standard, black, Width: 25
Plot 2
X-axis: Scrolled
Y-axis: autoscaled
Series markers: Square, navy blue, Width: 75
Series pen: None
Both plots display the same Point ID Values:

Axis Point ID
X
DEV1550
Y
DEV1900
A quick description of how to create each chart can clearly demonstrate how to use the XY
Plot Control dialog boxes in order to quickly achieve the display you want. The examples
were created to help you become familiar with the process. They include only a few of the
many configuration options available to you.
The Point IDs used in the example are connected to a local PLC. You can use any Point ID
that is active in your project.
Following are the steps followed to create:
Plot 1 and
Plot 2.
Configuring an XY Plot 1 Example

The two steps to configure the Plot 1 example are:
Step 1: Configure some Plot 1 basics in the XY Plot SmartObject dialog box.
Step 2: Enhance Plot 1 in the CIMPLICITY XY Plot Control Properties dialog box.
8-12
GFK-1260F
XY Plot: Standard Example
Plot 1
X and Y-axes: autoscaled
Series markers: None
Series pen: Solid, Standard, black, Width: 25
Step 1: Configure Plot 1 basics in the XY Plot SmartObject dialog box:

1.
Place an XY Plot SmartObject on a CimEdit screen.

The Series tab of the XY Plot SmartObject dialog box displays.
2.
Configure a Series.
A. Click Add to add a series to the chart.
B. Name the series. (The example name is DEV1550xDEV1900.)
C. Check Visible.
D. Click the Select a Point button in the X Expression field.
E. Select a Point ID. (The example is \\CIMPDEMO\DEV1550.)
F.
Click the Select a Point button in the Y Expression field.
G. Select a Point ID. (The example is \\CIMPDEMO\DEV1900.)

H. Check On Y expression update.
3.
Click the Axes button.
4.
Configure the X-axis.

A. Check Show X Axis.
B. Name the axis. (The example is DEV1550.)
C. Check Visible.
D. Leave the title blank. (Plot 1 X-axis does not have a title.)
E. Enter the limits:
Lower
F.
5.
Upper
1000000
Check Autoscale for the scaling.
Configure the Y-axis:

A. Check Show Y Axis.
C. Check Visible.
D. Enter a title in the Title field. (The example is DEV1900.)
GFK-1260F
8-13
E. Check Title Visible.

F.
Enter the Limits:

Lower
Upper
1000
G. Check Autoscale for the scaling.
6.
Click the Chart button.
7.
Keep the defaults.
8.
Click the Grid button.
9.
Specify the number of ticks (lines) for the grid:

Vertical
Horizontal
10. Click OK.
4
4
The dialog box closes and an XY Plot Control appears on the CimEdit screen. You can
display Plot 1 in CimView or you can further enhance it.
Step 2: Enhance Plot 1 using the CIMPLICITY XY Plot Control Properties dialog
box:
1.
Click the right mouse button over the XY Plot Control.
2.
Select CIMPLICITY XY Plot Control Object from the popup menu.
3.
Select Properties from the extended menu.
4.
Select Chart Color.
5.
Select the turquoise color from the chart color palette.
6.
Modify the Series.

A. Expand Series.
B. Expand Item
C. Expand Pen.
D. Select Color.
E. Select the navy blue color on the pen color palette.
F.
Select Width.
G. Enter 25.
7.
Modify the Fonts.

A. Modify the Title font.
i.
Expand Title.
ii.
Select Font.
iii. Specify Arial, Bold, 10.

B. Modify the Axes fonts.
i.
Expand X.
ii.
Expand Item
iii. Expand Ticks.
8-14
GFK-1260F
iv. Select Font.

v.
Select Arial, Regular 9 in the Font dialog box.
vi. Expand Y.
vii. Expand Item.
viii. Expand Title.
ix. Select Font.
x.
Select Arial, Bold, 10 in the Font dialog box.
xi. Expand Ticks.

xii. Select Font.
Select Arial, Regular 9 in the Font dialog box.
8.
Click OK.
9.
Test the chart in runtime.
Configuring the Plot 2 Example

The two steps to configure the Chart 2 example are:
Step 1: Configure some Plot 2 basics in the XY Plot SmartObject dialog box.
Step 2: Enhance Plot 2 in the CIMPLICITY XY Plot Control Properties dialog box.
XY Plot Scatter Example
Plot 2
X-axis: Scrolled
Y-axis: autoscaled
Series markers: Square, navy blue, Width: 75
Series pen: None
Step 1: Configure Plot 2 basics in the XY Plot SmartObject dialog box:

1.
Place an XY Plot SmartObject on a CimEdit screen.
2.
Configure a Series.
A. Click Add to add a series to the Plot Control.
B. Name the series. (The example name is DEV1550xDEV1900.)
C. Check Visible.
D. Click the Select a Point button in the X Expression field.
E. Select a Point ID. (The example is \\CIMPDEMO\DEV1550.)
F.
GFK-1260F
Click the Select a Point button in the Y Expression field.
8-15
G. Select a Point ID. (The example is \\CIMPDEMO\DEV1900.)

3.
Check On Y expression update.
4.
Click the Axes button.
5.
Configure the X-axis.

A. Check Show X Axis.
C. Check Visible.
D. Enter DEV1550 in the Title field.
F.
Enter the limits:

Lower
Upper
1000000
H. Check Scrolling for the scaling.
6.
Configure the Y-axis:

A. Check Show Y Axis.
C. Check Visible.
D. Enter a title in the Title field. (The example is DEV1900.)
F.
Enter the limits:

Lower
Upper
1000
G. Check Autoscale for the scaling.
7.
Click the Chart button.
8.
Clear the Title field. (Plot 2 does not have a title.)
9.
Click the Grid button.
10. Make sure the Show Grid check box is clear. (Plot 2 does not display a grid.)
11. Click OK.
The dialog box closes and an XY Plot Control appears on the CimEdit screen.
12. Move Plot 2 underneath Plot 1.
13. Use CimEdits graphics features to align and resize the charts.
See the chapter "Applying Inanimate Visual Features" in the "CIMPLICITY HMI CimEdit
Operation Manual," GFK-1396, for detailed information about aligning and resizing objects
in CimEdit.
You can display Plot 2 in CimView or you can further enhance it.
8-16
GFK-1260F
Step 2: Enhance Plot 2 in the CIMPLICITY XY Plot Control Properties dialog

box:
1.
Click the right mouse button over the XY Plot Control.
2.
Select CIMPLICITY XY Plot Control Object from the popup menu.
3.
Select Properties from the extended menu.
4.
Select Chart Color.
5.
Select the light green color on the Plot color palette.
6.
Modify the Series.

A. Expand Series.
B. Expand Item.
C. Select Type.
D. Select apSeriesScatter.
E. Expand Markers.
F.
Select Type.
G. Select apMarkerSquare.
H. Select Width.
I.
Enter 75.
J.
Expand Pen.
K. Select Color.
L. Select the navy blue on the pen color palette.
7.
Modify the Axes Fonts.

A. Expand X.
B. Expand Item
C. Expand Ticks.
D. Select Font.
E. Select Arial, Regular 9 in the Font dialog box.
F.
Expand Y.
G. Expand Item.
H. Expand Title.
I.
Select Font.
J.
Select Arial, Bold, 10 in the Font dialog box.
K. Expand Ticks.
L. Select Font.
M. Select Arial, Regular 9 in the Font dialog box.
GFK-1260F
8.
Click OK.
9.
Test the Plot Control in runtime.
8-17
Index
A
Action
Invoke method 3-3
Add
A line 3-6
AddLoggedLine Method 3-6
AddLoggedPointLine Method 3-8
AddPointLine Method 3-10
Advanced
Configure chart properties 2-31
Allow Point Scrolling 2-32
Ambient Colors
Used for XY 6-10
apAxisAutoscaled
For an XY Plot axis 6-16
apAxisFixed
apAxisScrolled
apBrushHatch
For an XY series 6-23, 6-38
For an XY series legend 6-36
apBrushSolid
For an XY series legend 6-36
apDirectionBackward
For XY 6-13
apDirectionForward
For XY 6-13
apHatchforwardDiagonal
For an XY series 6-24
apHatchHorizontal
apHatchVertical
apMarkerCircle
For XY Plot series 6-24
apMarkerSquare
GFK-1260F
apmarkerTriangle
apNumberAbsoluteTime
For an XY 6-13
apNumberCompact
For an XY 6-13
apNumberCustom
For an XY 6-13
Specified for an XY 6-14
ApNumberFixed
For an XY 6-13
apNumberInteger
For an XY 6-13
apNumberRelativeTime
For an XY 6-13
apNumberScientific
For an XY 6-13
apOrientationBottom
For XY 6-12
apOrientationLeft
For XY 6-12
apOrientationRight
For XY 6-12
apOrientationTop
For XY 6-12
Appearance
Of lines on a trend chart 2-6
apPenDash
for an XY Plot axis 6-15
For an XY grid line 6-33
For an XY slider 6-29
For XY series line 6-24, 8-5
apPenDashDot
apPenDashDotDot
for an XY Plot axis 6-15
appenSolid
apPenSolid
apSeriesScatter
For an XY 6-23
For an XY Plot 8-5
apSeriesStandard
For an XY 6-23
For an XY Plot 8-5

apSeriesStep
For an XY 6-23
For an XY Plot 8-5
apSliderHorizontal
For an XY 6-29
apSliderVertical
For an XY 6-28
Arguments
Invalid 3-5
Array
Point trends 2-37
Trend a single element 2-37
Trend at a single instant in time 2-37
Array Points
Push values for a series 7-8
Arrays
Scrolling 1-9
Auto Update 6-42
Logged line 2-9
Auto Update Interval 2-29
Autoupdate
A trend line 3-12
Axes
Configure with XY Plot SmartObject 8-6
Configured for an XY series 6-25
Designing for an XY 6-11
Finding the properties for an XY 6-11
Name 6-18
Prioritized on an XY 6-18
Properties on XY 6-11
Title 6-18
Title visible on an XY 6-18
Axis
Mapping to a line 2-19
Properties 2-21
B
Background Color on a Chart 2-29
BackgroundColor
Designing for XY 6-9
Backward
Scroll buttons on an XY 6-16
BackwardScroll
BOOL
Valid range 3-5
Brush
BSTR
Valid range 3-5
Buttons
Backward and forward scroll for an XY 6-16
ii
C
Change Limits
And x-axis timing 2-22
Changing chart properties at run-time 1-5
Chart
Configure advanced properties 2-31
Configure properties 2-29
Properties 2-29
Chart Color 2-29
ChartColor
For XY 6-9
Choose
A font 2-41, 6-8
Color
Ambient for XY 6-10
And 2-7
And quick line configuration 2-6
And the y-axis 2-28
Background on a chart 2-29
Chart 2-29
Create custom 2-38, 6-6
For an XY series line 6-24
Foreground on a Chart 2-29
Modifying 2-40, 6-7
Of gridlines 2-35
Of XY grid line 6-33
Select a basic color 2-38, 6-5
Column ID
And CSV file lines 2-12
Logged line 2-9
Common Time Stamp
Format for CSV lines 2-13
Compression
For a line 2-18
Configure
Basic chart properties 2-29
Begin for axis 2-21
CSV file line 2-12
Detailed x-axis 2-24
Expression line 2-8
Logged expression line 2-10
Logged line 2-9
Reference file 2-15
X-axis timing 2-22
XY Smart Object Plot Control axes 8-6
XY Smart Object Plot Control series 8-3
Y-axis 2-25
Y-axis details 2-27
Configured X Axis
And mapping axes to lines 2-20
Configured Y Axis
And mapping axes to lines 2-20
Content
GFK-1260F
Of XY Title 6-41
Count
Horizontal lines on XY grid 6-34
Vertical lines on XY grid 6-34
Create
A series from the object model 7-1, 7-2
CSV file line 2-12
Expression line 2-8
Logged expression line 2-10
Logged line 2-9
New trend line 2-6
Quick trend line 2-5
Reference file 2-15
CSV File Line 2-12
And Common time stamp format 2-13
And unique time stamp format 2-13
Custom
Color 2-38, 6-6
Runtime actions 2-36

Display
A grid 2-36
A legend 2-34
Gridlines on a chart 2-35
Line style 2-18
Status bar 2-34
Display Format 2-33
Display Height 2-33
Do Setpoint
Checkbox in edit method dialog box 3-5
Double
Valid range 3-5
Duration
Of x-axis time 2-23
Enable
EnableOutstandingLoggedRequestStateEvent trend
method 3-35, 3-36, 3-37, 3-38
Entries
Advanced for invoking a method 3-4
Basic for invoking a method 3-3
Expansion
For a line 2-18
Export Reference File
And reference file line 2-15
Expression
Disable expression line scrolling 2-8
Line 2-8
Line and qualified points 2-8
Logged lines scrolling 2-10
Data
Flow on an XY 6-12
Format type for an XY 6-13
Location on an XY 6-12
Push one or more values 7-5
Setting individual values 7-3
Data Source
For logged line 3-7, 3-9
Datasource
Logged line 2-9
Default Lower Limit 2-26
Default Upper Limit 2-26
Define
A legends properties 2-33
DeleteTrendLine Method 3-11
Density
Of XY grid 6-34
Design
An XY Plot grid 6-32
An XY Plot title 6-41
Axes for an XY 6-11
Legend for an XY 6-35
Series for an XY 6-20
Slider for an XY 6-27
XY Plot overview 6-1
Details
X-axis configuration 2-24
Dialog Box
Edit method overview 3-4
Dialog Box Section
Invoke method 3-3
Disable
Expression line scrolling 2-8
Expression logged line scrolling 2-10
GFK-1260F
Index
F
File ID
Fill
Find
Series properties for an XY 6-20
XY Plot axes properties 6-11
XY Plot Slider properties 6-27
XY Plot title properties 6-40
XY grid properties 6-32
Flow
Data on an XY 6-12
Font
And the x-axis 2-24
And the y-axis 2-27
Choosing 2-41, 6-8
For an XY title 6-41
iii
For the legend 2-33

Foreground Color
For XY 6-9
Foreground color on a chart 2-29
Format
Data for an XY 6-13
Forward
Fully Qualified Points
And expression lines 2-8
And logged expression lines 2-11
G
Graphic Choices 2-38, 6-5
Grid
Density 6-34
Display 2-36
Line 6-33
Properties 2-35
Properties on an XY 6-32
Visible 6-34
Group Log Table 2-9
H
Hatch Style
For an XY slider legend 6-39
HatchStyle
Hide
For a line 2-19
Horizontal
HorizontalCount
Lines on XY grid 6-34
I
Insert
Trend Control chart on a CimEdit Screen 2-1
XY Plot control in a CimEdit Screen 6-2
Inserting the chart object in CimEdit 2-1, 6-2
Integer
For an XY 6-13
Using in edit method dialog box 3-5
Invalid
Arguments 3-5
Invoke Method Action
Creating 3-3
For lines 3-6
Item 7-3
iv
J
Jump Scroll 2-30
Jump to Current Value 2-32
JumpToCurrentTime trend method 3-21
L
Labeled
For the x-axis 2-24
For the y-axis 2-28
Legend
Display the legend 2-34
Display the legend from the status popup 2-34
Properties 2-33
Legend Show All 2-32
Limits
Y-Axis 2-25
Line
Add a logged point line method 3-8
Add a point line method 3-10
Add logged method 3-6
Autoupdating method 3-12
Change the display style 2-18
Create 2-6
CSV file 2-12
Delete method 3-11
Design for an XY Plot axis 6-15
Display dialog box 2-18
Exression 2-8
For an XY grid 6-33
Hide 2-19
Logged 2-9
Logged expression 2-10
Mapping axes to 2-19
Method for deleting 3-11
Methods for 3-6
Reference Line 2-14
Set display 3-13
Using logged and point data 3-8
Width for an XY Plot axis 6-15
LineID
For logged line 3-7
Lines properties, Trend 2-5
List
Trend methods 3-1, 3-2
Location
Of data on an XY 6-12
Logged
Expression line 2-10
Expression line scrolling 2-10
GFK-1260F
Group log table 2-9

Line configuration 2-9
Logged line
Method to add 3-6
Logged Line
Data source 3-7, 3-9
long
Valid range 3-5
M
Map
Axis to line 2-19
Markers
Method
AddLoggedLine 3-6
AddLoggedPointLine 3-8
DeleteTrendLine 3-11
For adding a point line 3-10
SetLineAutoupdate 3-12
Method Result
For deleting a line 3-11
For logged line 3-7
For logged point line 3-9
For point line 3-11
For setting an automatic line update 3-13
Overview 3-5
Mode
Modify
A color 2-40, 6-7
New XY Plot control size 6-3
Multiple
Y-axes displayed 2-31
N
Name
For XY Plot axis 6-18
For XY Plot slider 6-31
Trend control 3-3
New
Trend line 2-6
No Scroll
For the x-axis 2-24
Now Minus Days 2-23
Now Minus Time 2-23
Number
Format for an XY 6-13
Type defined for an XY 6-13
GFK-1260F
Index
Object Model
Create a series 7-1, 7-2
Definition 7-1
ODBC
Data source for logged line 3-7, 3-9
Text driver and reference file name 2-16
Open
Advanced dialog box for chart properties 2-31
Trend chart properties dialog box 2-4
XY Plot Control Properties dialog box 6-4
Order of Priority
Axis on an XY 6-18
Output Argument
In edit method dialog box 3-5
Overview
Configure XY Plot SmartObject 8-3
Designing an XY 6-1
Features for XY Plots 5-2
Plotting XY data 7-1
Trend control axis tab 2-21
Trend control line tab 2-5
Trend methods 3-1
XY Plot SmartObject 8-1
XY Plots 5-1
P
Pages Enabled at Runtime 2-37
Parameter
Passing via a point id 3-5
PauseUpdates trend method 3-23
Pen
Design for an XY Plot axix 6-15
For an XY grid 6-33
Width for an XY Plot axis 6-15
Percent Configured
Y-axis 2-31
Place
Plot XY Data
Overview 7-1
Point
Adding a line for 3-10
Data with logged line 3-8
Set value from 7-12
Valid range for type 3-5
Points
Qualified and expression lines 2-8
Position
Of XY slider 6-29
Prioritize
Axes on an XY 6-18
Priority
Selected y-axis limits options 2-26
Procedure
Adding a point line method 3-10
Basic for invoking a method 3-3, 3-4
Begin axis configuration 2-21
Change the display style of a line 2-18
Configure a logged expression line 2-10
Configure a logged line 2-9
Configure a reference line from a reference file 2-15
Configure an expression line 2-8
Configure basic chart properties 2-29
Configure CSV file line 2-12
Configure x-axis details 2-24
Configure y-axis limits 2-25
Create a custom color 2-38, 6-6
Detailed y-axis configuration 2-27
Disable expression line scrolling 2-8
Disable expression logged line scrolling 2-10
Display gridlines on a chart 2-35
Enable/disable properties dialog box tabs
for runtime 2-36
For adding a logged line method 3-6
For adding a logged point line method 3-8
For automatically updating a line method 3-12
For deleting a line method 3-11
Insert an XY Plot control in a CimEdit Screen 6-2
Insert aTrend Control chart on a CimEdit Screen 2-1
Modify a color 2-40, 6-7
Open advanced dialog box for chart properties 2-31
Quickly create a line 2-5
Resize a new XY Plot control 6-3
Select a basic color 2-38, 6-5
Specify a font for a trending text item 2-41
Specify a font for an XY Chart text item 6-8
Specify how lines appear on a trend chart 2-6
specify what axis will explain a trend line 2-19
Trend a single element in an array 2-37
Trend an entire array at a single instant in time 2-37
Properties
Configure advanced for a chart 2-31
Configured for a chart 2-29
Finding for an XY Plot series 6-20
Finding for an XY Plot slider 6-27
Finding for an XY grid 6-32
Finding for XY Plot axes 6-11
For a charts legend 2-33
For a grid 2-35
Grid on an XY 6-32
Of XY Plot title 6-40
Slider on XY 6-27
That identify an XY series 6-22, 6-27
XY axes on XY 6-11
vi
Push
One or more data values 7-5
Values from Points 7-8
Q
Qualified
Points and expression lines 2-8
Points and logged expression lines 2-11
Quick Lines
Creating 2-5
R
Ranges
Valid for each point types parameters 3-5
Reference File 2-15
Example 2-17
Reference Line 2-14
Relative Time
ResetZoom trend method 3-33
Resize
New Trend Control chart 2-2
New XY Plot control 6-3
Series vectors 7-3
Restrictions
Reference file name 2-16
Restrrictions
On SetLineAutoupdate method 3-12
Runtime Actions
And a reference file line 2-15
RuntimeActions
Enable or disable 2-36
S
Scatter
Series for an XY Plot 8-5
Scroll
Buttons for an XY 6-16
Expression logged lines diaabled 2-10
Scroll Buttons
Visible on an XY 6-16
Scrolling 1-8
Disable for expression line 2-8
Disable for logged expression line 2-10
Disable for the x-axis 2-24
Scrolling behavior
Arrays 1-9
ScrollLines trend method 3-24
Select
A basic color 2-38, 6-5
GFK-1260F
Series
Axes 6-25
Configure with XY Plot SmartObject 8-3
Create data values 7-1
Design legend for 6-35
Fill on an XY 6-23
Finding properties for an XY 6-20
Identifying properties 6-22, 6-27
Markers 6-24
On an XY 6-20
Push one or more data values 7-5
Push value from point 7-8
Resize vectors 7-3
Type for an XY 6-23
Set
One or more data values 7-9
Values from points 7-12
SetGridState trend method 3-33
SetLegendState trend method 3-20
SetLineAutoupdate Method 3-12
SetLineAutoupdate trend method 3-12
SetLineDisplay Method 3-13
SetLineUseChartY trend method 3-31
SetLineVisible trend method 3-17
SetLineYAxis trend mehtod 3-28
Setpoint
Do setpoint in edit method dialog box 3-5
SetXDuration trend mehtod 3-25
SetXStartTime trend method 3-26
SetYAxisVisible trend method 3-30
Short
Valid range 3-5
Show Legend 2-33
Show Most Recent 2-23
Show Property Pages at Runtime 2-37
And a reference file line 2-15
Show Title 2-33
Single
Y-axis displayed 2-31
Single Element
Trended 2-37
Single Time Duration 2-32
Single X Axis 2-32
Single Y Axis 2-32
Size
Changing for a new XY Plot control 6-3
Slider
Design legends for 6-35
Line 6-29
Name 6-31
Position and visibility 6-29
Properties for an XY 6-27
GFK-1260F
Index
Type 6-28
Slider Grab Margin 2-32
SmartObject Plot Control
Configuring example 1 8-12
Configuring example 2 8-15
Smooth
For a line 2-19
Standard
Start Date
Start Time 2-23
Status
Display the status bar 2-34
Status Line 2-33
Step
For a line 2-19
Strip Chart 2-30
Style
Change for a line 2-18
Of gridlines 2-35
Of line for an XY Plot axis 6-15
Of XY grid line 6-33
Of XY series hatch fill 6-24, 6-36
Of XY series line 6-24
Of XY slider legend hatch fill 6-39
Specify for font 2-41, 6-8
T
Tab
Legend 2-33
Trend control axis 2-21
Trend control line 2-5
Table ID
Logged line 2-9
Text
Choose a font 2-41, 6-8
Ticks
For the x-axis 2-24
For the y-axis 2-28
On an XY Plot axis 6-15
Time Stamp
Common format for CSV lines 2-13
Unique format for CSV lines 2-13
Timing
Configure for x-axis 2-22
vii
Title
Content 6-41
Finding XY Plot title properties 6-40
Font 6-41
For XY Plot axis 6-18
Properties on XY 6-40
Visible 6-42
Trend charts
Inserting in CimEdit 2-1, 6-2
Trend Control
Naming 3-3
Trend Line
Add a logged point line method 3-8
Add logged line method 3-6
Add point line 3-10
Autoupdating method 3-12
Delete 3-11
Set Display 3-13
Trend Method
Create invoke method action 3-3
Overview 3-1
Trend methods
EnableOutstandingLoggedRequestStateEvent method
3-35, 3-36, 3-37, 3-38
JumpToCurrentTime method 3-21
PauseUpdates method 3-23
ResetZoom method 3-33
ScrollLines method 3-24
SetGridState method 3-33
SetLegendState method 3-20
SetLineAutoupdate 3-12
SetLineUseChartY method 3-31
SetLineVisible 3-17
SetLineYAxis method 3-28
SetXDuration method 3-25
SetXStartTime 3-26
SetYAxisVisible 3-30
WriteReferenceFile method 3-18
Trend properties
Lines 2-5
Trending
Run-time actions, Changing chart properties at runtime 1-5
Run-time actions, Scrolling 1-8
Run-time actions, Zooming 1-6
Scrolling behavior, Arrays 1-9
Type
Of Series for an XY 6-23
Of XY Plot slider 6-28
Unique Time STamp

Format for CSV lines 2-13
Update
Auto 6-42
Use
Use Fixed Lines
For a grid 2-35
Use Ticks from Axis
For a grid 2-35
UseAmbientBackgroundColor
For XY 6-10
UseAmbientChartColor
For XY 6-10
UseAmbientForegroundColor
For XY 6-10
V
Valid
Ranges for each point type 3-5
Value
Of XY title 6-41
Push for data 7-5
Push from points 7-8
Set from point 7-12
Setting for individual data 7-3
Vectors
Resize for series 7-3
Vertical
VerticalCount
Lines on XY grid 6-34
Visible
And the x-axis 2-24
Axis title on an XY 6-18
Grid on XY 6-34
Markers for XY series 6-24
XY series in legend 6-22, 6-27
XY title 6-42
W
Width
Change for a line 2-18
For XY series line 6-25
For XY series markers 6-24
Of an XY grid line 6-33
Of gridlines 2-35
Of line for an XY Plot axis 6-15
Of XY slider 6-29
WriteReferenceFile trend method 3-18
Unique Time Stamp

viii
GFK-1260F
X
X-axis
X-Axis
Configure timing 2-22
Detailed Configuration 2-24
XY Plot SmartObject
Configuring overview 8-3
Overview 8-1
Placing 8-2
XY Plots
Overview 5-1
Overview of features 5-2
Y
Y-axis
Y-Axis
Configuration 2-25
Configure limits 2-25
Detailed configuration 2-27
Display multiple 2-31
Display single 2-31
Percent configured 2-31
Priority of limits types 2-26
Z
Zooming 1-6
GFK-1260F
Index
ix

Gfk1260f - Cimplicity Hmi Trend and Xy Chart

Uploaded by

Copyright:

Available Formats

Gfk1260f - Cimplicity Hmi Trend and Xy Chart

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Gfk1260f - Cimplicity Hmi Trend and Xy Chart

Uploaded by

Copyright:

Available Formats

GE Fanuc Automation

CIMPLICITY Monitoring and Control Products

CIMPLICITY is a registered trademark of GE Fanuc Automation North America, Inc.

This manual was produced using Doc-To-Help, by WexTech Systems, Inc.

Copyright 1995-1998 GE Fanuc Automation North America, Inc.

Contents of this Manual

Trend Introduction ................................................................................................................. 1-1

Configuring A Trend Chart

About Trend Charts................................................................................................................ 2-1

About Trend Methods ............................................................................................................ 3-1

Creating a Quick Trend

About Quick Trends ............................................................................................................... 4-1

About XY Plots ...................................................................................................................... 5-1

CIMPLICITY HMI Trending and XY Chart Operation ManualApril 1999

About XY Plot Design ........................................................................................................... 6-1

About Plotting XY Data......................................................................................................... 7-1

Using XY Plot SmartObjects

About XY Plot SmartObjects ................................................................................................. 8-1

XY Plot SmartObject Enhancements.................................................................................... 8-11

CIMPLICITY HMI Trending and XY Chart Operation ManualApril 1999

Display trends with:

Trend Chart Display

Create a trend chart that displays:

Display status bar

Display sparse detail

CIMPLICITY HMI Trend and XY Chart Operation ManualApril 1999

You can choose to display or hide:

Choose to Display or Hide

Ticks and numbers

For the Y-axis

Other Configuration Options

Choose the color

Choose the color

The number of horizontal and /or vertical lines

Percent scroll buttons

Specify to display or hide them

Choose font, style and size

CIMPLICITY HMI Trend and XY Chart Operation ManualApril 1999

Magnify (Zoom into) a specific area of the trend chart

Changing Chart Properties at Runtime

Zooming into a Specific Area

Place the mouse cursor in the chart area.

CIMPLICITY HMI Trend and XY Chart Operation ManualApril 1999

Analyzing Data at a Selected Point in Time

when you are in position.) and drag the slider to

Drag the slider to a new position

Scrolling Lines Forward and Backward

To scroll a percent of the visible chart:

buttons to move the line back or forward a specified percent.

Non-array Data Scrolling

You will see:

Point data from the current time:

Only runtime data that has been accumulated up

Into the future

No data because it has not been received yet.

Logged point data:

Runtime data that has been accumulated up to

Into the future

No data because it has not been received yet.

Logged or CSV data