Time

  • read tcf

    read_tcf The read_tcf module is specifically designed to create models and animations of data that changes over time. This type of data can result from water table elevation and/or chemical measurements taken at discrete times or output from Groundwater simulations or other 3D time-domain simulations. The read_tcf module creates a field using a Time Control File (.TCF) to specify the date/time, field and corresponding data component to read (in netCDF, Field or UCD format), for each time step of a time_data field. All file types specified in the TCF file must be the same (e.g. all netCDF or all UCD). The same file can be repeated, specifying different data components to represent different time steps of the output.

  • read multi tcf

    read_multi_tcf The read_multi_tcf module is one of a limited set of Time_Data modules. These modules are specifically designed to create models and animations of data that changes over time. This type of data can result from water table elevation and/or chemical measurements taken at discrete times or output from Groundwater simulations or other 3D time-domain simulations.

  • time value

    time_value The time_value module is used to parse a TVF file consisting of dates, values, and (optional) labels. The starting and end dates are read from the file and the controls can be used to interpolate the values to the date and time of interest. Module Input Ports Date [Number] Accepts a date Module Output Ports Start Date [Number] Outputs the starting date End Date [Number] Outputs the ending date Date [Number] Output date Current Date and Time Label [String] Resulting string for the output date Current Date and Time Value [Number] Resulting value for the output date TVF File Format

  • time horizon

    time horizon The time horizon module allows you to extract a surface from a set of time-based surfaces. The time for the extracted surface can be any time between the start and end of the surface set. It will interpolate between adjacent known times.

  • time loop

    time_loop General Module Function The time_loop module is one of a limited set of Time_Data modules. These modules are specifically designed to create models and animations of data that changes over time. This type of data can result from water table elevation and/or chemical measurements taken at discrete times or output from Groundwater simulations or other 3D time-domain simulations.

Subsections of Time

read_tcf

The read_tcf module is specifically designed to create models and animations of data that changes over time. This type of data can result from water table elevation and/or chemical measurements taken at discrete times or output from Groundwater simulations or other 3D time-domain simulations.

The read_tcf module creates a field using a Time Control File (.TCF) to specify the date/time, field and corresponding data component to read (in netCDF, Field or UCD format), for each time step of a time_data field. All file types specified in the TCF file must be the same (e.g. all netCDF or all UCD). The same file can be repeated, specifying different data components to represent different time steps of the output.

read_tcf effectively includes internal interpolation between appropriate pairs of the files/data_components specified in the TCF file. Its internal structure only requires reading two successive time steps rather than the complete listing of time steps normally represented in a time_data field.

Module Input Ports

  • Date [Number] Accepts a date

Module Output Ports

  • Start Date [Number] Outputs the starting date
  • End Date [Number] Outputs the ending date
  • Date [Number] Output date
  • Output Field [Field] Outputs the data field

  • TCF File

    TCF File Format and Example The listing below is the full contents of the Time Control File control_tce_cdf.tcf. Blank lines or any lines beginning with a “#” are ignored. Valid lines representing time steps must be in order of ascending time and consisting of: a) a date and/or time in Windows standard format b) a file name with an absolute path or just the filename (if the data files are in the same directory as the TCF file). This is not a true relative path (..\file.cdf and subdir\file.cdf don’t work, but file.cdf does), but gives some of the relative path abilities.

Subsections of read tcf

TCF File Format and Example

The listing below is the full contents of the Time Control File control_tce_cdf.tcf. Blank lines or any lines beginning with a “#” are ignored. Valid lines representing time steps must be in order of ascending time and consisting of:

a) a date and/or time in Windows standard format

b) a file name with an absolute path or just the filename (if the data files are in the same directory as the TCF file). This is not a true relative path (..\file.cdf and subdir\file.cdf don’t work, but file.cdf does), but gives some of the relative path abilities.

c) the data component to use for that time step. (You can specify -1 in the third column, which causes ALL the data components to pass through.)

NOTE: These three items on each line must be separated with a comma “,”.

This file contains the list of control commands for the

TCE time data in netCDF format.

The format is a date/time, then the file, then the nodal data component.

The END on the last line is optional.

Each line MUST be comma delimited

(since spaces can exist in the time and filename)

6/1/1990 12:00 AM, $XP_PATH<0>/data/netcdf/time_data/tce_01.cdf, 0

12/1/1990, $XP_PATH<0>/data/netcdf/time_data/tce_02.cdf, 0

2/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_03.cdf, 0

5/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_04.cdf, 0

8/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_05.cdf, 0

11/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_06.cdf, 0

3/1/1992, $XP_PATH<0>/data/netcdf/time_data/tce_07.cdf, 0

6/1/1992, $XP_PATH<0>/data/netcdf/time_data/tce_08.cdf, 0

10/1/1992, $XP_PATH<0>/data/netcdf/time_data/tce_09.cdf, 0

3/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_10.cdf, 0

4/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_11.cdf, 0

8/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_12.cdf, 0

12/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_13.cdf, 0

3/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_14.cdf, 0

6/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_15.cdf, 0

9/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_16.cdf, 0

11/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_17.cdf, 0

3/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_18.cdf, 0

5/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_19.cdf, 0

8/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_20.cdf, 0

10/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_21.cdf, 0

1/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_22.cdf, 0

5/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_23.cdf, 0

9/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_24.cdf, 0

11/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_25.cdf, 0

12/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_26.cdf, 0

3/1/1997 12:00 AM, $XP_PATH<0>/data/netcdf/time_data/tce_27.cdf, 0

6/1/1997, $XP_PATH<0>/data/netcdf/time_data/tce_28.cdf, 0

9/1/1997, $XP_PATH<0>/data/netcdf/time_data/tce_29.cdf, 0

12/1/1997, $XP_PATH<0>/data/netcdf/time_data/tce_30.cdf, 0

3/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_31.cdf, 0

6/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_32.cdf, 0

9/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_33.cdf, 0

11/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_34.cdf, 0

5/1/1999, $XP_PATH<0>/data/netcdf/time_data/tce_35.cdf, 0

10/1/1999, $XP_PATH<0>/data/netcdf/time_data/tce_36.cdf, 0

3/1/2000, $XP_PATH<0>/data/netcdf/time_data/tce_37.cdf, 0

7/1/2000, $XP_PATH<0>/data/netcdf/time_data/tce_38.cdf, 0

11/1/2000, $XP_PATH<0>/data/netcdf/time_data/tce_39.cdf, 0

3/1/2001, $XP_PATH<0>/data/netcdf/time_data/tce_40.cdf, 0

5/1/2001, $XP_PATH<0>/data/netcdf/time_data/tce_41.cdf, 0

10/1/2001, $XP_PATH<0>/data/netcdf/time_data/tce_42.cdf, 0

END

read_multi_tcf

The read_multi_tcf module is one of a limited set of Time_Data modules. These modules are specifically designed to create models and animations of data that changes over time. This type of data can result from water table elevation and/or chemical measurements taken at discrete times or output from Groundwater simulations or other 3D time-domain simulations.

The read_multi_tcf module creates a field using one or more Time Control Files (.TCF). Click here for an example of a TCF fileand a description of the format.

The read_multi_tcf module creates a mesh grid with the interpolated data from a user specifed number of TCF files (n). It outputs the first data component from the first (n-1) TCF files and all of the time interpolated data components from the nth TCF file.

For example, if you were trying to create a time animation of the union of 3 analytes (e.g. Benzene, Toluene & Xylene), read_multi_tcf allows you to select all three separate TCF files. Only the first data component from Benzene.tcf (nominally the concentration of benzene) is output as the new first data component. The first data component from Toluene.tcf (nominally the concentration of toluene) is output as the new second data component. All of the data components from Xylene.tcf are then output (typically xylene, confidence_xylene, uncertainty_xylene, Geo_Layer, Material_ID, Elevation, etc.). This allows you to explode layers and do other typical subsetting and processing operations on the output of this module.

The TCF files should be created using identical grids with date ranges that overlap the time period of interest.

read_multi_tcf effectively includes an inter_time_step module internally in that it performs the interpolation between appropriate pairs of the files/data_components specified in the TCF file. Its internal structure only requires reading two successive time steps rather than the complete listing of time steps normally represented in a time_data field.

  • TCF File

    TCF File Format and Example The listing below is the full contents of the Time Control File control_tce_cdf.tcf. Blank lines or any lines beginning with a “#” are ignored. Valid lines representing time steps must be in order of ascending time and consisting of: a) a date and/or time in Windows standard format b) a file name with an absolute path or just the filename (if the data files are in the same directory as the TCF file). This is not a true relative path (..\file.cdf and subdir\file.cdf don’t work, but file.cdf does), but gives some of the relative path abilities.

Subsections of read multi tcf

TCF File Format and Example

The listing below is the full contents of the Time Control File control_tce_cdf.tcf. Blank lines or any lines beginning with a “#” are ignored. Valid lines representing time steps must be in order of ascending time and consisting of:

a) a date and/or time in Windows standard format

b) a file name with an absolute path or just the filename (if the data files are in the same directory as the TCF file). This is not a true relative path (..\file.cdf and subdir\file.cdf don’t work, but file.cdf does), but gives some of the relative path abilities.

c) the data component to use for that time step. (You can specify -1 in the third column, which causes ALL the data components to pass through.)

NOTE: These three items on each line must be separated with a comma “,”.

This file contains the list of control commands for the

TCE time data in netCDF format.

The format is a date/time, then the file, then the nodal data component.

The END on the last line is optional.

Each line MUST be comma delimited

(since spaces can exist in the time and filename)

6/1/1990 12:00 AM, $XP_PATH<0>/data/netcdf/time_data/tce_01.cdf, 0

12/1/1990, $XP_PATH<0>/data/netcdf/time_data/tce_02.cdf, 0

2/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_03.cdf, 0

5/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_04.cdf, 0

8/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_05.cdf, 0

11/1/1991, $XP_PATH<0>/data/netcdf/time_data/tce_06.cdf, 0

3/1/1992, $XP_PATH<0>/data/netcdf/time_data/tce_07.cdf, 0

6/1/1992, $XP_PATH<0>/data/netcdf/time_data/tce_08.cdf, 0

10/1/1992, $XP_PATH<0>/data/netcdf/time_data/tce_09.cdf, 0

3/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_10.cdf, 0

4/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_11.cdf, 0

8/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_12.cdf, 0

12/1/1993, $XP_PATH<0>/data/netcdf/time_data/tce_13.cdf, 0

3/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_14.cdf, 0

6/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_15.cdf, 0

9/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_16.cdf, 0

11/1/1994, $XP_PATH<0>/data/netcdf/time_data/tce_17.cdf, 0

3/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_18.cdf, 0

5/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_19.cdf, 0

8/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_20.cdf, 0

10/1/1995, $XP_PATH<0>/data/netcdf/time_data/tce_21.cdf, 0

1/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_22.cdf, 0

5/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_23.cdf, 0

9/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_24.cdf, 0

11/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_25.cdf, 0

12/1/1996, $XP_PATH<0>/data/netcdf/time_data/tce_26.cdf, 0

3/1/1997 12:00 AM, $XP_PATH<0>/data/netcdf/time_data/tce_27.cdf, 0

6/1/1997, $XP_PATH<0>/data/netcdf/time_data/tce_28.cdf, 0

9/1/1997, $XP_PATH<0>/data/netcdf/time_data/tce_29.cdf, 0

12/1/1997, $XP_PATH<0>/data/netcdf/time_data/tce_30.cdf, 0

3/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_31.cdf, 0

6/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_32.cdf, 0

9/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_33.cdf, 0

11/1/1998, $XP_PATH<0>/data/netcdf/time_data/tce_34.cdf, 0

5/1/1999, $XP_PATH<0>/data/netcdf/time_data/tce_35.cdf, 0

10/1/1999, $XP_PATH<0>/data/netcdf/time_data/tce_36.cdf, 0

3/1/2000, $XP_PATH<0>/data/netcdf/time_data/tce_37.cdf, 0

7/1/2000, $XP_PATH<0>/data/netcdf/time_data/tce_38.cdf, 0

11/1/2000, $XP_PATH<0>/data/netcdf/time_data/tce_39.cdf, 0

3/1/2001, $XP_PATH<0>/data/netcdf/time_data/tce_40.cdf, 0

5/1/2001, $XP_PATH<0>/data/netcdf/time_data/tce_41.cdf, 0

10/1/2001, $XP_PATH<0>/data/netcdf/time_data/tce_42.cdf, 0

END

time_value

The time_value module is used to parse a TVF file consisting of dates, values, and (optional) labels. The starting and end dates are read from the file and the controls can be used to interpolate the values to the date and time of interest.

Module Input Ports

  • Date [Number] Accepts a date

Module Output Ports

  • Start Date [Number] Outputs the starting date
  • End Date [Number] Outputs the ending date
  • Date [Number] Output date
  • Current Date and Time Label [String] Resulting string for the output date
  • Current Date and Time Value [Number] Resulting value for the output date

  • TVF File Format

    TVF files provide a way to generate a time varying numeric and option string (label). The file is similar to the TCF file, but does not reference info

Subsections of time value

TVF files provide a way to generate a time varying numeric and option string (label). The file is similar to the TCF file, but does not reference information in external files.

The file consists of two or more rows, each having 2 or 3 columns of information. The columns must contain:

  1. Date and/or time in Windows standard format
  2. A numeric (float) value (required)
  3. A string consisting of one or more words. These need not be in quotes. Everything on the row after the numeric value will be used. (optional)

Dates must be in order from earliest to latest and not repeating. Only the label column is optional.

An example file follows:
 
06/01/12	-1.63   Spring Rains
06/04/12	-1.87
06/07/12	-2.17
06/10/12	-1.87
06/13/12	-1.9
06/16/12	-2.2
06/19/12	-1.9
06/22/12	-1.96   Summer
06/25/12	-1.81
06/28/12	-1.84
07/01/12	-1.69
07/04/12	-1.39
07/07/12	-1.33
07/10/12	-1.12
07/13/12	-0.85
07/16/12	-1.03
07/19/12	-1.06
07/22/12	-0.76
07/25/12	-0.61	Flood Event
07/28/12	-0.31
07/31/12	-0.31
08/03/12	-0.52
08/06/12	-0.37
08/09/12	-0.61
08/12/12	-0.85
08/15/12	-0.79
08/18/12	-0.76
08/21/12	-0.58
08/24/12	-0.64
08/27/12	-0.49
08/30/12	-0.46
09/02/12	-0.67
09/05/12	-0.91
09/08/12	-0.82
09/11/12	-1.09	""
09/14/12	-1.27
09/17/12	-1.3
09/20/12	-1.33
09/23/12	-1.51   Fall
09/26/12	-1.42
09/29/12	-1.69
10/02/12	-1.69
10/05/12	-1.78
10/08/12	-1.84
10/11/12	-1.96
10/14/12	-2.17
10/17/12	-2.29
10/20/12	-2.26
10/23/12	-2.05
10/26/12	-2.05
10/29/12	-1.84
11/01/12	-2.05
11/04/12	-2.23
11/07/12	-2.08
11/10/12	-2.2
11/13/12	-2.41
11/16/12	-2.62
11/19/12	-2.83
11/22/12	-2.62
11/25/12	-2.5
11/28/12	-2.29
12/01/12	-2.11
12/04/12	-2.2
12/07/12	-1.9
12/10/12	-2.08
12/13/12	-1.93
12/16/12	-1.81
12/19/12	-1.75
12/22/12	-1.63   Winter
12/25/12	-1.36
12/28/12	-1.45
12/31/12	-1.24
01/03/13	-1.21
01/06/13	-1
01/09/13	-1.27
01/12/13	-1.21
01/15/13	-1.18
01/18/13	-1.15
01/21/13	-1.12
01/24/13	-1.33
01/27/13	-1.39
01/30/13	-1.24
02/02/13	-1.3
02/05/13	-1.57
02/08/13	-1.66
02/11/13	-1.81
02/14/13	-1.69
02/17/13	-1.78
02/20/13	-1.78
02/23/13	-1.84
02/26/13	-1.72
03/01/13	-2.02
03/04/13	-2.23
03/07/13	-2.08
03/10/13	-2.02
03/13/13	-2.32
03/16/13	-2.11
03/19/13	-2.41
03/22/13	-2.65   Spring
03/25/13	-2.38
03/28/13	-2.47
03/31/13	-2.47
04/03/13	-2.32
04/06/13	-2.17
04/09/13	-2.14
04/12/13	-2.41
04/15/13	-2.65
04/18/13	-2.47
04/21/13	-2.35
04/24/13	-2.32
04/27/13	-2.38
04/30/13	-2.08
05/03/13	-1.93
05/06/13	-1.84
05/09/13	-1.57
05/12/13	-1.84
05/15/13	-1.57
05/18/13	-1.57
05/21/13	-1.69
05/24/13	-1.93
05/27/13	-1.78
05/30/13	-1.57
06/02/13	-1.84

time horizon

The time horizon module allows you to extract a surface from a set of time-based surfaces. The time for the extracted surface can be any time between the start and end of the surface set. It will interpolate between adjacent known times.

time_loop

General Module Function

The time_loop module is one of a limited set of Time_Data modules. These modules are specifically designed to create models and animations of data that changes over time. This type of data can result from water table elevation and/or chemical measurements taken at discrete times or output from Groundwater simulations or other 3D time-domain simulations.

The time_loop module allows you to loop through a series of times or specify a time for interpolation from a time field.