Ranks, Ties, and Percentile Rank

Install and import#

bash

npm install fintech-algorithms

import { ranksTiesAndPercentileRank } from "fintech-algorithms/financial-mathematics-statistics-and-data-foundations/location-ranking-and-exploratory-summaries/ranks-ties-and-percentile-rank";

Signature#

ranksTiesAndPercentileRank(input)

Worked example#

verified This is the worked example published in the article, replayed by the test suite on every run. The output cannot drift.

Input#

input

{
  "values": [1, 2, 2, 4, 9],
  "weights": [1, 1, 2, 1, 1],
  "trimProportion": 0.2,
  "bins": 4
}

Call#

ranksTiesAndPercentileRank(input)

Returns#

object with 2 fields: ranks, percentileRanks

{
  "ranks": [1, 2.5, 2.5, 4, 5],
  "percentileRanks": [0, 37.5, 37.5, 75, 100]
}

Diagrams#

How it works#

This page states the contract — how to call it correctly. The article explains the concept: why it works, and where it breaks.

Read the article →

References#

rankdata
Historical-example decision