libMesh::ParameterMultiAccessor< T > Class Template Reference

Accessor object allowing reading and modification of the independent variables in a parameter sensitivity calculation. More...

#include <parameter_multiaccessor.h>

Inheritance diagram for libMesh::ParameterMultiAccessor< T >:

Public Member Functions
	ParameterMultiAccessor ()
	Constructor: no parameters attached yet. More...
	ParameterMultiAccessor (const ParameterAccessor< T > &param_accessor)
	Constructor: take the first sub-accessor for the parameter. More...
	~ParameterMultiAccessor ()
virtual ParameterAccessor< T > &	operator= (T *) override
	A simple reseater won't work with a multi-accessor. More...
virtual void	set (const T &new_value) override
	Setter: change the value of the parameter we access. More...
virtual const T &	get () const override
	Getter: get the value of the parameter we access. More...
virtual std::unique_ptr< ParameterAccessor< T > >	clone () const override
void	push_back (const ParameterAccessor< T > &new_accessor)
std::size_t	size () const
ParameterProxy< T >	operator* ()
	Proxy: for backward compatibility, we allow codes to treat a ParameterAccessor as if it were a simple pointer-to-value. More...
ConstParameterProxy< T >	operator* () const

Private Attributes
std::vector< ParameterAccessor< T > * >	_accessors

Detailed Description

template<typename T = Number>
class libMesh::ParameterMultiAccessor< T >

Accessor object allowing reading and modification of the independent variables in a parameter sensitivity calculation.

This is the "default" ParameterAccessor subclass: it simply stores a user-provided pointer to the parameter, and modifies the value at that location in memory.

Author

Roy Stogner

Date

2015 Stores a user-provided pointer to a parameter.

Definition at line 47 of file parameter_multiaccessor.h.

Constructor & Destructor Documentation

ParameterMultiAccessor() [1/2]

template<typename T = Number>

libMesh::ParameterMultiAccessor< T >::ParameterMultiAccessor

(

)

Constructor: no parameters attached yet.

Definition at line 53 of file parameter_multiaccessor.h.

{}

ParameterMultiAccessor() [2/2]

template<typename T = Number>

libMesh::ParameterMultiAccessor< T >::ParameterMultiAccessor

(

const ParameterAccessor< T > &

param_accessor

)

Constructor: take the first sub-accessor for the parameter.

Definition at line 58 of file parameter_multiaccessor.h.

                                                                      :
    _accessors(1, param_accessor.clone()) {}

~ParameterMultiAccessor()

template<typename T = Number>

libMesh::ParameterMultiAccessor< T >::~ParameterMultiAccessor

(

)

Definition at line 64 of file parameter_multiaccessor.h.

References libMesh::ParameterMultiAccessor< T >::_accessors.

                            {
    for (auto & accessor : _accessors)
      delete accessor;
  }

Member Function Documentation

clone()

template<typename T = Number>

virtual std::unique_ptr<ParameterAccessor<T> > libMesh::ParameterMultiAccessor< T >::clone ( ) const

overridevirtual

Returns

A new copy of the accessor.

Implements libMesh::ParameterAccessor< T >.

Definition at line 119 of file parameter_multiaccessor.h.

References libMesh::ParameterMultiAccessor< T >::_accessors.

  {
    ParameterMultiAccessor * pmp = new ParameterMultiAccessor<T>();
    for (auto & accessor : _accessors)
      pmp->_accessors.push_back(accessor->clone().release());

    return std::unique_ptr<ParameterAccessor<T>>(pmp);
  }

get()

template<typename T = Number>

virtual const T& libMesh::ParameterMultiAccessor< T >::get ( ) const

overridevirtual

Getter: get the value of the parameter we access.

Implements libMesh::ParameterAccessor< T >.

Definition at line 103 of file parameter_multiaccessor.h.

References libMesh::ParameterMultiAccessor< T >::_accessors.

  {
    libmesh_assert(!_accessors.empty());
    const T & val = _accessors[0]->get();
#ifndef NDEBUG
    // If you're already using inconsistent parameters we can't help
    // you.
    for (std::size_t i=1; i < _accessors.size(); ++i)
      libmesh_assert_equal_to(_accessors[i]->get(), val);
#endif
    return val;
  }

operator*() [1/2]

template<typename T = Number>

ParameterProxy<T> libMesh::ParameterAccessor< T >::operator* ( )

inherited

Proxy: for backward compatibility, we allow codes to treat a ParameterAccessor as if it were a simple pointer-to-value.

We can't safely allow "Number * n = parameter_vector[p]" to compile, but we can allow "*parameter_vector[p] += deltap" to work.

Definition at line 91 of file parameter_accessor.h.

{ return ParameterProxy<T>(*this); }

operator*() [2/2]

template<typename T = Number>

ConstParameterProxy<T> libMesh::ParameterAccessor< T >::operator* ( ) const

inherited

Definition at line 93 of file parameter_accessor.h.

{ return ConstParameterProxy<T>(*this); }

operator=()

template<typename T = Number>

virtual ParameterAccessor<T>& libMesh::ParameterMultiAccessor< T >::operator= ( T *  )

overridevirtual

A simple reseater won't work with a multi-accessor.

Reimplemented from libMesh::ParameterAccessor< T >.

Definition at line 74 of file parameter_multiaccessor.h.

  {
    libmesh_error();
    return *this;
  }

push_back()

template<typename T = Number>

void libMesh::ParameterMultiAccessor< T >::push_back

(

const ParameterAccessor< T > &

new_accessor

)

Definition at line 129 of file parameter_multiaccessor.h.

References libMesh::ParameterMultiAccessor< T >::_accessors, and libMesh::ParameterAccessor< T >::clone().

                                                             {
    _accessors.push_back(new_accessor.clone().release());
  }

set()

template<typename T = Number>

virtual void libMesh::ParameterMultiAccessor< T >::set ( const T &  new_value )

overridevirtual

Setter: change the value of the parameter we access.

Implements libMesh::ParameterAccessor< T >.

Definition at line 84 of file parameter_multiaccessor.h.

References libMesh::ParameterMultiAccessor< T >::_accessors.

  {
    libmesh_assert(!_accessors.empty());
#ifndef NDEBUG
    // Compare other values to the last one we'll change
    const T & val = _accessors.back()->get();
#endif
    for (auto & accessor : _accessors)
      {
        // If you're already using inconsistent parameters we can't
        // help you.
        libmesh_assert_equal_to(accessor->get(), val);
        accessor->set(new_value);
      }
  }

size()

template<typename T = Number>

std::size_t libMesh::ParameterMultiAccessor< T >::size

(

)

const

Returns

The number of sub-accessors associated with this parameter. Useful for testing if the multi-accessor is empty/invalid.

Definition at line 138 of file parameter_multiaccessor.h.

References libMesh::ParameterMultiAccessor< T >::_accessors.

{ return _accessors.size(); }

Member Data Documentation

_accessors

template<typename T = Number>

std::vector<ParameterAccessor<T> *> libMesh::ParameterMultiAccessor< T >::_accessors

private

Definition at line 141 of file parameter_multiaccessor.h.

Referenced by libMesh::ParameterMultiAccessor< T >::clone(), libMesh::ParameterMultiAccessor< T >::get(), libMesh::ParameterMultiAccessor< T >::push_back(), libMesh::ParameterMultiAccessor< T >::set(), libMesh::ParameterMultiAccessor< T >::size(), and libMesh::ParameterMultiAccessor< T >::~ParameterMultiAccessor().

---

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

• include/systems/parameter_multiaccessor.h