tf.contrib.training.evaluate_once

Evaluates the model at the given checkpoint path.

During a single evaluation, the eval_ops is run until the session is interrupted or requested to finish. This is typically requested via a tf.contrib.training.StopAfterNEvalsHook which results in eval_ops running the requested number of times.

Optionally, a user can pass in final_ops, a single Tensor, a list of Tensors or a dictionary from names to Tensors. The final_ops is evaluated a single time after eval_ops has finished running and the fetched values of final_ops are returned. If final_ops is left as None, then None is returned.

One may also consider using a tf.contrib.training.SummaryAtEndHook to record summaries after the eval_ops have run. If eval_ops is None, the summaries run immediately after the model checkpoint has been restored.

Note that evaluate_once creates a local variable used to track the number of evaluations run via tf.contrib.training.get_or_create_eval_step. Consequently, if a custom local init op is provided via a scaffold, the caller should ensure that the local init op also initializes the eval step.

Args
checkpoint_path The path to a checkpoint to use for evaluation.
master The BNS address of the TensorFlow master.
scaffold An tf.compat.v1.train.Scaffold instance for initializing variables and restoring variables. Note that scaffold.init_fn is used by the function to restore the checkpoint. If you supply a custom init_fn, then it must also take care of restoring the model from its checkpoint.
eval_ops A single Tensor, a list of Tensors or a dictionary of names to Tensors, which is run until the session is requested to stop, commonly done by a tf.contrib.training.StopAfterNEvalsHook.
feed_dict The feed dictionary to use when executing the eval_ops.
final_ops A single Tensor, a list of Tensors or a dictionary of names to Tensors.
final_ops_feed_dict A feed dictionary to use when evaluating final_ops.
hooks List of tf.estimator.SessionRunHook callbacks which are run inside the evaluation loop.
config An instance of tf.compat.v1.ConfigProto that will be used to configure the Session. If left as None, the default will be used.
Returns
The fetched values of final_ops or None if final_ops is None.

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/contrib/training/evaluate_once