.. highlightlang:: us

.. index:: quantile
.. index:: median

.. _quantile:

quantile
========

.. us.tag  quantile ENGLISH New5507  math-base

:ref:`quantile` returns quantile of a data vector *rvX* for the cumulative 
probability *rvP* in the interval 0 to 1. For *rvP* = 0.5 the median is returned.
For *rvP* = 1 the maximum is returned.

.. function::  rvY = quantile(rvX, rvP)
               rvY = quantile(rvX, rvP, bInterpol)

.. us.return

**Returnwert**

**Return Value**

*rvY* is a vector with quantile values having the same length as *rvP*. 
The function uses linear interpolation if bInterpol is TRUE (1).

.. us.params

**Parameter**

**Parameters**

.. uparam:: rvX

   *rvX* is a real vector.

.. uparam:: rvP

   *rvP* is a real vector in the range 0 to 1. 

.. uparam:: bInterpol

   If *bInterpol* is TRUE (1) the function uses linear interpolation. Default
   value is FALSE (0).

.. us.example

**Beispiel**

**Example**

::

   * quantile([5,12,7,24,19,9], 0.5)
     12.0000

   * quantile([5,12,7,24,19,9], 0.5, TRUE)
     10.5000

.. seealso::
   :ref:`uberblick-mathematik`,
   :ref:`sum`,
   :ref:`mean`,
   :ref:`cov`,
   :ref:`corrcoef`,
   :ref:`quantile`

:sub:`id-707342`