xref: /petsc/src/tao/bound/impls/bqnk/bqnktl.c (revision 414d97d33157b14bf619cafd0d5a004382ae017e)
1e0ed867bSAlp Dener #include <../src/tao/bound/impls/bqnk/bqnk.h>
2e0ed867bSAlp Dener 
33850be85SAlp Dener /*MC
43850be85SAlp Dener   TAOBQNKTL - Bounded Quasi-Newton-Krylov Trust-region with Line-search fallback, for nonlinear
53850be85SAlp Dener               minimization with bound constraints. This method approximates the Hessian-vector
63850be85SAlp Dener               product using a limited-memory quasi-Newton formula, and iteratively inverts the
73850be85SAlp Dener               Hessian with a Krylov solver. The quasi-Newton matrix and its settings can be
83850be85SAlp Dener               accessed via the prefix `-tao_bqnk_`
93850be85SAlp Dener 
103850be85SAlp Dener   Options Database Keys:
113850be85SAlp Dener + -tao_bqnk_max_cg_its - maximum number of bounded conjugate-gradient iterations taken in each Newton loop
123850be85SAlp Dener . -tao_bqnk_init_type - trust radius initialization method ("constant", "direction", "interpolation")
133850be85SAlp Dener . -tao_bqnk_update_type - trust radius update method ("step", "direction", "interpolation")
143850be85SAlp Dener - -tao_bqnk_as_type - active-set estimation method ("none", "bertsekas")
153850be85SAlp Dener 
163850be85SAlp Dener   Level: beginner
173850be85SAlp Dener M*/
18e0ed867bSAlp Dener PETSC_EXTERN PetscErrorCode TaoCreate_BQNKTL(Tao tao)
19e0ed867bSAlp Dener {
20*414d97d3SAlp Dener   TAO_BNK        *bnk;
21*414d97d3SAlp Dener   TAO_BQNK       *bqnk;
22e0ed867bSAlp Dener   PetscErrorCode ierr;
23e0ed867bSAlp Dener 
24e0ed867bSAlp Dener   PetscFunctionBegin;
25e0ed867bSAlp Dener   ierr = TaoCreate_BQNK(tao);CHKERRQ(ierr);
26*414d97d3SAlp Dener   bnk = (TAO_BNK*)tao->data;
27*414d97d3SAlp Dener   bqnk = (TAO_BQNK*)bnk->ctx;
28*414d97d3SAlp Dener   bqnk->solve = TaoSolve_BNTL;
29e0ed867bSAlp Dener   PetscFunctionReturn(0);
30e0ed867bSAlp Dener }
31