_average

Calculate the average of some Ratings -- Function

When you have a Rating or Review Property, you often want to know the average value of those ratings. This function is how you get those.

To use _average, your User Value Property must define the Summary Link Property, and set that to a Property of Rating Summarizer type. That Summarizer keeps track of the statistics about those User Values, and you can use the _average function on it.

So for example, say that you have a Property called My Ratings, which is of Rating Type. You should create another Property named My Rating Summary with the type Rating Summarizer, and set My Ratings' Summary Link to that. Once you have done that, you can say [[My Rating Summary -> _average]] to show the average rating of this Thing.

The average will display with stars, much like the input for Ratings. It is of a special Type named _ratingAverageType, which is only used for this purpose.

This Function will eventually be broadened, to let you calculate averages of Lists and Sets of numbers more generally. If you need that, please speak up, and we'll prioritize it.