torch.Storage

torch.Storage 是对应默认数据类型（torch.get_default_dtype()）的存储类的别名。例如，如果默认数据类型是 torch.float，则 torch.Storage 解析为 torch.FloatStorage。

第 torch.<type>Storage 和 torch.cuda.<type>Storage 类， 如 torch.FloatStorage, torch.IntStorage 等，实际上从未被实例化。调用它们的构造函数会创建一个带有适当 torch.dtype 和 torch.device 的 torch.TypedStorage。 torch.<type>Storage 类具有与 torch.TypedStorage 相同的所有类方法。

一个 torch.TypedStorage 是一个连续的、一维的特定 torch.dtype 元素数组。它可以被赋予任何 torch.dtype，内部数据将被适当地解释。torch.TypedStorage 包含一个 torch.UntypedStorage，它以未分类的字节数组形式保存数据。

每个步幅为 torch.Tensor 的元素包含一个 torch.TypedStorage, 它存储了所有 torch.Tensor 视图的数据。

警告

除了 torch.UntypedStorage 之外的所有存储类将在未来被移除，并且在所有情况下将使用 torch.UntypedStorage。

class torch.TypedStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

bfloat16()

将此存储转换为bfloat16类型。

bool()

将此存储转换为布尔类型。

byte()

将此存储转换为字节类型。

char()

将此存储转换为字符类型。

clone()

返回此存储的副本。

complex_double()

将此存储转换为复数双精度类型。

complex_float()

将此存储转换为复数浮点类型。

copy_(source, non_blocking=None)

cpu()

如果这个存储不在CPU上，返回它的CPU副本。

cuda(device=None, non_blocking=False)

返回此对象在CUDA内存中的副本。

如果该对象已经在CUDA内存中并且位于正确的设备上，那么不会执行复制操作，并返回原始对象。

Parameters

• 设备 (int) – 目标GPU的ID。默认为当前设备。

• non_blocking (bool) – 如果 True 且源在锁定内存中， 复制将异步于主机。否则， 该参数无效。

Return type

T

data_ptr()

property device

double()

将此存储转换为双精度类型。

dtype: dtype

element_size()

property filename: Optional[str]

返回与此存储关联的文件名，如果该存储是从文件内存映射创建的。 或 None 如果存储不是通过内存映射文件创建的。

fill_(value)

float()

将此存储转换为浮点类型。

float8_e4m3fn()

将此存储转换为float8_e4m3fn类型

float8_e4m3fnuz()

将此存储转换为 float8_e4m3fnuz 类型

float8_e5m2()

将此存储转换为float8_e5m2类型

float8_e5m2fnuz()

将此存储转换为 float8_e5m2fnuz 类型

classmethod from_buffer(*args, **kwargs)

classmethod from_file(filename, shared=False, size=0) → Storage

创建一个由内存映射文件支持的CPU存储。

如果 shared 是 True，那么所有进程之间将共享内存。 所有更改都将写入文件。如果 shared 是 False，那么存储上的更改不会影响文件。

size 是存储中的元素数量。如果 shared 是 False, 那么文件必须包含至少 size * sizeof(Type) 字节 (Type 是存储的类型)。如果 shared 是 True 文件将在需要时创建。

Parameters

• 文件名 (str) – 要映射的文件名

• 共享 (布尔值) – 是否共享内存（是否将 MAP_SHARED 或 MAP_PRIVATE 传递给底层的 mmap(2) 调用）

• 大小 (int) – 存储中的元素数量

get_device()

Return type

整数

half()

将此存储转换为半精度类型。

hpu(device=None, non_blocking=False)

返回此对象在HPU内存中的副本。

如果该对象已经在HPU内存中并且位于正确的设备上，那么不会执行复制操作，并返回原始对象。

Parameters

• 设备 (int) – 目标HPU的ID。默认为当前设备。

• non_blocking (bool) – 如果 True 且源在锁定内存中， 复制将异步于主机。否则， 该参数无效。

Return type

T

int()

将此存储转换为 int 类型。

property is_cuda

property is_hpu

is_pinned(device='cuda')

确定 CPU TypedStorage 是否已在设备上固定。

Parameters

device (str 或 torch.device) – 要固定内存的设备。默认值: 'cuda'

Returns

一个布尔变量。

is_shared()

is_sparse = False

long()

将此存储转换为长整型。

nbytes()

pickle_storage_type()

pin_memory(device='cuda')

将 CPU TypedStorage 复制到固定内存中，如果它尚未固定的话。

Parameters

device (str 或 torch.device) – 要固定内存的设备。默认值: 'cuda'.

Returns

一个固定在 CPU 上的存储。

resizable()

resize_(size)

share_memory_()

查看 torch.UntypedStorage.share_memory_()

short()

将此存储转换为 short 类型。

size()

to(*, device, non_blocking=False)

返回此对象在设备内存中的副本。

如果该对象已经在正确的设备上，则不会执行复制操作，并返回原始对象。

Parameters

• device (int) – 目标设备.

• non_blocking (bool) – 如果 True 且源在锁定内存中， 复制将异步于主机。否则， 该参数无效。

Return type

T

tolist()

返回一个包含此存储区元素的列表。

type(dtype=None, non_blocking=False)

如果未提供 dtype，则返回类型，否则将此对象转换为指定的类型。

如果已经是正确的类型，则不会执行复制操作，并返回原始对象。

Parameters

• dtype (类型 或 字符串) – 所需的类型

• non_blocking (bool) – 如果 True，并且源在固定内存中而目标在GPU上或相反，则复制操作相对于主机是异步执行的。否则，该参数没有效果。

• **kwargs – 为了兼容性，可能包含键 async 来代替 non_blocking 参数。参数 async 已弃用。

Return type

联合[T, 字符串]

untyped()

返回内部 torch.UntypedStorage。

class torch.UntypedStorage(*args, **kwargs)

bfloat16()

将此存储转换为bfloat16类型。

bool()

将此存储转换为布尔类型。

byte()

将此存储转换为字节类型。

byteswap(dtype)

在底层数据中交换字节。

char()

将此存储转换为字符类型。

clone()

返回此存储的副本。

complex_double()

将此存储转换为复数双精度类型。

complex_float()

将此存储转换为复数浮点类型。

copy_()

cpu()

如果这个存储不在CPU上，返回它的CPU副本。

cuda(device=None, non_blocking=False)

返回此对象在CUDA内存中的副本。

如果该对象已经在CUDA内存中并且位于正确的设备上，那么不会执行复制操作，并返回原始对象。

Parameters

• 设备 (int) – 目标GPU的ID。默认为当前设备。

• non_blocking (bool) – 如果 True 且源在锁定内存中， 复制将异步于主机。否则， 该参数无效。

Return type

T

data_ptr()

device: device

double()

将此存储转换为双精度类型。

element_size()

property filename: Optional[str]

返回与此存储关联的文件名，如果该存储是从文件内存映射创建的。 或 None 如果存储不是通过内存映射文件创建的。

fill_()

float()

将此存储转换为浮点类型。

float8_e4m3fn()

将此存储转换为float8_e4m3fn类型

float8_e4m3fnuz()

将此存储转换为 float8_e4m3fnuz 类型

float8_e5m2()

将此存储转换为float8_e5m2类型

float8_e5m2fnuz()

将此存储转换为 float8_e5m2fnuz 类型

static from_buffer()

static from_file(filename, shared=False, size=0) → Storage

创建一个由内存映射文件支持的CPU存储。

如果 shared 是 True，那么所有进程之间将共享内存。 所有更改都将写入文件。如果 shared 是 False，那么存储上的更改不会影响文件。

size 是存储中的元素数量。如果 shared 是 False， 则文件必须至少包含 size * sizeof(Type) 字节 （Type 是存储类型，在 UnTypedStorage 的情况下，文件必须至少包含 size 字节）。如果 shared 是 True，则在需要时会创建该文件。

Parameters

• 文件名 (str) – 要映射的文件名

• 共享 (布尔值) –

  是否共享内存（无论是将MAP_SHARED还是MAP_PRIVATE传递给 底层的mmap(2) 调用）

• 大小 (int) – 存储中的元素数量

get_device()

Return type

整数

half()

将此存储转换为半精度类型。

hpu(device=None, non_blocking=False)

返回此对象在HPU内存中的副本。

如果该对象已经在HPU内存中并且位于正确的设备上，那么不会执行复制操作，并返回原始对象。

Parameters

• 设备 (int) – 目标HPU的ID。默认为当前设备。

• non_blocking (bool) – 如果 True 且源在锁定内存中， 复制将异步于主机。否则， 该参数无效。

Return type

T

int()

将此存储转换为 int 类型。

property is_cuda

property is_hpu

is_pinned(device='cuda')

确定CPU存储是否已在设备上固定。

Parameters

device (str 或 torch.device) – 要固定内存的设备。默认值: 'cuda'.

Returns

一个布尔变量。

is_shared()

is_sparse: bool = False

is_sparse_csr: bool = False

long()

将此存储转换为长整型。

mps()

如果此存储尚未位于 MPS 上，则返回其 MPS 拷贝。

nbytes()

new()

pin_memory(device='cuda')

如果尚未固定，将 CPU 存储复制到固定内存中。

Parameters

device (str 或 torch.device) – 要固定内存的设备。默认值: 'cuda'.

Returns

一个固定在 CPU 上的存储。

resizable()

resize_()

share_memory_(*args, **kwargs)

将存储移动到共享内存。

对于已经位于共享内存中的存储以及不需要跨进程共享的 CUDA 存储，此操作不会产生任何效果。共享内存中的存储无法调整大小。

请注意，为缓解类似 此问题 从同一对象的多个线程调用此函数是线程安全的。 但是，在没有适当同步的情况下，调用 self 上的任何其他函数并不是线程安全的。请参阅 多进程最佳实践 以获取更多详细信息。

注意

当共享内存中对存储的所有引用都被删除时，相关的共享内存对象也将被删除。PyTorch 有一个特殊的清理过程，以确保即使当前进程意外退出，这一操作也能完成。

值得注意的是 share_memory_() 和 from_file() 与 shared = True 的区别

1. share_memory_ 使用 shm_open(3) 创建一个 POSIX 共享内存对象，而 from_file() 使用 open(2) 打开用户传递的文件名。

2. 两者都使用 mmap(2) 调用和MAP_SHARED 将文件/对象映射到当前虚拟地址空间

3. share_memory_ 将在映射后调用 shm_unlink(3) ，以确保当没有进程打开该对象时释放共享内存 对象。 torch.from_file(shared=True) 不会取消链接 文件。此文件是持久的，直到用户将其删除才会保留。

Returns

self

short()

将此存储转换为 short 类型。

size()

Return type

整数

to(*, device, non_blocking=False)

Return type

T

tolist()

返回一个包含此存储区元素的列表。

type(dtype=None, non_blocking=False, **kwargs)

如果未提供 dtype，则返回类型，否则将此对象转换为指定的类型。

如果已经是正确的类型，则不会执行复制操作，并返回原始对象。

Parameters

• dtype (类型 或 字符串) – 所需的类型

• non_blocking (bool) – 如果 True，并且源在固定内存中而目标在GPU上或相反，则复制操作相对于主机是异步执行的。否则，该参数没有效果。

• **kwargs – 为了兼容性，可能包含键 async 来代替 non_blocking 参数。参数 async 已弃用。

untyped()

class torch.DoubleStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.float64

class torch.FloatStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.float32

class torch.HalfStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.float16

class torch.LongStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.int64

class torch.IntStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.int32

class torch.ShortStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.int16

class torch.CharStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.int8

class torch.ByteStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.uint8

class torch.BoolStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.bool

class torch.BFloat16Storage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.bfloat16

class torch.ComplexDoubleStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.complex128

class torch.ComplexFloatStorage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.complex64

class torch.QUInt8Storage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.quint8

class torch.QInt8Storage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.qint8

class torch.QInt32Storage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.qint32

class torch.QUInt4x2Storage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.quint4x2

class torch.QUInt2x4Storage(*args, wrap_storage=None, dtype=None, device=None, _internal=False)

dtype: dtype = torch.quint2x4