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

Defines the linear algebra of a vector space on a generic partitioned vector where the individual vectors are distributed in batches defined by ROL::BatchManager. This is a batch-distributed version of ROL::PartitionedVector. More...

#include <ROL_SimulatedVector.hpp>

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

Public Types

typedef std::vector< PV >::size_type size_type
 

Public Member Functions

 SimulatedVector (const std::vector< RCPV > &vecs, const RCPBM &bman)
 
void set (const V &x)
 Set \(y \leftarrow x\) where \(y = \mathtt{*this}\). More...
 
void plus (const V &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 V &x)
 Compute \(y \leftarrow \alpha x + y\) where \(y = \mathtt{*this}\). More...
 
Real dot (const V &x) const
 Compute \( \langle y,x \rangle \) where \(y = \mathtt{*this}\). More...
 
Real norm () const
 Returns \( \| y \| \) where \(y = \mathtt{*this}\). More...
 
RCPV clone () const
 Clone to make a new (uninitialized) vector. More...
 
const Vdual (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...
 
RCPV basis (const int i) const
 Return i-th basis vector. More...
 
int dimension () const
 Return dimension of the vector space. More...
 
void zero ()
 Set to zero vector. More...
 
void applyUnary (const Elementwise::UnaryFunction< Real > &f)
 
void applyBinary (const Elementwise::BinaryFunction< Real > &f, const V &x)
 
Real reduce (const Elementwise::ReductionOp< Real > &r) const
 
Teuchos::RCP< const Vector< Real > > get (size_type i) const
 
Teuchos::RCP< Vector< Real > > get (size_type i)
 
void set (size_type i, const V &x)
 
void zero (size_type i)
 
size_type numVectors () const
 
- Public Member Functions inherited from ROL::Vector< Real >
virtual ~Vector ()
 
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 Types

typedef Vector< Real > V
 
typedef Teuchos::RCP< VRCPV
 
typedef Teuchos::RCP< BatchManager< Real > > RCPBM
 
typedef SimulatedVector< Real > PV
 

Private Attributes

const std::vector< RCPVvecs_
 
Teuchos::RCP< BatchManager< Real > > bman_
 
std::vector< RCPVdual_vecs_
 
Teuchos::RCP< PVdual_pvec_
 

Detailed Description

template<class Real>
class ROL::SimulatedVector< Real >

Defines the linear algebra of a vector space on a generic partitioned vector where the individual vectors are distributed in batches defined by ROL::BatchManager. This is a batch-distributed version of ROL::PartitionedVector.

Definition at line 62 of file ROL_SimulatedVector.hpp.

Member Typedef Documentation

◆ V

template<class Real>
typedef Vector<Real> ROL::SimulatedVector< Real >::V
private

Definition at line 64 of file ROL_SimulatedVector.hpp.

◆ RCPV

template<class Real>
typedef Teuchos::RCP<V> ROL::SimulatedVector< Real >::RCPV
private

Definition at line 65 of file ROL_SimulatedVector.hpp.

◆ RCPBM

template<class Real>
typedef Teuchos::RCP<BatchManager<Real> > ROL::SimulatedVector< Real >::RCPBM
private

Definition at line 66 of file ROL_SimulatedVector.hpp.

◆ PV

template<class Real>
typedef SimulatedVector<Real> ROL::SimulatedVector< Real >::PV
private

Definition at line 67 of file ROL_SimulatedVector.hpp.

◆ size_type

template<class Real>
typedef std::vector<PV>::size_type ROL::SimulatedVector< Real >::size_type

Definition at line 76 of file ROL_SimulatedVector.hpp.

Constructor & Destructor Documentation

◆ SimulatedVector()

template<class Real>
ROL::SimulatedVector< Real >::SimulatedVector ( const std::vector< RCPV > &  vecs,
const RCPBM bman 
)
inline

Member Function Documentation

◆ set() [1/2]

template<class Real>
void ROL::SimulatedVector< Real >::set ( const V x)
inlinevirtual

Set \(y \leftarrow x\) where \(y = \mathtt{*this}\).

Parameters
[in]xis a vector.
   On return \form#18.
   Uses #zero and #plus methods for the computation.
   Please overload if a more efficient implementation is needed.

   ---

Reimplemented from ROL::Vector< Real >.

Definition at line 84 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::get(), ROL::SimulatedVector< Real >::numVectors(), and ROL::SimulatedVector< Real >::vecs_.

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

◆ plus()

template<class Real>
void ROL::SimulatedVector< Real >::plus ( const V 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 97 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::get(), ROL::SimulatedVector< Real >::numVectors(), and ROL::SimulatedVector< Real >::vecs_.

◆ scale()

template<class Real>
void ROL::SimulatedVector< 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 110 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

◆ axpy()

template<class Real>
void ROL::SimulatedVector< Real >::axpy ( const Real  alpha,
const V 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 116 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::get(), ROL::SimulatedVector< Real >::numVectors(), and ROL::SimulatedVector< Real >::vecs_.

◆ dot()

template<class Real>
Real ROL::SimulatedVector< Real >::dot ( const V 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 129 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::bman_, ROL::SimulatedVector< Real >::get(), ROL::SimulatedVector< Real >::numVectors(), and ROL::SimulatedVector< Real >::vecs_.

◆ norm()

template<class Real>
Real ROL::SimulatedVector< 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 148 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::bman_, and ROL::SimulatedVector< Real >::vecs_.

◆ clone()

template<class Real>
RCPV ROL::SimulatedVector< 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 160 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::bman_, and ROL::SimulatedVector< Real >::vecs_.

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

◆ dual()

template<class Real>
const V& ROL::SimulatedVector< 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 171 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::bman_, ROL::SimulatedVector< Real >::dual_pvec_, ROL::SimulatedVector< Real >::dual_vecs_, and ROL::SimulatedVector< Real >::vecs_.

Referenced by ROL::SimulatedVector< Real >::SimulatedVector().

◆ basis()

template<class Real>
RCPV ROL::SimulatedVector< 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 181 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::clone(), ROL::SimulatedVector< Real >::dimension(), ROL::SimulatedVector< Real >::set(), ROL::SimulatedVector< Real >::vecs_, and ROL::SimulatedVector< Real >::zero().

◆ dimension()

template<class Real>
int ROL::SimulatedVector< 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 217 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

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

◆ zero() [1/2]

template<class Real>
void ROL::SimulatedVector< Real >::zero ( )
inlinevirtual

Set to zero vector.

Uses scale by zero for the computation. Please overload if a more efficient implementation is needed.


Reimplemented from ROL::Vector< Real >.

Definition at line 225 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

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

◆ applyUnary()

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

Reimplemented from ROL::Vector< Real >.

Definition at line 232 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

◆ applyBinary()

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

◆ reduce()

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

Reimplemented from ROL::Vector< Real >.

Definition at line 247 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

◆ get() [1/2]

template<class Real>
Teuchos::RCP<const Vector<Real> > ROL::SimulatedVector< Real >::get ( size_type  i) const
inline

◆ get() [2/2]

template<class Real>
Teuchos::RCP<Vector<Real> > ROL::SimulatedVector< Real >::get ( size_type  i)
inline

Definition at line 264 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

◆ set() [2/2]

template<class Real>
void ROL::SimulatedVector< Real >::set ( size_type  i,
const V x 
)
inline

Definition at line 268 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

◆ zero() [2/2]

template<class Real>
void ROL::SimulatedVector< Real >::zero ( size_type  i)
inline

Definition at line 272 of file ROL_SimulatedVector.hpp.

References ROL::SimulatedVector< Real >::vecs_.

◆ numVectors()

template<class Real>
size_type ROL::SimulatedVector< Real >::numVectors ( ) const
inline

Member Data Documentation

◆ vecs_

template<class Real>
const std::vector<RCPV> ROL::SimulatedVector< Real >::vecs_
private

◆ bman_

template<class Real>
Teuchos::RCP<BatchManager<Real> > ROL::SimulatedVector< Real >::bman_
private

◆ dual_vecs_

template<class Real>
std::vector<RCPV> ROL::SimulatedVector< Real >::dual_vecs_
mutableprivate

◆ dual_pvec_

template<class Real>
Teuchos::RCP<PV> ROL::SimulatedVector< Real >::dual_pvec_
mutableprivate

Definition at line 73 of file ROL_SimulatedVector.hpp.

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


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