SysML v2
Метадані симуляції в проєктах SysML v2
Бібліотека метаданих HolarchSimulation: як модель SysML v2 містить тривалості, ймовірності гілок, кількості повторень циклів, ресурси, витрати та налаштування скінченних автоматів для Симулятора, і як їх записувати та переносити.
Огляд
У проєкті 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, з’являються в рецензуваннях тексту й версіонуються разом з рештою моделі. Використовуйте їх, коли аналізуєте операційний сценарій (часові шкали, частки гілок, використання ресурсів), і перед тим, як перевіряти вимогу за дослідженням Монте-Карло.
Задати тривалість, імовірність або кількість проходів циклу
- Виберіть крок, послідовність, рішення, цикл або дію
ifу Поданні Action Flow, Оглядачі чи Редакторі. - У розділі Симуляція інспектора задайте Тривалість (фіксоване значення або розподіл), Імовірність (%), Ітерації або Імовірність then (%).
- Holarch записує анотацію в модель: Тривалість задає значення атрибута як середнє й додає анотацію розподілу (або записує
attribute duration : ISQ::DurationValue, коли крок його не має); Імовірність (%) записує Probability; Ітерації записує LoopCount. Кожна зміна відміняється одним натисканням “Відмінити” й одразу з’являється в тексті. - Очистьте поле, щоб вилучити його анотацію.
Holarch перевіряє кожну зміну перевіркою SysML перед записом. Зміна, яка додала б помилку, не записується, а повідомлення називає проблему.
Писати анотації в тексті
- Відкрийте Редактор.
- Додайте анотацію в тіло елемента як
@HolarchSimulation::Kind { field = value; }або після нього якmetadata HolarchSimulation::Kind about element { … }. - Для Consumes, Produces і Seizes спершу назвіть крок, а потім ресурс:
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.
Перенести старіші налаштування в модель
Проєкти, налаштування симуляції яких створено до перенесення в модель, показують Деякі налаштування симуляції цього проєкту є даними Holarch, а не частиною моделі. над налаштуваннями Симулятора.
- Натисніть Перенести налаштування симуляції в модель….
- Попередній перегляд перелічує кожне налаштування й анотацію, яка його замінює.
- Натисніть Перенести в модель. Усі налаштування переносяться, і одне натискання “Відмінити” повертає все назад; прогони дають ті самі результати.
Симулювати машину станів
Машини станів виконуються з рушієм SysML.
- Відкрийте Поведінка → Симулятор і виберіть визначення стану або частину, яка проявляє стани, як Корінь.
- Необов’язково: у полі Запускати разом із виберіть дію-сценарій, яка надсилає сигнали частині, як-от TestDrive з демопроєкту.
- У розділі Стимули натисніть + Додати стимул і задайте Час (час і одиницю), Сигнал і До (машину або Кожна машина, що його приймає).
- Натисніть ▶ Відтворити, ⏭ Крок або ⏩ Виконати до кінця. Машина станів під час виконання підсвічує активні стани й позначає перехід, що спрацював; вкладка Стани показує Стани в часі і Переходи, що спрацювали.
- У режимі Монте-Карло вкладка Стани показує Час у стані і Кількість переходів. Перевірити на відповідність 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;
driveConsumes 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 %."
- Анотація тривалості на самому кроці: розподіли належать атрибуту тривалості, а не дії.
Як це пов’язано з іншим
- Оцінювання, одиниці та аналіз у проєктах SysML v2: як Симулятор читає кроки, послідовності й тривалості.
- Симуляція: сторінка Симулятора, її панелі та статистика Монте-Карло.
- Текстова нотація SysML v2: метадані й
aboutу тексті.
Анотації
Розподіли
Задавайте розподіл на атрибуті тривалості. Поля положення й масштабу приймають величину з одиницею (45 [s], 2 [min]); поля форми приймають число.
| Анотація | Поля | Значення |
|---|---|---|
| Нормальний | mean, sd | Нормальний розподіл. |
| Трикутний | low, mode, high | Трикутний, з low ≤ mode ≤ high. |
| Рівномірний | low, high | Рівномірний між low і high. |
| Exponential | mean | Експоненційний із заданим середнім. |
| Gamma | shape, scale | Гамма; середнє — shape × scale. |
| LogNormal | median, sigma | Логарифм розподілено нормально навколо логарифма медіани. |
| Weibull | scale, shape | Вейбулла. |
| Beta | alpha, beta, scale | Бета на 0..1, помножений на scale. |
| Poisson | mean, scale | Кількість із заданим середнім, помножена на scale. |
| Binomial | trials, p, scale | Кількість успіхів у певній кількості випробувань, помножена на scale. |
Тривалості, вибрані меншими за нуль, вибираються знову.
Корельовані вхідні дані
Без кореляції кожне значення, вибране з розподілу, не залежить від інших. Correlation змушує два з них змінюватися разом:
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| Анотація | На чому | Значення |
|---|---|---|
Correlation coefficient | about 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 amount | about step, pool | Береться, коли крок починається. |
Produces amount | about step, pool | Додається, коли крок завершується. |
Seizes amount | about 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. у США та інших країнах.