Exponenta Banner
exponenta event banner

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

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

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

Синтаксис

T = предварительный просмотр (имя файла, выбор)

Описание

пример

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

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

Поддержка