From 71c250c4ca267adb797d3feecfb582025386f8ac Mon Sep 17 00:00:00 2001
From: jreback <jeff@reback.net>
Date: Mon, 25 Mar 2013 17:42:40 -0400
Subject: [PATCH] DOC: provide an axis alises example in the cookbook.rst

---
 doc/source/cookbook.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/doc/source/cookbook.rst b/doc/source/cookbook.rst
index 12140bcc66403..20f6937cf8cf5 100644
--- a/doc/source/cookbook.rst
+++ b/doc/source/cookbook.rst
@@ -297,3 +297,26 @@ The :ref:`Timedeltas <timeseries.timedeltas>` docs.
 
 `Operating with timedeltas
 <https://github.com/pydata/pandas/pull/2899>`__
+
+Aliasing Axis Names
+-------------------
+
+To globally provide aliases for axis names, one can define these 2 functions:
+
+.. ipython:: python
+
+   def set_axis_alias(cls, axis, alias):
+        if axis not in cls._AXIS_NUMBERS:
+            raise Exception("invalid axis [%s] for alias [%s]" % (axis, alias))
+        cls._AXIS_ALIASES[alias] = axis
+
+   def clear_axis_alias(cls, axis, alias):
+        if axis not in cls._AXIS_NUMBERS:
+            raise Exception("invalid axis [%s] for alias [%s]" % (axis, alias))
+        cls._AXIS_ALIASES.pop(alias,None)
+
+
+   set_axis_alias(DataFrame,'columns', 'myaxis2')
+   df2 = DataFrame(randn(3,2),columns=['c1','c2'],index=['i1','i2','i3'])
+   df2.sum(axis='myaxis2') 
+   clear_axis_alias(DataFrame,'columns', 'myaxis2')