# tf.estimator.experimental.stop_if_no_decrease_hook

<br />

|---|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 2 version](https://www.tensorflow.org/api_docs/python/tf/estimator/experimental/stop_if_no_decrease_hook) | [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/estimator/tree/master/tensorflow_estimator/python/estimator/early_stopping.py) |

Creates hook to stop if metric does not decrease within given max steps.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.estimator.experimental.stop_if_no_decrease_hook`](https://www.tensorflow.org/api_docs/python/tf/estimator/experimental/stop_if_no_decrease_hook), \`tf.compat.v2.estimator.experimental.stop_if_no_decrease_hook\`

<br />

    tf.estimator.experimental.stop_if_no_decrease_hook(
        estimator, metric_name, max_steps_without_decrease, eval_dir=None, min_steps=0,
        run_every_secs=60, run_every_steps=None
    )

#### Usage example:

    estimator = ...
    # Hook to stop training if loss does not decrease in over 100000 steps.
    hook = early_stopping.stop_if_no_decrease_hook(estimator, "loss", 100000)
    train_spec = tf.estimator.TrainSpec(..., hooks=[hook])
    tf.estimator.train_and_evaluate(estimator, train_spec, ...)

Caveat: Current implementation supports early-stopping both training and
evaluation in local mode. In distributed mode, training can be stopped but
evaluation (where it's a separate job) will indefinitely wait for new model
checkpoints to evaluate, so you will need other means to detect and stop it.
Early-stopping evaluation in distributed mode requires changes in
`train_and_evaluate` API and will be addressed in a future revision.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `estimator` | A [`tf.estimator.Estimator`](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/estimator/Estimator) instance. |
| `metric_name` | `str`, metric to track. "loss", "accuracy", etc. |
| `max_steps_without_decrease` | `int`, maximum number of training steps with no decrease in the given metric. |
| `eval_dir` | If set, directory containing summary files with eval metrics. By default, `estimator.eval_dir()` will be used. |
| `min_steps` | `int`, stop is never requested if global step is less than this value. Defaults to 0. |
| `run_every_secs` | If specified, calls `should_stop_fn` at an interval of `run_every_secs` seconds. Defaults to 60 seconds. Either this or `run_every_steps` must be set. |
| `run_every_steps` | If specified, calls `should_stop_fn` every `run_every_steps` steps. Either this or `run_every_secs` must be set. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| An early-stopping hook of type `SessionRunHook` that periodically checks if the given metric shows no decrease over given maximum number of training steps, and initiates early stopping if true. ||

<br />