Merge pull request pandas-dev#6500 from toobaz/level_name

DOC: Clarify that methods taking a MultiIndex level index also accept the name

Author: jreback

pandas/core/frame.py

@@ -3850,7 +3850,7 @@ def count(self, axis=0, level=None, numeric_only=False):
         ----------
         axis : {0, 1}
             0 for row-wise, 1 for column-wise
-        level : int, default None
+        level : int or level name, default None
             If the axis is a MultiIndex (hierarchical), count along a
             particular level, collapsing into a DataFrame
         numeric_only : boolean, default False
@@ -3926,7 +3926,7 @@ def any(self, axis=None, bool_only=None, skipna=True, level=None,
         skipna : boolean, default True
             Exclude NA/null values. If an entire row/column is NA, the result
             will be NA
-        level : int, default None
+        level : int or level name, default None
             If the axis is a MultiIndex (hierarchical), count along a
             particular level, collapsing into a DataFrame
         bool_only : boolean, default None
@@ -3957,7 +3957,7 @@ def all(self, axis=None, bool_only=None, skipna=True, level=None,
         skipna : boolean, default True
             Exclude NA/null values. If an entire row/column is NA, the result
             will be NA
-        level : int, default None
+        level : int or level name, default None
             If the axis is a MultiIndex (hierarchical), count along a
             particular level, collapsing into a DataFrame
         bool_only : boolean, default None

pandas/core/generic.py

@@ -1399,7 +1399,7 @@ def drop(self, labels, axis=0, level=None, inplace=False, **kwargs):
         ----------
         labels : single label or list-like
         axis : int or axis name
-        level : int or name, default None
+        level : int or level name, default None
             For MultiIndex
         inplace : bool, default False
             If True, do operation inplace and return None.
@@ -2869,7 +2869,7 @@ def align(self, other, join='outer', axis=None, level=None, copy=True,
         join : {'outer', 'inner', 'left', 'right'}, default 'outer'
         axis : allowed axis of the other object, default None
             Align on index (0), columns (1), or both (None)
-        level : int or name
+        level : int or level name, default None
             Broadcast across a level, matching Index values on the
             passed MultiIndex level
         copy : boolean, default True
@@ -3454,7 +3454,7 @@ def _add_numeric_operations(cls):
 skipna : boolean, default True
     Exclude NA/null values. If an entire row/column is NA, the result
     will be NA
-level : int, default None
+level : int or level name, default None
         If the axis is a MultiIndex (hierarchical), count along a
         particular level, collapsing into a """ + name + """
 numeric_only : boolean, default None

pandas/core/index.py

@@ -1334,7 +1334,7 @@ def join(self, other, how='left', level=None, return_indexers=False):
         ----------
         other : Index
         how : {'left', 'right', 'inner', 'outer'}
-        level :
+        level : int or level name, default None
         return_indexers : boolean, default False
 
         Returns
@@ -2463,7 +2463,7 @@ def get_level_values(self, level):
 
         Parameters
         ----------
-        level : int
+        level : int or level name
 
         Returns
         -------
@@ -2846,7 +2846,7 @@ def drop(self, labels, level=None):
         ----------
         labels : array-like
             Must be a list of tuples
-        level : int or name, default None
+        level : int or level name, default None
 
         Returns
         -------
@@ -3242,6 +3242,7 @@ def get_loc_level(self, key, level=0, drop_level=True):
         Parameters
         ----------
         key : label or tuple
+        level : int/level name or list thereof
 
         Returns
         -------

pandas/core/series.py

@@ -1064,7 +1064,7 @@ def count(self, level=None):
 
         Parameters
         ----------
-        level : int, default None
+        level : int or level name, default None
             If the axis is a MultiIndex (hierarchical), count along a
             particular level, collapsing into a smaller Series
 
@@ -1512,7 +1512,7 @@ def _binop(self, other, func, level=None, fill_value=None):
         fill_value : float or object
             Value to substitute for NA/null values. If both Series are NA in a
             location, the result will be NA regardless of the passed fill value
-        level : int or name
+        level : int or level name, default None
             Broadcast across a level, matching Index values on the
             passed MultiIndex level
 
@@ -1802,7 +1802,7 @@ def sortlevel(self, level=0, ascending=True):
 
         Parameters
         ----------
-        level : int
+        level : int or level name, default None
         ascending : bool, default True
 
         Returns