Per gli sviluppatori
Holarch Language Engine
Un motore del linguaggio per SysML v2 e KerML, disponibile in licenza.
Il motore alla base dei progetti SysML v2 di Holarch, per il proprio prodotto. Analizza, risolve, controlla e valuta testo SysML v2 e KerML, e funziona nel browser come WebAssembly o sul proprio server.

A chi si rivolge
Ai team che vogliono il testo SysML v2 nel proprio prodotto senza scrivere e mantenere un’implementazione del linguaggio.
Fornitori di strumenti
Aggiungere modifica, controllo e importazione SysML v2 a uno strumento di modellazione, di diagrammi o di architettura.
Prodotti PLM, per i requisiti e per la simulazione
Leggere modelli SysML v2, seguire requisiti e valori con unità, e scambiare modelli con altri strumenti.
Team interni per gli strumenti di ingegneria
Controllare i modelli nelle pipeline di revisione, generare report e offrire agli ingegneri un editor SysML v2 all’interno degli strumenti aziendali.
Che cosa fa
Un unico motore per l’intero percorso dal testo a un modello controllato, con JSON in ingresso e JSON in uscita.
Analisi sintattica
Notazione testuale SysML v2 e KerML, con recupero dagli errori: un errore non nasconde il resto del file. La libreria standard viene caricata con il motore.
Risoluzione
Nomi, import, alias, specializzazione, tipizzazione e ridefinizione tra package e file, con hover, vai alla definizione, completamento e ridenominazione.
Controllo
135 codici di diagnostica, ciascuno con una gravità, un intervallo esatto, un messaggio e una correzione suggerita che il proprio editor può offrire come correzione rapida.
Valutazione
Espressioni con unità e grandezze, come da body + 4 * 12 [kg] a 348 [kg], e vincoli dei requisiti e verification case. Le soglie dei requisiti e gli obiettivi a cui mirano vengono letti dal modello.
Rianalisi durante la digitazione
Le sessioni di documento rianalizzano solo la parte modificata e inviano delta dei token, così gli editor restano reattivi su modelli grandi.
Modificare il testo senza perdere la formattazione
Le modifiche da un diagramma o da un modulo vengono riscritte nel testo. Il testo invariato, i commenti e l’impaginazione restano esattamente come li ha scritti l’utente.
Diff, merge e rebase
Confrontare due versioni di un modello come elenco di modifiche, applicarle ed eseguire il rebase di una modifica al testo su modifiche al modello più recenti.
Varianti
Punti di variazione, varianti e configurazioni vengono controllati, e ogni combinazione di varianti può essere elencata e valutata rispetto ai vincoli del modello.
Simulazione (componente aggiuntivo)
Eseguire flussi di azioni e macchine a stati nel tempo simulato, come singole esecuzioni, passo per passo con input dal proprio prodotto, o come studi Monte Carlo. Lo stesso seed dà la stessa risposta nel browser e sul server.
Interscambio JSON
Importare ed esportare SysML v2 JSON, e leggere il modello come semplici record con id stabili. Il testo può contenere l’id di ogni elemento, così un testo modificato e riletto mantiene l’identità di ogni elemento attraverso ridenominazioni e spostamenti.
Collaudato in Holarch
Lo stesso motore esegue ogni progetto SysML v2 in Holarch: l’editor, le viste e le pagine del ciclo di vita.
Componenti aggiuntivi
Il motore controlla, analizza e modifica i modelli da solo. Tre componenti aggiuntivi lo estendono, ciascuno in licenza separata e attivato dal proprio token di licenza, senza ricompilazione né modifiche al codice.
Simulazione
Eseguire flussi di azioni e macchine a stati nel tempo simulato: singole esecuzioni, passo per passo con input dal proprio prodotto, o studi Monte Carlo. Lo stesso seed dà la stessa risposta nel browser e sul server. I modelli con annotazioni di simulazione vengono controllati anche senza di esso.
Migrazione da SysML v1 a SysML v2
Convertire un modello SysML v1 in testo SysML v2 controllato, con un rapporto su ogni elemento: convertito, approssimato o eliminato. Come funziona il componente aggiuntivo di migrazione.
Uso su server
Eseguire il motore al di fuori di una pagina del browser: Node.js, Deno, funzioni serverless o l’estensione Python. Controllare i modelli nelle pipeline di build, convertirli in batch o rispondere alle richieste del proprio servizio.
Componente aggiuntivo: migrazione da SysML v1 a SysML v2
Il componente aggiuntivo di migrazione converte un modello SysML v1 in testo SysML v2, sulla base della trasformazione da SysML v1 a SysML v2 della specifica OMG SysML 2.0. È il convertitore alla base dell’importazione SysML v1 di Holarch, in licenza separata dal motore.
- Input: un modello SysML v1 come JSON, in una forma neutra documentata nel riferimento API. Il proprio prodotto legge il file XMI (da Cameo o MagicDraw, Enterprise Architect, Rhapsody o Papyrus) e invia il modello; il motore non legge XML né file.
- Output: testo SysML v2, il controllo di quel testo da parte del motore e un rapporto che elenca ogni elemento come convertito, approssimato o eliminato, con un codice di motivazione stabile e il nome SysML v2 che è diventato.
- Ripetibile: lo stesso modello viene convertito ogni volta nello stesso testo.
- Limitato: modelli fino a 250.000 elementi e 8 MiB di testo; un modello più grande riceve una risposta di errore, mai un blocco.
La richiesta è v1_convert nel riferimento API. Senza il componente aggiuntivo, il motore risponde con feature-not-licensed e ogni altra richiesta funziona come al solito.
Una richiesta e la sua risposta
// 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" }, … ] } }
Un piccolo modello di test convertito dal motore: 31 elementi, nessuna diagnostica nel testo convertito.
Come viene eseguito
Nel browser, il motore è un modulo WebAssembly in un Web Worker, quindi l’analisi non blocca mai la pagina. Un piccolo livello di integrazione JavaScript invia le richieste e restituisce le risposte come promise. Una build server per Node.js o Python è disponibile su richiesta.
Una richiesta e la sua risposta
// 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" } ] }Una richiesta e una risposta reali dalla guida all’integrazione del motore: un errore di sintassi e un nome che non si risolve, ciascuno con un codice stabile e l’intervallo esatto nel testo.
Prestazione
Misurato su un modello generato di 10.000 righe:
- 150 ms per analizzare da zero l’intero modello di 10.000 righe (analisi sintattica, risoluzione e controllo); 215 ms come WebAssembly in Safari.
- Da 1,3 a 6,8 ms per ricontrollare il modello di 10.000 righe dopo una modifica (95° percentile); da 3 a 4 ms come WebAssembly in Safari.
- Base del motore, con la libreria standard caricata: 17 MiB. Un’analisi dell’intero modello aggiunge circa 29 MiB ogni 10.000 righe, e un’intera sessione di modifica circa 33 MiB ogni 10.000 righe.
- Circa 0,74 MB di WebAssembly, compresso.
Testato con modelli generati fino a 250.000 righe: risultati a ogni dimensione.
I propri numeri dipendono dal modello e dal computer. La valutazione permette di misurare sui propri modelli.
Sicurezza
- Nessun accesso alla rete o ai file. Il modulo WebAssembly non importa nulla dalla pagina: legge il testo e i record che gli vengono passati e restituisce JSON.
- Limiti dell’input. Dimensione dell’input, lunghezza delle righe, annidamento e profondità delle espressioni sono limitati, quindi un file ostile non può esaurire la memoria o lo stack.
- Sottoposto a fuzzing. I punti di ingresso di richieste, lexer e parser, il simulatore e le operazioni del linguaggio vengono sottoposti a fuzz testing.
- Isolato. Nel browser viene eseguito nel proprio worker. Un errore arresta solo quel worker, e la pagina lo riavvia.
Che cosa si ottiene
- Il motore: la build WebAssembly, con la libreria standard.
- Il livello di integrazione JavaScript: il worker e un client per la propria pagina.
- Documentazione per sviluppatori: una guida all’integrazione, il riferimento di ogni richiesta con richieste e risposte reali, l’elenco dei codici di diagnostica ed esempi eseguibili (una pagina minima, un editor, un browser di modelli, Node.js e Python).
- Aggiornamenti per la durata della licenza.
- Supporto via e-mail dal team che lo sviluppa.
Licenze
- Licenza annuale per un anno alla volta, con prezzo in base al numero di utenti attivi mensili delle funzionalità che il motore alimenta nel proprio prodotto.
- Valutazione gratuita di 60 giorni sul proprio computer, con la documentazione e gli esempi.
- Licenze accademiche e di ricerca per università e gruppi di ricerca.
- Uso Enterprise su richiesta: più prodotti o un numero elevato di utenti.
- Componenti aggiuntivi: simulazione, migrazione da SysML v1 a SysML v2 e uso su server, ciascuno in licenza separata.
Descriveteci il vostro prodotto e gli utenti previsti, e vi invieremo un preventivo.
Supporto del linguaggio
La versione attuale è Holarch Language Engine 2.1.2. Si basa sulla specifica OMG SysML v2 e supporta un sottoinsieme di SysML v2 e KerML. Copertura del linguaggio SysML v2 elenca i costrutti supportati e le lacune note, così come funzionano in Holarch. La documentazione della valutazione include lo stesso elenco per il motore.
Come il motore si confronta con l’implementazione pilota dell’OMG sui modelli di esempio ufficiali, e come si comporta su testo danneggiato e modelli grandi, fallimenti compresi: Risultati dei test del Language Engine.
Provare il motore sui propri modelli.
La valutazione è gratuita per 60 giorni.