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) файл задан filenamedaqread возвращает data, m-by-n матрица данных, где m является количеством выборок и n, является количеством каналов. Если data включает данные из нескольких триггеров, данные из каждого триггера разделяются NaN. Если вы устанавливаете OutputFormat свойство к tscollectiondaqread возвращает объект набора временных рядов. Смотрите ниже для получения дополнительной информации.

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

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

[data,time,abstime,events] = daqread(...) возвращает журнал событий. events структура, содержащая информацию о событии. Если вы задаете любого theSamplesВремя, или 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. Когда вы задаете tscollectiondaqread только возвращает data.

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

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

daqinfo.ObjInfo

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

daqinfo.HwInfo

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

Примеры

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

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

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

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

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

Выборки только для чтения 1 000 - 2 000 из индексов 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Время, или Triggers.

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

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

Больше о возвращенном объекте набора временных рядов

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

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

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

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

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

Смотрите также

|