Spec-Zone.ru › TensorFlow 1.15

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:
  • нижний: i.
  • верхний: j.
  • ближайший: 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API