Descriptive Analytics
  
Descriptive Analytics
Descriptive Analytics provides on-demand services that perform common statistical calculations and facilitate statistical monitoring. When using the ThingWorx platform to build an IoT solution, output from these services can be added quickly and easily to an application. The services provided by Descriptive Analytics can be used to build solution-specific visualizations (mashups or widgets), create alerts based on logged property values, or generate transformed data for machine learning processes.
The Descriptive Analytics microservice includes two microservers, each with its own set of statistical services.
StatisticalCalculation Microserver
The StatisticalCalculation Microserver contains a library of computational services that perform common statistical calculations and frequency transformations on raw data. These services are designed to receive data from the QueryTimedValuesForProperty service.
* 
Use of the QueryTimedValuesForProperty service is not a requirement. However, when data is provided from other sources, the format of the data might cause error during execution.
The StatisticalCalculation Microserver include the following services.
Calculation Service*
Description
Binned Data Distribution for Bin Size
Calculate the binned distribution of data points based on the desired bin size.
Binned Data Distribution for Number of Bins
Calculate the binned distribution of data points based on the desired number of bins.
Confidence Interval Values
Based on a specified confidence interval percentage, calculate the minimum, median, and maximum interval values.
Five Number Property Values
Calculate the five number values: minimum, lower quartile, median, upper quartile, and maximum.
Fourier Transform
Calculate the results of running the fast Fourier transform on the specified values.
Maximum Value
Calculate the maximum property value in the provided infotable.
Mean Value
Calculate the mean property value in the provided infotable.
Median Value
Calculate the median property value in the provided infotable.
Minimum Value
Calculate the minimum property value in the provided infotable.
Mode Value
Calculate the mode values from the provided infotable.
Sampling Frequency Values
Calculate the sampling frequency values: minimum, median, and maximum.
Standard Deviation Value
Calculate the standard deviation value from the provided infotable.
Range Value
Calculate the range of property values in the provided infotable, from the maximum to the minimum.
* 
Available only from release 8.4.4 onward.
Rate of Change
Calculate the percentage of difference between two specified values.
* Most of the Statistical Calculation services do not use the timestamp that is included in the data. Only the Fourier Transform and the Sampling Frequency Values services use the timestamp. For these services the timestamp parameter must be formatted according to the output of the QueryTimedValuesForProperty service.
StatisticalMonitoring Microserver
The StatisticalMonitoring Microserver contains a library of services that calculate the following types of statistical control criteria on a stream of data:
Monitoring Service
Description
Number of Points Beyond a Threshold
Monitor for the number of points in a series that are above or below a defined threshold.
Number of Consecutive Points Beyond a Threshold
Monitor for the number of consecutive point in a series that are above or below a defined threshold.
Number of Points Based on a Range
Monitor for the number of points in a series that remain inside or outside of a defined range.
Number of Consecutive Points Based on a Range
Monitor for the number of consecutive points in a series that remain inside or outside of a defined range.
Number of Consecutive Points Following a Trend
Monitor for the number of consecutive points in a series that are increasing, decreasing, or alternating direction.
Rate of Change
Monitor for the percentage of difference between two specified values.
Number of Points with Change Rate Out of Range
Monitor for how many pairs of consecutive points in a series have a rate of change outside the defined range. If the first value in a pair is 0, the pair is not considered for rate of change.
Related Topics
The following sections contain additional information about using Descriptive Analytics:
Descriptive Analytics Architecture – an overview of the components that comprise the functionality
Scenarios for Use – descriptions of some common scenarios for using the functionality
Preparations for Use – the minimum preparation required for implementing the functionality
Using the Sample Mashup – instructions for using the provided reference mashup and the sample data