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 и читайте модель как простые записи с постоянными идентификаторами. Текст может содержать идентификатор каждого элемента, поэтому отредактированный и прочитанный обратно текст сохраняет идентичность каждого элемента при переименованиях и перемещениях.

Проверен в 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 дней.