Гидравлические расчеты с помощью ZWS-команд

Введение в гидравлических расчеты с помощью ZWS-команд

[Предупреждение]Предупреждение

Гидравлические расчеты с помощью ZWS команд возможны только при наличии лицензий на:

  1. ZuluServer;

  2. веб-службы ZuluServer;

  3. модуль ZuluNetTools;

  4. расчетный модуль, который будет выполняться (например, "поверочный расчет ZuluThermo").

С помощью ZWS-команд ZuluServer можно выполнять гидравлические расчеты водопроводных, газовых, тепловых и канализационных сетей. ZWS-команды для гидравлических расчетов позволяют:

  • создавать слой инженерной сети с указанием инженерной модели;

  • задавать настройки проведения расчетов;

  • запускать и прерывать расчеты;

  • получать протокол расчета с ошибками и результатами расчета;

[Примечание]Примечание

Эти же ZWS-команды используются для проведения расчетов в ZuluGIS Mobile и ZuluGIS Online, поэтому, если вы хотите выполнять расчёты в мобильной или онлайн-версии, вам потребуется настроить ZuluServer для выполнения расчётов с помощью ZWS.

Взаимодействие происходит следующим образом: клиент отправляет по HTTP-протоколу команду ZWS на ZuluServer. ZuluServer вызывает для расчетов ZuluNetTools, куда передаются параметры расчетов. ZuluNetTools далее работает со слоем инженерной сети, расположенным на ZuluServer по протоколу толстого клиента (zulu://). Схема взаимодействия представлена на рисунке ниже.

Схема взаимодействия клиента и ZuluServer при выполнении расчетов с помощью ZWS-команд

Рисунок 149. Схема взаимодействия клиента и ZuluServer при выполнении расчетов с помощью ZWS-команд


Чтобы работа происходила по протоколу zulu://, ZuluServer должен работать от имени определенной учетной записи, которую необходимо указать при регистрации ZuluNetTools.exe.

Поэтому, для выполнения расчетов с помощью ZWS-команд требуют дополнительной предварительной настройки:

После того как ZuluServer настроен можно проводить расчеты с помощью ZWS-команд.

Например, далее приведена общая последовательность выполнения расчета:

  1. Получаем модель и набор свойств, которые поддерживает слой с помощью GetLayerCapabilities.

    Ответ должен содержать название модели в ZWS: например <Model>hydro</Model>.

  2. Получаем список источников слоя — NetToolsGetSourcesTree

    Для конструкторского расчета — указываем подсеть с помощью NetToolsSelectSubNetwork

  3. Запускаем расчет с помощью команды NetToolsTaskRun.

    Следить за статусом выполнения расчета можно с помощью NetToolsTaskGetStatus.

    Получить список ошибок при выполнении расчета — NetToolsTaskGetErrors. Что получить полный протокол расчета используйте NetToolsTaskGetOutput.

  4. Чтобы приостановить расчет и продолжать с ним работу, например: перезапустить с другими параметрами расчета, или после изменения исходных данных следует использовать NetToolsTaskStop для прерывания и NetToolsTaskRun — для повторного запуска.

    Чтобы завершить работу с расчетом, запущенным ранее, используйте NetToolsTaskTerminate.

Перечень ZWS-команд для выполнения расчетов доступен в разделе «ZWS-команды для выполнения расчетов».