#include <ColumnDataWriter.hpp>

Inheritance diagram for ColumnDataWriter:

Collaboration diagram for ColumnDataWriter:

Public Member Functions
	ColumnDataWriter (const std::string &rDirectory, const std::string &rBaseName, bool cleanDirectory=true, unsigned precision=8)
virtual	~ColumnDataWriter ()
int	DefineUnlimitedDimension (const std::string &rDimensionName, const std::string &rDimensionUnits)
int	DefineFixedDimension (const std::string &rDimensionName, const std::string &rDimensionUnits, long dimensionSize)
int	DefineVariable (const std::string &rVariableName, const std::string &rVariableUnits)
void	SetCommentForInfoFile (std::string comment)
virtual void	EndDefineMode ()
virtual void	AdvanceAlongUnlimitedDimension ()
virtual void	PutVariable (int variableID, double variableValue, long dimensionPosition=-1)
virtual void	Close ()
std::string	GetOutputDirectory ()
Protected Member Functions
void	CreateFixedDimensionFile (const std::string &rFileName)
void	CreateInfoFile (const std::string &rFileName)
void	CheckVariableName (const std::string &rName)
void	CheckUnitsName (const std::string &rName)
void	DoAdvanceAlongUnlimitedDimension ()
Protected Attributes
OutputFileHandler	mOutputFileHandler
std::string	mDirectory
std::string	mBaseName
bool	mIsInDefineMode
bool	mIsFixedDimensionSet
bool	mIsUnlimitedDimensionSet
long	mUnlimitedDimensionPosition
long	mFixedDimensionSize
out_stream	mpCurrentOutputFile
out_stream	mpCurrentAncillaryFile
DataWriterVariable *	mpUnlimitedDimensionVariable
DataWriterVariable *	mpFixedDimensionVariable
std::string	mUnlimitedDimensionName
std::string	mUnlimitedDimensionUnits
std::string	mFixedDimensionName
std::string	mFixedDimensionUnits
std::vector< DataWriterVariable >	mVariables
const unsigned	mFieldWidth
const unsigned	mPrecision
std::string	mFileExtension
int	mRowStartPosition
int	mRowWidth
int	mAncillaryRowStartPosition
int	mAncillaryRowWidth
bool	mHasPutVariable
bool	mNeedAdvanceAlongUnlimitedDimension
std::string	mCommentForInfoFile
Static Protected Attributes
static const int	SPACING = 2
static const int	FIXED_DIMENSION_VAR_ID = -1
static const int	UNLIMITED_DIMENSION_VAR_ID = -2

Detailed Description

A concrete column data writer class. Writes grid-formatted data in space separated column form. Each file has a header row with names and optional units for each column.

Definition at line 51 of file ColumnDataWriter.hpp.

Constructor & Destructor Documentation

ColumnDataWriter::ColumnDataWriter	(	const std::string &	rDirectory,
		const std::string &	rBaseName,
		bool	cleanDirectory = `true`,
		unsigned	precision = `8`
	)

Constructor.

Parameters:

rDirectory	the directory in which to write the data to file
rBaseName	the name of the file in which to write the data
cleanDirectory	whether to clean the directory (defaults to true)
precision	the precision with which to write the data (i.e. exactly how many digits to display after the decimal point). Defaults to 8. Must be between 2 and 20 (inclusive).

Implementation file for ColumnDataWriter class.

Definition at line 53 of file ColumnDataWriter.cpp.

References EXCEPTION.

ColumnDataWriter::~ColumnDataWriter ( ) [virtual]

Destructor. Closes any open files.

Definition at line 81 of file ColumnDataWriter.cpp.

References Close(), mpFixedDimensionVariable, and mpUnlimitedDimensionVariable.

Member Function Documentation

void ColumnDataWriter::AdvanceAlongUnlimitedDimension ( ) [virtual]

Dummy function for DoAdvanceAlongUnlimitedDimension.

Implements AbstractDataWriter.

Reimplemented in ParallelColumnDataWriter.

Definition at line 401 of file ColumnDataWriter.cpp.

References mHasPutVariable, and mNeedAdvanceAlongUnlimitedDimension.

Referenced by OdeSolution::WriteToFile().

void ColumnDataWriter::CheckUnitsName ( const std::string & rName ) [protected]

Check name of unit is allowed, i.e. contains only alphanumeric & _, and isn't blank.

Parameters:

rName unit name

Definition at line 126 of file ColumnDataWriter.cpp.

References EXCEPTION.

Referenced by CheckVariableName(), DefineFixedDimension(), DefineUnlimitedDimension(), and DefineVariable().

void ColumnDataWriter::CheckVariableName ( const std::string & rName ) [protected]

Check name of variable is allowed, i.e. contains only alphanumeric & _, and isn't blank.

Parameters:

rName variable name

Definition at line 117 of file ColumnDataWriter.cpp.

References CheckUnitsName(), and EXCEPTION.

Referenced by DefineFixedDimension(), DefineUnlimitedDimension(), and DefineVariable().

void ColumnDataWriter::Close ( ) [virtual]

Close any open files.

Implements AbstractDataWriter.

Reimplemented in ParallelColumnDataWriter.

Definition at line 102 of file ColumnDataWriter.cpp.

References mpCurrentAncillaryFile, and mpCurrentOutputFile.

Referenced by OdeSolution::WriteToFile(), and ~ColumnDataWriter().

void ColumnDataWriter::CreateFixedDimensionFile ( const std::string & rFileName ) [protected]

Create the output file and write out the header for it.

Parameters:

rFileName the name of the file to write to, relative to the output directory

Definition at line 323 of file ColumnDataWriter.cpp.

References mFixedDimensionSize, mOutputFileHandler, mpCurrentOutputFile, mpFixedDimensionVariable, mPrecision, mRowStartPosition, mRowWidth, DataWriterVariable::mVariableName, mVariables, DataWriterVariable::mVariableUnits, and OutputFileHandler::OpenOutputFile().

Referenced by DoAdvanceAlongUnlimitedDimension(), and EndDefineMode().

void ColumnDataWriter::CreateInfoFile ( const std::string & rFileName ) [protected]

Create the info file.

Parameters:

rFileName the name of the file to create, relative to the output directory

Definition at line 352 of file ColumnDataWriter.cpp.

References ChasteBuildInfo::GetProvenanceString(), mCommentForInfoFile, mFixedDimensionSize, mIsUnlimitedDimensionSet, mOutputFileHandler, mVariables, and OutputFileHandler::OpenOutputFile().

Referenced by EndDefineMode().

int ColumnDataWriter::DefineFixedDimension	(	const std::string &	rDimensionName,
		const std::string &	rDimensionUnits,
		long	dimensionSize
	)		`[virtual]`

Define the fixed dimension.

Parameters:

rDimensionName	The name of the dimension
rDimensionUnits	The physical units of the dimension
dimensionSize	The size of the dimension

Returns:: The identifier of the variable

Implements AbstractDataWriter.

Definition at line 166 of file ColumnDataWriter.cpp.

References CheckUnitsName(), CheckVariableName(), EXCEPTION, FIXED_DIMENSION_VAR_ID, mFixedDimensionName, mFixedDimensionSize, mFixedDimensionUnits, mIsFixedDimensionSet, mIsInDefineMode, mpFixedDimensionVariable, DataWriterVariable::mVariableName, and DataWriterVariable::mVariableUnits.

int ColumnDataWriter::DefineUnlimitedDimension	(	const std::string &	rDimensionName,
		const std::string &	rDimensionUnits
	)		`[virtual]`

Define the unlimited dimension, i.e. the dimension that increases as the simulation progresses.

Parameters:

rDimensionName	The name of the unlimited dimension
rDimensionUnits	The physical units of the unlimited dimension

Returns:: The identifier of the variable

Implements AbstractDataWriter.

Definition at line 138 of file ColumnDataWriter.cpp.

References CheckUnitsName(), CheckVariableName(), EXCEPTION, mIsInDefineMode, mIsUnlimitedDimensionSet, mpUnlimitedDimensionVariable, mUnlimitedDimensionName, mUnlimitedDimensionUnits, DataWriterVariable::mVariableName, DataWriterVariable::mVariableUnits, and UNLIMITED_DIMENSION_VAR_ID.

Referenced by OdeSolution::WriteToFile().

int ColumnDataWriter::DefineVariable	(	const std::string &	rVariableName,
		const std::string &	rVariableUnits
	)		`[virtual]`

Define a variable.

Parameters:

rVariableName	The name of the variable
rVariableUnits	The physical units of the variable

Returns:: The identifier of the variable

Implements AbstractDataWriter.

Definition at line 194 of file ColumnDataWriter.cpp.

References CheckUnitsName(), CheckVariableName(), EXCEPTION, mFixedDimensionName, mIsInDefineMode, mUnlimitedDimensionName, DataWriterVariable::mVariableName, mVariables, and DataWriterVariable::mVariableUnits.

Referenced by OdeSolution::WriteToFile().

void ColumnDataWriter::DoAdvanceAlongUnlimitedDimension ( ) [protected]

Advance along the unlimited dimension. Normally this will be called when all variables in a row have been input.

Definition at line 367 of file ColumnDataWriter.cpp.

References CreateFixedDimensionFile(), EXCEPTION, FILE_SUFFIX_WIDTH, mBaseName, mHasPutVariable, mIsFixedDimensionSet, mIsUnlimitedDimensionSet, mNeedAdvanceAlongUnlimitedDimension, mpCurrentOutputFile, mRowStartPosition, mRowWidth, and mUnlimitedDimensionPosition.

Referenced by ParallelColumnDataWriter::AdvanceAlongUnlimitedDimension(), and PutVariable().

void ColumnDataWriter::EndDefineMode ( ) [virtual]

End the define mode of the DataWriter.

Implements AbstractDataWriter.

Reimplemented in ParallelColumnDataWriter.

Definition at line 231 of file ColumnDataWriter.cpp.

References CreateFixedDimensionFile(), CreateInfoFile(), EXCEPTION, FILE_SUFFIX_WIDTH, mAncillaryRowStartPosition, mAncillaryRowWidth, mBaseName, mFieldWidth, mIsFixedDimensionSet, mIsInDefineMode, mIsUnlimitedDimensionSet, mOutputFileHandler, mpCurrentAncillaryFile, mpCurrentOutputFile, mpFixedDimensionVariable, mPrecision, mpUnlimitedDimensionVariable, mRowStartPosition, mRowWidth, mUnlimitedDimensionPosition, DataWriterVariable::mVariableName, mVariables, DataWriterVariable::mVariableUnits, OutputFileHandler::OpenOutputFile(), and SPACING.

Referenced by OdeSolution::WriteToFile().

std::string ColumnDataWriter::GetOutputDirectory ( )

Return the full pathname of the directory where we're writing files.

Definition at line 97 of file ColumnDataWriter.cpp.

References OutputFileHandler::GetOutputDirectoryFullPath(), and mOutputFileHandler.

void ColumnDataWriter::PutVariable	(	int	variableID,
		double	variableValue,
		long	dimensionPosition = `-1`
	)		`[virtual]`

Input the variable value to the output file or ancillary file.

Parameters:

variableID
variableValue
dimensionPosition	The position in column (defaults to -1). This is required if there is a fixed dimension, and will be the position along that dimension

Implements AbstractDataWriter.

Reimplemented in ParallelColumnDataWriter.

Definition at line 409 of file ColumnDataWriter.cpp.

References DoAdvanceAlongUnlimitedDimension(), EXCEPTION, FIXED_DIMENSION_VAR_ID, mFieldWidth, mFixedDimensionSize, mHasPutVariable, mIsFixedDimensionSet, mIsInDefineMode, mIsUnlimitedDimensionSet, mNeedAdvanceAlongUnlimitedDimension, mpCurrentAncillaryFile, mpCurrentOutputFile, mpFixedDimensionVariable, mpUnlimitedDimensionVariable, mRowStartPosition, mRowWidth, mVariables, SPACING, and UNLIMITED_DIMENSION_VAR_ID.