*Collate

<< Click to Display Table of Contents >>

Navigation:  Flexcom > Data Inputs > $SUMMARY COLLATE >

*Collate

Previous pageNext page

Purpose

To specify the summary postprocessing data to be collated and any exclusion criteria. This keyword is optional, and if you do not explicitly designate certain parameters for collation purposes, Flexcom will attempt to collate all available data.

Theory

Refer to Summary Postprocessing Collation for further information on this feature.

Keyword Format

One optional line followed by blocks of two lines repeated as necessary. The second line in each block is optional.

TITLE=Output Title [, UNITS=Unit]

[MIN=Minimum Value], [MAX=Maximum Value], [STDDEV=Standard Deviation]

The first data line, in the block, specifies the title of the result to be included in the collation and the second data line the exclusion criteria that apply for those results. All results sharing the same title are collated. Summary outputs with no title are excluded from the collation. The Unit entry is described in Note (c). If a Minimum is specified then results minima less than this value are not collated. If a Maximum is specified then results maxima greater than this value are not collated. If a Standard Deviation is specified then results whose standard deviation is greater than this value are not collated. If this keyword is not specified, Flexcom attempts to collate all available data from successful analyses.

The extension of the file containing the $SUMMARY COLLATE section and the extension of the analysis files to be collated must all have the same file extension i.e. a metric load case analysis (*.keyxm) can only be collated by $SUMMARY COLLATE contained in a *.keyxm file. Analysis with other keyword file extensions will be ignored and a warning issued.

Table Input

Input:

Description

Output Title:

A descriptive title associated with the parameter to be collated. See Note (a).

Unit:

The units to be used for the output. This entry is optional, and defaults to the base units for this output type. See Note (b).

Minimum Value:

A threshold level for minima. This entry is optional. See Note (c).

Maximum Value:

A threshold level for maxima. This entry is optional. See Note (c).

Standard Deviation:

A threshold level for standard deviation. This entry is optional. See Note (c).

Notes

(a)You have control over what parameters you wish to collate, based on the descriptive titles assigned to various outputs during the creation of the Summary Output File for each individual analysis. This entry is optional however, and if you do not specify any descriptive titles for collation purposes, Flexcom will attempt to collate all available data. Only parameters which share the same descriptive title are compared (any outputs with blank titles are ignored).

(b)The Units entry explicitly specifies what units are to be assigned to the output. This entry is optional, and if omitted, Flexcom simply assigns suitable units depending on the base units for the particular output type. If you do explicitly specify a unit, then it must be consistent with the dimension of the output type. For example, force can be specified in Newtons, Kips etc. The program is quite flexible in terms of accepting unit descriptions – e.g. Newtons, Newton, N etc. are all equally valid.

(c)You may also specify exclusion criteria to be applied, in terms of threshold levels for minima, maxima or standard deviation. If you choose to specify a threshold minimum, then any analysis where the parameter under consideration is less than the threshold is omitted. Likewise, if you opt to specify a threshold maximum or standard deviation, then any individual analysis results where the relevant parameter exceeds the threshold level is omitted. An output must pass all specified filters before it is included in the collated results. If specified, the units for the minima, maxima and standard deviation are taken from the Units entry. If no Unit is specified the unit is the base unit for that collation title.