Pytorch torch.roll函数介绍

torch.roll 是 PyTorch 中的一个函数,用于对输入张量的元素进行循环滚动操作。它可以将张量的元素在指定的维度上移动,超出边界的元素会循环回到另一侧。以下是关于 torch.roll 函数的详细介绍:

函数语法

复制代码
torch.roll(input, shifts, dims=None)

参数说明

  • input:必需参数,为输入的 PyTorch 张量,即需要进行循环滚动操作的张量。
  • shifts :表示元素滚动的位移量。可以是一个整数,此时所有指定维度都按照这个整数进行滚动;也可以是一个与 dims 长度相同的元组或列表,用于为每个指定维度分别指定滚动的位移量。正数表示元素向维度的末尾方向滚动,负数表示向维度的起始方向滚动。
  • dims:可选参数,指定要进行滚动操作的维度。可以是一个整数,表示对单一维度进行滚动;也可以是一个元组或列表,包含多个整数,用于指定对多个维度同时进行滚动。如果不指定该参数,则会将输入张量视为一维张量进行滚动。

返回值

返回一个新的张量,其元素是输入张量在指定维度上循环滚动后的结果。新张量的形状与输入张量相同。

使用示例

一维张量滚动
复制代码
import torch

# 创建一维张量
x = torch.tensor([1, 2, 3, 4, 5])
# 向右滚动 2 个位置
rolled_x = torch.roll(x, shifts=2)
print(rolled_x)  
# 输出: tensor([4, 5, 1, 2, 3])
二维张量在单个维度上滚动
复制代码
import torch

# 创建二维张量
x = torch.tensor([[1, 2, 3], [4, 5, 6], [7, 8, 9]])
# 在第 0 维(行)上向下滚动 1 个位置
rolled_x = torch.roll(x, shifts=1, dims=0)
print(rolled_x)
# 输出:
# tensor([[7, 8, 9],
#         [1, 2, 3],
#         [4, 5, 6]])
二维张量在多个维度上滚动
复制代码
import torch

# 创建二维张量
x = torch.tensor([[1, 2, 3], [4, 5, 6], [7, 8, 9]])
# 在第 0 维向下滚动 1 个位置,在第 1 维向右滚动 2 个位置
rolled_x = torch.roll(x, shifts=(1, 2), dims=(0, 1))
print(rolled_x)
# 输出:
# tensor([[8, 9, 7],
#         [2, 3, 1],
#         [5, 6, 4]])

总结

torch.roll 函数为在 PyTorch 中对张量元素进行循环滚动提供了方便的操作方式,可用于数据增强、信号处理等多种场景,通过灵活设置 shifts 和 dims 参数,可以实现不同维度和不同位移量的滚动操作。

相关推荐
赵大仁2 分钟前
Agent 工具调用可靠性:超时、重试、幂等与人工确认怎么设计
python·agent·幂等·工具调用·人工确认
双鱼大猫43 分钟前
opencode 吃掉 100G 空间:Agent 会话数据要分级清理
人工智能·agent·ai编程
用户5833339816681 小时前
RPA 流程的异常处理设计:重试、降级与告警,生产环境实战指南
人工智能
__underline__1 小时前
冷门Python知识点007篇:list[int]不是类,为什么能当基类?
后端·python
Dmz丶1 小时前
前端转 AI 100 天 Day 49:文档切分——RAG 效果的隐形开关
python
sanxing三省2 小时前
DeepSeek Harness 到底是什么?标题里最重的词其实不是「DeepSeek」
前端·人工智能·deepseek
青少儿编程课堂2 小时前
第十八届蓝桥杯青少组图形化真题 + 全国青少年信息素养大赛 + 电子学会图形化考级:校园泡泡堂大挑战解析
c++·python·算法·bfs·信息学竞赛
合尘猫3 小时前
用 6GB 显卡搭短视频产线:MiniMax H3 + ffmpeg 全流程实录(55 秒片 / 40 分钟)
人工智能·音视频
ZONGYUAN-ROOT3 小时前
【自愈治理】自愈式数据管道:大规模公开数据采集的治理方法
人工智能
Starry-sky(jing)3 小时前
Hermes Agent 升级 v0.23.2:先辨更新渠道,再看 CLI 退出残留修复
人工智能·python·ai agent