Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Работа с Alpha.Imitator

Управление и контроль процессами воспроизведения истории, коррекции исторических данных, дополнения пропущенных исторических данных выполняется с помощью служебных сигналов Alpha.Imitator.

Чтобы изменять и контролировать значения служебных сигналов, подключитесь к Alpha.Imitator, с помощью OPC клиента, например OpcExplorer. Для этого подключитесь к источнику AP.OPCDAServer.Imitator.

Подробная информация о работе Alpha.Imitator выводится в журнал приложений. Для просмотра журнала запустите приложение EventLogViewer.

Воспроизведение истории

Для просмотра воспроизведения истории с помощью Alpha.Imitator запустите приложение Alpha.HMI.Trends, у которого в качестве источника данных должен быть настроен Alpha.Imitator.

В оперативном режиме на трендовое поле добавьте сигналы из дерева Alpha.Imitator, для которых нужно воспроизвести историю изменения значений.

В имитационной базе должна быть история изменений по добавленным сигналам: значения сигналов изменялись после настроек Alpha.Historian и Alpha.Server.

В OpcExplorer в Инспектор добавьте служебные сигналы для управления и контроля процесса воспроизведения истории:

  • SessionInProgress - флаг наличия активной сессии;
  • EndSession - команда завершения сессии проигрывания;
  • BeginSession - команда запуска сессии имитации;
  • SetIntervalStart- задать метку времени начала имитируемого интервала;
  • SetIntervalEnd - задать метку времени конца имитируемого интервала;
  • SetSpeed - задать скорость проигрывания;
  • IntervalStart - метка времени начала интервала проигрывания;
  • IntervalEnd - метка времени конца интервала проигрывания;
  • Speed - текущая скорость проигрывания;
  • LoadData - загрузить данные для проигрывания;
  • DataLoaded - процент готовности данных к проигрыванию;
  • SetState - запустить процесс имитации;
  • Current - текущее положение процесса проигрывания;
  • State - статус процесса имитации.

Для воспроизведения истории:

  1. Убедитесь, что нет активной сессии имитации:

    • SessionInProgress == False.

    Если SessionInProgress == True, то завершите текущую сессию имитации, установив значение сигнала:

    • EndSession = True.

  2. Запустите новую сессию имитации в режиме воспроизведения истории, установив значение сигнала:

    • BeginSession = 0.

    При этом активируется флаг наличия активной сессии SessionInProgress == True.

  3. Задайте временной интервал в формате datetime_json, за который требуется воспроизвести историю, а также скорость проигрывания, установив значения сигналов:

    • SetIntervalStart;
    • SetIntervalEnd;
    • SetSpeed.

    Пример метки времени в формате datetime_json, соответствующий времени 11.10.2023 17:32:01.1 в часовом поясе UTC+7:

    {"y":2023,"mo":10,"d":11,"h":10,"m":32,"s":1,"ms":1}

    Сигналы устанавливают значения соответствующих сигналов IntervalStart, IntervalEnd и Speed.

  4. Загрузите данные для воспроизведения истории, установив значение сигнала:

    • LoadData = True.

    Процент загруженных данных отображается в значении сигнала DataLoaded.

  5. После полной загрузки данных (DataLoaded == 100) запустите воспроизведение истории, установив значение сигнала:

    • SetState = 1.

    В процессе воспроизведения истории текущее положение процесса воспроизведения отображается в значении сигнала Current, а статус воспроизведения State == 1.

    На трендовом поле Alpha.HMI.Trends в оперативном режиме отображается изменение значений сигналов за воспроизводимый период времени.

  6. Чтобы завершить сессию воспроизведения истории, установите значение сигнала:

    • EndSession = True.

    При этом сбрасываются значения сигналов IntervalStart, IntervalEnd, Current, а также устанавливаются следующие значения сигналов:

    • State = 0;
    • Speed = 1;
    • SessionInProgress = False.

В процессе воспроизведения истории (State == 1) возможно:

  1. Изменение скорости воспроизведения в сигнале SetSpeed.
  2. Изменение текущего положения воспроизведения в сигнале SetCurrent.
  3. Приостановка воспроизведения (пауза): SetState = 0.
  4. Завершение сессии воспроизведения: EndSession = True.

При достижении конца воспроизводимого интервала или приостановке воспроизведения (State == 0) возможно:

  1. Изменение скорости воспроизведения истории в сигнале SetSpeed.
  2. Изменение текущего положения воспроизведения в сигнале SetCurrent.
  3. Возобновление воспроизведения: SetState = 1.
  4. Завершение сессии воспроизведения: EndSession = True.

Перезапись исторических данных

В Alpha.Historian хранится некоторая история изменения сигнала ASRMB.Recalc и вычисленных значений сигнала ASRMB.Item.

Значение сигнала ASRMB.Item вычисляется на основе значения сигнала ASRMB.Recalc по формуле:

ASRMB.Item = ASRMB.Recalc + 10

Требуется пересчитать и перезаписать в Alpha.Historian значения сигнала ASRMB.Item на основе новых значений сигнала ASRMB.Recalc.

Перезапись единственного значения

В OpcExplorer в Инспектор добавьте служебные сигналы для управления и контроля процесса перезаписи исторических данных:

  • SessionInProgress - флаг наличия активной сессии;
  • BeginSession - команда запуска сессии имитации;
  • Cancel - отменить сессию имитации;
  • SetIntervalStart - задать метку времени начала перезаписываемого интервала;
  • SetIntervalEnd - задать метку времени конца перезаписываемого интервала;
  • IntervalStart - метка времени начала перезаписываемого интервала;
  • IntervalEnd - метка времени конца перезаписываемого интервала;
  • ReadHistory - запросить историю значений тега;
  • ReadHistoryResponse - список исторческих значений;
  • SetState - запустить процесс имитации;
  • State - статус процесса имитации;
  • Commit - применить результаты имитации.

Для перезаписи единственного значения:

  1. Переведите Alpha.Imitator в работу, установив значение сигнала Service.State.Server.Set = True.
  2. Убедитесь, что нет активной сессии имитации:

    • SessionInProgress == False.

    Если SessionInProgress == True, то отмените текущую сессию имитации, установив значение сигнала:

    • Cancel = True.

  3. Запустите новую сессию имитации в режиме перезаписи исторических данных, установив значение сигнала

    • BeginSession = 1.

  4. Задайте временной интервал, за который требуется перезаписать данные в Alpha.Historian, установив значения сигналов:

    • SetIntervalStart;
    • SetIntervalEnd.

    Значения в указанных сигналах задаются в формате datetime_json по времени UTC. Например, требуется перезаписать данные в интервале с 12.10.2023 10:38:39.1 по 12.10.2023 10:38:40.1:

    • в значение сигнала SetIntervalStart запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":38,"s":39,"ms":1}
    • в значение сигнала SetIntervalEnd запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":38,"s":40,"ms":1}

    Сигналы устанавливают значения соответствующих сигналов IntervalStart и IntervalEnd.

  5. Проверьте значения тегов в Alpha.Historian за заданный временной интервал. Для этого в сигнале ReadHistory укажите тег в формате:

    {"Tag":"ASRMB.Recalc"}

    В значении сигнала ReadHistoryResponse отобразятся значения тега за указанный интервал.

    История значений тега ASRMB.Recalc в указанном интервале:

    История значений тега ASRMB.Item в указанном интервале:

    Графики сигналов имеют вид:

  6. Установите новое значение тегу ASRMB.Recalc, на основе которого требуется пересчитать и перезаписать значение тега ASRMB.Item. Например, ASRMB.Recalc == 15.

  7. Запустите имитацию, установив значение сигнала:

    • SetState = 1.

    В результате имитации значение тега ASRMB.Item будет пересчитано, а статус процесса имитации примет значение State == 2.

  8. Сохраните результат имитации в Alpha.Historian, установив значение сигнала:

    • Commit = True.

    Новые значения тегов ASRMB.Recalc и ASRMB.Item будут перезаписаны в Alpha.Historian. При этом сбрасываются значения сигналов IntervalStart и IntervalEnd, а также устанавливаются следующие значения сигналов:

    • State = 0;
    • SessionInProgress = False.

Чтобы проверить запись новых значений тегов в Alpha.Historian за заданный временной интервал:

  1. Запустите сессию имитации: BeginSession = 1.
  2. Задайте временной интервал:

    • в значение сигнала SetIntervalStart запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":38,"s":39,"ms":1}
    • в значение сигнала SetIntervalEnd запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":38,"s":40,"ms":1}
  3. В сигнале ReadHistory укажите тег, после чего сигнале ReadHistoryResponse отобразятся значения тега за указанный интервал.

    История значений тега ASRMB.Recalc в указанном интервале:

    История значений тега ASRMB.Item в указанном интервале:

Графики сигналов с перезаписанными значениями примут вид:

Перезапись массива данных

В OpcExplorer в Инспектор добавьте служебные сигналы для управления и контроля процесса перезаписи исторических данных:

  • SessionInProgress - флаг наличия активной сессии;
  • BeginSession - команда запуска сессии имитации;
  • Cancel - отменить сессию имитации;
  • SetIntervalStart - задать метку времени начала перезаписываемого интервала;
  • SetIntervalEnd - задать метку времени конца перезаписываемого интервала;
  • IntervalStart - метка времени начала перезаписываемого интервала;
  • IntervalEnd - метка времени конца перезаписываемого интервала;
  • ReadHistory - запросить список исторических значений;
  • ReadHistoryResponse - список исторических значений;
  • Override - задать перезаписываемые сигналы;
  • ReadOverriden - запросить список переопределяемых значений;
  • ReadOverridenResponse - список переопределяемых значений;
  • GetOverriden - запросить список переопределяемых тегов;
  • GetOverridenResponse - список переопределяемых тегов;
  • SetState - запустить процесс имитации;
  • State - статус процесса имитации;
  • Commit - применить результаты имитации.

Для перезаписи массива значений:

  1. Переведите Alpha.Imitator в работу, установив значение сигнала Service.State.Server.Set = True.
  2. Убедитесь, что нет активной сессии имитации:

    • SessionInProgress == False.

    Если SessionInProgress == True, то отмените текущую сессию имитации, установив значение сигнала:

    • Cancel = True.

  3. Запустите новую сессию имитации в режиме перезаписи исторических днных, установив значение сигнала

    • BeginSession = 1.

  4. Задайте временной интервал, за который требуется перезаписать данные в Alpha.Historian, установив значения сигналов:

    • SetIntervalStart;
    • SetIntervalEnd.

    Значения в указанных сигналах задаются в формате datetime_json по времени UTC. Например, требуется перезаписать данные в интервале с 12.10.2023 10:56:19.1 по 12.10.2023 10:56:30.1:

    • в значение сигнала SetIntervalStart запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":56,"s":19,"ms":1}
    • в значение сигнала SetIntervalEnd запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":56,"s":30,"ms":1}

    Сигналы устанавливают значения соответствующих сигналов IntervalStart и IntervalEnd.

  5. Проверьте значения тегов в Alpha.Historian за заданный временной интервал. Для этого в сигнале ReadHistory укажите тег в формате:

    {"Tag":"ASRMB.Recalc"}

    В значении сигнала ReadHistoryResponse отобразятся значения тега за указанный интервал.

    История значений тега ASRMB.Recalc в указанном интервале содержит две записи:

    История значений тега ASRMB.Item в указанном интервале содержит две записи:

    Графики сигналов имеют вид:

  6. Установите новые значения тега ASRMB.Recalc, на основе которых требуется пересчитать и перезаписать значения тега ASRMB.Item. Например, тегу ASRMB.Recalc установите значения 15 и 0, вместо имеющихся 2 и 10. Для этого в сигнал Override запишите команду на перезапись массива значений в формате trend_json:

    {"Tag": "ASRMB.Recalc", "Add": [{"v": "15", "q": "216", "t": {"y":2023,"mo":10,"d":12,"h":3,"m":56,"s":19,"ms":1}}, {"v": "0", "q": "216", "t": {"y":2023,"mo":10,"d":12,"h":3,"m":56,"s":29,"ms":1}}]}
  7. Убедитесь, что для перезаписи подготовлены верные значения - 15 и 0. Для этого укажите в сигнале ReadOverriden тег, значения которого требуется перезаписать, в формате:

    {"Tag":"ASRMB.Recalc"}

    Массив значений, подготовленный для перезаписи, будет выведен в значении сигнала ReadOverridenResponse.

  8. Убедитесь, что список перезаписываемых тегов верен, установив значение сигнала GetOverriden = True. Список перезаписываемых тегов будет выведен в значении сигнала GetOverridenResponse.

  9. Запустите имитацию, установив значение сигнала:

    • SetState = 1.

    В результате имитации заданные значения тега ASRMB.Recalc и значения тега ASRMB.Item будут пересчитаны и перезаписаны. В сигналах будут отображаться последние перезаписанные значения из массива, а статус процесса имитации примет значение State == 2.

  10. Сохраните результат имитации в Alpha.Historian, установив значение сигнала: Commit = True.

    Массивы новых значений тегов ASRMB.Recalc и ASRMB.Item будут перезаписаны в Alpha.Historian. При этом сбрасываются значения сигналов IntervalStart, IntervalEnd, Current, а также устанавливаются следующие значения сигналов:

    • State = 0;
    • SessionInProgress = False.

Чтобы проверить запись массивов новых значений тегов в Alpha.Historian за заданный временной интервал:

  1. Запустите сессию имитации: BeginSession = 1.
  2. Задайте временной интервал:

    • в значение сигнала SetIntervalStart запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":38,"s":39,"ms":1}
    • в значение сигнала SetIntervalEnd запишите строку:

      {"y":2023,"mo":10,"d":12,"h":3,"m":38,"s":40,"ms":1}
  3. В сигнале ReadHistory укажите тег, после чего в сигнале ReadHistoryResponse отобразятся значения тега за указанный интервал.

    История значений тега ASRMB.Recalc в указанном интервале:

    История значений тега ASRMB.Item в указанном интервале:

Графики сигналов с перезаписанными значениями примут вид:

Дополнение пропущенных исторических данных

Чтобы записать отсутствующие данные в Alpha.Historian:

  1. Определите промежуток времени, за который отсутствуют данные в Alpha.Historian.
  2. Остановите Alpha.Server.
  3. В папку, указанную в настройках источника HUB Module в Alpha.Imitator, поместите файлы данных, которые не были переданы от нижестоящих систем за интересующий промежуток времени (в примере настройки папка C:\Backfilling).

    Файлы данных, из которых будет дополнена история, это DAT-файлы (*.dat), содержащие значения сигналов. Файлы данных следует скопировать из папки, в которую они были сгенерированы нижестоящей системой.

  4. Переведите Alpha.Imitator в работу, установив значение сигнала Service.State.Server.Set = True.
  5. Откройте новую сессию имитации в режиме дополнения пропущенных исторических данных, установив значение сигнала BeginSession = 2.

При открытии сессии имитации в режиме дополнения пропущенных исторических данных Alpha.Imitator начинает разбор файлов данных и записывает в Alpha.Historian полученные значения и пересчитанные зависимые параметры, заполняя промежутки времени, за которые отсутствовали данные в истории. Прочитанные файлы удаляются из папки автоматически.