Versions Compared

Key

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

Overview

The Replicate Runner runs a single eWater Source model multiple times using an ensemble of time-series inputs. The runner can be used, for example, to run an eWater Source model with a range of alternative climate data inputs. 

There are two means of specifying the time series ensembles:

  1. Generating variants of an existing time series using the Time Series Cycle Creator (TSCC)
  2. Loading a set of pre-generated time series
Warning

Option 2 is not currently available for eWater Run Manager.

eWater Source Project Setup

To run a Replicate job, the eWater Source project must already be created with the time-series to be cycled loaded in Data Sources. It is possible to cycle a single Data Source or multiple Data Sources.

In order to be cycled, the time-series Data Sources must be configured as follows:

  1. Reload on Run must be enabled (which instructs eWater Source to reload the data from a file on disk before simulating the model).
  2. The location of the data file must be specified as a Relative Path, and it must be in the same directory, or a sub-directory, of the eWater Source project file.
  3. The data file must be in the CSV file format.
  4. The data files must only contain data covering whole years otherwise cycled data will not match the correct day or month.

For time series that are not to be cycled, Reload on Run must be disabled.

Once configured, the eWater Source project and CSV files (containing the time series to be replicated) must be placed in a ZIP file. The CSV files can be located in sub-directories of the eWater Source project file.

Contents

Table of Contents
maxLevel3
excludeContents
printablefalse

Job Creation

Upload Data

Click "Choose project zip" and select the .zip file that contains your Replicate project. It may take a few seconds for the file to upload.

Once the project has uploaded, the Replicate Runner configuration options will be displayed.

Source Project Configuration

Table 2 lists the eWater Source project configuration options

Table 2. eWater Source project configuration options.
Configuration OptionDescription
ScenarioChoose the eWater Source scenario to be run
Running ConfigurationChoose which Running Configuration should be simulated

Anchor
TSCC
TSCC
Time Series Cycle Creator (TSCC) Configuration

The TSCC generates variants (called replicates) of an existing time series by repetitively 'cycling' the start of the time series to the end. The user can choose whether the data is cycled on a daily, weekly, monthly or annual basis. Table 1 lists the TSCC parameters.

Table 1. TSCC parameters.
ParametersRequirementDescription
Number of ReplicatesRequiredThe number of replicates (output time-series) that will be created
Start Cycle DateOptional

The first data date that will be used by the TSCC to generate the replicates (data prior to this date is cycled to the end of the time series before generating any replicates).

This will default to the start date of the input time series, if not specified.

Start Year ReplicatesOptional

The year that the replicates will be reported as starting in . (The the replicates will always use the same start day and month as the input time-series.)). The Start Year Replicates cannot be after the Source simulation start date, as this will cause the simulation to fail.

This will default to the first year of the input time-series, if not specified.


Example

Consider a daily time-series that spans the following 10 year period: 1/01/2000, 2/01/2000, 3/01/2000, ..., 31/12/2009. The data is used by a model that simulates a 2 year period from 1/1/2004 to 31/12/2005.

Running the TSCC with the following parameters would produce 3 replicates:

  • Number of Replicates = 3
  • Start Cycle Date = 1/01/20022006
  • Start Year Replicates = 20102004

The start date for all the replicates would be reported as 1/01/20102004 (i.e. Start Year Replicates) (and the end date would be 31/12/20192013). The values of the replicates would be as follows:

Replicate 01: the time series values would correspond to the following years of the input original time-series : 2002, 2003, 2004, 2005, (2006 is the Start Cycle Date): 2006, 2007, 2008, 2009, 2000, 2001, 2002, 2003, 2004, 2005. The model would simulate the original 2006 to 2007 data (although it would report this as being 2004 to 2005).

Replicate 12: the first year of replicate 0 1 would be moved to the end. Hence, the values of replicate 1 2 would correspond to the following years of the input original time-series: 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2000, 2001, 2002, 2003, 2004, 2005, 2006. The model would simulate the original 2007 to 2008 data (and would report this as being 2004 to 2005).

Replicate 23: the first year of replicate 1 2 would be moved to the end. Hence, the values of replicate 2 3 would correspond to the following years of the input original time-series: 2004, 2005, 2006, 2007, 2008, 2009, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007. The model would simulate the original 2008 to 2009 data (and would report this as being 2004 to 2005).

Queue Job Configuration

Specify a custom name for the job and, finally, select Queue to add the Replicate Runner job to the queue of jobs to be run.