pandas.read_table
-
pandas.read_table(filepath_or_buffer, sep=False, delimiter=None, header='infer', names=None, index_col=None, usecols=None, squeeze=False, prefix=None, mangle_dupe_cols=True, dtype=None, engine=None, converters=None, true_values=None, false_values=None, skipinitialspace=False, skiprows=None, skipfooter=0, nrows=None, na_values=None, keep_default_na=True, na_filter=True, verbose=False, skip_blank_lines=True, parse_dates=False, infer_datetime_format=False, keep_date_col=False, date_parser=None, dayfirst=False, iterator=False, chunksize=None, compression='infer', thousands=None, decimal=b'.', lineterminator=None, quotechar='"', quoting=0, doublequote=True, escapechar=None, comment=None, encoding=None, dialect=None, tupleize_cols=None, error_bad_lines=True, warn_bad_lines=True, delim_whitespace=False, low_memory=True, memory_map=False, float_precision=None)[source] -
Чтение общего разделительного файла в DataFrame.
Устарело начиная с версии 0.24.0.
Используйте
pandas.read_csv()вместо этого, передаваяsep='\t'при необходимости.Также поддерживает необязательное итеративное чтение или разбиение файла на куски.
Дополнительную помощь можно найти в онлайн-документации по Инструментам ввода-вывода.
Параметры: -
filepath_or_buffer : str, path object, or file-like object -
Любой допустимый путь к файлу в виде строки приемлем. Строка может быть URL. Допустимые схемы URL включают http, ftp, s3 и file. Для URL-адресов файлов ожидается хост. Локальный файл может быть: file://localhost/path/to/table.csv.
Если вы хотите передать объект пути, pandas принимает либо
pathlib.Path, либоpy._path.local.LocalPath.Под объектом-подобным файлу мы понимаем объекты с методом
read(), например, обработчик файла (например, с помощью встроенной функцииopen) илиStringIO. -
sep : str, default ‘\t’ (tab-stop) -
Разделитель для использования. Если sep равен None, движок C не может автоматически обнаружить разделитель, но движок парсинга Python может, что означает, что последний будет использован и автоматически обнаружит разделитель с помощью встроенного средства обнаружения Python,
csv.Sniffer. Кроме того, разделители длиной более 1 символа и отличные от'\s+'будут интерпретироваться как регулярные выражения и также будут принудительно использовать движок парсинга Python. Обратите внимание, что разделители регулярных выражений могут игнорировать цитированные данные. Пример регулярного выражения:'\r\t'. -
delimiter : str, default None -
Псевдоним для sep.
-
header : int, list of int, default ‘infer’ -
Номер(а) строки(ок) для использования в качестве имён столбцов и начала данных. По умолчанию имена столбцов выводятся: если имена не переданы, поведение идентично
header=0, и имена столбцов выводятся из первой строки файла, если имена столбцов явно переданы, то поведение идентичноheader=None. Явно передайтеheader=0, чтобы заменить существующие имена. Заголовок может быть списком целых чисел, указывающих позиции строк для многоиндексного столбца, например, [0,1,3]. Промежуточные строки, которые не указаны, будут пропущены (например, 2 в этом примере пропущена). Обратите внимание, что этот параметр игнорирует прокомментированные строки и пустые строки, еслиskip_blank_lines=True, поэтомуheader=0обозначает первую строку данных, а не первую строку файла. -
names : array-like, optional -
Список имён столбцов для использования. Если файл не содержит строку заголовка, то вы должны явно передать
header=None. Повторные значения в этом списке приведут к выдачеUserWarning. -
index_col : int, sequence or bool, optional -
Столбец для использования в качестве меток строк DataFrame. Если указана последовательность, используется MultiIndex. Если у вас есть повреждённый файл с разделителями в конце каждой строки, вы можете рассмотреть возможность
index_col=False, чтобы заставить pandas не использовать первый столбец в качестве индекса (имён строк). -
usecols : list-like or callable, optional -
Возвращает подмножество столбцов. Если это список, все элементы должны быть либо позиционными (т. е. целочисленными индексами в столбцах документа), либо строками, соответствующими именам столбцов, предоставленным пользователем в
namesили выведенными из строки(ок) заголовка документа. Например, допустимым списком-подобным параметромusecolsбудет[0, 1, 2]или['foo', 'bar', 'baz']. Порядок элементов игнорируется, поэтомуusecols=[0, 1]эквивалентно[1, 0]. Чтобы создать DataFrame изdataс сохранением порядка элементов, используйтеpd.read_csv(data, usecols=['foo', 'bar'])[['foo', 'bar']]для столбцов в порядке['foo', 'bar']илиpd.read_csv(data, usecols=['foo', 'bar'])[['bar', 'foo']]для порядка['bar', 'foo'].Если это вызываемая функция, вызываемая функция будет оцениваться по отношению к именам столбцов, возвращая имена, где вызываемая функция принимает значение True. Примером допустимого вызываемого аргумента будет
lambda x: x.upper() in ['AAA', 'BBB', 'DDD']. Использование этого параметра приводит к значительно более быстрому времени парсинга и меньшему использованию памяти. -
squeeze : bool, default False -
Если проанализированные данные содержат только один столбец, возвращается Series.
-
prefix : str, optional -
Префикс, добавляемый к номерам столбцов при отсутствии заголовка, например, «X» для X0, X1, …
-
mangle_dupe_cols : bool, default True -
Повторные столбцы будут указаны как «X», «X.1», …’X.N’, а не «X»…’X’. Передача False приведет к перезаписи данных при наличии дублирующихся имён столбцов.
-
dtype : Type name or dict of column -> type, optional -
Тип данных для данных или столбцов. Например, {‘a’: np.float64, ‘b’: np.int32, ‘c’: ‘Int64’} Используйте
strилиobjectвместе с подходящими настройкамиna_values, чтобы сохранить и не интерпретировать тип данных. Если конвертеры указаны, они будут применяться ВМЕСТО преобразования типа данных. -
engine : {‘c’, ‘python’}, optional -
Используемый движок парсера. Движок C быстрее, в то время как движок Python в настоящее время более функционален.
-
converters : dict, optional -
Словарь функций для преобразования значений в определённых столбцах. Ключи могут быть целыми числами или метками столбцов.
-
true_values : list, optional -
Значения, которые следует считать True.
-
false_values : list, optional -
Значения, которые следует считать False.
-
skipinitialspace : bool, default False -
Пропуск пробелов после разделителя.
-
skiprows : list-like, int or callable, optional -
Номера строк для пропуска (индексирование с 0) или количество строк для пропуска (целое число) в начале файла.
Если это вызываемая функция, вызываемая функция будет оцениваться по отношению к индексам строк, возвращая True, если строка должна быть пропущена, и False в противном случае. Примером допустимого вызываемого аргумента будет
lambda x: x in [0, 2]. -
skipfooter : int, default 0 -
Количество строк внизу файла, которые нужно пропустить (не поддерживается с engine=’c’).
-
nrows : int, optional -
Количество строк файла для чтения. Полезно для чтения фрагментов больших файлов.
-
na_values : scalar, str, list-like, or dict, optional -
Дополнительные строки для распознавания как NA/NaN. Если передан словарь, специфичные для столбцов значения NA. По умолчанию следующие значения интерпретируются как NaN: ‘’, ‘#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’.
-
keep_default_na : bool, default True -
Включать или нет значения NaN по умолчанию при разборе данных. В зависимости от того, передан ли
na_values, поведение таково:- Если
keep_default_naравно True, иna_valuesуказаны,na_valuesдобавляются к значениям NaN по умолчанию, используемым для парсинга. - Если
keep_default_naравно True, иna_valuesне указаны, для парсинга используются только значения NaN по умолчанию. - Если
keep_default_naравно False, иna_valuesуказаны, для парсинга используются только значения NaN, указанныеna_values. - Если
keep_default_naравно False, иna_valuesне указаны, никакие строки не будут анализироваться как NaN.
Обратите внимание, что если
na_filterпередаётся как False, параметрыkeep_default_naиna_valuesбудут игнорироваться. - Если
-
na_filter : bool, default True -
Обнаружение маркеров отсутствующих значений (пустых строк и значения na_values). В данных без каких-либо значений NA передача na_filter=False может улучшить производительность чтения большого файла.
-
verbose : bool, default False -
Указывает количество значений NA, размещённых в нечисловых столбцах.
-
skip_blank_lines : bool, default True -
Если True, пропускать пустые строки, а не интерпретировать как значения NaN.
-
parse_dates : bool or list of int or names or list of lists or dict, default False -
Поведение следующее:
- boolean. Если True -> попытка разбора индекса.
- список из int или имён. Например, Если [1, 2, 3] -> попытка разбора столбцов 1, 2, 3 каждого как отдельного столбца даты.
- список списков. Например, Если [[1, 3]] -> объединение столбцов 1 и 3 и разбор как одного столбца даты.
- словарь, например, {‘foo’ : [1, 3]} -> разбор столбцов 1, 3 как даты и присвоение результата имени ‘foo’
Если столбец или индекс не может быть представлен как массив дат, например, из-за неразборчивого значения или смешения часовых поясов, столбец или индекс будет возвращён без изменений как тип данных object. Для нестандартного разбора дат используйте
pd.to_datetimeпослеpd.read_csv. Для разбора индекса или столбца со смешением часовых поясов укажитеdate_parserв качестве частично применённой функцииpandas.to_datetime()сutc=True. См. Разбор CSV со смешанными часовыми поясами для получения дополнительной информации.Примечание: существует быстрый путь для дат в формате iso8601.
-
infer_datetime_format : bool, default False -
Если True и
parse_datesвключено, pandas попытается определить формат строк дат в столбцах и, если это возможно, переключиться на более быстрый метод их разбора. В некоторых случаях это может увеличить скорость разбора на 5-10 раз. -
keep_date_col : bool, default False -
Если True и
parse_datesопределяет объединение нескольких столбцов, сохраняются исходные столбцы. -
date_parser : function, optional -
Функция для преобразования последовательности столбцов строк в массив экземпляров дат. По умолчанию используется
dateutil.parser.parserдля выполнения преобразования. Pandas попытается вызватьdate_parserтремя разными способами, переходя к следующему, если возникнет исключение: 1) Передать один или несколько массивов (как определено вparse_dates) в качестве аргументов; 2) конкатенировать (по строкам) строковые значения из столбцов, определённыхparse_dates, в один массив и передать его; и 3) вызватьdate_parserодин раз для каждой строки, используя одну или несколько строк (соответствующих столбцам, определённымparse_dates) в качестве аргументов. -
dayfirst : bool, default False -
Даты в формате ДД/ММ, международный и европейский формат.
-
iterator : bool, default False -
Возвращает объект TextFileReader для итерации или получения фрагментов с
get_chunk(). -
chunksize : int, optional -
Возвращает объект TextFileReader для итерации. См. документацию по инструментам ввода-вывода для получения дополнительной информации о
iteratorиchunksize. -
compression : {‘infer’, ‘gzip’, ‘bz2’, ‘zip’, ‘xz’, None}, default ‘infer’
-
-
Для сжатия и распаковки данных на диске. Если ‘infer’ и
filepath_or_buffer— это путь к файлу, то определяется тип сжатия по следующим расширениям: ‘.gz’, ‘.bz2’, ‘.zip’ или ‘.xz’ (иначе сжатие не применяется). Если используется ‘zip’, то ZIP-архив должен содержать только один файл данных для чтения. Установите в значение None, чтобы отключить сжатие.Добавлено в версии 0.18.1: поддержка сжатия ‘zip’ и ‘xz’.
-
thousands : str, optional -
Разделитель тысяч.
-
decimal : str, default ‘.’ -
Символ, определяющий десятичную точку (например, используйте ‘,’ для европейских данных).
-
lineterminator : str (length 1), optional -
Символ для разделения файла на строки. Действителен только для парсера C.
-
quotechar : str (length 1), optional -
Символ, используемый для обозначения начала и конца цитируемого элемента. Цитируемые элементы могут включать разделитель, и он будет пропущен.
-
quoting : int or csv.QUOTE_* instance, default 0 -
Настройка цитирования полей по
csv.QUOTE_*константам. Используйте QUOTE_MINIMAL (0), QUOTE_ALL (1), QUOTE_NONNUMERIC (2) или QUOTE_NONE (3). -
doublequote : bool, default True -
Когда quotechar указан, а quoting не
QUOTE_NONE, указывает, следует ли интерпретировать два последовательных символа quotechar ВНУТРИ поля как одинquotecharэлемент. -
escapechar : str (length 1), optional -
Односимвольная строка, используемая для экранирования других символов.
-
comment : str, optional -
Указывает, что остальная часть строки не должна анализироваться. Если он находится в начале строки, строка игнорируется полностью. Этот параметр должен быть одиночным символом. Как и пустые строки (пока
skip_blank_lines=True), полностью комментируемые строки игнорируются параметромheader, но неskiprows. Например, еслиcomment='#', парсинг#empty\na,b,c\n1,2,3сheader=0приведет к тому, что ‘a,b,c’ будет обрабатываться как заголовок. -
encoding : str, optional -
Кодировка UTF для чтения/записи (например, ‘utf-8’). Список стандартных кодировок Python.
-
dialect : str or csv.Dialect, optional -
Если указан, этот параметр переопределит значения (по умолчанию или нет) для следующих параметров:
delimiter,doublequote,escapechar,skipinitialspace,quotechar, иquoting. При необходимости переопределения значений будет выведено предупреждение ParserWarning. Смотрите документацию csv.Dialect для получения более подробной информации. -
tupleize_cols : bool, default False -
Оставить список кортежей по столбцам как есть (по умолчанию преобразуется в MultiIndex по столбцам).
Устарело начиная с версии 0.21.0: Этот аргумент будет удален и всегда будет преобразовывать в MultiIndex
-
error_bad_lines : bool, default True -
Строки с слишком большим количеством полей (например, строка csv со слишком многими запятыми) по умолчанию вызовут исключение, и DataFrame не будет возвращен. Если False, то эти «плохие строки» будут удалены из возвращаемого DataFrame.
-
warn_bad_lines : bool, default True -
Если error_bad_lines равно False, а warn_bad_lines равно True, будет выведено предупреждение для каждой «плохой строки».
-
delim_whitespace : bool, default False -
Указывает, будут ли пробелы (например,
' 'или' ') использоваться в качестве sep. Эквивалентно установкеsep='\s+'. Если этот параметр установлен в True, то для параметраdelimiterничего не должно передаваться.Добавлено в версии 0.18.1: поддержка парсера Python.
-
low_memory : bool, default True -
Внутренняя обработка файла частями, что приводит к меньшему использованию памяти при анализе, но, возможно, к смешанному выводу типа. Для предотвращения смешанных типов либо установите False, либо укажите тип с помощью параметра
dtype. Обратите внимание, что весь файл считывается в один DataFrame независимо, используйте параметрchunksizeилиiteratorдля возврата данных частями. (Только для парсера C). -
memory_map : bool, default False -
Если для
filepath_or_bufferпредоставлен путь к файлу, файл-объект отображается непосредственно в памяти, и данные из него считываются напрямую. Использование этого параметра может повысить производительность, поскольку больше нет накладных расходов на ввод-вывод. -
float_precision : str, optional -
Указывает, какой преобразователь C-движка должен использоваться для чисел с плавающей точкой. Опции:
Noneдля обычного преобразователя,highдля преобразователя высокой точности иround_tripдля преобразователя с обратным переводом.
Возвращает: - DataFrame или TextParser
-
Файл с разделителями (csv) возвращается как двумерная структура данных с именованными осями.
См. также
Примеры
>>> pd.read_table('data.csv') # doctest: +SKIP-
© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.24.2/reference/api/pandas.read_table.html