pandas.Series.nlargest

Series.nlargest(n=5, keep='first')[source]

Возвращает самые большие n элементов.

Параметры:

n:int, по умолчанию 5

Возвращает столько же значений, отсортированных по убыванию.

keep:{‘first’, ‘last’, ‘all’}, по умолчанию ‘first’

Когда есть дублирующие значения, которые не могут все поместиться в Series из n элементов:

• first : возвращает первые n вхождений в порядке их появления.

• last : возвращает последние n вхождений в обратном порядке их появления.

• all : сохраняет все вхождения. Это может привести к Series размером больше, чем n.

Возвращает:

Series

Самые большие n значений в Series, отсортированные в порядке убывания.

См. также

Series.nsmallest

Получить n наименьших элементов.

Series.sort_values

Сортировать Series по значениям.

Series.head

Возвратить первые n строк.

Примечания

Быстрее, чем .sort_values(ascending=False).head(n) для небольших n по отношению к размеру объекта Series.

Примеры

>>> countries_population = {"Italy": 59000000, "France": 65000000,
...                         "Malta": 434000, "Maldives": 434000,
...                         "Brunei": 434000, "Iceland": 337000,
...                         "Nauru": 11300, "Tuvalu": 11300,
...                         "Anguilla": 11300, "Montserrat": 5200}
>>> s = pd.Series(countries_population)
>>> s
Italy       59000000
France      65000000
Malta         434000
Maldives      434000
Brunei        434000
Iceland       337000
Nauru          11300
Tuvalu         11300
Anguilla       11300
Montserrat      5200
dtype: int64

Самые большие n элементов, где n=5 по умолчанию.

>>> s.nlargest()
France      65000000
Italy       59000000
Malta         434000
Maldives      434000
Brunei        434000
dtype: int64

Самые большие n элементов, где n=3. Значение keep по умолчанию — ‘first’, поэтому Мальта будет сохранена.

>>> s.nlargest(3)
France    65000000
Italy     59000000
Malta       434000
dtype: int64

Самые большие n элементов, где n=3 и сохраняя последние дубликаты. Бруней будет сохранён, поскольку это последний с значением 434000, в порядке индексов.

>>> s.nlargest(3, keep='last')
France      65000000
Italy       59000000
Brunei        434000
dtype: int64

Самые большие n элементов, где n=3 и сохраняя все дубликаты. Обратите внимание, что возвращаемая Series имеет пять элементов из-за трёх дубликатов.

>>> s.nlargest(3, keep='all')
France      65000000
Italy       59000000
Malta         434000
Maldives      434000
Brunei        434000
dtype: int64