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 (эксклюзивно). The 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 Toolbox

Поддержка