Edge lumped mixed-hybrid solution of unsteady Darcy flow. More...

#include <richards_lmh.hh>

Inheritance diagram for RichardsLMH:

Collaboration diagram for RichardsLMH:

[legend]

Classes
class	EqData

class	EqFields

Public Member Functions
	RichardsLMH (Mesh &mesh, const Input::Record in_rec, TimeGovernor *tm=nullptr)

void	accept_time_step () override
	postprocess velocity field (add sources) More...

Public Member Functions inherited from DarcyLMH
	TYPEDEF_ERR_INFO (EI_Reason, string)

	DECLARE_EXCEPTION (ExcSolverDiverge,<< "Diverged nonlinear solver. Reason: "<< EI_Reason::val)

	DECLARE_INPUT_EXCEPTION (ExcMissingTimeGovernor,<< "Missing the key 'time', obligatory for the transient problems.")

	DarcyLMH (Mesh &mesh, const Input::Record in_rec, TimeGovernor *tm=nullptr)
	CREATE AND FILL GLOBAL MH MATRIX OF THE WATER MODEL. More...

void	init_eq_data ()

void	initialize () override

void	zero_time_step () override

void	update_solution () override

void	solve_time_step (bool output=true)
	Solve the problem without moving to next time and without output. More...

virtual void	postprocess ()

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

virtual double	solved_time () override

EqFields &	eq_fields ()

EqData &	eq_data ()

void	set_extra_storativity (const Field< 3, FieldValue< 3 >::Scalar > &extra_stor)
	Sets external storarivity field (coupling with other equation). More...

void	set_extra_source (const Field< 3, FieldValue< 3 >::Scalar > &extra_src)
	Sets external source field (coupling with other equation). More...

virtual	~DarcyLMH () override

Public Member Functions inherited from DarcyFlowInterface
	DECLARE_EXCEPTION (ExcBddcmlNotSupported,<< "Flow123d was not build with BDDCML support.\n")

	DECLARE_EXCEPTION (ExcUnknownSolver,<< "Unknown solver type. Internal error.\n")

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

virtual	~DarcyFlowInterface ()

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

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 Public Member Functions inherited from DarcyLMH
static const Input::Type::Selection &	get_mh_mortar_selection ()
	Selection for enum MortarMethod. More...

static const Input::Type::Record &	type_field_descriptor ()

static const Input::Type::Record &	get_input_type ()

Static Public Member Functions inherited from DarcyFlowInterface
static Input::Type::Abstract &	get_input_type ()

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

Protected Member Functions
bool	zero_time_term (bool time_global=false) override

void	initialize_specific () override

void	initial_condition_postprocess () override

void	assembly_linear_system () override

Protected Member Functions inherited from DarcyLMH
void	solve_nonlinear ()
	Solve method common to zero_time_step and update solution. More...

void	create_linear_system (Input::AbstractRecord rec)

void	read_initial_condition ()

void	allocate_mh_matrix ()

void	assembly_mh_matrix (MultidimAssembly &assembler)

void	reconstruct_solution_from_schur (MultidimAssembly &assembler)

virtual double	solution_precision () const

void	print_matlab_matrix (string matlab_file)
	Print darcy flow matrix in matlab format into a file. More...

std::vector< int >	get_component_indices_vec (unsigned int component) const
	Get vector of all DOF indices of given component (0..side, 1..element, 2..edge) More...

LinSys &	lin_sys_schur ()
	Getter for the linear system of the 2. Schur complement. More...

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

Private Attributes
std::shared_ptr< EqFields >	eq_fields_

std::shared_ptr< EqData >	eq_data_

Additional Inherited Members
Public Types inherited from DarcyFlowInterface
enum	MortarMethod { NoMortar = 0, MortarP0 = 1, MortarP1 = 2 }
	Type of experimental Mortar-like method for non-compatible 1d-2d interaction. More...

typedef DarcyFlowInterface	FactoryBaseType
	Typedef for usage of Input::Factory in child classes. More...

Protected Attributes inherited from DarcyLMH
std::shared_ptr< Balance >	balance_

DarcyFlowMHOutput *	output_object

int	size

bool	data_changed_

double	tolerance_

unsigned int	min_n_it_

unsigned int	max_n_it_

unsigned int	nonlinear_iteration_

std::shared_ptr< EqFields >	eq_fields_

std::shared_ptr< EqData >	eq_data_

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

Edge lumped mixed-hybrid solution of unsteady Darcy flow.

The time term and sources are evenly distributed form an element to its edges. This applies directly to the second Schur complement. After this system for pressure traces is solved we reconstruct pressures and side flows as follows:

Element pressure is average of edge pressure. This is in fact same as the MH for steady case so we let SchurComplement class do its job.
We let SchurComplement to reconstruct fluxes and then account time term and sources which are evenly distributed from an element to its sides. It can be proved, that this keeps continuity of the fluxes over the edges.

This lumping technique preserves discrete maximum principle for any time step provided one use acute mesh. But in practice even worse meshes are tractable.

Ideas how to unify steady and unsteady flow: zero_time_step:

Set initial time.
Read initial condition. Reconstruct pressures.
Assembly system (possibly in matrix free way).
Reconstruct velocities (schur complement resolve).
Solve iteratively as regular time step if an input flag "steady_initial_time" is set.
(Detect that there is no time term. I such case use arbitrary long time step up to next change of data. Some kind of time step estimator would be nice.

update solution:

Move to the next time.
Update fields
Nonlinear solve.
In case of slow convergence, use shorter time-step, within estimated limits. Otherwise there is a different problem.

Definition at line 62 of file richards_lmh.hh.

Constructor & Destructor Documentation

◆ RichardsLMH()

RichardsLMH::RichardsLMH	(	Mesh &	mesh,
		const Input::Record	in_rec,
		TimeGovernor *	tm = `nullptr`
	)

Definition at line 125 of file richards_lmh.cc.

Member Function Documentation

◆ accept_time_step()

void RichardsLMH::accept_time_step ( )

overridevirtual

postprocess velocity field (add sources)

Reimplemented from DarcyLMH.

Definition at line 179 of file richards_lmh.cc.

◆ assembly_linear_system()

void RichardsLMH::assembly_linear_system ( )

overrideprotectedvirtual

Assembly or update whole linear system.

Reimplemented from DarcyLMH.

Definition at line 203 of file richards_lmh.cc.

◆ get_input_type()

const it::Record & RichardsLMH::get_input_type ( )

static

Definition at line 83 of file richards_lmh.cc.

◆ initial_condition_postprocess()

void RichardsLMH::initial_condition_postprocess ( )

overrideprotectedvirtual

In some circumstances, the intial condition must be processed. It is called at the end of read_initial_condition(). This is used in Richards equation due the update of water content.

Reimplemented from DarcyLMH.

Definition at line 168 of file richards_lmh.cc.

◆ initialize_specific()

void RichardsLMH::initialize_specific ( )

overrideprotectedvirtual

Reimplemented from DarcyLMH.

Definition at line 137 of file richards_lmh.cc.

◆ zero_time_term()

bool RichardsLMH::zero_time_term ( bool time_global = false )

overrideprotectedvirtual

Returns true is the fields involved in the time term have values that makes the time term zero. For time_global==true, it returns true if there are no field descriptors in the input list, so the fields )of the time ter) have their default values for whole simulation. If time_global==false (default), only the actual values are considered.

Reimplemented from DarcyLMH.

Definition at line 189 of file richards_lmh.cc.

Member Data Documentation

◆ eq_data_

std::shared_ptr<EqData> RichardsLMH::eq_data_

private

Definition at line 117 of file richards_lmh.hh.

◆ eq_fields_

std::shared_ptr<EqFields> RichardsLMH::eq_fields_

private

Definition at line 116 of file richards_lmh.hh.

◆ registrar

const int RichardsLMH::registrar

staticprotected

Initial value:

=
        Input::register_class< RichardsLMH, Mesh &, const Input::Record >("Flow_Richards_LMH") +
        RichardsLMH::get_input_type().size()

Registrar of class to factory.

Definition at line 106 of file richards_lmh.hh.

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

/opt/flow123d/flow123d/src/flow/richards_lmh.hh
/opt/flow123d/flow123d/src/flow/richards_lmh.cc

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Attributes

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ RichardsLMH()

Member Function Documentation

◆ accept_time_step()

◆ assembly_linear_system()

◆ get_input_type()

◆ initial_condition_postprocess()

◆ initialize_specific()

◆ zero_time_term()

Member Data Documentation

◆ eq_data_

◆ eq_fields_

◆ registrar