Detailed Description

template<int DisplacementDim>
class ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >

Linear kinematics poro-mechanical/biphasic (fluid-solid mixture) model.

The mixture momentum balance and the mixture mass balance are solved under fully saturated conditions.

Definition at line 26 of file RichardsMechanicsProcess.h.

#include <RichardsMechanicsProcess.h>

Inheritance diagram for ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >:

[legend]

Collaboration diagram for ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >:

[legend]

Public Member Functions
	RichardsMechanicsProcess (std::string name, MeshLib::Mesh &mesh, std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&jacobian_assembler, std::vector< std::unique_ptr< ParameterLib::ParameterBase >> const &parameters, unsigned const integration_order, std::vector< std::vector< std::reference_wrapper< ProcessVariable >>> &&process_variables, RichardsMechanicsProcessData< DisplacementDim > &&process_data, SecondaryVariableCollection &&secondary_variables, bool const use_monolithic_scheme)

MathLib::MatrixSpecifications	getMatrixSpecifications (const int process_id) const override

ODESystem interface
bool	isLinear () const override

Public Member Functions inherited from ProcessLib::Process
	Process (std::string name_, MeshLib::Mesh &mesh, std::unique_ptr< AbstractJacobianAssembler > &&jacobian_assembler, std::vector< std::unique_ptr< ParameterLib::ParameterBase >> const &parameters, unsigned const integration_order, std::vector< std::vector< std::reference_wrapper< ProcessVariable >>> &&process_variables, SecondaryVariableCollection &&secondary_variables, const bool use_monolithic_scheme=true)

void	preTimestep (std::vector< GlobalVector * > const &x, const double t, const double delta_t, const int process_id)
	Preprocessing before starting assembly for new timestep. More...

void	postTimestep (std::vector< GlobalVector * > const &x, const double t, const double delta_t, int const process_id)
	Postprocessing after a complete timestep. More...

void	postNonLinearSolver (GlobalVector const &x, GlobalVector const &xdot, const double t, double const dt, int const process_id)

void	preIteration (const unsigned iter, GlobalVector const &x) final

void	computeSecondaryVariable (double const t, double const dt, std::vector< GlobalVector * > const &x, GlobalVector const &x_dot, int const process_id)
	compute secondary variables for the coupled equations or for output. More...

NumLib::IterationResult	postIteration (GlobalVector const &x) final

void	initialize ()

void	setInitialConditions (std::vector< GlobalVector * > &process_solutions, std::vector< GlobalVector * > const &process_solutions_prev, double const t, int const process_id)

MathLib::MatrixSpecifications	getMatrixSpecifications (const int process_id) const override

void	setCoupledSolutionsForStaggeredScheme (CoupledSolutionsForStaggeredScheme *const coupled_solutions)

void	updateDeactivatedSubdomains (double const time, const int process_id)

bool	isMonolithicSchemeUsed () const

virtual void	setCoupledTermForTheStaggeredSchemeToLocalAssemblers (int const)

virtual void	extrapolateIntegrationPointValuesToNodes (const double, std::vector< GlobalVector * > const &, std::vector< GlobalVector * > &)

void	preAssemble (const double t, double const dt, GlobalVector const &x) final

void	assemble (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &xdot, int const process_id, GlobalMatrix &M, GlobalMatrix &K, GlobalVector &b) final

void	assembleWithJacobian (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &xdot, const double dxdot_dx, const double dx_dx, int const process_id, GlobalMatrix &M, GlobalMatrix &K, GlobalVector &b, GlobalMatrix &Jac) final

std::vector< NumLib::IndexValueVector< GlobalIndexType > > const *	getKnownSolutions (double const t, GlobalVector const &x, int const process_id) const final

MeshLib::Mesh &	getMesh () const

std::vector< std::reference_wrapper< ProcessVariable > > const &	getProcessVariables (const int process_id) const

SecondaryVariableCollection const &	getSecondaryVariables () const

std::vector< std::unique_ptr< IntegrationPointWriter > > const *	getIntegrationPointWriter (MeshLib::Mesh const &mesh) const

virtual Eigen::Vector3d	getFlux (std::size_t, MathLib::Point3d const &, double const, std::vector< GlobalVector * > const &) const

virtual void	solveReactionEquation (std::vector< GlobalVector * > &, std::vector< GlobalVector * > const &, double const, double const, NumLib::EquationSystem &, int const)

Private Types
using	LocalAssemblerIF = LocalAssemblerInterface< DisplacementDim >

Private Member Functions
void	constructDofTable () override

void	initializeConcreteProcess (NumLib::LocalToGlobalIndexMap const &dof_table, MeshLib::Mesh const &mesh, unsigned const integration_order) override
	Process specific initialization called by initialize(). More...

void	initializeBoundaryConditions () override

void	setInitialConditionsConcreteProcess (std::vector< GlobalVector * > &x, double const t, int const process_id) override

void	assembleConcreteProcess (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &xdot, int const process_id, GlobalMatrix &M, GlobalMatrix &K, GlobalVector &b) override

void	assembleWithJacobianConcreteProcess (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &xdot, const double dxdot_dx, const double dx_dx, int const process_id, GlobalMatrix &M, GlobalMatrix &K, GlobalVector &b, GlobalMatrix &Jac) override

void	postTimestepConcreteProcess (std::vector< GlobalVector * > const &x, double const t, double const dt, const int process_id) override

NumLib::LocalToGlobalIndexMap const &	getDOFTable (const int process_id) const override

std::vector< NumLib::LocalToGlobalIndexMap const * >	getDOFTables (const int number_of_processes) const

void	computeSecondaryVariableConcrete (double const t, double const dt, std::vector< GlobalVector * > const &x, GlobalVector const &x_dot, int const process_id) override

std::tuple< NumLib::LocalToGlobalIndexMap *, bool >	getDOFTableForExtrapolatorData () const override

bool	hasMechanicalProcess (int const process_id) const

Private Attributes
std::vector< MeshLib::Node * >	_base_nodes

std::unique_ptr< MeshLib::MeshSubset const >	_mesh_subset_base_nodes

RichardsMechanicsProcessData< DisplacementDim >	_process_data

std::vector< std::unique_ptr< LocalAssemblerIF > >	_local_assemblers

std::unique_ptr< NumLib::LocalToGlobalIndexMap >	_local_to_global_index_map_single_component

std::unique_ptr< NumLib::LocalToGlobalIndexMap >	_local_to_global_index_map_with_base_nodes

GlobalSparsityPattern	_sparsity_pattern_with_linear_element

MeshLib::PropertyVector< double > *	_nodal_forces = nullptr

MeshLib::PropertyVector< double > *	_hydraulic_flow = nullptr

Additional Inherited Members
Public Types inherited from ProcessLib::Process
using	NonlinearSolver = NumLib::NonlinearSolverBase

using	TimeDiscretization = NumLib::TimeDiscretization

Public Attributes inherited from ProcessLib::Process
std::string const	name

Protected Member Functions inherited from ProcessLib::Process
NumLib::Extrapolator &	getExtrapolator () const

NumLib::LocalToGlobalIndexMap const &	getSingleComponentDOFTable () const

void	initializeProcessBoundaryConditionsAndSourceTerms (const NumLib::LocalToGlobalIndexMap &dof_table, const int process_id)

void	constructMonolithicProcessDofTable ()

void	constructDofTableOfSpecifiedProcessStaggeredScheme (const int specified_prosess_id)

Protected Attributes inherited from ProcessLib::Process
MeshLib::Mesh &	_mesh

std::unique_ptr< MeshLib::MeshSubset const >	_mesh_subset_all_nodes

std::unique_ptr< NumLib::LocalToGlobalIndexMap >	_local_to_global_index_map

SecondaryVariableCollection	_secondary_variables

VectorMatrixAssembler	_global_assembler

const bool	_use_monolithic_scheme

CoupledSolutionsForStaggeredScheme *	_coupled_solutions

unsigned const	_integration_order

std::vector< std::unique_ptr< IntegrationPointWriter > >	_integration_point_writer

GlobalSparsityPattern	_sparsity_pattern

std::vector< std::vector< std::reference_wrapper< ProcessVariable > > >	_process_variables

std::vector< BoundaryConditionCollection >	_boundary_conditions

Member Typedef Documentation

◆ LocalAssemblerIF

template<int DisplacementDim>

using ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::LocalAssemblerIF = LocalAssemblerInterface<DisplacementDim>

private

Definition at line 65 of file RichardsMechanicsProcess.h.

Constructor & Destructor Documentation

◆ RichardsMechanicsProcess()

template<int DisplacementDim>

ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::RichardsMechanicsProcess	(	std::string	name,
		MeshLib::Mesh &	mesh,
		std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&	jacobian_assembler,
		std::vector< std::unique_ptr< ParameterLib::ParameterBase >> const &	parameters,
		unsigned const	integration_order,
		std::vector< std::vector< std::reference_wrapper< ProcessVariable >>> &&	process_variables,
		RichardsMechanicsProcessData< DisplacementDim > &&	process_data,
		SecondaryVariableCollection &&	secondary_variables,
		bool const	use_monolithic_scheme
	)

Definition at line 27 of file RichardsMechanicsProcess.cpp.

     : Process(std::move(name), mesh, std::move(jacobian_assembler), parameters,
               integration_order, std::move(process_variables),
               std::move(secondary_variables), use_monolithic_scheme),
       _process_data(std::move(process_data))
 {
     _nodal_forces = MeshLib::getOrCreateMeshProperty<double>(
         mesh, "NodalForces", MeshLib::MeshItemType::Node, DisplacementDim);
  
     _hydraulic_flow = MeshLib::getOrCreateMeshProperty<double>(
         mesh, "HydraulicFlow", MeshLib::MeshItemType::Node, 1);
  
     // TODO (naumov) remove ip suffix. Probably needs modification of the mesh
     // properties, s.t. there is no "overlapping" with cell/point data.
     // See getOrCreateMeshProperty.
     _integration_point_writer.emplace_back(
         std::make_unique<IntegrationPointWriter>(
             "sigma_ip",
             static_cast<int>(mesh.getDimension() == 2 ? 4 : 6) /*n components*/,
             integration_order, _local_assemblers, &LocalAssemblerIF::getSigma));
  
     _integration_point_writer.emplace_back(
         std::make_unique<IntegrationPointWriter>(
             "saturation_ip", 1 /*n components*/, integration_order,
             _local_assemblers, &LocalAssemblerIF::getSaturation));
  
     _integration_point_writer.emplace_back(
         std::make_unique<IntegrationPointWriter>(
             "porosity_ip", 1 /*n components*/, integration_order,
             _local_assemblers, &LocalAssemblerIF::getPorosity));
  
     _integration_point_writer.emplace_back(
         std::make_unique<IntegrationPointWriter>(
             "transport_porosity_ip", 1 /*n components*/, integration_order,
             _local_assemblers, &LocalAssemblerIF::getTransportPorosity));
  
     _integration_point_writer.emplace_back(
         std::make_unique<IntegrationPointWriter>(
             "swelling_stress_ip",
             static_cast<int>(mesh.getDimension() == 2 ? 4 : 6) /*n components*/,
             integration_order, _local_assemblers,
             &LocalAssemblerIF::getSwellingStress));
  
     _integration_point_writer.emplace_back(
         std::make_unique<IntegrationPointWriter>(
             "epsilon_ip",
             static_cast<int>(mesh.getDimension() == 2 ? 4 : 6) /*n components*/,
             integration_order, _local_assemblers,
             &LocalAssemblerIF::getEpsilon));
 }

References ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::_hydraulic_flow, ProcessLib::Process::_integration_point_writer, ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::_local_assemblers, ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::_nodal_forces, MeshLib::Mesh::getDimension(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getEpsilon(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getPorosity(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getSaturation(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getSigma(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getSwellingStress(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getTransportPorosity(), and MeshLib::Node.

Member Function Documentation

◆ assembleConcreteProcess()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::assembleConcreteProcess	(	const double	t,
		double const	dt,
		std::vector< GlobalVector * > const &	x,
		std::vector< GlobalVector * > const &	xdot,
		int const	process_id,
		GlobalMatrix &	M,
		GlobalMatrix &	K,
		GlobalVector &	b
	)

overrideprivatevirtual

Implements ProcessLib::Process.

Definition at line 392 of file RichardsMechanicsProcess.cpp.

 {
     DBUG("Assemble the equations for RichardsMechanics");
  
     std::vector<std::reference_wrapper<NumLib::LocalToGlobalIndexMap>>
         dof_table = {std::ref(*_local_to_global_index_map)};
     ProcessLib::ProcessVariable const& pv = getProcessVariables(process_id)[0];
  
     // Call global assembler for each local assembly item.
     GlobalExecutor::executeSelectedMemberDereferenced(
         _global_assembler, &VectorMatrixAssembler::assemble, _local_assemblers,
         pv.getActiveElementIDs(), dof_table, t, dt, x, xdot, process_id, M, K,
         b);
 }

References ProcessLib::VectorMatrixAssembler::assemble(), DBUG(), NumLib::SerialExecutor::executeSelectedMemberDereferenced(), and ProcessLib::ProcessVariable::getActiveElementIDs().

◆ assembleWithJacobianConcreteProcess()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::assembleWithJacobianConcreteProcess	(	const double	t,
		double const	dt,
		std::vector< GlobalVector * > const &	x,
		std::vector< GlobalVector * > const &	xdot,
		const double	dxdot_dx,
		const double	dx_dx,
		int const	process_id,
		GlobalMatrix &	M,
		GlobalMatrix &	K,
		GlobalVector &	b,
		GlobalMatrix &	Jac
	)

overrideprivatevirtual

Implements ProcessLib::Process.

Definition at line 411 of file RichardsMechanicsProcess.cpp.

 {
     std::vector<std::reference_wrapper<NumLib::LocalToGlobalIndexMap>>
         dof_tables;
     // For the monolithic scheme
     if (_use_monolithic_scheme)
     {
         DBUG(
             "Assemble the Jacobian of RichardsMechanics for the monolithic"
             " scheme.");
         dof_tables.emplace_back(*_local_to_global_index_map);
     }
     else
     {
         // For the staggered scheme
         if (process_id == 0)
         {
             DBUG(
                 "Assemble the Jacobian equations of liquid fluid process in "
                 "RichardsMechanics for the staggered scheme.");
         }
         else
         {
             DBUG(
                 "Assemble the Jacobian equations of mechanical process in "
                 "RichardsMechanics for the staggered scheme.");
         }
         dof_tables.emplace_back(*_local_to_global_index_map_with_base_nodes);
         dof_tables.emplace_back(*_local_to_global_index_map);
     }
  
     ProcessLib::ProcessVariable const& pv = getProcessVariables(process_id)[0];
  
     GlobalExecutor::executeSelectedMemberDereferenced(
         _global_assembler, &VectorMatrixAssembler::assembleWithJacobian,
         _local_assemblers, pv.getActiveElementIDs(), dof_tables, t, dt, x, xdot,
         dxdot_dx, dx_dx, process_id, M, K, b, Jac);
  
     auto copyRhs = [&](int const variable_id, auto& output_vector)
     {
         if (_use_monolithic_scheme)
         {
             transformVariableFromGlobalVector(b, variable_id, dof_tables[0],
                                               output_vector,
                                               std::negate<double>());
         }
         else
         {
             transformVariableFromGlobalVector(b, 0, dof_tables[process_id],
                                               output_vector,
                                               std::negate<double>());
         }
     };
     if (_use_monolithic_scheme || process_id == 0)
     {
         copyRhs(0, *_hydraulic_flow);
     }
     if (_use_monolithic_scheme || process_id == 1)
     {
         copyRhs(1, *_nodal_forces);
     }
 }

References ProcessLib::VectorMatrixAssembler::assembleWithJacobian(), DBUG(), NumLib::SerialExecutor::executeSelectedMemberDereferenced(), ProcessLib::ProcessVariable::getActiveElementIDs(), and NumLib::transformVariableFromGlobalVector().

◆ computeSecondaryVariableConcrete()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::computeSecondaryVariableConcrete	(	double const	t,
		double const	dt,
		std::vector< GlobalVector * > const &	x,
		GlobalVector const &	x_dot,
		int const	process_id
	)

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 498 of file RichardsMechanicsProcess.cpp.

 {
     if (process_id != 0)
     {
         return;
     }
  
     DBUG("Compute the secondary variables for RichardsMechanicsProcess.");
     auto const dof_tables = getDOFTables(x.size());
  
     ProcessLib::ProcessVariable const& pv = getProcessVariables(process_id)[0];
     GlobalExecutor::executeSelectedMemberOnDereferenced(
         &LocalAssemblerIF::computeSecondaryVariable, _local_assemblers,
         pv.getActiveElementIDs(), dof_tables, t, dt, x, x_dot, process_id);
 }

References DBUG(), NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), and ProcessLib::ProcessVariable::getActiveElementIDs().

◆ constructDofTable()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::constructDofTable

overrideprivatevirtual

This function is for general cases, in which all equations of the coupled processes have the same number of unknowns. For the general cases with the staggered scheme, all equations of the coupled processes share one DOF table hold by _local_to_global_index_map. Other cases can be considered by overloading this member function in the derived class.

Reimplemented from ProcessLib::Process.

Definition at line 115 of file RichardsMechanicsProcess.cpp.

 {
     // Create single component dof in every of the mesh's nodes.
     _mesh_subset_all_nodes =
         std::make_unique<MeshLib::MeshSubset>(_mesh, _mesh.getNodes());
     // Create single component dof in the mesh's base nodes.
     _base_nodes = MeshLib::getBaseNodes(_mesh.getElements());
     _mesh_subset_base_nodes =
         std::make_unique<MeshLib::MeshSubset>(_mesh, _base_nodes);
  
     // TODO move the two data members somewhere else.
     // for extrapolation of secondary variables of stress or strain
     std::vector<MeshLib::MeshSubset> all_mesh_subsets_single_component{
         *_mesh_subset_all_nodes};
     _local_to_global_index_map_single_component =
         std::make_unique<NumLib::LocalToGlobalIndexMap>(
             std::move(all_mesh_subsets_single_component),
             // by location order is needed for output
             NumLib::ComponentOrder::BY_LOCATION);
  
     if (_use_monolithic_scheme)
     {
         // For pressure, which is the first
         std::vector<MeshLib::MeshSubset> all_mesh_subsets{
             *_mesh_subset_base_nodes};
  
         // For displacement.
         const int monolithic_process_id = 0;
         std::generate_n(std::back_inserter(all_mesh_subsets),
                         getProcessVariables(monolithic_process_id)[1]
                             .get()
                             .getNumberOfGlobalComponents(),
                         [&]() { return *_mesh_subset_all_nodes; });
  
         std::vector<int> const vec_n_components{1, DisplacementDim};
         _local_to_global_index_map =
             std::make_unique<NumLib::LocalToGlobalIndexMap>(
                 std::move(all_mesh_subsets), vec_n_components,
                 NumLib::ComponentOrder::BY_LOCATION);
         assert(_local_to_global_index_map);
     }
     else
     {
         // For displacement equation.
         const int process_id = 1;
         std::vector<MeshLib::MeshSubset> all_mesh_subsets;
         std::generate_n(std::back_inserter(all_mesh_subsets),
                         getProcessVariables(process_id)[0]
                             .get()
                             .getNumberOfGlobalComponents(),
                         [&]() { return *_mesh_subset_all_nodes; });
  
         std::vector<int> const vec_n_components{DisplacementDim};
         _local_to_global_index_map =
             std::make_unique<NumLib::LocalToGlobalIndexMap>(
                 std::move(all_mesh_subsets), vec_n_components,
                 NumLib::ComponentOrder::BY_LOCATION);
  
         // For pressure equation.
         // Collect the mesh subsets with base nodes in a vector.
         std::vector<MeshLib::MeshSubset> all_mesh_subsets_base_nodes{
             *_mesh_subset_base_nodes};
         _local_to_global_index_map_with_base_nodes =
             std::make_unique<NumLib::LocalToGlobalIndexMap>(
                 std::move(all_mesh_subsets_base_nodes),
                 // by location order is needed for output
                 NumLib::ComponentOrder::BY_LOCATION);
  
         _sparsity_pattern_with_linear_element = NumLib::computeSparsityPattern(
             *_local_to_global_index_map_with_base_nodes, _mesh);
  
         assert(_local_to_global_index_map);
         assert(_local_to_global_index_map_with_base_nodes);
     }
 }

References NumLib::BY_LOCATION, NumLib::computeSparsityPattern(), and MeshLib::getBaseNodes().

◆ getDOFTable()

template<int DisplacementDim>

NumLib::LocalToGlobalIndexMap const & ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::getDOFTable ( const int process_id ) const

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 529 of file RichardsMechanicsProcess.cpp.

 {
     if (hasMechanicalProcess(process_id))
     {
         return *_local_to_global_index_map;
     }
  
     // For the equation of pressure
     return *_local_to_global_index_map_with_base_nodes;
 }

◆ getDOFTableForExtrapolatorData()

template<int DisplacementDim>

std::tuple< NumLib::LocalToGlobalIndexMap *, bool > ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::getDOFTableForExtrapolatorData

overrideprivatevirtual

Get the address of a LocalToGlobalIndexMap, and the status of its memory. If the LocalToGlobalIndexMap is created as new in this function, the function also returns a true boolean value to let Extrapolator manage the memory by the address returned by this function.

Returns: Address of a LocalToGlobalIndexMap and its memory status.

Reimplemented from ProcessLib::Process.

Definition at line 520 of file RichardsMechanicsProcess.cpp.

 {
     const bool manage_storage = false;
     return std::make_tuple(_local_to_global_index_map_single_component.get(),
                            manage_storage);
 }

◆ getDOFTables()

template<int DisplacementDim>

std::vector< NumLib::LocalToGlobalIndexMap const * > ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::getDOFTables ( const int number_of_processes ) const

private

Definition at line 543 of file RichardsMechanicsProcess.cpp.

 {
     std::vector<NumLib::LocalToGlobalIndexMap const*> dof_tables;
     dof_tables.reserve(number_of_processes);
     std::generate_n(std::back_inserter(dof_tables), number_of_processes,
                     [&]() { return &getDOFTable(dof_tables.size()); });
     return dof_tables;
 }

◆ getMatrixSpecifications()

template<int DisplacementDim>

MathLib::MatrixSpecifications ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::getMatrixSpecifications ( const int process_id ) const

override

Get the size and the sparse pattern of the global matrix in order to create the global matrices and vectors for the system equations of this process.

Parameters

process_id Process ID. If the monolithic scheme is applied, process_id = 0. For the staggered scheme, process_id = 0 represents the hydraulic (H) process, while process_id = 1 represents the mechanical (M) process.

Returns: Matrix specifications including size and sparse pattern.

Definition at line 96 of file RichardsMechanicsProcess.cpp.

 {
     // For the monolithic scheme or the M process (deformation) in the staggered
     // scheme.
     if (_use_monolithic_scheme || process_id == 1)
     {
         auto const& l = *_local_to_global_index_map;
         return {l.dofSizeWithoutGhosts(), l.dofSizeWithoutGhosts(),
                 &l.getGhostIndices(), &this->_sparsity_pattern};
     }
  
     // For staggered scheme and H process (pressure).
     auto const& l = *_local_to_global_index_map_with_base_nodes;
     return {l.dofSizeWithoutGhosts(), l.dofSizeWithoutGhosts(),
             &l.getGhostIndices(), &_sparsity_pattern_with_linear_element};
 }

◆ hasMechanicalProcess()

template<int DisplacementDim>

bool ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::hasMechanicalProcess ( int const process_id ) const

inlineprivate

Check whether the process represented by process_id is/has mechanical process. In the present implementation, the mechanical process has process_id == 1 in the staggered scheme.

Definition at line 134 of file RichardsMechanicsProcess.h.

     {
         return _use_monolithic_scheme || process_id == 1;
     }

References ProcessLib::Process::_use_monolithic_scheme.

◆ initializeBoundaryConditions()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::initializeBoundaryConditions

overrideprivatevirtual

Member function to initialize the boundary conditions for all coupled processes. It is called by initialize().

Reimplemented from ProcessLib::Process.

Definition at line 348 of file RichardsMechanicsProcess.cpp.

 {
     if (_use_monolithic_scheme)
     {
         const int monolithic_process_id = 0;
         initializeProcessBoundaryConditionsAndSourceTerms(
             *_local_to_global_index_map, monolithic_process_id);
         return;
     }
  
     // Staggered scheme:
     // for the equations of pressure
     const int hydraulic_process_id = 0;
     initializeProcessBoundaryConditionsAndSourceTerms(
         *_local_to_global_index_map_with_base_nodes, hydraulic_process_id);
  
     // for the equations of deformation.
     const int mechanical_process_id = 1;
     initializeProcessBoundaryConditionsAndSourceTerms(
         *_local_to_global_index_map, mechanical_process_id);
 }

◆ initializeConcreteProcess()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::initializeConcreteProcess	(	NumLib::LocalToGlobalIndexMap const &	dof_table,
		MeshLib::Mesh const &	mesh,
		unsigned const	integration_order
	)

overrideprivatevirtual

Process specific initialization called by initialize().

Implements ProcessLib::Process.

Definition at line 192 of file RichardsMechanicsProcess.cpp.

 {
     using nlohmann::json;
  
     const int mechanical_process_id = _use_monolithic_scheme ? 0 : 1;
     const int deformation_variable_id = _use_monolithic_scheme ? 1 : 0;
     ProcessLib::RichardsMechanics::createLocalAssemblers<
         DisplacementDim, RichardsMechanicsLocalAssembler>(
         mesh.getDimension(), mesh.getElements(), dof_table,
         // use displacement process variable to set shape function order
         getProcessVariables(mechanical_process_id)[deformation_variable_id]
             .get()
             .getShapeFunctionOrder(),
         _local_assemblers, mesh.isAxiallySymmetric(), integration_order,
         _process_data);
  
     auto add_secondary_variable = [&](std::string const& name,
                                       int const num_components,
                                       auto get_ip_values_function)
     {
         _secondary_variables.addSecondaryVariable(
             name,
             makeExtrapolator(num_components, getExtrapolator(),
                              _local_assemblers,
                              std::move(get_ip_values_function)));
     };
  
     add_secondary_variable("sigma",
                            MathLib::KelvinVector::KelvinVectorType<
                                DisplacementDim>::RowsAtCompileTime,
                            &LocalAssemblerIF::getIntPtSigma);
  
     add_secondary_variable("swelling_stress",
                            MathLib::KelvinVector::KelvinVectorType<
                                DisplacementDim>::RowsAtCompileTime,
                            &LocalAssemblerIF::getIntPtSwellingStress);
  
     add_secondary_variable("epsilon",
                            MathLib::KelvinVector::KelvinVectorType<
                                DisplacementDim>::RowsAtCompileTime,
                            &LocalAssemblerIF::getIntPtEpsilon);
  
     add_secondary_variable("velocity", DisplacementDim,
                            &LocalAssemblerIF::getIntPtDarcyVelocity);
  
     add_secondary_variable("saturation", 1,
                            &LocalAssemblerIF::getIntPtSaturation);
  
     add_secondary_variable("micro_saturation", 1,
                            &LocalAssemblerIF::getIntPtMicroSaturation);
  
     add_secondary_variable("micro_pressure", 1,
                            &LocalAssemblerIF::getIntPtMicroPressure);
  
     add_secondary_variable("porosity", 1, &LocalAssemblerIF::getIntPtPorosity);
  
     add_secondary_variable("transport_porosity", 1,
                            &LocalAssemblerIF::getIntPtTransportPorosity);
  
     add_secondary_variable("dry_density_solid", 1,
                            &LocalAssemblerIF::getIntPtDryDensitySolid);
  
     //
     // enable output of internal variables defined by material models
     //
     ProcessLib::Deformation::solidMaterialInternalToSecondaryVariables<
         LocalAssemblerIF>(_process_data.solid_materials,
                           add_secondary_variable);
  
     // Assume all materials have same internal variables.
     ProcessLib::Deformation::
         solidMaterialInternalVariablesToIntegrationPointWriter(
             _process_data.solid_materials, _local_assemblers,
             _integration_point_writer, integration_order);
  
     _process_data.element_saturation = MeshLib::getOrCreateMeshProperty<double>(
         const_cast<MeshLib::Mesh&>(mesh), "saturation_avg",
         MeshLib::MeshItemType::Cell, 1);
  
     _process_data.element_porosity = MeshLib::getOrCreateMeshProperty<double>(
         const_cast<MeshLib::Mesh&>(mesh), "porosity_avg",
         MeshLib::MeshItemType::Cell, 1);
  
     _process_data.element_stresses = MeshLib::getOrCreateMeshProperty<double>(
         const_cast<MeshLib::Mesh&>(mesh), "stress_avg",
         MeshLib::MeshItemType::Cell,
         MathLib::KelvinVector::KelvinVectorType<
             DisplacementDim>::RowsAtCompileTime);
  
     _process_data.pressure_interpolated =
         MeshLib::getOrCreateMeshProperty<double>(
             const_cast<MeshLib::Mesh&>(mesh), "pressure_interpolated",
             MeshLib::MeshItemType::Node, 1);
  
     // Set initial conditions for integration point data.
     for (auto const& ip_writer : _integration_point_writer)
     {
         // Find the mesh property with integration point writer's name.
         auto const& name = ip_writer->name();
         if (!mesh.getProperties().existsPropertyVector<double>(name))
         {
             continue;
         }
         auto const& mesh_property =
             *mesh.getProperties().template getPropertyVector<double>(name);
  
         // The mesh property must be defined on integration points.
         if (mesh_property.getMeshItemType() !=
             MeshLib::MeshItemType::IntegrationPoint)
         {
             continue;
         }
  
         auto const ip_meta_data = getIntegrationPointMetaData(mesh, name);
  
         // Check the number of components.
         if (ip_meta_data.n_components !=
             mesh_property.getNumberOfGlobalComponents())
         {
             OGS_FATAL(
                 "Different number of components in meta data ({:d}) than in "
                 "the integration point field data for '{:s}': {:d}.",
                 ip_meta_data.n_components, name,
                 mesh_property.getNumberOfGlobalComponents());
         }
  
         // Now we have a properly named vtk's field data array and the
         // corresponding meta data.
         std::size_t position = 0;
         for (auto& local_asm : _local_assemblers)
         {
             std::size_t const integration_points_read =
                 local_asm->setIPDataInitialConditions(
                     name, &mesh_property[position],
                     ip_meta_data.integration_order);
             if (integration_points_read == 0)
             {
                 OGS_FATAL(
                     "No integration points read in the integration point "
                     "initial conditions set function for {:s} variable.",
                     name);
             }
             position += integration_points_read * ip_meta_data.n_components;
         }
     }
  
     // Initialize local assemblers after all variables have been set.
     GlobalExecutor::executeMemberOnDereferenced(&LocalAssemblerIF::initialize,
                                                 _local_assemblers,
                                                 *_local_to_global_index_map);
 }

References MeshLib::Cell, ProcessLib::RichardsMechanics::createLocalAssemblers(), NumLib::SerialExecutor::executeMemberOnDereferenced(), MeshLib::Properties::existsPropertyVector(), MeshLib::Mesh::getDimension(), MeshLib::Mesh::getElements(), ProcessLib::getIntegrationPointMetaData(), MeshLib::Mesh::getProperties(), MeshLib::IntegrationPoint, MeshLib::Mesh::isAxiallySymmetric(), ProcessLib::makeExtrapolator(), MaterialPropertyLib::name, MeshLib::Node, OGS_FATAL, ProcessLib::Deformation::solidMaterialInternalToSecondaryVariables(), and ProcessLib::Deformation::solidMaterialInternalVariablesToIntegrationPointWriter().

◆ isLinear()

template<int DisplacementDim>

bool ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::isLinear

override

Definition at line 89 of file RichardsMechanicsProcess.cpp.

 {
     return false;
 }

◆ postTimestepConcreteProcess()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::postTimestepConcreteProcess	(	std::vector< GlobalVector * > const &	x,
		double const	t,
		double const	dt,
		const int	process_id
	)

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 480 of file RichardsMechanicsProcess.cpp.

 {
     if (hasMechanicalProcess(process_id))
     {
         DBUG("PostTimestep RichardsMechanicsProcess.");
         auto const dof_tables = getDOFTables(x.size());
  
         ProcessLib::ProcessVariable const& pv =
             getProcessVariables(process_id)[0];
         GlobalExecutor::executeSelectedMemberOnDereferenced(
             &LocalAssemblerIF::postTimestep, _local_assemblers,
             pv.getActiveElementIDs(), dof_tables, x, t, dt);
     }
 }

References DBUG(), NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), and ProcessLib::ProcessVariable::getActiveElementIDs().

◆ setInitialConditionsConcreteProcess()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::setInitialConditionsConcreteProcess	(	std::vector< GlobalVector * > &	x,
		double const	t,
		int const	process_id
	)

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 371 of file RichardsMechanicsProcess.cpp.

 {
     if (process_id != 0)
     {
         return;
     }
  
     DBUG("SetInitialConditions RichardsMechanicsProcess.");
  
     ProcessLib::ProcessVariable const& pv = getProcessVariables(process_id)[0];
  
     GlobalExecutor::executeSelectedMemberOnDereferenced(
         &LocalAssemblerIF::setInitialConditions, _local_assemblers,
         pv.getActiveElementIDs(), getDOFTable(process_id), *x[process_id], t,
         _use_monolithic_scheme, process_id);
 }