CodeEntropy.levels.frame_dag module

Frame-local DAG execution.

This module defines the frame-scoped DAG used during the MAP stage of the hierarchy workflow. Each frame is processed independently to produce frame-local outputs (e.g., axes and covariance data), which are later reduced outside this DAG.

class CodeEntropy.levels.frame_dag.FrameContext(shared: dict[str, Any], frame_index: int, frame_covariance: Any = None, data: dict[str, Any] | None = None)

Bases: object

Container for per-frame execution context.

Variables:

• shared (dict[str, Any]) – Shared workflow data (mutated across the full workflow).

• frame_index (int) – Absolute trajectory frame index being processed.

• frame_covariance (Any) – Frame-local covariance output produced by FrameCovarianceNode.

• data (dict[str, Any] | None) – Additional frame-local scratch space for nodes, if needed.

data: dict[str, Any] | None = None

frame_covariance: Any = None

frame_index: int

shared: dict[str, Any]

class CodeEntropy.levels.frame_dag.FrameGraph(universe_operations: Any | None = None)

Bases: object

Execute a frame-local directed acyclic graph.

The graph is run once per trajectory frame. Nodes may read shared inputs from ctx[“shared”] and must write only frame-local outputs into the frame context.

Expected node outputs:

• “frame_covariance”

build() → FrameGraph

Build the default frame DAG topology.

Returns:

Self, to allow fluent chaining.

execute_frame(shared_data: dict[str, Any], frame_index: int) → Any

Execute the frame DAG for a single trajectory frame.

Parameters:

• shared_data – Shared workflow data dict.

• frame_index – Absolute trajectory frame index.

Returns:

Frame-local covariance payload produced by FrameCovarianceNode.