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