Библиотека подготовки и получения данных для отчётной документации

Имя:	TechApp
Основан:	январь 2008г
Версия:	1.0.0
Статус:	Открытый (GPL)
Автор:	Роман Савоченко
Описание:	Библиотека функций для облегчения выполнения типовых вычислений примитива формирования отчётной документации СВУ "Документ".
Адрес:	БД в файле: SQLite.LibDB.doc (oscadalibs.db.gz)

Contents

Про библиотеку

1 Состав библиотеки

Среднее знач. архива (averVal)

Запрос знач. архива (getVal)

Сумма знач. архива (sumVal)

Про библиотеку

Библиотека создаётся для предоставления типовых операций получения данных при построении отчётных документов с использованием данных источников данных (DAQ) и их архивов. Библиотека не является статической, а строится на основе модуля JavaLikeCalc, позволяющего создавать вычисления на Java-подобном языке.

Для адресации к функциям этой библиотеки можно использовать статический адрес вызова "DAQ.JavaLikeCalc.lib_doc.{Func}()" или динамический "SYS.DAQ.JavaLikeCalc["lib_doc"]["{Func}"].call()", "SYS.DAQ.JavaLikeCalc["lib_doc"].{Func}()". Где {Func} — идентификатор функции в библиотеке.

Подключить библиотеку к проекту станции OpenSCADA можно путём загрузки вложенного файла БД, размещения его в директории БД проекта станции и создания объекта БД для модуля БД "SQLite", указав файл БД в конфигурации.

1 Состав библиотеки

В своём составе библиотека содержит несколько функций часто востребованных при формировании документов на основе данных источников данных OpenSCADA. Названия функций и их параметров доступны на трёх языках: Английский, Украинский и Российский.

Среднее знач. архива (averVal)

Описание: Вычисление среднего значения за промежуток времени указанного архива и выдача результата с указанным количеством знаков после точки.
Параметры:

ID	Параметр	Тип	Режим	Скрытый	По умолчанию
rez	Результат	Строка	Возврат	false
addr	Адрес	Строка	Вход	false
bTime	Время начала (сек.)	Целый	Вход	false
eTime	Время конца (сек.)	Целый	Вход	false
prec	Знаков после запятой	Целый	Вход	false	3
archtor	Архиватор	Строка	Вход	false

Программа:
using Special.FLibSYS; a_src = vArh(strPath2Sep(addr)); vl=EVAL_REAL; buf_beg=max(a_src.begin(0,archtor),bTime); buf_end=min(a_src.end(0,archtor),eTime); while( true ) { buf_beg1=buf_beg; r_val = a_src.get(buf_beg,0,true,archtor); if(vl == EVAL_REAL) vl = r_val; else if(r_val != EVAL_REAL) vl=(vl*(buf_beg-bTime)+r_val*(buf_beg-buf_beg1))/(buf_beg-bTime+buf_beg-buf_beg1); if( buf_beg == 0 || buf_beg>=buf_end ) break; buf_beg++; } return (vl==EVAL_REAL) ? "Пусто" : real2str(vl,prec);

Запрос знач. архива (getVal)

Описание: Запрос значения на указанное время из установленного архива и выдача результата с указанным количеством знаков после точки.
Параметры:

ID	Параметр	Тип	Режим	Скрытый	По умолчанию
rez	Результат	Строка	Возврат	false
addr	Адрес	Строка	Вход	false
time	Время (сек.)	Целый	Вход	false
uTime	Время (мксек.)	Целый	Вход	false
prec	Знаков после запятой	Целый	Вход	false	3
archtor	Архиватор	Строка	Вход	false
strong	Жёсткое соответствие времени	Логич.	Вход	false	0

Программа:
using Special.FLibSYS; srcTime = time; val = vArh(strPath2Sep(addr)).get(time,uTime,0,archtor); return (val.isEVal() || (strong && srcTime != time)) ? "Пусто" : real2str(val,prec);

Сумма знач. архива (sumVal)

Описание: Вычисление суммы значений за промежуток времени указанного архива и выдача результата с указанным количеством знаков после точки.
Параметры:

ID	Параметр	Тип	Режим	Скрытый	По умолчанию
rez	Результат	Строка	Возврат	false
addr	Адрес	Строка	Вход	false
bTime	Время начала (сек.)	Целый	Вход	false
eTime	Время конца (сек.)	Целый	Вход	false
prec	Знаков после запятой	Целый	Вход	false	3
archtor	Архиватор	Строка	Вход	false

Программа:
using Special.FLibSYS; a_src = vArh(strPath2Sep(addr)); vl=0.0; buf_beg_u=buf_end_u=0; buf_beg=max(a_src.begin(0,archtor),bTime); buf_end=min(a_src.end(0,archtor),eTime); while( true ) { r_val = a_src.get(buf_beg,buf_beg_u,true,archtor); if(r_val != EVAL_REAL) vl+=r_val; if( !buf_beg || buf_beg>=buf_end ) break; buf_beg_u++; } return (vl==EVAL_REAL) ? "Пусто" : real2str(vl,prec);