SysML v2
Pokrycie języka SysML v2
Projekty SysML v2 w Holarch opierają się na specyfikacji OMG SysML v2 i obsługują podzbiór języka. Ta strona wymienia każdy obszar notacji tekstowej, zakres jego obsługi w Holarch i znane luki.
Co oznaczają poziomy
- Obsługiwane: Edytor analizuje i sprawdza konstrukcję, model ją przechowuje, a widoki i strony, które jej używają, odczytują ją i zapisują.
- Częściowo: obsługiwane, z ograniczeniami podanymi w wierszu.
- Przechowywane, nieinterpretowane: analizowane i przechowywane dokładnie tak, jak je zapisano, w tekście i w eksportach, ale bez nadawania własnego znaczenia.
- Jeszcze nie: niedostępne.
Edytor, widoki i kontrole korzystają z tego samego silnika językowego, więc konstrukcja zaakceptowana przez Edytor jest taka sama w każdym widoku. Zobacz też Holarch Language Engine.
Przejdź do: Konstrukcje językowe · Pliki i wymiana · Kontrole · Znane luki
Konstrukcje językowe
| Obszar | Poziom | Konstrukcje | Limity |
|---|---|---|---|
| Pakiety i przestrzenie nazw | Obsługiwane | package, pakiety zagnieżdżone, library package, doc, comment … about, notatki // i //* */, alias … for …, public, private i protected, nazwy krótkie <'1.2'>, nazwy w cudzysłowie. | Pakiety biblioteczne, w tym biblioteka standardowa, są tylko do odczytu. |
| Importy | Obsługiwane | Importy członkostwa i przestrzeni nazw, ::*, rekurencyjne ::**, importy z widocznością, importy filtrowane [@Kind]. | Filtry importu wybierają według metaklasy. |
| Definicje i użycia | Obsługiwane | part, attribute, item, port, connection, interface, flow, action, state, requirement, constraint, calc, use case, analysis, verification, view, viewpoint, concern, enum, occurrence, allocation, metadata; ref, abstract, in, out, inout i end. | Brak znanych. |
| Specjalizacja, typowanie i redefinicja | Obsługiwane | Specjalizacja :> i specializes, typowanie : i defined by, podzbiory :> i subsets, redefinicja :>> i redefines, koniugacja ~, disjoint, łańcuchy cech a.b.c. | Brak znanych. |
| Krotności | Obsługiwane | [n], [n..m], [*], [0..*], ordered, nonunique, wyrażenia jako granice. | Brak znanych. |
| Wartości i jednostki | Obsługiwane | =, :=, default, wielkości takie jak 5 [kg], wyrażenia jednostek takie jak [m/s^2], rodzaje wielkości ISQ oraz jednostki SI i amerykańskie jednostki zwyczajowe z biblioteki standardowej, kontrole wymiarów. | Brak znanych. |
| Ograniczenia i obliczenia | Obsługiwane | Definicje i użycia ograniczeń i obliczeń, return, assert constraint, wywołania, wyrażenia KerML z arytmetyką, porównaniami, logiką, if ? else i operacjami na sekwencjach, obliczanie z jednostkami. | Brak znanych. |
| Struktura | Obsługiwane | Porty i porty sprzężone, connect, interfejsy z końcami, nazwane końce połączeń z krotnościami (connect [1] driver ::> a to [1] driven ::> b), łączniki wiążące bind, przepływy elementów flow of T from … to …, message. | Brak znanych. Kierunki portów, przepływów i message są sprawdzane. Widoki połączeń opisują nazwane końce ich krotnością, a inspektor pozwala je edytować. |
| Akcje | Częściowo | Parametry, perform, następstwa first … then … i then, fork, join, decide, merge, warunki dozoru, accept, send, assign, if, while, for, loop, start, done, terminate. | Symulator uruchamia przepływy akcji, także przebiegi Monte Carlo, z czasami trwania, prawdopodobieństwami gałęzi i liczbą iteracji pętli pobranymi z modelu. |
| Stany | Częściowo | Akcje entry, do i exit, przejścia z wyzwalaczem, warunkiem dozoru i efektem (edytowane w widoku przejść stanów i inspektorze oraz pokazywane pod przejściem w Przeglądarce), stany parallel, stany zagnieżdżone, exhibit. | Symulator uruchamia maszyny stanów silnikiem SysML, z bodźcami, i podświetla aktywne stany w trakcie działania. Sprawdzany jest każdy rodzaj efektu do, ładunek wyzwalacza jest sprawdzany względem jego portu, a inne części modelu mogą odwoływać się do wyzwalacza i efektu przejścia (plugIn.effect.sentMessage). |
| Wymagania | Obsługiwane | subject, actor, stakeholder, require constraint, assume constraint, frame concern, satisfy … by …, verify, nazwy krótkie jako identyfikatory wymagań, doc jako tekst wymagania. | Brak znanych. |
| Przypadki użycia | Obsługiwane | Definicje i użycia przypadków użycia, subject, actor, objective, include use case. | Brak znanych. |
| Przypadki analizy i weryfikacji | Częściowo | Przypadki analizy z podmiotem, celem i wynikiem return; przypadki weryfikacji z verify i werdyktem. | Przypadek analizy jest obliczany tylko wtedy, gdy każde wejście ma wartość. Analizy kompromisów z biblioteki standardowej nie są obliczane; zamiast tego strona Analizy kompromisów w Holarch ocenia warianty na podstawie wartości z modelu. |
| Widoki | Częściowo | view, view def, expose z ::*, ::** i filtrami, filter, viewpoint, frame, render, standardowe definicje widoków. | Widoki sekwencji rysują komunikaty między liniami życia, a komunikaty wewnątrz if/else, pętli, rozwidleń i decyzji jako fragmenty alt, opt, loop i par z ich warunkami dozoru. |
| Alokacja i zależności | Obsługiwane | allocate a to b, definicje alokacji, dependency from … to …. | Brak znanych. |
| Metadane | Częściowo | @Name { … }, prefiks #Name, metadata Name about …, własne metadata def, pakiety metadanych Holarch dla wartości TBD i TBR oraz pojęć DoDAF i UAF, własne słowa kluczowe (#safetyCritical part controller), metadane semantyczne (#fault def BatteryOverheat;) oraz metadane z własnym znaczeniem: wymagane wartości, wartości zadeklarowanego typu i ograniczenia definicji są sprawdzane przy każdym użyciu. | Ograniczenia definicji metadanych odczytują jej własne wartości, a nie opisany element. Metadane zapisane z about nie dodają typu bazowego. |
| Zmienność | Obsługiwane | Definicje i użycia variation, składowe variant i odwołania do wariantów (variant plugInHybrid;), wybory według wartości (part :>> pack = BatteryPack::largePack;), konfiguracje oznaczone @HolarchConfiguration. Sprawdzane i obliczane: wariant ma cechy swojej zmienności, wybór musi być jednym z wariantów punktu, a punkt bez wyboru ma wartość nieznaną, więc asercja na jego temat nie jest ani spełniona, ani naruszona. | Konfiguracje zapisuje się w tekście; Holarch nie wyszukuje jeszcze na swoich stronach prawidłowych kombinacji. |
| Indywidua i wycinki czasu | Obsługiwane | Definicje i użycia individual (individual part def Car_VIN1234 :> Car), snapshot i timeslice (także po then), ich wartości i następstwa. Sprawdzane i obliczane: migawka lub wycinek czasu ma cechy wystąpienia, do którego należy, a jego własne wartości są odczytywane najpierw. Pole Wystąpienie w inspektorze, filtr Indywidua w Przeglądarce oraz Nowa migawka…/Nowy wycinek czasu…, a także widoki ogólne z «individual», «snapshot» i «timeslice» oraz Ułóż jako oś czasu. | Indywiduami, migawkami lub wycinkami czasu mogą być tylko wystąpienia. |
| Reprezentacje tekstowe | Częściowo | rep language "…" /* … */; treści w SysML i KerML są sprawdzane i wyróżniane jako kod, a treść ograniczenia SysML jest obliczana. Inspektor dodaje i edytuje reprezentacje, a widoki przepływu akcji oznaczają akcję, która ją ma, nazwą języka, np. {Python}. | Treści w innych językach, takich jak Python, OCL czy MATLAB, są przechowywane jako tekst i nigdy nie są uruchamiane. Treść nie może zawierać */. |
| KerML | Częściowo | Tekst KerML biblioteki standardowej: biblioteki jądra są odczytywane w KerML. Treści KerML reprezentacji tekstowych są sprawdzane. | Pliki .kerml nie są importowane do projektów, a modele zapisane w KerML nie są sprawdzane. |
| Rozszerzenia języka | Częściowo | Własne słowa kluczowe z metadanych semantycznych: #fault def BatteryOverheat; specjalizuje typ bazowy metadanych, więc ma cechy tego typu; metadane, które ograniczają to, co opisują (annotatedElement). | Typ bazowy jest odczytywany jako nazwa (faults meta SysML::Usage). Inne rozszerzenia języka nie są dostępne, a biblioteki standardowej nie można edytować. |
Pliki i wymiana
| Format | Poziom | Zakres | Limity |
|---|---|---|---|
| Tekst SysML v2 (.sysml) | Obsługiwane | Import i eksport, także jako plik .zip z plikami, z podglądem przed zastosowaniem importu. | Identyfikatory elementów są zachowywane, gdy przy eksporcie zaznaczono Dołącz identyfikatory elementów; bez nich ponowny import dopasowuje elementy po nazwie. |
| SysML v2 JSON | Częściowo | Import i eksport formatu elementów Systems Modeling API, z zachowaniem identyfikatorów elementów. | Rodzaje elementów, których Holarch nie interpretuje, są przechowywane w postaci zaimportowanej i zapisywane bez zmian przy eksporcie; nie mają tekstu i nie można ich edytować. |
| Modele SysML v1 (XMI, .mdzip) | Częściowo | Import do projektu SysML v2 z Cameo lub MagicDraw (.mdzip lub XMI), Enterprise Architect, Rhapsody i Papyrus (XMI, .uml, .xml). Model jest konwertowany na tekst SysML v2 i sprawdzany, a raport konwersji wymienia każdy element jako przekonwertowany, przybliżony lub pominięty, z przyczyną, także jako CSV. Import to jeden krok cofania. | Tylko import. Elementy bez odpowiednika w SysML v2, takie jak węzły końcowe przepływu, partycje aktywności, rozszerzenia przypadków użycia i specyfikacje instancji, są pomijane; diagramy i ich układ nie są konwertowane. Jeden plik o rozmiarze najwyżej 64 MB i 250 000 elementów; pliki projektów Enterprise Architect (.eap, .qea) nie są odczytywane. |
| Repozytoria modeli | Obsługiwane | Pobieranie z jednej gałęzi repozytorium udostępniającego Systems Modeling API i wysyłanie do niej. | Jedna gałąź na projekt. |
| Systems Modeling API w Holarch | Częściowo | Inne narzędzia SysML v2 odczytują bieżący model projektu i zatwierdzają zmiany w gałęziach wniosków o zmianę. | main jest tylko do odczytu: zatwierdzenia trafiają do wniosków o zmianę, które osoba zatwierdzająca stosuje w Holarch. |
| Pliki KerML (.kerml) | Jeszcze nie | Nie są importowane; import je pomija. | Użyj plików .sysml. |
Limity rozmiaru i wszystkie inne formaty są wymienione na stronie Import i eksport.
Kontrole
Edytor sprawdza tekst w trakcie pisania i oznacza każdy problem w miejscu jego wystąpienia. Kontrole obejmują:
- Składnia: znaki, komentarze, ciągi znaków, nawiasy klamrowe,
;, oczekiwane nazwy i tokeny. - Nazwy: nierozwiązane, niejednoznaczne, zduplikowane i prywatne.
- Typowanie i specjalizacja: cykle, właściwy rodzaj definicji, podzbiory i redefinicje cech dziedziczonych.
- Krotności i jednostki: prawidłowe granice, zgodne wymiary, brakujące lub nieznane jednostki.
- Wyrażenia: typy operandów, argumenty obliczeń i warunki logiczne.
- Struktura, akcje i stany: końce połączeń, kierunki portów, przepływów i
message, cele następstw, węzły sterowania, wartości, po których iteruje pętlafor, przejścia początkowe, regiony równoległe, wyzwalacze przejść (ładunki przez porty, czasyat) i efektydo(w tym to, dokąd trafiasend). - Własne słowa kluczowe:
#Namewskazuje metadane, metadane oznaczają tylko dozwolone przez nie rodzaje, a semantyczny typ bazowy jest definicją lub użyciem pasującym do oznaczanego elementu. - Wartości metadanych: każde użycie definicji metadanych podaje wymagane wartości, każda wartość pasuje do typu swojej cechy, a ograniczenia definicji są spełnione.
- Zmienność: zmienności zawierają tylko warianty swojego rodzaju, wybór jest wariantem swojego punktu, a otwarte punkty konfiguracji są odnotowywane.
- Wymagania, przypadki i widoki: składowe we właściwym miejscu, cele
satisfy,verify,exposeiframe. - Reprezentacje tekstowe: treści SysML i KerML dają się sparsować i deklarują element, który reprezentują; język nieznany Holarch jest odnotowywany.
- Obliczanie: ograniczenia, wymagania i cele, które nie są spełnione dla bieżących wartości.
Każda kontrola z przykładowym komunikatem: Kontrole.
Znane luki
- Brak solwera dla przypadków analizy. Przypadek analizy jest obliczany, gdy każde wejście ma wartość. W widoku parametrycznym Rozwiąż znajduje jedną niewiadomą na ograniczenie.
- Brak wyszukiwania wariantów na stronach. Zmienności, warianty i konfiguracje są sprawdzane i obliczane; strony Holarch nie wymieniają jeszcze wszystkich prawidłowych kombinacji.
- Brak plików KerML. KerML jest odczytywany tylko dla biblioteki standardowej.
- Rozszerzenia języka ograniczają się do własnych słów kluczowych i metadanych. Metadane semantyczne stosują swój typ bazowy; pozostałe metadane znaczą to, co określa ich definicja (wymagane wartości, typy wartości i ograniczenia), a biblioteka standardowa jest tylko do odczytu.
- Reprezentacje tekstowe w językach innych niż SysML i KerML są przechowywane jako tekst; Holarch nigdy ich nie uruchamia.
- Systems Modeling API: bez zatwierdzeń do main, tagów i scaleń. Inne narzędzia zatwierdzają zmiany w gałęziach wniosków o zmianę; osoba zatwierdzająca stosuje je w Holarch.
Holarch implementuje podzbiór specyfikacji wymieniony na tej stronie. Każdą jego zmianę wymienia strona Nowości.