apoc.agg.percentiles

Details

Syntax

apoc.agg.percentiles(value [, percentiles ])

Description

Returns the given percentiles over the range of numerical values in the given collection.

Arguments

Name

Type

Description

value

INTEGER | FLOAT

A value to be aggregated.

percentiles

LIST<FLOAT>

The percentiles from which the values are obtained. The default is: [0.5, 0.75, 0.9, 0.95, 0.99].

Returns

LIST<ANY>

Usage examples

The examples in this section are based on the following sample graph:

CREATE (TopGun:Movie {title:"Top Gun", released:1986, tagline:'I feel the need, the need for speed.'})
CREATE (SleeplessInSeattle:Movie {title:'Sleepless in Seattle', released:1993, tagline:'What if someone you never met, someone you never saw, someone you never knew was the only someone for you?'})
CREATE (ThatThingYouDo:Movie {title:'That Thing You Do', released:1996, tagline:'In every life there comes a time when that thing you dream becomes that thing you do'})
CREATE (TheDevilsAdvocate:Movie {title:"The Devil's Advocate", released:1997, tagline:'Evil has its winning ways'})
CREATE (AsGoodAsItGets:Movie {title:'As Good as It Gets', released:1997, tagline:'A comedy from the heart that goes for the throat.'})
CREATE (YouveGotMail:Movie {title:"You've Got Mail", released:1998, tagline:'At odds in life... in love on-line.'})
CREATE (TheMatrix:Movie {title:'The Matrix', released:1999, tagline:'Welcome to the Real World'})
CREATE (SnowFallingonCedars:Movie {title:'Snow Falling on Cedars', released:1999, tagline:'First loves last. Forever.'})
CREATE (JerryMaguire:Movie {title:'Jerry Maguire', released:2000, tagline:'The rest of his life begins now.'});
CREATE (TheMatrixReloaded:Movie {title:'The Matrix Reloaded', released:2003, tagline:'Free your mind'})

We can find the release year of movies for different percentiles, by running the query below:

apoc.agg.median
MATCH (movie:Movie)
RETURN apoc.agg.percentiles(movie.released, [0.25, 0.5, 0.75, 1.0]) AS percentiles;
Results
percentiles

[1996, 1997, 1999, 2003]