tf.raw_ops.SpaceToBatch

SpaceToBatch для 4-D тензоров типа T.

tf.raw_ops.SpaceToBatch(
    input, paddings, block_size, name=None
)

Это устаревшая версия более универсального оператора SpaceToBatchND.

Добавляет нулевые значения, а затем переставляет (перемещает) блоки пространственных данных в пакет. Точнее, этот оператор возвращает копию входного тензора, в которой значения из измерений height и width перемещаются в измерение batch. После добавления нулевых значений размеры height и width входного тензора должны делиться на размер блока.

Атрибут block_size должен быть больше единицы. Он задает размер блока.

• Неперекрывающиеся блоки размера block_size x block size в измерениях высоты и ширины в каждой позиции переставляются в измерение пакета.
• Размер пакета выходного тензора равен batch * block_size * block_size.
• height_pad и width_pad должны делиться на block_size.

Форма выходного тензора будет следующей:

[batch*block_size*block_size, height_pad/block_size, width_pad/block_size,
 depth]

Примеры:

(1) Для следующего входного тензора формы [1, 2, 2, 1] и block_size, равного 2:

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

Выходной тензор имеет форму [4, 1, 1, 1] и следующее значение:

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

(2) Для следующего входного тензора формы [1, 2, 2, 3] и block_size, равного 2:

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

Выходной тензор имеет форму [4, 1, 1, 3] и следующее значение:

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

(3) Для следующего входного тензора формы [1, 4, 4, 1] и block_size, равного 2:

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

Выходной тензор имеет форму [4, 2, 2, 1] и следующее значение:

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

(4) Для следующего входного тензора формы [2, 2, 4, 1] и block_size, равного 2:

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

Выходной тензор имеет форму [8, 1, 2, 1] и следующее значение:

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

Помимо прочего, этот оператор полезен для преобразования разреженной свертки в обычную свертку.

paddings = [[pad_top, pad_bottom], [pad_left, pad_right]]

height_pad = pad_top + height + pad_bottom
width_pad = pad_left + width + pad_right