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 свойства являются взаимоисключающими; то есть, любой Samples, Triggers или Time может быть задан целиком.

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

daqinfo.ObjInfo

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

daqinfo.HwInfo

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

Примеры

Используйте Data Acquisition Toolbox, чтобы получить данные. Объект аналогового входа, ai, получает одну секунду данных для четырех каналов и сохраняет данные к выходному файлу data.daq.

ai = analoginput('nidaq','Dev1');
chans = addchannel(ai,0:3);
set(ai,'SampleRate',1000)
ActualRate = get(ai,'SampleRate');
set(ai,'SamplesPerTrigger, ActualRate)
set(ai,'LoggingMode','Disk&Memory')
set(ai,'LogFileName','data.daq')
start(ai)

После того, как данные были собраны и сохранены в дисковый файл, можно получить данные и другую связанную с приобретением информацию с помощью 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 файлах

  • Формат используется daqread возвратить данные, относительное время, абсолютное время и информация о событии идентично формату, используемому getdata функция, которая является частью Data Acquisition Toolbox. Для получения дополнительной информации см. документацию Data Acquisition Toolbox.

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

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

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

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

  • Data Acquisition Toolbox (.daq) файлы создаются путем определения значения для LogFileName свойство (или принятие значения по умолчанию), и конфигурирование LoggingMode свойство к Disk или Disk&Memory.

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

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

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

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

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

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

Если daqread возвращает данные из нескольких триггеров, данные из каждого триггера разделяются NaN в данных временных рядов. Это увеличивает длину данных и временных векторов в объекте временных рядов количеством триггеров.

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

|