Command Line Options for Output Files

You can choose how to save output files. The data from all ranks can be stored in separate files or in one combined file. Additionally, the data can be written in two formats: EnSight Gold (the default) or H3D. The data is the same regardless of the option chosen, so you can pick the options which best meet your needs, while keeping in mind that each option comes with different computational and time costs.

Note: When using H3D, it is required to use merged data.

The output formats are set via the solver deck parameters <merge_output_files> and <file_format>. See the Simulation Parameters section.

To merge existing output and/or to convert to H3D, the following command lines options can be used separately or combined:

Merge

ultraFluidX allows you to merge output files manually by running the --merge option in the command line. Using >> ultraFluidX --merge <input file or path> will merge EnSight Gold or H3D files. The unmerged files will be kept unless the command specifically indicates to delete them: >> ultraFluidX --merge --delete-unmerged <input file or path>.

Convert

ultraFluidX allows you to convert output files that were written in the default EnSight Gold format into H3D format by running the --convert option in the command line, using >> ultraFluidX --convert <input file or path>. Inputs can be an EnSight Gold *.sos file, an EnSight Gold *.case file, or a path to a folder containing any of the former.

Table 1.
Setup input deck for ultraFluidX	<file_format> = ensight	<file_format> = h3d
<merge_output_files> = false	Default option	Significantly reduces the number of files. This should be selected for GHN runs as a basis for further post-processing.
<merge_output_files> = true	Additional time required for merging	Producing these files during the ultraFluidX run may be challenging for large cases due to memory requirements. It is recommended to write unmerged H3D and merge them as a subsequent step.