Добавил:
Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:

книги / Создание интегрированных систем управления. Работы по проектированию, конфигурированию и наладке

.pdf
Скачиваний:
4
Добавлен:
12.11.2023
Размер:
16.59 Mб
Скачать

Функция: PISampDat (tagname, stime, etime, interval, outcode, PIServer).

Аргументы

Аргумент

Тип аргумента

Описание

Tagname

String

Имя тэга, для которого необходимо получить дан-

 

 

ные выборки

Stime

String

Начальное время в формате времени PI

Etime

String

Конечное время в формате времени PI

Interval

String

Интервал выборки в формате времени PI

Outcode

Integer

Код вывода; 0, 1, 2 или 3

PIServer

String

Имя сервера PI

Возвращаемые значения:

Аргумент Outcode

Колонка 1

Колонка 2

0

Данные выборки

 

1

Метки времени

Данные выборки

При значении outputcode = 2 выходной массив, получаемый при outputcode = 0, транспонируется, а при значении outputcode = 3 транспонируется выходной массив, получаемый при outputcode = 1.

3.2.2.7. Диалоговое окно Compressed Data (Number)

Это диалоговое окно возвращает сжатые данные из архива PI Data Archive на основании начального времени и указанного количества точек данных.

Требуемые поля:

Tagname (имя тэга).

Start Time (начальное время).

Number of data points (число точек данных).

Это диалоговое окно возвращает #N/A, когда имеется меньшее число значений, чем указанное. Например, если вы хотите получить 400 значений, начиная с полуночи сегодня, а в архиве имеется только 356 значений, то в последних 44 ячейках будет выведено #N/A.

Функция: PINCompDat (tagname, stime, numvals, outcode, PIServer).

101

Аргумент

Тип аргумента

Описание

Tagname

String

Имя тэга, для которого необходимо получить сжа-

 

 

тые значения

Stime

String

Начальное время в формате времени PI

Numvals

Integer

Количество сжатых точек данных. Используйте

 

 

отрицательные значения для запроса данных,

 

 

предшествующих времени в поле Stime

Outcode

integer

Код вывода; 0, 1, 2 или 3

PIServer

string

Имя сервера PI

Возвращаемые значения:

Аргумент Outcode

Колонка 1

Колонка 2

0

Сжатые данные

 

1

Метки времени

Сжатые данные

При значении outputcode = 2 выходной массив, получаемый при outputcode = 0, транспонируется, а при значении outputcode = 3 транспонируется выходной массив, получаемый при outputcode = 1 .

3.2.2.8. Диалоговое окно Compressed Data (Times)

Это диалоговое окно возвращает сжатые данные из архива PI Data Archive на основании начального времени и конечного времени. Количество точек данных, полученных для указанного интервала времени, возвращается в первой ячейке.

Требуемые поля:

Tagname (имя тэга).

Start Time (начальное время).

End Time (конечное время).

Это диалоговое окно возвращает #N/A в неиспользуемых ячейках, если в архиве имеется меньшее число точек данных, чем ячеек, указанных в выходном массиве. Эта ситуация может возникнуть в случае использования относительного времени. Например, если вы получаете значения, начиная с момента времени y до момента времени y+5h, то число значений в архиве PI может быть различным для различных дней.

Функция: PICompDat (tagname, stime, etime, outcode, PIServer).

102

Аргумент

Тип аргумента

Описание

Tagname

String

Имя тэга, для которого необходимо получить

 

 

сжатые значения

Stime

String

Начальное время в формате времени PI

Etime

String

Конечное время в формате времени PI

Outcode

Integer

Код вывода; 0, 1, 2 или 3

PIServer

String

Сервер PI

Возвращаемые значения:

Аргумент Outcode

Колонка 1

Колонка 2

0

Сжатые данные

 

1

Метки времени

Сжатые данные

При значении outputcode = 2 выходной массив, получаемый при outputcode = 0, транспонируется, а при значении outputcode = 3 транспонируется выходной массив, получаемый при outputcode = 1. Число точек данных, возвращаемых для указанного интервала времени, выводится в первой ячейки строки/колонки.

3.2.2.9. Диалоговое окно Timed Data

Это диалоговое окно возвращает выборку значений для одного тэга, синхронизированных с массивом меток времени.

Требуемые поля:

Tagname (имя тэга).

Timestamp (метки времени). Поле меток времени должно ссылаться на массив меток времени. Метки времени в этом массиве должны быть либо монотонно убывающими, либо монотонно возрастающими.

Функция: PITimeDat(tagname, timestamps, PIServer).

Аргументы

Аргумент

Тип аргумента

Описание

Tagname

String

Имя тэга, для которого необходимо получить выборку

 

 

значений

Timestamps

Ссылка

Ссылка на массив времен в формате времени PI. Вре-

 

 

мена в этом массиве должны быть либо монотонно

 

 

убывающими, либо монотонно возрастающими

PIServer

String

Имя сервера PI

103

Возвращаемые значения:

Данные выборки. Если метки времени расположены в колонке, то данные возвращаются также в колонку. Если метки времени расположены в строке, то данные возвращаются также в строку.

3.2.2.10. Диалоговое окно Calculated Data

Это диалоговое окно возвращает равноотстоящие по времени вычисленные значения из архива PI. Вариантом вычисления может быть total, minimum, maximum, stdev, range, average или mean.

Требуемые поля:

Tagname. Ссылка поля Tagname может быть массивом.

Start Time (начальное время).

End Time (конечное время).

Time Interval (интервал времени).

Conversion Factor (коэффициент преобразования).

Calculation Mode (вариант вычисления).

Функция: PICalcDat (tagname, stime, etime, interval, mode, cfactor, outcode, PIServer).

Аргументы

Аргумент

Тип аргумента

Описание

tagname

String

Имя тэга, для которого необходимо вычислять

 

 

значения

stime

String

Начальное время в формате времени PI

Etime

String

Конечное время в формате времени PI

Interval

String

Интервал времени в формате времени PI

Mode

String

Вариант вычисления (total, minimum, maximum,

 

 

stdev, range, average или mean)

Cfactor

Number (число

Коэффициент преобразования. Должно быть 1

 

с плав точкой)

для max, min, avg, std и range. Для total смотри-

 

 

те Замечание в подразделе PicalcVal()

Outcode

Integer (целое)

Код вывода; от 0 до 7

PIServer

String

Имя сервера PI

Возвращаемые значения:

Значениеаргументаoutcode влияетнавыводследующимобразом: 0 – вычисленные значения располагаются в столбце;

104

 

1

– метки времени и значения располагаются в 2

столбцах;

 

2

– вычисленные значения располагаются в строке;

 

3

– метки времени и значения располагаются в 2

строках;

 

4

– значения и pctgood располагаются в 2 столбцах;

 

5 – метки

времени,

значения

и

pctgood

располагаются

в 3

столбцах;

 

 

 

 

 

 

6

– значения и pctgood располагаются в 2 строках;

 

7 – метки

времени,

значения

и

pctgood

располагаются

в 3

строках.

 

 

 

 

 

3.2.2.11. Диалоговое окно Filtered Sampled Data

Это диалоговое окно получает выборку данных из архива для значений, удовлетворяющих выражению фильтра. Если выбрана опция Marker, то для каждого значения, не удовлетворяющего условию фильтра, выводится статус «Filtered».

Требуемые поля:

Tagname. Ссылка поля Tagname может быть массивом.

Start Time (начальное время).

End Time (конечное время).

Time Interval (интервал выборки).

Expression (выражение фильтра).

Контрольные окна: Выключите контрольное окно Markers, чтобы подавить вывод статуса «Filtered» в ячейке для интервала времени, в котором значение не удовлетворяет условию фильтра.

Если вы можете ввести выражение фильтра в ячейку таблицы и ссылаться на нее в диалоговом окне, убедитесь, что выражение начинается с одинарной кавычки, т.е. что Excel будет интерпретировать выражение как строку. Поскольку имя тэга в выражении фильтра должно быть заключено в одинарные кавычки, то если выражение начинается с имени тэга, вам необходимо начинать выражение с двух одинарных кавычек (если выражение запоминается в ячейке электронной таблицы).

Функция: PISampFilDat (tagname, stime, etime, interval, filtexp, filtcode, outcode, PIServer).

105

Аргументы

Аргумент

Тип аргумента

Описание

Tagname

String

Имя тэга, для которого необходимо получить

 

 

выборку данных

Stime

String

Начальное время в формате времени PI

Etime

String

Конечное время в формате времени PI

Interval

String

Интервал выборки в формате времени PI

Filtexp

String

Выражение фильтра. Синтаксис выражения

 

 

фильтра см. в приложении A

Filtcode

Integer

Код фильтра. Используйте 1 для выдачи статуса

 

 

фильтрации, 0 – для пропуска выдачи статуса

Outcode

Integer

Код вывода; 0, 1, 2 или 3

PIServer

string

Имя сервера PI

Возвращаемые значения:

Аргумент

Колонка 1

Колонка 2

Outcode

 

 

0

Данные выборки

 

1

Метки времени

Данные выборки

При значении outputcode = 2 выходной массив, получаемый при outputcode = 0, транспонируется, а при значении outputcode = 3 транспонируется выходной массив, получаемый при outputcode = 1 .

3.2.2.12. Диалоговое окно Filtered Compressed Data (Number)

Это диалоговое окно возвращает указанное количество значений сжатых данных из архива PI, для которых выполняется условие в выражении фильтра. Если выбрана опция Marker, то для каждой группы значений, не удовлетворяющих условию фильтра, выводится статус «Filtered».

Требуемые поля:

Tagname (имя тэга).

Start Time (начальное время).

Number of data points (количество точек данных).

Expression (выражение фильтра).

Контрольные окна: Включите контрольное окно backwards in time, если вы хотите собрать данные из архива, предшествующие времени, указанному в поле Start time.

106

Выключите контрольное окно Markers, чтобы подавить вывод статуса «Filtered» в ячейке для интервала времени, в котором значение не удовлетворяет условию фильтра.

Это диалоговое окно возвращает #N/A, когда имеется меньшее число значений, чем указанное. Например, если вы хотите получить 400 значений, начиная с полуночи сегодня, а в архиве имеется только 356 значений, то в последних 44 ячейках будет выведено #N/A.

Функция: PICompFilDat (tagname, stime, etime, filtexp, filtcode, outcode, PIServer).

Аргументы

Аргумент

Тип аргумента

Описание

Tagname

String

Имя тэга, для которого необходимо получить

 

 

сжатые данные

Stime

String

Начальное время в формате времени PI

Etime

String

Конечное время в формате времени PI

Filtexp

String

Выражение фильтра. Синтаксис выражения

 

 

фильтра см. в приложении A

Filtcode

Integer

Код фильтра. Используйте 1 для выдачи статуса

 

 

фильтрации, 0 – для пропуска выдачи статуса

Outcode

integer

Код вывода; 0, 1, 2 или 3

PIServer

string

Имя сервера PI

Возвращаемые значения:

Аргумент Outcode

Колонка 1

Колонка 2

0

Сжатые данные

 

1

Метки времени

Сжатые данные

При значении outputcode = 2 выходной массив, получаемый при outputcode = 0, транспонируется, а при значении outputcode = 3 транспонируется выходной массив, получаемый при outputcode = 1. Количество точек данных, возвращаемых для данного интервала времени, выводится в первой ячейке строки/колонки.

3.2.2.13. Диалоговое окно Expression Calculation

Это диалоговое окно выполняет вычисления в соответствии с выражением, содержащим тэги, для равноотстоящих интервалов времени.

107

Требуемые поля

Expression (выражение). Синтаксис выражения см. в приложении A.

Start Time (начальное время).

End Time (конечное время).

Time Interval (интервал времени).

Если вы можете ввести выражение в ячейку таблицы и ссылаться на нее в диалоговом окне, убедитесь, что выражение начинается с одинарной кавычки, т.е. что Excel будет интерпретировать выражение как строку. Поскольку имя тэга в выражении должно быть заключено в одинарные кавычки, то если выражение начинается с имени тэга, вам необходимо начинать выражение с двух одинарных кавычек (если выражение запоминается в ячейке электронной таблицы).

Функция: PIExpDat (expression, stime, etime, interval, outcode, PIServer).

Аргументы

Аргумент

Тип аргумента

Описание

Expression

String

Выражение вычисления

Stime

String

Начальное время в формате времени PI

Etime

String

Конечное время в формате времени PI

Interval

String

Интервал времени в формате времени PI

Возвращаемые значения:

Аргумент Outcode

Колонка 1

Колонка 2

0

Вычисленные данные

Вычисленные данные

1

Метки времени

При значении outputcode = 2 выходной массив, получаемый при outputcode = 0, транспонируется, а при значении outputcode = 3 транспонируется выходной массив, получаемый при outputcode = 1.

3.2.2.14. Диалоговое окно Connections

Это диалоговое окно управляет подключениями к серверу PI. С помощью кнопок в нижней части окна вы можете добавить дополнительные серверы PI к списку серверов <Add...>, модифи-

108

цировать имеющиеся серверы PI <Edit...>, удалять имеющиеся серверы PI <Remove> и определять существующий сервер PI как сер-

вер по умолчанию <Set as Default>.

Вы можете также воспользоваться кнопками в правой части окна для подключения к серверу <Connect> и для отключения от сервера <Disconnect> из списка серверов. После успешного подключения к серверу PI поле статуса Status изменяется на READ или на READ/WRITE.

Для получения такой информации, как имя/адрес локального узла и имя/адрес сервера PI, щелкните по кнопке <Information>.

3.2.2.15. Диалоговое окно Tag Search

Это диалоговое окно позволяет выполнить поиск тэгов на вашем сервере PI и скопировать результат поиска в таблицу Excel.

3.2.2.16. Диалоговое окно Settings

Это диалоговое окно определяет настройки программы

PIDataLink.

Набор радиокнопок Single row или Single column определяет, будут ли тэги копироваться в таблицу построчно или по колонкам, если TagSearch вызывается из диалогового окна PI.

Контрольное окно Copy PIServer name определяет, будет ли имя сервера PI копироваться в поле ввода PIServer, если TagSearch вызывается из диалогового окна PI.

Контрольное окно Connect to PIServer on startup определяет,

будет ли PI-DataLink немедленно подключаться к серверу PI при запуске программы Excel.

Контрольное окно Synchronize time with PIServer определяет, будет ли PIDataLink выполнять однократную подстройку часов вашего ПК таким образом, чтобы они совпадали с часами сервера PI.

Поле Number format позволяет указать код формата чисел по умолчанию. Эта строка может содержать любой код, допустимый в списке Format | Cells | Number.

Поле Time format позволяет указать код формата времени по умолчанию. Эта строка может содержать любой код, допустимый в списке Format | Cells | Number.

109

3.2.3. Конфигурирование PI-DataLink

Прежде чем приступать к настройке тегов в PI-DataLink, необходимо выбрать, какие именно тэги будут поступать в PI-архив. Для этого в SCADA-системе из всего списка подключенного оборудования и списка параметров выбирается нужный параметр.

Если не известны имеющиеся в системе теги, то их наименования можно посмотреть, например, при помощи программы MatrikonOPC, интерфейс которой показан на рис. 3.13.

Рис. 3.13. Интерфейс программы MatrikonOPC

Далее можно получить все тэги, которые поступают в PI-архив. Для этого необходимо открыть Microsoft Excel и выбирать в меню

PI-SMT пункт «Import Tags» (рис. 3.14).

Рис. 3.14. Получение существующих тэгов.

110

Соседние файлы в папке книги