pandas.DataFrame.sort_index

DataFrame.sort_index(axis=0, level=None, ascending=True, inplace=False, kind='quicksort', na_position='last', sort_remaining=True, ignore_index=False, key=None)[source]

Сортировка объекта по меткам (по оси).

Возвращает новую DataFrame, отсортированную по меткам, если аргумент inplace равен False, иначе обновляет исходную DataFrame и возвращает None.

Parameters

axis:{0 или ‘index’, 1 или ‘columns’}, по умолчанию 0

Ось, по которой выполняется сортировка. Значение 0 соответствует строкам, а 1 — столбцам.

level:int или имя уровня или список целых чисел или список имён уровней

Если не равно None, сортировка по значениям на указанном уровне индекса.

ascending:bool или список bool, по умолчанию True

Сортировка по возрастанию или убыванию. Если индекс является MultiIndex, направление сортировки можно контролировать для каждого уровня индивидуально.

inplace:bool, по умолчанию False

Изменить DataFrame вместо создания нового.

kind:{‘quicksort’, ‘mergesort’, ‘heapsort’, ‘stable’}, по умолчанию ‘quicksort’

Выбор алгоритма сортировки. См. также numpy.sort() для получения дополнительной информации. mergesort и stable — единственные стабильные алгоритмы. Для DataFrames этот параметр применяется только при сортировке по одному столбцу или метке.

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

Размещает значения NaN в начале, если first; last размещает значения NaN в конце. Не реализовано для MultiIndex.

sort_remaining:bool, по умолчанию True

Если True и сортировка по уровню, а индекс многоуровневый, сортирует по другим уровням тоже (в порядке) после сортировки по указанному уровню.

ignore_index:bool, по умолчанию False

Если True, результирующая ось будет иметь метки 0, 1, ..., n-1.

Добавлена в версии 1.0.0.

key:callable, необязательно

Если не None, применяет функцию к значениям индекса перед сортировкой. Аналогично аргументу key в встроенной функции sorted(), с существенным отличием, что эта функция key должна быть векторизованной. Она должна ожидать Index и возвращать Index той же формы. Для входных данных MultiIndex функция key применяется к каждому уровню.

Добавлена в версии 1.1.0.

Returns

DataFrame или None

Исходная DataFrame, отсортированная по меткам, или None, если inplace=True.

См. также

Series.sort_index

Сортировка Series по индексу.

DataFrame.sort_values

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

Series.sort_values

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

Примеры

>>> df = pd.DataFrame([1, 2, 3, 4, 5], index=[100, 29, 234, 1, 150],
...                   columns=['A'])
>>> df.sort_index()
     A
1    4
29   2
100  1
150  5
234  3

По умолчанию сортировка по возрастанию. Чтобы отсортировать по убыванию, используйте ascending=False

>>> df.sort_index(ascending=False)
     A
234  3
150  5
100  1
29   2
1    4

Можно указать функцию-ключ, которая применяется к индексу перед сортировкой. Для MultiIndex это применяется к каждому уровню по отдельности.

>>> df = pd.DataFrame({"a": [1, 2, 3, 4]}, index=['A', 'b', 'C', 'd'])
>>> df.sort_index(key=lambda x: x.str.lower())
   a
A  1
b  2
C  3
d  4