ROL::HouseholderReflector< Real > Class Template Reference

Provides the interface to create a Householder reflector operator, that when applied to a vector x, produces a vector parallel to y. More...

#include <ROL_HouseholderReflector.hpp>

Inheritance diagram for ROL::HouseholderReflector< Real >:

Public Member Functions
	HouseholderReflector (const ROL::Ptr< const Vector< Real > > &x, const ROL::Ptr< const Vector< Real > > &y)
	HouseholderReflector (const ROL::Ptr< const Vector< Real > > &x, const ROL::Ptr< const Vector< Real > > &y, ROL::Ptr< Vector< Real > > &scratch)
	HouseholderReflector (const ROL::Ptr< const Vector< Real > > &x)
	HouseholderReflector (const ROL::Ptr< const Vector< Real > > &x, ROL::Ptr< Vector< Real > > &scratch)
void	apply (Vector< Real > &Hv, const Vector< Real > &v, Real &tol) const
void	applyInverse (Vector< Real > &Hv, const Vector< Real > &v, Real &tol) const
Public Member Functions inherited from ROL::ROL::LinearOperator< Real >
virtual	~LinearOperator ()
virtual void	update (const Vector< Real > &x, bool flag=true, int iter=-1)
	Update linear operator.
virtual void	apply (Vector< Real > &Hv, const Vector< Real > &v, Real &tol) const =0
	Apply linear operator.
virtual void	applyInverse (Vector< Real > &Hv, const Vector< Real > &v, Real &tol) const
	Apply inverse of linear operator.
virtual void	applyAdjoint (Vector< Real > &Hv, const Vector< Real > &v, Real &tol) const
	Apply adjoint of linear operator.
virtual void	applyAdjointInverse (Vector< Real > &Hv, const Vector< Real > &v, Real &tol) const
	Apply adjoint of the inverse linear operator.

Private Types
typedef Vector< Real >	V

Private Attributes
const ROL::Ptr< const V >	x_
const ROL::Ptr< const V >	y_
ROL::Ptr< V >	u_

Detailed Description

template<class Real>
class ROL::HouseholderReflector< Real >

Provides the interface to create a Householder reflector operator, that when applied to a vector x, produces a vector parallel to y.

Forms the linear operator H such that

\[Hv = (I-2u\otimes u) x = \frac{||x||}{||y||} y \]

where

\[\hat u = x + \operatorname{sign}(\langle x,u\rangle)\frac{||x||}{||y||}y,\quad u = \frac{\hat u}{||\hat u||} \]

If y is not specified, it is taken to be the first canonical vector

---

Definition at line 41 of file ROL_HouseholderReflector.hpp.

Member Typedef Documentation

V

template<class Real>

typedef Vector<Real> ROL::HouseholderReflector< Real >::V

private

Definition at line 43 of file ROL_HouseholderReflector.hpp.

Constructor & Destructor Documentation

HouseholderReflector() [1/4]

template<class Real>

ROL::HouseholderReflector< Real >::HouseholderReflector ( const ROL::Ptr< const Vector< Real > > & x, const ROL::Ptr< const Vector< Real > > & y )

inline

Definition at line 54 of file ROL_HouseholderReflector.hpp.

References u_, x_, and y_.

HouseholderReflector() [2/4]

template<class Real>

ROL::HouseholderReflector< Real >::HouseholderReflector ( const ROL::Ptr< const Vector< Real > > & x, const ROL::Ptr< const Vector< Real > > & y, ROL::Ptr< Vector< Real > > & scratch )

inline

Definition at line 58 of file ROL_HouseholderReflector.hpp.

References u_, x_, and y_.

HouseholderReflector() [3/4]

template<class Real>

ROL::HouseholderReflector< Real >::HouseholderReflector ( const ROL::Ptr< const Vector< Real > > & x )

inline

Definition at line 62 of file ROL_HouseholderReflector.hpp.

References u_, x_, and y_.

HouseholderReflector() [4/4]

template<class Real>

ROL::HouseholderReflector< Real >::HouseholderReflector ( const ROL::Ptr< const Vector< Real > > & x, ROL::Ptr< Vector< Real > > & scratch )

inline

Definition at line 64 of file ROL_HouseholderReflector.hpp.

References u_, x_, and y_.

Member Function Documentation

apply()

template<class Real>

void ROL::HouseholderReflector< Real >::apply ( Vector< Real > & Hv, const Vector< Real > & v, Real & tol ) const

inline

Definition at line 69 of file ROL_HouseholderReflector.hpp.

References ROL::Vector< Real >::axpy(), ROL::Vector< Real >::set(), u_, x_, and y_.

Referenced by applyInverse(), and main().

applyInverse()

template<class Real>

void ROL::HouseholderReflector< Real >::applyInverse ( Vector< Real > & Hv, const Vector< Real > & v, Real & tol ) const

inline

Definition at line 87 of file ROL_HouseholderReflector.hpp.

References apply().

Member Data Documentation

x_

template<class Real>

const ROL::Ptr<const V> ROL::HouseholderReflector< Real >::x_

private

Definition at line 47 of file ROL_HouseholderReflector.hpp.

Referenced by apply(), HouseholderReflector(), HouseholderReflector(), HouseholderReflector(), and HouseholderReflector().

y_

template<class Real>

const ROL::Ptr<const V> ROL::HouseholderReflector< Real >::y_

private

Definition at line 48 of file ROL_HouseholderReflector.hpp.

Referenced by apply(), HouseholderReflector(), HouseholderReflector(), HouseholderReflector(), and HouseholderReflector().

u_

template<class Real>

ROL::Ptr<V> ROL::HouseholderReflector< Real >::u_

private

Definition at line 50 of file ROL_HouseholderReflector.hpp.

Referenced by apply(), HouseholderReflector(), HouseholderReflector(), HouseholderReflector(), and HouseholderReflector().

---

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

• ROL_HouseholderReflector.hpp