spaceToBatch(_:spatialAxes:batchAxis:blockDimensions:usePixelShuffleOrder:name:)
Creates a space-to-batch operation and returns the result tensor.
Declaration
func spaceToBatch(_ tensor: MPSGraphTensor, spatialAxes: [NSNumber], batchAxis: Int, blockDimensions: [NSNumber], usePixelShuffleOrder: Bool, name: String?) -> MPSGraphTensorParameters
- tensor:
The input tensor.
- spatialAxes:
The axes that define the dimensions containing the spatial blocks.
- batchAxis:
The axis that defines the destination dimension, where to copy the blocks.
- blockDimensions:
An array of numbers that defines the size of the rectangular spatial sub-block.
- usePixelShuffleOrder:
A parameter that controls layout of the sub-blocks within the batch 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 spatialAxes (for usePixelShuffleOrder=YES 1,2 or 3 axes supported, otherwise limited only by MPSNDArray rank limitations) dimensions are moved in spatial blocks with rectangular size defined by blockDimensions to the batchAxis dimension. Use the usePixelShuffleOrder parameter to control how the data within spatial blocks is ordered in the batchAxis dimension: with usePixelShuffleOrder=YES MPSGraph stores the values of the spatial blocks contiguosly within the batchAxis dimension, whereas otherwise they are stored interleaved with existing values in the batchAxis dimension. Note: This operation is the inverse of batchToSpace(_:spatialAxes:batchAxis:blockDimensions:usePixelShuffleOrder:name:). Note: This operation is a generalization of space(toDepth2DTensor:widthAxis:heightAxis:depthAxis:blockSize:usePixelShuffleOrder:name:).