code: def summary_iterator(path):
      # pylint: disable=line-too-long
      """Returns a iterator for reading `Event` protocol buffers from an event file.
  
      You can use this function to read events written to an event file. It returns
      a Python iterator that yields `Event` protocol buffers.
  
      Example: Print the contents of an events file.
  
      ```python
      for e in tf.compat.v1.train.summary_iterator(path to events file):
          print(e)
      ```
  
      Example: Print selected summary values.
  
      ```python
      # This example supposes that the events file contains summaries with a
      # summary value tag 'loss'.  These could have been added by calling
      # `add_summary()`, passing the output of a scalar summary op created with
      # with: `tf.compat.v1.summary.scalar('loss', loss_tensor)`.
      for e in tf.compat.v1.train.summary_iterator(path to events file):
          for v in e.summary.value:
              if v.tag == 'loss':
                  print(tf.make_ndarray(v.tensor))
      ```
      Example: Continuously check for new summary values.
  
      ```python
      summaries = tf.compat.v1.train.summary_iterator(path to events file)
      while True:
        for e in summaries:
            for v in e.summary.value:
                if v.tag == 'loss':
                    print(tf.make_ndarray(v.tensor))
        # Wait for a bit before checking the file for any new events
        time.sleep(wait time)
      ```
  
      See the protocol buffer definitions of
      [Event](https://www.tensorflow.org/code/tensorflow/core/util/event.proto)
      and
      [Summary](https://www.tensorflow.org/code/tensorflow/core/framework/summary.proto)
      for more information about their attributes.
  
      Args:
        path: The path to an event file created by a `SummaryWriter`.
  
      Returns:
        A iterator that yields `Event` protocol buffers
      """
      return _SummaryIterator(path)
  
file_path: tensorflow/tensorflow/python/summary/summary_iterator.py
imports: from tensorflow.core.util import event_pb2
  from tensorflow.python.lib.io import tf_record
  from tensorflow.python.util.tf_export import tf_export
label_desc: Use image node_id 1 for calling a global function with example usage: summary_iterator(path) and returns: _SummaryIterator