[{"id":"7e3f7136-1a64-4958-84b8-24a4fbd2ef63","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"ab9ddf70-2472-43cc-94cd-2d03e0184d91","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"5e8a53c6-6b91-48cd-948d-406d4b128766","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"1acc9c3e-8bdd-4252-8798-4c4daf6db52c","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"074fc315-ff19-4be5-90ff-4fafbf049047","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"b94af2a4-df24-4732-825c-934150ecfcd3","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"985baaf2-5017-40cd-9cc9-b50fdb4b0b6c","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"fb2abd65-126a-4d70-9674-c1c331d2a4ad","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]},{"id":"cda48895-8088-4634-9e44-c92fdfbc024c","tags":[{"name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601","links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e"}]}]
        
(Showing Draft Content)

Chart Overlays

Overlays

In addition to geometrical shapes, such as columns, bars, or lines, that represent the data, a plot can contain additional items, called overlays, that represent the meta-information about the data. A typical example is a trendline that shows the linear regression of the data, as in the picture below.


image.png


You can add an overlay by selecting a plot and editing its Overlays collection in the Property Inspector.

All overlays has the following common properties:

  • Name – the name of the overlay

  • Type – the type of the overlay

  • Display – the Front value indicates that the overlay displays on the front side of the plot, the Back value indicates that the overlay displays on the back side of the plot

ActiveReportsJS chart supports several overlays types that we describe in detail below.

Reference lines

You can use Reference lines to display the data value at a given point. For example, the chart below has the reference line at the y-axis at the value that corresponds to the average sales amount for each sales channel.


image.png


A Reference line overlay exposes the following specific properties:

  • The Line Properties set the appearance of the reference line.

  • The Axis property specifies the axis with which the reference line is associated.

  • The Value property specifies the value of the reference line on the selected axis. You can use for static values.

  • The Field property specifies the data value on the selected axis that the reference line is associated with.

  • The Aggregate type property specifies the aggregation type that applies to the Field to calculate the value of the reference line.

  • The Legend Label property specifies the text that appears in the legend and associated with the reference line.

  • The Detail Level property specifies whether the reference line appears once per plot(Total) or once per detail encoding instance(Group).

Reference bands

You can use Reference bands to display a range of data values between given points. A Reference band overlay exposes the following specific properties:

  • The Line Properties and the Background Color set the appearance of the reference band.

  • The Axis property specifies the axis with which the reference band is associated.

  • The Start and End properties specify the start and the end values of the reference band on the selected axis. You can use for static values.

Linear trendlines

You can use Linear trendlines to display the best fit straight line that shows how data values increase or decrease at a steady rate. For example, the chart below has a linear trendline that shows the trend of the sales amount over three consecutive years.


image.png


A Linear trendline overlay exposes the following specific properties:

  • The Line Properties set the appearance of the trendline.

  • The Intercept property specifies the point where the trendline should cross the Y axis. You can use it for static values.

  • The Forward Forecast Period and the Backward Forecast Period properties specifies the number of data points for which the trendline extends forward and backwards relative to the last and the first data values, respectively.

  • The Field property specifies the data value with which the trendline is associated.

  • The Legend Label property specifies the text that appears in the legend and associated with the trendline.

  • The Detail Level property specifies whether the trendline appears once per plot(Total) or once per detail encoding instance(Group).

Exponential trendlines

You can use Exponential trendlines to display the best fit exponential curve that illustrates how data values increase or decrease and then level out. This trendline can only be used with data values that are greater than zero. A Exponential trendline overlay exposes the same properties as the Linear trendline overlay.

Power trendlines

You can use Power trendlines to display the best fit curved line to compare measurements that increase at a specific rate. This trendline can only be used with data values that are greater than zero. A Power trendline overlay exposes the same properties as the Linear trendline overlay, except for the Intercept property.

Logarithmic trendlines

You can use Logarithmic trendlines to display the best fit exponential curve that illustrates how data values increase or decrease and then level out. A Logarithmic trendline overlay exposes the same properties as the Linear trendline overlay, except for the Intercept property.

Polynomial trendlines

You can use Polynomial trendlines to display a best fit a curved line illustrating fluctuations in data values. For example, the chart below has a polynomial trendline that shows the trend of the sales amount over months.


image.png


A Polynomial trendline overlay exposes the same properties as the Linear trendline overlay. The Order property that has valid values from 2 to 6 indicates the complexity of the equation that defines the polynomial trendline.

Fourier series trendlines

You can use Fourier series trendlines to display a best fit Fourier Series line that illustrates fluctuations in data values. A Fourier series trendline overlay exposes the same properties as the Linear trendline overlay. The Order property that has valid values from 2 to 6 indicates the complexity of the equation that defines the Fourier series trendline.

Moving average trendlines

You can use Moving average trendlines to display a line that smooths out fluctuations in data values to show a pattern or trend more clearly.


ActiveReportsJS supports the following moving average trendline types:

A Moving average trendline overlays expose the following properties.

  • The Line Properties set the appearance of the trendline.

  • The Field property specifies the data value with which the trendline is associated.

  • The Legend Label property specifies the text that appears in the legend and associated with the trendline.

  • The Detail Level property specifies whether the trendline appears once per plot(Total) or once per detail encoding instance(Group).

  • The Period property that has valid values from 2 to the amount of data values indicates the number of data points used to calculate the moving average.

For example, the chart below has a simple moving average trendline with Period = 2 that shows the trend of the sales amount over months.


image.png