LOCA Parameter Reference Page

As in NOX, all parameters are passed to LOCA through parameter lists defined by the Teuchos::ParameterList class. All parameters are passed to the LOCA::Stepper class during construction. Below is a listing of all of the parameters that can be passed to the stepper with links to relevant classes that use those parameters.

Stepper Parameters

The parameter list passed to the Stepper has two sublists, "LOCA" and "NOX". The "LOCA" sublist contains parameters and sublists for the Stepper and various LOCA support classes, while the "NOX" sublist contains parameters and sublists specific to NOX solvers. The NOX sublist is passed directly to an instance of the NOX::Solver::Manager class in the Stepper and therefore has the same structure as any NOX solver parameter list hierarchy. Please see the NOX Parameter Reference page for more details on the structure of this list.

User-Defined Strategies Through Parameter Lists

Most strategy choices above have another available option that is not listed above for providing user-defined strategies. To use a user-defined strategy, one must implement the corresponding strategy abstract interface (e.g., LOCA::MultiPredictor::AbstractStrategy) and instantiate an object of the user-defined type. Then set the corrsponding "Method" (or similar) parameter of the relevant sublist to "User-Defined", set the parameter "User-Defined Name" to the parameter list name of the strategy (e.g., "My Predictor"), and set the parameter with that name to be a ref-count pointer to that object with the type of the abstract strategy interface (e.g., Teuchos::RCP<LOCA::MultiPredictor::AbstractStrategy>).

User-Defined Strategies Through Factories

Another option is available for providing user-defined strategies by implementing a factory to instantiate these strategies. This option is most appropriate when multiple user-defined strategies are available, and the user wishes to control which strategy is instantiated through parameter lists. This is often used when providing strategies that are specific to the underlying NOX group, for example the Epetra and LAPACK factories described below. In this case one imlements the LOCA::Abstract::Factory by defining the relevant strategy creation methods and then passes a ref-count pointer to this factory in the LOCA::createGlobalData() call. Then the user can select these strategies just as if they were built in to LOCA.

Epetra Factory

The LOCA::Epetra::Factory provides strategies specific to the NOX::Epetra::Group. It provides the following strategies:

LAPACK Factory

The LOCA::LAPACK::Factory provides strategies specific to the NOX::LAPACK::Group. It provides the following strategies:

 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends
Generated on Wed Apr 13 09:59:40 2011 for NOX by  doxygen 1.6.3