Products

Products

Tools

Get Redis

Resources

Connect

Learn

Latest

See how it works

Visit Demo Center

Login Book a meeting Try Redis

TDIGEST.CDF

Syntax

TDIGEST.CDF key value [value ...]

Available in:: Redis Open Source / Bloom 2.4.0
Time complexity:: O(N) where N is the number of values specified.
ACL categories:: @tdigest, @read,
Compatibility:: Redis Enterprise and Redis Cloud compatibility

Returns, for each input value, an estimation of the floating-point fraction of (observations smaller than the given value + half the observations equal to the given value). Multiple fractions can be retrieved in a single call.

Required arguments

key

is the key name for an existing t-digest sketch.

value

are the values for which the CDF (Cumulative Distribution Function) should be retrieved.

Examples

redis> TDIGEST.CREATE t COMPRESSION 1000
OK
redis> TDIGEST.ADD t 1 2 2 3 3 3 4 4 4 4 5 5 5 5 5
OK
redis> TDIGEST.CDF t 0 1 2 3 4 5 6
1) "0"
2) "0.033333333333333333"
3) "0.13333333333333333"
4) "0.29999999999999999"
5) "0.53333333333333333"
6) "0.83333333333333337"
7) "1"

Redis Enterprise and Redis Cloud compatibility

Redis Enterprise	Redis Cloud	Notes
✅ Supported	✅ Flexible & Annual ✅ Free & Fixed

Return information

RESP2 RESP3

One of the following:

Array of bulk string replies as floating-points, populated with fraction_1, fraction_2, ..., fraction_N. All values are nan if the given sketch is empty.
Simple error reply in these cases: the given key does not exist or is of an incorrect type, value parsing errors, or an incorrect number of arguments.