Holarch

SysML v2

Метадані симуляції в проєктах SysML v2

Бібліотека метаданих HolarchSimulation: як модель SysML v2 містить тривалості, ймовірності гілок, кількості повторень циклів, ресурси, витрати та налаштування скінченних автоматів для Симулятора, і як їх записувати та переносити.

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

На цій сторінці
  1. Огляд
  2. Поняття
    1. Номінальне значення й розподіл
    2. Які налаштування мають перевагу
    3. Два симулятори
  3. Як користуватися
    1. Коли й навіщо
    2. Задати тривалість, імовірність або кількість проходів циклу
    3. Писати анотації в тексті
    4. Перенести старіші налаштування в модель
    5. Симулювати машину станів
    6. Приклад: демопроєкт Hybrid Car
    7. Поради та добрі практики
    8. Типові помилки
    9. Як це пов’язано з іншим
  4. Анотації
    1. Розподіли
    2. Корельовані вхідні дані
    3. Імовірності й кількості
    4. Ресурси й витрати
    5. Анотації, які потребують рушія SysML
  5. Повідомлення
  6. Обмеження
  7. Пов’язане

Огляд

У проєкті SysML v2 налаштування Симулятора є частиною моделі. Це анотації метаданих із бібліотечного пакета HolarchSimulation, який завантажує кожен проєкт SysML v2. Модель, яка їх використовує, залишається коректною SysML v2: інші інструменти читають анотації як звичайні метадані, і лише Симулятор надає їм значення.

Анотація або розташована всередині елемента, який вона анотує, або називає цей елемент через about:

succession toCruise first shift if speed > 30 then cruise {
  @HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }

Поняття

Номінальне значення й розподіл

Тривалість кроку — це його атрибут duration (або атрибут з типом DurationValue чи TimeValue). Його значення — номінальна тривалість, яку бачать інші інструменти та обчислення Holarch. Анотація розподілу на цьому атрибуті змушує Симулятор натомість вибирати тривалість випадково:

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

Які налаштування мають перевагу

  • Анотація розподілу має перевагу над власним значенням атрибута.
  • Умова, умова if або умова циклу, яку модель може обчислити, вирішує сама. Probability або LoopCount використовується лише тоді, коли не може (LoopCount завжди рахує проходи).
  • Налаштування, зроблені до того, як налаштування симуляції перенесли в модель, зберігаються як дані Holarch поруч із моделлю. Вони все ще мають перевагу, тож прогони дають ті самі результати, доки ви їх не перенесете (див. Перенести старіші налаштування в модель).

Два симулятори

Сторінка Симулятора показує, який симулятор виконує модель, праворуч від налаштувань: Рушій SysML (симулятор Holarch Language Engine) або Симулятор JavaScript. Обидва читають ті самі анотації. Машини станів, стимули, ресурси з Resource, Consumes, Produces і Seizes, витрати з Cost та інші анотації з розділу Анотації, які потребують рушія SysML виконуються лише з рушієм SysML.

Як користуватися

Коли й навіщо

Записуйте налаштування симуляції в модель, коли модель є записом проєкту: числа переміщуються разом із файлами .sysml, з’являються в рецензуваннях тексту й версіонуються разом з рештою моделі. Використовуйте їх, коли аналізуєте операційний сценарій (часові шкали, частки гілок, використання ресурсів), і перед тим, як перевіряти вимогу за дослідженням Монте-Карло.

Задати тривалість, імовірність або кількість проходів циклу

  1. Виберіть крок, послідовність, рішення, цикл або дію if у Поданні Action Flow, Оглядачі чи Редакторі.
  2. У розділі Симуляція інспектора задайте Тривалість (фіксоване значення або розподіл), Імовірність (%), Ітерації або Імовірність then (%).
  3. Holarch записує анотацію в модель: Тривалість задає значення атрибута як середнє й додає анотацію розподілу (або записує attribute duration : ISQ::DurationValue, коли крок його не має); Імовірність (%) записує Probability; Ітерації записує LoopCount. Кожна зміна відміняється одним натисканням “Відмінити” й одразу з’являється в тексті.
  4. Очистьте поле, щоб вилучити його анотацію.

Holarch перевіряє кожну зміну перевіркою SysML перед записом. Зміна, яка додала б помилку, не записується, а повідомлення називає проблему.

Писати анотації в тексті

  1. Відкрийте Редактор.
  2. Додайте анотацію в тіло елемента як @HolarchSimulation::Kind { field = value; } або після нього як metadata HolarchSimulation::Kind about element { … }.
  3. Для Consumes, Produces і Seizes спершу назвіть крок, а потім ресурс: metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.

Перенести старіші налаштування в модель

Проєкти, налаштування симуляції яких створено до перенесення в модель, показують Деякі налаштування симуляції цього проєкту є даними Holarch, а не частиною моделі. над налаштуваннями Симулятора.

  1. Натисніть Перенести налаштування симуляції в модель….
  2. Попередній перегляд перелічує кожне налаштування й анотацію, яка його замінює.
  3. Натисніть Перенести в модель. Усі налаштування переносяться, і одне натискання “Відмінити” повертає все назад; прогони дають ті самі результати.

Симулювати машину станів

Машини станів виконуються з рушієм SysML.

  1. Відкрийте Поведінка → Симулятор і виберіть визначення стану або частину, яка проявляє стани, як Корінь.
  2. Необов’язково: у полі Запускати разом із виберіть дію-сценарій, яка надсилає сигнали частині, як-от TestDrive з демопроєкту.
  3. У розділі Стимули натисніть + Додати стимул і задайте Час (час і одиницю), Сигнал і До (машину або Кожна машина, що його приймає).
  4. Натисніть ▶ Відтворити, ⏭ Крок або ⏩ Виконати до кінця. Машина станів під час виконання підсвічує активні стани й позначає перехід, що спрацював; вкладка Стани показує Стани в часі і Переходи, що спрацювали.
  5. У режимі Монте-Карло вкладка Стани показує Час у стані і Кількість переходів. Перевірити на відповідність Requirement… пропонує як виходи час у стані й частку прогону для кожного стану.

У Поданні переходів станів ▶ Симулювати відкриває панель із ▶ Відтворити, ⏭ Крок, ⏩ Виконати до кінця, Скинути і Відкрити в симуляторі. Прогін використовує стимули, збережені в Симуляторі для цього визначення стану.

Приклад: демопроєкт Hybrid Car

Демопроєкт Hybrid Car (Керування проєктами → Файли проєктів ▾ → Новий демопроєкт) використовує бібліотеку:

  • DriveCycle: послідовність toCruise після shift має Probability 70; гілка else бере решту 30 %. cruise номінально триває 1 min, а значення вибирається з розподілу Triangular (45 s, 1 min, 2 min).
  • DrivenCar: батарея силової установки — це Resource на 62 Wh; drive Consumes 1.5 Wh з неї й має Cost 0.4 USD за використання.
  • PowertrainStates: перехід startElectric має Probability 80 для своєї умови; accept when charge < 15 перемикає на гібридний режим, коли заряд падає; accept after 30 [min] завершує заряджання.
  • TestDrive: сценарій, який надсилає StartRequest, чекає годину, потім надсилає StopRequest і PlugIn до demoCar. Запустіть Demo Car разом із Test Drive, щоб побачити, як силова установка змінює стани.

Демопроєкт перевіряється з 0 діагностик.

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

  • Тримайте номінальне значення змістовним: задавайте його рівним очікуваному значенню розподілу, як це робить інспектор.
  • Називайте послідовності, які ви анотуєте (succession toCruise first …), щоб анотацію було легко знайти в тексті.
  • Надавайте перевагу умовам, які модель може обчислити, а не імовірностям; використовуйте Probability для того, чого модель не описує.

Типові помилки

  • Імовірність не діє: умову можна обчислити, тож вона вирішує. Інспектор показує "Обчислюється як true: завжди виконується." або "Обчислюється як false: ніколи не виконується."
  • Імовірності гілок у сумі не дають 100 %: гілки без Probability ділять залишок; коли задані перевищують 100 %, попередження повідомляє "Імовірності гілок у сумі дають N %. Змініть їх, щоб сума становила 100 %."
  • Анотація тривалості на самому кроці: розподіли належать атрибуту тривалості, а не дії.

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

Анотації

Розподіли

Задавайте розподіл на атрибуті тривалості. Поля положення й масштабу приймають величину з одиницею (45 [s], 2 [min]); поля форми приймають число.

АнотаціяПоляЗначення
Нормальнийmean, sdНормальний розподіл.
Трикутнийlow, mode, highТрикутний, з low ≤ mode ≤ high.
Рівномірнийlow, highРівномірний між low і high.
ExponentialmeanЕкспоненційний із заданим середнім.
Gammashape, scaleГамма; середнє — shape × scale.
LogNormalmedian, sigmaЛогарифм розподілено нормально навколо логарифма медіани.
Weibullscale, shapeВейбулла.
Betaalpha, beta, scaleБета на 0..1, помножений на scale.
Poissonmean, scaleКількість із заданим середнім, помножена на scale.
Binomialtrials, p, scaleКількість успіхів у певній кількості випробувань, помножена на scale.

Тривалості, вибрані меншими за нуль, вибираються знову.

Корельовані вхідні дані

Без кореляції кожне значення, вибране з розподілу, не залежить від інших. Correlation змушує два з них змінюватися разом:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
АнотаціяНа чомуЗначення
Correlation coefficientabout a, b: два атрибути, кожен із розподіломРангова (Спірмена) кореляція їхніх значень, від -1 до 1. 0 — незалежні, 1 — завжди однаковий ранг, -1 — протилежний.
  • Кожен атрибут зберігає власний розподіл. Симулятор об’єднує всі пари в одну кореляційну матрицю (гаусова копула): n-те значення, вибране для атрибута в прогоні, іде разом з n-м значенням кожного атрибута, з яким він корельований.
  • Коефіцієнти групи корельованих атрибутів мають узгоджуватися: a сильно з b, b сильно з c, але a протилежно до c — неможливо. Перевірка повідомляє про таку групу; послабте один із коефіцієнтів.
  • Тривалості й кількості (Consumes, Produces, Seizes) корелюються однаково. Прогін з тим самим зерном дає ті самі значення.
  • У Симуляторі в режимі Монте-Карло з рушієм SysML Корельовані вхідні дані перелічує пари кореня. Виберіть два атрибути й коефіцієнт і натисніть + Додати кореляцію, змініть коефіцієнт або натисніть ×, щоб вилучити кореляцію; кожну зміну повертає назад одне натискання “Відмінити”. Після дослідження Досягнуто показує рангову кореляцію значень, які вибрали прогони.
  • ChargeStop демопроєкту Hybrid Car корелює очікування вільного зарядного пристрою з часом заряджання (0.6).

Імовірності й кількості

АнотаціяНа чомуЗначення
Probability percentПослідовність, що виходить із рішенняВага гілки. Гілки без ваги ділять те, що залишилося від 100.
Дія ifІмовірність гілки then, коли умову не вдається обчислити.
Дія циклуІмовірність повторення після кожного проходу.
ПерехідІмовірність того, що його умова виконується, коли умову не вдається обчислити.
LoopCount countДія циклуКількість проходів; має перевагу над умовами циклу.
LoopExitПослідовність до done у тілі циклуЗавершує весь цикл, а не лише прохід.

Ресурси й витрати

АнотаціяНа чомуЗначення
Resource initial, minimum, maximum, unitВикористання частини або предметаЗапас певної кількості. Якщо використання оголошує attribute level : Real, симулятор підтримує його рівним кількості, тож умови можуть його читати.
Consumes amountabout step, poolБереться, коли крок починається.
Produces amountabout step, poolДодається, коли крок завершується.
Seizes amountabout step, poolБереться, коли крок починається, і повертається, коли він завершується.
Utilization amountВикористання дії performЯку частку частини-виконавця займає крок.
Cost amount, rate, unit, labelКрок або частина-виконавецьВартість за використання (CostRate::perUse) або за годину (CostRate::perHour).

Анотації, які потребують рушія SysML

АнотаціяЗначення
Transfer latency, capacity, perНа з’єднанні або інтерфейсі: затримує предмети й сигнали, надіслані через нього.
Size sizeНа предметі: його розмір для затримок передавання.
Timeout limitНа об’єднанні: зупиняє незавершені гілки, коли спливає межа.
NotBefore timeНа кроці: він не починається раніше цього часу прогону.
ForkTargets, JoinSourcesНа переході в паралельний стан або з нього: підстани, у які входять, або підстани, які мають бути активними.
History deepНа складеному стані: повторний вхід відновлює підстан, активний на момент виходу.
HostHook key, pointsЗарезервовано для Holarch: прогін робить паузу для введення в перелічених точках.

Симулятор JavaScript читає Probability, LoopCount і розподіли.

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

ПовідомленняЗначення
Деякі налаштування симуляції цього проєкту є даними Holarch, а не частиною моделі.Старіші налаштування досі зберігаються поруч із моделлю. Натисніть Перенести налаштування симуляції в модель….
Дані Holarch з часу до перенесення налаштувань симуляції в модель; вони мають перевагу над моделлю.Показується в розділі Симуляція інспектора. Змініть поле, щоб записати його в модель, або перенесіть усі налаштування в Симуляторі.
У моделі немає тривалості. Задайте її тут (це записує attribute duration : ISQ::DurationValue) або напишіть у тексті.Крок не має атрибута тривалості.
@Normal: sd must be greater than zero. Change sd. (і подібні для інших розподілів і параметрів)Параметр розподілу відсутній або поза діапазоном. З рушієм SysML перевірка моделі повідомляє про нього в Редакторі, а Симулятор відмовляється виконувати прогін, доки його не виправлено.
@Normal: sd has another unit dimension than …Параметр положення або масштабу має інші одиниці, ніж атрибут, наприклад метри для тривалості.
@LoopCount does not apply to a part …Анотація розташована на виді елемента, до якого вона не застосовується. Перемістіть або видаліть її.
metadata Consumes … about needs an action and a part or item annotated @Resource.Елементи після about неправильні за кількістю або видом.
A probability of N % is outside 0 to 100.Введіть відсоток від 0 до 100.
The branch probabilities of this decision add up to N %; the simulator scales them to 100 %.Попередження: кожна гілка має вагу, і в сумі вони не дають 100.
A correlation needs two different attributes …, … is not an attribute … або … has no distribution, so nothing is drawn to correlate …Correlation називає один атрибут двічі, щось, що не є атрибутом, або атрибут без розподілу.
The coefficient N is outside -1 to 1. або The correlation has no coefficient.Введіть коефіцієнт від -1 до 1.
“a” and “b” are already correlated; the first correlation is used. …Попередження: друга Correlation тієї самої пари ігнорується. Вилучіть одну з двох.
The correlations of … contradict each other: no joint distribution has them …Коефіцієнти групи не можуть бути узгоджені (матриця не є додатно напіввизначеною). Послабте один. Симулятор відмовляється виконувати прогін, доки це не виправлено.
Взаємне блокування в <time>: N кроків чекають на те, що ніколи не надійде.Показується над результатами з рушієм SysML разом із кожним кроком, що чекає. accept без відправника, предмет, який ніколи не виробляється, або ресурс, який ніколи не звільняється, зупиняє прогін.

Обмеження

  • Тривалості записуються в секундах, хвилинах, годинах або днях (SI::s, SI::min, SI::h, SI::d). Мілісекунди записуються як секунди; тижні, місяці й роки — як дні.
  • Машини станів, стимули й Запускати разом із потребують рушія SysML.
  • Корельовані вхідні дані потребують рушія SysML; симулятор JavaScript вибирає кожне значення незалежно. В одній групі можна корелювати щонайбільше 200 атрибутів.
  • Перевірка суперечливих коефіцієнтів охоплює кореляції, записані в одному просторі імен; Симулятор перевіряє всі кореляції прогону.

SysML® і OMG® — зареєстровані торговельні марки Object Management Group, Inc. у США та інших країнах.