tf.compat.v1.nn.space_to_depth

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

tf.compat.v1.nn.space_to_depth(
    input, block_size, name=None, data_format='NHWC'
)

Переставляет блоки пространственных данных в глубину. Точнее, эта операция возвращает копию входного тензора, в которой значения из измерений 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 каждый элемент входного тензора можно задать шестью координатами, упорядоченными по убыванию значимости в расположении памяти: 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]]]]