XPUGraph
-
class torch.xpu.XPUGraph(keep_graph=False)[исходный код] -
Обёртка над графом XPU.
- Параметры:
-
keep_graph (bool, необязательно) – Если
keep_graph=False, исполняемый граф команд будет создан на GPU в концеcapture_end, а базовый изменяемый граф команд будет уничтожен. Обратите внимание, что в этом случае исполняемый граф команд не будет создан в концеcapture_end. Вместо этого он будет создан явным вызовомinstantiateили автоматически при первом вызовеreplay, если ранее не был вызванinstantiate. Рекомендуется вручную вызватьinstantiateпередreplay, чтобы избежать увеличения задержки при первом вызовеreplay. - Тип возвращаемого значения:
-
Self
-
capture_begin(pool=None)[исходный код] -
Начать захват операций XPU в текущем потоке xpu.
Обычно не следует вызывать
capture_beginсамостоятельно. Используйтеgraph, которая вызываетcapture_beginвнутри себя.- Параметры:
-
pool (необязательно) – Токен (возвращаемый
graph_pool_handle()илиother_Graph_instance.pool()), указывающий, что этот граф может использовать память совместно с указанным пулом.
-
capture_end()[исходный код] -
Завершить захват графа XPU в текущем потоке.
После
capture_endдля этого экземпляра можно вызватьreplay.Обычно не следует вызывать
capture_endсамостоятельно. Используйтеgraph, которая вызываетcapture_endвнутри себя.
-
debug_dump(debug_path)[исходный код] -
- Параметры:
-
debug_path (обязательно) – Путь, по которому следует сохранить граф.
Вызывает функцию отладки для сохранения графа, если отладка включена с помощью XPUGraph.enable_debug_mode()
-
enable_debug_mode()[исходный код] -
Включить режим отладки для XPUGraph.debug_dump.
-
instantiate()[исходный код] -
Создать граф XPU. Будет вызван методом
capture_end, еслиkeep_graph=False, или методомreplay, еслиkeep_graph=Trueиinstantiateещё не были вызваны явно. Не уничтожает изменяемый граф команд xpu, возвращённый методомraw_xpu_graph.
-
pool()[исходный код] -
Возвращает непрозрачный токен, представляющий идентификатор пула памяти этого графа.
Этот идентификатор можно при необходимости передать методу
capture_beginдругого графа, указав, что другой граф может использовать тот же пул памяти.- Тип возвращаемого значения:
-
_POOL_HANDLE
-
raw_xpu_graph()[исходный код] -
Возвращает базовый объект xpuGraph_t. Значение
keep_graphдолжно быть равно True.XPU не предоставляет API для работы с этим объектом.
- Тип возвращаемого значения:
-
raw_xpu_graph_exec()[исходный код] -
Возвращает базовый объект xpuGraphExec_t. Если
keep_graphравно True, должен быть вызванinstantiate; еслиkeep_graphравно False, должен быть вызванcapture_end. Если вызватьinstantiate()послеraw_xpu_graph_exec(), ранее возвращённый объект xpuGraphExec_t будет уничтожен. Вы обязаны не использовать этот объект после его уничтожения.XPU не предоставляет API для работы с этим объектом.
- Тип возвращаемого значения:
-
replay()[исходный код] -
Повторно выполнить операции XPU, захваченные этим графом.
-
reset()[исходный код] -
Удалить граф, хранящийся в данный момент в этом экземпляре.
© 2026, PyTorch Contributors
PyTorch has a BSD-style license, as found in the LICENSE file.
https://docs.pytorch.org/docs/2.14/generated/torch.xpu.XPUGraph.html