Spec-Zone.ru › TensorFlow 2.9

tf.summary.image

Просмотреть исходный код на GitHub

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

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

См. также 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/versions/r2.9/api_docs/python/tf/summary/image

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API