From bea24d7bafaf644fe173a6cb417574624af1c528 Mon Sep 17 00:00:00 2001
From: Wouter Overmeire <lodagro@gmail.com>
Date: Fri, 23 Dec 2011 16:33:01 +0100
Subject: [PATCH] adding DataFrame.reorder_levels().

---
 pandas/core/frame.py | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/pandas/core/frame.py b/pandas/core/frame.py
index a2dc6f1868d5e..094f5086ca0b2 100644
--- a/pandas/core/frame.py
+++ b/pandas/core/frame.py
@@ -1795,6 +1795,32 @@ def swaplevel(self, i, j, axis=0):
             result.columns = result.columns.swaplevel(i, j)
         return result
 
+    def reorder_levels(self, order, axis=0):
+        """
+        Rearrange index levels using input order.
+        May not drop or duplicate levels
+
+        Parameters
+        ----------
+        order: list of int representing new level order.
+               (reference level by number not by key)
+        axis: where to reorder levels
+
+        Returns
+        -------
+        type of caller (new object)
+        """
+        if not isinstance(self._get_axis(axis), MultiIndex):
+            raise Exception('Can only reorder levels on a hierarchical axis.')
+
+        result = self.copy()
+
+        if axis == 0:
+            result.index = result.index.reorder_levels(order)
+        else:
+            result.columns = result.columns.reorder_levels(order)
+        return result
+
     #----------------------------------------------------------------------
     # Filling NA's