initializationFile Statement

Purpose

Specifies a file that contains initial values for an input or output file.

Applicability

The initializationFile statement can be used inside of a RowFieldInputFile, RawInputFile, RowFieldOutputFile, and RawOutputFile.

Additional Information

The initializationFile is usually not explicitly specified. For input files, the initializationFile defaults to the templateFile. For output files, the initializationFile defaults to the fileToParse file.
The default option with the variable and array statements will override values contained in the initializationFile.

Syntax

initializationFile: <fileName>

Arguments

NameDescription

fileName

The name of the file that contains initialization values. If the full path for the file is not specified, the file is assumed to be located in the same directory as the .fileWrapper file.

Example

To manipulate three input and two output variables, the following sections of the FileWrapper file have been created. The user wishes to initialize the variables. Also, the default of value height is explicitly set to 0.45. Using the default option to overwrite initialization file data is useful when several wrappers use the initialization file.

RowFieldInputFile inFile 
{ 
   templateFile: xyz.template 
   initializationFile: xyz.inputs.initial 
   fileToGenerate: xyz.in 
   #          name    type    row  field 
   variable:  volume  double  1    2 
   variable:  length  double  1    3 
   variable:  height  double  2    3  default=0.45 
} 
 
RowFieldOutputFile outFile 
{ 
   initializationFile: xyz.outputs.initial 
   fileToParse: xyz.out 
   #          name         type    row  field 
   variable:  totalHeight  double  5    7 
   variable:  totalWeight  double  2    4 
}

Any file can be used for the initialization file. For this example, the values in the initialization file, xyz.inputs.initial, will be used to determine the values of both volume and length. The value of height defaults to 0.45 instead of the value in the initialization file. The xyz.outputs.initial file provides initial values for the output properties.