# BatchToSpaceNd

public final class **BatchToSpaceNd** BatchToSpace for N-D tensors of type T.


This operation reshapes the "batch" dimension 0 into \`M + 1\` dimensions of shape
\`block_shape + \[batch\]\`, interleaves these blocks back into the grid defined by
the spatial dimensions \`\[1, ..., M\]\`, to obtain a result with the same rank as
the input. The spatial dimensions of this intermediate result are then
optionally cropped according to \`crops\` to produce the output. This is the
reverse of SpaceToBatch. See below for a precise description.

<br />

### Public Methods

|---|---|
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/BatchToSpaceNd#asOutput())() Returns the symbolic handle of a tensor. |
| static \<T, U extends Number, V extends Number\> [BatchToSpaceNd](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/BatchToSpaceNd)\<T\> | [create](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/BatchToSpaceNd#create(org.tensorflow.op.Scope,%20org.tensorflow.Operand<T>,%20org.tensorflow.Operand<U>,%20org.tensorflow.Operand<V>))([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<T\> input, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<U\> blockShape, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<V\> crops) Factory method to create a class wrapping a new BatchToSpaceNd operation. |
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [output](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/BatchToSpaceNd#output())() |

### Inherited Methods

From class [org.tensorflow.op.PrimitiveOp](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp)

|---|---|
| final boolean | [equals](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#equals(java.lang.Object))(Object obj) |
| final int | [hashCode](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#hashCode())() |
| [Operation](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation) | [op](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#op())() Returns the underlying `https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation` |
| final String | [toString](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#toString())() |

From class java.lang.Object

|---|---|
| boolean | equals(Object arg0) |
| final Class\<?\> | getClass() |
| int | hashCode() |
| final void | notify() |
| final void | notifyAll() |
| String | toString() |
| final void | wait(long arg0, int arg1) |
| final void | wait(long arg0) |
| final void | wait() |

From interface [org.tensorflow.Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)

|---|---|
| abstract [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand#asOutput())() Returns the symbolic handle of a tensor. |

## Public Methods

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**asOutput**
()

Returns the symbolic handle of a tensor.

Inputs to TensorFlow operations are outputs of another TensorFlow operation. This method is
used to obtain a symbolic handle that represents the computation of the input.

<br />

#### public static [BatchToSpaceNd](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/BatchToSpaceNd)\<T\>
**create**
([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<T\> input, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<U\> blockShape, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<V\> crops)

Factory method to create a class wrapping a new BatchToSpaceNd operation.

##### Parameters

| scope | current scope |
| input | N-D with shape \`input_shape = \[batch\] + spatial_shape + remaining_shape\`, where spatial_shape has M dimensions. |
| blockShape | 1-D with shape \`\[M\]\`, all values must be \>= 1. |
| crops | 2-D with shape \`\[M, 2\]\`, all values must be \>= 0. \`crops\[i\] = \[crop_start, crop_end\]\` specifies the amount to crop from input dimension \`i + 1\`, which corresponds to spatial dimension \`i\`. It is required that \`crop_start\[i\] + crop_end\[i\] \<= block_shape\[i\] \* input_shape\[i + 1\]\`. This operation is equivalent to the following steps: 1. Reshape \`input\` to \`reshaped\` of shape: \[block_shape\[0\], ..., block_shape\[M-1\], batch / prod(block_shape), input_shape\[1\], ..., input_shape\[N-1\]\] 2. Permute dimensions of \`reshaped\` to produce \`permuted\` of shape \[batch / prod(block_shape), input_shape\[1\], block_shape\[0\], ..., input_shape\[M\], block_shape\[M-1\], input_shape\[M+1\], ..., input_shape\[N-1\]\] 3. Reshape \`permuted\` to produce \`reshaped_permuted\` of shape \[batch / prod(block_shape), input_shape\[1\] \* block_shape\[0\], ..., input_shape\[M\] \* block_shape\[M-1\], input_shape\[M+1\], ..., input_shape\[N-1\]\] 4. Crop the start and end of dimensions \`\[1, ..., M\]\` of \`reshaped_permuted\` according to \`crops\` to produce the output of shape: \[batch / prod(block_shape), input_shape\[1\] \* block_shape\[0\] - crops\[0,0\] - crops\[0,1\], ..., input_shape\[M\] \* block_shape\[M-1\] - crops\[M-1,0\] - crops\[M-1,1\], input_shape\[M+1\], ..., input_shape\[N-1\]\] Some examples: (1) For the following input of shape \`\[4, 1, 1, 1\]\`, \`block_shape = \[2, 2\]\`, and \`crops = \[\[0, 0\], \[0, 0\]\]\`: [[[[1]]], [[[2]]], [[[3]]], [[[4]]]] The output tensor has shape \`\[1, 2, 2, 1\]\` and value: x = [[[[1], [2]], [[3], [4]]]] (2) For the following input of shape \`\[4, 1, 1, 3\]\`, \`block_shape = \[2, 2\]\`, and \`crops = \[\[0, 0\], \[0, 0\]\]\`: [[[[1, 2, 3]]], [[[4, 5, 6]]], [[[7, 8, 9]]], [[[10, 11, 12]]]] The output tensor has shape \`\[1, 2, 2, 3\]\` and value: x = [[[[1, 2, 3], [4, 5, 6]], [[7, 8, 9], [10, 11, 12]]]] (3) For the following input of shape \`\[4, 2, 2, 1\]\`, \`block_shape = \[2, 2\]\`, and \`crops = \[\[0, 0\], \[0, 0\]\]\`: x = [[[[1], [3]], [[9], [11]]], [[[2], [4]], [[10], [12]]], [[[5], [7]], [[13], [15]]], [[[6], [8]], [[14], [16]]]] The output tensor has shape \`\[1, 4, 4, 1\]\` and value: x = [[[[1],   [2],  [3],  [4]], [[5],   [6],  [7],  [8]], [[9],  [10], [11],  [12]], [[13], [14], [15],  [16]]]] (4) For the following input of shape \`\[8, 1, 3, 1\]\`, \`block_shape = \[2, 2\]\`, and \`crops = \[\[0, 0\], \[2, 0\]\]\`: x = [[[[0], [1], [3]]], [[[0], [9], [11]]], [[[0], [2], [4]]], [[[0], [10], [12]]], [[[0], [5], [7]]], [[[0], [13], [15]]], [[[0], [6], [8]]], [[[0], [14], [16]]]] The output tensor has shape \`\[2, 2, 4, 1\]\` and value: x = [[[[1],   [2],  [3],  [4]], [[5],   [6],  [7],  [8]]], [[[9],  [10], [11],  [12]], [[13], [14], [15],  [16]]]] <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> <br /> |
|---|---|

##### Returns

- a new instance of BatchToSpaceNd

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<T\>
**output**
()

<br />