ROL
Public Member Functions | Private Attributes | List of all members
ROL::Vector_SimOpt< Real > Class Template Reference

Defines the linear algebra or vector space interface for simulation-based optimization. More...

#include <ROL_Vector_SimOpt.hpp>

+ Inheritance diagram for ROL::Vector_SimOpt< Real >:

Public Member Functions

 Vector_SimOpt (const Teuchos::RCP< Vector< Real > > &vec1, const Teuchos::RCP< Vector< Real > > &vec2)
 
void plus (const Vector< Real > &x)
 Compute \(y \leftarrow y + x\), where \(y = \mathtt{*this}\). More...
 
void scale (const Real alpha)
 Compute \(y \leftarrow \alpha y\) where \(y = \mathtt{*this}\). More...
 
void axpy (const Real alpha, const Vector< Real > &x)
 Compute \(y \leftarrow \alpha x + y\) where \(y = \mathtt{*this}\). More...
 
Real dot (const Vector< Real > &x) const
 Compute \( \langle y,x \rangle \) where \(y = \mathtt{*this}\). More...
 
Real norm () const
 Returns \( \| y \| \) where \(y = \mathtt{*this}\). More...
 
Teuchos::RCP< Vector< Real > > clone () const
 Clone to make a new (uninitialized) vector. More...
 
const Vector< Real > & dual (void) const
 Return dual representation of \(\mathtt{*this}\), for example, the result of applying a Riesz map, or change of basis, or change of memory layout. More...
 
Teuchos::RCP< Vector< Real > > basis (const int i) const
 Return i-th basis vector. More...
 
void applyUnary (const Elementwise::UnaryFunction< Real > &f)
 
void applyBinary (const Elementwise::BinaryFunction< Real > &f, const Vector< Real > &x)
 
Real reduce (const Elementwise::ReductionOp< Real > &r) const
 
int dimension () const
 Return dimension of the vector space. More...
 
Teuchos::RCP< const Vector< Real > > get_1 () const
 
Teuchos::RCP< const Vector< Real > > get_2 () const
 
Teuchos::RCP< Vector< Real > > get_1 ()
 
Teuchos::RCP< Vector< Real > > get_2 ()
 
void set_1 (const Vector< Real > &vec)
 
void set_2 (const Vector< Real > &vec)
 
- Public Member Functions inherited from ROL::Vector< Real >
virtual ~Vector ()
 
virtual void zero ()
 Set to zero vector. More...
 
virtual void set (const Vector &x)
 Set \(y \leftarrow x\) where \(y = \mathtt{*this}\). More...
 
virtual std::vector< Real > checkVector (const Vector< Real > &x, const Vector< Real > &y, const bool printToStream=true, std::ostream &outStream=std::cout) const
 Verify vector-space methods. More...
 

Private Attributes

Teuchos::RCP< Vector< Real > > vec1_
 
Teuchos::RCP< Vector< Real > > vec2_
 
Teuchos::RCP< Vector< Real > > dual_vec1_
 
Teuchos::RCP< Vector< Real > > dual_vec2_
 
Teuchos::RCP< Vector_SimOpt< Real > > dual_vec_
 

Detailed Description

template<class Real>
class ROL::Vector_SimOpt< Real >

Defines the linear algebra or vector space interface for simulation-based optimization.

Definition at line 57 of file ROL_Vector_SimOpt.hpp.

Constructor & Destructor Documentation

◆ Vector_SimOpt()

template<class Real>
ROL::Vector_SimOpt< Real >::Vector_SimOpt ( const Teuchos::RCP< Vector< Real > > &  vec1,
const Teuchos::RCP< Vector< Real > > &  vec2 
)
inline

Member Function Documentation

◆ plus()

template<class Real>
void ROL::Vector_SimOpt< Real >::plus ( const Vector< Real > &  x)
inlinevirtual

Compute \(y \leftarrow y + x\), where \(y = \mathtt{*this}\).

Parameters
[in]xis the vector to be added to \(\mathtt{*this}\).
   On return \form#9.

   ---

Implements ROL::Vector< Real >.

Definition at line 72 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::get_1(), ROL::Vector_SimOpt< Real >::get_2(), ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

◆ scale()

template<class Real>
void ROL::Vector_SimOpt< Real >::scale ( const Real  alpha)
inlinevirtual

Compute \(y \leftarrow \alpha y\) where \(y = \mathtt{*this}\).

Parameters
[in]alphais the scaling of \(\mathtt{*this}\).
   On return \form#11.

   ---

Implements ROL::Vector< Real >.

Definition at line 79 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

◆ axpy()

template<class Real>
void ROL::Vector_SimOpt< Real >::axpy ( const Real  alpha,
const Vector< Real > &  x 
)
inlinevirtual

Compute \(y \leftarrow \alpha x + y\) where \(y = \mathtt{*this}\).

Parameters
[in]alphais the scaling of x.
[in]xis a vector.
   On return \form#16.
   Uses #clone, #set, #scale and #plus for the computation.
   Please overload if a more efficient implementation is needed.

   ---

Reimplemented from ROL::Vector< Real >.

Definition at line 84 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::get_1(), ROL::Vector_SimOpt< Real >::get_2(), ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

◆ dot()

template<class Real>
Real ROL::Vector_SimOpt< Real >::dot ( const Vector< Real > &  x) const
inlinevirtual

Compute \( \langle y,x \rangle \) where \(y = \mathtt{*this}\).

Parameters
[in]xis the vector that forms the dot product with \(\mathtt{*this}\).
Returns
The number equal to \(\langle \mathtt{*this}, x \rangle\).

Implements ROL::Vector< Real >.

Definition at line 91 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::get_1(), ROL::Vector_SimOpt< Real >::get_2(), ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

◆ norm()

template<class Real>
Real ROL::Vector_SimOpt< Real >::norm ( ) const
inlinevirtual

Returns \( \| y \| \) where \(y = \mathtt{*this}\).

Returns
A nonnegative number equal to the norm of \(\mathtt{*this}\).

Implements ROL::Vector< Real >.

Definition at line 97 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

Referenced by main().

◆ clone()

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::clone ( ) const
inlinevirtual

Clone to make a new (uninitialized) vector.

Returns
A reference-counted pointer to the cloned vector.

Provides the means of allocating temporary memory in ROL.


Implements ROL::Vector< Real >.

Definition at line 103 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec1_, ROL::Vector_SimOpt< Real >::vec2_, and ROL::Vector_SimOpt< Real >::Vector_SimOpt().

Referenced by ROL::Vector_SimOpt< Real >::basis(), main(), and ROL::Vector_SimOpt< Real >::Vector_SimOpt().

◆ dual()

template<class Real>
const Vector<Real>& ROL::Vector_SimOpt< Real >::dual ( void  ) const
inlinevirtual

Return dual representation of \(\mathtt{*this}\), for example, the result of applying a Riesz map, or change of basis, or change of memory layout.

Returns
A const reference to dual representation.

By default, returns the current object. Please overload if you need a dual representation.


Reimplemented from ROL::Vector< Real >.

Definition at line 107 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::dual_vec1_, ROL::Vector_SimOpt< Real >::dual_vec2_, ROL::Vector_SimOpt< Real >::dual_vec_, ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

◆ basis()

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::basis ( const int  i) const
inlinevirtual

Return i-th basis vector.

Parameters
[in]iis the index of the basis function.
Returns
A reference-counted pointer to the basis vector with index i.

Overloading the basis is only required if the default gradient implementation is used, which computes a finite-difference approximation.


Reimplemented from ROL::Vector< Real >.

Definition at line 114 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::clone(), ROL::Vector_SimOpt< Real >::dimension(), ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

◆ applyUnary()

template<class Real>
void ROL::Vector_SimOpt< Real >::applyUnary ( const Elementwise::UnaryFunction< Real > &  f)
inlinevirtual

◆ applyBinary()

template<class Real>
void ROL::Vector_SimOpt< Real >::applyBinary ( const Elementwise::BinaryFunction< Real > &  f,
const Vector< Real > &  x 
)
inlinevirtual

◆ reduce()

template<class Real>
Real ROL::Vector_SimOpt< Real >::reduce ( const Elementwise::ReductionOp< Real > &  r) const
inlinevirtual

◆ dimension()

template<class Real>
int ROL::Vector_SimOpt< Real >::dimension ( void  ) const
inlinevirtual

Return dimension of the vector space.

Returns
The dimension of the vector space, i.e., the total number of basis vectors.

Overload if the basis is overloaded.


Reimplemented from ROL::Vector< Real >.

Definition at line 154 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec1_, and ROL::Vector_SimOpt< Real >::vec2_.

Referenced by ROL::Vector_SimOpt< Real >::basis().

◆ get_1() [1/2]

template<class Real>
Teuchos::RCP<const Vector<Real> > ROL::Vector_SimOpt< Real >::get_1 ( ) const
inline

Definition at line 158 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec1_.

Referenced by ROL::SimulatedEqualityConstraint< Real >::applyAdjointHessian(), ROL::EqualityConstraint_SimOpt< Real >::applyAdjointHessian(), ROL::SimulatedEqualityConstraint< Real >::applyAdjointJacobian(), ROL::EqualityConstraint_SimOpt< Real >::applyAdjointJacobian(), ROL::Vector_SimOpt< Real >::applyBinary(), ROL::SimulatedEqualityConstraint< Real >::applyJacobian(), ROL::EqualityConstraint_SimOpt< Real >::applyJacobian(), ROL::SimulatedEqualityConstraint< Real >::applyPreconditioner(), ROL::EqualityConstraint_SimOpt< Real >::applyPreconditioner(), ROL::Vector_SimOpt< Real >::axpy(), ROL::BoundConstraint_SimOpt< Real >::checkMultipliers(), ROL::Vector_SimOpt< Real >::dot(), ROL::SimulatedObjective< Real >::gradient(), ROL::SimulatedObjectiveCVaR< Real >::gradient(), ROL::Objective_SimOpt< Real >::gradient(), ROL::SimulatedObjective< Real >::hessVec(), ROL::Objective_SimOpt< Real >::hessVec(), ROL::BoundConstraint_SimOpt< Real >::isFeasible(), ROL::Vector_SimOpt< Real >::plus(), ROL::BoundConstraint_SimOpt< Real >::project(), ROL::BoundConstraint_SimOpt< Real >::pruneActive(), ROL::BoundConstraint_SimOpt< Real >::pruneLowerActive(), ROL::BoundConstraint_SimOpt< Real >::pruneUpperActive(), ROL::BoundConstraint_SimOpt< Real >::setVectorToLowerBound(), ROL::BoundConstraint_SimOpt< Real >::setVectorToUpperBound(), ROL::Objective_SimOpt< Real >::update(), ROL::BoundConstraint_SimOpt< Real >::update(), ROL::EqualityConstraint_SimOpt< Real >::update(), ROL::SimulatedObjective< Real >::value(), ROL::SimulatedEqualityConstraint< Real >::value(), ROL::SimulatedObjectiveCVaR< Real >::value(), ROL::Objective_SimOpt< Real >::value(), and ROL::EqualityConstraint_SimOpt< Real >::value().

◆ get_2() [1/2]

template<class Real>
Teuchos::RCP<const Vector<Real> > ROL::Vector_SimOpt< Real >::get_2 ( ) const
inline

Definition at line 162 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec2_.

Referenced by ROL::SimulatedEqualityConstraint< Real >::applyAdjointHessian(), ROL::EqualityConstraint_SimOpt< Real >::applyAdjointHessian(), ROL::SimulatedEqualityConstraint< Real >::applyAdjointJacobian(), ROL::EqualityConstraint_SimOpt< Real >::applyAdjointJacobian(), ROL::Vector_SimOpt< Real >::applyBinary(), ROL::SimulatedEqualityConstraint< Real >::applyJacobian(), ROL::EqualityConstraint_SimOpt< Real >::applyJacobian(), ROL::SimulatedEqualityConstraint< Real >::applyPreconditioner(), ROL::EqualityConstraint_SimOpt< Real >::applyPreconditioner(), ROL::Vector_SimOpt< Real >::axpy(), ROL::BoundConstraint_SimOpt< Real >::checkMultipliers(), ROL::Vector_SimOpt< Real >::dot(), ROL::SimulatedObjective< Real >::gradient(), ROL::SimulatedObjectiveCVaR< Real >::gradient(), ROL::Objective_SimOpt< Real >::gradient(), ROL::SimulatedObjective< Real >::hessVec(), ROL::Objective_SimOpt< Real >::hessVec(), ROL::BoundConstraint_SimOpt< Real >::isFeasible(), ROL::Vector_SimOpt< Real >::plus(), ROL::BoundConstraint_SimOpt< Real >::project(), ROL::BoundConstraint_SimOpt< Real >::pruneActive(), ROL::BoundConstraint_SimOpt< Real >::pruneLowerActive(), ROL::BoundConstraint_SimOpt< Real >::pruneUpperActive(), ROL::BoundConstraint_SimOpt< Real >::setVectorToLowerBound(), ROL::BoundConstraint_SimOpt< Real >::setVectorToUpperBound(), ROL::Objective_SimOpt< Real >::update(), ROL::BoundConstraint_SimOpt< Real >::update(), ROL::EqualityConstraint_SimOpt< Real >::update(), ROL::SimulatedObjective< Real >::value(), ROL::SimulatedObjectiveCVaR< Real >::value(), ROL::Objective_SimOpt< Real >::value(), and ROL::EqualityConstraint_SimOpt< Real >::value().

◆ get_1() [2/2]

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::get_1 ( )
inline

Definition at line 166 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec1_.

◆ get_2() [2/2]

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::get_2 ( )
inline

Definition at line 170 of file ROL_Vector_SimOpt.hpp.

References ROL::Vector_SimOpt< Real >::vec2_.

◆ set_1()

template<class Real>
void ROL::Vector_SimOpt< Real >::set_1 ( const Vector< Real > &  vec)
inline

◆ set_2()

template<class Real>
void ROL::Vector_SimOpt< Real >::set_2 ( const Vector< Real > &  vec)
inline

Member Data Documentation

◆ vec1_

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::vec1_
private

◆ vec2_

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::vec2_
private

◆ dual_vec1_

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::dual_vec1_
mutableprivate

◆ dual_vec2_

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::Vector_SimOpt< Real >::dual_vec2_
mutableprivate

◆ dual_vec_

template<class Real>
Teuchos::RCP<Vector_SimOpt<Real> > ROL::Vector_SimOpt< Real >::dual_vec_
mutableprivate

Definition at line 63 of file ROL_Vector_SimOpt.hpp.

Referenced by ROL::Vector_SimOpt< Real >::dual().


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