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