Supports writing of ensight cases as well as providing common factory methods to open new files. More...

Classes
class	options
	Configuration options for the ensightCase. More...

Public Member Functions
	ensightCase (const fileName &ensightDir, const word &caseName, const options &opts)
	Construct from components. More...

	ensightCase (const fileName &ensightDir, const word &caseName, const IOstreamOption::streamFormat fmt=IOstreamOption::BINARY)
	Construct from components with all default options. More...

	~ensightCase ()=default
	Destructor. More...

const ensightCase::options &	option () const
	Reference to the case options. More...

IOstreamOption::streamFormat	format () const
	The output file format (ascii/binary) More...

const fileName &	path () const noexcept
	The nominal path to the case file. More...

const word &	mask () const
	The output '*' mask. More...

word	padded (const label i) const
	Consistent zero-padded integer value. More...

bool	nodeValues () const
	Force use of values per node instead of per element. More...

bool	separateCloud () const
	Write clouds into their own directory instead in "data" directory. More...

void	nextTime (const scalar t)
	Set time for time-set 1, using next available index. More...

void	nextTime (const instant &t)
	Set time for time-set 1, using next available index. More...

void	setTime (const scalar t, const label index)
	Set current index and time for time-set 1. More...

void	setTime (const instant &t, const label index)
	Set current index and time for time-set 1. More...

autoPtr< ensightGeoFile >	newGeometry (bool moving=false) const
	Open stream for new geometry file (on master). More...

autoPtr< ensightFile >	newCloud (const word &cloudName) const
	Open stream for new cloud positions (on master). More...

template<class Type >
autoPtr< ensightFile >	newData (const word &varName, const bool isPointData=false) const
	Open stream for new data file (on master), with current index. More...

template<class Type >
autoPtr< ensightFile >	newPointData (const word &varName) const
	Open stream for new data file (on master), with current index and marking as containing POINT_DATA. More...

template<class Type >
autoPtr< ensightFile >	newCloudData (const word &cloudName, const word &varName) const
	Open stream for new cloud data file (on master), with current index. More...

void	rewind () const
	Rewind the output stream (master only). More...

void	write () const
	Write the case file. More...

Ostream &	operator() () const
	Output stream (master only). More...

Ostream &	printInfo (Ostream &os) const
	Print some general information. More...

template<class Type >
Foam::autoPtr< Foam::ensightFile >	newData (const word &name, const bool isPointData) const

template<class Type >
Foam::autoPtr< Foam::ensightFile >	newPointData (const word &name) const

template<class Type >
Foam::autoPtr< Foam::ensightFile >	newCloudData (const word &cloudName, const word &name) const

Static Public Member Functions
static word	padded (const int nwidth, const label value)
	Stringified zero-padded integer value. More...

static void	printTimeset (OSstream &os, const label ts, const scalar timeValue)
	Print time-set for ensight case file with a single time. More...

static void	printTimeset (OSstream &os, const label ts, const UList< scalar > &times)
	Print time-set for ensight case file, with N times and 0-based file numbering. More...

static void	printTimeset (OSstream &os, const label ts, const UList< scalar > &times, const bitSet &indices)
	Print time-set for ensight case file, with N times, 0-based file numbering but perhaps non-contiguous. More...

Static Public Attributes
static const char *	dataDirName = "data"
	The name for data subdirectory: "data". More...

static const char *	geometryName = "geometry"
	The name for geometry files: "geometry". More...

Detailed Description

Supports writing of ensight cases as well as providing common factory methods to open new files.

Source files

Definition at line 64 of file ensightCase.H.

Constructor & Destructor Documentation

◆ ensightCase() [1/2]

ensightCase	(	const fileName &	ensightDir,
		const word &	caseName,
		const options &	opts
	)

Construct from components.

Definition at line 511 of file ensightCase.C.

◆ ensightCase() [2/2]

ensightCase	(	const fileName &	ensightDir,
		const word &	caseName,
		const IOstreamOption::streamFormat	fmt = `IOstreamOption::BINARY`
	)

Construct from components with all default options.

Definition at line 536 of file ensightCase.C.

◆ ~ensightCase()

~ensightCase ( )

default

Destructor.

Member Function Documentation

◆ padded() [1/2]

Foam::word padded	(	const int	nwidth,
		const label	value
	)

static

Stringified zero-padded integer value.

Definition at line 38 of file ensightCase.C.

References Foam::name(), Foam::setfill(), and Foam::setw().

Referenced by ensightSurfaceReader::replaceMask(), and ensightWriter::writeCollated().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ option()

const Foam::ensightCase::options & option ( ) const

inline

Reference to the case options.

Definition at line 23 of file ensightCaseI.H.

◆ format()

Foam::IOstreamOption::streamFormat format ( ) const

inline

The output file format (ascii/binary)

Definition at line 29 of file ensightCaseI.H.

◆ path()

const Foam::fileName & path ( ) const

inlinenoexcept

The nominal path to the case file.

Definition at line 35 of file ensightCaseI.H.

◆ mask()

const Foam::word & mask ( ) const

inline

The output '*' mask.

Definition at line 41 of file ensightCaseI.H.

◆ padded() [2/2]

Foam::word padded ( const label i ) const

inline

Consistent zero-padded integer value.

Definition at line 47 of file ensightCaseI.H.

◆ nodeValues()

bool nodeValues ( ) const

inline

Force use of values per node instead of per element.

Definition at line 53 of file ensightCaseI.H.

Referenced by Foam::writeVolField().

Here is the caller graph for this function:

◆ separateCloud()

bool separateCloud ( ) const

inline

Write clouds into their own directory instead in "data" directory.

Definition at line 59 of file ensightCaseI.H.

◆ nextTime() [1/2]

void nextTime ( const scalar t )

Set time for time-set 1, using next available index.

Create corresponding sub-directory. Do not mix between nextTime and setTime in an application.

Definition at line 562 of file ensightCase.C.

References setTime().

Here is the call graph for this function:

◆ nextTime() [2/2]

void nextTime ( const instant & t )

Set time for time-set 1, using next available index.

Create corresponding sub-directory. Do not mix between nextTime and setTime in an application.

Definition at line 569 of file ensightCase.C.

References Instant< T >::value().

Here is the call graph for this function:

◆ setTime() [1/2]

void setTime	(	const scalar	t,
		const label	index
	)

Set current index and time for time-set 1.

Create corresponding sub-directory

Note: do not mix between nextTime and setTime in an application.

Definition at line 575 of file ensightCase.C.

References UPstream::master(), Foam::mkDir(), fileName::name(), and Foam::nl.

Here is the call graph for this function:

◆ setTime() [2/2]

void setTime	(	const instant &	t,
		const label	index
	)

Set current index and time for time-set 1.

Create corresponding sub-directory

Note: do not mix between nextTime and setTime in an application.

Definition at line 600 of file ensightCase.C.

References setTime(), and Instant< T >::value().

Here is the call graph for this function:

◆ newGeometry()

Foam::autoPtr< Foam::ensightGeoFile > newGeometry ( bool moving = false ) const

Open stream for new geometry file (on master).

Definition at line 800 of file ensightCase.C.

References format(), UPstream::master(), Foam::mkDir(), autoPtr< T >::New(), Foam::output(), and path().

Here is the call graph for this function:

◆ newCloud()

Foam::autoPtr< Foam::ensightFile > newCloud ( const word & cloudName ) const

Open stream for new cloud positions (on master).

Note the use of ensightFile, not ensightGeoFile.

Definition at line 834 of file ensightCase.C.

References cloudName(), UPstream::master(), Foam::output(), cloud::prefix, and Ostream::write().

Here is the call graph for this function:

◆ newData() [1/2]

autoPtr<ensightFile> newData	(	const word &	varName,
		const bool	isPointData = `false`
	)		const

Open stream for new data file (on master), with current index.

Optionally marking as containing POINT_DATA

Referenced by Foam::writeAreaField(), Foam::writePointField(), and Foam::writeVolField().

Here is the caller graph for this function:

◆ newPointData() [1/2]

autoPtr<ensightFile> newPointData ( const word & varName ) const

Open stream for new data file (on master), with current index and marking as containing POINT_DATA.

◆ newCloudData() [1/2]

autoPtr<ensightFile> newCloudData	(	const word &	cloudName,
		const word &	varName
	)		const

Open stream for new cloud data file (on master), with current index.

◆ rewind()

void rewind ( ) const

Rewind the output stream (master only).

Definition at line 858 of file ensightCase.C.

◆ write()

void write ( ) const

Write the case file.

Definition at line 606 of file ensightCase.C.

References cloudName(), Foam::flush(), Foam::max(), Foam::name(), Foam::nl, cloud::prefix, word::printf(), Foam::setw(), HashTable< T, Key, Hash >::sortedToc(), and Foam::writeHeader().

Here is the call graph for this function:

◆ operator()()

Foam::Ostream & operator() ( ) const

inline

Output stream (master only).

Definition at line 67 of file ensightCaseI.H.

◆ printInfo()

Foam::Ostream & printInfo ( Ostream & os ) const

Print some general information.

Definition at line 867 of file ensightCase.C.

References format(), Foam::nl, and os().

Here is the call graph for this function:

◆ printTimeset() [1/3]

void printTimeset	(	OSstream &	os,
		const label	ts,
		const scalar	timeValue
	)

static

Print time-set for ensight case file with a single time.

Definition at line 53 of file ensightCase.C.

References Foam::nl, and os().

Referenced by ensightWriter::writeCollated(), and ensightWriter::writeUncollated().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ printTimeset() [2/3]

void printTimeset	(	OSstream &	os,
		const label	ts,
		const UList< scalar > &	times
	)

static

Print time-set for ensight case file, with N times and 0-based file numbering.

* TIME
* time set: ts
* number of steps: ns
* filename start number: 0
* filename increment: 1
* time values: time_1 time_2 ... time_ns
*

Definition at line 74 of file ensightCase.C.

References Foam::nl, os(), Foam::setf(), Foam::setw(), and Foam::HashTableOps::values().

Here is the call graph for this function:

◆ printTimeset() [3/3]

void printTimeset	(	OSstream &	os,
		const label	ts,
		const UList< scalar > &	times,
		const bitSet &	indices
	)

static

Print time-set for ensight case file, with N times, 0-based file numbering but perhaps non-contiguous.

* TIME
* time set: ts
* number of steps: ns
* filename numbers: idx_1 idx_2 ... idx_ns
* time values: time_1 time_2 ... time_ns
*

Definition at line 109 of file ensightCase.C.

References bitSet::all(), bitSet::count(), Foam::nl, os(), Foam::setf(), Foam::setw(), PackedList< Width >::size(), and Foam::HashTableOps::values().

Here is the call graph for this function:

◆ newData() [2/2]

Foam::autoPtr<Foam::ensightFile> newData	(	const word &	name,
		const bool	isPointData
	)		const

Definition at line 29 of file ensightCaseTemplates.C.

References Foam::name(), Foam::output(), and Ostream::write().

Here is the call graph for this function:

◆ newPointData() [2/2]

Foam::autoPtr<Foam::ensightFile> newPointData ( const word & name ) const

Definition at line 69 of file ensightCaseTemplates.C.

References Foam::name().

Here is the call graph for this function:

◆ newCloudData() [2/2]

Foam::autoPtr<Foam::ensightFile> newCloudData	(	const word &	cloudName,
		const word &	name
	)		const

Definition at line 80 of file ensightCaseTemplates.C.

References cloudName(), Foam::name(), Foam::output(), and Ostream::write().

Here is the call graph for this function:

Member Data Documentation

◆ dataDirName

const char * dataDirName = "data"

static

The name for data subdirectory: "data".

Definition at line 69 of file ensightCase.H.

◆ geometryName

const char * geometryName = "geometry"

static

The name for geometry files: "geometry".

Definition at line 81 of file ensightCase.H.

Referenced by ensightWriter::writeCollated().

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

src/fileFormats/ensight/file/ensightCase.H
src/fileFormats/ensight/file/ensightCase.C
src/fileFormats/ensight/file/ensightCaseI.H
src/fileFormats/ensight/file/ensightCaseTemplates.C

Classes

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ensightCase() [1/2]

◆ ensightCase() [2/2]

◆ ~ensightCase()

Member Function Documentation

◆ padded() [1/2]

◆ option()

◆ format()

◆ path()

◆ mask()

◆ padded() [2/2]

◆ nodeValues()

◆ separateCloud()

◆ nextTime() [1/2]

◆ nextTime() [2/2]

◆ setTime() [1/2]

◆ setTime() [2/2]

◆ newGeometry()

◆ newCloud()

◆ newData() [1/2]

◆ newPointData() [1/2]

◆ newCloudData() [1/2]

◆ rewind()

◆ write()

◆ operator()()

◆ printInfo()

◆ printTimeset() [1/3]

◆ printTimeset() [2/3]

◆ printTimeset() [3/3]

◆ newData() [2/2]

◆ newPointData() [2/2]

◆ newCloudData() [2/2]

Member Data Documentation

◆ dataDirName

◆ geometryName