gfk1260f - cimplicity hmi trend and xy chart

GE Fanuc Automation

CIMPLICITY Monitoring and Control Products

CIMPLICITY HMI

Trend and XY ChartOperation Manual

GFK-1260F April 1999

ii Preface GFK-1260F

GFL-002

Warning

Warning notices are used in this publication to emphasize that hazardous voltages, currents, temperatures, or otherconditions 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.

NoteNotes 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 providefor every possible contingency in connection with installation, operation, or maintenance. Features may be describedherein which are not present in all hardware and software systems. GE Fanuc Automation assumes no obligation ofnotice 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 assumesno responsibility for the accuracy, completeness, sufficiency, or usefulness of the information contained herein. Nowarranties of merchantability or fitness for purpose shall apply.

CIMPLICITY is a registered trademark of GE Fanuc Automation North America, Inc.Windows, Windows NT and Windows 95 are registered trademarks of Microsoft Corporation

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

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

GFK-1260F iii

Preface

Contents of this ManualChapter 1. Introducing Trends: Gives a brief description of CIMPLICITY HMITrending.

Chapter 2. Creating A Trend Chart: Shows how to create a trend chart on aCimEdit screen.

Chapter 3. Trend Methods: Describes methods available for Trending and how toimplement them on a CimEdit screen.

Chapter 4. Creating a Quick Trend: Describes how to quickly trend a pointthrough the CIMPLICITY HMI Workbench

Chapter 5. Introducing XY Charts: Gives a brief description of CIMPLICITYHMI XY Charts

Chapter 6. Designing an XY Chart: Describes how to design an XY Chart indetail by using the XY Control Properties dialog box.

Chapter 7. Using XY SmartObject Charts: Describes how to quickly design aneffective XY Chart.

Related PublicationsFor more information, refer to these publications:

CIMPLICITY HMI Base System Users Manual (GFK-1180)

GFK-1260F v

ContentsIntroducing Trends 1-1

Trend Introduction ................................................................................................................. 1-1About Trends.......................................................................................................................... 1-1Trend Chart Display............................................................................................................... 1-2Runtime Actions..................................................................................................................... 1-5

Changing Chart Properties at Runtime..................................................................... 1-5Zooming into a Specific Area .................................................................................. 1-6Analyzing Data at a Selected Point in Time............................................................. 1-7Scrolling Lines Forward and Backward................................................................... 1-8

Configuring A Trend Chart 2-1About Trend Charts................................................................................................................ 2-1

Inserting a Trend Chart Control Chart ..................................................................... 2-1Resizing a New Trend Control Chart ....................................................................... 2-2

The CIMPLICITY Trend Chart Properties Dialog Box......................................................... 2-4Opening the CIMPLICITY Trend Chart Properties Dialog Box ............................. 2-4

Trend Control Line................................................................................................................. 2-5Using Quick Lines to Create a Trend Chart Line..................................................... 2-5Creating a New Trend Chart Line (Overview of Detailed Method)......................... 2-6Configuring an Expression Line............................................................................... 2-8Configuring a Logged Line ...................................................................................... 2-9Configuring a Logged Expression Line ................................................................. 2-10Configuring a CSV File Line ................................................................................. 2-12Configuring a Reference Line ................................................................................ 2-14Specifying Line Display Styles .............................................................................. 2-18Mapping Axes to a Line......................................................................................... 2-19

Axis Configuration ............................................................................................................... 2-21Configuring the X-axis........................................................................................... 2-21Configuring the Y-axis........................................................................................... 2-25

Chart Properties.................................................................................................................... 2-29Configuring Basic Chart Properties ....................................................................... 2-29Configuring Advanced Chart Properties ................................................................ 2-31

Legend Properties................................................................................................................. 2-33Grid Properties ..................................................................................................................... 2-35Runtime Actions................................................................................................................... 2-36Array Point Trends............................................................................................................... 2-37Color and Font Choices on a Trend Chart............................................................................ 2-38

Selecting a Basic Color .......................................................................................... 2-38Creating a Custom Color........................................................................................ 2-38Modifying a Color.................................................................................................. 2-40Choosing a Font ..................................................................................................... 2-41

vi CIMPLICITY HMI Trending and XY Chart Operation ManualApril 1999 GFK-1260F

Trend Methods 3-1About Trend Methods ............................................................................................................ 3-1Method Configuration ............................................................................................................ 3-3

Naming A Trend Control ......................................................................................... 3-3Creating an Invoke Method Action .......................................................................... 3-3

Line Display Methods ............................................................................................................ 3-6AddLoggedLine Method .......................................................................................... 3-6AddLoggedPointLine Method.................................................................................. 3-8AddPointLine Method............................................................................................ 3-10DeleteTrendLine Method ....................................................................................... 3-11SetLineAutoupdate Method ................................................................................... 3-12SetLineDisplay Method.......................................................................................... 3-13SetLineVisible Method .......................................................................................... 3-17WriteReferenceFile Method................................................................................... 3-18

Methods for the Legend........................................................................................................ 3-20SetLegendState Method ......................................................................................... 3-20

X-axis (Time Related) Methods ........................................................................................... 3-21JumpToCurrentTime Method................................................................................. 3-21PauseUpdates Method............................................................................................ 3-23ScrollLines Method................................................................................................ 3-24SetXDuration Method ............................................................................................ 3-25SetXStartTime Method .......................................................................................... 3-26

Y-axis Methods .................................................................................................................... 3-28SetLineYAxis Method............................................................................................ 3-28SetYAxisVisible Method ....................................................................................... 3-30SetLineUseChartY Method .................................................................................... 3-31

Visual Aid Methods.............................................................................................................. 3-33ResetZoom Method................................................................................................ 3-33SetGridState Method.............................................................................................. 3-33

Wait State Methods and Events............................................................................................ 3-35EnableOutstandingLoggedRequestStateEvent Method.......................................... 3-35DisableOutstandingLoggedRequestStateEvent Method......................................... 3-36EnteringOutstandingLoggedRequestState Event.................................................... 3-37LeavingOutstandingLoggedRequestState Event .................................................... 3-38

Other Methods...................................................................................................................... 3-39AboutBox Method.................................................................................................. 3-39SetCimplicityProject Method................................................................................. 3-39

Creating a Quick Trend 4-1About Quick Trends ............................................................................................................... 4-1

Starting Quick Trends .............................................................................................. 4-1Configuring a Quick Trend Chart ............................................................................ 4-3Using Popup Menus to Make Quick Changes.......................................................... 4-4

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

GFK-1260F Index vii

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

Inserting an XY Plot Control ................................................................................... 6-2Resizing a New XY Plot Control ............................................................................. 6-3Opening the CIMPLICITY XY Plot Properties Dialog Box ................................... 6-4

Color and Font Choices for an XY Plot Control .................................................................... 6-5Selecting a Basic Color ............................................................................................ 6-5Creating a Custom Color.......................................................................................... 6-6Modifying a Color.................................................................................................... 6-7Choosing a Font ....................................................................................................... 6-8

XY Plot Foreground, Background and Chart Colors ............................................................. 6-9XY Plot Axes Properties ...................................................................................................... 6-11

Finding the Axes Properties ................................................................................... 6-11Designing XY Plot Axes........................................................................................ 6-11

XY Plot Series Properties..................................................................................................... 6-20Finding the Series Properties ................................................................................. 6-20Designing a Series.................................................................................................. 6-20

XY Plot Slider Properties..................................................................................................... 6-27Finding the Sliders Properties ................................................................................ 6-27Designing a Slider.................................................................................................. 6-27

XY Plot Grid Properties....................................................................................................... 6-32Finding the Grid Properties.................................................................................... 6-32Designing the Grid ................................................................................................. 6-32

XY Plot Legend Properties .................................................................................................. 6-34Finding the Legend Properties ............................................................................... 6-34Designing the XY Plot Legends............................................................................. 6-35

XY Plot Title Properties....................................................................................................... 6-40Finding the XY Plot Title Properties ..................................................................... 6-40Designing an XY Plot Title.................................................................................... 6-41

XY Plot Updates .................................................................................................................. 6-42

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

Creating a Series of Data Values ............................................................................. 7-1Scripting Examples for XY Plots ........................................................................................... 7-2

Resizing Series Vectors ........................................................................................... 7-3Setting Individual Data Values ................................................................................ 7-3Pushing one or more Data Values ............................................................................ 7-5Pushing Values from Points ..................................................................................... 7-8Setting one or more Data Values ............................................................................. 7-9Setting Values from Points..................................................................................... 7-12

Using XY Plot SmartObjects 8-1About XY Plot SmartObjects ................................................................................................. 8-1XY Plot SmartObject Placement............................................................................................ 8-2XY Plot SmartObject Configuration ...................................................................................... 8-3

Configuring the XY Plot SmartObject Series .......................................................... 8-3Configuring the XY Plot SmartObject Axes ............................................................ 8-6Configuring an XY Plot SmartObject Name and Colors ......................................... 8-9Configuring an XY SmartObject Grid ................................................................... 8-10

viii CIMPLICITY HMI Trending and XY Chart Operation ManualApril 1999 GFK-1260F

XY Plot SmartObject Enhancements.................................................................................... 8-11Configuring an XY Plot 1 Example ....................................................................... 8-12Configuring the Plot 2 Example............................................................................. 8-15

Index i

GFK-1260F 1-1

Introducing Trends

Trend IntroductionCIMPLICITY HMI provides you with the ability to look at data from several differentperspectives. The charts that enable you to do this are:

Trend chartsIn which you can review, evaluate and log point point values overtime

XY chartsIn which you can plot values for one or more series, using two or moreaxes.

About TrendsCIMPLICITY HMI provides you with extensive capabilities to trend data that is in severaldifferent 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 othercomparable data.

ArraysCIMPLICITY 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.

1-2 CIMPLICITY HMI Trend and XY Chart Operation ManualApril 1999 GFK-1260F

Trend Chart DisplayYou 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. Youcan also let a runtime user make changes during their runtime session.

Trend Chart Configuration Options

Display yaxis ticks /numbersOptional

Display legend titleOptional

Show/hide lines

Specifypercentscroll

Choose linestyle / color

ChooseStep orsmooth curve

Choose chartbackground color

Choose chartcolor

Display legendand specificdetailsOptional

Display x-axis ticks /numbersOptional

Display status barand specificdetailsOptional

Specify fontand style

Display sparse detail

Slider

Display page scrollOptional

GFK-1260F Introducing Trends 1-3

You can choose to display or hide:

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

For the X-axis

Grid GridlinesLines Each lineLegend Entire legendLegend 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 barStatus bar features Specific features:

Status line Current date Current time Status title Slider date Slider time


You can also specify how the charts many display features will appear.

Display feature Other Configuration OptionsChart area Choose the colorChart background Choose the colorGrid The number of horizontal and /or vertical linesLines Specify:

Style Color

Percent scroll buttons Specify the percent a line will scroll (forward / backward)when the buttons are pressed

Page scroll buttons Specify to display or hide themFonts Choose font, style and size

You configure this powerful feature in CimEdit and display it in CimView. Becauseit is a CIMPLICITY HMI ActiveX control, it has an easy to use CIMPLICITY TrendControl Properties dialog box. On six straightforward tabs, you can customize thetrend chart exactly to your specifications.


Runtime ActionsDuring runtime if you, the trend chart designer allow it, a user can change the amount of detailbeing viewed and even change the way it is displayed.

In addition a runtime user can easily:

Magnify (Zoom into) a specific area of the trend chart Analyze data at a selected point in time Scroll to data not currently on the chart

Changing Chart Properties at RuntimeThe trend chart designer can allow a runtime user to change any or all of the chart propertiesfor the specific runtime session.

To change a trend charts properties during runtime:1. Double click the trend chart. The CIMPLICITY Trend Control Properties dialog box

appears.2. Select the tab that contains the propertys configuration specifications.3. Change the propertys configuration.4. Apply the change by doing one of the following:

Move to a different tab in the dialog box. The changes made on the previous tabtake effect.

Click Apply. Changes on the current tab take effect. Click OK. All changes take effect and the CIMPLICITY Trend Control

Properties dialog box closes.

Important: The changes you make remain in effect while the trend is being displayed. If youclose the CimView window displaying the trend, then reopen it, the trend reverts to theoriginal properties configured for it in CimEdit.


Zooming into a Specific AreaWhen you display the chart, CIMPLICITY HMIs zoom feature lets you examine areas of thetrend more closely.

To zoom in on an area of the trend chart:1. Place the mouse cursor in the chart area at one corner of the area you wish to

examine in more detail.2. Hold down the left mouse key and slide the mouse cursor diagonally, making a

rectangle enclosing the area you wish to examine.3. Lift the mouse button.

The chart will be redrawn to display the area you selected in a scale that fits the chartarea.

Note: While you are zoomed in, the auto update and run-time timers are ignored. Thezoomed portion of the screen remains unchanged until you zoom out again, at which pointnew values are drawn and the timers are used again.

To return to your normal chart display:1. Place the mouse cursor in the chart area.2. Hold down the left mouse key and slide the mouse out of the trend control area.3. Lift the mouse button

The chart redraws in normal mode.


Analyzing Data at a Selected Point in TimeA slider is a vertical line that extends over the chart area. Every trend control chart has one. Ifthe chart legend displays the Y values, dates, and times, they will be updated as the slidermoves across the chart.

To use the slider:Method 1Move the slider

Point to the slider. (the cursor changes to when you are in position.) and drag the slider tolocation you want.

Method 2Attach the chart slider to the most recent update data:

Drag the slider off the right edge of the chart.

The slider will then attach to the most recently plotted data and move as new values areplotted.

Method 3Turn off the most recent update modeDo one of the following:

Drag the slider to a new position Zoom into an area Display the CIMPLICITY Trend Control dialog box


Scrolling Lines Forward and BackwardTrending provides four scroll buttons, two forward and two backward, to make it easy for theuser to view past trending information and to return to current trending.

Scrolling Options

To scroll one page:

Use the buttons to scroll backward or forward one page on the chart.

To scroll a percent of the visible chart:

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

The percent is specified by the trend control designer in the CIMPLICITY Trend ControlProperties dialog box. (in the Scroll Percentage field in the Advanced dialog box on theChart property tab)

Non-array Data ScrollingThe type of data line you are scrolling determines how much information you see when youscroll. Scrolling also behaves differently for non-array and array data.

Line Scrolled You will see:Point data from the current time:

Back to the past Only runtime data that has been accumulated upto one chart page worth of data. You cancontinue scrolling but no data is displayed whereit is not available.

Into the future No data because it has not been received yet.Logged point data:

Back to the past Runtime data that has been accumulated up toone chart page worth of data. Whenever runtimedata is not available, logged data is displayed, ifavailable.

Into the future No data because it has not been received yet.Logged or CSV data

Back to the past Data if it is available from the database or theCSV file.

Into the future Only logged data if it is available for that futuretime span


Array Data ScrollingIf 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 its X-axis with another line, the axis labels displayed are based on thetime span.

4. The space between the last element and the end of the chart is equal to the spacebetween the first two elements.The type of array line you are scrolling determines how much information you seewhen you scroll. Scrolling also behaves differently for non-array and array data.

Array Line Scrolled You will see:Point arrays from the current time:Current Available array values that are closest to the new

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

scroll is for the entire duration of the chart.Into the future No data because it has not been received yet.Logged point arrays

Current Available array values that are closest to the newX-axis end time, giving preference to runtimedata.

Back to the past Array (logged) values if they are available in thedatabase if the scroll is for the entire duration ofthe chart,

Into the future No data because it has not been received yet.Logged array data:Current Available array values that are closest to the new

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

time span.

GFK-1260F 2-1

Configuring A Trend Chart

About Trend ChartsTrend Control charts that you configure in CimEdit are viewed during runtime in CimView.Because the Trend chart control is a CIMPLICITY HMI ActiveX control, you can place it onany CimEdit screen by simply clicking the Trend button on the CimEdit toolbar.In addition, the CIMPLICITY Trend Control Properties dialog box provides you with tabs tocustomize every aspect of the trend chart.

The tabs in the CIMPLICITY Trend Control Properties dialog box are:

Line Displays the associated point or expression dataAxis Defines the X and Y axes on the Trend.Chart Defines the chart characteristics of the Trend.Legend Defines the chart legend for the Trend.Grid Defines the grid display for the Trend.Runtime Actions Let you perform runtime actions when viewing the chart

Inserting a Trend Chart Control ChartTo insert the Trend Chart Control on a CimEdit screen:Method 1

Click the Trend button on the OLE toolbar.

Method 2

1. Click the OLE button on the Tools toolbar.

2. Place the ActiveX Placement cursor where you want the top left corner of the controlto be located. You can move the control any time you want.

3. Click the left mouse button.

The Insert Object dialog box opens.4. Select the ActiveX tab.


5. Select CIMPLICITY Trend Control.

CIMPLICITY Trend Control

6. Click OK. A new Trend control is placed at the position you selected in yourCimEdit screen.

The Trend control looks like this initially:

Resizing a New Trend Control ChartYou can resize a trend control chart quickly and /or precisely.

To resize a trend control chart:Method 1Quick

1. Grab one of the objects handles and move it.

Increase in proportion

Increase width

Increase height

GFK-1260F Configuring A Trend Chart 2-3

Method 2Precision

1. Select Edit on the menu bar.

2. Select Properties.

Go to "Continue (after choosing from Methods 2-4)"Method 3-Precision

Click the Properties button on the Format toolbar.Go to "Continue (after choosing from Methods 2-4)"

Method 4Precision

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 Heightfield.

Tip: Click the right mouse button in any area of the Trend control to display a popup menuthat is related to that area.


The CIMPLICITY Trend Chart Properties Dialog BoxAfter you insert a Trend control on your CimEdit screen, you can display and change itsproperties, including:

Line Displays the associated point or expression dataAxis Defines the X and Y axes on the Trend.Chart Defines the chart characteristics of the Trend.Legend Defines the chart legend for the Trend.Grid Defines the grid display for the Trend.Runtime Actions Let you perform runtime actions when viewing the chartYou do this entire configuration in the CIMPLICITY Trend Chart Properties dialog box.

There are several methods for opening the CIMPLICITY Trend Chart Properties dialog box.

Opening the CIMPLICITY Trend Chart Properties Dialog Box To open the CIMPLICITY Trend Chart Properties dialog box:Method 1

Double-click the trend control.

Method 2

1. Select the trend control.

2. Select Edit on the menu bar.

3. Select CIMPLICITY Trend Control Object.4. Select Properties from the cascading menu.

Method 3

1. Select the trend control.

2. Hold down the right mouse button.

3. Select CIMPLICITY Trend Control Object from the drop-down menu.4. Select Properties from the cascading menu.

Note: Any fields that do not apply to the Trend you are defining will be grayed out.


Trend Control LineWhen you configure lines in Trending, you can quickly configure a points trend line by usingQuick Lines.You can also take advantage of Trendings many features to define each line in detail.

Trending currently supports the following data sources for trend lines:

Expressions Logged data Logged Expressions CSV files Reference files

Using Quick Lines to Create a Trend Chart LineTrending provides you with a way to quickly add lines that trend point values to your chart.Once added, you can use them as they are, or further define them with detailed configuration.

To quickly create a Line:1. Open the CIMPLICITY Trend Chart Properties dialog box.

2. Select the Lines tab.

Example: Lines Tab Using Quick LinesLines grid

Line Display(style)dialog box

Press to openSelect a Point browser

3. Click the Quick Lines button . The Select a Point dialog box opens.


4. Select a Point ID.

The Line ID:

Appears in the Line ID column with an associated color

Will appear on the legend

The line will be visible.

5. (Optional) Click Display to open the Line Display dialog box and change the linedisplay style.

6. Either:

Continue until you have all the lines that you need.

Configure some lines with the detailed method.

Creating a New Trend Chart Line (Overview of Detailed Method)The Line tab provides several tools, in addition to the Quick Lines button, to add a new lineto the Trend Chart.

To specify how lines appear on a Trend Chart:1. Open the CIMPLICITY Trend Chart Properties dialog box.

2. Select the Lines tab.

Example: Lines Tab Filled In

Line Types Point

(Expression) Logged Logged Point

(Expression) .CSV Reference

Line Displaydialog box

Lines Grid

Color palette

Creates blankentry for newline

Copiesselected lineconfiguration

Quick LinesOpens Select a PointBrowser

Line - Axis Mappingdialog box

Deletes line Move line up/ down in list

3. Click the New button .4. Select the Line type.


5. Enter the required information for CIMPLICITY to associate data with that line type.See each line types section for more information.

6. Either:

A. Press Enter on the keyboard.

B. Click the Line ID column The Line ID appears in the Lines grid.7. Specify line characteristics in the Lines grid.

A. Select a color. Either:

Click the Color Palette button , on the lines 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 theLegend.

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 theentry. This is particularly useful if you want to display variations in anexpression.

10. Click the Delete button to delete any unnecessary lines.

11. Click the arrows to move a selected point up or down in the list. Theposition in which it is displayed in the Properties dialog box is the position in whichit is displayed in the Legend during runtime.

Note: If the Visible line option is cleared, the In Legend line option is ignored. This meansthat the line will not show up on the legend, unless the Legend show all chart option ischecked. See "Configuring Advanced Chart Properties" in this chapter.


Configuring an Expression LineExpression lines display data reported by the CIMPLICITY Point manager. This type oftrend is also called a current trend, because all the information comes from current data.

Expression Line ConfigurationTo configure an Expression line:

1. Select Expression in the Line type field.

Expression Line TypeCurrent Trend

Line Display dialog box

Enter one or more Point IDs andmathematical operators that can

be evaluated.

Expressionmenu

EditExpression

2. Enter, in the Expression field, one or more Point IDs and mathematical operatorsthat can be evaluated.

Procedure to Disable Expression Line ScrollingBy default, expression lines scroll.

To disable expression line scrolling:1. Select the Chart tab.

2. Click Advanced.3. Clear the Allow runtime scrolling check box.

Qualified Points and Expression LinesIf you do not specify a project, the Base project is used. If you change the Base project on the Chart tab of the CIMPLICITY Trend ControlProperties dialog box and:

If a Point ID TrendingIs 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 attemptsto 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.


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

Logged Line ConfigurationTo configure a logged line:

1. Select Logged in the Line type field.

Table/Columnbrowser

Logged Line TypeHistorical Trend


Select the ODBC data source(Default is CIMPLICITY PointLogging) Group log Table ID

Column in group log table

Clear to keep the samehistorical information as areference

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 updateClear Keep the same historical information as a

reference

Logged lines can always be scrolled. If you leave Auto update blank, the line will updatewhen 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 andWindows 95 Base System Users Manual (GFK-1180) for more information.

Note: Engineering Units will not be displayed with logged trends.


Configuring a Logged Expression LineLines using logged and runtime data display a combination of runtime and logged data.

Runtime data is reported by CIMPLICITY Point Management.

Logged data comes from a CIMPLICITY Log table.

Logged Expression Line ConfigurationTo configure a logged expression line:

1. Select Logged expression in the Line type field.Logged Point Line TypeCurrent and Historical Trend


Select the ODBC data source(Default is CIMPLICITY PointLogging)

Group log Table IDColumn in group log table

Enter one or more Point IDs andmathematical operators that can

be evaluated.

Point IDpopup

Point browser

Table/Columnbrowser

2. Enter, in the Point Expression field, one or more Point IDs and mathematicaloperators that can be evaluated.

3. Select the ODBC data source from the Datasource drop down menu.

4. Open the Table/Column browser to select the:

A. Table ID in the data source.

B. Column ID in the table.

Procedure to Disable Logged Expression Line ScrollingBy default, logged expression lines scroll.

To disable expression logged line scrolling:1. Go to the Chart tab.

2. Click Advanced.3. Clear the Allow runtime scrolling check box.


Logged Expression Lines and Scrolling ConfigurationThe behavior of the logged expression line type depends on how scrolling is configured on theChart tab as follows:

Allow runtime-scrolling BehaviorNot 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 timeduration.

Set the Scroll Percentage to 25.

During the display the:

First hour and a half (1 ) comes from the log tableLast half-hour ( ) comes from run-time data.

You cannot scroll logged expression lines when Allowruntime scrolling is not selected. In addition, the Trendwill always draw in Jump Scroll mode.

Selected The Scroll Percentage no longer determines the amountof run-time data used. The line displays up to one chartpage worth of run-time data. The rest of the data comesfrom the log table.You can scroll logged expression lines when Allowruntime scrolling is selected.

Logged Expression Lines and Qualified PointsIf you do not specify a project, the Base project is used. If you change the Base project on the Chart tab of the CIMPLICITY Trend ControlProperties dialog box and:

If a Point ID TrendingIs 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 attemptsto 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 logtable. See the Using the Database Logger chapter in the CIMPLICITY HMI for Windows NTand Windows 95 Base System Users Manual (GFK-1180) for more information.


Configuring a CSV File LineCSV File lines display data from a specific .CSV file.

A .CSV file is a text file in which the fields are separated by commas.

CSV File ConfigurationTo configure a .CSV file line:

1. Select CSV File in the Line type field.

Select a Filedialog box

Table/Columnbrowser

CSV Line TypeData from CSV File Trend


Column ID in .CSVfile up to 64characters long

Name of .CSV filecontaining the data

Clear to keep the samevalues as a reference

2. Open the Select a File dialog box.

3. Select the .CSV file that contains the trend data

4. Open the Table/Column browser.

5. Select the column in the .CSV file that contains the trend data.

CSV lines can be always be scrolled.

Guidelines for CSV files used by Trends include:1. Create a separate directory for your .CSV files.

2. Give a CSV file used by Trends one of two formats. Choose the format, as follows:

Format WhenCommon Time Stamp All data has a common time stampUnique Time Stamp Each data column has a unique time stamp

3. The time stamp column(s) should use the date and time format indicated in theInternational settings on your Control Panel. In the examples here, the format ismm/dd/yy hh:mm:ss.

4. Name columns using:

Either case. Columns are not case sensitive.

Up to 64 characters.

5. Enter up to 255 columns in a .CSV file.

6. Allow only the same data type within each column.


Example of data typeIf: The data type of the column FloatThen: 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 afile with a filename greater than 12 characters.

Examplelargest1.csv Can be a .CSV file name

Common Time Stamp Format for .CSV LinesIf all data columns in the file share a common time stamp, the file can have the followingformat:

"Val1", "Val2", "_time",10.75,1,9/19/95 8:32:0010.83,2,9/19/95 8:33:00

The first line consists of the column names enclosed in double quotes, and separated by theInternational settings list separator (in this case, a comma). The column that designates thetime stamp must be labeled "_time". The rows following the column names are the rows ofdata.

Unique Time Stamp Format for .CSV LinesIf each data column is associated with a unique time stamp, then the file has the followingformat:

"Val1", "Val1_time", "Val2", "Val2_time",10.75,9/19/95 8:32:00,1,9/19/95 8:30:1010.83,9/19/95 8:33:00,2,9/19/95 8:30:20

The first line consists of the column names enclosed in double quotes and separated by theInternational settings list separator (a comma in this example). The column name whichdesignates the time stamp associated with a data column is "_time" concatenated to the datacolumn name (for example, "Val1_time"). The rows following the column names are therows of data.


Configuring a Reference LineCreating a line as a reference for other lines can be useful in many instances.

A reference line is a horizontal line that will be updated.Reference lines can be created from:

An expression

A reference file that is created by the Trending module through the Runtime Actionstab in the CIMPLICITY Trend Control Properties dialog box.

Reference Line Types


Select a Filedialog boxTable/ColumnbrowserColumn in group log table

Name of .REF filecontaining the data

Clear to keep the samevalues as a reference

Reference Line TypeReference Data or Trend

Enter one or morePoint IDs andmathematical operatorsthat can be evaluated.

A

Choose A or B.

B

A Reference line is updated, as follows:

Reference LineValue Source How Trending Updates the Reference LineExpression Trending takes the latest value of the expression and draws a

horizontal line with the value. If the value of the expressionchanges, Trending updates the reference line.

Reference file Retrieves values from a reference file that are exported into thereference file at runtime.


Reference Line AxesFollowing is a description of reference line axes behavior:

Expression reference lines default to use the charts X-axis and Y-axis.

Reference file lines default to use their axes. They are named using the line ID with a_X and _Y suffix respectively. The axis configuration is based on the contents of thereference file. The X-axis defaults to no scroll.

Reference File ConfigurationAlthough reference file configuration is very easy, it requires a few steps.

Important: Reference files are currently available only on the Intel Windows 95 and IntelWindows NT platforms.

To configure a reference file to be used for a reference line:1. Select the Runtime Actions tab of the CIMPLICITY Trend Control Properties dialog

box.

Check to enablethe Runtimeaction tab duringruntime

Runtime Display Dialog Box

Check to makethe dialog boxavailable

Export toreference file...enabled duringruntime

2. Make sure the Show property pages at runtime and Runtime actions checkboxes 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.


Browse aWindows 95/NTSave As dialogbox

Select one ormore lines toreference

Enter a pathincluding adirectory andfile name


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 notselect a directory, the file is saved in the last directory you accessed with theFile 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 youselected will be written to the reference file.

Important: The ODBC Text driver cannot open a file with a filename greater than 12characters. For best results, enter a name that fits the 8.3 format. That is, the file nameshould be eight characters or less, followed by a period and an extension of three characters orless (for example, "largest1.txt").


Reference File RowsContents in Reference file rows include:

Row Contains1 Column names in double quotes and separated by the

International settings list separator (usually acomma).The column name that designates the time stampassociated with a data column is a concatenation ofthe 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 lines value changes

over the time period."Soap","Soap_TIME"211,"03-01-1996 18:19:34.000"506,"03-01-1996 18:24:34.000"476,"03-01-1996 18:18:54.230"474,"03-01-1996 18:19:16.570"470,"03-01-1996 18:19:17.770"467,"03-01-1996 18:19:19.040"464,"03-01-1996 18:19:20.480"461,"03-01-1996 18:19:31.220"457,"03-01-1996 18:19:32.460"

If you selected more than one line to save, the value and time information for each line isstored 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 linecontains the last array elements, and the rest of the rows contain the rest of the array elements. All arrayelements 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"


Specifying Line Display StylesTo change the display style of a line:

1. Select a line in the Lines grid.2. Click Display.The Line Display dialog box opens.

Choose a non-solid line.The width is fixed.

Line Display Dialog Box

Choose a solid line.Specify the width.

Steprecommended for runtime lines Smooth

Check to hide theline at runtime

Value to representa group of values None Average First Last Minimum Maximum

3. Select the line:

A. Style.B. Width if the line style is solid. If it is not solid, the width is fixed.

4. Select how data should be displayed if the number of data points to be plottedexceeds the display area (available pixels).If a compression type is selected:

A. The group size is automatically determined by Trending software.

B. The selected compression method (for example, average) is applied to thatgroup.

C. All the data points in that group are plotted as a single data point.

If no compression is selected, multiple data points are plotted along a vertical line.


5. Select how the points should be connected. The choices are

Step (Recommended for runtime display) Connectsdata points with a stepped line

Smooth Connects data points with a straight line. Thelegend will always display the last actual valueto the left of the cursor. That is, the value in thelegend does not reflect the line interpolation.

6. (Optional) Check the Hidden check box if you do not want the line to be displayedon the chart at run-time.

Mapping Axes to a LineIf you have more than one Y-axis or X-axis, you can specify which axes will explain eachline.

To specify what axis will explain a trend line:Method 1: Properties dialog box

Method 2: Popup menus

Continue: Following Method 1 or 2

Method 1Properties dialog box

1. Click the Line Axis Mapping button .Go to "Continue (following Method 1 or 2)".

Method 2 Popup menus

1. Place the cursor over either the Y-axis or X-axis.

2. Click the right mouse button. A popup menu displays.

Example: X-axis Popup

3. Select Line/Axis Mapping.

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


Y-Axis for selected line.

Example: Line-Axis Mapping

Lines associated with theselected axis display in theLines box.

X-axis for selected line

Continue (following Method 1 or 2)Do any or all of the following:

1. Select an axis in the Show lines for axis field to see what lines it represents.2. Select a line in the Lines field.

A. Select an X-axis in the Configured X-axis field to associate with the line.B. Select a Y-axis in the Configured Y-axis field to associate with the line.

Note: Y Chart Axis and X Chart Axis are the default axes.


Axis ConfigurationYour trend chart has to have at least on X-axis and one Y-axis. At times, you may want toconfigure more that can be used instead of either default axis.

To begin axis configuration:1. Open the CIMPLICITY TREND Chart Properties dialog box.

2. Select the Axis tab.

Ticks and labelsfor selected axis

Example: Axis Tab Filled In Axis Grid

Fields changebetween X-axisand Y-axis

Creates blankentry for newaxis

Copiesselected axisconfiguration

Font dialog box


Deletes anyaxis, exceptthe default

Configuring the X-axisFor each X-axis, you:

1. Configure the timing either in one of the following:

CIMPLICITY Trend Control Properties dialog box.

An X Axis Time dialog box that opens through a right mouse button popupmenu.

2. Configure other details in the CIMPLICITY Trend Control Properties dialog box.

Methods to Configure X-axis TimingAccess the X-axis timing either through the:

CIMPLICITY Trend Control dialog box, Axis tab

An X Axis Time dialog box that opens through a right mouse button popup menu.

To configure the X-axis timing:


Method 1CIMPLICITY Trend Control dialog box

1. Select an X-axis in the Configured axes grid of the CIMPLICITY Trend ControlProperties dialog box.

2. The Duration field and Start time box appear.Go to "Continue (following Method 1 or 2)".

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

Fields change basedon selection

Method 2Popup Menu

1. Position the cursor over the X-axis.

2. Click the right mouse button. A popup menu appears.

3. Select Time.

X-axis Popup

An X Axis Time dialog box appears.

Go to "Continue (following Method 1 or 2)".


Continue (following Method 1 or Method 2)1. Enter the Duration of time the X-axis represents. The format is ddd:hh:mm:ss

where:

Letters Representddd day number: 0365hh Hours: 059mm minutes: 059ss seconds: 059

2. Configure the Start time from the following choices:Example: X Axis Timing

Clear to allowruntime scroll

ddd:hh:mm:ss

hh:mm:ss

mm/dd/yy

hh:mm:ss

ddd= 0 -365hh = 0 - 23mm = 0 - 59ss = 0 - 59

ddd

A. Show most recent

B. Start dateC. Now minus days

A. Show most recent

No other entry is required. This is the same as selecting Now minus 0 days andNow minus time with a time that is equal to theduration.

B. Start date requires:

Start date Enter an Absolute date in mm/dd/yy format

Now minus days Number that specifies the number of days before thecurrent date. For example, enter 5 to begin thedisplay five (5) days before the current date.

C. Start time requires:

Start time Absolute time in hh:mm:ss formatNow minus time Number that specifies the number or hours, minutes

and seconds before the current time. The number isspecified in hh:mm:ss format. For example, enter1:30:05 for a starting time1 hour 30 minutes and 5seconds earlier than when the trend is first displayed.


Detailed X-axis ConfigurationThe several X-axis features, in addition to the time it represents, can be configured in theCIMPLICITY Trend Control Properties dialog box.

To configure the X-axis details:1. Select an X-axis in the Configured axes grid.



Fields changewhen a differentaxis is selected



Font dialog box



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 andY-axes.

3. Specify the axis characteristics in the Configured axis grid.A. Select a color.

Click the Color Palette button , on the lines row in the Color column.The Color Palette opens.

Double click a unique line color.

B. (Optional) Check Visible to make the X-axis visible.4. (Optional) Configure a label and ticks for the axis:

A. Enter a label in the Label field. The label you enter will be the axis title.B. Select the number of ticks in the Ticks box that you want the X-axis to display.

You can select through 100.

C. Check the Numbered checkbox to label the tick marks.D. Check the No scroll check box if you do not want users to scroll the X-axis at

run-time.


Configuring the Y-axisFor 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.

Methods to Configure Y-axis LimitsAccess the Y-axis timing either through the:

CIMPLICITY Trend Control dialog box, Axis tab

Trend Control popup menu

To configure Y-axis limits:Method 1Detailed CIMPLICITY Trend Control dialog box

1. Select a Y-axis in the Configured axes grid.The Limits box appears.

Example: Y-Axis Limits Configuration in Trend Control Properties Dialog Box

Order of priority whenall options are selected:

1

2

Each time a valuegoes above orbelow the existinglimit.

If there are noPoint Limits

3

Go to "Continue (following Method 1 or 2)".Method 2Popup Menu Configuration

1. Position the cursor over the Y-axis area.


Y-axis Popup

3. Select Limits.

A Y Axis Limits dialog box appears.

Go to "Continue (following Method 1 or 2)".


3

2

1

Example: Y-Axis Configuration from Popup Menu

Each time a value goesabove or below theexisting limit.

Continue (following Method 1 or 2)1. Enter one, two or all options for the Y-axis limits

A. Enter numeric values in the Default lower limit and Default upper limit fields.B. Check the Use Point Limits check box to have Trending use the points limits

specified in the ConfigurationPoint dialog box.

If Trending cant find limits in the ConfigurationPoint dialog box, it will usethe values you enter in the Default lower limit and Default upper limit fields.

C. Check the Autoscale check box to have Trending automatically change the Y-axis limits each time a value goes above or below the existing limit.

Autoscale functions as follows:1. The highest and lowest values are found from all lines associated with the

axis.

2. The decimal base is calculated for both highest and lowest values.

ExamplesThe decimal base of 150 is 100.The decimal base of 7654 is 1000.

3. The high limit is the number closest to the highest number on the high side,using the calculated decimal base from the highest value as multiple.

The low limit is the number closest to the highest number on the low side,using the calculated decimal base from the lowest value as a multiple.ExampleGiven 478 and 7891 as the lowest and highest values found, the calculatedlow and high limit for the axis is 400 and 8000. This is because 400 is theclosest value to 478 on the low side that uses a multiple of 100 and because8000 is the closest value to 7891 on the high side that uses a multiple of1000


Guidelines for the order of priority if you select all the limit optionsTrending:

1. Increments the upper or lower limit each time a value goes above or below theexisting limit.

2. Uses the limits specified in the Points Configuration dialog box.

3. Uses the limits specified in the Default lower limit and Default upper limit fields.

Detailed Y-axis ConfigurationThe several Y-axis features, in addition to the time it represents, can be configured in theCIMPLICITY Trend Control Properties dialog box.

To configure the Y-axis details:1. Select A Y-axis in the Configured axes grid in the CIMPLICITY Trend Control

Properties dialog box.



Fields changebetween X-axisand Y-axis



Font dialog box



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 Xand Y-axes.


3. Specify axis characteristics in the Configured axis grid.A. Select a color.

i. Click the Color Palette button , on the lines row in the Color column.The Color Palette opens.

ii. Double click a unique line color.

iii. (Optional) Check Visible to make the Y-axis visible.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 anotheraxis.

B. Click the Copy button to copy the selected axis. You can then modify theentry. This is particularly useful if you want to follow variations in anexpression.

C. Click the Delete button to delete any axis beyond the primary X-Axis andY-axis that you decide you dont want.


Chart PropertiesThere are several details about the chart itself from its color to how many pixels away can acursor be from the slider and still grab it.

These details are configured in the Chart tab of the CIMPLICITY Trend Control Propertiesdialog box and then in the Advanced dialog box that is accessed through the Chart tab.

Configuring Basic Chart PropertiesThe basic details including the chart color and auto update interval are configured in the mainChart tab of the CIMPLICITY Trend Control Properties dialog box.

To configure basic chart properties:1. Open the CIMPLICITY Trend Chart Properties dialog box.

2. Select the Chart tab.

If checked, lines:1. Update at the right

edge2. Scroll each time an

update is received

If checked, lines:1. Draw left to right2. Update across the

chart area.3. Scroll when the

right edge isreached

4. Continue updatefrom left to right.Interval for: Chart update Chart redrawn

(hh:mm:ss)

Open Color palette

Project used forunqualifiedpoints, can bechanged atruntime.

Open Advanceddialog box

Display scroll buttonsExample: Chart tab filled in

3. Click each color fields Color Palette button to configure the charts colors:

Field Selects color for the:Foreground color Slider, legend and chart X and Y-axesBackground field Area surrounding the trend chartChart color Solid color for the trend chart area

4. Enter the time between one new data update and the next in the Auto Update Intervalfield. The format is hh:mm:ss.

Example10 equals ten seconds; 1:00 equals one minute.


Note: Auto update will only occur for lines that have Auto Update selected on the Line tabof the CIMPLICITY Trend Control Properties dialog box.

5. Enter the time between one time that the chart redraws itself and the next in the AutoRefresh Interval field. The format is hh:mm:ss.

6. Select the CIMPLICITY project to be used for any unqualified Point IDs. Thedefault 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 rightedge 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.


Configuring Advanced Chart PropertiesThe Advanced chart properties let you configure the Y-axis display, scroll percentage, slidergrab margin and other miscellaneous chart features.

To open the Advanced dialog box for chart properties:1. Select the Chart tab of the CIMPLICITY Trend Control Properties dialog box.

2. Click the Advanced button.The Advanced dialog box appears.

Choose Multiple (default): All

nonhidden Y-axes Single: Y-axis only Percent Configured:

0100 Scale

Amount of data scrollwhen scroll buttonsare pressed

Number of pixelsfrom slider in whichthe slider can still begrabbed(110)

Chart Y-Axis

All lines use a singletime period

Legend shows visibleand hidden lines

Jump to current timeat next runtime orauto update

Scroll point andlogged point lines

All lines use a singletime period andduration

3. Determine what Y-axis to display in the Y-axis display field. Choices are:

Multiple (Default) Display all the currently configured Y-axes that arenot hidden

Single Display the chart Y-axis onlyPercent Configured Display a single Y-axis going from 0 to 100 percent.

All the lines are displayed on a scale of 0 to 100percent of their ranges as configured on the Axisproperty page.

4. Enter a percent in the Scroll percentage field to define the:

Time duration that the chart data will Scroll backward or forward when the or button is pressed during runtime.

Length of the jump when the drawing reaches the right edge of the chart if youset the Update style to Jump scroll in the basic Chart tab.

Example of button scrollA chart displays a two (2) hour time durationEnter 25 in this field.


The chart will scroll backward or forward by a half-hour (25% of two (2) hours)when the scroll button is pressed.

5. Enter the number (010) of pixels from the slider that a mouse cursor can move andstill grab the slider, in the Slider grab margin field..

6. (Optional) Check the Single X-axis check box if you want the chart to be displayedwith a single X-axis called the Chart X Axis. All lines will use the Chart X Axis.

In the case of Line charts that represent time, this option is mutually exclusive withthe Single Time Duration option. Therefore, if you select this option, the Singletime duration check box is unavailable.

7. (Optional) Check the Single Y-axis check box if you want the chart to be displayedwith a single Y-axis called the Chart Y-axis. All lines will use the Chart Y-axis.

If you select this option, the Y-axis display is disabled.8. Check the Single time duration check box if you want all the lines in the chart to

use a single time duration. The time duration is the Chart X Axis duration. Forexample, you want to view the data for all lines for a span of two hours, regardless ofstart time.

For Line charts that represent time, this option is mutually exclusive with the SingleX-axis option.

9. Check the Legend show all check box to display the legend information for allvisible and hidden lines on the chart.

Clear this check box to display information for only the visible lines on the chart.

Use the Legend tab to define the legend elements.

10. Check the Jump to current value check box to make the trend displayautomatically jump back to the current time at the next run-time or auto update timerinterval whenever you scroll the chart.

Clear this check box to scroll manually to return to the current time. If one of theobjects on the CimView screen has a JumpToCurrentTime method configured for thechart, you can use that method to scroll forward to the current time.

11. Check the Allow Runtime Scrolling check box to scroll Expression and LoggedExpression lines in the chart at run-time. You can see for:

Expression lines Up to one chart page of data in the past. Beyondthat, no data is displayed

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

Clear the Allow Runtime Scrolling checkbox to prevent Expression and LoggedExpression lines from scrolling. See "Logged Expression Lines and ScrollingConfiguration" in this chapter for more information about how logged expressionsbehave when this option is not checked.


Legend PropertiesThe Legend properties define the legend information for the lines on the chart.

To define the legend properties:Method 1Properties dialog box

1. Open the CIMPLICITY Trend Chart Properties dialog box.

2. Select the Legend tab.

Number oflegend lines

Move item up /down in list

Display Legend Title

Open Fontdialog box

Check to display instatus line

Check todisplay foreach line onthe chart

Single column Two columns

Example: Legends Tab

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 thevertical 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.


Method 2Popup Menu in the Legend area

1. Place the cursor over the X-axis.


Example: Legend Popup

Check to show item

3. Check Legend to display the legend.4. Select Show Fields. An extended menu appears.

5. Check any fields you want to display in the Legend.

6. Select Add Lines. An extended menu appears.

7. Select the lines you want to display n the Legend.

8. Check Status to display the status bar.

Method 3Popup menu in Status line

1. Place the cursor over the Status area.


Example: Status Popup

Check to show item

3. Check Status to display the status line.

4. Select Show Fields. An extended menu appears.

5. Check the fields you want to display in the Status line.6. Check Legend to display the legend.


Grid PropertiesYou can display grid lines that divide your chart into sections. You do this on the Grid tab ofthe CIMPLICITY Trent Control Properties dialog box.

To display gridlines on a chart:Method 1: CIMPLICITY Trend Chart Properties dialog box

1. Open the CIMPLICITY Trend Chart Properties dialog box.

2. Select the Grid tab.

Display grid based on a selected(or nearest) lines axis

Line Display Dialog Box

Choose asolid line.Specify thewidth

Choose a non-solid line.The width isfixed Enter the

number ofgrid lines

Check to display grid

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. ColorB. StyleC. 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 gridlinesto display

Axis ticks from line Select an axis whose ticks will determine the gridlines. If you select Use nearest axis, the first axiswith tick marks is used to determine the grid lines.


Method 2Popup menu in chart area (CimEdit or CimView)1. Place the cursor anywhere in the chart area.

2. Click the right mouse button.

Example: Chart Popup

Check to show item

3. Select Show. An extended menu displays.

4. Select Grid.

The grid that you configured on the Grid tab displays.

Runtime ActionsWhether or not an operator can access one or more of the tabs or even open the CIMPLICITYTrend Control Properties dialog box during runtime is under your control.

To enable/disable tabs in the CIMPLICITY Trend Control Properties dialog boxfor runtime:

1. Open the CIMPLICITY TREND Chart Properties dialog box.

2. Select the Runtime Actions tab.

Check to enabletab at runtime


Clear toprohibit dialogbox displayduring runtime

Axis tab disabledduring runtime

Export toreference file...enabled duringruntime


3. Check the Show property pages at runtime check box to let an operator open theCIMPLICITY Trend Control Properties dialog box during runtime. If you clear thecheck box, you have completed configuration of this tab.

4. Check the tabs that an operator can change during runtime in the Pages enabled atruntime box.

Important: It you are using a reference file, you need to enable at least the Runtime Actionstab so the operator can export data to the reference file. It is on this tab that the export button,which is disabled during configuration, is enabled during runtime.

Array Point TrendsArray elements are numbered from zero (0) to one (1) less than the number of elements in thearray.

For example, if ARRAY has ten elements, the individual elements are ARRAY[0]through ARRAY[9].

You may trend a single element of an array just as you can trend an ordinary line.

To trend a single element in an array:1. Enter the array name

2. Write the elements number in square brackets at the end of the array name.

For example, to look at the first element in ARRAY, enter ARRAY[0].

To trend an entire array at a single instant in time:Enter the array name only.

The resulting display depends on the Line Type you have chosen.

Logged data The whole array is drawn as it was at the axisend time.

Reference file The time of the array is provided in the file.Expression The most recent data for the array is displayed.

Whenever the array data changes, the old line is erased and a new one, representing the newdata, 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. The space between the last element and the end of the chart is equal to the spacebetween the first two elements.


Color and Font Choices on a Trend ChartYou can specify color or font characteristics in several parts of a Trend Chart. The methodsyou use to accomplish each are the same in all instances.

Selecting a Basic ColorWhen you are asked to specify a color, you can select one from Trendings easy to use colorpalettes.

To select a basic color:1. Click the drop-down list button to the right of the Color input field.

Palette tab Special tab

Double click a blank boxto create a custom color

Click one to select a baiccolor

Basic Palette

Right click an existingcustomized color to edit it.

2. Double click the color of your choice on the Palette tab.

Creating a Custom ColorCIMPLICITY HMI lets you create as many custom colors as you want; 16 custom colors atany one time.

To create a custom color:1. Click the drop-down list button to the right of the Color input field.2. Double click an empty box at the bottom of the Palette tab.

The Color (custom color) Palette opens.


Color pickerLuminosity picker

Actual color selected (exampleis dithered)

Closest solid color availableDouble click Solid to choose it Change a single colors index

value, to change its luminancein the mix

The picker positions and colorbox reflect the change

Hue=red, green and blue proportions based on their entered values Saturation=Defines color vividnes (amount of gray) Luminance=Amount of light in the color (0=Black)

Solid double clicked

Color Palette: To create Customized Color

Press to select color and addit to the basic palette

3. Do one or more of the following until you have created the color you want. You cansee 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 value255 for all colors = White255 for one color = Pure red, green or blue for that valueThe 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 Lumfield.

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 colorsshould be in the Sat field.

0 = Gray240 = No gray.

F. Specify the balance of red, green and blue that you want in the Hue field. Thisbalance 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|Solidbox. 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 thesolid 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. Thebox 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 ColorYou can modify any color on the palette. If you choose a standard color to modify, thecustomized 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 thatthe edited color used to occupy.


Choosing a FontWhenever you have to specify a font and its characteristics in Trending, you can do so in abasic Windows 95/NT Font dialog box.

To specify a font for a Trending text item:1. Choose one of the following:

Click the Font button on the Axis tab.

Click the Font button in the Axis or Legend tab.The Font dialog box opens.

2. Select the font. If you use TrueType fonts, users can resize a screen in CimView andstill 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

Trend Methods

About Trend MethodsBecause the trend chart is an object in CimEdit, you can specify events that trigger actions.Trending offers you a list of methods to use for a particular action, Invoke method that canbe triggered by an event.

A method is a function that operates on a Trend control in CimView.You can customize one or all of these methods, so that when theyre associated event occursthey will change or enable/disable an aspect of the trend chart, as follows:

Invoke methodItem Method On the CimView Trend Chart, to:Line

AddLoggedLine Add a specified logged lineAddLoggedPointLine Add a specified logged expression lineAddPointLine Add a specified expression lineDeleteTrendLine Delete a specified lineSetLineAutoupdate Change the auto-update status of one or all non-

runtime linesSetLineDisplay Set the color, compression and expansion of a

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

legend for one or all lines.WriteReferenceFile Write a reference file for specified lines.

LegendSetLegendState Make the legend visible/invisible

X-axis (Time Related)JumpToCurrentTime Set the chart time to the current time.PauseUpdates Pause or resume updatesScrollLines Scroll the chart by the given percentageSetXDuration Change the X-axis duration.SetXStartTime Change the Chart X-axis for one or all lines.


Y-axisSetLineYAxis Change the Y-axis settings.SetYAxisVisible Change the visibility of one or all Y axesSetLineUseChartY Toggle the use of the Chart Y-axis for a line.

Visual AidsResetZoom Reset zoom in the Trend Control to 100%.SetGridState Change the grid visibility for the Trend Control.

Wait StateEnableOutstandingLoggedRequestStateEvents

Enables the firing of logged data wait stateevents in the Trend control.

DisableOutstandingLoggedRequestStateEventsDisables or turns off the firing of logged datarequest wait state events in the Trend control.

OtherAboutBox 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 asevents 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 theyoccur:

Event On the CimView Trend Chart, when:EnteringOutstandingLoggedRequestState

The Trend control has determined that it haslogged data requests that have been outstanding(waiting) for longer than the number of secondsdetermined by the threshold.

LeavingOutstandingLoggedRequestStateThe Trend control has determined that it nolonger has any logged data requests that areoutstanding.

GFK-1260F Trend Methods 3-3

Method ConfigurationNaming A Trend Control

Before you can invoke a method for a Trend control, the control must have its Object namedefined.

To name a trend control:1. Select the Trend control.2. From the Edit menu, select Object properties.3. Select the General properties of the Object Properties window.4. Enter a name for the Trend control in the Object name field.5. Click OK to save your changes and close the Object Properties window.

You can now select the control when you create an Invoke Method action.

Creating an Invoke Method ActionYou can create an Invoke method action for a trend object the same way you would for anyobject or group