tf.summary.scalar
Записывает сводку со скалярным значением.
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.
Дополнительные примеры эффективного использования tf.summary.scalar см. в разделе «Начало работы с TensorBoard».
Как правило, этот 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/api_docs/python/tf/summary/scalar