Note

Click here to download the full example code

# What is PyTorch?¶

It’s a Python-based scientific computing package targeted at two sets of audiences:

- A replacement for NumPy to use the power of GPUs
- a deep learning research platform that provides maximum flexibility and speed

## Getting Started¶

### Tensors¶

Tensors are similar to NumPy’s ndarrays, with the addition being that Tensors can also be used on a GPU to accelerate computing.

```
from __future__ import print_function
import torch
```

Note

An uninitialized matrix is declared, but does not contain definite known values before it is used. When an uninitialized matrix is created, whatever values were in the allocated memory at the time will appear as the initial values.

Construct a 5x3 matrix, uninitialized:

```
x = torch.empty(5, 3)
print(x)
```

Out:

```
tensor([[2.4835e+27, 2.5428e+30, 1.0877e-19],
[1.5163e+23, 2.2012e+12, 3.7899e+22],
[5.2480e+05, 1.0175e+31, 9.7056e+24],
[1.6283e+32, 3.7913e+22, 3.9653e+28],
[1.0876e-19, 6.2027e+26, 2.3685e+21]])
```

Construct a randomly initialized matrix:

```
x = torch.rand(5, 3)
print(x)
```

Out:

```
tensor([[0.5458, 0.6207, 0.0637],
[0.4878, 0.5333, 0.5271],
[0.6966, 0.1288, 0.4597],
[0.6524, 0.3026, 0.5655],
[0.7118, 0.5281, 0.3327]])
```

Construct a matrix filled zeros and of dtype long:

```
x = torch.zeros(5, 3, dtype=torch.long)
print(x)
```

Out:

```
tensor([[0, 0, 0],
[0, 0, 0],
[0, 0, 0],
[0, 0, 0],
[0, 0, 0]])
```

Construct a tensor directly from data:

```
x = torch.tensor([5.5, 3])
print(x)
```

Out:

```
tensor([5.5000, 3.0000])
```

or create a tensor based on an existing tensor. These methods will reuse properties of the input tensor, e.g. dtype, unless new values are provided by user

```
x = x.new_ones(5, 3, dtype=torch.double) # new_* methods take in sizes
print(x)
x = torch.randn_like(x, dtype=torch.float) # override dtype!
print(x) # result has the same size
```

Out:

```
tensor([[1., 1., 1.],
[1., 1., 1.],
[1., 1., 1.],
[1., 1., 1.],
[1., 1., 1.]], dtype=torch.float64)
tensor([[-2.0440, -1.8390, 0.1495],
[ 0.9634, 1.1194, -1.2680],
[-0.7892, -1.0663, 0.9175],
[ 1.1596, 1.9360, -0.8163],
[-0.8623, -0.4153, 0.5346]])
```

Get its size:

```
print(x.size())
```

Out:

```
torch.Size([5, 3])
```

Note

`torch.Size`

is in fact a tuple, so it supports all tuple operations.

### Operations¶

There are multiple syntaxes for operations. In the following example, we will take a look at the addition operation.

Addition: syntax 1

```
y = torch.rand(5, 3)
print(x + y)
```

Out:

```
tensor([[-1.6608, -1.1781, 0.7251],
[ 1.0554, 1.8443, -1.2533],
[ 0.0317, -0.9218, 1.8924],
[ 1.9084, 2.5479, -0.6926],
[-0.4667, 0.3890, 0.6688]])
```

Addition: syntax 2

```
print(torch.add(x, y))
```

Out:

```
tensor([[-1.6608, -1.1781, 0.7251],
[ 1.0554, 1.8443, -1.2533],
[ 0.0317, -0.9218, 1.8924],
[ 1.9084, 2.5479, -0.6926],
[-0.4667, 0.3890, 0.6688]])
```

Addition: providing an output tensor as argument

```
result = torch.empty(5, 3)
torch.add(x, y, out=result)
print(result)
```

Out:

```
tensor([[-1.6608, -1.1781, 0.7251],
[ 1.0554, 1.8443, -1.2533],
[ 0.0317, -0.9218, 1.8924],
[ 1.9084, 2.5479, -0.6926],
[-0.4667, 0.3890, 0.6688]])
```

Addition: in-place

```
# adds x to y
y.add_(x)
print(y)
```

Out:

```
tensor([[-1.6608, -1.1781, 0.7251],
[ 1.0554, 1.8443, -1.2533],
[ 0.0317, -0.9218, 1.8924],
[ 1.9084, 2.5479, -0.6926],
[-0.4667, 0.3890, 0.6688]])
```

Note

Any operation that mutates a tensor in-place is post-fixed with an `_`

.
For example: `x.copy_(y)`

, `x.t_()`

, will change `x`

.

You can use standard NumPy-like indexing with all bells and whistles!

```
print(x[:, 1])
```

Out:

```
tensor([-1.8390, 1.1194, -1.0663, 1.9360, -0.4153])
```

Resizing: If you want to resize/reshape tensor, you can use `torch.view`

:

```
x = torch.randn(4, 4)
y = x.view(16)
z = x.view(-1, 8) # the size -1 is inferred from other dimensions
print(x.size(), y.size(), z.size())
```

Out:

```
torch.Size([4, 4]) torch.Size([16]) torch.Size([2, 8])
```

If you have a one element tensor, use `.item()`

to get the value as a
Python number

```
x = torch.randn(1)
print(x)
print(x.item())
```

Out:

```
tensor([-0.1663])
-0.16627416014671326
```

**Read later:**

100+ Tensor operations, including transposing, indexing, slicing, mathematical operations, linear algebra, random numbers, etc., are described here.

## NumPy Bridge¶

Converting a Torch Tensor to a NumPy array and vice versa is a breeze.

The Torch Tensor and NumPy array will share their underlying memory locations (if the Torch Tensor is on CPU), and changing one will change the other.

### Converting a Torch Tensor to a NumPy Array¶

```
a = torch.ones(5)
print(a)
```

Out:

```
tensor([1., 1., 1., 1., 1.])
```

```
b = a.numpy()
print(b)
```

Out:

```
[1. 1. 1. 1. 1.]
```

See how the numpy array changed in value.

```
a.add_(1)
print(a)
print(b)
```

Out:

```
tensor([2., 2., 2., 2., 2.])
[2. 2. 2. 2. 2.]
```

### Converting NumPy Array to Torch Tensor¶

See how changing the np array changed the Torch Tensor automatically

```
import numpy as np
a = np.ones(5)
b = torch.from_numpy(a)
np.add(a, 1, out=a)
print(a)
print(b)
```

Out:

```
[2. 2. 2. 2. 2.]
tensor([2., 2., 2., 2., 2.], dtype=torch.float64)
```

All the Tensors on the CPU except a CharTensor support converting to NumPy and back.

## CUDA Tensors¶

Tensors can be moved onto any device using the `.to`

method.

```
# let us run this cell only if CUDA is available
# We will use ``torch.device`` objects to move tensors in and out of GPU
if torch.cuda.is_available():
device = torch.device("cuda") # a CUDA device object
y = torch.ones_like(x, device=device) # directly create a tensor on GPU
x = x.to(device) # or just use strings ``.to("cuda")``
z = x + y
print(z)
print(z.to("cpu", torch.double)) # ``.to`` can also change dtype together!
```

Out:

```
tensor([0.8337], device='cuda:0')
tensor([0.8337], dtype=torch.float64)
```

**Total running time of the script:** ( 0 minutes 6.801 seconds)