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.
См. Начало работы с TensorBoard для получения дополнительных примеров эффективного использования tf.summary.scalar.
В общем случае, это API предполагает, что точки данных регистрируются с монотонно возрастающим значением шага. Точки с одинаковым шагом или точки, записанные в неупорядоченном порядке по шагу, не гарантированно отобразятся в TensorBoard должным образом.
| Аргументы | |
|---|---|
name | Имя этого свода. Тег сводки, используемый для TensorBoard, будет этим именем, дополненным любыми активными именованными областями. |
data | Действительное числовое скалярное значение, преобразуемое в float32 Tensor. |
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