pandas.Series.nsmallest

Series.nsmallest(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.nlargest

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

Series.sort_values

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

Series.head

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

Примечания

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

Примеры

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

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

>>> s.nsmallest()
Montserrat    5200
Nauru        11300
Tuvalu       11300
Anguilla     11300
Iceland     337000
dtype: int64

Наименьшие n элементы, где n=3. Значение по умолчанию для keep - ‘first’, поэтому будут сохранены Nauru и Tuvalu.

>>> s.nsmallest(3)
Montserrat   5200
Nauru       11300
Tuvalu      11300
dtype: int64

Наименьшие n элементы, где n=3 и сохраняются последние дубликаты. Anguilla и Tuvalu будут сохранены, так как они последние с значением 11300 в порядке индексов.

>>> s.nsmallest(3, keep='last')
Montserrat   5200
Anguilla    11300
Tuvalu      11300
dtype: int64

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

>>> s.nsmallest(3, keep='all')
Montserrat   5200
Nauru       11300
Tuvalu      11300
Anguilla    11300
dtype: int64