pub struct Trace {Show 13 fields
pub config_n_modes: usize,
pub config_latent_dim: usize,
pub config_eps: f64,
pub config_seed: Option<u64>,
pub config_schedule: String,
pub config_condition: Condition,
pub config_match_policy: MatchPolicy,
pub config_diff_policy: DiffPolicy,
pub config_stutter_k: u64,
pub config_optical: Option<String>,
pub config_merge_tau: f64,
pub initial_graph: Option<Graph>,
pub entries: Vec<TraceEntry>,
}Expand description
Full trace: a sequence of entries.
The header (config_* fields) must carry everything aria emit needs to
replay Φ byte-for-byte without a matching --config: n_modes,
latent_dim, and eps alone are not enough. seed, schedule,
condition, and match_policy select the trajectory; diff_policy
(consumed by Engine::apply), stutter_k (consumed by the scheduler),
and optical/merge_tau (consumed by engine_with when the backends are
built) all change the replayed latents just as much. initial_graph
records G₀ so a run seeded with a non-empty graph is self-describing
rather than silently replayed from Graph::empty(). Omitting any of these
makes replay silently diverge from the run that produced the trace (see
aria emit’s doc comment).
Fields§
§config_n_modes: usize§config_latent_dim: usize§config_eps: f64§config_seed: Option<u64>Seed the run used — None only if the run itself used no fixed seed.
config_schedule: StringSchedule string (“opmd” or a custom action-char sequence).
config_condition: ConditionConditioning a_t the run used.
config_match_policy: MatchPolicyMatch policy ℙ3 the run used.
config_diff_policy: DiffPolicyDiffusion policy for Diff_G(z) — consumed by Engine::apply.
config_stutter_k: u64Stutter budget K (𝐂5) — consumed by the scheduler.
config_optical: Option<String>Optical backend selection ("fft"/"householder", None = automatic)
— consumed by engine_with when the backend is built.
config_merge_tau: f64Graph merge distance threshold τ (spec §0.4) — consumed by
engine_with via SimGraphBackend::with_merge_tau.
initial_graph: Option<Graph>The graph the run started from (G₀). None iff the run started from
Graph::empty(); recorded (not just a flag) so a seeded run stays
self-describing. aria emit replays from an empty graph, so it must
reject a trace whose initial_graph is non-empty rather than silently
diverge.
entries: Vec<TraceEntry>Implementations§
Source§impl Trace
impl Trace
pub fn new( n_modes: usize, latent_dim: usize, eps: f64, seed: Option<u64>, schedule: &str, condition: Condition, match_policy: MatchPolicy, diff_policy: DiffPolicy, stutter_k: u64, optical: Option<String>, merge_tau: f64, initial_graph: Option<Graph>, ) -> Self
pub fn push( &mut self, t: u64, action: Action, residual: f64, energy: f64, graph_size: usize, condition: &str, )
Sourcepub fn action_sequence(&self) -> String
pub fn action_sequence(&self) -> String
Action symbol sequence for trace pattern matching.