tf.summary.scalar
| Просмотреть исходный код на GitHub |
Записывает скалярную сводку.
tf.summary.scalar(
name, data, step=None, description=None
)
См. также tf.summary.image, tf.summary.histogram, tf.summary.SummaryWriter.
Записывает простые числовые значения для последующего анализа в TensorBoard. Записи производятся в текущем по умолчанию записывателе сводок. Каждая точка сводки связана с целочисленным step значением. Это позволяет выполнять инкрементное протоколирование временных рядов данных. Распространенное использование этого API — протоколирование потери во время обучения для построения кривой потерь.
Например:
test_summary_writer = tf.summary.create_file_writer('test/logdir')
with test_summary_writer.as_default():
tf.summary.scalar('loss', 0.345, step=1)
tf.summary.scalar('loss', 0.234, step=2)
tf.summary.scalar('loss', 0.123, step=3)
Несколько независимых временных рядов могут быть записаны, присваивая каждой серии уникальное name значение.
См. Начало работы с TensorBoard для получения дополнительных примеров эффективного использования tf.summary.scalar.
В общем случае, это API предполагает, что точки данных записываются с монотонно возрастающим значением шага. Двойные точки для одного шага или точки, записанные не в порядке шага, не гарантируют правильного отображения в TensorBoard.
| Аргументы | |
|---|---|
name | Имя для этой сводки. Тег сводки, используемый в TensorBoard, будет этим именем, дополненным любыми активными именованными областями. |
data | Действительное числовое скалярное значение, преобразуемое в float32 тензор. |
step | Явное int64-преобразуемое монотонно возрастающее значение шага для этой сводки. Если опущен, он по умолчанию равен tf.summary.experimental.get_step(), который не должен быть None. |
description | Необязательное описание для этой сводки, в виде константы str. Поддерживается Markdown. По умолчанию пустое. |
| Возвращаемое значение | |
|---|---|
| True при успехе или false, если сводка не была записана из-за отсутствия записывателя сводок по умолчанию. |
| Исключения | |
|---|---|
ValueError | если записыватель по умолчанию существует, но шаг не был указан и tf.summary.experimental.get_step() равно None. |
© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.9/api_docs/python/tf/summary/scalar
