Spec-Zone.ru › pandas 0.21

pandas.Panel.rename

Panel.rename(items=None, major_axis=None, minor_axis=None, **kwargs) [source]

Изменить входные функции осей или функции. Значения функции/словаря должны быть уникальными (1 к 1). Метки, не содержащиеся в словаре/ряду, останутся неизменными. Дополнительные перечисленные метки не приводят к ошибке. В качестве альтернативы можно изменить Series.name на скалярное значение (только для Series).

Параметры:

items, major_axis, minor_axis : скаляр, список, словарь или функция, необязательно

Скаляр или список изменят атрибут Series.name, и вызовут ошибку при использовании DataFrame или Panel. Словарь или функция являются преобразованиями, применяемыми к значениям этой оси.

copy : boolean, по умолчанию True

Также скопировать данные из базового уровня.

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

Возвращать ли новый Panel. Если True, то значение copy игнорируется.

level : int или имя уровня, по умолчанию None

В случае MultiIndex, переименовать только метки указанного уровня.

Возвращает:

renamed : Panel (новый объект)

См. также

pandas.NDFrame.rename_axis

Примеры

>>> s = pd.Series([1, 2, 3])
>>> s
0    1
1    2
2    3
dtype: int64
>>> s.rename("my_name") # scalar, changes Series.name
0    1
1    2
2    3
Name: my_name, dtype: int64
>>> s.rename(lambda x: x ** 2)  # function, changes labels
0    1
1    2
4    3
dtype: int64
>>> s.rename({1: 3, 2: 5})  # mapping, changes labels
0    1
3    2
5    3
dtype: int64

Поскольку у DataFrame нет атрибута .name, допускаются только аргументы типа сопоставления.

>>> df = pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
>>> df.rename(2)
Traceback (most recent call last):
...
TypeError: 'int' object is not callable

DataFrame.rename поддерживает две соглашения вызова

  • (index=index_mapper, columns=columns_mapper, ...)
  • (mapper, axis={'index', 'columns'}, ...)

Мы настоятельно рекомендуем использовать ключевые аргументы для уточнения ваших намерений.

>>> df.rename(index=str, columns={"A": "a", "B": "c"})
   a  c
0  1  4
1  2  5
2  3  6
>>> df.rename(index=str, columns={"A": "a", "C": "c"})
   a  B
0  1  4
1  2  5
2  3  6

Использование параметров типа оси

>>> df.rename(str.lower, axis='columns')
   a  b
0  1  4
1  2  5
2  3  6
>>> df.rename({1: 2, 2: 4}, axis='index')
   A  B
0  1  4
2  2  5
4  3  6

Дополнительные сведения см. в руководстве пользователя.

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.21.1/generated/pandas.Panel.rename.html

Spec-Zone.ru

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