Holarch

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.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Due tipi di progetto
    2. Il modello e il testo sono una cosa sola
    3. Dati del modello e dati di Holarch
    4. Definizioni e usi
  3. Come usarlo
    1. Scegliere un tipo di progetto
    2. Creare un progetto SysML v2
    3. Aprire la demo Hybrid Car
    4. Aprire la demo Hybrid Car Battery Pack
    5. Aprire la demo Earth Observation Satellite
    6. Scrivere il primo modello
    7. Orientarsi
  4. Esempio svolto: esplorare la Hybrid Car
  5. Suggerimenti ed errori comuni
  6. La barra di navigazione nei progetti SysML v2
  7. Modalità semplice
    1. Attivarla o disattivarla
    2. Cosa mostra
    3. Mostra tutto
  8. Home
  9. Chiedi all'IA
  10. Non ancora disponibile
  11. Messaggi
  12. Limiti
  13. Pagine correlate

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).

LMLSysML v2
A cosa serveModellare 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 modelloIl 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ò scambiareImportazioni 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, perform e connect.
  • 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.

  1. Scegliere LML per usare il metodo Holarch completo: il Database, i diagrammi LML e i controlli guidati a ogni passaggio.
  2. Scegliere SysML v2 quando il modello deve essere testo SysML v2, per esempio per scambiarlo con un altro strumento SysML v2.
  3. 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

  1. Aprire Gestisci progetti e fare clic su + Nuovo progetto.
  2. In Come modellare questo sistema?, scegliere SysML v2.
  3. 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.

  1. Aprire Gestisci progetti.
  2. 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.

  1. Aprire Gestisci progetti.
  2. Fare clic su File di progetto ▾ → Nuovo progetto demo → Hybrid Car Battery Pack (SysML v2).

Cose da provare:

  • Valori calcolati: nell'Editor, Pack::mass somma 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, quindi massMargin è 5 kg. Pack::capacity somma 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.

  1. Aprire Gestisci progetti.
  2. 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;
    }
}
  1. Aprire Modello → Editor, fare clic su + Nuovo package, inserire Drone e confermare. L'Editor apre il testo del nuovo package.
  2. Digitare le importazioni e i membri tra le parentesi graffe del package, come sopra.
  3. 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.
  4. 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.

  1. Iniziare da Home per ciò che richiede attenzione, i gruppi del ciclo di vita e le prossime azioni.
  2. Usare Modello → Editor per scrivere il testo e Modello → Browser per vedere l'albero.
  3. Usare Esigenze e requisiti e Verifica per requisiti, casi di verifica e tracciabilità.
  4. Usare Comportamento, Architettura e Interfacce per le viste e le pagine di analisi.
  5. Aprire lo strumento Diagrammi in fondo alla barra di navigazione per vedere ogni vista.
  6. Premere ⌘K / Ctrl+K per trovare qualsiasi elemento per nome, nome breve, nome qualificato (Vehicles::Car) o testo della documentazione.
  7. 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.

  1. Creare la demo (vedere Aprire la demo Hybrid Car). Si apre in Home. Aprire Modello → Editor e scegliere Vehicles nell'elenco Pacchetti.
  2. Trovare part def Car. Ha le parti body, powertrain, frontAxle, rearAxle e spare : Wheel [0..1].
  3. Fare ⌘ / Ctrl-clic su Powertrain in part powertrain : Powertrain;. Il cursore passa a part def Powertrain, con le sue parti tank, engine, motor, battery, transmission e controller, e interfacce come interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;.
  4. Puntare MassValue in attribute mass : MassValue;. Una scheda mostra il suo tipo e il nome qualificato dalla libreria standard.
  5. Aprire Modello → Browser. Digitare sedan in Filtra per nome. L'albero mostra sedan sotto fleet in Vehicles. Selezionarlo: l'ispettore mostra Tipo part, Typed by Car e il nome qualificato Vehicles::fleet::sedan.
  6. 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.
  7. Aprire Esigenze e requisiti → Requisiti. Le righe includono VR-1.1 sedanMass, un uso di requisito il cui numero è il suo nome breve <'VR-1.1'>.
  8. 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 che SI sia visibile (e MassValue richiede ISQ). Aggiungere private import ISQ::*; e private 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

GruppoPagine
HomeRichiede attenzione, Ciclo di vita, Prossime azioni e gli altri pannelli della Home
Esigenze e requisitiDocumenti, Requisiti, Qualità, TBD/TBR, Collegamenti da rivedere, Approvazioni, Matrice di conformità*
ModelloEditor, Browser, Importazione ed esportazione
ComportamentoAnalisi funzionale, Flussi di azioni, FFBD, Macchine a stati, Sequenze, Simulatore
ArchitetturaParti, Viste generali, Viste di interconnessione, Gerarchia, Budget e TPM
InterfacceRegistro delle interfacce, ICD, Diagrammi N², Elementi e I/O
VerificaRVTM, 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 decisioniRegistro dei rischi, Diagrammi di Risk, Studi di trade-off, Decisioni, Problemi e azioni
PianoIl mio lavoro, Processo SE, Gestione del progetto, Grafici, Lavagne, Presentazioni
Controllo e revisioniRichieste di modifica, Baseline e versioni, Librerie, Revisioni, Attività
FrameworkDoDAF, 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.

DoveIn modalità sempliceNascosti fino a Mostra tutto
Vista generale, pannello AggiungiPackage, Definizione di part, Part, Definizione di port, Port, Attributo, Definizione di interfaccia, Definizione di action, Action, Definizione di requisito, Requisito, Caso di verificaDefinizione di attributo, Definizione di item, Definizione di enumerazione
Diagramma Spider, pannello AggiungiPackage, Definizione di part, Part, Definizione di port, Port, Attributo, Definizione di action, Action, Stato, Definizione di requisito, Requisito, Caso di verificaDefinizione di item, Item, Definizione di attributo, Caso d'uso
Vista di interconnessione, pannello AggiungiPart, PortElemento
Vista di transizione di stato, pannello AggiungiStato iniziale, Stato finale, Stato, Action entry, Action do, Action exitStato parallelo, Regione
Action Flow View, pannello Aggiungi e + Action ▾Action, Biforcazione, Ricongiungimento, Decisione, Unione, CorsiaAccetta, 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, VerificaOgni altro frammento adatto alla posizione del cursore
Modello → BrowserPackage, definizioni, usi, connessioni, flussi, transizioni, requisiti, satisfy e verifyImport, 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

MessaggioSignificato
Il modello è vuotoIl 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.

SysML® e OMG® sono marchi registrati di Object Management Group, Inc. negli Stati Uniti e in altri paesi.