pythonpytorchtensorflatten

How to flatten a tensor in PyTorch?


Given a tensor of multiple dimensions, how do I flatten it so that it has a single dimension?

torch.Size([2, 3, 5])    ⟶ flatten ⟶    torch.Size([30])

Solution

  • TL;DR: torch.flatten()

    Use torch.flatten() which was introduced in v0.4.1 and documented in v1.0rc1:

    >>> t = torch.tensor([[[1, 2],
                           [3, 4]],
                          [[5, 6],
                           [7, 8]]])
    >>> torch.flatten(t)
    tensor([1, 2, 3, 4, 5, 6, 7, 8])
    >>> torch.flatten(t, start_dim=1)
    tensor([[1, 2, 3, 4],
            [5, 6, 7, 8]])
    

    For v0.4.1 and earlier, use t.reshape(-1).


    With t.reshape(-1):

    If the requested view is contiguous in memory this will equivalent to t.view(-1) and memory will not be copied.

    Otherwise it will be equivalent to t.contiguous().view(-1).


    Other non-options:

    (Note: pytorch's reshape() may change data but numpy's reshape() won't.)


    t.resize(t.numel()) needs some discussion. The torch.Tensor.resize_ documentation says:

    The storage is reinterpreted as C-contiguous, ignoring the current strides (unless the target size equals the current size, in which case the tensor is left unchanged)

    Given the current strides will be ignored with the new (1, numel()) size, the order of the elements may apppear in a different order than with reshape(-1). However, "size" may mean the memory size, rather than the tensor's size.

    It would be nice if t.resize(-1) worked for both convenience and efficiency, but with torch 1.0.1.post2, t = torch.rand([2, 3, 5]); t.resize(-1) gives:

    RuntimeError: requested resize to -1 (-1 elements in total), but the given 
    tensor has a size of 2x2 (4 elements). autograd's resize can only change the 
    shape of a given tensor, while preserving the number of elements.
    

    I raised a feature request for this here, but the consensus was that resize() was a low level method, and reshape() should be used in preference.