Chapitres du cours
Formation · Parcours 9. Les fondamentaux de SysML v2 · Chapitre 9.1 sur 8
9.1 Définitions et attributs 4:33
Écrire des types de valeur et des composants en texte SysML v2, avec des valeurs en unités.
Montre Holarch 2.22.
Ce que vous allez apprendre
- Écrire une énumération, un type de valeur et une définition de part abstraite dans l'Éditeur
- Spécialiser une définition avec `:>` et donner aux attributs hérités des valeurs avec unités au moyen de `redefines`
- Trouver et corriger une erreur d'unité que le vérificateur souligne
- Écrire une définition avec Insérer ▾ et la complétion, et chercher un type dans la Bibliothèque standard
- Renommer un élément partout avec F2 en une seule étape d'annulation
Écrivez des définitions et des attributs SysML v2 dans l'Éditeur de Holarch, en suivant le tutoriel SysML v2 Definitions and Attributes sur un petit projet Hybrid Car : une énumération, un type de valeur qui spécialise ScalarValue, un composant abstrait et ses spécialisations avec des valeurs en unités, une erreur d'unité trouvée par le vérificateur, la complétion et la Bibliothèque standard, Insérer, et le renommage avec F2. SysML est une marque déposée d'Object Management Group, Inc.
Fichiers de projet
- Projet terminé (.holarch.json ; Gérer les projets → Fichiers de projet ▾ → Importer un projet (.json)…)
La vidéo est diffusée depuis holarch.app ; voir la Politique de confidentialité.
Pratique
Faites-le vous-même dans Holarch, sur le projet de démonstration Hybrid Car (SysML v2).
- Créez la démo Hybrid Car : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → Hybrid Car (SysML v2). Ouvrez Modèle → Éditeur et le package
Vehicles. - Sous
enum def FuelKind, ajoutezenum def CoolingMode { enum passive; enum active; }. - Sous
part def Body, choisissez Insérer ▾ → Définition de part et complétezpart def Radiator :> Componentavecattribute redefines mass = 8 [kg];,attribute coolantVolume : VolumeValue;(saisissezVoluet acceptezVolumeValuedans la liste de complétion avec Entrée) etattribute mode : CoolingMode;. - Changez la masse en
8 [W], pointez le soulignement pour lire le message, puis remettez8 [kg]. - Dans
part def Powertrain, ajoutezpart radiator : Radiator;. Placez ensuite le curseur surcoolantVolume, appuyez sur F2 et renommez-le encoolantCapacity. - Pour un parcours guidé et contrôlé, lancez le tutoriel SysML v2 Definitions and Attributes (Aide → Tutoriels).
C'est terminé quand l'état sous l'éditeur ne signale aucun problème et que le Navigateur affiche Radiator sous Vehicles avec coolantCapacity et mode.
Vérifiez vos connaissances
- Dans
part def Battery :> Component { attribute redefines mass = 45 [kg]; }, que fait chacun de:>etredefines? - Pourquoi Component est-il déclaré
abstract part def? - Pourquoi
attribute redefines power = 60 [kg];produit-il une erreur ? - Quelle est la différence entre
doc /* … */et une ligne//?
Afficher les réponses
Dans
part def Battery :> Component { attribute redefines mass = 45 [kg]; }, que fait chacun de:>etredefines?:>fait de Battery une spécialisation de Component : elle hérite de mass, partNumber et power.redefinesremplace dans Battery l'attribut héritémasspar sa propre feature, ici liée à 45 kg.Pourquoi Component est-il déclaré
abstract part def?Rien n'est un composant en tant que tel, seulement des types de composants. Une définition abstraite rassemble ce que tous les composants ont en commun, et seules ses spécialisations, comme Battery ou Engine, décrivent des parties réelles.
Pourquoi
attribute redefines power = 60 [kg];produit-il une erreur ?powerest typéPowerValue, et le kilogramme est une unité de masse. Le vérificateur évalue les unités : il souligne donc la valeur tant que l'unité n'est pas une unité de puissance comme[W].Quelle est la différence entre
doc /* … */et une ligne//?Un commentaire
docest une documentation qui appartient à l'élément et fait partie du modèle. Une note//reste uniquement dans le texte et ne fait pas partie du modèle.
Pour aller plus loin
- Tutoriel : Definitions and Attributes (tutoriels SysML v2)
- Docs : Notation textuelle SysML v2, typage, spécialisation et redéfinition
- Docs : Notation textuelle SysML v2, valeurs et unités
- Docs : Éditeur de texte SysML v2, insérer une construction
- Docs : Éditeur de texte SysML v2, aller à une définition et renommer
- Aide : Bibliothèque standard
Transcription
Afficher la transcription (narration et contenu de l'écran)
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.