/* *****************************************************************
MESQUITE -- The Mesh Quality Improvement Toolkit
Copyright 2004 Sandia Corporation and Argonne National
Laboratory. Under the terms of Contract DE-AC04-94AL85000
with Sandia Corporation, the U.S. Government retains certain
rights in this software.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
(lgpl.txt) along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
[email protected], [email protected], [email protected],
[email protected], [email protected], [email protected]
***************************************************************** */
/*!
\file ConjugateGradient.hpp
\brief
Conjugate Gradient minimization method ...
\author Michael Brewer
\date 2002-06/19
*/
#ifndef Mesquite_ConjugateGradient_hpp
#define Mesquite_ConjugateGradient_hpp
#include "Mesquite.hpp"
#include "VertexMover.hpp"
#include "PatchData.hpp"
#include "PatchSetUser.hpp"
namespace MBMesquite
{
class ObjectiveFunction;
/*! \class ConjugateGradient
\brief Optimizes the objective function using the Polack-Ribiere scheme.
*/
class ConjugateGradient : public VertexMover, public PatchSetUser
{
public:
MESQUITE_EXPORT ConjugateGradient( ObjectiveFunction* objective );<--- Class 'ConjugateGradient' has a constructor with 1 argument that is not explicit. [+]Class 'ConjugateGradient' has a constructor with 1 argument that is not explicit. Such constructors should in general be explicit for type safety reasons. Using the explicit keyword in the constructor means some mistakes when using the class can be avoided.
MESQUITE_EXPORT ConjugateGradient( ObjectiveFunction* objective, MsqError& err );
MESQUITE_EXPORT virtual ~ConjugateGradient();
MESQUITE_EXPORT virtual std::string get_name() const;
virtual PatchSet* get_patch_set();
//! Just for debugging purposes or for obtaining more data
//! during the optimization process.
MESQUITE_EXPORT void set_debugging_level( int new_lev )
{
conjGradDebug = new_lev;
}
protected:
//! Initialize data for smoothing process
virtual void initialize( PatchData& pd, MsqError& err );
virtual void optimize_vertex_positions( PatchData& pd, MsqError& err );
virtual void initialize_mesh_iteration( PatchData& pd, MsqError& err );
virtual void terminate_mesh_iteration( PatchData& pd, MsqError& err );
//! Delete arrays initially created in initialize().
virtual void cleanup();
//! Returns the step distance to take in the search direction.
double get_step( PatchData& pd, double f0, int& j, MsqError& err );
//! Culls the vertex list free_vertex_list.
// void cull_list(PatchData &pd, double beta, MsqError &err);
private:
std::vector< Vector3D > fGrad, pGrad, fNewGrad;
PatchDataVerticesMemento* pMemento;
// just for debugging
int conjGradDebug;
};
} // namespace MBMesquite
#endif