ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim > Class Template Reference

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 20 of file RichardsMechanicsProcess.h.

#include <RichardsMechanicsProcess.h>

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

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

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, bool const is_linear)
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.
void	postTimestep (std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, const double t, const double delta_t, int const process_id)
	Postprocessing after a complete timestep.
void	postNonLinearSolver (std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, 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_prev, int const process_id)
	compute secondary variables for the coupled equations or for output.
NumLib::IterationResult	postIteration (GlobalVector const &x) final
void	initialize (std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
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	updateDeactivatedSubdomains (double const time, const int process_id)
virtual bool	isMonolithicSchemeUsed () 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 &x_prev, 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 &x_prev, int const process_id, GlobalVector &b, GlobalMatrix &Jac) final
void	preOutput (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id)
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::vector< std::reference_wrapper< ProcessVariable > > > const &	getProcessVariables () const
std::vector< std::reference_wrapper< ProcessVariable > > const &	getProcessVariables (const int process_id) const
std::vector< std::size_t > const &	getActiveElementIDs () const
SecondaryVariableCollection const &	getSecondaryVariables () const
std::vector< std::unique_ptr< MeshLib::IntegrationPointWriter > > const &	getIntegrationPointWriters () 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)
bool	requiresNormalization () const override
Public Member Functions inherited from ProcessLib::SubmeshAssemblySupport
virtual	~SubmeshAssemblySupport ()=default

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().
void	initializeBoundaryConditions (std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media) 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 &x_prev, 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 &x_prev, int const process_id, GlobalVector &b, GlobalMatrix &Jac) override
void	preTimestepConcreteProcess (std::vector< GlobalVector * > const &x, double const t, double const dt, const int process_id) override
void	postTimestepConcreteProcess (std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, double const t, double const dt, const int process_id) override
std::vector< std::vector< std::string > >	initializeAssemblyOnSubmeshes (std::vector< std::reference_wrapper< MeshLib::Mesh > > const &meshes) override
NumLib::LocalToGlobalIndexMap const &	getDOFTable (const int process_id) const override
void	computeSecondaryVariableConcrete (double const t, double const dt, std::vector< GlobalVector * > const &x, GlobalVector const &x_prev, int const process_id) override
std::tuple< NumLib::LocalToGlobalIndexMap *, bool >	getDOFTableForExtrapolatorData () const override
bool	hasMechanicalProcess (int const process_id) const
Private Member Functions inherited from ProcessLib::AssemblyMixin< RichardsMechanicsProcess< DisplacementDim > >
void	initializeAssemblyOnSubmeshes (std::vector< std::reference_wrapper< MeshLib::Mesh > > const &submeshes, std::vector< std::vector< std::string > > const &residuum_names)
void	updateActiveElements ()
void	assemble (double const t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id, GlobalMatrix &M, GlobalMatrix &K, GlobalVector &b, std::vector< std::size_t > const *const sorted_element_subset=nullptr, bool const copy_residua_to_mesh=false)
void	assembleWithJacobian (double const t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id, GlobalVector &b, GlobalMatrix &Jac, std::vector< std::size_t > const *const sorted_element_subset=nullptr, bool const copy_residua_to_mesh=false)
void	preOutput (double const t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id)

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_

Friends
class	AssemblyMixin< RichardsMechanicsProcess< DisplacementDim > >

Additional Inherited Members
Public Attributes inherited from ProcessLib::Process
std::string const	name
Static Public Attributes inherited from ProcessLib::Process
static PROCESSLIB_EXPORT const std::string	constant_one_parameter_name = "constant_one"
Protected Member Functions inherited from ProcessLib::Process
std::vector< NumLib::LocalToGlobalIndexMap const * >	getDOFTables (int const number_of_processes) const
NumLib::Extrapolator &	getExtrapolator () const
NumLib::LocalToGlobalIndexMap const &	getSingleComponentDOFTable () const
void	initializeProcessBoundaryConditionsAndSourceTerms (const NumLib::LocalToGlobalIndexMap &dof_table, const int process_id, std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
void	constructMonolithicProcessDofTable ()
void	constructDofTableOfSpecifiedProcessStaggeredScheme (const int specified_process_id)
std::vector< GlobalIndexType >	getIndicesOfResiduumWithoutInitialCompensation () const override
void	setReleaseNodalForces (GlobalVector const *r_neq, int const process_id) override
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
CellAverageData	cell_average_data_
std::unique_ptr< ProcessLib::AbstractJacobianAssembler >	_jacobian_assembler
VectorMatrixAssembler	_global_assembler
const bool	_use_monolithic_scheme
unsigned const	_integration_order
std::vector< std::unique_ptr< MeshLib::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 63 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,
		bool const	is_linear )

Definition at line 24 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),
      AssemblyMixin<RichardsMechanicsProcess<DisplacementDim>>{
          *_jacobian_assembler, is_linear, use_monolithic_scheme},
      process_data_(std::move(process_data))
{
    // For numerical Jacobian assembler
    this->_jacobian_assembler->setNonDeformationComponentIDs(
        {0} /* pressure variable */);
 
    ProcessLib::Reflection::addReflectedIntegrationPointWriters<
        DisplacementDim>(LocalAssemblerIF::getReflectionDataForOutput(),
                         _integration_point_writer, integration_order,
                         local_assemblers_);
}

References ProcessLib::Process::Process(), RichardsMechanicsProcess(), ProcessLib::Process::_jacobian_assembler, and ProcessLib::Process::name.

Referenced by RichardsMechanicsProcess(), AssemblyMixin< RichardsMechanicsProcess< DisplacementDim > >, and preTimestepConcreteProcess().

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 & x_prev, int const process_id, GlobalMatrix & M, GlobalMatrix & K, GlobalVector & b )

overrideprivatevirtual

Implements ProcessLib::Process.

Definition at line 265 of file RichardsMechanicsProcess.cpp.

{
    DBUG("Assemble the equations for RichardsMechanics");
 
    AssemblyMixin<RichardsMechanicsProcess<DisplacementDim>>::assemble(
        t, dt, x, x_prev, process_id, M, K, b);
}

References ProcessLib::Process::assemble(), and DBUG().

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 & x_prev, int const process_id, GlobalVector & b, GlobalMatrix & Jac )

overrideprivatevirtual

Implements ProcessLib::Process.

Definition at line 277 of file RichardsMechanicsProcess.cpp.

{
    // For the monolithic scheme
    if (_use_monolithic_scheme)
    {
        DBUG(
            "Assemble the Jacobian of RichardsMechanics for the monolithic"
            " scheme.");
    }
    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.");
        }
    }
 
    AssemblyMixin<RichardsMechanicsProcess<DisplacementDim>>::
        assembleWithJacobian(t, dt, x, x_prev, process_id, b, Jac);
}

References ProcessLib::Process::_use_monolithic_scheme, and DBUG().

computeSecondaryVariableConcrete()

template<int DisplacementDim>

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

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 360 of file RichardsMechanicsProcess.cpp.

{
    if (process_id != 0)
    {
        return;
    }
 
    DBUG("Compute the secondary variables for RichardsMechanicsProcess.");
 
    GlobalExecutor::executeSelectedMemberOnDereferenced(
        &LocalAssemblerIF::computeSecondaryVariable, local_assemblers_,
        getActiveElementIDs(), getDOFTables(x.size()), t, dt, x, x_prev,
        process_id);
}

References ProcessLib::LocalAssemblerInterface::computeSecondaryVariable(), DBUG(), NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), ProcessLib::Process::getActiveElementIDs(), ProcessLib::Process::getDOFTables(), and local_assemblers_.

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 78 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 ProcessLib::Process::_local_to_global_index_map, ProcessLib::Process::_mesh, ProcessLib::Process::_mesh_subset_all_nodes, ProcessLib::Process::_use_monolithic_scheme, base_nodes_, NumLib::BY_LOCATION, NumLib::computeSparsityPattern(), MeshLib::getBaseNodes(), ProcessLib::Process::getProcessVariables(), local_to_global_index_map_single_component_, local_to_global_index_map_with_base_nodes_, mesh_subset_base_nodes_, and sparsity_pattern_with_linear_element_.

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 390 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_;
}

References ProcessLib::Process::_local_to_global_index_map, hasMechanicalProcess(), and local_to_global_index_map_with_base_nodes_.

getDOFTableForExtrapolatorData()

template<int DisplacementDim>

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

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 381 of file RichardsMechanicsProcess.cpp.

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

References getDOFTableForExtrapolatorData(), and local_to_global_index_map_single_component_.

Referenced by getDOFTableForExtrapolatorData().

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 59 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_};
}

References ProcessLib::Process::_local_to_global_index_map, ProcessLib::Process::_sparsity_pattern, ProcessLib::Process::_use_monolithic_scheme, local_to_global_index_map_with_base_nodes_, and 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 139 of file RichardsMechanicsProcess.h.

    {
        return _use_monolithic_scheme || process_id == 1;
    }

References ProcessLib::Process::_use_monolithic_scheme.

Referenced by getDOFTable(), and postTimestepConcreteProcess().

initializeAssemblyOnSubmeshes()

template<int DisplacementDim>

std::vector< std::vector< std::string > > ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::initializeAssemblyOnSubmeshes ( std::vector< std::reference_wrapper< MeshLib::Mesh > > const & meshes )

overrideprivatevirtual

Initializes the assembly on submeshes

Parameters

meshes

the submeshes on whom the assembly shall proceed.

Attention

meshes must be a must be a non-overlapping cover of the entire simulation domain (bulk mesh)!

Returns

The names of the residuum vectors that will be assembled for each process: outer vector of size 1 for monolithic schemes and greater for staggered schemes.

Reimplemented from ProcessLib::SubmeshAssemblySupport.

Definition at line 346 of file RichardsMechanicsProcess.cpp.

{
    INFO("RichardsMechanics process initializeSubmeshOutput().");
    std::vector<std::vector<std::string>> residuum_names{
        {"MassFlowRate", "NodalForces"}};
 
    AssemblyMixin<RichardsMechanicsProcess<DisplacementDim>>::
        initializeAssemblyOnSubmeshes(meshes, residuum_names);
 
    return residuum_names;
}

References INFO().

initializeBoundaryConditions()

template<int DisplacementDim>

void ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::initializeBoundaryConditions ( std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const & media )

overrideprivatevirtual

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

Reimplemented from ProcessLib::Process.

Definition at line 222 of file RichardsMechanicsProcess.cpp.

{
    if (_use_monolithic_scheme)
    {
        const int monolithic_process_id = 0;
        initializeProcessBoundaryConditionsAndSourceTerms(
            *_local_to_global_index_map, monolithic_process_id, media);
        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,
        media);
 
    // for the equations of deformation.
    const int mechanical_process_id = 1;
    initializeProcessBoundaryConditionsAndSourceTerms(
        *_local_to_global_index_map, mechanical_process_id, media);
}

References ProcessLib::Process::_local_to_global_index_map, ProcessLib::Process::_use_monolithic_scheme, ProcessLib::Process::initializeProcessBoundaryConditionsAndSourceTerms(), and local_to_global_index_map_with_base_nodes_.

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 155 of file RichardsMechanicsProcess.cpp.

{
    ProcessLib::createLocalAssemblersHM<DisplacementDim,
                                        RichardsMechanicsLocalAssembler>(
        mesh.getElements(), dof_table, local_assemblers_,
        NumLib::IntegrationOrder{integration_order}, mesh.isAxiallySymmetric(),
        process_data_);
 
    ProcessLib::Reflection::addReflectedSecondaryVariables<DisplacementDim>(
        LocalAssemblerIF::getReflectionDataForOutput(), _secondary_variables,
        getExtrapolator(), local_assemblers_);
 
    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)));
    };
 
    //
    // enable output of internal variables defined by material models
    //
    ProcessLib::Deformation::solidMaterialInternalToSecondaryVariables<
        LocalAssemblerIF>(process_data_.solid_materials,
                          add_secondary_variable);
 
    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);
 
    setIPDataInitialConditions(_integration_point_writer, mesh.getProperties(),
                               local_assemblers_);
 
    // Initialize local assemblers after all variables have been set.
    GlobalExecutor::executeMemberOnDereferenced(&LocalAssemblerIF::initialize,
                                                local_assemblers_,
                                                *_local_to_global_index_map);
}

References ProcessLib::Process::_integration_point_writer, ProcessLib::Process::_local_to_global_index_map, ProcessLib::Process::_secondary_variables, ProcessLib::Reflection::addReflectedSecondaryVariables(), MeshLib::Cell, ProcessLib::createLocalAssemblersHM(), NumLib::SerialExecutor::executeMemberOnDereferenced(), MeshLib::Mesh::getElements(), ProcessLib::Process::getExtrapolator(), MeshLib::getOrCreateMeshProperty(), MeshLib::Mesh::getProperties(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getReflectionDataForOutput(), ProcessLib::LocalAssemblerInterface::initialize(), MeshLib::Mesh::isAxiallySymmetric(), local_assemblers_, ProcessLib::makeExtrapolator(), ProcessLib::Process::name, MeshLib::Node, process_data_, ProcessLib::setIPDataInitialConditions(), ProcessLib::Deformation::solidMaterialInternalToSecondaryVariables(), and ProcessLib::Deformation::solidMaterialInternalVariablesToIntegrationPointWriter().

isLinear()

template<int DisplacementDim>

bool ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::isLinear ( ) const

override

Definition at line 52 of file RichardsMechanicsProcess.cpp.

{
    return AssemblyMixin<RichardsMechanicsProcess<DisplacementDim>>::isLinear();
}

References isLinear().

Referenced by isLinear().

postTimestepConcreteProcess()

template<int DisplacementDim>

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

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 328 of file RichardsMechanicsProcess.cpp.

{
    if (hasMechanicalProcess(process_id))
    {
        DBUG("PostTimestep RichardsMechanicsProcess.");
 
        GlobalExecutor::executeSelectedMemberOnDereferenced(
            &LocalAssemblerIF::postTimestep, local_assemblers_,
            getActiveElementIDs(), getDOFTables(x.size()), x, x_prev, t, dt,
            process_id);
    }
}

References DBUG(), NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), ProcessLib::Process::getActiveElementIDs(), ProcessLib::Process::getDOFTables(), hasMechanicalProcess(), local_assemblers_, and ProcessLib::LocalAssemblerInterface::postTimestep().

preTimestepConcreteProcess()

template<int DisplacementDim>

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

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 312 of file RichardsMechanicsProcess.cpp.

{
    DBUG("PreTimestep RichardsMechanicsProcess.");
 
    GlobalExecutor::executeSelectedMemberOnDereferenced(
        &LocalAssemblerIF::preTimestep, local_assemblers_,
        getActiveElementIDs(), *_local_to_global_index_map, *x[process_id], t,
        dt);
 
    AssemblyMixin<
        RichardsMechanicsProcess<DisplacementDim>>::updateActiveElements();
}

References RichardsMechanicsProcess(), ProcessLib::Process::_local_to_global_index_map, DBUG(), NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), ProcessLib::Process::getActiveElementIDs(), local_assemblers_, ProcessLib::LocalAssemblerInterface::preTimestep(), and ProcessLib::AssemblyMixin< RichardsMechanicsProcess< DisplacementDim > >::updateActiveElements().

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 247 of file RichardsMechanicsProcess.cpp.

{
    if (process_id != 0)
    {
        return;
    }
 
    DBUG("SetInitialConditions RichardsMechanicsProcess.");
 
    GlobalExecutor::executeSelectedMemberOnDereferenced(
        &LocalAssemblerIF::setInitialConditions, local_assemblers_,
        getActiveElementIDs(), getDOFTables(x.size()), x, t, process_id);
}

References DBUG(), NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), ProcessLib::Process::getActiveElementIDs(), ProcessLib::Process::getDOFTables(), local_assemblers_, and ProcessLib::LocalAssemblerInterface::setInitialConditions().

Friends And Related Symbol Documentation

AssemblyMixin< RichardsMechanicsProcess< DisplacementDim > >

template<int DisplacementDim>

friend class AssemblyMixin< RichardsMechanicsProcess< DisplacementDim > >

friend

Definition at line 146 of file RichardsMechanicsProcess.h.

References RichardsMechanicsProcess().

Member Data Documentation

base_nodes_

template<int DisplacementDim>

std::vector<MeshLib::Node*> ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::base_nodes_

private

Definition at line 108 of file RichardsMechanicsProcess.h.

Referenced by constructDofTable().

local_assemblers_

template<int DisplacementDim>

std::vector<std::unique_ptr<LocalAssemblerIF> > ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::local_assemblers_

private

Definition at line 112 of file RichardsMechanicsProcess.h.

Referenced by computeSecondaryVariableConcrete(), initializeConcreteProcess(), postTimestepConcreteProcess(), preTimestepConcreteProcess(), and setInitialConditionsConcreteProcess().

local_to_global_index_map_single_component_

template<int DisplacementDim>

std::unique_ptr<NumLib::LocalToGlobalIndexMap> ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::local_to_global_index_map_single_component_

private

Definition at line 115 of file RichardsMechanicsProcess.h.

Referenced by constructDofTable(), and getDOFTableForExtrapolatorData().

local_to_global_index_map_with_base_nodes_

template<int DisplacementDim>

std::unique_ptr<NumLib::LocalToGlobalIndexMap> ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::local_to_global_index_map_with_base_nodes_

private

Local to global index mapping for base nodes, which is used for linear interpolation for pressure in the staggered scheme.

Definition at line 120 of file RichardsMechanicsProcess.h.

Referenced by constructDofTable(), getDOFTable(), getMatrixSpecifications(), and initializeBoundaryConditions().

mesh_subset_base_nodes_

template<int DisplacementDim>

std::unique_ptr<MeshLib::MeshSubset const> ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::mesh_subset_base_nodes_

private

Definition at line 109 of file RichardsMechanicsProcess.h.

Referenced by constructDofTable().

process_data_

template<int DisplacementDim>

RichardsMechanicsProcessData<DisplacementDim> ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::process_data_

private

Definition at line 110 of file RichardsMechanicsProcess.h.

Referenced by initializeConcreteProcess().

sparsity_pattern_with_linear_element_

template<int DisplacementDim>

GlobalSparsityPattern ProcessLib::RichardsMechanics::RichardsMechanicsProcess< DisplacementDim >::sparsity_pattern_with_linear_element_

private

Sparsity pattern for the flow equation, and it is initialized only if the staggered scheme is used.

Definition at line 124 of file RichardsMechanicsProcess.h.

Referenced by constructDofTable(), and getMatrixSpecifications().

---

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

• RichardsMechanicsProcess.h
• RichardsMechanicsProcess.cpp