vibespatial.runtime.hotpath_trace¶

Classes¶

HotpathStageTrace

Functions¶

`hotpath_trace_mode`(→ str)	Return `off`, `counter`, or `timing` for the current process.
`hotpath_trace_enabled`(→ bool)
`hotpath_timing_enabled`(→ bool)	Whether trace stages may synchronize to attribute GPU wall time.
`hotpath_nvtx_enabled`(→ bool)
`attach_work_amplification`(, physical_shape, ...)	Attach one bounded host-known packet to an enabled hotpath stage.
`reset_hotpath_trace`(→ None)
`get_hotpath_trace`(→ tuple[HotpathStageTrace, Ellipsis])
`aggregate_hotpath_summaries`(→ list[dict[str, Any]])	Combine bounded per-statement summaries without restoring raw calls.
`summarize_hotpath_trace`(→ list[dict[str, Any]])
`hotpath_stage`(name, *[, category, metadata])

Module Contents¶

class vibespatial.runtime.hotpath_trace.HotpathStageTrace¶

name: str¶

category: str¶

elapsed_seconds: float¶

timing_mode: str = 'timing'¶

metadata: dict[str, Any]¶

vibespatial.runtime.hotpath_trace.hotpath_trace_mode() → str¶: Return off, counter, or timing for the current process.

vibespatial.runtime.hotpath_trace.hotpath_trace_enabled() → bool¶

vibespatial.runtime.hotpath_trace.hotpath_timing_enabled() → bool¶: Whether trace stages may synchronize to attribute GPU wall time.

vibespatial.runtime.hotpath_trace.hotpath_nvtx_enabled() → bool¶

vibespatial.runtime.hotpath_trace.attach_work_amplification(metadata: dict[str, Any] | None, *, operation: str, metric_family: str, sums: dict[str, int | float], maxima: dict[str, int | float], unavailable: tuple[str, Ellipsis] = (), physical_shape: str | None = None, consumer_kind: str | None = None, semantic_contract: dict[str, Any] | None = None) → None¶: Attach one bounded host-known packet to an enabled hotpath stage.

vibespatial.runtime.hotpath_trace.reset_hotpath_trace() → None¶

vibespatial.runtime.hotpath_trace.get_hotpath_trace() → tuple[HotpathStageTrace, Ellipsis]¶

vibespatial.runtime.hotpath_trace.aggregate_hotpath_summaries(summaries: tuple[list[dict[str, Any]], Ellipsis] | list[list[dict[str, Any]]]) → list[dict[str, Any]]¶: Combine bounded per-statement summaries without restoring raw calls.

vibespatial.runtime.hotpath_trace.summarize_hotpath_trace() → list[dict[str, Any]]¶

vibespatial.runtime.hotpath_trace.hotpath_stage(name: str, *, category: str = 'other', metadata: dict[str, Any] | None = None)¶