ROL
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | List of all members
ROL::LineSearch_U< Real > Class Template Referenceabstract

Provides interface for and implements line searches. More...

#include <ROL_LineSearch_U.hpp>

Inheritance diagram for ROL::LineSearch_U< Real >:

Public Member Functions

virtual ~LineSearch_U ()
 LineSearch_U (ParameterList &parlist)
virtual void initialize (const Vector< Real > &x, const Vector< Real > &g)
virtual void run (Real &alpha, Real &fval, int &ls_neval, int &ls_ngrad, const Real &gs, const Vector< Real > &s, const Vector< Real > &x, Objective< Real > &obj)=0
void setMaxitUpdate (Real &alpha, Real &fnew, const Real &fold)

Protected Member Functions

virtual bool status (const ELineSearchU type, int &ls_neval, int &ls_ngrad, const Real alpha, const Real fold, const Real sgold, const Real fnew, const Vector< Real > &x, const Vector< Real > &s, Objective< Real > &obj)
virtual Real getInitialAlpha (int &ls_neval, int &ls_ngrad, const Real fval, const Real gs, const Vector< Real > &x, const Vector< Real > &s, Objective< Real > &obj)
void setNextInitialAlpha (Real alpha)
bool useLocalMinimizer ()
bool takeNoStep ()

Private Member Functions

Real dirDeriv (const Vector< Real > &x, const Vector< Real > &s, const Real alpha, const Real fnew, Objective< Real > &obj)

Private Attributes

ECurvatureConditionU econd_
EDescentU edesc_
bool useralpha_
bool usePrevAlpha_
Real alpha0_
Real alpha0bnd_
int maxit_
Real c1_
Real c2_
Real c3_
Real eps_
Real fmin_
Real alphaMin_
bool acceptMin_
bool itcond_
bool FDdirDeriv_
Ptr< Vector< Real > > xtst_

Detailed Description

template<typename Real>
class ROL::LineSearch_U< Real >

Provides interface for and implements line searches.

Definition at line 27 of file ROL_LineSearch_U.hpp.

Constructor & Destructor Documentation

◆ ~LineSearch_U()

template<typename Real>
virtual ROL::LineSearch_U< Real >::~LineSearch_U ( )
inlinevirtual

Definition at line 78 of file ROL_LineSearch_U.hpp.

◆ LineSearch_U()

template<typename Real>
ROL::LineSearch_U< Real >::LineSearch_U ( ParameterList & parlist)
inline

Definition at line 81 of file ROL_LineSearch_U.hpp.

References acceptMin_, alpha0_, alpha0bnd_, alphaMin_, c1_, c2_, c3_, ROL::DESCENT_U_NONLINEARCG, econd_, edesc_, FDdirDeriv_, fmin_, itcond_, maxit_, ROL::StringToECurvatureConditionU(), ROL::StringToEDescentU(), usePrevAlpha_, useralpha_, and zero.

Referenced by ROL::BackTracking_U< Real >::BackTracking_U(), ROL::CubicInterp_U< Real >::CubicInterp_U(), ROL::IterationScaling_U< Real >::IterationScaling_U(), ROL::PathBasedTargetLevel_U< Real >::PathBasedTargetLevel_U(), and ROL::ScalarMinimizationLineSearch_U< Real >::ScalarMinimizationLineSearch_U().

Member Function Documentation

◆ dirDeriv()

template<typename Real>
Real ROL::LineSearch_U< Real >::dirDeriv ( const Vector< Real > & x,
const Vector< Real > & s,
const Real alpha,
const Real fnew,
Objective< Real > & obj )
inlineprivate

Definition at line 50 of file ROL_LineSearch_U.hpp.

References ROL::Objective< Real >::dirDeriv(), FDdirDeriv_, ROL::Vector< Real >::norm(), ROL::ROL_EPSILON(), ROL::Trial, ROL::Objective< Real >::update(), ROL::Objective< Real >::value(), and xtst_.

Referenced by status().

◆ initialize()

template<typename Real>
virtual void ROL::LineSearch_U< Real >::initialize ( const Vector< Real > & x,
const Vector< Real > & g )
inlinevirtual

Reimplemented in ROL::BackTracking_U< Real >, ROL::CubicInterp_U< Real >, ROL::IterationScaling_U< Real >, ROL::PathBasedTargetLevel_U< Real >, and ROL::ScalarMinimizationLineSearch_U< Real >.

Definition at line 117 of file ROL_LineSearch_U.hpp.

References ROL::Vector< Real >::clone(), and xtst_.

Referenced by ROL::BackTracking_U< Real >::initialize(), ROL::CubicInterp_U< Real >::initialize(), ROL::IterationScaling_U< Real >::initialize(), ROL::PathBasedTargetLevel_U< Real >::initialize(), and ROL::ScalarMinimizationLineSearch_U< Real >::initialize().

◆ run()

template<typename Real>
virtual void ROL::LineSearch_U< Real >::run ( Real & alpha,
Real & fval,
int & ls_neval,
int & ls_ngrad,
const Real & gs,
const Vector< Real > & s,
const Vector< Real > & x,
Objective< Real > & obj )
pure virtual

Implemented in ROL::BackTracking_U< Real >, ROL::CubicInterp_U< Real >, ROL::IterationScaling_U< Real >, ROL::PathBasedTargetLevel_U< Real >, and ROL::ScalarMinimizationLineSearch_U< Real >.

◆ setMaxitUpdate()

template<typename Real>
void ROL::LineSearch_U< Real >::setMaxitUpdate ( Real & alpha,
Real & fnew,
const Real & fold )
inline

Definition at line 127 of file ROL_LineSearch_U.hpp.

References acceptMin_, alphaMin_, fmin_, itcond_, and setNextInitialAlpha().

◆ status()

template<typename Real>
virtual bool ROL::LineSearch_U< Real >::status ( const ELineSearchU type,
int & ls_neval,
int & ls_ngrad,
const Real alpha,
const Real fold,
const Real sgold,
const Real fnew,
const Vector< Real > & x,
const Vector< Real > & s,
Objective< Real > & obj )
inlineprotectedvirtual

Definition at line 142 of file ROL_LineSearch_U.hpp.

References alphaMin_, c1_, c2_, c3_, ROL::CURVATURECONDITION_U_APPROXIMATEWOLFE, ROL::CURVATURECONDITION_U_GENERALIZEDWOLFE, ROL::CURVATURECONDITION_U_GOLDSTEIN, ROL::CURVATURECONDITION_U_NULL, ROL::CURVATURECONDITION_U_STRONGWOLFE, ROL::CURVATURECONDITION_U_WOLFE, ROL::DESCENT_U_NONLINEARCG, dirDeriv(), econd_, edesc_, fmin_, itcond_, ROL::LINESEARCH_U_BACKTRACKING, ROL::LINESEARCH_U_CUBICINTERP, and maxit_.

Referenced by ROL::BackTracking_U< Real >::run(), and ROL::CubicInterp_U< Real >::run().

◆ getInitialAlpha()

template<typename Real>
virtual Real ROL::LineSearch_U< Real >::getInitialAlpha ( int & ls_neval,
int & ls_ngrad,
const Real fval,
const Real gs,
const Vector< Real > & x,
const Vector< Real > & s,
Objective< Real > & obj )
inlineprotectedvirtual

Definition at line 205 of file ROL_LineSearch_U.hpp.

References alpha0_, alpha0bnd_, ROL::DESCENT_U_NONLINEARCG, ROL::DESCENT_U_STEEPEST, edesc_, ROL::ROL_EPSILON(), ROL::Trial, ROL::Objective< Real >::update(), usePrevAlpha_, useralpha_, ROL::Objective< Real >::value(), and xtst_.

Referenced by ROL::BackTracking_U< Real >::run(), ROL::CubicInterp_U< Real >::run(), ROL::IterationScaling_U< Real >::run(), and ROL::ScalarMinimizationLineSearch_U< Real >::run().

◆ setNextInitialAlpha()

template<typename Real>
void ROL::LineSearch_U< Real >::setNextInitialAlpha ( Real alpha)
inlineprotected

Definition at line 233 of file ROL_LineSearch_U.hpp.

References alpha0_, and usePrevAlpha_.

Referenced by ROL::ScalarMinimizationLineSearch_U< Real >::run(), and setMaxitUpdate().

◆ useLocalMinimizer()

template<typename Real>
bool ROL::LineSearch_U< Real >::useLocalMinimizer ( )
inlineprotected

Definition at line 239 of file ROL_LineSearch_U.hpp.

References acceptMin_, and itcond_.

◆ takeNoStep()

template<typename Real>
bool ROL::LineSearch_U< Real >::takeNoStep ( )
inlineprotected

Definition at line 243 of file ROL_LineSearch_U.hpp.

References acceptMin_, and itcond_.

Member Data Documentation

◆ econd_

template<typename Real>
ECurvatureConditionU ROL::LineSearch_U< Real >::econd_
private

Definition at line 30 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), and status().

◆ edesc_

template<typename Real>
EDescentU ROL::LineSearch_U< Real >::edesc_
private

Definition at line 31 of file ROL_LineSearch_U.hpp.

Referenced by getInitialAlpha(), LineSearch_U(), and status().

◆ useralpha_

template<typename Real>
bool ROL::LineSearch_U< Real >::useralpha_
private

Definition at line 33 of file ROL_LineSearch_U.hpp.

Referenced by getInitialAlpha(), and LineSearch_U().

◆ usePrevAlpha_

template<typename Real>
bool ROL::LineSearch_U< Real >::usePrevAlpha_
private

Definition at line 34 of file ROL_LineSearch_U.hpp.

Referenced by getInitialAlpha(), LineSearch_U(), and setNextInitialAlpha().

◆ alpha0_

template<typename Real>
Real ROL::LineSearch_U< Real >::alpha0_
private

Definition at line 35 of file ROL_LineSearch_U.hpp.

Referenced by getInitialAlpha(), LineSearch_U(), and setNextInitialAlpha().

◆ alpha0bnd_

template<typename Real>
Real ROL::LineSearch_U< Real >::alpha0bnd_
private

Definition at line 36 of file ROL_LineSearch_U.hpp.

Referenced by getInitialAlpha(), and LineSearch_U().

◆ maxit_

template<typename Real>
int ROL::LineSearch_U< Real >::maxit_
private

Definition at line 37 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), and status().

◆ c1_

template<typename Real>
Real ROL::LineSearch_U< Real >::c1_
private

Definition at line 38 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), and status().

◆ c2_

template<typename Real>
Real ROL::LineSearch_U< Real >::c2_
private

Definition at line 39 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), and status().

◆ c3_

template<typename Real>
Real ROL::LineSearch_U< Real >::c3_
private

Definition at line 40 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), and status().

◆ eps_

template<typename Real>
Real ROL::LineSearch_U< Real >::eps_
private

Definition at line 41 of file ROL_LineSearch_U.hpp.

◆ fmin_

template<typename Real>
Real ROL::LineSearch_U< Real >::fmin_
private

Definition at line 42 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), setMaxitUpdate(), and status().

◆ alphaMin_

template<typename Real>
Real ROL::LineSearch_U< Real >::alphaMin_
private

Definition at line 43 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), setMaxitUpdate(), and status().

◆ acceptMin_

template<typename Real>
bool ROL::LineSearch_U< Real >::acceptMin_
private

Definition at line 44 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), setMaxitUpdate(), takeNoStep(), and useLocalMinimizer().

◆ itcond_

template<typename Real>
bool ROL::LineSearch_U< Real >::itcond_
private

Definition at line 45 of file ROL_LineSearch_U.hpp.

Referenced by LineSearch_U(), setMaxitUpdate(), status(), takeNoStep(), and useLocalMinimizer().

◆ FDdirDeriv_

template<typename Real>
bool ROL::LineSearch_U< Real >::FDdirDeriv_
private

Definition at line 46 of file ROL_LineSearch_U.hpp.

Referenced by dirDeriv(), and LineSearch_U().

◆ xtst_

template<typename Real>
Ptr<Vector<Real> > ROL::LineSearch_U< Real >::xtst_
private

Definition at line 48 of file ROL_LineSearch_U.hpp.

Referenced by dirDeriv(), getInitialAlpha(), and initialize().

The documentation for this class was generated from the following file:
Generated by doxygen 1.15.0