torch.xpu

創建於：2024年02月01日 | 最後更新於：2025年06月06日

此包引入了對 XPU 後端的支援，該後端專門針對 Intel GPU 進行了最佳化。

此包是惰性初始化的，因此您可以隨時匯入它，並使用 is_available() 來確定您的系統是否支援 XPU。

StreamContext	選擇給定流的上下文管理器。
current_device	返回當前選定裝置的索引。
current_stream	返回給定裝置的當前選定的 Stream。
device	更改選定裝置的上下文管理器。
device_count	返回可用的 XPU 裝置數量。
device_of	將當前裝置更改為給定物件裝置的上下文管理器。
get_arch_list	返回此庫編譯時支援的 XPU 架構列表。
get_device_capability	獲取裝置的 XPU 功能。
get_device_name	獲取裝置的名稱。
get_device_properties	獲取裝置的屬性。
get_gencode_flags	返回此庫編譯時使用的 XPU AOT（預編譯）構建標誌。
get_stream_from_external	從外部 SYCL 佇列返回一個 Stream。
init	初始化 PyTorch 的 XPU 狀態。
is_available	返回一個布林值，指示 XPU 當前是否可用。
is_initialized	返回 PyTorch 的 XPU 狀態是否已初始化。
set_device	設定當前裝置。
set_stream	設定當前流。這是一個用於設定流的包裝 API。
stream	包裝選擇給定流的上下文管理器 StreamContext。
synchronize	等待給定 XPU 裝置上的所有流中的所有核心完成。

隨機數生成器

get_rng_state	將指定 GPU 的隨機數生成器狀態作為 ByteTensor 返回。
get_rng_state_all	返回一個 ByteTensor 列表，表示所有裝置的隨機數狀態。
initial_seed	返回當前 GPU 的當前隨機種子。
manual_seed	設定當前 GPU 隨機數生成的種子。
manual_seed_all	設定所有 GPU 隨機數生成的種子。
seed	將當前 GPU 隨機數生成的種子設定為一個隨機數。
seed_all	將所有 GPU 隨機數生成的種子設定為一個隨機數。
set_rng_state	設定指定 GPU 的隨機數生成器狀態。
set_rng_state_all	設定所有裝置的隨機數生成器狀態。

流和事件

事件	XPU 事件的包裝器。
流	XPU 流的包裝器。

記憶體管理

empty_cache	釋放快取分配器當前持有的所有未佔用的快取記憶體，以便其他 XPU 應用程式可以使用它們。
max_memory_allocated	返回給定裝置上張量佔用的最大 GPU 記憶體（以位元組為單位）。
max_memory_reserved	返回給定裝置上快取分配器管理的最大 GPU 記憶體（以位元組為單位）。
mem_get_info	返回給定裝置的全域性空閒和總 GPU 記憶體。
memory_allocated	返回給定裝置上張量當前佔用的 GPU 記憶體（以位元組為單位）。
memory_reserved	返回給定裝置上快取分配器管理的當前 GPU 記憶體（以位元組為單位）。
memory_stats	返回給定裝置的 XPU 記憶體分配器統計資訊的字典。
memory_stats_as_nested_dict	以巢狀字典的形式返回 memory_stats() 的結果。
reset_accumulated_memory_stats	重置 XPU 記憶體分配器跟蹤的“累積”（歷史）統計資訊。
reset_peak_memory_stats	重置 XPU 記憶體分配器跟蹤的“峰值”統計資訊。