Analytic multi-trend requests (analyticMultiTrend:)

Analytic multi-trends are similar to trend requests, but they also consolidate trend data from multiple ORDs into a single BITable.

The list of ORDs formed depends on the multiOrd parameter passed as part of ORD query. The consolidation depends on the aggMode and agg properties. If aggMode is true, the system consolidates the data from multiple ORDs using the combination defined by the agg parameter. Else, it creates a multi-column table, which has a column for the output of each ORD query.

For example:

node=slot:/Drivers/BacnetNetwork/Building1/ElectricMeter,node=slot:
/Drivers/ModbusNetwork/Building2/ElectricMeter

ORD scheme parameter	Syntax	Description
aggregation	aggregation=option (defaults to `First`)	Configures the default function to apply when the analytic request needs to combine values from multiple data sources into a single value. This applies to both value and trend requests. If aggregation is not enabled in the binding/settings window, the aggregation value defined in the Data Definition applies to all chart bindings, reports and tables. `And` returns the logical “and” of Boolean values. `Avg` returns the statistical mean, which is determined by calculating the sum of all values and dividing by the number of values. `Count` returns the total number or quantity of values in a combination. If you request this value on a binding in a PX view, the system counts the number of values based on the properties defined by the data source block and the algorithm’s Property Sheet. `First` returns the first value in the combination. `Last` returns the last value in the combination. `Max` returns the highest value in the combination. `Median` returns the value in the middle of a sorted combination—the number that separates the higher half from the lower half. `Min` returns the lowest value in the combination. `Mode` returns the statistically most frequently occurring number in the combination. `Or` returns the logical “or” of Boolean values. `Range` returns the statistical difference between the largest and smallest values in the combination. `Sum` adds together all values in the combination resulting in a single value. `Load Factor` returns the average value divided by peak value. `Std Dev` returns the standard deviation of the values in the combination.
Data	algorithm (or tag) name; data=algorithm or tag name	Specifies the an algorithm (or tag) used to retrieve data. The purpose of an alert is to detect a fault condition (Boolean value result). In most cases, you would pick an algorithm that has a Boolean result when configuring this property for an alert. Algorithms with a numeric or enum value greater than zero are considered true and less than zero are considered false. This is how output from one algorithm becomes the input data source to another algorithm. The prefix for algorithms is alg:.
Data Filter, dataFlter	optional NEQL query (property) or ORD parameter (dataFilter=query)	Identifies data sources in the subtree of the request node. When a predicate accepts a node that contains the desired data, the system does not search the node’s subtree for additional values (including the root node).
Interval, interval	optional drop-down list (defaults to the optimal number of records on reports); interval=option	Refers to the BInterval component, which the framework uses to identify the time between values in a trend (time series). When specified, a rollup is required, which causes the system to combine all values that fall into a single interval. Options range from `None` to a `Year`. Above the drop-down list, the `Use This Value` check box turns on and off the check box next to `Interval` in the Settings window (you access this window by clicking the Edit button (), followed by clicking the Settings button () on the chart). The availability of this check box provides an easy way for a user to enable and disable the use of intervals in chart calculations.
normalizeTime	`true` (default) or `false`; normalizeTime=option	Manages how time is represented. `true` converts time to the time zone of the request. This preserves time properties, such as the hour of day, while changing the time zone. `false` does not perform the conversion.
rollup	rollup=option	Configures the default function to apply when the analytic request needs to rollup records from a single data source into less granular records. This typically only applies to trend request, but may also apply to value requests where the Id is an algorithm that contains a block like Runtime or Sliding Window, which processes a trend request. If rollup is not enabled in the binding/settings window, the rollup value configured in the Data Definition applies to all chart bindings, reports and tables. `And` returns the logical “and” of Boolean values. `Avg` returns the statistical mean, which is determined by calculating the sum of all values and dividing by the number of values. `Count` returns the total number or quantity of values in a combination. If you request this value on a binding in a PX view, the system counts the number of values based on the properties defined by the data source block and the algorithm’s Property Sheet. `First` returns the first value in the combination. `Last` returns the last value in the combination. `Max` returns the highest value in the combination. `Median` returns the value in the middle of a sorted combination—the number that separates the higher half from the lower half. `Min` returns the lowest value in the combination. `Mode` returns the statistically most frequently occurring number in the combination. `Or` returns the logical “or” of Boolean values. `Range` returns the statistical difference between the largest and smallest values in the combination. `Sum` adds together all values in the combination resulting in a single value. `Std Dev` calculates the standard deviation of the values in the combination. `Load Factor` calculates the average divided by peak (Max) value.
timeRange	timerange=option	Defines the time period used to query historical data. This property is required for rollup requests (analyticRollup), trends (analyticTrend), and rollup bindings. It is optional elsewhere. It is not used if the block’s `Use Request Time Range` property is `true` and the request specifies a time range. Options range from `From` to `All`.
useCache	optional ORD parameter `true` or `false`; useCache=option	Turns on and off the use of cache memory. `true` causes the framework to request cache memory for value, trend and rollup requests that take longer than 200ms to process. `false` uses no cache. This property is not related to the data availability cache.
Series Name, seriesName	BFormat (defaults to %node.navDisplayName-data.name%)	Defines the node and tag name configured by the `Data` property. The BFormat value may contain static text or scripts that use the percentage symbol delimiter, such as %node.navDisplayName%. The default value is %node.navDisplayName%-%data.name%, which resolves to the navDisplayName of the node and the name of the tag configured by the `Data` property, such as ”Building1-Power.” The %data.name% script drops the tags namespace, such as “hs:” or the algorithm reference, such as “alg:.” If you enter an invalid value, the system displays, “Problem with seriesName BFormat,” and logs a message in the station console. The name you enter here displays as the legend and tool tip in the Web chart. If left blank, no legend displays for the tool tip.
Totalize, totalize	`true` (true) or `false` or hisTotEnabled=option (ORD scheme parameter)	Turns on (`true`) and off (`false`) value accumulation. By default, the framework totalizes (accumulates) all consumption history values in charts, tables and reports. To prevent cumulative values, disable this property (set it to `false`).
daysOfWeek	dow=option	Specifies the days of the week to include.
aggStrategy	aggStrategy=option	Selects the missing data aggregation strategy, which defines how to handle data in a series when even a single record for an interval is missing. `Ignore Point` tells the system to ignore any missing records and aggregate the values in the existing records. `Ignore Series` tells the system to ignore the entire series if the record for even one interval in the series is missing.
intpAlgorithm	intpAlgorithm=option (ORD scheme parameter)	Selects the missing data interpolation algorithm, which defines the value to replace a missing value. `Linear Interpolation` replaces a missing value by linearly interpolating the missing value. `K-Nearest Neighbor` is for numeric, enum and Boolean records. This strategy replaces a missing value by calculating the majority value recorded for the item’s nearest neighbors.
knnValue	knnvalue=n (ORD scheme parameter	Indicates the number of neighbors to a missing data item that the interpolation algorithm should include in its calculation.
unit	unit=option (unit of measure)	Selects the unit name and display symbol to associate with a data source.
multiOrd	comma separated list of ORD parameters	Identifies the nodes to add to the multi trend ord scheme.
aggMode	`true` or `false`	`true` enables `agg`. `false` returns a multi column response, which results in a union of the timestamps
agg	agg=option	Aggregates the result of all the trend requests that correspond to each of the nodes. `And` returns the logical “and” of Boolean values. `Avg` returns the statistical mean, which is determined by calculating the sum of all values and dividing by the number of values. `Count` returns the total number or quantity of values in a combination. If you request this value on a binding in a PX view, the system counts the number of values based on the properties defined by the data source block and the algorithm’s Property Sheet. `First` returns the first value in the combination. `Last` returns the last value in the combination. `Max` returns the highest value in the combination. `Median` returns the value in the middle of a sorted combination—the number that separates the higher half from the lower half. `Min` returns the lowest value in the combination. `Mode` returns the statistically most frequently occurring number in the combination. `Or` returns the logical “or” of Boolean values. `Range` returns the statistical difference between the largest and smallest values in the combination. `Sum` adds together all values in the combination resulting in a single value. `Load Factor` returns the average value divided by peak value. `Std Dev` returns the standard deviation of the values in the combination.

Analytic multi-trend requests (analyticMultiTrend:)

Related Links