SysML v2
Tutorial SysML v2
Nove tutorial guidati per i progetti SysML v2, dal primo pacchetto a porte, azioni, stati, requisiti, verifica, vincoli e varianti, con un pannello dei passaggi che controlla il lavoro.
In questa pagina
Holarch offre una serie di tutorial guidati per i progetti SysML v2. Ognuno crea un piccolo progetto iniziale SysML v2 e apre un pannello dei passaggi accanto alla pagina. Il pannello controlla il modello mentre si lavora: un passaggio diventa verde quando il modello contiene ciò che il passaggio richiede. Questa pagina elenca ogni passaggio come testo, quindi è possibile seguirli anche da qui.
Il primo tutorial usa la WS-1 Weather Station, come i tutorial LML. Gli altri costruiscono parti di un'auto ibrida, il modello della demo Hybrid Car: tipi di valore e componenti, le porte e le interfacce del gruppo propulsore, un ciclo di guida, gli stati del gruppo propulsore, i requisiti dell'auto, la loro verifica, i controlli sui valori della berlina e la linea di prodotti. Ogni tutorial ha il proprio progetto iniziale, quindi è possibile seguirli in qualsiasi ordine. Ogni progetto iniziale e ogni tutorial completato si controllano con 0 problemi.
| Tutorial | Tempo | Si impara a |
|---|---|---|
| Primi passi | 15 min | scrivere testo SysML v2, vederlo come albero e come vista, disegnare nella vista e aggiungere un requisito |
| Definitions and Attributes | 20 min | scrivere enumerazioni, tipi di valore e definizioni astratte, specializzare con valori e unità, e usare il completamento, Inserisci e la ridenominazione |
| Ports and Interfaces | 20 min | definire porte e interfacce, coniugare le porte, collegare le parti e disegnare un'interfaccia in una Vista di interconnessione |
| Actions and Flows | 20 min | scrivere definizioni di azione e un ciclo di guida con una biforcazione, flussi e un ricongiungimento, aggiungere corsie e costruire passi nell'FFBD |
| States and Transitions | 20 min | scrivere segnali e una macchina a stati con trigger, guardie e azioni di stato, e disegnare una transizione temporizzata |
| Requisiti | 20 min | scrivere limiti, definizioni e usi di requisiti, soddisfarli e vedere un requisito non rispettato |
| Verification and Traceability | 15 min | scrivere un caso di verifica, tracciare un passo nella Matrice di tracciabilità e derivare un requisito |
| Constraints and Calculations | 20 min | scrivere vincoli e calcoli, collegare valori in una Vista parametrica, eseguire un caso di analisi e contrassegnare valori TBD e TBR |
| Varianti e configurazioni | 15 min | scrivere variazioni e varianti, una linea di prodotti con una regola, configurazioni e una parola chiave propria |
Come usarlo
Avviare un tutorial SysML v2
- Aprire Guida → Tutorial nella barra, oppure premere ⌘K / Ctrl+K e digitare
tutorial. Fuori da un progetto, la pagina Tutorial elenca prima i tutorial LML, poi Tutorial per progetti SysML v2. All'interno di un progetto SysML v2 elenca solo i tutorial SysML v2. - Fare clic su Inizia su una scheda. Holarch crea il progetto, per esempio Tutorial: SysML v2 Ports and Interfaces (Hybrid Car), e lo apre con il pannello dei passaggi a destra.
Il pannello dei passaggi funziona come nei tutorial LML: Mostra evidenzia il controllo di cui un passaggio ha bisogno, Vai lì apre la pagina, Ulteriori informazioni apre l'argomento della Guida, e Ricomincia…, Segna come completato e × funzionano allo stesso modo. Vedere Tutorial.
Digitare il testo di un passaggio
La maggior parte dei passaggi fornisce testo SysML da digitare in Modello → Editor. Il passaggio indica dove vanno le righe, per esempio “prima dell'ultima parentesi graffa di chiusura del package”. Il testo viene applicato al modello quando si fa una pausa nella digitazione; lo stato sotto l'editor lo conferma e il passaggio diventa verde.
- Digitare le righe come indicato. Il rientro non conta per il modello; l'Editor mantiene quello dell'utente.
- Una sottolineatura rossa segnala un errore: puntarla per leggere il messaggio. Il testo con un errore di sintassi resta una bozza e non viene applicato finché non lo si corregge.
- ⌘Z / Ctrl+Z annulla l'ultima modifica applicata.
Suggerimenti
- La prima volta, seguire i tutorial in ordine: ognuno spiega il testo che usa, e quelli successivi presuppongono i concetti precedenti (definizioni e usi,
:>e:>>). - Un passaggio che resta aperto di solito ha un errore di battitura in un nome. Confrontare il proprio testo con le righe del passaggio; in SysML v2 i nomi distinguono tra maiuscole e minuscole.
- I tutorial insegnano lo stesso linguaggio di Nozioni di base su SysML v2; la pagina Notazione testuale contiene i dettagli.
Primi passi
Scrivere un primo modello della Weather Station: aprire il testo, aggiungere una definizione di parte con un valore e un'unità, usarla in un'altra definizione, vedere il modello nel Browser e in una Vista generale, disegnare una parte nella vista e vederla comparire nel testo, aggiungere un requisito con satisfy ed esportare il modello come file .sysml. I passaggi sono descritti in Primi passi con i progetti SysML v2.
Definitions and Attributes
Il progetto iniziale contiene il package Vehicles con una definizione di parte, Car.
- Aprire il package. Fare clic su Modello → Editor. Ogni dichiarazione è una parola chiave e un nome, seguiti da un corpo tra parentesi graffe o da un punto e virgola.
- Scrivere un'enumerazione. Sopra
part def Car {, aggiungereenum def DriveMode { enum economy; enum normal; enum sport; }(un valore per riga). - Definire un tipo di valore. Sotto di essa, aggiungere
attribute def TirePressure :> ScalarValue;.:>significa “specializza”. - Scrivere una definizione astratta. Aggiungere
abstract part def Componentcon un commentodoce gli attributimass : MassValue,partNumber : Stringepower : PowerValue.//inizia una nota che resta solo nel testo. - Lasciare che il controllo trovi un errore. Aggiungere
part def Battery :> Componentconattribute redefines mass = 45 [kg];e, di proposito,attribute redefines power = 60 [kg];. Il controllo sottolinea l'unità: i chilogrammi non sono una potenza. - Correggere l'unità. Cambiarla in
60 [W]. - Completare un nome. Nella batteria, digitare
attribute capacity : Ener, accettareEnergyValuedall'elenco di completamento con Enter e terminare con;. - Cercarlo nella Libreria standard. Fare clic su Impostazioni → Libreria standard in fondo alla barra e digitare
EnergyValuenella casella di ricerca. - Inserire una definizione. Nell'Editor, premere ⌃⇧Space / Ctrl+Shift+Space (o fare clic su Inserisci ▾) su una riga vuota, scegliere Definizione di part e completare
part def Engine :> Componentconattribute redefines mass = 110 [kg];eattribute cylinders : Integer;. - Usare le definizioni. In
Car, aggiungereattribute mode : DriveMode;,part battery : Battery;epart engine : Engine;. - Rinominare ovunque. Posizionare il cursore su
cylinders, premere F2 e rinominarlo incylinderCount.
Ports and Interfaces
Il progetto iniziale contiene i componenti del gruppo propulsore con le loro porte di coppia e di potenza, le definizioni di porta TorquePort e PowerPort e le definizioni di interfaccia Shaft e HighVoltageBus.
- Definire una porta. Sopra
port def TorquePort, aggiungereport def FuelPortconout attribute flowRate : Real;eattribute kind : FuelKind;.outsignifica che il valore esce dalla parte che possiede la porta. - Assegnare le porte alle parti. Aggiungere
port fuelOut : FuelPort;aFuelTankeport fuelIn : ~FuelPort;aEngine.~coniuga la porta: ingresso e uscita sono invertiti. - Definire un'interfaccia. Aggiungere
interface def FuelLine { end supply : FuelPort; end consumer : ~FuelPort; }. - Costruire il gruppo propulsore. Alla fine del package, aggiungere
part def Powertraincon le partitank,engine,motor,batteryetransmission, una portaoutput : TorquePortebind output = transmission.output;. - Collegare due parti. Nel gruppo propulsore, aggiungere
interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;. - Aggiungere gli alberi di trasmissione. Aggiungere
interface engineShaft : Shaft connect engine.output to transmission.engineIn;einterface motorShaft : Shaft connect motor.output to transmission.motorIn;. - Creare una Vista di interconnessione. Fare clic su Architettura → Viste di interconnessione, poi su + Nuovo diagramma. Scegliere
Powertrainin Mostra e fare clic su Crea. - Disegnare un'interfaccia. Trascinare dalla maniglia della porta
powerOutdella batteria alla portapowerIndel motore e rilasciare su Interface : HighVoltageBus. - Assegnare un nome all'interfaccia. Selezionare la nuova linea e inserire
hvBuscome Nome nell'ispettore. - Vederla nel testo. Fare clic su Modello → Editor: l'interfaccia si trova nel gruppo propulsore, con nome, tipo ed estremità.
Actions and Flows
Il progetto iniziale contiene il package VehicleBehavior con gli item Fuel e Torque, le funzioni ProduceTorque (F.2) e DriveWheels (F.3) e tre definizioni di parte.
- Definire una funzione. Aggiungere
action def <'F.1'> SupplyFuelconin attribute fuelDemand : Real;eout item fuel : Fuel;. Il nome breve tra parentesi angolari è il numero della funzione. - Scrivere il ciclo di guida. Aggiungere
action def <'F'> DriveCycleconfirst start then split;,fork split;,then supply;,then produce;e i passiaction supply : SupplyFueleaction produce : ProduceTorque, ciascuno con unaduration. - Aggiungere un flusso. Nel ciclo di guida, aggiungere
flow of Fuel from supply.fuel to produce.fuel;. - Ricongiungere i rami. Aggiungere
first supply then ready;,first produce then ready;,join ready;,then action drive : DriveWheels { … },then done;eflow produce.torque to drive.torque;. - Creare una Action Flow View. Fare clic su Comportamento → Flussi di azioni, poi su + Nuovo diagramma, e scegliere
DriveCyclein Mostra. - Indicare chi esegue ogni passo. Aggiungere
part def DrivenCarconperform action trip : DriveCycle;e le partitank,engineetransmission, ciascuna conperform trip.supply;,perform trip.produce;operform trip.drive;. La vista ottiene una corsia per ogni parte. - Aprire Analisi funzionale. Fare clic su Comportamento → Analisi funzionale, fare clic su Scegli… e selezionare
DriveCycle. - Dichiarare un'altra azione. Aggiungere
action def EmergencyShutdown;. - Costruire i passi nell'FFBD. Fare clic su Comportamento → FFBD, poi su + Nuovo diagramma, e scegliere
EmergencyShutdown. Nel pannello Aggiungi, digitareOpen Contactorse premere Enter, poiCut Fuel. - Vedere i passi nel testo. Fare clic su Modello → Editor: l'FFBD ha scritto i passi e le loro successioni.
States and Transitions
Il progetto iniziale contiene il package PowertrainBehavior con un part def Car vuoto.
- Definire i segnali. Aggiungere
attribute def StartRequest;, e allo stesso modoStopRequest,PlugIneUnplug. - Scrivere una definizione di stato. Aggiungere
state def PowertrainStatesconin attribute charge : Real;,entry; then off;e gli statioff,electricehybrid. - Aggiungere transizioni. Dopo
state off;, aggiungereaccept StartRequest if charge > 20 then electric;eaccept StartRequest then hybrid;. - Assegnare azioni a uno stato. Sostituire
state electric;con un corpo che contieneentry action spinUpMotor;,do action driveElectric;eexit action holdMotor;. - Uscire dallo stato elettrico. Dopo di esso, aggiungere
if charge < 15 then hybrid;eaccept StopRequest then off;; aggiungereaccept StopRequest then off;anche dopostate hybrid;. - Aggiungere uno stato con transizioni con nome. Aggiungere
state charging { do action chargeBattery; },transition plugIn first off accept PlugIn then charging;etransition unplugged first charging accept Unplug then off;. - Creare una Vista di transizione di stato. Fare clic su Comportamento → Macchine a stati, poi su + Nuovo diagramma, e scegliere
PowertrainStatesin Mostra. - Disegnare una transizione temporizzata. Trascinare dalla maniglia di
chargingaoffe rilasciare su Transizione. Nel pannello della transizione, inserire il Nomechargede il Triggerafter 30 [min]. - Vederla nel testo. Fare clic su Modello → Editor: la transizione è scritta come transizione con nome.
- Far esibire gli stati all'auto. In
Car, aggiungereexhibit state powertrainStates : PowertrainStates;.
Requisiti
Il progetto iniziale contiene il package VehicleRequirements con una piccola copia del progetto: Battery, Car e la sedan della flotta con una massa in ordine di marcia di 1580 kg.
- Dare un nome ai limiti. Aggiungere
attribute maxCurbMass : MassValue = 1650 [kg];eattribute minBatteryCapacity : EnergyValue = 1.2 [kW*h];. - Scrivere una definizione di requisito. Aggiungere
requirement def <'VR-1'> CurbMasscon un enunciatodoc,subject car : Car;,attribute limit : MassValue;erequire constraint { car.curbMass <= limit }. - Inserire un requisito. Premere ⌃⇧Space / Ctrl+Shift+Space su una riga vuota, scegliere Definizione di requisito e scrivere
VR-3 BatteryCapacitycon il soggettobattery : Batteryerequire constraint { battery.capacity >= minBatteryCapacity }. - Annidare i requisiti in una specifica. Aggiungere
requirement carSpecconsubject car : Car;erequirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }. - Indicare cosa li soddisfa. Aggiungere
satisfy carSpec by fleet.sedan;esatisfy requirement batterySpec : BatteryCapacity by fleet.sedan.battery;. - Violare un requisito. Cambiare la massa in ordine di marcia della berlina in
1700 [kg]. L'Editor segnala il satisfy: la berlina non rispetta più VR-1.1. - Rispettarlo di nuovo. Premere ⌘Z / Ctrl+Z, oppure riportarla a
1580 [kg]. - Vedere la tabella dei requisiti. Fare clic su Esigenze e requisiti → Requisiti.
- Creare una Vista dei requisiti. Nella pagina Diagrammi, fare clic su + Nuovo diagramma, scegliere Vista dei requisiti e
carSpecin Mostra. - Controllare gli enunciati. Fare clic su Esigenze e requisiti → Qualità e fare clic su Controlla qualità.
Verification and Traceability
Il progetto iniziale contiene il requisito sulla massa in ordine di marcia e la specifica dell'auto, un ciclo di guida con i passi cruise e brake, VR-6 batteryMassLimit e VR-7 stopFromCruise.
- Scrivere un caso di verifica. Aggiungere
verification def <'VC-1'> CurbMassTestconsubject car : Car;,objective massObjective { verify carSpec.sedanMass; }ereturn verdict : Boolean = car.curbMass <= maxCurbMass;. - Applicarlo alla berlina. Aggiungere
verification <'VC-1.1'> sedanWeighing : CurbMassTest { subject car = fleet.sedan; }. - Aprire i casi di verifica. Fare clic su Verifica → Casi di verifica. Passi, risultati e stato sono dati di Holarch accanto al modello. Nella riga di Sedan Weighing, fare clic su + Passi, poi su + Aggiungi passo, digitare
Weigh the carsotto Action e fare clic su Applica. Poi fare clic su Superati tra i suoi pulsanti di stato. - Leggere la RVTM. Fare clic su Verifica → RVTM.
- Tracciare un passo verso un requisito. Fare clic su Verifica → Matrice di tracciabilità, mostrare i requisiti come righe e le azioni come colonne, fare clic sulla cella di
stopFromCruiseebrakee scegliere satisfied by. - Derivare un requisito. Aggiungere
private import RequirementDerivation::*;econnection batteryMassDerivation : Derivation connect carSpec.sedanMass to batteryMassLimit;. - Eseguire i controlli del modello. Fare clic su Verifica → Controlli del modello.
Constraints and Calculations
Il progetto iniziale contiene il package VehicleAnalysis con il motore, la batteria, l'auto e i valori della berlina, e gli obiettivi maxCurbMass e minPowerToWeight.
- Scrivere una definizione di vincolo. Aggiungere
constraint def MassLimitconin mass : MassValue;,in limit : MassValue;e l'espressionemass <= limit. - Scrivere un calcolo. Aggiungere
calc def PowerToWeightcon i parametripoweremassereturn ratio = power / mass;. - Collegare i valori della berlina. Aggiungere
constraint sedanMassCheck : MassLimit { in mass = fleet.sedan.curbMass; in limit = maxCurbMass; }. - Creare una Vista parametrica. Nella pagina Diagrammi, fare clic su + Nuovo diagramma, scegliere Vista parametrica e
VehicleAnalysisin Mostra. Il controllo è superato: 1580 kg rientra in 1650 kg. - Far fallire il controllo. Cambiare la massa in ordine di marcia della berlina in
1700 [kg]; la vista mostra il controllo fallito. - Farlo superare di nuovo. Annullare, oppure riportarla a
1580 [kg]. Risolvi tutto controlla di nuovo ogni vincolo. - Eseguire un caso di analisi. Aggiungere
analysis def PowerToWeightAnalysiscon un obiettivo che richiederatio >= minPowerToWeight, eanalysis sedanPowerToWeight : PowerToWeightAnalysis { subject car = fleet.sedan; }. - Contrassegnare i valori aperti. Aggiungere
private import HolarchMetadata::*;e il requisito VR-5ChargeTimecon#TBRsul suo limite di tempo e@TBDcon un responsabile, una scadenza e una motivazione sulla potenza del caricatore.TBDeTBRprovengono dalla libreriaHolarchMetadatadi Holarch, non dalla libreria standard di SysML v2; specializzano i metadati standardStatusInfo. - Aprire il registro TBD/TBR. Fare clic su Esigenze e requisiti → TBD/TBR. Il tempo di ricarica è elencato con il responsabile e la scadenza dei suoi metadati
@TBD. Il registro è di sola lettura: modificare il responsabile o la data nei metadati nell'Editor. - Aggregare la massa. Fare clic su Architettura → Budget e TPM e selezionare la parte radice
sedan.
Varianti e configurazioni
Il progetto iniziale contiene Component, Battery, Controller, Car e Powertrain.
- Importare il package di variabilità. Aggiungere
private import HolarchVariability::*;. - Scrivere una variazione. Su una riga vuota, premere ⌃⇧Space / Ctrl+Shift+Space (o fare clic su Inserisci ▾), scegliere Variazione e completare
variation part def BatteryPack :> Batterycon le variantistandardPack(1,4 kWh) elargePack(12 kWh, 120 kg). - Scrivere la linea di prodotti. Aggiungere
part def CarLine :> Carconpart pack : BatteryPack;, unavariation part chargercon le variantinoChargerewallbox, eassert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }. - Avviare una configurazione. Scegliere Inserisci ▾ → Configurazione e compilare
part plugInHybrid : CarLine { @HolarchConfiguration; }. L'Editor segnala i punti di variazione ancora aperti. - Scegliere le varianti. In
plugInHybrid, scegliere Inserisci ▾ → Scelta della variante per ogni punto e compilarepart :>> pack = BatteryPack::largePack;epart :>> charger = charger::wallbox;. - Aggiungere una seconda configurazione. Aggiungere
selfChargingHybridallo stesso modo, con il pacco standard e senza caricatore. - Definire una parola chiave propria. Aggiungere
metadata def <safetyCritical> SafetyCritical. - Usare la parola chiave. In
Powertrain, scrivere#safetyCritical part controller : Controller;. - Vedere la linea di prodotti. Creare una Vista generale di
Vehicles: il pacco batteria è contrassegnato come variation.
Progetti dei tutorial
I progetti dei tutorial SysML v2 seguono le stesse regole degli altri progetti dei tutorial: non contano per i progetti attivi del piano, contengono fino a 300 elementi ed è possibile averne uno per tutorial. Vedere Tutorial.
Correlati
- Tutorial
- Primi passi con i progetti SysML v2
- L'Editor di testo e il Browser
- Notazione testuale
- Viste
- Requisiti nei progetti SysML v2
SysML® e OMG® sono marchi registrati di Object Management Group, Inc. negli Stati Uniti e in altri paesi.