.. _package-rst-hri:
=================
Package rst.hri
=================
*Not documented*
Messages
========
.. container:: mess4ge-multi
.. container:: mess4ge-graph
.. digraph:: message_graph
fontname="Arial";
fontsize=11;
stylesheet="../_static/graphs.css";
node [fontsize=11,fontname="Arial"]
edge [fontsize=11,fontname="Arial"]
"1" [label=<
| PersonHypotheses |
|
PersonHypothesis | persons |
>,shape=box,style=filled,fillcolor="white"];
"2" [label=< | PersonHypothesis |
|
TrackingInfo | tracking_info |
LocatedFace | face |
Body | body |
Head | head |
AgeRange | age |
Gender | gender |
OCTET-VECTOR | id |
ASCII-STRING | name |
FLOAT32 | human_height |
AttentionTarget | attention_targets |
>,shape=box,style=filled,fillcolor="white"];
"16" [label=< | AttentionTarget |
|
OCTET-VECTOR | name |
FLOAT32 | probability |
>,shape=box,style=filled,fillcolor="white"];
"15" [label=< | Gender |
|
UNKNOWN | 0 |
MALE | 1 |
FEMALE | 2 |
>,shape=box,style=filled,fillcolor="white"];
"14" [label=< | AgeRange |
|
FLOAT32 | age_min |
FLOAT32 | age_max |
>,shape=box,style=filled,fillcolor="white"];
"13" [label=< | Head |
|
BoundingBox3DFloat | shape |
>,shape=box,style=filled,fillcolor="white"];
"10" [label=< | Body |
|
Translation | location |
Rotation | orientation |
BoundingBox3DFloat | shape |
>,shape=box,style=filled,fillcolor="white"];
"11" [label=< | BoundingBox3DFloat |
|
Pose | transformation |
FLOAT32 | width |
FLOAT32 | depth |
FLOAT32 | height |
>,shape=box,style=filled,fillcolor="white"];
"12" [label=< | Pose |
|
Translation | translation |
Rotation | rotation |
>,shape=box,style=filled,fillcolor="white"];
"4" [label=< | LocatedFace |
|
Face | face |
Translation | location |
Rotation | orientation |
>,shape=box,style=filled,fillcolor="white"];
"9" [label=< | Rotation |
|
FLOAT64 | qw |
FLOAT64 | qx |
FLOAT64 | qy |
FLOAT64 | qz |
ASCII-STRING | frame_id |
>,shape=box,style=filled,fillcolor="white"];
"8" [label=< | Translation |
|
FLOAT64 | x |
FLOAT64 | y |
FLOAT64 | z |
ASCII-STRING | frame_id |
>,shape=box,style=filled,fillcolor="white"];
"5" [label=< | Face |
|
BoundingBox | region |
FLOAT64 | confidence |
>,shape=box,style=filled,fillcolor="white"];
"6" [label=< | BoundingBox |
|
Vec2DInt | top_left |
UINT32 | width |
UINT32 | height |
UINT32 | image_width |
UINT32 | image_height |
>,shape=box,style=filled,fillcolor="white"];
"7" [label=< | Vec2DInt |
|
INT32 | x |
INT32 | y |
>,shape=box,style=filled,fillcolor="white"];
"3" [label=< | TrackingInfo |
|
UINT32 | id |
OCTET-VECTOR | persistent_id |
>,shape=box,style=filled,fillcolor="white"];
"1":persons -> "2"[];
"2" -> "16"[dir=both,arrowtail=odiamond];
"2" -> "15"[dir=both,arrowtail=odiamond];
"2" -> "14"[dir=both,arrowtail=odiamond];
"2":attention_targets -> "16"[];
"2":gender -> "15"[];
"2":age -> "14"[];
"2":head -> "13"[];
"2":body -> "10"[];
"2":face -> "4"[];
"2":tracking_info -> "3"[];
"13":shape -> "11"[];
"10":shape -> "11"[];
"10":orientation -> "9"[];
"10":location -> "8"[];
"11":transformation -> "12"[];
"12":rotation -> "9"[];
"12":translation -> "8"[];
"4":orientation -> "9"[];
"4":location -> "8"[];
"4":face -> "5"[];
"5":region -> "6"[];
"6":top_left -> "7"[];
.. container:: mess4ge-list
.. container:: messages
* :ref:`PersonHypotheses `
* :ref:`PersonHypothesis `
* :ref:`Head `
* :ref:`Body `
.. container:: clearer
clearer: should be made invisible via css
.. _message-rst-hri-personhypotheses:
Message PersonHypotheses
------------------------
.. container:: message-rst-hri-personhypotheses-multi
.. container:: message-rst-hri-personhypotheses-documentation
.. py:class:: rst.hri.PersonHypotheses
A sequence of person hypothesis.
.. codeauthor:: Johannes Wienke
.. py:attribute:: persons
:type: array of :py:class:`rst.hri.PersonHypothesis`
*Not documented*
.. container:: message-rst-hri-personhypotheses-source
:download:`Download this file /home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypotheses.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypotheses.proto
:lines: 14-18
:language: protobuf
:emphasize-lines: 3-3
.. _message-rst-hri-personhypothesis:
Message PersonHypothesis
------------------------
.. container:: message-rst-hri-personhypothesis-multi
.. container:: message-rst-hri-personhypothesis-documentation
.. py:class:: rst.hri.PersonHypothesis
A hypothesis about a person (e.g. in a person-tracking system).
.. codeauthor:: Johannes Wienke
.. py:attribute:: tracking_info
:type: :py:class:`rst.tracking.TrackingInfo`
A unique identification of a person hypothesis maintained by
the person manager.
.. py:attribute:: face
:type: :py:class:`rst.vision.LocatedFace`
The person's face as a part of an image. This also includes the
head's pose in 3D space.
.. py:attribute:: body
:type: :py:class:`rst.hri.Body`
Geometric properties of the person's body.
This includes the person's position in the world.
.. py:attribute:: head
:type: :py:class:`rst.hri.Head`
Geometric properties of the person's head.
This includes the person's head position in the world.
.. py:attribute:: age
:type: :py:class:`rst.hri.PersonHypothesis.AgeRange`
The person's age in years as a range.
If the exact age is known, set both bounds of the range to the
desired value.
.. py:attribute:: gender
:type: :py:class:`rst.hri.PersonHypothesis.Gender`
The person's gender.
.. py:attribute:: id
:type: :py:class:`OCTET-VECTOR`
**Constraint**: ``len(value) = 16``
A unique, persistent id (a RFC 4122 UUID) for the person.
For this encoding, the encoded UUID is 16 bytes long.
.. py:attribute:: name
:type: :py:class:`ASCII-STRING`
The person's name. Empty string means unknown or undecided.
.. py:attribute:: human_height
:type: :py:class:`FLOAT32`
**Unit**: meter
**Constraint**: ``value >= 0``
Human height of the person (from the ground).
.. seealso::
Definition of the person's body height
http://en.wikipedia.org/wiki/Human_height
.. py:attribute:: attention_targets
:type: array of :py:class:`rst.hri.PersonHypothesis.AttentionTarget`
A list of defined attention targets in a scene that a person can focus
on with the probability that each target is actually currently focused
by this person.
.. container:: message-rst-hri-personhypothesis-source
:download:`Download this file /home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto
:lines: 17-132
:language: protobuf
:emphasize-lines: 7-7,13-13,20-20,27-27,55-55,66-66,74-74,79-79,89-89,115-115
.. _message-rst-hri-personhypothesis-agerange:
Message AgeRange
----------------
.. container:: message-rst-hri-personhypothesis-agerange-multi
.. container:: message-rst-hri-personhypothesis-agerange-documentation
.. py:class:: rst.hri.PersonHypothesis.AgeRange
Represents a person's age in years as a range.
If the exact age is known, set both values (min and max) to the
desired value.
.. py:attribute:: age_min
:type: :py:class:`FLOAT32`
The lower bound of the age range.
.. py:attribute:: age_max
:type: :py:class:`FLOAT32`
The upper bound of the age range.
.. container:: message-rst-hri-personhypothesis-agerange-source
:download:`Download this file /home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto
:lines: 51-63
:language: protobuf
:emphasize-lines: 6-6,11-11
.. _message-rst-hri-personhypothesis-gender:
Message Gender
--------------
.. container:: message-rst-hri-personhypothesis-gender-multi
.. container:: message-rst-hri-personhypothesis-gender-documentation
.. py:class:: rst.hri.PersonHypothesis.Gender
*Not documented*
.. py:attribute:: UNKNOWN
= 0
*Not documented*
.. py:attribute:: MALE
= 1
*Not documented*
.. py:attribute:: FEMALE
= 2
*Not documented*
.. container:: message-rst-hri-personhypothesis-gender-source
:download:`Download this file /home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto
:lines: 73-77
:language: protobuf
:emphasize-lines: 2-2,3-3,4-4
.. _message-rst-hri-personhypothesis-attentiontarget:
Message AttentionTarget
-----------------------
.. container:: message-rst-hri-personhypothesis-attentiontarget-multi
.. container:: message-rst-hri-personhypothesis-attentiontarget-documentation
.. py:class:: rst.hri.PersonHypothesis.AttentionTarget
Indication of the probability that a person focuses on a named
attention target in the scene.
.. py:attribute:: name
:type: :py:class:`OCTET-VECTOR`
String description of the target
.. py:attribute:: probability
:type: :py:class:`FLOAT32`
**Constraint**: ``0 <= value <= 1``
Probability of the target.
.. container:: message-rst-hri-personhypothesis-attentiontarget-source
:download:`Download this file /home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/PersonHypothesis.proto
:lines: 111-124
:language: protobuf
:emphasize-lines: 6-6,12-12
.. _message-rst-hri-head:
Message Head
------------
.. container:: message-rst-hri-head-multi
.. container:: message-rst-hri-head-documentation
.. py:class:: rst.hri.Head
Geometric properties of a person's head (e.g. in a person-tracking
system).
.. codeauthor:: Leon Ziegler
.. codeauthor:: Rene Zorn
.. py:attribute:: shape
:type: :py:class:`rst.geometry.BoundingBox3DFloat`
Bounding box around the whole head.
This is not necessarily aligned to location and orientation.
.. container:: message-rst-hri-head-source
:download:`Download this file /home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/Head.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-trunk/upstream/RST-0.19.0-Linux/share/rst0.19/proto/sandbox/rst/hri/Head.proto
:lines: 16-25
:language: protobuf
:emphasize-lines: 8-8