Holarch

SysML v2

Simulationsmetadaten in SysML v2-Projekten

Die Metadatenbibliothek HolarchSimulation: wie ein SysML v2-Modell Dauern, Verzweigungswahrscheinlichkeiten, Schleifenzahlen, Ressourcen, Kosten und Zustandsautomaten-Einstellungen für den Simulator trägt, und wie Sie sie schreiben und verschieben.

So gehen Sie vor →

Auf dieser Seite
  1. Überblick
  2. Konzepte
    1. Nennwert und Verteilung
    2. Welche Einstellungen gelten
    3. Zwei Simulatoren
  3. So setzen Sie es ein
    1. Wann und warum
    2. Eine Dauer, Wahrscheinlichkeit oder Schleifenanzahl festlegen
    3. Annotationen in den Text schreiben
    4. Ältere Einstellungen in das Modell verschieben
    5. Einen Zustandsautomaten simulieren
    6. Ausgeführtes Beispiel: die Hybrid-Car-Demo
    7. Tipps und bewährte Vorgehensweisen
    8. Häufige Fehler
    9. Zusammenhänge
  4. Annotationen
    1. Verteilungen
    2. Korrelierte Eingaben
    3. Wahrscheinlichkeiten und Anzahlen
    4. Ressourcen und Kosten
    5. Annotationen, die die SysML-Engine benötigen
  5. Meldungen
  6. Grenzen
  7. Verwandte Themen

Überblick

In einem SysML v2-Projekt sind die Einstellungen des Simulators Teil des Modells. Es sind Metadatenannotationen aus dem Bibliotheks-Package HolarchSimulation, das jedes SysML v2-Projekt lädt. Ein Modell, das sie verwendet, bleibt gültiges SysML v2: Andere Werkzeuge lesen die Annotationen als gewöhnliche Metadaten, und nur der Simulator gibt ihnen eine Bedeutung.

Eine Annotation steht entweder innerhalb des Elements, das sie annotiert, oder nennt dieses Element mit about:

succession toCruise first shift if speed > 30 then cruise {
  @HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }

Konzepte

Nennwert und Verteilung

Die Dauer eines Schritts ist sein Attribut duration (oder ein mit DurationValue oder TimeValue typisiertes Attribut). Sein Wert ist die Nenndauer, die andere Werkzeuge und Holarchs Auswertung sehen. Eine Verteilungsannotation an diesem Attribut lässt den Simulator die Dauer stattdessen ziehen:

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

Welche Einstellungen gelten

  • Eine Verteilungsannotation hat Vorrang vor dem eigenen Wert des Attributs.
  • Ein Guard, eine if-Bedingung oder eine Schleifenbedingung, die das Modell auswerten kann, entscheidet selbst. Eine Probability oder ein LoopCount wird nur verwendet, wenn es das nicht kann (ein LoopCount zählt die Durchläufe immer).
  • Einstellungen, die vorgenommen wurden, bevor die Simulationseinstellungen in das Modell wanderten, bleiben als Holarch-Daten neben dem Modell erhalten. Sie haben weiterhin Vorrang, sodass Läufe dieselben Ergebnisse liefern, bis Sie sie hineinverschieben (siehe Ältere Einstellungen in das Modell verschieben).

Zwei Simulatoren

Die Seite Simulator zeigt rechts neben den Einstellungen, welcher Simulator das Modell ausführt: SysML-Engine (der Simulator der Holarch Language Engine) oder JavaScript-Simulator. Beide lesen dieselben Annotationen. Zustandsautomaten, Stimuli, Ressourcen aus Resource, Consumes, Produces und Seizes, Kosten aus Cost und die übrigen Annotationen unter Annotationen, die die SysML-Engine benötigen laufen nur mit der SysML-Engine.

So setzen Sie es ein

Wann und warum

Schreiben Sie Simulationseinstellungen in das Modell, wenn das Modell die maßgebliche Aufzeichnung des Entwurfs ist: Die Zahlen reisen mit den .sysml-Dateien, erscheinen in Reviews des Textes und werden mit dem Rest des Modells versioniert. Verwenden Sie sie, während Sie ein Betriebsszenario analysieren (Zeitleisten, Verzweigungsanteile, Ressourcennutzung), und bevor Sie eine Anforderung gegen eine Monte-Carlo-Studie prüfen.

Eine Dauer, Wahrscheinlichkeit oder Schleifenanzahl festlegen

  1. Wählen Sie den Schritt, die Succession, die Entscheidung, die Schleife oder die if-Action in einer Action Flow View, im Browser oder im Editor aus.
  2. Legen Sie im Abschnitt Simulation des Inspektors Dauer (einen festen Wert oder eine Verteilung), Wahrscheinlichkeit (%), Iterationen oder Wahrscheinlichkeit von then (%) fest.
  3. Holarch schreibt die Annotation in das Modell: Dauer setzt den Wert des Attributs auf den Mittelwert und fügt die Verteilungsannotation hinzu (oder schreibt attribute duration : ISQ::DurationValue, wenn der Schritt keines hat); Wahrscheinlichkeit (%) schreibt Probability; Iterationen schreibt LoopCount. Jede Änderung lässt sich mit einem einzigen Rückgängigmachen zurücknehmen und erscheint sofort im Text.
  4. Leeren Sie ein Feld, um seine Annotation zu entfernen.

Holarch prüft jede Änderung mit dem SysML-Checker, bevor es sie schreibt. Eine Änderung, die einen Fehler hinzufügen würde, wird nicht geschrieben, und eine Meldung nennt das Problem.

Annotationen in den Text schreiben

  1. Öffnen Sie den Editor.
  2. Fügen Sie die Annotation im Rumpf des Elements als @HolarchSimulation::Kind { field = value; } hinzu, oder danach als metadata HolarchSimulation::Kind about element { … }.
  3. Nennen Sie bei Consumes, Produces und Seizes zuerst den Schritt und dann die Ressource: metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.

Ältere Einstellungen in das Modell verschieben

Projekte, deren Simulationseinstellungen vorgenommen wurden, bevor diese in das Modell wanderten, zeigen über den Einstellungen des Simulators Einige Simulationseinstellungen dieses Projekts sind Holarch-Daten und nicht Teil des Modells.

  1. Klicken Sie auf Simulationseinstellungen in das Modell verschieben….
  2. Die Vorschau listet jede Einstellung und die Annotation auf, die sie ersetzt.
  3. Klicken Sie auf In das Modell verschieben. Alle Einstellungen werden verschoben, und ein einziges Rückgängigmachen nimmt alles zurück; Läufe liefern dieselben Ergebnisse.

Einen Zustandsautomaten simulieren

Zustandsautomaten laufen mit der SysML-Engine.

  1. Öffnen Sie Verhalten → Simulator und wählen Sie eine Zustandsdefinition oder einen Part, der Zustände zeigt (exhibit), als Wurzel.
  2. Optional: Wählen Sie unter Zusammen ausführen mit eine Szenario-Action, die Signale an den Part sendet, etwa TestDrive aus der Demo.
  3. Klicken Sie unter Stimuli auf + Stimulus hinzufügen und legen Sie Bei (Zeit und Einheit), Signal und An fest (einen Automaten oder Jeder Automat, der es akzeptiert).
  4. Drücken Sie ▶ Start, ⏭ Schritt oder ⏩ Bis zum Ende ausführen. Zustandsautomat während der Ausführung lässt die aktiven Zustände leuchten und markiert den ausgelösten Übergang; die Registerkarte Zustände zeigt States over time und Transitions fired.
  5. In Monte Carlo zeigt die Registerkarte Zustände Zeit im Zustand und Transition counts. Gegen Requirement prüfen… bietet die Zeit im Zustand und den Anteil am Lauf für jeden Zustand als Ausgaben an.

In einer State Transition View öffnet ▶ Simulieren eine Leiste mit ▶ Start, ⏭ Schritt, ⏩ Bis zum Ende ausführen, Zurücksetzen und Im Simulator öffnen. Der Lauf verwendet die im Simulator für diese Zustandsdefinition gespeicherten Stimuli.

Ausgeführtes Beispiel: die Hybrid-Car-Demo

Die Hybrid-Car-Demo (Projekte verwalten → Projektdateien ▾ → Neues Demoprojekt) verwendet die Bibliothek:

  • DriveCycle: Die Succession toCruise nach shift hat Probability 70; der else-Zweig erhält die übrigen 30 %. cruise dauert nominal 1 min, gezogen aus einer Triangular-Verteilung (45 s, 1 min, 2 min).
  • DrivenCar: Die Batterie des Antriebsstrangs ist eine Resource von 62 Wh; drive Consumes 1,5 Wh davon und hat Cost von 0,4 USD pro Verwendung.
  • PowertrainStates: Der Übergang startElectric hat für seinen Guard Probability 80; accept when charge < 15 wechselt auf Hybrid, wenn die Ladung sinkt; accept after 30 [min] beendet das Laden.
  • TestDrive: ein Szenario, das StartRequest sendet, eine Stunde wartet und dann StopRequest und PlugIn an demoCar sendet. Führen Sie Demo Car zusammen mit Test Drive aus, um zu sehen, wie der Antriebsstrang die Zustände wechselt.

Die Demo wird mit 0 Diagnosen geprüft.

Tipps und bewährte Vorgehensweisen

  • Halten Sie den Nennwert aussagekräftig: Setzen Sie ihn auf den Erwartungswert der Verteilung, wie es der Inspektor tut.
  • Benennen Sie Successions, die Sie annotieren (succession toCruise first …), damit die Annotation im Text leicht zu finden ist.
  • Bevorzugen Sie Bedingungen, die das Modell auswerten kann, gegenüber Wahrscheinlichkeiten; verwenden Sie Probability für das, was das Modell nicht beschreibt.

Häufige Fehler

  • Eine Wahrscheinlichkeit hat keine Wirkung: Der Guard lässt sich auswerten, also entscheidet er. Der Inspektor sagt "Ergibt true: wird immer genommen." oder "Ergibt false: wird nie genommen."
  • Verzweigungswahrscheinlichkeiten ergeben nicht 100 %: Zweige ohne Probability teilen sich den Rest; übersteigen die angegebenen 100 %, lautet die Warnung "Die Branch-Wahrscheinlichkeiten ergeben zusammen N %. Ändern Sie sie so, dass die Summe 100 % beträgt."
  • Eine Dauerannotation am Schritt selbst: Verteilungen gehören an das Attribut duration, nicht an die Action.

Zusammenhänge

Annotationen

Verteilungen

Setzen Sie eine Verteilung an ein Attribut duration. Lage- und Skalenfelder nehmen eine Größe mit Einheit an (45 [s], 2 [min]); Formfelder nehmen eine Zahl an.

AnnotationFelderBedeutung
Normalverteilungmean, sdNormalverteilung.
Dreiecksverteilunglow, mode, highDreiecksverteilung, mit low ≤ mode ≤ high.
Gleichverteilunglow, highGleichverteilung zwischen low und high.
ExponentialmeanExponentialverteilung mit dem angegebenen Mittelwert.
Gammashape, scaleGammaverteilung; der Mittelwert ist shape × scale.
LogNormalmedian, sigmaDer Logarithmus ist normalverteilt um den Logarithmus des Medians.
Weibullscale, shapeWeibull-Verteilung.
Betaalpha, beta, scaleBetaverteilung auf 0..1, mal scale.
Poissonmean, scaleEine Anzahl mit dem angegebenen Mittelwert, mal scale.
Binomialtrials, p, scaleErfolge in einer Anzahl von Versuchen, mal scale.

Dauern, die unter null gezogen werden, werden neu gezogen.

Korrelierte Eingaben

Ohne Korrelation ist jeder aus einer Verteilung gezogene Wert von den anderen unabhängig. Correlation lässt zwei davon gemeinsam variieren:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
AnnotationAnBedeutung
Correlation coefficientabout a, b: zwei Attribute, jedes mit einer VerteilungDie Rangkorrelation (Spearman) ihrer Werte, von -1 bis 1. 0 bedeutet unabhängig, 1 ordnet sie immer gleich, -1 entgegengesetzt.
  • Jedes Attribut behält seine eigene Verteilung. Der Simulator fügt alle Paare zu einer Korrelationsmatrix zusammen (einer Gauß-Copula): Der n-te in einem Lauf für ein Attribut gezogene Wert gehört zum n-ten Wert jedes Attributs, mit dem es korreliert ist.
  • Die Koeffizienten einer Gruppe korrelierter Attribute müssen zueinander passen: a stark mit b, b stark mit c, aber a entgegengesetzt zu c ist unmöglich. Die Prüfung meldet eine solche Gruppe; schwächen Sie einen der Koeffizienten ab.
  • Dauern und Mengen (Consumes, Produces, Seizes) korrelieren gleichermaßen. Ein Lauf mit demselben Seed liefert dieselben Werte.
  • Im Simulator listet Korrelierte Eingaben im Modus Monte Carlo mit der SysML-Engine die Paare der Wurzel auf. Wählen Sie zwei Attribute und einen Koeffizienten und klicken Sie auf + Korrelation hinzufügen, ändern Sie einen Koeffizienten oder klicken Sie auf ×, um einen zu entfernen; ein einziges Rückgängigmachen nimmt jede Änderung zurück. Nach einer Studie zeigt Erreicht die Rangkorrelation der Werte, die die Läufe gezogen haben.
  • ChargeStop in der Hybrid-Car-Demo korreliert die Wartezeit auf ein freies Ladegerät mit der Ladezeit (0,6).

Wahrscheinlichkeiten und Anzahlen

AnnotationAnBedeutung
Probability percentEine Succession aus einer EntscheidungDas Gewicht des Zweigs. Zweige ohne eines teilen sich den Rest von 100.
Eine if-ActionDie Wahrscheinlichkeit des then-Zweigs, wenn die Bedingung nicht ausgewertet werden kann.
Eine Schleifen-ActionDie Wahrscheinlichkeit einer Wiederholung nach jedem Durchlauf.
Ein ÜbergangDie Wahrscheinlichkeit, dass sein Guard gilt, wenn der Guard nicht ausgewertet werden kann.
LoopCount countEine Schleifen-ActionDie Anzahl der Durchläufe; sie hat Vorrang vor den Bedingungen der Schleife.
LoopExitEine Succession nach done in einem SchleifenrumpfBeendet die ganze Schleife, nicht nur den Durchlauf.

Ressourcen und Kosten

AnnotationAnBedeutung
Resource initial, minimum, maximum, unitEine Part- oder Item-VerwendungEin Vorrat einer Menge. Deklariert die Verwendung attribute level : Real, hält der Simulator es gleich der Menge, sodass Guards es lesen können.
Consumes amountabout step, poolWird beim Start des Schritts entnommen.
Produces amountabout step, poolWird beim Ende des Schritts hinzugefügt.
Seizes amountabout step, poolWird beim Start des Schritts entnommen und an seinem Ende zurückgegeben.
Utilization amountEine Perform-Action-VerwendungWie viel des ausführenden Parts der Schritt belegt.
Cost amount, rate, unit, labelEin Schritt oder ein ausführender PartKosten pro Verwendung (CostRate::perUse) oder pro Stunde (CostRate::perHour).

Annotationen, die die SysML-Engine benötigen

AnnotationBedeutung
Transfer latency, capacity, perAn einer Verbindung oder einem Interface: verzögert darüber gesendete Items und Signale.
Size sizeAn einem Item: seine Größe für Übertragungsverzögerungen.
Timeout limitAn einem Join: stoppt nicht beendete Zweige, wenn das Limit abläuft.
NotBefore timeAn einem Schritt: Er startet nicht vor dieser Laufzeit.
ForkTargets, JoinSourcesAn einem Übergang in einen oder aus einem parallelen Zustand: die betretenen Unterzustände oder die Unterzustände, die aktiv sein müssen.
History deepAn einem zusammengesetzten Zustand: Erneutes Betreten setzt den Unterzustand fort, der beim Verlassen aktiv war.
HostHook key, pointsFür Holarch reserviert: Der Lauf pausiert an den aufgeführten Punkten für eine Eingabe.

Der JavaScript-Simulator liest Probability, LoopCount und die Verteilungen.

Meldungen

NachrichtBedeutung
Einige Simulationseinstellungen dieses Projekts sind Holarch-Daten und nicht Teil des Modells.Ältere Einstellungen sind noch neben dem Modell gespeichert. Klicken Sie auf Simulationseinstellungen in das Modell verschieben….
Holarch-Daten aus der Zeit, bevor die Simulationseinstellungen in das Modell wanderten; sie haben Vorrang vor dem Modell.Wird im Abschnitt Simulation des Inspektors angezeigt. Ändern Sie das Feld, um es in das Modell zu schreiben, oder verschieben Sie alle Einstellungen im Simulator.
Keine Dauer im Modell. Legen Sie hier eine fest (sie schreibt attribute duration : ISQ::DurationValue) oder schreiben Sie sie im Text.Der Schritt hat kein Attribut duration.
@Normal: sd must be greater than zero. Change sd. (und Ähnliches für andere Verteilungen und Parameter)Ein Verteilungsparameter fehlt oder liegt außerhalb des Bereichs. Mit der SysML-Engine meldet die Modellprüfung ihn im Editor, und der Simulator verweigert die Ausführung, bis er korrigiert ist.
@Normal: sd has another unit dimension than …Ein Lage- oder Skalenparameter hat andere Einheiten als das Attribut, zum Beispiel Meter bei einer Dauer.
@LoopCount does not apply to a part …Die Annotation steht an einer Elementart, für die sie nicht gilt. Verschieben oder löschen Sie sie.
metadata Consumes … about needs an action and a part or item annotated @Resource.Die Elemente nach about stimmen in Anzahl oder Art nicht.
A probability of N % is outside 0 to 100.Geben Sie einen Prozentwert von 0 bis 100 ein.
The branch probabilities of this decision add up to N %; the simulator scales them to 100 %.Eine Warnung: Jeder Zweig hat ein Gewicht, und sie ergeben zusammen nicht 100.
A correlation needs two different attributes …, … is not an attribute … oder … has no distribution, so nothing is drawn to correlate …Eine Correlation nennt ein Attribut zweimal, etwas, das kein Attribut ist, oder ein Attribut ohne Verteilung.
The coefficient N is outside -1 to 1. oder The correlation has no coefficient.Geben Sie einen Koeffizienten von -1 bis 1 ein.
“a” and “b” are already correlated; the first correlation is used. …Eine Warnung: Eine zweite Correlation desselben Paars wird ignoriert. Entfernen Sie eine der beiden.
The correlations of … contradict each other: no joint distribution has them …Die Koeffizienten einer Gruppe können nicht zusammen gelten (die Matrix ist nicht positiv semidefinit). Schwächen Sie einen ab. Der Simulator verweigert die Ausführung, bis dies korrigiert ist.
Deadlock bei <time>: N Schritte warten auf etwas, das nie eintrifft.Wird mit der SysML-Engine über den Ergebnissen angezeigt, mit jedem wartenden Schritt. Ein accept ohne Sender, ein nie erzeugtes Item oder eine nie freigegebene Ressource stoppt den Lauf.

Grenzen

  • Dauern werden in Sekunden, Minuten, Stunden oder Tagen geschrieben (SI::s, SI::min, SI::h, SI::d). Millisekunden werden als Sekunden geschrieben, Wochen, Monate und Jahre als Tage.
  • Zustandsautomaten, Stimuli und Zusammen ausführen mit benötigen die SysML-Engine.
  • Korrelierte Eingaben benötigen die SysML-Engine; der JavaScript-Simulator zieht jeden Wert unabhängig. Höchstens 200 Attribute lassen sich in einer Gruppe korrelieren.
  • Die Prüfung widersprüchlicher Koeffizienten umfasst die in einem Namensraum geschriebenen Korrelationen; der Simulator prüft alle Korrelationen des Laufs.

SysML® und OMG® sind eingetragene Marken der Object Management Group, Inc. in den Vereinigten Staaten und anderen Ländern.