HOWTO read from an interpolated TECPLOT file

COOLFluiD allows for starting a simulation from TECPLOT files. To this end, two TECPLOT files, both in unstructured point-based format, are normally required:

• .plt file having the mesh and solution for the full domain (for the moment, only one ZONE is supported)
• .surf.plt file having the mesh and solution corresponding to the boundary nodes, divided in multiple zones.

The following example illustrates the related user-defined settings.

The given mesh/solution will be converted and then read as CFmesh file: Simulator.SubSystem.MeshCreator = CFmeshFileReader

A file named "input.CFmesh" will be read: Simulator.SubSystem.CFmeshFileReader.Data.FileName = input.CFmesh

Herein, the file path is either local (i.e. inside the directory from which you are running or ./) or relative to the COOLFluiD base directory. For instance: ../../RESULTS/input.CFmesh would mean that ../../ corresponds to the COOLFluiD base directory.

A given "input.plt" will be converted to "input.CFmesh": Simulator.SubSystem.CFmeshFileReader.convertFrom = Tecplot2CFmesh

The following two options define the conversion to a Finite Volume CFmesh format: Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.Discontinuous = true Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.SolutionOrder = P0

The TECPLOT file is in point-based format: Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.HasBlockFormat = false

The names of the boundary zones defined in the .surf.plt file are specified: Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.SurfaceTRS = Wall Inlet Outlet

The names of the variables to be read in both the .plt and .surf.plt are specified (note that the coordinates "x0" "x1" "x2" must not appear explicitly here):
Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.ReadVariables = "p" "u" "v" "T"

The number of element types is given (but only 1 is supported for now): Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.NbElementTypes = 1

The following flag must be set to true if only the mesh (no solution) is read: Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.SkipSolution = false

If the SkipSolution = false (i.e. solution variables are read) the flag corresponding to a restart has to be activated for the corresponding solver. For instance, in the case of Finite Volume you have to set: Simulator.SubSystem.CellCenterFVM.Restart = true

In general, data inside .plt and .surf.plt must have the same exact precision, since nodes will be matched by position between the two files. The precision of the floating data to be read can be rounded up using the following option (default value is 8): Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.Precision = 9

SOLUTION INTERPOLATION

COOLFluiD allows for specifying a donor TECPLOT solution mesh/file from which the solution will be interpolated onto the target mesh (i.e. the mesh corresponding to the input.plt in our example above) by using the following option:

Simulator.SubSystem.CFmeshFileReader.Tecplot2CFmesh.InterpolateFrom = donor.plt

Also in this case, the file path is either local (./ can be prepended) or relative to the COOLFluiD base directory. The interpolation will be accomplished by self-generating and running a TECPLOT macro (interpolate.mcr) that will also create a .allsurf.plt file, which includes all the boundary nodes in one single zone. This is needed to ease the node matching between boundaries and full domain within the implemented conversion from TECPLOT to CFmesh format.

An example of usage of interpolation and TECPLOT-to-CFmesh conversion is given in this CFcase example for a 3D magnetospheric simulation.