tf.compat.v1.image.extract_glimpse

Извлекает фрагмент из входного тензора.

tf.compat.v1.image.extract_glimpse(
    input, size, offsets, centered=True, normalized=True, uniform_noise=True,
    name=None
)

Возвращает набор окон, называемых фрагментами, извлечёнными в позиции offsets из входного тензора. Если окна частично накладываются на входные данные, то неперекрытые области будут заполнены случайным шумом.

Результат — тензор 4-го ранга с формой [batch_size, glimpse_height, glimpse_width, channels]. Размеры каналов и батчей совпадают с размерами входного тензора. Высота и ширина выходных окон задаются в параметре size.

Аргументы normalized и centered управляют тем, как строятся окна:

Если координаты нормализованы, но не центрированы, 0,0 и 1,0 соответствуют минимальному и максимальному значениям по каждой высоте и ширине.
Если координаты нормализованы и центрированы, они находятся в диапазоне от -1,0 до 1,0. Координаты (-1,0, -1,0) соответствуют верхнему левому углу, нижний правый угол расположен в (1,0, 1,0), а центр в (0, 0).
Если координаты не нормализованы, они интерпретируются как количество пикселей.

Пример использования:

x = [[[[0.0],
          [1.0],
          [2.0]],
         [[3.0],
          [4.0],
          [5.0]],
         [[6.0],
          [7.0],
          [8.0]]]]
tf.compat.v1.image.extract_glimpse(x, size=(2, 2), offsets=[[1, 1]],
                                   centered=False, normalized=False)
<tf.Tensor: shape=(1, 2, 2, 1), dtype=float32, numpy=
array([[[[0.],
         [1.]],
        [[3.],
         [4.]]]], dtype=float32)>

Аргументы
`input`	A `Tensor` типа `float32`. 4-мерный плавающий тензор с формой `[batch_size, height, width, channels]`.
`size`	A `Tensor` типа `int32`. 1-мерный тензор из 2 элементов, содержащий размер извлекаемых фрагментов. Высота фрагмента должна быть указана первой, а затем ширина.
`offsets`	A `Tensor` типа `float32`. 2-мерный целочисленный тензор с формой `[batch_size, 2]` , содержащий координаты y и x центра каждого окна.
`centered`	Необязательный `bool`. По умолчанию `True`. Указывает, являются ли координаты смещения центрированными относительно изображения, в этом случае смещение (0, 0) относится к центру входных изображений. Если значение false, смещение (0,0) соответствует верхнему левому углу входных изображений.
`normalized`	Необязательный `bool`. По умолчанию `True`. Указывает, нормализованы ли координаты смещения.
`uniform_noise`	Необязательный `bool`. По умолчанию `True`. Указывает, должен ли шум генерироваться с помощью равномерного или гауссова распределения.
`name`	Имя операции (необязательно).

Возвращаемое значение
A `Tensor` типа `float32`.

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r2.4/api_docs/python/tf/compat/v1/image/extract_glimpse