4 - 14 Fluent Common Fluid Files Loader
The "Fluent Common Fluid Files Loader" is a loader based on ANSYS's latest, HDF5 file format for its Fluent solver. Loader instructions, following Tecplot's Standard Syntax, are given to Tecplot's $!ReadDataset command to control how the case and data files are loaded.
Windows: Full support
Linux: The loader operates on most modern Linux operating systems, however, it is based on a library from ANSYS that does not support CentOS 7 or similarly aged operating systems. The $!LoadAddOn "tecutildataio_fluentcff" command in the tecplot.add file of the installation directory specifies the IsOptional=True subcommand so that Tecplot will continue to load other add-ons on startup and not report failure to load the Fluent Common Fluid Files Loader on older Linux operating systems that do not support the ANSYS library.
Mac: The loader is based on a binary library from ANSYS that is not supported on the Mac.
4 - 14.2 Macro Commands for the Fluent Common Fluid Files loader
The syntax for loading Fluent Common Fluid Files with the Tecplot macro language is as follows:
Note that the StandardSyntax 1.0 name/value pair option must be the very first instruction. All other name/value(s) options can be specified in any order.
|
$!ReadDataSet ' "Standard Syntax" 1.0 ...any of the name value pairs in the following table... ' DataSetReader = "Fluent Common Fluid Files Loader" |
Each name/value pair should be in double quotes. Refer to the Scripting Guide for details on working with the Tecplot macro language.
|
Keyword |
Available Value(s) |
Default |
Notes |
|---|---|---|---|
|
STANDARDSYNTAX |
1.0 |
n/a |
Must be the first instruction. |
|
FileList_DataFiles |
n "file1" "file2"... "filen" |
n/a |
REQUIRED. The FileList_DataFiles command expects an integer count representing the number of files to follow. The count is followed by file paths to one or more case files, where each case file is followed by zero or more data files. Case files must have the extension .cas.h5 and data files must have the extension .dat.h5. |
|
SolutionTimeSource |
Auto SteadyState ConstantTimeInterval |
Auto |
Auto: Loader first looks for and uses solution time specified in the simulation settings of the Fluent Cff data files. If that information isn't present in all supplied data files, the loader looks for solution time embedded in the file names. If solution time cannot be determined, the loader assigns strands and a constant time interval, starting at zero and incrementing by one, if there is a single case file, or if there are case and data file combinations, otherwise the loader assigns static stand IDs and a solution time of zero to all zones. SteadyState: Loader assigns static strand IDs and a solution time of zero to all zones. ConstantTimeInterval: Loader assigns strands and a constant time interval, starting at zero and incrementing by one. |
|
IncludeInteriorFaceZones |
True, Yes, T, Y, False, No, F, N |
False |
[True | Yes | T | Y]: Interior face zones used to build the cell zones are also loaded as independent face zones, and added to the end of the other loaded face zones, such as walls, symmetry, etc. [False | No | F | N]: Interior face zones are not loaded as independent face zones, however, they are used to construct the cell zones. |
|
IncludeParticleZones |
True, Yes, T, Y, False, No, F, N |
True |
[True | Yes | T | Y]: If particle data exists in the .dat.h5 file(s) it is loaded and represented as additional I-ordered zones and nodal variables. [False | No | F | N]: Particle data is not loaded even if it exists in the .dat.h5 file(s). |
Example
$!ReadDataset command using the "Raw String" formatting, which allows the command to be spread over multiple lines and to contain quotation marks and other characters without escaping them. Raw strings begin with R"( and end with )" allowing the string within those delimiters to contain any character that doesn't match the closing delimiter:
|
$!ReadDataset R"( |
|
StandardSyntax 1.0 |
|
FileList_Datafiles 6 |
|
"/path/to/my/data/vessel-15.cas.h5" |
|
"/path/to/my/data/vessel-15.30001.dat.h5" |
|
"/path/to/my/data/vessel-15.30002.dat.h5" |
|
"/path/to/my/data/vessel-15.30003.dat.h5" |
|
"/path/to/my/data/vessel-15.30004.dat.h5" |
|
"/path/to/my/data/vessel-15.30005.dat.h5" |
|
SolutionTimeSource ConstantTimeInterval |
|
IncludeInteriorFaceZones True |
|
IncludeParticleZones False |
|
)" |
|
DatasetReader = "Fluent Common Fluid Files Loader" |