5.3.3 Aggregate Information Bits

5.3.3.1 General

These bits are set only when obtaining Aggregate data. They indicate where the data value came from and provide information that affects how the client uses the data value. Table 47 lists the bit settings which indicate the data location (i.e. is the value stored in the underlying data repository, or is the value the result of data aggregation). These bits are mutually exclusive.

Table 47 – Data location
StatusCodeDescription
RawA Raw data value.
CalculatedA data value which was calculated.
InterpolatedA data value which was interpolated.

In the case where Interpolated data is requested, and there is an actual raw value for that timestamp, the Server should set the ‘Raw’ bit in the StatusCode of that value.

Table 48 lists the bit settings which indicate additional important information about the data values returned.

Table 48 – Additional information
StatusCodeDescription
Partial A calculated value that is not based on a complete interval. See 5.3.3.2.
Extra DataIf a Server chooses to set this bit, it indicates that a Raw data value supersedes other data at the same timestamp.
Multiple ValuesMultiple values match the Aggregate criteria (i.e. multiple minimum values or multiple worst quality at different timestamps within the same ProcessingInterval).

The conditions under which these information bits are set depend on how the data has been requested and state of the underlying data repository.

5.3.3.2 Partial Information bit

Partial bit is used to indicate that the interval is not a complete interval and that a client may receive a different value for the Aggregate if it re-fetches the interval with the same parameters.

The Partial bit will be set in the following examples:

Assume for these examples the first stored point in the collection is 1:01:10 and the last stored point in the collection is 1:31:20. Older data may exist but is unavailable or offline at the time of the query. Newer data may be available but has not yet been stored in the history collection.

The Partial bit may be set with the Calculated bit when the Calculated bit is always set for the specific Aggregate.