Viewing Data in a TWC Ad Hoc Chart

The CygNet Thin Web Client provides a way to add any CygNet point presented in the main web view to an on-demand or ad hoc chart. For any point-based control that supports a context menu, an option is available to add a selected point to a new chart or existing chart, which then opens in a separate browser tab.

Ad hoc charts are interactive in that you can change the date and time range displayed in the chart via a Date/Time calendar or six preset shortcut buttons, enable or disable live updating, and hide or show unreliable points. Each chart page includes a grid of point data, which is responsive to the selected point series. A series can be deleted on demand, and the grid data can be exported to an Excel file.

Note that an ad hoc chart is not a template. Any saved chart is hard-coded with specific point tags. You can always add a other points to a previously saved chart. And then you can delete a point from the ad hoc chart as desired.

All ad hoc charts are saved by default. Each chart is given a default chart name; and any chart can be renamed, duplicated, or deleted when no longer needed. Ad hoc charts are browser based, stored in the local storage space of the browser, meaning if you save a chart in Edge, it cannot be viewed in Chrome. Each logged-in user has their own local storage space for the browser. Each chart has its own URL, taking the form: https://<server_name>:5001/adhocchart/<name of chart>. Once saved, an ad hoc chart can be viewed from the main TWC page via the Saved Charts (Saved Charts ) button.

The following sample ad hoc chart shows Pressure Casing (PRCASXIN) for four facilities on the Colfax Central Delivery Point (CDP) for the last eight hours. Series data for the highlighted facility, Ash Well, is presented in a grid below the chart. Any series in the chart can be displayed in the grid by selecting the facility in the legend. From here you can export data to Excel or delete the series. Any point in a series can be examined by hovering over the point to see a small popup showing the long point ID, point value, and timestamp. Also shown in this example is the Settings menu on the far right where you can rename, duplicate, or delete the current chart.

Sample TWC ad hoc chart

Click the thumbnail to see a
sample TWC ad hoc chart.

The page design for an ad hoc chart is fixed. The chart page is divided into several sections, with different options to interact with the data presented. See the following subsections for more information:

Menu Bar

The menu bar along the top of the chart page provides options to interact with the chart by manipulating the time range and data visibility.

Option Description

Date/Time pickers

To change an ad hoc chart's time range use the From Date/Time and To Data/Time calendars to select date and time:

  • Click Date Time Chooser (From Date/Time) to reveal a Date picker.
    • Specify desired values, click Set, and the chart will be redrawn to display the new date/time.
    • Or click Cancel to close the Date picker.
  • Click Date Time Chooser (To Date/Time) to reveal a Date picker.
    • Specify desired values, click Set, and the chart will be redrawn to display the new date/time.
    • Or click Cancel to close the Date picker.

Note: You can also type the desired date and/or time directly into the control.

Date picker

Date/Time picker

 

Time picker

Date/Time picker

Shortcut buttons

Use the shortcut buttons (1 Hour, 6 Hours, 8 Hours, 1 Day, 5 Days, or 7 Days) to quickly select a predefined time range for the chart.

Live chart

The Live chart toggle indicates whether the ad hoc chart will request new data allowing the chart to trend data at a real-time pace. When live updates are enabled and any change occurs, e.g., the next poll, the series line will update to reflect the slope change.

  • Toggle the Live chart option to enable or disable the live chart feature for real-time updates.
  • The Date/Time pickers are replaced with two controls to specify the starting date for a chart; that is, the amount of time in the past from when to start the series.
  • Type a number in the Earliest text box (or use the spin control) and select a time period (Seconds, Minutes, Hours, Days, Years) from the drop-down menu. For example, 8 Hours ago or 2 Days ago.

Note: The live chart update rate is not configurable in TWC. The update rate is based on a subscription model and points will be sent to the client browser whenever the server is updated. So, if the point updates every second on the server, then the web client will update that data point every second.

Enable live chart controls

Live chart controls

Clean data

Click the Clean data toggle to display only clean data and hide any unreliable data in the chart based on a point's unreliable point state. The UNRELIABLE status bit is set when a point is deemed unreliable. When enabled data points marked as unreliable will be hidden in the chart. When disabled, unreliable data points will be shown in the chart.

Settings Menu

A Settings menu is available on the far right of the page with three options to rename, duplicate, or delete the current chart.

  • Click Charts Settings (three vertical dots) to reveal the Settings menu.
  • Click Rename chart to give the current chart a new name. Type the new chart name in the Rename chart popup and click OK. The renamed chart is now included in the drop-down list of saved ad hoc charts in the TWC context menu and in the Saved Charts list on the main TWC page.
  • Click Duplicate chart to make a copy of the current chart. The current chart is duplicated and "New" is appended to the chart name. Rename the chart as desired. The duplicated chart is now included in the drop-down list of saved ad hoc charts in the TWC context menu and in the Saved Charts list on the main TWC page.
  • Click Delete chart to delete the current chart and return to the main TWC page. The deleted chart is removed from the drop-down list of saved ad hoc charts in the TWC context menu and from the Saved Charts list on the main TWC page. You must delete all unwanted charts.
 

Settings menu

Settings menu

Chart

The chart is presented below the menu bar.

Grid

The grid presented below the chart displays historical data for the selected series in the chart in five columns: Timestamp, Value, Point State, Status, and Point Tag. If the chart contains multiple series, the grid is populated with the first series when the chart is first loaded.