mdfDatastore

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

Описание

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

Создание

Описание

пример

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

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

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

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

Местоположение файлов 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

Опция преобразования для данных MDF-файла в виде 'Numeric'все, или 'None'.

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

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

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

Пример: 'All'

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

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

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
isPartitionable (MATLAB)Определите, partitionable ли datastore
isShuffleable (MATLAB)Определите, shuffleable ли datastore

Примеры

свернуть все

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

mdfds = mdfDatastore(fullfile(matlabroot,'examples','vnt','data','CANape.MF4'));
while hasdata(mdfds)
    m = read(mdfds);
end
Введенный в R2017b