tf.summary.FileWriter
Записывает протоколы буфера в файлы событий.
tf.summary.FileWriter(
logdir, graph=None, max_queue=10, flush_secs=120, graph_def=None,
filename_suffix=None, session=None
)
Класс FileWriter предоставляет механизм для создания файла событий в заданном каталоге и добавления в него сводок и событий. Класс обновляет содержимое файла асинхронно. Это позволяет программе обучения вызывать методы для добавления данных в файл непосредственно из цикла обучения, не замедляя обучение.
При создании с параметром tf.compat.v1.Session FileWriter вместо этого формирует слой совместимости над новыми сводками на основе графа (tf.contrib.summary), чтобы облегчить использование нового написания сводок с уже существующим кодом, который ожидает экземпляр FileWriter.
| Аргументы | |
|---|---|
logdir | Строка. Каталог, в котором будет записан файл событий. |
graph | Объект Graph, например, sess.graph. |
max_queue | Целое число. Размер очереди для ожидающих событий и сводок. |
flush_secs | Число. С какой частотой, в секундах, нужно записывать в диск ожидающие события и сводки. |
graph_def | УСТАНОВЛЕНО: Используйте аргумент graph вместо него. |
filename_suffix | Строка. Каждое имя файла событий имеет суффикс suffix. |
session | Объект tf.compat.v1.Session. См. подробности выше. |
| Исключения | |
|---|---|
RuntimeError | Если вызвана при включенном режиме выполнения eager. |
Методы
add_event
add_event(
event
)
Добавляет событие в файл событий.
| Аргументы | |
|---|---|
event | Протокол буфера Event. |
add_graph
add_graph(
graph, global_step=None, graph_def=None
)
Добавляет Graph в файл событий.
Граф, описанный протоколом буфера, будет отображен в TensorBoard. Большинство пользователей передают граф в конструктор вместо этого.
| Аргументы | |
|---|---|
graph | Объект Graph, например, sess.graph. |
global_step | Число. Дополнительный счётчик глобальной стадии для записи с графиком. |
graph_def | УСТАНОВЛЕНО. Используйте параметр graph вместо него. |
| Исключения | |
|---|---|
ValueError | Если в метод передаются как граф, так и graph_def. |
add_meta_graph
add_meta_graph(
meta_graph_def, global_step=None
)
Добавляет MetaGraphDef в файл событий.
MetaGraphDef позволяет запустить данный граф через saver.import_meta_graph().
| Аргументы | |
|---|---|
meta_graph_def | Объект MetaGraphDef, часто возвращаемый saver.export_meta_graph() . |
global_step | Число. Дополнительный счётчик глобальной стадии для записи с графиком. |
| Исключения | |
|---|---|
TypeError | Если meta_graph_def не является экземпляром MetaGraphDef. |
add_run_metadata
add_run_metadata(
run_metadata, tag, global_step=None
)
Добавляет метаинформацию для одного вызова session.run().
| Аргументы | |
|---|---|
run_metadata | Объект протокола буфера RunMetadata. |
tag | Имя тега для этой метаданных. |
global_step | Число. Дополнительный счётчик глобальной стадии для записи с StepStats. |
| Исключения | |
|---|---|
ValueError | Если предоставленный тег уже использовался для этого типа события. |
add_session_log
add_session_log(
session_log, global_step=None
)
Добавляет протокол буфера SessionLog в файл событий.
Этот метод оборачивает предоставленный сеанс в протокол буфера Event и добавляет его в файл событий.
| Аргументы | |
|---|---|
session_log | Протокол буфера SessionLog. |
global_step | Число. Дополнительное значение глобальной стадии для записи со сводкой. |
add_summary
add_summary(
summary, global_step=None
)
Добавляет протокол буфера Summary в файл событий.
Этот метод оборачивает предоставленную сводку в протокол буфера Event и добавляет её в файл событий.
Вы можете передать результат оценки любого оператора сводки, используя tf.Session.run или tf.Tensor.eval, в эту функцию. В качестве альтернативы, вы можете передать протокол буфера tf.compat.v1.Summary, который вы заполняете своими данными. Последнее часто выполняется для отчёта результатов оценки в файлах событий.
| Аргументы | |
|---|---|
summary | Протокол буфера Summary, необязательно сериализованный как строка. |
global_step | Число. Дополнительное значение глобальной стадии для записи со сводкой. |
close
close()
Записывает файл событий на диск и закрывает его.
Вызовите этот метод, когда вам больше не нужен объект записи сводок.
flush
flush()
Записывает файл событий на диск.
Вызовите этот метод, чтобы убедиться, что все ожидающие события были записаны на диск.
get_logdir
get_logdir()
Возвращает каталог, в котором будет записан файл событий.
reopen
reopen()
Переоткрывает EventFileWriter.
Можно вызвать после close(), чтобы добавить больше событий в тот же каталог. События будут записаны в новый файл событий.
Ничего не делает, если EventFileWriter не был закрыт.
__enter__
__enter__()
Возможность использования с оператором "with".
__exit__
__exit__(
unused_type, unused_value, unused_traceback
)
Возможность использования с оператором "with".
© 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/summary/FileWriter