Skip to content
heliaAOT
API Reference
HELIA HUB

ArenaRole

Machine-readable model

  • ArenaRoleclassLogical role of a memory arena.
class

ArenaRole

Python

Logical role of a memory arena.

helia_aot/memory/defines.py:67

ArenaRole()

Logical role of a memory arena.

Provisional: importable, but outside the compatibility promise; a minor release can change or remove it.

Every tensor in a :class:MemoryPlan lives in an arena tagged with one of these roles. Roles partition the planner output so scratch reuse, persistent zero-init, and constant residency can be reasoned about independently.

Each member also answers to its lowercase name (ArenaRole.scratch), an alias of the same member; the value is the spelling reports use.

constant

SCRATCH

Python

helia_aot/memory/defines.py:90

SCRATCH = auto()

scratch. Writable activation/scratch arena (whole-program lifetime shared by ops, slots reused via liveness analysis).

constant

CONSTANT

Python

helia_aot/memory/defines.py:92

CONSTANT = auto()

constant. Read-only weight storage. Can be cold (the arena buffer is the cold-storage blob and kernels read it in place) or staged (the arena buffer is a writable runtime copy hydrated from a separate source blob).