This is the list of changes to pandas between each release. For full details, see the commit logs at http://github.com/pydata/pandas
pandas is a Python package providing fast, flexible, and expressive data structures designed to make working with “relational” or “labeled” data both easy and intuitive. It aims to be the fundamental high-level building block for doing practical, real world data analysis in Python. Additionally, it has the broader goal of becoming the most powerful and flexible open source data analysis / manipulation tool available in any language.
- Source code: http://github.com/pydata/pandas
- Binary installers on PyPI: http://pypi.python.org/pypi/pandas
- Documentation: http://pandas.pydata.org
Release date: NOT YET RELEASED
New features
- New unified DatetimeIndex class for nanosecond-level timestamp data
- New Timestamp datetime.datetime subclass with easy time zone conversions, and support for nanoseconds
- New PeriodIndex class for timespans, calendar logic, and Period scalar object
- High performance resampling of timestamp and period data. New resample method of all pandas data structures
- New frequency names plus shortcut string aliases like '15h', '1h30min'
- Time series string indexing shorthand (#222)
- Add week, dayofyear array and other timestamp array-valued field accessor functions to DatetimeIndex
- Add GroupBy.prod optimized aggregation function and 'prod' fast time series conversion method (#1018)
- Implement robust frequency inference function and inferred_freq attribute on DatetimeIndex (#391)
- New
tz_convert
methods in Series / DataFrame- Convert DatetimeIndexes to UTC if time zones are different in join/setops (#864)
- Add limit argument for forward/backward filling to reindex, fillna, etc. (#825 and others)
- Add support for indexes (dates or otherwise) with duplicates and common sense indexing/selection functionality
- Series/DataFrame.update methods, in-place variant of combine_first (#961)
- Add
match
function to API (#502)- Add Cython-optimized first, last, min, max, prod functions to GroupBy (#994, #1043)
- Dates can be split across multiple columns (#1227, #1186)
- Add experimental support for converting pandas DataFrame to R data.frame via rpy2 (#350, #1212)
- Can pass list of (name, function) to GroupBy.aggregate to get aggregates in a particular order (#610)
- Can pass dicts with lists of functions or dicts to GroupBy aggregate to do much more flexible multiple function aggregation (#642, #610)
- New ordered_merge functions for merging DataFrames with ordered data. Also supports group-wise merging for panel data (#813)
- Add keys() method to DataFrame
- Add flexible replace method for replacing potentially values to Series and DataFrame (#929, #1241)
- Add 'kde' plot kind for Series/DataFrame.plot (#1059)
- More flexible multiple function aggregation with GroupBy
- Add pct_change function to Series/DataFrame
- Add option to interpolate by Index values in Series.interpolate (#1206)
- Add
max_colwidth
option for DataFrame, defaulting to 50- Conversion of DataFrame through rpy2 to R data.frame (#1282, )
- Add keys() method on DataFrame (#1240)
- Add new
match
function to API (similar to R) (#502)- Add dayfirst option to parsers (#854)
- Add
method
argument toalign
method for forward/backward fillin (#216)- Add Panel.transpose method for rearranging axes (#695)
Improvements to existing features
- Switch to klib/khash-based hash tables in Index classes for better performance in many cases and lower memory footprint
- Shipping some functions from scipy.stats to reduce dependency, e.g. Series.describe and DataFrame.describe (GH #1092)
- Can create MultiIndex by passing list of lists or list of arrays to Series, DataFrame constructor, etc. (#831)
- Can pass arrays in addition to column names to DataFrame.set_index (#402)
- Improve the speed of "square" reindexing of homogeneous DataFrame objects by significant margin (#836)
- Handle more dtypes when passed MaskedArrays in DataFrame constructor (#406)
- Improved performance of join operations on integer keys (#682)
- Can pass multiple columns to GroupBy object, e.g. grouped[[col1, col2]] to only aggregate a subset of the value columns (#383)
- Add histogram / kde plot options for scatter_matrix diagonals (#1237)
- Add inplace option to Series/DataFrame.rename and sort_index, DataFrame.drop_duplicates (#805, #207)
- More helpful error message when nothing passed to Series.reindex (#1267)
- Can mix array and scalars as dict-value inputs to DataFrame ctor (#1329)
- Use DataFrame columns' name for legend title in plots
- Preserve frequency in DatetimeIndex when possible in boolean indexing operations
- Promote datetime.date values in data alignment operations (#867)
- Add
order
method to Index classes (#1028)- Avoid hash table creation in large monotonic hash table indexes (#1160)
- Store time zones in HDFStore (#1232)
- Enable storage of sparse data structures in HDFStore (#85)
- Enable Series.asof to work with arrays of timestamp inputs
- Cython implementation of DataFrame.corr speeds up by > 100x (#1349)
API Changes
- Frequency name overhaul, WEEKDAY/EOM and rules with @ deprecated. get_legacy_offset_name backwards compatibility function added
- Raise ValueError in DataFrame.__nonzero__, so "if df" no longer works (#1073)
- Change BDay (business day) to not normalize dates by default (#506)
- Remove deprecated DataMatrix name
- Default merge suffixes for overlap now have underscores instead of periods to facilitate tab completion, etc. (#1239)
- Deprecation of offset, time_rule timeRule parameters throughout codebase
Bug fixes
- Fix OverflowError from storing pre-1970 dates in HDFStore by switching to datetime64 (GH #179)
- Fix logical error with February leap year end in YearEnd offset
- Series([False, nan]) was getting casted to float64 (GH #1074)
- Fix binary operations between boolean Series and object Series with booleans and NAs (GH #1074, #1079)
- Couldn't assign whole array to column in mixed-type DataFrame via .ix (#1142)
- Fix label slicing issues with float index values (#1167)
- Fix segfault caused by empty groups passed to groupby (#1048)
- Fix occasionally misbehaved reindexing in the presence of NaN labels (#522)
- Fix imprecise logic causing weird Series results from .apply (#1183)
- Unstack multiple levels in one shot, avoiding empty columns in some cases. Fix pivot table bug (#1181)
- Fix formatting of MultiIndex on Series/DataFrame when index name coincides with label (#1217)
- Handle Excel 2003 #N/A as NaN from xlrd (#1213, #1225)
- Fix timestamp locale-related deserialization issues with HDFStore by moving to datetime64 representation (#1081, #809)
- Fix DataFrame.duplicated/drop_duplicates NA value handling (#557)
- Actually raise exceptions in fast reducer (#1243)
- Fix various timezone-handling bugs from 0.7.3 (#969)
- GroupBy on level=0 discarded index name (#1313)
- Better error message with unmergeable DataFrames (#1307)
- Series.__repr__ alignment fix with unicode index values (#1279)
- Better error message if nothing passed to reindex (#1267)
- More robust NA handling in DataFrame.drop_duplicates (#557)
- Resolve locale-based and pre-epoch HDF5 timestamp deserialization issues (#973, #1081, #179)
- Implement Series.repeat (#1229)
- Fix indexing with namedtuple and other tuple subclasses (#1026)
- Fix float64 slicing bug (#1167)
- Parsing integers with commas (#796)
- Fix groupby improper data type when group consists of one value (#1065)
- Fix negative variance possibility in nanvar resulting from floating point error (#1090)
- Consistently set name on groupby pieces (#184)
- Treat dict return values as Series in GroupBy.apply (#823)
Release date: April 12, 2012
New features / modules
- Support for non-unique indexes: indexing and selection, many-to-one and many-to-many joins (#1306)
- Added fixed-width file reader, read_fwf (PR #952)
- Add group_keys argument to groupby to not add group names to MultiIndex in result of apply (GH #938)
- DataFrame can now accept non-integer label slicing (GH #946). Previously only DataFrame.ix was able to do so.
- DataFrame.apply now retains name attributes on Series objects (GH #983)
- Numeric DataFrame comparisons with non-numeric values now raises proper TypeError (GH #943). Previously raise "PandasError: DataFrame constructor not properly called!"
- Add
kurt
methods to Series and DataFrame (PR #964)- Can pass dict of column -> list/set NA values for text parsers (GH #754)
- Allows users specified NA values in text parsers (GH #754)
- Parsers checks for openpyxl dependency and raises ImportError if not found (PR #1007)
- New factory function to create HDFStore objects that can be used in a with statement so users do not have to explicitly call HDFStore.close (PR #1005)
- pivot_table is now more flexible with same parameters as groupby (GH #941)
- Added stacked bar plots (GH #987)
- scatter_matrix method in pandas/tools/plotting.py (PR #935)
- DataFrame.boxplot returns plot results for ex-post styling (GH #985)
- Short version number accessible as pandas.version.short_version (GH #930)
- Additional documentation in panel.to_frame (GH #942)
- More informative Series.apply docstring regarding element-wise apply (GH #977)
- Notes on rpy2 installation (GH #1006)
- Add rotation and font size options to hist method (#1012)
- Use exogenous / X variable index in result of OLS.y_predict. Add OLS.predict method (PR #1027, #1008)
API Changes
- Calling apply on grouped Series, e.g. describe(), will no longer yield DataFrame by default. Will have to call unstack() to get prior behavior
- NA handling in non-numeric comparisons has been tightened up (#933, #953)
- No longer assign dummy names key_0, key_1, etc. to groupby index (#1291)
Bug fixes
- Fix logic error when selecting part of a row in a DataFrame with a MultiIndex index (GH #1013)
- Series comparison with Series of differing length causes crash (GH #1016).
- Fix bug in indexing when selecting section of hierarchically-indexed row (GH #1013)
- DataFrame.plot(logy=True) has no effect (GH #1011).
- Broken arithmetic operations between SparsePanel-Panel (GH #1015)
- Unicode repr issues in MultiIndex with non-ascii characters (GH #1010)
- DataFrame.lookup() returns inconsistent results if exact match not present (GH #1001)
- DataFrame arithmetic operations not treating None as NA (GH #992)
- DataFrameGroupBy.apply returns incorrect result (GH #991)
- Series.reshape returns incorrect result for multiple dimensions (GH #989)
- Series.std and Series.var ignores ddof parameter (GH #934)
- DataFrame.append loses index names (GH #980)
- DataFrame.plot(kind='bar') ignores color argument (GH #958)
- Inconsistent Index comparison results (GH #948)
- Improper int dtype DataFrame construction from data with NaN (GH #846)
- Removes default 'result' name in grouby results (GH #995)
- DataFrame.from_records no longer mutate input columns (PR #975)
- Use Index name when grouping by it (#1313)
Release date: March 16, 2012
New features / modules
- Add additional tie-breaking methods in DataFrame.rank (#874)
- Add ascending parameter to rank in Series, DataFrame (#875)
- Add coerce_float option to DataFrame.from_records (#893)
- Add sort_columns parameter to allow unsorted plots (#918)
- IPython tab completion on GroupBy objects
API Changes
- Series.sum returns 0 instead of NA when called on an empty series. Analogously for a DataFrame whose rows or columns are length 0 (#844)
Improvements to existing features
- Don't use groups dict in Grouper.size (#860)
- Use khash for Series.value_counts, add raw function to algorithms.py (#861)
- Enable column access via attributes on GroupBy (#882)
- Enable setting existing columns (only) via attributes on DataFrame, Panel (#883)
- Intercept __builtin__.sum in groupby (#885)
- Can pass dict to DataFrame.fillna to use different values per column (#661)
- Can select multiple hierarchical groups by passing list of values in .ix (#134)
- Add level keyword to
drop
for dropping values from a level (GH #159)- Add
coerce_float
option on DataFrame.from_records (# 893)- Raise exception if passed date_parser fails in
read_csv
- Add
axis
option to DataFrame.fillna (#174)- Fixes to Panel to make it easier to subclass (PR #888)
Bug fixes
- Fix overflow-related bugs in groupby (#850, #851)
- Fix unhelpful error message in parsers (#856)
- Better err msg for failed boolean slicing of dataframe (#859)
- Series.count cannot accept a string (level name) in the level argument (#869)
- Group index platform int check (#870)
- concat on axis=1 and ignore_index=True raises TypeError (#871)
- Further unicode handling issues resolved (#795)
- Fix failure in multiindex-based access in Panel (#880)
- Fix DataFrame boolean slice assignment failure (#881)
- Fix combineAdd NotImplementedError for SparseDataFrame (#887)
- Fix DataFrame.to_html encoding and columns (#890, #891, #909)
- Fix na-filling handling in mixed-type DataFrame (#910)
- Fix to DataFrame.set_value with non-existant row/col (#911)
- Fix malformed block in groupby when excluding nuisance columns (#916)
- Fix inconsistant NA handling in dtype=object arrays (#925)
- Fix missing center-of-mass computation in ewmcov (#862)
- Don't raise exception when opening read-only HDF5 file (#847)
- Fix possible out-of-bounds memory access in 0-length Series (#917)
Release date: February 29, 2012
New features / modules
- Add
to_clipboard
function to pandas namespace for writing objects to the system clipboard (#774)- Add
itertuples
method to DataFrame for iterating through the rows of a dataframe as tuples (#818)- Add ability to pass fill_value and method to DataFrame and Series align method (#806, #807)
- Add fill_value option to reindex, align methods (#784)
- Enable concat to produce DataFrame from Series (#787)
- Add
between
method to Series (#802)- Add HTML representation hook to DataFrame for the IPython HTML notebook (#773)
- Support for reading Excel 2007 XML documents using openpyxl
Improvements to existing features
- Improve performance and memory usage of fillna on DataFrame
- Can concatenate a list of Series along axis=1 to obtain a DataFrame (#787)
Bug fixes
- Fix memory leak when inserting large number of columns into a single DataFrame (#790)
- Appending length-0 DataFrame with new columns would not result in those new columns being part of the resulting concatenated DataFrame (#782)
- Fixed groupby corner case when passing dictionary grouper and as_index is False (#819)
- Fixed bug whereby bool array sometimes had object dtype (#820)
- Fix exception thrown on np.diff (#816)
- Fix to_records where columns are non-strings (#822)
- Fix Index.intersection where indices have incomparable types (#811)
- Fix ExcelFile throwing an exception for two-line file (#837)
- Add clearer error message in csv parser (#835)
- Fix loss of fractional seconds in HDFStore (#513)
- Fix DataFrame join where columns have datetimes (#787)
- Work around numpy performance issue in take (#817)
- Improve comparison operations for NA-friendliness (#801)
- Fix indexing operation for floating point values (#780, #798)
- Fix groupby case resulting in malformed dataframe (#814)
- Fix behavior of reindex of Series dropping name (#812)
- Improve on redudant groupby computation (#775)
- Catch possible NA assignment to int/bool series with exception (#839)
Release date: 2/9/2012
New features / modules
- New
merge
function for efficiently performing full gamut of database / relational-algebra operations. Refactored existing join methods to use the new infrastructure, resulting in substantial performance gains (GH #220, #249, #267)- New
concat
function for concatenating DataFrame or Panel objects along an axis. Can form union or intersection of the other axes. Improves performance ofDataFrame.append
(#468, #479, #273)- Handle differently-indexed output values in
DataFrame.apply
(GH #498)- Can pass list of dicts (e.g., a list of shallow JSON objects) to DataFrame constructor (GH #526)
- Add
reorder_levels
method to Series and DataFrame (PR #534)- Add dict-like
get
function to DataFrame and Panel (PR #521)DataFrame.iterrows
method for efficiently iterating through the rows of a DataFrame- Added
DataFrame.to_panel
with code adapted fromLongPanel.to_long
reindex_axis
method added to DataFrame- Add
level
option to binary arithmetic functions onDataFrame
andSeries
- Add
level
option to thereindex
andalign
methods on Series and DataFrame for broadcasting values across a level (GH #542, PR #552, others)- Add attribute-based item access to
Panel
and add IPython completion (PR #554)- Add
logy
option toSeries.plot
for log-scaling on the Y axis- Add
index
,header
, andjustify
options toDataFrame.to_string
. Add option to (GH #570, GH #571)- Can pass multiple DataFrames to
DataFrame.join
to join on index (GH #115)- Can pass multiple Panels to
Panel.join
(GH #115)- Can pass multiple DataFrames to DataFrame.append to concatenate (stack) and multiple Series to
Series.append
too- Added
justify
argument toDataFrame.to_string
to allow different alignment of column headers- Add
sort
option to GroupBy to allow disabling sorting of the group keys for potential speedups (GH #595)- Can pass MaskedArray to Series constructor (PR #563)
- Add Panel item access via attributes and IPython completion (GH #554)
- Implement
DataFrame.lookup
, fancy-indexing analogue for retrieving values given a sequence of row and column labels (GH #338)- Add
verbose
option toread_csv
andread_table
to show number of NA values inserted in non-numeric columns (GH #614)- Can pass a list of dicts or Series to
DataFrame.append
to concatenate multiple rows (GH #464)- Add
level
argument toDataFrame.xs
for selecting data from other MultiIndex levels. Can take one or more levels with potentially a tuple of keys for flexible retrieval of data (GH #371, GH #629)- New
crosstab
function for easily computing frequency tables (GH #170)- Can pass a list of functions to aggregate with groupby on a DataFrame, yielding an aggregated result with hierarchical columns (GH #166)
- Add integer-indexing functions
iget
in Series andirow
/iget
in DataFrame (GH #628)- Add new
Series.unique
function, significantly faster thannumpy.unique
(GH #658)- Add new
cummin
andcummax
instance methods toSeries
andDataFrame
(GH #647)- Add new
value_range
function to return min/max of a dataframe (GH #288)- Add
drop
parameter toreset_index
method ofDataFrame
and added method toSeries
as well (GH #699)- Add
isin
method to Index objects, works just likeSeries.isin
(GH #657)- Implement array interface on Panel so that ufuncs work (re: #740)
- Add
sort
option toDataFrame.join
(GH #731)- Improved handling of NAs (propagation) in binary operations with dtype=object arrays (GH #737)
- Add
abs
method to Pandas objects- Added
algorithms
module to start collecting central algos
API Changes
- Label-indexing with integer indexes now raises KeyError if a label is not found instead of falling back on location-based indexing (GH #700)
- Label-based slicing via
ix
or[]
on Series will now only work if exact matches for the labels are found or if the index is monotonic (for range selections)- Label-based slicing and sequences of labels can be passed to
[]
on a Series for both getting and setting (GH #86)- [] operator (
__getitem__
and__setitem__
) will raise KeyError with integer indexes when an index is not contained in the index. The prior behavior would fall back on position-based indexing if a key was not found in the index which would lead to subtle bugs. This is now consistent with the behavior of.ix
on DataFrame and friends (GH #328)- Rename
DataFrame.delevel
toDataFrame.reset_index
and add deprecation warning- Series.sort (an in-place operation) called on a Series which is a view on a larger array (e.g. a column in a DataFrame) will generate an Exception to prevent accidentally modifying the data source (GH #316)
- Refactor to remove deprecated
LongPanel
class (PR #552)- Deprecated
Panel.to_long
, renamed toto_frame
- Deprecated
colSpace
argument inDataFrame.to_string
, renamed tocol_space
- Rename
precision
toaccuracy
in engineering float formatter (GH #395)- The default delimiter for
read_csv
is comma rather than lettingcsv.Sniffer
infer it- Rename
col_or_columns
argument inDataFrame.drop_duplicates
(GH #734)
Improvements to existing features
- Better error message in DataFrame constructor when passed column labels don't match data (GH #497)
- Substantially improve performance of multi-GroupBy aggregation when a Python function is passed, reuse ndarray object in Cython (GH #496)
- Can store objects indexed by tuples and floats in HDFStore (GH #492)
- Don't print length by default in Series.to_string, add length option (GH #489)
- Improve Cython code for multi-groupby to aggregate without having to sort the data (GH #93)
- Improve MultiIndex reindexing speed by storing tuples in the MultiIndex, test for backwards unpickling compatibility
- Improve column reindexing performance by using specialized Cython take function
- Further performance tweaking of Series.__getitem__ for standard use cases
- Avoid Index dict creation in some cases (i.e. when getting slices, etc.), regression from prior versions
- Friendlier error message in setup.py if NumPy not installed
- Use common set of NA-handling operations (sum, mean, etc.) in Panel class also (GH #536)
- Default name assignment when calling
reset_index
on DataFrame with a regular (non-hierarchical) index (GH #476)- Use Cythonized groupers when possible in Series/DataFrame stat ops with
level
parameter passed (GH #545)- Ported skiplist data structure to C to speed up
rolling_median
by about 5-10x in most typical use cases (GH #374)- Some performance enhancements in constructing a Panel from a dict of DataFrame objects
- Made
Index._get_duplicates
a public method by removing the underscore- Prettier printing of floats, and column spacing fix (GH #395, GH #571)
- Add
bold_rows
option to DataFrame.to_html (GH #586)- Improve the performance of
DataFrame.sort_index
by up to 5x or more when sorting by multiple columns- Substantially improve performance of DataFrame and Series constructors when passed a nested dict or dict, respectively (GH #540, GH #621)
- Modified setup.py so that pip / setuptools will install dependencies (GH #507, various pull requests)
- Unstack called on DataFrame with non-MultiIndex will return Series (GH #477)
- Improve DataFrame.to_string and console formatting to be more consistent in the number of displayed digits (GH #395)
- Use bottleneck if available for performing NaN-friendly statistical operations that it implemented (GH #91)
- Monkey-patch context to traceback in
DataFrame.apply
to indicate which row/column the function application failed on (GH #614)- Improved ability of read_table and read_clipboard to parse console-formatted DataFrames (can read the row of index names, etc.)
- Can pass list of group labels (without having to convert to an ndarray yourself) to
groupby
in some cases (GH #659)- Use
kind
argument to Series.order for selecting different sort kinds (GH #668)- Add option to Series.to_csv to omit the index (PR #684)
- Add
delimiter
as an alternative tosep
inread_csv
and other parsing functions- Substantially improved performance of groupby on DataFrames with many columns by aggregating blocks of columns all at once (GH #745)
- Can pass a file handle or StringIO to Series/DataFrame.to_csv (GH #765)
- Can pass sequence of integers to DataFrame.irow(icol) and Series.iget, (GH #654)
- Prototypes for some vectorized string functions
- Add float64 hash table to solve the Series.unique problem with NAs (GH #714)
- Memoize objects when reading from file to reduce memory footprint
- Can get and set a column of a DataFrame with hierarchical columns containing "empty" ('') lower levels without passing the empty levels (PR #768)
Bug fixes
- Raise exception in out-of-bounds indexing of Series instead of seg-faulting, regression from earlier releases (GH #495)
- Fix error when joining DataFrames of different dtypes within the same typeclass (e.g. float32 and float64) (GH #486)
- Fix bug in Series.min/Series.max on objects like datetime.datetime (GH #487)
- Preserve index names in Index.union (GH #501)
- Fix bug in Index joining causing subclass information (like DateRange type) to be lost in some cases (GH #500)
- Accept empty list as input to DataFrame constructor, regression from 0.6.0 (GH #491)
- Can output DataFrame and Series with ndarray objects in a dtype=object array (GH #490)
- Return empty string from Series.to_string when called on empty Series (GH #488)
- Fix exception passing empty list to DataFrame.from_records
- Fix Index.format bug (excluding name field) with datetimes with time info
- Fix scalar value access in Series to always return NumPy scalars, regression from prior versions (GH #510)
- Handle rows skipped at beginning of file in read_* functions (GH #505)
- Handle improper dtype casting in
set_value
methods- Unary '-' / __neg__ operator on DataFrame was returning integer values
- Unbox 0-dim ndarrays from certain operators like all, any in Series
- Fix handling of missing columns (was combine_first-specific) in DataFrame.combine for general case (GH #529)
- Fix type inference logic with boolean lists and arrays in DataFrame indexing
- Use centered sum of squares in R-square computation if entity_effects=True in panel regression
- Handle all NA case in Series.{corr, cov}, was raising exception (GH #548)
- Aggregating by multiple levels with
level
argument to DataFrame, Series stat method, was broken (GH #545)- Fix Cython buf when converter passed to read_csv produced a numeric array (buffer dtype mismatch when passed to Cython type inference function) (GH #546)
- Fix exception when setting scalar value using .ix on a DataFrame with a MultiIndex (GH #551)
- Fix outer join between two DateRanges with different offsets that returned an invalid DateRange
- Cleanup DataFrame.from_records failure where index argument is an integer
- Fix Data.from_records failure when passed a dictionary
- Fix NA handling in {Series, DataFrame}.rank with non-floating point dtypes
- Fix bug related to integer type-checking in .ix-based indexing
- Handle non-string index name passed to DataFrame.from_records
- DataFrame.insert caused the columns name(s) field to be discarded (GH #527)
- Fix erroneous in monotonic many-to-one left joins
- Fix DataFrame.to_string to remove extra column white space (GH #571)
- Format floats to default to same number of digits (GH #395)
- Added decorator to copy docstring from one function to another (GH #449)
- Fix error in monotonic many-to-one left joins
- Fix __eq__ comparison between DateOffsets with different relativedelta keywords passed
- Fix exception caused by parser converter returning strings (GH #583)
- Fix MultiIndex formatting bug with integer names (GH #601)
- Fix bug in handling of non-numeric aggregates in Series.groupby (GH #612)
- Fix TypeError with tuple subclasses (e.g. namedtuple) in DataFrame.from_records (GH #611)
- Catch misreported console size when running IPython within Emacs
- Fix minor bug in pivot table margins, loss of index names and length-1 'All' tuple in row labels
- Add support for legacy WidePanel objects to be read from HDFStore
- Fix out-of-bounds segfault in pad_object and backfill_object methods when either source or target array are empty
- Could not create a new column in a DataFrame from a list of tuples
- Fix bugs preventing SparseDataFrame and SparseSeries working with groupby (GH #666)
- Use sort kind in Series.sort / argsort (GH #668)
- Fix DataFrame operations on non-scalar, non-pandas objects (GH #672)
- Don't convert DataFrame column to integer type when passing integer to __setitem__ (GH #669)
- Fix downstream bug in pivot_table caused by integer level names in MultiIndex (GH #678)
- Fix SparseSeries.combine_first when passed a dense Series (GH #687)
- Fix performance regression in HDFStore loading when DataFrame or Panel stored in table format with datetimes
- Raise Exception in DateRange when offset with n=0 is passed (GH #683)
- Fix get/set inconsistency with .ix property and integer location but non-integer index (GH #707)
- Use right dropna function for SparseSeries. Return dense Series for NA fill value (GH #730)
- Fix Index.format bug causing incorrectly string-formatted Series with datetime indexes (# 726, 758)
- Fix errors caused by object dtype arrays passed to ols (GH #759)
- Fix error where column names lost when passing list of labels to DataFrame.__getitem__, (GH #662)
- Fix error whereby top-level week iterator overwrote week instance
- Fix circular reference causing memory leak in sparse array / series / frame, (GH #663)
- Fix integer-slicing from integers-as-floats (GH #670)
- Fix zero division errors in nanops from object dtype arrays in all NA case (GH #676)
- Fix csv encoding when using unicode (GH #705, #717, #738)
- Fix assumption that each object contains every unique block type in concat, (GH #708)
- Fix sortedness check of multiindex in to_panel (GH #719, 720)
- Fix that None was not treated as NA in PyObjectHashtable
- Fix hashing dtype because of endianness confusion (GH #747, #748)
- Fix SparseSeries.dropna to return dense Series in case of NA fill value (GH #730)
- Use map_infer instead of np.vectorize. handle NA sentinels if converter yields numeric array, (GH #753)
- Fixes and improvements to DataFrame.rank (GH #742)
- Fix catching AttributeError instead of NameError for bottleneck
- Try to cast non-MultiIndex to better dtype when calling reset_index (GH #726 #440)
- Fix #1.QNAN0' float bug on 2.6/win64
- Allow subclasses of dicts in DataFrame constructor, with tests
- Fix problem whereby set_index destroys column multiindex (GH #764)
- Hack around bug in generating DateRange from naive DateOffset (GH #770)
- Fix bug in DateRange.intersection causing incorrect results with some overlapping ranges (GH #771)
- Craig Austin
- Chris Billington
- Marius Cobzarenco
- Mario Gamboa-Cavazos
- Hans-Martin Gaudecker
- Arthur Gerigk
- Yaroslav Halchenko
- Jeff Hammerbacher
- Matt Harrison
- Andreas Hilboll
- Luc Kesters
- Adam Klein
- Gregg Lind
- Solomon Negusse
- Wouter Overmeire
- Christian Prinoth
- Jeff Reback
- Sam Reckoner
- Craig Reeson
- Jan Schulz
- Skipper Seabold
- Ted Square
- Graham Taylor
- Aman Thakral
- Chris Uga
- Dieter Vandenbussche
- Texas P.
- Pinxing Ye
- ... and everyone I forgot
Release date: 12/13/2011
API Changes
- Rename names argument in DataFrame.from_records to columns. Add deprecation warning
- Boolean get/set operations on Series with boolean Series will reindex instead of requiring that the indexes be exactly equal (GH #429)
New features / modules
- Can pass Series to DataFrame.append with ignore_index=True for appending a single row (GH #430)
- Add Spearman and Kendall correlation options to Series.corr and DataFrame.corr (GH #428)
- Add new get_value and set_value methods to Series, DataFrame, and Panel to very low-overhead access to scalar elements. df.get_value(row, column) is about 3x faster than df[column][row] by handling fewer cases (GH #437, #438). Add similar methods to sparse data structures for compatibility
- Add Qt table widget to sandbox (PR #435)
- DataFrame.align can accept Series arguments, add axis keyword (GH #461)
- Implement new SparseList and SparseArray data structures. SparseSeries now derives from SparseArray (GH #463)
- max_columns / max_rows options in set_printoptions (PR #453)
- Implement Series.rank and DataFrame.rank, fast versions of scipy.stats.rankdata (GH #428)
- Implement DataFrame.from_items alternate constructor (GH #444)
- DataFrame.convert_objects method for inferring better dtypes for object columns (GH #302)
- Add rolling_corr_pairwise function for computing Panel of correlation matrices (GH #189)
- Add margins option to pivot_table for computing subgroup aggregates (GH #114)
- Add Series.from_csv function (PR #482)
Improvements to existing features
- Improve memory usage of DataFrame.describe (do not copy data unnecessarily) (PR #425)
- Use same formatting function for outputting floating point Series to console as in DataFrame (PR #420)
- DataFrame.delevel will try to infer better dtype for new columns (GH #440)
- Exclude non-numeric types in DataFrame.{corr, cov}
- Override Index.astype to enable dtype casting (GH #412)
- Use same float formatting function for Series.__repr__ (PR #420)
- Use available console width to output DataFrame columns (PR #453)
- Accept ndarrays when setting items in Panel (GH #452)
- Infer console width when printing __repr__ of DataFrame to console (PR #453)
- Optimize scalar value lookups in the general case by 25% or more in Series and DataFrame
- Can pass DataFrame/DataFrame and DataFrame/Series to rolling_corr/rolling_cov (GH #462)
- Fix performance regression in cross-sectional count in DataFrame, affecting DataFrame.dropna speed
- Column deletion in DataFrame copies no data (computes views on blocks) (GH #158)
- MultiIndex.get_level_values can take the level name
- More helpful error message when DataFrame.plot fails on one of the columns (GH #478)
- Improve performance of DataFrame.{index, columns} attribute lookup
Bug fixes
- Fix O(K^2) memory leak caused by inserting many columns without consolidating, had been present since 0.4.0 (GH #467)
- DataFrame.count should return Series with zero instead of NA with length-0 axis (GH #423)
- Fix Yahoo! Finance API usage in pandas.io.data (GH #419, PR #427)
- Fix upstream bug causing failure in Series.align with empty Series (GH #434)
- Function passed to DataFrame.apply can return a list, as long as it's the right length. Regression from 0.4 (GH #432)
- Don't "accidentally" upcast scalar values when indexing using .ix (GH #431)
- Fix groupby exception raised with as_index=False and single column selected (GH #421)
- Implement DateOffset.__ne__ causing downstream bug (GH #456)
- Fix __doc__-related issue when converting py -> pyo with py2exe
- Bug fix in left join Cython code with duplicate monotonic labels
- Fix bug when unstacking multiple levels described in #451
- Exclude NA values in dtype=object arrays, regression from 0.5.0 (GH #469)
- Use Cython map_infer function in DataFrame.applymap to properly infer output type, handle tuple return values and other things that were breaking (GH #465)
- Handle floating point index values in HDFStore (GH #454)
- Fixed stale column reference bug (cached Series object) caused by type change / item deletion in DataFrame (GH #473)
- Index.get_loc should always raise Exception when there are duplicates
- Handle differently-indexed Series input to DataFrame constructor (GH #475)
- Omit nuisance columns in multi-groupby with Python function
- Buglet in handling of single grouping in general apply
- Handle type inference properly when passing list of lists or tuples to DataFrame constructor (GH #484)
- Preserve Index / MultiIndex names in GroupBy.apply concatenation step (GH #481)
- Ralph Bean
- Luca Beltrame
- Marius Cobzarenco
- Andreas Hilboll
- Jev Kuznetsov
- Adam Lichtenstein
- Wouter Overmeire
- Fernando Perez
- Nathan Pinger
- Christian Prinoth
- Alex Reyfman
- Joon Ro
- Chang She
- Ted Square
- Chris Uga
- Dieter Vandenbussche
Release date: 11/25/2011
API Changes
- Arithmetic methods like sum will attempt to sum dtype=object values by default instead of excluding them (GH #382)
New features / modules
- Add melt function to pandas.core.reshape
- Add level parameter to group by level in Series and DataFrame descriptive statistics (PR #313)
- Add head and tail methods to Series, analogous to to DataFrame (PR #296)
- Add Series.isin function which checks if each value is contained in a passed sequence (GH #289)
- Add float_format option to Series.to_string
- Add skip_footer (GH #291) and converters (GH #343) options to read_csv and read_table
- Add proper, tested weighted least squares to standard and panel OLS (GH #303)
- Add drop_duplicates and duplicated functions for removing duplicate DataFrame rows and checking for duplicate rows, respectively (GH #319)
- Implement logical (boolean) operators &, |, ^ on DataFrame (GH #347)
- Add Series.mad, mean absolute deviation, matching DataFrame
- Add QuarterEnd DateOffset (PR #321)
- Add matrix multiplication function dot to DataFrame (GH #65)
- Add orient option to Panel.from_dict to ease creation of mixed-type Panels (GH #359, #301)
- Add DataFrame.from_dict with similar orient option
- Can now pass list of tuples or list of lists to DataFrame.from_records for fast conversion to DataFrame (GH #357)
- Can pass multiple levels to groupby, e.g. df.groupby(level=[0, 1]) (GH #103)
- Can sort by multiple columns in DataFrame.sort_index (GH #92, PR #362)
- Add fast get_value and put_value methods to DataFrame and micro-performance tweaks (GH #360)
- Add cov instance methods to Series and DataFrame (GH #194, PR #362)
- Add bar plot option to DataFrame.plot (PR #348)
- Add idxmin and idxmax functions to Series and DataFrame for computing index labels achieving maximum and minimum values (PR #286)
- Add read_clipboard function for parsing DataFrame from OS clipboard, should work across platforms (GH #300)
- Add nunique function to Series for counting unique elements (GH #297)
- DataFrame constructor will use Series name if no columns passed (GH #373)
- Support regular expressions and longer delimiters in read_table/read_csv, but does not handle quoted strings yet (GH #364)
- Add DataFrame.to_html for formatting DataFrame to HTML (PR #387)
- MaskedArray can be passed to DataFrame constructor and masked values will be converted to NaN (PR #396)
- Add DataFrame.boxplot function (GH #368, others)
- Can pass extra args, kwds to DataFrame.apply (GH #376)
Improvements to existing features
- Raise more helpful exception if date parsing fails in DateRange (GH #298)
- Vastly improved performance of GroupBy on axes with a MultiIndex (GH #299)
- Print level names in hierarchical index in Series repr (GH #305)
- Return DataFrame when performing GroupBy on selected column and as_index=False (GH #308)
- Can pass vector to on argument in DataFrame.join (GH #312)
- Don't show Series name if it's None in the repr, also omit length for short Series (GH #317)
- Show legend by default in DataFrame.plot, add legend boolean flag (GH #324)
- Significantly improved performance of Series.order, which also makes np.unique called on a Series faster (GH #327)
- Faster cythonized count by level in Series and DataFrame (GH #341)
- Raise exception if dateutil 2.0 installed on Python 2.x runtime (GH #346)
- Significant GroupBy performance enhancement with multiple keys with many "empty" combinations
- New Cython vectorized function map_infer speeds up Series.apply and Series.map significantly when passed elementwise Python function, motivated by PR #355
- Cythonized cache_readonly, resulting in substantial micro-performance enhancements throughout the codebase (GH #361)
- Special Cython matrix iterator for applying arbitrary reduction operations with 3-5x better performance than np.apply_along_axis (GH #309)
- Add raw option to DataFrame.apply for getting better performance when the passed function only requires an ndarray (GH #309)
- Improve performance of MultiIndex.from_tuples
- Can pass multiple levels to stack and unstack (GH #370)
- Can pass multiple values columns to pivot_table (GH #381)
- Can call DataFrame.delevel with standard Index with name set (GH #393)
- Use Series name in GroupBy for result index (GH #363)
- Refactor Series/DataFrame stat methods to use common set of NaN-friendly function
- Handle NumPy scalar integers at C level in Cython conversion routines
Bug fixes
- Fix bug in DataFrame.to_csv when writing a DataFrame with an index name (GH #290)
- DataFrame should clear its Series caches on consolidation, was causing "stale" Series to be returned in some corner cases (GH #304)
- DataFrame constructor failed if a column had a list of tuples (GH #293)
- Ensure that Series.apply always returns a Series and implement Series.round (GH #314)
- Support boolean columns in Cythonized groupby functions (GH #315)
- DataFrame.describe should not fail if there are no numeric columns, instead return categorical describe (GH #323)
- Fixed bug which could cause columns to be printed in wrong order in DataFrame.to_string if specific list of columns passed (GH #325)
- Fix legend plotting failure if DataFrame columns are integers (GH #326)
- Shift start date back by one month for Yahoo! Finance API in pandas.io.data (GH #329)
- Fix DataFrame.join failure on unconsolidated inputs (GH #331)
- DataFrame.min/max will no longer fail on mixed-type DataFrame (GH #337)
- Fix read_csv / read_table failure when passing list to index_col that is not in ascending order (GH #349)
- Fix failure passing Int64Index to Index.union when both are monotonic
- Fix error when passing SparseSeries to (dense) DataFrame constructor
- Added missing bang at top of setup.py (GH #352)
- Change is_monotonic on MultiIndex so it properly compares the tuples
- Fix MultiIndex outer join logic (GH #351)
- Set index name attribute with single-key groupby (GH #358)
- Bug fix in reflexive binary addition in Series and DataFrame for non-commutative operations (like string concatenation) (GH #353)
- setupegg.py will invoke Cython (GH #192)
- Fix block consolidation bug after inserting column into MultiIndex (GH #366)
- Fix bug in join operations between Index and Int64Index (GH #367)
- Handle min_periods=0 case in moving window functions (GH #365)
- Fixed corner cases in DataFrame.apply/pivot with empty DataFrame (GH #378)
- Fixed repr exception when Series name is a tuple
- Always return DateRange from asfreq (GH #390)
- Pass level names to swaplavel (GH #379)
- Don't lose index names in MultiIndex.droplevel (GH #394)
- Infer more proper return type in DataFrame.apply when no columns or rows depending on whether the passed function is a reduction (GH #389)
- Always return NA/NaN from Series.min/max and DataFrame.min/max when all of a row/column/values are NA (GH #384)
- Enable partial setting with .ix / advanced indexing (GH #397)
- Handle mixed-type DataFrames correctly in unstack, do not lose type information (GH #403)
- Fix integer name formatting bug in Index.format and in Series.__repr__
- Handle label types other than string passed to groupby (GH #405)
- Fix bug in .ix-based indexing with partial retrieval when a label is not contained in a level
- Index name was not being pickled (GH #408)
- Level name should be passed to result index in GroupBy.apply (GH #416)
- Craig Austin
- Marius Cobzarenco
- Joel Cross
- Jeff Hammerbacher
- Adam Klein
- Thomas Kluyver
- Jev Kuznetsov
- Kieran O'Mahony
- Wouter Overmeire
- Nathan Pinger
- Christian Prinoth
- Skipper Seabold
- Chang She
- Ted Square
- Aman Thakral
- Chris Uga
- Dieter Vandenbussche
- carljv
- rsamson
Release date: 10/24/2011
This release of pandas includes a number of API changes (see below) and cleanup of deprecated APIs from pre-0.4.0 releases. There are also bug fixes, new features, numerous significant performance enhancements, and includes a new IPython completer hook to enable tab completion of DataFrame columns accesses as attributes (a new feature).
In addition to the changes listed here from 0.4.3 to 0.5.0, the minor releases 0.4.1, 0.4.2, and 0.4.3 brought some significant new functionality and performance improvements that are worth taking a look at.
Thanks to all for bug reports, contributed patches and generally providing feedback on the library.
API Changes
- read_table, read_csv, and ExcelFile.parse default arguments for index_col is now None. To use one or more of the columns as the resulting DataFrame's index, these must be explicitly specified now
- Parsing functions like read_csv no longer parse dates by default (GH #225)
- Removed weights option in panel regression which was not doing anything principled (GH #155)
- Changed buffer argument name in Series.to_string to buf
- Series.to_string and DataFrame.to_string now return strings by default instead of printing to sys.stdout
- Deprecated nanRep argument in various to_string and to_csv functions in favor of na_rep. Will be removed in 0.6 (GH #275)
- Renamed delimiter to sep in DataFrame.from_csv for consistency
- Changed order of Series.clip arguments to match those of numpy.clip and added (unimplemented) out argument so numpy.clip can be called on a Series (GH #272)
- Series functions renamed (and thus deprecated) in 0.4 series have been removed:
- asOf, use asof
- toDict, use to_dict
- toString, use to_string
- toCSV, use to_csv
- merge, use map
- applymap, use apply
- combineFirst, use combine_first
- _firstTimeWithValue use first_valid_index
- _lastTimeWithValue use last_valid_index
- DataFrame functions renamed / deprecated in 0.4 series have been removed:
- asMatrix method, use as_matrix or values attribute
- combineFirst, use combine_first
- getXS, use xs
- merge, use join
- fromRecords, use from_records
- fromcsv, use from_csv
- toRecords, use to_records
- toDict, use to_dict
- toString, use to_string
- toCSV, use to_csv
- _firstTimeWithValue use first_valid_index
- _lastTimeWithValue use last_valid_index
- toDataMatrix is no longer needed
- rows() method, use index attribute
- cols() method, use columns attribute
- dropEmptyRows(), use dropna(how='all')
- dropIncompleteRows(), use dropna()
- tapply(f), use apply(f, axis=1)
- tgroupby(keyfunc, aggfunc), use groupby with axis=1
- Other outstanding deprecations have been removed:
- indexField argument in DataFrame.from_records
- missingAtEnd argument in Series.order. Use na_last instead
- Series.fromValue classmethod, use regular Series constructor instead
- Functions parseCSV, parseText, and parseExcel methods in pandas.io.parsers have been removed
- Index.asOfDate function
- Panel.getMinorXS (use minor_xs) and Panel.getMajorXS (use major_xs)
- Panel.toWide, use Panel.to_wide instead
New features / modules
- Added DataFrame.align method with standard join options
- Added parse_dates option to read_csv and read_table methods to optionally try to parse dates in the index columns
- Add nrows, chunksize, and iterator arguments to read_csv and read_table. The last two return a new TextParser class capable of lazily iterating through chunks of a flat file (GH #242)
- Added ability to join on multiple columns in DataFrame.join (GH #214)
- Added private _get_duplicates function to Index for identifying duplicate values more easily
- Added column attribute access to DataFrame, e.g. df.A equivalent to df['A'] if 'A' is a column in the DataFrame (PR #213)
- Added IPython tab completion hook for DataFrame columns. (PR #233, GH #230)
- Implement Series.describe for Series containing objects (PR #241)
- Add inner join option to DataFrame.join when joining on key(s) (GH #248)
- Can select set of DataFrame columns by passing a list to __getitem__ (GH #253)
- Can use & and | to intersection / union Index objects, respectively (GH #261)
- Added pivot_table convenience function to pandas namespace (GH #234)
- Implemented Panel.rename_axis function (GH #243)
- DataFrame will show index level names in console output
- Implemented Panel.take
- Add set_eng_float_format function for setting alternate DataFrame floating point string formatting
- Add convenience set_index function for creating a DataFrame index from its existing columns
Improvements to existing features
- Major performance improvements in file parsing functions read_csv and read_table
- Added Cython function for converting tuples to ndarray very fast. Speeds up many MultiIndex-related operations
- File parsing functions like read_csv and read_table will explicitly check if a parsed index has duplicates and raise a more helpful exception rather than deferring the check until later
- Refactored merging / joining code into a tidy class and disabled unnecessary computations in the float/object case, thus getting about 10% better performance (GH #211)
- Improved speed of DataFrame.xs on mixed-type DataFrame objects by about 5x, regression from 0.3.0 (GH #215)
- With new DataFrame.align method, speeding up binary operations between differently-indexed DataFrame objects by 10-25%.
- Significantly sped up conversion of nested dict into DataFrame (GH #212)
- Can pass hierarchical index level name to groupby instead of the level number if desired (GH #223)
- Add support for different delimiters in DataFrame.to_csv (PR #244)
- Add more helpful error message when importing pandas post-installation from the source directory (GH #250)
- Significantly speed up DataFrame __repr__ and count on large mixed-type DataFrame objects
- Better handling of pyx file dependencies in Cython module build (GH #271)
Bug fixes
read_csv / read_table fixes - Be less aggressive about converting float->int in cases of floating point
representations of integers like 1.0, 2.0, etc.
- "True"/"False" will not get correctly converted to boolean
- Index name attribute will get set when specifying an index column
- Passing column names should force header=None (GH #257)
- Don't modify passed column names when index_col is not None (GH #258)
- Can sniff CSV separator in zip file (since seek is not supported, was failing before)
Worked around matplotlib "bug" in which series[:, np.newaxis] fails. Should be reported upstream to matplotlib (GH #224)
DataFrame.iteritems was not returning Series with the name attribute set. Also neither was DataFrame._series
Can store datetime.date objects in HDFStore (GH #231)
Index and Series names are now stored in HDFStore
Fixed problem in which data would get upcasted to object dtype in GroupBy.apply operations (GH #237)
Fixed outer join bug with empty DataFrame (GH #238)
Can create empty Panel (GH #239)
Fix join on single key when passing list with 1 entry (GH #246)
Don't raise Exception on plotting DataFrame with an all-NA column (GH #251, PR #254)
Bug min/max errors when called on integer DataFrames (PR #241)
DataFrame.iteritems and DataFrame._series not assigning name attribute
Panel.__repr__ raised exception on length-0 major/minor axes
DataFrame.join on key with empty DataFrame produced incorrect columns
Implemented MultiIndex.diff (GH #260)
Int64Index.take and MultiIndex.take lost name field, fix downstream issue GH #262
Can pass list of tuples to Series (GH #270)
Can pass level name to DataFrame.stack
Support set operations between MultiIndex and Index
Fix many corner cases in MultiIndex set operations - Fix MultiIndex-handling bug with GroupBy.apply when returned groups are not indexed the same
Fix corner case bugs in DataFrame.apply
Setting DataFrame index did not cause Series cache to get cleared
Various int32 -> int64 platform-specific issues
Don't be too aggressive converting to integer when parsing file with MultiIndex (GH #285)
Fix bug when slicing Series with negative indices before beginning
- Thomas Kluyver
- Daniel Fortunov
- Aman Thakral
- Luca Beltrame
- Wouter Overmeire
Release date: 10/9/2011
This is largely a bugfix release from 0.4.2 but also includes a handful of new and enhanced features. Also, pandas can now be installed and used on Python 3 (thanks Thomas Kluyver!).
New features / modules
- Python 3 support using 2to3 (PR #200, Thomas Kluyver)
- Add name attribute to Series and added relevant logic and tests. Name now prints as part of Series.__repr__
- Add name attribute to standard Index so that stacking / unstacking does not discard names and so that indexed DataFrame objects can be reliably round-tripped to flat files, pickle, HDF5, etc.
- Add isnull and notnull as instance methods on Series (PR #209, GH #203)
Improvements to existing features
- Skip xlrd-related unit tests if not installed
- Index.append and MultiIndex.append can accept a list of Index objects to concatenate together
- Altered binary operations on differently-indexed SparseSeries objects to use the integer-based (dense) alignment logic which is faster with a larger number of blocks (GH #205)
- Refactored Series.__repr__ to be a bit more clean and consistent
API Changes
- Series.describe and DataFrame.describe now bring the 25% and 75% quartiles instead of the 10% and 90% deciles. The other outputs have not changed
- Series.toString will print deprecation warning, has been de-camelCased to to_string
Bug fixes
- Fix broken interaction between Index and Int64Index when calling intersection. Implement Int64Index.intersection
- MultiIndex.sortlevel discarded the level names (GH #202)
- Fix bugs in groupby, join, and append due to improper concatenation of MultiIndex objects (GH #201)
- Fix regression from 0.4.1, isnull and notnull ceased to work on other kinds of Python scalar objects like datetime.datetime
- Raise more helpful exception when attempting to write empty DataFrame or LongPanel to HDFStore (GH #204)
- Use stdlib csv module to properly escape strings with commas in DataFrame.to_csv (PR #206, Thomas Kluyver)
- Fix Python ndarray access in Cython code for sparse blocked index integrity check
- Fix bug writing Series to CSV in Python 3 (PR #209)
- Miscellaneous Python 3 bugfixes
- Thomas Kluyver
- rsamson
Release date: 10/3/2011
This is a performance optimization release with several bug fixes. The new Int64Index and new merging / joining Cython code and related Python infrastructure are the main new additions
New features / modules
- Added fast Int64Index type with specialized join, union, intersection. Will result in significant performance enhancements for int64-based time series (e.g. using NumPy's datetime64 one day) and also faster operations on DataFrame objects storing record array-like data.
- Refactored Index classes to have a join method and associated data alignment routines throughout the codebase to be able to leverage optimized joining / merging routines.
- Added Series.align method for aligning two series with choice of join method
- Wrote faster Cython data alignment / merging routines resulting in substantial speed increases
- Added is_monotonic property to Index classes with associated Cython code to evaluate the monotonicity of the Index values
- Add method get_level_values to MultiIndex
- Implemented shallow copy of BlockManager object in DataFrame internals
Improvements to existing features
- Improved performance of isnull and notnull, a regression from v0.3.0 (GH #187)
- Wrote templating / code generation script to auto-generate Cython code for various functions which need to be available for the 4 major data types used in pandas (float64, bool, object, int64)
- Refactored code related to DataFrame.join so that intermediate aligned copies of the data in each DataFrame argument do not need to be created. Substantial performance increases result (GH #176)
- Substantially improved performance of generic Index.intersection and Index.union
- Improved performance of DateRange.union with overlapping ranges and non-cacheable offsets (like Minute). Implemented analogous fast DateRange.intersection for overlapping ranges.
- Implemented BlockManager.take resulting in significantly faster take performance on mixed-type DataFrame objects (GH #104)
- Improved performance of Series.sort_index
- Significant groupby performance enhancement: removed unnecessary integrity checks in DataFrame internals that were slowing down slicing operations to retrieve groups
- Added informative Exception when passing dict to DataFrame groupby aggregation with axis != 0
API Changes
None
Bug fixes
- Fixed minor unhandled exception in Cython code implementing fast groupby aggregation operations
- Fixed bug in unstacking code manifesting with more than 3 hierarchical levels
- Throw exception when step specified in label-based slice (GH #185)
- Fix isnull to correctly work with np.float32. Fix upstream bug described in GH #182
- Finish implementation of as_index=False in groupby for DataFrame aggregation (GH #181)
- Raise SkipTest for pre-epoch HDFStore failure. Real fix will be sorted out via datetime64 dtype
- Uri Laserson
- Scott Sinclair
Release date: 9/25/2011
This is primarily a bug fix release but includes some new features and improvements
New features / modules
- Added new DataFrame methods get_dtype_counts and property dtypes
- Setting of values using
.ix
indexing attribute in mixed-type DataFrame objects has been implemented (fixes GH #135)- read_csv can read multiple columns into a MultiIndex. DataFrame's to_csv method will properly write out a MultiIndex which can be read back (PR #151, thanks to Skipper Seabold)
- Wrote fast time series merging / joining methods in Cython. Will be integrated later into DataFrame.join and related functions
- Added ignore_index option to DataFrame.append for combining unindexed records stored in a DataFrame
Improvements to existing features
- Some speed enhancements with internal Index type-checking function
- DataFrame.rename has a new copy parameter which can rename a DataFrame in place
- Enable unstacking by level name (PR #142)
- Enable sortlevel to work by level name (PR #141)
- read_csv can automatically "sniff" other kinds of delimiters using csv.Sniffer (PR #146)
- Improved speed of unit test suite by about 40%
- Exception will not be raised calling HDFStore.remove on non-existent node with where clause
- Optimized _ensure_index function resulting in performance savings in type-checking Index objects
API Changes
None
Bug fixes
- Fixed DataFrame constructor bug causing downstream problems (e.g. .copy() failing) when passing a Series as the values along with a column name and index
- Fixed single-key groupby on DataFrame with as_index=False (GH #160)
- Series.shift was failing on integer Series (GH #154)
- unstack methods were producing incorrect output in the case of duplicate hierarchical labels. An exception will now be raised (GH #147)
- Calling count with level argument caused reduceat failure or segfault in earlier NumPy (GH #169)
- Fixed DataFrame.corrwith to automatically exclude non-numeric data (GH #144)
- Unicode handling bug fixes in DataFrame.to_string (GH #138)
- Excluding OLS degenerate unit test case that was causing platform specific failure (GH #149)
- Skip blosc-dependent unit tests for PyTables < 2.2 (PR #137)
- Calling copy on DateRange did not copy over attributes to the new object (GH #168)
- Fix bug in HDFStore in which Panel data could be appended to a Table with different item order, thus resulting in an incorrect result read back
- Yaroslav Halchenko
- Jeff Reback
- Skipper Seabold
- Dan Lovell
- Nick Pentreath
Release date: 9/12/2011
New features / modules
- pandas.core.sparse module: "Sparse" (mostly-NA, or some other fill value) versions of Series, DataFrame, and Panel. For low-density data, this will result in significant performance boosts, and smaller memory footprint. Added to_sparse methods to Series, DataFrame, and Panel. See online documentation for more on these
- Fancy indexing operator on Series / DataFrame, e.g. via .ix operator. Both getting and setting of values is supported; however, setting values will only currently work on homogeneously-typed DataFrame objects. Things like:
- series.ix[[d1, d2, d3]]
- frame.ix[5:10, ['C', 'B', 'A']], frame.ix[5:10, 'A':'C']
- frame.ix[date1:date2]
- Significantly enhanced groupby functionality
- Can groupby multiple keys, e.g. df.groupby(['key1', 'key2']). Iteration with multiple groupings products a flattened tuple
- "Nuisance" columns (non-aggregatable) will automatically be excluded from DataFrame aggregation operations
- Added automatic "dispatching to Series / DataFrame methods to more easily invoke methods on groups. e.g. s.groupby(crit).std() will work even though std is not implemented on the GroupBy class
- Hierarchical / multi-level indexing
- New the MultiIndex class. Integrated MultiIndex into Series and DataFrame fancy indexing, slicing, __getitem__ and __setitem, reindexing, etc. Added level keyword argument to groupby to enable grouping by a level of a MultiIndex
- New data reshaping functions: stack and unstack on DataFrame and Series
- Integrate with MultiIndex to enable sophisticated reshaping of data
- Index objects (labels for axes) are now capable of holding tuples
- Series.describe, DataFrame.describe: produces an R-like table of summary statistics about each data column
- DataFrame.quantile, Series.quantile for computing sample quantiles of data across requested axis
- Added general DataFrame.dropna method to replace dropIncompleteRows and dropEmptyRows, deprecated those.
- Series arithmetic methods with optional fill_value for missing data, e.g. a.add(b, fill_value=0). If a location is missing for both it will still be missing in the result though.
- fill_value option has been added to DataFrame.{add, mul, sub, div} methods similar to Series
- Boolean indexing with DataFrame objects: data[data > 0.1] = 0.1 or data[data> other] = 1.
- pytz / tzinfo support in DateRange
- tz_localize, tz_normalize, and tz_validate methods added
- Added ExcelFile class to pandas.io.parsers for parsing multiple sheets out of a single Excel 2003 document
- GroupBy aggregations can now optionally broadcast, e.g. produce an object of the same size with the aggregated value propagated
- Added select function in all data structures: reindex axis based on arbitrary criterion (function returning boolean value), e.g. frame.select(lambda x: 'foo' in x, axis=1)
- DataFrame.consolidate method, API function relating to redesigned internals
- DataFrame.insert method for inserting column at a specified location rather than the default __setitem__ behavior (which puts it at the end)
- HDFStore class in pandas.io.pytables has been largely rewritten using patches from Jeff Reback from others. It now supports mixed-type DataFrame and Series data and can store Panel objects. It also has the option to query DataFrame and Panel data. Loading data from legacy HDFStore files is supported explicitly in the code
- Added set_printoptions method to modify appearance of DataFrame tabular output
- rolling_quantile functions; a moving version of Series.quantile / DataFrame.quantile
- Generic rolling_apply moving window function
- New drop method added to Series, DataFrame, etc. which can drop a set of labels from an axis, producing a new object
- reindex methods now sport a copy option so that data is not forced to be copied then the resulting object is indexed the same
- Added sort_index methods to Series and Panel. Renamed DataFrame.sort to sort_index. Leaving DataFrame.sort for now.
- Added
skipna
option to statistical instance methods on all the data structures- pandas.io.data module providing a consistent interface for reading time series data from several different sources
Improvements to existing features
- The 2-dimensional DataFrame and DataMatrix classes have been extensively redesigned internally into a single class DataFrame, preserving where possible their optimal performance characteristics. This should reduce confusion from users about which class to use.
- Note that under the hood there is a new essentially "lazy evaluation" scheme within respect to adding columns to DataFrame. During some operations, like-typed blocks will be "consolidated" but not before.
- DataFrame accessing columns repeatedly is now significantly faster than DataMatrix used to be in 0.3.0 due to an internal Series caching mechanism (which are all views on the underlying data)
- Column ordering for mixed type data is now completely consistent in DataFrame. In prior releases, there was inconsistent column ordering in DataMatrix
- Improved console / string formatting of DataMatrix with negative numbers
- Improved tabular data parsing functions, read_table and read_csv:
- Added skiprows and na_values arguments to pandas.io.parsers functions for more flexible IO
- parseCSV / read_csv functions and others in pandas.io.parsers now can take a list of custom NA values, and also a list of rows to skip
- Can slice DataFrame and get a view of the data (when homogeneously typed), e.g. frame.xs(idx, copy=False) or frame.ix[idx]
- Many speed optimizations throughout Series and DataFrame
- Eager evaluation of groups when calling
groupby
functions, so if there is an exception with the grouping function it will raised immediately versus sometime later on when the groups are needed- datetools.WeekOfMonth offset can be parameterized with n different than 1 or -1.
- Statistical methods on DataFrame like mean, std, var, skew will now ignore non-numerical data. Before a not very useful error message was generated. A flag numeric_only has been added to DataFrame.sum and DataFrame.count to enable this behavior in those methods if so desired (disabled by default)
- DataFrame.pivot generalized to enable pivoting multiple columns into a DataFrame with hierarchical columns
- DataFrame constructor can accept structured / record arrays
- Panel constructor can accept a dict of DataFrame-like objects. Do not need to use from_dict anymore (from_dict is there to stay, though).
API Changes
- The DataMatrix variable now refers to DataFrame, will be removed within two releases
- WidePanel is now known as Panel. The WidePanel variable in the pandas namespace now refers to the renamed Panel class
- LongPanel and Panel / WidePanel now no longer have a common subclass. LongPanel is now a subclass of DataFrame having a number of additional methods and a hierarchical index instead of the old LongPanelIndex object, which has been removed. Legacy LongPanel pickles may not load properly
- Cython is now required to build pandas from a development branch. This was done to avoid continuing to check in cythonized C files into source control. Builds from released source distributions will not require Cython
- Cython code has been moved up to a top level pandas/src directory. Cython extension modules have been renamed and promoted from the lib subpackage to the top level, i.e.
- pandas.lib.tseries -> pandas._tseries
- pandas.lib.sparse -> pandas._sparse
- DataFrame pickling format has changed. Backwards compatibility for legacy pickles is provided, but it's recommended to consider PyTables-based HDFStore for storing data with a longer expected shelf life
- A copy argument has been added to the DataFrame constructor to avoid unnecessary copying of data. Data is no longer copied by default when passed into the constructor
- Handling of boolean dtype in DataFrame has been improved to support storage of boolean data with NA / NaN values. Before it was being converted to float64 so this should not (in theory) cause API breakage
- To optimize performance, Index objects now only check that their labels are unique when uniqueness matters (i.e. when someone goes to perform a lookup). This is a potentially dangerous tradeoff, but will lead to much better performance in many places (like groupby).
- Boolean indexing using Series must now have the same indices (labels)
- Backwards compatibility support for begin/end/nPeriods keyword arguments in DateRange class has been removed
- More intuitive / shorter filling aliases ffill (for pad) and bfill (for backfill) have been added to the functions that use them: reindex, asfreq, fillna.
- pandas.core.mixins code moved to pandas.core.generic
- buffer keyword arguments (e.g. DataFrame.toString) renamed to buf to avoid using Python built-in name
- DataFrame.rows() removed (use DataFrame.index)
- Added deprecation warning to DataFrame.cols(), to be removed in next release
- DataFrame deprecations and de-camelCasing: merge, asMatrix, toDataMatrix, _firstTimeWithValue, _lastTimeWithValue, toRecords, fromRecords, tgroupby, toString
- pandas.io.parsers method deprecations
- parseCSV is now read_csv and keyword arguments have been de-camelCased
- parseText is now read_table
- parseExcel is replaced by the ExcelFile class and its parse method
- fillMethod arguments (deprecated in prior release) removed, should be replaced with method
- Series.fill, DataFrame.fill, and Panel.fill removed, use fillna instead
- groupby functions now exclude NA / NaN values from the list of groups. This matches R behavior with NAs in factors e.g. with the tapply function
- Removed parseText, parseCSV and parseExcel from pandas namespace
- Series.combineFunc renamed to Series.combine and made a bit more general with a fill_value keyword argument defaulting to NaN
- Removed pandas.core.pytools module. Code has been moved to pandas.core.common
- Tacked on groupName attribute for groups in GroupBy renamed to name
- Panel/LongPanel dims attribute renamed to shape to be more conformant
- Slicing a Series returns a view now
- More Series deprecations / renaming: toCSV to to_csv, asOf to asof, merge to map, applymap to apply, toDict to to_dict, combineFirst to combine_first. Will print FutureWarning.
- DataFrame.to_csv does not write an "index" column label by default anymore since the output file can be read back without it. However, there is a new
index_label
argument. So you can doindex_label='index'
to emulate the old behavior- datetools.Week argument renamed from dayOfWeek to weekday
- timeRule argument in shift has been deprecated in favor of using the offset argument for everything. So you can still pass a time rule string to offset
- Added optional encoding argument to read_csv, read_table, to_csv, from_csv to handle unicode in python 2.x
Bug fixes
- Column ordering in pandas.io.parsers.parseCSV will match CSV in the presence of mixed-type data
- Fixed handling of Excel 2003 dates in pandas.io.parsers
- DateRange caching was happening with high resolution DateOffset objects, e.g. DateOffset(seconds=1). This has been fixed
- Fixed __truediv__ issue in DataFrame
- Fixed DataFrame.toCSV bug preventing IO round trips in some cases
- Fixed bug in Series.plot causing matplotlib to barf in exceptional cases
- Disabled Index objects from being hashable, like ndarrays
- Added __ne__ implementation to Index so that operations like ts[ts != idx] will work
- Added __ne__ implementation to DataFrame
- Bug / unintuitive result when calling fillna on unordered labels
- Bug calling sum on boolean DataFrame
- Bug fix when creating a DataFrame from a dict with scalar values
- Series.{sum, mean, std, ...} now return NA/NaN when the whole Series is NA
- NumPy 1.4 through 1.6 compatibility fixes
- Fixed bug in bias correction in rolling_cov, was affecting rolling_corr too
- R-square value was incorrect in the presence of fixed and time effects in the PanelOLS classes
- HDFStore can handle duplicates in table format, will take
- Joon Ro
- Michael Pennington
- Chris Uga
- Chris Withers
- Jeff Reback
- Ted Square
- Craig Austin
- William Ferreira
- Daniel Fortunov
- Tony Roberts
- Martin Felder
- John Marino
- Tim McNamara
- Justin Berka
- Dieter Vandenbussche
- Shane Conway
- Skipper Seabold
- Chris Jordan-Squire
This major release of pandas represents approximately 1 year of continuous development work and brings with it many new features, bug fixes, speed enhancements, and general quality-of-life improvements. The most significant change from the 0.2 release has been the completion of a rigorous unit test suite covering all of the core functionality.
Release date: February 20, 2011
New features / modules
- DataFrame / DataMatrix classes
- corrwith function to compute column- or row-wise correlations between two objects
- Can boolean-index DataFrame objects, e.g. df[df > 2] = 2, px[px > last_px] = 0
- Added comparison magic methods (__lt__, __gt__, etc.)
- Flexible explicit arithmetic methods (add, mul, sub, div, etc.)
- Added reindex_like method
- WidePanel
- Added reindex_like method
pandas.io: IO utilities
- pandas.io.sql module
- Convenience functions for accessing SQL-like databases
- pandas.io.pytables module
- Added (still experimental) HDFStore class for storing pandas data structures using HDF5 / PyTables
- pandas.io.sql module
pandas.core.datetools
- Added WeekOfMonth date offset
pandas.rpy (experimental) module created, provide some interfacing / conversion between rpy2 and pandas
Improvements
- Unit test coverage: 100% line coverage of core data structures
- Speed enhancement to rolling_{median, max, min}
- Column ordering between DataFrame and DataMatrix is now consistent: before DataFrame would not respect column order
- Improved {Series, DataFrame}.plot methods to be more flexible (can pass matplotlib Axis arguments, plot DataFrame columns in multiple subplots, etc.)
API Changes
- Exponentially-weighted moment functions in pandas.stats.moments have a more consistent API and accept a min_periods argument like their regular moving counterparts.
- fillMethod argument in Series, DataFrame changed to method, FutureWarning added.
- fill method in Series, DataFrame/DataMatrix, WidePanel renamed to fillna, FutureWarning added to fill
- Renamed DataFrame.getXS to xs, FutureWarning added
- Removed cap and floor functions from DataFrame, renamed to clip_upper and clip_lower for consistency with NumPy
Bug fixes
- Fixed bug in IndexableSkiplist Cython code that was breaking rolling_max function
- Numerous numpy.int64-related indexing fixes
- Several NumPy 1.4.0 NaN-handling fixes
- Bug fixes to pandas.io.parsers.parseCSV
- Fixed DateRange caching issue with unusual date offsets
- Fixed bug in DateRange.union
- Fixed corner case in IndexableSkiplist implementation