Гидравлические расчёты с помощью 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-команд

Рисунок 150. Схема взаимодействия клиента и 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-команды для выполнения расчётов».