Holarch

SysML v2

Початок роботи з проєктами SysML v2

Виберіть між проєктом LML і SysML v2, створіть проєкт SysML v2 або демопроєкт, напишіть першу модель і освойтеся в інтерфейсі.

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

На цій сторінці
  1. Огляд
  2. Поняття
    1. Два типи проєктів
    2. Модель і текст — одне ціле
    3. Дані моделі та дані Holarch
    4. Визначення та використання
  3. Як користуватися
    1. Вибрати тип проєкту
    2. Створити проєкт SysML v2
    3. Відкрити демопроєкт Hybrid Car
    4. Відкрити демопроєкт Hybrid Car Battery Pack
    5. Відкрити демопроєкт Earth Observation Satellite
    6. Написати першу модель
    7. Освоїтися в інтерфейсі
  4. Розібраний приклад: огляд Hybrid Car
  5. Поради та поширені помилки
  6. Панель навігації в проєктах SysML v2
  7. Спрощений режим
    1. Увімкнути або вимкнути
    2. Що показує
    3. Показати все
  8. Головна
  9. Запитати ШІ
  10. Ще недоступно
  11. Повідомлення
  12. Обмеження
  13. Пов’язані сторінки

Огляд

Holarch підтримує проєкти SysML v2. Проєкт SysML v2 містить одну модель, написану текстовою нотацією SysML v2 на основі специфікації OMG SysML v2.

Ви пишете модель як текст у Редактор. Holarch зберігає ту саму модель як елементи: пакети, визначення, використання та зв’язки. Оглядач, подання та сторінки життєвого циклу (вимоги, верифікація, інтерфейси, ризики, планування) показують ті самі елементи.

На цій сторінці пояснено два типи проєктів, як почати проєкт SysML v2 і де що розташовано. Саму мову описано на сторінці Текстова нотація SysML v2. Редактор і Оглядач описано на сторінці Текстовий редактор і Оглядач.

Поняття

Два типи проєктів

Кожен проєкт Holarch є або проєктом LML, або проєктом SysML v2. Ви вибираєте тип під час створення проєкту. Він залишається незмінним: проєкт змінює тип лише через перетворену копію (див. Перетворення між LML і SysML v2).

LMLSysML v2
Для чогоМоделювання системи мовою Lifecycle Modeling Language: вимоги, функції, фізична архітектура, інтерфейси, тести, ризики та графік. Holarch перевіряє вашу роботу на кожному кроці.Побудова моделі мовою SysML v2 у вигляді тексту зі стандартними поняттями SysML v2: пакети, визначення та використання, порти, з’єднання, дії, стани та вимоги.
Як будується модельБаза даних, форми та понад 30 типів діаграм.Текст у Редакторі, а також подання та сторінки життєвого циклу, які записують у той самий текст.
Чим можна обмінюватисяІмпорт із Word, Excel, CSV, ReqIF і XMI; експорт у Word, Excel і діаграм; файли проєктів.Текст SysML v2 (.sysml) і SysML v2 JSON (див. Обмін моделями SysML v2); імпорт SysML v1 з XMI та файлів Cameo або MagicDraw .mdzip (див. Імпорт моделей SysML v1); файли проєктів.

Якщо не впевнені, виберіть LML. Він має всі сторінки та діаграми Holarch і підходить тим, хто тільки починає з MBSE. Вибирайте SysML v2, коли ваша команда вже моделює в SysML v2 або обмінюється моделями з інструментами SysML v2.

Модель і текст — одне ціле

Проєкт SysML v2 не містить файлів. Модель — це набір елементів, а Редактор показує один текстовий документ на кожен пакет верхнього рівня. Коли текст успішно розбирається, Holarch застосовує його до моделі. Коли ви змінюєте модель деінде (у поданні, таблиці, інспекторі), текст змінюється разом із нею. Див. Текст і подання залишаються синхронізованими.

Дані моделі та дані Holarch

Частина інформації входить у текст SysML; частину Holarch зберігає поруч із моделлю.

  • У тексті: назви елементів, короткі назви (номери вимог), документація, типи, кратності, значення та зв’язки, як-от satisfy, verify, perform і connect.
  • Поруч із моделлю (дані Holarch): статус і затвердження вимог, результати верифікації, мітки, виконавці, терміни, коментарі обговорень, компонування подань, налаштування симулятора, бюджети, ризики, рішення та завдання. Вони зв’язані з елементами моделі за ідентичністю, тож зв’язки зберігаються після перейменувань і переміщень.

Дані Holarch не записуються в текст SysML і не входять до експорту .sysml.

Визначення та використання

Більшість ключових слів SysML v2 мають дві форми. Визначення (part def Wheel;) описує вид речі. Використання (part frontWheel : Wheel;) — одне використання визначення всередині іншого елемента. Та сама схема діє для port def/port, action def/action і requirement def/requirement. На сторінці Текстова нотація SysML v2 це пояснено повністю.

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

Вибрати тип проєкту

Визначтеся з типом, перш ніж створювати проєкт.

  1. Виберіть LML, щоб користуватися повним методом Holarch: Базою даних, діаграмами LML і перевірками з підказками на кожному кроці.
  2. Виберіть SysML v2, коли модель має бути текстом SysML v2, наприклад для обміну з іншим інструментом SysML v2.
  3. Щоб спершу спробувати SysML v2, відкрийте демопроєкт Hybrid Car (процедура через одну) замість порожнього проєкту.

Створити проєкт SysML v2

  1. Відкрийте Керування проєктами і натисніть + Новий проєкт.
  2. У розділі Як ви моделюватимете цю систему? виберіть SysML v2.
  3. Введіть назву й натисніть Створити проєкт.

Проєкт відкривається на Головна. Чип SysML v2 показується поруч із назвою проєкту на верхній панелі та на сторінці “Керування проєктами”. Нова модель порожня: Наступні дії на Головній пропонує Напишіть перший пакет у Редакторі.

Відкрити демопроєкт Hybrid Car

Демопроєкт Hybrid Car — це готова модель SysML v2 для ознайомлення та редагування.

  1. Відкрийте Керування проєктами.
  2. Натисніть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car (SysML v2).

Holarch створює проєкт Hybrid Car (SysML v2 demo) і відкриває його на Головна. Натисніть Редактор на панелі навігації, щоб прочитати текст. Модель має шість пакетів верхнього рівня: Vehicles, VehicleRequirements, VehicleBehavior, VehicleViews, HolarchFrameworks і HybridCarArchitecture. Кожен із них — документ у списку Пакети Редактора.

Демопроєкт — ваша власна копія. Змінюйте його вільно або створіть знову, щоб почати спочатку.

Щоб відкрити демопроєкт за посиланням, використайте https://app.holarch.app/#/?demo=hybrid. Воно створює демопроєкт і відкриває його; у хостинговому застосунку він відкривається після входу.

Відкрити демопроєкт Hybrid Car Battery Pack

Демопроєкт Hybrid Car Battery Pack — це тягова батарея автомобіля в тому вигляді, як її моделює постачальник, в окремому проєкті. Якщо демопроєкт Hybrid Car також є серед ваших проєктів, створений до чи після нього, три вимоги до батареї зв’язано з вимогами до батареї автомобіля (BP-1 з VR-3, BP-2 з VR-6, BP-3 з VR-5), тож Керування проєктами → Карта програми показує, як пов’язані ці два проєкти. Ці демозв’язки працюють у кожному тарифі.

  1. Відкрийте Керування проєктами.
  2. Натисніть Файли проєктів ▾ → Новий демопроєкт → Hybrid Car Battery Pack (SysML v2).

Що спробувати:

  • Обчислені значення: у Редакторі Pack::mass підсумовує модулі (кожен із 12 комірок і корпусу), систему керування батареєю, розподільчу коробку, охолодження та кожух: 43 кг при ліміті 48 кг, тож massMargin становить 5 кг. Pack::capacity підсумовує 120 комірок: 1,44 кВт·год проти 1,4 кВт·год. Виберіть атрибут, щоб побачити його значення в інспекторі.
  • Параметричне подання: відкрийте packParametrics. Перевірки ємності, маси, часу заряджання та балансування комірок прив’язано до значень батареї, і вони проходять.
  • RVTM: ємність і маса мають статус “Пройдено”, приймання заряду — “Не пройдено” (тест гарячого заряджання тривав 34 хвилини проти 30), а балансування комірок ще не виконано. Кожен випадок верифікації обчислює свій вердикт із моделі.
  • Симулятор: Симулятор відкривається на pack разом із Hot Day Charge. Натисніть Run to End, потім Стани: заряджання знижується до половини потужності, коли комірки перегріваються, і відновлюється, коли вони охолонуть. Виберіть Cell Over Voltage Fault у полі Запускати разом із, щоб побачити захисне вимкнення та сервісне скидання.

Відкрити демопроєкт Earth Observation Satellite

Демопроєкт Earth Observation Satellite — більша модель: місія EO-2, 12U-супутник для зйомки з наземним сегментом, приблизно 3 000 рядків у 14 пакетах. Власні дані Holarch заповнено поверх моделі, тож кожна сторінка має що показати.

  1. Відкрийте Керування проєктами.
  2. Натисніть Файли проєктів ▾ → Новий демопроєкт → Супутник спостереження Землі (SysML v2).

Holarch створює проєкт Earth Observation Satellite (SysML v2 demo) і відкриває Головну. Демопроєкт має 1 549 елементів — більше, ніж 1 000 елементів на проєкт у тарифі Free: на тарифі Free його пункт меню неактивний і показує Потрібен тариф Individual (1 549 елементів). Посилання https://app.holarch.app/#/?demo=eosat також створює його. Що спробувати:

  • Документи: відкрийте EO-2 System Requirements Specification. Його розділи містять вимоги з EORequirements, живі значення та матрицю верифікації.
  • Бюджети: маса формувача зображень перевищує виділені 4,0 кг; TPM Imager Mass показує тенденцію.
  • Зв’язки для перевірки і TBD/TBR: змінені вимоги та відкриті значення, які потрібно визначити.
  • Симулятор: запустіть прохід зйомки з подання imagingPassFlow.
  • Базові лінії: порівняйте базову лінію PDR Data Freeze з поточною моделлю.
  • Подання: режими космічного апарата, подання з’єднань і послідовність постановки завдань.

Написати першу модель

Ця процедура будує невелику модель дрона з таким текстом:

package Drone {
    private import ISQ::*;
    private import SI::*;

    part def Battery {
        attribute mass : MassValue = 0.4 [kg];
    }
    part def Quadcopter {
        part battery : Battery;
    }
}
  1. Відкрийте Модель → Редактор, натисніть + Новий пакет, введіть Drone і підтвердьте. Редактор відкриває текст нового пакета.
  2. Введіть імпорти та члени всередині фігурних дужок пакета, як вище.
  3. Припиніть введення. Після короткої паузи рядок стану під текстом показує Застосовано. Тепер модель містить пакет, обидва визначення частин, атрибут і частину, і одне натискання “Відмінити” повертає все назад.
  4. Відкрийте Модель → Оглядач і розгорніть Drone, щоб побачити ті самі елементи деревом.

Якщо рядок містить помилку, рядок стану показує Не застосовано: виправте рядок N. Модель зберігає останній правильний стан, доки текст знову не розбиратиметься. Див. Помилки та чернетки.

Освоїтися в інтерфейсі

Проєкти SysML v2 зберігають панель життєвого циклу Holarch. Кожна група працює з моделлю SysML v2.

  1. Почніть із Головна: що потребує уваги, групи життєвого циклу та наступні дії.
  2. Використовуйте Модель → Редактор, щоб писати текст, і Модель → Оглядач, щоб бачити дерево.
  3. Використовуйте Потреби та вимоги і Верифікація для вимог, випадків верифікації та простежуваності.
  4. Використовуйте Поведінка, Архітектура та Інтерфейси для подань і сторінок аналізу.
  5. Відкрийте інструмент Діаграми внизу панелі навігації, щоб побачити всі подання.
  6. Натисніть ⌘K / Ctrl+K, щоб знайти будь-який елемент за назвою, короткою назвою, кваліфікованою назвою (Vehicles::Car) або текстом документації.
  7. Уперше з SysML v2? Увімкніть спрощений режим, щоб спершу бачити найуживаніші елементи.

Розібраний приклад: огляд Hybrid Car

Цей огляд використовує демопроєкт Hybrid Car.

  1. Створіть демопроєкт (див. Відкрити демопроєкт Hybrid Car). Він відкривається на Головна. Відкрийте Модель → Редактор і виберіть Vehicles у списку Пакети.
  2. Знайдіть part def Car. Він має частини body, powertrain, frontAxle, rearAxle і spare : Wheel [0..1].
  3. Клацніть із ⌘ / Ctrl на Powertrain у part powertrain : Powertrain;. Курсор переходить до part def Powertrain з його частинами tank, engine, motor, battery, transmission і controller та інтерфейсами, як-от interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;.
  4. Наведіть вказівник на MassValue у attribute mass : MassValue;. Картка показує його вид і кваліфіковану назву зі стандартної бібліотеки.
  5. Відкрийте Модель → Оглядач. Введіть sedan у полі Фільтрувати за іменем. Дерево показує sedan під fleet у Vehicles. Виберіть його: інспектор показує Kind part, Typed by Car і кваліфіковану назву Vehicles::fleet::sedan.
  6. Відкрийте Головна. Картка Життєвий цикл групи Потреби та вимоги рахує вимоги моделі; Потребує уваги показує зв’язки для перевірки, прострочені TBD і високі ризики моделі.
  7. Відкрийте Потреби та вимоги → Вимоги. Рядки містять VR-1.1 sedanMass — використання вимоги, номер якого є його короткою назвою <'VR-1.1'>.
  8. Відкрийте інструмент Діаграми і відкрийте driveCycleFlow — подання потоку дій DriveCycle. Перейменуйте там дію й поверніться до Редактора: VehicleBehavior показує нову назву.

Поради та поширені помилки

  • Почніть із демопроєкту. Копіювання шаблонів із тексту Hybrid Car — найшвидший спосіб вивчити нотацію.
  • Імпортуйте одиниці. Щоб 5 [kg] був видимий, потрібен SI (а для MassValue — ISQ). Додайте до пакета private import ISQ::*; і private import SI::*;.
  • Одна модель на проєкт. Розділяйте велику модель на кілька пакетів верхнього рівня; кожен є окремим документом у Редакторі.
  • Вибрано не той тип. Тип не можна змінити на місці. Створіть перетворену копію з “Керування проєктами” (⋯ → Створити копію LML… або Створити копію SysML v2…).
  • Очікування статусу в тексті. Статус вимог, результати верифікації та мітки — це дані Holarch. Вони не з’являються в тексті чи в експорті .sysml.

Панель навігації в проєктах SysML v2

ГрупаСторінки
ГоловнаПотребує уваги, Життєвий цикл, Наступні дії та інші панелі Головної
Потреби та вимогиДокументи, Вимоги, Якість, TBD/TBR, Зв’язки для перевірки, Затвердження, Матриця відповідності*
МодельРедактор, Оглядач, Імпорт і експорт
ПоведінкаФункціональний аналіз, Потоки дій, FFBD, Машини станів, Послідовності, Симулятор
АрхітектураЧастини, Загальні подання, Подання взаємозв’язків, Ієрархія, Бюджети й TPM
ІнтерфейсиРеєстр інтерфейсів, ICD, Діаграми N², Елементи та вх./вих.
ВерифікаціяRVTM, Випадки верифікації, Відхилення та поступки*, Матриця простежуваності, Покриття програми, Перевірки моделі
Безпека та надійність†Журнал небезпек, FMECA, Дерева відмов, Структурні схеми надійності
Ризики, проблеми та рішенняРеєстр ризиків, Діаграми Risk, Аналізи компромісів, Рішення, Проблеми й дії
ТарифМоя робота, Процес SE, Керування проєктом, Графіки, Дошки, Презентації
Контроль і рецензуванняЗапити на зміну, Базові лінії та версії, Бібліотеки, Рецензування, Активність
ФреймворкиDoDAF, UAF

* Коли ввімкнено формальну програму. † Коли ввімкнено програму безпеки та надійності. Обидві перемикаються в Параметри проєкту → Функції програми.

Інструменти внизу панелі навігації ті самі, що й у проєктах LML: База даних, Діаграми, Кошик, Налаштування і Довідка. У проєктах SysML v2 Налаштування також містять Стандартна бібліотека. Сторінки, які не стосуються проєктів SysML v2, не показуються.

Сторінки описано в розділах Подання SysML v2, Вимоги та верифікація в проєктах SysML v2, Оцінювання, одиниці та аналіз у проєктах SysML v2 і Функції Holarch у проєктах SysML v2.

Спрощений режим

Простий режим призначено для тих, хто лише починає працювати з SysML v2. Він показує елементи, з яких починається більшість моделей, пояснює кожен одним реченням і приховує решту, доки ви її не попросите. Він змінює лише те, що ви бачите: модель, її текст і кожен експорт залишаються такими самими.

Увімкнути або вимкнути

  • Параметри → SysML v2 → Простий режим.
  • Простий режим у заголовку сторінки Модель → Оглядач (натиснута, поки режим увімкнено).
  • ⌘K / Ctrl+K → Увімкнути простий режим або Вимкнути простий режим.

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

Коли ви вперше відкриваєте проєкт SysML v2, під верхньою панеллю з’являється примітка Уперше працюєте з SysML v2? Увімкніть простий режим, щоб спершу бачити найуживаніші елементи. Натисніть Увімкнути, щоб увімкнути простий режим, або ×, щоб закрити примітку. Будь-яку відповідь буде збережено у вашому обліковому записі, і примітка більше не з’явиться. Доки ви не відповіли, вона показується щоразу, коли ви відкриваєте проєкт SysML v2. Вона не показується, якщо простий режим уже ввімкнено.

Що показує

Дванадцять понять, які найчастіше використовують демопроєкт Hybrid Car і посібники: пакет, частина, атрибут, порт, з’єднання та інтерфейс, дія, потік і послідовність, стан, перехід, вимога, задоволення (satisfy) та верифікація.

ДеУ простому режиміПриховано до “Показати все”
Загальне подання, панель “Додати”Пакет, Визначення частини, Частина, Визначення порту, Порт, Атрибут, Визначення інтерфейсу, Визначення дії, Дія, Визначення вимоги, Вимога, Випадок верифікаціїВизначення атрибута, Визначення предмета, Визначення переліку
Діаграма Spider, панель “Додати”Пакет, Визначення частини, Частина, Визначення порту, Порт, Атрибут, Визначення дії, Дія, Стан, Визначення вимоги, Вимога, Випадок верифікаціїВизначення предмета, Предмет, Визначення атрибута, Варіант використання
Подання взаємозв’язків, панель “Додати”Частина, ПортЕлемент обміну
Подання переходів станів, панель “Додати”Початковий стан, Кінцевий стан, Стан, Дія входу, Дія do, Дія виходуПаралельний стан, Область
Подання Action Flow, панель “Додати” і + Action ▾Дія, Розгалуження, Злиття, Рішення, Об’єднання, ДоріжкаДія accept, Дія надсилання, Цикл (while), Завершити
Редактор, Вставити ▾Пакет, Визначення частини, Частина, Атрибут, Визначення порту, Порт, Інтерфейс, З’єднання, Визначення дії, Дія, Послідовність, Потік, Визначення стану, Стан, Початковий стан, Перехід, Визначення вимоги, Вимога, Задовольнити, Визначення верифікації, ВерифікуватиУсі інші фрагменти, що підходять у позиції курсора
Модель → ОглядачПакети, визначення, використання, з’єднання, потоки, переходи, вимоги, satisfy і verifyІмпорти, псевдоніми, expose, коментарі, документація, метадані, бібліотечні пакети, сполучні з’єднувачі (binding), елементи рівня KerML, а також рядки тригера й ефекту переходу

Наведіть вказівник на елемент у панелі “Додати” або на вид рядка в Оглядачі, щоб прочитати пояснення цього елемента одним реченням.

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

Показати все

  • Панелі “Додати”: Показати все (ще n) під елементами; Показати менше знову їх приховує.
  • + Action ▾: Показати все… наприкінці знову відкриває меню з усіма видами.
  • Вставити ▾: позначте Показати все в його заголовку.
  • Оглядач: позначте Показати все на панелі фільтра.

“Показати все” діє, доки ви не перезавантажите сторінку або не перемкнете простий режим; простий режим тим часом залишається ввімкненим. В Оглядачі елемент, який ви відкриваєте з іншого місця (наприклад, через Показати в оглядачі в інспекторі), завжди показується разом зі своїми власниками, навіть якщо його вид приховано.

Головна

Головна — та сама сторінка, що й у проєктах LML (див. Головна): Потребує уваги (зв’язки для рецензування, прострочені TBD, невдалі тести, перевищення TPM, високі ризики, перевірки моделі, стан збереження), картка Життєвий цикл для кожної групи панелі навігації та панелі, як-от Наступні дії, Контрольна точка Процесу SE і Контрольні точки. Лічильники беруться з моделі SysML v2 і даних Holarch поруч із нею. ✦ Написати стислий опис проєкту у проєктах SysML v2 не пропонується.

  • Групи панелі навігації показують ті самі значки проблем, а сторінка огляду кожної групи перелічує те, що потребує уваги, і її показники.
  • + Додати панель → Вміст моделі показує Пакети (з кількістю пакетів верхнього рівня), Визначення, Використання, Зв’язки і Вимоги (n не задоволено · n не верифіковано), елементи не на своєму місці, коли елементи втратили власника, і Останні зміни: найновіші зміни моделі (створено, змінено, переміщено, видалено або відновлено) з видом елемента й часом.

Запитати ШІ

“Запитати ШІ” відповідає на запитання про мову SysML v2 і про роботу з Holarch на основі Довідки й Docs. У тарифах Individual і Team, а також із власним ключем ШІ або ключем вашої організації, він також відповідає на запитання про відкриту модель і пропонує зміни, які відкриваються для перегляду, перш ніж застосуватися. Див. Запитати ШІ.

Ще недоступно

  • Коміти в main, теги й об’єднання через Systems Modeling API: інші інструменти надсилають коміти в гілки запитів на зміну, які затверджувач застосовує в Holarch (див. API і MCP у проєктах SysML v2).
  • Редагування мови: стандартна бібліотека доступна лише для читання.

Текстова нотація SysML v2 докладно перелічує підтримувану мову.

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

ПовідомленняЗначення
Модель порожняПроєкт не має елементів. Натисніть + Новий пакет, а потім напишіть його члени в Редакторі.
Не застосовано: виправте рядок N.Текст має помилку в рядку N. Модель зберігає свій останній правильний стан, доки текст не буде розібрано.
Лише перегляд: попросіть власника надати доступ на редагування.Ви маєте доступ до проєкту лише на перегляд. Текст і сторінки доступні лише для читання.
Цьому проєкту потрібна новіша версія Holarch.Проєкт збережено новішою версією Holarch, а ця сторінка старіша. Проєкт відкривається лише для перегляду, а банер угорі пояснює чому. Натисніть Перезавантажити в банері, щоб отримати нову версію.

Обмеження

  • Тип проєкту задається під час створення й не змінюється.
  • Одна модель на проєкт.
  • Текстовий документ, більший за 8 MB, не перевіряється; розділіть його на кілька пакетів.

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