Exponenta Banner
exponenta event banner

mdfDatastore

Хранилище данных для сбора файлов MDF

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

Описание

Объект хранилища данных MDF используется для доступа к данным из коллекции файлов MDF.

Создание

Синтаксис

mdfds = mdfDatastore (расположение)
mdfds = mdfDatastore (__, 'Имя 1', Value1, 'Имя 2', Value2,...)

Описание

пример

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

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

Примечание

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

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

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

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

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

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

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

Укажите дополнительные пары «Имя», «Значение», разделенные запятыми, чтобы задать сведения о файле или свойства объекта. Разрешенные параметры: IncludeSubfolders, FileExtensions, и свойства ReadSize, SelectedChannelGroupNumber, и SelectedChannelNames.

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

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

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

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

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

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

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

Свойства

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

Это свойство доступно только для чтения.

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

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

Это свойство доступно только для чтения.

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

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

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

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

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

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

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

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

Пример: 50

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

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

Пример: 1

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

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

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

Пример: 'Counter_B4'

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

Параметр преобразования для данных MDF-файла, указанный как 'Numeric', 'All', или 'None'.

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

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

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

Пример: 'All'

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

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

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

Примеры

свернуть все

Создание хранилища данных MDF из файла образца CANape.MF4и прочтите его в расписание.

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

См. также

Темы

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

Документация по комплекту инструментов для сети транспортных средств

Поддержка