Skip to main content

sightloom_analysis/
input.rs

1//! Lightweight observation inputs for miners and anomaly detectors.
2//!
3//! These are intentionally independent of `sightloom-index` to avoid crate cycles.
4//! Hosts map `VisionIndex` entities into these views.
5
6extern crate alloc;
7
8use alloc::vec::Vec;
9use sightloom_core::{EventId, SourceId, SubjectId, ZoneId};
10
11/// One timed subject observation (appearance start, visit start, etc.).
12#[derive(Clone, Copy, Debug, PartialEq)]
13pub struct TimedSubjectEvent {
14    /// Subject when known.
15    pub subject_id: Option<SubjectId>,
16    /// Source when known.
17    pub source_id: Option<SourceId>,
18    /// Event time in nanoseconds (media or wall timeline, host-defined).
19    pub at_ns: i64,
20    /// Optional supporting event id.
21    pub event_id: Option<EventId>,
22    /// Host-defined kind tag for `EventBeforeEvent` mining (`0` = untyped).
23    pub kind_tag: u32,
24}
25
26/// One dwell / visit duration sample.
27#[derive(Clone, Copy, Debug, PartialEq)]
28pub struct DurationSample {
29    /// Subject when known.
30    pub subject_id: Option<SubjectId>,
31    /// Source camera when known (camera-specific baselines).
32    pub source_id: Option<SourceId>,
33    /// Zone when known.
34    pub zone_id: Option<ZoneId>,
35    /// Duration nanoseconds.
36    pub duration_ns: i64,
37    /// Sample time (end of dwell) in nanoseconds.
38    pub at_ns: i64,
39    /// Optional evidence event.
40    pub event_id: Option<EventId>,
41}
42
43/// One ordered zone route for a subject.
44#[derive(Clone, Debug, PartialEq)]
45pub struct RouteSample {
46    /// Subject.
47    pub subject_id: SubjectId,
48    /// Ordered zone ids.
49    pub zones: Vec<ZoneId>,
50    /// Route end time nanoseconds.
51    pub at_ns: i64,
52    /// Optional evidence event.
53    pub event_id: Option<EventId>,
54}
55
56/// One co-occurrence pair observation.
57#[derive(Clone, Copy, Debug, PartialEq)]
58pub struct PairSample {
59    /// First subject (order is normalized by miners).
60    pub subject_a: SubjectId,
61    /// Second subject.
62    pub subject_b: SubjectId,
63    /// Shared source when known.
64    pub source_id: Option<SourceId>,
65    /// Observation time nanoseconds.
66    pub at_ns: i64,
67    /// Optional evidence event.
68    pub event_id: Option<EventId>,
69}
70
71/// Bundle of host-prepared series used by miners/detectors.
72#[derive(Clone, Debug, Default)]
73pub struct AnalysisSeries {
74    /// Appearance / presence timestamps.
75    pub timed: Vec<TimedSubjectEvent>,
76    /// Dwell / visit durations.
77    pub durations: Vec<DurationSample>,
78    /// Route sequences.
79    pub routes: Vec<RouteSample>,
80    /// Co-occurrence pairs.
81    pub pairs: Vec<PairSample>,
82}