#include <transport.h>

Inheritance diagram for ConvectionTransport:

Collaboration diagram for ConvectionTransport:

[legend]

Classes
class	EqData

Public Types
typedef ConcentrationTransportBase	FactoryBaseType

Public Types inherited from ConcentrationTransportBase
typedef std::vector< std::shared_ptr< FieldFE< 3, FieldValue< 3 >::Scalar > > >	FieldFEScalarVec

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	compute_p0_interpolation () override

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_output_stream (std::shared_ptr< OutputTime > stream) override
	Setter for output stream. More...

FieldFEScalarVec &	get_p0_interpolation () override
	Getter for P0 interpolation by FieldFE. More...

Vec	get_component_vec (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 &	eq_fieldset ()

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	conc_sources_bdr_conditions ()
	Assembles concentration sources for each substance and set boundary conditions. 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_

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...

vector< VectorMPI >	corr_vec

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 *	vpconc

Vec *	bcvcorr

Vec *	vcumulative_corr

double **	cumulative_corr

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...

FETransportObjects	feo_
	Finite element objects. 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_fieldset_

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 119 of file transport.h.

Member Typedef Documentation

◆ FactoryBaseType

typedef ConcentrationTransportBase ConvectionTransport::FactoryBaseType

Definition at line 150 of file transport.h.

Constructor & Destructor Documentation

◆ ConvectionTransport()

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

Constructor.

Definition at line 158 of file transport.cc.

◆ ~ConvectionTransport()

ConvectionTransport::~ConvectionTransport ( )

virtual

TODO: destructor

Definition at line 256 of file transport.cc.

Member Function Documentation

◆ alloc_transport_structs_mpi()

void ConvectionTransport::alloc_transport_structs_mpi ( )

private

Definition at line 340 of file transport.cc.

Here is the caller graph for this function:

◆ alloc_transport_vectors()

void ConvectionTransport::alloc_transport_vectors ( )

private

Definition at line 319 of file transport.cc.

Here is the caller graph for this function:

◆ calculate_side_flux()

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 871 of file transport.cc.

◆ compute_p0_interpolation()

void ConvectionTransport::compute_p0_interpolation ( )

inlineoverridevirtual

Compute P0 interpolation of the solution (used reaction term). Empty - solution is already P0 interpolation.

Implements ConcentrationTransportBase.

Definition at line 186 of file transport.h.

◆ conc_sources_bdr_conditions()

void ConvectionTransport::conc_sources_bdr_conditions ( )

private

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

Definition at line 389 of file transport.cc.

Here is the caller graph for this function:

◆ create_mass_matrix()

void ConvectionTransport::create_mass_matrix ( )

private

Definition at line 706 of file transport.cc.

Here is the caller graph for this function:

◆ create_transport_matrix_mpi()

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 742 of file transport.cc.

Here is the caller graph for this function:

◆ evaluate_time_constraint()

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 517 of file transport.cc.

◆ get_component_vec()

Vec ConvectionTransport::get_component_vec ( unsigned int sbi )

overridevirtual

Return PETSc vector with solution for sbi-th substance.

Implements ConcentrationTransportBase.

Definition at line 220 of file transport.cc.

◆ get_input_type()

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

static

Definition at line 73 of file transport.cc.

◆ get_output_selection()

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

static

◆ get_p0_interpolation()

ConvectionTransport::FieldFEScalarVec & ConvectionTransport::get_p0_interpolation ( )

overridevirtual

Getter for P0 interpolation by FieldFE.

Getters.

Implements ConcentrationTransportBase.

Definition at line 825 of file transport.cc.

◆ get_par_info()

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 829 of file transport.cc.

◆ get_row_4_el()

LongIdx * ConvectionTransport::get_row_4_el ( )

overridevirtual

Return global array of order of elements within parallel vector.

Implements ConcentrationTransportBase.

Definition at line 839 of file transport.cc.

◆ get_subst_idx()

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

inlineoverridevirtual

Return substance indices used in balance.

Implements ConcentrationTransportBase.

Definition at line 214 of file transport.h.

◆ initialize()

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 181 of file transport.cc.

◆ make_transport_partitioning()

void ConvectionTransport::make_transport_partitioning ( )

private

Definition at line 229 of file transport.cc.

Here is the caller graph for this function:

◆ n_substances()

unsigned int ConvectionTransport::n_substances ( )

inlineoverridevirtual

Returns number of transported substances.

Implements ConcentrationTransportBase.

Definition at line 240 of file transport.h.

Here is the caller graph for this function:

◆ output_data()

void ConvectionTransport::output_data ( )

overridevirtual

Write computed fields.

Reimplemented from EquationBase.

Definition at line 845 of file transport.cc.

Here is the caller graph for this function:

◆ read_concentration_sources()

void ConvectionTransport::read_concentration_sources ( )

private

◆ set_balance_object()

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 857 of file transport.cc.

◆ set_initial_condition()

void ConvectionTransport::set_initial_condition ( )

private

Definition at line 298 of file transport.cc.

Here is the caller graph for this function:

◆ set_output_stream()

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

inlineoverridevirtual

Setter for output stream.

Implements ConcentrationTransportBase.

Definition at line 222 of file transport.h.

◆ set_target_time()

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 683 of file transport.cc.

◆ side_flux()

double ConvectionTransport::side_flux ( const DHCellSide & cell_side )

private

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

Definition at line 863 of file transport.cc.

Here is the caller graph for this function:

◆ substances()

SubstanceList& ConvectionTransport::substances ( )

inlineoverridevirtual

Returns reference to the vector of substance names.

Implements ConcentrationTransportBase.

Definition at line 244 of file transport.h.

◆ transport_matrix_step_mpi()

void ConvectionTransport::transport_matrix_step_mpi ( double time_step )

private

Finish explicit transport matrix (time step scaling)

◆ update_after_reactions()

void ConvectionTransport::update_after_reactions ( bool )

inlineoverridevirtual

Not used in this class.

Implements ConcentrationTransportBase.

Definition at line 189 of file transport.h.

◆ update_solution()

void ConvectionTransport::update_solution ( )

overridevirtual

Calculates one time step of explicit transport.

Reimplemented from EquationBase.

Definition at line 580 of file transport.cc.

◆ zero_time_step()

void ConvectionTransport::zero_time_step ( )

overridevirtual

Initialize solution at zero time.

Reimplemented from EquationBase.

Definition at line 493 of file transport.cc.

Friends And Related Function Documentation

◆ TransportOperatorSplitting

friend class TransportOperatorSplitting

friend

Definition at line 370 of file transport.h.

Member Data Documentation

◆ bcvcorr

Vec* ConvectionTransport::bcvcorr

private

Definition at line 340 of file transport.h.

◆ cfl_flow_

double* ConvectionTransport::cfl_flow_

private

Definition at line 322 of file transport.h.

◆ cfl_max_step

double ConvectionTransport::cfl_max_step

private

Time step constraint coming from CFL condition.

Definition at line 318 of file transport.h.

◆ cfl_source_

double * ConvectionTransport::cfl_source_

private

Definition at line 322 of file transport.h.

◆ corr_vec

vector<VectorMPI> ConvectionTransport::corr_vec

private

Definition at line 314 of file transport.h.

◆ cumulative_corr

double** ConvectionTransport::cumulative_corr

private

Definition at line 342 of file transport.h.

◆ data_

EqData ConvectionTransport::data_

private

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

Definition at line 300 of file transport.h.

◆ dh_

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 362 of file transport.h.

◆ el_4_loc

LongIdx* ConvectionTransport::el_4_loc

private

Definition at line 351 of file transport.h.

◆ el_ds

Distribution* ConvectionTransport::el_ds

private

Definition at line 352 of file transport.h.

◆ feo_

FETransportObjects ConvectionTransport::feo_

private

Finite element objects.

Definition at line 368 of file transport.h.

◆ input_rec

const Input::Record ConvectionTransport::input_rec

private

Record with input specification.

Definition at line 345 of file transport.h.

◆ is_bc_term_scaled

bool ConvectionTransport::is_bc_term_scaled

private

Definition at line 308 of file transport.h.

◆ is_convection_matrix_scaled

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 308 of file transport.h.

◆ is_mass_diag_changed

bool ConvectionTransport::is_mass_diag_changed

private

Flag indicates that porosity or cross_section changed during last time.

Definition at line 311 of file transport.h.

◆ is_src_term_scaled

bool ConvectionTransport::is_src_term_scaled

private

Definition at line 308 of file transport.h.

◆ mass_diag

Vec ConvectionTransport::mass_diag

private

Definition at line 327 of file transport.h.

◆ output_stream_

std::shared_ptr<OutputTime> ConvectionTransport::output_stream_

private

Definition at line 347 of file transport.h.

◆ registrar

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 295 of file transport.h.

◆ row_4_el

LongIdx* ConvectionTransport::row_4_el

private

Definition at line 350 of file transport.h.

◆ subst_idx

vector<unsigned int> ConvectionTransport::subst_idx

private

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

Definition at line 365 of file transport.h.

◆ substances_

SubstanceList ConvectionTransport::substances_

private

Transported substances.

Definition at line 355 of file transport.h.

◆ target_mark_type

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 317 of file transport.h.

◆ tm

Mat ConvectionTransport::tm

private

Definition at line 326 of file transport.h.

◆ tm_diag

double** ConvectionTransport::tm_diag

private

Definition at line 330 of file transport.h.

◆ transport_bc_time

double ConvectionTransport::transport_bc_time

private

Time of the last update of the boundary condition terms.

Definition at line 336 of file transport.h.

◆ transport_matrix_time

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 335 of file transport.h.

◆ v_tm_diag

Vec* ConvectionTransport::v_tm_diag

private

Definition at line 329 of file transport.h.

◆ vcfl_flow_

Vec ConvectionTransport::vcfl_flow_

private

Parallel vector for flow contribution to CFL condition.

Definition at line 320 of file transport.h.

◆ vcfl_source_

Vec ConvectionTransport::vcfl_source_

private

Parallel vector for source term contribution to CFL condition.

Definition at line 321 of file transport.h.

◆ vconc_out_scatter

VecScatter ConvectionTransport::vconc_out_scatter

private

Definition at line 325 of file transport.h.

◆ vcumulative_corr

Vec* ConvectionTransport::vcumulative_corr

private

Definition at line 341 of file transport.h.

◆ vpconc

Vec* ConvectionTransport::vpconc

private

Definition at line 339 of file transport.h.

◆ vpmass_diag

Vec ConvectionTransport::vpmass_diag

private

Definition at line 328 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

◆ FactoryBaseType

Constructor & Destructor Documentation

◆ ConvectionTransport()

◆ ~ConvectionTransport()

Member Function Documentation

◆ alloc_transport_structs_mpi()

◆ alloc_transport_vectors()

◆ calculate_side_flux()

◆ compute_p0_interpolation()

◆ conc_sources_bdr_conditions()

◆ create_mass_matrix()

◆ create_transport_matrix_mpi()

◆ evaluate_time_constraint()

◆ get_component_vec()

◆ get_input_type()

◆ get_output_selection()

◆ get_p0_interpolation()

◆ get_par_info()

◆ get_row_4_el()

◆ get_subst_idx()

◆ initialize()

◆ make_transport_partitioning()

◆ n_substances()

◆ output_data()

◆ read_concentration_sources()

◆ set_balance_object()

◆ set_initial_condition()

◆ set_output_stream()

◆ set_target_time()

◆ side_flux()

◆ substances()

◆ transport_matrix_step_mpi()

◆ update_after_reactions()

◆ update_solution()

◆ zero_time_step()

Friends And Related Function Documentation

◆ TransportOperatorSplitting

Member Data Documentation

◆ bcvcorr

◆ cfl_flow_

◆ cfl_max_step

◆ cfl_source_

◆ corr_vec

◆ cumulative_corr

◆ data_

◆ dh_

◆ el_4_loc

◆ el_ds

◆ feo_

◆ input_rec

◆ is_bc_term_scaled

◆ is_convection_matrix_scaled

◆ is_mass_diag_changed

◆ is_src_term_scaled

◆ mass_diag

◆ output_stream_

◆ registrar

◆ row_4_el

◆ subst_idx

◆ substances_

◆ target_mark_type

◆ tm

◆ tm_diag

◆ transport_bc_time

◆ transport_matrix_time

◆ v_tm_diag

◆ vcfl_flow_

◆ vcfl_source_

◆ vconc_out_scatter