Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section describes how to load time series data into Source and how to manually enter data in to tables. Additional sub-pages include:

 

Child pages (Children Display)

...

When time series data is loaded in to Source, it is referred to as a data source and is available throughout Source. To either load new data sources, or access previously loaded data sources, you can use:

...

Figure 1. Loading a data source from within a component's feature editor

 

Anchor
DataSourcesExplorer
DataSourcesExplorer
Data Sources Explorer

...

Figure 2 shows features of the Data Sources Explorer containing all data sources available in the scenario, both from time series data files and another scenario. Additionally, the nodes that some of the data sources are associated with are shown. Once a time series has been assigned to a node it is locked to that node, as indicated by the padlock.

Figure 2. Data Sources Explorer

...

  • Click the Load data file button and navigate to and select your time series data file. 
  • Anchor
    Relative path
    Relative path
    The path to you data file is displayed. If you enable the Relative Path check box, the path displayed is the location of the time-series file relative to the project. Note that the project must have been saved prior to this. 

  • Each column of data in the time series data file becomes a row in the Data table. All time series data in the file is imported by default. You can select what columns to import by toggling the appropriate check box in the Import column.
  • Choose the scenario input set(s) associated with this data source by clicking on the arrow for the Default Input Set tab and toggling the appropriate check boxes. Refer to Assigning data sources to scenario input sets for more detail. 
  • Click on Reload on Run to toggle whether Source reloads the data into the internal store when the Scenario is next run (for more information, see below).
  • Click on a Default Units cell and choose the appropriate units from the drop down menu. To filter the list of units , select the Default Units input box a begin typing the name of the unit that you require. Right-click on a Default Units cell to bring up a contextual menu that allows you to Apply Unit to all data.

...

Info
iconfalse
titlePerformance Improvement


Excerpt

Performance can be improved on large models by splitting the model in to parts and running them separately and then using scenario data sources. For example, a model can be split into an upstream and a downstream scenario. Then, the results from the upstream scenario can be a scenario data source in the downstream scenario. In this case, Reload on Run should generally be enabled, to ensure that the downstream scenario is always using the most recent results from the upstream scenario.


 

You can only load the result(s) of scenario run(s). Therefore, ensure that the donor scenario has been run before you load the scenario data source into the acceptor scenario.

...

  • Click on the ellipsis (…) button on the first column of the Data table, which opens the Results dialog (Figure 7).
  • This dialog lists the most recent results for each scenario that you have run in your project. Choose the result that you wish to use as input data to your current scenario. In Figure 7, this data is Upstream Scenario Confluence 1's Downstream Flow;
  • Click OK to close the Results dialog. 
  • If required, enable the Reload on Run checkbox (see below). 
  • The units are set automatically from the result chosen.
  • Just as with time series, you can select the scenario input set(s) associated with this data source.
  • To load another scenario data source, repeat this process.

...

Once you assign a time series to a node or link, the associated component is shown underneath that time series (Figure 2). A time series can be disconnected from a component.

Figure 6. Load Scenario Data Source

...

Info
iconfalse

Note: If the Sets if a failed "Reload on run" will stop the current run button in the Data Sources toolbar is enabled (it is shown enabled in Figure 3), and the data source cannot be found, the scenario run will fail. However, if this icon is toggled off, Source will continue to use the data in its internal store, regardless of whether the source file can be found or the source scenario has been run yet.

...

Scenario input sets allow you to easily switch between groups of input data and parameters that represent different conditions, such as normal, wet and dry (see Scenario Input Sets for more information). Data sources are assigned to specific scenario input set(s) using the Load Data Source dialogs (Figures 5, 6).

Each scenario has a Default Input Set created automatically when you create the scenario, and by default all loaded data sources will be assigned to this root-level scenario input set. To create another root-level scenario input set, see Adding Scenario Input Sets. It is also possible to create a child scenario input set, which inherits all parameters and data sources specified in its parent. However, data sources can only be assigned to root-level scenario input sets.

...

  • Open the Load file data source dialog (Figure 5) either by creating a new data source or editing an existing one (see Loading a file data source for more information).
  • The first time series data file you load is associated with all scenario input sets that exist when it is loaded. 
  • For each additional time series data file you want to add to the data source:
    • Create a new tab by clicking the Add New Tab button. By default new tabs are not associated with any scenario input sets.
    • Load the time series data file (see Loading a file data source for more information)

      Info
      iconfalse

      Note: Each time series data file must contain the same number of time series columns as the other files in that data source, in the same order.


  • Choose the scenario input set(s) to associate with each time series data file by selecting the tab's drop-down menu and toggling the check box next to the appropriate scenario input set(s). The associated scenario input sets are listed in the tab's heading. For example, in Figure 5, Flows.csv is associated with Default Input Set and Dry Weather. Source will warn you if you assign more than one time series data file to the same scenario input set. 
  • The check box next to the tab name determines which time series data file Source will use to name the time series columns; only one of the tabs can be toggled on. If none of the check boxes are selected, the column names from the file in the first tab will be used.
    The default name of the data source will be the file name in the first tab. Both the data source and the time series columns can be renamed in the Data Source Explorer (see above). 

Assign a scenario data source to scenario input set(s) as explained for a file data sources, but use a new tab for each input scenario.

...

An example of a completed table is shown in Figure 10.

 

Figure 9. Steps to manually enter data tables

...

Figure 10. Manual data entry in tables (completed)