@@ -1283,12 +1283,12 @@ def set_names(self, names, level=None, inplace=False):
12831283 Parameters
12841284 ----------
12851285 names : str or sequence
1286- name (s) to set
1286+ Name (s) to set.
12871287 level : int, level name, or sequence of int/level names (default None)
12881288 If the index is a MultiIndex (hierarchical), level(s) to set (None
1289- for all levels). Otherwise level must be None
1289+ for all levels). Otherwise level must be None.
12901290 inplace : bool
1291- if True, mutates in place
1291+ If True, mutates in place.
12921292
12931293 Returns
12941294 -------
@@ -1302,16 +1302,16 @@ def set_names(self, names, level=None, inplace=False):
13021302 Int64Index([1, 2, 3, 4], dtype='int64', name='foo')
13031303
13041304 >>> idx = pd.MultiIndex.from_tuples([(1, u'one'), (1, u'two'),
1305- (2, u'one'), (2, u'two')],
1306- names=['foo', 'bar'])
1305+ ... (2, u'one'), (2, u'two')],
1306+ ... names=['foo', 'bar'])
13071307 >>> idx.set_names(['baz', 'quz'])
1308- MultiIndex(levels=[[1, 2], [u 'one', u 'two']],
1308+ MultiIndex(levels=[[1, 2], ['one', 'two']],
13091309 labels=[[0, 0, 1, 1], [0, 1, 0, 1]],
1310- names=[u 'baz', u 'quz'])
1310+ names=['baz', 'quz'])
13111311 >>> idx.set_names('baz', level=0)
1312- MultiIndex(levels=[[1, 2], [u 'one', u 'two']],
1312+ MultiIndex(levels=[[1, 2], ['one', 'two']],
13131313 labels=[[0, 0, 1, 1], [0, 1, 0, 1]],
1314- names=[u 'baz', u 'bar'])
1314+ names=['baz', 'bar'])
13151315
13161316 See also
13171317 --------
@@ -1345,35 +1345,35 @@ def set_names(self, names, level=None, inplace=False):
13451345 def rename (self , name , inplace = False ):
13461346 """
13471347 Set new names on index. Defaults to returning new index.
1348+
13481349 Length of names must match number of levels in MultiIndex.
13491350
13501351 Parameters
13511352 ----------
1352- name : str or sequence
1353- name (s) to set
1353+ name : str or list
1354+ Name (s) to set.
13541355 inplace : bool
1355- if True, mutates in place
1356+ If True, mutates in place.
13561357
13571358 Returns
13581359 -------
13591360 new index (of same type and class...etc) [if inplace, returns None]
13601361
13611362 Examples
13621363 --------
1363- >>> idx = Index([1, 2, 3, 4], name='foo')
1364- Int64Index([1, 2, 3, 4], dtype='int64', name='foo')
1364+ >>> idx = pd.Index([1, 2, 3, 4], name='foo')
13651365 >>> idx.rename('bar')
13661366 Int64Index([1, 2, 3, 4], dtype='int64', name='bar')
13671367
1368- >>> idx = MultiIndex.from_tuples([(1, u'one'), (1, u'two'),
1369- (2, u'one'), (2, u'two')],
1370- names=['foo', 'bar'])
1371- >>> idx.rename(['bar', None], inplace=True)
1372- >>> idx
1368+ >>> idx = pd.MultiIndex.from_tuples([(1, u'one'), (1, u'two'),
1369+ ... (2, u'one'), (2, u'two')],
1370+ ... names=['foo', 'bar'])
1371+ >>> idx.rename(['bar', None])
13731372 MultiIndex(levels=[[1, 2], ['one', 'two']],
1374- labels=[[0, 0, 1, 1], [0, 1, 0, 1]],
1375- names=['bar', None])
1373+ labels=[[0, 0, 1, 1], [0, 1, 0, 1]],
1374+ names=['bar', None])
13761375 >>> idx.rename(['bar'])
1376+ Traceback (most recent call last):
13771377 ValueError: Length of names must match number of levels in MultiIndex.
13781378
13791379 See also
0 commit comments