TaoSetOptionsPrefix — PETSc 3.23.0 documentation

Skip to main content
`Ctrl`+`K`

# TaoSetOptionsPrefix

Sets the prefix used for searching for all Tao options in the database.

## Synopsis

    #include "petsctao.h"
    PetscErrorCode TaoSetOptionsPrefix(Tao tao, const char p[])

Logically Collective

## Input Parameters

- tao - the `Tao` context

- p - the prefix string to prepend to all Tao option requests

## Notes

A hyphen (-) must NOT be given at the beginning of the prefix name. The first character of all runtime options is AUTOMATICALLY the hyphen.

For example, to distinguish between the runtime options for two different Tao solvers, one could call

          TaoSetOptionsPrefix(tao1,"sys1_")
          TaoSetOptionsPrefix(tao2,"sys2_")

This would enable use of different options for each system, such as

          -sys1_tao_method blmvm -sys1_tao_grtol 1.e-3
          -sys2_tao_method lmvm  -sys2_tao_grtol 1.e-4

## See Also

TAO: Optimization Solvers, `Tao`, `TaoSetFromOptions()`, `TaoAppendOptionsPrefix()`, `TaoGetOptionsPrefix()`

## Level

advanced

## Location

src/tao/interface/taosolver.c

## Examples

src/tao/tutorials/ex4.c

Index of all Tao routines
Table of Contents for all manual pages
Index of all manual pages