SysML v2
Metadane symulacji w projektach SysML v2
Biblioteka metadanych HolarchSimulation: jak model SysML v2 przenosi czasy trwania, prawdopodobieństwa gałęzi, liczby powtórzeń pętli, zasoby, koszty i ustawienia maszyn stanów dla Symulatora oraz jak je zapisywać i przenosić.
Przegląd
W projekcie SysML v2 ustawienia Symulatora są częścią modelu. Są to adnotacje metadanych z pakietu biblioteki HolarchSimulation, który ładuje każdy projekt SysML v2. Model, który z nich korzysta, pozostaje poprawnym modelem SysML v2: inne narzędzia odczytują adnotacje jako zwykłe metadane, a znaczenie nadaje im tylko Symulator.
Adnotacja albo znajduje się wewnątrz elementu, który opisuje, albo wskazuje ten element za pomocą 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"; }
Pojęcia
Wartość nominalna i rozkład
Czas trwania kroku to jego atrybut duration (lub atrybut typu DurationValue albo TimeValue). Jego wartość to nominalny czas trwania widziany przez inne narzędzia i przez obliczenia Holarch. Adnotacja rozkładu na tym atrybucie sprawia, że Symulator zamiast tego losuje czas trwania:
action cruise {
attribute duration : ISQ::DurationValue = 1 [min] {
@HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
}
}
Które ustawienia mają pierwszeństwo
- Adnotacja rozkładu ma pierwszeństwo przed własną wartością atrybutu.
- Warunek dozoru, warunek
iflub warunek pętli, który model może obliczyć, rozstrzyga sam. Probability lub LoopCount jest używane tylko wtedy, gdy nie może (LoopCount zawsze liczy przejścia). - Ustawienia wprowadzone, zanim ustawienia symulacji zostały przeniesione do modelu, są przechowywane jako dane Holarch obok modelu. Nadal mają pierwszeństwo, więc przebiegi dają te same wyniki, dopóki ich nie przeniesiesz (zobacz Przenoszenie starszych ustawień do modelu).
Dwa symulatory
Strona Symulatora pokazuje po prawej stronie ustawień, który symulator wykonuje model: Silnik SysML (symulator Holarch Language Engine) lub Symulator JavaScript. Oba odczytują te same adnotacje. Maszyny stanów, bodźce, zasoby z Resource, Consumes, Produces i Seizes, koszty z Cost oraz pozostałe adnotacje opisane w sekcji Adnotacje wymagające silnika SysML działają tylko z silnikiem SysML.
Jak z niego korzystać
Kiedy i dlaczego
Zapisuj ustawienia symulacji w modelu, gdy model jest zapisem projektu: liczby przemieszczają się razem z plikami .sysml, pojawiają się w przeglądach tekstu i są wersjonowane razem z resztą modelu. Używaj ich podczas analizy scenariusza operacyjnego (osie czasu, udziały gałęzi, wykorzystanie zasobów) i przed sprawdzeniem wymagania względem badania Monte Carlo.
Ustawianie czasu trwania, prawdopodobieństwa lub liczby przejść pętli
- Zaznacz krok, następstwo, decyzję, pętlę lub akcję
ifw widoku przepływu akcji, w Przeglądarce lub w Edytorze. - W sekcji Symulacja inspektora ustaw Czas trwania (wartość stałą lub rozkład), Prawdopodobieństwo (%), Iteracje lub Prawdopodobieństwo then (%).
- Holarch zapisuje adnotację w modelu: Czas trwania ustawia wartość atrybutu na średnią i dodaje adnotację rozkładu (lub zapisuje
attribute duration : ISQ::DurationValue, gdy krok go nie ma); Prawdopodobieństwo (%) zapisuje Probability; Iteracje zapisuje LoopCount. Każdą zmianę można cofnąć jednym poleceniem Cofnij i od razu pojawia się ona w tekście. - Wyczyść pole, aby usunąć jego adnotację.
Holarch sprawdza każdą zmianę mechanizmem sprawdzającym SysML przed jej zapisaniem. Zmiana, która dodałaby błąd, nie jest zapisywana, a komunikat wskazuje problem.
Pisanie adnotacji w tekście
- Otwórz Edytor.
- Dodaj adnotację wewnątrz treści elementu jako
@HolarchSimulation::Kind { field = value; }lub po nim jakometadata HolarchSimulation::Kind about element { … }. - Dla Consumes, Produces i Seizes podaj najpierw krok, a potem zasób:
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.
Przenoszenie starszych ustawień do modelu
Projekty, których ustawienia symulacji zostały wprowadzone przed przeniesieniem ich do modelu, pokazują nad ustawieniami Symulatora komunikat Niektóre ustawienia symulacji tego projektu to dane Holarch, a nie część modelu.
- Kliknij Przenieś ustawienia symulacji do modelu….
- Podgląd wymienia każde ustawienie i adnotację, która je zastępuje.
- Kliknij Przenieś do modelu. Wszystkie ustawienia zostają przeniesione, a jedno polecenie Cofnij wycofuje całość; przebiegi dają te same wyniki.
Symulacja maszyny stanów
Maszyny stanów działają z silnikiem SysML.
- Otwórz Zachowanie → Symulator i wybierz definicję stanu lub część wykazującą stany jako Korzeń.
- Opcjonalnie: w polu Uruchom razem z wybierz akcję scenariusza, która wysyła sygnały do części, na przykład TestDrive z projektu demonstracyjnego.
- W sekcji Bodźce kliknij + Dodaj bodziec i ustaw W chwili (czas i jednostka), Sygnał i Do (maszyna lub Każda maszyna, która go przyjmuje).
- Naciśnij ▶ Odtwórz, ⏭ Krok lub ⏩ Uruchom do końca. Maszyna stanów w trakcie przebiegu podświetla aktywne stany i oznacza przejście, które zostało wyzwolone; karta Stany pokazuje Stany w czasie i Wyzwolone przejścia.
- W trybie Monte Carlo karta Stany pokazuje Czas w stanie i Liczby przejść. Sprawdź względem Requirement… oferuje jako wyjścia czas w stanie i udział w przebiegu dla każdego stanu.
W widoku przejść stanów ▶ Symuluj otwiera pasek z przyciskami ▶ Odtwórz, ⏭ Krok, ⏩ Uruchom do końca, Resetuj i Otwórz w Symulatorze. Przebieg korzysta z bodźców zapisanych w Symulatorze dla tej definicji stanu.
Przykład: projekt demonstracyjny Hybrid Car
Projekt demonstracyjny Hybrid Car (Zarządzaj projektami → Pliki projektów ▾ → Nowy projekt demonstracyjny) korzysta z biblioteki:
- DriveCycle: następstwo
toCruiseposhiftma Probability 70; gałąźelseotrzymuje pozostałe 30 %.cruisetrwa nominalnie 1 min, losowane z rozkładu Triangular (45 s, 1 min, 2 min). - DrivenCar: akumulator układu napędowego to Resource o pojemności 62 Wh;
drivezużywa (Consumes) z niego 1.5 Wh i ma Cost 0.4 USD za użycie. - PowertrainStates: przejście
startElectricma Probability 80 dla swojego warunku dozoru;accept when charge < 15przełącza na tryb hybrydowy, gdy poziom naładowania spada;accept after 30 [min]kończy ładowanie. - TestDrive: scenariusz, który wysyła
StartRequest, czeka godzinę, a następnie wysyłaStopRequestiPlugIndodemoCar. Uruchom Demo Car razem z Test Drive, aby zobaczyć, jak układ napędowy zmienia stany.
Projekt demonstracyjny przechodzi kontrolę z 0 komunikatami diagnostycznymi.
Wskazówki i dobre praktyki
- Zachowaj sens wartości nominalnej: ustaw ją na wartość oczekiwaną rozkładu, tak jak robi to inspektor.
- Nazywaj następstwa, które opatrujesz adnotacjami (
succession toCruise first …), aby łatwo było znaleźć adnotację w tekście. - Przedkładaj warunki, które model może obliczyć, nad prawdopodobieństwa; używaj Probability dla tego, czego model nie opisuje.
Typowe błędy
- Prawdopodobieństwo nie działa: warunek dozoru można obliczyć, więc to on rozstrzyga. Inspektor podaje “Daje true: zawsze jest wybierana.” lub “Daje false: nigdy nie jest wybierana.”
- Prawdopodobieństwa gałęzi nie sumują się do 100 %: gałęzie bez Probability dzielą to, co zostaje; gdy podane wartości przekraczają 100 %, ostrzeżenie brzmi “Branch probabilities add up to N %. Change them to total 100 %.” (prawdopodobieństwa gałęzi sumują się do N %).
- Adnotacja czasu trwania na samym kroku: rozkłady należy umieszczać na atrybucie czasu trwania, a nie na akcji.
Powiązania z innymi funkcjami
- Ewaluacja, jednostki i analiza w projektach SysML v2: jak Symulator odczytuje kroki, następstwa i czasy trwania.
- Symulacja: strona Symulatora, jej panele i statystyki Monte Carlo.
- Notacja tekstowa SysML v2: metadane i
aboutw tekście.
Adnotacje
Rozkłady
Umieść rozkład na atrybucie czasu trwania. Pola położenia i skali przyjmują wielkość z jednostką (45 [s], 2 [min]); pola kształtu przyjmują liczbę.
| Adnotacja | Pola | Znaczenie |
|---|---|---|
| Normalny | mean, sd | Rozkład normalny. |
| Trójkątny | low, mode, high | Trójkątny, z low ≤ mode ≤ high. |
| Jednostajny | low, high | Jednostajny między low i high. |
| Exponential | mean | Wykładniczy o podanej średniej. |
| Gamma | shape, scale | Gamma; średnia to shape × scale. |
| LogNormal | median, sigma | Logarytm ma rozkład normalny wokół logarytmu mediany. |
| Weibull | scale, shape | Weibulla. |
| Beta | alpha, beta, scale | Beta na 0..1, pomnożony przez scale. |
| Poisson | mean, scale | Liczba zdarzeń o podanej średniej, pomnożona przez scale. |
| Binomial | trials, p, scale | Liczba sukcesów w określonej liczbie prób, pomnożona przez scale. |
Czasy trwania wylosowane poniżej zera są losowane ponownie.
Skorelowane dane wejściowe
Bez korelacji każda wartość losowana z rozkładu jest niezależna od pozostałych. Correlation sprawia, że dwie z nich zmieniają się razem:
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| Adnotacja | Na | Znaczenie |
|---|---|---|
Correlation coefficient | about a, b: dwa atrybuty, każdy z rozkładem | Korelacja rangowa (Spearmana) ich wartości, od -1 do 1. 0 oznacza niezależność, 1 zawsze takie samo uporządkowanie, -1 odwrotne. |
- Każdy atrybut zachowuje własny rozkład. Symulator łączy wszystkie pary w jedną macierz korelacji (kopuła Gaussa): n-ta wartość wylosowana dla atrybutu w przebiegu idzie w parze z n-tą wartością każdego atrybutu, z którym jest skorelowany.
- Współczynniki grupy skorelowanych atrybutów muszą do siebie pasować: a silnie z b, b silnie z c, ale a odwrotnie do c jest niemożliwe. Kontrola zgłasza taką grupę; osłab jeden ze współczynników.
- Czasy trwania i ilości (Consumes, Produces, Seizes) korelują się tak samo. Przebieg z tym samym ziarnem daje te same wartości.
- W Symulatorze, w trybie Monte Carlo z silnikiem SysML, Skorelowane dane wejściowe wymienia pary korzenia. Wybierz dwa atrybuty i współczynnik, a następnie kliknij + Dodaj korelację, zmień współczynnik lub kliknij ×, aby usunąć parę; jedno polecenie Cofnij wycofuje każdą zmianę. Po badaniu Osiągnięto pokazuje korelację rangową wartości wylosowanych w przebiegach.
ChargeStopw projekcie demonstracyjnym Hybrid Car koreluje czas oczekiwania na wolną ładowarkę z czasem ładowania (0.6).
Szanse i liczby
| Adnotacja | Na | Znaczenie |
|---|---|---|
Probability percent | Następstwo wychodzące z decyzji | Waga gałęzi. Gałęzie bez wagi dzielą to, co zostaje ze 100. |
Akcja if | Szansa gałęzi then, gdy nie można obliczyć warunku. | |
| Akcja pętli | Szansa powtórzenia po każdym przejściu. | |
| Przejście | Szansa, że warunek dozoru jest spełniony, gdy nie można go obliczyć. | |
LoopCount count | Akcja pętli | Liczba przejść; ma pierwszeństwo przed warunkami pętli. |
| LoopExit | Następstwo do done w treści pętli | Kończy całą pętlę, a nie tylko bieżące przejście. |
Zasoby i koszty
| Adnotacja | Na | Znaczenie |
|---|---|---|
Resource initial, minimum, maximum, unit | Użycie części lub obiektu | Pula pewnej ilości. Jeśli użycie deklaruje attribute level : Real, symulator utrzymuje go równym tej ilości, dzięki czemu warunki dozoru mogą go odczytywać. |
Consumes amount | about step, pool | Pobierane, gdy krok się rozpoczyna. |
Produces amount | about step, pool | Dodawane, gdy krok się kończy. |
Seizes amount | about step, pool | Pobierane, gdy krok się rozpoczyna, i zwracane, gdy się kończy. |
Utilization amount | Użycie akcji perform | Jaką część możliwości części wykonującej zajmuje krok. |
Cost amount, rate, unit, label | Krok lub część wykonująca | Koszt za użycie (CostRate::perUse) lub za godzinę (CostRate::perHour). |
Adnotacje wymagające silnika SysML
| Adnotacja | Znaczenie |
|---|---|
Transfer latency, capacity, per | Na połączeniu lub interfejsie: opóźnia przesyłane nim obiekty i sygnały. |
Size size | Na obiekcie: jego rozmiar na potrzeby opóźnień transferu. |
Timeout limit | Na złączeniu: zatrzymuje niedokończone gałęzie po upływie limitu. |
NotBefore time | Na kroku: krok nie rozpoczyna się przed tym czasem przebiegu. |
| ForkTargets, JoinSources | Na przejściu do stanu równoległego lub z niego: stany podrzędne, do których następuje wejście, lub stany podrzędne, które muszą być aktywne. |
History deep | Na stanie złożonym: ponowne wejście wznawia stan podrzędny aktywny w chwili wyjścia. |
HostHook key, points | Zarezerwowane dla Holarch: przebieg wstrzymuje się w celu pobrania danych w wymienionych punktach. |
Symulator JavaScript odczytuje Probability, LoopCount i rozkłady.
Komunikaty
| Wiadomość | Znaczenie |
|---|---|
| Niektóre ustawienia symulacji tego projektu to dane Holarch, a nie część modelu. | Starsze ustawienia są nadal przechowywane obok modelu. Kliknij Przenieś ustawienia symulacji do modelu…. |
| Dane Holarch sprzed przeniesienia ustawień symulacji do modelu; mają pierwszeństwo przed modelem. | Wyświetlane w sekcji Symulacja inspektora. Zmień pole, aby zapisać je w modelu, lub przenieś wszystkie ustawienia w Symulatorze. |
| Brak czasu trwania w modelu. Ustaw go tutaj (zapisuje attribute duration : ISQ::DurationValue) lub zapisz go w tekście. | Krok nie ma atrybutu czasu trwania. |
| @Normal: sd must be greater than zero. Change sd. (sd musi być większe od zera; podobnie dla innych rozkładów i parametrów) | Brakuje parametru rozkładu lub jest on poza zakresem. Z silnikiem SysML kontrola modelu zgłasza to w Edytorze, a Symulator odmawia uruchomienia, dopóki nie zostanie to poprawione. |
| @Normal: sd has another unit dimension than … | Parametr położenia lub skali ma inne jednostki niż atrybut, na przykład metry przy czasie trwania. |
| @LoopCount does not apply to a part … | Adnotacja znajduje się na rodzaju elementu, którego nie dotyczy. Przenieś ją lub usuń. |
| metadata Consumes … about needs an action and a part or item annotated @Resource. | Elementy po about mają niewłaściwą liczbę lub rodzaj. |
| A probability of N % is outside 0 to 100. | Wpisz wartość procentową od 0 do 100. |
| The branch probabilities of this decision add up to N %; the simulator scales them to 100 %. | Ostrzeżenie: każda gałąź ma wagę, a wagi nie sumują się do 100. |
| A correlation needs two different attributes …, … is not an attribute … lub … has no distribution, so nothing is drawn to correlate … | Correlation wskazuje dwa razy ten sam atrybut, coś, co nie jest atrybutem, lub atrybut bez rozkładu. |
| The coefficient N is outside -1 to 1. lub The correlation has no coefficient. | Wpisz współczynnik od -1 do 1. |
| “a” and “b” are already correlated; the first correlation is used. … | Ostrzeżenie: druga Correlation tej samej pary jest ignorowana. Usuń jedną z nich. |
| The correlations of … contradict each other: no joint distribution has them … | Współczynniki grupy nie mogą jednocześnie obowiązywać (macierz nie jest dodatnio półokreślona). Osłab jeden z nich. Symulator odmawia uruchomienia, dopóki nie zostanie to poprawione. |
| Zakleszczenie w chwili <time>: N kroków czeka na coś, co nigdy nie nadejdzie. | Wyświetlane nad wynikami z silnikiem SysML, wraz z każdym oczekującym krokiem. accept bez nadawcy, obiekt, który nigdy nie zostaje wytworzony, lub zasób, który nigdy nie zostaje zwolniony, zatrzymuje przebieg. |
Limity
- Czasy trwania zapisuje się w sekundach, minutach, godzinach lub dniach (
SI::s,SI::min,SI::h,SI::d). Milisekundy zapisuje się jako sekundy, a tygodnie, miesiące i lata jako dni. - Maszyny stanów, bodźce i Uruchom razem z wymagają silnika SysML.
- Skorelowane dane wejściowe wymagają silnika SysML; symulator JavaScript losuje każdą wartość niezależnie. W jednej grupie można skorelować co najwyżej 200 atrybutów.
- Kontrola sprzecznych współczynników obejmuje korelacje zapisane w jednej przestrzeni nazw; Symulator sprawdza wszystkie korelacje przebiegu.
Powiązane
SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.