doc/manual/tao.md

131 can be used to set the algorithm TAO uses to solve the application. The
145 requires quotation marks in an application program, but quotation marks
176 In all the optimization solvers, the application must provide a `Vec`
182 the application object by using the
188 routine. When using this routine, the application should initialize the
191 store the solution. Elsewhere in the application, this solution vector
192 can be retrieved from the application object by using the
199 argument and sets it to the solution vector used in the application.
209 Writing a TAO application may require use of an *application context*.
210 An application context is a structure or object defined by an
211 application developer, passed into a routine also written by the
212 application developer, and used within the routine to perform its stated
217 may be specific to an application and necessary to evaluate the
226 data specific to an application and its implementation is confined to an
229 application objects will never access this structure, so the application
231 needed by the application then a NULL pointer can be used.
237 TAO solvers that minimize an objective function require the application
239 application to evaluate derivatives of the objective function. Routines
240 that perform these computations must be identified to the application
253 argument is an application context. This routine should use the third
257 This routine, and the application context, should be passed to the
258 application object by using the
267 application context. Although the final argument may point to anything,
274 Many TAO solvers also require gradient information from the application
284 the fourth argument is the user-defined application context. Only the
290 be passed to the application object by using the
299 application context, cast to `(void*)`.
322 where the arguments are the TAO application, the optional vector to be
326 The TAO example problems demonstrate the use of these application
389 coloring of the matrix is known. If the application programmer creates a
431 intermediate application states. The user defines these constraints through
476 argument is a pointer to the user-defined application context, cast into
486 where the first and last arguments are the TAO solver object and the application
519 Once the application and solver have been set up, the solver can be
1623 is that it is easier to write an application when no derivatives need to
1824 calculation with a direct inverse application of the approximate Hessian
1838 quasi-Newton inverse application is used to precondition the Krylov
2669 prior to solving the application. The bounds, $[\ell,u]$, on the
2915 application to achieve improved performance. Additional details on the
2933 routine for any application-specific computations that should be done
3030    so application problems may conveniently switch solvers to compare
3034    by the application developer, contains limited support for finite
3053    variety of data structures while allowing application developers to
3070 application programmers, but may be necessary for solver implementations
3104 a solution. TAO will call this routine when the application program uses
3349 application makes a call to `TaoSetFromOptions()`. It should have the
3368 called when the application makes a call to `TaoView()` or when the