NAME:      read_flow3d

AUTHOR:    Ian Curington, Stardent Computer Ltd., UK   orginal
           version 2 by Michael Rangitsch     substantially altered

SOURCE FILE: read_flow3d.c

TYPE:      data

INPUTS:    None

OUTPUTS:   field 3D irregular vector

PARAMETERS:  file browser,
	    choice parameters to select variables stored in the ASCII 
            dump file.

DESCRIPTION:

Files in this directory are for reading/converting
CFD data and Mesh files from the Harwell "FLOW3D" code version 2.4
into AVS Field types.

The read_flow3d module ascesses the dump files via a browser.
Prior to selecting the filename, use the parameter toggles to identify
which turbulence model, which combustion model, the number of scalar
species were used in the model and whether density or viscosity are stored, 
if the convection coefficients are desired or if the problem was in 
cylindrical coordinates.  The reader has no way of knowing from the dump 
file alone.

mjr -    I didn't test the new version on the data files listed below, but the
         reader worked on the data files I created.  In this version the
         boundary cells (low and high in i,j and k) are not valid flow 
         cells and should be cropped out.  I will modify this version (soon!)
         to properly account for the boundary cells.    6 Mar. 1992

The data may be used for promotional purposes, to show
how the reader module works, with credit to Harwell, UK.

Example files:

ex1:
  A 2d case, where data is valid only on the middle slice.
  Flow travels in one side and out the other, with recirculation
  on the top and bottom.

ex4:
  Flow along a pipe past four staggered quarter circle blockages.
  The 4 blockages are in a helical pattern. This causes the flow to
  rotate as it passes down the pipe.

ex4a:
  Flow past a rotated cube within a second cube.
  Flow is calculated between two cubes, one rotated
  within the other.

ex4b:
  Compressable flow through a duct of non uniform cross section.
  Heat sink is in the square part of duct.
  In this example the duct starts of with a circular cross section
  and then gradually changes into a square cross section. Half the duct
  is modelled and a symmetry plane is used.
  Prior to the square section the duct is split in two with a thin
  surface. The flow travels up one side of the duct, gets cooled
  in the square section by a heat sink, and
  then travels back down the other side of the duct.


Revision:  11 October 90  Ian Curington, Stardent UK
Version 2.0   6 March 92  Michael Rangitsch