# Documentation/Calc Functions/PERCENTILE.INC

TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Donate

## Function name:

PERCENTILE.INC

## Category:

Statistical Analysis

## Summary:

Calculates the alpha-percentile of data values in an array of numbers. Percentiles can be used to understand the significance of particular values within a data set. The nth percentile of a data set is the value below which n% of the data set lies. This function uses an alpha argument lying in the range 0 to 1 (inclusive), which corresponds to a percentage in the range 0% to 100%. For example, an alpha of 0.5 gives the 50th percentile, also known as the median.

## Syntax:

PERCENTILE.INC(**Data**; **Alpha**)

## Returns:

Returns a real number which is the scale value for the specified data set and alpha.

## Arguments:

**Data** is an array or a reference to the range of cells that represents the array of data.

**Alpha** is a real number or a reference to the cell containing that number which represents the percentage of the scale between 0 and 1 (inclusive).

- If
**Alpha**is greater than 1 or less than 0 then the function returns an error value. - If
**Alpha**is not a multiple of 1/(n-1) then the function interpolates to obtain the value between two data points, where n is the total number of data points. For example, if we have a data set with five values, then alpha values of 0, 0.25, 0.5, 0.75, and 1 will pick out the values in the data set in ascending order.

## Additional details:

**Alpha**= 0.25 gives the first quartile,**Alpha**= 0.5 gives the median, and**Alpha**= 0.75 gives the third quartile.- For more details on percentiles, visit Wikipedia.

## Examples:

Formula | Description | Returns |
---|---|---|

=PERCENTILE.INC(A1:A5;0.4) where A1:A5 contains 5,7,3,2,9 | The function calculates the value in the data set, which equals 40% of the total data scale in A1:A5. Here interpolation occurs since Alpha is not a multiple of 1/(5-1) = 0.25. |
4.2 |

=PERCENTILE.INC(A1:A5;1) where A1:A5 contains 5,7,3,2,9 | The function calculates the value in the data set, which equals 100% of the total data scale in A1:A5. | 9 |

=PERCENTILE.INC({5;7;3;2;9};0.25) | The function calculates the value in the data set, which equals 25% of the total data scale. Here no interpolation occurs since Alpha is a multiple of 1/(5-1) = 0.25 and the function returns an exact value from the data set. |
3 |

=PERCENTILE.INC(A1:A5;1.1) where A1:A5 contains 5,7,3,2,9 | The function returns an error value since the Alpha is greater than 1. |
Err:502 |

## Related LibreOffice functions:

## ODF standard:

None

## Equivalent Excel functions:

PERCENTILE.INC