tf.summary.image

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

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

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

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

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

Записывает коллекцию изображений в текущий писатель сводок по умолчанию. Данные отображаются на панели «Images» в 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` или целочисленный `Tensor` ранга 0. На каждом шаге будет выведено не более этого количества изображений. Если передано больше `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