read multi tcf

read multi tcf

The read multi 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 multi tcf module creates a field using one or more Time Control Files (.TCF). It creates a mesh grid with the interpolated data from a user-specified number of TCF files. It outputs the first data component from each of the initial TCF files and all of the time-interpolated data components from the last TCF file.

For example, if you were trying to create a time animation of the union of 3 analytes (e.g. Benzene, Toluene and Xylene), read multi tcf allows you to select all three separate TCF files. Only the first data component from each of the first two TCF files is output as a new data component, and all of the data components from the third TCF file are then output (typically concentration, confidence, uncertainty, 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.

The module effectively includes internal interpolation between appropriate pairs of the files and data components specified in the TCF files. 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.

Ports

DirectionNameTypeDescription
InputInput DateDateDate used for interpolating between dates in a time control file format.
OutputStart DateDateStart Date used for interpolating between dates in a time control file format.
OutputEnd DateDateEnd Date used for interpolating between dates in a time control file format.
OutputOutput DateDateDate used for interpolating between dates in a time control file format.
OutputOutput FieldFieldThe main output field with interpolated data.
OutputGeology LegendGeology LegendGeology legend output.

Properties

PropertyTypeDescription
Time Control File ListFile listThe Time Control File List will read any number of TCF files and allow processing for those files.
Date And TimeDateThe Date and Time of interest.
Time LoopLoopThe Time Loop controls setting the Date and Time by specified increments.
Step Time UnitsChoice: Seconds, Minutes, Hours, Days, Weeks, YearsThe Step Time Units specify the increment for advancement when stepping or running.
Step SizeDoubleThe Step Size value specifies a factor, along with the Step Time Units, for the increment for advancement when stepping or running.

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