SysML v2
Primi passi con i progetti SysML v2
Scegliere tra un progetto LML e uno SysML v2, creare un progetto SysML v2 o una demo, scrivere un primo modello e orientarsi.
In questa pagina
Panoramica
Holarch supporta i progetti SysML v2. Un progetto SysML v2 contiene un modello, scritto nella notazione testuale SysML v2 e basato sulla specifica OMG SysML v2.
Il modello si scrive come testo nell'Editor. Holarch conserva lo stesso modello come elementi: package, definizioni, usi e relazioni. Il Browser, le viste e le pagine del ciclo di vita (requisiti, verifica, interfacce, rischio, pianificazione) mostrano tutti quegli stessi elementi.
Questa pagina spiega i due tipi di progetto, come avviare un progetto SysML v2 e dove si trovano le cose. Il linguaggio stesso è descritto in Notazione testuale SysML v2. L'Editor e il Browser sono descritti in L'Editor di testo e il Browser.
Concetti
Due tipi di progetto
Ogni progetto Holarch è un progetto LML o un progetto SysML v2. Il tipo si sceglie alla creazione del progetto. Resta fisso: un progetto cambia tipo solo tramite una copia convertita (vedere Conversione tra LML e SysML v2).
| LML | SysML v2 | |
|---|---|---|
| A cosa serve | Modellare un sistema nel Lifecycle Modeling Language: requisiti, funzioni, architettura fisica, interfacce, test, rischi e pianificazione temporale. Holarch controlla il lavoro a ogni passaggio. | Costruire un modello nel linguaggio SysML v2, come testo, con i concetti standard di SysML v2: package, definizioni e usi, porte, connessioni, azioni, stati e requisiti. |
| Come si costruisce il modello | Il Database, i moduli e più di 30 tipi di diagramma. | Testo nell'Editor, più le viste e le pagine del ciclo di vita, che scrivono nello stesso testo. |
| Cosa si può scambiare | Importazioni da Word, Excel, CSV, ReqIF e XMI; esportazioni in Word, Excel e di diagrammi; file di progetto. | Testo SysML v2 (.sysml) e SysML v2 JSON (vedere Scambio di modelli SysML v2); importazioni SysML v1 da XMI e da file .mdzip di Cameo o MagicDraw (vedere Importazione di modelli SysML v1); file di progetto. |
In caso di dubbio, scegliere LML. Ha ogni pagina e diagramma di Holarch ed è adatto a chi è nuovo all'MBSE. Scegliere SysML v2 quando il team modella già in SysML v2 o scambia modelli con strumenti SysML v2.
Il modello e il testo sono una cosa sola
Un progetto SysML v2 non contiene file. Il modello è un insieme di elementi, e l'Editor mostra un documento di testo per ogni package di primo livello. Quando il testo viene analizzato correttamente, Holarch lo applica al modello. Quando si modifica il modello altrove (una vista, una tabella, l'ispettore), il testo cambia di conseguenza. Vedere Testo e viste restano sincronizzati.
Dati del modello e dati di Holarch
Alcune informazioni fanno parte del testo SysML; altre sono conservate da Holarch accanto al modello.
- Nel testo: nomi degli elementi, nomi brevi (numeri dei requisiti), documentazione, tipi, molteplicità, valori e relazioni come
satisfy,verify,performeconnect. - Accanto al modello (dati di Holarch): stato e approvazioni dei requisiti, risultati della verifica, etichette, assegnatari, scadenze, commenti delle discussioni, layout delle viste, impostazioni del simulatore, budget, rischi, decisioni e attività. Sono collegati agli elementi del modello tramite l'identità, quindi i collegamenti sopravvivono a rinomine e spostamenti.
I dati di Holarch non vengono scritti nel testo SysML e non fanno parte di un'esportazione .sysml.
Definizioni e usi
La maggior parte delle parole chiave SysML v2 ha due forme. Una definizione (part def Wheel;) descrive un tipo di cosa. Un uso (part frontWheel : Wheel;) è un impiego di una definizione all'interno di un altro elemento. Lo stesso schema vale per port def/port, action def/action e requirement def/requirement. Notazione testuale SysML v2 lo spiega per intero.
Come usarlo
Scegliere un tipo di progetto
Decidere il tipo prima di creare il progetto.
- Scegliere LML per usare il metodo Holarch completo: il Database, i diagrammi LML e i controlli guidati a ogni passaggio.
- Scegliere SysML v2 quando il modello deve essere testo SysML v2, per esempio per scambiarlo con un altro strumento SysML v2.
- Per provare prima SysML v2, aprire la demo Hybrid Car (la procedura dopo la prossima) al posto di un progetto vuoto.
Creare un progetto SysML v2
- Aprire Gestisci progetti e fare clic su + Nuovo progetto.
- In Come modellare questo sistema?, scegliere SysML v2.
- Inserire un nome e fare clic su Crea progetto.
Il progetto si apre in Home. Il chip SysML v2 compare accanto al nome del progetto nella barra superiore e in Gestisci progetti. Un nuovo modello è vuoto: Prossime azioni in Home riporta Scrivere il primo package nell'editor.
Aprire la demo Hybrid Car
La demo Hybrid Car è un modello SysML v2 completo da esplorare e modificare.
- Aprire Gestisci progetti.
- Fare clic su File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2).
Holarch crea il progetto Hybrid Car (SysML v2 demo) e lo apre in Home. Fare clic su Editor nella barra di navigazione per leggere il testo. Il modello ha sei package di primo livello: Vehicles, VehicleRequirements, VehicleBehavior, VehicleViews, HolarchFrameworks e HybridCarArchitecture. Ognuno è un documento nell'elenco Pacchetti dell'Editor.
La demo è una propria copia. Modificarla liberamente, oppure crearla di nuovo per ripartire da zero.
Per aprire la demo da un link, usare https://app.holarch.app/#/?demo=hybrid. Costruisce la demo e la apre; nell'app ospitata si apre dopo l'accesso.
Aprire la demo Hybrid Car Battery Pack
La demo Hybrid Car Battery Pack è il pacco batteria di trazione dell'auto come lo modella il suo fornitore, in un progetto a sé. Se anche la demo Hybrid Car è tra i propri progetti, creata prima o dopo, tre requisiti del pacco sono collegati ai requisiti della batteria dell'auto (BP-1 a VR-3, BP-2 a VR-6, BP-3 a VR-5), così Gestisci progetti → Mappa del programma mostra come i due progetti sono collegati. Questi collegamenti delle demo funzionano in ogni piano.
- Aprire Gestisci progetti.
- Fare clic su File di progetto ▾ → Nuovo progetto demo → Hybrid Car Battery Pack (SysML v2).
Cose da provare:
- Valori calcolati: nell'Editor,
Pack::masssomma i moduli (12 celle e un alloggiamento ciascuno), il sistema di gestione della batteria, la scatola di giunzione, il raffreddamento e l'involucro: 43 kg rispetto al limite di 48 kg, quindimassMarginè 5 kg.Pack::capacitysomma le 120 celle: 1,44 kWh rispetto a 1,4 kWh. Selezionare un attributo per vederne il valore nell'ispettore. - Vista parametrica: aprire packParametrics. I controlli di capacità, massa, tempo di ricarica e bilanciamento delle celle sono ciascuno vincolati ai valori del pacco e risultano superati.
- RVTM: capacità e massa sono Passed, l'accettazione della carica è Failed (il test di ricarica a caldo ha richiesto 34 minuti rispetto a 30) e il bilanciamento delle celle non è ancora stato eseguito. Ogni caso di verifica calcola il proprio esito dal modello.
- Simulatore: il Simulatore si apre su pack insieme a Hot Day Charge. Fare clic su Esegui fino alla fine, poi su Stati: la ricarica si riduce a metà potenza quando le celle si surriscaldano e riprende quando si raffreddano. Scegliere Cell Over Voltage Fault in Esegui insieme a per vedere uno spegnimento di protezione e il ripristino di servizio.
Aprire la demo Earth Observation Satellite
La demo Earth Observation Satellite è un modello più grande: la missione EO-2, un satellite per immagini 12U con il suo segmento di terra, in circa 3.000 righe su 14 package. I dati propri di Holarch sono compilati sopra il modello, quindi ogni pagina ha qualcosa da mostrare.
- Aprire Gestisci progetti.
- Fare clic su File di progetto ▾ → Nuovo progetto demo → Satellite di osservazione della Terra (SysML v2).
Holarch crea il progetto Earth Observation Satellite (SysML v2 demo) e apre la Home. La demo ha 1.549 elementi, più dei 1.000 elementi per progetto del piano Free: nel piano Free la sua voce di menu è disattivata e riporta Needs the Individual plan (1,549 items). Anche il link https://app.holarch.app/#/?demo=eosat la costruisce. Cose da provare:
- Documenti: aprire EO-2 System Requirements Specification. Le sue sezioni contengono i requisiti di EORequirements, valori aggiornati e una matrice di verifica.
- Budget: la massa dell'imager supera la sua allocazione di 4,0 kg; il TPM Imager Mass mostra l'andamento.
- Collegamenti da rivedere e TBD/TBR: requisiti modificati e valori aperti da risolvere.
- Simulatore: eseguire il passaggio di acquisizione delle immagini dalla vista imagingPassFlow.
- Baseline: confrontare la baseline PDR Data Freeze con il modello attuale.
- Viste: le modalità del veicolo spaziale, le viste di interconnessione e la sequenza di pianificazione delle attività.
Scrivere il primo modello
Questa procedura costruisce un piccolo modello di drone con questo testo:
package Drone {
private import ISQ::*;
private import SI::*;
part def Battery {
attribute mass : MassValue = 0.4 [kg];
}
part def Quadcopter {
part battery : Battery;
}
}
- Aprire Modello → Editor, fare clic su + Nuovo package, inserire
Dronee confermare. L'Editor apre il testo del nuovo package. - Digitare le importazioni e i membri tra le parentesi graffe del package, come sopra.
- Smettere di digitare. Dopo una breve pausa la riga di stato sotto il testo riporta Applicato. Il modello contiene ora il package, entrambe le definizioni di parte, l'attributo e la parte, e un solo annullamento revoca tutto.
- Aprire Modello → Browser ed espandere Drone per vedere gli stessi elementi come albero.
Se una riga contiene un errore, la riga di stato riporta Non applicato: correggere la riga N. Il modello mantiene il suo ultimo stato valido finché il testo non viene di nuovo analizzato correttamente. Vedere Errori e bozze.
Orientarsi
I progetti SysML v2 mantengono la barra del ciclo di vita di Holarch. Ogni gruppo lavora sul modello SysML v2.
- Iniziare da Home per ciò che richiede attenzione, i gruppi del ciclo di vita e le prossime azioni.
- Usare Modello → Editor per scrivere il testo e Modello → Browser per vedere l'albero.
- Usare Esigenze e requisiti e Verifica per requisiti, casi di verifica e tracciabilità.
- Usare Comportamento, Architettura e Interfacce per le viste e le pagine di analisi.
- Aprire lo strumento Diagrammi in fondo alla barra di navigazione per vedere ogni vista.
- Premere ⌘K / Ctrl+K per trovare qualsiasi elemento per nome, nome breve, nome qualificato (
Vehicles::Car) o testo della documentazione. - Nuovi a SysML v2? Attivare la modalità semplice per vedere prima gli elementi più usati.
Esempio svolto: esplorare la Hybrid Car
Questa procedura guidata usa la demo Hybrid Car.
- Creare la demo (vedere Aprire la demo Hybrid Car). Si apre in Home. Aprire Modello → Editor e scegliere Vehicles nell'elenco Pacchetti.
- Trovare
part def Car. Ha le partibody,powertrain,frontAxle,rearAxleespare : Wheel [0..1]. - Fare ⌘ / Ctrl-clic su
Powertraininpart powertrain : Powertrain;. Il cursore passa apart def Powertrain, con le sue partitank,engine,motor,battery,transmissionecontroller, e interfacce comeinterface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;. - Puntare
MassValueinattribute mass : MassValue;. Una scheda mostra il suo tipo e il nome qualificato dalla libreria standard. - Aprire Modello → Browser. Digitare
sedanin Filtra per nome. L'albero mostrasedansottofleetin Vehicles. Selezionarlo: l'ispettore mostra Tipo part, Typed by Car e il nome qualificatoVehicles::fleet::sedan. - Aprire Home. La scheda Ciclo di vita di Esigenze e requisiti conta i requisiti del modello; Richiede attenzione mostra i collegamenti da rivedere, i TBD in ritardo e i rischi elevati del modello.
- Aprire Esigenze e requisiti → Requisiti. Le righe includono
VR-1.1sedanMass, un uso di requisito il cui numero è il suo nome breve<'VR-1.1'>. - Aprire lo strumento Diagrammi e aprire driveCycleFlow, la vista action flow di
DriveCycle. Rinominare lì un'azione e tornare all'Editor: VehicleBehavior mostra il nuovo nome.
Suggerimenti ed errori comuni
- Partire dalla demo. Copiare gli schemi dal testo della Hybrid Car è il modo più rapido per imparare la notazione.
- Importare le unità.
5 [kg]richiede cheSIsia visibile (eMassValuerichiedeISQ). Aggiungereprivate import ISQ::*;eprivate import SI::*;al package. - Mantenere un modello per progetto. Dividere un modello grande in più package di primo livello; ognuno è un documento a sé nell'Editor.
- Scegliere il tipo sbagliato. Il tipo non può essere cambiato sul posto. Creare una copia convertita da Gestisci progetti (⋯ → Crea una copia LML… o Crea una copia SysML v2…).
- Aspettarsi lo stato nel testo. Stato dei requisiti, risultati della verifica ed etichette sono dati di Holarch. Non compaiono nel testo né in un'esportazione
.sysml.
La barra di navigazione nei progetti SysML v2
| Gruppo | Pagine |
|---|---|
| Home | Richiede attenzione, Ciclo di vita, Prossime azioni e gli altri pannelli della Home |
| Esigenze e requisiti | Documenti, Requisiti, Qualità, TBD/TBR, Collegamenti da rivedere, Approvazioni, Matrice di conformità* |
| Modello | Editor, Browser, Importazione ed esportazione |
| Comportamento | Analisi funzionale, Flussi di azioni, FFBD, Macchine a stati, Sequenze, Simulatore |
| Architettura | Parti, Viste generali, Viste di interconnessione, Gerarchia, Budget e TPM |
| Interfacce | Registro delle interfacce, ICD, Diagrammi N², Elementi e I/O |
| Verifica | RVTM, Casi di verifica, Deroghe e concessioni*, Matrice di tracciabilità, Copertura del programma, Controlli del modello |
| Sicurezza e affidabilità† | Registro dei pericoli, FMECA, Alberi dei guasti, Diagrammi a blocchi di affidabilità |
| Rischi, problemi e decisioni | Registro dei rischi, Diagrammi di Risk, Studi di trade-off, Decisioni, Problemi e azioni |
| Piano | Il mio lavoro, Processo SE, Gestione del progetto, Grafici, Lavagne, Presentazioni |
| Controllo e revisioni | Richieste di modifica, Baseline e versioni, Librerie, Revisioni, Attività |
| Framework | DoDAF, UAF |
* Con il programma formale attivo. † Con il programma Sicurezza e affidabilità attivo. Entrambi si attivano in Preferenze del progetto → Funzionalità di programma.
Gli strumenti in fondo alla barra sono gli stessi dei progetti LML: Database, Diagrammi, Cestino, Impostazioni e Guida. Nei progetti SysML v2, Impostazioni elenca anche la Libreria standard. Le pagine che non si applicano ai progetti SysML v2 non vengono mostrate.
Le pagine sono descritte in Viste SysML v2, Requisiti e verifica nei progetti SysML v2, Valutazione, unità e analisi nei progetti SysML v2 e Funzionalità di Holarch nei progetti SysML v2.
Modalità semplice
La modalità semplice è pensata per chi è alle prime armi con SysML v2. Mostra gli elementi da cui parte la maggior parte dei modelli, spiega ciascuno in una frase e nasconde il resto finché non lo si richiede. Cambia solo ciò che si vede: il modello, il suo testo e ogni esportazione restano invariati.
Attivarla o disattivarla
- Preferenze → SysML v2 → Modalità semplice.
- Modalità semplice nell'intestazione della pagina Modello → Browser (premuto quando è attiva).
- ⌘K / Ctrl+K → Attiva modalità semplice o Disattiva modalità semplice.
È disattivata per impostazione predefinita. L'impostazione appartiene all'account: segue l'utente su qualsiasi computer da cui accede, e all'accesso si applica l'impostazione dell'account. Reimposta preferenze non la modifica.
La prima volta che si apre un progetto SysML v2, una nota sotto la barra superiore riporta Nuovi a SysML v2? Attivare la modalità semplice per vedere prima gli elementi più usati. Fare clic su Attiva per attivare la modalità semplice, oppure su × per chiudere la nota. Entrambe le risposte vengono conservate nell'account e la nota non compare più. Finché resta senza risposta, compare ogni volta che si apre un progetto SysML v2. Non compare quando la modalità semplice è già attiva.
Cosa mostra
Dodici concetti, quelli che la demo Hybrid Car e i tutorial usano di più: package, part, attributo, port, connessione e interfaccia, azione, flusso e successione, stato, transizione, requisito, satisfy e verifica.
| Dove | In modalità semplice | Nascosti fino a Mostra tutto |
|---|---|---|
| Vista generale, pannello Aggiungi | Package, Definizione di part, Part, Definizione di port, Port, Attributo, Definizione di interfaccia, Definizione di action, Action, Definizione di requisito, Requisito, Caso di verifica | Definizione di attributo, Definizione di item, Definizione di enumerazione |
| Diagramma Spider, pannello Aggiungi | Package, Definizione di part, Part, Definizione di port, Port, Attributo, Definizione di action, Action, Stato, Definizione di requisito, Requisito, Caso di verifica | Definizione di item, Item, Definizione di attributo, Caso d'uso |
| Vista di interconnessione, pannello Aggiungi | Part, Port | Elemento |
| Vista di transizione di stato, pannello Aggiungi | Stato iniziale, Stato finale, Stato, Action entry, Action do, Action exit | Stato parallelo, Regione |
| Action Flow View, pannello Aggiungi e + Action ▾ | Action, Biforcazione, Ricongiungimento, Decisione, Unione, Corsia | Accetta, Invia, Ciclo, Termina |
| Editor, Inserisci ▾ | Package, Definizione di part, Part, Attributo, Definizione di port, Port, Interfaccia, Connessione, Definizione di action, Action, Successione, Flusso, Definizione di stato, Stato, Stato iniziale, Transizione, Definizione di requisito, Requisito, Soddisfa, Definizione di verifica, Verifica | Ogni altro frammento adatto alla posizione del cursore |
| Modello → Browser | Package, definizioni, usi, connessioni, flussi, transizioni, requisiti, satisfy e verify | Import, alias, expose, commenti, documentazione, metadati, package di libreria, binding connector, elementi a livello KerML, e le righe di trigger ed effetto di una transizione |
Puntare un elemento in un pannello Aggiungi, o il tipo di una riga nel Browser, per leggere una spiegazione di una frase di quell'elemento.
Le viste dei requisiti, dei casi d'uso, parametrica, di sequenza, dei package e geometrica e i pannelli Gerarchia, Albero, IDEF0 e FFBD mantengono tutti i loro elementi: ciascuno riguarda il tipo che aggiunge. + Nuovo diagramma, le tabelle, la ricerca, l'ispettore e la digitazione nell'Editor (con il completamento) non vengono filtrati.
Mostra tutto
- Pannelli Aggiungi: Mostra tutto (n in più) sotto gli elementi; Mostra meno li nasconde di nuovo.
- + Action ▾: Mostra tutto… in fondo riapre il menu con tutti i tipi.
- Inserisci ▾: spuntare Mostra tutto nella sua intestazione.
- Browser: spuntare Mostra tutto nella barra dei filtri.
Mostra tutto dura finché non si ricarica la pagina o si cambia la modalità semplice, e nel frattempo la modalità semplice resta attiva. Nel Browser, un elemento aperto da altrove (per esempio con Mostra nel Browser nell'ispettore) viene sempre mostrato, insieme ai suoi proprietari, anche quando il suo tipo è nascosto.
Home
Home è la stessa pagina dei progetti LML (vedere Home): Richiede attenzione (collegamenti da rivedere, TBD scaduti, test non superati, superamenti dei TPM, rischi elevati, controlli del modello, stato del salvataggio), una scheda Ciclo di vita per ogni gruppo della barra, e i pannelli come Prossime azioni, Gate del Processo SE e Milestone. I conteggi provengono dal modello SysML v2 e dai dati di Holarch accanto a esso. ✦ Scrivi la sintesi del progetto non è disponibile nei progetti SysML v2.
- I gruppi della barra mostrano gli stessi indicatori di problema, e la pagina di panoramica di ogni gruppo elenca ciò che richiede attenzione e i relativi numeri.
- + Aggiungi pannello → Contenuto del modello mostra Package (con il numero di package di primo livello), Definizioni, Usi, Relazioni e Requisiti (n non soddisfatti · n non verificati), elementi fuori posto quando degli elementi hanno perso il loro proprietario, e Modifiche recenti: le ultime modifiche al modello (creati, modificati, spostati, eliminati o ripristinati) con il tipo dell'elemento e l'ora.
Chiedi all'IA
Chiedi all'IA risponde a domande sul linguaggio SysML v2 e sull'uso di Holarch, sulla base della Guida e di Docs. Nei piani Individual e Team, e con una chiave IA propria o dell'organizzazione, risponde anche a domande sul modello aperto e propone modifiche, che si aprono per la revisione prima di essere applicate. Vedere Chiedi all'IA.
Non ancora disponibile
- Commit su
main, tag e merge tramite la Systems Modeling API: gli altri strumenti eseguono commit nei rami delle richieste di modifica, che un approvatore applica in Holarch (vedere API e MCP nei progetti SysML v2). - Modificare il linguaggio: la libreria standard è di sola lettura.
Notazione testuale SysML v2 elenca in dettaglio il linguaggio supportato.
Messaggi
| Messaggio | Significato |
|---|---|
| Il modello è vuoto | Il progetto non ha elementi. Fare clic su + Nuovo package, poi scriverne i membri nell'Editor. |
| Non applicato: correggere la riga N. | Il testo ha un errore alla riga N. Il modello mantiene il suo ultimo stato valido finché il testo non viene analizzato correttamente. |
| Sola visualizzazione: chiedere a un proprietario l'accesso in modifica. | Si dispone dell'accesso in visualizzazione al progetto. Il testo e le pagine sono di sola lettura. |
| Questo progetto richiede una versione più recente di Holarch. | Il progetto è stato salvato da una versione più recente di Holarch e questa pagina è meno recente. Il progetto si apre in sola visualizzazione e il banner in alto ne spiega il motivo. Fare clic su Ricarica nel banner per ottenere la nuova versione. |
Limiti
- Il tipo di progetto è fissato alla creazione.
- Un modello per progetto.
- Un documento di testo più grande di 8 MB non viene controllato; suddividerlo in più package.
Pagine correlate
- Notazione testuale SysML v2
- L'Editor di testo e il Browser
- Viste SysML v2
- Conversione tra LML e SysML v2
- Primi passi
SysML® e OMG® sono marchi registrati di Object Management Group, Inc. negli Stati Uniti e in altri paesi.