當前位置: 首頁>>編程示例 >>用法及示例精選 >>正文

Python pandas.DataFrame.rename用法及代碼示例

用法:

DataFrame.rename(mapper=None, *, index=None, columns=None, axis=None, copy=True, inplace=False, level=None, errors='ignore')

更改軸標簽。

函數/字典值必須是唯一的(一對一)。字典/係列中未包含的標簽將保留 as-is。列出的額外標簽不會引發錯誤。

有關更多信息，請參閱用戶指南。

參數：

mapper：dict-like 或函數

Dict-like 或函數轉換以應用於該軸的值。使用 mapper 和 axis 指定要使用 mapper 或 index 和 columns 定位的軸。

index：dict-like 或函數

替代指定軸(mapper, axis=0 等效於 index=mapper)。

columns：dict-like 或函數

替代指定軸(mapper, axis=1 等效於 columns=mapper)。

axis：{0 或 ‘index’，1 或 ‘columns’}，默認 0

使用 mapper 定位的軸。可以是軸名稱 (‘index’, ‘columns’) 或編號 (0, 1)。默認值為‘index’。

copy：布爾值，默認為真

同時複製基礎數據。

inplace：布爾值，默認為 False

是否返回一個新的 DataFrame。如果為 True，則忽略副本的值。

level：int 或級別名稱，默認無

在 MultiIndex 的情況下，僅重命名指定級別的標簽。

errors：{‘ignore’, ‘raise’}，默認 ‘ignore’

如果 ‘raise’，當 dict-like mapper , index 或 columns 包含正在轉換的索引中不存在的標簽時，引發 KeyError。如果‘ignore’，現有的鍵將被重命名，額外的鍵將被忽略。

返回：

DataFrame 或無

帶有重命名軸標簽的 DataFrame 或 None 如果 inplace=True 。

拋出：

KeyError

如果在所選軸和“errors=’raise’” 中未找到任何標簽。

例子：

DataFrame.rename 支持兩種調用約定

  • (index=index_mapper, columns=columns_mapper, ...)

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

我們強烈建議使用關鍵字參數來闡明您的意圖。

使用映射重命名列：

>>> df = pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
>>> df.rename(columns={"A": "a", "B": "c"})
   a  c
0  1  4
1  2  5
2  3  6

使用映射重命名索引：

>>> df.rename(index={0: "x", 1: "y", 2: "z"})
   A  B
x  1  4
y  2  5
z  3  6

將索引標簽轉換為不同的類型：

>>> df.index
RangeIndex(start=0, stop=3, step=1)
>>> df.rename(index=str).index
Index(['0', '1', '2'], dtype='object')
>>> df.rename(columns={"A": "a", "B": "b", "C": "c"}, errors="raise")
Traceback (most recent call last):
KeyError: ['C'] not found in axis

使用 axis-style 參數：

>>> 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

相關用法


注：本文由純淨天空篩選整理自pandas.pydata.org大神的英文原創作品 pandas.DataFrame.rename。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。