4.2.9.1. InflowWind Driver

Example input files are included in Section 4.2.9.4.

Command-line syntax for InflowWind driver:

InlowWind_Driver <filename> [options]

      where:  <filename>     --   Name of driver input file to use
    options:  /ifw           --   treat <filename> as name of InflowWind input file (no driver input file)

    The following options will override values in the driver input file:
              /DT[#]         --   timestep
              /TStart[#]     --   start time
              /TSteps[#]     --   number of timesteps
              /xrange[#:#]   --   range of x (#'s are reals)
              /yrange[#:#]   --   range of y
              /zrange[#:#]   --   range in z (ground = 0.0)
              /Dx[#]         --   spacing in x
              /Dy[#]         --   spacing in y
              /Dz[#]         --   spacing in z
              /points[FILE]  --   calculates at x,y,z coordinates specified in a white space delimited FILE
              /v             --   verbose output
              /vv            --   very verbose output
              /hawc          --   convert wind file specified in InflowWind to HAWC format
              /bladed        --   convert wind file specified in InflowWind to Bladed format
              /vtk           --   convert wind file specified in InflowWind to VTK format
              /help          --   print this help menu and exit
Notes:
-   Unspecified ranges and resolutions default to what is in the file.
-   If no XRange is specified, assumed to be only at X=0
-   Options are not case sensitive.

The InflowWind Manual contains a description of file formats that it can read.

4.2.9.1.1. Specifying the InflowWind Input File

The InflowWind driver input file requires that an InflowWind input file be specified within it. See an example InflowWind input file in Section 4.2.9.4.

Within the InflowWind input file, if the wind file being specified is Bladed native format (WindType = 7), please also see Section 4.2.9.2.1.

4.2.9.1.2. Wind-file output formats

The InflowWind driver is capable of writing the wind data read from the input wind file into wind files of various formats.

4.2.9.1.2.1. HAWC2

This format generates the following files:

  • three binary files, one for each component: <RootName>-HAWC.u, <RootName>-HAWC.v, and <RootName>-HAWC.w

  • a text summary file in the style of HAWC2 input files: <RootName>-HAWC.sum

In the conversion script, the u component will have the (approximate) mean removed at each height. The mean value that was removed is displayed as comments in the text summary file. The turbulence is not scaled, so it will have the same scaling as the original file.

4.2.9.1.2.2. Bladed

This format generates a packed binary file and a text summary file.

This output format is in the Bladed-style format that TurbSim generates. That means that the shear is included in the file.

4.2.9.1.2.3. VTK

This format creates files in a subdirectory called vtk. There is one vtk file for each time in the full-field data structure, and the entire Y-Z grid is printed in each file. This format can be used to visualize the wind field using a viewer such as ParaView.

4.2.9.1.3. Converting uniform wind to full-field wind format

When converting from a uniform wind file to a full-field wind format, the following assumptions are used: - The advection speed is the time-averaged horizontal wind speed in the uniform wind file (it does not include the gust speed). - The constant time-step used in the output file is the smallest difference between any two entries in the hub-height file. - The maximum time in the uniform wind file will be used as the maximum time in the FF binary file. - The grid is generated with 5-m resolution in the lateral (Y) and horizontal (Z) directions. - The size of the grid is based on the RefLength parameter in the InflowWind input file. The converter adds approximately 10% to the grid width, with the exact size determined by achieving the desired grid resolution. The grid is centered in the lateral direction; it extends vertically above RefHt by the same distance as the grid width, and extends below RefHt to the ground (or within one grid point of the ground).

Note that there is a potential time shift between the uniform and full-field wind files, equal to the time it takes to travel the distance of half the grid width. When using the resulting full-field files, care must be taken that the aeroelastic code does not treat it as periodic.