Kurskapitel
Schulung · Reihe 9. SysML-v2-Grundlagen · Kapitel 9.7 von 8
9.7 Constraints und Berechnungen 4:26
Constraints und Berechnungen schreiben, die Werte der Limousine mit Einheiten prüfen und offene Werte markieren.
Zeigt Holarch 2.22.
Das lernen Sie
- Eine Constraint-Definition und eine Calculation-Definition mit Parametern schreiben
- Die Parameter einer Constraint-Usage an Werte im Modell binden
- Einen Constraint in einer Parametrik-Ansicht bestehen und scheitern sehen und mit „Alle lösen“ jeden Constraint prüfen
- Offene Werte mit TBD- und TBR-Metadaten markieren und sie im TBD/TBR-Register finden
- Die Masse eines Parts in Budgets & TPMs aufsummieren
Schreiben Sie SysML-v2-Constraints und -Berechnungen in Holarch, nach dem SysML-v2-Tutorial „Constraints and Calculations“ an einem kleinen Hybrid-Car-Projekt: eine Constraint-Definition und eine Berechnung, eine an die Werte der Limousine gebundene Constraint-Usage, eine Parametrik-Ansicht, in der die Prüfung scheitert und besteht, „Alle lösen“, ein Analysis Case, TBD- und TBR-Werte mit ihrem Register und eine Massenaufsummierung in Budgets. 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).
- Öffnen Sie Ihr Demoprojekt Hybrid Car (erstellen Sie es bei Bedarf: Projekte verwalten → Projektdateien ▾ → Neues Demoprojekt → Hybridauto (SysML v2)), öffnen Sie Modell → Editor und das Package
VehicleRequirements. - Fügen Sie nach
constraint def SpeedLimitconstraint sedanBatteryCheck : MassLimit { in mass = fleet.sedan.powertrain.battery.mass; in limit = 50 [kg]; }hinzu. - Klicken Sie auf der Seite Diagramme auf + Neues Diagramm, wählen Sie Parametrik-Ansicht und unter Zeigt
VehicleRequirementsund klicken Sie auf Erstellen. Die neue Prüfung besteht: 48 kg liegen innerhalb von 50 kg. - Ändern Sie im Package
Vehiclesdie Masse der Limousinenbatterie auf52 [kg]; die Ansicht zeigt, dass die Prüfung scheitert. Drücken Sie ⌘Z / Ctrl+Z und klicken Sie dann auf Alle lösen, um jeden Constraint erneut zu prüfen. - Ersetzen Sie in
requirement def <'VR-2'> Accelerationattribute zeroToHundred : TimeValue;durchattribute zeroToHundred : TimeValue { @TBD { owner = "Test lead"; rationale = "The test track is not booked yet."; } }. Öffnen Sie Bedarfe & Anforderungen → TBD/TBR und finden Sie die Anforderung mit ihrem Verantwortlichen. - Öffnen Sie Architektur → Budgets & TPMs, klicken Sie auf Wurzelteil auswählen… und wählen Sie
sedan. Wählen Sie unter Menge Mass und suchen Sie die 48 kg der Batterie.
Sie sind fertig, wenn sedanBatteryCheck in der Parametrik-Ansicht Bestanden zeigt und das TBD/TBR-Register die Anforderung Acceleration mit dem Verantwortlichen Test lead auflistet.
Selbsttest
- Was ist der Unterschied zwischen einer
constraint defund einercalc def? - Ein Constraint in der Parametrik-Ansicht zeigt „Eingabe erforderlich“. Was fehlt?
- Warum markiert man einen offenen Wert mit
#TBDoder@TBD { … }, statt TBD als Wert zu schreiben? - Was fügt ein Analysis Case einer Berechnung hinzu?
Antworten anzeigen
Was ist der Unterschied zwischen einer
constraint defund einercalc def?Eine Constraint-Definition formuliert eine Bedingung über ihre Parameter, die gilt oder nicht, etwa
mass <= limit. Eine Calculation-Definition berechnet einen Wert und gibt ihn zurück, etwareturn ratio = power / mass;.Ein Constraint in der Parametrik-Ansicht zeigt „Eingabe erforderlich“. Was fehlt?
Ein Parameter hat noch keinen Wert. Binden Sie jeden Parameter an einen Wert, zum Beispiel
in mass = fleet.sedan.curbMass;.Warum markiert man einen offenen Wert mit
#TBDoder@TBD { … }, statt TBD als Wert zu schreiben?TBDanstelle eines Werts ist kein gültiges SysML. Die Metadaten aus dem Holarch-PackageHolarchMetadatahalten den Text gültig; TBD und TBR spezialisieren die Standard-MetadatenStatusInfo, sodass andere SysML-v2-Werkzeuge sie als Statusannotationen lesen.Was fügt ein Analysis Case einer Berechnung hinzu?
Er wendet die Berechnung auf ein Subjekt an, etwa die Limousine, gibt das Ergebnis zurück und hat ein Ziel, dessen require-Constraint Holarch wie jeden anderen Constraint auswertet.
Weiterlesen
- Tutorial: Constraints and Calculations (SysML-v2-Tutorials)
- Dokumentation: SysML-v2-Analyse, Constraints in einer Parametrik-Ansicht prüfen
- Dokumentation: SysML-v2-Analyse, Werte lösen
- Dokumentation: Anforderungen in SysML-v2-Projekten, Einen Wert als TBD oder TBR markieren
- Dokumentation: SysML-v2-Analyse, Ein Budget aufsummieren
- Hilfe: Budgets und TPMs in SysML-v2-Projekten
Transkript
Transkript anzeigen (Erzählung und Bildschirminhalt)
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.