daqread

Чтение Data Acquisition Toolbox (.daq) файл

Синтаксис

data = daqread('filename')
[data,time] = daqread(...)
[data,time,abstime] = daqread(...)
[data,time,abstime,events] = daqread(...)
[data,time,abstime,events,daqinfo] = daqread(...)
data = daqread(...,'Param1', Val1,...)
daqinfo = daqread('filename','info')

Описание

data = daqread('filename') считывает все данные из Data Acquisition Toolbox™ (.daq) файл, заданный filename. daqread возвращает data, матрица m -by n данных, где m - количество выборок, а n - количество каналов. Если data включает данные от нескольких триггеров, данные от каждого триггера разделяются NaN. Если вы задаете OutputFormat свойство к tscollection, daqread возвращает объект набора временных рядов. Для получения дополнительной информации см. ниже.

[data,time] = daqread(...) возвращает пары время/значение. time - вектор m -by-1, такой же длины, как data, который содержит относительное время для каждой выборки. Относительное время измеряется относительно первого возникающего триггера.

[data,time,abstime] = daqread(...) возвращает абсолютное время первого триггера. abstime возвращается как clock вектор.

[data,time,abstime,events] = daqread(...) возвращает журнал событий. events - структура, содержащая информацию о событии. Если вы задаете либо Samples, Time, или Triggers параметры (см. ниже), структура событий содержит только указанные события.

[data,time,abstime,events,daqinfo] = daqread(...) возвращает структуру, daqinfo, который содержит два поля: ObjInfo и HwInfo. ObjInfo - структура, содержащая пары имя/значение свойства и HwInfo - структура, содержащая аппаратную информацию. Весь журнал событий возвращается в daqinfo.ObjInfo.EventLog.

data = daqread(...,'Param1', Val1,...) определяет объем возвращаемых данных и формат данных, используя следующие параметры.

Параметр

Описание

Samples

Задайте область значений образцов.

Time

Задайте относительную временную область значений.

Triggers

Задайте область значений триггеров.

Channels

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

DataFormat

Задайте формат данных следующим doubles (по умолчанию) или native.

TimeFormat

Задайте формат времени следующим vector (по умолчанию) или matrix.

OutputFormat

Задайте выход следующим matrix (по умолчанию) или tscollection. Когда вы задаете tscollection, daqread возвращает только data.

The Samples, Time, и Triggers свойства являются взаимоисключающими; то есть в вызове функции можно задать только один из них.

daqinfo = daqread('filename','info') возвращает метаданные из файла в daqinfo structure, без возникновения накладных расходов на чтение данных из файла. The daqinfo структура содержит два поля:

daqinfo.ObjInfo

структура, содержащая пары параметр/значение для объекта сбора данных, используемого для создания файла, filename. Примечание: The UserData значение свойства не восстанавливается.

daqinfo.HwInfo

структуру, содержащую аппаратную информацию. Весь журнал событий возвращается в daqinfo.ObjInfo.EventLog.

Примеры

В этом примере показано, как считать данные, которые были сохранены в файле журнала data.daq в более раннем релизе. Это логгирование было достигнуто путем определения свойств логгирования analoginput объект, как описано в analoginput. Вы используете daqread для извлечения данных и другой информации, связанной с получением.

Считайте все пары шаг расчета из data.daq:

[data,time] = daqread('data.daq');

Считайте выборки от 500 до 1000 для всех каналов от data.daq:

data = daqread('data.daq','Samples',[500 1000]);

Считывайте только выборки с 1000 по 2000 индексов канала 2, 4 и 7 в основном формате из файла data.daq:

data = daqread('data.daq', 'Samples', [1000 2000],...
               'Channels', [2 4 7], 'DataFormat', 'native');

Считывайте только данные, которые представляют первый и второй триггеры на всех каналах из файла data.daq:

[data,time] = daqread('data.daq', 'Triggers', [1 2]);

Получите информацию о свойствах канала от data.daq:

daqinfo = daqread('data.daq','info');
chaninfo = daqinfo.ObjInfo.Channel;

Получите список типов событий и данных о событиях, содержащихся в data.daq:

daqinfo = daqread('data.daq','info');
events = daqinfo.ObjInfo.EventLog;
event_type = {events.Type};
event_data = {events.Data};

Считайте все данные из файла data.daq и возвращает его как объект набора временных рядов:

data = daqread('data.daq','OutputFormat','tscollection');

Совет

Подробнее о .daq файлах

  • Если считываются данные из нескольких триггеров, то размер получившегося массива данных увеличивается на количество выданных триггеров, потому что каждый триггер разделяется NaN.

  • ObjInfo.EventLog всегда содержит весь журнал событий независимо от значения, заданного в Samples, Time, или Triggers.

  • The UserData значение свойства не восстанавливается, когда вы возвращаете объект устройства (ObjInfo) информацию.

  • При чтении .daq файл, daqread функция не возвращает значения свойств, заданные как массив ячеек.

Возвращен объект набора временных рядов

Когда OutputFormat установлено в tscollection, daqread возвращает объект набора временных рядов. Этот объект набора временных рядов содержит объект абсолютного временного ряда для каждого канала в файле. Следующее описывает, как daqread устанавливает некоторые свойства объекта набора временных рядов и объектов временных рядов.

  • The time свойство объекта набора временных рядов устанавливается в значение InitialTriggerTime свойство, заданное в файле.

  • The name свойство каждого объекта временных рядов устанавливается в значение Name свойство канала в файле. Если это имя не может использоваться как временные ряды имя объекта, daqread задает имя 'Channel' с HwChannel свойство канала, приложенного.

  • Значение Units свойство объекта временных рядов зависит от значения DataFormat параметр. Если на DataFormat параметру задано значение 'double', daqread устанавливает DataInfo свойство каждого объекта временных рядов в наборе к значению Units свойство соответствующего канала в файле. Если на DataFormat параметру задано значение 'native', daqread устанавливает Units свойство к 'native'.

  • Каждый объект временных рядов будет иметь tsdata.event объекты, соответствующие журналу событий, связанных с каналом.

См. также

|