exponenta event banner

daqread

Считывание инструментария сбора данных (.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') считывает все данные из Toolbox™ сбора данных (.daq) файл, указанный filename. daqread прибыль dataматрица данных m-на-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.

Samples, Time, и 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 до 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.

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

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

Дополнительные сведения о возвращенном объекте коллекции временных рядов

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

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

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

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

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

См. также

|