Merge pull request pandas-dev#3140 from jreback/cooker

DOC: cross reference cookbook and docs

Author: jreback

doc/source/10min.rst

@@ -600,6 +600,8 @@ the quarter end:
 Plotting
 --------
 
+:ref:`Plotting <visualization>` docs.
+
 .. ipython:: python
    :suppress:
 

doc/source/cookbook.rst

@@ -25,8 +25,13 @@ We encourage users to add to this documentation.
 This is a great *First Pull Request* (to add interesting links and/or put short code inline
 for existing links)
 
+.. _cookbook.selection:
+
 Selection
 ---------
+
+The :ref:`indexing <indexing>` docs.
+
 `Boolean Rows Indexing
 <http://stackoverflow.com/questions/14725068/pandas-using-row-labels-in-boolean-indexing>`__
 
@@ -42,9 +47,13 @@ Selection
 `Selecting via the complement
 <http://stackoverflow.com/questions/14986510/picking-out-elements-based-on-complement-of-indices-in-python-pandas>`__
 
+.. _cookbook.multi_index:
+
 MultiIndexing
 -------------
 
+The :ref:`multindexing <indexing.hierarchical>` docs.
+
 `Creating a multi-index from a labeled frame
 <http://stackoverflow.com/questions/14916358/reshaping-dataframes-in-pandas-based-on-column-labels>`__
 
@@ -75,9 +84,13 @@ Levels
 `Flatten Hierarchical columns
 <http://stackoverflow.com/questions/14507794/python-pandas-how-to-flatten-a-hierarchical-index-in-columns>`__
 
+.. _cookbook.grouping:
+
 Grouping
 --------
 
+The :ref:`grouping <groupby>` docs.
+
 `Basic grouping with apply
 <http://stackoverflow.com/questions/15322632/python-pandas-df-groupy-agg-column-reference-in-agg>`__
 
@@ -123,9 +136,13 @@ Timeseries
 `Vectorized Lookup
 <http://stackoverflow.com/questions/13893227/vectorized-look-up-of-values-in-pandas-dataframe>`__
 
+.. _cookbook.resample:
+
 Resampling
 ~~~~~~~~~~
 
+The :ref:`Resample <timeseries.resampling>` docs.
+
 `TimeGrouping of values grouped across time
 <http://stackoverflow.com/questions/15297053/how-can-i-divide-single-values-of-a-dataframe-by-monthly-averages>`__
 
@@ -141,9 +158,13 @@ Resampling
 `Resample minute data
 <http://stackoverflow.com/questions/14861023/resampling-minute-data>`__
 
+.. _cookbook.merge:
+
 Merge
 -----
 
+The :ref:`Concat <merging.concatenation>` docs. The :ref:`Join <merging.join>` docs.
+
 `emulate R rbind
 <http://stackoverflow.com/questions/14988480/pandas-version-of-rbind>`__
 
@@ -153,9 +174,13 @@ Merge
 `How to set the index and join
 <http://stackoverflow.com/questions/14341805/pandas-merge-pd-merge-how-to-set-the-index-and-join>`__
 
+.. _cookbook.plotting:
+
 Plotting
 --------
 
+The :ref:`Plotting <visualization>` docs.
+
 `Make Matplotlib look like R
 <http://stackoverflow.com/questions/14349055/making-matplotlib-graphs-look-like-r-by-default>`__
 
@@ -165,9 +190,13 @@ Plotting
 Data In/Out
 -----------
 
+.. _cookbook.csv:
+
 CSV
 ~~~
 
+The :ref:`CSV <io.read_csv_table>` docs
+
 `Reading a csv chunk-by-chunk
 <http://stackoverflow.com/questions/11622652/large-persistent-dataframe-in-pandas/12193309#12193309>`__
 
@@ -177,15 +206,23 @@ CSV
 `Inferring dtypes from a file
 <http://stackoverflow.com/questions/15555005/get-inferred-dataframe-types-iteratively-using-chunksize>`__
 
+.. _cookbook.sql:
+
 SQL
 ~~~
 
+The :ref:`SQL <io.sql>` docs
+
 `Reading from databases with SQL
 <http://stackoverflow.com/questions/10065051/python-pandas-and-databases-like-mysql>`__
 
+.. _cookbook.hdf:
+
 HDFStore
 ~~~~~~~~
 
+The :ref:`HDFStores <io.hdf5>` docs
+
 `Simple Queries with a Timestamp Index
 <http://stackoverflow.com/questions/13926089/selecting-columns-from-pandas-hdfstore-table>`__
 
@@ -222,5 +259,7 @@ Storing Attributes to a group node
 Miscellaneous
 -------------
 
+The :ref:`Timedeltas <timeseries.timedeltas>` docs
+
 `Operating with timedeltas
 <https://github.com/pydata/pandas/pull/2899>`__

doc/source/groupby.rst

@@ -59,6 +59,8 @@ We aim to make operations like this natural and easy to express using
 pandas. We'll address each area of GroupBy functionality then provide some
 non-trivial examples / use cases.
 
+See some :ref:`cookbook examples <cookbook.grouping>` for some advanced strategies
+
 .. _groupby.split:
 
 Splitting an object into groups

doc/source/indexing.rst

@@ -32,6 +32,8 @@ attention in this area. Expect more work to be invested higher-dimensional data
 structures (including Panel) in the future, especially in label-based advanced
 indexing.
 
+See some :ref:`cookbook examples <cookbook.selection>` for some advanced strategies
+
 Choice
 ------
 
@@ -879,6 +881,8 @@ described above and in prior sections. Later, when discussing :ref:`group by
 non-trivial applications to illustrate how it aids in structuring data for
 analysis.
 
+See some :ref:`cookbook examples <cookbook.multi_index>` for some advanced strategies
+
 .. note::
 
    Given that hierarchical indexing is so new to the library, it is definitely

doc/source/io.rst

@@ -37,6 +37,9 @@ The two workhorse functions for reading text files (a.k.a. flat files) are
 They both use the same parsing code to intelligently convert tabular
 data into a DataFrame object. They can take a number of arguments:
 
+See some :ref:`cookbook examples <cookbook.csv>` for some advanced strategies
+See some :ref:`cookbook examples <cookbook.csv>` for some advanced strategies
+
   - ``filepath_or_buffer``: Either a string path to a file, or any object with a
     ``read`` method (such as an open file or ``StringIO``).
   - ``sep`` or ``delimiter``: A delimiter / separator to split fields
@@ -981,6 +984,8 @@ HDF5 (PyTables)
 the high performance HDF5 format using the excellent `PyTables
 <http://www.pytables.org/>`__ library.
 
+See some :ref:`cookbook examples <cookbook.hdf>` for some advanced strategies
+
 .. ipython:: python
    :suppress:
    :okexcept:
@@ -1690,6 +1695,8 @@ facilitate data retrieval and to reduce dependency on DB-specific API. There
 wrappers only support the Python database adapters which respect the `Python
 DB-API <http://www.python.org/dev/peps/pep-0249/>`_.
 
+See some :ref:`cookbook examples <cookbook.sql>` for some advanced strategies
+
 Suppose you want to query some data with different types from a table such as:
 
 +-----+------------+-------+-------+-------+

doc/source/merging.rst

@@ -304,6 +304,8 @@ better) than other open source implementations (like ``base::merge.data.frame``
 in R). The reason for this is careful algorithmic design and internal layout of
 the data in DataFrame.
 
+See some :ref:`cookbook examples <cookbook.merge>` for some advanced strategies
+
 pandas provides a single function, ``merge``, as the entry point for all
 standard database join operations between DataFrame objects:
 

doc/source/timeseries.rst

@@ -579,6 +579,8 @@ performing resampling operations during frequency conversion (e.g., converting
 secondly data into 5-minutely data). This is extremely common in, but not
 limited to, financial applications.
 
+See some :ref:`cookbook examples <cookbook.resample>` for some advanced strategies
+
 .. ipython:: python
 
    rng = date_range('1/1/2012', periods=100, freq='S')

doc/source/visualization.rst

@@ -33,6 +33,8 @@ We use the standard convention for referencing the matplotlib API:
 Basic plotting: ``plot``
 ------------------------
 
+See some :ref:`cookbook examples <cookbook.plotting>` for some advanced strategies
+
 The ``plot`` method on Series and DataFrame is just a simple wrapper around
 ``plt.plot``: