深刻理解pandas读取excel,txt,csv文件等命令

pandas读取文件官方提供的文档

在使用pandas读取文件以前,必备的内容,必然属于官方文档,官方文档查阅地址html

http://pandas.pydata.org/pandas-docs/version/0.24/reference/io.htmlhtml5

文档操做属于pandas里面的Input/Output也就是IO操做,基本的API都在上述网址,接下来本文核心带你理解部分经常使用的命令python

pandas读取txt文件

读取txt文件须要肯定txt文件是否符合基本的格式,也就是是否存在\t,` ,,`等特殊的分隔符
通常txt文件长成这个样子git

txt文件举例github

下面的文件为空格间隔正则表达式

1 2019-03-22 00:06:24.4463094 中文测试 
2 2019-03-22 00:06:32.4565680 须要编辑encoding 
3 2019-03-22 00:06:32.6835965 ashshsh 
4 2017-03-22 00:06:32.8041945 eggg

读取命令采用 read_csv或者 read_table均可以apache

import pandas as pd
df =  pd.read_table("./test.txt")
print(df)

import pandas as pd
df =  pd.read_csv("./test.txt")
print(df)

可是,注意,这个地方读取出来的数据内容为3行1列的DataFrame类型,并无按照咱们的要求获得3行4列json

import pandas as pd
df =  pd.read_csv("./test.txt")
print(type(df))
print(df.shape)

<class 'pandas.core.frame.DataFrame'>
(3, 1)

read_csv函数

默认: 从文件、URL、文件新对象中加载带有分隔符的数据,默认分隔符是逗号。api

上述txt文档并无逗号分隔,因此在读取的时候须要增长sep分隔符参数数组

df =  pd.read_csv("./test.txt",sep=' ')

参数说明,官方Source : https://github.com/pandas-dev/pandas/blob/v0.24.0/pandas/io/parsers.py#L531-L697

中文说明以及重点功能案例

参数 中文释义
filepath_or_buffer 能够是URL,可用URL类型包括:http, ftp, s3和文件,本地文件读取实例:file://localhost/path/to/table.csv
sep str类型,默认',' 指定分隔符。若是不指定参数,则会尝试使用默认值逗号分隔。分隔符长于一个字符而且不是‘\s+’,将使用python的语法分析器。而且忽略数据中的逗号。正则表达式例子:'\r\t'
delimiter 定界符,备选分隔符(若是指定该参数,则sep参数失效) 通常不用
delimiter_whitespace True or False 默认False, 用空格做为分隔符等价于spe=’\s+’若是该参数被调用,则delimite不会起做用
header 指定第几行做为列名(忽略注解行),若是没有指定列名,默认header=0; 若是指定了列名header=None
names 指定列名,若是文件中不包含header的行,应该显性表示header=None ,header能够是一个整数的列表,如[0,1,3]。未指定的中间行将被删除(例如,跳过此示例中的2行)
index_col(案例1) 默认为None 用列名做为DataFrame的行标签,若是给出序列,则使用MultiIndex。若是读取某文件,该文件每行末尾都有带分隔符,考虑使用index_col=False使panadas不用第一列做为行的名称。
usecols 默认None 可使用列序列也可使用列名,如 [0, 1, 2] or [‘foo’, ‘bar’, ‘baz’] ,使用这个参数能够加快加载速度并下降内存消耗。
squeeze 默认为False, True的状况下返回的类型为Series,若是数据经解析后仅含一行,则返回Series
prefix 自动生成的列名编号的前缀,如: ‘X’ for X0, X1, ... 当header =None 或者没有设置header的时候有效
mangle_dupe_cols 默认为True,重复的列将被指定为’X.0’…’X.N’,而不是’X’…’X’。若是传入False,当列中存在重复名称,则会致使数据被覆盖。
dtype 例子: {‘a’: np.float64, ‘b’: np.int32} 指定每一列的数据类型,a,b表示列名
engine 使用的分析引擎。能够选择C或者是python,C引擎快可是Python引擎功能更多一些
converters(案例2) 设置指定列的处理函数,能够用"序号"也可使用“列名”进行列的指定
true_values / false_values 没有找到实际的应用场景,备注一下,后期完善
skipinitialspace 忽略分隔符后的空格,默认false
skiprows 默认值 None 须要忽略的行数(从文件开始处算起),或须要跳过的行号列表(从0开始)
skipfooter 从文件尾部开始忽略。 (c引擎不支持)
nrows 从文件中只读取多少数据行,须要读取的行数(从文件头开始算起)
na_values 空值定义,默认状况下, ‘#N/A’, ‘#N/A N/A’, ‘#NA’, ‘-1.#IND’, ‘-1.#QNAN’, ‘-NaN’, ‘-nan’, ‘1.#IND’, ‘1.#QNAN’, ‘N/A’, ‘NA’, ‘NULL’, ‘NaN’, ‘n/a’, ‘nan’, ‘null’. 都表现为NAN
keep_default_na 若是指定na_values参数,而且keep_default_na=False,那么默认的NaN将被覆盖,不然添加
na_filter 是否检查丢失值(空字符串或者是空值)。对于大文件来讲数据集中没有N/A空值,使用na_filter=False能够提高读取速度
verbose 是否打印各类解析器的输出信息,例如:“非数值列中缺失值的数量”等。
skip_blank_lines 若是为True,则跳过空行;不然记为NaN。
parse_dates 有以下的操做
1. boolean. True -> 解析索引
2. list of ints or names. e.g. If [1, 2, 3] -> 解析1,2,3列的值做为独立的日期列;
3. list of lists. e.g. If [[1, 3]] -> 合并1,3列做为一个日期列使用
4. dict, e.g. {‘foo’ : [1, 3]} -> 将1,3列合并,并给合并后的列起名为"foo"
infer_datetime_format 若是设定为True而且parse_dates 可用,那么pandas将尝试转换为日期类型,若是能够转换,转换方法并解析。在某些状况下会快5~10倍
keep_date_col 若是链接多列解析日期,则保持参与链接的列。默认为False
date_parser 用于解析日期的函数,默认使用dateutil.parser.parser来作转换。Pandas尝试使用三种不一样的方式解析,若是遇到问题则使用下一种方式。
1.使用一个或者多个arrays(由parse_dates指定)做为参数;
2.链接指定多列字符串做为一个列做为参数;
3.每行调用一次date_parser函数来解析一个或者多个字符串(由parse_dates指定)做为参数。
dayfirst DD/MM格式的日期类型
iterator 返回一个TextFileReader 对象,以便逐块处理文件。
chunksize 文件块的大小
compression 直接使用磁盘上的压缩文件。若是使用infer参数,则使用 gzip, bz2, zip或者解压文件名中以‘.gz’, ‘.bz2’, ‘.zip’, or ‘xz’这些为后缀的文件,不然不解压。若是使用zip,那么ZIP包中国必须只包含一个文件。设置为None则不解压。
新版本0.18.1版本支持zip和xz解压
thousands 千分位符号,默认‘,’
decimal 小数点符号,默认‘.’
lineterminator 行分割符,只在C解析器下使用
quotechar 引号,用做标识开始和解释的字符,引号内的分割符将被忽略
quoting 控制csv中的引号常量。可选 QUOTE_MINIMAL (0), QUOTE_ALL (1), QUOTE_NONNUMERIC (2) or QUOTE_NONE (3)
doublequote 双引号,当单引号已经被定义,而且quoting 参数不是QUOTE_NONE的时候,使用双引号表示引号内的元素做为一个元素使用。
escapechar 当quoting 为QUOTE_NONE时,指定一个字符使的不受分隔符限值。
comment 标识着多余的行不被解析。若是该字符出如今行首,这一行将被所有忽略。这个参数只能是一个字符,空行(就像skip_blank_lines=True)注释行被header和skiprows忽略同样。例如若是指定comment='#' 解析‘#empty\na,b,c\n1,2,3’ 以header=0 那么返回结果将是以’a,b,c'做为header
encoding 编码方式,指定字符集类型,一般指定为'utf-8'
dialect 若是没有指定特定的语言,若是sep大于一个字符则忽略。具体查看csv.Dialect 文档
error_bad_lines 若是一行包含太多的列,那么默认不会返回DataFrame ,若是设置成false,那么会将改行剔除(只能在C解析器下使用)
warn_bad_lines 若是error_bad_lines =False,而且warn_bad_lines =True 那么全部的“bad lines”将会被输出(只能在C解析器下使用)
low_memory 分块加载到内存,再低内存消耗中解析。可是可能出现类型混淆。确保类型不被混淆须要设置为False。或者使用dtype 参数指定类型。注意使用chunksize 或者iterator 参数分块读入会将整个文件读入到一个Dataframe,而忽略类型(只能在C解析器中有效)
delim_whitespace New in version 0.18.1: Python解析器中有效
memory_map 若是为filepath_or_buffer提供了文件路径,则将文件对象直接映射到内存上,并直接从那里访问数据。使用此选项能够提升性能,由于再也不有任何I / O开销,使用这种方式能够避免文件再次进行IO操做
float_precision 指定C引擎应用于浮点值的转换器

该表格部分参考 博客 http://www.javashuo.com/article/p-nmbkbeht-gm.html 感谢博主的翻译,O(∩_∩)O哈哈~

案例1

index_col 使用
首先准备一个txt文件,这个文件最大的问题是在每行的末尾多了一个',' ,按照提示解释为,若是每行末尾都有分隔符,会出现问题,可是在实际测试的时候发现须要配合names参数,才能够出现效果

goof,1,2,3,ddd,
u,1,3,4,asd,
as,df,12,33,

编写以下代码

df =  pd.read_csv("./demo.txt",header=None,names=['a','b','c','d','e'])
print(df)

df =  pd.read_csv("./demo.txt",header=None,index_col=False,names=['a','b','c','d','e'])
print(df)

深刻理解pandas
其实发现意义还真不是很大,可能文档并无表述清楚他的具体做用。接下来讲一下index_col的常见用途

在读取文件的时候,若是不设置index_col列索引,默认会使用从0开始的整数索引。当对表格的某一行或列进行操做以后,在保存成文件的时候你会发现老是会多一列从0开始的列,若是设置index_col参数来设置列索引,就不会出现这种问题了。

案例2

converters 设置指定列的处理函数,能够用"序号"也可使用“列名”进行列的指定

import pandas as pd

def fun(x):
    return str(x)+"-haha"

df =  pd.read_csv("./test.txt",sep=' ',header=None,index_col=0,converters={3:fun})
print(type(df))
print(df.shape)
print(df)

pandas深刻理解read_csv

read_csv函数过程当中常见的问题

  1. 有的IDE中利用Pandas的read_csv函数导入数据文件时,若文件路径或文件名包含中文,会报错。

解决办法

import pandas as pd
#df=pd.read_csv('F:/测试文件夹/测试数据.txt')
f=open('F:/测试文件夹/测试数据.txt')
df=pd.read_csv(f)
  1. 排除某些行 使用 参数 skiprows.它的功能为排除某一行。
    要注意的是:排除前3行是skiprows=3 排除第3行是skiprows=[3]

  2. 对于不规则分隔符,使用正则表达式读取文件
    文件中的分隔符采用的是空格,那么咱们只须要设置sep=" "来读取文件就能够了。当分隔符并非单个的空格,也许有的是一个空格有的是多个空格时,若是这个时候仍是采用sep=" "来读取文件,也许你就会获得一个很奇怪的数据,由于它会将空格也作为数据。

    data = pd.read_csv("data.txt",sep="\s+")
  3. 读取的文件中若是出现中文编码错误
    须要设定 encoding 参数

  4. 为行和列添加索引
    用参数names添加列索引,用index_col添加行索引

read_csv该命令有至关数量的参数。大多数都是没必要要的,由于你下载的大部分文件都有标准格式。

read_table函数

基本用法是一致的,区别在于separator分隔符。
csv是逗号分隔值,仅能正确读入以 “,” 分割的数据,read_table默认是'\t'(也就是tab)切割数据集的

read_fwf 函数

读取具备固定宽度列的文件,例如文件

id8141    360.242940   149.910199   11950.7
id1594    444.953632   166.985655   11788.4
id1849    364.136849   183.628767   11806.2
id1230    413.836124   184.375703   11916.8
id1948    502.953953   173.237159   12468.3

read_fwf 命令有2个额外的参数能够设置

colspecs :

须要给一个元组列表,元组列表为半开区间,[from,to) ,默认状况下它会从前100行数据进行推断。

例子:

import pandas as pd
colspecs = [(0, 6), (8, 20), (21, 33), (34, 43)]
df = pd.read_fwf('demo.txt', colspecs=colspecs, header=None, index_col=0)

widths:
直接用一个宽度列表,能够代替colspecs参数

widths = [6, 14, 13, 10]
df = pd.read_fwf('demo.txt', widths=widths, header=None)

read_fwf 使用并非很频繁,能够参照 http://pandas.pydata.org/pandas-docs/stable/user_guide/io.html#files-with-fixed-width-columns 学习

read_msgpack 函数

pandas支持的一种新的可序列化的数据格式,这是一种轻量级的可移植二进制格式,相似于二进制JSON,这种数据空间利用率高,在写入(序列化)和读取(反序列化)方面都提供了良好的性能。

read_clipboard 函数

读取剪贴板中的数据,能够看做read_table的剪贴板版本。在将网页转换为表格时颇有用

这个地方出现以下的BUG

module 'pandas' has no attribute 'compat'

我更新了一下pandas 既能够正常使用了

python深刻理解pandas
还有一个比较坑的地方,就是在读取剪切板的时候,若是复制了中文,很容易读取不到数据
解决办法

  1. 打开site-packages\pandas\io\clipboard.py 这个文件须要自行检索
  2. 在 text = clipboard_get() 后面一行 加入这句: text = text.decode('UTF-8')
  3. 保存,而后就可使用了

read_excel 函数

依旧是官方文档一码当先:http://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.read_excel.html#pandas.read_excel

参数 中文释义
io 文件类对象 ,pandas Excel 文件或 xlrd 工做簿。该字符串多是一个URL。URL包括http,ftp,s3和文件。例如,本地文件可写成file://localhost/path/to/workbook.xlsx
sheet_name 默认是sheetname为0,返回多表使用sheetname=[0,1],若sheetname=None是返回全表 。注意:int/string返回的是dataframe,而none和list返回的是dict of dataframe,表名用字符串表示,索引表位置用整数表示;
header 指定做为列名的行,默认0,即取第一行,数据为列名行如下的数据;若数据不含列名,则设定 header = None;
names 指定列的名字,传入一个list数据
index_col 指定列为索引列,也可使用u”strings” ,若是传递一个列表,这些列将被组合成一个MultiIndex。
squeeze 若是解析的数据只包含一列,则返回一个Series
dtype 数据或列的数据类型,参考read_csv便可
engine 若是io不是缓冲区或路径,则必须将其设置为标识io。 可接受的值是None或xlrd
converters 参照read_csv便可
其他参数 基本和read_csv一致

pandas 读取excel文件若是报错,通常处理为

错误为:ImportError: No module named 'xlrd'
pandas读取excel文件,须要单独的xlrd模块支持 pip install xlrd 便可

read_json 函数

参数 中文释义
path_or_buf 一个有效的JSON文件,默认值为None,字符串能够为URL,例如file://localhost/path/to/table.json
orient (案例1) 预期的json字符串格式,orient的设置有如下几个值:
1. 'split' : dict like {index -> [index], columns -> [columns], data -> [values]}
2. 'records' : list like [{column -> value}, ... , {column -> value}]
3. 'index' : dict like {index -> {column -> value}}
4. 'columns' : dict like {column -> {index -> value}}
5. 'values' : just the values array
typ 返回的格式(series or frame), 默认是 ‘frame’
dtype 数据或列的数据类型,参考read_csv便可
convert_axes boolean,尝试将轴转换为正确的dtypes,默认值为True
convert_dates 解析日期的列列表;若是为True,则尝试解析相似日期的列,默认值为True
参考列标签
it ends with '_at',
it ends with '_time',
it begins with 'timestamp',
it is 'modified',
it is 'date'
keep_default_dates boolean,default True。若是解析日期,则解析默认的日期样列
numpy 直接解码为numpy数组。默认为False;仅支持数字数据,但标签多是非数字的。还要注意,若是numpy=True,JSON排序MUST
precise_float boolean,默认False。设置为在将字符串解码为双精度值时启用更高精度(strtod)函数的使用。默认值(False)是使用快速但不太精确的内置功能
date_unit string,用于检测转换日期的时间戳单位。默认值无。默认状况下,将检测时间戳精度,若是不须要,则经过's','ms','us'或'ns'之一分别强制时间戳精度为秒,毫秒,微秒或纳秒。
encoding json编码
lines 每行将文件读取为一个json对象。

若是JSON不可解析,解析器将产生ValueError/TypeError/AssertionError之一。

案例1

  1. orient='split'
import pandas as pd
    s = '{"index":[1,2,3],"columns":["a","b"],"data":[[1,3],[2,5],[6,9]]}'
    df = pd.read_json(s,orient='split')
  1. orient='records'
    成员为字典列表
import pandas as pd
s = '[{"a":1,"b":2},{"a":3,"b":4}]'
df = pd.read_json(s,orient='records')
  1. orient='index'
    以索引为key,以列字段构成的字典为键值。如:

    s = '{"0":{"a":1,"b":2},"1":{"a":2,"b":4}}'
  2. orient='columns' 或者 values 本身推断便可

部分中文翻译,能够参考github> https://github.com/apachecn/pandas-doc-zh

read_json()常见BUG

读取json文件出现 ValueError: Trailing data ,JSON格式问题
原格式为

{"a":1,"b":1},{"a":2,"b":2}

调整为

[{"a":1,"b":1},{"a":2,"b":2}]

或者使用lines参数,而且JSON调整为每行一条数据

{"a":1,"b":1}
{"a":2,"b":2}

若JSON文件中有中文,建议加上encoding参数,赋值'utf-8',不然会报错

read_html 函数

参数 中文释义
io 接收网址、文件、字符串。网址不接受https,尝试去掉s后爬去
match 正则表达式,返回与正则表达式匹配的表格
flavor 解析器默认为‘lxml’
header 指定列标题所在的行,list为多重索引
index_col 指定行标题对应的列,list为多重索引
skiprows 跳过第n行(序列标示)或跳过n行(整数标示)
attrs 属性,好比 attrs = {'id': 'table'}
parse_dates 解析日期

使用方法,在网页中右键若是发现表格 也就是 table 便可使用

例如: http://data.stcn.com/2019/0304/14899644.shtml

<table class="..." id="...">
    <thead>
    <tr>
    <th>...</th>
    </tr>
    </thead>
    <tbody>
        <tr>
            <td>...</td>
        </tr>
        <tr>...</tr>
    </tbody>
</table>


<table> : 定义表格
<thead> : 定义表格的页眉
<tbody> : 定义表格的主体
<tr>    : 定义表格的行
<th>    : 定义表格的表头
<td>    : 定义表格单元

常见BUG

出现以下报错 ImportError: html5lib not found, please install it

安装html5lib便可,或者使用参数

import pandas as pd
df = pd.read_html("http://data.stcn.com/2019/0304/14899644.shtml",flavor ='lxml')

更多参考源码,能够参考 > http://pandas.pydata.org/pandas-docs/stable/user_guide/io.html

尾声

截止到如今,本篇博客已经完成,对于pandas读取文件,相信你应该已经有一个深刻的理解了。在pandas读取文件的过程当中,最常出现的问题,就是中文问题与格式问题,但愿当你碰到的时候,能够完美的解决。

有任何问题,但愿能够在评论区给我回复,期待和你一块儿进步,博客园-梦想橡皮擦

相关文章
相关标签/搜索