pandas: powerful Python data analysis toolkit

2017 Pages·2016·8.65 MB·English

pandas: powerful Python data analysis
toolkit
Release 0.20.3
Wes McKinney & PyData Development Team
Jul 07, 2017

CONTENTS
1 What’sNew 3
1.1 v0.20.3(July7,2017) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1.1 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1.1.1 Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1.1.2 Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.1.3 I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.1.4 Plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.1.5 Reshaping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1.1.6 Categorical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2 v0.20.2(June4,2017) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2.1 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2.2 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2.3 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2.3.1 Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2.3.2 Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2.3.3 I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2.3.4 Plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.2.3.5 Groupby/Resample/Rolling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.3.6 Sparse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.3.7 Reshaping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.3.8 Numeric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.3.9 Categorical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.3.10 Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.3 v0.20.1(May5,2017) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.3.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3.1.1 aggAPIforDataFrame/Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3.1.2 dtypekeywordfordataIO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.3.1.3 .to_datetime()hasgainedanoriginparameter . . . . . . . . . . . . . . . 12
1.3.1.4 GroupbyEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.3.1.5 BettersupportforcompressedURLsinread_csv . . . . . . . . . . . . . . . . . 13
1.3.1.6 PicklefileI/Onowsupportscompression . . . . . . . . . . . . . . . . . . . . . . . 13
1.3.1.7 UInt64SupportImproved . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.3.1.8 GroupByonCategoricals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.3.1.9 TableSchemaOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
1.3.1.10 SciPysparsematrixfrom/toSparseDataFrame . . . . . . . . . . . . . . . . . . . . 17
1.3.1.11 ExceloutputforstyledDataFrames . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.3.1.12 IntervalIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
1.3.1.13 OtherEnhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
1.3.2 BackwardsincompatibleAPIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
1.3.2.1 PossibleincompatibilityforHDF5formatscreatedwithpandas<0.13.0 . . . . . . 22
i
1.3.2.2 MaponIndextypesnowreturnotherIndextypes . . . . . . . . . . . . . . . . . . 23
1.3.2.3 AccessingdatetimefieldsofIndexnowreturnIndex . . . . . . . . . . . . . . . . . 24
1.3.2.4 pd.uniquewillnowbeconsistentwithextensiontypes . . . . . . . . . . . . . . . . 25
1.3.2.5 S3FileHandling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
1.3.2.6 PartialStringIndexingChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
1.3.2.7 Concatofdifferentfloatdtypeswillnotautomaticallyupcast . . . . . . . . . . . . 27
1.3.2.8 PandasGoogleBigQuerysupporthasmoved . . . . . . . . . . . . . . . . . . . . . 27
1.3.2.9 MemoryUsageforIndexismoreAccurate . . . . . . . . . . . . . . . . . . . . . . 27
1.3.2.10 DataFrame.sort_indexchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
1.3.2.11 GroupbyDescribeFormatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
1.3.2.12 WindowBinaryCorr/CovoperationsreturnaMultiIndexDataFrame . . . . . . . . 31
1.3.2.13 HDFStorewherestringcomparison . . . . . . . . . . . . . . . . . . . . . . . . . . 32
1.3.2.14 Index.intersectionandinnerjoinnowpreservetheorderoftheleftIndex . . . . . . 32
1.3.2.15 PivotTablealwaysreturnsaDataFrame . . . . . . . . . . . . . . . . . . . . . . . 33
1.3.2.16 OtherAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
1.3.3 Reorganizationofthelibrary: PrivacyChanges . . . . . . . . . . . . . . . . . . . . . . . . 35
1.3.3.1 ModulesPrivacyHasChanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
1.3.3.2 pandas.errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
1.3.3.3 pandas.testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.3.3.4 pandas.plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.3.3.5 OtherDevelopmentChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.3.4 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.3.4.1 Deprecate.ix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.3.4.2 DeprecatePanel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.3.4.3 Deprecategroupby.agg()withadictionarywhenrenaming . . . . . . . . . . . . . 39
1.3.4.4 Deprecate.plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
1.3.4.5 OtherDeprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
1.3.5 Removalofpriorversiondeprecations/changes . . . . . . . . . . . . . . . . . . . . . . . . 42
1.3.6 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.3.7 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.3.7.1 Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.3.7.2 Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
1.3.7.3 I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
1.3.7.4 Plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
1.3.7.5 Groupby/Resample/Rolling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
1.3.7.6 Sparse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
1.3.7.7 Reshaping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
1.3.7.8 Numeric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
1.3.7.9 Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
1.4 v0.19.2(December24,2016) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
1.4.1 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
1.4.2 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
1.4.3 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
1.5 v0.19.1(November3,2016) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
1.5.1 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
1.5.2 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
1.6 v0.19.0(October2,2016) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
1.6.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
1.6.1.1 merge_asofforasof-styletime-seriesjoining . . . . . . . . . . . . . . . . . . . 53
1.6.1.2 .rolling()isnowtime-seriesaware . . . . . . . . . . . . . . . . . . . . . . . 56
1.6.1.3 read_csvhasimprovedsupportforduplicatecolumnnames . . . . . . . . . . . 58
1.6.1.4 read_csvsupportsparsingCategoricaldirectly . . . . . . . . . . . . . . . . 58
1.6.1.5 CategoricalConcatenation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
1.6.1.6 Semi-MonthOffsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
ii
1.6.1.7 NewIndexmethods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
1.6.1.8 GoogleBigQueryEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
1.6.1.9 Fine-grainednumpyerrstate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
1.6.1.10 get_dummiesnowreturnsintegerdtypes . . . . . . . . . . . . . . . . . . . . . 62
1.6.1.11 Downcastvaluestosmallestpossibledtypeinto_numeric . . . . . . . . . . . . 63
1.6.1.12 pandasdevelopmentAPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
1.6.1.13 Otherenhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
1.6.2 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
1.6.2.1 Series.tolist()willnowreturnPythontypes . . . . . . . . . . . . . . . . . 67
1.6.2.2 Seriesoperatorsfordifferentindexes . . . . . . . . . . . . . . . . . . . . . . . 67
1.6.2.3 Seriestypepromotiononassignment . . . . . . . . . . . . . . . . . . . . . . . 70
1.6.2.4 .to_datetime()changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
1.6.2.5 Mergingchanges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
1.6.2.6 .describe()changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
1.6.2.7 Periodchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
1.6.2.8 Index+/-nolongerusedforsetoperations . . . . . . . . . . . . . . . . . . . . . 76
1.6.2.9 Index.differenceand.symmetric_differencechanges . . . . . . . . 76
1.6.2.10 Index.uniqueconsistentlyreturnsIndex . . . . . . . . . . . . . . . . . . . . 77
1.6.2.11 MultiIndexconstructors,groupbyandset_indexpreservecategoricaldtypes 77
1.6.2.12 read_csvwillprogressivelyenumeratechunks . . . . . . . . . . . . . . . . . . 79
1.6.2.13 SparseChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
1.6.2.14 Indexerdtypechanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
1.6.2.15 OtherAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
1.6.3 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
1.6.4 Removalofpriorversiondeprecations/changes . . . . . . . . . . . . . . . . . . . . . . . . 85
1.6.5 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
1.6.6 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
1.7 v0.18.1(May3,2016) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
1.7.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
1.7.1.1 CustomBusinessHour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
1.7.1.2 .groupby(..)syntaxwithwindowandresampleoperations . . . . . . . . . . . 93
1.7.1.3 Methodchaininngimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
1.7.1.4 PartialstringindexingonDateTimeIndexwhenpartofaMultiIndex . . . . 97
1.7.1.5 AssemblingDatetimes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
1.7.1.6 OtherEnhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
1.7.2 Sparsechanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
1.7.3 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
1.7.3.1 .groupby(..).nth()changes . . . . . . . . . . . . . . . . . . . . . . . . . . 101
1.7.3.2 numpyfunctioncompatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
1.7.3.3 Using.applyongroupbyresampling . . . . . . . . . . . . . . . . . . . . . . . . 103
1.7.3.4 Changesinread_csvexceptions . . . . . . . . . . . . . . . . . . . . . . . . . . 104
1.7.3.5 to_datetimeerrorchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
1.7.3.6 OtherAPIchanges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
1.7.3.7 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
1.7.4 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
1.7.5 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
1.8 v0.18.0(March13,2016) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
1.8.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
1.8.1.1 Windowfunctionsarenowmethods . . . . . . . . . . . . . . . . . . . . . . . . . 111
1.8.1.2 Changestorename . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
1.8.1.3 RangeIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
1.8.1.4 Changestostr.extract . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
1.8.1.5 Additionofstr.extractall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
1.8.1.6 Changestostr.cat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
iii
1.8.1.7 Datetimelikerounding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
1.8.1.8 FormattingofIntegersinFloatIndex . . . . . . . . . . . . . . . . . . . . . . . . . 118
1.8.1.9 Changestodtypeassignmentbehaviors . . . . . . . . . . . . . . . . . . . . . . . . 118
1.8.1.10 to_xarray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
1.8.1.11 LatexRepresentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
1.8.1.12 pd.read_sas()changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
1.8.1.13 Otherenhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
1.8.2 BackwardsincompatibleAPIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
1.8.2.1 NaTandTimedeltaoperations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
1.8.2.2 Changestomsgpack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
1.8.2.3 Signaturechangefor.rank. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
1.8.2.4 BuginQuarterBeginwithn=0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
1.8.2.5 ResampleAPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
1.8.2.6 Changestoeval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
1.8.2.7 OtherAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
1.8.2.8 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
1.8.2.9 Removalofdeprecatedfloatindexers . . . . . . . . . . . . . . . . . . . . . . . . . 133
1.8.2.10 Removalofpriorversiondeprecations/changes . . . . . . . . . . . . . . . . . . . . 135
1.8.3 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
1.8.4 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
1.9 v0.17.1(November21,2015) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
1.9.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
1.9.1.1 ConditionalHTMLFormatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
1.9.2 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
1.9.3 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
1.9.3.1 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
1.9.4 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
1.9.5 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
1.10 v0.17.0(October9,2015) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
1.10.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
1.10.1.1 DatetimewithTZ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
1.10.1.2 ReleasingtheGIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
1.10.1.3 Plotsubmethods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
1.10.1.4 Additionalmethodsfordtaccessor . . . . . . . . . . . . . . . . . . . . . . . . . 148
1.10.1.5 PeriodFrequencyEnhancement . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
1.10.1.6 SupportforSASXPORTfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
1.10.1.7 SupportforMathFunctionsin.eval() . . . . . . . . . . . . . . . . . . . . . . . . . 151
1.10.1.8 ChangestoExcelwithMultiIndex . . . . . . . . . . . . . . . . . . . . . . . . 151
1.10.1.9 GoogleBigQueryEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
1.10.1.10 DisplayAlignmentwithUnicodeEastAsianWidth . . . . . . . . . . . . . . . . . 153
1.10.1.11 Otherenhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
1.10.2 BackwardsincompatibleAPIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
1.10.2.1 ChangestosortingAPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
1.10.2.2 Changestoto_datetimeandto_timedelta . . . . . . . . . . . . . . . . . . . . . . . 158
1.10.2.3 ChangestoIndexComparisons . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
1.10.2.4 ChangestoBooleanComparisonsvs. None . . . . . . . . . . . . . . . . . . . . . 160
1.10.2.5 HDFStoredropnabehavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
1.10.2.6 Changestodisplay.precisionoption . . . . . . . . . . . . . . . . . . . . . 162
1.10.2.7 ChangestoCategorical.unique . . . . . . . . . . . . . . . . . . . . . . . . 162
1.10.2.8 ChangestoboolpassedasheaderinParsers . . . . . . . . . . . . . . . . . . . 163
1.10.2.9 OtherAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
1.10.2.10 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
1.10.2.11 Removalofpriorversiondeprecations/changes . . . . . . . . . . . . . . . . . . . . 165
1.10.3 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
iv
1.10.4 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
1.11 v0.16.2(June12,2015) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
1.11.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
1.11.1.1 Pipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
1.11.1.2 OtherEnhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
1.11.2 APIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
1.11.3 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
1.11.4 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
1.12 v0.16.1(May11,2015) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
1.12.1 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
1.12.1.1 CategoricalIndex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
1.12.1.2 Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
1.12.1.3 StringMethodsEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
1.12.1.4 OtherEnhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
1.12.2 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
1.12.2.1 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
1.12.3 IndexRepresentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
1.12.4 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
1.12.5 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
1.13 v0.16.0(March22,2015) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
1.13.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
1.13.1.1 DataFrameAssign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
1.13.1.2 Interactionwithscipy.sparse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
1.13.1.3 StringMethodsEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
1.13.1.4 Otherenhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
1.13.2 BackwardsincompatibleAPIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
1.13.2.1 ChangesinTimedelta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
1.13.2.2 IndexingChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
1.13.2.3 CategoricalChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
1.13.2.4 OtherAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
1.13.2.5 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
1.13.2.6 Removalofpriorversiondeprecations/changes . . . . . . . . . . . . . . . . . . . . 197
1.13.3 PerformanceImprovements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
1.13.4 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
1.14 v0.15.2(December12,2014) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
1.14.1 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
1.14.2 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
1.14.3 Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
1.14.4 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
1.15 v0.15.1(November9,2014) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
1.15.1 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
1.15.2 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
1.15.3 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
1.16 v0.15.0(October18,2014). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
1.16.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
1.16.1.1 CategoricalsinSeries/DataFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
1.16.1.2 TimedeltaIndex/Scalar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
1.16.1.3 MemoryUsage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
1.16.1.4 .dtaccessor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
1.16.1.5 Timezonehandlingimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . 221
1.16.1.6 Rolling/ExpandingMomentsimprovements . . . . . . . . . . . . . . . . . . . . . 222
1.16.1.7 Improvementsinthesqliomodule . . . . . . . . . . . . . . . . . . . . . . . . . . 226
1.16.2 BackwardsincompatibleAPIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
1.16.2.1 Breakingchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
v
1.16.2.2 InternalRefactoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
1.16.2.3 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
1.16.2.4 Removalofpriorversiondeprecations/changes . . . . . . . . . . . . . . . . . . . . 233
1.16.3 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
1.16.4 Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
1.16.5 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
1.17 v0.14.1(July11,2014) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
1.17.1 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
1.17.2 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
1.17.3 Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
1.17.4 Experimental . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
1.17.5 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
1.18 v0.14.0(May31,2014) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
1.18.1 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
1.18.2 DisplayChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
1.18.3 TextParsingAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
1.18.4 GroupbyAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
1.18.5 SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
1.18.6 MultiIndexingUsingSlicers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
1.18.7 Plotting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
1.18.8 PriorVersionDeprecations/Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
1.18.9 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
1.18.10 KnownIssues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
1.18.11 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
1.18.12 Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
1.18.13 Experimental . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
1.18.14 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
1.19 v0.13.1(February3,2014) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
1.19.1 OutputFormattingEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
1.19.2 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
1.19.3 PriorVersionDeprecations/Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
1.19.4 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
1.19.5 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
1.19.6 Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
1.19.7 Experimental . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
1.19.8 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
1.20 v0.13.0(January3,2014) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
1.20.1 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
1.20.2 PriorVersionDeprecations/Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
1.20.3 Deprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
1.20.4 IndexingAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
1.20.5 Float64IndexAPIChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
1.20.6 HDFStoreAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
1.20.7 DataFramereprChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
1.20.8 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
1.20.9 Experimental . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
1.20.10 InternalRefactoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
1.20.11 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
1.21 v0.12.0(July24,2013) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
1.21.1 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
1.21.2 I/OEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
1.21.3 OtherEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
1.21.4 ExperimentalFeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
1.21.5 BugFixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
vi
1.22 v0.11.0(April22,2013) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
1.22.1 SelectionChoices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
1.22.2 SelectionDeprecations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
1.22.3 Dtypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
1.22.4 DtypeConversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
1.22.5 DtypeGotchas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
1.22.6 DatetimesConversion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
1.22.7 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
1.22.8 Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
1.23 v0.10.1(January22,2013) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
1.23.1 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
1.23.2 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
1.23.3 HDFStore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
1.24 v0.10.0(December17,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
1.24.1 Fileparsingnewfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
1.24.2 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
1.24.3 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
1.24.4 WideDataFramePrinting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
1.24.5 UpdatedPyTablesSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
1.24.6 NDimensionalPanels(Experimental) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
1.25 v0.9.1(November14,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
1.25.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
1.25.2 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
1.26 v0.9.0(October7,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
1.26.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
1.26.2 APIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
1.27 v0.8.1(July22,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
1.27.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
1.27.2 Performanceimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
1.28 v0.8.0(June29,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
1.28.1 Supportfornon-uniqueindexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
1.28.2 NumPydatetime64dtypeand1.6dependency . . . . . . . . . . . . . . . . . . . . . . . . . 350
1.28.3 Timeserieschangesandimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
1.28.4 Othernewfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
1.28.5 Newplottingmethods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
1.28.6 OtherAPIchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
1.28.7 Potentialportingissuesforpandas<=0.7.3users . . . . . . . . . . . . . . . . . . . . . . . 353
1.29 v.0.7.3(April12,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
1.29.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
1.29.2 NABooleanComparisonAPIChange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
1.29.3 OtherAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
1.30 v.0.7.2(March16,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
1.30.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
1.30.2 Performanceimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
1.31 v.0.7.1(February29,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
1.31.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
1.31.2 Performanceimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
1.32 v.0.7.0(February9,2012) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
1.32.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
1.32.2 APIChangestointegerindexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
1.32.3 APItweaksregardinglabel-basedslicing . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
1.32.4 ChangestoSeries[]operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
1.32.5 OtherAPIChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
1.32.6 Performanceimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
vii
1.33 v.0.6.1(December13,2011) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
1.33.1 Newfeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
1.33.2 Performanceimprovements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
1.34 v.0.6.0(November25,2011) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
1.34.1 NewFeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
1.34.2 PerformanceEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
1.35 v.0.5.0(October24,2011) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
1.35.1 NewFeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
1.35.2 PerformanceEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
1.36 v.0.4.3throughv0.4.1(September25-October9,2011) . . . . . . . . . . . . . . . . . . . . . . . . 368
1.36.1 NewFeatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
1.36.2 PerformanceEnhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
2 Installation 371
2.1 Pythonversionsupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
2.2 Installingpandas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
2.2.1 InstallingpandaswithAnaconda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
2.2.2 InstallingpandaswithMiniconda . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
2.2.3 InstallingfromPyPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
2.2.4 InstallingusingyourLinuxdistribution’spackagemanager. . . . . . . . . . . . . . . . . . . 372
2.2.5 Installingfromsource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
2.2.6 Runningthetestsuite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
2.3 Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
2.3.1 RecommendedDependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
2.3.2 OptionalDependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
3 Contributingtopandas 377
3.1 Wheretostart? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
3.2 Bugreportsandenhancementrequests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
3.3 Workingwiththecode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
3.3.1 Versioncontrol,Git,andGitHub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
3.3.2 GettingstartedwithGit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
3.3.3 Forking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
3.3.4 Creatingabranch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
3.3.5 Creatingadevelopmentenvironment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
3.3.6 CreatingaWindowsdevelopmentenvironment . . . . . . . . . . . . . . . . . . . . . . . . 381
3.3.7 Makingchanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
3.4 Contributingtothedocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
3.4.1 Aboutthepandasdocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
3.4.2 Howtobuildthepandasdocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
3.4.2.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
3.4.2.2 Buildingthedocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
3.4.2.3 Buildingmasterbranchdocumentation . . . . . . . . . . . . . . . . . . . . . . . . 384
3.5 Contributingtothecodebase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
3.5.1 Codestandards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
3.5.1.1 C(cpplint) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
3.5.1.2 Python(PEP8) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
3.5.1.3 BackwardsCompatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
3.5.2 TestingWithContinuousIntegration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
3.5.3 Test-drivendevelopment/codewriting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
3.5.3.1 Writingtests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
3.5.3.2 Transitioningtopytest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
3.5.3.3 Usingpytest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
3.5.4 Runningthetestsuite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
viii