Dla programistów
Holarch Language Engine
Silnik językowy dla SysML v2 i KerML, dostępny na licencji.
Silnik stojący za projektami SysML v2 w Holarch, do twojego własnego produktu. Parsuje, rozwiązuje, sprawdza i oblicza tekst SysML v2 i KerML, a działa w przeglądarce jako WebAssembly lub na twoim serwerze.

Dla kogo
Zespoły, które chcą mieć tekst SysML v2 we własnym produkcie bez pisania i utrzymywania implementacji języka.
Dostawcy narzędzi
Dodaj edycję, sprawdzanie i import SysML v2 do narzędzia do modelowania, tworzenia diagramów lub architektury.
Produkty PLM, do wymagań i do symulacji
Odczytuj modele SysML v2, śledź wymagania i wartości z jednostkami oraz wymieniaj modele z innymi narzędziami.
Zespoły wewnętrznych narzędzi inżynierskich
Sprawdzaj modele w procesach przeglądu, generuj raporty i daj inżynierom edytor SysML v2 w narzędziach firmowych.
Co robi
Jeden silnik na całą drogę od tekstu do sprawdzonego modelu, z JSON na wejściu i JSON na wyjściu.
Parsowanie
Notacja tekstowa SysML v2 i KerML z odtwarzaniem po błędach: jedna pomyłka nie ukrywa reszty pliku. Biblioteka standardowa ładuje się razem z silnikiem.
Rozwiązywanie
Nazwy, importy, aliasy, specjalizacja, typowanie i redefinicja w obrębie pakietów i plików, z podpowiedziami po najechaniu, przejściem do definicji, uzupełnianiem i zmianą nazwy.
Kontrola
135 kodów diagnostycznych, każdy z poziomem ważności, dokładnym zakresem, komunikatem i sugerowaną poprawką, którą edytor może zaproponować jako szybką poprawkę.
Obliczanie
Wyrażenia z jednostkami i wielkościami, na przykład body + 4 * 12 [kg] do 348 [kg], oraz ograniczenia wymagań i przypadki weryfikacji. Progi wymagań i cele, do których zmierzają, są odczytywane z modelu.
Ponowna analiza podczas pisania
Sesje dokumentów ponownie parsują tylko zmienioną część i wysyłają różnice tokenów, dzięki czemu edytory pozostają responsywne przy dużych modelach.
Edycja tekstu bez utraty formatowania
Zmiany z diagramu lub formularza są zapisywane z powrotem w tekście. Niezmieniony tekst, komentarze i układ pozostają dokładnie takie, jak zapisał je użytkownik.
Porównywanie, scalanie i rebase
Porównaj dwie wersje modelu jako listę zmian, zastosuj je i przenieś (rebase) edycję tekstu na nowsze zmiany modelu.
Warianty
Punkty zmienności, warianty i konfiguracje są sprawdzane, a każdą kombinację wariantów można wypisać i ocenić względem ograniczeń modelu.
Symulacja (dodatek)
Uruchamiaj przepływy akcji i maszyny stanów w czasie symulowanym, jako pojedyncze przebiegi, krok po kroku z danymi wejściowymi z twojego produktu lub jako badania Monte Carlo. To samo ziarno daje tę samą odpowiedź w przeglądarce i na serwerze.
Wymiana JSON
Importuj i eksportuj SysML v2 JSON oraz odczytuj model jako zwykłe rekordy ze stałymi identyfikatorami. Tekst może zawierać identyfikator każdego elementu, więc edytowany tekst odczytany z powrotem zachowuje tożsamość każdego elementu mimo zmian nazw i przeniesień.
Sprawdzony w Holarch
Ten sam silnik obsługuje każdy projekt SysML v2 w Holarch: edytor, widoki i strony cyklu życia.
Dodatki
Silnik samodzielnie sprawdza, analizuje i edytuje modele. Rozszerzają go trzy dodatki, każdy licencjonowany osobno i włączany tokenem licencji, bez ponownej kompilacji i bez zmian w kodzie.
Symulacja
Uruchamiaj przepływy akcji i maszyny stanów w czasie symulowanym: pojedyncze przebiegi, krok po kroku z danymi wejściowymi z twojego produktu lub badania Monte Carlo. To samo ziarno daje tę samą odpowiedź w przeglądarce i na serwerze. Modele z adnotacjami symulacji są sprawdzane również bez niego.
Migracja z SysML v1 do SysML v2
Konwertuj model SysML v1 na sprawdzony tekst SysML v2, z raportem dla każdego elementu: przekonwertowany, przybliżony lub pominięty. Jak działa dodatek do migracji.
Użycie na serwerze
Uruchamiaj silnik poza stroną w przeglądarce: w Node.js, Deno, funkcjach bezserwerowych lub jako rozszerzenie Pythona. Sprawdzaj modele w potokach kompilacji, konwertuj je wsadowo lub odpowiadaj na żądania z własnej usługi.
Dodatek: migracja z SysML v1 do SysML v2
Dodatek do migracji konwertuje model SysML v1 na tekst SysML v2 na podstawie transformacji SysML v1 do SysML v2 ze specyfikacji OMG SysML 2.0. To konwerter stojący za importem SysML v1 w Holarch, licencjonowany osobno od silnika.
- Dane wejściowe: model SysML v1 jako JSON, w neutralnej postaci udokumentowanej w dokumentacji API. Twój produkt odczytuje plik XMI (z Cameo lub MagicDraw, Enterprise Architect, Rhapsody lub Papyrus) i wysyła model; silnik nie czyta XML ani plików.
- Dane wyjściowe: tekst SysML v2, kontrola tego tekstu przez silnik oraz raport, który wymienia każdy element jako przekonwertowany, przybliżony lub pominięty, ze stałym kodem przyczyny i nazwą SysML v2, którą otrzymał.
- Powtarzalność: ten sam model za każdym razem daje ten sam tekst.
- Ograniczenia: modele do 250 000 elementów i 8 MiB tekstu; większy model otrzymuje odpowiedź z błędem, nigdy nie powoduje zawieszenia.
Żądanie to v1_convert w dokumentacji API. Bez dodatku silnik odpowiada na nie feature-not-licensed, a wszystkie inne żądania działają normalnie.
Żądanie i odpowiedź
// 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" }, … ] } }
Mały model testowy przekonwertowany przez silnik: 31 elementów, bez komunikatów diagnostycznych w przekonwertowanym tekście.
Jak działa
W przeglądarce silnik jest modułem WebAssembly w Web Workerze, więc analiza nigdy nie blokuje strony. Mała warstwa integracyjna w JavaScript wysyła żądania i zwraca odpowiedzi jako obietnice (promises). Kompilacja serwerowa dla Node.js lub Pythona jest dostępna na żądanie.
Żądanie i odpowiedź
// 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" } ] }Prawdziwe żądanie i odpowiedź z przewodnika integracji silnika: jeden błąd składni i jedna nazwa, która się nie rozwiązuje, każde ze stałym kodem i dokładnym zakresem w tekście.
Wydajnościowe
Zmierzone na generowanym modelu o 10 000 wierszy:
- 150 ms na analizę całego modelu o 10 000 wierszy od zera (parsowanie, rozwiązywanie i kontrola); 215 ms jako WebAssembly w Safari.
- Od 1,3 do 6,8 ms na ponowne sprawdzenie modelu o 10 000 wierszy po edycji (95. percentyl); od 3 do 4 ms jako WebAssembly w Safari.
- Baza silnika z załadowaną biblioteką standardową: 17 MiB. Analiza całego modelu dodaje około 29 MiB na 10 000 wierszy, a cała sesja edycji około 33 MiB na 10 000 wierszy.
- Około 0,74 MB WebAssembly po kompresji.
Testowano na generowanych modelach do 250 000 wierszy: wyniki dla każdego rozmiaru.
Twoje wartości zależą od modelu i komputera. Wersja ewaluacyjna pozwala zmierzyć je na własnych modelach.
Bezpieczeństwo
- Brak dostępu do sieci i plików. Moduł WebAssembly niczego nie importuje ze strony: czyta przekazany tekst i rekordy i zwraca JSON.
- Limity danych wejściowych. Rozmiar danych, długość wiersza, zagnieżdżenie i głębokość wyrażeń są ograniczone, więc złośliwy plik nie wyczerpie pamięci ani stosu.
- Testy fuzzingowe. Punkty wejścia żądań, leksera i parsera, symulator i operacje językowe są testowane fuzzingiem.
- Izolacja. W przeglądarce działa we własnym workerze. Błąd zatrzymuje tylko ten worker, a strona uruchamia go ponownie.
Co otrzymujesz
- Silnik: kompilację WebAssembly z biblioteką standardową.
- Warstwę integracyjną JavaScript: worker i klienta dla twojej strony.
- Dokumentację dla programistów: przewodnik integracji, opis każdego żądania z prawdziwymi żądaniami i odpowiedziami, listę kodów diagnostycznych i działające przykłady (minimalna strona, edytor, przeglądarka modelu, Node.js i Python).
- Aktualizacje przez okres obowiązywania licencji.
- Wsparcie e-mailowe od zespołu, który go tworzy.
Licencjonowanie
- Licencja roczna na jeden rok naraz, wyceniana według liczby aktywnych miesięcznie użytkowników funkcji, które silnik obsługuje w twoim produkcie.
- Bezpłatna 60-dniowa wersja ewaluacyjna na twoim komputerze, z dokumentacją i przykładami.
- Licencje akademickie i badawcze dla uczelni i grup badawczych.
- Zastosowania korporacyjne na żądanie: kilka produktów lub duże liczby użytkowników.
- Dodatki: symulacja, migracja z SysML v1 do SysML v2 i użycie na serwerze, każdy licencjonowany osobno.
Opowiedz nam o swoim produkcie i przewidywanej liczbie użytkowników, a prześlemy wycenę.
Obsługa języka
Bieżąca wersja to Holarch Language Engine 2.1.2. Opiera się na specyfikacji OMG SysML v2 i obsługuje podzbiór SysML v2 i KerML. Pokrycie języka SysML v2 wymienia obsługiwane konstrukcje i znane luki, tak jak działają w Holarch. Dokumentacja wersji ewaluacyjnej zawiera tę samą listę dla silnika.
Jak silnik wypada w porównaniu z pilotażową implementacją OMG na oficjalnych przykładowych modelach i jak radzi sobie z uszkodzonym tekstem i dużymi modelami, łącznie z niepowodzeniami: Wyniki testów Language Engine.
Wypróbuj silnik na własnych modelach.
Wersja ewaluacyjna jest bezpłatna przez 60 dni.