.. _package-rst-timing:
====================
Package rst.timing
====================
This package contains data types which represent aspects of time.
Messages
========
.. container:: mess4ge-multi
.. container:: mess4ge-graph
.. digraph:: message_graph
fontname="Arial";
fontsize=11;
stylesheet="../_static/corlab.css";
node [fontsize=11]
node [fontname="Arial"]
edge [fontsize=11]
edge [fontname="Arial"]
"4" [label=<
| Frequency |
|
FLOAT64 | hz |
>,shape=box,style=filled,fillcolor="white"];
"3" [label=< | Duration |
|
UINT64 | time |
>,shape=box,style=filled,fillcolor="white"];
"1" [label=< | Interval |
|
Timestamp | begin |
Timestamp | end |
>,shape=box,style=filled,fillcolor="white"];
"2" [label=< | Timestamp |
|
UINT64 | time |
>,shape=box,style=filled,fillcolor="white"];
"1":end -> "2" [];
"1":begin -> "2" [];
.. container:: mess4ge-list
.. container:: messages
* :ref:`Interval `
* :ref:`Duration `
* :ref:`Timestamp `
* :ref:`Frequency `
.. container:: clearer
clearer: should be made invisible via css
.. _message-rst-timing-interval:
Message Interval
----------------
.. container:: message-rst-timing-interval-multi
.. container:: message-rst-timing-interval-documentation
.. py:class:: rst.timing.Interval
**Constraint**: ``.begin.time <= .end.time``
A time interval represented with two absolute timestamps.
.. codeauthor:: Arne Nordmann
.. py:attribute:: begin
:type: :py:class:`rst.timing.Timestamp`
Start of the interval.
.. py:attribute:: end
:type: :py:class:`rst.timing.Timestamp`
End of the interval.
.. container:: message-rst-timing-interval-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Interval.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Interval.proto
:lines: 13-25
:language: protobuf
:emphasize-lines: 6-6,11-11
.. _message-rst-timing-duration:
Message Duration
----------------
.. container:: message-rst-timing-duration-multi
.. container:: message-rst-timing-duration-documentation
.. py:class:: rst.timing.Duration
Holds a time duration in microseconds.
.. codeauthor:: Arne Nordmann
.. py:attribute:: time
:type: :py:class:`UINT64`
**Unit**: microsecond
.. container:: message-rst-timing-duration-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Duration.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Duration.proto
:lines: 10-15
:language: protobuf
:emphasize-lines: 4-4
.. _message-rst-timing-timestamp:
Message Timestamp
-----------------
.. container:: message-rst-timing-timestamp-multi
.. container:: message-rst-timing-timestamp-documentation
.. py:class:: rst.timing.Timestamp
Holds a UNIX timestamp in microseconds.
Count starts at the Unix Epoch on January 1st, 1970 in UTC time.
.. codeauthor:: Agnes Swadzba
.. py:attribute:: time
:type: :py:class:`UINT64`
**Unit**: microsecond
Number of microseconds since January 1st, 1970 in UTC time.
.. container:: message-rst-timing-timestamp-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Timestamp.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Timestamp.proto
:lines: 12-20
:language: protobuf
:emphasize-lines: 7-7
.. _message-rst-timing-frequency:
Message Frequency
-----------------
.. container:: message-rst-timing-frequency-multi
.. container:: message-rst-timing-frequency-documentation
.. py:class:: rst.timing.Frequency
Holds a frequency.
.. codeauthor:: Arne Nordmann
.. py:attribute:: hz
:type: :py:class:`FLOAT64`
**Unit**: hertz
.. container:: message-rst-timing-frequency-source
:download:`Download this file /home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Frequency.proto>`
.. literalinclude:: //home/jenkins/workspace/rst-manual-0.11-merge-simulator/rst-manual/../rst-proto/proto/stable/rst/timing/Frequency.proto
:lines: 10-15
:language: protobuf
:emphasize-lines: 4-4