Ipopt::IpoptApplication Class Reference

This is the main application class for making calls to Ipopt. More...

#include <IpIpoptApplication.hpp>

Inheritance diagram for Ipopt::IpoptApplication:

Inheritance graph
[legend]
Collaboration diagram for Ipopt::IpoptApplication:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 IpoptApplication (bool create_console_out=true, bool create_empty=false)
 IpoptApplication (SmartPtr< RegisteredOptions > reg_options, SmartPtr< OptionsList > options, SmartPtr< Journalist > jnlst)
 Another constructor that assumes that the code in the (default) constructor has already been executed.
virtual ~IpoptApplication ()
SmartPtr< IpoptApplicationclone ()
 Method for creating a new IpoptApplication that uses the same journalist and registered options, and a copy of the options list.
ApplicationReturnStatus Initialize (std::string params_file="ipopt.opt")
 Initialize method.
ApplicationReturnStatus Initialize (std::istream &is)
bool OpenOutputFile (std::string file_name, EJournalLevel print_level)
 Method for opening an output file with given print_level.
Solve methods
ApplicationReturnStatus OptimizeTNLP (const SmartPtr< TNLP > &tnlp)
 Solve a problem that inherits from TNLP.
ApplicationReturnStatus OptimizeNLP (const SmartPtr< NLP > &nlp)
 Solve a problem that inherits from NLP.
ApplicationReturnStatus OptimizeNLP (const SmartPtr< NLP > &nlp, SmartPtr< AlgorithmBuilder > &alg_builder)
 Solve a problem that inherits from NLP.
ApplicationReturnStatus ReOptimizeTNLP (const SmartPtr< TNLP > &tnlp)
 Solve a problem (that inherits from TNLP) for a repeated time.
ApplicationReturnStatus ReOptimizeNLP (const SmartPtr< NLP > &nlp)
 Solve a problem (that inherits from NLP) for a repeated time.
Accessor methods
SmartPtr< JournalistJnlst ()
 Get the Journalist for printing output.
SmartPtr< RegisteredOptionsRegOptions ()
 Get a pointer to RegisteredOptions object to add new options.
SmartPtr< OptionsListOptions ()
 Get the options list for setting options.
SmartPtr< const OptionsListOptions () const
 Get the options list for setting options (const version).
SmartPtr< SolveStatisticsStatistics ()
 Get the object with the statistics about the most recent optimization run.
SmartPtr< IpoptNLPIpoptNLPObject ()
 Get the IpoptNLP Object.
SmartPtr< IpoptDataIpoptDataObject ()
 Get the IpoptData Object.
SmartPtr< IpoptCalculatedQuantitiesIpoptCQObject ()
 Get the IpoptCQ Object.
SmartPtr< IpoptAlgorithmAlgorithmObject ()
 Get the Algorithm Object.

Static Public Member Functions

static void RegisterAllIpoptOptions (const SmartPtr< RegisteredOptions > &roptions)
 Method to registering all Ipopt options.
Methods for IpoptTypeInfo
static void RegisterOptions (SmartPtr< RegisteredOptions > roptions)

Private Member Functions

ApplicationReturnStatus call_optimize ()
 Method for the actual optimize call of the Ipopt algorithm.
Default Compiler Generated Methods
(Hidden to avoid implicit creation/calling). These methods are not implemented and we do not want the compiler to implement them for us, so we declare them private and do not define them. This ensures that they will not be implicitly created/called.

 IpoptApplication (const IpoptApplication &)
 Copy Constructor.
void operator= (const IpoptApplication &)
 Overloaded Equals Operator.

Private Attributes

SmartPtr< Journalistjnlst_
 Journalist for reporting output.
SmartPtr< RegisteredOptionsreg_options_
 RegisteredOptions.
SmartPtr< OptionsListoptions_
 OptionsList used for the application.
SmartPtr< SolveStatisticsstatistics_
 Object for storing statistics about the most recent optimization run.
SmartPtr< IpoptAlgorithmalg_
 Object with the algorithm sceleton.
SmartPtr< IpoptNLPip_nlp_
 IpoptNLP Object for the NLP.
SmartPtr< IpoptDataip_data_
 IpoptData Object for the NLP.
SmartPtr< IpoptCalculatedQuantitiesip_cq_
 IpoptCalculatedQuantities Object for the NLP.
SmartPtr< NLPnlp_adapter_
 Pointer to the TNLPAdapter used to convert the TNLP to an NLP.
Variables that customize the application behavior
bool read_params_dat_
 Decide whether or not the ipopt.opt file should be read.
Algorithmic parameters
bool inexact_algorithm_
 Flag indicating if we are to use the inexact linear solver option.
bool replace_bounds_
 Flag indicating if all bounds should be replaced by inequality constraints.
bool skip_finalize_solution_call_
 Flag indicating if the NLP:FinalizeSolution method should not be called after optimization.

Detailed Description

This is the main application class for making calls to Ipopt.

Definition at line 35 of file IpIpoptApplication.hpp.


Constructor & Destructor Documentation

Ipopt::IpoptApplication::IpoptApplication ( bool  create_console_out = true,
bool  create_empty = false 
)

Ipopt::IpoptApplication::IpoptApplication ( SmartPtr< RegisteredOptions reg_options,
SmartPtr< OptionsList options,
SmartPtr< Journalist jnlst 
)

Another constructor that assumes that the code in the (default) constructor has already been executed.

virtual Ipopt::IpoptApplication::~IpoptApplication (  )  [virtual]

Ipopt::IpoptApplication::IpoptApplication ( const IpoptApplication  )  [private]

Copy Constructor.


Member Function Documentation

SmartPtr<IpoptApplication> Ipopt::IpoptApplication::clone (  ) 

Method for creating a new IpoptApplication that uses the same journalist and registered options, and a copy of the options list.

ApplicationReturnStatus Ipopt::IpoptApplication::Initialize ( std::string  params_file = "ipopt.opt"  ) 

Initialize method.

This method reads the params file and initializes the journalists. You should call this method at some point before the first optimize call. Note: you can skip the processing of a params file by setting params_file to "". It returns something other than Solve_Succeeded if there was a problem in the initialization (such as an invalid option).

ApplicationReturnStatus Ipopt::IpoptApplication::Initialize ( std::istream &  is  ) 

ApplicationReturnStatus Ipopt::IpoptApplication::OptimizeTNLP ( const SmartPtr< TNLP > &  tnlp  ) 

Solve a problem that inherits from TNLP.

ApplicationReturnStatus Ipopt::IpoptApplication::OptimizeNLP ( const SmartPtr< NLP > &  nlp  ) 

Solve a problem that inherits from NLP.

ApplicationReturnStatus Ipopt::IpoptApplication::OptimizeNLP ( const SmartPtr< NLP > &  nlp,
SmartPtr< AlgorithmBuilder > &  alg_builder 
)

Solve a problem that inherits from NLP.

ApplicationReturnStatus Ipopt::IpoptApplication::ReOptimizeTNLP ( const SmartPtr< TNLP > &  tnlp  ) 

Solve a problem (that inherits from TNLP) for a repeated time.

The OptimizeTNLP method must have been called before. The TNLP must be the same object, and the structure (number of variables and constraints and position of nonzeros in Jacobian and Hessian must be the same).

ApplicationReturnStatus Ipopt::IpoptApplication::ReOptimizeNLP ( const SmartPtr< NLP > &  nlp  ) 

Solve a problem (that inherits from NLP) for a repeated time.

The OptimizeNLP method must have been called before. The NLP must be the same object, and the structure (number of variables and constraints and position of nonzeros in Jacobian and Hessian must be the same).

bool Ipopt::IpoptApplication::OpenOutputFile ( std::string  file_name,
EJournalLevel  print_level 
)

Method for opening an output file with given print_level.

Returns false if there was a problem.

SmartPtr<Journalist> Ipopt::IpoptApplication::Jnlst (  )  [inline]

Get the Journalist for printing output.

Definition at line 97 of file IpIpoptApplication.hpp.

References jnlst_.

SmartPtr<RegisteredOptions> Ipopt::IpoptApplication::RegOptions (  )  [inline]

Get a pointer to RegisteredOptions object to add new options.

Definition at line 104 of file IpIpoptApplication.hpp.

References reg_options_.

SmartPtr<OptionsList> Ipopt::IpoptApplication::Options (  )  [inline]

Get the options list for setting options.

Definition at line 110 of file IpIpoptApplication.hpp.

References options_.

SmartPtr<const OptionsList> Ipopt::IpoptApplication::Options (  )  const [inline]

Get the options list for setting options (const version).

Definition at line 116 of file IpIpoptApplication.hpp.

References Ipopt::ConstPtr(), and options_.

SmartPtr<SolveStatistics> Ipopt::IpoptApplication::Statistics (  ) 

Get the object with the statistics about the most recent optimization run.

SmartPtr<IpoptNLP> Ipopt::IpoptApplication::IpoptNLPObject (  ) 

Get the IpoptNLP Object.

SmartPtr<IpoptData> Ipopt::IpoptApplication::IpoptDataObject (  ) 

Get the IpoptData Object.

SmartPtr<IpoptCalculatedQuantities> Ipopt::IpoptApplication::IpoptCQObject (  ) 

Get the IpoptCQ Object.

SmartPtr<IpoptAlgorithm> Ipopt::IpoptApplication::AlgorithmObject (  ) 

Get the Algorithm Object.

static void Ipopt::IpoptApplication::RegisterOptions ( SmartPtr< RegisteredOptions roptions  )  [static]

static void Ipopt::IpoptApplication::RegisterAllIpoptOptions ( const SmartPtr< RegisteredOptions > &  roptions  )  [static]

Method to registering all Ipopt options.

void Ipopt::IpoptApplication::operator= ( const IpoptApplication  )  [private]

Overloaded Equals Operator.

ApplicationReturnStatus Ipopt::IpoptApplication::call_optimize (  )  [private]

Method for the actual optimize call of the Ipopt algorithm.

This is used both for Optimize and ReOptimize


Member Data Documentation

bool Ipopt::IpoptApplication::read_params_dat_ [private]

Decide whether or not the ipopt.opt file should be read.

Definition at line 173 of file IpIpoptApplication.hpp.

SmartPtr<Journalist> Ipopt::IpoptApplication::jnlst_ [private]

Journalist for reporting output.

Definition at line 177 of file IpIpoptApplication.hpp.

Referenced by Jnlst().

SmartPtr<RegisteredOptions> Ipopt::IpoptApplication::reg_options_ [private]

RegisteredOptions.

Definition at line 180 of file IpIpoptApplication.hpp.

Referenced by RegOptions().

SmartPtr<OptionsList> Ipopt::IpoptApplication::options_ [private]

OptionsList used for the application.

Definition at line 183 of file IpIpoptApplication.hpp.

Referenced by Options().

SmartPtr<SolveStatistics> Ipopt::IpoptApplication::statistics_ [private]

Object for storing statistics about the most recent optimization run.

Definition at line 187 of file IpIpoptApplication.hpp.

SmartPtr<IpoptAlgorithm> Ipopt::IpoptApplication::alg_ [private]

Object with the algorithm sceleton.

Definition at line 191 of file IpIpoptApplication.hpp.

SmartPtr<IpoptNLP> Ipopt::IpoptApplication::ip_nlp_ [private]

IpoptNLP Object for the NLP.

We keep this around for a ReOptimize warm start.

Definition at line 195 of file IpIpoptApplication.hpp.

SmartPtr<IpoptData> Ipopt::IpoptApplication::ip_data_ [private]

IpoptData Object for the NLP.

We keep this around for a ReOptimize warm start.

Definition at line 200 of file IpIpoptApplication.hpp.

SmartPtr<IpoptCalculatedQuantities> Ipopt::IpoptApplication::ip_cq_ [private]

IpoptCalculatedQuantities Object for the NLP.

We keep this around for a ReOptimize warm start.

Definition at line 205 of file IpIpoptApplication.hpp.

SmartPtr<NLP> Ipopt::IpoptApplication::nlp_adapter_ [private]

Pointer to the TNLPAdapter used to convert the TNLP to an NLP.

We keep this around for the ReOptimizerTNLP call.

Definition at line 209 of file IpIpoptApplication.hpp.

bool Ipopt::IpoptApplication::inexact_algorithm_ [private]

Flag indicating if we are to use the inexact linear solver option.

Definition at line 214 of file IpIpoptApplication.hpp.

bool Ipopt::IpoptApplication::replace_bounds_ [private]

Flag indicating if all bounds should be replaced by inequality constraints.

This is necessary for the inexact algorithm.

Definition at line 217 of file IpIpoptApplication.hpp.

bool Ipopt::IpoptApplication::skip_finalize_solution_call_ [private]

Flag indicating if the NLP:FinalizeSolution method should not be called after optimization.

Definition at line 220 of file IpIpoptApplication.hpp.


The documentation for this class was generated from the following file:
Generated on Fri Jul 17 03:03:28 2009 by  doxygen 1.4.7