Holarch

Поведінка

Діаграми Action

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

Як цим користуватися →

На цій сторінці
  1. Огляд
  2. Поняття
    1. Потік
    2. Елементи навколо потоку
  3. Як користуватися
    1. Коли й навіщо
    2. Побудова потоку з нуля
    3. Побудова потоку перетягуванням із палітри
    4. З’єднання Input/Outputs і Resources
    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, і Симулятор виконує саме те, що вона показує.

Діаграма показує:

  • дочірні Actions у порядку виконання;
  • де потік розгалужується на паралельні шляхи чи альтернативи і де він зациклюється;
  • Input/Outputs (I/O), що передаються від одного Action до іншого;
  • Ресурси, які використовує кожен Action;
  • Активи, що виконують роботу.

Діаграма — це подання моделі, а не малюнок. Кожна фігура, яку ви додаєте, переміщуєте чи видаляєте, змінює сутності й зв’язки в проєкті. Кожна зміна відміняється одним натисканням “Відмінити”.

Той самий потік також керує функціональною блок-схемою потоку (FFBD), SysML Діаграмою діяльності і діаграмою часової шкали. Редагуйте потік у будь-якій із них, і решта підлаштуються.

Поняття

Потік

Потік іде від зеленої капсули Початок ліворуч до червоної капсули Кінець праворуч. Стрілки з’єднують елементи між ними. Кожен елемент — один із таких:

ЕлементФормаЩо означаєСутність
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, і подання на кшталт часової шкали їх пропускають.

Елементи навколо потоку

Елемент обмінуФормаЗв’язокЗначення
Input/OutputПаралелограм над потоком. Зелений, коли запускає Action, інакше сірий.Action generates I/O; Action receives I/OІнформація, дані або матеріал, що передаються між Actions
Батьківський Input/OutputПаралелограм із підписом parent input (ліворуч від початку) або parent output (праворуч від кінця)Кореневий Action receives або generates йогоІнтерфейс батьківського Action. Малюється пунктиром, поки його не використовує жоден дочірній Action.
ResourceФіолетовий шестикутник під потокомAction consumes, produces або seizes Resource з AmountКількість, яку Actions витрачають, повертають або створюють
Asset-виконавець⟂ і назва Asset під назвою ActionAsset performs ActionХто або що виконує Action. Показується, коли ввімкнено Активи.
Виконавець⟂ і назва Asset на гілці Parallel або SYNCAsset performs кожен Action на гілціВиконавець для цілої гілки. Узгоджується при кожному редагуванні.

Для симуляції важливі два терміни:

  • Тригер: отриманий I/O з увімкненим Тригер (типово) змушує Action-отримувач чекати, доки I/O з’явиться.
  • Необов’язково: отриманий I/O з вимкненим тригером. 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 із двома порожніми гілками.

  3. Клацніть лінію гілки, щоб вибрати її.
  4. Натисніть + Додати ▾ → + Action ▾ → Новий Action…, щоб додати крок у цю гілку.
  5. Натисніть + Гілка, якщо потрібна третя гілка.

Використовуйте + Додати ▾ → + Action ▾ → Паралельні гілки (без сутності) замість + Синхронізація, коли не потрібні тайм-аут, назва чи скрипт.

Додавання рішення:

  1. Виберіть крок перед рішенням.
  2. Натисніть + Або.
  3. Введіть запитання, наприклад Contact in view?.

    Ви бачите дві гілки, Так і Ні, по 50%.

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

Повторення кроку:

  1. Виберіть крок.
  2. Натисніть + Додати ▾ → + Цикл.
  3. Введіть назву циклу.

    Ви бачите крок, обгорнутий у цикл, що виконується двічі.

  4. Задайте кількість ітерацій або іншу умову в інспекторі.

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

  1. Виберіть Action.
  2. Заповніть Тривалість у групі Розклад інспектора.
  3. Щоб задати кільком Actions однакову тривалість, клацніть їх із Shift і задайте Тривалість (N Actions) в інспекторі.
  4. Натисніть значок перевірок діаграми на панелі інструментів (✓ Перевірки або ⚠ з числом).

    Інспектор перелічує Actions без тривалості та нез’єднані елементи.

Побудова потоку перетягуванням із палітри

Палітра ліворуч містить конструкції та типи елементів. Перетягуйте їх на полотно замість використання панелі інструментів.

  1. Перетягніть Action на будь-яку лінію потоку. Лінія скидання підсвічується, коли елемент над допустимим місцем.

    Ви бачите в цій точці “New Action”. Поле назви в інспекторі виділено й готове до введення.

  2. Введіть назву.
  3. Так само перетягніть Паралельно, Або, Синхронізація, Цикл або Вихід на лінію.
  4. Перетягніть Input/Output на Action. Це створює I/O, який генерує Action. Скиньте на порожнє полотно, щоб розмістити нез’єднаний I/O.
  5. Перетягніть Resource на Action. Це створює Resource, який споживає Action (Amount 1). Скиньте на порожнє полотно, щоб розмістити його нез’єднаним.
  6. Перетягніть Виконавець на лінію гілки Parallel або SYNC, потім виберіть Asset.

    Тепер Asset виконує кожен Action на цій гілці.

Щоб повторно використати елементи, що вже є в моделі:

  1. Введіть назву в Додати або знайти…. У проєкті перелічує відповідні Actions, Input/Outputs, Resources та Assets.
  2. Перетягніть збіг на діаграму:
    • Action — на лінію;
    • I/O або Resource — на Action чи полотно;
    • Asset — на лінію гілки Parallel або SYNC.

З клавіатури наведіть фокус на елемент палітри й натисніть Enter або Space. Конструкції додаються в кінець головного потоку. Input/Outputs і Resources — у центр подання.

З’єднання Input/Outputs і Resources

З’єднуйте елементи, перетягуючи маркер від однієї фігури до іншої.

Передавання 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, потім виберіть Вхід (тригер) або Вхід (необов’язково) у засобі вибору з’єднання.

Якщо Action уже отримує цей I/O, змінюється лише його параметр “Тригер”.

Як змусити Action використовувати Resource:

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

Перемикання між consumes і seizes зберігає кількість.

Задання кількості для зв’язку з ресурсом:

  1. Виберіть Action.
  2. У розділі Трасування інспектора знайдіть Resource під consumes, produces або seizes і натисніть Атрибути.
  3. Відредагуйте атрибут зв’язку Amount.

Розміщення I/O і Resources вручну:

  • Перетягніть фігуру Input/Output або Resource туди, куди потрібно. Положення зберігається з діаграмою.
  • Натисніть Скинути положення в її інспекторі, щоб повернути її до автоматичного компонування над або під Actions, що її використовують.
  • Виберіть Упорядкувати ▾ → Скинути положення 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. Перед першим запуском відкрийте значок перевірок діаграми і виправте те, що він перелічує.

    Ви бачите, що Симулятор вважатиме відсутнім:

    • Actions без тривалості симулюються як 0.
    • I/O, які не генерує жоден Action, змушують своїх отримувачів чекати (блокування).
    • Перелічуються Resources, які ніщо не використовує.
  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).

Потік використовує два Resources:

  • 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”. Його дочірні елементи — Assets-виконавці з Conduits для кожного I/O, що передається між двома з них. Відкривається його діаграма Asset.

Поради та добрі практики

  • Називайте Actions як дієслово + об’єкт (Capture Image Strip), а I/O — іменниками (Image Strip). Називайте умови OR як відповіді на запитання OR.
  • Обмежуйте кожну діаграму приблизно сімома–дванадцятьма елементами. Групуйте подробиці в дочірні Actions через Декомпозувати (групу).
  • Типово використовуйте 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, і жодна гілка не має виконавцяСпершу призначте виконавців

Як це пов’язано з іншими функціями

  • Отримує дані з: Функціонального аналізу, що створює функції (дочірні Actions) та їхній потік. Вимоги доходять до Actions через satisfied by. Assets і Resources беруться з архітектури.
  • Передає дані в Симулятор: час, вартість, рівні ресурсів, використання Asset і перевірки вимог. Див. Симуляція.
  • Передає дані в інші подання того самого потоку: FFBD і діаграму діяльності.
  • Передає дані в похідні подання:
    • діаграму часової шкали (розклад за Start і Duration);
    • діаграму послідовності (лінії життя — Assets-виконавці, повідомлення — I/O);
    • Згенерувати діаграму Asset (фізичний контекст і Conduits);
    • діаграму N² (I/O між функціями);
    • IDEF0 (входи й виходи).
  • Простежуваність: розділ Трасування інспектора показує вимоги кожного Action (satisfies). RVTM і матриця простежуваності читають ті самі зв’язки.

Редактор

Діаграма Action використовує спільний редактор діаграм (див. Діаграми). Вона має рядок панелі інструментів, палітру ліворуч, полотно й інспектор праворуч.

  • Засіб вибору Тип діаграми: показує той самий кореневий Action в іншому типі діаграми, що застосовний до Actions. Типи: Hierarchy, Spider, Tree, Risk, Timeline, Action, Sequence, Use Case, N2, IDEF0, ICOM (A0), Activity і FFBD.
  • ▲ Батьківський: відкриває діаграму Action батьківського Action. Показується лише тоді, коли корінь має батьківський Action.

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

Панель інструментів — один рядок груп. Команди додавання групи “Вставлення” (+ Action ▾, + Синхронізація, + Або, + Цикл, + Вихід, + Гілка, + I/O) зібрано в один список + Додати ▾: вони діють щодо виділення (після нього, навколо нього, на його гілках), тоді як панель Додати ліворуч додає перетягуванням або клавішею Enter. У списку ↓ і ↑ переміщують між командами, а Esc закриває його. Коли вікно вузьке, елементи переходять у ⋯ (Інші дії); + Додати ▾ залишається в рядку, і лише Декомпозувати та ▶ Симулювати ▾ зберігають повні підписи. Вибір фігури відкриває інспектор, не зсуваючи кнопок панелі інструментів.

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

Упорядкувати ▾

Елемент обмінуЩо він робить
Відновити типовіОчищає задані вручну положення I/O і Resource.
Показати / приховатиПриховати ресурси, Приховати всі Input/Output, Приховати батьківські Input/Output, Приховати Assets-виконавців і Приховати палітру; поки частину приховано, пункт має вигляд Показати … (наприклад, Показати Assets-виконавців).
Скинути положення Input/Output і ResourceПовертає кожен переміщений I/O і Resource до автоматичного компонування.
Згенерувати діаграму AssetСтворює “root performers”, див. Згенерувати діаграму Asset.
Відкрити як FFBDВідкриває той самий потік як функціональну блок-схему потоку.
Налаштування діаграмиКорінь в інспекторі з Перенумерувати дочірні… (старі → нові номери; порядок дочірніх елементів — за структурою чи потоком — береться з Параметри проєкту → Нумерація; одне натискання “Відмінити” повертає все назад).
Приховати панель додавання / Показати панель додаванняПриховує ліву бічну панель (палітру та анотації) на всіх діаграмах.

Згенерувати діаграму Asset

Упорядкувати ▾ → Згенерувати діаграму Asset будує фізичний контекст потоку з його виконавців.

  • Створюється Asset “root performers”. Цей Asset виконує кореневий Action.
  • Новий Asset decomposed by кожним Asset-виконавцем. Виконавці беруться з performed by і виконавців гілок на всіх рівнях під коренем.
  • Для кожної пари Assets, чиї Actions обмінюються I/O, повторно використовується або створюється Conduit. Conduit має назву “A to B” або “A / B”, коли I/O іде в обидва боки, і він transfers ці I/O.
  • Потім відкривається діаграма Asset.

Палітра

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

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

Введіть назву в Додати або знайти…: Створити пропонує “назва” як Action, Or, Sync, Loop, Input/Output або Resource, а У проєкті перелічує відповідні Actions, Input/Outputs, Resources і Assets (до 60; без кореня та сутностей конструкцій). Перетягніть рядок або натисніть на ньому Enter.

Під палітрою розташовано розділ Анотації, спільний для всіх діаграм. × у заголовку панелі “Додати” приховує її. Упорядкувати ▾ → Показати палітру повертає її.

Жести на полотні

ЖестРезультат
Клацнути фігуруВибрати; інспектор показує вибране
Клацання з ShiftДодати елемент до виділення або вилучити з нього
Клацання лініїВибрати гілку, до якої він належить (або очистити виділення на головній лінії)
Клацнути фонОчистити виділення
Перетягнути Action або конструкцію на лініюПеремістити туди (з усім, що всередині)
Перетягнути I/O або ResourceРозмістити довільно
Перетягнути зелений маркерЗ’єднати (див. З’єднання Input/Outputs і Resources)
Подвійне клацання ActionВідкрити його дочірню діаграму Action, якщо його декомпозовано, інакше — його подання елемента
Подвійне клацання I/O або ResourceВідкрити його подання елемента
Клацання значка декомпозиціїВідкрити дочірню діаграму Action
Перетягнути фонПанорамування
Прокручування / ⌘ / Ctrl+прокручуванняПанорамування / масштабування біля вказівника

Що показує кожна фігура

  • Прямокутник Action: номер (угорі), назва й один рядок нижче. Цей рядок показує тривалість (наприклад, 1 minute) або Assets-виконавців, коли ввімкнено Активи.
  • { } фіолетового кольору внизу ліворуч: 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: спільна панель сутності. Вона має:

  • заголовок із класом, номером і назвою та Відкрити в ▾ (подання елемента та кожна інша діаграма цієї сутності);
  • Визначення: Number, Name і Description;
  • Фігура: додаткові дії з таблиці нижче та Положення й розмір;
  • групи атрибутів (Робочий процес, Розклад тощо), потім Трасування, Обговорення і Подробиці.

Зв’язки, якими керує ця діаграма, заблоковано в розділі “Трасування”, щоб діаграма й модель залишалися узгодженими. Це 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 (рішення)):

  • Назва рішення: назва сутності 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 Actions) (живе поле: зміна задає тривалість кожному вибраному 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 з атрибутом зв’язку Тригер (Yes = тригер, No = необов’язково)
Лінія між Action і Resourceconsumes, produces або seizes, кожен з атрибутом Amount
⟂ AssetAsset performs Action (обернений performed by). Атрибут зв’язку Amount — кількість одиниць цього Asset, яку займає Action.
Тривалість на прямокутникуАтрибут Action Тривалість (число або розподіл з одиницею)
Дочірній потікВласна діаграма Action дочірнього Action

Атрибути класів на цій діаграмі:

  • Action: Start (дата й час), Тривалість (значення або розподіл плюс Seconds, Minutes, Hours, Days, Weeks, Months або Years) і Percent Complete.
  • Resource: Одиниці, Initial Amount, Minimum Amount і Maximum Amount.
  • Input/Output: Розмір, Одиниці, Тип і Значення.

Скрипти симуляції

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

Щоб відредагувати скрипт:

  1. Виберіть Action, OR, SYNC або LOOP.
  2. Натисніть Редагувати скрипт… (Action) або Редагувати скрипт…/Додати скрипт… (OR, SYNC, LOOP).
  3. Натисніть Додати onStart(), Додати prompt(), Додати onEnd() або Додати 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, коли його Тривалість дорівнює =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його зв’язки з показаними тут Actionsсутність
Виконавець (× в інспекторі)Вилучити виконавця: “name” виконує N Action(s) на цій гілці. Вилучити й ці зв’язки performed by?Зберегти зв’язки, Вилучити зв’язки

Вилучити також вилучає зв’язок Action decomposed by з коренем, тож він більше не дочірній. Сутність і її інші зв’язки залишаються.

Комбінації клавіш

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

Параметри й налаштування

  • Показ/приховування (перемикачі панелі інструментів і Упорядкувати ▾): I/O, ресурси, активи, батьківські I/O і палітра. Зберігається для кожної діаграми й запам’ятовується в цьому браузері як типове для нових діаграм Action. Типово: I/O, ресурси, батьківські I/O і палітру ввімкнено; активи вимкнено.
  • Положення I/O і Resource: зберігаються для кожної діаграми. Скиньте їх через Скинути положення або Скинути положення Input/Output і Resource.
  • Масштаб і положення: зберігаються для кожної діаграми. Діаграма відкривається вписаною, але не менше ніж на 70%.
  • Показ лише для читання: користувачі з роллю читача бачать діаграму без груп редагування на панелі інструментів, палітри, маркерів і панелі виділення. Вони можуть панорамувати, масштабувати, шукати й експортувати.

Повідомлення

ПовідомленняЗначення
Скиньте конструкцію на лінію потоку.Конструкції та Actions можна вставляти лише на стрілку.
Елемент не може опинитися всередині самого себе. Скиньте його назовні.Ви скинули конструкцію в її власну гілку або спробували додати корінь чи одного з його предків.
“name” уже є на цій діаграмі.Цей Action уже є в потоці.
Виберіть Parallel, SYNC або OR, щоб додати гілку+ Гілка потребує, щоб було вибрано одну з цих конструкцій (або одну з її гілок).
Спершу виберіть Action, що створює Input/Output+ I/O потребує вибраного Action.
Виберіть Action для декомпозиції або клацніть із Shift кілька, щоб згрупувати їхДекомпозувати потребує Action (не конструкції).
Не вдається згрупувати: елементи на різних гілках. Виберіть елементи в одній послідовності.Згруповані елементи мають бути в одній послідовності.
Не вдається згрупувати: елементи не сусідні. Виберіть елементи, що йдуть один за одним.Згруповані елементи мають іти поспіль.
Згруповано в новий дочірній Action. Назвіть його в інспекторі.Декомпозувати (групу) виконано успішно.
Виберіть Action із дочірньою діаграмою, щоб звести її в один рівеньЗведення потребує Action із дочірнім потоком.
Дочірня діаграма порожня. Додайте до неї Actions перед зведенням.Дочірній Action не має дочірніх елементів.
Не вдається звести: дочірній потік керування пошкоджено.Дочірній потік посилається на видалені сутності; відкрийте його, щоб виправити.
Цю групу не можна звести: один із її дочірніх елементів уже є на цьому рівні.Зведення розмістило б Action двічі.
Кількість ітерацій має бути 1 або більше. Введіть ціле число, не менше за 1.Кількість ітерацій менше 1 не приймається.
Ймовірності гілок у сумі дають N %. Змініть їх, щоб у сумі було 100 %.Виправте ймовірності OR.
“name” тепер виконує Actions на цій гілці.Виконавця задано.
Жоден Action тут не має виконавця. Пов’яжіть Actions з Assets (performed by) або скиньте виконавця на гілку.Згенерувати діаграму Asset не має що розмістити.
Створено “name performers” з N Asset(s) і M Conduit(s).Згенерувати діаграму Asset виконано успішно.
Перетягніть сюди елемент або натисніть + ActionПотік порожній.
Цей Action видалено.Корінь видалено.
✓ Перевірки на значку перевірок діаграмиПеревірки нічого не знайшли.
… не має зв’язку ні з чим іншим на цій діаграмі. … З’єднайте або вилучіть його.Зауваження перевірок діаграми (Сироти та цикли) з причиною: Input/Output “name” не генерує й не отримує жоден Action на цій діаграмі., Resource “name” не споживає, не створює й не захоплює жоден Action на цій діаграмі. або Action “name” не має тривалості (симулюється як 0).
Декомпозиція утворює цикл: … Вилучіть один із цих зв’язків decomposed by.Action є (опосередковано) власним дочірнім елементом.
Лише перегляд: попросіть власника надати доступ на редагування.Ваша роль у цьому проєкті — читач.

Обмеження

  • Один потік на батьківський Action.
  • Action може з’являтися в потоці лише один раз. Щоб повторити його, використовуйте LOOP.
  • Додати або знайти… перелічує перші 60 збігів у проєкті. Введіть більше символів назви, щоб звузити список.
  • Ймовірності OR — цілі відсотки від 0 до 100.
  • Кількість ітерацій циклу — ціле число, не менше за 1.
  • У симуляції тривалості ніколи не бувають від’ємними: від’ємне вибране значення вибирається повторно.
  • Вибір рамкою вибирає лише анотації. Для елементів потоку використовуйте клацання із Shift.