preview

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

Свернуть все на странице

Синтаксис

T = preview(filename,opts)

Описание

пример

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

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

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

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

Примеры

свернуть все

Открыть Live Script

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

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

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 функция. The opts объект содержит свойства, которые управляют процессом импорта данных. Для получения дополнительной информации о свойствах отдельных объектов см. соответствующую страницу объекта.

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

Алгоритмы

  • The preview функция возвращает менее восьми строк в следующих случаях:

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

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

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

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

См. также

| | | |

Введенный в R2018a

Документация MATLAB

Поддержка

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