read

Считайте данные о канале из MDF-файла

Описание

пример

data = read(mdfObj) Считывает все данные для всех каналов от MDF-файла, идентифицированного объектом mdfObj MDF-файла, и присваивает выход data. Если данные о файле являются одной группой канала, выход является расписанием; несколько групп канала возвращены как массив ячеек расписаний, где индекс массива ячеек соответствует номеру группы канала.

Примечание

Эта функция поддерживается только на 64-битных операционных системах Windows®.

пример

data = read(mdfObj,chanGroupIndex,chanName) Считывает все данные для заданного канала от MDF-файла, идентифицированного объектом mdfObj MDF-файла.

пример

data = read(mdfObj,chanGroupIndex,chanName,startPosition) считывает данные из положения, заданного startPosition.

пример

data = read(mdfObj,chanGroupIndex,chanName,startPosition,endPosition) считывает данные для диапазона, указанного от startPosition к endPosition.

пример

data = read(mdfObj,chanGroupIndex,chanName,startPosition,endPosition,'OutputFormat',fmtType) возвращает данные с заданным выходным форматом.

пример

[data,time] = read(mdfObj,chanGroupIndex,chanName,startPosition,endPosition,'OutputFormat','Vector') возвращает два вектора данных о канале и соответствующих меток времени.

Примеры

свернуть все

Считайте все доступные данные из MDF-файла.

mdfObj = mdf('MDFFile.mf4');
data = read(mdfObj);

Считайте все доступные данные из MDF-файла для заданных каналов.

mdfObj = mdf('MDFFile.mf4');
data = read(mdfObj,1,{'Channel1','Channel2'});

Считайте область значений данных из индексации использующего MDF-файла для startPosition и endPosition указывать диапазон данных.

mdfObj = mdf('MDFFile.mf4');
data = read(mdfObj,1,{'Channel1','Channel2'},1,10);

Считайте область значений данных из MDF-файла с помощью временных стоимостей в startPosition и endPosition указывать диапазон данных.

mdfObj = mdf('MDFFile.mf4');
data = read(mdfObj,1,{'Channel1','Channel2'},seconds(5.5),seconds(7.3));

Считайте все доступные данные из MDF-файла, возвратив данные и временные векторы.

mdfObj = mdf('MDFFile.mf4');
[data,time] = read(mdfObj,1,'Channel1','OutputFormat','Vector');

Считайте все доступные данные из MDF-файла, возвратив данные временных рядов.

mdfObj = mdf('MDFFile.mf4');
data = read(mdfObj,1,'Channel1','OutputFormat','TimeSeries');

Считайте данные из канала, идентифицированного channelList функция.

Получите список каналов и отобразите их имена и числа группы.

mdfObj = mdf('File05.mf4');
chlist = channelList(mdfObj);
chlist(:,1:2)
  4×2 table

                ChannelName                 ChannelGroupNumber
    ____________________________________    __________________

    "Float_32_LE_Offset_64"                         2         
    "Float_64_LE_Master_Offset_0"                   2

Считайте данные из первого канала в списке.

data = read(mdfObj,chlist{1,2},chlist{1,1});
data(1:5,:)
  5×1 timetable

      Time      Float_32_LE_Offset_64
    ________    _____________________

    0 sec                  5         
    0.01 sec             5.1         
    0.02 sec             5.2         
    0.03 sec             5.3         
    0.04 sec             5.4

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

свернуть все

MDF-файл, заданный как объект MDF-файла.

Пример: mdf('MDFFile.mf4')

Индекс группы канала, заданной как числовое значение, которое идентифицирует группу канала, из которой можно читать.

Пример 1

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

Пример: 'Channel1'

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

Первое положение данных о канале, заданных как числовое значение или длительность. startPosition опция задает первое положение, из которого можно считать данные о канале. Введите числовое значение, чтобы задать положение индекса; используйте длительность, чтобы задать положение времени. Если только startPosition обеспечивается без endPosition опция, значение данных в том местоположении возвращено. Когда используется с endPosition чтобы указать диапазон, функция возвращает данные из startPosition (включительно) к endPosition (невключительно).

Пример 1

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration

Последняя позиция диапазона данных о канале, указанного как числовое значение или длительность. endPosition опция задает последнюю позицию для чтения области значений данных о канале. Предоставьте обоим startPosition и endPosition задавать извлечение области значений данных. Функция возвращается до, но не включая endPosition при чтении области значений. Введите числовое значение, чтобы задать положение индекса; используйте длительность, чтобы задать положение времени.

Пример: 1000

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration

Формат для выходных данных, заданных как вектор символов или строка. Эта опция форматирует выход согласно следующей таблице.

'OutputFormat' Описание
'Timetable'

Возвратите расписание в один или несколько каналов в одну выходную переменную. Это - единственный формат, позволенный при чтении из нескольких каналов одновременно. (Значение по умолчанию).

Примечание: формат расписания включает столбцы для каналов MDF. Поскольку заголовки столбцов должны быть допустимыми идентификаторами MATLAB®, они не могут быть точно тем же самым как теми значениями в объекте MDF ChannelNames свойство. Заголовки столбцов выведены из свойства с помощью функционального matlab.lang.makeValidName. Исходные названия канала доступны в VariableDescriptions свойство timetable объект.

'Vector'Возвратите вектор значений числовых данных, и опционально вектор временных стоимостей от одного канала. Используйте одну выходную переменную, чтобы возвратить только данные или две выходных переменные, чтобы возвратить и данные и временные векторы.
'TimeSeries'Возвратите временные ряды данных из одного канала.

Пример: 'Vector'

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

Выходные аргументы

свернуть все

Данные о канале, возвращенные как вектор, удваиваются, временные ряды, расписание или массив ячеек расписаний, согласно 'OutputFormat' установка опции и количество групп канала.

Времена данных о канале, возвращенные как вектор двойных элементов. Временной вектор возвращен только когда 'OutputFormat' установлен в 'Vector'.

Введенный в R2017b

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