vtkExodusIIWriter Class Reference

#include <vtkExodusIIWriter.h>

Inheritance diagram for vtkExodusIIWriter:

Inheritance graph
[legend]
Collaboration diagram for vtkExodusIIWriter:

Collaboration graph
[legend]

List of all members.


Detailed Description

Write Exodus II files.

This is a vtkWriter that writes it's vtkUnstructuredGrid input out to an Exodus II file. Go to http://endo.sandia.gov/SEACAS/ for more information about the Exodus II format.

Exodus files contain much information that is not captured in a vtkUnstructuredGrid, such as time steps, information lines, node sets, and side sets. This information can be stored in a vtkModelMetadata object.

The vtkExodusReader and vtkPExodusReader can create a vtkModelMetadata object and embed it in a vtkUnstructuredGrid in a series of field arrays. This writer searches for these field arrays and will use the metadata contained in them when creating the new Exodus II file.

You can also explicitly give the vtkExodusIIWriter a vtkModelMetadata object to use when writing the file.

In the absence of the information provided by vtkModelMetadata, if this writer is not part of a parallel application, we will use reasonable defaults for all the values in the output Exodus file. If you don't provide a block ID element array, we'll create a block for each cell type that appears in the unstructured grid.

However if this writer is part of a parallel application (hence writing out a distributed Exodus file), then we need at the very least a list of all the block IDs that appear in the file. And we need the element array of block IDs for the input unstructured grid.

In the absense of a vtkModelMetadata object, you can also provide time step information which we will include in the output Exodus file.

Warning:
If the input floating point field arrays and point locations are all floats or all doubles, this class will operate more efficiently. Mixing floats and doubles will slow you down, because Exodus II requires that we write only floats or only doubles.

We use the terms "point" and "node" interchangeably. Also, we use the terms "element" and "cell" interchangeably.

Events:
vtkCommand::StartEvent vtkCommand::EndEvent

Definition at line 88 of file vtkExodusIIWriter.h.


Public Types

typedef vtkWriter Superclass

Public Member Functions

virtual const char * GetClassName ()
virtual int IsA (const char *type)
void PrintSelf (ostream &os, vtkIndent indent)
void SetInput (vtkUnstructuredGrid *ug)
vtkUnstructuredGridGetInput ()
virtual void SetModelMetadata (vtkModelMetadata *)
virtual vtkModelMetadataGetModelMetadata ()
vtkModelMetadataGetOrCreateModelMetadata ()
virtual void SetFileName (const char *)
virtual char * GetFileName ()
virtual void SetStoreDoubles (int)
virtual int GetStoreDoubles ()
virtual void SetGhostLevel (int)
virtual int GetGhostLevel ()
virtual void SetBlockIdArrayName (const char *)
virtual char * GetBlockIdArrayName ()
virtual void SetWriteOutBlockIdArray (int)
virtual int GetWriteOutBlockIdArray ()
virtual void WriteOutBlockIdArrayOn ()
virtual void WriteOutBlockIdArrayOff ()
virtual void SetWriteOutGlobalNodeIdArray (int)
virtual int GetWriteOutGlobalNodeIdArray ()
virtual void WriteOutGlobalNodeIdArrayOn ()
virtual void WriteOutGlobalNodeIdArrayOff ()
virtual void SetWriteOutGlobalElementIdArray (int)
virtual int GetWriteOutGlobalElementIdArray ()
virtual void WriteOutGlobalElementIdArrayOn ()
virtual void WriteOutGlobalElementIdArrayOff ()
virtual void SetWriteAllTimeSteps (int)
virtual int GetWriteAllTimeSteps ()
virtual void WriteAllTimeStepsOn ()
virtual void WriteAllTimeStepsOff ()
void SetAllBlockIds (int numEntries, int *blockIds)
virtual void SetErrorStatus (int)
virtual int GetErrorStatus ()

Static Public Member Functions

static vtkExodusIIWriterNew ()
static int IsTypeOf (const char *type)
static vtkExodusIIWriterSafeDownCast (vtkObject *o)

Protected Member Functions

 vtkExodusIIWriter ()
 ~vtkExodusIIWriter ()
virtual int ProcessRequest (vtkInformation *request, vtkInformationVector **inputVector, vtkInformationVector *outputVector)
virtual int RequestData (vtkInformation *request, vtkInformationVector **inputVector, vtkInformationVector *outputVector)
virtual int RequestInformation (vtkInformation *request, vtkInformationVector **inputVector, vtkInformationVector *outputVector)
virtual int FillInputPortInformation (int port, vtkInformation *info)
void WriteData ()
 vtkExodusIIWriter (const vtkExodusIIWriter &)
void operator= (const vtkExodusIIWriter &)
virtual void SetMyFileName (const char *)
virtual char * GetMyFileName ()
void StringUppercase (const char *str, char *upperstr)
virtual void SetMyRank (int)
virtual int GetMyRank ()

Member Typedef Documentation

Reimplemented from vtkWriter.

Definition at line 92 of file vtkExodusIIWriter.h.


Constructor & Destructor Documentation

vtkExodusIIWriter::vtkExodusIIWriter (  )  [protected]

vtkExodusIIWriter::~vtkExodusIIWriter (  )  [protected]

vtkExodusIIWriter::vtkExodusIIWriter ( const vtkExodusIIWriter  )  [protected]


Member Function Documentation

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

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

Reimplemented from vtkAlgorithm.

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

Reimplemented from vtkWriter.

static int vtkExodusIIWriter::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 vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkWriter.

virtual int vtkExodusIIWriter::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 vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkWriter.

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

Reimplemented from vtkWriter.

void vtkExodusIIWriter::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 vtkWriter.

void vtkExodusIIWriter::SetInput ( vtkUnstructuredGrid ug  ) 

Specify input which will be written out to the Exodus II file.

vtkUnstructuredGrid* vtkExodusIIWriter::GetInput (  ) 

Reimplemented from vtkWriter.

virtual void vtkExodusIIWriter::SetModelMetadata ( vtkModelMetadata  )  [virtual]

Specify the vtkModelMetadata object which contains the Exodus file model information (metadata) absent in the vtkUnstructuredGrid. If you have this object, you don't need to set any other values before writing. (Just the FileName and the Input.) Note that the vtkExodusReader can create and attach a vtkModelMetadata object to it's output. If this has happened, the ExodusIIWriter will find it and use it.

virtual vtkModelMetadata* vtkExodusIIWriter::GetModelMetadata (  )  [virtual]

vtkModelMetadata* vtkExodusIIWriter::GetOrCreateModelMetadata (  ) 

By default, ModelMetadata is NULL until the Write() method is called, at which point the vtkExodusIIWriter will create a default metadata object. If you would like to obtain the metadata and modify it, rather than creating it yourself, you may call this function. If the metadata already exists (because it has been set by a call to SetModelMetadata or because it has been packed into the FieldData of the input mesh), that metadata will be returned. Otherwise, the vtkExodusIIWriter will create metadata using the input mesh as needed, set the metadata to that object, and return it.

virtual void vtkExodusIIWriter::SetFileName ( const char *   )  [virtual]

Name for the output file. If writing in parallel, the number of processes and the process rank will be appended to the name, so each process is writing out a separate file. If not set, this class will make up a file name.

virtual char* vtkExodusIIWriter::GetFileName (  )  [virtual]

virtual void vtkExodusIIWriter::SetStoreDoubles ( int   )  [virtual]

If StoreDoubles is ON, the floating point fields in the Exodus file will be double precision fields. The default is determined by the input vtkUnstructuredGrid. If the field data appears to be doubles, then StoreDoubles will be ON, otherwise StoreDoubles will be OFF.

virtual int vtkExodusIIWriter::GetStoreDoubles (  )  [virtual]

virtual void vtkExodusIIWriter::SetGhostLevel ( int   )  [virtual]

We never write out ghost cells. This variable is here to satisfy the behavior of ParaView on invoking a parallel writer.

virtual int vtkExodusIIWriter::GetGhostLevel (  )  [virtual]

virtual void vtkExodusIIWriter::SetBlockIdArrayName ( const char *   )  [virtual]

Exodus files group cells into blocks. There are no blocks in a vtkUnstructuredGrid, but you may have stored block IDs in a cell array. If so provide that name here. If you don't provide it, we'll look for an array named "BlockId", and we'll assume it's a vtkIntArray. If we find no block ID array, and this is not a multi-process application, we will create one Exodus block for every cell type found in the vtkUnstructuredGrid.

virtual char* vtkExodusIIWriter::GetBlockIdArrayName (  )  [virtual]

virtual void vtkExodusIIWriter::SetWriteOutBlockIdArray ( int   )  [virtual]

By default, the integer array containing the global Block Ids of the cells is not included when the new Exodus II file is written out. If you do want to include this array, set WriteOutBlockIdArray to ON.

virtual int vtkExodusIIWriter::GetWriteOutBlockIdArray (  )  [virtual]

virtual void vtkExodusIIWriter::WriteOutBlockIdArrayOn (  )  [virtual]

virtual void vtkExodusIIWriter::WriteOutBlockIdArrayOff (  )  [virtual]

virtual void vtkExodusIIWriter::SetWriteOutGlobalNodeIdArray ( int   )  [virtual]

By default, the integer array containing the global Node Ids is not included when the new Exodus II file is written out. If you do want to include this array, set WriteOutGlobalNodeIdArray to ON.

virtual int vtkExodusIIWriter::GetWriteOutGlobalNodeIdArray (  )  [virtual]

virtual void vtkExodusIIWriter::WriteOutGlobalNodeIdArrayOn (  )  [virtual]

virtual void vtkExodusIIWriter::WriteOutGlobalNodeIdArrayOff (  )  [virtual]

virtual void vtkExodusIIWriter::SetWriteOutGlobalElementIdArray ( int   )  [virtual]

By default, the integer array containing the global Element Ids is not included when the new Exodus II file is written out. If you do want to include this array, set WriteOutGlobalElementIdArray to ON.

virtual int vtkExodusIIWriter::GetWriteOutGlobalElementIdArray (  )  [virtual]

virtual void vtkExodusIIWriter::WriteOutGlobalElementIdArrayOn (  )  [virtual]

virtual void vtkExodusIIWriter::WriteOutGlobalElementIdArrayOff (  )  [virtual]

virtual void vtkExodusIIWriter::SetWriteAllTimeSteps ( int   )  [virtual]

When WriteAllTimeSteps is turned ON, the writer is executed once for each timestep available from the reader.

virtual int vtkExodusIIWriter::GetWriteAllTimeSteps (  )  [virtual]

virtual void vtkExodusIIWriter::WriteAllTimeStepsOn (  )  [virtual]

virtual void vtkExodusIIWriter::WriteAllTimeStepsOff (  )  [virtual]

void vtkExodusIIWriter::SetAllBlockIds ( int  numEntries,
int *  blockIds 
)

Provide a list of all blockIds that appear in the file. If this is a distributed file, and there is no vtkModelMetadata, we need all block Ids that appear in any of the files. We make a copy of your array of IDs.

virtual void vtkExodusIIWriter::SetErrorStatus ( int   )  [virtual]

The writer will set the ErrorStatus to a non-zero value each time a serious error occurs. Usually this would be a problem with memory allocation, invalid values in the input file's metadata, or an inability to write the output file.

virtual int vtkExodusIIWriter::GetErrorStatus (  )  [virtual]

virtual int vtkExodusIIWriter::ProcessRequest ( vtkInformation request,
vtkInformationVector **  inInfo,
vtkInformationVector outInfo 
) [protected, virtual]

Upstream/Downstream requests form the generalized interface through which executives invoke a algorithm's functionality. Upstream requests correspond to information flow from the algorithm's outputs to its inputs. Downstream requests correspond to information flow from the algorithm's inputs to its outputs. A downstream request is defined by the contents of the request information object. The input to the request is stored in the input information vector passed to ProcessRequest. The results of an downstream request are stored in the output information vector passed to ProcessRequest. An upstream request is defined by the contents of the request information object. The input to the request is stored in the output information vector passed to ProcessRequest. The results of an upstream request are stored in the input information vector passed to ProcessRequest. It returns the boolean status of the pipeline (false means failure).

Reimplemented from vtkWriter.

virtual int vtkExodusIIWriter::RequestData ( vtkInformation request,
vtkInformationVector **  inputVector,
vtkInformationVector outputVector 
) [protected, virtual]

Reimplemented from vtkWriter.

virtual int vtkExodusIIWriter::RequestInformation ( vtkInformation request,
vtkInformationVector **  inputVector,
vtkInformationVector outputVector 
) [protected, virtual]

virtual int vtkExodusIIWriter::FillInputPortInformation ( int  port,
vtkInformation info 
) [protected, virtual]

Fill the input port information objects for this algorithm. This is invoked by the first call to GetInputPortInformation for each port so subclasses can specify what they can handle.

Reimplemented from vtkAlgorithm.

void vtkExodusIIWriter::WriteData (  )  [protected, virtual]

Implements vtkWriter.

void vtkExodusIIWriter::operator= ( const vtkExodusIIWriter  )  [protected]

virtual void vtkExodusIIWriter::SetMyFileName ( const char *   )  [protected, virtual]

virtual char* vtkExodusIIWriter::GetMyFileName (  )  [protected, virtual]

virtual void vtkExodusIIWriter::SetMyRank ( int   )  [protected, virtual]

Get/Set the rank of the writer in a set of parallel processes so that it may determine which piece of the dataset it is responsible for writing.

virtual int vtkExodusIIWriter::GetMyRank (  )  [protected, virtual]

Get/Set the rank of the writer in a set of parallel processes so that it may determine which piece of the dataset it is responsible for writing.

void vtkExodusIIWriter::StringUppercase ( const char *  str,
char *  upperstr 
) [protected]


The documentation for this class was generated from the following file:

Generated on Sat Dec 27 13:24:17 2008 for VTK by  doxygen 1.5.6