предварительный просмотр

Предварительный просмотр восьми строк из файла с помощью параметров импорта

Синтаксис

T = preview(filename,opts)

Описание

пример

T = preview(filename,opts) возвращает таблицу, содержащую первые восемь строк данных в filename, с помощью настроек импорта opts.

  • Значение свойства SelectedVariableNames объекта opts настроек импорта выбирает переменные, которые появляются в таблице T.

  • Функция предварительного просмотра возвращает подмножество данных, которые функция readtable возвращает с объектом opts настроек импорта.

  • Обычно, вывод функции preview содержит восемь строк данных. Однако в некоторых случаях количество строк отличается в зависимости от значений свойств, заданных в объекте opts настроек импорта. Для получения дополнительной информации смотрите, Советы.

Примеры

свернуть все

Во-первых, создайте объект настроек импорта. Затем, используйте настройки импорта, чтобы получить первые восемь строк таблицы, и затем сгенерировать предварительный просмотр, показывающий только переменные интереса.

Создайте объект настроек импорта для файла.

filename = 'outages.csv';
opts = detectImportOptions(filename);

Предварительно просмотрите таблицу.

preview(filename,opts)
ans=8×6 table
      Region            OutageTime          Loss     Customers       RestorationTime             Cause      
    ___________    ____________________    ______    __________    ____________________    _________________

    'SouthWest'    01-Feb-2002 12:18:00    458.98    1.8202e+06    07-Feb-2002 16:50:00    'winter storm'   
    'SouthEast'    23-Jan-2003 00:49:00    530.14    2.1204e+05                     NaT    'winter storm'   
    'SouthEast'    07-Feb-2003 21:15:00     289.4    1.4294e+05    17-Feb-2003 08:14:00    'winter storm'   
    'West'         06-Apr-2004 05:44:00    434.81    3.4037e+05    06-Apr-2004 06:10:00    'equipment fault'
    'MidWest'      16-Mar-2002 06:18:00    186.44    2.1275e+05    18-Mar-2002 23:23:00    'severe storm'   
    'West'         18-Jun-2003 02:49:00         0             0    18-Jun-2003 10:54:00    'attack'         
    'West'         20-Jun-2004 14:39:00    231.29           NaN    20-Jun-2004 19:16:00    'equipment fault'
    'West'         06-Jun-2002 19:28:00    311.86           NaN    07-Jun-2002 00:51:00    'equipment fault'

Выберите который переменные включать в предварительный просмотр и операции чтения.

opts.SelectedVariableNames = {'Region','OutageTime'};

Предварительно просмотрите первые восемь строк и выбранные переменные.

preview(filename,opts)
ans=8×2 table
      Region            OutageTime     
    ___________    ____________________

    'SouthWest'    01-Feb-2002 12:18:00
    'SouthEast'    23-Jan-2003 00:49:00
    'SouthEast'    07-Feb-2003 21:15:00
    'West'         06-Apr-2004 05:44:00
    'MidWest'      16-Mar-2002 06:18:00
    'West'         18-Jun-2003 02:49:00
    'West'         20-Jun-2004 14:39:00
    'West'         06-Jun-2002 19:28:00

Входные параметры

свернуть все

Имя файла, чтобы читать, заданный как вектор символов или скаляр строки.

Пример: 'myFile.xlsx'

Типы данных: char | string

Настройки импорта файла, заданные как SpreadsheetImportOptions, объект DelimitedTextImportOptions или FixedWidthImportOptions создается функцией detectImportOptions. Объект opts содержит свойства, которые управляют процессом импорта данных. Для получения дополнительной информации о свойствах для отдельных объектов смотрите соответствующую объектную страницу.

Тип файловВывод
Файлы электронной таблицыОбъект SpreadsheetImportOptions
Текстовые файлыОбъект DelimitedTextImportOptions
Текстовые файлы фиксированной шириныОбъект FixedWidthImportOptions

Алгоритмы

  • Функция preview возвращает меньше чем восемь строк в этих случаях:

    • Когда файл содержит меньше чем восемь строк данных.

    • Когда DataLines или свойства DataRange объекта opts задают меньше чем восемь строк.

    • Когда комбинация свойств объекта opts приводит меньше чем к восьми строкам данных. Например, preview возвращает меньше чем восемь строк, когда значение EmptyLineRule, ImportErrorRule или MissingRule объекта opts заставляет функцию импорта не использовать данные.

  • Когда DataLines или свойство DataRange объекта opts задают несколько областей значений строки, и первая область значений строки охватывает меньше чем восемь строк, затем preview возвращает строки в первую область значений строки, сопровождаемую строками из последовательных областей значений строки, пока это не достигает в общей сложности восьми строк.

Смотрите также

| | | |

Введенный в R2018a

Для просмотра документации необходимо авторизоваться на сайте