tensorflow::ops::DepthToSpace

#include <array_ops.h>

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

Краткое содержание

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

  • Фрагменты данных размером block_size * block_size из глубины перестраиваются в непересекающиеся блоки размером block_size x block_size
  • Ширина выходного тензора равна input_depth * block_size , а высота — input_height * block_size .
  • Координаты Y и X внутри каждого блока выходного изображения определяются высокопорядковой компонентой индекса входного канала.
  • Глубина входного тензора должна быть делима на block_size * 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,iY,iX,bY,bX,oC (где n = индекс пакета, iX, iY — координаты X или Y во входном изображении, bX, bY — координаты в выходном блоке, oC — выходные каналы). Выход будет представлять собой входные данные, преобразованные в следующую структуру: n,iY,bY,iX,bX,oC

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

Например, если на вход подаются данные формы [1, 1, 1, 4] , формат данных = "NHWC" и размер блока = 2: 

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

  

  
This operation will output a tensor of shape [1, 2, 2, 1]:

  

    
   [[[[1], [2]],
     [[3], [4]]]]
 Здесь на вход поступает пакет из 1 элемента, каждый элемент пакета имеет форму [1, 1, 4] , соответствующий выход будет содержать 2x2 элемента и иметь глубину 1 канал (1 = 4 / (block_size * block_size) ). Форма выходного элемента — [2, 2, 1] .
 Для входного тензора большей глубины, в данном случае формы [1, 1, 1, 12] , например 
x = [[[[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]]]]
 При размере блока, равном 2, эта операция вернет следующий тензор формы [1, 2, 2, 3] 
   [[[[1, 2, 3], [4, 5, 6]],
     [[7, 8, 9], [10, 11, 12]]]]
  

  
Similarly, for the following input of shape [1 2 2 4], and a block size of 2:

  

    
x =  [[[[1, 2, 3, 4],
       [5, 6, 7, 8]],
      [[9, 10, 11, 12],
       [13, 14, 15, 16]]]]
 Оператор вернет следующий тензор формы [1 4 4 1] : 
x = [[[ [1],   [2],  [5],  [6]],
      [ [3],   [4],  [7],  [8]],
      [ [9],  [10], [13],  [14]],
      [ [11], [12], [15],  [16]]]]
  

  
Arguments:
    
      
  • scope: A Scope object
    • 
      
  • block_size: The size of the spatial block, same as in Space2Depth.
    • 
    

  
Returns:

                                              




        
Constructors and Destructors

      		





        DepthToSpace(const ::tensorflow::Scope & scope, ::tensorflow::Input input, int64 block_size)
        

      		





        DepthToSpace(const ::tensorflow::Scope & scope, ::tensorflow::Input input, int64 block_size, const DepthToSpace::Attrs & attrs)
        

      		




                                                          




        
Public attributes

      		





        operation
      

        
      





        output
      

        
      




                                                                              




        
Public functions

      		





        node() const 
      

        

          ::tensorflow::Node *
        

      		





        operator::tensorflow::Input() const 
      

        

          
        

      		





        operator::tensorflow::Output() const 
      

        

          
        

      		




                                      




        
Public static functions

      		





        DataFormat(StringPiece x)
      

        
      




                                      




        
Structs

      		





        tensorflow::ops::DepthToSpace::Attrs
      

        
Optional attribute setters for DepthToSpace. 

      		




  
Public attributes

  

    
operation

    
Operation operation
 выход 
::tensorflow::Output output
 Общественные функции 
 ГлубинаВКосмос 
 DepthToSpace(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  int64 block_size
)
 ГлубинаВКосмос 
 DepthToSpace(
  const ::tensorflow::Scope & scope,
  ::tensorflow::Input input,
  int64 block_size,
  const DepthToSpace::Attrs & attrs
)
 узел 
::tensorflow::Node * node() const 
 оператор::tensorflow::Input 
 operator::tensorflow::Input() const 
 оператор::tensorflow::Output 
 operator::tensorflow::Output() const 
 Открытые статические функции 
 Формат данных 
Attrs DataFormat(
  StringPiece x
)