Holarch

Pacchetto per i docenti · v1.0

Insegnare con Holarch: pacchetto per i docenti

Risultati di apprendimento del corso e sei esercitazioni con rubriche per un corso semestrale di ingegneria dei sistemi o MBSE, tutti basati sull’EO-1 Open MBSE Reference Model v1.1, un CubeSat 6U fittizio per l’osservazione della Terra. Gratuito con licenza CC BY 4.0.

Scarica il pacchetto per i docenti v1.0

Tutti i file (.zip, 17 KB)

File Markdown che si aprono in qualsiasi editor. Usa l’EO-1 Reference Model v1.1. Licenza: CC BY 4.0, attribuzione "Holarch".

In questa pagina
  1. Contenuto
  2. Come usarlo
  3. Note con le soluzioni
  4. Risultati di apprendimento
    1. Corrispondenza con le esercitazioni
  5. A1 · Tracciare un’esigenza
  6. A2 · Rielaborazione e revisione dei requisiti
  7. A3 · Trovare le lacune di copertura
  8. A4 · Estendere l’architettura
  9. A5 · Gestire la modifica
  10. A6 · Piano di validazione
  11. Insegnare SysML v2 con Holarch: cosa controlla e cosa si limita a conservare
  12. Download
  13. Versioni
  14. Come citare
  15. Licenza

Contenuto

FilePerContenuto
learning-outcomes.mdDocenti, documentazione per l’accreditamentoI risultati di apprendimento del corso, le esercitazioni che valutano ciascuno e le funzionalità di Holarch utilizzate.
Da assignments/A1-trace-a-need.md a A6-validation-plan.mdStudenti (da distribuire)Sei esercitazioni su EO-1, ciascuna con contesto, compito, cosa consegnare e una rubrica.
sysml-v2-teaching-boundaries.mdDocentiCosa controllano i progetti SysML v2 di Holarch, cosa conservano senza interpretarlo e cosa non è ancora disponibile.

Come usarlo

  1. Dare a ogni gruppo la propria copia di EO-1 v1.1. In Holarch: Manage Projects → Project Files ▾ → New Demo Project → CubeSat EO-1, oppure scaricare eo-1-v1.1.holarch.json da holarch.app/reference-models/eo-1/ e importarlo con Manage Projects → Project Files ▾ → Import Project…. Ogni esercitazione parte dal modello così come viene distribuito.
  2. Gestire il corso in un’organizzazione di tipo corso. Aggiungere ogni esercitazione con la sua scadenza in Organization Settings → Class Review → + New Assignment. Class Review conserva una versione di ogni progetto di gruppo a ogni scadenza e mostra il lavoro di ogni studente.
  3. Per A2, entrare in ogni progetto di gruppo come Revisore: si possono commentare, approvare, respingere e riaprire i requisiti, e nient’altro.
  4. Per A6, gli studenti partono dal modello predefinito Verification and Validation Plan. Per dare loro una versione ridotta con le proprie istruzioni, salvarne una come modello dell’organizzazione (Write ▾ → Templates ▸ Save as Template…, Save to: Organization) e renderla predefinita per Test Plan Document.
  5. Impostare pesi, dimensioni dei gruppi e scadenze per il proprio corso. I pesi indicati sono suggerimenti.

Le esercitazioni nominano pagine di Holarch, ma a ogni domanda si può rispondere anche dai file CSV di EO-1, quindi possono partecipare anche gli studenti che lavorano con un altro strumento.

Note con le soluzioni

Le note con le soluzioni, con rilievi attesi, risposte di esempio ed errori frequenti per A1–A6, non sono pubblicate, quindi gli studenti non possono scaricare le risposte. I docenti le scaricano in Holarch: Organization Settings → Class Review → Download Solution Notes. Il pulsante è visibile agli amministratori (docenti e assistenti) di un’organizzazione con stato di corso.

Risultati di apprendimento

Corso: Model-Based Systems Engineering, un semestre, ultimi anni della laurea triennale o primo anno della magistrale.

Alla fine del corso, gli studenti sanno:

#RisultatoValutato daFunzionalità di Holarch usate
LO1Distinguere le esigenze degli stakeholder dai requisiti di sistema e tracciare ogni esigenza fino ai requisiti che la formalizzano.A1, esame intermedioStatement, relazioni traced to, la sezione Trace della Item View, matrice di tracciabilità
LO2Scrivere requisiti necessari, singoli, non ambigui e verificabili, con un metodo di verifica e criteri di successo.A2, esame intermedioAttributi dei requisiti, Quality, TBD/TBR
LO3Condurre un ciclo di revisione e approvazione dei requisiti e rispondere ai commenti di revisione con modifiche al modello.A2, partecipazione alla revisioneRuolo Reviewer, Approvals (Approve, Reject…, Reopen), commenti con menzioni
LO4Analizzare la copertura di tracciabilità e di verifica e decidere, per ogni lacuna, se è sbagliato il modello o il requisito.A3Matrice di tracciabilità, RVTM, controlli del modello
LO5Scomporre le funzioni, definire un’architettura logica, allocare le funzioni a elementi logici e fisici e derivarne le interfacce.A4, esame finaleDiagrammi di Action e FFBD, Asset, allocazione, registro delle interfacce
LO6Valutare tramite il modello l’impatto di una modifica a un requisito e registrare una decisione per ogni elemento coinvolto.A5, esame finaleLinks to Review, analisi d’impatto, Change Requests, Baselines & Versions
LO7Pianificare verifica e validazione: distinguerle, scegliere i metodi, scrivere procedure di test e di validazione nei termini corretti e leggere una RVTM.A6, esame finaleCasi di test e suite, Test Center, RVTM e VCRM, modelli di documento
LO8Produrre deliverable di ingegneria dal modello e mantenerli coerenti con esso: documenti in baseline e matrici esportate per la revisione.A2, A6, esame finaleDocumenti, matrici dinamiche, baseline, esportazione in Word ed Excel
LO9 (facoltativo)Leggere e scrivere la notazione testuale SysML v2 per un sottosistema e indicare quali proprietà uno strumento ha controllato e quali si è limitato a conservare.Parte facoltativa di A6Progetto SysML v2, i controlli dell’Editor, la nota didattica su SysML v2

Corrispondenza con le esercitazioni

RisultatoA1 Tracciare un’esigenzaA2 Rielaborazione dei requisitiA3 Lacune di coperturaA4 ArchitetturaA5 Impatto della modificaA6 Piano di validazione
LO1●○○
LO2●○
LO3●
LO4○●○
LO5●
LO6●
LO7○○○●
LO8○●

● risultato principale valutato, ○ contribuisce anche.

Note per il docente

  • I risultati descrivono competenze di ingegneria dei sistemi, non l’abilità con lo strumento. Holarch è il luogo in cui gli studenti si esercitano; i file CSV di EO-1 permettono a uno studente di dimostrare ogni risultato anche senza di esso.
  • I risultati seguono la pratica comune dell’ingegneria dei sistemi, per esempio i processi tecnici della ISO/IEC/IEEE 15288: definizione delle esigenze e dei requisiti degli stakeholder, definizione dei requisiti di sistema, definizione dell’architettura, verifica e validazione. Vanno ricondotti ai criteri di accreditamento del proprio corso di studi come richiesto dall’ateneo.

A1 · Tracciare un’esigenza

Risultati: LO1 (principale), LO4, LO7 · Dimensione del gruppo: individuale · Peso suggerito: 8 %

Contesto

Il cliente di EO-1, un’azienda di analisi agricole, ha espresso tre esigenze. N2 Twice-Weekly Revisit recita: «I clienti agricoli hanno bisogno di immagini aggiornate dei loro campi almeno due volte alla settimana durante la stagione di crescita.» Un’esigenza è soddisfatta solo quando i requisiti che la formalizzano sono soddisfatti dal progetto e verificati, e l’esigenza stessa è validata con il cliente.

Compito

  1. Seguire N2 attraverso il modello: i requisiti a cui è tracciata, i loro figli, le funzioni e i componenti che soddisfano ciascuno di essi e i casi di test che li verificano, con lo stato di ogni test.
  2. Rappresentare la catena come tabella o piccolo diagramma: una riga o un riquadro per elemento, con numero, nome, stato e la relazione che lo collega.
  3. Trovare l’attività di validazione di N2 e il suo stato.
  4. Rispondere: quali evidenze mancano ancora perché N2 si possa considerare validata? Elencare ogni elemento mancante, l’elemento del modello a cui appartiene e cosa servirebbe per chiuderlo.
  5. Cercare requisiti che supportano N2 ma non sono tracciati a essa. Indicare un candidato e argomentare a favore o contro l’aggiunta della traccia. Non aggiungerla al modello.

In Holarch: aprire N2 nella Item View e leggere la sezione Traccia, poi usare Verification → Traceability Matrix, Verification → RVTM e Verification → Test Center. Senza Holarch: eo-1-v1.1-traceability.csv e eo-1-v1.1-rvtm.csv.

Da consegnare

Una nota di una o due pagine (Word o PDF) con la catena, le evidenze mancanti e la risposta al passo 5. Per questa esercitazione il modello non va modificato.

Rubrica di valutazione

Criterio4 Eccellente3 Competente2 In sviluppo1 Iniziale
Catena completa e corretta (40 %)Ogni elemento da N2 ai test, con relazioni e stati corretti, compresi entrambi i figli e l’attività di validazione.Un elemento o uno stato mancante o errato.La catena si ferma ai requisiti o tralascia un figlio.Elementi elencati senza relazioni.
Evidenze mancanti (35 %)Indica ogni lacuna (test non eseguiti, un padre senza una propria verifica, requisiti non ancora approvati, la validazione non eseguita, il figlio senza una funzione) e cosa chiude ciascuna.La maggior parte delle lacune, con ciò che le chiude.Elenca le lacune senza dire cosa le chiude.Dice solo «mancano i test».
Verifica e validazione (15 %)Le mantiene sempre distinte: i requisiti si verificano, l’esigenza si valida.Un errore.Considera un test superato come validazione dell’esigenza.Nessuna distinzione.
Traccia candidata (10 %)Un requisito specifico con un’argomentazione motivata in un senso o nell’altro.Un candidato con un’argomentazione debole.Un candidato senza argomentazione.Mancante.

A2 · Rielaborazione e revisione dei requisiti

Risultati: LO2 (principale), LO3, LO8 · Dimensione del gruppo: gruppo · Peso suggerito: 10 %

Contesto

Tre requisiti di EO-1 sono ancora bozze e ottengono il 44 % nel controllo di qualità di Holarch:

  • 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."

Il requisito 3.5 ha anche un problema aperto, ISS-3 Battery heater set point not chosen, e un commento di revisione del comitato di revisione del progetto, RID-1 No cold-case analysis for the battery heater.

Compito

  1. Per ciascuno dei tre, elencare cosa lo rende debole, parola per parola dove conta.
  2. Riscrivere ciascuno nel progetto del gruppo: un solo «shall», una condizione misurabile e un punto di partenza o una condizione espliciti dove sono in gioco tempi o intervalli. Sostituire ogni TBD con un valore e registrarne la motivazione, oppure mantenere un TBR con un responsabile e una data. Per 3.5, spiegare come la riscrittura risponde a ISS-3 e RID-1.
  3. Compilare Verification Method, Livello di verifica e Criteri di successo per ciascuno.
  4. Tracciare ciascuno alla sua origine (un’esigenza, un requisito padre o una fonte) e alla funzione che lo soddisfa. Se nessuna funzione esiste, indicare la funzione mancante.
  5. Impostare ciascuno su In Review. Il docente li revisiona come Reviewer. Rispondere a ogni commento nel modello (modificare il requisito o rispondere con una motivazione), poi risolvere il commento.
  6. Salvare una baseline del documento EO-1 System Requirements Specification (SRS-001) con il nome «A2 handed in» ed esportarla in Word.

In Holarch: Needs & Requirements → Quality, l’ispettore del requisito, Needs & Requirements → Approvals e, nel documento, Version ▾ → Save Baseline… e Deliver ▾ → Specification (Word).

Da consegnare

L’esportazione Word, più una nota di mezza pagina sulle debolezze trovate al passo 1. Insieme a questi si valuta il modello così com’è alla scadenza.

Rubrica di valutazione

Criterio4 Eccellente3 Competente2 In sviluppo1 Iniziale
Requisiti riscritti (40 %)Tutti e tre singoli, misurabili e verificabili; condizioni e punti di partenza espliciti; valori giustificati.Un requisito ha ancora un termine vago o una condizione mancante.Valori aggiunti, ma condizioni o motivazioni mancanti.Formulazione cambiata, ancora non verificabile.
Attributi di verifica (20 %)Metodo, livello e criteri di successo adatti a ogni requisito ed eseguibili così come scritti.Una incongruenza, per esempio Test dove è possibile solo Analysis.Metodi impostati, criteri di successo vaghi.Mancante.
Tracciabilità (15 %)Ciascuno tracciato alla sua fonte e alla funzione che lo soddisfa, oppure indicata la funzione mancante.Una traccia mancante.Solo le fonti.Nessuna.
Ciclo di revisione (15 %)Ogni commento di revisione ha risposta nel modello ed è risolto; i requisiti respinti sono rielaborati e ripresentati.Un commento lasciato aperto.Commenti con risposta ma senza modifiche al modello.Commenti ignorati.
Analisi delle debolezze (10 %)Precisa: indica ogni termine vago e perché non è verificabile.Generica ma corretta.Ripete il punteggio di qualità.Mancante.

A3 · Trovare le lacune di copertura

Risultati: LO4 (principale), LO1, LO2, LO7 · Dimensione del gruppo: gruppo · Peso suggerito: 10 %

Contesto

EO-1 è alla revisione critica del progetto (CDR). Il modello è volutamente imperfetto: alcuni requisiti non hanno una funzione che li soddisfa, alcuni non hanno un test, alcuni test sono falliti e un’equazione non è collegata a nulla.

Compito

Lavorare sul modello così come viene distribuito nella v1.1. Usare una copia nuova se il progetto del gruppo è cambiato.

  1. Elencare ogni requisito che nessuna funzione soddisfa.
  2. Elencare ogni requisito che nessun caso di test verifica e quelli i cui test sono falliti, con il problema aperto ed eventuali deroghe registrate.
  3. Elencare i requisiti senza un componente che li soddisfa. Decidere quali ne hanno bisogno e quali sono giustamente soddisfatti a livello di missione o di segmento.
  4. Trovare gli elementi del modello a cui nulla è tracciato. Suggerimento: osservare le equazioni di potenza.
  5. Per ogni lacuna, decidere: al modello manca qualcosa (una funzione, un componente, un test, un collegamento), oppure il requisito non serve o è scritto male? Dare una frase di motivazione per lacuna.
  6. Chiudere tre lacune a scelta nel progetto del gruppo, ciascuna come una modifica identificabile in Control & Reviews → Activity.

In Holarch: Verification → Traceability Matrix, Verification → RVTM, Verification → Model Checks e Risks, Issues & Decisions → Issues & Actions. Senza Holarch: eo-1-v1.1-traceability.csv (la colonna Copertura), eo-1-v1.1-rvtm.csv, eo-1-v1.1-issues-actions.csv e eo-1-v1.1-deviations-waivers.csv.

Da consegnare

Una tabella delle lacune (lacuna, elemento, decisione, motivazione, chiusa sì o no) in Excel o Word e un elenco delle tre modifiche eseguite.

Rubrica di valutazione

Criterio4 Eccellente3 Competente2 In sviluppo1 Iniziale
Lacune trovate (35 %)Tutte le lacune di funzioni, test, componenti ed elementi orfani, compresi i test falliti con i relativi problemi e la deroga.Una o due lacune non individuate.Trovate solo le bozze evidenti.Meno della metà.
Decisioni (35 %)Ogni lacuna riceve una decisione sostenibile; distingue il progetto mancante dai requisiti non necessari o con un ambito errato e dalla soddisfazione a livello di missione.La maggior parte delle decisioni è fondata.Ogni lacuna trattata come «aggiungere un collegamento».Nessuna decisione.
Modifiche eseguite (20 %)Tre modifiche che chiudono davvero delle lacune, ciascuna un passo pulito nella cronologia.Due modifiche valide.Modifiche che nascondono una lacuna, come un collegamento aggiunto senza motivo.Nessuna.
Presentazione (10 %)La tabella è ordinabile e completa.Omissioni minori.Difficile da seguire.Mancante.

A4 · Estendere l’architettura

Risultati: LO5 (principale), LO4 · Dimensione del gruppo: gruppo · Peso suggerito: 12 %

Contesto

L’architettura logica di EO-1 (L0) copre solo le parti di alimentazione e gestione dati: da L1 Power Generation a L6 Fault Management. Ogni elemento logico raggruppa funzioni (allocated to) ed è realizzato da una parte fisica (related to); per esempio F3.1 Convert Sunlight to Power è allocata a L1, e 1.3.1 Solar Arrays realizza L1. La determinazione e il controllo d’assetto hanno le funzioni F4.1 Estimate Attitude, F4.2 Compute Control Torques, F4.3 Drive Reaction Wheels e F4.4 Unload Wheel Momentum e parti fisiche sotto 1.2 ADCS, ma nessun livello logico.

Compito

  1. Aggiungere sotto L0 elementi logici per la determinazione e il controllo d’assetto. Ogni elemento dichiara il proprio scopo senza nominare l’hardware.
  2. Allocare loro le funzioni da F4.1 a F4.4 e mettere in relazione ogni elemento logico con le parti fisiche sotto 1.2 ADCS che lo realizzano, seguendo lo schema di L1–L6.
  3. Disegnare il diagramma di Action di F4 con gli elementi che fluiscono tra le sue sottofunzioni, per esempio la stima d’assetto e i comandi di coppia, se il progetto del gruppo non ne ha ancora uno.
  4. Dai flussi che attraversano i confini degli elementi, derivare le interfacce. Confrontarle con le interfacce esistenti IF-06, IF-16, IF-17 e IF-18: quali corrispondono, quali mancano e quali trasportano elementi che nessuna funzione usa?
  5. Verificare che i requisiti da 2.1 a 2.4 siano soddisfatti ciascuno dalla funzione che svolge il lavoro e indicare quale elemento logico è quindi responsabile di ciascun requisito.

In Holarch: Architecture → Assets, Behavior → Action Diagrams (F4), la sezione Traccia dell’ispettore per le allocazioni, Interfaces → Interface Register e il preset Gerarchia di allocazione del diagramma di gerarchia. Senza Holarch: eo-1-v1.1-allocation-chain.csv e eo-1-v1.1-icd.csv.

Da consegnare

Una breve descrizione dell’architettura (da due a tre pagine, Word o PDF): gli elementi logici con i loro scopi, la tabella di allocazione (funzione → elemento logico → parte fisica), il diagramma di Action di F4 e il confronto delle interfacce.

Rubrica di valutazione

Criterio4 Eccellente3 Competente2 In sviluppo1 Iniziale
Elementi logici (25 %)Indipendenti dalla soluzione, coesi, ciascuno con uno scopo chiaro; nessun nome di hardware.Un elemento nomina l’hardware o mescola scopi diversi.Gli elementi ricalcano le parti fisiche.Mancanti o poco chiari.
Allocazione (30 %)Ogni sottofunzione allocata una sola volta all’elemento giusto; elementi realizzati da parti; coerente nel modello.Un’allocazione discutibile.Allocazioni solo alle parti, saltando il livello logico.Incompleta.
Flussi e interfacce (30 %)Interfacce derivate dai flussi che attraversano i confini; confronto preciso con IF-06, IF-16, IF-17 e IF-18, comprese le lacune in entrambe le direzioni.Confronto in gran parte corretto.Interfacce elencate, non derivate.Mancante.
Responsabilità dei requisiti (15 %)Ciascuno dei requisiti da 2.1 a 2.4 tracciato attraverso la sua funzione fino a un elemento logico, con le incoerenze indicate.Uno mancante.Elencati senza verifica.Mancante.

A5 · Gestire la modifica

Risultati: LO6 (principale), LO7 · Dimensione del gruppo: gruppo · Peso suggerito: 10 %

Contesto

Dopo la revisione del progetto, il requisito 3.1 Orbit Average Power è passato da 28 W a 30 W di potenza media orbitale a fine vita. Il caso di test TC-06 Solar Array Power Test era stato superato rispetto al vecchio valore. Holarch ha contrassegnato da rivedere i collegamenti di 3.1.

Compito

  1. Elencare ogni elemento raggiunto dalla modifica: in avanti attraverso i collegamenti di 3.1, all’indietro verso ciò da cui 3.1 deriva, e gli elementi che citano il vecchio valore senza un collegamento a 3.1. Indicare come è stato trovato ciascuno.
  2. Per ogni elemento, scrivere la domanda che la modifica solleva, il rilievo (con i numeri dove il modello li contiene) e una decisione: nessuna modifica (segnare il collegamento come revisionato con un commento), aggiornamento, oppure rinvio al comitato di controllo delle modifiche.
  3. Decidere cosa fare di TC-06: un test superato a 28 W dimostra ancora 30 W? Mostrare i calcoli a partire dalle equazioni del modello.
  4. Trovare un elemento che l’analisi basata sui collegamenti non individua e spiegare perché è importante.
  5. Registrare le decisioni nel progetto del gruppo: un commento su ogni collegamento segnato come revisionato, una richiesta di modifica per ciò che il comitato deve decidere e una baseline prima e dopo.

In Holarch: Needs & Requirements → Links to Review, l’analisi d’impatto da 3.1 (Open in ▾ → Spider, poi Impatto), la sezione Traccia dell’ispettore, le equazioni di potenza da EQ-1.1 a EQ-1.4 e TPM-2 (Architecture → Budgets & TPMs), Control & Reviews → Change Requests e Control & Reviews → Baselines & Versions. Senza Holarch: eo-1-v1.1-traceability.csv e eo-1-v1.1-change-impact-3.1.csv, la registrazione d’impatto pubblicata; svolgere prima la propria analisi, poi confrontare.

Da consegnare

Una registrazione d’impatto (una tabella: elemento, come è stato raggiunto, domanda, rilievo, decisione, stato) e una raccomandazione di un paragrafo al comitato di controllo delle modifiche.

Rubrica di valutazione

Criterio4 Eccellente3 Competente2 In sviluppo1 Iniziale
Copertura (30 %)Trovati gli elementi in avanti, all’indietro e tramite ricerca testuale, compresi quelli che nessun collegamento raggiunge.Solo i collegamenti, tutti.Alcuni collegamenti in avanti.Solo 3.1 e TC-06.
Rilievi con numeri (30 %)Usa i valori e le equazioni del modello; il deficit di TC-06 è calcolato e spiegato.Numeri in gran parte corretti.Solo qualitativi.Conclusioni errate.
Decisioni (25 %)Ogni elemento ha una decisione coerente con il rilievo; collegamenti segnati come revisionati solo con un motivo; elementi per il comitato tenuti separati.Una decisione debole.Segna i collegamenti come revisionati senza motivi.Nessuna decisione.
Registrazione nel modello (15 %)Commenti, richiesta di modifica e baseline presenti e coerenti con la registrazione.Uno mancante.Solo il documento.Nulla nel modello.

A6 · Piano di validazione

Risultati: LO7 (principale), LO8, LO1 · Dimensione del gruppo: gruppo · Peso suggerito: 10 %

Contesto

La verifica chiede se EO-1 è stato costruito correttamente rispetto ai suoi requisiti; la validazione chiede se è il sistema giusto per i clienti agricoli. La suite di validazione di EO-1 TS-3 Mission Validation contiene VAL-01 Customer Alert Pilot (per N1, non eseguito), VAL-02 Growing Season Revisit Simulation (per N2, non eseguito) e VAL-03 Agronomist Map Review (per N3, superato).

Iniziare il piano in Needs & Requirements → Documents → + New Document. In Modello, impostare Modelli per su Test Plan Document e scegliere il modello predefinito Verification and Validation Plan con Includi indicazioni di scrittura, oppure il modello dell’organizzazione pubblicato dal docente per questa esercitazione.

Compito

  1. 5.1 Operational Scenarios: scrivere lo scenario per VAL-01 nei termini del cliente: chi fa cosa, in quale giorno, con quale risultato. Indicare l’esigenza che mette alla prova.
  2. 5.2 Users and Participants: indicare gli utenti rappresentativi e cosa decide ciascuno.
  3. 5.3 Validation Environment: descrivere l’ambiente, in cosa differisce dall’esercizio operativo e cosa significa questa differenza per il risultato.
  4. Scrivere i criteri di accettazione di VAL-01 in modo che un cliente possa rispondere sì o no senza giudizio ingegneristico, e registrarli nel campo Risultato atteso del caso di test.
  5. 8 Verification Status: leggere la matrice dinamica. Prendere il test fallito TC-04 Pointing Accuracy Test e spiegare cosa significherebbe il risultato di VAL-01 se TC-04 risultasse ancora fallito al momento del pilota.
  6. Esportare il piano in Word.

Facoltativo: bonus SysML v2 (LO9, fino al 10 % in più)

Creare un progetto SysML v2 da eo-1-v1.1-power-subsystem.sysml (Manage Projects → Project Files ▾ → Import SysML v2 Files…). Il file contiene ancora il requisito 3.1 a 28 W. Portare la potenza media orbitale richiesta a 30 W, la modifica di A5, e leggere cosa segnala l’Editor. È un errore di modellazione o un rilievo di progetto? Poi modificare i valori di progetto, non il requisito, finché la riga di stato dell’Editor non indica Nessun problema, e dire se i nuovi valori sono fisicamente credibili. In mezza pagina, indicare quali delle proprie affermazioni lo strumento ha controllato e quali si è limitato a conservare; la nota didattica su SysML v2 condivisa dal docente elenca entrambe.

Da consegnare

  • L’esportazione Word del piano.
  • Per il bonus SysML v2: il file .sysml e la mezza pagina.

Rubrica di valutazione

Criterio4 Eccellente3 Competente2 In sviluppo1 Iniziale
Scenario nei termini del cliente (30 %)Concreto, calato nella giornata tipo, senza gergo ingegneristico; mette chiaramente alla prova N1.Chiaro, con un po’ di gergo.Una procedura di test, non uno scenario.Mancante o generico.
Criteri di accettazione (25 %)Osservabili, sì o no, di competenza del cliente; legati a «il giorno di un passaggio» di N1.In gran parte osservabili.Solo soglie ingegneristiche.Vaghi.
Partecipanti e ambiente (20 %)Utenti rappresentativi indicati con le loro decisioni; differenze rispetto all’esercizio operativo e loro effetto dichiarati.Uno mancante.Elencati senza effetto.Mancante.
Ragionamento su V&V (15 %)Spiega perché un pilota di validazione può riuscire o fallire indipendentemente da TC-04 e cosa significa ciascun esito.In gran parte fondato.Confonde verifica e validazione.Mancante.
Deliverable (10 %)Esportazione Word pulita, indicazioni del modello sostituite dai contenuti.Restano testi di indicazione.Esportato in parte.Mancante.
Bonus SysML v2 (fino a +10 %)Rilievo spiegato; No problems, con valori credibili; dichiarazione precisa di cosa è stato controllato e cosa conservato.No problems; dichiarazione generica.Requisito indebolito invece di modificare il progetto, oppure problemi rimasti.Nessun punteggio.

Insegnare SysML v2 con Holarch: cosa controlla e cosa si limita a conservare

I progetti SysML v2 di Holarch supportano un sottoinsieme della specifica OMG SysML v2. Lo stato attuale di ogni area è nella pagina sulla copertura del linguaggio SysML v2 (holarch.app/sysml-v2-coverage/); consultarla prima di ogni semestre. Quando si insegna il linguaggio con Holarch, conviene tenere distinti tre tipi di affermazione, in modo che gli studenti non scambino un limite dello strumento per una regola del linguaggio, né un costrutto che lo strumento ha conservato per uno che ha controllato:

  • Controllato: l’Editor analizza il costrutto e lo controlla durante la digitazione, e le viste e le pagine lo utilizzano. Quando la riga di stato dell’Editor indica No problems, questi controlli sono superati.
  • Conservato, non interpretato: analizzato e conservato esattamente come scritto, nel testo e nelle esportazioni, ma senza alcun significato attribuito. No problems non dice nulla sulla sua correttezza.
  • Non ancora in Holarch: il costrutto o la funzionalità non è disponibile in Holarch. Resta SysML v2 valido.

Controllato: si può insegnare e valutare con lo strumento

AreaCosa gli studenti possono contare che l’Editor rilevi
SintassiCaratteri, commenti, stringhe, parentesi graffe, ;, nomi e token attesi.
Nomi e importNomi non risolti, ambigui, duplicati e privati; import di membri, di namespace, ricorsivi e filtrati.
Definizioni, usi, specializzazionepart, attribute, port, action, state, requirement e gli altri tipi con le loro definizioni; tipizzazione, subsetting, ridefinizione e coniugazione; cicli e tipo di definizione errato.
Molteplicità, valori e unitàLimiti validi; grandezze con i tipi di grandezza ISQ e le unità SI e consuetudinarie statunitensi; controlli dimensionali: una potenza dove è attesa una massa è un errore.
Vincoli e calcoliTipi degli operandi, argomenti dei calcoli, condizioni booleane e valutazione: vengono segnalati vincoli, requisiti e obiettivi che non sono rispettati con i valori correnti.
StrutturaEstremità delle connessioni; direzioni di porte, flussi e messaggi; interfacce e connettori di binding.
Azioni e statiDestinazioni delle successioni, nodi di controllo, i valori su cui itera un ciclo for, transizioni iniziali, regioni parallele, trigger delle transizioni ed effetti do.
Requisiti e casi d’usosubject, actor, stakeholder, require e assume constraint, destinazioni di satisfy, verify e frame nelle posizioni corrette.
Allocazioneallocate … to …, definizioni di allocazione, dipendenze.
VariabilitàUna variazione possiede solo varianti del suo tipo, una scelta è una variante del suo punto e i valori della scelta vengono valutati.
Individui, snapshot e time sliceCiascuno possiede le feature dell’occorrenza a cui appartiene; i suoi valori vengono letti per primi.

Controllato in parte: insegnare indicando il limite

AreaControllato o eseguitoLimite da comunicare agli studenti
AzioniIl Simulator esegue i flussi di azioni, comprese le esecuzioni Monte Carlo.Durate dei passi, probabilità dei rami e numero di iterazioni sono impostazioni del Simulator conservate in Holarch, non nel testo, quindi un’esportazione .sysml non le contiene.
StatiIl Simulator esegue le macchine a stati con stimoli e mostra gli stati attivi.Lo stesso: le impostazioni del Simulator non fanno parte del testo.
Casi di analisi e di verificaSoggetto, obiettivo, risultato restituito; verify e un verdetto.Un caso di analisi viene valutato solo quando ogni input ha un valore; non c’è un risolutore. In una Parametric View, Solve trova un’incognita per vincolo. Le analisi di studio di trade-off della libreria standard non vengono valutate.
Visteview, view def, expose, filtri, viewpoint e le definizioni di vista standard; le Sequence View disegnano i frammenti alt, opt, loop e par.Il layout appartiene a Holarch, non al modello.
VariabilitàVariazioni, varianti e configurazioni vengono controllate e valutate.Holarch non cerca né elenca ancora tutte le combinazioni valide.
Metadati e parole chiave@Name, #Name, metadata … about, parole chiave definite dall’utente tramite metadati semantici.Gli altri metadati definiti dall’utente non hanno significato oltre ai loro valori; i metadati scritti con about non aggiungono alcun tipo base.
Rappresentazioni testualiI corpi rep … language in SysML e KerML vengono controllati, e il corpo di un vincolo SysML viene valutato.I corpi in altri linguaggi, come Python, OCL o MATLAB, vengono conservati come testo e mai eseguiti.
Scambio SysML v2 JSONImportazione ed esportazione nel formato degli elementi della Systems Modeling API, con gli id degli elementi conservati.I tipi di elemento che Holarch non interpreta vengono conservati come importati e riscritti invariati; non hanno testo e non si possono modificare.

Conservato, non interpretato: qui No problems non dimostra nulla

  • Corpi di rappresentazioni testuali in linguaggi diversi da SysML e KerML.
  • I valori dei metadati definiti dall’utente diversi dai metadati semantici.
  • Testo doc e commenti: mai confrontati con il modello. Nel sottosistema di potenza di EO-1, portando il requisito 3.1 a 30 W il suo doc continua a dire 28 W, senza che venga segnalato alcun problema. Un buon esercizio.
  • I tipi di elemento che Holarch non interpreta in un file SysML v2 JSON importato.

Conta anche il contrario: stato dei requisiti, risultati di verifica ed etichette sono dati di Holarch. Non sono nel testo né in un’esportazione .sysml.

Non ancora in Holarch

  • File .kerml: non vengono importati, e i modelli scritti in KerML non vengono controllati. Il KerML viene letto solo per la libreria standard.
  • Estensioni del linguaggio diverse dalle parole chiave definite dall’utente; la libreria standard non si può modificare.
  • Un risolutore per i casi di analisi e una ricerca delle combinazioni di varianti valide nelle pagine di Holarch.
  • Commit della Systems Modeling API su main, tag e merge: gli altri strumenti eseguono commit nei rami delle richieste di modifica, e un approvatore li applica in Holarch.

Come usarlo in un corso

  • Dire «lo strumento ha controllato» solo per le aree controllate. Per esempio, No problems significa che le unità sono coerenti e che i requisiti sono rispettati con i valori correnti. Non significa che il testo doc corrisponda ai valori né che un corpo in Python sia corretto.
  • Valutare i costrutti conservati leggendoli. Valutarli tramite ispezione, non in base al numero di problemi.
  • Il comportamento viene eseguito nel Simulator sia per i flussi di azioni sia per le macchine a stati. Le durate e le probabilità usate dal Simulator sono impostazioni di Holarch: se gli studenti consegnano solo il file .sysml, chiedere anche le impostazioni.
  • Le regole del linguaggio derivano dalla specifica, non da uno strumento. Dove Holarch non ha implementato qualcosa, dire «non ancora in Holarch», non «non consentito».
  • Il bonus di A6 si basa su questa nota: gli studenti portano 3.1 a 30 W nel sottosistema di potenza di EO-1, vedono il controllo di valutazione segnalarlo, correggono il progetto e annotano cosa è stato controllato e cosa solo conservato.

Download

Il pacchetto è un unico file zip. Riporta la versione nel nome, così un corso può indicare esattamente la copia usata. I file CSV e di progetto delle esercitazioni sono i download dell’EO-1 Reference Model v1.1 nella pagina di EO-1.

FileContenuto
teaching-with-holarch-v1.0.zipTutti i file seguenti in un’unica cartella.
README.txtIl contenuto, come usare il pacchetto, l’avviso di licenza e la cronologia delle modifiche.
LICENSE.txtL’avviso di licenza.
learning-outcomes.mdI risultati di apprendimento del corso e la loro corrispondenza con le esercitazioni.
assignments/A1-trace-a-need.mdA1 Tracciare un’esigenza.
assignments/A2-requirements-rework.mdA2 Rielaborazione e revisione dei requisiti.
assignments/A3-coverage-gaps.mdA3 Trovare le lacune di copertura.
assignments/A4-extend-the-architecture.mdA4 Estendere l’architettura.
assignments/A5-work-the-change.mdA5 Gestire la modifica.
assignments/A6-validation-plan.mdA6 Piano di validazione.
sysml-v2-teaching-boundaries.mdInsegnare SysML v2 con Holarch: cosa controlla e cosa si limita a conservare.

Le note con le soluzioni non sono nello zip; vedere Note con le soluzioni.

Versioni

Questo è il pacchetto per i docenti Teaching with Holarch v1.0, scritto per l’EO-1 Reference Model v1.1. Una nuova versione riceve nuovi nomi di file; le versioni precedenti restano disponibili ai loro indirizzi.

  • v1.0: prima versione: i risultati di apprendimento del corso e le esercitazioni da A1 ad A6 con rubriche, per l’EO-1 Reference Model v1.1.

Come citare

Citare la versione utilizzata:

Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.

Licenza

I file del pacchetto per i docenti sono distribuiti con licenza Creative Commons Attribuzione 4.0 Internazionale (CC BY 4.0). È consentito copiarli, condividerli e adattarli per qualsiasi scopo, anche commerciale, a condizione di riconoscerne adeguatamente la paternità, fornire un link alla licenza e indicare se sono state apportate modifiche. Attribuzione: "Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0". Ogni download contiene questo avviso.

L’EO-1 Reference Model mantiene la propria riga di attribuzione: "EO-1 Reference Model v1.1, Holarch, CC BY 4.0". Tutti i nomi, le persone e i risultati di EO-1 sono inventati.

La licenza copre solo i file del pacchetto. Le note con le soluzioni non fanno parte del pacchetto, e il software Holarch non è coperto dalla licenza.

Pubblicato da Holarch