1 |
gezelter |
1741 |
/* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ |
2 |
|
|
|
3 |
|
|
/* |
4 |
|
|
Copyright (C) 2006 Ferdinando Ametrano |
5 |
|
|
Copyright (C) 2001, 2002, 2003 Nicolas Di Césaré |
6 |
|
|
|
7 |
|
|
This file is part of QuantLib, a free-software/open-source library |
8 |
|
|
for financial quantitative analysts and developers - http://quantlib.org/ |
9 |
|
|
|
10 |
|
|
QuantLib is free software: you can redistribute it and/or modify it |
11 |
|
|
under the terms of the QuantLib license. You should have received a |
12 |
|
|
copy of the license along with this program; if not, please email |
13 |
|
|
<quantlib-dev@lists.sf.net>. The license is also available online at |
14 |
|
|
<http://quantlib.org/license.shtml>. |
15 |
|
|
|
16 |
|
|
This program is distributed in the hope that it will be useful, but WITHOUT |
17 |
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
18 |
|
|
FOR A PARTICULAR PURPOSE. See the license for more details. |
19 |
|
|
*/ |
20 |
|
|
|
21 |
|
|
/*! \file linesearch.hpp |
22 |
|
|
\brief Line search abstract class |
23 |
|
|
*/ |
24 |
|
|
|
25 |
|
|
#ifndef quantlib_optimization_line_search_h_ |
26 |
|
|
#define quantlib_optimization_line_search_h_ |
27 |
|
|
|
28 |
|
|
#include "math/DynamicVector.hpp" |
29 |
|
|
#include "optimization/EndCriteria.hpp" |
30 |
|
|
|
31 |
|
|
using namespace OpenMD; |
32 |
|
|
namespace QuantLib { |
33 |
|
|
|
34 |
|
|
class Problem; |
35 |
|
|
class Constraint; |
36 |
|
|
class EndCriteria; |
37 |
|
|
|
38 |
|
|
//! Base class for line search |
39 |
|
|
class LineSearch { |
40 |
|
|
public: |
41 |
|
|
//! Default constructor |
42 |
|
|
LineSearch(RealType = 0.0) |
43 |
|
|
: qt_(0.0), qpt_(0.0), succeed_(true) {} |
44 |
|
|
//! Destructor |
45 |
|
|
virtual ~LineSearch() {} |
46 |
|
|
|
47 |
|
|
//! return last x value |
48 |
|
|
const DynamicVector<RealType>& lastX() { return xtd_; } |
49 |
|
|
//! return last objective function value |
50 |
|
|
RealType lastFunctionValue() { return qt_; } |
51 |
|
|
//! return last gradient |
52 |
|
|
const DynamicVector<RealType>& lastGradient() { return gradient_; } |
53 |
|
|
//! return square norm of last gradient |
54 |
|
|
RealType lastGradientNorm2() { return qpt_;} |
55 |
|
|
|
56 |
|
|
bool succeed() { return succeed_; } |
57 |
|
|
|
58 |
|
|
//! Perform line search |
59 |
|
|
virtual RealType operator()(Problem& P, // Optimization problem |
60 |
|
|
EndCriteria::Type& ecType, |
61 |
|
|
const EndCriteria&, |
62 |
|
|
const RealType t_ini) = 0; // initial value of line-search step |
63 |
|
|
RealType update(DynamicVector<RealType>& params, |
64 |
|
|
const DynamicVector<RealType>& direction, |
65 |
|
|
RealType beta, |
66 |
|
|
const Constraint& constraint); |
67 |
|
|
|
68 |
|
|
//! current value of the search direction |
69 |
|
|
const DynamicVector<RealType>& searchDirection() const { return searchDirection_; } |
70 |
|
|
DynamicVector<RealType>& searchDirection() { return searchDirection_; } |
71 |
|
|
protected: |
72 |
|
|
//! current values of the search direction |
73 |
|
|
DynamicVector<RealType> searchDirection_; |
74 |
|
|
//! new x and its gradient |
75 |
|
|
DynamicVector<RealType> xtd_, gradient_; |
76 |
|
|
//! objective function value and gradient norm corresponding to xtd_ |
77 |
|
|
RealType qt_, qpt_; |
78 |
|
|
//! flag to know if linesearch succeed |
79 |
|
|
bool succeed_; |
80 |
|
|
|
81 |
|
|
}; |
82 |
|
|
} |
83 |
|
|
|
84 |
|
|
#endif |