tf.summary.image

Записать сводку изображения.

tf.summary.image(
    name, data, step=None, max_outputs=3, description=None
)

Используется в блокнотах

Используется в учебниках
Отображение данных изображения в TensorBoard

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

Записывает коллекцию изображений в текущий по умолчанию объект записи сводок. Данные отображаются на панели «Изображения» в TensorBoard. Как и tf.summary.scalar точки, каждая коллекция изображений связана с step и name. Все коллекции изображений с одинаковым name образуют временной ряд коллекций изображений.

В этом примере записываются 2 случайных изображения в оттенках серого:

w = tf.summary.create_file_writer('test/logs')
with w.as_default():
  image1 = tf.random.uniform(shape=[8, 8, 1])
  image2 = tf.random.uniform(shape=[8, 8, 1])
  tf.summary.image("grayscale_noise", [image1, image2], step=0)

Для предотвращения обрезки данные следует преобразовать в один из следующих типов:

значения с плавающей точкой в диапазоне [0,1], или
значения uint8 в диапазоне [0,255]

# Convert the original dtype=int32 `Tensor` into `dtype=float64`.
rgb_image_float = tf.constant([
  [[1000, 0, 0], [0, 500, 1000]],
]) / 1000
tf.summary.image("picture", [rgb_image_float], step=0)

# Convert original dtype=uint8 `Tensor` into proper range.
rgb_image_uint8 = tf.constant([
  [[1, 1, 0], [0, 0, 1]],
], dtype=tf.uint8) * 255
tf.summary.image("picture", [rgb_image_uint8], step=1)

Аргументы
`name`	Имя этой сводки. Тег сводки, используемый в TensorBoard, будет иметь это имя в префиксе, а также любые активные области имен.
`data`	`Tensor`, представляющий данные пикселей с формой `[k, h, w, c]`, где `k` — количество изображений, `h` и `w` — высота и ширина изображений, а `c` — число каналов, которое должно быть 1, 2, 3 или 4 (оттенки серого, оттенки серого с альфа-каналом, RGB, RGBA). Любой из размеров может быть статически неизвестен (т.е. `None`). Данные с плавающей точкой будут обрезаны до диапазона [0,1]. Другие типы данных будут обрезаны в разрешенный диапазон для безопасного преобразования в uint8, используя `tf.image.convert_image_dtype`.
`step`	Явное `int64`-преобразуемое монотонное значение шага для этой сводки. Если опущено, по умолчанию используется `tf.summary.experimental.get_step()`, который не должен быть None.
`max_outputs`	Необязательное `int` или целое число ранга 0 `Tensor`. Максимум, это число изображений, которое будет выведено на каждом шаге. Когда предоставляется более `max_outputs` изображений, будут использованы первые `max_outputs` изображений, а остальные будут проигнорированы.
`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/image