Moose::MFEM::NamedFieldsMap< T > Class Template Reference

Lightweight adaptor over an std::map from strings to pointer to T. More...

#include <MFEMContainers.h>

Public Types
using	MapType = std::map< std::string, std::shared_ptr< T > >
using	const_iterator = typename MapType::const_iterator

Public Member Functions
	NamedFieldsMap ()=default
	Default initializer. More...
	~NamedFieldsMap ()
	Destructor. More...
template<class FieldType , class... FieldArgs>
void	Register (const std::string &field_name, FieldArgs &&... args)
	Construct new field with name field_name and register. More...
void	Register (const std::string &field_name, std::shared_ptr< T > field)
	Register association between field and field_name. More...
void	Deregister (const std::string &field_name)
	Unregister association between a field and the field_name. More...
bool	Has (const std::string &field_name) const
	Predicate to check if a field is registered with name field_name. More...
std::shared_ptr< T >	GetShared (const std::string &field_name) const
	Returns a shared pointer to the field. This is guaranteed to return a non-null shared pointer. More...
T &	GetRef (const std::string &field_name) const
	Returns a reference to a field. More...
T *	Get (const std::string &field_name) const
	Returns a non-owning pointer to the field. This is guaranteed to return a non-null pointer. More...
template<typename TDerived >
TDerived *	Get (const std::string &field_name) const
	Returns a non-owning pointer to the field where TDerived is a derived class of class T. More...
std::vector< T * >	Get (const std::vector< std::string > &keys) const
	Returns a vector containing all values for supplied keys. More...
const_iterator	begin () const
	Returns a begin const iterator to the registered fields. More...
const_iterator	end () const
	Returns an end const iterator to the registered fields. More...
int	size ()
	Returns the number of elements in the map. More...

Protected Member Functions
const_iterator	FindField (const std::string &field_name) const
	Returns a const iterator to the field. More...
void	CheckFieldIsRegistrable ([[maybe_unused]] const std::string &field_name, [[maybe_unused]] T *field) const
	Check that the field pointer is valid and the field has not already been registered. More...
void	CheckFieldIsRegistered (const std::string &field_name) const
	Check that a field exists in the map. More...
std::shared_ptr< T >	EnsureFieldPointerIsNonNull (const_iterator &iterator) const
	Ensure that a returned shared pointer is valid. More...
template<typename TDerived >
TDerived *	EnsurePointerCastIsNonNull (T *ptr) const
	Ensure that a dynamic cast is successful. More...
void	DeregisterAll ()
	Clear all associations between names and fields. More...

Private Attributes
MapType	_field_map {}

Detailed Description

template<typename T>
class Moose::MFEM::NamedFieldsMap< T >

Lightweight adaptor over an std::map from strings to pointer to T.

Definition at line 35 of file MFEMContainers.h.

Member Typedef Documentation

const_iterator

template<typename T>

using Moose::MFEM::NamedFieldsMap< T >::const_iterator = typename MapType::const_iterator

Definition at line 39 of file MFEMContainers.h.

MapType

template<typename T>

using Moose::MFEM::NamedFieldsMap< T >::MapType = std::map<std::string, std::shared_ptr<T> >

Definition at line 38 of file MFEMContainers.h.

Constructor & Destructor Documentation

NamedFieldsMap()

template<typename T>

Moose::MFEM::NamedFieldsMap< T >::NamedFieldsMap ( )

default

Default initializer.

~NamedFieldsMap()

template<typename T>

Moose::MFEM::NamedFieldsMap< T >::~NamedFieldsMap ( )

inline

Destructor.

Definition at line 45 of file MFEMContainers.h.

{ DeregisterAll(); }

Member Function Documentation

begin()

template<typename T>

const_iterator Moose::MFEM::NamedFieldsMap< T >::begin ( ) const

inline

Returns a begin const iterator to the registered fields.

Definition at line 120 of file MFEMContainers.h.

{ return _field_map.begin(); }

CheckFieldIsRegistered()

template<typename T>

void Moose::MFEM::NamedFieldsMap< T >::CheckFieldIsRegistered ( const std::string &  field_name ) const

inlineprotected

Check that a field exists in the map.

Definition at line 146 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::GetShared().

  {
    if (!Has(field_name))
      mooseError("The field '" + field_name + "' has not been registered.");
  }

CheckFieldIsRegistrable()

template<typename T>

void Moose::MFEM::NamedFieldsMap< T >::CheckFieldIsRegistrable ( [[maybe_unused] ] const std::string &  field_name, [[maybe_unused] ] T *  field  ) const

inlineprotected

Check that the field pointer is valid and the field has not already been registered.

Definition at line 137 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Register().

  {
    mooseAssert(field, "Cannot register NULL field with name '" + field_name + "'.");
    mooseAssert(!Has(field_name) || Get(field_name) != field,
                "The field '" + field_name + "' is already registered.");
  }

Deregister()

template<typename T>

void Moose::MFEM::NamedFieldsMap< T >::Deregister ( const std::string &  field_name )

inline

Unregister association between a field and the field_name.

Definition at line 65 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Register().

{ _field_map.erase(field_name); }

DeregisterAll()

template<typename T>

void Moose::MFEM::NamedFieldsMap< T >::DeregisterAll ( )

inlineprotected

Clear all associations between names and fields.

Definition at line 170 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::~NamedFieldsMap().

{ _field_map.clear(); }

end()

template<typename T>

const_iterator Moose::MFEM::NamedFieldsMap< T >::end ( ) const

inline

Returns an end const iterator to the registered fields.

Definition at line 124 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Has().

{ return _field_map.end(); }

EnsureFieldPointerIsNonNull()

template<typename T>

std::shared_ptr<T> Moose::MFEM::NamedFieldsMap< T >::EnsureFieldPointerIsNonNull ( const_iterator &  iterator ) const

inlineprotected

Ensure that a returned shared pointer is valid.

Definition at line 153 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::GetShared().

  {
    auto owned_ptr = iterator->second;
    mooseAssert(owned_ptr, "The field '" + iterator->first + "' is NULL.");
    return owned_ptr;
  }

EnsurePointerCastIsNonNull()

template<typename T>

template<typename TDerived >

TDerived* Moose::MFEM::NamedFieldsMap< T >::EnsurePointerCastIsNonNull ( T *  ptr ) const

inlineprotected

Ensure that a dynamic cast is successful.

Definition at line 162 of file MFEMContainers.h.

  {
    auto derived_ptr = dynamic_cast<TDerived *>(ptr);
    mooseAssert(derived_ptr, "The dynamic cast performed on the field pointer failed.");
    return derived_ptr;
  }

FindField()

template<typename T>

const_iterator Moose::MFEM::NamedFieldsMap< T >::FindField ( const std::string &  field_name ) const

inlineprotected

Returns a const iterator to the field.

Definition at line 131 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::GetShared(), and Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Has().

  {
    return _field_map.find(field_name);
  }

Get() [1/3]

template<typename T>

T* Moose::MFEM::NamedFieldsMap< T >::Get ( const std::string &  field_name ) const

inline

Returns a non-owning pointer to the field. This is guaranteed to return a non-null pointer.

Definition at line 90 of file MFEMContainers.h.

Referenced by Moose::MFEM::TimeDependentEquationSystem::AddKernel(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::CheckFieldIsRegistrable(), Moose::MFEM::TimeDependentEquationSystem::EliminateCoupledVariables(), Moose::MFEM::EquationSystem::EliminateCoupledVariables(), Moose::MFEM::EigenproblemEquationSystem::FormEigenproblemMatrix(), Moose::MFEM::EquationSystem::FormJacobianMatrix(), Moose::MFEM::ComplexEquationSystem::FormSystemMatrix(), Moose::MFEM::EquationSystem::FormSystemMatrix(), Moose::MFEM::ComplexEquationSystem::FormSystemOperator(), Moose::MFEM::EquationSystem::FormSystemOperator(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Get(), MFEMProblem::getMeshDisplacementGridFunction(), MFEMProblem::getMFEMVariableMesh(), Moose::MFEM::ComplexEquationSystem::Init(), Moose::MFEM::EquationSystem::Init(), Moose::MFEM::EigenproblemESProblemOperator::RecoverEigenproblemSolution(), Moose::MFEM::ComplexEquationSystemProblemOperator::SetGridFunctions(), Moose::MFEM::ProblemOperatorBase::SetGridFunctions(), Moose::MFEM::ComplexEquationSystem::SetTrialVariablesFromTrueVectors(), and Moose::MFEM::EquationSystem::SetTrialVariablesFromTrueVectors().

  {
    return GetShared(field_name).get();
  }

Get() [2/3]

template<typename T>

template<typename TDerived >

TDerived* Moose::MFEM::NamedFieldsMap< T >::Get ( const std::string &  field_name ) const

inline

Returns a non-owning pointer to the field where TDerived is a derived class of class T.

Definition at line 97 of file MFEMContainers.h.

  {
    auto ptr = Get(field_name);

    return EnsurePointerCastIsNonNull<TDerived>(ptr);
  }

Get() [3/3]

template<typename T>

std::vector<T *> Moose::MFEM::NamedFieldsMap< T >::Get ( const std::vector< std::string > &  keys ) const

inline

Returns a vector containing all values for supplied keys.

Definition at line 105 of file MFEMContainers.h.

  {
    std::vector<T *> values;

    for (const auto & key : keys)
    {
      values.push_back(Get(key));
    }

    values.shrink_to_fit();
    return values;
  }

GetRef()

template<typename T>

T& Moose::MFEM::NamedFieldsMap< T >::GetRef ( const std::string &  field_name ) const

inline

Returns a reference to a field.

Definition at line 84 of file MFEMContainers.h.

Referenced by Moose::MFEM::ComplexEquationSystem::AddComplexEssentialBCs(), Moose::MFEM::EquationSystem::AddEssentialBC(), Moose::MFEM::TimeDependentEquationSystem::AddKernel(), Moose::MFEM::ComplexEquationSystem::ApplyComplexEssentialBC(), Moose::MFEM::EquationSystem::ApplyEssentialBC(), Moose::MFEM::EigenproblemEquationSystem::ApplyEssentialBCs(), Moose::MFEM::ComplexEquationSystem::ApplyEssentialBCs(), Moose::MFEM::EquationSystem::ApplyEssentialBCs(), Moose::MFEM::ComplexEquationSystem::BuildLinearForms(), Moose::MFEM::EquationSystem::BuildLinearForms(), Moose::MFEM::EquationSystem::GetBilinearForm(), and Moose::MFEM::EquationSystem::GetGridFunction().

  {
    return *GetShared(field_name);
  }

GetShared()

template<typename T>

std::shared_ptr<T> Moose::MFEM::NamedFieldsMap< T >::GetShared ( const std::string &  field_name ) const

inline

Returns a shared pointer to the field. This is guaranteed to return a non-null shared pointer.

Definition at line 74 of file MFEMContainers.h.

Referenced by Moose::MFEM::TimeDependentEquationSystem::BuildBilinearForms(), Moose::MFEM::ComplexEquationSystem::BuildBilinearForms(), Moose::MFEM::EquationSystem::BuildBilinearForms(), Moose::MFEM::ComplexEquationSystem::BuildLinearForms(), Moose::MFEM::EquationSystem::BuildLinearForms(), Moose::MFEM::TimeDependentEquationSystem::BuildNonlinearForms(), Moose::MFEM::EquationSystem::BuildNonlinearForms(), Moose::MFEM::EquationSystem::ComputeNonlinearResidual(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Get(), MFEMProblem::getComplexGridFunction(), MFEMProblem::getGridFunction(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::GetRef(), Moose::MFEM::ComplexEquationSystem::Init(), Moose::MFEM::EquationSystem::Init(), and MFEMVariable::MFEMVariable().

  {
    CheckFieldIsRegistered(field_name);

    auto it = FindField(field_name);

    return EnsureFieldPointerIsNonNull(it);
  }

Has()

template<typename T>

bool Moose::MFEM::NamedFieldsMap< T >::Has ( const std::string &  field_name ) const

inline

Predicate to check if a field is registered with name field_name.

Definition at line 68 of file MFEMContainers.h.

Referenced by Moose::MFEM::ComplexEquationSystem::AddComplexEssentialBCs(), Moose::MFEM::EquationSystem::AddEssentialBC(), Moose::MFEM::TimeDependentEquationSystem::AddKernel(), Moose::MFEM::ComplexEquationSystem::ApplyComplexEssentialBC(), Moose::MFEM::EquationSystem::ApplyEssentialBC(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::CheckFieldIsRegistered(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::CheckFieldIsRegistrable(), Moose::MFEM::TimeDependentEquationSystem::EliminateCoupledVariables(), Moose::MFEM::EquationSystem::FormJacobianMatrix(), MFEMProblem::getMFEMVariableMesh(), Moose::MFEM::ComplexEquationSystem::Init(), Moose::MFEM::EquationSystem::Init(), MultiAppMFEMCopyTransfer::transferVariables(), and MultiAppMFEMShapeEvaluationTransfer::transferVariables().

  {
    return FindField(field_name) != end();
  }

Register() [1/2]

template<typename T>

template<class FieldType , class... FieldArgs>

void Moose::MFEM::NamedFieldsMap< T >::Register ( const std::string &  field_name, FieldArgs &&...  args  )

inline

Construct new field with name field_name and register.

Definition at line 49 of file MFEMContainers.h.

Referenced by Moose::MFEM::ComplexEquationSystem::AddComplexEssentialBCs(), Moose::MFEM::EquationSystem::AddEssentialBC(), MFEMProblem::addFESpace(), MFEMProblem::addFESpaceHierarchy(), MFEMProblem::addGridFunction(), Moose::MFEM::TimeDependentEquationSystem::AddKernel(), MFEMProblem::addSubMesh(), Moose::MFEM::TimeDependentEquationSystem::BuildBilinearForms(), Moose::MFEM::ComplexEquationSystem::BuildBilinearForms(), Moose::MFEM::EquationSystem::BuildBilinearForms(), Moose::MFEM::ComplexEquationSystem::BuildLinearForms(), Moose::MFEM::EquationSystem::BuildLinearForms(), Moose::MFEM::TimeDependentEquationSystem::BuildMixedBilinearForms(), Moose::MFEM::TimeDependentEquationSystem::BuildNonlinearForms(), Moose::MFEM::EquationSystem::BuildNonlinearForms(), Moose::MFEM::ComplexEquationSystem::Init(), Moose::MFEM::EquationSystem::Init(), and Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Register().

  {
    Register(field_name, std::make_shared<FieldType>(std::forward<FieldArgs>(args)...));
  }

Register() [2/2]

template<typename T>

void Moose::MFEM::NamedFieldsMap< T >::Register ( const std::string &  field_name, std::shared_ptr< T >  field  )

inline

Register association between field and field_name.

Definition at line 55 of file MFEMContainers.h.

  {
    CheckFieldIsRegistrable(field_name, field.get());

    Deregister(field_name);

    _field_map[field_name] = std::move(field);
  }

size()

template<typename T>

int Moose::MFEM::NamedFieldsMap< T >::size ( )

inline

Returns the number of elements in the map.

Definition at line 127 of file MFEMContainers.h.

Referenced by dataStore(), and Moose::MFEM::ComplexEquationSystem::Init().

{ return _field_map.size(); }

Member Data Documentation

_field_map

template<typename T>

MapType Moose::MFEM::NamedFieldsMap< T >::_field_map {}

private

Definition at line 173 of file MFEMContainers.h.

Referenced by Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::begin(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Deregister(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::DeregisterAll(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::end(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::FindField(), Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::Register(), and Moose::MFEM::NamedFieldsMap< mfem::ParNonlinearForm >::size().

---

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

• include/mfem/containers/MFEMContainers.h