Overview

The Graphing window provides traditional 2D graphs that plot sensor data metrics versus time. The graph below is an example of a single metric plot with multiple features enabled.

Navigating to Graphs

The graphs module can be accessed from the Connectivity module in one of two ways.

The first method directs the user to the graphing window where they can select a graph profile or create a new plot. 

1.  Select "Data" to navigate to the data module and access each of the different data analytics windows.

2.  Select "Graphs" to open the iTwin graphing window. You have successfully navigated to the graphing window.

The second method allows the user to select the sensor or sensors that they would like to graph, and then navigate to the graphing window in order to configure their graph plot.

1. From the Connectivity module, select a sensor, sensors, or device by marking the checkboxes.

2. After selecting sensors, a pop-up will appear with several options for navigating to other modules. Click on the  icon to navigate to the graph window (This icon will appear in other modules when selecting sensors. A user can use this icon to navigate to the graph window from other modules and windows when present.). The user can then edit the graph for the selected sensors.  

Graphs Window

This section of the article will review all of the options and configurations available to the user within the Graphs window to guide the user in utilizing graphs.

1. Configuration Cogwheel and Graphing Toolbar: The buttons located on the left-hand side of the page contain icons and options that allow the user to access and manage graphing profiles and manipulate features of the graphing window. See the Profiles article to learn what a profile is. This portion of the article will explain all of the configuration options available from the pop-out, 1A-1I.

Profile Settings and Graph Options: The gear icon, , opens a pop-out display of options as illustrated below.

1A: Click the "View All Profiles" button to navigate to a list of all graphing profiles created by or shared with you.

1B: Click the "Add Profile" button to create another graphing profile from scratch or copy from another profile.

1C Current Profile Options: This line lists the name of the current profile and options available for this profile. Click the sharing icon, , to access the sharing options for the selected graphing profile. To learn more about sharing, click here. Click the Pencil icon, , to change the name of the current profile. Click the Trash Can icon, , to delete the current profile.

1D Disable Profile Editing: Select the checkbox to prohibit any changes from being saved to the profile.

1E Export Data    : Export all data contained in the current profile to either Excel or CSV. The data will be exported in a tabular format.

1F Data Filtering: Enabling this checkbox will open a box that allows the user to input time frames of daily data in order to hide it from graphs.

1G Data Averaging: You can smooth out your graph lines by enabling data averaging, which gives you the option to average by Hour, Day, Week, Month, or Automatic.

1H Enabled Alerts: If any sensors contained in your profile have an existing Alert associated with them, the alert will show up here. Click the check box to show the alert threshold on the graph as illustrated in Point 7 of the graph overview.

1I Configuration Updates and Custom Events: Enabling configuration updates will display edits made to the sensor configuration on the graph. Enabling Custom Events will display any custom events that have been entered on the graph. Custom events are added using the flag described in 1L.

Additional Graphing Options

There are a number of additional graph options below the settings wheel that manipulate graphs and plots.

1J. Select Sensors: The Sensor Selection Tool,  ,  is used to choose the sensors that will be plotted on the graph. Learn more about how to use the Sensor Selection Tool Here. The data graphed in each plot is dependent on the sensors selected    and the sensor metric chosen in step 3.

1K. Add Plots: Use this button, , to add additional plots to the profile. Up to 6 Plots can be added to each page. Each plot can be used to graph different sensors, metrics, and time frames. Displaying multiple plots will cause two additional options to appear, the Lock and Plot Stacking. These options are enabled if highlighted blue.

•   Lock Time Frames:  Select this button to lock the time ranges of each of the plots together. The time range for each graph will snap to the time range chosen in the top left plot. This option will only become available after a second plot has been added to the profile. 
•  Stack Plots: If two plots are displayed, clicking the Stack Plots icon will stick the plots vertical on one another.

1L. Enable Event Mode: Clicking allows the user to add events that will be displayed as vertical lines on a graph. Hovering over and clicking on the graphed line with Event Mode enabled will allow the user to add an Event. An example of the event add pop-up window is displayed below.

1M. Enable Trend Line: Click the trend line icon,  , to allow the addition of a linear best-fit trend line to a dataset on the graph. An example of this trend line function can be seen highlighted on point 6.

1N. Delete Points: Click the trash can icon,   , to enter deletion mode. Once in deletion mode, the user can click on any point to permanently delete it from the server. The user will be prompted before any deletion actually occurs. Please note: Deleting data points from the graph will permanently delete this data from iTwin cloud storage. Only delete data if the data will never be required again.

2A. Date/Time Frame Selection:

Use the Date/Time Selection Tool in the upper left corner of the plot to easily jump to a preselected time frame. This will default to a Moving Window time frame with the end date always showing the most current data. Selecting the "All" option will display the sensor data from the first reading of any sensor selected on the graph to today's date. electing the "Fit" option will display the sensor data from the first reading of any sensor selected on the graph to the sensor data to the last reading of any sensor selected on the graph.

Click the clock icon, , to select a precise time frame. Select down to the minute you wish to set your time frame. An example of this window is seen below.

2B. Date/Time Frame Selection Slider:

Use the Date/Time Slider Tool located at the bottom of the page to easily adjust the time frame viewed in the plot. Drag the start and end date handles left and right to adjust the time frame.

The color of the Slider Handles will indicate how the slider behaves.

Static Time Window: Two Grey handles will indicate a static time frame. The time frame will remain there each time you revisit the profile

Moving Window locked to now: Bring the end date handle all the way to the right to "Lock to now". The handle will turn green to indicate it is always showing the most recent data collected. The end date will trail behind in a moving window.

End date locked to now and start date locked: Click the start date slider handle to lock it in place. The handle will turn red indicating that the start date is now fixed.

3. Metric/Unit Selection: The user can select the metric to display on the graph from the dropdown options available in this location. Select the metric type you would like to graph, and then select the metric from a dropdown list of available metrics for the sensors currently selected on the profile.

Click on the Units displayed to see different unit options for that Metric.

Certain Metrics will contain Calculation Parameters that affect the way the metric is calculated. Parameters configured here will override any settings that are already set in the sensor configuration and apply only to the plot chosen.

You can also add a second axis to your graph to plot two metrics on the same plot. To do this simply click  You can then choose two different metrics, one displayed on the left Y-axis and the second displayed on the right Y-axis. The legend will automatically turn on to let you know which line represents which metric. See the example below. 

4.  Plot Actions: 

4.1  Create an alert for the sensors currently selected in the plot.

4.2  Create a Table view for the sensors currently selected in the plot.

4.3  The Gear icon will open the following options:

 

Select to change your graph from the standard scale to a logarithmic scale. 

Select   to create a minimum and maximum limit to your graph. When you select this function you will be given the option to input your desired min and max in the boxes below

Select  to filter out any data outside of your chosen minimum and maximum values. When you select this function you will be given the option to input your desired min and max into the boxes below. 

Note: If you have two axis selected for a single graph, you will find options to filter data, and add axis limits for both of the axis in your graph seperately. 

You can unselect to view single points of the data that you are graphing. With Show Graph Lines turned off, your graph will look like this: 

Selecting the Option will bring up a legend for all of the sensors that you have selected within the graphing profile. Clicking on a sensor within the legend will toggle the sensor data on or off of the graph. 

You can use the option to search for certain types of sensors that you have in your graphing profile, and filter out the ones you do not want to include. To do this you can just type in the name of the sensor/ sensors you're looking for and click the enter button. 

4.4  Download the plot to a JPG, PNG, PDF, or SVG Vector Image.

4.5  Click the X to delete the chart from the profile.

5. Tool Tips: Hover over any Data Point to open up its Tool Tip. This will display the sensor name, data value, and time stamp.

You can also quickly remove a graphed sensor by holding down command on Mac or control on windows and selecting the graphed data you would like to remove. The tooltip window will change to the picture below.

6.  Trend Lines: The graphing module can calculate the linear regression of the data between two points and visually display it as a trend line. To plot a trend line, enable 1L and hover your cursor over the line. The tooltip will then indicate that you can start a trend line.

To remove the trend line simply hover the cursor over the line and the tooltip will indicate you can remove the trend line.

7.  Alert Thresholds: If any data contained within the graph has an alert associated with it, the alert threshold can be displayed on top of the plot. Open up the profile settings in section 1H to turn on any relevant alert.

8. Legend: The legend will show which sensors you have displayed on your plot. The legend can be moved anywhere on the plot. The legend can be added by clicking on the cog wheel icon of section.