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}