Файл: Создание интегрированных систем управления. Работы по проектированию, конфигурированию и наладке.pdf
ВУЗ: Не указан
Категория: Не указан
Дисциплина: Не указана
Добавлен: 29.02.2024
Просмотров: 71
Скачиваний: 0
Аргумент |
Тип аргумента |
Описание |
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