Copyright © 1988-2025 Tecplot, Inc. All rights reserved worldwide. See the complete legal notice in the copyright section of this document.
- Data Files
- Overview on Reading Data in FieldView
- GRID PROCESSING
- Function Selection
- Transient Data
- PLOT3D & OVERFLOW-2 Auto-Detect Format
- Read Boundary Data Only
- Reading more than one Dataset at a time
- Dataset Comparison for Multiple Datasets
- Merged Transient Datasets
- Appending Datasets to the same Server Process
- Data Written On Different Systems
- Support for Arbitrary Elements
- FieldView Parallel Datasets
- Direct Readers in FieldView
- Working with the Data Input Menu
- Reading Data Interactively with FieldView Parallel
- AcuSolve Direct Reader
- CGNS
- CGNS Unstructured/Hybrid Reader
- FIDAP
- FLOW-3D® Animation Data
- FLOW-3D® Restart Data
- FLOW-3D®
- ANSYS-Fluent CFF [Direct Reader]
- FLUENT cas/dat Direct Reader
- FLUENT Direct Reader
- FLUENT Universal
- FLUENT/UNS (and RAMPANT)
- FV-UNS Data Input (Native FieldView Unstructured Format)
- Ensight Reader
- Tecplot 360 Reader
- HAVOC
- LS-DYNA d3plot Direct Reader
- LS-DYNA
- NPARC/WIND
- OpenFOAM
- OVERFLOW-2
- PLOT3D
- SC/Tetra
- scFLOW
- SCRYU
- scSTREAM
- Surface Sampled Data
- STL
- UH3D
- ultraFluidX
- VTK
- WIND US
- XDB Import
- Partitioned File Parallel Reader (PFPR)
- Exports to FieldView Formats
- Exports to FieldView Parallel Compatible Formats
- Standalone Translators to FieldView Formats
- User Defined Plugin Readers for FieldView
- User Defined Plugin Readers for FieldView Parallel
- Overview on Reading Data in FieldView
- Functions
- Function Specification Panel
- Face Data and the Function Specification Panel
- Face Data and the Function Selection Panel
- Using the Functions Panel
- Face Data and the Function Formula Specification Panel
- Using the Function Formula Specification Panel
- Frequently Asked Questions
- Possible Issues
- Differences between Datasets
- Out of Range Handling
- Function Specification Panel
- Region Files
- FieldView Extension Language (FVX)
- Introduction
- FVX Syntax
- General Function Library
- CFD Open Post-Processing Functions
- CFD Data I/O
- Creation and Modification of Post-Processing Objects
- FVX Show Min Max Annotation
- FVX Legends
- FVX Support to Return Object Handles
- Geometric Color and Scalar Colormap Specification
- Vector Options
- Annotation
- Quantify and Query
- Surface to Surface Sampling for Dataset Comparison
- Transient Data Handling
- Graphing
- GUI Functions
- Other Functions
- Dynamic Clipping
- FVX View Controls
- FVX Debugger
- Access to FVX Programs from the Tools Menu
- Python-Enabled FVX
- FVX Learning Tools
- Restart Files and Script Language
- Restart Files Menu
- Using the Restarts File Selector
- Complete Restart
- Complete Restart, No Data Read
- Current Dataset Restart
- Multi-Window Layout…
- Layout Restart Files
- Preference Restart
- Script Restart
- Formula Restart
- Data File Input
- Computational Surface
- Iso-Surface
- Streamlines
- Streamline Template
- Particle Paths
- Annotation
- View (World)
- Colormap Specification
- Surface Plot
- Boundary Surface
- Vortex Cores / Surface Flows
- Coordinate Surface
- 2D Plots Restart
- Point Probe Input
- Presentation Render
- Clip Groups
- FieldView Script Language Commands
- Sample Scripts
- Animation
- Saving Images
- Advanced Numerical Functions
- Building FieldView Plugins
- Built-In Functions
- PLOT3D Formats
- Function File Name Format
- Unstructured Grid Format
- Introductory note
- Supported Element Types
- Standard 3D element types
- Arbitrary Polyhedron Cells
- Arbitrary Polygon Boundary Faces
- FieldView Compliance for Unstructured Data
- Binary Format
- Unformatted (FORTRAN 77) Format
- ASCII Format
- Unstructured Data Input panel
- Creating FV-UNS files with FORTRAN 77 and C for different OS
- 2D FV-UNS FILES
- Colormap File Format
- FieldView Limits
- 2D Plot Format
- Structured Boundary Files
- Plain Text Export Format
- MAT-File Export
- CSV Export
- Particle Path Formats
- FieldView Math Fonts
- NPARC/WIND Constants and Formulas
- Copyright
Data Files
Datasets can be read into FieldView in the following ways:
-
Using a built-in reader.
-
Exporting from a solver program to a FieldView compatible format such as PLOT3D or the FieldView Unstructured File Format, and then using one of the built-in FieldView readers.
-
Using a stand-alone translator, supplied by Tecplot Inc. or another commercial solver company, to convert data files to a FieldView compatible format.
-
Using a User Defined FieldView Plugin Reader.
|
Information on commercial solvers, known problems and changes or updates to Plugin Toolkit Readers will be kept up to date on the Customer Support Section of the Tecplot Inc. web page. See FieldView Solver Interfaces for the latest information on all changes and up to date information on reading data into FieldView. |
Solver |
Company |
Method |
Altair |
Export to FV-UNS |
|
Altair |
Direct Plugin Toolkit Reader |
|
Government Version of COBALT60 |
Standalone Translator |
|
Reaction Engineering |
Export to PLOT3D |
|
Metacomp Technology |
Standalone Translator to FV-UNS |
|
ESI Group |
Export to PLOT3D |
|
ANSYS |
Export to FV-UNS |
|
Direct Plugin Toolkit Reader |
||
COBALT CFD |
Export to FV-UNS |
|
Air Force Research Lab |
Standalone Translator to FV-UNS |
|
Convergent Science, Inc. |
Export to FV-UNS |
|
ANSYS |
Export to FV-UNS |
|
ANSYS |
Export to FV-UNS |
|
ANSYS |
Direct Reader |
|
Numeca |
Export to PLOT3D |
|
AVL |
Standalone Translator to FV-UNS |
|
Flow Science |
Direct Plugin Toolkit Reader |
|
Flow Science |
Direct Plugin Toolkit Reader |
|
Flow Science |
Legacy Direct Reader |
|
ANSYS-Fluent CFF [Direct Reader] (current version) |
ANSYS |
Direct Plugin Toolkit Reader |
FLUENT cas/dat Direct Reader (current version) |
ANSYS |
Direct Plugin Toolkit Reader |
FLUENT (current version) |
ANSYS |
Export to FV-UNS |
FLUENT Universal (version 4.2 and below) |
ANSYS |
Universal Files |
ANSYS |
FieldView Case and Data files |
|
FrontFLOW |
Export to FV-UNS |
|
NASA |
Export to FV-UNS, VTK, CGNS or Tecplot Binary format |
|
Aerosoft |
Export to PLOT3D |
|
Reaction Engineering |
Standalone Translator to PLOT3D |
|
Corvid Technologies |
Direct Reader |
|
LSTC |
Direct Plugin Toolkit Reader |
|
NPARC Alliance |
Direct Reader |
|
ESI |
Direct Reader |
|
NASA |
Direct Reader |
|
NASA |
Direct Reader |
|
ANSYS |
Export to FV-UNS |
|
EXA |
Export to FV-UNS |
|
Pratt |
Pratt Whitney |
Direct Reader |
RavenCFD |
Corvid Technologies |
Export to FV-UNS |
Software Cradle Co., Ltd. |
Direct Reader |
|
Software Cradle Co., Ltd. |
Direct Reader |
|
Software Cradle Co., Ltd. |
Direct Reader |
|
Software Cradle Co., Ltd. |
Direct Reader |
|
CD-adapco |
Export to FV-UNS |
|
Stereolithographic CAD |
Direct Reader |
|
Tetra Research |
Export to FV-UNS |
|
ThermoAnalytics |
Export to FV-UNS |
|
Mindware |
Direct Reader |
|
Altair |
Direct Reader |
|
NASA |
Export to FV-UNS |
|
Kitware |
Direct Reader |
|
NPARC Alliance |
Direct Reader |
|
Tecplot Inc. |
Export from FV |
Overview on Reading Data in FieldView
GRID PROCESSING
The GRID PROCESSING section on the Data Input panels allows users to interactively balance performance versus read time and memory. Settings can be easily changed, depending on usage, to maximize productivity.
When FieldView reads data, it performs grid processing after reading the grid. Grid processing increases FieldView's speed in such operations as creating and sweeping Coordinate Surfaces, computing accurate streamlines, and Dataset Sampling. The costs of grid processing are read time and memory. Previous versions of FieldView required setting environment variables to balance performance versus read time and memory. For a full list of operations benefiting from this initial grid processing, please refer to list of operations which will have performance impacted by grid processing in the FieldView User’s Guide.
|
Grid Processing setting guidelines:
|
GRID PROCESSING is shown on the PLOT3D and OVERFLOW-2 panels in Figure 2 and the FV-UNS panel in Figure 3. The slider defaults to a "Balanced" position between faster data input using less memory and faster performance using more memory. If you wish to post-process your data using many Coordinate Surfaces or streamlines, or if you’re going to use Dataset Sampling for comparing results, setting the slider to "More" will improve FieldView's performance. If performance of these features is less critical, setting the slider to "Less" will minimize read time and memory.
This Grid Processing setting is saved in, and read from, the Data Input restart file or FVX.
Exceptions
The presence of the following environment variables will disable Grid Processing controls on the Data Input Panel, and override the "grid_processing" settings in Data Input (.dat) restarts and FVX scripts for the entire FieldView session: FV_PROBE_PERFORMANCE FV_PROBE_SAVE_MEM
These environment variables (maintained for backward compatibility) offer another way of setting the Grid Processing level, but for the entire FieldView session. For more on these environment variables, please refer to the Balance Between Memory Usage and Performance section of the FieldView User’s Guide.
When any one of these environment variables is set, the Data Input Grid Processing GUI will display a field explaining why it is disabled. For example, this message will also be printed to the console: "Grid Processing controls disabled because FV_PROBE_PERFORMANCE is set".
If FV_PROBE_SAVE_MEM is set, Grid Processing is set to Less, as the goal of this environment variable is to use as little memory as possible during the read phase.
If FV_PROBE_PERFORMANCE is set, Grid Processing is set to Balanced on the FieldView interface, but this setting is actually ignored, with precedence given to FV_PROBE_PERFORMANCE.
There are certain conditions detected during the read such that Grid Processing will be ignored:
| A Grid DataGuideTM file (.fvpre) was found and used. |
In this case, the grid setting used is the same as the one used at the time of the generation of the DataGuideTM file. The message printed to the console is: The Grid Processing setting was ignored because a DataGuide file was found and used. |
| The dataset being read is Cartesian. |
In this case, grid processing is not needed. The message printed to the console is: The dataset is Cartesian. Grid Processing is not needed for Cartesian. |
| The grid file is a duplicate of a file read earlier. |
In this case, the grid setting used is the same as the one used before. The message printed to the console is: The grid file is a duplicate of an earlier grid file. The Grid Processing setting was inherited from the earlier grid file. |
Function Selection
Reading results data in Replace or Append mode using most readers will automatically bring up the Function Subset Selection panel containing a list of the variable names from the results file.
All Function Names will be initially selected (highlighted). Clicking on a selected Function Name will deselect (unhighlight) it and vice versa.
Vector Function Selection
Vector functions are indicated on the Function Subset Selection panel by a triplet of scalar variable names, the first of which has a ";", followed by the vector name ("Velocity" in the panel shown in Figure 1). Selecting any of the three consecutive variables that define a vector function will automatically select the other two variables. Similarly, deselecting a variable that belongs to a vector function will deselect all three lines that belong to the vector function. In the example panel shown in Figure 1, deselecting "Velocity_1" will also deselect "Velocity_0", "Velocity" and "Velocity_2", since they form a vector triplet.
Transient Data
For a transient dataset given as a series of files, FieldView will prompt you to read the whole series of files and treat them as a transient dataset.
A dataset will automatically be recognized as transient as long as a particular file naming convention is used. The file naming convention embeds the integer time step number (but not the solution time) in the filename. This is represented as ##### below. Note that you should use as many digits as required to represent your time steps. There is no requirement that five be used. FieldView looks for the embedded time step value (#####) to the left of the first 'dot' ( . ), if there is one in the file name, otherwise it will search from the right. The required format can be one of either: prefix#####.extension prefix.#####
Example: pipe04020.extension, pipe04021.extension, …, pipe04073.extension
The actual extension used is not important.
| Note: Only single byte numbers in filenames will be recognized as time steps in a transient series. |
For the readers that produce a single file containing transient data (AcuSolve, OpenFOAM, FLOW-3D® and FIDAP), FieldView will present you with the Time Step Selection panel (see Figure 1) when the data is read. This will show you the time steps found in the file(s) and allow you to choose which one you wish to initially read into memory. By default, FieldView selects the last time step to read in. You will have to explicitly choose a different time step if that is desired.
When turned on, the 'Read as Steady State' toggle button allows the selection of a specific time step of a multiple time step per file dataset.
This capability is particularly of interest for quickly animating particles computed for a transient dataset but with a fixed geometry over time. This can be done by:
-
Reading the dataset with the "Read as Steady State" option ON.
-
Importing a STREAKLINE (not PARTICLE SET) format Particle Path file, with the Import button from the Particle Paths panel.
-
Setting the Display Type to one that is compatible with animations, such as Growing, Spheres, Dots or Polyspheres.
-
Using the Animate button on the Particle Paths panel.
Since only particles will be updated, it will be many times faster than a full transient animation, in which the volume data would be read and updated at each step.
The transient panel will be disabled and transient restrictions on particle path display options will be lifted. The Particle Path Animate button will also be enabled in this mode.
Note that in order for time step or solution time information to be available in a FieldView session (for example, to be included in an annotation using the escape sequence %%T or %%N), the dataset needs to be read as transient with the 'Read as Steady State' option turned off.
For all transient data, any time step can be accessed through the Transient Data Controls panel (see Transient Data Controls section of Working with FieldView for more information).
Changing of time step for a transient dataset will not cause all grid and results files to be re-read. Only the file or files containing the results of the current dataset will be re-read when the time step number is changed. The transient sweep reading of grid and results files (PLOT3D, FV-UNS-split) is optimized so that only the files that need to be changed for the new time step will be read. An invariant grid for the current dataset and all files for other datasets will remain in memory.
PLOT3D & OVERFLOW-2 Auto-Detect Format
PLOT3D and OVERFLOW-2 data files can be saved using different file formats and attributes. A previous limitation of the FieldView data input panels for both types of data was that the file formats and attributes needed to be explicitly and correctly set before the file could be read. By default, FieldView will attempt to automatically detect the values for the FILE FORMAT, COORDS and DATA FORMAT. You still have the option to disable this default behavior by turning the Auto-Detect Format option OFF - in this case, explicit setting of the file format and attributes will be required.
If FieldView is unable to correctly detect the file format, the Auto-Detect Format button will be turned off, and the following pop-up message will appear:
Note that if Auto-Detect Format switch has been turned OFF, it will remain OFF unless you turn it back ON - it does not get reset back to the original default during the session.
Auto-Detect can only be used interactively or with FVX Data Input. The syntax for the FVX read_dataset command is:
auto_detect = 'on' or auto_detect = 'off'
Auto-Detect is NOT read or written to the data file restart.
Auto-Detect is enabled whether using Direct or Server, and supports non-parallel servers, parallel servers, and partitioned-file parallel (PFPR).
Read Boundary Data Only
Often it is useful to review only the boundary surfaces for a dataset. By limiting the dataset read operation to read in just the boundary data, a significant reduction in the time required to read can be realized. Reading of boundary data only is available for all unstructured data readers, including user-defined (toolkit plugin) unstructured data readers.
If an unstructured data reader always has boundary data without any volume data, such as XDB Import, or STL [Direct Reader], then Read Boundary Data Only is always enabled and the check button is grayed out.
The time savings associated with Read Boundary Data Only will depend on the ratio of boundary to volume data, and will typically be in the range of 15x to 20x faster than reading the entire volume data for a given dataset.
Read Boundary Data Only is enabled by turning on the check button in the Data Input panel (see Figure 3). This setting is off by default. Read Boundary Data Only is fully compatible with FieldView Parallel. Partitioned File Parallel formats are also fully supported. This feature will also work correctly to examine extruded 2D boundary data, created using the FV_2D_TO_3D environment variable.
Recognize that all surface and rake types which rely on volume data cannot be created following a read boundary only data option.
Complete support has been provided for RESTARTS. However, it is important to keep in mind that it will not be possible to create any rakes or surfaces which need volume data. So, consider the case where a Complete RESTART has been saved for a full volume data read. If we attempt to apply this RESTART (ALL, NO_DATA_READ) following a Boundary Data only read, any surfaces based on volume data will not be present.
Regarding transient streaklines however, It is possible however to do the following:
-
Read the volume data and compute streaklines from a transient sweep. This can be automated to run in batch.
-
Read the Boundary Data only, read in the saved streakline data (particle path) and create an animation from a transient sweep.
In the above scenario, the time savings by not having to read in the volume data at each time will be considerable. In general, the time required to read Boundary Data only is dramatically reduced relative to the time needed to read the volume data for the same case.
This feature is currently limited to work with unstructured datasets only. Writing DataGuideTM files is disabled when the read boundary only switch is on.
Reading more than one Dataset at a time
You can read multiple datasets into FieldView. This is done with the Append button that appears on all of the data input panels. This will allow you to read in, display and visualize several datasets at the same time.
|
The restarts from the current dataset can be applied to the second dataset. Implementing this feature can save you a considerable amount of time. For more information see Current Dataset Restart section of the Reference Manual or the Heat Exchanger Tutorial section of the User’s Guide. |
The datasets that you read into memory do not have to be of the same type or format or have the same number of variables. One can be a structured dataset and another can be an unstructured dataset. However, a Results file Append will always try to read results for the highest-numbered dataset. If it succeeds, the current dataset will be changed to the highest-numbered dataset. A Results file Replace will (as in previous versions of FieldView) always try to read results for the first dataset. If it succeeds, the current dataset will be set to 1. Therefore, reading grid files and results files in the following order: Grid1, Grid2, Result1, Result2 will not yield the desired result in FieldView memory. The order Grid1, Result1, Grid2, Result2 will need to be used.
Switching between datasets can be accomplished on the Dataset Controls panel or the Main Toolbar (see the Tools section of Working with FieldView for more information). You can also switch between datasets by "quick-picking" Double-Click on any surface, rake, legend, etc. that belongs to that dataset.
Each dataset loaded into memory will have a separate set of functions (results) which will be shown when the Functions button is pressed. Variables of one dataset cannot be used in formulas for a different dataset (with the exception of Dataset Comparison mode).
For PLOT3D and split FieldView Unstructured files the grid will be automatically re-used when appending results that are based on the same grid file. We expect users to save significant disk space, and to see a substantial improvement in the handling of datasets where the grid is invariant with time, or across several datasets.
All surfaces and rakes created will belong to a specific dataset. If you have two datasets in memory and each dataset has a computational surface created in it, then both computational surfaces will be surface number 1, specific to the given dataset. A surface cannot be switched to a different dataset. Control of the current dataset is through the Dataset Controls panel or the Main Toolbar.
Dataset Comparison for Multiple Datasets
FieldView will let you make numerical comparisons between datasets. If the datasets are based on the same underlying grid, Dataset Comparison is directly possible and formulas spanning datasets can be created using the Function Specification Panel (see Function Specification Panel). If the underlying meshes differ, or if the datasets are based on different file formats, then the Dataset Sampling Tool can be used to create a sampled dataset which can then be used for numerical comparisons (see Dataset Sampling). Note that both Dataset Comparison and Dataset Sampling requires that when your input data is not read serially with the FieldView Client and remote or local servers are used, the Append Server button option must be checked ON. This is the default. Note also that Dataset Sampling is not supported on parallel servers.
Merged Transient Datasets
If more than one transient dataset is read into FieldView, it is possible to animate all time steps using merged solution times for all datasets during the transient sweep. This feature simplifies the task of creating an animation of multiple transient cases (see Use Merged Times).
Appending Datasets to the same Server Process
This feature permits you to use the same SERVER process to read more than one dataset. To turn this feature on, first read a dataset into FieldView using the Client-Server feature. Then, to read another dataset to that same SERVER process, in the File menu Data Input pulldown, turn the Server Append button ON. With a minimum of two datasets read into FieldView in this way, the Dataset Sampling and Dataset Comparison features will be fully enabled, except that Dataset Sampling is not supported when using Parallel Servers. These features will be discussed in more detail in sections describing the Client-Server operation of FieldView.
Data Written On Different Systems
It is known that files created on LINUX or Windows systems have different byte ordering compared to their UNIX counterparts. It is also often the case that datasets are created on one system, and post-processed on another. The FieldView Unstructured (FV-UNS) and PLOT3D readers permit reading of non-native byte ordered FV-UNS (all types) and PLOT3D (all types) files.
Support for Arbitrary Elements
Arbitrary elements are now widely used by commercial CFD solvers. A common discretization strategy is to mesh the internal volume with regular hexahedral cells, the near-surface volume with extruded cell layers, and generate arbitrary polyhedra to fill the gap in between the two. By default, FieldView employs interpolation and gradient calculations natively for arbitrary polyhedra, consistent with other commercial solvers such as STAR, STAR-CCM+ and FLUENT. Tetrahedralization on-the-fly is only used in the following two cases:
-
The cell has a cell-center node
-
The cell has face-centered nodes
The importance of native handling for arbitrary polyhedra is highlighted in the illustration below:
Holes in the tetrahedralized mesh (on the left) are clearly seen.
Special handling is implemented in FieldView to calculate derivatives (gradient, divergence and curl) for the case of split planar faces. These types of faces are commonly encountered in hexcore style meshes, where mesh resolution within the core regions change from coarser to finer cells.
Several key features are supported for datasets containing arbitrary elements:
|
Considerations when working with datasets containing Arbitrary Polyhedra
An individual element must have less than 256 vertices on a single face. And there can be no more than 256 faces for a single element. Typically arbitrary elements will have 10 to 20 faces, with each face having up to 10 edges. These values lie well below the limits specified.
The vortex core detection schemes and shock surface feature detection are currently not supported for arbitrary elements.
If holes are seen in surfaces, it is because there is face mismatching between adjacent cells which are intersected by the cutting planes of interest.