vtkMultiBlockPLOT3DReader Class Reference

#include <vtkMultiBlockPLOT3DReader.h>

Inheritance diagram for vtkMultiBlockPLOT3DReader:

[legend]

Collaboration diagram for vtkMultiBlockPLOT3DReader:

[legend]

List of all members.

Detailed Description

read PLOT3D data files

vtkMultiBlockPLOT3DReader is a reader object that reads PLOT3D formatted files and generates structured grid(s) on output. PLOT3D is a computer graphics program designed to visualize the grids and solutions of computational fluid dynamics. Please see the "PLOT3D User's Manual" available from NASA Ames Research Center, Moffett Field CA.

PLOT3D files consist of a grid file (also known as XYZ file), an optional solution file (also known as a Q file), and an optional function file that contains user created data (currently unsupported). The Q file contains solution information as follows: the four parameters free stream mach number (Fsmach), angle of attack (Alpha), Reynolds number (Re), and total integration time (Time). This information is stored in an array called Properties in the FieldData of each output (tuple 0: fsmach, tuple 1: alpha, tuple 2: re, tuple 3: time). In addition, the solution file contains the flow density (scalar), flow momentum (vector), and flow energy (scalar).

The reader can generate additional scalars and vectors (or "functions") from this information. To use vtkMultiBlockPLOT3DReader, you must specify the particular function number for the scalar and vector you want to visualize. This implementation of the reader provides the following functions. The scalar functions are: -1 - don't read or compute any scalars 100 - density 110 - pressure 120 - temperature 130 - enthalpy 140 - internal energy 144 - kinetic energy 153 - velocity magnitude 163 - stagnation energy 170 - entropy 184 - swirl.

The vector functions are: -1 - don't read or compute any vectors 200 - velocity 201 - vorticity 202 - momentum 210 - pressure gradient.

(Other functions are described in the PLOT3D spec, but only those listed are implemented here.) Note that by default, this reader creates the density scalar (100) and momentum vector (202) as output. (These are just read in from the solution file.) Please note that the validity of computation is a function of this class's gas constants (R, Gamma) and the equations used. They may not be suitable for your computational domain.

Additionally, you can read other data and associate it as a vtkDataArray into the output's point attribute data. Use the method AddFunction() to list all the functions that you'd like to read. AddFunction() accepts an integer parameter that defines the function number.

See also:: vtkStructuredGridSource vtkStructuredGrid

Tests:: vtkMultiBlockPLOT3DReader (Tests)

Definition at line 89 of file vtkMultiBlockPLOT3DReader.h.


Public Types
enum	{ FILE_BIG_ENDIAN = 0, FILE_LITTLE_ENDIAN = 1 }
typedef vtkMultiBlockDataSetAlgorithm	Superclass
Public Member Functions
virtual const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
virtual int	CanReadBinaryFile (const char *fname)

void	SetFileName (const char *name)
const char *	GetFileName ()
virtual void	SetXYZFileName (const char *)
virtual char *	GetXYZFileName ()

virtual void	SetQFileName (const char *)
virtual char *	GetQFileName ()

int	GetNumberOfBlocks ()
int	GetNumberOfGrids ()

virtual void	SetBinaryFile (int)
virtual int	GetBinaryFile ()
virtual void	BinaryFileOn ()
virtual void	BinaryFileOff ()

virtual void	SetMultiGrid (int)
virtual int	GetMultiGrid ()
virtual void	MultiGridOn ()
virtual void	MultiGridOff ()

virtual void	SetHasByteCount (int)
virtual int	GetHasByteCount ()
virtual void	HasByteCountOn ()
virtual void	HasByteCountOff ()

virtual void	SetIBlanking (int)
virtual int	GetIBlanking ()
virtual void	IBlankingOn ()
virtual void	IBlankingOff ()

virtual void	SetTwoDimensionalGeometry (int)
virtual int	GetTwoDimensionalGeometry ()
virtual void	TwoDimensionalGeometryOn ()
virtual void	TwoDimensionalGeometryOff ()

virtual void	SetForceRead (int)
virtual int	GetForceRead ()
virtual void	ForceReadOn ()
virtual void	ForceReadOff ()

void	SetByteOrderToBigEndian ()
void	SetByteOrderToLittleEndian ()
virtual void	SetByteOrder (int)
virtual int	GetByteOrder ()
const char *	GetByteOrderAsString ()

virtual void	SetR (double)
virtual double	GetR ()

virtual void	SetGamma (double)
virtual double	GetGamma ()

virtual void	SetUvinf (double)
virtual double	GetUvinf ()

virtual void	SetVvinf (double)
virtual double	GetVvinf ()

virtual void	SetWvinf (double)
virtual double	GetWvinf ()

void	SetScalarFunctionNumber (int num)
virtual int	GetScalarFunctionNumber ()

void	SetVectorFunctionNumber (int num)
virtual int	GetVectorFunctionNumber ()

void	AddFunction (int functionNumber)
void	RemoveFunction (int)
void	RemoveAllFunctions ()
Static Public Member Functions
static vtkMultiBlockPLOT3DReader *	New ()
static int	IsTypeOf (const char *type)
static vtkMultiBlockPLOT3DReader *	SafeDownCast (vtkObject *o)
Protected Member Functions
	vtkMultiBlockPLOT3DReader ()
	~vtkMultiBlockPLOT3DReader ()
int	CheckFile (FILE &fp, const char fname)
int	CheckGeometryFile (FILE *&xyzFp)
int	CheckSolutionFile (FILE *&qFp)
void	SkipByteCount (FILE *fp)
int	ReadIntBlock (FILE fp, int n, int block)
int	ReadFloatBlock (FILE fp, int n, float block)
int	GetNumberOfBlocksInternal (FILE *xyzFp, int verify=1)
int	ReadGeometryHeader (FILE *fp)
int	ReadQHeader (FILE *fp)
void	CalculateFileSize (FILE *fp)
long	EstimateSize (int ni, int nj, int nk)
void	AssignAttribute (int fNumber, vtkStructuredGrid *output, int attributeType)
void	MapFunction (int fNumber, vtkStructuredGrid *output)
void	ComputeTemperature (vtkStructuredGrid *output)
void	ComputePressure (vtkStructuredGrid *output)
void	ComputeEnthalpy (vtkStructuredGrid *output)
void	ComputeKineticEnergy (vtkStructuredGrid *output)
void	ComputeVelocityMagnitude (vtkStructuredGrid *output)
void	ComputeEntropy (vtkStructuredGrid *output)
void	ComputeSwirl (vtkStructuredGrid *output)
void	ComputeVelocity (vtkStructuredGrid *output)
void	ComputeVorticity (vtkStructuredGrid *output)
void	ComputePressureGradient (vtkStructuredGrid *output)
void	ClearGeometryCache ()
int	GenerateDefaultConfiguration ()
int	VerifySettings (char *buf, int bufSize)
void	ReadIntBlockV (char *buf, int n, int block)
void	SkipByteCountV (char **buf)
virtual int	FillOutputPortInformation (int port, vtkInformation *info)
virtual int	RequestData (vtkInformation , vtkInformationVector , vtkInformationVector )
virtual int	RequestInformation (vtkInformation , vtkInformationVector , vtkInformationVector )
Protected Attributes
char *	XYZFileName
char *	QFileName
int	BinaryFile
int	HasByteCount
int	TwoDimensionalGeometry
int	MultiGrid
int	ForceRead
int	ByteOrder
int	IBlanking
long	FileSize
double	R
double	Gamma
double	Uvinf
double	Vvinf
double	Wvinf
vtkIntArray *	FunctionList
int	ScalarFunctionNumber
int	VectorFunctionNumber
vtkFloatArray **	PointCache
vtkUnsignedCharArray **	IBlankCache

Member Typedef Documentation

typedef vtkMultiBlockDataSetAlgorithm vtkMultiBlockPLOT3DReader::Superclass

Reimplemented from vtkMultiBlockDataSetAlgorithm.

Definition at line 93 of file vtkMultiBlockPLOT3DReader.h.

Member Enumeration Documentation

anonymous enum

Enumerator:

FILE_BIG_ENDIAN
FILE_LITTLE_ENDIAN

Definition at line 242 of file vtkMultiBlockPLOT3DReader.h.

Constructor & Destructor Documentation

vtkMultiBlockPLOT3DReader::vtkMultiBlockPLOT3DReader ( ) [protected]

vtkMultiBlockPLOT3DReader::~vtkMultiBlockPLOT3DReader ( ) [protected]

Member Function Documentation

static vtkMultiBlockPLOT3DReader* vtkMultiBlockPLOT3DReader::New ( ) [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkMultiBlockDataSetAlgorithm.

virtual const char* vtkMultiBlockPLOT3DReader::GetClassName ( ) [virtual]

Reimplemented from vtkMultiBlockDataSetAlgorithm.

static int vtkMultiBlockPLOT3DReader::IsTypeOf ( const char * name ) [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkMultiBlockDataSetAlgorithm.

virtual int vtkMultiBlockPLOT3DReader::IsA ( const char * name ) [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkMultiBlockDataSetAlgorithm.

static vtkMultiBlockPLOT3DReader* vtkMultiBlockPLOT3DReader::SafeDownCast ( vtkObject * o ) [static]

Reimplemented from vtkMultiBlockDataSetAlgorithm.

void vtkMultiBlockPLOT3DReader::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)			`[virtual]`

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkMultiBlockDataSetAlgorithm.

void vtkMultiBlockPLOT3DReader::SetFileName ( const char * name ) [inline]

Set/Get the PLOT3D geometry filename.

Definition at line 98 of file vtkMultiBlockPLOT3DReader.h.

const char* vtkMultiBlockPLOT3DReader::GetFileName ( ) [inline]

Set/Get the PLOT3D geometry filename.

Definition at line 99 of file vtkMultiBlockPLOT3DReader.h.

virtual void vtkMultiBlockPLOT3DReader::SetXYZFileName ( const char * ) [virtual]

Set/Get the PLOT3D geometry filename.

virtual char* vtkMultiBlockPLOT3DReader::GetXYZFileName ( ) [virtual]

Set/Get the PLOT3D geometry filename.

virtual void vtkMultiBlockPLOT3DReader::SetQFileName ( const char * ) [virtual]

Set/Get the PLOT3D solution filename.

virtual char* vtkMultiBlockPLOT3DReader::GetQFileName ( ) [virtual]

Set/Get the PLOT3D solution filename.

int vtkMultiBlockPLOT3DReader::GetNumberOfBlocks ( )

This returns the number of outputs this reader will produce. This number is equal to the number of grids in the current file. This method has to be called before getting any output if the number of outputs will be greater than 1 (the first output is always the same). Note that every time this method is invoked, the header file is opened and part of the header is read.

int vtkMultiBlockPLOT3DReader::GetNumberOfGrids ( ) [inline]

This returns the number of outputs this reader will produce. This number is equal to the number of grids in the current file. This method has to be called before getting any output if the number of outputs will be greater than 1 (the first output is always the same). Note that every time this method is invoked, the header file is opened and part of the header is read.

Definition at line 118 of file vtkMultiBlockPLOT3DReader.h.

virtual void vtkMultiBlockPLOT3DReader::SetBinaryFile ( int ) [virtual]

Is the file to be read written in binary format (as opposed to ascii).

virtual int vtkMultiBlockPLOT3DReader::GetBinaryFile ( ) [virtual]

Is the file to be read written in binary format (as opposed to ascii).

virtual void vtkMultiBlockPLOT3DReader::BinaryFileOn ( ) [virtual]

Is the file to be read written in binary format (as opposed to ascii).

virtual void vtkMultiBlockPLOT3DReader::BinaryFileOff ( ) [virtual]

Is the file to be read written in binary format (as opposed to ascii).

virtual void vtkMultiBlockPLOT3DReader::SetMultiGrid ( int ) [virtual]

Does the file to be read contain information about number of grids. In some PLOT3D files, the first value contains the number of grids (even if there is only 1). If reading such a file, set this to true.

virtual int vtkMultiBlockPLOT3DReader::GetMultiGrid ( ) [virtual]

Does the file to be read contain information about number of grids. In some PLOT3D files, the first value contains the number of grids (even if there is only 1). If reading such a file, set this to true.

virtual void vtkMultiBlockPLOT3DReader::MultiGridOn ( ) [virtual]

Does the file to be read contain information about number of grids. In some PLOT3D files, the first value contains the number of grids (even if there is only 1). If reading such a file, set this to true.

virtual void vtkMultiBlockPLOT3DReader::MultiGridOff ( ) [virtual]

Does the file to be read contain information about number of grids. In some PLOT3D files, the first value contains the number of grids (even if there is only 1). If reading such a file, set this to true.

virtual void vtkMultiBlockPLOT3DReader::SetHasByteCount ( int ) [virtual]

Were the arrays written with leading and trailing byte counts ? Usually, files written by a fortran program will contain these byte counts whereas the ones written by C/C++ won't.

virtual int vtkMultiBlockPLOT3DReader::GetHasByteCount ( ) [virtual]

Were the arrays written with leading and trailing byte counts ? Usually, files written by a fortran program will contain these byte counts whereas the ones written by C/C++ won't.

virtual void vtkMultiBlockPLOT3DReader::HasByteCountOn ( ) [virtual]

Were the arrays written with leading and trailing byte counts ? Usually, files written by a fortran program will contain these byte counts whereas the ones written by C/C++ won't.

virtual void vtkMultiBlockPLOT3DReader::HasByteCountOff ( ) [virtual]

Were the arrays written with leading and trailing byte counts ? Usually, files written by a fortran program will contain these byte counts whereas the ones written by C/C++ won't.

virtual void vtkMultiBlockPLOT3DReader::SetIBlanking ( int ) [virtual]

Is there iblanking (point visibility) information in the file. If there is iblanking arrays, these will be read and assigned to the PointVisibility array of the output.

virtual int vtkMultiBlockPLOT3DReader::GetIBlanking ( ) [virtual]

Is there iblanking (point visibility) information in the file. If there is iblanking arrays, these will be read and assigned to the PointVisibility array of the output.

virtual void vtkMultiBlockPLOT3DReader::IBlankingOn ( ) [virtual]

Is there iblanking (point visibility) information in the file. If there is iblanking arrays, these will be read and assigned to the PointVisibility array of the output.

virtual void vtkMultiBlockPLOT3DReader::IBlankingOff ( ) [virtual]

Is there iblanking (point visibility) information in the file. If there is iblanking arrays, these will be read and assigned to the PointVisibility array of the output.

virtual void vtkMultiBlockPLOT3DReader::SetTwoDimensionalGeometry ( int ) [virtual]

If only two-dimensional data was written to the file, turn this on.

virtual int vtkMultiBlockPLOT3DReader::GetTwoDimensionalGeometry ( ) [virtual]

If only two-dimensional data was written to the file, turn this on.

virtual void vtkMultiBlockPLOT3DReader::TwoDimensionalGeometryOn ( ) [virtual]

If only two-dimensional data was written to the file, turn this on.

virtual void vtkMultiBlockPLOT3DReader::TwoDimensionalGeometryOff ( ) [virtual]

If only two-dimensional data was written to the file, turn this on.

virtual void vtkMultiBlockPLOT3DReader::SetForceRead ( int ) [virtual]

Try to read a binary file even if the file length seems to be inconsistent with the header information. Use this with caution, if the file length is not the same as calculated from the header. either the file is corrupt or the settings are wrong.

virtual int vtkMultiBlockPLOT3DReader::GetForceRead ( ) [virtual]

Try to read a binary file even if the file length seems to be inconsistent with the header information. Use this with caution, if the file length is not the same as calculated from the header. either the file is corrupt or the settings are wrong.

virtual void vtkMultiBlockPLOT3DReader::ForceReadOn ( ) [virtual]

Try to read a binary file even if the file length seems to be inconsistent with the header information. Use this with caution, if the file length is not the same as calculated from the header. either the file is corrupt or the settings are wrong.

virtual void vtkMultiBlockPLOT3DReader::ForceReadOff ( ) [virtual]

Try to read a binary file even if the file length seems to be inconsistent with the header information. Use this with caution, if the file length is not the same as calculated from the header. either the file is corrupt or the settings are wrong.

void vtkMultiBlockPLOT3DReader::SetByteOrderToBigEndian ( )