SysML v2
Copertura del linguaggio SysML v2
I progetti SysML v2 di Holarch si basano sulla specifica OMG SysML v2 e supportano un sottoinsieme del linguaggio. Questa pagina elenca ogni area della notazione testuale, fino a che punto Holarch la supporta e le lacune note.
Che cosa significano i livelli
- Supportato: l’Editor analizza e controlla il costrutto, il modello lo conserva, e le viste e le pagine che lo usano lo leggono e lo scrivono.
- Parziale: supportato, con i limiti indicati nella riga.
- Conservato, non interpretato: analizzato e conservato esattamente come scritto, nel testo e nelle esportazioni, ma senza alcun significato proprio.
- Non ancora: non disponibile.
Lo stesso motore del linguaggio esegue l’Editor, le viste e i controlli, quindi un costrutto accettato dall’Editor è lo stesso in ogni vista. Vedere anche Holarch Language Engine.
Vai a: Costrutti del linguaggio · File e scambio · Controlli · Lacune note
Costrutti del linguaggio
| Area | Livello | Costrutti | Limiti |
|---|---|---|---|
| Package e namespace | Supportato | package, package annidati, library package, doc, comment … about, note // e //* */, alias … for …, public, private e protected, nomi brevi <'1.2'>, nomi tra apici. | I package di libreria, compresa la libreria standard, sono di sola lettura. |
| Import | Supportato | Import di membri e di namespace, ::*, ricorsivi ::**, import con visibilità, import filtrati [@Kind]. | I filtri di import selezionano per metaclasse. |
| Definizioni e usi | Supportato | part, attribute, item, port, connection, interface, flow, action, state, requirement, constraint, calc, use case, analysis, verification, view, viewpoint, concern, enum, occurrence, allocation, metadata; ref, abstract, in, out, inout ed end. | Nessuno noto. |
| Specializzazione, tipizzazione e ridefinizione | Supportato | Specializzazione :> e specializes, tipizzazione : e defined by, subsetting :> e subsets, ridefinizione :>> e redefines, coniugazione ~, disjoint, catene di feature a.b.c. | Nessuno noto. |
| Molteplicità | Supportato | [n], [n..m], [*], [0..*], ordered, nonunique, espressioni come limiti. | Nessuno noto. |
| Valori e unità | Supportato | =, :=, default, grandezze come 5 [kg], espressioni di unità come [m/s^2], i tipi di grandezza ISQ e le unità SI e consuetudinarie statunitensi della libreria standard, controlli dimensionali. | Nessuno noto. |
| Vincoli e calcoli | Supportato | Definizioni e usi di constraint e calc, return, assert constraint, chiamate, espressioni KerML con operazioni aritmetiche, di confronto, logiche, if ? else e sulle sequenze, valutazione con unità. | Nessuno noto. |
| Struttura | Supportato | Porte e porte coniugate, connect, interfacce con estremità, estremità di connessione con nome e con molteplicità (connect [1] driver ::> a to [1] driven ::> b), binding connector bind, item flow flow of T from … to …, message. | Nessuna nota. Le direzioni di porte, flussi e message vengono controllate. Le viste di interconnessione etichettano le estremità con nome con la loro molteplicità, e l’ispettore le modifica. |
| Azioni | Parziale | Parametri, perform, successioni first … then … e then, fork, join, decide, merge, guardie, accept, send, assign, if, while, for, loop, start, done, terminate. | Il Simulatore esegue i flussi di azioni, comprese le esecuzioni Monte Carlo, con durate, probabilità dei rami e numero di iterazioni dei cicli presi dal modello. |
| Stati | Parziale | Azioni entry, do ed exit, transizioni con trigger, guardia ed effetto (modificate nella Vista di transizione di stato e nell’ispettore, e mostrate sotto la transizione nel Browser), stati parallel, stati annidati, exhibit. | Il Simulatore esegue le macchine a stati con il motore SysML, con stimoli, ed evidenzia gli stati attivi durante l’esecuzione. Ogni tipo di effetto do viene controllato, il payload di un trigger viene controllato rispetto alla sua porta, e altre parti del modello possono nominare il trigger e l’effetto di una transizione (plugIn.effect.sentMessage). |
| Requisiti | Supportato | subject, actor, stakeholder, require constraint, assume constraint, frame concern, satisfy … by …, verify, nomi brevi come id dei requisiti, doc come testo del requisito. | Nessuno noto. |
| Casi d’uso | Supportato | Definizioni e usi di casi d’uso, subject, actor, objective, include use case. | Nessuno noto. |
| Casi di analisi e di verifica | Parziale | Casi di analisi con un soggetto, un obiettivo e un risultato return; casi di verifica con verify e un verdetto. | Un caso di analisi viene valutato solo quando ogni input ha un valore. Le analisi di trade-off della libreria standard non vengono valutate; la pagina Studi di trade-off di Holarch assegna invece un punteggio alle alternative con valori presi dal modello. |
| Viste | Parziale | view, view def, expose con ::*, ::** e filtri, filter, viewpoint, frame, render, le definizioni di vista standard. | Le viste di sequenza disegnano i messaggi tra le linee di vita, e i messaggi all’interno di if/else, cicli, fork e decisioni come frammenti alt, opt, loop e par con le loro guardie. |
| Allocazione e dipendenze | Supportato | allocate a to b, definizioni di allocazione, dependency from … to …. | Nessuno noto. |
| Metadati | Parziale | @Name { … }, il prefisso #Name, metadata Name about …, metadata def definite dall’utente, i package di metadati di Holarch per i valori TBD e TBR e per i concetti DoDAF e UAF, parole chiave definite dall’utente (#safetyCritical part controller), metadati semantici (#fault def BatteryOverheat;) e metadati con un significato proprio: valori obbligatori, valori del tipo dichiarato e vincoli della definizione vengono controllati a ogni uso. | I vincoli di una definizione di metadati leggono i propri valori, non l’elemento annotato. I metadati scritti con about non aggiungono alcun tipo base. |
| Variabilità | Supportato | Definizioni e usi di variation, membri variant e riferimenti a varianti (variant plugInHybrid;), scelte per valore (part :>> pack = BatteryPack::largePack;), configurazioni marcate @HolarchConfiguration. Controllati e valutati: una variante ha le feature della sua variation, una scelta deve essere una delle varianti del punto, e un punto senza scelta ha un valore sconosciuto, quindi un’asserzione su di esso non è né soddisfatta né violata. | Le configurazioni si scrivono nel testo; Holarch non cerca ancora combinazioni valide nelle sue pagine. |
| Individui e time slice | Supportato | Definizioni e usi di individual (individual part def Car_VIN1234 :> Car), snapshot e timeslice (anche dopo then), i loro valori e le successioni. Controllati e valutati: uno snapshot o un time slice ha le feature dell’occorrenza a cui appartiene, e i suoi valori vengono letti per primi. Il campo Occorrenza dell’ispettore, il filtro Individui del Browser e Nuovo snapshot…/Nuovo time slice…, e le viste generali con «individual», «snapshot» e «timeslice» e Disponi come cronologia. | Solo le occorrenze possono essere individui, snapshot o time slice. |
| Rappresentazioni testuali | Parziale | rep language "…" /* … */; i corpi in SysML e KerML vengono controllati ed evidenziati come codice, e un corpo di vincolo SysML viene valutato. L’ispettore aggiunge e modifica le rappresentazioni, e le Action Flow View contrassegnano un’azione che ne ha una con il suo linguaggio, ad esempio {Python}. | I corpi in altri linguaggi, come Python, OCL o MATLAB, vengono conservati come testo e mai eseguiti. Un corpo non può contenere */. |
| KerML | Parziale | Testo KerML della libreria standard: le librerie del kernel vengono lette in KerML. I corpi KerML delle rappresentazioni testuali vengono controllati. | I file .kerml non vengono importati nei progetti, e i modelli scritti in KerML non vengono controllati. |
| Estensioni del linguaggio | Parziale | Parole chiave definite dall’utente da metadati semantici: #fault def BatteryOverheat; specializza il tipo base dei metadati, quindi ha le feature del tipo base; metadati che limitano ciò che annotano (annotatedElement). | Il tipo base viene letto come nome (faults meta SysML::Usage). Altre estensioni del linguaggio non sono disponibili, e la libreria standard non può essere modificata. |
File e scambio
| Formato | Livello | Cosa copre | Limiti |
|---|---|---|---|
| Testo SysML v2 (.sysml) | Supportato | Importazione ed esportazione, anche come .zip di file, con un’anteprima prima che un’importazione venga applicata. | Gli id degli elementi vengono mantenuti quando all’esportazione è spuntato Includi id degli elementi; senza di essi, una reimportazione abbina gli elementi per nome. |
| JSON SysML v2 | Parziale | Importazione ed esportazione del formato degli elementi della Systems Modeling API, con gli id degli elementi mantenuti. | I tipi di elemento che Holarch non interpreta vengono conservati come importati e riscritti invariati all’esportazione; non hanno testo e non si possono modificare. |
| Modelli SysML v1 (XMI, .mdzip) | Parziale | Importazione in un progetto SysML v2 da Cameo o MagicDraw (.mdzip o XMI), Enterprise Architect, Rhapsody e Papyrus (XMI, .uml, .xml). Il modello viene convertito in testo SysML v2 e controllato, e un report di conversione elenca ogni elemento come convertito, approssimato od omesso, con il motivo, anche come CSV. L’importazione è un unico passo di annullamento. | Solo importazione. Gli elementi senza controparte SysML v2, come flow final node, activity partition, estensioni dei casi d’uso e instance specification, vengono omessi; i diagrammi e il loro layout non vengono convertiti. Un file di al massimo 64 MB e 250.000 elementi; i file di progetto di Enterprise Architect (.eap, .qea) non vengono letti. |
| Repository di modelli | Supportato | Pull da e push verso un ramo di un repository che offre la Systems Modeling API. | Un ramo per progetto. |
| Systems Modeling API in Holarch | Parziale | Altri strumenti SysML v2 leggono il modello corrente di un progetto ed eseguono commit nei rami delle richieste di modifica. | main è di sola lettura: i commit vanno nelle richieste di modifica che un approvatore applica in Holarch. |
| File KerML (.kerml) | Non ancora | Non importati; l’importazione li salta. | Usare file .sysml. |
I limiti di dimensione e tutti gli altri formati sono elencati in Importazione ed esportazione.
Controlli
L’Editor controlla il testo durante la digitazione e segnala ogni problema sul posto. I controlli riguardano:
- Sintassi: caratteri, commenti, stringhe, parentesi graffe,
;, nomi e token attesi. - Nomi: nomi non risolti, ambigui, duplicati e privati.
- Tipizzazione e specializzazione: cicli, il tipo giusto di definizione, subsetting e ridefinizione delle feature ereditate.
- Molteplicità e unità: limiti validi, dimensioni corrispondenti, unità mancanti o sconosciute.
- Espressioni: tipi degli operandi, argomenti dei calcoli e condizioni booleane.
- Struttura, azioni e stati: estremità delle connessioni, direzioni di porte, flussi e
message, destinazioni delle successioni, nodi di controllo, i valori su cui itera un ciclofor, transizioni iniziali, regioni parallele, trigger delle transizioni (payload attraverso le porte, tempiat) ed effettido(compresa la destinazione di unsend). - Parole chiave definite dall’utente:
#Namenomina metadati, i metadati marcano solo i tipi che consentono, e un tipo base semantico è una definizione o un uso adatto all’elemento che marca. - Valori dei metadati: ogni uso di una definizione di metadati fornisce i valori obbligatori, ogni valore è conforme al tipo della sua feature, e i vincoli della definizione sono rispettati.
- Variabilità: le variation possiedono solo varianti del loro tipo, una scelta è una variante del suo punto, e i punti aperti di una configurazione vengono segnalati.
- Requisiti, casi e viste: membri nel posto giusto, destinazioni di
satisfy,verify,exposeeframe. - Rappresentazioni testuali: i corpi SysML e KerML vengono analizzati e dichiarano l’elemento che rappresentano; un linguaggio che Holarch non conosce viene segnalato.
- Valutazione: vincoli, requisiti e obiettivi che non sono rispettati con i valori correnti.
Ogni controllo con un messaggio di esempio: Controlli.
Lacune note
- Nessun risolutore per i casi di analisi. Un caso di analisi viene valutato quando ogni input ha un valore. In una Vista parametrica, Risolvi trova una sola incognita per vincolo.
- Nessuna ricerca di varianti nelle pagine. Variation, varianti e configurazioni vengono controllate e valutate; le pagine di Holarch non elencano ancora ogni combinazione valida.
- Nessun file KerML. KerML viene letto solo per la libreria standard.
- Le estensioni del linguaggio sono limitate alle parole chiave definite dall’utente e ai metadati. I metadati semantici applicano il loro tipo base; gli altri metadati significano ciò che la loro definizione stabilisce (valori obbligatori, tipi dei valori e vincoli), e la libreria standard è di sola lettura.
- Le rappresentazioni testuali in linguaggi diversi da SysML e KerML vengono conservate come testo; Holarch non le esegue mai.
- Systems Modeling API: nessun commit su main, tag o merge. Gli altri strumenti eseguono commit nei rami delle richieste di modifica; un approvatore li applica in Holarch.
Holarch implementa il sottoinsieme della specifica elencato in questa pagina. Novità elenca ogni modifica.