numpy.loadtxt
numpy.loadtxt(fname, dtype=, comments='#', delimiter=None, converters=None, skiprows=0, usecols=None, unpack=False, ndmin=0, encoding='bytes', max_rows=None)[source]
从文本文件加载数据。
文本文件中的每一行必须具有相同数量的值。
参数 ： | fname： 要读取的文件，文件名或生成器。 如果文件扩展名是 则首先将文件解压缩。 请注意， 生成器应返回字节字符串。 dtype： 结果数组的数据类型； 默认值： 如果这是结构化数据类型， 则结果数组将为一维，并且每一行将被解释为数组的元素。 在这种情况下，使用的列数必须与数据类型中的字段数匹配。 comments： 用于指示注释开始的字符或字符列表。 无表示无评论。 为了向后兼容，字节字符串将被解码为 默认值为 delimiter： 用于分隔值的字符串。 为了向后兼容， 字节字符串将被解码为 converters： 将列号映射到函数的字典， 该函数会将列字符串解析为所需的值。 例如， 如果第0列是日期字符串：
转换器也可以用于提供缺失数据的默认值 （但另请参见 genfromtxt）：
默认值： skiprows： 跳过第一行，包括注释； 默认值： usecols： 要读取的列，第一列为 将提取第二，第五和第六列。 默认值为 将导致读取所有列。在版本1.11.0中进行了更改： 当必须读取单个列时，可以使用整数而不是元组。 例如，
unpack： 如果为True，则对返回的数组进行转置， 以便可以使用 与结构化数据类型一起使用时，将为每个字段返回数组。 默认值为 ndmin： 返回的数组将至少具有ndmin维。 否则，将挤压一维轴。 合法值： 1.6.0版中的新功能。 encoding： 用于解码输入文件的编码。 不适用于输入流。 特殊值 可确保您尽可能接收字节数组作为结果， 并将 覆盖此值以接收 并将字符串作为输入传递给转换器。 如果设置为 默认值为 1.14.0版中的新功能。 max_rows： 在行数之后读取 1.16.0版中的新功能。 |
返回值 ： | out： 从文本文件读取数据。 |
Notes
此功能旨在成为简单格式文件的快速阅读器。genfromtxt函数可对例如缺少值的行进行更复杂的处理。
1.10.0版中的新功能。
Python float.hex方法产生的字符串可用作float的输入。
例子
>>> from io import StringIO # StringIO behaves like a file object
>>> c = StringIO("0 1\n2 3")
>>> np.loadtxt(c)
array([[0., 1.],
[2., 3.]])>>> d = StringIO("M 21 72\nF 35 58")
>>> np.loadtxt(d, dtype={'names': ('gender', 'age', 'weight'),
... 'formats': ('S1', 'i4', 'f4')})
array([(b'M', 21, 72.), (b'F', 35, 58.)],
dtype=[('gender', 'S1'), ('age', '<i4'), ('weight', '<f4')])>>> c = StringIO("1,0,2\n3,0,4")
>>> x, y = np.loadtxt(c, delimiter=',', usecols=(0, 2), unpack=True)
>>> x
array([1., 3.])
>>> y
array([2., 4.])本示例说明如何使用转换器将带有尾随减号的字段转换为负数
>>> s = StringIO('10.01 31.25-\n19.22 64.31\n17.57- 63.94')
>>> def conv(fld):
... return -float(fld[:-1]) if fld.endswith(b'-') else float(fld)
...
>>> np.loadtxt(s, converters={0: conv, 1: conv})
array([[ 10.01, -31.25],
[ 19.22, 64.31],
[-17.57, 63.94]])