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
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
- Contenuto
- Come usarlo
- Note con le soluzioni
- Risultati di apprendimento
- A1 · Tracciare un’esigenza
- A2 · Rielaborazione e revisione dei requisiti
- A3 · Trovare le lacune di copertura
- A4 · Estendere l’architettura
- A5 · Gestire la modifica
- A6 · Piano di validazione
- Insegnare SysML v2 con Holarch: cosa controlla e cosa si limita a conservare
- Download
- Versioni
- Come citare
- Licenza
Contenuto
| File | Per | Contenuto |
|---|---|---|
learning-outcomes.md | Docenti, documentazione per l’accreditamento | I 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.md | Studenti (da distribuire) | Sei esercitazioni su EO-1, ciascuna con contesto, compito, cosa consegnare e una rubrica. |
sysml-v2-teaching-boundaries.md | Docenti | Cosa controllano i progetti SysML v2 di Holarch, cosa conservano senza interpretarlo e cosa non è ancora disponibile. |
Come usarlo
- 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.jsonda holarch.app/reference-models/eo-1/ e importarlo con Manage Projects → Project Files ▾ → Import Project…. Ogni esercitazione parte dal modello così come viene distribuito. - 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.
- Per A2, entrare in ogni progetto di gruppo come Revisore: si possono commentare, approvare, respingere e riaprire i requisiti, e nient’altro.
- 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.
- 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:
| # | Risultato | Valutato da | Funzionalità di Holarch usate |
|---|---|---|---|
| LO1 | Distinguere le esigenze degli stakeholder dai requisiti di sistema e tracciare ogni esigenza fino ai requisiti che la formalizzano. | A1, esame intermedio | Statement, relazioni traced to, la sezione Trace della Item View, matrice di tracciabilità |
| LO2 | Scrivere requisiti necessari, singoli, non ambigui e verificabili, con un metodo di verifica e criteri di successo. | A2, esame intermedio | Attributi dei requisiti, Quality, TBD/TBR |
| LO3 | Condurre un ciclo di revisione e approvazione dei requisiti e rispondere ai commenti di revisione con modifiche al modello. | A2, partecipazione alla revisione | Ruolo Reviewer, Approvals (Approve, Reject…, Reopen), commenti con menzioni |
| LO4 | Analizzare la copertura di tracciabilità e di verifica e decidere, per ogni lacuna, se è sbagliato il modello o il requisito. | A3 | Matrice di tracciabilità, RVTM, controlli del modello |
| LO5 | Scomporre le funzioni, definire un’architettura logica, allocare le funzioni a elementi logici e fisici e derivarne le interfacce. | A4, esame finale | Diagrammi di Action e FFBD, Asset, allocazione, registro delle interfacce |
| LO6 | Valutare tramite il modello l’impatto di una modifica a un requisito e registrare una decisione per ogni elemento coinvolto. | A5, esame finale | Links to Review, analisi d’impatto, Change Requests, Baselines & Versions |
| LO7 | Pianificare verifica e validazione: distinguerle, scegliere i metodi, scrivere procedure di test e di validazione nei termini corretti e leggere una RVTM. | A6, esame finale | Casi di test e suite, Test Center, RVTM e VCRM, modelli di documento |
| LO8 | Produrre deliverable di ingegneria dal modello e mantenerli coerenti con esso: documenti in baseline e matrici esportate per la revisione. | A2, A6, esame finale | Documenti, 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 A6 | Progetto SysML v2, i controlli dell’Editor, la nota didattica su SysML v2 |
Corrispondenza con le esercitazioni
| Risultato | A1 Tracciare un’esigenza | A2 Rielaborazione dei requisiti | A3 Lacune di copertura | A4 Architettura | A5 Impatto della modifica | A6 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
- 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.
- 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.
- Trovare l’attività di validazione di N2 e il suo stato.
- 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.
- 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
| Criterio | 4 Eccellente | 3 Competente | 2 In sviluppo | 1 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
- Per ciascuno dei tre, elencare cosa lo rende debole, parola per parola dove conta.
- 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.
- Compilare Verification Method, Livello di verifica e Criteri di successo per ciascuno.
- 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.
- 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.
- 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
| Criterio | 4 Eccellente | 3 Competente | 2 In sviluppo | 1 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.
- Elencare ogni requisito che nessuna funzione soddisfa.
- Elencare ogni requisito che nessun caso di test verifica e quelli i cui test sono falliti, con il problema aperto ed eventuali deroghe registrate.
- 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.
- Trovare gli elementi del modello a cui nulla è tracciato. Suggerimento: osservare le equazioni di potenza.
- 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.
- 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
| Criterio | 4 Eccellente | 3 Competente | 2 In sviluppo | 1 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
- Aggiungere sotto L0 elementi logici per la determinazione e il controllo d’assetto. Ogni elemento dichiara il proprio scopo senza nominare l’hardware.
- 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.
- 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.
- 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?
- 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
| Criterio | 4 Eccellente | 3 Competente | 2 In sviluppo | 1 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
- 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.
- 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.
- 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.
- Trovare un elemento che l’analisi basata sui collegamenti non individua e spiegare perché è importante.
- 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
| Criterio | 4 Eccellente | 3 Competente | 2 In sviluppo | 1 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
- 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.
- 5.2 Users and Participants: indicare gli utenti rappresentativi e cosa decide ciascuno.
- 5.3 Validation Environment: descrivere l’ambiente, in cosa differisce dall’esercizio operativo e cosa significa questa differenza per il risultato.
- 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.
- 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.
- 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
.sysmle la mezza pagina.
Rubrica di valutazione
| Criterio | 4 Eccellente | 3 Competente | 2 In sviluppo | 1 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
| Area | Cosa gli studenti possono contare che l’Editor rilevi |
|---|---|
| Sintassi | Caratteri, commenti, stringhe, parentesi graffe, ;, nomi e token attesi. |
| Nomi e import | Nomi non risolti, ambigui, duplicati e privati; import di membri, di namespace, ricorsivi e filtrati. |
| Definizioni, usi, specializzazione | part, 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 calcoli | Tipi degli operandi, argomenti dei calcoli, condizioni booleane e valutazione: vengono segnalati vincoli, requisiti e obiettivi che non sono rispettati con i valori correnti. |
| Struttura | Estremità delle connessioni; direzioni di porte, flussi e messaggi; interfacce e connettori di binding. |
| Azioni e stati | Destinazioni 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’uso | subject, actor, stakeholder, require e assume constraint, destinazioni di satisfy, verify e frame nelle posizioni corrette. |
| Allocazione | allocate … 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 slice | Ciascuno possiede le feature dell’occorrenza a cui appartiene; i suoi valori vengono letti per primi. |
Controllato in parte: insegnare indicando il limite
| Area | Controllato o eseguito | Limite da comunicare agli studenti |
|---|---|---|
| Azioni | Il 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. |
| Stati | Il 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 verifica | Soggetto, 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. |
| Viste | view, 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 testuali | I 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 JSON | Importazione 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
doce commenti: mai confrontati con il modello. Nel sottosistema di potenza di EO-1, portando il requisito 3.1 a 30 W il suodoccontinua 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
doccorrisponda 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.
| File | Contenuto |
|---|---|
| teaching-with-holarch-v1.0.zip | Tutti i file seguenti in un’unica cartella. |
README.txt | Il contenuto, come usare il pacchetto, l’avviso di licenza e la cronologia delle modifiche. |
LICENSE.txt | L’avviso di licenza. |
learning-outcomes.md | I risultati di apprendimento del corso e la loro corrispondenza con le esercitazioni. |
assignments/A1-trace-a-need.md | A1 Tracciare un’esigenza. |
assignments/A2-requirements-rework.md | A2 Rielaborazione e revisione dei requisiti. |
assignments/A3-coverage-gaps.md | A3 Trovare le lacune di copertura. |
assignments/A4-extend-the-architecture.md | A4 Estendere l’architettura. |
assignments/A5-work-the-change.md | A5 Gestire la modifica. |
assignments/A6-validation-plan.md | A6 Piano di validazione. |
sysml-v2-teaching-boundaries.md | Insegnare 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.