pandas.Series.rename_axis — pandas 3.0.0rc0+33.g1fd184de2a documentation (original) (raw)

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 mapper and axis to specify the axis to target with mapper, or index.

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

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