Color Spectrum User's Guide

Issue Date 0101

Table of Contents Color Spectrum User’s Guide

Table of Contents ...... 1

Chapter 1 Introduction to Color Spectrum...... 1-1

Introduction...... 1-1

Key Concepts...... 1-2 Chapter Organization ...... 1-2 Online Help ...... 1-2 Manual Conventions ...... 1-2 Color Spectrum Overview ...... 1-3 Chapter 2 Defining Color Spectrum...... 2-1

Introduction...... 2-1

Key Concepts...... 2-2 Color Maps in Color Spectrum ...... 2-2 Object and Sample Selection...... 2-3 Minimum and Maximum Analog Values...... 2-3 Procedure Overview...... 2-4

2 Color Spectrum

Detailed Procedures...... 2-5 Defining a New Color Spectrum...... 2-5 Defining a Color Spectrum Title ...... 2-6 Selecting a Point Object Name ...... 2-6 Defining Sample Selection Values ...... 2-8 Defining a New Color Map ...... 2-9 Reversing a Color Map ...... 2-11 Changing Color Spectrum Sample Colors ...... 2-12 Defining Minimum and Maximum Data Set Ranges ...... 2-12 Chapter 3 Using Color Spectrum ...... 3-1

Introduction...... 3-1

Key Concepts...... 3-2 Color Spectrum Modes ...... 3-2 Box Plot in Color Spectrum ...... 3-3 Axis and Legend Ticks in Color Spectrum ...... 3-4 Color Spectrum Menus ...... 3-5 Toolbar Icons ...... 3-6 Procedure Overview...... 3-7

Detailed Procedures...... 3-8 Loading an Existing Color Spectrum...... 3-8 Saving an Existing Color Spectrum...... 3-9 Showing or Hiding the Box Plot in Color Spectrum...... 3-10 Zooming In on Color Spectrum ...... 3-11 Changing Color Spectrum Fonts...... 3-12 Changing the Tick Count for Color Legend...... 3-14 Table of Contents 3

Appendix A Color Spectrum ActiveX Control...... A-1

Introduction...... A-1

Key Concepts...... A-2 ActiveX ...... A-2 ActiveX Control ...... A-2 Color Spectrum in ActiveX Control...... A-2 Expanded Right-click in a Color Spectrum ActiveX Control...... A-3 ActiveX Control Properties ...... A-4 Color Spectrum Events ...... A-4 ActiveX Methods ...... A-5 Appendix B Color Spectrum Application ...... B-1

Introduction...... B-1

Key Concepts...... B-2 Color Spectrum Application...... B-2

Color Spectrum User’s Guide 1-1

Chapter 1 Introduction to Color Spectrum

Introduction Color Spectrum shows the historical analog information of a point. The value of each data sample is mapped to a color from a selected range of colors. The Color Spectrum is unique compared to other software, since a single display can reveal patterns in months of historical data. This chapter provides a definition of terms.

Key Concepts

Chapter Organization Each chapter in the Color Spectrum User’s Guide is divided into four main sections:

Table 1-1: Chapter Organization Section Description Introduction Briefly outlines the contents of the chapter

Key Concepts Describes background information necessary to perform or understand specific tasks

Procedure Overview Describes general steps for performing the tasks that are described in detail in the Detailed Procedures section. This section is geared toward users already experienced in using Color Spectrum who only need a reference.

Detailed Procedures Describes in detail the steps needed to complete specific tasks described within the chapter. This section is geared toward users who are new to Color Spectrum.

If a section is not necessary for a particular chapter, it is omitted. For example, this chapter, Introduction to Color Spectrum, does not contain a Detailed Procedures section. Online Help Color Spectrum software includes online Help. The Help screens may be accessed by selecting Help from the menu bar, by pressing the F1 key, or by pressing Alt + H. Help describes the basic procedures for performing functions within the Color Spectrum software. Guide Conventions As in most Windows® based programs, sometimes there are multiple ways to perform the same tasks. This guide describes how to use the mouse to perform procedures. In general, Microsoft® conventions are used to describe software features. Color Spectrum User’s Guide 1-3

Color Spectrum Overview Color Spectrum is used to find patterns in Heating, Ventilating, and Air Conditioning (HVAC) equipment operations. By mapping historical analog data to colors, Building Automation System (BAS) operators are able to see daily and monthly patterns in the operation of the facility’s equipment. Operators can easily see any abnormal operation of the equipment and plan corrective actions. Color Spectrum allows the operator to identify irregularities such as problems in the sequence of operation, equipment cycling, equipment use during unoccupied hours, and unusual patterns of equipment use. Operators can use Color Spectrum to analyze facility energy usage. It shows the BAS operators the daily, weekly, and monthly patterns of energy usage. Operators are able to see when energy usage levels reach peak values, identify patterns indicating the energy waste, and evaluate load limiting and optimal start strategies. Ribbons of colors represent each day. A combination of all ribbons (days) forms the Color Spectrum (Figure 1-1).

Figure 1-1: Color Ribbons in Color Spectrum Color Spectrum User’s Guide 2-1

Chapter 2 Defining Color Spectrum

Introduction The Color Spectrum display provides a compact view of history data of an analog point in a color spectrum format. It reads History values between two particular date and time values and displays the information in the form of a color ribbon. Operators can define color schemes for a specific point within Color Spectrum using a different range of values for the same point. This chapter describes how to: • define a new Color Spectrum • define a Color Spectrum title • select a point object name • define sample selection values • define a new color map • reverse a color map • change Color Spectrum sample colors • define minimum and maximum data set ranges Note: Larger databases may affect the performance of the Color Spectrum application for the Metasys® Web Access (MWA) Remote User in MWA configurations. We recommend keeping the database size below 250 MB. Typical Performance Table Time to Refresh a Color Spectrum Size of Screen on a Remote Computer Database 30 seconds 250 MB 5 minutes 1 GB

Key Concepts

Color Maps in Color Spectrum Operators can use color maps to define the display color corresponding to a particular value. Each color map contains one or more color segments and the gradation between these colors. The Color Spectrum contains twelve predefined color maps. Operators are able to define and save additional color maps and can save color maps under different names. However, operators cannot delete or change the predefined color maps. The patterns within a particular data set are revealed differently depending on the colors used to display data. Operators should experiment with using different color maps to distinguish patterns in the data set. Reversing a color map is useful when natural relationships are made with certain colors. Displaying temperature with a color map that shows low values as blue, middle values as green and high values as red makes it easy to see the problems. When displaying the value of a cooling valve, 0% to 100% open, it is helpful to reverse the color map so the higher values of cooling are displayed as blue. The point values that do not fall between the specified minimum and maximum values are called Out of Range values and appear in the Out of Range color defined by the operators. When the sample value is not available for a particular sample, it is called the Data Not Available value and appears in the Data Not Available color defined by the operators. Operators are able to select which color map currently is used to plot the data. The data values are mapped on to the screen according to the color map selected. Color Spectrum User’s Guide 2-3

Object and Sample Selection The operators are presented with the list of objects for which data exists in the historical database. When the operator selects an object to plot, a dialog box appears that displays the earliest and latest dates that exist for the samples. The default is to plot the entire set of data. The operators also can select the starting date and time and the ending date and time from this dialog box. The vertical axis is labeled with the days of the week and the dates. The labels of weekdays are plotted and repeated with the days selected by the operator. As the display height is resized, smaller, fewer labels may be displayed to avoid a cluttered display. Operators can select colors for the background, out of range data, offline, and no data available to distinguish the colors from the rest of the data being displayed. Minimum and Maximum Analog Values The Minimum and maximum analog values are used to specify the range of analog values mapped to the range of colors. Specify the values so the range of interest that the point data is displaying spreads across the entire color map. This causes the patterns within the data to easily be seen. A temperature sensor may have a range of 0 to 100°F, yet the range of interest for a chilled water sensor may be 40 to 60°F. 2-4 Color Spectrum User’s Guide

Procedure Overview

Table 2-1: Procedure Overview To Do This Follow These Steps: Define a New Color Spectrum On the Edit menu, click Color Spectrum. Make necessary modifications. Click OK. Define a Color Spectrum Title On the Edit menu, click Color Spectrum. Enter the desired title. Click OK. Select a Point Object Name On the Edit menu, click Color Spectrum. Click Find. Browse to desired point. Click OK. Click OK. Define Sample Selection On the Edit menu, click Color Spectrum. Values Select the Sample Definition tab. Make the necessary modifications. Click OK. Define a New Color Map On the Edit menu, click Color Spectrum. Select the Colors/Fonts tab. Click Add. Enter the color map name and color map segments. Click OK. Reverse a Color Map On the Edit menu, click Color Spectrum. Select the Colors/Fonts tab. Select the desired color map. Select Reverse Color Map. Click OK. Change Color Spectrum On the Edit menu, click Color Spectrum. Sample Colors Select the Colors/Fonts tab. Make desired modifications. Click OK. Define Minimum and Maximum On the Edit menu, click Color Spectrum. Make Data Set Ranges necessary modifications. Click OK.

Color Spectrum User’s Guide 2-5

Detailed Procedures

Defining a New Color Spectrum To define a Color Spectrum: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears (Figure 2-1).

Figure 2-1: Color Spectrum Properties Dialog Box 2. Make necessary modifications (Table 2-2).

Table 2-2: Spectrum Definition Tab Attributes Field Description Title Allows the new display to be named Point Name Allow the user to find and select a point name from the database Minimum Analog Value Defines the minimum Analog value Maximum Analog Value Defines the maximum Analog value Tick Count Defines the number of Ticks marks on the Legend

3. Click OK. 2-6 Color Spectrum User’s Guide

Defining a Color Spectrum Title To define Color Spectrum title: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears (Figure 2-1). 2. Enter the desired title. 3. Click OK. Selecting a Point Object Name To select the Point Object name: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears (Figure 2-1). 2. Click on Find. The Select Color Spectrum Point dialog box appears (Figure 2-2) and allows browsing of the history database.

Figure 2-2: Select Color Spectrum Point Dialog Box 3. Browse to the desired point. Refer to Table 2-3. Note: Table 2-3 describes the typical tree hierarchy of folders. Color Spectrum User’s Guide 2-7

Table 2-3: Select Color Spectrum Point Nodes Node Description Root Represents the network name (N1 network) or site name (BACnet®) of database. The root is the top node of the tree. Branch Represents system name (N1 network) or point name/number (BACnet) of database. The branch is the second node of the tree. Leaves Represents attributes of points (N1 or BACnet). The leaves are the last node of the tree. Leaves do not appear on the tree if the attribute matches the .ini file.

4. Click OK. The Select Color Spectrum Point dialog box closes. 5. Click OK. The selected point name appears in the form of a tag in the Point Name Edit Box. 2-8 Color Spectrum User’s Guide

Defining Sample Selection Values To define sample selection values: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears (Figure 2-1). 2. Select the Sample Definition tab (Figure 2-3).

Figure 2-3: Color Spectrum Properties - Sample Definition Tab 3. Make the necessary modifications. Refer to Table 2-4.

Table 2-4: Sample Definition Attributes Field Description Sample Definition Allows the Sample Starting Date, Sample Starting Time, Sample Ending Date, and Sample Ending Time to be set Sample Labeled Days Allows the days of the week to be selected to appear with labels on the Color Spectrum Sample Interval Allows the number of minutes for the interval to refresh data to be set

4. Click OK. Color Spectrum User’s Guide 2-9

Defining a New Color Map To define a new color map: 1. On the Edit menu, click Color Spectrum. 2. Select the Colors/Fonts Definition tab (Figure 2-4).

Figure 2-4: Color Spectrum Properties - Colors/Fonts Definition Tab 3. Click Add. The Define New Color Map dialog box appears (Figure 2-5).

Figure 2-5: Define New Color Map Dialog Box 2-10 Color Spectrum User’s Guide

4. Enter the color map name and number of color map segments. 5. Click OK. The Color Map dialog box appears (Figure 2-6). 6. Select Segment.

Figure 2-6: Color Map Dialog Box 7. Click on the Start Color and End Color to select desired colors. 8. Repeat Steps 6 and 7 for each segment. 9. Click OK. The Color Map dialog box closes. 10. Click OK. Color Spectrum User’s Guide 2-11

Reversing a Color Map To reverse a color map: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears (Figure 2-1). 2. Select the Colors/Fonts Definition tab (Figure 2-4). 3. Select the desired color map. 4. Select Reverse Color Map. 5. Click OK. Changing Color Spectrum Sample Colors To change Color Spectrum sample colors: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears (Figure 2-1). 2. Select the Colors/Fonts Definition tab (Figure 2-4). 3. Make desired modifications to: Background Color, Out of Range Color, Data not available, Offline/Data Error, and Restore Default Colors. 4. Click OK. Defining Minimum and Maximum Data Set Ranges To define minimum and maximum data set ranges: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears (Figure 2-1). 2. Make the necessary modifications. Refer to Table 2-2. 3. Click OK. Color Spectrum User’s Guide 3-1

Chapter 3 Using Color Spectrum

Introduction By using the Color Spectrum, operators are able to see the history of the point, in terms of how many times or when the point was in range, what the point’s values were, and also when the point was out of range. This chapter describes how to: • load an existing Color Spectrum • save an existing Color Spectrum • show or hide the box plot in Color Spectrum • zoom in on Color Spectrum • change Color Spectrum fonts • change the tick count for color legend

Key Concepts

Color Spectrum Modes Color Spectrum has two modes of display: solid color fill plot and box plot display. Patterns appear in the display according to a chosen color map. In the box display, horizontal and vertical grids appear. The horizontal grids are divided into intervals defined by the sample interval. Vertically, each division represents a day. Designated colors of a chosen color map appear on these grids. Figure 3-1 is an example of a non-box display. Each bar represents a specific data sample. In a solid color filled plot, sample information is shown in the form of solid filled boxes, which form a ribbon for a day’s worth of data. The boxes are solid filled with a color from the color map chosen, based on the sample object value and status for a particular time duration. The solid color filled plot is the default mode.

Figure 3-1: Example of Solid Color Fill in Color Spectrum Color Spectrum User’s Guide 3-3

Box Plot in Color Spectrum The Color Spectrum display information appears in a color box plot as well as a solid color filled plot. When the color box plot is selected, sample information appears in the form of hollow boxes. The outline of the boxes is drawn with colors from the color map, depending on the sample object value and status for a particular time duration. Operators can use the box plot mode to see individual samples more easily. Figure 3-2 is an example of a box plot display.

Figure 3-2: Example of Box Plot in Color Spectrum 3-4 Color Spectrum User’s Guide

Axis and Legend Ticks in Color Spectrum Once a Color Spectrum is defined, axis and legend ticks can be shown or hidden on the screen. This allows the ticks to show on a horizontal axis, vertical axis, and color map legend. The horizontal axis has two types of ticks: • small thin ticks shown at one hour intervals • long thick ticks shown at three hour intervals The ticks on the vertical axis are shown based on the days selected by the user. The Color map legend ticks are shown based on the number of ticks selected by the user in the Color Spectrum Properties dialog box. Figure 3-3 is an example with ticks.

Figure 3-3: Example of Ticks in Color Spectrum Color Spectrum User’s Guide 3-5

Color Spectrum Menus The menus in Table 3-1 are always available in Color Spectrum.

Table 3-1: Color Spectrum Menus Menu Command Description File New Defines a new Color Spectrum. Open Displays an existing Color Spectrum. Save Saves an existing Color Spectrum. Save As Allows the user to name and save a Color Spectrum. Print Prints current Color Spectrum. Print Preview Allows the user to view the page before printing. Print Setup Allows user to select desired printer. Recent File Lists last four recently opened Color Spectrum files. Exit Allows user to exit Color Spectrum. Edit Color Spectrum Opens the Color Spectrum Definition dialog box. View Toolbar Allows user to view toolbar. Status Bar Allows user to view status bar. Ticks Allows user to view tick marks. Box plot Allows the user to view the display in box plot mode. Zoom Allows the user to view display in larger size. Unzoom Allows the user to view display in normal size. Help Help Topics Gives user help with operating Color Spectrum. About Color Spectrum Gives user information about Color Spectrum revision level.

3-6 Color Spectrum User’s Guide

Toolbar Icons When a Color Spectrum document is opened as a standalone, the following icons appear on the window:

Table 3-2: Toolbar Icons Icon Command Description New Creates a new Color Spectrum.

Open Opens an existing Color Spectrum.

Save Saves a Color Spectrum.

Print Prints a Color Spectrum.

Edit Color Edits Color Spectrum parameters. Spectrum Show Box Shows Color Spectrum in box plot form. plot Show Ticks Shows ticks on Color Spectrum display.

Zoom Magnifies color ribbons on Color Spectrum display. Unzoom Normalizes the Color Spectrum.

About Displays help operating Color Spectrum.

Color Spectrum User’s Guide 3-7

Procedure Overview

Table 3-3: Using Color Spectrum To Do This Follow These Steps: Load an Existing Color On the File menu, click Open. Select desired Spectrum file. Click Open. Save an Existing Color On the File menu, click Save or Save As. Spectrum Enter file name. Click Save. Show or Hide the Box Plot in On the View menu, click Box plot. Color Spectrum Zoom In on Color Spectrum On the View menu, click Zoom. Left-click on the display area, and keeping the mouse clicked, drag the mouse to cover all the area to be enlarged. To unzoom: On the View menu, click Unzoom. Change Color Spectrum Fonts On the Edit menu, click Color Spectrum. Select the Colors/Fonts tab. Make desired modifications. Change the Tick Count for Select the Database. On the Edit menu, click Color Legend Color Spectrum. Select the Spectrum Definition tab. Select a point. Define the Minimum and Maximum analog values. Select the Sample Definition tab. Select the Start and End dates, specify the days to be labeled, and specify the Sample Interval. Click OK.

3-8 Color Spectrum User’s Guide

Detailed Procedures

Loading an Existing Color Spectrum To load an existing Color Spectrum: 1. On the File menu, click Open. The Open dialog box appears (Figure 3-4).

Figure 3-4: Open Dialog Box 2. Select desired file. 3. Click Open. Color Spectrum User’s Guide 3-9

Saving an Existing Color Spectrum To save an existing Color Spectrum: 1. On the File menu, click Save or Save As. The Save As dialog box appears (Figure 3-5). If the Color Spectrum is already named, the file saves without opening the Save As dialog box when Save is selected.

Figure 3-5: Save As Dialog Box 2. Enter file name. 3. Click Save. 3-10 Color Spectrum User’s Guide

Showing or Hiding the Box Plot in Color Spectrum To show or hide the box plot in Color Spectrum: On the View menu, click box plot. Figure 3-6 is an example with the box plot shown.

Figure 3-6: Box Plot Shown in Color Spectrum Color Spectrum User’s Guide 3-11

Zooming In on Color Spectrum To zoom in on Color Spectrum: 1. On the View menu, click Zoom. 2. Left-click on the display area, and keeping the mouse clicked, drag the mouse to cover all the area to be enlarged (Figure 3-7).

Figure 3-7: Example of Zoom in Color Spectrum Note: If the right mouse button is pressed while dragging, the selected area of Color Spectrum will not be zoomed. If you select the zoom icon located on the toolbar, click on the intended zoom area. To unzoom: On the View menu, click Unzoom. 3-12 Color Spectrum User’s Guide

Changing Color Spectrum Fonts To change Color Spectrum fonts: 1. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears. 2. Select the Colors/Fonts Definition tab (Figure 3-8).

Figure 3-8: Color Spectrum Properties - Colors/Fonts Definition Tab

Table 3-4: Colors/Fonts Definition Attributes Field Description Color Displays the Background, Data Not Available, Out of Range, and Offline/Data Error colors. Color Maps Displays the selected color map and allows the user to edit, add, or delete color map from the Color Spectrum. Selecting Reverse Color Map puts the color map in opposite defined order. Font Allows the font type for Title, Day/date, and Ticks to be selected.

3. Click on the button next to Title Font, Day/date Font, or Ticks Font choices. The Font dialog box appears (Figure 3-9). Color Spectrum User’s Guide 3-13

Figure 3-9: Font Dialog Box 4. Make desired modifications. Refer to Table 3-5.

Table 3-5: Font Dialog Box Attributes Field Description Font Displays the selected font. Font Style Displays the selected font style. Size Displays the size of the selected font. Effects When selected, font appears with strikeout or underline. Sample Displays a sample of the selected font. Color Displays the selected font color. Script Displays the selected script for the selected font.

5. Click OK. 3-14 Color Spectrum User’s Guide

Changing the Tick Count for Color Legend To change the tick count for the color legend: 1. Select the Database. 2. On the Edit menu, click Color Spectrum. The Color Spectrum Properties dialog box appears. 3. Select the Spectrum Definition tab (Figure 3-10). 4. Select a point. 5. Define the Minimum and maximum analog values.

Figure 3-10: Color Spectrum Properties - Sample Definition Tab 6. Select the Sample Definition tab. 7. Select the Start and End dates, specify the days to be labeled, and specify the Sample Interval. 8. Click OK. Color Spectrum User’s Guide A-1

Appendix A Color Spectrum ActiveX® Control

Introduction The ActiveX Control version of Color Spectrum is a software component that can be invoked by any container application, for example, M-Graphics. This version allows the user to take the view and place it anywhere on the graphic.

Key Concepts

ActiveX Technologies A loosely defined set of technologies developed by Microsoft corporation. ActiveX technologies is an outgrowth of two other Microsoft technologies called OLE (Object Linking and Embedding) and COM (Component Object Model). ActiveX technologies is not a programming language but rather a set of rules of how applications share information. ActiveX Control The ActiveX control represents a specific way of implementing ActiveX technologies. The ActiveX control can be used to provide limited functionality of an application, such as Color Spectrum, without having to download the entire program to a machine. Color Spectrum in ActiveX Control An ActiveX control allows the display of Color Spectrum graphs in M-Graphics displays or other ActiveX compliant applications such as Internet Explorer 4.0. Using the Color Spectrum ActiveX control, a user can put multiple Color Spectrum images into an M-Graphics display. When a Color Spectrum ActiveX control is created in an M-Graphics display, the information for the Color Spectrum graph is saved in the M-Graphics document. Therefore, instead of having a separate .csd file for the Color Spectrum display information, the Color Spectrum information is accessed when the M-Graphics document (.gdf file) is opened. A right mouse click allows the information to be stored as .csd file within M-Graphics. Note: For more information on the ActiveX control, refer to Microsoft Visual Basic Programmer’s Guide Version 4.0 (or Later) or Understanding ActiveX and OLE: A Guide for Developers & Managers written by David Chappell. Color Spectrum User’s Guide A-3

Expanded Right-click in a Color Spectrum ActiveX Control When a Color Spectrum display ActiveX control is inserted in an ActiveX compliant application, some of the menus appear in a menu bar. These menus can be accessed through an expanded right-click menu (Figure A-1). The menu commands are described in Table A-1.

Figure A-1: ActiveX Pop-up Menu

Table A-1: Menu Operation Command Description New Creates a new Color Spectrum display. Open Opens an existing Color Spectrum display. Save Saves a Color Spectrum display. Save As Saves Color Spectrum information in another file name. Edit Color Spectrum Opens Color Spectrum Definition dialog box. Show Ticks Displays horizontal and vertical gridlines. Select desired one. Box Plots Shows or hides the Color Legend. Zoom Displays Color Spectrum information in bigger size. Unzoom Displays Color Spectrum information in normal size. About Displays program information, copyright, and version information.

A-4 Color Spectrum User’s Guide

ActiveX Control Properties The following are attributes used for ActiveX Controls in custom built applications. The ActiveX Control version of Color Spectrum supports the properties shown in Table A-2.

Table A-2: ActiveX Properties Property Description BackgroundColor Sets the background color of Color Spectrum. The default color is black. DataNotAvailableColor Sets the Data Not Available color when point value is not defined. The default color is indigo. OfflineErrorColor Sets the Offline color when the point sample is not available. The default color is white. OutofRangeColor Sets the Out of Range color when point value goes out of set minimum and maximum range. The default color is black.

Color Spectrum Events The ActiveX version of Color Spectrum supports the events listed in Table A-3.

Table A-3: Color Spectrum Events Event Description Mouse Up Event Generates when the left or right mouse button is clicked in the Color Spectrum display area. Mouse Click Event Generates when the left mouse button is clicked in the Color Spectrum display area. Mouse Drag Event Generates when the left mouse button is clicked and held down while dragging the mouse pointer. This operation captures the mouse until the left mouse button is released.

Color Spectrum User’s Guide A-5

ActiveX Methods ActiveX version of Color Spectrum supports the methods described in Table A-4.

Table A-4: ActiveX Methods Method Description ShowTicks Returns True when Ticks appear on display. ShowBoxPlot Returns True when Color Spectrum is in Box Plot. EditColorSpectrum Displays the Color Spectrum Definition dialog box. GetColorSpectrumDisplayTitle Returns Color Spectrum title of currently open configuration. OnColorSpecZoom Zooms Color Spectrum display. OnColorSpecUnzoom Unzooms Color Spectrum when currently zoomed. IsCSZoomed Returns to normal view if zoomed or unzoomed. GetPrinterPages Returns the number of pages to the printer. OnPrintColorSpectrum Prints the open Color Spectrum display. GetErrorLineNumber Returns the line number in the error has occurred while loading the Color Spectrum file. GetLoadedFileName Returns the name of currently loaded configuration file. GetSpectrumModifiedStatus Returns last loaded Color Spectrum. NewColorSpectrumDisplay Opens a new Color Spectrum document. SaveColorSpectrumToFile Saves Color Spectrum display configuration to currently opened file. SerializeSpectrumData Serialize currently opened configuration file. ViewPopupMenu Returns Pop-up menu on right click. LoadColorSpectrumFromFile Loads Color Spectrum configuration from .csd file. GetTicksStatus Returns Ticks to display screen. GetBoxPlotStatus Returns Color Spectrum in Box Plot mode. ShowMetasysLogo Returns Metasys logo to display screen. SetCSDirectoryPath Sets path of the current working directory. IsZoomUnderLimit Determines if Color Spectrum zoom is under limit. IsEditPermitted Returns True when the operator has rights to Edit Color Spectrum. IsFileOpenPermitted Returns True when the operator has rights to open a Color Spectrum configuration. LaunchSecurityServer Launches security server for the Color Spectrum ActiveX control.

Color Spectrum User’s Guide B-1

Appendix B Color Spectrum Application

Introduction This appendix describes an application of using Color Spectrum to analyze facility energy usage.

Key Concepts

Color Spectrum Application The Color Spectrum canbe used to analyze facility energy usage. It shows the BAS operator the daily, weekly, and monthly patterns of energy usage. The operator is able to see when energy usage levels reach peak values, identify patterns indicating the energy waste and evaluate load limiting and optimal start strategies. When using Color Spectrum to analyze facility energy usage, the operator can use these helpful steps: • Select the energy point to be examined. • Set the start time to midnight – this sets the left edge of the display to midnight for each day, making the patterns in the energy usage data easy to relate to the time of day. • Set the Minimum analog value to the minimum energy usage. • Set the Maximum analog value to the maximum energy usage – these steps evenly distribute the energy usage value over the entire color map so that the patterns in the data are more readily seen. For typical cases several patterns in the display are seen. There is a daily pattern that corresponds to the building occupancy times. If you have chosen Map1 (default) as the Color Map the display shows colors ranging from cyan to blue to yellow to red. During unoccupied times the energy usage is low, displaying the cyan to blue color range. The energy usage begins to increase (green to yellow) during morning startup, usually peaking (yellow to red) during early afternoon and decreasing (blue to cyan) significantly after building shutdown. This pattern normally is repeated for Monday through Friday. Monday starts to turn green earlier than Tuesday through Friday. Weekends show significantly less energy usage with Saturday and Sunday in the cyan to blue color range. The next pattern is a weekly repetition of the daily patterns. Any abnormal energy usage shows up as an abrupt change in color. If an air handler is turned on at night (temporary occupancy) the color may change from cyan to blue or green while it was operating.

Controls Group www.johnsoncontrols.com 507 E. Michigan Street Printed in U.S.A. P.O. Box 423 Milwaukee, WI 53201