Runtime Result Output

This output can be used to monitor the optimization process. The type of output and the output interval is defined in the parameter file using the <OUTPUT> command.

Typically the following steps are carried out to define runtime result output with the <OUTPUT> command:

Choose the file format and a filename (base name) for the output file.
Choose an output interval, that is, determine in which iteration(s) of the optimization the output is to be written.
Choose the data that is used as basis for the result cell set determination.
Choose the cutoff parameter for result cell set determination.

File Format and File Name

The file format for the output file can be specified using the <FORMAT> command item in the <OUTPUT> command. The following file formats are available:


Format	Description	Application
WRL	Virtual reality modeling language (VRML)	VRML Viewer, for example, ParaView

Example

<FORMAT>WRL</FORMAT>

In addition to the file format, a base file name can be specified using the <FILENAME> command item in the <OUTPUT> command:

<FILENAME>opt_result</FILENAME>

The base file name is used as the first portion of the file name. After the base name, output-specific extensions are added automatically by SIMULIA Tosca Fluid.

Output Interval

An output interval must be defined to determine when and how often the requested output is to be written. The output interval is defined using the <ITERATION> command item in the <OUTPUT> command and expressed in terms of output iterations. One or more output iterations can be specified.

Example 1: Single output in iteration 1000:

<ITERATION>1000</ITERATION>

Example 2: Output in three distinct iterations:

<ITERATION>500,750,1000</ITERATION>

Example 3: Multiple outputs every 100th iteration, staring in iteration 100 and ending in iteration 1000:

<ITERATION>100-1000:100</ITERATION>

Note: Keep the optimization start iteration (<OPT_START> in <OPT_PARAM>) in mind. Before the optimization start iteration is reached, no optimization data can be stored our used to generate runtime result output.

Define Data for Result Determination

SIMULIA Tosca Fluid results can be determined based on different result data. The possible result extraction methods are explained in detail in the Methods Manual. The available data types for result determination are listed in the table below:


PTRACK	Particle track data
VELOCITY	Cell velocity data
MATERIAL	Cell sedimentation magnitude data

To select a specific data type, the <RESULT> command item is used in the <OUTPUT> command. For example to use cell velocity data the following command item is required:

<RESULT>VELOCITY</RESULT>

For the PTACK and the MATERIAL extraction method default cutoff values can be used. The cutoff value is mandatory in the case of the VELOCITY based extraction.

Note: If the <RESULT> command item is omitted, the default result MATERIAL is used.

Define a Cutoff Parameter

The cutoff parameter is defined using the <CUTOFF> command item in the <OUTPUT> command (consult the Methods Manual for an explanation of the methods). A single cutoff value can be specified or a set of cutoff values by means of a general list.

Note: The behavior of the <OUTPUT> command in case of multiple cutoff values depends on the selected file format.

Example 1: Single cutoff value

<CUTOFF>0.1</CUTOFF>

Example 2: Multiple cutoff values, starting from 0.2 and ending at 0.6 using an increment of 0.1

<CUTOFF>0.2-0.6:0.1</CUTOFF>

Note: The MATERIAL and the PTRACK extraction method do not need a cutoff value.

Complete Output Example

A complete example of an output definition is given below. Cell set output in VRML format is to be written in every 100th iteration using velocity results and a range of cutoff values (namely 0.2, 0.25, 0.3, 0.35, 0.4):

<OUTPUT>
  <ID_NAME>my_cell_output</ID_NAME>
  <FORMAT>WRL</FORMAT>
  <FILENAME>opt_result</FILENAME>
  <ITERATION>100-1000:100</ITERATION>
  <RESULT>VELOCITY</RESULT>
  <CUTOFF>0.2-0.4:0.05</CUTOFF>
</OUTPUT>

In this example, SIMULIA Tosca Fluid generates five output files in every 100th iteration using the VRML format and the following file name:

opt_result_<iteration>_<result>_<cutoff_value>.wrl

Here, the tags are replaced by the respective information:

Example:

opt_result_01000_vel_0.200.wrl

Note: The <OUTPUT> command must not be referenced in the <OPTIMIZE> command.