tf.compat.v1.summary.image

Выводит буфер протокола Summary с изображениями.

tf.compat.v1.summary.image(
    name, tensor, max_outputs=3, collections=None, family=None
)

Для обеспечения совместимости при вызове в TF2, когда внешний контекст работает в режиме eager, этот API проверяет, доступен ли подходящий контекст средства записи сводок TF2, и, если доступен, перенаправляет вызов этому средству записи. «Подходящий» контекст средства записи означает, что это средство записи установлено как средство записи по умолчанию и для step задано соответствующее непустое значение (см. tf.summary.SummaryWriter.as_default, tf.summary.experimental.set_step или tf.compat.v1.train.create_global_step). При перенаправленном вызове аргументы будут переданы реализации TF2 для tf.summary.image, а возвращаемым значением будет пустой тензор типа bytestring, чтобы избежать дублирования записи сводок. Это перенаправление выполняется по возможности, поэтому не все аргументы будут сохранены. Кроме того:

• Операция TF2 не выполняет описанные выше этапы нормализации. Вместо масштабирования данных, выходящих за пределы ожидаемого диапазона, она просто ограничивает их.
• Операция TF2 выводит данные под одним тегом, содержащим несколько примеров, а не под несколькими тегами (то есть без суффиксов «/0» или «/1»).

Для перехода на TF2 используйте вместо этого tf.summary.image. Конкретные шаги по переходу см. в разделе «Перенос использования tf.summary на TF 2.0».

Сопоставление аргументов

Описание

Сводка содержит до max_outputs значений сводки с изображениями. Изображения создаются из tensor, который должен быть четырёхмерным и иметь форму [batch_size, height, width, channels], где channels может принимать следующие значения:

• 1: tensor интерпретируется как изображение в оттенках серого.
• 3: tensor интерпретируется как изображение RGB.
• 4: tensor интерпретируется как изображение RGBA.

Число каналов изображений совпадает с числом каналов входного тензора. Для входных данных типа float значения каждого изображения по отдельности нормализуются и приводятся к диапазону [0, 255]. Значения uint8 не изменяются. Операция использует два разных алгоритма нормализации:

• Если все входные значения положительные, они масштабируются так, чтобы наибольшее значение равнялось 255.

• Если какое-либо входное значение отрицательное, значения сдвигаются так, чтобы входному значению 0.0 соответствовало 127. Затем они масштабируются так, чтобы наименьшее значение было равно 0 или наибольшее — 255.

Значение tag в выходных protobuf-сообщениях Summary.Value формируется на основе имени; суффикс зависит от настройки max_outputs:

• Если max_outputs равно 1, тег значения сводки имеет вид «name/image».
• Если max_outputs больше 1, теги значений сводки формируются последовательно: «name/image/0», «name/image/1» и т. д.