RANK.EQ DAX Function (Statistical)

Returns the rank of a number in a column of numbers. If more than one value has the same rank, the top rank of that set of values is returned.

Syntax

RANK.EQ ( <Value>, <ColumnName> [, <Order>] )
Parameter Attributes Description
Value

The value to be ranked.

ColumnName

A column in which the value will be ranked.

Order Optional

The order to be applied. 0/FALSE/DESC – descending; 1/TRUE/ASC – ascending. If omitted, the default is descending.

Return values

Scalar A single integer value.

A number indicating the rank of Value among the numbers in ColumnName.

Remarks

The following RANK.EQ calls:

RANK.EQ ( <value>, table[column] )

RANK.EQ ( <value>, table[column], <order> )

correspond to the following RANKX calls:

RANKX (
    VALUES ( table[column] ),
    table[column],
    <value>
)

RANKX (
    VALUES ( table[column] ),
    table[column],
    <value>,
    <order>
)

The <value> placeholder is a DAX expression executed in the filter context where RANK.EQ is evaluated.
The <order> placeholder is the optional order argument, which is descending by default.

» 1 related function

Examples

--  RANK.EQ find the ranking of a value in the column 
--  passed as second argument. The column values are sorted
--  according to the third argument (default DESC).
DEFINE
    TABLE SampleData1 = { 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 }
    TABLE SampleData2 = { 20, 40, 60, 80, 100, 10, 30, 50, 70, 90 }
EVALUATE
{
    ( "RANK.EQ ASC 1", RANK.EQ ( 70, SampleData1[Value], ASC ) ),
    ( "RANK.EQ ASC 2", RANK.EQ ( 70, SampleData2[Value], ASC ) ),
    ( "RANK.EQ DESC 1", RANK.EQ ( 70, SampleData1[Value], DESC ) ),
    ( "RANK.EQ DESC 2", RANK.EQ ( 70, SampleData2[Value], DESC ) ),
    ( "RANK.EQ 1", RANK.EQ ( 70, SampleData1[Value] ) ),
    ( "RANK.EQ 2", RANK.EQ ( 70, SampleData2[Value] ) )
}
Value1 Value2
2001-01-01 7
2001-02-01 7
2001-01-01 4
2001-02-01 4
2001-01-01 4
2001-02-01 4
--  RANKX can be used instead of RANK.EQ, iterating
--  the table containing the column to analyze 
--  for the ranking
DEFINE
    TABLE SampleData = { 20, 40, 60, 80, 100, 10, 30, 50, 70, 90 }
EVALUATE
{
    ( "RANK.EQ", RANK.EQ ( 70, SampleData[Value] ) ),
    ( "RANKX", RANKX ( SampleData, SampleData[Value], 70 ) ),
    ( "RANK.EQ ASC", RANK.EQ ( 70, SampleData[Value], ASC ) ),
    ( "RANKX ASC", RANKX ( SampleData, SampleData[Value], 70, ASC ) )
}
Value1 Value2
RANK.EQ 4
RANKX 4
RANK.EQ ASC 7
RANKX ASC 7
--  RANK.EQ keeps duplicated value in the sorted column
--  to evaluate the ranking. The ranking obtained skips
--  the rank number in case of ties (SKIP argument of RANKX).
DEFINE
    TABLE SampleData = { "C", "B", "B", "A", "F", "D", "B" }
    -- Sorted: A, B, B, B, C, D, F
EVALUATE
{
    ( "RANK.EQ ASC", RANK.EQ ( "A", SampleData[Value], ASC ) ),
    ( "RANK.EQ ASC", RANK.EQ ( "B", SampleData[Value], ASC ) ),
    ( "RANK.EQ ASC", RANK.EQ ( "C", SampleData[Value], ASC ) ),
    ( "RANKX ASC", RANKX ( SampleData, SampleData[Value], "C", ASC, SKIP ) ),
    ( "RANK.EQ", RANK.EQ ( "A", SampleData[Value] ) ),
    ( "RANK.EQ", RANK.EQ ( "B", SampleData[Value] ) ),
    ( "RANK.EQ", RANK.EQ ( "C", SampleData[Value] ) ),
    ( "RANKX", RANKX ( SampleData, SampleData[Value], "C" ) )
}

Value1 Value2
RANK.EQ ASC 1
RANK.EQ ASC 2
RANK.EQ ASC 5
RANKX ASC 5
RANK.EQ 7
RANK.EQ 4
RANK.EQ 3
RANKX 3

Related functions

Other related functions are:

Last update: May 12, 2021   » Contribute   » Show contributors

Contributors: Alberto Ferrari, Marco Russo, Kenneth Barber

Microsoft documentation: https://docs.microsoft.com/en-us/dax/rank-eq-function-dax

2018-2021 © SQLBI. All rights are reserved. Information coming from Microsoft documentation is property of Microsoft Corp. » Contact us   » Privacy Policy & Cookies

Context Transition

This function performs a Context Transition if called in a Row Context. Click to read more.

Row Context

This expression is executed in a Row Context. Click to read more.

Iterator

Not recommended

The use of this function is not recommended. See Remarks and Related functions for alternatives.

Not recommended

The use of this parameter is not recommended.

Deprecated

This function is deprecated. Jump to the Alternatives section to see the function to use.

Deprecated

This parameter is deprecated and its use is not recommended.

DirectQuery compatibility

Limitations are placed on DAX expressions allowed in measures and calculated columns.
The state below shows the DirectQuery compatibility of the DAX function.

Contribute

Want to improve the content of RANK.EQ? Did you find any issue?
Please, report it us! All submissions will be evaluated for possible updates of the content.


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.