# TaoSetTolerances
Sets parameters used in Tao convergence tests 
## Synopsis
```
#include "petsctao.h" 
PetscErrorCode TaoSetTolerances(Tao tao, PetscReal gatol, PetscReal grtol, PetscReal gttol)
```
Logically collective on tao


## Input Parameters

- ***tao -*** the Tao context
- ***gatol -*** stop if norm of gradient is less than this
- ***grtol -*** stop if relative norm of gradient is less than this
- ***gttol -*** stop if norm of gradient is reduced by this factor



## Options Database Keys

- ***-tao_gatol <gatol> -*** Sets gatol
- ***-tao_grtol <grtol> -*** Sets grtol
- ***-tao_gttol <gttol> -*** Sets gttol



## Stopping Criteria
```none
||g(X)||                            <= gatol
```
```none
||g(X)|| / |f(X)|                   <= grtol
```
```none
||g(X)|| / ||g(X0)||                <= gttol
```


## Notes
Use PETSC_DEFAULT to leave one or more tolerances unchanged.




## See Also
 `TaoGetTolerances()`


## Level
beginner

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/tao/interface/taosolver.c.html#TaoSetTolerances">src/tao/interface/taosolver.c</A>

## Examples
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/tao/unconstrained/tutorials/burgers_spectral.c.html">src/tao/unconstrained/tutorials/burgers_spectral.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/tao/unconstrained/tutorials/rosenbrock2.c.html">src/tao/unconstrained/tutorials/rosenbrock2.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/tao/unconstrained/tutorials/rosenbrock3.c.html">src/tao/unconstrained/tutorials/rosenbrock3.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/tao/unconstrained/tutorials/spectraladjointassimilation.c.html">src/tao/unconstrained/tutorials/spectraladjointassimilation.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/tao/constrained/tutorials/ex1.c.html">src/tao/constrained/tutorials/ex1.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/tao/constrained/tutorials/maros.c.html">src/tao/constrained/tutorials/maros.c.html</A><BR>


---
[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](/docs/manualpages/index.md)  
[Index of all manual pages](/docs/manualpages/singleindex.md)  
