pandas.Series.rename_axis#
- Series.rename_axis(mapper=<no_default>, *, index=<no_default>, axis=0, copy=<no_default>, inplace=False)[source]#
Set the name of the axis for the index.
- Parameters:
- mapperscalar, list-like, optional
Value to set the axis name attribute.
Use either
mapperandaxisto specify the axis to target withmapper, orindex.- indexscalar, list-like, dict-like or function, optional
A scalar, list-like, dict-like or functions transformations to apply to that axis’ values.
- axis{0 or ‘index’}, default 0
The axis to rename. For Series this parameter is unused and defaults to 0.
- copybool, default False
This keyword is now ignored; changing its value will have no impact on the method.
Deprecated since version 3.0.0: This keyword is ignored and will be removed in pandas 4.0. Since pandas 3.0, this method always returns a new object using a lazy copy mechanism that defers copies until necessary (Copy-on-Write). See the user guide on Copy-on-Write for more details.
- inplacebool, default False
Modifies the object directly, instead of creating a new Series or DataFrame.
- Returns:
- Series, or None
The same type as the caller or None if
inplace=True.
See also
Series.renameAlter Series index labels or name.
DataFrame.renameAlter DataFrame index labels or name.
Index.renameSet new names on index.
Examples
>>> s = pd.Series(["dog", "cat", "monkey"]) >>> s 0 dog 1 cat 2 monkey dtype: object >>> s.rename_axis("animal") animal 0 dog 1 cat 2 monkey dtype: object