Setting up a live data feed

00:04

After defining a connection to a remote server in InfoWorks WS Pro,

00:09

it is time to give your live data configuration the information it requires to find feeds within the server,

00:15

which, in this example, is the Bridge CSV database.

00:19

With the Live Data Configuration open, click the Live Data Feed tab.

00:23

There are two ways to set up the feed tab: manually or by using a live data CSV file to do it automatically.

00:31

To set the feed tab up manually, click the cell in the first row in the Feed Name column,

00:37

and type in “189435”.

00:41

In the Connection column, expand the drop-down and click Bridge,

00:47

which is the connection name chosen earlier.

00:49

In the first row of the External Units column, expand the drop-down and select l/s (liters per second).

00:57

Set the Offset to 0 and the Factor to 1,

01:01

as this example requires no adjustments to the input values.

01:06

Expand the drop-down in the Time-step column and click 15 Mins.

01:11

Set the Time Window to 15.

01:14

In the Adaptor column, select Generic from the drop-down.

01:19

Then, in the Table Name drop-down, select M189435.csv.

01:26

Notice that the empty cells that do not require information are now grayed out.

01:31

To set up the feed tab automatically using a live data CSV file,

01:36

first click the cell in the second row of the Feed Name column.

01:40

In the Model Group window, right-click the Live Data Configuration and select Update > From CSV....

01:47

In the Import / Update from CSV Data dialog, click OK.

01:53

A file navigation window opens.

01:55

Select Live Data.

01:58

Select the file named BridgeTownLiveData.csv, and then click Open.

02:05

The file navigation window reopens to allow you to select another file,

02:10

but this is the only one for this example, so click Cancel.

02:15

A window opens, showing the results of the CSV data import

02:19

and notifying you that this process created new objects in the Live Data Feed.

02:24

Click the X to close this window.

02:27

In the Live Data Feed tab, new feeds—including all required information—are listed.

02:34

This is a much simpler way to populate this tab, especially if you are using multiple feeds.

02:40

Note the Offset and Factor columns in the grid.

02:44

Offset and factor simply reconcile differences between the raw data coming in through a telemetry system

02:49

and what a model is expecting.

02:52

The Offset is a value to be added to all telemetry data in the feed.

02:56

This is used to adjust the positioning or reference point of the incoming data.

03:02

For example, a logger might be recording pressure that is a representation of the pressure in relation to the logger’s position,

03:09

which may need to be adjusted to represent the pressure in relation to sea level.

03:14

The Factor is a multiplication factor for adjusting all telemetry data in the feed to account for known inconsistencies

03:22

and uncertainty in the incoming telemetry data,

03:25

such as a systematic under- or over-representation.

03:29

It applies only to live data points coming from files.

03:33

For example, models typically measure reservoir depth from bottom to top,

03:37

when a telemetry sensor may actually measure it the other way around.

03:41

The following steps are no longer mandatory, as Live Data Feeds can now be linked to model objects.

03:47

But, to populate the Live Data Point tab;

03:49

Click the Live Data Point tab.

03:52

In the first cell under Live Data Point ID, right-click and select Add live data feed.

03:58

In the Choose Telemetry Point window, click Select All, and then click OK.

04:05

The Live Data Point table automatically populates with the same data you entered into the Live Data Feed table.

04:13

Now that the live configuration is complete for the database,

04:16

the next step will be to link it to the network,

04:19

so that you know where in the network these points are.

Video transcript

00:04

After defining a connection to a remote server in InfoWorks WS Pro,

00:09

it is time to give your live data configuration the information it requires to find feeds within the server,

00:15

which, in this example, is the Bridge CSV database.

00:19

With the Live Data Configuration open, click the Live Data Feed tab.

00:23

There are two ways to set up the feed tab: manually or by using a live data CSV file to do it automatically.

00:31

To set the feed tab up manually, click the cell in the first row in the Feed Name column,

00:37

and type in “189435”.

00:41

In the Connection column, expand the drop-down and click Bridge,

00:47

which is the connection name chosen earlier.

00:49

In the first row of the External Units column, expand the drop-down and select l/s (liters per second).

00:57

Set the Offset to 0 and the Factor to 1,

01:01

as this example requires no adjustments to the input values.

01:06

Expand the drop-down in the Time-step column and click 15 Mins.

01:11

Set the Time Window to 15.

01:14

In the Adaptor column, select Generic from the drop-down.

01:19

Then, in the Table Name drop-down, select M189435.csv.

01:26

Notice that the empty cells that do not require information are now grayed out.

01:31

To set up the feed tab automatically using a live data CSV file,

01:36

first click the cell in the second row of the Feed Name column.

01:40

In the Model Group window, right-click the Live Data Configuration and select Update > From CSV....

01:47

In the Import / Update from CSV Data dialog, click OK.

01:53

A file navigation window opens.

01:55

Select Live Data.

01:58

Select the file named BridgeTownLiveData.csv, and then click Open.

02:05

The file navigation window reopens to allow you to select another file,

02:10

but this is the only one for this example, so click Cancel.

02:15

A window opens, showing the results of the CSV data import

02:19

and notifying you that this process created new objects in the Live Data Feed.

02:24

Click the X to close this window.

02:27

In the Live Data Feed tab, new feeds—including all required information—are listed.

02:34

This is a much simpler way to populate this tab, especially if you are using multiple feeds.

02:40

Note the Offset and Factor columns in the grid.

02:44

Offset and factor simply reconcile differences between the raw data coming in through a telemetry system

02:49

and what a model is expecting.

02:52

The Offset is a value to be added to all telemetry data in the feed.

02:56

This is used to adjust the positioning or reference point of the incoming data.

03:02

For example, a logger might be recording pressure that is a representation of the pressure in relation to the logger’s position,

03:09

which may need to be adjusted to represent the pressure in relation to sea level.

03:14

The Factor is a multiplication factor for adjusting all telemetry data in the feed to account for known inconsistencies

03:22

and uncertainty in the incoming telemetry data,

03:25

such as a systematic under- or over-representation.

03:29

It applies only to live data points coming from files.

03:33

For example, models typically measure reservoir depth from bottom to top,

03:37

when a telemetry sensor may actually measure it the other way around.

03:41

The following steps are no longer mandatory, as Live Data Feeds can now be linked to model objects.

03:47

But, to populate the Live Data Point tab;

03:49

Click the Live Data Point tab.

03:52

In the first cell under Live Data Point ID, right-click and select Add live data feed.

03:58

In the Choose Telemetry Point window, click Select All, and then click OK.

04:05

The Live Data Point table automatically populates with the same data you entered into the Live Data Feed table.

04:13

Now that the live configuration is complete for the database,

04:16

the next step will be to link it to the network,

04:19

so that you know where in the network these points are.

Video quiz

In the Live Data Configuration grid, after you set up the live feed to the database either manually or by import, you must then set up the __________, for it to be possible to connect to the network?

(Select one)
Select an answer

1/1 questions left unanswered

Step-by-step Guide

After defining a connection to a remote server in InfoWorks WS Pro, give your live data configuration the information required to find feeds within the server—which, in this exercise, is the Bridge CSV database.

  1. In the Model Group, double-click Live Data Configuration.
  2. In the Live Data Feed grid window, click the Live Data Feed tab.

In the InfoWorks WS Pro interface, the LiveData Feed grid window with the Live Data Feed tab called out.

The feed tab can be set up manually or by using a live data CSV file to do it automatically.

To set up the feed tab manually:

  1. In the Feed Name column, click the first cell and type “189435”.
  2. In the Connection column, expand the drop-down and select Bridge.
  3. In the External Units column, select l/s (liters per second).
  4. Set the Offset to “0”.
  5. Set the Factor to “1”.

This example requires no adjustments to the input values.

  1. In the Time-step column, select 15 Mins.
  2. Set the Time Window to “15”.
  3. In the Adaptor column, select Generic.
  4. In the Table Name column, select M189435.csv.

The empty cells that do not require information now appear grayed out.

The Live Data Feed grid window, Live Data Feed tab, with values entered in the first row and cells that do not require information grayed out.

If you are using multiple feeds, it is much easier to populate the feed tab automatically, using a live data CSV file:

  1. In the second row of the grid, click the Feed Name cell.
  2. In the Model Group, right-click Live Data Configuration and select Update > From CSV.

In the Model Group, the Live Data Configuration shortcut menu displayed with Update selected, and in the flyout, From CSV selected.

  1. In the Import / Update from CSV Data dialog, click OK.
  2. In the file browser, open the Live Data folder.
  3. Select BridgeTownLiveData.csv.
  4. Click Open.

In the file browser, the Live Data folder, with BridgeTownLiveData.csv highlighted and Open selected.

  1. When the file browser reopens to allow another file selection, click Cancel.

A window opens with the results of the CSV data import and a notification that new objects were created in the Live Data Feed. In the Live Data Feed tab, new feeds are now listed, including all required information.

The Live Data Feed table with new feeds listed, and a Results window with results of the CSV data import.

  1. Close the results window.

In the Live Data Feed, notice the Offset and Factor columns. The Offset value is added to all telemetry data in the feed to adjust the positioning or reference point of the incoming data. The Factor adjusts incoming telemetry data to account for known inconsistencies and uncertainty. It applies only to live data points coming from files.

  1. Click the Live Data Point tab.
  2. Under Live Data Point ID, right-click the first cell and select Add live data feed.

In the Live Data Point table, the Live Data Point ID shortcut menu with Add live data feed selected and called out.

  1. In the Choose Telemetry Point dialog box, enable Select All.
  2. Click OK.

The Live Data Point table automatically populates with the data entered into the Live Data Feed table.

The Live Data Point table populated with the data entered into the Live Data Feed table.

IMPORTANT: If the Live Data Point table is left empty, it will not be possible to connect to the network.

Was this information helpful?