mdfDatastore

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

Описание

Используйте объект MDF datastore для доступа к данным из набора 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

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

Укажите необязательные аргументы в виде пар «» имя, значение «», разделенных запятыми, чтобы задать информацию о файле или свойствах объекта. Допустимые опции IncludeSubfolders, FileExtensions, и свойства ReadSize, SelectedChannelGroupNumber, и SelectedChannelNames.

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

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

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

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

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

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

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

Свойства

расширить все

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

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

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

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

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

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

Типы данных: 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

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

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

Пример: '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 datastore
readallСчитайте все данные в MDF datastore
previewПодмножество данных из MDF datastore
resetСбросьте MDF-хранилище datastore в начальное состояние
hasdataОпределите, доступны ли данные для чтения из MDF datastore
partitionPartition MDF datastore
numpartitionsКоличество разделов для MDF datastore
combine (MATLAB)Объедините данные из нескольких хранилищ данных
transform (MATLAB)Преобразуйте datastore
isPartitionable (MATLAB)Определите, является ли datastore разделяемым
isShuffleable (MATLAB)Определите, является ли datastore shuffleable

Примеры

свернуть все

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

mdfds = mdfDatastore(fullfile(matlabroot,'examples','vnt','data','CANape.MF4'));
while hasdata(mdfds)
    m = read(mdfds);
end
Введенный в R2017b
Для просмотра документации необходимо авторизоваться на сайте