Holarch

Поведение

Моделирование

Запуск потока Action как дискретно-событийного моделирования или исследования методом Монте-Карло, чтение результатов по времени, затратам, ресурсам и загрузке, скрипты для решений и запись результата верификации для требования.

Как использовать →

На этой странице
  1. Обзор
  2. Понятия
    1. Что читает Симулятор
  3. Как использовать
    1. Когда и зачем
    2. Дискретно-событийное моделирование
    3. Исследование Монте-Карло
    4. Проверка требования и запись результата
    5. Сохранённые прогоны
    6. Разобранный пример: съёмочный проход CubeSat EO-1
    7. Советы и рекомендации
    8. Типичные ошибки
    9. Как это связано с остальным
  4. Правила моделирования
    1. Длительности и распределения
    2. Управляющие конструкции
    3. Resource
    4. Активы и загрузка
    5. Затраты
    6. Случайные числа и начальные значения
  5. Страница “Симулятор”
    1. Заголовок страницы и панель прогона
    2. Настройки
    3. Элементы управления дискретно-событийным моделированием
    4. Элементы управления Монте-Карло
    5. Примечания над панелями
  6. Панели
    1. Меню панели
    2. Вкладки дискретно-событийного режима
    3. Вкладки Монте-Карло
  7. Скрипты
    1. Обработчики
    2. Построитель запросов
    3. Доступно в скриптах
    4. Пример: выбор ветви по заряду батареи
    5. Песочница и доверие
  8. Клавиатура и мышь
  9. Сообщения
  10. Ограничения
  11. Связанные материалы

Обзор

Симулятор выполняет поток Action в моделируемом времени ровно так, как его рисует диаграмма Action. У него два режима:

  • Дискретно-событийная: один прогон во времени, за которым можно наблюдать, проходить его по шагам и отвечать на решения. Он показывает, какие действия когда выполняются, чего они ждут, как растут и падают ресурсы, какие активы заняты и сколько стоит прогон.
  • Монте-Карло: множество независимых прогонов с выборкой длительностей и решений. Он показывает разброс общего времени и стоимости, процентили, кривую кумулятивной вероятности, пройденные пути решений и вероятность уложиться в порог.

Симулятор читает модель и никогда не меняет её во время выполнения. В проект он записывает тремя способами: настройки корневого действия (сохраняются по мере изменения), запись прогона для каждого завершённого прогона и Записать результат….

Понятия

Что читает Симулятор

Симулятор берёт всё необходимое из модели. Настройте это на диаграмме Action и в атрибутах сущностей перед запуском.

Элемент моделиОткуда берётсяЧто с ним делает моделирование
ПотокДиаграмма Action корневого Action: последовательность, Parallel, SYNC, OR, LOOP и EXITВыполняет элементы по порядку. Ветви выполняются параллельно, или выбирается одна из них.
ДлительностьАтрибут Duration каждого Action (число или распределение с единицей)Время, которое занимает действие. Декомпозированное действие длится столько же, сколько его дочерний поток.
ДекомпозицияДочерние Action с собственным потокомВыполняет дочерний поток вместо собственной длительности родителя
ТриггерыInput/Output, которые действие receives (атрибут связи Trigger, включён, если не задан как false)Действие ждёт, пока не будет сгенерирован каждый I/O-триггер
Генерация I/OInput/Output, которые действие generatesСтановятся доступны по окончании действия, после задержки Conduit
Задержка ConduitConduit, который transfers I/O: Latency плюс Size ÷ CapacityЗадерживает доставку I/O
ResourceСвязи consumes, seizes и produces с Resource, с Amount (по умолчанию 1)Потребление и захват — в начале. Захваченные количества освобождаются в конце. Производство — в конце.
Пропускная способность Assetperformed by с Amount и Multiplicity актива под его родителемДействие ждёт, пока у актива не появится свободная мощность
Время занятости AssetКаждый Asset, выполняющий действие (performed by)Занятость (%) и графики загрузки
ЗатратыСущности Cost, incurred by Action или выполняющим AssetДобавляются к текущей общей стоимости
CalendarАтрибут Start корня и каждого ActionИспользуется только в режиме “Календарные даты”
СкриптыСкрипт моделирования действия или конструкцииОбработчики, которые задают длительности, выбирают ветви, задают вам вопросы и отслеживают значения

Время хранится в секундах и показывается в самой удобной для чтения единице (мс, с, мин, ч, дни, месяцы или годы).

Подробные правила для длительностей, решений, ресурсов, активов, затрат и начальных значений приведены ниже в разделе Правила моделирования.

Как использовать

Когда и зачем

Моделируйте, когда функциональный поток существует и у его действий есть длительности, исполнители и ресурсы. Обычно это после функционального анализа, во время распределения и анализа компромиссов архитектуры.

Моделирование отвечает на вопросы:

  • Сколько длится операция и насколько меняется время?
  • Какие действия находятся на критическом пути? Где они ждут — данных, ресурсов или мощности активов?
  • Остаются ли ресурсы, например заряд батареи или хранилище данных, в пределах ограничений?
  • Какие активы перегружены?
  • Какова вероятность выполнения требования к характеристикам (время, стоимость, уровень ресурса)? Это становится результатом верификации анализом, связанным с требованием.

Дискретно-событийное моделирование

  1. Откройте диаграмму Action операции.
  2. Выберите ▶ Моделировать ▾ → Дискретно-событийная.

    Симулятор открывается с этим Action в качестве Корневое Action.

    Другие способы открыть: Поведение → Симулятор на панели навигации (открывается на Action с сохранёнными настройками Симулятора, иначе на первом Action с потоком; при необходимости выберите другой Корневое Action) или Открыть в ▾ → Симулятор у Action. Выбор другого Корневое Action мышью сразу открывает его; с клавиатуры выберите его и нажмите Enter (или Открыть).

  3. Проверьте настройки: нажмите Настройки на панели вверху (её подсказка перечисляет текущие). Основные настройки — Решения, Скорость, Варьировать фиксированные длительности с ± %, Начальное значение генератора и Календарные даты (см. Настройки).
  4. Нажмите ▶ Воспроизвести.

    Часы идут, и Action во времени (вкладка “Временная шкала”) растёт. Диаграмма Action в ходе выполнения окрашивает каждое действие зелёным во время выполнения, оранжевым во время ожидания и серым по завершении.

  5. Нажмите ⏸ Пауза, чтобы остановиться и изучить состояние.
  6. Нажмите ⏭ Шаг, чтобы перейти к следующему событию, или ⏩ Выполнить до конца, чтобы завершить без анимации.
  7. Когда появляется диалог с заголовком Вход для …, выберите путь или введите значение.
  8. Нажмите OK.

    Прогон продолжается как прежде: воспроизведение, пошаговое выполнение или выполнение до конца.

  9. По окончании прогона прочитайте результаты:
    • Статус: Выполнено на 100%, Взаимоблокировка или Остановлено. После взаимоблокировки он сообщает, когда прогон остановился и чего ждёт каждое ожидающее действие, например Stopped at 0 ms: F1 Separate and Detumble waits for ADCS Sensor Data, which no earlier action produces. Щёлкните имя действия, чтобы изучить его;
    • Общее время и Общая стоимость;
    • панели ресурсов и загрузки;
    • Консоль — для предупреждений.
  10. Щёлкните любую полосу или элемент графика, чтобы увидеть подробности.

    Сущность открывается в инспекторе с данными о том, как часто и как долго она выполнялась в этом прогоне. Открыть в ▾ → Вид элемента открывает её страницу.

  11. Нажмите ⟲ Сбросить, чтобы очистить прогон и начать снова.

Исследование Монте-Карло

  1. Переключите заголовок на Монте-Карло. Или на диаграмме Action выберите ▶ Моделировать ▾ → Монте-Карло.
  2. Задайте Прогоны (от 1 до 20 000; по умолчанию 100).
  3. Задайте Варьировать фиксированные длительности, если нужен разброс фиксированных длительностей.
  4. Введите Начальное значение генератора, если исследование должно быть воспроизводимым.
  5. Нажмите ▶ Выполнить Монте-Карло.

    Если у некоторых OR или LOOP нет вероятности или числа повторов, их перечисляет диалог Незаданные решения.

  6. В этом диалоге нажмите Использовать равные вероятности, чтобы продолжить. Или нажмите Отмена и задайте их на диаграмме Action.

    Появится индикатор выполнения и текущий текст k / n · mean … · mean cost …. Нажмите Отмена, чтобы остановить; уведомление сообщает “Прогон Монте-Карло остановлен”.

    Когда исследование завершено, текст показывает число моделирований и затраченное время.

  7. Прочитайте Завершённые прогоны, затем вкладку Распределение (Статистика, Распределение длительности, Кумулятивная вероятность (S-кривая)) и Комбинации ветвей на вкладке Факторы.

    Если какие-то прогоны попали во взаимоблокировку или завершились неудачей, красная рамка показывает их число и P(failure) с 95% доверительным интервалом.

  8. Чтобы узнать, почему прогон не удался, откройте Неудачные прогоны и нажмите Открыть прогон.

    Прогон воспроизводится в дискретно-событийном режиме со своим начальным значением.

  9. Нажмите Назад к результатам Монте-Карло, чтобы вернуться.

Проверка требования и запись результата

Используйте это после исследования Монте-Карло, чтобы превратить результаты в результат верификации.

  1. Нажмите Проверить по требованию….
  2. Выберите Выход: Общее время, Общая стоимость, минимальное или конечное количество каждого Resource или числовую глобальную переменную скрипта (Global: …).
  3. Задайте порог одним из двух способов:
    • Из Measure: выберите Мера и Использовать (Порог или Цель). Поля заполняются из Measure (см. ниже).
    • Вручную: задайте Критерий (≤ не более или ≥ не менее), Значение и Единицы и выберите Requirement.
  4. Задайте Требуемая вероятность (%) (по умолчанию 90).

    Вы увидите таблицу результатов:

    • Критерий и Прогоны;
    • Среднее (95% ДИ) и P5 / P50 / P95;
    • P(meet) с 95% доверительным интервалом;
    • Запас (среднее и порог);
    • Результат: Пройдено или Не пройдено.
  5. Нажмите Записать результат….

    Предпросмотр Записать результат перечисляет изменения, которые будут внесены:

    • Projected Value (или Value) Measure получает среднее значение.
    • Test Case верифицирует требование. Это новый тестовый случай с именем “Simulation check: <output> <criterion>” или выбранный вами существующий. Его Status становится Passed или Failed, а Фактический результат получает текст результата.
  6. Снимите отметку со строк, которые хотите пропустить.
  7. Нажмите Применить.

    Одно нажатие «Отменить» возвращает всё назад.

Когда вы выбираете Measure на шаге 3, она заполняет поля так:

  • Её значение заполняет Значение и Единицы.
  • Её Improvement Direction выбирает критерий: Negative даёт ≤, Positive даёт ≥.
  • Requirement, который она specifies, заполняет Requirement.

Сохранённые прогоны

Каждый завершённый прогон сохраняется автоматически; отдельного шага сохранения нет.

  • Дискретно-событийный прогон сохраняется по окончании (завершён, во взаимоблокировке или остановлен). Исследование Монте-Карло сохраняется, когда завершены все его прогоны; отменённое исследование не сохраняется.
  • Запись — это Artifact с меткой Simulation Run и файлом .sim. Её имя — “<root> run <date> seed <n>”, например “Perform Delivery Mission run 2026-10-14 09.30 seed 48213”, или “<root> Monte Carlo <date> seed <n>” для исследования. Её описание резюмирует результат.
  • Прогон без Начальное значение генератора получает его, поэтому имя подсказывает, как его повторить: введите это значение и запустите снова.
  • Уведомление “Сохранено как <имя>.” содержит ссылку на запись.
  • Повторы прогона Монте-Карло и открытые записи повторно не сохраняются. Читатели не могут сохранять записи.
  • Удаляйте ненужные записи в базе данных (фильтр по метке Simulation Run).

В старых проектах используется имя метки Simulation Output; при открытии проекта оно становится Simulation Run, а импорт принимает любое из имён.

Чтобы снова открыть сохранённые результаты:

  1. Откройте Сохранённые результаты ▾ в заголовке страницы.
  2. Выберите результат.

    Баннер сообщает “Просмотр сохранённых результатов: …”. Его ссылка Выполнить снова на текущей модели запускает текущую модель в том же режиме.

Разобранный пример: съёмочный проход CubeSat EO-1

Демонстрационный проект содержит операцию OPS Run Nominal Imaging Pass. В нём также есть требование 6.5 Planning Cycle Time: “The mission shall complete each planning cycle, from target list uplink to product delivery, within 100 minutes.” Создайте демо-проект через Управление проектами → Файлы проектов ▾ → Новый демо-проект.

Поток OPS:

  1. Три последовательных шага:
    • OPS.1 Transmit Imaging Plan (треугольное распределение от 4 до 9 минут, пик 6; Ground Station);
    • OPS.2 Receive Imaging Plan (1 минута);
    • OPS.3 Load Command Schedule (2 минуты).
  2. Parallel: OPS.4 Rotate to Target (нормальное, 3 ± 0,5 минуты) и OPS.5 Prepare Camera (5 минут). Оба запускаются I/O Command Schedule, который генерирует OPS.3.
  3. LOOP Each target, 4 итерации: OPS.6 Capture Image Strip (нормальное, 40 ± 6 секунд), затем OPS.7 Encode and Store Image (равномерное от 20 до 40 секунд).
  4. OR Contact in view?:
    • Yes (75%) выполняет OPS.8 Transmit Image Data (нормальное, 8 ± 1,5 минуты);
    • No (25%) выполняет OPS.9 Hold Data Onboard.
  5. Parallel: OPS.10 Recharge Battery in Sunlight (35 минут) на одной ветви. На другой — OPS.11 Receive Downlink (9 минут), за которым следует OPS.12 Process Image Products (нормальное, 45 ± 10 минут).

Ресурсы:

  • Battery Charge (начальное 62 Вт·ч, минимум 23, максимум 77). OPS.4–OPS.8 потребляют его. OPS.10 производит его (+30 Вт·ч).
  • Data Storage (начальное 1,5 ГБ). Прибавляет 2,5 ГБ на каждый OPS.7 и теряет 8 ГБ в OPS.8.

У демо-проекта есть сохранённые настройки для OPS: начальное значение 42 и 200 итераций Монте-Карло с равномерной вариацией ±10% для фиксированных длительностей.

Запустите его:

  1. Откройте Поведение → Симулятор.
  2. Выберите OPS Run Nominal Imaging Pass в качестве Корневое Action и оставьте Дискретно-событийная.
  3. Нажмите ⏩ Выполнить до конца.

    Вы увидите:

    • Action во времени показывает OPS.4 и OPS.5 рядом и четыре пронумерованные итерации OPS.6 и OPS.7 (#2, #3, #4).
    • Длинная ветвь OPS.11 → OPS.12 задаёт время окончания.
    • На вкладке Ресурсы Уровни Resource во времени показывает, как Battery Charge ступенчато снижается во время съёмки и восстанавливается во время OPS.10.
    • Общая стоимость показывает “Нет затрат”, потому что в демо-проекте нет сущностей Cost.
  4. Переключитесь на Монте-Карло.
  5. Нажмите ▶ Выполнить Монте-Карло (200 прогонов).

    Комбинации ветвей (вкладка Факторы) показывает, что около трёх четвертей прогонов пошли по Yes.

  6. Нажмите Проверить по требованию… и оставьте Общее время.
  7. Выберите Measure MOE-7 Planning Cycle Time и Использовать Порог.

    Значение становится 100, единицы — Minutes, критерий — ≤, а требование — 6.5 Planning Cycle Time.

  8. Оставьте 90% и прочитайте P(meet) и вердикт.
  9. Нажмите Записать результат…, затем Применить.

    Projected Value у MOE-7 получает среднее значение. Test Case, верифицирующий 6.5, получает Status Passed или Failed. Теперь RVTM указывает этот Test Case для 6.5.

Советы и рекомендации

  • Задайте каждому листовому действию длительность. Действие без длительности не занимает времени и не видно на оси времени.
  • Используйте распределения для длительностей, в которых вы не уверены. Варьировать фиксированные длительности используйте только для быстрой проверки чувствительности.
  • Перед Монте-Карло задайте вероятности для каждого OR и число итераций для каждого LOOP. Иначе каждый прогон выбирает случайно, и результаты сообщают об этом.
  • Задайте Начальное значение генератора перед записью результата верификации, чтобы результат можно было воспроизвести. Начальное значение включается в записанный текст.
  • Выполняйте достаточно итераций. Когда требуемая вероятность лежит внутри доверительного интервала, проверка сообщает “Выполните больше итераций для более уверенного вердикта.”
  • Настройки сохраняются с корневым действием по мере их изменения, поэтому переносятся вместе с проектом.

Типичные ошибки

СимптомПричинаИсправление
Статус показывает Взаимоблокировка; Консоль сообщает “waiting for I/O … (never generated)”Действие получает как триггер I/O, который на пройденном пути ничто не генерирует (например, после OR)Генерируйте I/O на каждом пути или задайте Trigger = false на связи receives
Взаимоблокировка “waiting for … (never available)”Resource никогда не возвращается выше количества, нужного действию, или мощность актива меньше Amount одного действияУвеличьте Initial Amount, добавьте производящее действие или проверьте Amount и Multiplicity
У каждого прогона одинаковое общее времяВсе длительности фиксированы, а вариация — НетИспользуйте распределения или задайте Варьировать фиксированные длительности
“Simulation aborted: too many steps (check LOOP counts or recursive decomposition).” (моделирование прервано: слишком много шагов)LOOP выполняется слишком часто, или действие находится внутри собственной декомпозицииУменьшите число повторов LOOP или исправьте декомпозицию
Консоль показывает “Script error in …”Скрипт выбросил исключениеОткройте скрипт действия (Изменить скрипт… в инспекторе диаграммы Action) и исправьте указанную строку
Загрузка активов пустаНи одно действие не performed by AssetСвяжите действия с выполняющими их Asset

Как это связано с остальным

  • Получает данные из: потока диаграммы Action и атрибутов и связей его действий, I/O, ресурсов, conduit, активов и затрат. Поток, построенный в функциональном анализе, — тот же поток.
  • Передаёт данные в:
    • Measure (Projected Value или Value);
    • Test Case, верифицирующие требования, а значит, RVTM и Центр тестирования;
    • Artifact с сохранёнными результатами;
    • графики работ MS Project XML и отчёты CSV.

Правила моделирования

В этом разделе точно описано, как Симулятор обрабатывает длительности, решения, ресурсы, активы, затраты и случайные числа.

Длительности и распределения

  • Duration — это значение и единица: Milliseconds, Seconds, Minutes, Hours, Days, Weeks, Months или Years. Значение без единицы читается как часы.
  • Значение — фиксированное число или распределение, например =norm.dist(40, 6) или =triang.dist(4, 9, 6).
  • Распределения выбираются заново при каждом выполнении.
  • Отрицательные выбранные длительности генерируются заново. Поэтому нормальное распределение ведёт себя как усечённое в 0.
  • Доступно десять распределений: бета, биномиальное, экспоненциальное, гамма, логнормальное, нормальное, Пуассона, треугольное, равномерное и Вейбулла. См. Типы атрибутов и распределения.
  • Duration =script() вызывает обработчик duration() действия при каждом выполнении. Введите =script() в значение Duration; обработчик возвращает длительность в единице Duration (отсутствие числа считается как 0).

Варьировать фиксированные длительности — настройка, добавляющая разброс только фиксированным числам. Распределения дополнительно никогда не варьируются.

  • Равномерная ±% выбирает равномерно в пределах ± процента.
  • Треугольная ±% выбирает по треугольнику с пиком в фиксированном значении.

Управляющие конструкции

КонструкцияПоведение при моделировании
Parallel (без сущности)Запускает все ветви сразу. Продолжает, когда все ветви завершатся.
SYNCТо же, что Parallel. Её Duration — тайм-аут. Когда он истекает, незавершённые ветви останавливаются (их полосы Ганта становятся красными, “stopped by SYNC timed out”), и поток продолжается.
ORВыбирает ровно одну ветвь по Тип решения (ниже)
LOOPПроверяет своё условие Повторять, пока перед каждым проходом и снова выполняет тело, пока оно выполняется
EXITЗавершает охватывающий LOOP. На верхнем уровне завершает поток.

Типы решений OR:

  • Вероятность: у каждой ветви есть вероятность (%). Незаполненные ветви поровну делят остаток до 100%. Если все вероятности равны 0, все ветви равновероятны.
  • Количество ресурса: каждая ветвь сравнивает текущее количество выбранного Resource (==, !=, >, <, >=, <=). Выбирается первая ветвь, условие которой выполняется, иначе ветвь с отметкой else.
  • Скрипт: onEnd() конструкции возвращает имя ветви, по которой нужно пойти (или её индекс). Неизвестное имя записывает предупреждение в журнал, и выбирается случайная ветвь.
  • Нет (спросить во время прогона или случайно): если для Решения задано Спрашивать (если нет скрипта), диалог спрашивает, какой путь выбрать. Иначе ветвь выбирается случайно.

Условия продолжения LOOP:

  • Итерации: фиксированное число проходов (не менее 1).
  • Вероятность: перед каждым проходом продолжать с этой вероятностью (%).
  • Количество ресурса: продолжать, пока количество Resource удовлетворяет сравнению.
  • Скрипт: onEnd() вызывается перед каждым проходом. true снова выполняет тело, false останавливает, а число задаёт, сколько ещё проходов выполнить.
  • Нет (спросить во время прогона или случайно): в режиме запросов диалог спрашивает Сколько итераций? (по умолчанию 3). Иначе случайно выполняется 0, 1 или 2 прохода.

Resource

У Resource есть Initial Amount, Minimum Amount, Maximum Amount и Units. Начальное количество ограничивается минимумом и максимумом.

  • consumes: количество забирается, когда действие начинается, и не возвращается.
  • seizes: количество забирается, когда действие начинается, и освобождается, когда оно заканчивается.
  • produces: количество добавляется, когда действие заканчивается. Количества выше максимума ограничиваются.

Действие ждёт, когда ему нужно больше, чем доступно. “Недоступно” означает, что количество опустилось бы ниже Minimum Amount или ниже 0, если минимум не задан. Действие ждёт, пока другие действия не освободят или не произведут достаточно. Его полоса Ганта показывает фиолетовое штрихованное ожидание.

Активы и загрузка

  • Каждый Asset, выполняющий действие (performed by), занят, пока действие выполняется.
  • Занятость (%) — доля моделируемого времени, в течение которой выполнялось хотя бы одно из его действий.

Чтобы смоделировать мощность, задайте Amount на связи performed by.

  • Мощность актива — верхняя граница Multiplicity на связи decomposed by его родителя. Например, 0..2 даёт 2.
  • Действие ждёт, пока у актива нет свободной мощности (оранжевое штрихованное ожидание).
  • Без Multiplicity мощность не ограничена.

Затраты

  • У сущности Cost есть Amount, Rate и Units.
  • При Rate Per Hour количество умножается на длительность действия в часах. Иначе оно начисляется один раз, когда действие заканчивается.
  • Cost, incurred by выполняющим Asset, начисляется за каждое действие, которое выполняет этот Asset. Он умножается на Amount связи performed by (1, если не задано).
  • Единицы первого найденного Cost подписывают все показатели стоимости.

Случайные числа и начальные значения

  • Начальное значение генератора делает прогон воспроизводимым. Оставьте его пустым, чтобы каждый раз получать новую случайную последовательность.
  • В Монте-Карло каждый прогон получает своё начальное значение из начального значения исследования. Поэтому любой отдельный прогон можно воспроизвести в дискретно-событийном режиме через Воспроизвести снова на вкладке Прогоны (или Открыть прогон для неудачного прогона).
  • Math.random() в скриптах использует тот же генератор с начальным значением.

Страница “Симулятор”

Заголовок страницы и панель прогона

Панель под заголовком страницы содержит слева направо Корневое Action, элементы управления прогоном для режима (ниже), Настройки и переключатель режима. До первого прогона страница показывает одну строку пояснения и диаграмму Action; карточки сводки (Статус, Общее время, Общая стоимость или карточки Монте-Карло) появляются с первым прогоном.

  • Корневое Action: действие, поток которого выполняется. Список показывает все Action с потоком действий. Действие без потока отображается как “(нет потока)”. Выбор другого корня заново открывает страницу для него.
  • Дискретно-событийная / Монте-Карло: режим. При переключении настройки каждого режима сохраняются.
  • Заголовок страницы: Сохранённые результаты ▾ (сохранённые прогоны или “Сохранённых прогонов пока нет. Здесь сохраняется каждый завершённый прогон.”) и Открыть диаграмму Action.

Настройки

Настройки показывает или скрывает настройки прогона под панелью (сначала скрыты; выбор запоминается в этом браузере). Её подсказка перечисляет текущие настройки, например “автоматические решения, скорость 100×, фиксированные длительности, начальное значение 42”.

НастройкаРежимЗначенияПо умолчанию
ПрогоныМонте-Карлоот 1 до 20 000100
РешенияДискретно-событийнаяАвтоматически (если нет скрипта), Спрашивать (если нет скрипта)Автоматически (если нет скрипта)
СкоростьДискретно-событийная1×, 10×, 100×, 1000×, 10 000×, 100 000× (моделируемых секунд на реальную секунду)100×
Варьировать фиксированные длительностиОба (хранятся отдельно для каждого режима)Нет, Равномерная ±%, Треугольная ±%Нет
± %ОбаОт 0 до 10010
Начальное значение генератораОбаЧисло или пусто для случайного значенияпусто
Календарные датыДискретно-событийнаяЗапускать часы с даты Start корневого Action; Action с атрибутом Start ждут её наступлениявыкл.
Начинать на паузе (пошаговое выполнение)Дискретно-событийнаяСоздаёт прогон при открытии страницы, готовый к ⏭ Шагвыкл.
  • Настройки сохраняются в проекте вместе с корневым действием по мере их изменения и действуют для всех, кто его открывает. Каждое изменение отменяется одним нажатием “Отменить”. Они также запоминаются в этом браузере для других корневых действий.
  • Восстановить значения по умолчанию (после “Настройки сохранены с этим Action.”) восстанавливает значения по умолчанию и сбрасывает выбор сущностей на графиках.
  • Читатели могут менять настройки для своих прогонов; в проекте они не сохраняются.

Элементы управления дискретно-событийным моделированием

  • ▶ Воспроизвести / ⏸ Пауза: анимировать прогон с выбранной скоростью. Длинные отрезки без событий пропускаются сразу.
  • ⏭ Шаг: перейти к следующему событию.
  • ⏩ Выполнить до конца: выполнить до конца без анимации. Запросы при этом всё равно останавливают прогон.
  • ⟲ Сбросить: отбросить прогон.
  • Часы: текущее модельное время (дата и время в режиме “Календарные даты”).

Элементы управления Монте-Карло

  • ▶ Выполнить Монте-Карло, Отмена, индикатор выполнения и текст о ходе выполнения.
  • Проверить по требованию… (доступно после исследования с завершёнными прогонами).
  • Любой прогон можно воспроизвести снова или скачать как расписание MS Project на вкладке Прогоны.

Примечания над панелями

Уведомления, требующие внимания, например о просмотре сохранённых результатов, остаются видимыми и при скрытых настройках.

  • “К фиксированным длительностям добавлена равномерная вариация ±n%.” (или треугольная), когда вариация включена.
  • “Для n незаданных конструкций использованы равные вероятности: …” после Использовать равные вероятности.
  • Рамка неудачных прогонов (Монте-Карло) и баннер повтора “Повтор прогона Монте-Карло n (взаимоблокировка или ошибка) с начальным значением s и настройками исследования.”

Панели

Результаты расположены в фиксированной раскладке: сводная полоса сверху и вкладки под ней. Каждая вкладка содержит два столбца панелей; широкие панели (диаграмма, диаграмма Ганта, журнал событий, Статистика и Прогоны) занимают оба. До прогона каждая панель показывает своё описание. Открытая вкладка запоминается в этом браузере.

Меню панели

У каждой панели есть заголовок и одно меню ⋯:

  • Скачать данные… открывает диалог экспорта с данными панели: файлы CSV со всеми столбцами, а для Action во времени также Расписание (MS Project XML). Имя файла — “<корень> <заголовок панели>”.
  • Скачать изображение… открывает диалог экспорта с <заголовок панели> (PNG) (с Прозрачный фон и Масштаб) и <заголовок панели> (SVG). Изображения используют цвета светлой темы.
  • Выбрать сущности… (графики затрат, ресурсов и активов) открывает Выбор сущностей: отфильтруйте список по имени или номеру, отметьте сущности (Все, Нет) и нажмите Применить. Если ничего не отмечено, график показывает все сущности. Графики затрат добавляют Показать итог. Цвета следуют палитре графика в порядке списка. Выбор сохраняется с корневым действием.

Щёлкните сущность на графике, в списке Статус или в журнале событий, чтобы открыть её в инспекторе с данными о том, как часто и как долго она выполнялась.

Вкладки дискретно-событийного режима

Сводная полоса: Статус, Общее время и Общая стоимость.

ВкладкаПанельПоказываетДанные
—СтатусДействия, выполняющиеся сейчас, с ходом выполнения. Жёлтый: ожидание Input/Output; фиолетовый: Resource; оранжевый: пропускная способность Asset. В конце: Выполнено на 100%, Взаимоблокировка или Остановлено, с числом выполнений действий и общим временем—
—Общее времяЧасы моделирования (дата в режиме “Календарные даты” с прошедшим временем)—
—Общая стоимостьТекущая общая стоимость и число сущностей с затратами—
Временная шкалаДиаграмма Action во время прогонаКорневая диаграмма Action только для чтения; действия окрашиваются по мере выполнения (зелёный), ожидания (оранжевый) и завершения (серый)—
Временная шкалаAction во времениДиаграмма Ганта выполненных действий; заштрихованные части — ожидания; декомпозированные действия показаны скобками, которые можно свернуть щелчком (▸/▾); повторные выполнения нумеруются #2, #3; красные полосы остановлены по тайм-ауту SYNC; красная пунктирная линия отмечает часы. Инструменты: +, − (масштаб), Сбросить, Скрыть стрелки линий / Показать стрелки линий, Скрыть цвета линий / Показать цвета линийВременная шкала (CSV), Расписание (MS Project XML)
СтоимостьСтоимость во времениНакопленная стоимость по каждой выбранной сущности и итогСтоимость во времени (CSV)
СтоимостьСтоимость по сущностямОбщая стоимость по каждой выбранной сущности (столбчатая диаграмма)Стоимость по элементам (CSV)
ResourceУровни ресурсов во времениКоличества выбранных Resource во времениУровни ресурсов во времени (CSV)
ResourceКоличества ресурсовНачальное, минимальное, максимальное, конечное, потреблённое и произведённое количество по каждому ResourceИзменения ресурсов (CSV)
ResourceВремя занятости AssetЗанятость (%) каждого выполняющего Asset и используемые единицы (или выполняющиеся действия) во времениИспользование активов (CSV)
ЖурналКонсольВывод print(), ошибки скриптов (с номерами строк), предупреждения и взаимоблокировкиКонсоль (CSV)
ЖурналЖурнал событийКаждое событие движка: start, end, wait, resume, io, transfer, resource, decision, loop, exit, sync, killed, cost, deadlock, errorЖурнал событий (CSV)
ЖурналПеременные скриптовГлобальные переменные скриптов (globals.put) с текущим значением; разверните значение, чтобы увидеть его историюГлобальные значения (CSV)

Пока прогон воспроизводится, перерисовываются только сводная полоса и открытая вкладка; остальные вкладки обновляются, когда вы их открываете или когда прогон завершается.

Вкладки Монте-Карло

Сводная полоса: Завершённые прогоны.

ВкладкаПанельПоказываетДанные
—Завершённые прогоныЗавершённые моделирования; среднее и стандартное отклонение длительности и стоимости. Прогоны со взаимоблокировкой или ошибкой считаются отдельно и исключаютсяСводка Монте-Карло (CSV)
РаспределениеСтатистикаСреднее, 95% ДИ среднего, стандартное отклонение, минимум, P5, медиана (P50), P95 и максимум длительности, стоимости и каждой числовой глобальной переменной скрипта (только завершённые прогоны)—
РаспределениеРаспределение длительностиГистограмма общей длительности по прогонамДлительности прогонов (CSV)
РаспределениеРаспределение стоимостиГистограмма общей стоимости по прогонам (“Ни в одном прогоне не было затрат.” без затрат)Стоимость прогонов (CSV)
РаспределениеНакопленная вероятность (S-кривая)Интегральное распределение выбранного выходного показателя с полем x и показанием P(X ≤ x)—
ФакторыВремя по ActionСуммарные длительности действий по всем прогонамДлительности действий (CSV)
ФакторыСтоимость по ActionСуммарная стоимость по каждому действию или активу по всем прогонамСтоимость действий (CSV)
ФакторыКомбинации ветвейКаждая комбинация ветвей OR с Прогоны и ДоляКомбинации ветвей (CSV)
ResourceУровни ресурсовСреднее минимальное, максимальное и конечное количество по каждому ResourceРесурсы по прогонам (CSV)
ResourceВремя занятости AssetСредняя занятость (%) каждого выполняющего Asset (столбчатая диаграмма, если активов меньше трёх)Использование активов по прогонам (CSV)
ПрогоныПрогоныКаждый прогон с Выполнить, Начальное значение, Исход (Завершён, Взаимоблокировка, Ошибка), Длительность и Стоимость. Щёлкните заголовок столбца для сортировки (повторно — в обратном порядке). P10, P50 и P90 выбирают прогон в этой точке распределения длительности и выделяют его. Воспроизвести снова повторяет прогон в дискретно-событийном режиме с его начальным значением; MS Project скачивает его как расписание MS Project XML “<корень> run <n>.xml”. Перечисляются первые 500 прогоновПрогоны (CSV) (каждый прогон: начальное значение, исход, длительность, стоимость, путь, глобальные переменные)

Сообщения консоли по отдельным прогонам в исследовании не хранятся; чтобы их увидеть, используйте Воспроизвести снова для прогона.

Скрипты

Скрипты — это обработчики JavaScript для Action, OR, SYNC и LOOP. Используйте их, когда одна диаграмма не может выразить поведение, например решение на основе уровня ресурса.

Чтобы написать скрипт:

  1. На диаграмме Action выберите элемент.
  2. В инспекторе нажмите Изменить скрипт… (для действия) или Изменить скрипт… / Добавить скрипт… на панелях OR, SYNC и LOOP.

    Открывается диалог редактора, например Скрипт: Capture Image Strip или Скрипт OR: ….

  3. Нажмите Добавить onStart(), Добавить prompt(), Добавить onEnd() или Добавить duration(), чтобы вставить пустой обработчик.
  4. Напишите код. Tab вставляет два пробела.
  5. Нажмите Сохранить (или Отмена).

Обработчики

ОбработчикВызываетсяВозвращаемое значение
onStart()Когда действие или конструкция начинается—
prompt(p)После onStart, чтобы построить диалог ввода— (заполнить p)
onEnd(response)Когда действие завершается; для OR — когда он принимает решение; для LOOP — перед каждым проходомOR: имя или индекс ветви. LOOP: true, чтобы продолжить, false, чтобы остановиться, или число дальнейших проходов
duration()Когда Duration действия равен =script()Длительность в единице атрибута Duration

response содержит ответы диалога запроса с ключами по имени входа.

При Автоматически (если нет скрипта) и в режиме Монте-Карло запрос не показывается. Вместо этого используются значения по умолчанию: значение числа или 0, значение флажка или первый вариант выбора.

Построитель запросов

  • p.setTitle(text): заголовок диалога (по умолчанию “Вход для <имя>”).
  • p.addEnumInput(title, name, choices, default): список выбора.
  • p.addTextInput(title, name, default), p.addBigtitleTextInput(title, name, default) (многострочный), p.addNumberInput(title, name, default), p.addBooleanInput(title, name, default) (флажок).

В диалоге написано “Моделирование приостановлено в <время>.”, и он закрывается кнопкой OK.

Доступно в скриптах

  • print(x, …): пишет в Консоль. Объекты выводятся как JSON.
  • globals.put(key, value), globals.get(key): значения, отслеживаемые во времени в Переменных скриптов. Числовые глобальные переменные становятся выходными показателями Монте-Карло (Global: key) в Статистике, S-кривой и Проверить по требованию….
  • Sim.getEntityById(id), Sim.getEntityByGlobalId(id), Sim.getEntityByName(name), Sim.getEntityByNumber(number), Sim.getEntitiesByName(name), Sim.getEntitiesByNumber(number): возвращают обёртки сущностей.
    • Свойства: id, name, number, description, className.
    • Методы: getId(), getGlobalId(), getName(), getNumber(), getDescription(), getAttribute(name) (по имени атрибута, без учёта регистра) и attributes().get(name).
  • Sim.getIOValueById(id), Sim.getIOValueByGlobalId(id), Sim.getIOValueByName(name), Sim.getIOValueByNumber(number): атрибут Value объекта Input/Output.
  • Sim.getAmount(name), Sim.getAmountById(id), Sim.getAmountByGlobalId(id): текущее количество Resource. Sim.getResourceByName(name) возвращает {id, name, amount, units}.
  • Sim.setResourceById(id, value), Sim.setResourceByGlobalId(id, value), Sim.setResourceByName(name, value): задать количество Resource (записывается в журнал как изменение скриптом).
  • Sim.getCurrentTime() (миллисекунды от начала) и Sim.getCurrentCost().

Каждый скрипт компилируется один раз за прогон, поэтому переменные верхнего уровня сохраняют значения между проходами цикла. Модель доступна скриптам только для чтения, кроме количеств ресурсов.

Пример: выбор ветви по заряду батареи

function onEnd() {
  const wh = Sim.getAmount('Battery Charge');
  globals.put('Battery at decision', wh);
  return wh > 40 ? 'Yes' : 'No';
}

Поместите это в OR Contact in view? с Тип решения Скрипт. Ветви должны называться Да и Нет.

Песочница и доверие

  • Каждый прогон выполняется в отдельной песочнице с копией модели только для чтения. У скриптов нет доступа к странице, другим проектам, файлам, хранилищу браузера или сети.
  • Вызов скрипта, работающий дольше 8 секунд, останавливает прогон: “Скрипт <имя> работал дольше 8 с и был остановлен. Проверьте, нет ли в нём бесконечного цикла.”
  • Скрипты, которые вы пишете или одобряете в этом браузере, считаются доверенными.

Прогон может включать скрипты из другого источника, например из импортированного файла или правок другого участника. Перед таким прогоном Holarch просит вас одобрить их. Вопрос появляется перед ▶ Воспроизвести, ⏭ Шаг, ⏩ Выполнить до конца и ▶ Выполнить Монте-Карло.

  1. Запустите прогон.

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

  2. Откройте Показать скрипты, чтобы просмотреть их.
  3. Нажмите Выполнить скрипты, чтобы выполнить их, или Отмена.

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

Клавиатура и мышь

ДействиеДействие
Щелчок по полосе Ганта, точке графика, ячейке древовидной карты или строке статусаОткрывает сущность в инспекторе
Щелчок по метке декомпозированной строки ГантаСворачивает или разворачивает её дочерние строки
Tab в редакторе скриптовВставляет два пробела

Сообщения

СообщениеЗначение и исправление
“Нет Action для моделирования” / “Задайте у Action дочерние Action и нарисуйте их поток на его диаграмме Action.”В проекте нет Action с потоком
“Ошибка моделирования” с подробностямиПрогон не удалось запустить или произошёл сбой песочницы; прочитайте подробности
“Корневое Action больше не существует. Выберите другое корневое Action.”Корень был удалён
“Ошибка скрипта в <имя> (<обработчик>): <сообщение>”Скрипт выбросил исключение; прогон останавливается. Консоль показывает номер строки
“<имя>: скрипт вернул “x”, что не соответствует ни одной ветви; выбрано случайно.”Скрипт OR вернул неизвестное имя ветви
“<имя>: более 10000 итераций — проверьте условие LOOP.”LOOP никогда не останавливается
Бесконечные циклы (перед прогоном)Никакой EXIT не может завершить цикл, повторяющийся с вероятностью 100 % (Action.19). Исправьте это или нажмите Всё равно выполнить.
“Существует бесконечная иерархия (A → B → A). Удалите одну из этих связей декомпозиции на диаграмме.”Действие декомпозировано само в себя
“Simulation aborted: too many steps (check LOOP counts or recursive decomposition).” (моделирование прервано: слишком много шагов)Более 20 000 выполнений действий за один прогон
“Моделирование прервано: достигнут предел событий.”Более 500 000 событий за один прогон
“Взаимоблокировка: <действие> ожидает I/O <имя> (никогда не генерируется)”I/O-триггер так и не был сгенерирован
“Взаимоблокировка: <действие> ожидает <количество> <ресурс> (никогда не доступно)” / “ожидание пропускной способности Asset: …”Ресурс или пропускная способность так и не стали доступны
“У Asset <имя> более одного родителя; для его пропускной способности используется первый.”Пропускная способность актива берётся из Multiplicity первого родителя
“<I/O> переносится несколькими Conduit; симулятор использовал <conduit>.”Применяется только задержка первого Conduit
“У скриптов моделирования нет доступа к сети (Sim.httpGet, httpPost и httpPut недоступны).”Скрипты не могут обращаться к сети
“Не найдена сущность с именем: <имя>” / “Не найден ресурс с id: <id>”Поиск Sim ничего не нашёл
“Скрипты моделирования не могут компилировать код во время выполнения.” / “Скрипты моделирования не могут использовать import().”Скрипт попытался создать или загрузить код
“Скрипт <имя> работал дольше 8 с и был остановлен. Проверьте, нет ли в нём бесконечного цикла.”Сторожевой таймер скриптов
“Моделирование перестало отвечать и было остановлено.”Песочница перестала отвечать вне скрипта
“Прогон Монте-Карло остановлен”Вы нажали Отмена
“n из N прогонов не удались (d — взаимоблокировка, e — ошибка). P(failure) = …”Неудачные прогоны исключаются из статистики; используйте Открыть прогон
“Нет завершённых прогонов. Сначала выполните Монте-Карло.”Для Проверить по требованию… нужны завершённые прогоны
“Введите пороговое значение или выберите Measure.” / “Сначала введите пороговое значение.”У проверки нет значения
“У <Measure> нет числового Threshold Value. Введите порог.”Порог или цель Measure не является числом
“Выберите Measure или Requirement, чтобы записать результат.”Для Записать результат… нужна цель
“Выберите хотя бы одно изменение.”Все строки в Записать результат не отмечены
“Результат записан”Measure и Test Case обновлены
“Требуемая вероятность лежит внутри доверительного интервала. Выполните больше итераций для более уверенного вердикта.”Вердикт может измениться при большем числе прогонов
“Не удалось прочитать сохранённые результаты: <причина>. Выполните моделирование снова.”Сохранённый файл .sim отсутствует или недействителен; нажмите Выполнить снова
“Эта панель относится к другому режиму моделирования.”Панель другого режима
“Только просмотр: попросите владельца о доступе на редактирование.”Читатели могут выполнять моделирование, но не могут сохранять настройки, результаты или записанные проверки

Ограничения

  • Монте-Карло: от 1 до 20 000 итераций на исследование.
  • Один прогон: не более 20 000 выполнений действий, 500 000 событий и 10 000 проходов одного LOOP.
  • Вызовы скриптов: по 8 секунд каждый.
  • Таблица неудачных прогонов: перечисляются первые 50 неудачных прогонов. Прогоны ⋯ → Скачать данные… → Прогоны (CSV) перечисляет все прогоны.
  • Вкладка Прогоны: перечисляются первые 500 прогонов; в Прогоны (CSV) есть все.
  • Статистика Монте-Карло использует только завершённые прогоны.
  • Задержку I/O задаёт только первый Conduit, который его передаёт; пропускную способность актива задаёт только первый родитель.