Pakiet dla prowadzących · v1.0
Nauczanie z Holarch: pakiet dla prowadzących
Efekty uczenia się i sześć zadań z kryteriami oceny do jednosemestralnego kursu inżynierii systemów lub MBSE, wszystkie oparte na EO-1 Open MBSE Reference Model v1.1, fikcyjnym CubeSacie 6U do obserwacji Ziemi. Bezpłatnie na licencji CC BY 4.0.
Pobierz pakiet dla prowadzących v1.0
Pliki Markdown, które otwierają się w każdym edytorze. Korzystają z EO-1 Reference Model v1.1. Licencja: CC BY 4.0, uznanie autorstwa „Holarch”.
Na tej stronie
- Zawartość
- Jak z niego korzystać
- Notatki z rozwiązaniami
- Efekty uczenia się
- A1 · Prześledź potrzebę
- A2 · Poprawa i przegląd wymagań
- A3 · Znajdź luki w pokryciu
- A4 · Rozbuduj architekturę
- A5 · Przeprowadź zmianę
- A6 · Plan walidacji
- Nauczanie SysML v2 z Holarch: co sprawdza, a co tylko przechowuje
- Pliki do pobrania
- Wersje
- Jak cytować
- Licencja
Zawartość
| Plik | Dla | Zawartość |
|---|---|---|
learning-outcomes.md | Prowadzący, dokumentacja akredytacyjna | Efekty uczenia się kursu, zadania, które oceniają każdy z nich, i używane funkcje Holarch. |
Od assignments/A1-trace-a-need.md do A6-validation-plan.md | Studenci (do rozdania) | Sześć zadań na modelu EO-1, każde z tłem, opisem zadania, listą materiałów do oddania i kryteriami oceny. |
sysml-v2-teaching-boundaries.md | Prowadzący | Co sprawdzają projekty SysML v2 w Holarch, co przechowują bez interpretacji i co nie jest jeszcze dostępne. |
Jak z niego korzystać
- Daj każdej grupie własną kopię EO-1 v1.1. W Holarch: Manage Projects → Project Files ▾ → New Demo Project → CubeSat EO-1 albo pobierz
eo-1-v1.1.holarch.jsonze strony holarch.app/reference-models/eo-1/ i zaimportuj go poleceniem Manage Projects → Project Files ▾ → Import Project…. Każde zadanie zaczyna się od modelu w wersji dostarczanej. - Prowadź kurs w organizacji zajęć. Dodaj każde zadanie z terminem w Organization Settings → Class Review → + New Assignment. Class Review zachowuje wersję każdego projektu grupy w każdym terminie i pokazuje pracę każdego studenta.
- W A2 dołącz do każdego projektu grupy jako Recenzent: ta rola pozwala komentować, zatwierdzać, odrzucać i ponownie otwierać wymagania, nic więcej.
- W A6 studenci zaczynają od wbudowanego szablonu Verification and Validation Plan. Aby dać im skróconą wersję z własnymi instrukcjami, zapisz ją jako szablon organizacji (Write ▾ → Templates ▸ Save as Template…, Save to: Organization) i ustaw jako domyślny dla Test Plan Document.
- Ustal wagi, wielkości grup i terminy dla swojego kursu. Podane wagi są sugestiami.
Zadania wymieniają strony Holarch, ale na każde pytanie można też odpowiedzieć na podstawie plików CSV modelu EO-1, więc mogą w nich uczestniczyć studenci pracujący w innym narzędziu.
Notatki z rozwiązaniami
Notatki z rozwiązaniami z oczekiwanymi ustaleniami, przykładowymi odpowiedziami i typowymi błędami dla A1–A6 nie są publikowane, więc studenci nie mogą pobrać odpowiedzi. Prowadzący pobierają je w Holarch: Organization Settings → Class Review → Download Solution Notes. Przycisk widzą administratorzy (prowadzący i asystenci) organizacji ze statusem zajęć.
Efekty uczenia się
Kurs: Model-Based Systems Engineering, jeden semestr, starsze lata studiów pierwszego stopnia lub pierwszy rok studiów drugiego stopnia.
Po ukończeniu kursu student potrafi:
| # | Efekt | Oceniane w | Używane funkcje Holarch |
|---|---|---|---|
| LO1 | Odróżnić potrzeby interesariuszy od wymagań systemowych i powiązać każdą potrzebę z wymaganiami, które ją formalizują. | A1, kolokwium śródsemestralne | Statement, relacje traced to, sekcja Trace w Item View, Traceability Matrix |
| LO2 | Pisać wymagania konieczne, pojedyncze, jednoznaczne i weryfikowalne, z metodą weryfikacji i kryteriami sukcesu. | A2, kolokwium śródsemestralne | Atrybuty wymagań, Quality, TBD/TBR |
| LO3 | Przeprowadzić cykl przeglądu i zatwierdzania wymagań oraz odpowiadać na komentarze z przeglądu zmianami w modelu. | A2, udział w przeglądzie | Rola Reviewer, Approvals (Approve, Reject…, Reopen), komentarze ze wzmiankami |
| LO4 | Analizować identyfikowalność i pokrycie weryfikacją oraz rozstrzygać dla każdej luki, czy błędny jest model, czy wymaganie. | A3 | Traceability Matrix, RVTM, Model Checks |
| LO5 | Dekomponować funkcje, definiować architekturę logiczną, alokować funkcje do elementów logicznych i fizycznych oraz wyprowadzać wynikające z tego interfejsy. | A4, egzamin końcowy | Diagramy Action i FFBD, Asset, alokacja, Interface Register |
| LO6 | Oceniać wpływ zmiany wymagania za pomocą modelu i zapisywać decyzję dla każdego objętego nią elementu. | A5, egzamin końcowy | Links to Review, analiza wpływu, Change Requests, Baselines & Versions |
| LO7 | Planować weryfikację i walidację: odróżniać je, dobierać metody, pisać procedury testowe i walidacyjne we właściwych kategoriach i czytać RVTM. | A6, egzamin końcowy | Przypadki i zestawy testowe, Test Center, RVTM i VCRM, szablony dokumentów |
| LO8 | Tworzyć produkty inżynierskie z modelu i utrzymywać ich zgodność z nim: dokumenty z linią bazową i macierze eksportowane do przeglądu. | A2, A6, egzamin końcowy | Dokumenty, żywe macierze, linie bazowe, eksport do Worda i Excela |
| LO9 (opcjonalnie) | Czytać i pisać notację tekstową SysML v2 dla podsystemu oraz wskazywać, które właściwości narzędzie sprawdziło, a które tylko przechowało. | Opcjonalna część A6 | Projekt SysML v2, kontrole edytora, notatka o nauczaniu SysML v2 |
Przyporządkowanie do zadań
| Efekt | A1 Prześledź potrzebę | A2 Poprawa wymagań | A3 Luki w pokryciu | A4 Architektura | A5 Wpływ zmiany | A6 Plan walidacji |
|---|---|---|---|---|---|---|
| LO1 | ● | ○ | ○ | |||
| LO2 | ● | ○ | ||||
| LO3 | ● | |||||
| LO4 | ○ | ● | ○ | |||
| LO5 | ● | |||||
| LO6 | ● | |||||
| LO7 | ○ | ○ | ○ | ● | ||
| LO8 | ○ | ● |
● główny oceniany efekt, ○ efekt wspierany.
Uwagi dla prowadzącego
- Efekty opisują umiejętności z zakresu inżynierii systemów, a nie biegłość w narzędziu. Holarch to miejsce ćwiczeń; pliki CSV modelu EO-1 pozwalają studentowi wykazać każdy efekt bez niego.
- Efekty odpowiadają powszechnej praktyce inżynierii systemów, na przykład procesom technicznym ISO/IEC/IEEE 15288: definiowanie potrzeb i wymagań interesariuszy, definiowanie wymagań systemowych, definiowanie architektury, weryfikacja i walidacja. Przyporządkuj je do kryteriów akredytacji swojego programu zgodnie z wymaganiami uczelni.
A1 · Prześledź potrzebę
Efekty: LO1 (główny), LO4, LO7 · Wielkość grupy: indywidualnie · Sugerowana waga: 8 %
Tło
Klient EO-1, firma zajmująca się analityką rolniczą, sformułował trzy potrzeby. N2 Twice-Weekly Revisit brzmi: „Farm customers need fresh imagery of their fields at least twice a week in the growing season.” Potrzeba jest spełniona dopiero wtedy, gdy formalizujące ją wymagania są spełnione przez projekt i zweryfikowane, a sama potrzeba jest zwalidowana z klientem.
Zadanie
- Prześledź N2 w modelu: wymagania, z którymi jest powiązana, ich wymagania podrzędne, funkcje i komponenty spełniające każde z nich oraz przypadki testowe, które je weryfikują, wraz ze statusem każdego testu.
- Przedstaw łańcuch jako tabelę lub mały diagram: jeden wiersz lub prostokąt na element, z jego numerem, nazwą, statusem i relacją, która go łączy.
- Znajdź działanie walidacyjne dla N2 i jego status.
- Odpowiedz: Jakich dowodów wciąż brakuje, by N2 można było uznać za zwalidowaną? Wymień każdy brakujący element, element modelu, do którego należy, i to, co by go uzupełniło.
- Poszukaj wymagań, które wspierają N2, ale nie są z nią powiązane. Wskaż jednego kandydata i uzasadnij dodanie powiązania lub rezygnację z niego. Nie dodawaj go do modelu.
W Holarch: otwórz N2 w Item View i przeczytaj sekcję Ślad, a następnie użyj Verification → Traceability Matrix, Verification → RVTM i Verification → Test Center. Bez Holarch: eo-1-v1.1-traceability.csv i eo-1-v1.1-rvtm.csv.
Do oddania
Notatka na jedną do dwóch stron (Word lub PDF) z łańcuchem, brakującymi dowodami i odpowiedzią na krok 5. W tym zadaniu nie zmieniaj modelu.
Kryteria oceny
| Kryterium | 4 Wzorowy | 3 Biegły | 2 Rozwijający się | 1 Początkujący |
|---|---|---|---|---|
| Łańcuch kompletny i poprawny (40 %) | Każdy element od N2 do testów, z właściwymi relacjami i statusami, łącznie z oboma wymaganiami podrzędnymi i działaniem walidacyjnym. | Brak jednego elementu lub statusu albo jeden błąd. | Łańcuch kończy się na wymaganiach lub pomija wymaganie podrzędne. | Elementy wymienione bez relacji. |
| Brakujące dowody (35 %) | Wskazuje każdą lukę (niewykonane testy, wymaganie nadrzędne bez własnej weryfikacji, jeszcze niezatwierdzone wymagania, niewykonana walidacja, wymaganie podrzędne bez funkcji) i to, co ją zamyka. | Większość luk, wraz z tym, co je zamyka. | Wymienia luki, nie mówiąc, co je zamyka. | Stwierdza jedynie, że „brakuje testów”. |
| Weryfikacja a walidacja (15 %) | Konsekwentnie je rozróżnia: wymagania są weryfikowane, potrzeba jest walidowana. | Jedna pomyłka. | Traktuje zaliczony test jako walidację potrzeby. | Brak rozróżnienia. |
| Kandydat do powiązania (10 %) | Konkretne wymaganie z przemyślanym argumentem za lub przeciw. | Kandydat ze słabym argumentem. | Kandydat bez argumentu. | Brak. |
A2 · Poprawa i przegląd wymagań
Efekty: LO2 (główny), LO3, LO8 · Wielkość grupy: grupa · Sugerowana waga: 10 %
Tło
Trzy wymagania EO-1 są nadal szkicami i w kontroli jakości Holarch uzyskują 44 %:
- 2.5 Safe Mode Recovery: „The spacecraft should recover from safe mode quickly and resume imaging as appropriate”
- 3.5 Battery Thermal Control: „The thermal design shall keep the battery warm enough (TBD).”
- 6.4 Operator Interface: „The operator interface shall be user friendly and/or easy to use.”
Wymaganie 3.5 ma też otwarty problem, ISS-3 Battery heater set point not chosen, oraz komentarz z rady ds. przeglądu projektu, RID-1 No cold-case analysis for the battery heater.
Zadanie
- Dla każdego z nich wypisz, co je osłabia, słowo po słowie tam, gdzie ma to znaczenie.
- Przepisz każde z nich w projekcie grupy: jedno „shall”, jeden mierzalny warunek oraz określony punkt początkowy lub warunek tam, gdzie chodzi o czas lub zakres. Zastąp każde TBD wartością i zapisz jej uzasadnienie albo pozostaw TBR z właścicielem i datą. Dla 3.5 wyjaśnij, jak nowe brzmienie odpowiada na ISS-3 i RID-1.
- Uzupełnij dla każdego pola Verification Method, Poziom weryfikacji i Kryteria sukcesu.
- Powiąż każde z jego źródłem (potrzebą, wymaganiem nadrzędnym lub źródłem) oraz z funkcją, która je spełnia. Jeśli takiej funkcji nie ma, wskaż brakującą funkcję.
- Ustaw każde na In Review. Prowadzący przegląda je jako Reviewer. Odpowiedz na każdy komentarz w modelu (zmień wymaganie albo odpowiedz z uzasadnieniem), a potem rozwiąż komentarz.
- Zapisz linię bazową dokumentu EO-1 System Requirements Specification (SRS-001) o nazwie „A2 handed in” i wyeksportuj ją do Worda.
W Holarch: Needs & Requirements → Quality, inspektor wymagania, Needs & Requirements → Approvals, a w dokumencie Version ▾ → Save Baseline… i Deliver ▾ → Specification (Word).
Do oddania
Eksport do Worda oraz półstronicowa notatka o słabościach znalezionych w kroku 1. Ocenie podlega też model w stanie z dnia terminu.
Kryteria oceny
| Kryterium | 4 Wzorowy | 3 Biegły | 2 Rozwijający się | 1 Początkujący |
|---|---|---|---|---|
| Przepisane wymagania (40 %) | Wszystkie trzy pojedyncze, mierzalne i weryfikowalne; warunki i punkty początkowe określone; wartości uzasadnione. | Jedno wymaganie wciąż zawiera niejasny termin lub nie ma warunku. | Dodano wartości, ale brakuje warunków lub uzasadnienia. | Zmienione sformułowanie, nadal nieweryfikowalne. |
| Atrybuty weryfikacji (20 %) | Metoda, poziom i kryteria sukcesu pasują do każdego wymagania i dałoby się je przeprowadzić tak, jak zapisano. | Jedna niezgodność, na przykład Test tam, gdzie możliwa jest tylko Analysis. | Metody ustawione, kryteria sukcesu niejasne. | Brak. |
| Identyfikowalność (15 %) | Każde powiązane ze źródłem i spełniającą je funkcją albo wskazana brakująca funkcja. | Brak jednego powiązania. | Tylko źródła. | Brak. |
| Cykl przeglądu (15 %) | Odpowiedź na każdy komentarz z przeglądu w modelu i jego rozwiązanie; odrzucone wymagania poprawione i ponownie przesłane. | Jeden komentarz pozostał otwarty. | Odpowiedzi na komentarze bez zmian w modelu. | Komentarze zignorowane. |
| Analiza słabości (10 %) | Precyzyjna: wskazuje każdy niejasny termin i powód, dla którego nie da się go zweryfikować. | Ogólna, ale poprawna. | Powtarza wynik jakości. | Brak. |
A3 · Znajdź luki w pokryciu
Efekty: LO4 (główny), LO1, LO2, LO7 · Wielkość grupy: grupa · Sugerowana waga: 10 %
Tło
EO-1 jest na etapie krytycznego przeglądu projektu. Model jest celowo niedoskonały: niektóre wymagania nie mają spełniającej je funkcji, niektóre nie mają testu, niektóre testy nie przeszły, a jedno równanie nie jest z niczym powiązane.
Zadanie
Pracuj na modelu w wersji dostarczanej v1.1. Użyj świeżej kopii, jeśli projekt grupy się zmienił.
- Wymień każde wymaganie, którego nie spełnia żadna funkcja.
- Wymień każde wymaganie, którego nie weryfikuje żaden przypadek testowy, oraz te, których testy nie przeszły, z otwartym problemem i ewentualnym odstępstwem zapisanym dla nich.
- Wymień wymagania bez spełniającego je komponentu. Rozstrzygnij, które z nich go potrzebują, a które słusznie są spełniane na poziomie misji lub segmentu.
- Znajdź elementy modelu, z którymi nic nie jest powiązane. Wskazówka: przyjrzyj się równaniom zasilania.
- Dla każdej luki rozstrzygnij: czy w modelu czegoś brakuje (funkcji, komponentu, testu, powiązania), czy wymaganie jest zbędne lub źle sformułowane? Podaj jedno zdanie uzasadnienia na lukę.
- Zamknij w projekcie grupy trzy wybrane luki, każdą jako jedną zmianę, którą można wskazać w Control & Reviews → Activity.
W Holarch: Verification → Traceability Matrix, Verification → RVTM, Verification → Model Checks i Risks, Issues & Decisions → Issues & Actions. Bez Holarch: eo-1-v1.1-traceability.csv (kolumna Pokrycie), eo-1-v1.1-rvtm.csv, eo-1-v1.1-issues-actions.csv i eo-1-v1.1-deviations-waivers.csv.
Do oddania
Tabela luk (luka, element, decyzja, uzasadnienie, zamknięta tak lub nie) w Excelu lub Wordzie oraz lista trzech wprowadzonych zmian.
Kryteria oceny
| Kryterium | 4 Wzorowy | 3 Biegły | 2 Rozwijający się | 1 Początkujący |
|---|---|---|---|---|
| Znalezione luki (35 %) | Wszystkie luki dotyczące funkcji, testów, komponentów i elementów osieroconych, łącznie z testami, które nie przeszły, ich problemami i odstępstwem. | Pominięta jedna lub dwie luki. | Znalezione tylko oczywiste szkice. | Mniej niż połowa. |
| Decyzje (35 %) | Każda luka ma obronioną decyzję; odróżnia brakujący projekt od zbędnych lub źle określonych wymagań i od spełnienia na poziomie misji. | Większość decyzji trafna. | Każda luka potraktowana jako „dodaj powiązanie”. | Brak decyzji. |
| Wprowadzone zmiany (20 %) | Trzy zmiany, które rzeczywiście zamykają luki, każda jako jeden czysty krok w historii. | Dwie dobre zmiany. | Zmiany, które ukrywają lukę, na przykład powiązanie dodane bez uzasadnienia. | Brak. |
| Prezentacja (10 %) | Tabela daje się sortować i jest kompletna. | Drobne braki. | Trudna do śledzenia. | Brak. |
A4 · Rozbuduj architekturę
Efekty: LO5 (główny), LO4 · Wielkość grupy: grupa · Sugerowana waga: 12 %
Tło
Architektura logiczna EO-1 (L0) obejmuje tylko wycinki dotyczące zasilania i obsługi danych: od L1 Power Generation do L6 Fault Management. Każdy element logiczny grupuje funkcje (allocated to) i jest realizowany przez część fizyczną (related to); na przykład F3.1 Convert Sunlight to Power jest alokowana do L1, a 1.3.1 Solar Arrays realizuje L1. Wyznaczanie i sterowanie orientacją ma funkcje F4.1 Estimate Attitude, F4.2 Compute Control Torques, F4.3 Drive Reaction Wheels i F4.4 Unload Wheel Momentum oraz części fizyczne pod 1.2 ADCS, ale nie ma warstwy logicznej.
Zadanie
- Dodaj pod L0 elementy logiczne dla wyznaczania i sterowania orientacją. Każdy element określa swój cel bez nazywania sprzętu.
- Alokuj do nich funkcje F4.1–F4.4 i powiąż każdy element logiczny z częściami fizycznymi pod 1.2 ADCS, które go realizują, według wzoru L1–L6.
- Narysuj diagram Action dla F4 z elementami przepływającymi między jego podfunkcjami, na przykład estymatą orientacji i poleceniami momentu, jeśli projekt grupy jeszcze takiego diagramu nie ma.
- Z przepływów przekraczających granice elementów wyprowadź interfejsy. Porównaj je z istniejącymi interfejsami IF-06, IF-16, IF-17 i IF-18: które się zgadzają, których brakuje, a które przenoszą elementy nieużywane przez żadną funkcję?
- Sprawdź, czy każde z wymagań 2.1–2.4 jest spełnione przez funkcję, która wykonuje daną pracę, i wskaż, który element logiczny odpowiada wtedy za każde wymaganie.
W Holarch: Architecture → Assets, Behavior → Action Diagrams (F4), sekcja Ślad inspektora dla alokacji, Interfaces → Interface Register oraz ustawienie Hierarchia alokacji diagramu hierarchii. Bez Holarch: eo-1-v1.1-allocation-chain.csv i eo-1-v1.1-icd.csv.
Do oddania
Krótki opis architektury (dwie do trzech stron, Word lub PDF): elementy logiczne z ich celami, tabela alokacji (funkcja → element logiczny → część fizyczna), diagram Action dla F4 i porównanie interfejsów.
Kryteria oceny
| Kryterium | 4 Wzorowy | 3 Biegły | 2 Rozwijający się | 1 Początkujący |
|---|---|---|---|---|
| Elementy logiczne (25 %) | Niezależne od rozwiązania, spójne, każdy z jasnym celem; bez nazw sprzętu. | Jeden element nazywa sprzęt lub łączy różne cele. | Elementy powielają części fizyczne. | Brak lub niejasne. |
| Alokacja (30 %) | Każda podfunkcja alokowana raz do właściwego elementu; elementy realizowane przez części; spójnie w modelu. | Jedna alokacja wątpliwa. | Alokacje tylko do części, z pominięciem warstwy logicznej. | Niekompletne. |
| Przepływy i interfejsy (30 %) | Interfejsy wyprowadzone z przepływów przekraczających granice; precyzyjne porównanie z IF-06, IF-16, IF-17 i IF-18, łącznie z lukami w obu kierunkach. | Porównanie w większości poprawne. | Interfejsy wymienione, nie wyprowadzone. | Brak. |
| Odpowiedzialność za wymagania (15 %) | Każde z wymagań 2.1–2.4 powiązane przez swoją funkcję z elementem logicznym, niespójności wskazane. | Brak jednego. | Wymienione bez sprawdzenia. | Brak. |
A5 · Przeprowadź zmianę
Efekty: LO6 (główny), LO7 · Wielkość grupy: grupa · Sugerowana waga: 10 %
Tło
Po przeglądzie projektu wymaganie 3.1 Orbit Average Power zmieniło się z 28 W na 30 W średniej mocy na orbicie pod koniec życia. Przypadek testowy TC-06 Solar Array Power Test przeszedł dla starej wartości. Holarch oznaczył powiązania 3.1 do przeglądu.
Zadanie
- Wymień każdy element, którego dotyczy zmiana: w przód przez powiązania z 3.1, wstecz do tego, z czego 3.1 wynika, oraz elementy, które wspominają starą wartość bez powiązania z 3.1. Opisz, jak znaleziono każdy z nich.
- Dla każdego elementu zapisz pytanie, które rodzi zmiana, swoje ustalenie (z liczbami tam, gdzie model je zawiera) i decyzję: bez zmian (oznacz powiązanie jako przejrzane, z komentarzem), aktualizacja lub przekazanie do rady ds. zmian.
- Zdecyduj, co zrobić z TC-06: czy test zaliczony przy 28 W nadal dowodzi 30 W? Przedstaw obliczenia na podstawie równań modelu.
- Znajdź jeden element, który analiza oparta na powiązaniach pomija, i wyjaśnij, dlaczego ma on znaczenie.
- Zapisz decyzje w projekcie grupy: komentarz do każdego powiązania oznaczonego jako przejrzane, wniosek o zmianę dla tego, o czym musi zdecydować rada, oraz linię bazową przed i po.
W Holarch: Needs & Requirements → Links to Review, analiza wpływu z 3.1 (Open in ▾ → Spider, potem Wpływ), sekcja Ślad inspektora, równania zasilania EQ-1.1–EQ-1.4 i TPM-2 (Architecture → Budgets & TPMs), Control & Reviews → Change Requests oraz Control & Reviews → Baselines & Versions. Bez Holarch: eo-1-v1.1-traceability.csv i eo-1-v1.1-change-impact-3.1.csv, opublikowany zapis wpływu; najpierw przeprowadź własną analizę, a potem porównaj.
Do oddania
Zapis wpływu (tabela: element, sposób dotarcia, pytanie, ustalenie, decyzja, status) i jednoakapitowa rekomendacja dla rady ds. zmian.
Kryteria oceny
| Kryterium | 4 Wzorowy | 3 Biegły | 2 Rozwijający się | 1 Początkujący |
|---|---|---|---|---|
| Zasięg (30 %) | Znalezione elementy w przód, wstecz i przez wyszukiwanie tekstu, łącznie z tymi, do których nie prowadzi żadne powiązanie. | Tylko powiązania, wszystkie. | Część powiązań w przód. | Tylko 3.1 i TC-06. |
| Ustalenia z liczbami (30 %) | Wykorzystuje wartości i równania modelu; niedobór w TC-06 jest obliczony i wyjaśniony. | Liczby w większości poprawne. | Tylko jakościowo. | Błędne wnioski. |
| Decyzje (25 %) | Każdy element ma decyzję zgodną z ustaleniem; powiązania oznaczone jako przejrzane tylko z uzasadnieniem; sprawy dla rady wydzielone. | Jedna decyzja słaba. | Oznacza powiązania jako przejrzane bez uzasadnień. | Brak decyzji. |
| Zapis w modelu (15 %) | Komentarze, wniosek o zmianę i linie bazowe są na miejscu i zgodne z zapisem. | Brak jednego. | Tylko dokument. | Nic w modelu. |
A6 · Plan walidacji
Efekty: LO7 (główny), LO8, LO1 · Wielkość grupy: grupa · Sugerowana waga: 10 %
Tło
Weryfikacja pyta, czy EO-1 zbudowano prawidłowo względem wymagań; walidacja pyta, czy jest to właściwy system dla klientów rolniczych. Zestaw walidacyjny EO-1 TS-3 Mission Validation zawiera VAL-01 Customer Alert Pilot (dla N1, niewykonany), VAL-02 Growing Season Revisit Simulation (dla N2, niewykonany) i VAL-03 Agronomist Map Review (dla N3, zaliczony).
Rozpocznij plan w Needs & Requirements → Documents → + New Document. W sekcji Szablon ustaw Szablony dla na Test Plan Document i wybierz wbudowany Verification and Validation Plan z opcją Uwzględnij wskazówki redakcyjne albo szablon organizacji opublikowany przez prowadzącego do tego zadania.
Zadanie
- 5.1 Operational Scenarios: opisz scenariusz dla VAL-01 w języku klienta: kto co robi, którego dnia i z jakim wynikiem. Wskaż potrzebę, którą sprawdza.
- 5.2 Users and Participants: wymień reprezentatywnych użytkowników i to, o czym każdy z nich decyduje.
- 5.3 Validation Environment: opisz środowisko, czym różni się od eksploatacji i co ta różnica oznacza dla wyniku.
- Sformułuj kryteria akceptacji VAL-01 tak, by klient mógł powiedzieć tak lub nie bez oceny inżynierskiej, i zapisz je w polu Oczekiwany wynik przypadku testowego.
- 8 Verification Status: odczytaj żywą macierz. Wybierz niezaliczony test TC-04 Pointing Accuracy Test i wyjaśnij, co oznaczałby wynik VAL-01, gdyby w czasie pilotażu TC-04 nadal był niezaliczony.
- Wyeksportuj plan do Worda.
Opcjonalnie: dodatek SysML v2 (LO9, do 10 % dodatkowo)
Utwórz projekt SysML v2 z pliku eo-1-v1.1-power-subsystem.sysml (Manage Projects → Project Files ▾ → Import SysML v2 Files…). Plik nadal zawiera wymaganie 3.1 z wartością 28 W. Zmień wymaganą średnią moc na orbicie na 30 W, zgodnie ze zmianą z A5, i przeczytaj, co zgłasza edytor. Czy to błąd modelowania, czy ustalenie projektowe? Następnie zmieniaj wartości projektowe, a nie wymaganie, aż wiersz stanu edytora pokaże Brak problemów, i oceń, czy nowe wartości są fizycznie wiarygodne. Na pół strony określ, które z twierdzeń narzędzie sprawdziło, a które tylko przechowało; notatka o nauczaniu SysML v2 udostępniona przez prowadzącego wymienia jedne i drugie.
Do oddania
- Eksport planu do Worda.
- Do dodatku SysML v2: plik
.sysmli pół strony tekstu.
Kryteria oceny
| Kryterium | 4 Wzorowy | 3 Biegły | 2 Rozwijający się | 1 Początkujący |
|---|---|---|---|---|
| Scenariusz w języku klienta (30 %) | Konkretny, z perspektywy codziennej pracy, bez żargonu inżynierskiego; wyraźnie sprawdza N1. | Jasny, z odrobiną żargonu. | Procedura testowa, nie scenariusz. | Brak lub ogólnikowy. |
| Kryteria akceptacji (25 %) | Obserwowalne, tak lub nie, należące do klienta; związane z „on the day of an overpass” z N1. | W większości obserwowalne. | Tylko progi inżynierskie. | Niejasne. |
| Uczestnicy i środowisko (20 %) | Reprezentatywni użytkownicy wymienieni wraz z ich decyzjami; różnice względem eksploatacji i ich wpływ określone. | Brak jednego. | Wymienione bez wpływu. | Brak. |
| Rozumowanie o V&V (15 %) | Wyjaśnia, dlaczego pilotaż walidacyjny może się udać lub nie niezależnie od TC-04 i co oznacza każdy wynik. | W większości trafne. | Myli weryfikację z walidacją. | Brak. |
| Produkt (10 %) | Czysty eksport do Worda, wskazówki szablonu zastąpione treścią. | Pozostawiony tekst wskazówek. | Częściowo wyeksportowany. | Brak. |
| Dodatek SysML v2 (do +10 %) | Ustalenie wyjaśnione; No problems przy wiarygodnych wartościach; precyzyjne określenie, co zostało sprawdzone, a co przechowane. | No problems; określenie ogólnikowe. | Osłabiono wymaganie zamiast zmienić projekt albo pozostały problemy. | Bez punktów. |
Nauczanie SysML v2 z Holarch: co sprawdza, a co tylko przechowuje
Projekty SysML v2 w Holarch obsługują podzbiór specyfikacji OMG SysML v2. Aktualny stan każdego obszaru przedstawia strona pokrycia języka SysML v2 (holarch.app/sysml-v2-coverage/); sprawdź ją przed każdym semestrem. Ucząc języka z Holarch, rozróżniaj trzy rodzaje stwierdzeń, aby studenci nie uznali ograniczenia narzędzia za regułę języka ani konstrukcji tylko przechowanej przez narzędzie za sprawdzoną:
- Sprawdzane: edytor analizuje konstrukcję i sprawdza ją w trakcie pisania, a widoki i strony z niej korzystają. Gdy wiersz stanu edytora pokazuje No problems, te kontrole zostały zaliczone.
- Przechowywane, nieinterpretowane: analizowane i przechowywane dokładnie tak, jak je zapisano, w tekście i w eksportach, ale bez nadawania znaczenia. No problems nie mówi nic o ich poprawności.
- Jeszcze nie ma w Holarch: konstrukcja lub funkcja nie jest dostępna w Holarch. Nadal jest poprawnym SysML v2.
Sprawdzane: można bezpiecznie uczyć i oceniać z pomocą narzędzia
| Obszar | Co edytor na pewno wychwyci |
|---|---|
| Składnia | Znaki, komentarze, ciągi znaków, nawiasy klamrowe, ;, oczekiwane nazwy i tokeny. |
| Nazwy i importy | Nierozwiązane, niejednoznaczne, zduplikowane i prywatne nazwy; importy członków, przestrzeni nazw, rekurencyjne i filtrowane. |
| Definicje, użycia, specjalizacja | part, attribute, port, action, state, requirement i pozostałe rodzaje oraz ich definicje; typowanie, podzbiory, redefinicja i sprzężenie; cykle i niewłaściwy rodzaj definicji. |
| Krotności, wartości i jednostki | Poprawne granice; wielkości z rodzajami wielkości ISQ oraz jednostkami SI i amerykańskimi zwyczajowymi; kontrole wymiarów: moc tam, gdzie oczekiwana jest masa, to błąd. |
| Ograniczenia i obliczenia | Typy operandów, argumenty obliczeń, warunki logiczne i ewaluacja: ograniczenia, wymagania i cele, które nie są spełnione dla bieżących wartości, są zgłaszane. |
| Struktura | Końce połączeń; kierunki portów, przepływów i komunikatów; interfejsy i łączniki wiążące. |
| Akcje i stany | Cele następstw, węzły sterujące, wartości, po których iteruje pętla for, przejścia początkowe, regiony równoległe, wyzwalacze przejść i efekty do. |
| Wymagania i przypadki użycia | Cele subject, actor, stakeholder, require i assume constraint, satisfy, verify i frame we właściwych miejscach. |
| Alokacja | allocate … to …, definicje alokacji, zależności. |
| Zmienność | Wariacja zawiera tylko warianty swojego rodzaju, wybór jest wariantem swojego punktu, a wartości wyboru są ewaluowane. |
| Indywidua, migawki i wycinki czasowe | Każde ma cechy wystąpienia, do którego należy; najpierw odczytywane są jego własne wartości. |
Częściowo sprawdzane: uczyć ze wskazaniem ograniczenia
| Obszar | Sprawdzane lub wykonywane | Ograniczenie do przekazania studentom |
|---|---|---|
| Akcje | Symulator wykonuje przepływy akcji, także w przebiegach Monte Carlo. | Czasy trwania kroków, prawdopodobieństwa gałęzi i liczby powtórzeń pętli to ustawienia symulatora przechowywane w Holarch, a nie w tekście, więc eksport .sysml ich nie zawiera. |
| Stany | Symulator wykonuje maszyny stanów z bodźcami i pokazuje aktywne stany. | Tak samo: ustawienia symulatora nie są częścią tekstu. |
| Przypadki analizy i weryfikacji | Podmiot, cel, zwracany wynik; verify i werdykt. | Przypadek analizy jest ewaluowany tylko wtedy, gdy każde wejście ma wartość; nie ma solwera. W widoku Parametric View polecenie Solve znajduje jedną niewiadomą na ograniczenie. Analizy kompromisów z biblioteki standardowej nie są ewaluowane. |
| Widoki | view, view def, expose, filtry, punkty widzenia i standardowe definicje widoków; widoki Sequence View rysują fragmenty alt, opt, loop i par. | Układ należy do Holarch, a nie do modelu. |
| Zmienność | Wariacje, warianty i konfiguracje są sprawdzane i ewaluowane. | Holarch nie wyszukuje jeszcze ani nie wyświetla wszystkich poprawnych kombinacji. |
| Metadane i słowa kluczowe | @Name, #Name, metadata … about, słowa kluczowe zdefiniowane przez użytkownika z metadanych semantycznych. | Inne metadane zdefiniowane przez użytkownika nie mają znaczenia poza swoimi wartościami; metadane zapisane z about nie dodają typu bazowego. |
| Reprezentacje tekstowe | Treści rep … language w SysML i KerML są sprawdzane, a treść ograniczenia w SysML jest ewaluowana. | Treści w innych językach, takich jak Python, OCL czy MATLAB, są przechowywane jako tekst i nigdy nie są wykonywane. |
| Wymiana SysML v2 JSON | Import i eksport w formacie 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 z powrotem bez zmian; nie mają tekstu i nie można ich edytować. |
Przechowywane, nieinterpretowane: No problems niczego tu nie dowodzi
- Treści reprezentacji tekstowych w językach innych niż SysML i KerML.
- Wartości metadanych zdefiniowanych przez użytkownika innych niż metadane semantyczne.
- Tekst
doci komentarze: nigdy nie są porównywane z modelem. W podsystemie zasilania EO-1 zmiana wymagania 3.1 na 30 W pozostawia w jegodocwartość 28 W, a żaden problem nie jest zgłaszany. To dobre ćwiczenie. - Rodzaje elementów, których Holarch nie interpretuje, w zaimportowanym pliku SysML v2 JSON.
Odwrotna zależność też ma znaczenie: status wymagania, wyniki weryfikacji i etykiety to dane Holarch. Nie ma ich w tekście ani w eksporcie .sysml.
Jeszcze nie ma w Holarch
- Pliki
.kerml: nie są importowane, a modele napisane w KerML nie są sprawdzane. KerML jest odczytywany tylko na potrzeby biblioteki standardowej. - Rozszerzenia języka inne niż słowa kluczowe zdefiniowane przez użytkownika; biblioteki standardowej nie można edytować.
- Solwer dla przypadków analizy oraz wyszukiwanie poprawnych kombinacji wariantów na stronach Holarch.
- Commity Systems Modeling API do
main, tagi i scalenia: inne narzędzia zatwierdzają zmiany w gałęziach wniosków o zmianę, a osoba zatwierdzająca stosuje je w Holarch.
Jak wykorzystać to na kursie
- Mów „narzędzie sprawdziło” tylko w odniesieniu do obszarów sprawdzanych. Na przykład No problems oznacza, że jednostki są spójne, a wymagania są spełnione dla bieżących wartości. Nie oznacza, że tekst
doczgadza się z wartościami ani że treść w Pythonie jest poprawna. - Konstrukcje przechowywane oceniaj, czytając je. Oceniaj je przez inspekcję, a nie na podstawie liczby problemów.
- Zachowanie wykonuje się w symulatorze, zarówno przepływy akcji, jak i maszyny stanów. Czasy trwania i prawdopodobieństwa używane przez symulator to ustawienia Holarch: jeśli studenci oddają tylko plik
.sysml, poproś także o ustawienia. - Reguły języka pochodzą ze specyfikacji, a nie z narzędzia. Tam, gdzie Holarch czegoś nie zaimplementował, mów „jeszcze nie ma w Holarch”, a nie „niedozwolone”.
- Dodatek do A6 opiera się na tej notatce: studenci zmieniają 3.1 na 30 W w podsystemie zasilania EO-1, widzą, jak kontrola ewaluacji to zgłasza, poprawiają projekt i zapisują, co zostało sprawdzone, a co tylko przechowane.
Pliki do pobrania
Pakiet to jeden plik zip. Jego nazwa zawiera wersję, więc kurs może wskazać dokładnie tę kopię, której użył. Pliki CSV i projekty do zadań to pliki EO-1 Reference Model v1.1 do pobrania na stronie EO-1.
| Plik | Zawartość |
|---|---|
| teaching-with-holarch-v1.0.zip | Wszystkie poniższe pliki w jednym folderze. |
README.txt | Zawartość, sposób korzystania z pakietu, informacja o licencji i historia zmian. |
LICENSE.txt | Informacja o licencji. |
learning-outcomes.md | Efekty uczenia się kursu i ich przyporządkowanie do zadań. |
assignments/A1-trace-a-need.md | A1 Prześledź potrzebę. |
assignments/A2-requirements-rework.md | A2 Poprawa i przegląd wymagań. |
assignments/A3-coverage-gaps.md | A3 Znajdź luki w pokryciu. |
assignments/A4-extend-the-architecture.md | A4 Rozbuduj architekturę. |
assignments/A5-work-the-change.md | A5 Przeprowadź zmianę. |
assignments/A6-validation-plan.md | A6 Plan walidacji. |
sysml-v2-teaching-boundaries.md | Nauczanie SysML v2 z Holarch: co sprawdza, a co tylko przechowuje. |
Notatek z rozwiązaniami nie ma w pliku zip; zobacz Notatki z rozwiązaniami.
Wersje
To jest Teaching with Holarch instructor package v1.0, przygotowany dla EO-1 Reference Model v1.1. Nowa wersja otrzymuje nowe nazwy plików; wcześniejsze wersje pozostają dostępne pod swoimi adresami.
- v1.0: Pierwsze wydanie: efekty uczenia się kursu i zadania A1–A6 z kryteriami oceny, dla EO-1 Reference Model v1.1.
Jak cytować
Cytuj użytą wersję:
Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.
Licencja
Pliki pakietu dla prowadzących są udostępnione na licencji Creative Commons Uznanie autorstwa 4.0 Międzynarodowe (CC BY 4.0). Można je kopiować, udostępniać i dostosowywać w dowolnym celu, także komercyjnym, pod warunkiem odpowiedniego uznania autorstwa, podania łącza do licencji i wskazania, czy wprowadzono zmiany. Uznanie autorstwa: „Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0”. Każdy plik do pobrania zawiera tę informację.
EO-1 Reference Model ma własną formułę uznania autorstwa: „EO-1 Reference Model v1.1, Holarch, CC BY 4.0”. Wszystkie nazwy, osoby i wyniki w EO-1 są wymyślone.
Licencja obejmuje wyłącznie pliki pakietu. Notatki z rozwiązaniami nie należą do pakietu, a licencja nie obejmuje oprogramowania Holarch.