tf.contrib.distributions.percentile
Вычислить q-й перцентиль x.
tf.contrib.distributions.percentile(
x, q, axis=None, interpolation=None, keep_dims=False, validate_args=False,
name=None
)
Учитывая вектор x, q-й перцентиль x — это значение, находящееся на q / 100 пути от минимума до максимума в отсортированной копии x.
Значения и расстояния двух ближайших соседей, а также параметр interpolation определят перцентиль, если нормированный ранг не соответствует точно местоположению q.
Эта функция эквивалентна медиане, если q = 50, минимуму, если q = 0, и максимуму, если q = 100.
# Get 30th percentile with default ('nearest') interpolation.
x = [1., 2., 3., 4.]
percentile(x, q=30.)
==> 2.0
# Get 30th percentile with 'lower' interpolation
x = [1., 2., 3., 4.]
percentile(x, q=30., interpolation='lower')
==> 1.0
# Get 100th percentile (maximum). By default, this is computed over every dim
x = [[1., 2.]
[3., 4.]]
percentile(x, q=100.)
==> 4.0
# Treat the leading dim as indexing samples, and find the 100th quantile (max)
# over all such samples.
x = [[1., 2.]
[3., 4.]]
percentile(x, q=100., axis=[0])
==> [3., 4.]
Сравните с numpy.percentile.
| Аргументы | |
|---|---|
x | Числовое значение с плавающей запятой N-D Tensor с N > 0. Если axis не None, x должен иметь статически известное количество измерений. |
q | Скалярное Tensor в [0, 100]. Перцентиль. |
axis | Необязательный 0-D или 1-D целочисленный Tensor со значениями константы. Ось, содержащая независимые выборки, для которой требуется перцентиль. Если None (по умолчанию), все измерения обрабатываются как измерения выборки, возвращая скаляр. |
interpolation | {"нижний", "верхний", "ближайший"}. По умолчанию: "ближайший". Этот необязательный параметр задаёт метод интерполяции, который используется, когда искомый квантиль находится между двумя точками данных i < j:
|
keep_dims | Python bool. Если True, последнее измерение сохраняется с размером 1. Если False, последнее измерение удаляется из формы вывода. |
validate_args | Нужно ли добавлять проверки на корректность аргументов во время выполнения? Если False, а аргументы некорректны, гарантий правильного поведения нет. |
name | Имя строки Python для обозначения этого Op. По умолчанию "percentile" |
| Возвращает | |
|---|---|
(N - len(axis))-мерный Tensor того же типа данных, что и x, или, если axis есть None, скаляр. |
| Возбуждает | |
|---|---|
ValueError | Если тип аргумента 'interpolation' не допустимый. |
© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/contrib/distributions/percentile