Разработчикам
Holarch Language Engine
Языковой движок для SysML v2 и KerML, доступный для лицензирования.
Движок, на котором работают проекты SysML v2 в Holarch, — для вашего собственного продукта. Он разбирает, разрешает, проверяет и вычисляет текст SysML v2 и KerML и работает в браузере как WebAssembly или на вашем сервере.

Для кого он
Для команд, которым нужен текст 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 доступна по запросу.
Запрос и ответ на него
// 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 дней.