Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add UML + some restructure

...

  • SpecifiedPlainRecord
  • SpecifiedTimeStampedRecord, etc.


Image Added

...

TimeStamp

NOTE:  The exact format of all of these may differ when these concepts are translated to different protocols or languages.
As a starting point however, let's propose to use ISO 8601 standard format, with fractional seconds (e.g. microseconds) and always UTC (Zulu) time zone, if a TimeStamp is given in text format.  For other purposes such as binary formats, more efficient encodings should be considered. 

Real, "Wall clock time"

  •    "ts" : "2020-01-10T02:59:43.492750Z # Zulu time, ISO std with microseconds

Relative to a previously predefined time stamp reference:

  • "rts" : "T02:59:43.100044"    # Similar to ISO 8610.  Years/month/dates can be omitted if zero
  • "rts" : "02:59:43.100044"      # Alternative, also OK
  • "rts2", "rts3", ...                      # If more than one relative time stamp reference had been previously agreed


...

Bundle

  • A collection of several records, transferred together.
  • Subtypes are TimeSeries and Snapshot.

...

Note that values in a Snapshot need a record type that specifies the signal, since different signals are included in the same message.

Image Added


Stream:

  • Continuous delivery of data points according to a predefined agreement
  • Not only a different container type.  It deals more with the delivery method (constant stream compared to atomic message)
  • Does not have a fixed start/end time
  • Delivers a stream of Records (or Snapshots)
  • + could also deliver side-band information (e.g. Job information)
  • Is analogous to the delivery of a Subscription for protocols that support subscriptions.

...

NOTE:  The exact format of all of these may differ when these concepts are translated to different protocols or languages.
As a starting point however, let's propose to use ISO 8601 standard format, with fractional seconds (e.g. microseconds) and always UTC (Zulu) time zone, if a TimeStamp is given in text format.  For other purposes such as binary formats, more efficient encodings should be considered. 

Real, "Wall clock time"

  •    "ts" : "2020-01-10T02:59:43.492750Z # Zulu time, ISO std with microseconds

Relative to a previously predefined time stamp reference:

...


...

Image Added


...

Examples, in JSON


(Plain) Record:

...