Holarch

Для розробників

Holarch Language Engine

Мовний рушій для SysML v2 і KerML, доступний для ліцензування.

Рушій, на якому працюють проєкти SysML v2 у Holarch, для вашого власного продукту. Він розбирає, розв’язує, перевіряє й обчислює текст SysML v2 і KerML і працює в браузері як WebAssembly або на вашому сервері.

Holarch Language Engine у роботі: помилка одиниць з’являється під час введення значення й зникає після виправлення, перехід до визначення відкриває визначення частини в іншому пакеті, а модель із 250,000 рядків перевіряється з командного рядка з кодом діагностики й витраченим часом

Для кого він

Для команд, яким потрібен текст SysML v2 у власному продукті без написання й підтримки реалізації мови.

Постачальники інструментів

Додайте редагування, перевірку й імпорт SysML v2 до інструмента моделювання, побудови діаграм або архітектури.

Продукти PLM, керування вимогами й симуляції

Читайте моделі SysML v2, відстежуйте вимоги й значення з одиницями та обмінюйтеся моделями з іншими інструментами.

Команди внутрішніх інженерних інструментів

Перевіряйте моделі в конвеєрах рецензування, генеруйте звіти й надайте інженерам редактор SysML v2 у корпоративних інструментах.

Що він робить

Один рушій для всього шляху від тексту до перевіреної моделі: на вході JSON, на виході JSON.

Розбір

Текстова нотація SysML v2 і KerML з відновленням після помилок: одна помилка не приховує решту файлу. Стандартна бібліотека завантажується разом із рушієм.

Розв’язання

Імена, імпорти, псевдоніми, спеціалізація, типізація й перевизначення між пакетами й файлами, з підказками при наведенні, переходом до визначення, автодоповненням і перейменуванням.

Перевірка

135 кодів діагностики, кожен із рівнем серйозності, точним діапазоном, повідомленням і запропонованим виправленням, яке ваш редактор може запропонувати як швидке виправлення.

Обчислення

Вирази з одиницями й величинами, як-от body + 4 * 12 [kg] до 348 [kg], а також обмеження вимог і випадки верифікації. Порогові значення вимог і цілі, до яких вони прагнуть, зчитуються з моделі.

Повторний аналіз під час введення

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

Редагування тексту без втрати форматування

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

Порівняння, об’єднання й перебазування

Порівнюйте дві версії моделі як список змін, застосовуйте їх і перебазовуйте текстове редагування на новіші зміни моделі.

Варіанти

Точки варіативності, варіанти й конфігурації перевіряються, а кожну комбінацію варіантів можна перелічити й оцінити відносно обмежень моделі.

Симуляція (доповнення)

Виконуйте потоки дій і автомати станів у симульованому часі: окремими прогонами, покроково з вхідними даними від вашого продукту або як дослідження Монте-Карло. Той самий seed дає ту саму відповідь у браузері й на сервері.

Обмін JSON

Імпортуйте й експортуйте SysML v2 JSON і читайте модель як прості записи зі сталими id. Текст може містити id кожного елемента, тож відредагований текст, прочитаний назад, зберігає ідентичність кожного елемента під час перейменувань і переміщень.

Перевірено в Holarch

Той самий рушій обслуговує кожен проєкт SysML v2 у Holarch: редактор, подання та сторінки життєвого циклу.

Доповнення

Рушій самостійно перевіряє, аналізує й редагує моделі. Три доповнення розширюють його, кожне ліцензується окремо й вмикається вашим ліцензійним токеном, без перезбирання й змін коду.

Симуляція

Виконуйте потоки дій і автомати станів у симульованому часі: окремі прогони, покроково з вхідними даними від вашого продукту або дослідження Монте-Карло. Той самий seed дає ту саму відповідь у браузері й на сервері. Моделі з анотаціями симуляції перевіряються й без нього.

Міграція з SysML v1 на SysML v2

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

Серверне використання

Запускайте рушій поза сторінкою браузера: у Node.js, Deno, безсерверних функціях або як розширення Python. Перевіряйте моделі в конвеєрах збирання, перетворюйте їх пакетами або відповідайте на запити з власного сервісу.

Доповнення: міграція з SysML v1 на SysML v2

Доповнення для міграції перетворює модель SysML v1 на текст SysML v2 на основі перетворення SysML v1 у SysML v2 зі специфікації OMG SysML 2.0. Це перетворювач, на якому працює імпорт SysML v1 у Holarch, і він ліцензується окремо від рушія.

  • Вхідні дані: модель SysML v1 як JSON у нейтральній формі, задокументованій у довіднику API. Ваш продукт читає файл XMI (з Cameo чи MagicDraw, Enterprise Architect, Rhapsody або Papyrus) і надсилає модель; рушій не читає ні XML, ні файлів.
  • Вихідні дані: текст SysML v2, перевірка цього тексту рушієм і звіт, що перелічує кожен елемент як перетворений, наближений або відкинутий, зі сталим кодом причини та ім’ям SysML v2, яким він став.
  • Відтворюваність: та сама модель щоразу перетворюється на той самий текст.
  • Обмеженість: моделі до 250,000 елементів і 8 MiB тексту; більша модель отримує відповідь з помилкою, ніколи не зависання.

Запит — v1_convert у довіднику API. Без доповнення рушій відповідає на нього feature-not-licensed, а всі інші запити працюють як зазвичай.

Запит і відповідь на нього

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

Невелика тестова модель, перетворена рушієм: 31 елемент, жодної діагностики в перетвореному тексті.

Як він працює

У браузері рушій — це модуль WebAssembly у Web Worker, тож аналіз ніколи не блокує сторінку. Невеликий інтеграційний шар JavaScript надсилає запити й повертає відповіді як проміси. Серверна збірка для Node.js або Python доступна на запит.

How the engine fits into a browser applicationYour application calls the JavaScript integration layer with JSON requests. The layer passes them to a Web Worker that runs the WebAssembly engine with the standard library loaded, and returns JSON answers. The engine has no network or file access. Your application editor, views, pipeline JavaScript integration layer requests as promises WEB WORKER Holarch Language Engine WebAssembly, no network or file access Standard library JSON

Запит і відповідь на нього

// Request
{ "op": "analyze",
  "text": "package P { part a : Engine; part b }" }

// Answer (tokens left out)
{ "diagnostics": [
    { "code": "syntax.expected-token",
      "args": { "expected": ";", "found": "}" },
      "range": { "from": 35, "to": 35 },
      "severity": "error" },
    { "code": "name.unresolved",
      "args": { "name": "Engine" },
      "field": "typedBy",
      "range": { "from": 21, "to": 27 },
      "severity": "error" } ] }

Справжній запит і відповідь з посібника з інтеграції рушія: одна синтаксична помилка й одне ім’я, що не розв’язується, кожна зі сталим кодом і точним діапазоном у тексті.

Характеристики

Виміряно на згенерованій моделі з 10,000 рядків:

  • 150 ms на аналіз усієї моделі з 10,000 рядків з нуля (розбір, розв’язання й перевірка); 215 ms як WebAssembly в Safari.
  • Від 1.3 до 6.8 ms на повторну перевірку моделі з 10,000 рядків після редагування (95-й процентиль); від 3 до 4 ms як WebAssembly в Safari.
  • База рушія із завантаженою стандартною бібліотекою: 17 MiB. Аналіз усієї моделі додає приблизно 29 MiB на 10,000 рядків, а весь сеанс редагування — приблизно 33 MiB на 10,000 рядків.
  • Приблизно 0.74 MB WebAssembly у стисненому вигляді.

Перевірено на згенерованих моделях до 250,000 рядків: результати для кожного розміру.

Ваші показники залежать від моделі й комп’ютера. Ознайомлювальна версія дає змогу виміряти їх на власних моделях.

Безпека

  • Без доступу до мережі й файлів. Модуль WebAssembly нічого не імпортує зі сторінки: він читає передані вами текст і записи й повертає JSON.
  • Обмеження вхідних даних. Розмір вхідних даних, довжину рядка, вкладеність і глибину виразів обмежено, тож шкідливий файл не може вичерпати пам’ять чи стек.
  • Фазинг. Точки входу для запитів, лексера й парсера, симулятор і мовні операції проходять фазинг-тестування.
  • Ізольованість. У браузері він працює у власному worker. Збій зупиняє лише цей worker, і ваша сторінка перезапускає його.

Що ви отримуєте

  • Рушій: збірку WebAssembly зі стандартною бібліотекою.
  • Інтеграційний шар JavaScript: worker і клієнт для вашої сторінки.
  • Документацію для розробників: посібник з інтеграції, довідник кожного запиту зі справжніми запитами й відповідями, перелік кодів діагностики та робочі приклади (мінімальна сторінка, редактор, браузер моделі, Node.js і Python).
  • Оновлення протягом строку дії ліцензії.
  • Підтримку електронною поштою від команди, яка його створює.

Ліцензування

  • Річна ліцензія щоразу на один рік, ціна якої залежить від кількості щомісячних активних користувачів функцій, що їх забезпечує рушій у вашому продукті.
  • Безкоштовна 60-денна ознайомлювальна версія на вашому комп’ютері з документацією та прикладами.
  • Академічні й дослідницькі ліцензії для університетів і дослідницьких груп.
  • Корпоративне використання на запит: кілька продуктів або велика кількість користувачів.
  • Доповнення: симуляція, міграція з SysML v1 на SysML v2 і серверне використання, кожне ліцензується окремо.

Розкажіть нам про свій продукт і очікувану кількість користувачів, і ми надішлемо комерційну пропозицію.

Підтримка мови

Поточна версія — Holarch Language Engine 2.1.2. Він ґрунтується на специфікації OMG SysML v2 і підтримує підмножину SysML v2 і KerML. На сторінці Охоплення мови SysML v2 перелічено підтримувані конструкції та відомі прогалини так, як вони працюють у Holarch. Документація ознайомлювальної версії містить такий самий перелік для рушія.

Як рушій порівнюється з пілотною реалізацією OMG на офіційних прикладах моделей і як він працює з пошкодженим текстом і великими моделями, зокрема невдачі: Результати тестування Language Engine.

Випробуйте рушій на власних моделях.

Ознайомлювальна версія безкоштовна протягом 60 днів.