mdfDatastore

Datastore для набора MDF-файлов

Описание

Используйте объект datastore MDF получить доступ к данным из набора MDF-файлов.

Создание

Описание

пример

mdfds = mdfDatastore(location) создает MDFDatastore на основе MDF-файла или набора файлов в папке, заданной location. Все файлы в папке с расширениями .mdf, .dat, или .mf4 включены.

mdfds = mdfDatastore(__,'Name1',Value1,'Name2',Value2,...) задает функциональные опции и свойства mdfds использование дополнительных пар "имя-значение".

Примечание

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

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

развернуть все

Местоположение файлов datastore MDF, заданных как вектор символов, массив ячеек из символьных векторов или matlab.io.datastore.DsFileSet объект, идентифицирующий или файлы или папки. Путь может быть относительным или абсолютным, и может содержать подстановочный символ *. Если location задает папку, по умолчанию datastore включает все файлы в ту папку с расширениями .mdf, .dat, или .mf4.

Пример: 'CANape.MF4'

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

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Имени, аргументы Value, чтобы установить информацию о файле или свойства объектов. Позволенными опциями является IncludeSubfolders'FileExtensions' , и свойства ReadSize, SelectedChannelGroupNumber, и SelectedChannelNames.

Пример: 'SelectedChannelNames','Counter_B4'

Включайте файлы в подпапки, заданные как логическое. Задайте true включать файлы в каждую папку и рекурсивно в подпапки.

Пример: 'IncludeSubfolders',true

Типы данных: логический

Пользовательские расширения для имен файлов, чтобы включать в datastore MDF, заданный как вектор символов или массив ячеек из символьных векторов. По умолчанию поддерживаемые расширения включают .mdf, .dat, и .mf4. Если ваши файлы имеют пользовательские или нестандартные расширения, используйте эту установку Name-Value, чтобы включать файлы с теми расширениями.

Пример: 'FileExtensions',{'.myformat1','.myformat2'}

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

Свойства

развернуть все

Все группы канала, существующие в первом MDF-файле, возвращенном как таблица.

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

Все каналы, существующие в первом MDF-файле, возвращенном как таблица.

Те каналы, предназначенные для чтения, должны иметь то же имя и принадлежать той же группе канала в каждом файле datastore MDF

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

Файлы включены в datastore, заданный как вектор символов, строка или массив ячеек.

Пример: {'file1.mf4','file2.mf4'}

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

Размер данных возвращен read функция, заданная как 'file', числовое значение или длительность. Значение вектора символов 'file' заставляет целый файл быть считанным; числовое двойное значение задает количество записей в чтение; и значение длительности указывает диапазон времени в чтение.

Если вы позже изменяете ReadSize тип значения свойства, сброс datastore.

Пример: 50

Типы данных: double | char | duration

Группа канала, чтобы читать, заданный как значение числового скаляра.

Пример 1

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

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

Те каналы, предназначенные для чтения, должны иметь то же имя и принадлежать той же группе канала в каждом файле datastore MDF.

Пример: 'Counter_B4'

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

Функции объекта

readСчитайте данные в datastore MDF
readallСчитывайте все данные в datastore MDF
previewПодмножество данных из datastore MDF
resetСбросьте datastore MDF к начальному состоянию
hasdataОпределите, доступны ли данные, чтобы читать из datastore MDF
partitionРаздел datastore MDF
numpartitionsКоличество разделов для datastore MDF
combine (MATLAB)Объедините данные от нескольких datastores
transform (MATLAB)Преобразуйте datastore

Примеры

свернуть все

Создайте datastore MDF из файла примера CANape.MF4, и считайте его в расписание.

mdfds = mdfDatastore(fullfile(matlabroot,'examples','vnt','CANape.MF4'));
while hasdata(mdfds)
    m = read(mdfds);
end 

Введенный в R2017b