tf.raw_ops.SpaceToDepth

SpaceToDepth для тензоров типа T.

tf.raw_ops.SpaceToDepth(
    input, block_size, data_format='NHWC', name=None
)

Переупорядочивает блоки пространственных данных в глубину. Более конкретно, этот оператор выводит копию входного тензора, где значения из height и width измерений перемещаются в depth измерение. Атрибут block_size указывает размер блока входных данных.

• Неперекрывающиеся блоки размера block_size x block size переупорядочиваются в глубину в каждой позиции.
• Глубина выходного тензора составляет block_size * block_size * input_depth.
• Координаты Y, X внутри каждого блока входных данных становятся старшим компонентом индекса выходного канала.
• Высота и ширина входного тензора должны быть кратны block_size.

Атрибут data_format определяет расположение входного и выходного тензоров со следующими вариантами: "NHWC": [ batch, height, width, channels ] "NCHW": [ batch, channels, height, width ] "NCHW_VECT_C": qint8 [ batch, channels / 4, height, width, 4 ]

Полезно рассматривать операцию как преобразование 6-мерного тензора. Например, для data_format = NHWC, каждый элемент в входном тензоре может быть указан с помощью 6 координат, упорядоченных по убыванию значимости в макете памяти как: n,oY,bY,oX,bX,iC (где n=индекс партии, oX, oY означает координаты X или Y в выходном изображении, bX, bY означает координаты внутри входного блока, iC означает входные каналы). Выход будет транспонирован в следующий макет: n,oY,oX,bY,bX,iC

Этот оператор полезен для изменения размера активаций между свертками (но сохраняя все данные), например, вместо пулинга. Он также полезен для обучения чисто сверточных моделей.

Например, при входных данных формы [1, 2, 2, 1], data_format = "NHWC" и block_size = 2:

x = [[[[1], [2]],
      [[3], [4]]]]

Этот оператор выведет тензор формы [1, 1, 1, 4]:

[[[[1, 2, 3, 4]]]]

Здесь вход имеет партию 1, и каждый элемент партии имеет форму [2, 2, 1], соответствующий вывод будет иметь единственный элемент (т.е. ширина и высота обе равны 1) и будет иметь глубину 4 канала (1 * block_size * block_size). Форма элемента вывода составляет [1, 1, 4].

Для входного тензора с большей глубиной, например, формы [1, 2, 2, 3],

x = [[[[1, 2, 3], [4, 5, 6]],
      [[7, 8, 9], [10, 11, 12]]]]

Этот оператор, для block_size 2, вернёт следующий тензор формы [1, 1, 1, 12]

[[[[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]]]]

Аналогично, для следующего входного тензора формы [1 4 4 1], и размера блока 2:

x = [[[[1],   [2],  [5],  [6]],
      [[3],   [4],  [7],  [8]],
      [[9],  [10], [13],  [14]],
      [[11], [12], [15],  [16]]]]

оператор вернёт следующий тензор формы [1 2 2 4]:

x = [[[[1, 2, 3, 4],
       [5, 6, 7, 8]],
      [[9, 10, 11, 12],
       [13, 14, 15, 16]]]]