"curveDataAt","curveDataAtX"

Returns the data which is available for a specific curve at a stated point in time.

Synopsis

trendObj.curveDataAt(string curve, time ti, mapping &data);

getValue(trendObj, "curveDataAt", string curve, time ti, mapping &data);

Parameter

Parameter Description
trendObj Trend for which the attributed should be get
curve Name of the curve
ti Point in time for which the data should be returned
data Data that is returned

Details

The Function returns the data for a specific point of time for the given curve. The returned data is a mapping that contains following information/keys:

  • time - Exact time (might differ from the stated time)
  • status - The status of the curve as bit64
  • value - the corresponding average value as float
  • minValue - the corresponding minimum value as float (returned when downsampling is active)
  • maxValue - the corresponding maximum value as float (returned when downsampling is active)
  • formattedValue - The formatted average value as displayed inside the legend
  • minFormattedValue - The formatted minimum value as displayed inside the legend (returned when downsampling is active)
  • maxFormattedValue - The formatted maximum value as displayed inside the legend (returned when downsampling is active)
  • msgCatKey - Contains the matched config keys for the "trendStatusPattern" (optional)
  • pointIcon - Path to the used icon file (optional)

If the curve is an event curve than the corresponding event data is returned as JSON mapping in addition to the mapping keys above.

Assignment

Trend