ZuluNetTools — ActiveX компоненты для расчетов инженерных сетей
ZuluNetTools - библиотека ActiveX компонентов. Предоставляет возможность разработчикам программного обеспечения включать в свои приложения гидравлические расчеты тепловых, водопроводных, канализационных, паровых и газовых сетей, реализованные в расчетных модулях ZuluThermo, ZuluHydro, ZuluSteam, ZuluGaz и ZuluDrain в средах разработки приложений, поддерживающих модель COM (Microsoft Visual C++, Microsoft Visual Basic, Borland Delphi, Borland C++Builder и т.д.).
Компоненты для ZuluThermo, ZuluHydro, ZuluSteam, ZuluGaz и ZuluDrain лицензируются по отдельности
Возможности ZuluNetTools:
- программное задание топологической модели инженерной сети
- программное задание исходных данных для расчетов
- подключение инженерных сетей в формате ZuluGIS
- запуск расчетов тепловых сетей ZuluThermo
- запуск расчетов водопроводных сетей ZuluHydro
- запуск расчетов паровых сетей ZuluSteam
- запуск расчетов газовых сетей ZuluGaz
- запуск расчетов канализационных сетей ZuluDrain
- программное чтение результатов расчетов и кодов ошибок
- вывод протокола расчетов и списка ошибок
- построение пьезографиков
- создание модели инженерной сети через Web API
- выполнение расчетов тепловых, паровых, газовых, водопроводных и канализационных сетей используя Web API.
Компоненты ZuluNetTools
В состав библиотеки ZuluNetTools входят компоненты, представляющие расчетную модель инженерной сети или просто «сети», компоненты для выполнения расчетов - расчетные задачи, а также набор визуальных компонентов (окно сообщений, окно пьезометра), предоставляющие пользовательский интерфейс, схожий с интерфейсом ZuluGIS, для интеграции инженерных расчетов в конечное приложение пользователя.
Рис 1. Диаграмма компонентов ZuluNetTools
Модель инженерной сети (ZCNNetwork, ZCNNetworkCtrl)
Компонент «Сеть» представляет собой модель инженерной сети. Компонент ZCNNetworkCtrl является невидимым ActiveX-элементом, размещаемым на форме. Его аналог, объект ZCNNetwork - простой COM-объект, делающий тоже самое, но создаваемый и используемый в линейном коде.
Модель сети может быть задана программно, путем занесения графа сети и задания расчетных параметров объектов сети. Кроме того, в качестве расчетной модели можно прямо указать слой ZuluGIS.
Набор расчетных задач ZuluNetTools
Каждый из компонентов «Задача» представляет собой набор расчетных задач, решаемых одним из пакетов ZuluThermo, ZuluHydro, ZuluSteam и ZuluGaz. Компоненты представлен в виде невидимых ActiveX-элементов, размещаемых на форме, а также в виде COM-объектов, имеющих аналогичный набор методов и свойств (см. таблицу ниже).
| ActiveX-компонент | COM-объект | Продукт |
| ZCNTaskThermoCtrl | ZCNTaskThermo | ZuluThermo (тепловые расчеты) |
| ZCNTaskHydroCtrl | ZCNTaskHydro | ZuluHydro (водопроводные расчеты) |
| ZCNTaskSteamCtrl | ZCNTaskSteam | ZuluSteam (расчеты паропроводов) |
| ZCNTaskGazCtrl | ZCNTaskGaz | ZuluGaz (расчеты газовых сетей) |
| ZCNTaskDrainCtrl | ZCNTaskDrain | ZuluDrain (расчеты сетей водоотведения) |
Таб 1. Расчетные задачи ZuluNetTools
Эти компоненты используются для организации выполнения расчетов без использования пользовательского интерфейса ZuluGIS. Параметры расчетов и источники для расчетов задаются программно.
Компонент «Сообщения» (ZCNOutputCtrl)
Визуальный компонент ZCNOutputCtrl является аналогом окна Сообщения ZuluGIS. Если этот компонент подключить к компоненту-задаче, в этом окне будет отображаться ход выполнения расчетов.
Рис. 2. Компонент ZCNOutputCtrl.
Компонент «Пьезометр» (ZCNPiezoCtrl)
Визуальный компонент ZCNPiezoCtrl позволяет строить пьезометрические графики по результатам расчетов. Подключается к компонетам ZCNNetworkCtrl или ZCNNetwork для получения исходной информации. Компонент является полным аналогом окна пьезометра ZuluGIS.
В зависимости от типа подключенной сети, компонент позволяет отображать пьезометрические графики для тепловой и водопроводной сети, графики падения давления, температуры, энтальпии и влажности пара в паропроводах, а также графики падения давления газа в трубопроводе газовой сети по заданному направлению.
Рис. 3. Компонент ZCNPiezoCtrl.
Компонент «Панель расчетов»
Визуальный компонент ZCNTaskWinCtrl позволяет внедрить в форму панель расчетов одного из продуктов ZuluThermo, ZuluHydro, ZuluSteam или ZuluGaz. С помощью этого компонента можно организовать внедрение расчетных продуктов линейки ZuluGIS в свои приложения c использованием оригинального пользовательского интерфейса этих продуктов.
Рис. 4. Компонент ZCNTaskWinCtrl с внедренной панелью расчетов ZuluThermo.
Гидравлические расчеты из тонкого клиента через веб-интерфейс
Доступ к модели инженерной сети, опубликованной на ZuluServer можно осуществлять по протоколу HTTP, для этого используются Веб-службы ZuluServer. В версии ZuluServer 2021 появилась возможность обращаться к модулю ZuluNetTools используя ZWS команды для гидравлических расчетов. Выполнение расчетов возможно в ZuluGIS Online или из собственных приложений. Команды ZWS позволяют:
- создавать слой модели инженерной сети
- задавать настройки гидравлических расчетов
- выполнять и останавливать гидравлические расчеты
- получать протокол расчета с ошибками, ходом и результатами расчета
Обзор выполнения гидравлических расчетов из тонкого клиента с использованием веб-служб ZuluServer и модуля ZuluNetTools.
Для расчетов через веб-интерфейс потребуются лицензии на ZuluServer, веб-службы для ZuluServer, модуль ZuluNetTools и сам расчет, который будет выполняться.
Описание ZWS команд для гидравлических расчетов