Holarch
Chapitres du cours

Formation · Parcours 9. Les fondamentaux de SysML v2 · Chapitre 9.7 sur 8

9.7 Contraintes et calculs 4:26

Écrire des contraintes et des calculs, contrôler les valeurs de la berline avec leurs unités, et marquer les valeurs ouvertes.

Montre Holarch 2.22.

Ce que vous allez apprendre

  • Écrire une définition de contrainte et une définition de calcul avec des paramètres
  • Lier les paramètres d'un usage de contrainte à des valeurs du modèle
  • Voir une contrainte réussir et échouer dans une Vue paramétrique, et contrôler toutes les contraintes avec Tout résoudre
  • Marquer les valeurs ouvertes avec les métadonnées TBD et TBR et les retrouver dans le registre TBD/TBR
  • Agréger la masse d'une partie dans Budgets et TPM

Écrivez des contraintes et des calculs SysML v2 dans Holarch, en suivant le tutoriel SysML v2 Constraints and Calculations sur un petit projet Hybrid Car : une définition de contrainte et un calcul, un usage de contrainte lié aux valeurs de la berline, une Vue paramétrique où le contrôle échoue puis réussit, Tout résoudre, un cas d'analyse, des valeurs TBD et TBR avec leur registre, et une agrégation de masse dans Budgets. 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).

  1. Ouvrez votre projet de démonstration Hybrid Car (créez-le si besoin : Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration → Hybrid Car (SysML v2)), ouvrez Modèle → Éditeur et le package VehicleRequirements.
  2. Après constraint def SpeedLimit, ajoutez constraint sedanBatteryCheck : MassLimit { in mass = fleet.sedan.powertrain.battery.mass; in limit = 50 [kg]; }.
  3. Sur la page Diagrammes, cliquez sur + Nouveau diagramme, choisissez Vue paramétrique et VehicleRequirements sous Affiche, et cliquez sur Créer. Le nouveau contrôle réussit : 48 kg est inférieur à 50 kg.
  4. Dans le package Vehicles, changez la masse de la batterie de la berline en 52 [kg] ; la vue montre l'échec du contrôle. Appuyez sur ⌘Z / Ctrl+Z, puis cliquez sur Tout résoudre pour recontrôler toutes les contraintes.
  5. Dans requirement def <'VR-2'> Acceleration, remplacez attribute zeroToHundred : TimeValue; par attribute zeroToHundred : TimeValue { @TBD { owner = "Test lead"; rationale = "The test track is not booked yet."; } }. Ouvrez Besoins et exigences → TBD/TBR et trouvez l'exigence avec son responsable.
  6. Ouvrez Architecture → Budgets et TPM, cliquez sur Sélectionner la partie racine… et choisissez sedan. Sous Grandeur, choisissez Mass et trouvez les 48 kg de la batterie.

C'est terminé quand sedanBatteryCheck affiche Réussi dans la Vue paramétrique et que le registre TBD/TBR liste l'exigence Acceleration avec le responsable Test lead.

Vérifiez vos connaissances

  1. Quelle est la différence entre une constraint def et une calc def ?
  2. Une contrainte de la Vue paramétrique affiche Saisie requise. Que manque-t-il ?
  3. Pourquoi marquer une valeur ouverte avec #TBD ou @TBD { … } plutôt que d'écrire TBD comme valeur ?
  4. Qu'apporte un cas d'analyse à un calcul ?
Afficher les réponses
  1. Quelle est la différence entre une constraint def et une calc def ?

    Une définition de contrainte énonce sur ses paramètres une condition vraie ou fausse, comme mass <= limit. Une définition de calcul calcule et renvoie une valeur, comme return ratio = power / mass;.

  2. Une contrainte de la Vue paramétrique affiche Saisie requise. Que manque-t-il ?

    Un paramètre n'a pas encore de valeur. Liez chaque paramètre à une valeur, par exemple in mass = fleet.sedan.curbMass;.

  3. Pourquoi marquer une valeur ouverte avec #TBD ou @TBD { … } plutôt que d'écrire TBD comme valeur ?

    TBD à la place d'une valeur n'est pas du SysML valide. Les métadonnées du package HolarchMetadata de Holarch gardent le texte valide ; TBD et TBR spécialisent la métadonnée standard StatusInfo, si bien que les autres outils SysML v2 les lisent comme des annotations d'état.

  4. Qu'apporte un cas d'analyse à un calcul ?

    Il applique le calcul à un sujet, comme la berline, renvoie le résultat, et possède un objectif dont la contrainte require est évaluée par Holarch comme n'importe quelle autre contrainte.

Pour aller plus loin

Transcription

Afficher la transcription (narration et contenu de l'écran)

Introduction

Chapter seven: constraints and calculations. They turn the model's values into checks and results that Holarch evaluates with units.

In this chapter you write a constraint and a calculation, bind a check to the sedan's values, see it fail and pass in a Parametric View, run an analysis case, and mark open values.

Start the tutorial

Start the tutorial Constraints and Calculations from Project Files, Start a Tutorial. Its starter project holds the sedan with its engine and battery values, and two targets: the maximum curb mass and the minimum power to weight.

On screen: Project Files ▾ → Start a Tutorial… → SysML v2: Constraints and Calculations → Start; Model → Editor.

Constraints and calculations

A constraint definition states a condition over its parameters. After the constraints comment, write the mass limit: the mass is at most the limit.

On screen: After // ---- Constraints and calculations ----: constraint def MassLimit.

Below it, a calculation: power to weight divides the power by the mass, and returns the ratio.

On screen: Below it: calc def PowerToWeight.

A constraint usage binds each parameter to a value: here, the sedan's curb mass and the maximum curb mass.

On screen: Below it: constraint sedanMassCheck : MassLimit with bound inputs.

The Parametric View

Open the Diagrams page, click New Diagram, and choose Parametric View. Choose the vehicle analysis package under Shows, and click Create.

On screen: Diagrams → + New Diagram → Parametric View; Shows: VehicleAnalysis; Create.

The check shows its expression, with its parameters bound to the values. Fifteen hundred eighty kilograms is within sixteen hundred fifty, so it passes.

On screen: The mass check: pass.

In the Editor, change the sedan's curb mass to seventeen hundred kilograms. Back in the Parametric View, the mass check now fails.

On screen: Model → Editor: curbMass 1580 → 1700; Diagrams → the Parametric View: fail.

Change it back to fifteen hundred eighty in the Editor. In the view, Solve All checks every constraint again, with units.

On screen: Model → Editor: 1700 → 1580; the view → Solve All → Pass; Close.

An analysis case

An analysis case computes a result for a subject. At the end of the package, add the power to weight analysis, and apply it to the sedan. Its objective requires at least the minimum, and the checker evaluates it like any constraint.

On screen: Model → Editor; after sedanMassCheck: analysis def PowerToWeightAnalysis; analysis sedanPowerToWeight.

TBD and TBR

Values that are still open get a mark. First import Holarch's metadata package after the other imports.

On screen: After the imports: private import HolarchMetadata::*;

Then add a charge time requirement. TBR marks the time limit to be reviewed, and TBD marks the charger power to be determined, with an owner, a due date and a rationale. Both come from Holarch's metadata library and specialize the standard status metadata, so other SysML v2 tools see them as status annotations.

On screen: At the end: requirement def <'VR-5'> ChargeTime with #TBR and @TBD.

Open Needs and Requirements, then TBD/TBR. The charge time is listed with the owner and the due date from its metadata. The register only lists them: to change them, edit the metadata in the Editor.

On screen: Needs & Requirements → TBD/TBR; the ChargeTime row with owner and due date.

Budgets

Last, open Architecture, then Budgets, and select the sedan as the root part. The quantity Mass reads each part's mass attribute with its unit: the battery shows the sedan's own forty eight kilograms.

On screen: Architecture → Budgets & TPMs → Select Root Part… → sedan; the battery 48 kg.

Recap

Every step is ticked off. Click Mark as Done.

On screen: Step panel → Mark as Done.

Let's recap. You wrote a constraint and a calculation, bound a check to the sedan's values, saw it fail and pass in a Parametric View, ran an analysis case, marked open values for the register, and rolled up the mass.

Next, variants and configurations describe a product line.