SysML v2
Охоплення мови SysML v2
Проєкти SysML v2 у Holarch базуються на специфікації OMG SysML v2 і підтримують підмножину мови. Ця сторінка перелічує кожну область текстової нотації, наскільки Holarch її підтримує, і відомі прогалини.
Що означають рівні
- Підтримується: Редактор розбирає й перевіряє конструкцію, модель її зберігає, а подання й сторінки, що її використовують, читають і записують її.
- Частково: підтримується з обмеженнями, названими в рядку.
- Зберігається, не інтерпретується: розбирається й зберігається точно так, як написано, у тексті та в експортах, але не отримує власного значення.
- Ще ні: недоступно.
Той самий мовний рушій обслуговує Редактор, подання й перевірки, тож конструкція, яку приймає Редактор, однакова в кожному поданні. Див. також Holarch Language Engine.
Перейти до: Мовні конструкції · Файли та обмін · Перевірки · Відомі прогалини
Мовні конструкції
| Область | Рівень | Конструкції | Обмеження |
|---|---|---|---|
| Пакети й простори імен | Підтримується | package, вкладені пакети, library package, doc, comment … about, примітки // і //* */, alias … for …, public, private і protected, короткі імена <'1.2'>, імена в лапках. | Пакети бібліотек, зокрема стандартна бібліотека, доступні лише для читання. |
| Імпорти | Підтримується | Імпорти членства й простору імен, ::*, рекурсивний ::**, імпорти з видимістю, відфільтровані імпорти [@Kind]. | Фільтри імпорту вибирають за метакласом. |
| Визначення та використання | Підтримується | part, attribute, item, port, connection, interface, flow, action, state, requirement, constraint, calc, use case, analysis, verification, view, viewpoint, concern, enum, occurrence, allocation, metadata; ref, abstract, in, out, inout і end. | Невідомо. |
| Спеціалізація, типізація та перевизначення | Підтримується | Спеціалізація :> і specializes, типізація : і defined by, підмножина :> і subsets, перевизначення :>> і redefines, спряження ~, disjoint, ланцюжки ознак a.b.c. | Невідомо. |
| Кратності | Підтримується | [n], [n..m], [*], [0..*], ordered, nonunique, вирази як межі. | Невідомо. |
| Значення та одиниці | Підтримується | =, :=, default, величини на кшталт 5 [kg], вирази одиниць на кшталт [m/s^2], види величин ISQ та одиниці SI і звичаєві одиниці США зі стандартної бібліотеки, перевірки розмірностей. | Невідомо. |
| Обмеження та обчислення | Підтримується | Визначення й використання обмежень і обчислень, return, assert constraint, виклики, вирази KerML з арифметикою, порівнянням, логікою, if ? else та операціями над послідовностями, обчислення з одиницями. | Невідомо. |
| Структура | Підтримується | Порти та спряжені порти, connect, інтерфейси з кінцями, іменовані кінці з’єднань з кратностями (connect [1] driver ::> a to [1] driven ::> b), зв’язувальні з’єднувачі bind, потоки елементів flow of T from … to …, message. | Відомих немає. Напрямки портів, потоків і message перевіряються. Подання взаємозв’язків підписують іменовані кінці їхньою кратністю, а інспектор їх редагує. |
| Дії | Частково | Параметри, perform, послідовності first … then … і then, fork, join, decide, merge, умови, accept, send, assign, if, while, for, loop, start, done, terminate. | Симулятор виконує потоки дій, зокрема прогони Монте-Карло, з тривалостями, ймовірностями гілок і кількістю повторень циклів із моделі. |
| Стани | Частково | Дії entry, do і exit, переходи з тригером, умовою та ефектом (редагуються в поданні переходів станів та інспекторі й показуються під переходом у Браузері), стани parallel, вкладені стани, exhibit. | Симулятор виконує скінченні автомати рушієм SysML зі стимулами й підсвічує активні стани під час виконання. Перевіряється кожен вид ефекту do, корисне навантаження тригера перевіряється щодо його порту, а інші частини моделі можуть називати тригер і ефект переходу (plugIn.effect.sentMessage). |
| Вимоги | Підтримується | subject, actor, stakeholder, require constraint, assume constraint, frame concern, satisfy … by …, verify, короткі імена як ідентифікатори вимог, doc як текст вимоги. | Невідомо. |
| Варіанти використання | Підтримується | Визначення та використання варіантів використання, subject, actor, objective, include use case. | Невідомо. |
| Випадки аналізу та верифікації | Частково | Випадки аналізу із суб’єктом, метою та результатом return; випадки верифікації з verify і вердиктом. | Випадок аналізу обчислюється лише тоді, коли кожен вхід має значення. Аналізи компромісів зі стандартної бібліотеки не обчислюються; натомість сторінка «Аналізи компромісів» у Holarch оцінює альтернативи за значеннями з моделі. |
| Подання | Частково | view, view def, expose з ::*, ::** і фільтрами, filter, viewpoint, frame, render, стандартні визначення подань. | Подання послідовності малюють повідомлення між лініями життя, а повідомлення всередині if/else, циклів, розгалужень і рішень — як фрагменти alt, opt, loop і par з їхніми умовами. |
| Розподіл і залежності | Підтримується | allocate a to b, визначення розподілу, dependency from … to …. | Невідомо. |
| Метадані | Частково | @Name { … }, префікс #Name, metadata Name about …, користувацькі metadata def, пакети метаданих Holarch для значень TBD і TBR та понять DoDAF і UAF, користувацькі ключові слова (#safetyCritical part controller), семантичні метадані (#fault def BatteryOverheat;) і метадані з власним значенням: обов’язкові значення, значення оголошеного типу та обмеження визначення перевіряються при кожному використанні. | Обмеження визначення метаданих читають власні значення, а не анотований елемент. Метадані, записані з about, не додають базового типу. |
| Варіативність | Підтримується | Визначення й використання variation, члени variant і посилання на варіанти (variant plugInHybrid;), вибір за значенням (part :>> pack = BatteryPack::largePack;), конфігурації з позначкою @HolarchConfiguration. Перевіряється й обчислюється: варіант має ознаки своєї варіації, вибір має бути одним із варіантів точки, а точка без вибору має невідоме значення, тож твердження щодо неї ні виконується, ні порушується. | Конфігурації записуються в тексті; Holarch поки не шукає допустимих комбінацій на своїх сторінках. |
| Індивіди та часові зрізи | Підтримується | Визначення й використання individual (individual part def Car_VIN1234 :> Car), snapshot і timeslice (також після then), їхні значення та послідовності. Перевіряється й обчислюється: знімок або часовий зріз має ознаки події, до якої належить, а його власні значення читаються першими. Поле Подія (occurrence) в інспекторі, фільтр Індивіди й Новий знімок…/Новий часовий зріз… у Браузері, а також загальні подання з «individual», «snapshot» і «timeslice» та Упорядкувати як часову шкалу. | Індивідами, знімками чи часовими зрізами можуть бути лише події (occurrence). |
| Текстові представлення | Частково | rep language "…" /* … */; тіла мовами SysML і KerML перевіряються й підсвічуються як код, а тіло обмеження SysML обчислюється. Інспектор додає й редагує подання, а подання Action Flow позначають дію, що має таке подання, його мовою, наприклад {Python}. | Тіла іншими мовами, як-от Python, OCL чи MATLAB, зберігаються як текст і ніколи не виконуються. Тіло не може містити */. |
| KerML | Частково | Текст KerML стандартної бібліотеки: бібліотеки ядра читаються в KerML. Тіла KerML текстових подань перевіряються. | Файли .kerml не імпортуються в проєкти, а моделі, написані на KerML, не перевіряються. |
| Розширення мови | Частково | Користувацькі ключові слова із семантичних метаданих: #fault def BatteryOverheat; спеціалізує базовий тип метаданих, тож має ознаки цього базового типу; метадані, що обмежують те, що вони анотують (annotatedElement). | Базовий тип читається як ім’я (faults meta SysML::Usage). Інші розширення мови недоступні, а стандартну бібліотеку не можна редагувати. |
Файли та обмін
| Формат | Рівень | Що охоплює | Обмеження |
|---|---|---|---|
| Текст SysML v2 (.sysml) | Підтримується | Імпорт і експорт, також як .zip файлів, з попереднім переглядом перед застосуванням імпорту. | Ідентифікатори елементів зберігаються, коли під час експорту позначено Включити ідентифікатори елементів; без них повторний імпорт зіставляє елементи за іменем. |
| SysML v2 JSON | Частково | Імпорт і експорт у форматі елементів Systems Modeling API зі збереженням ідентифікаторів елементів. | Види елементів, які Holarch не інтерпретує, зберігаються як імпортовані й записуються без змін під час експорту; вони не мають тексту й не редагуються. |
| Моделі SysML v1 (XMI, .mdzip) | Частково | Імпорт у проєкт SysML v2 з Cameo чи MagicDraw (.mdzip або XMI), Enterprise Architect, Rhapsody і Papyrus (XMI, .uml, .xml). Модель перетворюється на текст SysML v2 і перевіряється, а звіт про перетворення перелічує кожен елемент як перетворений, наближений чи пропущений, із причиною, також у CSV. Імпорт — один крок відміни. | Лише імпорт. Елементи без відповідника в SysML v2, як-от кінцеві вузли потоку, розділи діяльності, розширення варіантів використання та специфікації екземплярів, пропускаються; діаграми та їхнє компонування не перетворюються. Один файл щонайбільше 64 MB і 250 000 елементів; файли проєктів Enterprise Architect (.eap, .qea) не читаються. |
| Репозиторії моделей | Підтримується | Отримання з однієї гілки репозиторію, що надає Systems Modeling API, і надсилання до неї. | Одна гілка на проєкт. |
| Systems Modeling API в Holarch | Частково | Інші інструменти SysML v2 читають поточну модель проєкту й фіксують зміни в гілки запитів на зміну. | main доступна лише для читання: фіксації потрапляють у запити на зміну, які затверджувач застосовує в Holarch. |
| Файли KerML (.kerml) | Поки ні | Не імпортуються; імпорт їх пропускає. | Використовуйте файли .sysml. |
Обмеження розміру та всі інші формати наведено на сторінці Імпорт і експорт.
Перевірки
Редактор перевіряє текст під час введення й позначає кожну проблему на місці. Перевірки охоплюють:
- Синтаксис: символи, коментарі, рядки, дужки,
;, очікувані імена та токени. - Імена: нерозв’язані, неоднозначні, дубльовані й приватні імена.
- Типізація та спеціалізація: цикли, правильний вид визначення, підмножини й перевизначення успадкованих ознак.
- Кратності та одиниці: допустимі межі, відповідність розмірностей, відсутні чи невідомі одиниці.
- Вирази: типи операндів, аргументи обчислень і булеві умови.
- Структура, дії та стани: кінці з’єднань, напрямки портів, потоків і
message, цілі послідовностей, вузли керування, значення, якими проходить циклfor, початкові переходи, паралельні регіони, тригери переходів (корисні навантаження через порти, моментиat) та ефектиdo(зокрема, куди спрямованоsend). - Користувацькі ключові слова:
#Nameназиває метадані, метадані позначають лише дозволені ними види, а семантичний базовий тип — це визначення або використання, що відповідає елементу, який він позначає. - Значення метаданих: кожне використання визначення метаданих задає обов’язкові значення, кожне значення відповідає типу своєї ознаки, а обмеження визначення виконуються.
- Варіативність: варіації містять лише варіанти свого виду, вибір є варіантом своєї точки, а відкриті точки конфігурації відзначаються.
- Вимоги, випадки та подання: члени в правильному місці, цілі
satisfy,verify,exposeіframe. - Текстові подання: тіла SysML і KerML розбираються й оголошують елемент, який вони подають; мова, якої Holarch не знає, відзначається.
- Обчислення: обмеження, вимоги й цілі, що не виконуються для поточних значень.
Кожна перевірка з прикладом повідомлення: Перевірки.
Відомі прогалини
- Немає розв’язувача для випадків аналізу. Випадок аналізу обчислюється, коли кожен вхід має значення. У параметричному поданні «Розв’язати» знаходить одну невідому для кожного обмеження.
- Немає пошуку варіантів на сторінках. Варіації, варіанти й конфігурації перевіряються та обчислюються; сторінки Holarch поки не перелічують усіх допустимих комбінацій.
- Немає файлів KerML. KerML читається лише для стандартної бібліотеки.
- Розширення мови обмежено користувацькими ключовими словами й метаданими. Семантичні метадані застосовують свій базовий тип; інші метадані означають те, що задає їхнє визначення (обов’язкові значення, типи значень та обмеження), а стандартна бібліотека доступна лише для читання.
- Текстові подання іншими мовами, ніж SysML і KerML, зберігаються як текст; Holarch ніколи їх не виконує.
- Systems Modeling API: без фіксацій у main, тегів і об’єднань. Інші інструменти фіксують зміни в гілки запитів на зміну; затверджувач застосовує їх у Holarch.
Holarch реалізує підмножину специфікації, наведену на цій сторінці. Що нового перелічує кожну її зміну.