Holarch

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

Wszystkie pliki (.zip, 17 KB)

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
  1. Zawartość
  2. Jak z niego korzystać
  3. Notatki z rozwiązaniami
  4. Efekty uczenia się
    1. Przyporządkowanie do zadań
  5. A1 · Prześledź potrzebę
  6. A2 · Poprawa i przegląd wymagań
  7. A3 · Znajdź luki w pokryciu
  8. A4 · Rozbuduj architekturę
  9. A5 · Przeprowadź zmianę
  10. A6 · Plan walidacji
  11. Nauczanie SysML v2 z Holarch: co sprawdza, a co tylko przechowuje
  12. Pliki do pobrania
  13. Wersje
  14. Jak cytować
  15. Licencja

Zawartość

PlikDlaZawartość
learning-outcomes.mdProwadzący, dokumentacja akredytacyjnaEfekty 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.mdStudenci (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.mdProwadzącyCo sprawdzają projekty SysML v2 w Holarch, co przechowują bez interpretacji i co nie jest jeszcze dostępne.

Jak z niego korzystać

  1. 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.json ze 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.
  2. 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.
  3. W A2 dołącz do każdego projektu grupy jako Recenzent: ta rola pozwala komentować, zatwierdzać, odrzucać i ponownie otwierać wymagania, nic więcej.
  4. 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.
  5. 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:

#EfektOceniane wUżywane funkcje Holarch
LO1Odróżnić potrzeby interesariuszy od wymagań systemowych i powiązać każdą potrzebę z wymaganiami, które ją formalizują.A1, kolokwium śródsemestralneStatement, relacje traced to, sekcja Trace w Item View, Traceability Matrix
LO2Pisać wymagania konieczne, pojedyncze, jednoznaczne i weryfikowalne, z metodą weryfikacji i kryteriami sukcesu.A2, kolokwium śródsemestralneAtrybuty wymagań, Quality, TBD/TBR
LO3Przeprowadzić cykl przeglądu i zatwierdzania wymagań oraz odpowiadać na komentarze z przeglądu zmianami w modelu.A2, udział w przeglądzieRola Reviewer, Approvals (Approve, Reject…, Reopen), komentarze ze wzmiankami
LO4Analizować identyfikowalność i pokrycie weryfikacją oraz rozstrzygać dla każdej luki, czy błędny jest model, czy wymaganie.A3Traceability Matrix, RVTM, Model Checks
LO5Dekomponować funkcje, definiować architekturę logiczną, alokować funkcje do elementów logicznych i fizycznych oraz wyprowadzać wynikające z tego interfejsy.A4, egzamin końcowyDiagramy Action i FFBD, Asset, alokacja, Interface Register
LO6Oceniać wpływ zmiany wymagania za pomocą modelu i zapisywać decyzję dla każdego objętego nią elementu.A5, egzamin końcowyLinks to Review, analiza wpływu, Change Requests, Baselines & Versions
LO7Planować weryfikację i walidację: odróżniać je, dobierać metody, pisać procedury testowe i walidacyjne we właściwych kategoriach i czytać RVTM.A6, egzamin końcowyPrzypadki i zestawy testowe, Test Center, RVTM i VCRM, szablony dokumentów
LO8Tworzyć 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ńcowyDokumenty, ż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ęść A6Projekt SysML v2, kontrole edytora, notatka o nauczaniu SysML v2

Przyporządkowanie do zadań

EfektA1 Prześledź potrzebęA2 Poprawa wymagańA3 Luki w pokryciuA4 ArchitekturaA5 Wpływ zmianyA6 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

  1. 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.
  2. 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.
  3. Znajdź działanie walidacyjne dla N2 i jego status.
  4. 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.
  5. 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

Kryterium4 Wzorowy3 Biegły2 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

  1. Dla każdego z nich wypisz, co je osłabia, słowo po słowie tam, gdzie ma to znaczenie.
  2. 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.
  3. Uzupełnij dla każdego pola Verification Method, Poziom weryfikacji i Kryteria sukcesu.
  4. 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ę.
  5. 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.
  6. 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

Kryterium4 Wzorowy3 Biegły2 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ł.

  1. Wymień każde wymaganie, którego nie spełnia żadna funkcja.
  2. 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.
  3. 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.
  4. Znajdź elementy modelu, z którymi nic nie jest powiązane. Wskazówka: przyjrzyj się równaniom zasilania.
  5. 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ę.
  6. 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

Kryterium4 Wzorowy3 Biegły2 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

  1. Dodaj pod L0 elementy logiczne dla wyznaczania i sterowania orientacją. Każdy element określa swój cel bez nazywania sprzętu.
  2. 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.
  3. 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.
  4. 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ę?
  5. 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

Kryterium4 Wzorowy3 Biegły2 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

  1. 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.
  2. 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.
  3. Zdecyduj, co zrobić z TC-06: czy test zaliczony przy 28 W nadal dowodzi 30 W? Przedstaw obliczenia na podstawie równań modelu.
  4. Znajdź jeden element, który analiza oparta na powiązaniach pomija, i wyjaśnij, dlaczego ma on znaczenie.
  5. 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

Kryterium4 Wzorowy3 Biegły2 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

  1. 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.
  2. 5.2 Users and Participants: wymień reprezentatywnych użytkowników i to, o czym każdy z nich decyduje.
  3. 5.3 Validation Environment: opisz środowisko, czym różni się od eksploatacji i co ta różnica oznacza dla wyniku.
  4. 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.
  5. 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.
  6. 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 .sysml i pół strony tekstu.

Kryteria oceny

Kryterium4 Wzorowy3 Biegły2 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

ObszarCo edytor na pewno wychwyci
SkładniaZnaki, komentarze, ciągi znaków, nawiasy klamrowe, ;, oczekiwane nazwy i tokeny.
Nazwy i importyNierozwiązane, niejednoznaczne, zduplikowane i prywatne nazwy; importy członków, przestrzeni nazw, rekurencyjne i filtrowane.
Definicje, użycia, specjalizacjapart, 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 jednostkiPoprawne 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 obliczeniaTypy 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.
StrukturaKońce połączeń; kierunki portów, przepływów i komunikatów; interfejsy i łączniki wiążące.
Akcje i stanyCele 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życiaCele subject, actor, stakeholder, require i assume constraint, satisfy, verify i frame we właściwych miejscach.
Alokacjaallocate … 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 czasoweKaż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

ObszarSprawdzane lub wykonywaneOgraniczenie do przekazania studentom
AkcjeSymulator 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.
StanySymulator wykonuje maszyny stanów z bodźcami i pokazuje aktywne stany.Tak samo: ustawienia symulatora nie są częścią tekstu.
Przypadki analizy i weryfikacjiPodmiot, 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.
Widokiview, 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 tekstoweTreś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 JSONImport 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 doc i komentarze: nigdy nie są porównywane z modelem. W podsystemie zasilania EO-1 zmiana wymagania 3.1 na 30 W pozostawia w jego doc wartość 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 doc zgadza 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.

PlikZawartość
teaching-with-holarch-v1.0.zipWszystkie poniższe pliki w jednym folderze.
README.txtZawartość, sposób korzystania z pakietu, informacja o licencji i historia zmian.
LICENSE.txtInformacja o licencji.
learning-outcomes.mdEfekty uczenia się kursu i ich przyporządkowanie do zadań.
assignments/A1-trace-a-need.mdA1 Prześledź potrzebę.
assignments/A2-requirements-rework.mdA2 Poprawa i przegląd wymagań.
assignments/A3-coverage-gaps.mdA3 Znajdź luki w pokryciu.
assignments/A4-extend-the-architecture.mdA4 Rozbuduj architekturę.
assignments/A5-work-the-change.mdA5 Przeprowadź zmianę.
assignments/A6-validation-plan.mdA6 Plan walidacji.
sysml-v2-teaching-boundaries.mdNauczanie 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.

Wydawca: Holarch