Chapter 5
FieldConvert

FieldConvert is a utility embedded in Nektar++ with the primary aim of allowing the user to convert the Nektar++ output binary files (.chk and .fld) into formats which can be read by common visualisation and post-processing software, primarily Paraview/VisIt (in unstructured VTK .vtu format) or Tecplot/VisIt (in ASCII .dat or binary .plt formats). FieldConvert also allows the user to manipulate the Nektar++ output binary files by using some additional modules which can be called with the option -m which stands for module. Note that another flag, -r (which stand for range) allows the user to specify a sub-range of the domain on which the conversion or manipulation of the Nektar++ output binary files will be performed.

Almost all of the FieldConvert functionalities can be run in parallel if Nektar++ is compiled using MPI (see the installation documentation for additional info on how to implement Nektar++ using MPI). 1

 5.1 Basic usage
  5.1.1 Input formats
 5.2 Convert .fld / .chk files into Paraview, VisIt or Tecplot format
 5.3 Convert field files between XML and HDF5 format
 5.4 Range option -r
 5.5 FieldConvert modules -m
  5.5.1 Smooth the data: C0Projection module
  5.5.2 Calculate Q-Criterion: QCriterion module
  5.5.3 Calculate λ2: L2Criterion module
  5.5.4 Add composite ID: addcompositeid module
  5.5.5 Add new field: fieldfromstring module
  5.5.6 Sum two .fld files: addFld module
  5.5.7 Combine two .fld files containing time averages: combineAvg module
  5.5.8 Concatenate two files: concatenate module
  5.5.9 Count the number of DOF: dof module
  5.5.10 Equi-spaced output of data: equispacedoutput module
  5.5.11 Extract a boundary region: extract module
  5.5.12 Compute the gradient of a field: gradient module
  5.5.13 Convert HalfMode expansion to SingleMode for further processing: halfmodetofourier module
  5.5.14 Extract a plane from 3DH1D expansion: homplane module
  5.5.15 Stretch a 3DH1D expansion: homstretch module
  5.5.16 Inner Product of a single or series of fields with respect to a single or series of fields: innerproduct module
  5.5.17 Interpolate one field to another: interpfield module
  5.5.18 Interpolate scattered point data to a field: interppointdatatofld module
  5.5.19 Interpolate a field to a series of points: interppoints module
  5.5.20 Interpolate a set of points to another: interpptstopts module
  5.5.21 Isocontour extraction: iscontour module
  5.5.22 Show high frequency energy of the Jacobian: jacobianenergy module
  5.5.23 Calculate mesh quality: qualitymetric module
  5.5.24 Evaluate the mean of variables on the domain: mean module
  5.5.25 Extract mean mode of 3DH1D expansion: meanmode module
  5.5.26 Project point data to a field: pointdatatofld module
  5.5.27 Print L2 and LInf norms: printfldnorms module
  5.5.28 Removes one or more fields from .fld files: removefield module
  5.5.29 Computes the scalar gradient: scalargrad module
  5.5.30 Scale a given .fld: scaleinputfld module
  5.5.31 Time-averaged shear stress metrics: shear module
  5.5.32 Stream function of a 2D incompressible flow: streamfunction module
  5.5.33 Boundary layer height calculation: surfdistance module
  5.5.34 Calculate vorticity: vorticity module
  5.5.35 Computing the wall shear stress: wss module
  5.5.36 Manipulating meshes with FieldConvert
 5.6 FieldConvert in parallel
 5.7 Processing large files in serial
  5.7.1 Using the part-only and part-only-overlapping options
  5.7.2 Using the nparts options
  5.7.3 Running in parallel with the nparts option