src/main/cpp/numerics4cpp/root/newton.h

00001 /*
00002  * Copyright (c) 2005, DoodleProject
00003  * All rights reserved.
00004  * 
00005  * Redistribution and use in source and binary forms, with or without
00006  * modification, are permitted provided that the following conditions
00007  * are met:
00008  * 
00009  * Redistributions of source code must retain the above copyright
00010  * notice, this list of conditions and the following disclaimer.
00011  * 
00012  * Redistributions in binary form must reproduce the above copyright
00013  * notice, this list of conditions and the following disclaimer in
00014  * the documentation and/or other materials provided with the
00015  * distribution.
00016  * 
00017  * Neither the name of DoodleProject nor the names of its contributors
00018  * may be used to endorse or promote products derived from this
00019  * software without specific prior written permission.
00020  * 
00021  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
00022  * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
00023  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
00024  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
00025  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
00026  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
00027  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
00028  * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
00029  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
00030  * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
00031  * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
00032  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00033  * SUCH DAMAGE.
00034  */
00035 
00036 #ifndef _NUMERICS4CPP_ROOT_NEWTON_H_
00037 #define _NUMERICS4CPP_ROOT_NEWTON_H_
00038 
00039 #include <cmath>
00040 #include <limits>
00041 #include "../iterativemethod.h"
00042 #include "../math.h"
00043 
00044 NUM_NAMESPACE_BEGIN
00045 
00072 template<class Function>
00073 class newton_root_finder : public iterative_method {
00074 
00075 public:
00083         newton_root_finder(Function& f, Function& d, unsigned int iterations = 100,
00084         double relative_error = 1.0e-15)
00085         : iterative_method(iterations, relative_error), _function(f),
00086           _derivative(d)
00087     {
00088         }
00089         
00096         double find_root(double x0) {
00097         double ret;
00098         
00099         if (is_nan(x0)) {
00100             ret = std::numeric_limits<double>::quiet_NaN();
00101         } else {
00102             unsigned int n = 0;
00103             double x = x0;
00104             double error;
00105             double delta;
00106             double fx;
00107             double dx;
00108             do {
00109                 ++n;
00110                 fx = _function(x);
00111                 dx = _derivative(x);
00112                 delta = fx / dx;
00113                 
00114                 error = std::max(std::fabs(fx), std::fabs(delta / x));
00115                 x = x - delta;
00116             } while (n < maximum_iterations() &&
00117                 error > maximum_relative_error());
00118                 
00119             if (n >= maximum_iterations()) {
00120                 throw convergence_exception(
00121                     "Newton's method failed to converge.");
00122             }
00123             
00124             ret = x;
00125         }
00126         
00127         return ret;
00128         }
00129                         
00130 private:
00132     Function& _function;
00133 
00135     Function& _derivative;
00136 };
00137 
00138 NUM_NAMESPACE_END
00139 
00140 #endif

Generated on Wed Nov 21 22:22:15 2007 for numerics4c++ by  doxygen 1.5.3