Python dask.dataframe.DataFrame.rename用法及代碼示例

用法: DataFrame.rename(index=None, columns=None)

更改軸標簽。

此文檔字符串是從 pandas.core.frame.DataFrame.rename 複製而來的。

可能存在與 Dask 版本的一些不一致之處。

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

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

mapper：dict-like 或函數(Dask 不支持): Dict-like 或函數轉換以應用於該軸的值。使用 mapper 和 axis 指定要使用 mapper 或 index 和 columns 定位的軸。
index：dict-like 或函數(Dask 不支持): 替代指定軸(mapper, axis=0 等效於 index=mapper)。
columns：dict-like 或函數: 替代指定軸(mapper, axis=1 等效於 columns=mapper)。
axis：{0 或 ‘index’，1 或 ‘columns’}，默認 0(Dask 中不支持): 使用 mapper 定位的軸。可以是軸名稱 (‘index’, ‘columns’) 或編號 (0, 1)。默認值為‘index’。
copy：bool，默認 True(Dask 中不支持): 同時複製基礎數據。
inplace：bool，默認 False(在 Dask 中不支持): 是否返回一個新的 DataFrame。如果為 True，則忽略副本的值。
level：int 或級別名稱，默認無(Dask 中不支持): 在 MultiIndex 的情況下，僅重命名指定級別的標簽。
errors：{‘ignore’, ‘raise’}，默認 ‘ignore’(Dask 不支持): 如果 ‘raise’，當 dict-like mapper , index 或 columns 包含正在轉換的索引中不存在的標簽時，引發 KeyError。如果‘ignore’，現有的鍵將被重命名，額外的鍵將被忽略。

DataFrame.rename 支持兩種調用約定

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

使用映射重命名列：

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

相關用法

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