particula.execution.preparation_context
Typed, setup-only dependencies for built-in resident process adapters.
The context contains resources and preparation results, not simulation lifecycle methods. Built-ins cannot step, close, snapshot or restart their owning runner. Warp buffers remain runtime-typed at the direct-kernel boundary.
Classes
| Name | Description |
|---|---|
BuiltinPreparationContext | Explicit native resources and shared setup outputs for one preparation. |
BuiltinPreparationContextclassdataclass#
class BuiltinPreparationContext(wp: ModuleType, session: ResidentSession, registry: GPUResourceRegistry, device: Device, time_step: float, failure: Any, plans: tuple[_ProcessPlan | _RegisteredPlan, ...], fields: FieldBuffers, bindings: dict[str, Any], auxiliary: dict[str, Any], observers: list[Callable[[], object]], refresh: Callable[[], None] | None = None)Explicit native resources and shared setup outputs for one preparation.
Binding and auxiliary maps are shared with the owner to preserve resource
identity. Only setup mutates these maps; retained operations capture their
fixed buffers. refresh publishes the derived-state refresh operation.
auxiliaryattributeinstance attribute#
auxiliary: dict[str, Any]bindingsattributeinstance attribute#
bindings: dict[str, Any]deviceattributeinstance attribute#
device: Devicefailureattributeinstance attribute#
failure: Anyfieldsattributeinstance attribute#
fields: FieldBuffersobserversattributeinstance attribute#
observers: list[Callable[[], object]]plansattributeinstance attribute#
plans: tuple[_ProcessPlan | _RegisteredPlan, ...]refreshattributeclass attributeinstance attribute#
refresh: Callable[[], None] | None = Noneregistryattributeinstance attribute#
registry: GPUResourceRegistrysessionattributeinstance attribute#
session: ResidentSessiontime_stepattributeinstance attribute#
time_step: floatwpattributeinstance attribute#
wp: ModuleTypeenvironmentproperty#
environment: WarpEnvironmentDataExpose the already validated box environment buffer layout.
gasproperty#
gas: WarpGasDataExpose the already validated full-gas buffer layout.
particlesproperty#
particles: WarpParticleDataExpose the already validated native particle buffer layout.
__init__method#
def __init__(wp: ModuleType, session: ResidentSession, registry: GPUResourceRegistry, device: Device, time_step: float, failure: Any, plans: tuple[_ProcessPlan | _RegisteredPlan, ...], fields: FieldBuffers, bindings: dict[str, Any], auxiliary: dict[str, Any], observers: list[Callable[[], object]], refresh: Callable[[], None] | None = None) -> None