tf.summary.histogram

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

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`. Выход будет иметь столько ведер, сколько указано, за исключением двух крайних случаев. Если данных нет, ведер нет. Если данные есть, но все точки имеют одно и то же значение, то левая и правая границы всех ведер совпадают, и только последнее ведро имеет ненулевой счёт. По умолчанию 30, если не указано иначе.
`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/histogram