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