tf.compat.v2.image.extract_glimpse

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

tf.compat.v2.image.extract_glimpse(
    input, size, offsets, centered=True, normalized=True, noise='uniform', 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).
Если координаты не нормализованы, они интерпретируются как количество пикселей.

Аргументы
`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) относится к центру входных изображений. Если ложно, смещение (0,0) соответствует верхнему левому углу входных изображений.
`normalized`	Необязательный `bool`. По умолчанию `True`. Указывает, нормализованы ли координаты смещения.
`noise`	Необязательный `string`. По умолчанию `uniform`. Указывает, должен ли шум быть `uniform` (равномерное распределение), `gaussian` (гауссово распределение) или `zero` (нулевое заполнение).
`name`	Имя операции (необязательно).

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

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

BATCH_SIZE = 1
IMAGE_HEIGHT = 3
IMAGE_WIDTH = 3
CHANNELS = 1
GLIMPSE_SIZE = (2, 2)
image = tf.reshape(tf.range(9, delta=1, dtype=tf.float32),
  shape=(BATCH_SIZE, IMAGE_HEIGHT, IMAGE_WIDTH, CHANNELS))
output = tf.image.extract_glimpse(image, size=GLIMPSE_SIZE,
  offsets=[[1, 1]], centered=False, normalized=False)
 ```

© 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/r1.15/api_docs/python/tf/compat/v2/image/extract_glimpse