Exponenta Banner
exponenta event banner

читать

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

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

Синтаксис

data = чтение (mdfObj)
data = read (mdfObj, chanList)
data = read (mdfObj, chanGroupIndex, chanName)
data = read (mdfObj, chanGroupIndex, chanName, startPosition)
data = read (mdfObj, chanGroupIndex, chanName, startPosition, endPosition)
data = read (___, 'Преобразование', convOpt)
data = read (___, 'OutputFormat', fmtType)
[data, time] = чтение (___, 'OutputFormat', 'Vector')

Описание

пример

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

пример

data = read(mdfObj,chanList) считывает все данные для всех каналов, указанных в таблице списка каналов chanList.

пример

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

пример

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

пример

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

пример

data = read(___,'Conversion',convOpt) применяет указанную опцию преобразования к данным MDF при их чтении в. Эта опция переопределяет настройку Conversion имущества mdf объект.

пример

data = read(___,'OutputFormat',fmtType) возвращает данные с указанным форматом вывода.

пример

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

Примеры

свернуть все

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

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

Считывание необработанных данных из указанного канала в первой группе каналов без применения каких-либо правил преобразования.

mdfObj = mdf('MDFFile.mf4');
data = read(mdfObj,1,'Unsigend_UInt32_LE_Master_Offset_0','Conversion','None');
data(1:4,:)
ans =

  4×1 timetable

    Time     Unsigend_UInt32_LE_Master_Offset_0
    _____    __________________________________

    0 sec                    0
    1 sec                    1
    2 sec                    2 
    3 sec                    3

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

mdfObj = mdf('MDFFile.mf4');
chanList = channelList(mdfObj) % Channel table
data = read(mdfObj,chanList(1:3,:)); % First 3 channels

Считывайте все доступные данные из 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,1:2) % Display 2 channels, 2 columns
  2×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')

Список каналов, указанный как таблица в формате, возвращаемом channelList(Панель инструментов сети транспортных средств).

Пример: channelList()

Типы данных: table

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

Пример: 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

Параметр преобразования для данных MDF-файла, указанный как 'Numeric', 'All', или 'None'. По умолчанию используется значение, указанное в Conversion имущества mdf объект.

  • 'Numeric' - Примените только числовые конверсионные правила (CC_Type 1-6). Данные с нечисловыми правилами преобразования импортируются как необработанные, не преобразованные значения.

  • 'None' - Не применять никакие правила преобразования. Все данные импортируются как необработанные.

  • 'All' - Примените всех числовых и текстовые конверсионные правила (CC_Type 1-10).

Пример: 'All'

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

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

свернуть все

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

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

См. также

Функции

Темы

Представлен в R2016b

Документация по блокам силового агрегата

Поддержка