Kurskapitel
Schulung · Reihe 9. SysML-v2-Grundlagen · Kapitel 9.1 von 8
9.1 Definitionen und Attribute 4:33
Wertetypen und Komponenten in SysML-v2-Text schreiben, mit Werten in Einheiten.
Zeigt Holarch 2.22.
Das lernen Sie
- Im Editor eine Enumeration, einen Wertetyp und eine abstrakte Part-Definition schreiben
- Eine Definition mit `:>` spezialisieren und geerbten Attributen mit `redefines` Werte mit Einheiten geben
- Einen Einheitenfehler finden und beheben, den die Prüfung unterstreicht
- Eine Definition mit Einfügen ▾ und Vervollständigung schreiben und einen Typ in der Standardbibliothek nachschlagen
- Ein Element mit F2 in einem Rückgängig-Schritt überall umbenennen
Schreiben Sie SysML-v2-Definitionen und -Attribute im Editor von Holarch, nach dem SysML-v2-Tutorial „Definitions and Attributes“ an einem kleinen Hybrid-Car-Projekt: eine Enumeration, ein Wertetyp, der ScalarValue spezialisiert, eine abstrakte Komponente und ihre Spezialisierungen mit Werten in Einheiten, ein von der Prüfung gefundener Einheitenfehler, Vervollständigung und die Standardbibliothek, Einfügen und Umbenennen mit F2. SysML ist eine eingetragene Marke der Object Management Group, Inc.
Projektdateien
- Fertiges Projekt (.holarch.json; Projekte verwalten → Projektdateien ▾ → Projekt importieren (.json)…)
Das Video wird von holarch.app abgespielt; siehe Datenschutzerklärung.
Übung
Führen Sie dies selbst in Holarch durch, am Demoprojekt Hybrid Car (SysML v2).
- Erstellen Sie die Demo Hybrid Car: Projekte verwalten → Projektdateien ▾ → Neues Demoprojekt → Hybridauto (SysML v2). Öffnen Sie Modell → Editor und das Package
Vehicles. - Fügen Sie unter
enum def FuelKindenum def CoolingMode { enum passive; enum active; }hinzu. - Wählen Sie unter
part def BodyEinfügen ▾ → Part-Definition und vervollständigen Siepart def Radiator :> Componentmitattribute redefines mass = 8 [kg];,attribute coolantVolume : VolumeValue;(geben SieVoluein und übernehmen SieVolumeValuemit der Eingabetaste aus der Vervollständigungsliste) undattribute mode : CoolingMode;. - Ändern Sie die Masse in
8 [W], zeigen Sie auf die Unterstreichung, um die Meldung zu lesen, und ändern Sie sie dann zurück in8 [kg]. - Fügen Sie in
part def Powertrainpart radiator : Radiator;hinzu. Setzen Sie dann den Cursor aufcoolantVolume, drücken Sie F2 und benennen Sie es incoolantCapacityum. - Für eine geprüfte Schritt-für-Schritt-Anleitung führen Sie das SysML-v2-Tutorial Definitions and Attributes aus (Hilfe → Tutorials).
Sie sind fertig, wenn der Status unter dem Editor keine Probleme meldet und der Browser Radiator unter Vehicles mit coolantCapacity und mode zeigt.
Selbsttest
- Was bewirken in
part def Battery :> Component { attribute redefines mass = 45 [kg]; }jeweils:>undredefines? - Warum ist Component als
abstract part defdeklariert? - Warum ergibt
attribute redefines power = 60 [kg];einen Fehler? - Was ist der Unterschied zwischen
doc /* … */und einer//-Zeile?
Antworten anzeigen
Was bewirken in
part def Battery :> Component { attribute redefines mass = 45 [kg]; }jeweils:>undredefines?:>macht Battery zu einer Spezialisierung von Component, sodass es mass, partNumber und power erbt.redefinesersetzt das geerbtemassin Battery durch ein eigenes Feature, hier an 45 kg gebunden.Warum ist Component als
abstract part defdeklariert?Nichts ist eine Komponente an sich, nur Arten von Komponenten. Eine abstrakte Definition sammelt, was alle Komponenten gemeinsam haben, und nur ihre Spezialisierungen, etwa Battery oder Engine, beschreiben reale Teile.
Warum ergibt
attribute redefines power = 60 [kg];einen Fehler?powerist vom TypPowerValue, und Kilogramm ist eine Masseneinheit. Die Prüfung wertet Einheiten aus und unterstreicht den Wert daher, bis die Einheit eine Leistungseinheit wie[W]ist.Was ist der Unterschied zwischen
doc /* … */und einer//-Zeile?Ein
doc-Kommentar ist Dokumentation, die zum Element gehört und Teil des Modells ist. Eine//-Notiz bleibt nur im Text und ist nicht Teil des Modells.
Weiterlesen
- Tutorial: Definitions and Attributes (SysML-v2-Tutorials)
- Dokumentation: SysML-v2-Textnotation, Typisierung, Spezialisierung und Redefinition
- Dokumentation: SysML-v2-Textnotation, Werte und Einheiten
- Dokumentation: SysML-v2-Texteditor, Ein Konstrukt einfügen
- Dokumentation: SysML-v2-Texteditor, Zu einer Definition springen und umbenennen
- Hilfe: Standardbibliothek
Transkript
Transkript anzeigen (Erzählung und Bildschirminhalt)
Introduction
Welcome to SysML v2 Fundamentals. This track teaches the SysML v2 textual notation and views in Holarch, one task per chapter, on the starter projects of Holarch's SysML v2 tutorials, so you can follow along step by step.
In this chapter you write definitions and attributes: an enumeration, a value type, an abstract component and the components that specialize it, with values in units.
Start the tutorial
In Manage Projects, open Project Files and choose Start a Tutorial. Under the tutorials for SysML v2 projects, click Start on Definitions and Attributes. Holarch creates a small Hybrid Car project and opens the step panel, which checks each step as you go.
On screen: Project Files ▾ → Start a Tutorial… → SysML v2: Definitions and Attributes → Start; the step panel opens.
Enumerations and value types
Open Model, then Editor. The package Vehicles holds one part definition, Car, with two attributes. Every declaration is a keyword and a name, then a body in braces, or a semicolon when there is no body.
On screen: Model → Editor: Vehicles; outline part def Car.
An enumeration is a value type with a fixed set of values. Above the car, write the drive mode: economy, normal or sport.
On screen: Caret after the imports; type enum def DriveMode.
Next, a value type of your own. Tire pressure specializes Scalar Value from the standard library. The short symbol after the name means specializes.
On screen: Below DriveMode; type attribute def TirePressure :> ScalarValue;
Specialization and units
Now an abstract component. There is no component as such, only kinds of components, and every one has a mass, a part number and a power. The doc comment is part of the model. Two slashes start a note that stays in the text only.
On screen: Below TirePressure; type abstract part def Component.
The battery is a component, so it has a mass, a part number and a power of its own. Write it with a mistake on purpose: a power in kilograms.
On screen: Below Component; type part def Battery :> Component with power = 60 [kg].
The checker underlines the value, and the status under the editor counts the error. Point at the underline to read the message.
On screen: Problems count; the information card on 60 [kg].
Change kilograms to watts, and the error clears. Redefines gives each inherited attribute the battery's own value, with its unit in square brackets.
On screen: kg → W; No problems, Applied.
Completion and the Standard Library
Completion knows the model and the library. Inside the battery, type attribute capacity, a colon, and the start of Energy Value. Press Enter to take it from the list, and end the line with a semicolon.
On screen: Inside Battery: attribute capacity : Ener → completion → Enter → ;
Point at Energy Value. The card shows that it comes from the I S Q package of the standard library.
On screen: The information card on EnergyValue.
The Standard Library page lists every package and definition of that library. Open Settings, then Standard Library, and search for Energy Value.
On screen: Settings → Standard Library; Find EnergyValue.
Insert
Back in the Editor, Insert writes a construct for you. Place the cursor below the battery, open Insert, and choose Part Definition. Type Engine, and press Tab to move into its body.
On screen: Model → Editor; caret below Battery; Insert ▾ (open on camera) → Part Definition; Engine; Tab.
The engine is a component too. Give it its mass and a number of cylinders, and make it specialize Component.
On screen: Body: mass 110 kg, cylinders : Integer; then :> Component after the name.
Usages and rename
Now use the definitions. Inside the car, add a drive mode, a battery and an engine. Each usage is typed by a definition after the colon, the drive mode by the enumeration you wrote first.
On screen: In Car after curbMass: attribute mode : DriveMode; part battery : Battery; part engine : Engine;
To rename a name everywhere it is used, place the cursor on cylinders and press F2. Enter cylinder count and confirm. Every reference to it changes, in one undo step.
On screen: Caret in cylinders; F2; New name cylinderCount; OK.
Every step is ticked off. Click Mark as Done to finish the tutorial.
On screen: Step panel → Mark as Done.
Recap
Let's recap. You started a SysML v2 tutorial, wrote an enumeration and a value type, an abstract component with specializations and values in units, let the checker find a wrong unit, and used completion, the Standard Library, Insert and rename.
Next, ports and interfaces connect these components.