Exponenta Banner
exponenta event banner

readRaw

Считывание необработанных данных указанного временного диапазона с сервера HDA

свернуть все на странице

Синтаксис

DObj = readRaw (HdaClient, ItmList, StartTime, EndTime)
DObj = readRaw (HdaClient, ItmList, StartTime, EndTime, ExtendedBounds)

Описание

пример

DObj = readRaw(HdaClient,ItmList,StartTime,EndTime) считывает данные из элементов, определенных ItmList, хранится на сервере OPC HDA, подключенном к клиенту OPC HDA HdaClient, между StartTime (включительно) и EndTime (эксклюзивно). StartTime и EndTime аргументы должны быть номерами дат или векторами символов, которые могут быть преобразованы в номер даты MATLAB ® .DObj возвращается как opc.hda.Data массив, с одним элементом на элемент, указанный в ItmList.

DObj = readRaw(HdaClient,ItmList,StartTime,EndTime,ExtendedBounds) позволяет задать удлинение границы. Если ExtendedBounds является true, то возвращается первая точка данных на или за пределами определенного времени начала и окончания. Если ExtendedBounds является false, то только значения, которые были помечены по времени между StartTime (включительно) и EndTime (эксклюзивные) включены.

Одна или несколько временных меток, возвращаемых для каждого элемента, могут быть уникальными для этого элемента. Для получения выровненных данных с сервера OPC HDA используйте readAtTime или readProcessed.

Примеры

свернуть все

Считывание данных за последние сутки с двух элементов на сервере OPC HDA.

Создайте клиент OPC HDA и подключите его к серверу.

hdaObj = opchda('localhost','Matrikon.OPC.Simulation');
connect(hdaObj);

Считывание данных за последний день из двух указанных элементов.

DObj = readRaw(hdaObj,{'Random.Real8','Random.Real4'},now-1,now);

Входные аргументы

свернуть все

Клиент OPC HDA, указанный как объект клиента OPC HDA.

Пример: opchda()

Элементы HDA, указанные как символьный вектор, строка или поддерживающий массив.

Пример: {'Random.Real8','Random.Real4'}

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

Временные границы, указанные как серийные номера. Значения могут быть удвоенными, например, значения, возвращаемые datenum или now функции или векторы символов, которые можно преобразовать в номера дат.

Пример: datenum(2018,11,30)

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

Расширение временных границ для обеспечения включения времени начала и окончания, указанного как false или true.

Этот флаг указывает серверу истории, следует ли полностью охватить требуемое время начала и окончания или возвращать только те значения, которые содержатся в пределах указанного времени начала и окончания (время начала включено, но не время окончания). Если ExtendedBounds true, возвращаемые значения гарантированно включают временную метку в указанное время начала или до него, а также в указанное время окончания или после него. Если ExtendedBounds false, нет гарантии, что значения включают точное указанное время начала и определенно не включают указанное время окончания. Правила, применяемые этим флагом:

  • Если ExtendedBounds является false (по умолчанию) сервер возвращает все записанные данные от времени запуска до времени окончания, но не включая его.

  • Если ExtendedBounds является trueсервер возвращает все данные от времени начала до времени окончания (включительно). Если в момент начала данных точно не существует, возвращается предыдущее значение; если значение данных не существует точно в момент окончания, возвращается следующее значение; даже если эти значения находятся за пределами указанного времени начала и окончания.

  • Если ExtendedBounds является true и нет данных о времени начала или до него, сервер включает значение Empty на начальной отметке времени и качество OPCHDA_NOBOUND («Без привязки»). Аналогично для конечного времени.

Пример: true

Типы данных: logical

Выходные аргументы

свернуть все

Необработанные данные OPC HDA возвращены как массив объектов данных OPC HDA с одним элементом на элемент.

См. также

Функции

Представлен в R2011a

Документация по панели инструментов OPC

Поддержка