Holarch

Поведение

Диаграммы Action

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

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

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

Обзор

Диаграмма Action показывает, как выполняется родительский Action. Это поведенческая диаграмма LML, и Симулятор выполняет ровно то, что она показывает.

Диаграмма показывает:

  • дочерние Action в порядке их выполнения;
  • где поток разделяется на параллельные пути или альтернативы и где он зацикливается;
  • Input/Output (входы/выходы), передаваемые от одного Action к другому;
  • Resource, которые использует каждый Action;
  • Активы, выполняющие работу.

Диаграмма — это представление модели, а не рисунок. Каждая добавленная, перемещённая или удалённая фигура меняет сущности и связи в проекте. Каждое изменение отменяется одним нажатием “Отменить”.

Тот же поток управляет функциональной потоковой блок-схемой (FFBD), SysML диаграммой деятельности и диаграммой Timeline. Измените поток в любой из них, и остальные последуют.

Понятия

Поток

Поток идёт от зелёной таблетки Начало слева к красной таблетке Конец справа. Стрелки соединяют элементы между ними. Каждый элемент — один из следующих:

ЭлементФормаЧто означаетСущность
Action (последовательный шаг)Скруглённый синий прямоугольник с номером и именемШаг, который начинается, когда заканчивается предыдущий элементДочерний Action корня (decomposed by)
ПараллельноПолоса разветвления с подписью parallel и закрывающая полосаДве или более ветви, выполняемые одновременно. Поток продолжается, когда все ветви завершатся.Нет
SYNCБлок с отметкой SYNC с острием справа и закрывающая полосаПараллельные ветви с собственной сущностью. Её Duration — тайм-аут, который останавливает незавершённые ветви.Action с именем “Sync Action” (тип управления SYNC)
ORБлок с отметкой OR с острием слева и закрывающий кругРешение: выполняется ровно одна ветвьAction с именем “Or Action” (тип управления OR)
LOOPВходной круг, тело цикла, блок с отметкой LOOP, пунктирная обратная стрелкаТело повторяется, пока выполняется условие продолжения. Условие проверяется перед каждым проходом.Action с именем “Loop Action” (тип управления LOOP)
EXITКрасный прямоугольник с отметкой EXITПри достижении завершает охватывающий LOOP (или поток, в котором находится)Нет

Ветвь — один путь внутри Parallel, SYNC или OR. Каждая ветвь — собственная последовательность и может содержать любой элемент, включая другие конструкции. LOOP содержит одну последовательность, называемую его телом.

OR, SYNC и LOOP — конструкции с собственной сущностью. Эта сущность — дочерний элемент корня, как шаг, поэтому конструкция может нести имя, скрипт и (для SYNC) тайм-аут. Конструкции — не шаги: они никогда не отображаются как прямоугольники Action, и такие виды, как Timeline, их пропускают.

Предметы вокруг потока

ПредметФормаСвязьЗначение
Input/OutputПараллелограмм над потоком. Зелёный, когда запускает Action, иначе серый.Action generates I/O; Action receives I/OИнформация, данные или материал, передаваемые между Action
Input/Output родителяПараллелограмм с подписью parent input (слева от начала) или parent output (справа от конца)Корневой Action receives или generates егоИнтерфейс родительского Action. Рисуется пунктиром, пока его не использует ни один дочерний Action.
ResourceФиолетовый шестиугольник под потокомAction consumes, produces или seizes Resource с AmountКоличество, которое Action расходуют, возвращают или создают
Выполняющий Asset⟂ и имя Asset под именем ActionAsset performs ActionКто или что выполняет Action. Показывается, когда включено Активы.
Исполнитель⟂ и имя Asset на ветви Parallel или SYNCAsset performs каждый Action на ветвиИсполнитель для всей ветви. Синхронизируется при каждом изменении.

Для моделирования важны два понятия:

  • Триггер: полученный I/O с установленным Trigger (по умолчанию) заставляет принимающий Action ждать, пока этот I/O не появится.
  • Необязательно: полученный I/O с выключенным Trigger. Action начинается, не дожидаясь его.

Линия Resource подписана связью и количеством, например consumes 1.5. Resource, который только захватывается, рисуется светлее.

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

Когда и зачем

Стройте диаграмму Action, когда у вас есть набор функций, и до их распределения по физической архитектуре. Функции обычно получаются в результате функционального анализа требований.

Диаграмма отвечает на такие вопросы:

  • В каком порядке выполняются функции и какие из них выполняются параллельно?
  • Где система принимает решение?
  • Что нужно каждой функции и что она производит?
  • Сколько времени занимает вся последовательность?

Используйте одну диаграмму на каждый уровень декомпозиции. Начните с операционного сценария верхнего уровня, например временной шкалы миссии или варианта использования. Затем добавьте диаграмму для каждой функции, которой нужна собственная детализация.

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

Построение потока с нуля

Создайте диаграмму:

  1. Откройте Диаграммы внизу панели навигации.
  2. Нажмите + Новая диаграмма.
  3. В Тип диаграммы выберите Диаграмма Action (в группе Поведение, с тегом LML).
  4. В Корень введите имя нового Action, например Run Nominal Imaging Pass. (Номер, например OPS, можно задать позже в инспекторе.)
  5. Нажмите Создать.

    Вы увидите начало и конец и подсказку Перетащите сюда элемент или нажмите + Action.

Добавьте последовательные шаги:

  1. Нажмите + Добавить ▾ → + Action ▾ → Новый Action….
  2. Введите имя в Добавить Action.
  3. Нажмите OK (или Enter).

    В потоке появится пронумерованный прямоугольник Action. Номера продолжают номер родителя: OPS.1, OPS.2 и так далее. Новый Action — дочерний элемент корня.

  4. Оставьте новый Action выбранным и повторите шаги 1–3 для следующего шага. + Action всегда вставляет после выбранного элемента.

Добавьте шаги, выполняемые одновременно:

  1. Выберите шаг, после которого начинаются параллельные шаги.
  2. Нажмите + Добавить ▾ → + Sync.

    Появится SYNC с двумя пустыми ветвями.

  3. Щёлкните линию ветви, чтобы выбрать её.
  4. Нажмите + Добавить ▾ → + Action ▾ → Новый Action…, чтобы добавить шаг в эту ветвь.
  5. Нажмите + Ветвь, если нужна третья ветвь.

Используйте + Добавить ▾ → + Action ▾ → Параллельные ветви (без сущности) вместо + Sync, когда не нужны тайм-аут, имя или скрипт.

Добавьте решение:

  1. Выберите шаг перед решением.
  2. Нажмите + Или.
  3. Введите вопрос, например Contact in view?.

    Появятся две ветви, Yes и No, по 50% каждая.

  4. Выберите OR и задайте имена условий и вероятности в инспекторе.

Повторите шаг:

  1. Выберите шаг.
  2. Нажмите + Добавить ▾ → + Цикл.
  3. Введите имя цикла.

    Шаг окажется обёрнут в цикл, выполняемый дважды.

  4. Задайте число итераций или другое условие в инспекторе.

Задайте длительности и проверьте результат:

  1. Выберите Action.
  2. Заполните Duration в группе График работ инспектора.
  3. Чтобы задать нескольким Action одинаковую длительность, выберите их Shift-щелчком и задайте Длительность (N Action) в инспекторе.
  4. Щёлкните значок проверок диаграммы на панели инструментов (✓ Проверки или ⚠ и число).

    Инспектор перечисляет Action без длительности и несоединённые предметы.

Построение потока перетаскиванием из палитры

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

  1. Перетащите Action на любую линию потока. Линия вставки подсвечивается, пока предмет находится над допустимым местом.

    В этой точке появится “New Action”. Его поле имени в инспекторе выделено и готово к вводу.

  2. Введите имя.
  3. Так же перетащите на линию Parallel, Или, Sync, Цикл или Exit.
  4. Перетащите Input/Output на Action. Это создаёт I/O, который генерирует Action. Бросьте его на пустой холст, чтобы разместить несоединённый I/O.
  5. Перетащите Resource на Action. Это создаёт Resource, который потребляет Action (Amount 1). Бросьте его на пустой холст, чтобы разместить его несоединённым.
  6. Перетащите Исполнитель на линию ветви Parallel или SYNC, затем выберите Asset.

    Теперь Asset выполняет каждый Action на этой ветви.

Чтобы повторно использовать предметы, уже имеющиеся в модели:

  1. Введите имя в Добавить или найти…. В проекте перечисляет подходящие Action, Input/Output, Resource и Asset.
  2. Перетащите совпадение на диаграмму:
    • Action — на линию;
    • I/O или Resource — на Action или холст;
    • Asset — на линию ветви Parallel или SYNC.

С клавиатуры установите фокус на элемент палитры и нажмите Enter или Space. Конструкции попадают в конец основного потока. Input/Output и Resource — в центр вида.

Подключение Input/Output и Resource

Соединяйте предметы, перетаскивая маркер от одной фигуры к другой.

Передайте I/O от одного Action к другому:

  1. Выберите первый Action.

    Над ним появится зелёный маркер.

  2. Перетащите маркер на второй Action.

    При наведении целевой прямоугольник показывает две половины.

  3. Отпустите на половине Триггер (верхней) для запускающего входа или на половине Необязательно (нижней) для необязательного.

    Holarch создаёт новый Input/Output. Первый Action генерирует его, второй получает. Новый I/O выбран, и его поле имени готово к вводу.

  4. Введите имя I/O.

Маркер Action можно отпустить и в других местах:

  • На существующий Input/Output: Action генерирует его.
  • На Resource: Action производит его (Amount 1).
  • На пустой холст: Holarch создаёт новый выход Action.

Сделайте так, чтобы Action получал существующий I/O:

  1. Выберите Input/Output.
  2. Перетащите его маркер (под фигурой) на Action.
  3. Отпустите на Action, затем выберите Input (триггер) или Input (необязательно) в меню выбора соединения.

Если Action уже получает этот I/O, меняется только его настройка Trigger.

Сделайте так, чтобы Action использовал Resource:

  1. Выберите Resource.
  2. Перетащите его маркер (над фигурой) на Action.
  3. Отпустите на половине Потребляет (верхней) или Захватывает (нижней).

Переключение между consumes и seizes сохраняет количество.

Задайте количество для связи с ресурсом:

  1. Выберите Action.
  2. В разделе Трассировка инспектора найдите Resource под consumes, produces или seizes и нажмите Атрибуты.
  3. Измените атрибут связи Amount.

Разместите I/O и Resource вручную:

  • Перетащите фигуру Input/Output или Resource в нужное место. Положение сохраняется вместе с диаграммой.
  • Нажмите Сбросить положение в её инспекторе, чтобы вернуть её в автоматическую компоновку над или под использующими её Action.
  • Выберите Упорядочить ▾ → Сбросить положения Input/Output и Resource, чтобы сбросить их все.

Назначение исполнителей

Назначьте Asset одному Action:

  1. Выберите Action и выберите Открыть в ▾ → Вид элемента. (На диаграмме performed by заблокирована в инспекторе, потому что ею управляет диаграмма.)
  2. В разделе Трассировка добавьте performed by через + → Связать существующий….
  3. Выберите Asset.

Назначьте Asset всей ветви Parallel или SYNC одним из двух способов:

  • Перетащите Исполнитель с панели добавления на линию ветви.
  • Выберите Parallel или SYNC и нажмите + Asset рядом с ветвью в инспекторе.

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

Декомпозиция и детализация

Задайте одному Action собственный дочерний поток:

  1. Выберите Action.
  2. Нажмите Декомпозировать.

    Откроется собственная диаграмма Action этого Action.

  3. Постройте там его дочерний поток.
  4. Нажмите ▲ Родитель в заголовке страницы, чтобы вернуться.

Дочерний поток можно также открыть двойным щелчком по декомпозированному Action или щелчком по его значку декомпозиции.

Сгруппируйте несколько шагов в новый дочерний Action:

  1. Выберите Shift-щелчком два или более соседних элемента на одной линии.
  2. Нажмите Декомпозировать (группа).

    Элементы перемещаются в новый дочерний Action с именем “New Action” и собственным потоком. Появится уведомление Сгруппировано в новый дочерний Action. Назовите его в инспекторе., и поле имени будет выделено.

  3. Введите новое имя.

Сведите дочерний поток обратно в эту диаграмму:

  1. Выберите декомпозированный Action.
  2. Нажмите Свести в один уровень (на панели инструментов или в инспекторе).

    Его дочерний поток заменяет его в этой диаграмме.

  3. Выберите Сохранить Action, чтобы оставить опустевший Action в модели (вне этой диаграммы), или Удалить элемент, чтобы удалить его.

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

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

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

    Вы увидите, что Симулятор будет считать отсутствующим:

    • Action без длительности моделируются как 0.
    • I/O, которые не генерирует ни один Action, оставляют своих получателей ждать (взаимоблокировка).
    • Перечисляются Resource, которые ничто не использует.
  2. Исправьте то, о чём сообщает проверка.
  3. Нажмите ▶ Моделировать ▾ и выберите Дискретно-событийная, чтобы посмотреть один прогон во времени, или Монте-Карло для многих прогонов.

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

  4. Запустите моделирование.

Прогон, который ждёт бесконечно, сообщается как взаимоблокировка. Статус Симулятора показывает причину, а вкладка Журнал перечисляет её:

  • waiting for I/O … (never generated)
  • waiting for … (never available)

Исправьте диаграмму и запустите снова. Например, превратите триггер в необязательный вход.

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

Демонстрационный проект содержит диаграмму Action OPS Run Nominal Imaging Pass.

  1. Создайте демо-проект через Управление проектами → Файлы проектов ▾ → Новый демо-проект.
  2. Откройте диаграмму через Поведение → Диаграммы Action.

Поток выполняется так:

  1. Три шага выполняются последовательно:
    • OPS.1 Transmit Imaging Plan (Ground Station, треугольное распределение 4–9 минут, наиболее вероятно 6);
    • OPS.2 Receive Imaging Plan (UHF Transceiver, 1 минута);
    • OPS.3 Load Command Schedule (C&DH, 2 минуты).
  2. Parallel одновременно выполняет OPS.4 Rotate to Target (ADCS, нормальное распределение 3 ± 0,5 минуты) и OPS.5 Prepare Camera (Payload Camera, 5 минут). Оба получают Command Schedule как триггер.
  3. LOOP с именем Each target выполняет OPS.6 Capture Image Strip и OPS.7 Encode and Store Image четыре раза (Continue (×4)).
  4. OR с именем Contact in view? выбирает следующий шаг:
    • Yes (75%): OPS.8 Transmit Image Data;
    • No (25%): OPS.9 Hold Data Onboard.
  5. Завершающий Parallel заряжает батарею (OPS.10), пока наземный сегмент получает и обрабатывает данные (OPS.11, OPS.12).

Поток использует два Resource:

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

Image Data Package — необязательный вход OPS.11. Поэтому проход без связи не приводит к взаимоблокировке наземного сегмента.

Попробуйте такие изменения:

  1. Выберите OR и измените Yes на 60, а No на 40.

    Метки ветвей показывают Yes (60%) и No (40%). Инспектор показывает Total 100%.

  2. Выберите LOOP и задайте Число итераций равным 6.

    Текст цикла показывает Continue (×6).

  3. Выберите ▶ Моделировать ▾ → Монте-Карло и запустите.

    Больше целей за проход — больше расход батареи. Полоса сводки и вкладка Распределение показывают более долгое время прохода.

  4. Включите Активы, чтобы увидеть каждого исполнителя.
  5. Выберите Упорядочить ▾ → Создать диаграмму Asset.

    Holarch создаёт Asset “Run Nominal Imaging Pass performers”. Его дочерние элементы — выполняющие Asset, с Conduit для каждого I/O, передаваемого между двумя из них. Открывается его диаграмма Asset.

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

  • Называйте Action по схеме “глагол + объект” (Capture Image Strip), а I/O — существительными (Image Strip). Называйте условия OR как ответы на вопрос OR.
  • Ограничивайте каждую диаграмму примерно семью–двенадцатью элементами. Группируйте детали в дочерние Action через Декомпозировать (группа).
  • По умолчанию используйте Parallel (без сущности). SYNC используйте, только когда нужны тайм-аут, имя или скрипт.
  • OR в режиме вероятностей должен давать в сумме 100%. Если вероятности неизвестны, выберите Нет (спросить во время прогона или случайно). Тогда Симулятор спрашивает, а Монте-Карло использует равные вероятности.
  • Задайте каждому листовому Action длительность перед моделированием. Если время меняется, используйте распределение, например =norm.dist(40,6) Seconds.
  • Сделайте полученный I/O Необязательно, если Action может начаться без него. Иначе ветвь, которая его никогда не производит, приводит прогон к взаимоблокировке.
  • Нумеруйте дочерние элементы в порядке потока через Перенумеровать дочерние… в инспекторе корня (Упорядочить ▾ → Настройки диаграммы), задав порядок дочерних элементов по потоку.

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

СимптомПричинаИсправление
Бросьте конструкцию на линию потока.Конструкция или Action отпущены на фигуре или пустом холстеОтпустите на стрелке между элементами
Вероятности ветвей в сумме дают 90 %. Измените их, чтобы сумма была 100 %.Вероятности OR не дают в сумме 100 %Исправьте проценты или добавьте ветвь
Моделирование никогда не заканчивается (взаимоблокировка)Action ждёт запускающий I/O, который на этом пути ничто не генерируетСделайте вход Необязательно или генерируйте его на каждом пути
Action не занимает времени при моделированииНет длительности, или Action декомпозирован (вместо него выполняется дочерний поток)Задайте его длительность или добавьте длительности его дочерним элементам
Шаг как будто исчезаетЕго убрали с диаграммы, но оставили в моделиВведите его имя в Добавить или найти… и перетащите обратно на линию
“Создать диаграмму Asset” сообщает No Action here has a performer…Ни у одного Action нет Asset performed by, и ни у одной ветви нет исполнителяСначала назначьте исполнителей

Связь с другими функциями

  • Получает данные из: Функциональный анализ создаёт функции (дочерние Action) и их поток. Требования доходят до Action через satisfied by. Asset и Resource берутся из архитектуры.
  • Передаёт данные в Симулятор: время, стоимость, уровни ресурсов, загрузка Asset и проверки требований. См. Моделирование.
  • Передаёт данные в другие виды того же потока: FFBD и диаграмму деятельности.
  • Передаёт данные в производные виды:
    • диаграмму Timeline (график по Start и Duration);
    • диаграмму последовательности (линии жизни — выполняющие Asset, сообщения — I/O);
    • Создать диаграмму Asset (физический контекст и Conduit);
    • диаграмму N² (I/O между функциями);
    • IDEF0 (входы и выходы).
  • Прослеживаемость: раздел Трассировка инспектора показывает требования каждого Action (satisfies). RVTM и Матрица прослеживаемости читают те же связи.

Редактор

Диаграмма Action использует общий редактор диаграмм (см. Диаграммы). В ней есть строка панели инструментов, палитра слева, холст и инспектор справа.

  • Селектор Тип диаграммы: показывает тот же корневой Action в другом типе диаграммы, применимом к Action. Типы: Hierarchy, Spider, Tree, Risk, Timeline, Action, Sequence, Use Case, N2, IDEF0, ICOM (A0), Activity и FFBD.
  • ▲ Родитель: открывает диаграмму Action родительского Action. Показывается, только когда у корня есть родительский Action.

Панель инструментов

Панель инструментов — одна строка групп. Команды добавления группы вставки (+ Action ▾, + Sync, + Или, + Цикл, + Выход, + Ветвь, + Вх./вых.) собраны в одном списке + Добавить ▾: они действуют относительно выбранного (после него, вокруг него, на его ветвях), а панель Добавить слева добавляет перетаскиванием или по Enter. В списке ↓ и ↑ перемещают между командами, а Esc закрывает его. Когда окно узкое, элементы переходят в ⋯ (Другие действия); + Добавить ▾ остаётся в строке, а в полном виде остаются только Декомпозировать и ▶ Моделировать ▾. Выбор фигуры открывает инспектор, не сдвигая кнопки панели инструментов.

ГруппаЭлемент управленияЧто он делает
РежимПанорамаПеретаскивайте фон, чтобы сдвигать вид (по умолчанию).
РежимВыделение рамкойНа диаграммах Action выделяет только аннотации. Элементы потока выбирайте Shift-щелчком.
Вставка+ Добавить ▾Открывает список команд добавления ниже (“Добавить у выбранного”).
Вставка+ Action ▾Новый Action… запрашивает имя (по умолчанию New Action). Существующий Action… выбирает Action, который не является корнем, одним из его предков и ещё не находится на этой диаграмме. Параллельные ветви (без сущности) добавляет параллельные ветви. Вставляет после выбранного, в конец выбранной ветви или в конец потока.
Вставка+ SyncДобавляет SYNC с двумя пустыми ветвями.
Вставка+ ИлиЗапрашивает Имя решения (вопрос) (по умолчанию Or Action), затем добавляет OR с ветвями Yes и No по 50%.
Вставка+ ЦиклЗапрашивает Имя цикла (условие повтора) (по умолчанию Loop Action). Если выбран элемент, оборачивает его в цикл (Поместить выбранный элемент внутрь LOOP). Иначе добавляет пустой цикл (Добавить пустой LOOP). Новые циклы выполняют 2 итерации.
Вставка+ ВыходДобавляет EXIT после выбранного.
Вставка+ ВетвьДобавляет ветвь к выбранному Parallel, SYNC или OR (или к тому, чья ветвь выбрана). Вероятности OR заново делятся поровну. В остальных случаях недоступна.
Вставка+ Вх./вых.Когда выбран Action, выберите принимающий Action (Input/Output из “…” в…), затем назовите новый I/O. Первый Action генерирует его, а второй получает как триггер.
РедактированиеОтменить, Повторить⌘Z / Ctrl+Z, ⇧⌘Z / Ctrl+Shift+Z.
РедактированиеСоединить…Соединяет выбранную фигуру с другой с клавиатуры, с теми же вариантами, что и при перетаскивании её маркера (см. Клавиатура и программы чтения с экрана).
Редактирование◀, ▶Перемещает выбранный элемент на одну позицию влево или вправо в его последовательности.
РедактированиеУбратьУбирает выбранное с диаграммы; Shift+щелчок удаляет сущности (см. Удаление и уборка).
Представление−, масштаб в %, +, ⤢Уменьшить, ввести масштаб (10–400%), увеличить, вписать диаграмму.
ПредставлениеПоиск по диаграмме с ‹ ›Выделяет Action, I/O и Resource, имя, номер, описание, id или значения атрибутов которых совпадают. ↓ / ↑ (или ‹ ›) перемещают между совпадениями; Enter выбирает текущее.
ПредставлениеСодержаниеСодержимое диаграммы: фигуры, соединения и связи в виде текста.
ПредставлениеНастроитьПоказывает корень и тип диаграммы в инспекторе, чтобы сменить любой из них на месте (см. Настройка: корень и тип).
ПредставлениеУпорядочить ▾См. Упорядочить ▾ ниже.
ПредставлениеЗначок Проверки диаграммыСироты и циклы плюс проверки диаграммы Action (см. Сообщения), перечисленные в инспекторе с Показать.
ПредставлениеВх./вых., Resource, Активы, Вх./вых. родителяПоказать или скрыть Input/Output, Resource, выполняющие Asset и Input/Output родителя. Выбор сохраняется вместе с диаграммой и становится значением по умолчанию для новых диаграмм Action.
Действия типаДекомпозировать / Декомпозировать (группа)Выбран один Action: открыть его дочернюю диаграмму Action. Несколько элементов: сгруппировать их в новый дочерний Action.
Действия типаСвести в один уровеньЗаменить выбранный декомпозированный Action его дочерним потоком.
Действия типаОткрытиеОткрывает вид элемента выбранной сущности или корня.
Действия типа▶ Моделировать ▾Дискретно-событийная или Монте-Карло: открывает Симулятор с этим корнем.
ВыходЭкспорт…Диаграмма (PNG) с прозрачным фоном и масштабом, Диаграмма (SVG), Диаграмма (HTML), Диаграмма (Word), Диаграмма (печать).
Ещё⋯Не поместившиеся элементы, затем Открыть представление элемента, Все диаграммы, Справка по диаграмме Action и Удалить диаграмму….

Упорядочить ▾

ПредметЧто он делает
Восстановить значения по умолчаниюСбрасывает вручную заданные положения I/O и Resource.
Показать / скрытьСкрыть Resource, Скрыть все Input/Output, Скрыть Input/Output родителя, Скрыть выполняющие Asset и Скрыть палитру; пока соответствующая часть скрыта, пункт называется Показать … (например, Показать выполняющие Asset).
Сбросить положения Input/Output и ResourceВозвращает каждый перемещённый I/O и Resource в автоматическую компоновку.
Создать диаграмму AssetСоздаёт “root performers”, см. Создать диаграмму Asset.
Открыть как FFBDОткрывает тот же поток как функциональную потоковую блок-схему.
Настройки диаграммыКорень в инспекторе с Перенумеровать дочерние… (старые → новые номера; порядок дочерних элементов — по структуре или по потоку — задаётся в Параметры проекта → Нумерация; одно нажатие “Отменить” возвращает всё назад).
Скрыть панель «Добавить» / Показать панель «Добавить»Скрывает левую боковую панель (палитру и аннотации) во всех диаграммах.

Создать диаграмму Asset

Упорядочить ▾ → Создать диаграмму Asset строит физический контекст потока по его исполнителям.

  • Создаётся Asset “root performers”. Этот Asset выполняет корневой Action.
  • Новый Asset декомпозируется на каждый выполняющий Asset (decomposed by). Исполнители берутся из performed by и исполнителей ветвей на всех уровнях ниже корня.
  • Для каждой пары Asset, Action которых обмениваются I/O, используется существующий или создаётся новый Conduit. Conduit называется “A to B” или “A / B”, если I/O идёт в обе стороны, и transfers эти I/O.
  • Затем открывается диаграмма Asset.

Палитра

Панель Добавить (подсказка Перетащите на линию или фигуру или нажмите Enter) перечисляет:

ПредметКуда броситьСоздаёт
ДействиеЛинияНовый Action “New Action”
ПараллельноЛинияПараллельные ветви (без сущности)
ИлиЛинияСущность OR Action с ветвями Yes/No
SyncЛинияСущность SYNC Action
ЦиклЛинияСущность LOOP Action (пустое тело, 2 итерации)
ВыходЛинияEXIT
Input/OutputAction или любое местоНовый I/O с именем “I/O”, который генерирует Action, если бросить его на Action
ResourceAction или любое местоНовый Resource с именем “Resource”, потребляемый (Amount 1), если бросить его на Action
ИсполнительЛиния ветви Parallel или SYNCЗапрашивает Asset (Исполнитель этой ветви), который затем выполняет ветвь

Введите имя в Добавить или найти…: Создать предлагает “name” как Action, Or, Sync, Loop, Input/Output или Resource, а В проекте перечисляет подходящие Action, Input/Output, Resource и Asset (до 60; кроме корня и сущностей конструкций). Перетащите строку на диаграмму или нажмите на ней Enter.

Под палитрой находится раздел Аннотации, общий для всех диаграмм. × в заголовке панели добавления скрывает её. Упорядочить ▾ → Показать палитру возвращает её.

Жесты на холсте

ЖестРезультат
Щелчок по фигуреВыбрать его; инспектор показывает его
Щелчок с ShiftДобавить элемент к выбору или убрать из него
Щелчок по линииВыбрать ветвь, к которой он относится (или снять выбор на основной линии)
Щелчок по фонуСнять выделение
Перетащить Action или конструкцию на линиюПереместить туда (со всем, что внутри)
Перетащить I/O или ResourceРазместить свободно
Перетащить зелёный маркерСоединить (см. Подключение Input/Output и Resource)
Двойной щелчок по ActionОткрыть его дочернюю диаграмму Action, если он декомпозирован, иначе его вид элемента
Двойной щелчок по I/O или ResourceОткрыть его вид элемента
Щелчок по значку декомпозицииОткрыть дочернюю диаграмму Action
Перетаскивание фонаПанорама
Прокрутка / ⌘ / Ctrl+прокруткаПанорамирование / масштабирование у указателя

Что показывает каждая фигура

  • Прямоугольник Action: номер (вверху), имя и одна строка ниже. Эта строка показывает длительность (например, 1 minute) или, когда включено Активы, выполняющие Asset.
  • { } фиолетового цвета внизу слева: у Action или конструкции есть скрипт моделирования.
  • Значок декомпозиции вверху справа: у Action есть собственный дочерний поток. Щёлкните значок, чтобы открыть его.
  • Метки ветвей OR: имя условия и его вероятность (Yes (75%)) или условие (Low [< 20], [else]).
  • Метки ветвей Parallel и SYNC: имя ветви и её исполнитель.
  • Текст цикла под обратной стрелкой: Continue (×4), Continue (50%), Continue while Battery Charge > 20, Continue (script) или Continue (ask). Exit отмечает выход.
  • Имя конструкции: показывается курсивом рядом с блоками OR, SYNC и LOOP.

Инспектор

Инспектор справа показывает выбранное. Что он показывает, зависит от того, что выбрано.

Action, Input/Output, Resource или Asset: общая панель сущности. В ней есть:

  • заголовок с классом, номером и именем и Открыть в ▾ (вид элемента и все остальные диаграммы этой сущности);
  • Определение: Номер, Имя и Описание;
  • Фигура: дополнительные действия из таблицы ниже и Положение и размер;
  • группы атрибутов (Рабочий процесс, График работ и так далее), затем Трассировка, Обсуждение и Подробности.

Связи, которыми управляет эта диаграмма, заблокированы в разделе “Трассировка”, чтобы диаграмма и модель оставались согласованными. Это consumed by, decomposed by, generated by, performed by, produced by, received by и seized by.

ВыборДополнительные действия
ДействиеДиаграмма Action, Изменить скрипт…, Свести в один уровень (если декомпозирован), Убрать и Удалить элемент…
Перемещённый Input/Output или ResourceСбросить положение
I/O родителя, декомпозированный на дочерние I/OПоказать Input/Output родителя показывает его дочерние элементы вместо него; Скрыть Input/Output родителя возвращает его
ЛюбоеУбрать и Удалить элемент…

Выбран OR (панель OR (Decision)):

  • Имя решения: имя сущности OR.
  • Тип решения: Вероятность, Количество ресурса, Скрипт или Нет (спросить во время прогона или случайно).
  • Resource (только для “Количество ресурса”): Resource, количество которого сравнивается.
  • Ветви: имя условия для каждой ветви. В зависимости от типа у каждой ветви также есть вероятность (0–100 %) или оператор (==, !=, >, <, >=, <=, else) и значение.
  • Строка итога: показывает Total 100% или предупреждение Вероятности ветвей в сумме дают N %. Измените их, чтобы сумма была 100 %.
  • Изменить скрипт…/Добавить скрипт… (тип “Скрипт”): onEnd() возвращает имя условия ветви, по которой нужно пойти.
  • Примечание для типа “Нет”: При решениях “Prompt” симулятор спрашивает, какой путь выбрать; в автоматическом режиме он выбирает ветвь случайно.
  • + Добавить ветвь, Открыть элемент.

Выбран SYNC:

  • Имя.
  • Ограничение по времени: Необязательно. По истечении этого времени SYNC завершается и останавливает ещё выполняющиеся ветви.
  • Примечание N ветвей выполняются одновременно; поток продолжается, когда все завершатся.
  • По одной строке на ветвь: имя ветви и + Asset. Когда Asset задан, строка показывает ⟂ имя Asset и ×, чтобы убрать его.
  • Изменить скрипт…/Добавить скрипт…, + Добавить ветвь, Открыть элемент.

Выбран Parallel: то же, что SYNC, без полей сущности.

Выбрана ветвь: Выбрана ветвь N — + Action добавляет в неё.

Выбран LOOP:

  • Имя (условие).
  • Повторять, пока: Итерации, Вероятность, Количество ресурса, Скрипт или Нет (спросить во время прогона или случайно).
  • В зависимости от условия: Число итераций (минимум 1), Вероятность продолжения (%) или Resource плюс продолжать, пока количество с оператором и значением.
  • Примечание для скрипта: Перед каждым проходом вызывается onEnd(); возврат true снова выполняет тело.
  • Примечание для “Нет”: При решениях “Prompt” симулятор спрашивает число итераций; в автоматическом режиме он случайно выполняет 0–2 прохода.
  • Изменить скрипт…/Добавить скрипт…, примечание EXIT в теле цикла досрочно останавливает цикл., Открыть элемент.

Выбран EXIT: При достижении останавливает охватывающий LOOP или этот поток.

Выбрано несколько элементов: Выбрано элементов: N, Длительность (N Action) (динамическое поле: изменение задаёт длительность каждому выбранному Action как один шаг отмены; остаётся пустым, если их длительности различаются), Декомпозировать (сгруппировать в новый дочерний Action) и Убрать.

Соответствие диаграммы LML

На диаграммуВ модели
Корень диаграммыРодительский Action
Прямоугольник ActionДочерний Action: родитель decomposed by дочерний
Блок OR, SYNC, LOOPДочерний Action с типом управления, decomposed by родителя
Порядок, ветви, циклыСтруктура потока, сохранённая с родителем (порядок выполнения дочерних элементов)
Линия от Action к I/OAction generates Input/Output
Линия от I/O к ActionAction receives Input/Output с атрибутом связи Trigger (Yes = триггер, No = необязательный)
Линия между Action и Resourceconsumes, produces или seizes, каждая с атрибутом Amount
⟂ AssetAsset performs Action (обратная — performed by). Атрибут связи Amount — число экземпляров этого Asset, которые занимает Action.
Длительность на прямоугольникеАтрибут Duration Action (число или распределение с единицей)
Дочерний потокСобственная диаграмма Action дочернего Action

Атрибуты классов на этой диаграмме:

  • Action: Start (дата и время), Duration (значение или распределение плюс Seconds, Minutes, Hours, Days, Weeks, Months или Years) и Percent Complete.
  • Resource: Units, Initial Amount, Minimum Amount и Maximum Amount.
  • Input/Output: Size, Units, Type и Value.

Скрипты моделирования

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

Чтобы изменить скрипт:

  1. Выберите Action, OR, SYNC или LOOP.
  2. Нажмите Изменить скрипт… (Action) или Изменить скрипт…/Добавить скрипт… (OR, SYNC, LOOP).
  3. Нажмите Add onStart(), Add prompt(), Add onEnd() или Add duration(), чтобы вставить пустую функцию-обработчик.
  4. Напишите код. Tab вставляет два пробела.
  5. Нажмите Сохранить. Пустой скрипт удаляет скрипт.

Обработчики:

  • onStart() выполняется, когда элемент начинается.
  • prompt(p) строит вопрос для пользователя: p.setTitle(), p.addEnumInput(title, name, choices, default), addTextInput, addNumberInput, addBooleanInput.
  • onEnd(response) выполняется в конце. OR возвращает имя ветви, по которой нужно пойти. LOOP возвращает true, чтобы снова выполнить тело.
  • duration() возвращает длительность Action, когда его Duration равна =script().

Скрипты могут вызывать:

  • Sim.getEntityByName(n), Sim.getAmount(name), Sim.setResourceByName(name, v);
  • Sim.getCurrentTime(), Sim.getCurrentCost();
  • print(x);
  • globals.put(k, v) / globals.get(k).

Переменные верхнего уровня сохраняются на время прогона. Math.random использует генератор прогона с начальным значением. Полный API, песочница и запрос доверия описаны в разделе Моделирование.

Удаление и уборка

Delete или Убрать сразу убирает выбранное с диаграммы и сохраняет сущности; примечание Убрано с диаграммы. предлагает Отменить и Удалить элемент…. ⇧Delete / Shift+Delete или Удалить элемент… сначала спрашивает, а затем удаляет и сущности. Любое из этих действий отменяется одним нажатием “Отменить” (см. Уборка и удаление).

Выбор“Убрать” убирает с диаграммы⇧Delete / Shift+Delete также удаляет
Action, OR, SYNC или LOOPэлемент и элементы внутри негосущность элемента
Parallel или EXITконструкцию и элементы внутри неёсущности внутри неё
Ветвьветвь и её элементы; последняя ветвь или тело цикла убирает всю конструкциюсущности на ветви
Несколько элементоввсе выбранные элементыих сущности
Input/Output, Resource или Assetего связи с показанными здесь Actionсущность
Исполнитель (× в инспекторе)Убрать исполнителя: “name” выполняет на этой ветви Action: N. Удалить и эти связи performed by?Сохранить связи, Удалить связи

Убрать также удаляет связь decomposed by Action с корнем, поэтому он больше не дочерний. Сущность и её другие связи остаются.

Сочетания клавиш

КлавишаДействие
Delete или BackspaceУбрать выделенное с диаграммы (сущности остаются)
⇧Delete / Shift+DeleteУдалить выбранные сущности из проекта после подтверждения
EscСнять выделение
Щелчок с ShiftДобавить в выделение или убрать из него
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+ZОтменить / повторить
Enter или Space на элементе палитрыВставить его (конструкции — в конец основного потока, I/O и Resource — в центр)
⌘ / Ctrl+прокруткаМасштаб
Enter в поле масштабаПрименить введённый масштаб
↓ / ↑ в поиске по диаграммеСледующее / предыдущее совпадение; Enter выбирает его, Esc очищает поиск

Параметры и настройки

  • Показать/скрыть (переключатели панели инструментов и Упорядочить ▾): Вх./вых., Resource, Активы, Вх./вых. родителя и палитра. Сохраняется для каждой диаграммы и запоминается в этом браузере как значение по умолчанию для новых диаграмм Action. По умолчанию: Вх./вых., Resource, Вх./вых. родителя и палитра включены; Активы выключены.
  • Положения I/O и Resource: сохраняются для каждой диаграммы. Сбрасываются через Сбросить положение или Сбросить положения Input/Output и Resource.
  • Масштаб и положение: сохраняются для каждой диаграммы. Диаграмма открывается вписанной, но не менее чем на 70%.
  • Отображение только для чтения: пользователи с ролью “Читатель” видят диаграмму без групп редактирования на панели инструментов, палитры, маркеров и панели выбора. Они могут панорамировать, масштабировать, искать и экспортировать.

Сообщения

СообщениеЗначение
Бросьте конструкцию на линию потока.Конструкции и Action можно вставлять только на стрелку.
Элемент нельзя поместить внутрь самого себя. Бросьте его снаружи.Вы бросили конструкцию внутрь её собственной ветви или попытались добавить корень или одного из его предков.
“name” уже есть на этой диаграмме.Этот Action уже есть в потоке.
Выберите Parallel, SYNC или OR, чтобы добавить ветвь+ Ветвь требует, чтобы был выбран один из них (или одна из его ветвей).
Сначала выберите Action, который производит Input/Output+ Вх./вых. требует выбранного Action.
Выберите Action для декомпозиции или выберите Shift-щелчком несколько, чтобы сгруппировать ихДекомпозировать требует Action (не конструкции).
Невозможно сгруппировать: элементы находятся на разных ветвях. Выберите элементы одной последовательности.Группируемые элементы должны принадлежать одной последовательности.
Невозможно сгруппировать: элементы не соседние. Выберите элементы, идущие друг за другом.Группируемые элементы должны идти подряд.
Сгруппировано в новый дочерний Action. Назовите его в инспекторе.“Декомпозировать (группа)” выполнено.
Выберите Action с дочерней диаграммой, чтобы свести её в один уровень“Свести в один уровень” требует Action с дочерним потоком.
Дочерняя диаграмма пуста. Добавьте в неё Action, прежде чем сводить.У дочернего Action нет дочерних элементов.
Невозможно свести: дочерний поток управления повреждён.Дочерний поток ссылается на удалённые сущности; откройте его, чтобы исправить.
Эту группу нельзя свести: один из её дочерних элементов уже есть на этом уровне.Сведение поместило бы Action дважды.
Число итераций должно быть не меньше 1. Введите целое число не меньше 1.Число итераций меньше 1 отклоняется.
Вероятности ветвей в сумме дают N %. Измените их, чтобы сумма была 100 %.Исправьте вероятности OR.
“name” теперь выполняет Action на этой ветви.Исполнитель задан.
Ни у одного Action здесь нет исполнителя. Свяжите Action с Asset (performed by) или бросьте исполнителя на ветвь.“Создать диаграмму Asset” нечего размещать.
Создан “name performers”: Asset — N, Conduit — M.“Создать диаграмму Asset” выполнено.
Перетащите сюда элемент или нажмите + ActionПоток пуст.
Этот Action удалён.Корень удалён.
✓ Проверки на значке проверок диаграммыПроверки ничего не нашли.
… не имеет связей ни с чем другим на этой диаграмме. … Соедините его или уберите.Замечание проверок диаграммы (Сироты и циклы) с причиной: Input/Output “name” не генерируется и не принимается ни одним Action на этой диаграмме., Resource “name” не потребляется, не производится и не захватывается ни одним Action на этой диаграмме. или У Action “name” нет Duration (моделируется как 0).
Декомпозиция образует цикл: … Удалите одну из этих связей decomposed by.Action является (косвенно) собственным дочерним элементом.
Только просмотр: попросите владельца предоставить доступ на редактирование.Ваша роль в этом проекте — “Читатель”.

Ограничения

  • Один поток на родительский Action.
  • Action может встречаться в данном потоке только один раз. Используйте LOOP, чтобы повторить его.
  • Добавить или найти… перечисляет первые 60 совпадений в проекте. Введите больше букв имени, чтобы сузить список.
  • Вероятности OR — целые проценты от 0 до 100.
  • Число итераций цикла — целое число не меньше 1.
  • При моделировании длительности никогда не отрицательны: отрицательное выбранное значение генерируется заново.
  • Выделение рамкой выделяет только аннотации. Для элементов потока используйте Shift-щелчок.