# pandas.MultiIndex.to_hierarchical

`MultiIndex.``to_hierarchical`(n_repeat, n_shuffle=1)

  Return a MultiIndex reshaped to conform to the shapes given by n_repeat and n_shuffle.

  Deprecated since version 0.24.0.

  Useful to replicate and rearrange a MultiIndex for combination with another Index with n_repeat items.

  Parameters:

  n_repeat : int

  > Number of times to repeat the labels on self

  n_shuffle : int

  > Controls the reordering of the labels. If the result is going to be an inner level in a MultiIndex, n_shuffle will need to be greater than one. The size of each label must divisible by n_shuffle.

  Returns: | MultiIndex

  Examples

      >>> idx = pd.MultiIndex.from_tuples([(1, 'one'), (1, 'two'),
                                          (2, 'one'), (2, 'two')])
      >>> idx.to_hierarchical(3)
      MultiIndex([(1, 'one'),
                  (1, 'one'),
                  (1, 'one'),
                  (1, 'two'),
                  (1, 'two'),
                  (1, 'two'),
                  (2, 'one'),
                  (2, 'one'),
                  (2, 'one'),
                  (2, 'two'),
                  (2, 'two'),
                  (2, 'two')],
                 )

Scroll To Top