public final class **ExpandDims** Inserts a dimension of 1 into a tensor's shape.


Given a tensor \`input\`, this operation inserts a dimension of 1 at the
dimension index \`axis\` of \`input\`'s shape. The dimension index \`axis\` starts at
zero; if you specify a negative number for \`axis\` it is counted backward from
the end.


This operation is useful if you want to add a batch dimension to a single
element. For example, if you have a single image of shape \`\[height, width,
channels\]\`, you can make it a batch of 1 image with \`expand_dims(image, 0)\`,
which will make the shape \`\[1, height, width, channels\]\`.


Other examples:

    # 't' is a tensor of shape [2]
     shape(expand_dims(t, 0)) ==&gt; [1, 2]
     shape(expand_dims(t, 1)) ==&gt; [2, 1]
     shape(expand_dims(t, -1)) ==&gt; [2, 1]
     
     # 't2' is a tensor of shape [2, 3, 5]
     shape(expand_dims(t2, 0)) ==&gt; [1, 2, 3, 5]
     shape(expand_dims(t2, 2)) ==&gt; [2, 3, 1, 5]
     shape(expand_dims(t2, 3)) ==&gt; [2, 3, 5, 1]
     
This operation requires that:


\`-1-input.dims() \<= dim \<= input.dims()\`


This operation is related to \`squeeze()\`, which removes dimensions of
size 1.

<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/ExpandDims#asOutput())() Returns the symbolic handle of a tensor. |
| static \<T, U extends Number\> [ExpandDims](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/ExpandDims)\<T\> | [create](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/ExpandDims#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\> input, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<U\> axis) Factory method to create a class wrapping a new ExpandDims 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/ExpandDims#output())() Contains the same data as \`input\`, but its shape has an additional dimension of size 1 added. |

### 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 [ExpandDims](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/ExpandDims)\<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\> axis)

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

##### Parameters

| scope | current scope |
| axis | 0-D (scalar). Specifies the dimension index at which to expand the shape of \`input\`. Must be in the range \`\[-rank(input) - 1, rank(input)\]\`. |
|---|---|

##### Returns

- a new instance of ExpandDims

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

Contains the same data as \`input\`, but its shape has an additional
dimension of size 1 added.