#include <transport.h>

Inheritance diagram for ConvectionTransport:

Collaboration diagram for ConvectionTransport:

[legend]

Classes
class	EqData

Public Types
typedef ConcentrationTransportBase	FactoryBaseType

Public Member Functions
	ConvectionTransport (Mesh &init_mesh, const Input::Record in_rec)

virtual	~ConvectionTransport ()

void	initialize () override

void	zero_time_step () override

bool	evaluate_time_constraint (double &time_constraint) override

void	update_solution () override

void	calculate_concentration_matrix () override
	Calculate the array of concentrations per element (for reactions). More...

void	update_after_reactions (bool) override
	Not used in this class. More...

void	set_target_time (double target_time) override

void	set_balance_object (std::shared_ptr< Balance > balance) override

const vector< unsigned int > &	get_subst_idx () override
	Return substance indices used in balance. More...

virtual void	output_data () override
	Write computed fields. More...

void	set_velocity_field (std::shared_ptr< FieldFE< 3, FieldValue< 3 >::VectorFixed >> flux_field) override
	Pass velocity from flow to transport. More...

void	set_output_stream (std::shared_ptr< OutputTime > stream) override
	Setter for output stream. More...

std::shared_ptr< OutputTime >	output_stream () override

double **	get_concentration_matrix () override
	Getter for array of concentrations per element. More...

const Vec &	get_solution (unsigned int sbi) override
	Return PETSc vector with solution for sbi-th substance. More...

void	get_par_info (LongIdx &el_4_loc, Distribution &el_ds) override
	Return array of indices of local elements and parallel distribution of elements. More...

LongIdx *	get_row_4_el () override
	Return global array of order of elements within parallel vector. More...

unsigned int	n_substances () override
	Returns number of transported substances. More...

SubstanceList &	substances () override
	Returns reference to the vector of substance names. More...

Public Member Functions inherited from ConcentrationTransportBase
	ConcentrationTransportBase (Mesh &init_mesh, const Input::Record in_rec)

Public Member Functions inherited from EquationBase
	EquationBase ()

	EquationBase (Mesh &mesh, const Input::Record in_rec)

virtual	~EquationBase ()

virtual void	choose_next_time ()

virtual void	set_time_upper_constraint (double dt, std::string message)

virtual void	set_time_lower_constraint (double dt, std::string message)

TimeGovernor &	time ()

virtual void	set_time_governor (TimeGovernor &time)

double	planned_time ()

double	solved_time ()

Mesh &	mesh ()

std::shared_ptr< Balance >	balance () const

TimeMark::Type	mark_type ()

FieldSet &	data ()

Static Public Member Functions
static const Input::Type::Record &	get_input_type ()

static const IT::Selection &	get_output_selection ()

Static Public Member Functions inherited from ConcentrationTransportBase
static Input::Type::Abstract &	get_input_type ()
	Common specification of the input record for secondary equations. More...

Static Public Member Functions inherited from EquationBase
static Input::Type::Record &	record_template ()
	Template Record with common keys for derived equations. More...

Private Member Functions
void	create_transport_matrix_mpi ()

void	create_mass_matrix ()

void	make_transport_partitioning ()

void	set_initial_condition ()

void	read_concentration_sources ()

void	set_boundary_conditions ()

void	compute_concentration_sources ()
	Assembles concentration sources for each substance. note: the source of concentration is multiplied by time interval (gives the mass, not the flow like before) More...

void	transport_matrix_step_mpi (double time_step)

void	alloc_transport_vectors ()

void	alloc_transport_structs_mpi ()

double	side_flux (const DHCellSide &cell_side)
	Wrapper of following method, call side_flux with correct template parameter. More...

template<unsigned int dim>
double	calculate_side_flux (const DHCellSide &cell)
	Calculate flux on side of given element specified by dimension. More...

Private Attributes
EqData	data_

double **	sources_corr

Vec *	v_sources_corr

TimeMark::Type	target_mark_type
	TimeMark type for time marks denoting end of every time interval where transport matrix remains constant. More...

double	cfl_max_step
	Time step constraint coming from CFL condition. More...

Vec	vcfl_flow_
	Parallel vector for flow contribution to CFL condition. More...

Vec	vcfl_source_
	Parallel vector for source term contribution to CFL condition. More...

double *	cfl_flow_

double *	cfl_source_

VecScatter	vconc_out_scatter

Mat	tm

Vec	mass_diag

Vec	vpmass_diag

Vec *	v_tm_diag

double **	tm_diag

double	transport_matrix_time

double	transport_bc_time
	Time of the last update of the boundary condition terms. More...

Vec *	vconc
	Concentration vectors for mobile phase. More...

double **	conc
	Concentrations for phase, substance, element. More...

Vec *	vpconc

Vec *	bcvcorr

Vec *	vcumulative_corr

double **	cumulative_corr

std::vector< VectorMPI >	out_conc

std::vector< std::shared_ptr< FieldFE< 3, FieldValue< 3 >::Scalar > > >	output_field_ptr
	Fields correspond with `out_conc`. More...

const Input::Record	input_rec
	Record with input specification. More...

std::shared_ptr< OutputTime >	output_stream_

LongIdx *	row_4_el

LongIdx *	el_4_loc

Distribution *	el_ds

SubstanceList	substances_
	Transported substances. More...

std::shared_ptr< DOFHandlerMultiDim >	dh_

vector< unsigned int >	subst_idx
	List of indices used to call balance methods for a set of quantities. More...

std::shared_ptr< FieldFE< 3, FieldValue< 3 >::VectorFixed > >	velocity_field_ptr_
	Pointer to velocity field given from Flow equation. More...

bool	changed_
	Indicator of change in velocity field. More...

FETransportObjects	feo_
	Finite element objects. More...


bool	is_convection_matrix_scaled

bool	is_src_term_scaled

bool	is_bc_term_scaled

bool	is_mass_diag_changed
	Flag indicates that porosity or cross_section changed during last time. More...

Static Private Attributes
static const int	registrar
	Registrar of class to factory. More...

Friends
class	TransportOperatorSplitting

Additional Inherited Members
Protected Attributes inherited from EquationBase
bool	equation_empty_
	flag is true if only default constructor was called More...

Mesh *	mesh_

TimeGovernor *	time_

Input::Record	input_record_

FieldSet *	eq_data_

std::shared_ptr< Balance >	balance_
	object for calculation and writing the mass balance to file. More...

Detailed Description

Class that implements explicit finite volumes scheme with upwind. The timestep is given by CFL condition.

Definition at line 118 of file transport.h.

Member Typedef Documentation

typedef ConcentrationTransportBase ConvectionTransport::FactoryBaseType

Definition at line 149 of file transport.h.

Constructor & Destructor Documentation

ConvectionTransport::ConvectionTransport	(	Mesh &	init_mesh,
		const Input::Record	in_rec
	)

Constructor.

Definition at line 158 of file transport.cc.

ConvectionTransport::~ConvectionTransport ( )

virtual

TODO: destructor

Definition at line 254 of file transport.cc.

Member Function Documentation

void ConvectionTransport::alloc_transport_structs_mpi ( )

private

Definition at line 346 of file transport.cc.

Here is the caller graph for this function:

void ConvectionTransport::alloc_transport_vectors ( )

private

Definition at line 315 of file transport.cc.

Here is the caller graph for this function:

void ConvectionTransport::calculate_concentration_matrix ( )

inlineoverridevirtual

Calculate the array of concentrations per element (for reactions).

Implements ConcentrationTransportBase.

Definition at line 182 of file transport.h.

template<unsigned int dim>

double ConvectionTransport::calculate_side_flux ( const DHCellSide & cell )

private

Calculate flux on side of given element specified by dimension.

Definition at line 898 of file transport.cc.

void ConvectionTransport::compute_concentration_sources ( )

private

Assembles concentration sources for each substance. note: the source of concentration is multiplied by time interval (gives the mass, not the flow like before)

Definition at line 458 of file transport.cc.

Here is the caller graph for this function:

void ConvectionTransport::create_mass_matrix ( )

private

Definition at line 733 of file transport.cc.

Here is the caller graph for this function:

void ConvectionTransport::create_transport_matrix_mpi ( )

private

Assembly convection term part of the matrix and boundary matrix for application of boundary conditions.

Discretization of the convection term use explicit time scheme and finite volumes with full upwinding. We count on with exchange between dimensions and mixing on edges where more then two elements connect (can happen for 2D and 1D elements in 3D embedding space)

In order to get multiplication matrix for explicit transport one have to scale the convection part by the acctual time step and add time term, i. e. unit matrix (see. transport_matrix_step_mpi)

Updates CFL time step constrain.

Definition at line 769 of file transport.cc.

Here is the caller graph for this function:

bool ConvectionTransport::evaluate_time_constraint ( double & time_constraint )

overridevirtual

Evaluates CFL condition. Assembles the transport matrix and vector (including sources, bc terms).

Parameters

time_constraint is the value CFL constraint (return parameter)

Returns: true if CFL is changed since previous step, false otherwise

Implements ConcentrationTransportBase.

Definition at line 542 of file transport.cc.

double ** ConvectionTransport::get_concentration_matrix ( )

overridevirtual

Getter for array of concentrations per element.

Implements ConcentrationTransportBase.

Definition at line 852 of file transport.cc.

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

static

Definition at line 73 of file transport.cc.

static const IT::Selection& ConvectionTransport::get_output_selection ( )

static

void ConvectionTransport::get_par_info	(	LongIdx *&	el_4_loc,
		Distribution *&	el_ds
	)

overridevirtual

Return array of indices of local elements and parallel distribution of elements.

Implements ConcentrationTransportBase.

Definition at line 856 of file transport.cc.

LongIdx * ConvectionTransport::get_row_4_el ( )

overridevirtual

Return global array of order of elements within parallel vector.

Implements ConcentrationTransportBase.

Definition at line 866 of file transport.cc.

const Vec& ConvectionTransport::get_solution ( unsigned int sbi )

inlineoverridevirtual

Return PETSc vector with solution for sbi-th substance.

Implements ConcentrationTransportBase.

Definition at line 233 of file transport.h.

const vector<unsigned int>& ConvectionTransport::get_subst_idx ( )

inlineoverridevirtual

Return substance indices used in balance.

Implements ConcentrationTransportBase.

Definition at line 210 of file transport.h.

void ConvectionTransport::initialize ( )

overridevirtual

This method should initialize fields of the equation. All members (e.g. number of components) that are necessary for the field initialization must be set between construction and call of initialize. After this method the upper level coupling may set sharing of some fields between equations.

Reimplemented from EquationBase.

Definition at line 182 of file transport.cc.

void ConvectionTransport::make_transport_partitioning ( )

private

Definition at line 227 of file transport.cc.

Here is the caller graph for this function:

unsigned int ConvectionTransport::n_substances ( )

inlineoverridevirtual

Returns number of transported substances.

Implements ConcentrationTransportBase.

Definition at line 241 of file transport.h.

Here is the caller graph for this function:

void ConvectionTransport::output_data ( void )

overridevirtual

Write computed fields.

Reimplemented from EquationBase.

Definition at line 872 of file transport.cc.

Here is the caller graph for this function:

std::shared_ptr<OutputTime> ConvectionTransport::output_stream ( )

inlineoverridevirtual

Getters.

Implements ConcentrationTransportBase.

Definition at line 228 of file transport.h.

void ConvectionTransport::read_concentration_sources ( )

private

void ConvectionTransport::set_balance_object ( std::shared_ptr< Balance > balance )

overridevirtual

Use Balance object from upstream equation (e.g. in various couplings) instead of own instance.

Implements ConcentrationTransportBase.

Definition at line 884 of file transport.cc.

void ConvectionTransport::set_boundary_conditions ( )

private

Definition at line 395 of file transport.cc.

Here is the caller graph for this function:

void ConvectionTransport::set_initial_condition ( )

private

Definition at line 301 of file transport.cc.

Here is the caller graph for this function:

void ConvectionTransport::set_output_stream ( std::shared_ptr< OutputTime > stream )

inlineoverridevirtual

Setter for output stream.

Implements ConcentrationTransportBase.

Definition at line 221 of file transport.h.

void ConvectionTransport::set_target_time ( double target_time )

overridevirtual

Set time interval which is considered as one time step by TransportOperatorSplitting. In particular the velocity field doesn't change over this interval.

Dependencies:

velocity, porosity -> matrix, source_vector matrix -> time_step

data_read_times -> time_step (not necessary if we won't stick to jump times) data -> source_vector time_step -> scaling

Implements ConcentrationTransportBase.

Definition at line 710 of file transport.cc.

void ConvectionTransport::set_velocity_field ( std::shared_ptr< FieldFE< 3, FieldValue< 3 >::VectorFixed >> flux_field )

inlineoverridevirtual

Pass velocity from flow to transport.

Implements ConcentrationTransportBase.

Definition at line 218 of file transport.h.

double ConvectionTransport::side_flux ( const DHCellSide & cell_side )

private

Wrapper of following method, call side_flux with correct template parameter.

Definition at line 890 of file transport.cc.

Here is the caller graph for this function:

SubstanceList& ConvectionTransport::substances ( )

inlineoverridevirtual

Returns reference to the vector of substance names.

Implements ConcentrationTransportBase.

Definition at line 245 of file transport.h.

void ConvectionTransport::transport_matrix_step_mpi ( double time_step )

private

Finish explicit transport matrix (time step scaling)

void ConvectionTransport::update_after_reactions ( bool )

inlineoverridevirtual

Not used in this class.

Implements ConcentrationTransportBase.

Definition at line 185 of file transport.h.

void ConvectionTransport::update_solution ( void )

overridevirtual

Calculates one time step of explicit transport.

Reimplemented from EquationBase.

Definition at line 608 of file transport.cc.

void ConvectionTransport::zero_time_step ( )

overridevirtual

Initialize solution at zero time.

Reimplemented from EquationBase.

Definition at line 517 of file transport.cc.

Friends And Related Function Documentation

friend class TransportOperatorSplitting

friend

Definition at line 391 of file transport.h.

Member Data Documentation

Vec* ConvectionTransport::bcvcorr

private

Definition at line 348 of file transport.h.

double* ConvectionTransport::cfl_flow_

private

Definition at line 325 of file transport.h.

double ConvectionTransport::cfl_max_step

private

Time step constraint coming from CFL condition.

Definition at line 321 of file transport.h.

double * ConvectionTransport::cfl_source_

private

Definition at line 325 of file transport.h.

bool ConvectionTransport::changed_

private

Indicator of change in velocity field.

Definition at line 386 of file transport.h.

double** ConvectionTransport::conc

private

Concentrations for phase, substance, element.

Definition at line 344 of file transport.h.

double** ConvectionTransport::cumulative_corr

private

Definition at line 350 of file transport.h.

EqData ConvectionTransport::data_

private

Parameters of the equation, some are shared with other implementations since EqData is derived from TransportBase::TransportEqData

Definition at line 302 of file transport.h.

std::shared_ptr<DOFHandlerMultiDim> ConvectionTransport::dh_

private

Temporary solution how to pass velocity field form the flow model. TODO: introduce FieldDiscrete -containing true DOFHandler and data vector and pass such object together with other data. Possibly make more general set_data method, allowing setting data given by name. needs support from EqDataBase.

Definition at line 377 of file transport.h.

LongIdx* ConvectionTransport::el_4_loc

private

Definition at line 366 of file transport.h.

Distribution* ConvectionTransport::el_ds

private

Definition at line 367 of file transport.h.

FETransportObjects ConvectionTransport::feo_

private

Finite element objects.

Definition at line 389 of file transport.h.

const Input::Record ConvectionTransport::input_rec

private

Record with input specification.

Definition at line 360 of file transport.h.

bool ConvectionTransport::is_bc_term_scaled

private

Definition at line 310 of file transport.h.

bool ConvectionTransport::is_convection_matrix_scaled

private

Flag indicates the state of object (transport matrix or source or boundary term). If false, the object is freshly assembled and not rescaled. If true, the object is scaled (not necessarily with the current time step).

Definition at line 310 of file transport.h.

bool ConvectionTransport::is_mass_diag_changed

private

Flag indicates that porosity or cross_section changed during last time.

Definition at line 313 of file transport.h.

bool ConvectionTransport::is_src_term_scaled

private

Definition at line 310 of file transport.h.

Vec ConvectionTransport::mass_diag

private

Definition at line 330 of file transport.h.

std::vector<VectorMPI> ConvectionTransport::out_conc

private

Definition at line 352 of file transport.h.

std::vector< std::shared_ptr<FieldFE<3, FieldValue<3>::Scalar> > > ConvectionTransport::output_field_ptr

private

Fields correspond with out_conc.

Definition at line 357 of file transport.h.

std::shared_ptr<OutputTime> ConvectionTransport::output_stream_

private

Definition at line 362 of file transport.h.

const int ConvectionTransport::registrar

staticprivate

Initial value:

=
        Input::register_class< ConvectionTransport, Mesh &, const Input::Record >(_equation_name) +
        ConvectionTransport::get_input_type().size()

Registrar of class to factory.

Definition at line 297 of file transport.h.

LongIdx* ConvectionTransport::row_4_el

private

Definition at line 365 of file transport.h.

double** ConvectionTransport::sources_corr

private

Definition at line 316 of file transport.h.

vector<unsigned int> ConvectionTransport::subst_idx

private

List of indices used to call balance methods for a set of quantities.

Definition at line 380 of file transport.h.

SubstanceList ConvectionTransport::substances_

private

Transported substances.

Definition at line 370 of file transport.h.

TimeMark::Type ConvectionTransport::target_mark_type

private

TimeMark type for time marks denoting end of every time interval where transport matrix remains constant.

Definition at line 320 of file transport.h.

Mat ConvectionTransport::tm

private

Definition at line 329 of file transport.h.

double** ConvectionTransport::tm_diag

private

Definition at line 333 of file transport.h.

double ConvectionTransport::transport_bc_time

private

Time of the last update of the boundary condition terms.

Definition at line 339 of file transport.h.

double ConvectionTransport::transport_matrix_time

private

Time when the transport matrix was created. TODO: when we have our own classes for LA objects, we can use lazy dependence to check necessity for matrix update

Definition at line 338 of file transport.h.

Vec* ConvectionTransport::v_sources_corr

private

Definition at line 317 of file transport.h.

Vec* ConvectionTransport::v_tm_diag

private

Definition at line 332 of file transport.h.

Vec ConvectionTransport::vcfl_flow_

private

Parallel vector for flow contribution to CFL condition.

Definition at line 323 of file transport.h.

Vec ConvectionTransport::vcfl_source_

private

Parallel vector for source term contribution to CFL condition.

Definition at line 323 of file transport.h.

Vec* ConvectionTransport::vconc

private

Concentration vectors for mobile phase.

Definition at line 342 of file transport.h.

VecScatter ConvectionTransport::vconc_out_scatter

private

Definition at line 328 of file transport.h.

Vec* ConvectionTransport::vcumulative_corr

private

Definition at line 349 of file transport.h.

std::shared_ptr<FieldFE<3, FieldValue<3>::VectorFixed> > ConvectionTransport::velocity_field_ptr_

private

Pointer to velocity field given from Flow equation.

Definition at line 383 of file transport.h.

Vec* ConvectionTransport::vpconc

private

Definition at line 347 of file transport.h.

Vec ConvectionTransport::vpmass_diag

private

Definition at line 331 of file transport.h.

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

/opt/flow123d/flow123d/src/transport/transport.h
/opt/flow123d/flow123d/src/transport/transport.cc

Classes

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation