# TaoSetMonitor

Sets an ADDITIONAL function that is to be used at every iteration of the unconstrained minimization solver to display the iteration's progress.

## Synopsis

    #include "tao_solver.h"
    int TaoSetMonitor(TAO_SOLVER tao,int (*mymonitor)(TAO_SOLVER,void*),void *mctx)

Collective on TAO_SOLVER

## Input Parameters

| tao | - the TAO_SOLVER solver context
| mymonitor | - monitoring routine
| mctx | - [optional] user-defined context for private data for the monitor routine (may be TAO_NULL)

## Calling sequence of mymonitor

        int mymonitor(TAO_SOLVER tao,void *mctx)

| tao | - the TAO_SOLVER solver context
| mctx | - [optional] monitoring context

## Options Database Keys

| -tao_monitor | - sets TaoDefaultMonitor()
| -tao_smonitor | - sets short monitor
| -tao_cancelmonitors | - cancels all monitors that have been hardwired into a code by calls to TaoSetMonitor(), but does not cancel those set via the options database.

## Notes

Several different monitoring routines may be set by calling TaoSetMonitor() multiple times; all will be called in the order in which they were set.

## Keywords

options, monitor, View

## See Also

TaoDefaultMonitor(), TaoClearMonitor(), TaoSetDestroyRoutine()

Level:intermediate
Location:src/interface/tao.c
TAO Solver Index
Table of Contents