:orphan: # TaoSetFromOptions Sets various Tao parameters from the options database ## Synopsis ``` #include "petsctao.h" PetscErrorCode TaoSetFromOptions(Tao tao) ``` Collective ## Input Parameter - ***tao -*** the `Tao` solver context ## Options Database Keys - ***-tao_type -*** The algorithm that Tao uses (lmvm, nls, etc.) - ***-tao_gatol -*** absolute error tolerance for ||gradient|| - ***-tao_grtol -*** relative error tolerance for ||gradient|| - ***-tao_gttol -*** reduction of ||gradient|| relative to initial gradient - ***-tao_max_it -*** sets maximum number of iterations - ***-tao_max_funcs -*** sets maximum number of function evaluations - ***-tao_fmin -*** stop if function value reaches fmin - ***-tao_steptol -*** stop if trust region radius less than - ***-tao_trust0 -*** initial trust region radius - ***-tao_monitor -*** prints function value and residual norm at each iteration - ***-tao_smonitor -*** same as tao_monitor, but truncates very small values - ***-tao_cmonitor -*** prints function value, residual, and constraint norm at each iteration - ***-tao_view_solution -*** prints solution vector at each iteration - ***-tao_view_ls_residual -*** prints least-squares residual vector at each iteration - ***-tao_view_stepdirection -*** prints step direction vector at each iteration - ***-tao_view_gradient -*** prints gradient vector at each iteration - ***-tao_draw_solution -*** graphically view solution vector at each iteration - ***-tao_draw_step -*** graphically view step vector at each iteration - ***-tao_draw_gradient -*** graphically view gradient at each iteration - ***-tao_fd_gradient -*** use gradient computed with finite differences - ***-tao_fd_hessian -*** use hessian computed with finite differences - ***-tao_mf_hessian -*** use matrix-free hessian computed with finite differences - ***-tao_cancelmonitors -*** cancels all monitors (except those set with command line) - ***-tao_view -*** prints information about the Tao after solving - ***-tao_converged_reason -*** prints the reason Tao stopped iterating ## Note To see all options, run your program with the `-help` option or consult the user's manual. Should be called after `TaoCreate()` but before `TaoSolve()` ## See Also [](ch_tao), `Tao`, `TaoCreate()`, `TaoSolve()` ## Level beginner ## Location src/tao/interface/taosolver.c ## Examples src/tao/bound/tutorials/jbearing2.c
src/tao/bound/tutorials/plate2.c
src/tao/bound/tutorials/plate2f.F90
src/tao/complementarity/tutorials/blackscholes.c
src/tao/complementarity/tutorials/minsurf1.c
src/tao/constrained/tutorials/ex1.c
src/tao/constrained/tutorials/maros.c
src/tao/constrained/tutorials/tomographyADMM.c
src/tao/leastsquares/tutorials/chwirut1.c
src/tao/leastsquares/tutorials/chwirut1f.F90
src/tao/leastsquares/tutorials/chwirut2.c
## Implementations TaoSetFromOptions_BLMVM in src/tao/bound/impls/blmvm/blmvm.c
TaoSetFromOptions_BNCG in src/tao/bound/impls/bncg/bncg.c
TaoSetFromOptions_BNK in src/tao/bound/impls/bnk/bnk.c
TaoSetFromOptions_BNTL in src/tao/bound/impls/bnk/bntl.c
TaoSetFromOptions_BNTR in src/tao/bound/impls/bnk/bntr.c
TaoSetFromOptions_BQNK in src/tao/bound/impls/bqnk/bqnk.c
TaoSetFromOptions_BQNLS in src/tao/bound/impls/bqnls/bqnls.c
TaoSetFromOptions_TRON in src/tao/bound/impls/tron/tron.c
TaoSetFromOptions_SSLS in src/tao/complementarity/impls/ssls/ssls.c
TaoSetFromOptions_ADMM in src/tao/constrained/impls/admm/admm.c
TaoSetFromOptions_ALMM in src/tao/constrained/impls/almm/almm.c
TaoSetFromOptions_IPM in src/tao/constrained/impls/ipm/ipm.c
TaoSetFromOptions_PDIPM in src/tao/constrained/impls/ipm/pdipm.c
TaoSetFromOptions_BRGN in src/tao/leastsquares/impls/brgn/brgn.c
TaoSetFromOptions_POUNDERS in src/tao/leastsquares/impls/pounders/pounders.c
TaoSetFromOptions_LCL in src/tao/pde_constrained/impls/lcl/lcl.c
TaoSetFromOptions_BQPIP in src/tao/quadratic/impls/bqpip/bqpip.c
TaoSetFromOptions_GPCG in src/tao/quadratic/impls/gpcg/gpcg.c
TaoSetFromOptions_BMRM in src/tao/unconstrained/impls/bmrm/bmrm.c
TaoSetFromOptions_CG in src/tao/unconstrained/impls/cg/taocg.c
TaoSetFromOptions_LMVM in src/tao/unconstrained/impls/lmvm/lmvm.c
TaoSetFromOptions_NM in src/tao/unconstrained/impls/neldermead/neldermead.c
TaoSetFromOptions_NLS in src/tao/unconstrained/impls/nls/nls.c
TaoSetFromOptions_NTL in src/tao/unconstrained/impls/ntl/ntl.c
TaoSetFromOptions_NTR in src/tao/unconstrained/impls/ntr/ntr.c
TaoSetFromOptions_OWLQN in src/tao/unconstrained/impls/owlqn/owlqn.c
--- [Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/tao/interface/taosolver.c) [Index of all Tao routines](index.md) [Table of Contents for all manual pages](/manualpages/index.md) [Index of all manual pages](/manualpages/singleindex.md)