# tensorplay.functional.unsqueeze

Source: https://www.tensorplay.cn/docs/generated/tensorplay.functional.unsqueeze.html

```python
tensorplay.functional.unsqueeze(input, dim) → Tensor
```

Returns a new tensor with a dimension of size one inserted at the
specified position.

The returned tensor shares the same underlying data with this tensor.

A dim value within the range [-input.dim() - 1, input.dim() + 1)
can be used. Negative dim will correspond to [unsqueeze()](#tensorplay.functional.unsqueeze)
applied at dim = dim + input.dim() + 1.

Parameters:

- input ([Tensor](/docs/generated/tensorplay.Tensor.html#tensorplay.Tensor)) – the input tensor.

- dim ([int](https://docs.python.org/3/builtins/functions.html#int)) – the index at which to insert the singleton dimension

Example:

```
>>> x = tensorplay.tensor([1, 2, 3, 4])
>>> tensorplay.unsqueeze(x, 0)
tensor([[ 1,  2,  3,  4]])
>>> tensorplay.unsqueeze(x, 1)
tensor([[ 1],
        [ 2],
        [ 3],
        [ 4]])
```