pandas.Series.drop#

Series.drop(labels=None, *, axis=0, index=None, columns=None, level=None, inplace=False, errors='raise')[source]#

Return Series with specified index labels removed.

Remove elements of a Series based on specifying the index labels. When using a multi-index, labels on different levels can be removed by specifying the level.

Parameters:

labelssingle label or list-like: Index labels to drop.
axis{0 or ‘index’}: Unused. Parameter needed for compatibility with DataFrame.
indexsingle label or list-like: Redundant for application on Series, but ‘index’ can be used instead of ‘labels’.
columnssingle label or list-like: No change is made to the Series; use ‘index’ or ‘labels’ instead.
levelint or level name, optional: For MultiIndex, level for which the labels will be removed.
inplacebool, default False: If True, do operation inplace and return None.
errors{‘ignore’, ‘raise’}, default ‘raise’: If ‘ignore’, suppress error and only existing labels are dropped.

Returns:

Series or None: Series with specified index labels removed or None if inplace=True.

Raises:

KeyError: If none of the labels are found in the index.

See also

Series.reindex: Return only specified index labels of Series.
Series.dropna: Return series without null values.
Series.drop_duplicates: Return Series with duplicate values removed.
DataFrame.drop: Drop specified labels from rows or columns.

Examples

>>> s = pd.Series(data=np.arange(3), index=["A", "B", "C"])
>>> s
A  0
B  1
C  2
dtype: int64

Drop labels B and C

>>> s.drop(labels=["B", "C"])
A  0
dtype: int64

Drop 2nd level label in MultiIndex Series

>>> midx = pd.MultiIndex(
...     levels=[["llama", "cow", "falcon"], ["speed", "weight", "length"]],
...     codes=[[0, 0, 0, 1, 1, 1, 2, 2, 2], [0, 1, 2, 0, 1, 2, 0, 1, 2]],
... )
>>> s = pd.Series([45, 200, 1.2, 30, 250, 1.5, 320, 1, 0.3], index=midx)
>>> s
llama   speed      45.0
        weight    200.0
        length      1.2
cow     speed      30.0
        weight    250.0
        length      1.5
falcon  speed     320.0
        weight      1.0
        length      0.3
dtype: float64

>>> s.drop(labels="weight", level=1)
llama   speed      45.0
        length      1.2
cow     speed      30.0
        length      1.5
falcon  speed     320.0
        length      0.3
dtype: float64