Add references for different index types + examples for pd.Index

Author: tp

pandas/core/indexes/base.py

@@ -122,6 +122,29 @@ class Index(IndexOpsMixin, PandasObject):
     Notes
     -----
     An Index instance can **only** contain hashable objects
+
+    Examples
+    --------
+    >>> pd.Index([1, 2, 3])
+    Int64Index([1, 2, 3], dtype='int64')
+
+    >>> pd.Index(list('abc'))
+    Index(['a', 'b', 'c'], dtype='object')
+
+    See Also
+    ---------
+    RangeIndex : Index implementing a monotonic integer range (very
+                 memory-efficient)
+    CategoricalIndex : Index with :class:`Categorical` s.
+    MultiIndex : A multi-level, or hierarchical, Index
+    DatetimeIndex : Index with datetime64 data
+    TimedeltaIndex : Index of timedelta64 data
+    PeriodIndex : Index holding regular time periods such as years, quarters,
+                  months, etc.
+    IntervalIndex : an Index of :class:`Interval` s.
+    Int64Index : Index with int64 data
+    UInt64Index : Index with uint64 data
+    Float64Index : Index with float64 data
     """
     # To hand over control to subclasses
     _join_precedence = 1

pandas/core/indexes/datetimes.py

@@ -206,9 +206,15 @@ class DatetimeIndex(DatelikeOps, TimelikeOps, DatetimeIndexOpsMixin,
 
     Notes
     -----
-
     To learn more about the frequency strings, please see `this link
     <http://pandas.pydata.org/pandas-docs/stable/timeseries.html#offset-aliases>`__.
+
+    See Also
+    ---------
+    Index : The base pandas Index type
+    TimedeltaIndex : Index of timedelta64 data
+    PeriodIndex : Index holding regular time periods such as years, quarters,
+                  months, etc.
     """
 
     _typ = 'datetimeindex'

pandas/core/indexes/interval.py

@@ -122,7 +122,7 @@ class IntervalIndex(IntervalMixin, Index):
 
     See Also
     --------
-    Index
+    Index : The base pandas Index type
     """
     _typ = 'intervalindex'
     _comparables = ['name']

pandas/core/indexes/multi.py

@@ -95,6 +95,7 @@ class MultiIndex(Index):
     MultiIndex.from_product : Create a MultiIndex from the cartesian product
                               of iterables
     MultiIndex.from_tuples  : Convert list of tuples to a MultiIndex
+    Index : The base pandas Index type
     """
 
     # initialize to zero-length tuples to make everything work

pandas/core/indexes/numeric.py

@@ -108,9 +108,14 @@ def is_all_dates(self):
         Make a copy of input ndarray
     name : object
         Name to be stored in the index
+
     Notes
     -----
     An Index instance can **only** contain hashable objects.
+
+    See also
+    --------
+    Index : The base pandas Index type
 """
 
 _int64_descr_args = dict(

pandas/core/indexes/period.py

@@ -163,6 +163,12 @@ class PeriodIndex(DatelikeOps, DatetimeIndexOpsMixin, Int64Index):
     >>> idx = PeriodIndex(year=year_arr, quarter=q_arr)
 
     >>> idx2 = PeriodIndex(start='2000', end='2010', freq='A')
+
+    See Also
+    ---------
+    Index : The base pandas Index type
+    DatetimeIndex : Index with datetime64 data
+    TimedeltaIndex : Index of timedelta64 data
     """
     _box_scalars = True
     _typ = 'periodindex'

pandas/core/indexes/range.py

@@ -38,6 +38,10 @@ class RangeIndex(Int64Index):
     copy : bool, default False
         Unused, accepted for homogeneity with other index types.
 
+    See Also
+    --------
+    Index : The base pandas Index type
+    Int64Index : Index with int64 data
     """
 
     _typ = 'rangeindex'

pandas/core/indexes/timedeltas.py

@@ -114,6 +114,14 @@ class TimedeltaIndex(DatetimeIndexOpsMixin, TimelikeOps, Int64Index):
 
     To learn more about the frequency strings, please see `this link
     <http://pandas.pydata.org/pandas-docs/stable/timeseries.html#offset-aliases>`__.
+
+    See Also
+    ---------
+    Index : The base pandas Index type
+    TimeDelta : Represents a duration between two dates or times.
+    DatetimeIndex : Index with datetime64 data
+    PeriodIndex : Index holding regular time periods such as years, quarters,
+                  months, etc.
     """
 
     _typ = 'timedeltaindex'