tf.image.extract_glimpse

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

tf.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).
Если координаты не нормализованы, они интерпретируются как количество пикселей.

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

x = [[[[0.0],
          [1.0],
          [2.0]],
         [[3.0],
          [4.0],
          [5.0]],
         [[6.0],
          [7.0],
          [8.0]]]]
tf.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([[[[4.],
         [5.]],
        [[7.],
         [8.]]]], dtype=float32)>

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

Возвращает
`Tensor` типа `float32`.

© 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/api_docs/python/tf/image/extract_glimpse