Professional Documents
Culture Documents
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 provides information when careful attention must be taken in order to avoid
damaging results.
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,
nor 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.
Related Publications
For more information, refer to these publications:
CIMPLICITY HMI Plant Edition Base System User's Manual (GFK-1180)
GFK-1260H iii
Contents
Introducing Trends 1-1
Trend Introduction ................................................................................................................. 1-1
About Trends.......................................................................................................................... 1-1
Trend Chart Display............................................................................................................... 1-2
Runtime Action Options......................................................................................................... 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
GFK-1260H Contents-v
Configuring Trend Methods 3-1
About Trend Methods ............................................................................................................ 3-1
Method Configuration ............................................................................................................ 3-4
Step1. Name a Trend Control................................................................................... 3-4
Step 2. Create an Invoke Method Action ................................................................. 3-4
Line Display Methods ............................................................................................................ 3-8
AddDynPointLine Method ....................................................................................... 3-8
AddExpressionLine Method .................................................................................. 3-10
AddLoggedLine Method ........................................................................................ 3-11
AddLoggedExpressionLine Method ...................................................................... 3-13
DeleteTrendLine Method ....................................................................................... 3-15
SetLineAutoupdate................................................................................................. 3-16
SetLineCompression Method ................................................................................. 3-18
SetLineDisplay Method.......................................................................................... 3-20
SetLineVisible Method .......................................................................................... 3-24
WriteReferenceFile Method................................................................................... 3-26
Legend Methods ................................................................................................................... 3-28
SetLegendState Method ......................................................................................... 3-28
Axis Methods ....................................................................................................................... 3-30
SetAxisTicks Method............................................................................................. 3-30
X-axis (Time Related) Methods ........................................................................................... 3-31
JumpToCurrentTime Method................................................................................. 3-31
PauseUpdates Method............................................................................................ 3-33
ScrollLines Method................................................................................................ 3-34
SetXDuration Method ............................................................................................ 3-35
SetXStartTime Method .......................................................................................... 3-37
Y-axis Methods .................................................................................................................... 3-39
SetAxisLabel Method............................................................................................. 3-39
SetLineYAxis Method............................................................................................ 3-40
SetYAxisVisible Method ....................................................................................... 3-42
SetLineUseChartY Method .................................................................................... 3-44
Visual Aid Methods.............................................................................................................. 3-46
ResetZoom Method................................................................................................ 3-46
SetGridState Method.............................................................................................. 3-47
Wait State Methods and Events............................................................................................ 3-48
EnableOutstandingLoggedRequestStateEvent Method .......................................... 3-49
DisableOutstandingLoggedRequestStateEvent Method......................................... 3-50
EnteringOutstandingLoggedRequestState Event.................................................... 3-51
LeavingOutstandingLoggedRequestState Event .................................................... 3-52
Using Wait State Functionality Example ............................................................... 3-52
Other Trend Methods ........................................................................................................... 3-61
AboutBox Method.................................................................................................. 3-61
ForceRedraw Method............................................................................................. 3-61
SetCimplicityProject Method................................................................................. 3-62
Index-vi CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Introducing XY Plots 5-1
About XY Plots ...................................................................................................................... 5-1
Index i
Index-viii CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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 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:
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.
GFK-1260H 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
Step
or
smooth curve
Line
style / color
X-axis ticks /
numbersOptional
Page scrollOptional
Legend titleOptional
Slider
1-2 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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
Status bar Entire status bar
Status bar features Specific features:
Status line
Current date
Current time
Status title
Slider date
Slider time
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
Percent scroll buttons Specify the percent a line will scroll (forward /
backward) when the buttons are pressed
Page scroll buttons Specify to display or hide them
Fonts 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
1-4 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Runtime Action Options
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
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.
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.
1-6 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Scrolling Options
Use the buttons to scroll backward or forward one page on the 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)
1-8 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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. 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. 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 it's X-axis with another line, the axis labels displayed are based on
the time span.
4. 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 No data because it has not been received yet.
Logged point arrays
Current Available array values that are closest to the
new 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 No data because it has not been received yet.
Logged array data:
Current Available array values that are closest to the
new 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.
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:
Page
(This chapter)
Line Displays the associated point or expression 6
data.
Axis Defines the X and Y axes on the Trend. 27
Chart Defines the chart characteristics of the Trend 37
Legend Defines the chart legend for the Trend. 42
Grid Defines the grid display for the Trend. 44
Runtime Actions Let you perform runtime actions when viewing 46
the chart.
GFK-1260H 2-1
3. Click the left mouse button.
The Insert Object dialog box opens.
4. Select the ActiveX tab.
5. Select CIMPLICITY Trend Control.
CIMPLICITY
Trend Control
6. Click OK.
Result: A new Trend control is placed at the position you selected in your CimEdit
screen when you use either method.
The Trend control looks like this initially:
2-2 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Resizing a New Trend Control Chart
You can resize a trend control chart quickly and /or precisely.
Method 1Quick
1. Grab one of the objects handles and move it.
Increase width
Increase in
proportion
Increase height
Method 2Precision
1. Click Edit on the menu bar.
2. Select Properties.
Go to "Continue (after choosing from Methods 2-4)."
Method 3-Precision
Tip: Click the right mouse button in any area of the Trend control to display a popup
menu that is related to that area.
2-4 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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:
Page
(This chapter)
Line Displays the associated point or expression data. 6
Axis Defines the X and Y axes on the Trend. 27
Chart Defines the chart characteristics of the Trend 37
Legend Defines the chart legend for the Trend. 42
Grid Defines the grid display for the Trend. 44
Runtime Actions Let you perform runtime actions when viewing 46
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.
Result: The CIMPLICITY Trend Control Properties dialog box opens when you use
any method.
Note: Any fields that do not apply to the Trend you are defining will be dimmed.
Note: Engineering units only apply to Expression lines that contain one Point ID.
2-6 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
3. Click the Quick Lines button . The Select a Point dialog box opens.
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.
Lines Grid.
Color palette.
Line Display
dialog box.
Line Types
Point
(Expression)
Logged
Logged Point
Fields change
(Expression)
based on Line
.CSV
type selection.
Reference
Creates blank
entry for new
line.
Move line up /
Copies down in list.
selected line
configuration. Line - Axis Mapping
Quick Lines dialog box.
Deletes line.
Opens Select a Point
Browser.
2-8 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
7. Specify line characteristics in the Lines grid.
A. Select a color. Either:
Click the Color Palette button on the line's row in the Color column
(the color Palette opens.) or,
Double-click a unique line color.
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.
B. Click the Copy button to copy the selected line. You can then modify
the entry. This is particularly useful if you want to display variations in an
expression.
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.
Note: Using a logged expression line is preferable if you want the data to come from a
data source that you choose, rather than the source chosen by the above order.
Browse
dialog box
Point menu
Enter a Point ID.
2-10 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Edit
Expression
Expression
Enter one or more Point IDs and mathematical menu
operators that can be evaluated.
2. Enter, in the Expression field, one or more Point IDs and mathematical
operators that can be evaluated.
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.
Important: Logging array points to Data log tables is currently not supported. As a
result, trending array points from data log tables is not supported. Use group tables for
array points.
Select a Table/Column
ODBC Data Administrator
dialog box
2. Select the ODBC data source from the Datasource drop down menu.
3. Open the Table/Point ID 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 Specify auto update.
Clear Keep the same historical information as a
reference.
Logged lines can always be scrolled. If you uncheck Auto update, 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 Base System User's
Manual (GFK-1180) for more information.
2-12 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Configuring a Logged Expression Line
Lines using logged and runtime data first display a combination of logged and runtime
data.
Runtime data is reported by CIMPLICITY Point Management.
Logged data comes from a CIMPLICITY Log table.
Important: Logging array points to Data log tables is currently not supported. As a
result, trending array points from data log tables is not supported. Use group tables for
array points.
Select a Table/Column
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.
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 Base System
User's Manual (GFK-1180) for more information
2-14 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
2-16 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
B
Name of .REF file Select a File
containing the data dialog box
Column in group log table Table/Column
browser
Important: Reference files are currently available only on the Intel Windows NT
platforms.
Check to make
the dialog box
available
Check to enable
Runtime action
tab during
runtime
Export to
reference file...
enabled during
runtime
2. Make sure the Show property pages at runtime and Runtime actions check
boxes are checked.
2-18 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. During runtime:
A. Double-click the Trend chart.
The CIMPLICITY Trend Control Properties dialog box opens.
B. Select the Runtime Actions tab.
C. Click Export reference file
The Save Reference File dialog box displays.
3 4
D. Click each line in the Lines to Save box that you want to write to the
reference file.
E. Browse for the folder where you want to save the reference file in the Save
in box.
F. Enter the File name.
F. Click Save to write the reference file, or click Cancel to cancel your
request. When you click Save, 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-20 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Specifying Line Display Features
When you configure the line display, you can choose:
The line style and
Data compression.
Steprecommended
for runtime lines
2
Smooth
Option 1. Select compression for a line type that does not have historical
data:
1. (If the Line Display dialog box is not open) Open the Line Display dialog box.
A. Select a line in the Lines grid.
B. Click Display.
The Line Display dialog box opens.
2. Select a compression type in the Compression field to display one of the
following plotted values.
Compression Type Plotted Value
None Multiple data points along a vertical line.
Average The average of the values within the automatically
determined group size.
First First value in the group
Last Last value in the group
Minimum Minimum value in the group
Maximum Maximum value in the group
Line Display Dialog Box: Server Side Compression Selected
Average
1 First
Last
Minimum
Maximum
2
2-22 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Option 2. Compression for Lines that have Historical Data
If you select compression for a logged line type you have the option to reduce overhead
by collecting only the representative data from the Database Logger. This is done because
the Database Logger, instead of Trending, determines the value from your criteria and
sends only the representative values to Trending.
1 Average
First
Last
Minimum
Maximum
2-24 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Note: The time interval begin time is based on the X-axis pre-set start date and time.
Example
Your X-axis start time is set to begin at 10:15AM (5-25-02)
You have specified 5 minutes as the length of each interval.
The first interval:
Start time=10:15AM (5-25-02)
The second interval:
Start time = 10:20AM (5-25-02)
See page 2-27 for details about setting the X-axis start time and date.
Note: Y Chart Axis and X Chart Axis are the default axes.
2-26 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Color palette
Label for
selected axis
Fields change
between X-axis
and Y-axis
Ticks for
Creates selected axis
blank entry
for new axis
Fields change
based on
selection
X-axis Popup
2-28 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Go to "Continue (following Method 1 or 2)".
Continue (following Method 1 or Method 2)
1. 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
2. Configure the Start time from the following choices:
Example: X Axis Timing Options ddd:hh:mm:ss Clear to allow
(Before Apply is Clicked) runtime scroll
ddd= 0 -365
hh = 0 - 23
mm = 0 - 59
ss = 0 - 59 mm/dd/yy
hh:mm:ss
hh:mm:ss ddd
ddd= 0 -365
hh = 0 - 23
mm = 0 - 59 mm/dd/yyyy
ss = 0 - 59
hh:mm:ss
hh:mm:ss ddd
Note: If you configure rapid trend retrieval (data compression), Trending uses the start
time based on these specifications as the trend interval start time. If you specify a relative
time, the start time is based on the time you start the Trend chart.
See page 2-23 for details about rapid trend retrieval.
2-30 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Detailed X-axis Configuration
The several X-axis features, in addition to the time it represents, can be configured in the
CIMPLICITY Trend Control Properties dialog box.
Color palette
Label for
selected axis
Fields change
between X-axis
and Y-axis
Ticks for
Creates selected axis
blank entry
for new axis
2. (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.
Click the Color Palette button , on the lines row in the Color
column. The Color Palette opens.
Double click a unique line color.
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.
3 1
Y-axis Popup
2-32 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. Select Limits.
A Y-Axis Limits dialog box appears.
Go to "Continue (following Method 1 or 2)".
Example. Y-axis Configuration from Popup Menu
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.
2-34 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Detailed Y-axis Configuration
The several Y-axis features, in addition to the time it represents, can be configured in the
CIMPLICITY Trend Control Properties dialog box.
Color palette
Label for
selected axis
Fields change
between X-axis
and Y-axis
Ticks for
Creates selected axis
blank entry
for new axis
2. (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 axis characteristics in the Configured axis grid.
A. Select a color.
i. Click the Color Palette button , on the lines row in the Color
column. The Color Palette opens.
ii. Double click a unique line color.
iii. (Optional) Check Visible to make the Y-axis visible.
A. Click the New button to enter completely new information for another
axis.
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-36 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Chart Properties
There are several details about the chart itself. Details range from the chart's color to how
many pixels away a cursor can be from the slider and still grab it.
These details are configured on the:
Chart tab of the CIMPLICITY Trend Control Properties dialog box and
Advanced tab that is accessed through the Chart tab.
Interval for:
Chart update
Project used for
unqualified points, Chart redrawn
can be changed at (hh:mm:ss)
runtime.
Display scroll
buttons
If checked, lines:
1. Draw left to right
2. Update across the
chart area. If checked, lines:
3. Scroll when the 1. Update at the right
right edge is edge
reached 2. Scroll each time an
4. Continue update update is received
from left to right.
Advanced
dialog box
3. Click each color fields Palette button to configure the charts colors:
Field Selects color for the:
Foreground color Slider, legend and chart X and Y-axes
Default Color: CimEdit ambient Fore color.
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 in the
Base project field. The default is provided by CimView, but it may be changed
at run-time.
Trending goes step-by-step, in the following order of priority, to find the project
that contains the unqualified points. The step that proves positive is the one
Trending uses to determine the project name. Each step applies to both Server
and Viewer, unless otherwise noted:
Priority Project is used to fully qualify any Unqualified Point IDs when
A. In CimView, an Open screen or Overlay screen action specifies a
project. When a user opens the screen that contains the Trend chart
using one of these actions, the project specified in the action is used.
B. A command line is used to open the CimView screen that contains the
Trend chart and the /project option is used, that project is used.
C. The screen that contains the Trend chart is in a project directory, that
project is used.
D. The project name in the Trend chart property page is not blank, that
project is used.
E. You are on a Server and a single project is currently running, that
project is used.
F. You are on a Server and multiple projects are running, the project that
was started first is used. However, you can modify this behavior using
the PROJECT_ID global parameter.
G. You are on a Viewer, and none of the above conditions are positive,
unqualified Point IDs are unavailable.
7. (Optional) Check Show buttons to display the scroll buttons.
2-38 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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. (Optional) Continue configuration in the Advanced Properties dialog box.
2-40 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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. This option in combination with Allow Runtime Scrolling affects logged
expression behavior. See "Logged Expression Lines and Scrolling
Configuration" on page 2-14 in this manual for more information about how
logged expressions behave.
11. Check the Allow Runtime Scrolling check box to scroll Expression and
Logged Expression lines in the chart at run-time.
Clear the Allow Runtime Scrolling checkbox to prevent Expression and
Logged Expression lines from scrolling. This option in combination with
JumpToCurrentTime affects logged expression behavior. See "Logged
Expression Lines and Scrolling Configuration" on page 2-14 in this manual for
more information about how logged expressions behave.
12. Check Enable logged data request outstanding state events to enable a
wait state event.
A. Outstanding state longer than N secondsis the wait time, in seconds,
at which a request for logged data is considered outstanding.
B. Refresh state every N secondsis 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.
See "Wait State Methods and Events" in the Configuring Trend Methods
chapter in this manual for details about wait state methods.
Check to
Display
Legend. Single column
Two columns
Number of
legend lines.
Check to
show status
line.
Check to
display for
each line on Check to
the chart. display in
status line.
Move item up /
down in list.
Open Font
dialog box.
3. (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 buttons to create the order in which you want the items
displayed.
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
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.
2-42 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
10. Click Font to select the font, font style, size and script for the legend and status
bar.
Method 2Popup Menu in the Legend area
1. Place the cursor over the legend area.
2. Click the right mouse button. A popup menu appears.
Choose a
solid line.
Specify the
Check to width
display grid.
Choose a non-
solid line.
The width is
fixed.
Enter the
number of grid
lines.
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. 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-44 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Method 2Popup menu in chart area (CimEdit or CimView)
1. Place the cursor anywhere in the chart area.
2. Click the right mouse button.
3. Select Show/Hide. An extended menu displays.
4. Select Grid.
Chart Popup: Grid Selected
Lines tab is
enabled.
Axis tab is
Disabled.
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.
2-46 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Basic Palette
2-48 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Creating a Custom Color
CIMPLICITY HMI lets you create as many custom colors as you want; 16 custom colors
at any one time.
Color picker
Luminosity picker
3. 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.
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. Click the Palette button to the right of the Color field.
2. Select a color in the customized color section.
3. Click the right mouse button.
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-50 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Choosing a Font
Whenever you have to specify a font and its characteristics in Trending, you can do so in
a basic Windows 98/NT Font dialog box.
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.
GFK-1260H 3-1
Invoke method
Method Page
On the CimView Trend Chart, to: (This chapter)
Line
AddDynPointLine Add a specified point line 8
AddExpressionLine Add a specified expression line 10
AddLoggedLine Add a specified logged line 11
AddLoggedExpressionLine Add a specified logged expression line 13
DeleteTrendLine Delete a specified line 15
SetLineAutoupdate Change the auto-update status of one or all non- 16
runtime lines
SetLineCompression Set the compression specifications for a particular 18
Line ID.
SetLineDisplay Set the color, compression and expansion of a 20
given line.
SetLineVisible Toggle the line visibility in both the chart and 24
legend for one or all lines.
WriteReferenceFile 26
Legend
SetLegendState Make the legend visible/invisible 28
Axis (X or Y)
SetAxisTicks Display ticks and tick labels on either an X or Y- 30
axis.
X-axis (Time Related)
JumpToCurrentTime Set the chart time to the current time. 31
PauseUpdates Pause or resume updates 33
ScrollLines Scroll the chart by the given percentage 34
SetXDuration Change the X-axis duration. 35
SetXStartTime Change the Chart X-axis for one or all lines. 37
3-2 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Invoke method Page
Method On the CimView Trend Chart, to: (This chapter)
Y-axis
SetAxisLabel Display a label for a selected Y-axis. 39
SetLineYAxis Change the Y-axis settings. 40
SetYAxisVisible Change the visibility of one or all Y axes 42
SetLineUseChartY Toggle the use of the Chart Y-axis for a line. 44
Visual Aids
ResetZoom Reset zoom in the Trend Control to 100%. 46
SetGridState Change the grid visibility for the Trend Control. 47
Wait State
EnableOutstandingLoggedRequestState Enables the firing of logged data 49
wait state events in the Trend
control.
DisableOutstandingLoggedRequestState Disables or turns off the firing of 50
logged data request wait state
events in the Trend control.
Other
AboutBox Display the Help About dialog box for the 61
CIMPLICITY Trend Control.
ForceRedraw Redraws the chart to display the current values. 61
SetCimplicityProject Set the CIMPLICITY project for the Trend Control. 62
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 Trend control has determined that it 51
has logged data requests that have
been outstanding (waiting) for
longer than the number of seconds
determined by the threshold.
LeavingOutstandingLoggedRequestState Trend control has determined that it 52
no longer has any logged data
requests that are outstanding.
3-4 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Step 2. Create an Invoke Method Action
Task 1. (All Methods) do Basic Configuration
The procedure to get to the Invoke method action is the same as any other action.
B
C
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.
1 1
2 2
1 Point to trend.
Value entry is required. 2 Identifies line, in legend.
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)
3-6 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. (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.
4. Click OK to save your changes and return to the Actions tab.
5. Click OK to save the procedure information and return to the Events tab.
6. 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:
AddDynPointLine Method
Purpose: To easily add a point's available logged and ongoing current data to the runtime Trend
Control without having to specify the data source. The addition occurs when the method
is triggered by an event or through a script.
Lines using automatically found 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, which CIMPLICITY finds when the method is triggered.
The order in which CIMPLICITY looks for logged data is as follows:
1. A CIMPLICITY data table.
2. The first data table in alphabetical order.
3. A CIMPLICITY group table.
4. The first group table in alphabetical order.
If the point is not being logged to either a data or group table, the trend line
displays as current data becomes available.
The behavior of the logged point line type depends on the Allow Runtime
Scrolling property
3-8 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
To configure the AddDynPointLine method.
1. Select AddDynPointLine Method for the Invoke method Action type.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying AddDynPointLine.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
1 11
2 22
1 Point to trend.
Value entry is required. 2 Identifies line, in legend.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying AddExpressionLine.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
1 1
2 2
1 Expression to trend.
Value entry is required. 2 Identifies line, in legend.
3-10 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
4. (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.
Result: When you invoke the method, the optional Method result contains one
of the following values.
Value Method Result
1 The line was successfully added to the trend.
0 The line was not added to the trend.
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 or data table. This type of trend is also called a historical trend because all
the information comes from logged data.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
he Edit Method dialog box opens displaying AddLoggedLine.
1 1
2 2
Note: The source for a Logged line is data from any point logging table. For more
information about point logging tables, see Using the Database Logger in the
CIMPLICITY HMI Base System User's Manual (GFK-1180).
3-12 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
AddLoggedExpressionLine 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 runtime 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
1 1
2 2
3 3
Note: The source for a Logged line can be a point from any point logging table. For
more information about point logging tables, see "Using the Database Logger" in the
"CIMPLICITY HMI for Base System User's Manual" (GFK-1180).
3-14 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
DeleteTrendLine Method
Purpose: To delete a specified point line from the runtime Trend Control when Invoke Method
is triggered by an event.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying DeleteTrendLine.
(Optional) A setpoint that contains the status
valuedevice or global Point IDAnalog point
3. Enter a string that evaluates to an existing Line ID. Trending will delete the
specified line when the method is invoked.
4. (Optional) Enter a Method result. Use a Point ID in the Analog Point Class.
You can use a device or global Point ID.
Result: 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
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetLineAutoupdate.
(Optional) A setpoint containing the status
valuedevice or global Analog point
1 1
2 2
1 Identifies line, in legend.
Value entry is required.
2 0 Update off
1 Update on
3-16 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
B. An expression or Point ID for nOffOnToggle that evaluates to the numeric
value:
Value Trending will:
0 Turn off selected line(s) autoupdate
1 Make selected line(s) start autoupdating
2 Toggle the current state of the line(s)
4. (Optional) Enter a Method result. Use a Point ID in the Analog Point Class.
You can use a device or global Point ID.
When you invoke the method, the Method result display contains the count of
the number of lines that were changed.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetLineCompression.
(Optional) A setpoint containing the status
valuedevice or global Boolean point
1 1
2 2
3 3
4 4
1 Identifies line, in legend.
Value entry is required.
2 0None
1Average
2First point 4 0Seconds
1Minutes
3Last point
2Hours
4Minimum point
5Maximum point
6Average of historical group
7First point-historical group
8Last point-historical group
9Smallest value-historical group
10Largest value-historical group
3 Units for each historical group
3-18 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. Enter the following:
A. A string that identifies the Line ID whose display parameters you want to
change.
B. An expression or Point ID for NoneAvgFirstLastMinMax that evaluates to
one of the following numeric values:
Value Trending will:
0 Not do any compression
1 Plot the average of the values in the group
2 Plot the first data point in the group
3 Plot the last data point in the group
4 Plot the data point from the group with the smallest
value
5 Plot the data point from the group with the largest
value
If you are using compression, Trending automatically
determines the group size.
6 Plot the average of the values in the group, using
server side compression.
7 Plot the first data point in the group, using server side
compression.
8 Plot the last data point in the group, using server side
compression.
9 Plot the data point from the group with the smallest
value, using server side compression.
10 Plot the data point from the group with the largest
value, using server side compression.
C. Enter the number of time units that should be used for each group of data.
D. Enter the unit of time to be used as follows:
Enter For
0 Seconds
1 Minutes
2 Hours
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetLineDisplay.
(Optional) A setpoint containing the status
valuedevice or global Boolean point
1 1
2 2
3 3
4 4
Identifies line, in
1
Value entry is required. legend.
2 RGB Color Values
3 0None 4 0Step mode
1Average 1Smooth mode
2First point
Note: Use 610 with Server Side compression. 3Last point
4Minimum point
5Maximum point
6Average of historical group
7First point-historical group
8Last point-historical group
9Smallest value-historical group
10Largest value-historical group
3-20 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Value Trending will:
0 Not do any compression
1 Plot the average of the values in the group
2 Plot the first data point in the group
3 Plot the last data point in the group
4 Plot the data point from the group with the smallest
value
5 Plot the data point from the group with the largest
value
If you are using compression, Trending automatically
determines the group size.
6 Plot the average of the values in the group, using
server side compression.
7 Plot the first data point in the group, using server side
compression.
8 Plot the last data point in the group, using server side
compression.
9 Plot the data point from the group with the smallest
value, using server side compression.
10 Plot the data point from the group with the largest
value, using server side compression.
Note: If you enter an option from 6 through 10, this field performs the
same as the Type field in SetLineCompression.Specify the time
interval to collect the historical group size either in a
SetLineCompression method or in the Trend control's Line Display
dialog box. See the "Configuring the Trend Control" chapter for details
about the Line Display dialog box.
D. An expression or Point ID for StepSmooth that evaluates to one of the
following numeric values:
Value Trending will:
0 Display the line in step mode
1 Display the line in smooth mode
4. (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.
Result: When you invoke the method, the optional Method result contains one
of the following values:
Value Method Result
1 The change was successfully made.
0 The change was not made.
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.
Example: Customized Color Palette Providing Luminosity for RGB Calculation
(255) +
(105 * 256) +
(255 * 65536) = 16738815
3-22 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Standard RGB Color Value Table
White 16777215
Black 0
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
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetLineVisible.
(Optional) A setpoint containing the status
valuedevice or global Boolean point
1 1
2 2
1 Identifies line for visibility on/off.
Value entry is required.
2 0Line off
1Line on
2Toggle
3-24 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
4. 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
1 The line is visible.
0 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.
Important: This method is available only on Intel Windows 95 and Intel Windows NT
platforms.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying WriteReferenceFile.
(Optional) A setpoint containing the status
valuedevice or globalAnalog point
1 1
2 2
3
3
3-26 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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 (8 character limit).
4. (Optional) Enter a Method result. Use a Point ID in the Analog Point Class.
You can use a device or global Point ID.
When you invoke the method, the Method result displays 0.
SetLegendState Method
Purpose: To change the visibility of the legend for the trend.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetLegendState.
(Optional) A setpoint containing the status
valuedevice or global Boolean point
0 Legend off
Value entry is required.
1 Legend on
3-28 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
4. (Optional) Enter a Method result. Use a Point ID in the Boolean Point Class.
You can use a device or global Point ID.
When you invoke the method, the Method result displays:
Value Method Result
1 Legend is visible
0 Legend is invisible
SetAxisTicks Method
Purpose: To display ticks or ticks and tick labels on either an X or Y-axis.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetAxisTicks.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
1 1
2 2
3 3
1 Axis on which the label displays.
Value entry is required.
2 Number of ticks to display.
3 0Ticks only
1Ticks and tick labels
3-30 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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 On the CimView Trend Chart, to:
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.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying JumpToCurrentTime.
(Optional) A setpoint that contains the
status valuedevice or global Point ID
Analog point
3-32 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
PauseUpdates Method
Purpose: To pause or resume updates in the trend.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying PauseUpdates.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying ScrollLines.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
1 1
2 2
3-34 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetXDuration.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
1 1
2 2
3-36 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
SetXStartTime Method
Purpose: To specify a start time of the X-axis for the chart or indicated line and redraw the
trend.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetXStartTime.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point Setpoint not allowed
1 1
2 2
3 3
1 Identifies line for x-axis duration change
Value entry is required.
2 mm/dd/yy hh:mm:ss AM/PM
3 To the millesecond
3-38 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Y-axis Methods
Trending provides you with the following methods to let a Trend user change
the y-axis during runtime:
Invoke method
Method On the CimView Trend Chart, to:
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.
SetAxisLabel Method
Purpose: To display a label that describes the Y-axis.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetAxisLabel.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
1 1
2 2
Value entry is required. 1 Axis on which the label displays.
2 Text that displays.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetLineYAxis.
(Optional) A setpoint that contains the status
valuedevice or global Point ID Boolean point
1 1
2 2
3 3
4 4
Value entry is required. 1 Identifies line for y-axis change
2 Y-axis Lower,Upper Limits
3 0Invisible
1Visible
4 0Disable autoscaling
1Enable autoscaling
3-40 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. Enter the following:
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
An existing Line ID The axis that belongs to the line
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 Make the Y-axis invisible
1 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 Not Autoscale
1 Perform Autoscaling
4. (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.
Result: When you invoke the method, the optional Method result contains one
of the following values:
Value Method Result
1 The Y-axis has been set.
0 The Y-axis was not set.
1 1
2 2
3-42 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. Enter the following:
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
An existing Line ID The axis that belongs to the line
B. An expression or Point ID for nOffOnToggle that evaluates to one of the
following numeric values.
Value Trending will:
0 Make the selected axis invisible
1 Make the selected axis visible
2 Toggle the current state of the axis
4. (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.
Result: When you invoke the method, the optional Method result contains one
of the following values:
Value Method Result
1 The Y-axis has been made visible.
0 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.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetLineUseChart.
(Optional) A setpoint that contains the status
valuedevice or global Point IDBoolean point
1 1
2 2
3-44 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
4. (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:
Option 1If 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 2If 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
1 The method executed successfully.
0 The method failed.
ResetZoom Method
Purpose: To reset the zoom on a trend to 100%.
3-46 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
SetGridState Method
Purpose: To change the grid visibility for the Trend Control.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetGridState.
(Optional) A setpoint containing the status
valuedevice or global Boolean point
3-48 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
EnableOutstandingLoggedRequestStateEvent Method
Purpose: To enable the firing of logged data wait state events in the Trend control.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying
EnableOustandingLoggedRequestStateEvent.
1 1
2 2
1 Seconds Trend checks logged
Value entry is required.
requests outstanding for longer than
the threshold
2 Seconds that request is outstanding
3-50 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Events drop
down list
Procedure
New / edit
associated
procedure
with selected
popup
event
2. Create an Action for the event. This action can be either a script or a procedure
in CimView.
Events drop
down list
Procedure
associated New / edit
with selected procedure
event popup
2. Create an Action for the event. This action can be either a script or a procedure
in CimView.
3-52 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Note: This example uses the following Expression lines, which are already configured
for the chart.
Line 1 S90_350
Line 2 S90_500
Line 3 S90_900
Configuration steps include:
Step 1. Create a screen level variable.
Step 2. Activate Trending's wait state feature.
Step 3. Configure an EnteringOutstandingLoggedRequestState event.
Step 4. Configure a LeavingOutstandingLoggedRequestState event.
Step 5. Configure an object to report Trending's request status.
Step 6. Test the request configuration at runtime.
4. Click OK.
Result: CimEdit creates a screen level variable that can be used by the Trend
control and any other configured objects on the screen.
Indicates a
possible problem.
4. Click OK.
The Chart tab reappears.
5. Click OK.
Result: The CIMPLICITY Trend Control Properties dialog box closes with the
Enable logged data request outstanding state events feature enabled.
3-54 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Step 3. Configure an EnteringOutstandingLoggedRequestState
Event.
1. Open the Properties - Object dialog box.
A. Click the right mouse button on the trend chart.
B. Select Properties from the popup menu.
2. Select the Events tab.
3. Create an EnteringOutstandingLoggedRequestState event.
A. Select ActiveX Event in the Event field.
B. Select EnteringOutstandingLoggedRequestState in the
ActiveX Event field.
G. Click OK.
Result: The Events tab displays the configured
EnteringOutstandingLoggedRequestState event.
3-56 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Step 4. Configure a LeavingOutstandingLoggedRequestState
Event.
1. Add a LeavingOutstandingLoggedRequestState event to the Events
tab in the Properties - Object dialog box.
A. Click New .
A new line appears in the Events list.
B. Select ActiveX Event in the Event field.
C. Select LeavingOutstandingLoggedRequestState in the ActiveX
Event field.
2. Configure the event's procedure.
3-58 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
5. Configure the animation.
A. Enter {BUSY} EQ 1 in the Expression field.
B. Check Fill.
C. Select Solid, Red.
D. Check Blink.
E. Click Close .
BUSY value=0 at screen level.
EnteringOutstandingLoggedRequestState
event value=1.
Object is red
when BUSY=1.
Object blinks
when BUSY=1.
3-60 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Other Trend Methods
Trending also provides you with methods to:
Invoke method
Method On the CimView Trend Chart, to:
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.
ForceRedraw Method
Purpose: To redraw the Trend chart to display the current values.
2. Click an enabled Advanced button in the Edit tab of the Properties dialog box.
The Edit Method dialog box opens displaying SetCimplicityProject.
3. 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-62 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Creating a Quick Trend
GFK-1260H 4-1
Starting Quick Trends
While you are working in the Workbench, you can start a quick trend for any point.
4-2 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Configuring a Quick Trend Chart
Quick Trends offers you the same CIMPLICITY Trend Control Properties dialog box
that you use in CimEdit.
Changes include:
Chart color
Line:
M Color
M Style
M Width
Background color
Legend:
M Font
M Display
Status display
Note: The most recent four trends that are saved, appear on the File drop down menu.
4-4 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Introducing XY Plots
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 effective 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-1260H 5-1
XY Chart Configuration Options Example
Choose chart Display titles
Display yaxis ticks / Choose chart background color
numbersOptional color Show/hide lines
Choose
Step, scatter
or
smooth curve
Choose line
style / color
Slider
5-2 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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
Series legend
Slider legend
Legend features Specific features:
Title
Series' value at the slider
Series' value at an index
Slider's value
Axes One or more X or Y-axes
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
Plot SmartObject. See the "Using XY Plot SmartObjects" chapter in this manual for
details.
GFK-1260F-1 6-1
Inserting an XY Plot Control
To insert the XY Plot control on a CimEdit screen:
CIMPLICITY XY Plot
Control
6. Click OK. A new XY Plot control is placed at the position you selected in your
CimEdit screen.
6-2 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
The XY Plot control looks like this initially:
Increase width
Increase in proportion
Increase height
Method 2Precision
1. Select Edit on the menu bar.
2. Select Properties.
Go to "Continue" (after choosing from Methods 2-4)
Method 3-Precision
6-4 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
The XY Plot Properties dialog box opens when you use any method.
Basic Palette
6-6 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Color Palette: To create Customized Color
Color picker
Luminosity picker
Press to select color and Hue=red, green and blue proportions based on their entered values.
add it to the basic palette. Saturation=Defines color vividnes (amount of gray).
Luminance=Amount of light in the color (0=Black).
3. 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
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.
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. Click the down arrow to the right of the Color input field.
2. Select a color in the customized color section.
3. Click the right mouse button.
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.
6-8 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Choosing a Font
Whenever you have to specify a font and its characteristics in XY, you can do so in a
basic Windows 98/NT Font dialog box.
2. Select the Font. If you use True Type 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 font's:
Style
Size
Script
4. 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.
Background
Foreground
Chart
6-10 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Ambient Colors Selected for an XY Chart Background and Foreground
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-12 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
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
.
Method 3
Double click X or Y.
When you use any method, the tree expands to display:
Count (Read only) The number of X or Y-axes that have been
configured for the chart.
Item The properties appear in a tree under Item.
2. 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.
6-14 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
3. Make additional entries, when they apply, to define more precisely 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.
Entry Displays
d 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.
M Month as digits with no leading zero for
single-digit months.
MM Month as digits with leading zero for single-
digit months.
MMM Month as a three-letter abbreviation.
MMMM Month as its full name.
y 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.
h Hours with no leading zero for single-digit
hours (12-hour clock).
hh Hours with leading zero for single-digit
hours (12-hour clock).
H Hours with no leading zero for single-digit
hours (24-hour clock).
HH Hours with leading zero for single-digit
hours (24-hour clock).
m Minutes with no leading zero for single-digit
minutes.
mm Minutes with leading zero for single-digit
minutes.
s Seconds with no leading zero for single-digit
seconds.
ss Seconds with leading zero for single-digit
seconds.
t One character time marker string, such as A
or P.
tt Multicharacter time marker string, such as
AM or PM.
6-16 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
The # flag may prefix any formatting code. In that case, the meaning of the
format code is changed as follows:
Format Code Meaning
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#% #
Flag is ignored. (Format code above)
%#c Long date and time representation,
appropriate for current locale. For example:
Tuesday, March 14, 1995, 12:41:29.
%#x Long date representation, appropriate to
current locale. For example: Tuesday,
March 14, 1995.
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, #Y
Remove leading zeros (if any). (Format
code above)
C. For apNumberCustom, select the item Custom. Use a format string in the
standard C language format notation to display a number.
D. For apNumberScientific or apNumbercompact, select Precision if you
need to change it from the default of 6.
E. For apNumberRelativeTime, select RelativeTime. Choose one entry.:
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
6-18 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
3. Specify the High and Low Limits. During runtime, the limits will display in
response to the mode you specified. The defaults are:
High 100
Low 0
4. If apAxisScrolled is selected, configure the Backward and Forward scroll
buttons.
A. Click the to the left of BackwardScroll under XItem or YItem.
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.
Automatically displays the total number
of X or Y-axes
6. 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.
6-20 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
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 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. Select TRUE for Visible (in the path under XItem or YItem) to display the
axis. The default is TRUE.
Caution: 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.)
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.
6-22 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Step 11. Specify if a series' values should be in the legend.
Step 12. (Optional) Enter X and Y values for the series.
Caution: 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.
6-24 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Method 3
Double click Series.
The tree expands to display:
Count (Read only) The number of series that have been configured
for the chart.
Item The properties appear in a tree under Item.
3. Use any of the methods you used for Series 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.
The popup menu displays as Collapse
apHatchBackwardDiagonal
apHatchCross
apHatchDiagonalCross
apHatchForwardDiagonal
apHatchHorizontal
apHatchVertical
6-26 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
4. Select line Width for the series line.
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).
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.
X column
6-28 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
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
Designing a Slider
Following are nine 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 slider's initial position and its visibility.
Step 6. Specify if a slider's 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.
Method 3
Double click X or Y.
When you use any method, the tree expands to display:
Count (Read only) The number of sliders that have been configured
for the chart.
Item The properties appear in a tree under Item.
2. Use any of the methods you used for Sliders to expand Item. (Choose Expand
from the popup menu list, if you choose that method.)
6-30 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
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.
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.
Automatically displays the total number
of slider
7. Expand the new slider and configure it using the same steps you used for the
previous slider.
6-32 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
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.
Caution: 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.
6-34 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Method 3
Double click Grid.
The tree expands to display the grid's property options.
Note: Follow any of the three methods when the tree is expanded to collapse the tree.
The popup menu displays as Collapse.
6-36 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Method 2
A. Click the right mouse button.
B. Click the Expand popup menu
.
Method 3
Double click Legends.
The tree expands to display the title's property options.
Note: Follow any of the three methods when the tree is expanded to collapse the tree.
The popup menu displays as Collapse.
apHatchBackwardDiagonal
apHatchCross
apHatchDiagonalCross
apHatchForwardDiagonal
apHatchHorizontal
apHatchVertical
5. Configure the Series legend's columns for the XY Plot's 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.
6-38 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
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.
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 0's right.
I. 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.
J. (Optional) Add additional columns.
i. Select Item under LegendsSeries.
ii. Click the right mouse button.
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.
apHatchBackwardDiagonal
apHatchCross
apHatchDiagonalCross
apHatchForwardDiagonal
apHatchHorizontal
apHatchVertical
5. Configure the legend's columns for the XY Plot's 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.
6-40 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
D. Specify the type of slider's 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 must be an X-axis; for a horizontal slider, a Y-axis.
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.
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 0's right.
I. (Optional) Add additional columns.
i. Select Item under LegendsSlider.
ii. Click the right mouse button.
iii. Select Add from the popup menu.
J. 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. Format the Slider Legend's 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.
6-42 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Method 2
A. Click the right mouse button.
B. Click the Expand popup menu
.
Method 3
Double click Title.
The tree expands to display the title's property options.
Note: Follow any of the three methods when the tree is expanded to collapse the tree.
The popup menu displays as Collapse
6-44 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 2000 GFK-1260F-1
Plotting XY Data
GFK-1260H 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. Open the CimEdit Properties dialog box for the XY Plot control object.
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. Display the Edit Script tab.
6. Write the following Basic excerpt within a subroutine.
' 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
7-2 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Accessed through the Data property in CimSeries.
CimData is
The interface that defines each vector.
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:
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.
7-3 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. Write the following Basic excerpt within a subroutine.
' Access the series object:
Dim series as CimSeries
Set series = cimOleObj.Series("Series 1")
7-4 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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:
' Set the point to the third Y data value in the series:
x.SetValue = cimOleObj.Series("Series 1").Data.Y(2)
Example 2. Set individual data values from the series vectors to a particular
value:
Series name: Series 1
Script purpose: Set the fifth X data value to the value of a point
Procedure:
1. Open the CimEdit Properties dialog box for the XY Plot control object.
2. Display the Edit Script tab.
7-5 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
3. Write the following Basic excerpt within a subroutine.
' Define the point:
Dim x As New Point
x.Id = "X_POINT"
7-6 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Example. Push one or more data values:
You have a series whose X and Y values are the following:
X 5 10 15 20 25 30
Y 22 17 9 -7 22 41
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
Series name: Series 1
Script purpose: Push an integer and a double value into Series 1
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.
' Create an integer and a double value:
Dim x as Integer
x = 7
Dim y as Double
Y = 22.74
7-7 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Example 2. Push arrays of X and Y values through the end of the series
vectors
Series name: Series 1
Script purpose: Create an array of variant values and an array of double values and push
them into Series 1
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.
' 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"
7-8 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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:
7-9 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Example 1. Push one X and one Y value through the end of a series
vectors:
Series name: Series 1
Script purpose: Push the single values of two CIMPLICITY points into Series 1
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.
' Get two point values:
Dim x As New Point
x.Id = "X_POINT"
Dim y As New Point
y.Id = "Y_POINT"
7-10 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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:
Single values or
Arrays of any size.
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:
Integer
Long
Single
Double
Decimal
Boolean
Byte
Variant
String
7-11 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Example. Set one or more data values:
You have a series whose X and Y values are the following:
X 5 10 15 20 25 30
Y 22 17 9 -7 22 41
You set the following X and Y values starting at location 2 (index 1):
X 35 40 45 50
Y 59 37 21 6
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
7-12 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Example 2. Create an array of variant values in a series:
Series name: Series 1
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. 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.
' 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"
7-13 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
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.
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:
7-14 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Example 1. Set the first location in a series:
Series name: Series 1
Scripting purpose: Set the first location (index 0) in Series 1. The values of two
CIMPLICITY points are used.
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.
' Get two point values:
Dim x As New Point
x.Id = "X_POINT"
Dim y As New Point
y.Id = "Y_POINT"
Example 2. Set a series with the array values of two CIMPLICITY HMI
points:
Series name: Series 1
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. 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.
' Get two point values:
Dim x As New Point
x.Id = "X_ARRAY_POINT"
Dim y As New Point
y.Id = "Y_ARRAY_POINT"
7-15 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Using XY Plot SmartObjects
GFK-1260H 8-1
XY Plot SmartObject Placement
The XY Plot SmartObject is in the Object Explorer.
8-2 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Series box
Add a series
Delete a series
Move a series in
Series data
the list
M Up
M Down
Update criteria
X and Y-axis
assignments
8-4 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
Axis location
Show X Axes
Show Y Axes
8-6 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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 Apply , 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.
Scroll
7. Check the Ticks checkbox to display ticks on the axis being configured.
8. Enter the number of ticks to display. The default is 2.
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.
8-8 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Configuring an XY Plot SmartObject Name and Colors
8-10 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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 CIMPLICITY XY Plot Control dialog box, as follows:
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.
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
X initial: 0 to 1000000
Y initial: 0 to 1000
Series markers: Square, navy blue, Width: 75
Slider initial position: 40
Series pen: None
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
8-12 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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 0
Upper 1000000
F. Check Autoscale for the scaling.
5. Configure the Y-axis:
A. Check Show Y Axis.
B. Name the axis. (The example is DEV1900.)
C. Check Visible.
D. Enter a title in the Title field. (The example is DEV1900.)
E. Check Title Visible.
F. Enter the Limits:
Lower 0
Upper 1000
G. Check Autoscale for the scaling.
6. Click Chart.
7. Keep the defaults.
8. Click Grid.
9. Specify the number of ticks (lines) for the grid:
Vertical 4
Horizontal 4
10. Click OK.
Result: 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.
8-14 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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
X initial: 0 to 1000000
Y initial: 0 to 1000
Series markers: Square, navy blue, Width: 75
Slider initial position: 40
Series pen: None
8-16 CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
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.
8. Click OK.
9. Test the Plot Control in runtime.
GFK-1260H Index-i
apSeriesScatter Brush
For an XY 6-25 For an XY series 6-25
For an XY Plot 8-5 BSTR
apSeriesStandard Valid range 3-7
For an XY 6-25 Buttons
For an XY Plot 8-5 Backward and forward scroll for an XY 6-19
apSeriesStep
For an XY 6-25 C
For an XY Plot 8-5
apSliderHorizontal Change Limits
For an XY 6-31 And x-axis timing 2-28
apSliderVertical Changing chart properties at run-time 1-5
For an XY 6-30 Chart
Arguments Configure advanced properties 2-39
Invalid 3-7 Configure properties 2-37
Array Properties 2-37
Point trends 2-47 Chart Color 2-38
Trend a single element 2-47 ChartColor
Trend at a single instant in time 2-47 For XY 6-10
Array Points Choose
Push values for a series 7-9 A font 2-51, 6-9
Arrays Color
Scrolling 1-9 Ambient for XY 6-11
Auto Update 6-44 And 2-9
Logged line 2-12 And quick line configuration 2-7
Auto Update Interval 2-38 And the y-axis 2-35
Autoupdate Background on a chart 2-38
A trend line 3-16 Chart 2-38
Axes Create custom 2-49, 6-6
Configure with XY Plot SmartObject 8-6 For an XY series line 6-26
Configured for an XY series 6-27 Foreground on a Chart 2-37
Designing for an XY 6-12 Modifying 2-50, 6-8
Finding the properties for an XY 6-12 Of gridlines 2-44
Name 6-20 Of XY grid line 6-35
Prioritized on an XY 6-20 Select a basic color 2-48, 6-6
Properties on XY 6-12 Colors
Title 6-21 Ambient and Trend chart 2-37
Title visible on an XY 6-21 Column ID
Axis And CSV file lines 2-15
Mapping to a line 2-25 Logged line 2-12
Properties 2-27 Common Time Stamp
And CSV file lines 2-15
Format for CSV lines 2-16
B
Compression
Background Color on a Chart 2-38 For a line 2-21
BackgroundColor Server side 2-22
Designing for XY 6-10 Configure
Backward Basic chart properties 2-37
Scroll buttons on an XY 6-19 Begin for axis 2-27
BackwardScroll CSV file line 2-15
For an XY Plot axis 6-19 Detailed x-axis 2-31
Base Project Expression line 2-11
Selected for Trending 2-38 Logged expression line 2-13
BOOL Logged line 2-12
Valid range 3-7 Point line 2-10
Index-ii CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Reference file 2-18 Design
X-axis timing 2-28 An XY Plot grid 6-34
XY Smart Object Plot Control axes 8-6 An XY Plot title 6-42
XY Smart Object Plot Control series 8-3 Axes for an XY 6-12
Y-axis 2-32 Legend for an XY 6-36
Y-axis details 2-35 Series for an XY 6-22
Configured X Axis Slider for an XY 6-29
And mapping axes to lines 2-26 XY Plot overview 6-1
Configured Y Axis Details
And mapping axes to lines 2-26 X-axis configuration 2-31
Content Dialog Box
Of XY Title 6-43 Edit method overview 3-6
Count Dialog Box Section
Horizontal lines on XY grid 6-35 Invoke method 3-5
Vertical lines on XY grid 6-35 Disable
Create Expression line scrolling 2-11
A series from the object model 7-1, 7-2 Expression logged line scrolling 2-13
CSV file line 2-15 Point line scrolling 2-10
Expression line 2-11 Runtime actions 2-46
Logged expression line 2-13 Display
Logged line 2-12 A grid 2-45
New trend line 2-8 A legend 2-43
Point line 2-10 Gridlines on a chart 2-44
Quick trend line 2-7 Line style 2-21
Reference file 2-18 Status bar 2-43
CSV File Line 2-15 Display Format 2-42
And Common time stamp format 2-16 Display Height 2-42
And unique time stamp format 2-16 Do Setpoint
Custom Checkbox in edit method dialog box 3-6
Color 2-49, 6-6 Double
Valid range 3-7
D Duration
And x-axis timing 2-28
Data Of x-axis time 2-29
Flow on an XY 6-14
Format type for an XY 6-14
E
Location on an XY 6-14
Push one or more values 7-6 Enable
Setting individual values 7-4 Runtime actions 2-46
Data Compression Enable 3-52
Interval start time 2-25 Enable logged data request outstanding state events
Logged lines 2-23 Configuration example 3-52
Non-logged lines 2-22 EnableOutstandingLoggedRequestStateEvent
Data Source Configuration example 3-52
For logged line 3-12, 3-14 EnableOutstandingLoggedRequestStateEvent trend
Datasource method 3-49, 3-50, 3-51
Logged line 2-12 Entries
Default Lower Limit 2-33 Advanced for invoking a method 3-6
Default Upper Limit 2-33 Basic for invoking a method 3-5
Define Expansion
A legend's properties 2-42 For a line 2-21
DeleteTrendLine Method 3-15 Export
Density Reference file 2-19
Of XY grid 6-35
Index-iv CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Line Method
Add a logged expression line method 3-13 AddLoggedExpressionLine 3-13
Add an expression line method 3-10 AddLoggedLine 3-11
Add logged method 3-11 DeleteTrendLine 3-15
Autoupdating method 3-16 For adding an expression line 3-10
Change the display style 2-21 SetLineAutoupdate 3-16
Create 2-8 Method Result
CSV file 2-15 For deleting a line 3-15
Delete method 3-15 For expression line 3-11
Design for an XY Plot axis 6-17 For logged line 3-9, 3-12
Display dialog box 2-21 For logged point line 3-14
Expression 2-11 For setting an automatic line update 3-17
For an XY grid 6-35 Overview 3-7
For an XY series 6-26 Mode
For an XY slider 6-31 For an XY Plot axis 6-18
Hide 2-21 Modify
Logged 2-12 A color 6-8
Mapping axes to 2-25 A color 2-50
Method for deleting 3-15 New XY Plot control size 6-3
Methods for 3-8 Multiple
Point 2-10 Y-axes displayed 2-40
Reference Line 2-17
Set compression 3-18 N
Set display 3-20
Using logged and point data 3-13 Name
Width for an XY Plot axis 6-17 For an XY series 6-24, 6-29
LineID For XY Plot axis 6-20
For logged line 3-9, 3-12 For XY Plot slider 6-33
Lines properties, Trend 2-6 Trend control 3-4
List New
Trend methods 3-3 Trend line 2-8
Trend methods 3-1 No Scroll
Location For the x-axis 2-31
Of data on an XY 6-14 Now Minus Days 2-29
XY Plot legend 6-37 Now Minus Time 2-29
Logged Number
Expression line scrolling 2-13 Format for an XY 6-14
Group log table 2-12 Type defined for an XY 6-15
Line configuration 2-12
Logged Line O
Data source 3-12, 3-14
Method to add 3-11 Object Model
long Create a series 7-1, 7-2
Valid range 3-7 Definition 7-1
ODBC
Data source for logged line 3-12, 3-14
M Text driver and reference file name 2-19
Map Open
Axis to line 2-25 Advanced dialog box for chart properties 2-39
Markers Trend chart properties dialog box 2-5
For an XY series 6-26 XY Plot Control Properties dialog box 6-4
Order of Priority
Axis on an XY 6-20
Output Argument
In edit method dialog box 3-6
Index-vi CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
Q ScrollLines trend method 3-34
Select
Qualified A basic color 6-6
Points and expression lines 2-11 A basic color 2-48
Points and logged expression lines 2-14 Series
Quick Lines Axes 6-27
Creating 2-7 Configure with XY Plot SmartObject 8-3
Create data values 7-1
R Design legend for 6-36
Designing for an XY 6-22
Ranges
Fill on an XY 6-25
Valid for each point type's parameters 3-7
Finding properties for an XY 6-22
Rapid Trend Retrieval
Identifying properties 6-24, 6-29
Interval start time 2-25
Markers 6-26
Logged lines 2-23
On an XY 6-22
Non-logged lines 2-22
Push one or more data values 7-6
Reference File 2-18
Push value from point 7-9
Example 2-20
Resize vectors 7-3
Export 2-19
Type for an XY 6-25
Reference Line 2-17
Server Side Compression 2-22
Relative Time
Set
Specified for an XY 6-17
One or more data values 7-11
ResetZoom trend method 3-46
Values from points 7-14
Resize
SetAxisLabel Method 3-39
New Trend Control chart 2-3
SetAxisTicks Method 3-30
New XY Plot control 6-3
SetGridState trend method 3-47
Series vectors 7-3
SetLegendState trend method 3-28
Restrictions
SetLineAutoupdate Method 3-16
Reference file name 2-19
SetLineAutoupdate trend method 3-16
Restrrictions
SetLineCompression Method 3-18
On SetLineAutoupdate method 3-16
SetLineDisplay Method 3-20
Retrieval
SetLineUseChartY trend method 3-44
Rapid for trend logged lines 2-23
SetLineVisible trend method 3-24
Rapid for trend non-logged lines 2-22
SetLineYAxis Method 3-40
Runtime Actions
Setpoint
And a reference file line 2-18
Do setpoint in edit method dialog box 3-6
Enable or disable 2-46
SetXDuration trend mehtod 3-35
SetXStartTime trend method 3-37
S SetYAxisVisible trend method 3-42
Short
Scatter
Valid range 3-7
Series for an XY 6-25
Show Legend 2-42
Series for an XY Plot 8-5
Show Most Recent 2-29
Scroll
Show Property Pages at Runtime 2-46
Buttons for an XY 6-19
And a reference file line 2-18
Expression logged lines disabled 2-13
Show Title 2-42
Scroll Buttons
Single
Visible on an XY 6-19
Y-axis displayed 2-40
Scrolling 1-8
Single Element
Disable for expression line 2-11
Trended 2-47
Disable for logged expression line 2-13
Single Time Duration 2-40
Disable for point line 2-10
Single X Axis 2-40
Disable for the x-axis 2-31
Single Y Axis 2-40
Scrolling behavior
Size
Arrays 1-9
Changing for a new XY Plot control 6-3
Index-viii CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H
SetXStartTime 3-37 Visible
SetYAxisVisible 3-42 And the x-axis 2-31
WriteReferenceFile method 3-26 Axis title on an XY 6-21
Trend properties Grid on XY 6-35
Lines 2-6 Markers for XY series 6-26
Trending Scroll buttons on an XY 6-19
Run-time actions, Changing chart properties at run- XY series in legend 6-24, 6-29
time 1-5 XY title 6-43
Runtime actions, Scrolling 1-8
Run-time actions, Zooming 1-6 W
Scrolling behavior, Arrays 1-9
Type Wait State
Of Series for an XY 6-25 Functionality example 3-52
Of XY Plot slider 6-30 Width
Change for a line 2-21
For XY series line 6-27
U
For XY series markers 6-26
Unique Time Stamp Of an XY grid line 6-35
And CSV file lines 2-15 Of gridlines 2-44
Format for CSV lines 2-16 Of line for an XY Plot axis 6-17
Update Of XY slider 6-31
Auto 6-44 WriteReferenceFile trend method 3-26
Use
XY Plot SmartObject 8-2 X
Use Fixed Lines
For a grid 2-44 X-axis
Use Ticks from Axis Designing for an XY 6-12
For a grid 2-44 Finding properties for an XY 6-12
UseAmbientBackgroundColor Prioritized on an XY 6-20
For XY 6-11 Properties on an XY 6-12
UseAmbientChartColor X-Axis
For XY 6-11 Configure timing 2-28
UseAmbientForegroundColor Detailed Configuration 2-31
For XY 6-11 XY Plot
Legend location 6-37
XY Plot SmartObject
V
Configuring overview 8-3
Valid Overview 8-1
Ranges for each point type 3-7 Placing 8-2
Value XY Plots
Of XY title 6-43 Overview 5-1
Push for data 7-6 Overview of features 5-3
Push from points 7-9
Set from point 7-14 Y
Setting for individual data 7-4
Vectors Y-axis
Resize for series 7-3 Designing for an XY 6-12
Vertical Finding properties for an XY 6-12
Slider for an XY 6-30 Prioritized on an XY 6-20
VerticalCount Properties on an XY 6-12
Lines on XY grid 6-35
Z
Zooming 1-6
Index-x CIMPLICITY HMI Trend and XY Chart Operation ManualJuly 2001 GFK-1260H