Documente Academic
Documente Profesional
Documente Cultură
CIMPLICITY HMI
Warning
Warning notices are used in this publication to emphasize that hazardous voltages, currents, temperatures, or other
conditions that could cause personal injury exist in the equipment or may be associated with its use.
In situations where inattention could cause either personal injury or damage to equipment, a Warning notice is used.
Caution
Caution notices are used where equipment might be damaged if care is not taken.
Note
Notes merely call attention to information that is especially significant to understanding and operating the equipment.
This document is based on information available at the time of publication. While efforts have been made to be accurate,
the information contained herein does not purport to cover all details or variations in hardware or software, not to provide
for every possible contingency in connection with installation, operation, or maintenance. Features may be described
herein which are not present in all hardware and software systems. GE Fanuc Automation assumes no obligation of
notice to holders of this document with respect to changes subsequently made.
GE Fanuc Automation makes no representation of warranty, expressed, implied, or statutory with respect to, and assumes
no responsibility for the accuracy, completeness, sufficiency, or usefulness of the information contained herein. No
warranties of merchantability or fitness for purpose shall apply.
ii Preface GFK-1260F
Preface
Related Publications
For more information, refer to these publications:
CIMPLICITY HMI Base System User’s Manual (GFK-1180)
GFK-1260F iii
Contents
Introducing Trends 1-1
Trend Introduction ................................................................................................................. 1-1
About Trends.......................................................................................................................... 1-1
Trend Chart Display............................................................................................................... 1-2
Runtime Actions..................................................................................................................... 1-5
Changing Chart Properties at Runtime..................................................................... 1-5
Zooming into a Specific Area .................................................................................. 1-6
Analyzing Data at a Selected Point in Time............................................................. 1-7
Scrolling Lines Forward and Backward ................................................................... 1-8
GFK-1260F v
Trend Methods 3-1
About Trend Methods ............................................................................................................ 3-1
Method Configuration ............................................................................................................ 3-3
Naming A Trend Control ......................................................................................... 3-3
Creating an Invoke Method Action .......................................................................... 3-3
Line Display Methods ............................................................................................................ 3-6
AddLoggedLine Method .......................................................................................... 3-6
AddLoggedPointLine Method.................................................................................. 3-8
AddPointLine Method............................................................................................ 3-10
DeleteTrendLine Method ....................................................................................... 3-11
SetLineAutoupdate Method ................................................................................... 3-12
SetLineDisplay Method.......................................................................................... 3-13
SetLineVisible Method .......................................................................................... 3-17
WriteReferenceFile Method................................................................................... 3-18
Methods for the Legend........................................................................................................ 3-20
SetLegendState Method ......................................................................................... 3-20
X-axis (Time Related) Methods ........................................................................................... 3-21
JumpToCurrentTime Method................................................................................. 3-21
PauseUpdates Method............................................................................................ 3-23
ScrollLines Method................................................................................................ 3-24
SetXDuration Method ............................................................................................ 3-25
SetXStartTime Method .......................................................................................... 3-26
Y-axis Methods .................................................................................................................... 3-28
SetLineYAxis Method............................................................................................ 3-28
SetYAxisVisible Method ....................................................................................... 3-30
SetLineUseChartY Method .................................................................................... 3-31
Visual Aid Methods.............................................................................................................. 3-33
ResetZoom Method................................................................................................ 3-33
SetGridState Method.............................................................................................. 3-33
Wait State Methods and Events............................................................................................ 3-35
EnableOutstandingLoggedRequestStateEvent Method .......................................... 3-35
DisableOutstandingLoggedRequestStateEvent Method......................................... 3-36
EnteringOutstandingLoggedRequestState Event.................................................... 3-37
LeavingOutstandingLoggedRequestState Event .................................................... 3-38
Other Methods...................................................................................................................... 3-39
AboutBox Method.................................................................................................. 3-39
SetCimplicityProject Method................................................................................. 3-39
Index i
viii CIMPLICITY HMI Trending and XY Chart Operation Manual–April 1999 GFK-1260F
Introducing Trends
Trend Introduction
CIMPLICITY HMI provides you with the ability to look at data from several different
perspectives. The charts that enable you to do this are:
• Trend charts–In which you can review, evaluate and log point point values over
time
• XY charts–In 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-1260F 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
Choose line
style / color
Display x-axis ticks /
numbers–Optional
Display page scroll–
Optional
Display legend title–
Optional
Slider
1-2 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
You can choose to display or hide:
Display feature Choose to Display or Hide
Ticks and numbers For the Y-axis
For the X-axis
Grid Gridlines
Lines Each line
Legend Entire legend
Legend features Specific features:
• Title
• Line ID
• Y value at slider
• Engineering units
• Time at slider
• Date at slider
• Y-axis limits
• Current point value
• Array status
• Autoupdate status
Status bar Entire status bar
Status bar features Specific features:
• Status line
• Current date
• Current time
• Status title
• Slider date
• Slider time
1-4 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Runtime Actions
During runtime if you, the trend chart designer allow it, a user can change the amount of detail
being viewed and even change the way it is displayed.
In addition a runtime user can easily:
• Magnify (Zoom into) a specific area of the trend chart
• Analyze data at a selected point in time
• Scroll to data not currently on the chart
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 Manual–April 1999 GFK-1260F
Analyzing Data at a Selected Point in Time
A slider is a vertical line that extends over the chart area. Every trend control chart has one. If
the chart legend displays the Y values, dates, and times, they will be updated as the slider
moves across the chart.
Scrolling Options
To scroll one page:
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 Manual–April 1999 GFK-1260F
Array Data Scrolling
If a line is an array, whenever the array data changes, the old line is erased and a new one,
representing the new data, is drawn.
Arrays display, as follows:
1. 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.
Method 2
1. Click the OLE button on the Tools toolbar.
2. Place the ActiveX Placement cursor where you want the top left corner of the control
to be located. You can move the control any time you want.
GFK-1260F 2-1
5. Select CIMPLICITY Trend Control.
6. Click OK. A new Trend control is placed at the position you selected in your
CimEdit screen.
The Trend control looks like this initially:
Increase width
Increase in proportion
Increase height
2-2 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Method 2–Precision
1. Select Edit on the menu bar.
2. Select Properties.
Go to "Continue (after choosing from Methods 2-4)"
Method 3-Precision
Click the Properties button on the Format toolbar.
Go to "Continue (after choosing from Methods 2-4)"
Method 4–Precision
1. Hold down the right mouse button.
2. Select Properties from the drop-down menu.
Go to "Continue (after choosing from Methods 2-4)"
The Properties – Object dialog box displays when you use Methods 2-4.
Continue (after choosing from Methods 2-4)
1. Select the Geometry tab.
2. Enter the width and / or height for the trend chart in the Width field and Height
field.
Tip: Click the right mouse button in any area of the Trend control to display a popup menu
that is related to that area.
Note: Any fields that do not apply to the Trend you are defining will be grayed out.
2-4 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Trend Control Line
When you configure lines in Trending, you can quickly configure a point’s trend line by using
Quick Lines.
You can also take advantage of Trending’s many features to define each line in detail.
Trending currently supports the following data sources for trend lines:
• Expressions
• Logged data
• Logged Expressions
• CSV files
• Reference files
Line Display
Press to open
(style)
Select a Point browser
dialog box
3. Click the Quick Lines button . The Select a Point dialog box opens.
Creates blank
entry for new
line
Line Display
dialog box
Copies
selected line
configuration
2-6 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
5. Enter the required information for CIMPLICITY to associate data with that line type.
See each line type’s section for more information.
6. Either:
A. Press Enter on the keyboard.
B. Click the Line ID column The Line ID appears in the Lines grid.
7. Specify line characteristics in the Lines grid.
A. Select a color. Either:
• Click the Color Palette button , 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.
Edit
Expression
Enter one or more Point IDs and Expression
mathematical operators that can menu
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.
2-8 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Configuring a Logged Line
Logged lines display data from a CIMPLICITY Database Logger group table. This type of
trend is also called an historical trend because all the information comes from logged data.
2. Select the ODBC data source from the Datasource drop down menu.
3. Open the Table/Column browser to select the:
A. Table ID in the data source.
B. Column ID in the table.
4. Specify the update status in the Auto update check box:
Check Specify auto update
Clear Keep the same historical information as a
reference
Logged lines can always be scrolled. If you leave Auto update blank, the line will update
when it is scrolled.
Important: The source for a Logged line is always a column in a group log table.
A group log table has one column per point, one row for all points.
See the Using the Database Logger chapter in the CIMPLICITY HMI for Windows NT and
Windows 95 Base System User’s Manual (GFK-1180) for more information.
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.
2-10 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Logged Expression Lines and Scrolling Configuration
The behavior of the logged expression line type depends on how scrolling is configured on the
Chart tab as follows:
Allow runtime-scrolling Behavior
Not selected The Scroll Percentage determines the amount of run-time
data used. The rest of the data comes from the log table.
Example
Configure a chart to display a two (2) hour time
duration.
Set the Scroll Percentage to 25.
During the display the:
First hour and a half (1 ½) comes from the log table
Last half-hour ( ½) comes from run-time data.
You cannot scroll logged expression lines when Allow
runtime scrolling is not selected. In addition, the Trend
will always draw in Jump Scroll mode.
Selected The Scroll Percentage no longer determines the amount
of run-time data used. The line displays up to one chart
page worth of run-time data. The rest of the data comes
from the log table.
You can scroll logged expression lines when Allow
runtime scrolling is selected.
If a Point ID Trending
Is fully qualified Continues to draw the line using the same data source.
Is not fully qualified Trending assumes the data is coming from the base
project. If you change the base project, Trending attempts
to find the point in the new base project.
This feature is useful if you have two or more projects with the same Point ID (for example,
BLDG_1 project and BLDG_2 project) and you want to be able to switch between them.
Note: One of the sources for a Logged expression line is always a column in a group log
table. See the Using the Database Logger chapter in the CIMPLICITY HMI for Windows NT
and Windows 95 Base System User’s Manual (GFK-1180) for more information.
2-12 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Example of data type
If: The data type of the column Float
Then: All rows should have float values for that column.
7. Give CSV files names that fit the 8.3 format. The ODBC Text driver cannot open a
file with a filename greater than 12 characters.
Example
largest1.csv Can be a .CSV file name
A
Enter one or more
Point IDs and
mathematical operators
that can be evaluated.
B
Select a File
Name of .REF file
dialog box
containing the data
Table/Column
Column in group log table
browser
Clear to keep the same Line Display
values as a reference dialog box
Reference Line
Value Source How Trending Updates the Reference Line
Expression Trending takes the latest value of the expression and draws a
horizontal line with the value. If the value of the expression
changes, Trending updates the reference line.
Reference file Retrieves values from a reference file that are exported into the
reference file at runtime.
2-14 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Reference Line Axes
Following is a description of reference line axes’ behavior:
• Expression reference lines default to use the chart’s X-axis and Y-axis.
• Reference file lines default to use their axes. They are named using the line ID with a
_X and _Y suffix respectively. The axis configuration is based on the contents of the
reference file. The X-axis defaults to no scroll.
Important: Reference files are currently available only on the Intel Windows 95 and Intel
Windows NT platforms.
Export to
reference file...
enabled during
runtime
Check to make
the dialog box
available
Check to enable
the Runtime
action tab during
runtime
2. Make sure the Show property pages at runtime and Runtime actions check
boxes are checked.
3. During runtime:
A. Open the CIMPLICITY Trend Control Properties dialog box.
B. Select the Runtime Actions tab.
C. Click Export reference file… The Save Reference File dialog box displays.
Select one or
more lines to
reference
Enter a path
including a Browse a
directory and Windows 95/NT
file name Save As dialog
box
D. Click on each line that you want to write to the reference file.
E. Enter a directory and file name in the File Name field.
It is better to create a separate directory for the file. However, if you do not
select a directory, the file is saved in the last directory you accessed with the
File Save dialog box. The default filename extension is .REF.
F. Click OK to write the reference file, or click Cancel to cancel your request.
When you click OK, all the data currently visible on the trend for the lines you
selected will be written to the reference file.
Important: The ODBC Text driver cannot open a file with a filename greater than 12
characters. For best results, enter a name that fits the 8.3 format. That is, the file name
should be eight characters or less, followed by a period and an extension of three characters or
less (for example, "largest1.txt").
2-16 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Reference File Rows
Contents in Reference file rows include:
Row Contains
1 Column names in double quotes and separated by the
International settings list separator (usually a
comma).
The column name that designates the time stamp
associated with a data column is a concatenation of
the data column name and "_TIME".
2 The minimum value and time for each line in the file.
3 The maximum value and time for each line in the file.
Remaining The value and time each time the line’s value changes
over the time period.
"Soap","Soap_TIME"
211,"03-01-1996 18:19:34.000"
506,"03-01-1996 18:24:34.000"
476,"03-01-1996 18:18:54.230"
474,"03-01-1996 18:19:16.570"
470,"03-01-1996 18:19:17.770"
467,"03-01-1996 18:19:19.040"
464,"03-01-1996 18:19:20.480"
461,"03-01-1996 18:19:31.220"
457,"03-01-1996 18:19:32.460"
If you selected more than one line to save, the value and time information for each line is
stored independently, as in the following example:
"Soap","Soap_TIME","Wax","Wax_TIME"
1,"03-01-1996 19:29:34.000",1,"03-01-1996 19:29:34.000"
575,"03-01-1996 19:34:34.000",575,"03-01-1996 19:34:34.000"
183,"03-01-1996 19:29:01.840",476,"03-01-1996 19:25:19.270"
179,"03-01-1996 19:29:02.850",472,"03-01-1996 19:25:20.280"
175,"03-01-1996 19:29:03.850",468,"03-01-1996 19:25:21.580"
172,"03-01-1996 19:29:04.860",467,"03-01-1996 19:25:22.590"
169,"03-01-1996 19:29:14.890",466,"03-01-1996 19:25:32.980"
165,"03-01-1996 19:29:15.900",462,"03-01-1996 19:25:34.000"
If the reference file is for an array point, the second line contains the first array element, the third line
contains the last array elements, and the rest of the rows contain the rest of the array elements. All array
elements have the same time value. For example:
"Step", "Step_TIME"
100, "03-01-1996 18:19:34.000"
105, "03-01-1996 18:19:34.000"
101, "03-01-1996 18:19:34.000"
102, "03-01-1996 18:19:34.000"
103, "03-01-1996 18:19:34.000"
104, "03-01-1996 18:19:34.000"
Value to represent
a group of values
é None
é Average
é First
Check to hide the é Last
line at runtime é Minimum
é Maximum
2-18 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
5. Select how the points should be connected. The choices are
Step (Recommended for runtime display) Connects
data points with a stepped line
Smooth Connects data points with a straight line. The
legend will always display the last actual value
to the left of the cursor. That is, the value in the
legend does not reflect the line interpolation.
6. (Optional) Check the Hidden check box if you do not want the line to be displayed
on the chart at run-time.
Note: Y Chart Axis and X Chart Axis are the default axes.
2-20 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Axis Configuration
Your trend chart has to have at least on X-axis and one Y-axis. At times, you may want to
configure more that can be used instead of either default axis.
Fields change
between X-axis
and Y-axis
Creates blank
entry for new
axis
Copies
selected axis
configuration
X-axis Popup
2-22 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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: 0–365
hh Hours: 0–59
mm minutes: 0–59
ss seconds: 0–59
2. Configure the Start time from the following choices:
Example: X Axis Timing
A. Show most recent
ddd= 0 -365
hh = 0 - 23
mm = 0 - 59 ddd:hh:mm:ss
ss = 0 - 59
mm/dd/yy
B. Start date
C. Now minus days ddd hh:mm:ss
Now minus days Number that specifies the number of days before the
current date. For example, enter 5 to begin the
display five (5) days before the current date.
C. Start time requires:
Start time Absolute time in hh:mm:ss format
Now minus time Number that specifies the number or hours, minutes
and seconds before the current time. The number is
specified in hh:mm:ss format. For example, enter
1:30:05 for a starting time1 hour 30 minutes and 5
seconds earlier than when the trend is first displayed.
Fields change
when a different
axis is selected
Creates blank
entry for new
axis
Copies
selected axis
configuration
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 line’s 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.
2-24 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Configuring the Y-axis
For each Y-axis, you:
1. Configure the limits either in the:
• CIMPLICITY Trend Control Properties dialog box.
• Y-axis Limits dialog box
2. Configure other details in the CIMPLICITY Trend Control Properties dialog box.
If there are no
2
Point Limits
1
3 Each time a value
goes above or
below the existing
limit.
Go to "Continue (following Method 1 or 2)".
Method 2–Popup Menu Configuration
1. Position the cursor over the Y-axis area.
2. Click the right mouse button. A popup menu appears.
Y-axis Popup
3. Select Limits.
A Y Axis Limits dialog box appears.
Go to "Continue (following Method 1 or 2)".
2
Each time a value goes
1 above or below the
existing limit.
2-26 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Guidelines for the order of priority if you select all the limit options
Trending:
1. Increments the upper or lower limit each time a value goes above or below the
existing limit.
2. Uses the limits specified in the Points – Configuration dialog box.
3. Uses the limits specified in the Default lower limit and Default upper limit fields.
Fields change
between X-axis
and Y-axis
Creates blank
entry for new
axis
Copies
selected axis
configuration
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.
i. Click the Color Palette button , on the line’s 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.
4. (Optional) Configure a label and ticks for the axis:
A. Select the number of ticks in the Ticks box that you want the Y-axis to display.
You can select through 100.
B. Check the Numbered checkbox to label the tick marks.
5. Continue to add axes as follows:
A. Click the New button 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 don’t want.
2-28 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Chart Properties
There are several details about the chart itself from its color to how many pixels away can a
cursor be from the slider and still grab it.
These details are configured in the Chart tab of the CIMPLICITY Trend Control Properties
dialog box and then in the Advanced dialog box that is accessed through the Chart tab.
Example: Chart tab filled in Open Color palette Display scroll buttons
If checked, lines:
1. Draw left to right
2. Update across the
chart area.
3. Scroll when the
right edge is
reached
4. Continue update
Interval for:
from left to right.
é Chart update
é Chart redrawn
If checked, lines:
(hh:mm:ss) 1. Update at the right
edge
Project used for
2. Scroll each time an
unqualified
update is received
points, can be
changed at
runtime.
Open Advanced
dialog box
3. Click each color field’s Color Palette button to configure the chart’s colors:
Field Selects color for the:
Foreground color Slider, legend and chart X and Y-axes
Background field Area surrounding the trend chart
Chart color Solid color for the trend chart area
4. Enter the time between one new data update and the next in the Auto Update Interval
field. The format is hh:mm:ss.
Example
10 equals ten seconds; 1:00 equals one minute.
5. Enter the time between one time that the chart redraws itself and the next in the Auto
Refresh Interval field. The format is hh:mm:ss.
6. Select the CIMPLICITY project to be used for any unqualified Point IDs. The
default is provided by CimView, but it may be changed at run-time.
7. (Optional) Check the Show buttons check box to display the scroll buttons.
8. Choose an update style
Jump Scroll The line:
Starts at the left of the chart
Updates across the chart area.
Is automatically scrolled by the scroll percentage,
specified in the Advanced dialog box, when the right
edge is reached
Continues to update from left to right.
Strip Chart The line:
Updates at the right edge of the chart
Scrolls each time an update is received
9. (Optional) Continue configuration in the Advanced Properties dialog box.
2-30 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Configuring Advanced Chart Properties
The Advanced chart properties let you configure the Y-axis display, scroll percentage, slider
grab margin and other miscellaneous chart features.
Choose
é Multiple (default): All
nonhidden Y-axes
é Single: Y-axis only
é Percent Configured:
0–100 Scale
Number of pixels
from slider in which
the slider can still be Amount of data scroll
grabbed when scroll buttons
(1–10) are pressed
All lines use a single
Legend shows visible
time period and
and hidden lines
duration
All lines use a single Jump to current time
time period at next runtime or
auto update
• Time duration that the chart data will Scroll backward or forward when the
or button is pressed during runtime.
• Length of the jump when the drawing reaches the right edge of the chart if you
set the Update style to Jump scroll in the basic Chart tab.
Example of button scroll
A chart displays a two (2) hour time duration
Enter 25 in this field.
2-32 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Legend Properties
The Legend properties define the legend information for the lines on the chart.
é Single column
Check to é Two columns
display for
each line on
Number of
the chart
legend lines
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.
10. Click Font to select the font, font style, size and script for the legend and status bar.
2-34 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Grid Properties
You can display grid lines that divide your chart into sections. You do this on the Grid tab of
the CIMPLICITY Trent Control Properties dialog box.
Choose a non-
solid line.
The width is
Enter the
fixed
number of
grid lines
Choose a
solid line.
Specify the
width
Display grid based on a selected
(or nearest) line’s axis
3. (Optional) Check the Show grid check box to display a grid on the chart.
If you clear the check box, you have completed configuration of this tab.
4. Configure the gridline by selecting the:
A. Color
B. Style
C. Width, if the line style is solid. If it is not solid, the width is fixed.
5. 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.
Runtime Actions
Whether or not an operator can access one or more of the tabs or even open the CIMPLICITY
Trend Control Properties dialog box during runtime is under your control.
Export to
reference file...
enabled during
runtime
2-36 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
3. Check the Show property pages at runtime check box to let an operator open the
CIMPLICITY Trend Control Properties dialog box during runtime. If you clear the
check box, you have completed configuration of this tab.
4. Check the tabs that an operator can change during runtime in the Pages enabled at
runtime box.
Important: It you are using a reference file, you need to enable at least the Runtime Actions
tab so the operator can export data to the reference file. It is on this tab that the export button,
which is disabled during configuration, is enabled during runtime.
Basic Palette
2-38 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Color Palette: To create Customized Color
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.
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 drop-down list button 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.
2-40 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Choosing a Font
Whenever you have to specify a font and its characteristics in Trending, you can do so in a
basic Windows 95/NT Font dialog box.
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-1260F 3-1
Y-axis
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.
Visual Aids
ResetZoom Reset zoom in the Trend Control to 100%.
SetGridState Change the grid visibility for the Trend Control.
Wait State
EnableOutstandingLoggedRequestStateEvents
Enables the firing of logged data wait state
events in the Trend control.
DisableOutstandingLoggedRequestStateEvents
Disables or turns off the firing of logged data
request wait state events in the Trend control.
Other
AboutBox Display the Help About dialog box for the
CIMPLICITY Trend Control.
SetCimplicityProject Set the CIMPLICITY project for the Trend
Control.
In addition to methods, Trending offers you a list of events you can select in CimView as
events of type ActiveX Event.
An event is a way for the Trend object to notify CimView that something has occurred.
You can use one or all of the following events to perform an action in CimView when they
occur:
3-2 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Method Configuration
Naming A Trend Control
Before you can invoke a method for a Trend control, the control must have its Object name
defined.
Example: Entry in Edit Method Dialog Box for an Invoke Method Action
Expresion
dialog box
Point ID
popup
Expresion
dialog box
Point ID
popup
Method’s
parameters Parameter Enter the value format specified in the Type
type column
é No–Not optional–An
é Disabled–Setpoint not allowed
entry is required in
é Selected–Enter a single writeable Point ID
the Value column
in the Value field
é Yes–Optional
é Cleared–Enter a Point ID or an expression
in the Value field
3-4 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
2. Enter an expression in the Value column that will pass as the argument for each
argument in the Name column. Your options are:
A. You must make an entry for each parameter that has a No in the Optional box.
If the argument is optional, you will see Yes in the Optional box.
Choose one of the following to pass argument values to a method:
Type Enter
Integer An expression or Point ID that evaluates to a numeric
value.
String Choose one or a combination of the following:
1. Point ID that refers to a text point
2. Constant string enclosed in double quotes
3. If/Then/Else condition where:
If is A (from either 1 or 2 on the list)
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:
AddLoggedLine Method
Purpose: To add a specified logged line to the runtime Trend Control when Invoke Method is
triggered by an event.
Lines using Logged data display data from a CIMPLICITY Database Logger group
table. This type of trend is also called a historical trend because all the information
comes from logged data.
3-6 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
(Optional) A setpoint that contains the status
value–device or global Point ID–Boolean point Setpoint not allowed
A.
B.
Note: The source for a Logged line is always a column in a group log table. For more
information about group log tables, see Using the Database Logger in the CIMPLICITY HMI
for Windows NT and Windows 95 Base System User’s Manual (GFK-1180).
2. Click Advanced.
The Edit Method dialog box opens displaying AddLoggedPointLine.
A.
B.
C.
3-8 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
3. Enter the following:
A. A string that provides a name for the Line ID. The name will appear in the
legend to identify the added line.
B. A string that evaluates to a Point ID. Trending creates the trend based on the
specified point’s values.
C. Strings that Trending will evaluate to find the:
• ODBC data source in which CIMPLICITY will find the table and column
for the line display. If you require a User ID and password enter them on
this line.
Including "DSN=" is optional. In either case, the UID= and PWD= must
appear after the DSN.
Example
Either of the following is correct:
“CIMPLICITY Point Logging;UID=Administrator;PWD=98403”
"DSN=CIMPLICITY Point Logging;UID=Administrator;PWD=98403”
• Table in the Database Logger where the line data will be found.
• Column in the Database Logger table that contains the line’s data.
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 was successfully added to the trend.
0 The line was not added to the trend.
Note: The source for a Logged line is always a column in a group log table. For more
information about group log tables, see "Using the Database Logger" in the "CIMPLICITY
HMI for Base System User’s Manual" (GFK-1180).
2. Click Advanced.
The Edit Method dialog box opens displaying AddPointLine.
A.
B.
A. Point to trend.
Entry is required B. Identifies line, in legend
3. Enter the following:
A. A string that provides a name for LineID. The name will appear in the legend to
identify the added line.
B. A string that evaluates to a Point ID. Trending creates the trend based on the
identified values.
3-10 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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 was successfully added to the trend.
0 The line was not added to the trend.
DeleteTrendLine Method
Purpose: To delete a specified point line from the runtime Trend Control when Invoke Method is
triggered by an event.
2. Click Advanced.
The Edit Method dialog box opens displaying DeleteTrendLine.
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.
SetLineAutoupdate Method
Purpose: To change the autoupdate status of one or all non-point lines on the Trend Control.
2. Click Advanced.
The Edit Method dialog box opens displaying SetLineAutoupdate.
A.
B.
3-12 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
3. Enter the following:
A. One of the following to identify what line or lines should be automatically
updated.
Value Identifies
“” All non-point lines on the chart
String for a Line ID The line to autoupdate
B. An expression or Point ID for nOffOnToggle that evaluates to the numeric
value:
Value Trending will:
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.
SetLineDisplay Method
Purpose: To set the color, compression and expansion, and display method for a particular Line ID.
2. Click Advanced.
The Edit Method dialog box opens displaying SetLineDisplay.
A.
B.
C.
D.
3-14 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Value Method Result
1 The change was successfully made.
0 The change was not made.
(255) +
(105 * 256) +
(255 * 65536) = 16738815
3-16 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
SetLineVisible Method
Purpose: To change one or all lines on the Trend Control visible or invisible.
2. Click Advanced.
The Edit Method dialog box opens displaying SetLineVisible.
A.
B.
Note: When the line is made invisible, it is removed from the chart. If you did not check the
Always visible legend option, the line description is also removed from the legend.
Even thought the line is removed from the display, the Trend Control still collects data and
performs calculations for the line.
WriteReferenceFile Method
Purpose: To write data for all lines on the chart to the reference file you designate.
Important: This method is available only on Intel Windows 95 and Intel Windows NT
platforms.
2. Click Advanced.
The Edit Method dialog box opens displaying WriteReferenceFile.
3-18 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
(Optional) A setpoint containing the status
value–device or global–Analog point
Setpoint not allowed
A.
B.
C.
D.
SetLegendState Method
Purpose: To change the visibility of the legend for the trend.
2. Click Advanced.
The Edit Method dialog box opens displaying SetLegendState.
0 – Legend off
Entry is required 1 – Legend on
3-20 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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
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 Advanced.
The Edit Method dialog box opens displaying JumpToCurrentTime.
3. Enter one of the following for LineID to name what lines should jump to the current
time.
Entry Identifies
“” All X-axes with runtime and/or auto updating lines
Existing Line ID The X-axis associated with the line
4. (Optional) Enter a Method result. Use a Point ID in the Analog Point Class with a
Data Structure Type of BOOL. You can use a device or global Point ID.
When you invoke the method, the Method result contains the number of lines that
jumped to the current time.
3-22 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
PauseUpdates Method
To pause or resume updates in the trend.
2. Click Advanced.
The Edit Method dialog box opens displaying PauseUpdates.
(Optional) A setpoint that contains the status
value–device or global Point ID– Boolean
point Setpoint not allowed
0 – resume trending
Entry is required 1 – pause the trend
2 – toggle the current pause
state
2. Click Advanced.
The Edit Method dialog box opens displaying ScrollLines.
A.
B.
A. 0 – scroll left
Entry is required 1 – scroll right
B. Percent scroll
between 0 and100
3. Enter the following:
A. An expression or Point ID for NLeftRight that evaluates to one of the following
numeric values:
Value Trending will:
0 Scroll left
1 Scroll right
B. An expression or Point ID for nPercent that evaluates to a percentage value
between 0 and 100.
3-24 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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 Parameters are good and scroll performed.
0 Parameters are bad.
SetXDuration Method
Purpose: To change the X-axis duration settings for a single line or all lines on the chart that use the
chart X-axis and scrolls lines to beginning of chart.
2. Click Advanced.
The Edit Method dialog box opens displaying SetXDuration.
A.
B.
SetXStartTime Method
Pupose: To specify a start time of the X-axis for the chart or indicated line and redraw the trend.
2. Click Advanced.
The Edit Method dialog box opens displaying SetXStartTime.
3-26 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
(Optional) A setpoint that contains the status
value–device or global Point ID– Boolean point Setpoint not allowed
A.
B.
C.
A. Identifies line for x-axis
duration change
Entry is required
B. mm/dd/yy hh:mm:ss AM/PM
C. To the millesecond
SetLineYAxis Method
Purpose: To change the Y-axis settings for a single line or all lines that use the chart Y-axis.
2. Click Advanced.
The Edit Method dialog box opens displaying SetLineYAxis.
3-28 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
(Optional) A setpoint that contains the status
value–device or global Point ID– Boolean point Setpoint not allowed
A.
B.
C.
D.
SetYAxisVisible Method
Purpose: To change the visibility of one or all Y-axes on the Trend Control.
2. Click Advanced.
The Edit Method dialog box opens displaying SetYAxisVisible.
A.
B.
3-30 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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.
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.
SetLineUseChartY Method
Purpose: To change the line’s Y-axis to either the Chart Y Axis or an axis whose ID is the line’s ID
plus a _Y suffix.
2. Click Advanced.
The Edit Method dialog box opens displaying SetLineUseChartY.
A.
B.
3-32 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Visual Aid Methods
Trending provides you with the following methods to let a Trend user use visuals aids when
looking at the chart.
Invoke method
Method On the CimView Trend Chart, to:
ResetZoom Reset zoom in the Trend Control to 100%.
SetGridState Change the grid visibility for the Trend Control.
ResetZoom Method
Purpose: To reset the zoom on a trend to 100%.
SetGridState Method
Purpose: To change the grid visibility for the Trend Control.
2. Click Advanced.
The Edit Method dialog box opens displaying SetGridState.
0 – Grid off
Entry is required 1 – Grid on
3-34 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Wait State Methods and Events
Trend has an option to fire events that allow you to know if the Trend control is
waiting for logged data from the database. One of the events is fired when the Trend
enters a state where the Trend is waiting for logged data that is taking longer than a
configurable threshold (in seconds). Once the data is received, another event is fired
to let the screen know that the Trend has left the waiting state.
These events are particularly useful when retrieving data that takes a long time to
retrieve so that the CimView screen can either disable buttons or have a flashing
light that lets the user know that the Trend is working on getting the data.
The following methods allow you to enable or disable the wait state events:
Invoke method
Method On the CimView Trend Chart, to:
EnableOutstandingLoggedRequestStateEvents
Enables the firing of logged data wait state events in the
Trend control.
DisableOutstandingLoggedRequestStateEvents
Disables or turns off the firing of logged data request wait
state events in the Trend control.
EnableOutstandingLoggedRequestStateEvent Method
Purpose: To enable the firing of logged data wait state events in the Trend control.
2. Click Advanced.
The Edit Method dialog box opens displaying
EnableOustandingLoggedRequestStateEvent.
A.
B.
A. Seconds Trend checks logged
requests outstanding for longer
Entry is required
than the threshold
B. Seconds that request is
outstanding
DisableOutstandingLoggedRequestStateEvent Method
Purpose: To disable the firing of logged data wait state events in the Trend control.
3-36 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
EnteringOutstandingLoggedRequestState Event
Purpose: Fired when the Trend control has determined that it has logged data requests that have been
outstanding (waiting) for longer than the number of seconds determined by the threshold.
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.
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-38 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Other 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.
SetCimplicityProject Method
Purpose: To set the CIMPLICITY project that will be used by the Trend Control when it displays
data.
2. Click Advanced.
The Edit Method dialog box opens displaying SetCimplicityProject.
Project name
Entry is required
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-40 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Creating a Quick Trend
GFK-1260F 4-1
Workbench Popup for Quick Trend
4-2 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Configuring a Quick Trend Chart
Quick Trends offers you the same CIMPLICITY Trend Control Properties dialog box that you
use in CimEdit.
To open the CIMPLICITY Trend Control Properties dialog box in Quick Trends:
1. Select Edit on the Quick Trends menu bar.
2. Select Properties.
3. The CIMPLICITY Trend Control Properties dialog box opens.
4. Configure the chart the same as you would through CimEdit.
5. (Optional) Save the file, as follows:
A. Select File on the trend chart’s menu bar.
B. Select Save. The Save File dialog box open.
C. Select its directory.
D. Name the trend.
Example: Quick Trend After Several Configuration Changes Added lines
Changes include:
Chart color
Line:
w Color
w Style
w Width
Background color
Legend:
w Font
w Display
Status display
Note: The most recent four trends that are saved, appear on the File drop down menu
4-4 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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 effecty XY Plot.
You have considerable control over what an XY Plot displays and its appearance using any of
the tools that XY Plot provides.
• You can create an XY Plot that displays:
½ One or several XY series
½ One or more X,Y axes
½ Minimum detail so a user can view quickly view the pattern of relative values
½ All the details a user needs to fully analyze any of the XY series
• Allow a runtime user, for the one runtime session, specify what should display.
For display, you can choose the colors, line types and fonts that you think will work best.
GFK-1260F 5-1
XY Chart Configuration Options Example
Choose chart Display titles
Display yaxis ticks / Choose chart background color
numbers–Optional color Show/hide lines
Choose
Step, scatter
or
smooth curve
Choose line
style / color
Slider
5-2 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
You can also specify how the chart’s many display features will appear.
Display feature Other Configuration Options
Colors Change for several chart elements
Series Display the associated point or expression data
Axes Add or remove
Sliders Add or remove
Fonts Change the style and size
You configure this powerful feature in CimEdit and display it in CimView. The XY Plot is an
ActiveX control that you can configure as follows.
1. Insert the control into a CimEdit screen.
XY provides an XY toolbar button that you simply click.
2. Configure the chart's design.
A CIMPLICITY Plot Control dialog box provides a long list of design choices.
3. Specify runtime data criteria.
XY comes with XY properties and methods that you can use in scripts to manipulate
runtime. You can also design the chart by using scripts in addition to, or instead of,
the CIMPLICITY Plot Control dialog box.
If you want to begin with a chart that is pre-configured, you can take advantage of the XY
SmartObject. The SmartObject provides you with
GFK-1260F 6-1
Inserting an XY Plot Control
To insert the XY Plot control on a CimEdit screen:
1. Click the OLE button on the Tools toolbar.
2. Place the ActiveX Placement cursor where you want the top left corner of the control
to be located. You can move the control any time you want.
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 Manual–April 1999 GFK-1260F
The XY Plot control looks like this initially:
Increase width
Increase in proportion
Increase height
Method 2–Precision
1. Select Edit on the menu bar.
2. Select Properties.
Go to "Continue (after choosing from Methods 2-4)"
Method 3-Precision
Click the Properties button on the Format toolbar.
Go to "Continue (after choosing from Methods 2-4)"
6-4 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
The XY Plot Properties dialog box opens when you use any method.
Basic Palette
Palette tab Special tab
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.
6-6 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
D. Enter an exact value that specifies the amount of light in the color in the Lum
field.
0 = Black (The colors’ values will change to 0)
240 = White (The colors’ values will change to 255.
Any changes you make in this value will affect all the colors.
E. Specify how vivid the color specified by the balance of the three basic colors
should be in the Sat field.
0 = Gray
240 = No gray.
F. Specify the balance of red, green and blue that you want in the Hue field. This
balance is calculated against the values that are already in the Color fields.
4. Decide whether to use the exact color or the solid color displayed in the Color|Solid
box. possibilities are:
A. The exact color is the same as the solid color.
B. The exact color is dithered, a pattern of dots that simulates the color. Only the
solid portion of a dithered color will display in a pattern.
C. The solid color that is closest to exact color.
5. Select the option you want.
A. Double click the Solid side of the Color|Solid box to add the solid color. The
box changes to the solid color.
B. Click Add Color when in the Color|Solid box if:
Both the exact and solid display. The exact color will be selected.
Only the solid color displays. The solid color will be selected.
Modifying a Color
You can modify any color on the palette. If you choose a standard color to modify, the
customized color appears in the customized section of the palette.
To modify a color:
1. Click the drop-down list button 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.
2. Select the Font. If you use TrueType fonts, users can resize a screen in CimView and
still have the text display in proportion to the rest of the objects on the screen.
3. Select the 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.
6-8 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
XY Plot Foreground, Background and Chart Colors
For an XY Plot background, chart and foreground colors, you can:
• Specify the colors individually
• Use the ambient colors specified for the CimEdit screen on which you are
configuring the XY Plot.
Click the Palette button on
Colors Selected for an XY Chart Background and Foreground
each row to select a color
Background
Foreground
Chart
To use the CimEdit ambient colors for the XY Plot background, chart and
foreground colors:
1. Open the CIMPLICITY XY Plot Control Properties dialog box.
2. Specify the value as True for any of the following properties. (The default is True.)
UseAmbientBackgroundColor
UseAmbientChartColor
UseAmbientForegroundColor
6-10 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
XY Plot Axes Properties
XY Plots provides you with several options for configuring one or more X-axes and Y-axes.
.
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.
Step 3: Choose the location of and data flow direction along an X or Y-axis:
1. Select Orientation under X–Item or Y–Item to specify the location of the axis on an
XY Plot.
Orientation Orients the axis on a chart toward the:
apOrientationBottom Lower part. (X-axis only)
apOrientationLeft Left side. (Y-axis only)
apOrientationRight Right side. (Y-axis only)
apOrientationTop Upper side. (X-axis only)
6-12 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
2. Select the Direction in which data will flow.
Direction Specifies the flow or direction to be:
apDirectionForward Standard (Upward for a Y-axis, rightward for an X-
axis)
apDirectionBackward Alternate (Downward for a Y-axis, leftward for an X-
axis)
6-14 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Step 5: Design the line (pen) for an X or Y-axis:
1. Select Pen under X–Item or Y–Item.
B. Specify whether or not to display the Full Backward Scroll button, e.g.
when the X-axis is in the Forward direction.
6-16 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
D. Specify whether or not to display the Full Forward Scroll button,
e.g. when the X-axis is in the Forward direction.
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.
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.
a. Click the Font Dialog Box button and configure the font in the
Font dialog box. The font you configure will be used.
b.Set UseAmbientFont to True. The ambient font for the CimEdit screen
will be used.
B. Specify the title content.
i. Select Value.
ii. Enter the text that you want to display. The default is X Axis under the X
and Y Axis under the Y.
C. Select True for Visible in the tree under Title to display the title. The default is
True.
4. Select True for Visible (in the path under X–Item or Y–Item) to display the axis. The
default is True.
6-18 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Step 10: (Optional) Remove axes:
Remove all X or Y-axes
1. Select Item.
2. Click the right mouse button.
3. Select Remove All.
Important: When you select Remove All or Remove, XY Plot immediately makes the
removal. It does not wait for you to click the Apply button. Therefore, select those two
options very carefully. (If you saved the CimEdit screen before you accidentally remove an
item, close the CIMPLICITY XY Plot Control Properties dialog box and the CimEdit screen
without saving it. The screen will re-open with the last saved features, including the features
you removed.)
Designing a Series
Following are some quick steps to customize every property for a series.
Step 1: Add additional series.
Step 2: Configure properties that identify the series.Step 3: (Optional) Remove series.
Step 4: Expand the tree under Series. (You can collapse whatever you expand.)
Step 5: Expand a selected series.
Step 6: Select the type of series.
Step 7: Configure a fill (brush) for a series.
Step 8: Configure the markers.
Step 9: Configure the line (pen).
Step 10: Configure the X and Y-axes for the series.
Step 11: Specify if a series’ values should be in the legend.
6-20 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Step 12: (Optional) Enter X and Y values for the series.
6. Click OK.
A next number up from the number of existing series appears under Item.
Example
You had one Series. You add a second. The first series appears in the list under Item
as 0. The second will be listed as 1.
Automatically displays the total number
of series
7. Expand the new series and configure it using the same steps you used for the
previous series.
Important: When you select Remove All or Remove, XY Plot control immediately makes
the removal. It does not wait for you to click the Apply button. Therefore, select those two
options very carefully.
6-22 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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-24 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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-26 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
XY Plot Slider Properties
You can use a slider to:
• Select data on the chart for which you want values
• Move data backward and display data that might no longer be on the chart
• Move data forward
Designing a Slider
Following are four quick steps to customize every property for a slider.
Step 1: Expand the tree under Sliders. (You can collapse whatever you expand.)
Step 2: Expand a selected Slider..
Step 3: Select the Type of Slider.
Step 4: Configure the line (pen) for a slider.
Step 5: Specify the 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-28 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
apSliderHorizontal Interesected X data value shows. This is because a
horizontal slider moves across the Y axis. Therefore,
for each Y data value that the slider is at, you have an
X data value on the series data vector.
If there is more than one intersected X data value, the
data value that is displayed is the first intersected data
value found from the end to the beginning of the data
vector.
Style Displays
apPenDash
apPenDashDot
apPenDashDotDot
apPenSolid (Default)
4. Select line Width for the slider 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).
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-30 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Step 8: Configure properties to prioritize a slider and identify it:
1. Specify the Order of priority in which the slider will be addressed by the XY Plot.
The default is the lowest priority.
Example
The XY Plot has three sliders. You add a fourth.
The fourth sliders’ default order will be 3 (0, 1, 2, 3).
2. Enter a Name for the slider.
3. Leave Visible as True to display the slider; select False to hide it.
Important: When you select Remove All or Remove, XY Plot immediately makes the
removal. It does not wait for you to click the Apply button. Therefore, select those two
options very carefully.
6-32 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Method 2
A. Click the right mouse button.
B. Click the Expand popup menu.
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-34 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Designing the XY Plot Legends
Following are quick steps to customize every property for Series and Slider Legends.
Step 1: Expand the tree under Legends.
Step 2: Make the Legends visible.
Step 3: Specify the legends’ location (orientation) relative to the XY Plot.
Step 4: Design the Series legend.
Step 5: Design the Slider legend.
.
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
6-36 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
5. Configure the Series legend’s columns for the XY Plot’s series.
A. Expand Columns under Legends–Series.
The number of columns currently in the header appears (grayed out) in the
Count row. You can add additional columns or delete existing ones.
B. Expand Item.
Each number that appears represents a column in the order that it displays, from
left to right, e.g. 0 represents the column that is furthest left.
C. Set Visible to True to make the column visible; False to hide it.
D. Specify the type of series’ value that appears in the legend column. The options
are:
Option Shows the
apLegendColor Series color
apLegendSeriesName Series name
apLegendSeriesValueAtSlider Data value that is intersected by a particular
slider
apLegendSeriesValueAtIndex Data value at a particular index in a series
data vector
E. Make specifications when apLegendSeriesValueAtIndex is selected.
i. Select True for ShowX to display the series’ X values; False to display the
series Y values.
ii. Enter an Index value that contains the index to the series data value that
you want to display.
Example
If you enter 0 in the Index row, the column will display the first data value
(X or Y, depending on the value of ShowX.
F. Enter text that displays as the column header in the Header row. The text
normally describes the type of value the column is reporting.
G. Specify the column width.
Set AutoWidth to True to make the column width expand or contract to
accommodate the width of its values, or
Set AutoWidth to False and enter a value in the Width row.
A value of 1 is equivalent to 1/100th of a millimeter (when a CimView
screen is at 100% zoom).
H. Enter a number in the Order row that defines the order in which the column
should appear in the legend, from left to right. For example, 0 is the first column
at the left of the legend; 1 is to Column 0’s right.
I. Select a fill for a selected column.
i. Expand Brush under Column–Item <number>.
ii. Click the Palette button on the Color row to select a color.
6-38 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
D. Select a HatchStyle for the brush if you selected apBrushHatch as the type.
apHatchBackwardDiagonal
apHatchCross
apHatchDiagonalCross
apHatchForwardDiagonal
apHatchHorizontal
apHatchVertical
5. Configure the legend’s columns for the XY Plot’s slider.
A. Expand Columns under Legends–Slider.
The number of columns currently in the header appears (grayed out) in the
Count row. You can add additional columns or delete existing ones.
B. Expand Item.
Each number that appears represents a column in the order that it displays, from
left to right, e.g. 0 represents the column that is furthest left.
C. Set Visible to True to make the column visible; False to hide it.
D. Specify the type of 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.
6-40 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Designing an XY Plot Title
Following are three quick steps to customize an XY Plot title.
Step 1: Expand the tree under Title. (You can collapse whatever you expand.)
Step 2: Specify the title content.
Step 3: Configure the Font for the title.
Step 4: Make the title visible.
.
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
XY Plot Updates
When you make a change in an XY Plot, it automatically updates by default.
Turning of the automatic update stops a chart from being refreshed by your configuration.
However, other actions, such as moving the dialog box over the chart will invalidate the
current settings and cause the screen to refresh itself. This will update the chart to the most
current settings.
This feature is most useful if you are doing complicated scripting and want to minimize the
screen updates.
6-42 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Plotting XY Data
GFK-1260F 7-1
Example 2: Create a series through an object other than the XY Plot control
object:
Series name: Series 1 (displays in an XY Plot control object in a CimView screen)
Scripting purpose: Create a series through and object other than the XY Plot Control object
model
Procedure:
1. 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 Manual–April 1999 GFK-1260F
Resizing Series Vectors
CimPairData has a property called Count.
Count allows you to set the number of data values in both the X and Y vectors.
Scripting examples for resizing a series vector include:
7-4 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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.
3. Write the following Basic excerpt within a subroutine.
’ Define the point:
Dim x As New Point
x.Id = "X_POINT"
Example 3: Set individual data values from the series vectors to unavailable:
Series name: Series 1
Script purpose: Set the fourth y data value to null, the fourth X data value to empty
Both operations result in the value being unavailable.
Procedure:
1. Open the CimEdit Properties dialog box for the XY Plot control object.
2. Display the Edit Script tab.
Write the following Basic excerpt within a subroutine.
’ Set the fourth X and Y data values to unavailable
’ (either null or empty):
cimOleObj.Series("Series 1").Data.Y(3) = Null
cimOleObj.Series("Series 1").Data.X(3) = Empty
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.
7-6 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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
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"
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.
7-8 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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: Push arrays of X and Y values through the end of a series vectors
Series name: Series 1
Script purpose: Push the array values of two CIMPLICITY HMI 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_ARRAY_POINT"
Dim y As New Point
y.Id = "Y_ARRAY_POINT"
7-10 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
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 Manual–April 1999 GFK-1260F
Example for Single Points
To set the values of two single points
Option 1
Use the following format to set the values of single points using GetValue:
CimPairData.Set Index, Point.GetValue, Point.GetValue
Option 2
Use the following format to set the values of two points using a combination of Get and
Value:
Point.Get
CimPairData.Set Index Point.Value, Point.Value
Example for Array Points
To set the values of two array points:
Option 1
Use the following format to set the values of two points using GetSafeArray.
CimPairData.Set Index, Point.GetSafeArray, Point.GetSafeArray
Option 2
Use the following format to set the values of two points using a combination of Get and
SafeArray.
Point.Get
CimPairData.Set Index, Point.SafeArray, Point.SafeArray
Scripting examples for setting values from single points and array points include:
7-14 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Using XY Plot SmartObjects
GFK-1260F 8-1
XY Plot SmartObject Placement
The XY Plot SmartObject is in the Object Explorer.
8-2 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
XY Plot SmartObject Configuration
The SmartObject Plot Control provides you with several tabs on which you can quickly
configure an XY Plot Control. You can, of course, change all of the defaults. However, you
will frequently discover that you need to modify very few options to get a meaningful XY
Plot Control up and running.
The XY Plot SmartObject dialog box tabs represent the main features you will configure for
the XY Plot Control. The tabs are for an XY Plot are:
• Series
• Axes
• Name and colors
• Grid
When you finish your initial configuration, you can easily modify or enhance the Plot Control
whenever you want.
Series box
Add a series
Delete a series
Move a series in
Series data
the list
w Up
w Down
Update criteria
X and Y-axis
assignments
8-4 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
B. Select a point to represent the expression or be included in an expression.
i. Click the Select a Point button to the right of the X Expression field.
ii. Select a Point ID.
iii. (Optional) Enhance the Point ID with an expression operator found in the
CimEdit.
Example
Point ID can be \\CIMPDEMO\DEV1550
Point ID in an Expression can be SQR(\\CIMPDEMO\DEV1550)
2. Configure the Y-axis expression by repeating the procedure to configure the X-axis
expression.
3. Specify the Expression Update method. the options are:
Timed Enter the number of one of the following options
found in the drop down menu:
Milleseconds (Ms)
Seconds (Sec)
Minutes (Min)
Hours (Hour)
On X expression update How frequently the X expression updates depends
how the expression values are configured. e.g. A
Point ID that is updated On Change, will update the
XY Plot Control whenever it changes.
On Y expression update How frequently the Y expression updates depends
how the expression values are configured. e.g. A
Point ID that is updated On Change, will update the
XY Plot Control whenever it changes.
Solid (Default)
Dashed
Dotted
Dashed-Dotted
Dashed-DoubleDotted
Axis location
Show X Axes
Show Y Axes
8-6 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Step 1: Select an X and Y-axis for configuration:
1. Click the Axes button on the bottom of the Series tab.
The Axes tab displays with Axis0 displaying in the Axis box.
2. Check either the Show X Axes or Show Y Axes check box.
The Axis0 represents the axis you select, e.g. if you checked the Show X Axes
checkbox, Axis0 becomes the X-axis.
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 Manual–April 1999 GFK-1260F
Step 7: Apply your configuration:
1. Click the Grid button on the bottom of the Chart tab in the XY Plot
SmartObject dialog box.
The Grid tab of the XY Plot SmartObject dialog
2. Check the Show Grid check box to display the grid on the XY Plot Control.
3. Select the Style from the Style drop down menu.
½ Solid–Select the line width in the Width drop down menu if you choose this
option
½ Dashed
½ Dotted (default)
½ Dash Dotted
½ Dash Double Dot
4. Configure the grid's density.
A. Enter the number of vertical ticks (lines) that should display for the XY Plot
Control grid in the Vertical field.
B. Enter the number of horizontal ticks (lines) that should display for the XY Plot
Control grid in the Horizontal field.
5. Click the Match Axes button to display the two horizontal and two
vertical grid lines.
8-10 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
XY Plot SmartObject Enhancements
Using the XY Plot SmartObject dialog box, you can create an XY Plot Control that will
display the data you specify during runtime. You may, however, want to modify and enhance
your configuration. You can easily make modifications and enhance your chart without using
scripts. You can either:
1. Re-open the XY Plot SmartObject dialog box by double clicking the XY Plot
Control, or
2. Open the .
A. Click the right mouse button over the XY Plot Control.
B. Select CIMPLICITY XY Plot Control Object from the popup menu.
C. Select Properties from the extended menu.
The following example displays two views of the same values.
Each chart was configured first in the XY Plot SmartObject dialog box and then enhanced
through the CIMPLICITY XY Plot Control Properties dialog box.
See the beginning of this chapter for detailed information about the XY Plot SmartObject
dialog box.
See the chapter "Designing an XY Plot" for detailed information about the options available
in the CIMPLICITY XY Plot control Properties dialog box.
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
A quick description of how to create each chart can clearly demonstrate how to use the XY
Plot Control dialog boxes in order to quickly achieve the display you want. The examples
were created to help you become familiar with the process. They include only a few of the
many configuration options available to you.
The Point ID’s used in the example are connected to a local PLC. You can use any Point ID
that is active in your project.
Following are the steps followed to create:
• Plot 1 and
• Plot 2.
8-12 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
XY Plot: Standard Example
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
Step 2: Enhance Plot 1 using the CIMPLICITY XY Plot Control Properties dialog
box:
1. Click the right mouse button over the XY Plot Control.
2. Select CIMPLICITY XY Plot Control Object from the popup menu.
3. Select Properties from the extended menu.
4. Select Chart Color.
5. Select the turquoise color from the chart color palette.
6. Modify the Series.
A. Expand Series.
B. Expand Item
C. Expand Pen.
D. Select Color.
E. Select the navy blue color on the pen color palette.
F. Select Width.
G. Enter 25.
7. Modify the Fonts.
A. Modify the Title font.
i. Expand Title.
ii. Select Font.
iii. Specify Arial, Bold, 10.
B. Modify the Axes fonts.
i. Expand X.
ii. Expand Item
iii. Expand Ticks.
8-14 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
iv. Select Font.
v. Select Arial, Regular 9 in the Font dialog box.
vi. Expand Y.
vii. Expand Item.
viii. Expand Title.
ix. Select Font.
x. Select Arial, Bold, 10 in the Font dialog box.
xi. Expand Ticks.
xii. Select Font.
Select Arial, Regular 9 in the Font dialog box.
8. Click OK.
9. Test the chart in runtime.
8-16 CIMPLICITY HMI Trend and XY Chart Operation Manual–April 1999 GFK-1260F
Step 2: Enhance Plot 2 in the CIMPLICITY XY Plot Control Properties dialog
box:
1. Click the right mouse button over the XY Plot Control.
2. Select CIMPLICITY XY Plot Control Object from the popup menu.
3. Select Properties from the extended menu.
4. Select Chart Color.
5. Select the light green color on the Plot color palette.
6. Modify the Series.
A. Expand Series.
B. Expand Item.
C. Select Type.
D. Select apSeriesScatter.
E. Expand Markers.
F. Select Type.
G. Select apMarkerSquare.
H. Select Width.
I. Enter 75.
J. Expand Pen.
K. Select Color.
L. Select the navy blue on the pen color palette.
7. Modify the Axes Fonts.
A. Expand X.
B. Expand Item
C. Expand Ticks.
D. Select Font.
E. Select Arial, Regular 9 in the Font dialog box.
F. Expand Y.
G. Expand Item.
H. Expand Title.
I. Select Font.
J. Select Arial, Bold, 10 in the Font dialog box.
K. Expand Ticks.
L. Select Font.
M. Select Arial, Regular 9 in the Font dialog box.
8. Click OK.
9. Test the Plot Control in runtime.
GFK-1260F i
For an XY Plot 8-5 C
apSeriesStep
For an XY 6-23 Change Limits
For an XY Plot 8-5 And x-axis timing 2-22
apSliderHorizontal Changing chart properties at run-time 1-5
For an XY 6-29 Chart
apSliderVertical Configure advanced properties 2-31
For an XY 6-28 Configure properties 2-29
Arguments Properties 2-29
Invalid 3-5 Chart Color 2-29
Array ChartColor
Point trends 2-37 For XY 6-9
Trend a single element 2-37 Choose
Trend at a single instant in time 2-37 A font 2-41, 6-8
Array Points Color
Push values for a series 7-8 Ambient for XY 6-10
Arrays And 2-7
Scrolling 1-9 And quick line configuration 2-6
Auto Update 6-42 And the y-axis 2-28
Logged line 2-9 Background on a chart 2-29
Auto Update Interval 2-29 Chart 2-29
Autoupdate Create custom 2-38, 6-6
A trend line 3-12 For an XY series line 6-24
Axes Foreground on a Chart 2-29
Configure with XY Plot SmartObject 8-6 Modifying 2-40, 6-7
Configured for an XY series 6-25 Of gridlines 2-35
Designing for an XY 6-11 Of XY grid line 6-33
Finding the properties for an XY 6-11 Select a basic color 2-38, 6-5
Name 6-18 Column ID
Prioritized on an XY 6-18 And CSV file lines 2-12
Properties on XY 6-11 Logged line 2-9
Title 6-18 Common Time Stamp
Title visible on an XY 6-18 And CSV file lines 2-12
Axis Format for CSV lines 2-13
Mapping to a line 2-19 Compression
Properties 2-21 For a line 2-18
Configure
Basic chart properties 2-29
B Begin for axis 2-21
Background Color on a Chart 2-29 CSV file line 2-12
BackgroundColor Detailed x-axis 2-24
Designing for XY 6-9 Expression line 2-8
Backward Logged expression line 2-10
Scroll buttons on an XY 6-16 Logged line 2-9
BackwardScroll Reference file 2-15
For an XY Plot axis 6-16 X-axis timing 2-22
BOOL XY Smart Object Plot Control axes 8-6
Valid range 3-5 XY Smart Object Plot Control series 8-3
Brush Y-axis 2-25
For an XY series 6-23 Y-axis details 2-27
BSTR Configured X Axis
Valid range 3-5 And mapping axes to lines 2-20
Buttons Configured Y Axis
Backward and forward scroll for an XY 6-16 And mapping axes to lines 2-20
Content
GFK-1260F Index v
Axes on an XY 6-18 Push
Priority One or more data values 7-5
Selected y-axis limits options 2-26 Values from Points 7-8
Procedure
Adding a point line method 3-10 Q
Basic for invoking a method 3-3, 3-4
Begin axis configuration 2-21 Qualified
Change the display style of a line 2-18 Points and expression lines 2-8
Configure a logged expression line 2-10 Points and logged expression lines 2-11
Configure a logged line 2-9 Quick Lines
Configure a reference line from a reference file 2-15 Creating 2-5
Configure an expression line 2-8
Configure basic chart properties 2-29 R
Configure CSV file line 2-12
Configure x-axis details 2-24 Ranges
Configure y-axis limits 2-25 Valid for each point type’s parameters 3-5
Create a custom color 2-38, 6-6 Reference File 2-15
Detailed y-axis configuration 2-27 Example 2-17
Disable expression line scrolling 2-8 Reference Line 2-14
Disable expression logged line scrolling 2-10 Relative Time
Display gridlines on a chart 2-35 Specified for an XY 6-14
Enable/disable properties dialog box tabs ResetZoom trend method 3-33
for runtime 2-36 Resize
For adding a logged line method 3-6 New Trend Control chart 2-2
For adding a logged point line method 3-8 New XY Plot control 6-3
For automatically updating a line method 3-12 Series vectors 7-3
For deleting a line method 3-11 Restrictions
Insert an XY Plot control in a CimEdit Screen 6-2 Reference file name 2-16
Insert aTrend Control chart on a CimEdit Screen 2-1 Restrrictions
Modify a color 2-40, 6-7 On SetLineAutoupdate method 3-12
Open advanced dialog box for chart properties 2-31 Runtime Actions
Quickly create a line 2-5 And a reference file line 2-15
Resize a new XY Plot control 6-3 RuntimeActions
Select a basic color 2-38, 6-5 Enable or disable 2-36
Specify a font for a trending text item 2-41
Specify a font for an XY Chart text item 6-8 S
Specify how lines appear on a trend chart 2-6
specify what axis will explain a trend line 2-19 Scatter
Trend a single element in an array 2-37 Series for an XY 6-23
Trend an entire array at a single instant in time 2-37 Series for an XY Plot 8-5
Properties Scroll
Configure advanced for a chart 2-31 Buttons for an XY 6-16
Configured for a chart 2-29 Expression logged lines diaabled 2-10
Finding for an XY Plot series 6-20 Scroll Buttons
Finding for an XY Plot slider 6-27 Visible on an XY 6-16
Finding for an XY grid 6-32 Scrolling 1-8
Finding for XY Plot axes 6-11 Disable for expression line 2-8
For a chart’s legend 2-33 Disable for logged expression line 2-10
For a grid 2-35 Disable for the x-axis 2-24
Grid on an XY 6-32 Scrolling behavior
Of XY Plot title 6-40 Arrays 1-9
Slider on XY 6-27 ScrollLines trend method 3-24
That identify an XY series 6-22, 6-27 Select
XY axes on XY 6-11 A basic color 2-38, 6-5
viii CIMPLICITY HMI Trending and XY Chart Operation Manual–April 1999 GFK-1260F
X
X-axis
Designing for an XY 6-11
Finding properties for an XY 6-11
Prioritized on an XY 6-18
Properties on an XY 6-11
X-Axis
Configure timing 2-22
Detailed Configuration 2-24
XY Plot SmartObject
Configuring overview 8-3
Overview 8-1
Placing 8-2
XY Plots
Overview 5-1
Overview of features 5-2
Y
Y-axis
Designing for an XY 6-11
Finding properties for an XY 6-11
Prioritized on an XY 6-18
Properties on an XY 6-11
Y-Axis
Configuration 2-25
Configure limits 2-25
Detailed configuration 2-27
Display multiple 2-31
Display single 2-31
Percent configured 2-31
Priority of limits types 2-26
Z
Zooming 1-6
GFK-1260F Index ix