1# This message encodes possible matches between transient IDs (face, body,
2# voice) and permanent IDs (person), with their corresponding confidence level.
3# Such messages should be published on the /humans/candidate_matches topic.
4#
5# confidence == 0.0 has the special meaning of: those two IDs are *not* associated.
6# This can be use for instance if one of the ID (eg, a face id) is not valid anymore
7# (face not tracked anymore)
8#
9# Note that setting only one of `id1` or `id2` is invalid. Likewise, `id1` and
10# `id2` can not be equal.
11#
12# ## Examples
13#
14# For instance, a face recognition module might publish the following message
15# to indicate that face 'a3eb4' has been recognised with 63% confidence as
16# person 'b31ad':
17#
18# {id1: 'a3eb4', id1_type: FACE, id2: 'b31ad', id2_type: PERSON, confidence:
19# 0.63, }
20#
21# Another example: a module that detect both faces and skeleton might publish a
22# 100% confidence match between the two:
23#
24# {id1: 'ff424', id1_type: FACE, id2: '850d1', id2_type: BODY, confidence:
25# 1.0, }
26#
27
28int8 UNSET=0
29int8 PERSON=1
30int8 FACE=2
31int8 BODY=3
32int8 VOICE=4
33
34string id1
35int8 id1_type
36string id2
37int8 id2_type
38
39float32 confidence