# Reshape

public final class **Reshape** Reshapes a tensor.


Given \`tensor\`, this operation returns a tensor that has the same values
as \`tensor\` with shape \`shape\`.


If one component of 1-D tensor \`shape\` is the special value -1, the size of that
dimension is computed so that the total size remains constant. In particular, a
\`shape\` of \`\[-1\]\` flattens into 1-D. At most one component of \`shape\` may be
unknown.


The \`shape\` must be 1-D and the operation returns a tensor with shape
\`shape\` filled with the values of \`tensor\`. In this case, the number of elements
implied by \`shape\` must be the same as the number of elements in \`tensor\`.


It is an error if \`shape\` is not 1-D.


For example:

    # tensor 't' is [1, 2, 3, 4, 5, 6, 7, 8, 9]
     # tensor 't' has shape [9]
     reshape(t, [3, 3]) ==&gt; [[1, 2, 3],
                             [4, 5, 6],
                             [7, 8, 9]]
     
     # tensor 't' is [[[1, 1], [2, 2]],
     #                [[3, 3], [4, 4]]]
     # tensor 't' has shape [2, 2, 2]
     reshape(t, [2, 4]) ==&gt; [[1, 1, 2, 2],
                             [3, 3, 4, 4]]
     
     # tensor 't' is [[[1, 1, 1],
     #                 [2, 2, 2]],
     #                [[3, 3, 3],
     #                 [4, 4, 4]],
     #                [[5, 5, 5],
     #                 [6, 6, 6]]]
     # tensor 't' has shape [3, 2, 3]
     # pass '[-1]' to flatten 't'
     reshape(t, [-1]) ==&gt; [1, 1, 1, 2, 2, 2, 3, 3, 3, 4, 4, 4, 5, 5, 5, 6, 6, 6]
     
     # -1 can also be used to infer the shape
     
     # -1 is inferred to be 9:
     reshape(t, [2, -1]) ==&gt; [[1, 1, 1, 2, 2, 2, 3, 3, 3],
                              [4, 4, 4, 5, 5, 5, 6, 6, 6]]
     # -1 is inferred to be 2:
     reshape(t, [-1, 9]) ==&gt; [[1, 1, 1, 2, 2, 2, 3, 3, 3],
                              [4, 4, 4, 5, 5, 5, 6, 6, 6]]
     # -1 is inferred to be 3:
     reshape(t, [ 2, -1, 3]) ==&gt; [[[1, 1, 1],
                                   [2, 2, 2],
                                   [3, 3, 3]],
                                  [[4, 4, 4],
                                   [5, 5, 5],
                                   [6, 6, 6]]]
     
     # tensor 't' is [7]
     # shape `[]` reshapes to a scalar
     reshape(t, []) ==&gt; 7
     
<br />

<br />

<br />

<br />

<br />

<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/Reshape#asOutput())() Returns the symbolic handle of a tensor. |
| static \<T, U extends Number\> [Reshape](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Reshape)\<T\> | [create](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Reshape#create(org.tensorflow.op.Scope,%20org.tensorflow.Operand<T>,%20org.tensorflow.Operand<U>))([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\> tensor, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<U\> shape) Factory method to create a class wrapping a new Reshape 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/Reshape#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 [Reshape](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/Reshape)\<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\> tensor, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<U\> shape)

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

##### Parameters

| scope | current scope |
| shape | Defines the shape of the output tensor. |
|---|---|

##### Returns

- a new instance of Reshape

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

<br />