Holarch

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ć.

Jak z niego korzystać →

Na tej stronie
  1. Przegląd
  2. Pojęcia
    1. Wartość nominalna i rozkład
    2. Które ustawienia mają pierwszeństwo
    3. Dwa symulatory
  3. Jak z niego korzystać
    1. Kiedy i dlaczego
    2. Ustawianie czasu trwania, prawdopodobieństwa lub liczby przejść pętli
    3. Pisanie adnotacji w tekście
    4. Przenoszenie starszych ustawień do modelu
    5. Symulacja maszyny stanów
    6. Przykład: projekt demonstracyjny Hybrid Car
    7. Wskazówki i dobre praktyki
    8. Typowe błędy
    9. Powiązania z innymi funkcjami
  4. Adnotacje
    1. Rozkłady
    2. Skorelowane dane wejściowe
    3. Szanse i liczby
    4. Zasoby i koszty
    5. Adnotacje wymagające silnika SysML
  5. Komunikaty
  6. Limity
  7. Powiązane

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 if lub 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

  1. Zaznacz krok, następstwo, decyzję, pętlę lub akcję if w widoku przepływu akcji, w Przeglądarce lub w Edytorze.
  2. W sekcji Symulacja inspektora ustaw Czas trwania (wartość stałą lub rozkład), Prawdopodobieństwo (%), Iteracje lub Prawdopodobieństwo then (%).
  3. 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.
  4. 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

  1. Otwórz Edytor.
  2. Dodaj adnotację wewnątrz treści elementu jako @HolarchSimulation::Kind { field = value; } lub po nim jako metadata HolarchSimulation::Kind about element { … }.
  3. 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.

  1. Kliknij Przenieś ustawienia symulacji do modelu….
  2. Podgląd wymienia każde ustawienie i adnotację, która je zastępuje.
  3. 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.

  1. Otwórz Zachowanie → Symulator i wybierz definicję stanu lub część wykazującą stany jako Korzeń.
  2. 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.
  3. 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).
  4. 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.
  5. 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 toCruise po shift ma Probability 70; gałąź else otrzymuje pozostałe 30 %. cruise trwa 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; drive zużywa (Consumes) z niego 1.5 Wh i ma Cost 0.4 USD za użycie.
  • PowertrainStates: przejście startElectric ma Probability 80 dla swojego warunku dozoru; accept when charge < 15 przełą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ła StopRequest i PlugIn do demoCar. 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

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ę.

AdnotacjaPolaZnaczenie
Normalnymean, sdRozkład normalny.
Trójkątnylow, mode, highTrójkątny, z low ≤ mode ≤ high.
Jednostajnylow, highJednostajny między low i high.
ExponentialmeanWykładniczy o podanej średniej.
Gammashape, scaleGamma; średnia to shape × scale.
LogNormalmedian, sigmaLogarytm ma rozkład normalny wokół logarytmu mediany.
Weibullscale, shapeWeibulla.
Betaalpha, beta, scaleBeta na 0..1, pomnożony przez scale.
Poissonmean, scaleLiczba zdarzeń o podanej średniej, pomnożona przez scale.
Binomialtrials, p, scaleLiczba 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; }
AdnotacjaNaZnaczenie
Correlation coefficientabout a, b: dwa atrybuty, każdy z rozkłademKorelacja 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.
  • ChargeStop w projekcie demonstracyjnym Hybrid Car koreluje czas oczekiwania na wolną ładowarkę z czasem ładowania (0.6).

Szanse i liczby

AdnotacjaNaZnaczenie
Probability percentNastępstwo wychodzące z decyzjiWaga gałęzi. Gałęzie bez wagi dzielą to, co zostaje ze 100.
Akcja ifSzansa gałęzi then, gdy nie można obliczyć warunku.
Akcja pętliSzansa powtórzenia po każdym przejściu.
PrzejścieSzansa, że warunek dozoru jest spełniony, gdy nie można go obliczyć.
LoopCount countAkcja pętliLiczba przejść; ma pierwszeństwo przed warunkami pętli.
LoopExitNastępstwo do done w treści pętliKończy całą pętlę, a nie tylko bieżące przejście.

Zasoby i koszty

AdnotacjaNaZnaczenie
Resource initial, minimum, maximum, unitUżycie części lub obiektuPula 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 amountabout step, poolPobierane, gdy krok się rozpoczyna.
Produces amountabout step, poolDodawane, gdy krok się kończy.
Seizes amountabout step, poolPobierane, gdy krok się rozpoczyna, i zwracane, gdy się kończy.
Utilization amountUżycie akcji performJaką część możliwości części wykonującej zajmuje krok.
Cost amount, rate, unit, labelKrok lub część wykonującaKoszt za użycie (CostRate::perUse) lub za godzinę (CostRate::perHour).

Adnotacje wymagające silnika SysML

AdnotacjaZnaczenie
Transfer latency, capacity, perNa połączeniu lub interfejsie: opóźnia przesyłane nim obiekty i sygnały.
Size sizeNa obiekcie: jego rozmiar na potrzeby opóźnień transferu.
Timeout limitNa złączeniu: zatrzymuje niedokończone gałęzie po upływie limitu.
NotBefore timeNa kroku: krok nie rozpoczyna się przed tym czasem przebiegu.
ForkTargets, JoinSourcesNa 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 deepNa stanie złożonym: ponowne wejście wznawia stan podrzędny aktywny w chwili wyjścia.
HostHook key, pointsZarezerwowane 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.

SysML® i OMG® są zastrzeżonymi znakami towarowymi Object Management Group, Inc. w Stanach Zjednoczonych i innych krajach.