space(toDepth2DTensor:widthAxis:heightAxis:depthAxis:blockSize:usePixelShuffleOrder:name:)
Creates a space-to-depth2D operation and returns the result tensor.
Declaration
func space(toDepth2DTensor tensor: MPSGraphTensor, widthAxis: Int, heightAxis: Int, depthAxis: Int, blockSize: Int, usePixelShuffleOrder: Bool, name: String?) -> MPSGraphTensorParameters
- tensor:
The input tensor.
- widthAxis:
The axis that defines the fastest running dimension within the block.
- heightAxis:
The axis that defines the 2nd fastest running dimension within the block.
- depthAxis:
The axis that defines the destination dimension, where to copy the blocks.
- blockSize:
The size of the square spatial sub-block.
- usePixelShuffleOrder:
A parameter that controls the layout of the sub-blocks within the depth dimension.
- name:
The name for the operation.
Return Value
A valid MPSGraphTensor object
Discussion
This operation outputs a copy of the input tensor, where values from the widthAxis and heightAxis dimensions are moved in spatial blocks of size blockSize to the depthAxis dimension. Use the usePixelShuffleOrder parameter to control how the data within spatial blocks is ordered in the depthAxis dimension: with usePixelShuffleOrder=YES MPSGraph stores the values of the spatial blocks contiguosly within the depthAxis dimension, whereas otherwise they are stored interleaved with existing values in the depthAxis dimension. This operation is the inverse of MPSGraph/depthToSpace2DTensor:widthAxis:heightAxis:depthAxis:blockSize:usePixelShuffleOrder:name:.