Description
For relevant true return 1/rank and 1/(rank × queryCount); otherwise return zero for both.
Search metrics and positional checks depend on rank origins, token positions, relevance definitions, and tie or gap conventions. One term is not a complete query or retrieval evaluation.
For relevant true return 1/rank and 1/(rank × queryCount); otherwise return zero for both.
When to use this tool
Use Search Result Reciprocal Rank Term when you need one rank contribution or token-position diagnostic.
How to use the tool and how it works
- Enter rank, queryCount, relevant. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read reciprocalRank, meanContribution. Use the output convention below.
For relevant true return 1/rank and 1/(rank × queryCount); otherwise return zero for both. Rank and queryCount are positive integers.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| rank | One-based rank position. | Required. Safe integer; minimum 1. |
| queryCount | Positive number of queries used as the mean denominator. | Required. Safe integer; minimum 1. |
| relevant | Relevant | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| reciprocalRank | Reciprocal Rank | Required. Finite number. |
| meanContribution | Mean Contribution | Required. Finite number. |
{
"input": {
"rank": 4,
"queryCount": 10,
"relevant": true
},
"output": {
"reciprocalRank": 0.25,
"meanContribution": 0.025
}
}Limitations and assumptions
- For mean reciprocal rank, rank must describe the first relevant result for its query; the tool does not find that result or aggregate queries.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Evaluate complete queries and result sets under a documented tokenization, relevance, and aggregation policy.
References
Similar or alternative tools
- Information Retrieval Dcg One Rank Term
Use relevance or 2^relevance - 1 for gain according to exponentialGain.
- Query Phrase Slop One Gap
Subtract firstPosition from secondPosition for observedGap, then compare its absolute difference from expectedGap inclusively with allowedSlop.