1use core::num::NonZeroU64;
4
5use super::super::{
6 radio_evidence::{RadioIdentifier, RadioObservationTime},
7 record::{CalibrationDeclaration, MeasurementQuality, ProvenanceDeclaration},
8 uncertainty::{EvidenceReference, MethodVersion, UncertaintyRecord},
9 MeasurementModality, PhysicalFieldSemantics, SemanticId,
10};
11
12#[derive(Clone, Copy, Debug, PartialEq, Eq)]
13pub enum CandidateKind {
14 Unknown,
15 Entity,
16 Agent,
17}
18
19#[derive(Clone, Copy, Debug, PartialEq, Eq)]
22pub struct EntityCandidate {
23 pub id: NonZeroU64,
24 pub kind: CandidateKind,
25 pub ontology_type: SemanticId,
26}
27
28#[derive(Clone, Copy, Debug, PartialEq, Eq)]
31pub struct AssociationHypothesis {
32 pub id: NonZeroU64,
33 pub subject: EntityCandidate,
34 pub relation_id: NonZeroU64,
35 pub object: EntityCandidate,
36}
37
38#[derive(Clone, Copy, Debug, PartialEq, Eq)]
39pub enum AssociationEvidenceKind {
40 Measurement(MeasurementModality),
41 RadioIdentifier,
42 NfcIdentifier,
43 EnvironmentalContext,
44 SocialContext,
45 IdentityAnchor,
46 Other(SemanticId),
47}
48
49#[derive(Clone, Copy, Debug, PartialEq)]
50pub enum AssociationValue {
51 Unknown,
52 Missing,
53 Scalar {
54 value: f64,
55 quantity: SemanticId,
56 unit: SemanticId,
57 },
58 Radio(RadioIdentifier),
59 Reference(EvidenceReference),
62}
63
64#[derive(Clone, Copy, Debug, PartialEq)]
67pub struct AssociationEvidence<'a> {
68 pub observation_id: NonZeroU64,
69 pub source_id: SemanticId,
70 pub context_id: SemanticId,
71 pub kind: AssociationEvidenceKind,
72 pub value: AssociationValue,
73 pub observed_at: RadioObservationTime,
74 pub quality: MeasurementQuality,
75 pub calibration: CalibrationDeclaration,
76 pub provenance: ProvenanceDeclaration,
77 pub field: Option<PhysicalFieldSemantics>,
78 pub uncertainty: Option<&'a UncertaintyRecord>,
79 pub dependence_group: Option<NonZeroU64>,
80}
81
82#[derive(Clone, Copy, Debug, PartialEq, Eq)]
83pub enum DependenceAssumption {
84 Unknown,
85 Joint,
88 IndependentGroups {
91 justification: EvidenceReference,
92 },
93}
94
95#[derive(Clone, Copy, Debug, PartialEq, Eq)]
96pub struct AssociationModelReference {
97 pub method: MethodVersion,
98 pub calibration: EvidenceReference,
99}
100
101#[derive(Clone, Copy, Debug, PartialEq, Eq)]
104pub struct AssociationRequest {
105 pub context_id: NonZeroU64,
106 pub purpose_id: NonZeroU64,
107 pub actor_id: Option<NonZeroU64>,
108 pub policy_context: Option<EvidenceReference>,
109}
110
111#[derive(Clone, Copy, Debug, PartialEq)]
115pub enum AssociationPhase<'a> {
116 Evaluate,
117 Publish {
118 results: &'a [super::AssociationResult],
119 evaluation_decision: EvidenceReference,
120 },
121}
122
123#[derive(Clone, Copy, Debug, PartialEq, Eq)]
124pub enum AssociationPermission {
125 Unknown,
126 Denied,
127 Approved { decision: EvidenceReference },
128}
129
130pub trait AssociationAuthority {
139 fn authorize(
140 &mut self,
141 phase: AssociationPhase<'_>,
142 request: &AssociationRequest,
143 hypotheses: &[AssociationHypothesis],
144 evidence: &[AssociationEvidence<'_>],
145 model: AssociationModelReference,
146 dependence: DependenceAssumption,
147 ) -> AssociationPermission;
148}
149
150#[derive(Clone, Copy)]
153pub struct AssociationEvidenceGroup<'a, 'data> {
154 pub(super) evidence: &'a [AssociationEvidence<'data>],
155 pub(super) group: Option<NonZeroU64>,
156}
157
158impl<'a, 'data> AssociationEvidenceGroup<'a, 'data> {
159 pub const fn group_id(self) -> Option<NonZeroU64> {
160 self.group
161 }
162
163 pub fn records(self) -> impl Iterator<Item = &'a AssociationEvidence<'data>> {
164 self.evidence
165 .iter()
166 .filter(move |record| self.group.is_none() || record.dependence_group == self.group)
167 }
168}
169
170#[derive(Clone, Copy, Debug, PartialEq)]
173pub struct BinaryLogLikelihoods {
174 pub given_association: f64,
175 pub given_no_association: f64,
176}
177
178pub trait CalibratedAssociationModel {
184 fn reference(&self) -> AssociationModelReference;
185 fn prior_probability(
186 &self,
187 request: &AssociationRequest,
188 hypothesis: &AssociationHypothesis,
189 ) -> Option<f64>;
190 fn joint_log_likelihoods(
191 &self,
192 request: &AssociationRequest,
193 hypothesis: &AssociationHypothesis,
194 evidence: AssociationEvidenceGroup<'_, '_>,
195 ) -> Option<BinaryLogLikelihoods>;
196}