From ba9c83e50d25c739488f3623bbc4fa36172e1db0 Mon Sep 17 00:00:00 2001 From: jreback Date: Wed, 13 Mar 2013 07:34:15 -0400 Subject: [PATCH 1/2] DOC: added cookbook.rst to main docs --- RELEASE.rst | 1 + doc/source/cookbook.rst | 59 +++++++++++++++++++++++++++++++++++++++++ doc/source/index.rst | 1 + doc/source/v0.11.0.txt | 3 +++ 4 files changed, 64 insertions(+) create mode 100644 doc/source/cookbook.rst diff --git a/RELEASE.rst b/RELEASE.rst index d79ede4dad26e..b91426db2741c 100644 --- a/RELEASE.rst +++ b/RELEASE.rst @@ -30,6 +30,7 @@ pandas 0.11.0 **New features** - New documentation section, ``10 Minutes to Pandas`` + - New documentation section, ``Cookbook`` - Allow mixed dtypes (e.g ``float32/float64/int32/int16/int8``) to coexist in DataFrames and propogate in operations - Add function to pandas.io.data for retrieving stock index components from diff --git a/doc/source/cookbook.rst b/doc/source/cookbook.rst new file mode 100644 index 0000000000000..02386bcc0a962 --- /dev/null +++ b/doc/source/cookbook.rst @@ -0,0 +1,59 @@ +.. _cookbook: + +.. currentmodule:: pandas + +.. ipython:: python + :suppress: + + import numpy as np + import random + import os + np.random.seed(123456) + from pandas import * + import pandas as pd + randn = np.random.randn + randint = np.random.randint + np.set_printoptions(precision=4, suppress=True) + +******** +Cookbook +******** + +This is a respository for *short and sweet* example and links for useful pandas recipes. +We encourage users to add to this documentation. This is a great *First Pull Request*. + +Selection +--------- + +`Extending a panel along the minor axis +`__ + +Grouping +-------- + +`Basic grouping with apply +`__ + +`TimeGrouping of values grouped across time +`__ + +Merge +----- + +Join +~~~~ + +`Joining a DataFrame to itself +`__ + +Data In/Out +----------- + +CSV +~~~ + +HDF5 +~~~~ + +Managing heteregenous data using a linked multiple table hierarchy. +See `here `__. diff --git a/doc/source/index.rst b/doc/source/index.rst index d59cb6d7a816b..b919657b64fc2 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -113,6 +113,7 @@ See the package overview for more detail about what's in the library. faq overview 10min + cookbook dsintro basics indexing diff --git a/doc/source/v0.11.0.txt b/doc/source/v0.11.0.txt index 9397be36697b2..c53ffa9ac1997 100644 --- a/doc/source/v0.11.0.txt +++ b/doc/source/v0.11.0.txt @@ -12,6 +12,9 @@ pay close attention to. There is a new section in the documentation, :ref:`10 Minutes to Pandas <10min>`, primarily geared to new users. +There is a new section in the documentation, :ref:`Cookbook `, a collection +of useful recipes in pandas (and that we want contributions!). + There are several libraries that are now :ref:`Recommended Dependencies ` Selection Choices From 9a55ff29dfed8d0bda867570312ad1c644a98b7d Mon Sep 17 00:00:00 2001 From: jreback Date: Wed, 13 Mar 2013 08:52:45 -0400 Subject: [PATCH 2/2] DOC: more recipes --- doc/source/cookbook.rst | 30 ++++++++++++++++++++++++++++-- 1 file changed, 28 insertions(+), 2 deletions(-) diff --git a/doc/source/cookbook.rst b/doc/source/cookbook.rst index 02386bcc0a962..a805496fa56ca 100644 --- a/doc/source/cookbook.rst +++ b/doc/source/cookbook.rst @@ -24,16 +24,27 @@ We encourage users to add to this documentation. This is a great *First Pull Req Selection --------- +`Boolean Rows Indexing +`__ `Extending a panel along the minor axis `__ +`Prepending a level to a multiindex +`__ + Grouping -------- `Basic grouping with apply `__ +`Apply to different items in a group +`__ + +`Replacing values with groupby means +`__ + `TimeGrouping of values grouped across time `__ @@ -46,6 +57,12 @@ Join `Joining a DataFrame to itself `__ +Timeseries +---------- + +`Resample intraday frame without adding new days +`__ + Data In/Out ----------- @@ -55,5 +72,14 @@ CSV HDF5 ~~~~ -Managing heteregenous data using a linked multiple table hierarchy. -See `here `__. +`Managing heteregenous data using a linked multiple table hierarchy +`__ + +`Simple Queries with a Timestamp Index +`__ + +Miscellaneous +------------- + +`Multi-index sorting +`__