PyTorch .hstack()

Anonymous contributor's avatar
Anonymous contributor
Published Nov 2, 2024
Contribute to Docs

In PyTorch, .hstack() (short for horizontal stack) is a function used to concatenate two or more tensors along the horizontal axis (axis=1). This operation is helpful in combining data with the same number of rows but differing in the number of columns. It acts similarly to np.hstack() in NumPy and is particularly handy for data that needs to be concatenated side by side before being fed into a model for training or inference.

  • Machine Learning Data Scientists solve problems at scale, make predictions, find patterns, and more! They use Python, SQL, and algorithms.
    • Includes 27 Courses
    • With Professional Certification
    • Beginner Friendly.
      95 hours
  • Learn how to use PyTorch to build, train, and test artificial neural networks in this course.
    • Intermediate.
      3 hours

Syntax

torch.hstack(tensors) -> Tensor
  • tensors: A sequence of tensors with the same number of rows. All tensors must have the same number of dimensions and the same size in all dimensions except for the dimension corresponding to the horizontal stacking.

The function returns a new tensor containing the horizontal concatenation of the input tensors.

Example

Here’s an example demonstrating how .hstack() can be used to concatenate tensors:

import torch
# Create two tensors
a = torch.tensor([[1, 2],[3, 4]])
b = torch.tensor([[5, 6],[7, 8]])
# Stack the tensors horizontally
c = torch.hstack((a, b))
print(c)

The above code produces the following output:

tensor([[1, 2, 5, 6],
[3, 4, 7, 8]])

This example demonstrates concatenating two 2x2 tensors horizontally resulting in 2x4 tensor.

All contributors

Contribute to Docs

Learn PyTorch on Codecademy

  • Machine Learning Data Scientists solve problems at scale, make predictions, find patterns, and more! They use Python, SQL, and algorithms.
    • Includes 27 Courses
    • With Professional Certification
    • Beginner Friendly.
      95 hours
  • Learn how to use PyTorch to build, train, and test artificial neural networks in this course.
    • Intermediate.
      3 hours