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.
Ü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
- 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. - Legen Sie im Abschnitt Simulation des Inspektors Dauer (einen festen Wert oder eine Verteilung), Wahrscheinlichkeit (%), Iterationen oder Wahrscheinlichkeit von then (%) fest.
- 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. - 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
- Öffnen Sie den Editor.
- Fügen Sie die Annotation im Rumpf des Elements als
@HolarchSimulation::Kind { field = value; }hinzu, oder danach alsmetadata HolarchSimulation::Kind about element { … }. - 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.
- Klicken Sie auf Simulationseinstellungen in das Modell verschieben….
- Die Vorschau listet jede Einstellung und die Annotation auf, die sie ersetzt.
- 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.
- Öffnen Sie Verhalten → Simulator und wählen Sie eine Zustandsdefinition oder einen Part, der Zustände zeigt (exhibit), als Wurzel.
- Optional: Wählen Sie unter Zusammen ausführen mit eine Szenario-Action, die Signale an den Part sendet, etwa TestDrive aus der Demo.
- 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).
- 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.
- 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
toCruisenachshifthat Probability 70; derelse-Zweig erhält die übrigen 30 %.cruisedauert 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;
driveConsumes 1,5 Wh davon und hat Cost von 0,4 USD pro Verwendung. - PowertrainStates: Der Übergang
startElectrichat für seinen Guard Probability 80;accept when charge < 15wechselt auf Hybrid, wenn die Ladung sinkt;accept after 30 [min]beendet das Laden. - TestDrive: ein Szenario, das
StartRequestsendet, eine Stunde wartet und dannStopRequestundPlugInandemoCarsendet. 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
- Auswertung, Einheiten und Analyse in SysML v2-Projekten: wie der Simulator Schritte, Successions und Dauern liest.
- Simulation: die Seite Simulator, ihre Bereiche und die Monte-Carlo-Statistiken.
- SysML v2-Textnotation: Metadaten und
aboutim Text.
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.
| Annotation | Felder | Bedeutung |
|---|---|---|
| Normalverteilung | mean, sd | Normalverteilung. |
| Dreiecksverteilung | low, mode, high | Dreiecksverteilung, mit low ≤ mode ≤ high. |
| Gleichverteilung | low, high | Gleichverteilung zwischen low und high. |
| Exponential | mean | Exponentialverteilung mit dem angegebenen Mittelwert. |
| Gamma | shape, scale | Gammaverteilung; der Mittelwert ist shape × scale. |
| LogNormal | median, sigma | Der Logarithmus ist normalverteilt um den Logarithmus des Medians. |
| Weibull | scale, shape | Weibull-Verteilung. |
| Beta | alpha, beta, scale | Betaverteilung auf 0..1, mal scale. |
| Poisson | mean, scale | Eine Anzahl mit dem angegebenen Mittelwert, mal scale. |
| Binomial | trials, p, scale | Erfolge 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; }
| Annotation | An | Bedeutung |
|---|---|---|
Correlation coefficient | about a, b: zwei Attribute, jedes mit einer Verteilung | Die 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.
ChargeStopin der Hybrid-Car-Demo korreliert die Wartezeit auf ein freies Ladegerät mit der Ladezeit (0,6).
Wahrscheinlichkeiten und Anzahlen
| Annotation | An | Bedeutung |
|---|---|---|
Probability percent | Eine Succession aus einer Entscheidung | Das Gewicht des Zweigs. Zweige ohne eines teilen sich den Rest von 100. |
Eine if-Action | Die Wahrscheinlichkeit des then-Zweigs, wenn die Bedingung nicht ausgewertet werden kann. | |
| Eine Schleifen-Action | Die Wahrscheinlichkeit einer Wiederholung nach jedem Durchlauf. | |
| Ein Übergang | Die Wahrscheinlichkeit, dass sein Guard gilt, wenn der Guard nicht ausgewertet werden kann. | |
LoopCount count | Eine Schleifen-Action | Die Anzahl der Durchläufe; sie hat Vorrang vor den Bedingungen der Schleife. |
| LoopExit | Eine Succession nach done in einem Schleifenrumpf | Beendet die ganze Schleife, nicht nur den Durchlauf. |
Ressourcen und Kosten
| Annotation | An | Bedeutung |
|---|---|---|
Resource initial, minimum, maximum, unit | Eine Part- oder Item-Verwendung | Ein Vorrat einer Menge. Deklariert die Verwendung attribute level : Real, hält der Simulator es gleich der Menge, sodass Guards es lesen können. |
Consumes amount | about step, pool | Wird beim Start des Schritts entnommen. |
Produces amount | about step, pool | Wird beim Ende des Schritts hinzugefügt. |
Seizes amount | about step, pool | Wird beim Start des Schritts entnommen und an seinem Ende zurückgegeben. |
Utilization amount | Eine Perform-Action-Verwendung | Wie viel des ausführenden Parts der Schritt belegt. |
Cost amount, rate, unit, label | Ein Schritt oder ein ausführender Part | Kosten pro Verwendung (CostRate::perUse) oder pro Stunde (CostRate::perHour). |
Annotationen, die die SysML-Engine benötigen
| Annotation | Bedeutung |
|---|---|
Transfer latency, capacity, per | An einer Verbindung oder einem Interface: verzögert darüber gesendete Items und Signale. |
Size size | An einem Item: seine Größe für Übertragungsverzögerungen. |
Timeout limit | An einem Join: stoppt nicht beendete Zweige, wenn das Limit abläuft. |
NotBefore time | An einem Schritt: Er startet nicht vor dieser Laufzeit. |
| ForkTargets, JoinSources | An einem Übergang in einen oder aus einem parallelen Zustand: die betretenen Unterzustände oder die Unterzustände, die aktiv sein müssen. |
History deep | An einem zusammengesetzten Zustand: Erneutes Betreten setzt den Unterzustand fort, der beim Verlassen aktiv war. |
HostHook key, points | Fü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
| Nachricht | Bedeutung |
|---|---|
| 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.
Verwandte Themen
SysML® und OMG® sind eingetragene Marken der Object Management Group, Inc. in den Vereinigten Staaten und anderen Ländern.