Replicate Runner

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:

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

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:

Reload on Run must be enabled (which instructs eWater Source to reload the data from a file on disk before simulating the model).
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.
The data file must be in the CSV file format.
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.

Job Setup

Choose Project Zip

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

Table 1 lists the eWater Source project configuration options

Table 1. eWater Source project configuration options.

Configuration Option

Description

Scenario

Choose the eWater Source scenario to be run

Running Configuration

Choose which Source Running Configuration should be simulated.

Currently, the Run Manager is only designed to be used with Single Simulation.

Time Series Cycle Creator (TSCC)

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.

Parameters

Requirement

Description

Number of Replicates

Required

The number of replicates (output time-series) that will be created

Start Cycle Date

Optional

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 Replicates

Optional

The year that the replicates will be reported as starting in (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/2006
Start Year Replicates = 2004

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

Replicate 1: the time series values would correspond to the following years of the original time-series (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 2: the first year of replicate 1 would be moved to the end. Hence, the values of replicate 2 would correspond to the following years of the original time-series: 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 3: the first year of replicate 2 would be moved to the end. Hence, the values of replicate 3 would correspond to the following years of the original time-series: 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).

Job Outputs

Choose which outputs the user would like to store and be able to access on completion of the job.

Queue

The Queue enables the user to configure the job details, estimate costs, and send the job to the queue. Table 1 lists the configuration options.

Table 2. Single Simulation Queue options.

Configuration Option	Description
Job Name	The name given to the job when viewed in the Run Manager
Agent Endpoints	Choose which type of agents should be used to run the job
Number of Agents	Choose the maximum number of agents used to run the job
Model Run Estimate (Minutes)	(Optional) The user's estimate of how long it will take to run the Source project once
Estimate	(Optional) Estimates the costs of running the job based on the user's Model Run Estimate, the selected agents, and the job type.
Queue	Adds the job to the queue of jobs to be run