版本0.10.0(2012年12月17日)#
这是从0.9.1开始的一个主要版本,包括许多新功能和增强功能,以及大量的错误修复。还有一些重要的API变化,长期使用大Pandas的人应该密切关注。
文件解析新功能#
带分隔符的文件解析引擎( read_csv
和 read_table
)被从头开始重写,现在解析时使用的内存量只有原来的一小部分,而在大多数用例中速度要快40%或更多(在某些情况下要快得多)。
此外,还有许多新功能:
已大大改进的Unicode处理,通过
encoding
选项。列过滤 (
usecols
)Dtype规范 (
dtype
论据)能够指定要识别为True/False的字符串
生成NumPy记录数组的能力 (
as_recarray
)高性能
delim_whitespace
选项十进制格式(例如欧洲格式)规范
更简单的CSV方言选项:
escapechar
,lineterminator
,quotechar
等。更可靠地处理在野外观察到的许多特殊类型的文件
API更改#
不推荐使用的DataFrame BINOP TimeSeries特殊情况行为
DataFrame和Series之间的二进制操作的默认行为始终是在DataFrame的列上对齐并向下传播行, 除 在DataFrame包含时间序列的特殊情况下。由于现在有针对每个二元运算符的方法,使您能够指定您希望如何广播,因此我们将逐步淘汰这种特殊情况(PYTHON的Zen: 特殊情况不够特殊,不足以违反规则 )。这就是我要说的:
In [1]: import pandas as pd
In [2]: df = pd.DataFrame(np.random.randn(6, 4), index=pd.date_range("1/1/2000", periods=6))
In [3]: df
Out[3]:
0 1 2 3
2000-01-01 0.469112 -0.282863 -1.509059 -1.135632
2000-01-02 1.212112 -0.173215 0.119209 -1.044236
2000-01-03 -0.861849 -2.104569 -0.494929 1.071804
2000-01-04 0.721555 -0.706771 -1.039575 0.271860
2000-01-05 -0.424972 0.567020 0.276232 -1.087401
2000-01-06 -0.673690 0.113648 -1.478427 0.524988
# deprecated now
In [4]: df - df[0]
Out[4]:
2000-01-01 00:00:00 2000-01-02 00:00:00 2000-01-03 00:00:00 2000-01-04 00:00:00 2000-01-05 00:00:00 2000-01-06 00:00:00 0 1 2 3
2000-01-01 NaN NaN NaN NaN NaN NaN NaN NaN NaN NaN
2000-01-02 NaN NaN NaN NaN NaN NaN NaN NaN NaN NaN
2000-01-03 NaN NaN NaN NaN NaN NaN NaN NaN NaN NaN
2000-01-04 NaN NaN NaN NaN NaN NaN NaN NaN NaN NaN
2000-01-05 NaN NaN NaN NaN NaN NaN NaN NaN NaN NaN
2000-01-06 NaN NaN NaN NaN NaN NaN NaN NaN NaN NaN
# Change your code to
In [5]: df.sub(df[0], axis=0) # align on axis 0 (rows)
Out[5]:
0 1 2 3
2000-01-01 0.0 -0.751976 -1.978171 -1.604745
2000-01-02 0.0 -1.385327 -1.092903 -2.256348
2000-01-03 0.0 -1.242720 0.366920 1.933653
2000-01-04 0.0 -1.428326 -1.761130 -0.449695
2000-01-05 0.0 0.991993 0.701204 -0.662428
2000-01-06 0.0 0.787338 -0.804737 1.198677
您将在0.10.x系列中收到不推荐使用的警告,并且不推荐使用的功能将在0.11或更高版本中删除。
更改的重采样默认行为
默认时间序列 resample
每天的装箱行为 D
和 更高 频率已更改为 closed='left', label='left'
。较低的n频率不受影响。之前的默认设置给用户造成了很大的困惑,特别是将数据重新采样到每天的频率(这将聚合组标记为间隔结束:第二天)。
In [1]: dates = pd.date_range('1/1/2000', '1/5/2000', freq='4h')
In [2]: series = pd.Series(np.arange(len(dates)), index=dates)
In [3]: series
Out[3]:
2000-01-01 00:00:00 0
2000-01-01 04:00:00 1
2000-01-01 08:00:00 2
2000-01-01 12:00:00 3
2000-01-01 16:00:00 4
2000-01-01 20:00:00 5
2000-01-02 00:00:00 6
2000-01-02 04:00:00 7
2000-01-02 08:00:00 8
2000-01-02 12:00:00 9
2000-01-02 16:00:00 10
2000-01-02 20:00:00 11
2000-01-03 00:00:00 12
2000-01-03 04:00:00 13
2000-01-03 08:00:00 14
2000-01-03 12:00:00 15
2000-01-03 16:00:00 16
2000-01-03 20:00:00 17
2000-01-04 00:00:00 18
2000-01-04 04:00:00 19
2000-01-04 08:00:00 20
2000-01-04 12:00:00 21
2000-01-04 16:00:00 22
2000-01-04 20:00:00 23
2000-01-05 00:00:00 24
Freq: 4H, dtype: int64
In [4]: series.resample('D', how='sum')
Out[4]:
2000-01-01 15
2000-01-02 51
2000-01-03 87
2000-01-04 123
2000-01-05 24
Freq: D, dtype: int64
In [5]: # old behavior
In [6]: series.resample('D', how='sum', closed='right', label='right')
Out[6]:
2000-01-01 0
2000-01-02 21
2000-01-03 57
2000-01-04 93
2000-01-05 129
Freq: D, dtype: int64
无穷大和负无穷大不再被视为NA
isnull
和notnull
。它们曾经是早期Pandas的遗迹。可以通过以下方式全局重新启用此行为mode.use_inf_as_null
选项:
In [6]: s = pd.Series([1.5, np.inf, 3.4, -np.inf])
In [7]: pd.isnull(s)
Out[7]:
0 False
1 False
2 False
3 False
Length: 4, dtype: bool
In [8]: s.fillna(0)
Out[8]:
0 1.500000
1 inf
2 3.400000
3 -inf
Length: 4, dtype: float64
In [9]: pd.set_option('use_inf_as_null', True)
In [10]: pd.isnull(s)
Out[10]:
0 False
1 True
2 False
3 True
Length: 4, dtype: bool
In [11]: s.fillna(0)
Out[11]:
0 1.5
1 0.0
2 3.4
3 0.0
Length: 4, dtype: float64
In [12]: pd.reset_option('use_inf_as_null')
方法,使用
inplace
选项现在全部返回None
而不是调用对象。例如,编写如下的代码df = df.fillna(0, inplace=True)
可能会停止工作。要进行修复,只需删除不必要的变量赋值即可。pandas.merge
不再对组密钥进行排序 (sort=False
)默认情况下。这样做是出于性能原因:组键排序通常是计算成本较高的部分之一,而且通常是不必要的。没有标题的文件的默认列名已更改为整数
0
通过N - 1
。这是为了与未指定列的DataFrame构造函数保持一致。V0.9.0行为(名称X0
,X1
,...)可以通过指定prefix='X'
:
In [6]: import io
In [7]: data = """
...: a,b,c
...: 1,Yes,2
...: 3,No,4
...: """
...: print(data)
...: pd.read_csv(io.StringIO(data), header=None)
...: pd.read_csv(io.StringIO(data), header=None, prefix="X")
...:
Input In [7]
print(data)
^
IndentationError: unexpected indent
价值观,如
'Yes'
和'No'
默认情况下不会解释为布尔值,尽管这可以由新的true_values
和false_values
论据:
In [4]: print(data)
a,b,c
1,Yes,2
3,No,4
In [5]: pd.read_csv(io.StringIO(data))
Out[5]:
a b c
0 1 Yes 2
1 3 No 4
In [6]: pd.read_csv(io.StringIO(data), true_values=["Yes"], false_values=["No"])
Out[6]:
a b c
0 1 True 2
1 3 False 4
文件分析器将不会将从转换器函数产生的非字符串值识别为NA
na_values
争论。最好是使用replace
取而代之的是函数。呼叫
fillna
不带参数的On Series或DataFrame不再是有效代码。必须指定填充值或内插方法:
In [8]: s = pd.Series([np.nan, 1.0, 2.0, np.nan, 4])
In [9]: s
Out[9]:
0 NaN
1 1.0
2 2.0
3 NaN
4 4.0
dtype: float64
In [10]: s.fillna(0)
Out[10]:
0 0.0
1 1.0
2 2.0
3 0.0
4 4.0
dtype: float64
In [11]: s.fillna(method="pad")
Out[11]:
0 NaN
1 1.0
2 2.0
3 2.0
4 4.0
dtype: float64
方便的方法 ffill
和 bfill
已添加:
In [12]: s.ffill()
Out[12]:
0 NaN
1 1.0
2 2.0
3 2.0
4 4.0
dtype: float64
Series.apply
现在将对应用函数的返回值进行操作,该返回值本身是一个序列,并可能将结果向上强制转换为DataFrameIn [13]: def f(x): ....: return pd.Series([x, x ** 2], index=["x", "x^2"]) ....: In [14]: s = pd.Series(np.random.rand(5)) In [15]: s Out[15]: 0 0.340445 1 0.984729 2 0.919540 3 0.037772 4 0.861549 dtype: float64 In [16]: s.apply(f) Out[16]: x x^2 0 0.340445 0.115903 1 0.984729 0.969691 2 0.919540 0.845555 3 0.037772 0.001427 4 0.861549 0.742267
用于处理Pandas选项的新API函数 (GH2097 ):
get_option
/set_option
-获取/设置选项的值。接受部分名称。-reset_option
-将一个或多个选项重置为其缺省值。接受部分名称。-describe_option
-打印一个或多个选项的说明。在没有参数的情况下调用时。打印所有已注册的选项。
注:
set_printoptions
/reset_printoptions
不推荐使用(但仍在运行),打印选项现在位于“display.XYZ”下。例如:In [17]: pd.get_option("display.max_rows") Out[17]: 15
TO_STRING()方法现在始终返回Unicode字符串 (GH2224 )。
新功能#
宽幅数据帧打印#
默认情况下,Pandas不再打印摘要信息,而是将字符串表示分成多行:
In [18]: wide_frame = pd.DataFrame(np.random.randn(5, 16))
In [19]: wide_frame
Out[19]:
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
0 -0.548702 1.467327 -1.015962 -0.483075 1.637550 -1.217659 -0.291519 -1.745505 -0.263952 0.991460 -0.919069 0.266046 -0.709661 1.669052 1.037882 -1.705775
1 -0.919854 -0.042379 1.247642 -0.009920 0.290213 0.495767 0.362949 1.548106 -1.131345 -0.089329 0.337863 -0.945867 -0.932132 1.956030 0.017587 -0.016692
2 -0.575247 0.254161 -1.143704 0.215897 1.193555 -0.077118 -0.408530 -0.862495 1.346061 1.511763 1.627081 -0.990582 -0.441652 1.211526 0.268520 0.024580
3 -1.577585 0.396823 -0.105381 -0.532532 1.453749 1.208843 -0.080952 -0.264610 -0.727965 -0.589346 0.339969 -0.693205 -0.339355 0.593616 0.884345 1.591431
4 0.141809 0.220390 0.435589 0.192451 -0.096701 0.803351 1.715071 -0.708758 -1.202872 -1.814470 1.018601 -0.595447 1.395433 -0.392670 0.007207 1.928123
旧的打印摘要信息的行为可以通过‘Expand_Frame_Repr’打印选项来实现:
In [20]: pd.set_option("expand_frame_repr", False)
In [21]: wide_frame
Out[21]:
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
0 -0.548702 1.467327 -1.015962 -0.483075 1.637550 -1.217659 -0.291519 -1.745505 -0.263952 0.991460 -0.919069 0.266046 -0.709661 1.669052 1.037882 -1.705775
1 -0.919854 -0.042379 1.247642 -0.009920 0.290213 0.495767 0.362949 1.548106 -1.131345 -0.089329 0.337863 -0.945867 -0.932132 1.956030 0.017587 -0.016692
2 -0.575247 0.254161 -1.143704 0.215897 1.193555 -0.077118 -0.408530 -0.862495 1.346061 1.511763 1.627081 -0.990582 -0.441652 1.211526 0.268520 0.024580
3 -1.577585 0.396823 -0.105381 -0.532532 1.453749 1.208843 -0.080952 -0.264610 -0.727965 -0.589346 0.339969 -0.693205 -0.339355 0.593616 0.884345 1.591431
4 0.141809 0.220390 0.435589 0.192451 -0.096701 0.803351 1.715071 -0.708758 -1.202872 -1.814470 1.018601 -0.595447 1.395433 -0.392670 0.007207 1.928123
每一行的宽度都可以通过‘line_width’(默认为80)进行更改:
pd.set_option("line_width", 40)
wide_frame
更新的PyTables支持#
Docs 对于PyTables Table
Format&API的几个增强。以下是我们将会遇到的情况。
In [41]: store = pd.HDFStore('store.h5')
In [42]: df = pd.DataFrame(np.random.randn(8, 3),
....: index=pd.date_range('1/1/2000', periods=8),
....: columns=['A', 'B', 'C'])
In [43]: df
Out[43]:
A B C
2000-01-01 -2.036047 0.000830 -0.955697
2000-01-02 -0.898872 -0.725411 0.059904
2000-01-03 -0.449644 1.082900 -1.221265
2000-01-04 0.361078 1.330704 0.855932
2000-01-05 -1.216718 1.488887 0.018993
2000-01-06 -0.877046 0.045976 0.437274
2000-01-07 -0.567182 -0.888657 -0.556383
2000-01-08 0.655457 1.117949 -2.782376
[8 rows x 3 columns]
# appending data frames
In [44]: df1 = df[0:4]
In [45]: df2 = df[4:]
In [46]: store.append('df', df1)
In [47]: store.append('df', df2)
In [48]: store
Out[48]:
<class 'pandas.io.pytables.HDFStore'>
File path: store.h5
/df frame_table (typ->appendable,nrows->8,ncols->3,indexers->[index])
# selecting the entire store
In [49]: store.select('df')
Out[49]:
A B C
2000-01-01 -2.036047 0.000830 -0.955697
2000-01-02 -0.898872 -0.725411 0.059904
2000-01-03 -0.449644 1.082900 -1.221265
2000-01-04 0.361078 1.330704 0.855932
2000-01-05 -1.216718 1.488887 0.018993
2000-01-06 -0.877046 0.045976 0.437274
2000-01-07 -0.567182 -0.888657 -0.556383
2000-01-08 0.655457 1.117949 -2.782376
[8 rows x 3 columns]
In [50]: wp = pd.Panel(np.random.randn(2, 5, 4), items=['Item1', 'Item2'],
....: major_axis=pd.date_range('1/1/2000', periods=5),
....: minor_axis=['A', 'B', 'C', 'D'])
In [51]: wp
Out[51]:
<class 'pandas.core.panel.Panel'>
Dimensions: 2 (items) x 5 (major_axis) x 4 (minor_axis)
Items axis: Item1 to Item2
Major_axis axis: 2000-01-01 00:00:00 to 2000-01-05 00:00:00
Minor_axis axis: A to D
# storing a panel
In [52]: store.append('wp', wp)
# selecting via A QUERY
In [53]: store.select('wp', [pd.Term('major_axis>20000102'),
....: pd.Term('minor_axis', '=', ['A', 'B'])])
....:
Out[53]:
<class 'pandas.core.panel.Panel'>
Dimensions: 2 (items) x 3 (major_axis) x 2 (minor_axis)
Items axis: Item1 to Item2
Major_axis axis: 2000-01-03 00:00:00 to 2000-01-05 00:00:00
Minor_axis axis: A to B
# removing data from tables
In [54]: store.remove('wp', pd.Term('major_axis>20000103'))
Out[54]: 8
In [55]: store.select('wp')
Out[55]:
<class 'pandas.core.panel.Panel'>
Dimensions: 2 (items) x 3 (major_axis) x 4 (minor_axis)
Items axis: Item1 to Item2
Major_axis axis: 2000-01-01 00:00:00 to 2000-01-03 00:00:00
Minor_axis axis: A to D
# deleting a store
In [56]: del store['df']
In [57]: store
Out[57]:
<class 'pandas.io.pytables.HDFStore'>
File path: store.h5
/wp wide_table (typ->appendable,nrows->12,ncols->2,indexers->[major_axis,minor_axis])
Enhancements
增加了分层密钥的功能
In [58]: store.put('foo/bar/bah', df) In [59]: store.append('food/orange', df) In [60]: store.append('food/apple', df) In [61]: store Out[61]: <class 'pandas.io.pytables.HDFStore'> File path: store.h5 /foo/bar/bah frame (shape->[8,3]) /food/apple frame_table (typ->appendable,nrows->8,ncols->3,indexers->[index]) /food/orange frame_table (typ->appendable,nrows->8,ncols->3,indexers->[index]) /wp wide_table (typ->appendable,nrows->12,ncols->2,indexers->[major_axis,minor_axis]) # remove all nodes under this level In [62]: store.remove('food') In [63]: store Out[63]: <class 'pandas.io.pytables.HDFStore'> File path: store.h5 /foo/bar/bah frame (shape->[8,3]) /wp wide_table (typ->appendable,nrows->12,ncols->2,indexers->[major_axis,minor_axis])
增加了对混合数据类型的支持!
In [64]: df['string'] = 'string' In [65]: df['int'] = 1 In [66]: store.append('df', df) In [67]: df1 = store.select('df') In [68]: df1 Out[68]: A B C string int 2000-01-01 -2.036047 0.000830 -0.955697 string 1 2000-01-02 -0.898872 -0.725411 0.059904 string 1 2000-01-03 -0.449644 1.082900 -1.221265 string 1 2000-01-04 0.361078 1.330704 0.855932 string 1 2000-01-05 -1.216718 1.488887 0.018993 string 1 2000-01-06 -0.877046 0.045976 0.437274 string 1 2000-01-07 -0.567182 -0.888657 -0.556383 string 1 2000-01-08 0.655457 1.117949 -2.782376 string 1 [8 rows x 5 columns] In [69]: df1.get_dtype_counts() Out[69]: float64 3 int64 1 object 1 dtype: int64
表写入的性能改进
支持任意索引的维度
SparseSeries
现在有一个density
财产性 (GH2384 )启用
Series.str.strip/lstrip/rstrip
接受输入参数以剥离任意字符的方法 (GH2411 )实施
value_vars
在……里面melt
将值限制在某些列并添加melt
到Pandas命名空间 (GH2412 )
错误修复
已添加
Term
指定WHERE条件的方法 (GH1996 )。del store['df']
现在拨打store.remove('df')
用于商店删除删除连续行的速度比以前快得多
min_itemsize
参数,以强制索引列的最小大小(以前的实现将基于第一个追加设置列大小)通过以下方式提供索引支持
create_table_index
(需要PyTables>=2.3) (GH698 )。如果表不是首先通过
put
修复了加载酸洗数据帧后缺少属性的问题(GH2431)
对SELECT和REMOVE的微小更改:仅当还提供了WHERE(而不是没有)时才需要一个表
Compatibility
共0.10页 HDFStore
向后兼容读取在早期版本的PANAS中创建的表,但是,不支持使用先前(未记录的)方法的查询词。您必须读入整个文件,并使用新格式将其写出,才能利用更新。
N维面板(实验)#
添加对Panel4D和工厂函数的实验性支持,以创建n维命名面板。以下是我们将会遇到的情况。
In [58]: p4d = Panel4D(np.random.randn(2, 2, 5, 4),
....: labels=['Label1','Label2'],
....: items=['Item1', 'Item2'],
....: major_axis=date_range('1/1/2000', periods=5),
....: minor_axis=['A', 'B', 'C', 'D'])
....:
In [59]: p4d
Out[59]:
<class 'pandas.core.panelnd.Panel4D'>
Dimensions: 2 (labels) x 2 (items) x 5 (major_axis) x 4 (minor_axis)
Labels axis: Label1 to Label2
Items axis: Item1 to Item2
Major_axis axis: 2000-01-01 00:00:00 to 2000-01-05 00:00:00
Minor_axis axis: A to D
请参阅 full release notes 或在GitHub上的问题跟踪器上查看完整的列表。
贡献者#
共有26人为此次发布贡献了补丁。名字中带有“+”的人第一次贡献了一个补丁。
A. Flaxman +
Abraham Flaxman
Adam Obeng +
Brenda Moon +
Chang She
Chris Mulligan +
Dieter Vandenbussche
Donald Curtis +
Jay Bourque +
Jeff Reback +
Justin C Johnson +
K.-Michael Aye
Keith Hughitt +
Ken Van Haren +
Laurent Gautier +
Luke Lee +
Martin Blais
Tobias Brandt +
Wes McKinney
Wouter Overmeire
alex arsenovic +
jreback +
locojaydev +
timmie
y-p
zach powers +