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

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


用法:

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

更改列和索引標簽。

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

DataFrame.rename 支持兩種調用約定：
  • (index=index_mapper, columns=columns_mapper, ...)
  • (mapper, axis={0/'index' or 1/'column'}, ...)

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

參數：

mapper：dict-like 或函數，默認無

可選的 dict-like 或函數轉換以應用於索引/列值，具體取決於所選的 axis 。

index：dict-like，默認無

可選的 dict-like 轉換應用於索引軸的值。尚不支持軸 0 的函數。

columns：dict-like 或函數，默認無

可選 dict-like 或函數轉換以應用於列軸的值。

axis：整數，默認 0

使用映射器重命名的軸。 0 或 ‘index’ 用於索引 1 或 ‘columns’ 用於列

copy：布爾值，默認 True

同時複製基礎數據

inplace：布爾值，默認為 False

返回新的 DataFrame 。如果為 True，則分配不複製的列

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

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

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

Only ‘ignore’ supported 控製在提供的 dtype 的無效數據上引發異常。

  • raise : 允許引發異常
  • ignore：抑製異常。出錯時返回原始對象。
  • warn ：將最後的異常打印為警告並返回原始對象。

返回：

DataFrame

注意：

與 Pandas 的區別：
  • 不支持：水平

重命名不會覆蓋列名。如果傳遞了包含重複項的列表，則列名將帶有數字後綴。

例子：

>>> import cudf
>>> df = cudf.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
>>> df
   A  B
0  1  4
1  2  5
2  3  6

使用映射重命名列：

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

使用映射重命名索引：

>>> df.rename(index={0: 10, 1: 20, 2: 30})
    A  B
10  1  4
20  2  5
30  3  6

相關用法


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