TopCount (PQL)

Returns a derived list of the TOP elements from the specified list. 

  • Returned Output: List
  • Library: PQL \ Semantic \ List
  • Version: 2018.00.000
  • Compatibility: Pyramid Query Language (PQL) data sources

Syntax

TopCount( <List> , <Integer> , OPTIONAL <Data Point> )
Syntax Alternatives

Top( <List> , <Integer> , OPTIONAL <Data Point> )

* Click on the function's arguments above for more details on the input values.

Comments
  • List parameter should be a list or set of elements from an existing hierarchy in the model.
  • The counter integer specifies the number of elements to return.
  • The data point or tuple is optional, and describes the values used to determine the order for the list. If not supplied, the default measure or the query context will determine this value instead.
  • For details on how to employ and use this function see the semantic calculation overview.

This function is like the MDX TopCount function; it calculates the top list of elements from a specified list.

The TopCount function works by ordering the list from highest to lowest using the optional numeric data point (value) or default values. It then captures the first "n" elements as specified by the counter value and returns them as a list.

Examples

This example will take all the members in the Manufacturer attribute (listing), rank them from high to low based on August 2010 expenses, and then return the top 3 items as a list/set:

TopCount( {AllMembers([manufacturers].[manufacturer])}, 3, ([measures].[data Expenses], [data].[dateKey].[aug 2010]) )

Using the grid below, this will return Poomah, Slicenger, and Woolson: