The class for outputting data during time. More...

#include <output_time.hh>

Inheritance diagram for OutputTime:

Collaboration diagram for OutputTime:

[legend]

Public Types
enum	DiscreteSpace { NODE_DATA = 0, CORNER_DATA = 1, ELEM_DATA = 2, NATIVE_DATA = 3, MESH_DEFINITION = 9, UNDEFINED = 10 }

typedef unsigned int	DiscreteSpaceFlags

typedef std::shared_ptr< ElementDataCacheBase >	OutputDataPtr

typedef std::vector< OutputDataPtr >	OutputDataFieldVec

typedef std::pair< std::string, unsigned int >	FieldInterpolationData
	pair of field name and shape (= Scalar 1, Vector 3, Tensor 9) More...

typedef std::map< DiscreteSpace, std::vector< FieldInterpolationData > >	InterpolationMap

Public Member Functions
	OutputTime ()
	Default constructor. Only for testing. More...

virtual void	init_from_input (const std::string &equation_name, const Input::Record &in_rec)
	Constructor of OutputTime object. It opens base file for writing. More...

void	set_stream_precision (std::ofstream &stream)

virtual	~OutputTime ()
	Destructor of OutputTime. It doesn't do anything, because all necessary destructors will be called in destructor of Output. More...

Input::Iterator< Input::Array >	get_time_set_array ()

Input::Iterator< Input::Record >	get_output_mesh_record ()

void	write_time_frame ()

std::shared_ptr< Observe >	observe (Mesh *mesh)

void	clear_data (void)
	Clear data for output computed by method `compute_field_data`. More...

bool	is_output_data_caches_init ()

bool	enable_refinement ()
	Return auxiliary flag enable_refinement_. More...

virtual void	set_output_data_caches (std::shared_ptr< OutputMeshBase > mesh_ptr)

std::shared_ptr< OutputMeshBase >	get_output_mesh_ptr ()

void	update_time (double field_time)

template<typename T >
ElementDataCache< T > &	prepare_compute_data (std::string field_name, DiscreteSpace space_type, unsigned int n_rows, unsigned int n_cols)

void	get_output_params (bool &parallel, int &rank)

virtual void	add_dummy_fields ()
	Complete information about dummy fields, method has effect only for GMSH output. More...

Static Public Member Functions
static const Input::Type::Record &	get_input_type ()
	The specification of output stream. More...

static Input::Type::Abstract &	get_input_format_type ()
	The specification of output file format. More...

static std::shared_ptr< OutputTime >	create_output_stream (const std::string &equation_name, const Input::Record &in_rec)
	This method delete all object instances of class OutputTime stored in output_streams vector. More...

Static Public Attributes
static const unsigned int	N_DISCRETE_SPACES = 4

Protected Member Functions
void	fix_main_file_extension (std::string extension)

int	get_parallel_current_step ()
	Return unique value current step for parallel or serial output. More...

virtual int	write_data (void)=0
	Virtual method for writing data to output file. More...

Protected Attributes
int	rank

int	n_proc

OutputDataFieldVec	output_data_vec_ [N_DISCRETE_SPACES]

int	current_step

double	time

double	write_time

Input::Record	input_record_

ofstream	_base_file

FilePath	_base_filename

std::string	equation_name_

int	precision_

std::shared_ptr< OutputMeshBase >	output_mesh_
	Output mesh. More...

std::shared_ptr< Observe >	observe_

bool	enable_refinement_
	Auxiliary flag for refinement enabling, due to gmsh format. More...

bool	parallel_
	Parallel or serial version of file format (parallel has effect only for VTK) More...

std::shared_ptr< ElementDataCache< double > >	nodes_
	Vector of node coordinates. [spacedim x n_nodes]. More...

std::shared_ptr< ElementDataCache< unsigned int > >	connectivity_
	Vector maps the nodes to their coordinates in vector `nodes_`. More...

std::shared_ptr< ElementDataCache< unsigned int > >	offsets_
	Vector of offsets of node indices of elements. Maps elements to their nodes in connectivity_. More...

Detailed Description

The class for outputting data during time.

This class is descendant of Output class. This class is used for outputting data varying in time. Own output to specific file formats is done at other places to. See output_vtk.cc and output_msh.cc.

Definition at line 44 of file output_time.hh.

Member Typedef Documentation

typedef unsigned int OutputTime::DiscreteSpaceFlags

Maps names of output fields required by user to their indices in output_data_vec_.

Definition at line 111 of file output_time.hh.

typedef std::pair< std::string, unsigned int > OutputTime::FieldInterpolationData

pair of field name and shape (= Scalar 1, Vector 3, Tensor 9)

Definition at line 120 of file output_time.hh.

typedef std::map< DiscreteSpace, std::vector<FieldInterpolationData> > OutputTime::InterpolationMap

Definition at line 121 of file output_time.hh.

typedef std::vector< OutputDataPtr > OutputTime::OutputDataFieldVec

Definition at line 117 of file output_time.hh.

typedef std::shared_ptr<ElementDataCacheBase> OutputTime::OutputDataPtr

Map field name to its OutputData object.

Definition at line 116 of file output_time.hh.

Member Enumeration Documentation

enum OutputTime::DiscreteSpace

Enumerator
NODE_DATA
CORNER_DATA
ELEM_DATA
NATIVE_DATA
MESH_DEFINITION
UNDEFINED

Definition at line 98 of file output_time.hh.

Constructor & Destructor Documentation

OutputTime::OutputTime ( )

Default constructor. Only for testing.

Definition at line 71 of file output_time.cc.

OutputTime::~OutputTime ( void )

virtual

Destructor of OutputTime. It doesn't do anything, because all necessary destructors will be called in destructor of Output.

Definition at line 105 of file output_time.cc.

Member Function Documentation

void OutputTime::add_dummy_fields ( )

virtual

Complete information about dummy fields, method has effect only for GMSH output.

Reimplemented in OutputMSH.

Definition at line 253 of file output_time.cc.

Here is the caller graph for this function:

void OutputTime::clear_data ( void )

Clear data for output computed by method compute_field_data.

Definition at line 240 of file output_time.cc.

Here is the caller graph for this function:

std::shared_ptr< OutputTime > OutputTime::create_output_stream	(	const std::string &	equation_name,
		const Input::Record &	in_rec
	)

static

This method delete all object instances of class OutputTime stored in output_streams vector.

This method tries to create new instance of OutputTime according record in configuration file.

Definition at line 183 of file output_time.cc.

Here is the caller graph for this function:

bool OutputTime::enable_refinement ( )

inline

Return auxiliary flag enable_refinement_.

Definition at line 158 of file output_time.hh.

void OutputTime::fix_main_file_extension ( std::string extension )

protected

Change main filename to have prescribed extension.

Definition at line 149 of file output_time.cc.

Here is the caller graph for this function:

IT::Abstract & OutputTime::get_input_format_type ( )

static

The specification of output file format.

Definition at line 64 of file output_time.cc.

Here is the caller graph for this function:

const IT::Record & OutputTime::get_input_type ( )

static

The specification of output stream.

Returns: This variable defines record for output stream

Definition at line 37 of file output_time.cc.

Here is the caller graph for this function:

std::shared_ptr< OutputMeshBase > OutputTime::get_output_mesh_ptr ( )

Get shared pointer of output_mesh_.

Definition at line 137 of file output_time.cc.

Here is the caller graph for this function:

Input::Iterator< Input::Record > OutputTime::get_output_mesh_record ( )

Return the input record for the output mesh of the output stream.

Definition at line 124 of file output_time.cc.

void OutputTime::get_output_params	(	bool &	parallel,
		int &	rank
	)

inline

Return base output parameters (rank and parallel) which determine if the output is performed

Definition at line 198 of file output_time.hh.

int OutputTime::get_parallel_current_step ( )

protected

Return unique value current step for parallel or serial output.

Respect value of parallel_ flag:

for serial output return actual value of current_step
for parallel output take unique value with account rank and number of processes

Definition at line 246 of file output_time.cc.

Here is the caller graph for this function:

Input::Iterator< Input::Array > OutputTime::get_time_set_array ( )

Return the input array for the output time set of the output stream.

Definition at line 119 of file output_time.cc.

void OutputTime::init_from_input	(	const std::string &	equation_name,
		const Input::Record &	in_rec
	)

virtual

Constructor of OutputTime object. It opens base file for writing.

Parameters

[in]	equation_name	The name of equation, used for forming output file name.
[in]	in_rec	The reference on the input record

Reimplemented in OutputVTK.

Definition at line 83 of file output_time.cc.

Here is the caller graph for this function:

bool OutputTime::is_output_data_caches_init ( )

inline

Return if shared pointer to output data caches are created.

Definition at line 153 of file output_time.hh.

std::shared_ptr< Observe > OutputTime::observe ( Mesh * mesh )

Getter of the observe object.

Definition at line 228 of file output_time.cc.

template<typename T >

ElementDataCache< T > & OutputTime::prepare_compute_data	(	std::string	field_name,
		DiscreteSpace	space_type,
		unsigned int	n_rows,
		unsigned int	n_cols
	)

Prepare data for computing field values.

Method:

compute discontinuous mesh if CORNER_DATA is calculated
find and return ElementDataCache of given field_name, create its if doesn't exist

Parameters

field_name	Quantity name of founding ElementDataCache
space_type	Output discrete space
n_rows	Count of rows of data cache (used only if new cache is created)
n_cols	Count of columns of data cache (used only if new cache is created)
size	Size of data cache (used only if new cache is created and only for native data)

Definition at line 78 of file output_time.impl.hh.

Here is the caller graph for this function:

void OutputTime::set_output_data_caches ( std::shared_ptr< OutputMeshBase > mesh_ptr )

virtual

Set shared pointers of output data caches.

Set shared pointer of output_mesh_ (temporary solution).

Reimplemented in OutputMSH.

Definition at line 129 of file output_time.cc.

Here is the caller graph for this function:

void OutputTime::set_stream_precision ( std::ofstream & stream )

Common method to set scientific format and precision for output of floating point values to ASCII streams.

Definition at line 98 of file output_time.cc.

Here is the caller graph for this function:

void OutputTime::update_time ( double field_time )

Update the last time is actual time is less than field_time

Definition at line 142 of file output_time.cc.

Here is the caller graph for this function:

virtual int OutputTime::write_data ( void )

protectedpure virtual

Virtual method for writing data to output file.

Implemented in OutputVTK, and OutputMSH.

Here is the caller graph for this function:

void OutputTime::write_time_frame ( )

Write all data registered as a new time frame.

Definition at line 197 of file output_time.cc.

Member Data Documentation

ofstream OutputTime::_base_file

protected

Base output stream

Definition at line 269 of file output_time.hh.

FilePath OutputTime::_base_filename

protected

Name of base output file

Definition at line 274 of file output_time.hh.

std::shared_ptr<ElementDataCache<unsigned int> > OutputTime::connectivity_

protected

Vector maps the nodes to their coordinates in vector nodes_.

Definition at line 301 of file output_time.hh.

int OutputTime::current_step

protected

Current step

Definition at line 249 of file output_time.hh.

bool OutputTime::enable_refinement_

protected

Auxiliary flag for refinement enabling, due to gmsh format.

Definition at line 293 of file output_time.hh.

std::string OutputTime::equation_name_

protected

Name of the equation owning the output stream. Usually the balance equation. Used for forming default output file name and the name of observe output file.

Definition at line 280 of file output_time.hh.

Input::Record OutputTime::input_record_

protected

Record for current output stream

Definition at line 264 of file output_time.hh.

const unsigned int OutputTime::N_DISCRETE_SPACES = 4

static

Types of reference data

NATIVE_DATA represents output of FieldFE in our own format, Paraview ignores this format.

Definition at line 97 of file output_time.hh.

int OutputTime::n_proc

protected

Cached MPI number of processes (is tested in methods)

Definition at line 238 of file output_time.hh.

std::shared_ptr<ElementDataCache<double> > OutputTime::nodes_

protected

Vector of node coordinates. [spacedim x n_nodes].

Definition at line 299 of file output_time.hh.

std::shared_ptr<Observe> OutputTime::observe_

protected

Definition at line 290 of file output_time.hh.

std::shared_ptr<ElementDataCache<unsigned int> > OutputTime::offsets_

protected

Vector of offsets of node indices of elements. Maps elements to their nodes in connectivity_.

Definition at line 303 of file output_time.hh.

OutputDataFieldVec OutputTime::output_data_vec_[N_DISCRETE_SPACES]

protected

Registered output data. Single map for every value of DiscreteSpace corresponding to nodes, elements and corners.

Definition at line 244 of file output_time.hh.

std::shared_ptr<OutputMeshBase> OutputTime::output_mesh_

protected

Output mesh.

Definition at line 288 of file output_time.hh.

bool OutputTime::parallel_

protected

Parallel or serial version of file format (parallel has effect only for VTK)

Definition at line 296 of file output_time.hh.

int OutputTime::precision_

protected

Number of decimal digits used for output of double values.

Definition at line 285 of file output_time.hh.

int OutputTime::rank

protected

Cached MPI rank of process (is tested in methods)

Definition at line 233 of file output_time.hh.

double OutputTime::time

protected

The newest time of registered data

Definition at line 254 of file output_time.hh.

double OutputTime::write_time

protected

The last time, when data was wrote to this stream

Definition at line 259 of file output_time.hh.

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

/opt/flow123d/flow123d/src/io/output_time.hh
/opt/flow123d/flow123d/src/io/output_time.cc
/opt/flow123d/flow123d/src/io/output_time.impl.hh

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation