Wind-US Utilities - cfaverage

(Wind-US Documentation Home Page) (Wind-US User's Guide) (GMAN User's Guide) (MADCAP User's Guide) (CFPOST User's Guide) (Wind-US Utilities) (Common File User's Guide) (Wind-US Installation Guide) (Wind-US Developer's Reference) (Guidelines Documents)

(adf_revert) (cfaverage) (cfbeta) (cfcnvt) (cfcombine) (cflistnum) (cfpart) (cfreorder) (cfreset_iter) (cfspart) (cfsplit) (decompose) (fpro) (gpro) (jormak) (mpigetnzone) (recombine) (resplt.pl) (thplt) (tmptrn) (USintrpltQ) (windpar) ... (all utilities)

cfaverage

cfaverage may be used to average the values in two or more existing common flow (.cfl) files, and write the averaged values to a new .cfl file. The maximum number of files that can be averaged is 256, and the maximum number of zones in a file is 512. All the files must have the same reference conditions.

Input to cfaverage is specified in a keyword input file, with the three-letter extension .inp. Lines in the input file starting with a "/" are comments. The following keywords and parameters may be specified.

CHECK Checks the input file for errors without performing any operations.

AVERAGE FILE file1.cfl
AVERAGE FILE file2.cfl
... The input .cfl files to be averaged. The maximum number of files that can be averaged is 256.

OUTPUT fileave.cfl The name of the output .cfl file containing the averaged values (or summmed values, in ACCUMULATE mode).

AMODE {DEFAULT|ACCUMULATE|FINALIZE}

The averaging mode. The options are:

	`DEFAULT`		Values in the specified input files are averaged, and the results are written to the specified output file. This is the default averaging mode.
	`ACCUMULATE`		Values in the specified input files are summed, and the results are written to the specified output file, along with a running total of the number of input files represented in the summed values. This averaging mode may be used multiple times with the same output file to accumulate additional results. When results from all the desired input files have been accumulated, cfaverage is run one last time in `FINALIZE` mode to compute the averaged values.
	`FINALIZE`		Summed values in the specified output file, previously written using `ACCUMULATE` mode, are averaged over the total number of input files. The results are written back to the same file, overwriting the summed values. Note that once `FINALIZE` mode is used, the same output file can't be used for `ACCUMULATE` mode as the results will no longer be valid. Thus, to compute intermediate averages while using `ACCUMULATE` mode, copy the output file to a new intermediate file, and use `FINALIZE` mode with that intermediate file.

RMS Compute a root mean square average instead of a simple average.

AFILE filebase.cfl A "base" .cfl file for use with RMS averaging. Values in this file will be subtracted from those in each input file during the averaging process, like a standard deviation.

Example

The following input file for cfaverage, named cfave3.inp, will average the values in the files case1.cfl, case2.cfl, and case3.cfl, and write the averaged values into the new file caseave3.cfl.

   / Files to be averaged
   /
   AVERAGE FILE case1.cfl
   AVERAGE FILE case2.cfl
   AVERAGE FILE case3.cfl
   /
   / File containing averaged values
   /
   OUTPUT caseave.cfl

The terminal session is shown below. Lines in a slanted font are typed by the user.

   % cfaverage
   
                                ***** cfaverage *****
   
             Select the desired version from the following list.
   
   0) END
   1) cfaverage
   
   Single program automatically selected.
   
   Omit the .inp extension!
   Enter cfaverage INPUT FILE ............. (<CR>=cfaverage.inp) : cfave3
    cfaverage - Version 1.8 (last changed 2009/05/01 23:18:38)
    ****************************************************************************
    * Warning: This software contains technical data whose export is           *
    * restricted by the Arms Export Control Act (Title 22, U.S.C., Sec 2751,   *
    * et seq.) or Executive Order 12470. Violation of these export-control     *
    * laws is subject to severe criminal penalties. Dissemination of this      *
    * software is controlled under DoD Directive 5230.25 and AFI 61-204.       *
    ****************************************************************************
     INF: AVERAGING ZONE   1 FROM FILE case1.cfl
     INF: AVERAGING ZONE   1 FROM FILE case2.cfl
     INF: AVERAGING ZONE   1 FROM FILE case3.cfl
     INF: AVERAGING ZONE   2 FROM FILE case1.cfl
     INF: AVERAGING ZONE   2 FROM FILE case2.cfl
     INF: AVERAGING ZONE   2 FROM FILE case3.cfl
     INF: AVERAGING ZONE   3 FROM FILE case1.cfl
     INF: AVERAGING ZONE   3 FROM FILE case2.cfl
     INF: AVERAGING ZONE   3 FROM FILE case3.cfl

Last updated 22 May 2009