Spec-Zone.ru › TensorFlow 2.9

tf.summary.histogram

Просмотреть исходный код на GitHub

Записывает сводку гистограммы.

tf.summary.histogram(
    name, data, step=None, buckets=None, description=None
)

См. также tf.summary.scalar, tf.summary.SummaryWriter.

Записывает гистограмму в текущий сводный файл записи, для последующего анализа в панелях «Гистограммы» и «Распределения» TensorBoard (данные, записанные с помощью этого API, будут отображаться в обоих местах). Как и tf.summary.scalar точки, каждая гистограмма связана с step и name. Все гистограммы с одинаковым name образуют временной ряд гистограмм.

Гистограмма вычисляется по всем элементам заданного Tensor без учета его формы или ранга.

В этом примере записываются 2 гистограммы:

w = tf.summary.create_file_writer('test/logs')
with w.as_default():
    tf.summary.histogram("activations", tf.random.uniform([100, 50]), step=0)
    tf.summary.histogram("initial_weights", tf.random.normal([1000]), step=0)

Часто используемый случай — это проверка изменяющихся паттернов активации (или их отсутствия) на определённых слоях нейронной сети в течение времени.

w = tf.summary.create_file_writer('test/logs')
with w.as_default():
for step in range(100):
    # Generate fake "activations".
    activations = [
        tf.random.normal([1000], mean=step, stddev=1),
        tf.random.normal([1000], mean=step, stddev=10),
        tf.random.normal([1000], mean=step, stddev=100),
    ]

    tf.summary.histogram("layer1/activate", activations[0], step=step)
    tf.summary.histogram("layer2/activate", activations[1], step=step)
    tf.summary.histogram("layer3/activate", activations[2], step=step)
Аргументы
name Имя этой сводки. Тег сводки, используемый в TensorBoard, будет содержать это имя, дополненное любыми активными именованными областями.
data Tensor любой формы. Гистограмма вычисляется по её элементам, которые должны быть приводимы к типу float64.
step Явное int64-преобразуемое монотонное значение шага для этой сводки. Если опущено, по умолчанию используется tf.summary.experimental.get_step(), которое не должно быть равно None.
buckets Необязательное положительное int. Выход будет содержать столько ведер, сколько указано, кроме двух крайних случаев. Если данных нет, то ведер нет. Если данные есть, но все точки имеют одинаковое значение, тогда все левые и правые границы ведер совпадают и только последнее ведро имеет ненулевой счёт.
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/histogram

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API