Holarch

Per i corsi · Modello di riferimento EO-1 v1.1

Esercitazioni per i corsi sul modello di riferimento EO-1

Sei esercitazioni per un corso di ingegneria dei sistemi, ciascuna con un compito, cosa consegnare e una rubrica di valutazione. Tutte si basano sull’EO-1 Open MBSE Reference Model, un CubeSat 6U fittizio per l’osservazione della Terra, così come viene distribuito. Gli studenti possono rispondere a ogni domanda in Holarch oppure dai file CSV del modello con qualsiasi strumento. Uso e adattamento liberi secondo CC BY 4.0.

In questa pagina
  1. Come usarle
  2. Risultati di apprendimento
  3. A1 · Tracciare un’esigenza
    1. Compito
    2. Da consegnare
    3. Rubrica di valutazione
  4. A2 · Rielaborazione e revisione dei requisiti
    1. Compito
    2. Da consegnare
    3. Rubrica di valutazione
  5. A3 · Trovare le lacune di copertura
    1. Compito
    2. Da consegnare
    3. Rubrica di valutazione
  6. A4 · Estendere l’architettura
    1. Compito
    2. Da consegnare
    3. Rubrica di valutazione
  7. A5 · Gestire la modifica
    1. Compito
    2. Da consegnare
    3. Rubrica di valutazione
  8. A6 · Piano di validazione
    1. Compito (parte A)
    2. Parte B: SysML v2 (facoltativa)
    3. Da consegnare
    4. Rubrica di valutazione
  9. Lavorare senza Holarch
  10. Insegnare SysML v2: cosa Holarch controlla e cosa si limita a conservare
    1. Controllato
    2. Controllato, con un limite da indicare
    3. Conservato, non interpretato
    4. Come usarlo in un corso
  11. Soluzioni
  12. Licenza e attribuzione

Come usarle

Le esercitazioni seguono il modello dalle esigenze degli stakeholder fino alla verifica e alla modifica. Si possono assegnare in ordine o scegliere quelle adatte al corso. Ciascuna indica i risultati di apprendimento che valuta, una dimensione di gruppo suggerita e una rubrica su quattro livelli con pesi; pesi e livelli si possono adattare al proprio sistema di valutazione.

  1. Fornire il modello a ogni studente o gruppo. Scaricare l’EO-1 Reference Model v1.1, oppure far creare il modello a ogni gruppo in Holarch con Manage Projects → Project Files ▾ → New Demo Project → CubeSat (Guided systems engineering). Ogni esercitazione parte dal modello così come viene distribuito; se il progetto di un gruppo è cambiato nel frattempo, il gruppo lavora su una copia nuova.
  2. Configurare il corso. Inserire i progetti dei gruppi in un’organizzazione di tipo corso, aggiungere sé stessi e gli assistenti a ogni progetto di gruppo con il ruolo Revisore e impostare la scadenza di ogni esercitazione in Class Review. La guida per i docenti contiene una checklist di configurazione e tre piani di modulo.
  3. Valutare il ragionamento, non l’abilità con lo strumento. Le rubriche premiano rilievi, decisioni e la loro giustificazione. Uno studente che lavora dai file CSV può raggiungere il livello massimo in ogni criterio, tranne in quelli che richiedono modifiche al modello.

Tutti i nomi, le persone, le organizzazioni e i risultati di EO-1 sono inventati. EO-1 non è un veicolo spaziale reale.

Risultati di apprendimento

I risultati descrivono competenze di ingegneria dei sistemi. Seguono 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.

RisultatoGli studenti sannoEsercitazione principaleAnche inFunzionalità di Holarch usate
LO1Distinguere le esigenze degli stakeholder dai requisiti di sistema e tracciare ogni esigenza fino ai requisiti che la formalizzano.A1A3, A6Statement, collegamenti traced to, la Vista elemento e la sua sezione Traccia, la matrice di tracciabilità
LO2Scrivere requisiti necessari, singoli, non ambigui e verificabili, con un metodo di verifica e criteri di successo.A2A3Attributi dei requisiti, Qualità, il registro TBD/TBR
LO3Condurre un ciclo di revisione e approvazione dei requisiti e rispondere ai commenti di revisione con modifiche al modello.A2Il ruolo Reviewer, Approvazioni (Approva, Rifiuta…, Riapri), commenti
LO4Analizzare la copertura di tracciabilità e di verifica e decidere, per ogni lacuna, se è sbagliato il modello o il requisito.A3A1, A4Matrice 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.A4Diagrammi di Action, la gerarchia degli Asset, l’allocazione, il registro delle interfacce
LO6Valutare tramite il modello l’impatto di una modifica a un requisito e registrare una decisione per ogni elemento coinvolto.A5Collegamenti da rivedere, analisi d’impatto, Richieste di modifica e i relativi elenchi Impatto, baseline
LO7Pianificare verifica e validazione: distinguerle, scegliere i metodi, scrivere criteri di validazione nei termini del cliente e leggere una RVTM.A6A1, A3, A5Casi di test e suite, Centro test, RVTM e VCRM, modelli di documento
LO8Produrre deliverable di ingegneria dal modello e mantenerli coerenti con esso: documenti in baseline e matrici dinamiche esportate per la revisione.A6A2Documenti, matrici dinamiche, baseline, esportazione in Word
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.A6 parte BUn progetto SysML v2, i controlli dell’Editor, i limiti didattici descritti più avanti

A1 · Tracciare un’esigenza

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

Il cliente di EO-1, un’azienda di analisi agricole, ha espresso tre esigenze. N2 Twice-Weekly Revisit richiede immagini aggiornate dei campi dei clienti 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 al successivo.
  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 la Vista elemento di N2 e seguire la sezione Traccia, poi la Matrice di tracciabilità, la 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 tutti i requisiti 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, requisiti non ancora approvati, un requisito senza una funzione che lo soddisfa, validazione non eseguita) e cosa chiude ciascuna.La maggior parte delle lacune, con ciò che le chiude.Elenca le lacune senza dire cosa le chiude.Dice solo che 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 %

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

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 scadenza.
  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 quale funzione manca.
  5. Impostare ciascuno su In Review. Il docente li revisiona come Reviewer, con commenti e Approva o Rifiuta…. Rispondere a ogni commento nel modello: modificare il requisito o aggiungere un commento con la motivazione. Rielaborare un requisito respinto e reimpostarlo su In Review.
  6. Salvare una baseline della System Requirements Specification con il nome «A2 handed in» ed esportarla in Word.

In Holarch: Needs & Requirements → Quality, l’ispettore del requisito, Needs & Requirements → Approvals, Version ▾ → Save Baseline… e Deliver ▾ → Specification (Word) del documento. Senza Holarch: eo-1-v1.1-requirements.csv; consegnare le riscritture come tabella, e il docente simula il giro di revisione via e-mail o in aula.

Da consegnare

L’esportazione Word e 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 e attuabili 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; i requisiti respinti sono rielaborati e ripresentati.Un commento senza risposta.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 %

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. 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 per ogni fallimento.
  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: la Matrice di tracciabilità, la RVTM e Verification → Model Checks. Senza Holarch: eo-1-v1.1-traceability.csv (la colonna Copertura) e eo-1-v1.1-rvtm.csv; descrivere le tre modifiche invece di eseguirle.

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 non tracciati, compresi i test falliti e i relativi problemi.Una o due lacune non individuate.Trovate solo le bozze evidenti.Meno della metà.
Decisioni (35 %)Ogni lacuna ha una decisione sostenibile; il progetto mancante è distinto 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 %

L’architettura logica di EO-1, L0 EO-1 Logical Architecture, copre solo le parti di alimentazione e gestione dati: da L1 Power Generation a L6 Fault Management. 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. Seguire lo schema di L1–L6: aprirne uno nella Vista elemento e osservare la sezione Traccia per vedere quali relazioni usa.
  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: la gerarchia degli Asset, il diagramma di Action di F4, l’Registro delle interfacce e un diagramma di gerarchia con il preset Gerarchia di allocazione. Senza Holarch: eo-1-v1.1-allocation-chain.csv, eo-1-v1.1-icd.csv e eo-1-v1.1-traceability.csv; disegnare il diagramma a mano o con qualsiasi strumento.

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 e 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; un 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 %

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. I collegamenti di 3.1 sono ora elencati in Collegamenti da rivedere.

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 che ne dà il motivo), 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. Salvare una baseline del progetto prima di iniziare. Segnare come revisionati, con commenti, i collegamenti ancora validi. Creare una richiesta di modifica per ciò che il comitato deve decidere (il modello contiene già CR-1 come bozza, quindi la propria sarà CR-2), aggiungere gli elementi coinvolti e preparare le modifiche proposte. Leggere l’elenco Impatto di ogni modifica preparata e confrontarlo con la propria registrazione: cosa elenca che era sfuggito, e cosa è stato trovato che l’elenco non può contenere? Inviare la richiesta in revisione senza applicarla, poi salvare una seconda baseline.

Facoltativo: se il docente attiva Work in change requests nelle Impostazioni delle richieste di modifica del progetto, apportare le modifiche proposte nella richiesta in bozza dalle pagine abituali invece di prepararle una alla volta, e rivederle nella richiesta prima di inviarla.

In Holarch: Needs & Requirements → Links to Review, un’analisi d’impatto da 3.1 (Open in ▾ → Spider, poi Impatto), la sezione Traccia della Vista elemento, la ricerca, le equazioni di potenza e TPM-2, Control & Reviews → Change Requests e Control & Reviews → Baselines & Versions. Senza Holarch: eo-1-v1.1-traceability.csv per l’analisi; eo-1-v1.1-change-impact-3.1.csv è la registrazione d’impatto del modello stesso, quindi svolgere prima la propria analisi e confrontare dopo.

Piani: le richieste di modifica, i relativi elenchi Impact e le registrazioni di approvazione funzionano con ogni piano. Il controllo della configurazione (gli elementi approvati e in baseline cambiano solo tramite una richiesta approvata) è incluso nei piani Individual e Team, e il lavoro all’interno di una richiesta di modifica nel piano Team. Un indirizzo e-mail accademico verificato o l’appartenenza a un’organizzazione di tipo corso attiva includono entrambi. Vedere Controllo della configurazione.

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; l’effetto su 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.Collegamenti segnati come revisionati senza motivi.Nessuna decisione.
Registrazione nel modello (15 %)Commenti, la richiesta di modifica con le modifiche preparate e le due baseline presenti e coerenti con la registrazione; differenze rispetto all’elenco Impact spiegate.Uno mancante.Solo la registrazione scritta.Nulla nel modello.

A6 · Piano di validazione

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

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 contiene VAL-01 Customer Alert Pilot (per N1), VAL-02 Growing Season Revisit Simulation (per N2) e VAL-03 Agronomist Map Review (per N3, superato).

Iniziare il piano con + Nuovo documento nella pagina Documents. In Modelli per, scegliere il modello del corso del docente, se esiste; altrimenti scegliere il modello predefinito Verification and Validation Plan (un Test Plan Document) con Includi indicazioni di scrittura. I numeri di sezione seguenti sono quelli del modello predefinito.

Compito (parte A)

  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 di loro.
  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 sul caso di test.
  5. 8 Verification Status: leggere la RVTM 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. Sostituire le indicazioni di scrittura con i propri contenuti ed esportare il piano in Word.

Parte B: SysML v2 (facoltativa)

Usarla come bonus fino al 10 % oppure da sola in un modulo su SysML v2. Creare un progetto SysML v2 da eo-1-v1.1-power-subsystem.sysml con Manage Projects → Project Files ▾ → Import SysML v2 Files…. Il file contiene ancora 3.1 a 28 W.

  1. 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?
  2. Modificare i valori di progetto, non il requisito, finché il file non ha 0 diagnostiche. Indicare se i nuovi valori sono fisicamente credibili.
  3. In mezza pagina, indicare quali delle proprie affermazioni lo strumento ha controllato e quali si è limitato a conservare. Usare i limiti didattici descritti più avanti.

Senza Holarch: scrivere il piano in Word a partire dai titoli di sezione indicati sopra; ricavare lo stato di verifica da eo-1-v1.1-rvtm.csv.

Da consegnare

L’esportazione Word del piano e, per la parte B, il file .sysml e la mezza pagina.

Rubrica di valutazione

Criterio4 Eccellente3 Competente2 In sviluppo1 Iniziale
Scenario nei termini del cliente (30 %)Concreto e 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 e legati a ciò che N1 richiede.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 il loro effetto.Mancante.
Ragionamento su verifica e validazione (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 %)Un’esportazione Word pulita con le indicazioni di scrittura sostituite dai contenuti.Restano testi di indicazione.Esportato in parte.Mancante.
Parte B: SysML v2 (bonus, fino al 10 %)Il rilievo spiegato; 0 diagnostiche con valori credibili; una dichiarazione precisa di cosa è stato controllato e cosa è stato conservato.0 diagnostiche; la dichiarazione è generica.Il requisito indebolito invece di modificare il progetto, oppure diagnostiche rimaste.Non svolta.

Lavorare senza Holarch

Ogni esercitazione si può svolgere con i soli file di EO-1, quindi possono partecipare anche gli studenti che usano un altro strumento o nessuno. I file CSV sono in UTF-8 con una riga di intestazione e si aprono in qualsiasi foglio di calcolo. Sono viste dello stesso modello, versione 1.1.

EsercitazioneFile
A1 Tracciare un’esigenzatracciabilità, RVTM
A2 Rielaborazione dei requisitirequisiti, tracciabilità
A3 Lacune di coperturatracciabilità (colonna Coverage), RVTM, problemi e azioni
A4 Architetturacatena di allocazione, interfacce, tracciabilità
A5 Gestire la modificatracciabilità; dopo, per il confronto: impatto della modifica per 3.1
A6 Piano di validazioneRVTM, requisiti; parte B: sottosistema di potenza (.sysml)

Tutti i file, con un README e la licenza, sono in eo-1-v1.1.zip. La sezione download di EO-1 descrive ogni file.

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

I progetti SysML v2 di Holarch supportano un sottoinsieme della specifica OMG SysML v2. 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. La pagina Copertura del linguaggio SysML v2 riporta lo stato attuale; consultarla prima di ogni semestre.

Controllato

L’Editor controlla questi aspetti durante la digitazione, e le viste e le pagine li utilizzano. Quando l’Editor mostra 0 diagnostiche, questi controlli sono superati.

  • 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 e specializzazione: tipizzazione, subsetting, ridefinizione e coniugazione; cicli e tipo di definizione errato.
  • Molteplicità, valori e unità: limiti validi, grandezze con le unità ISQ, SI e consuetudinarie statunitensi della libreria standard, e controlli dimensionali (una potenza dove è attesa una massa viene segnalata).
  • Vincoli e calcoli: tipi degli operandi, argomenti dei calcoli e condizioni booleane, e valutazione: vengono segnalati vincoli, requisiti e obiettivi che non sono rispettati con i valori correnti.
  • Struttura: estremità delle connessioni e direzioni di porte, flussi e messaggi.
  • Requisiti, casi d’uso e viste: membri nella posizione corretta, e destinazioni di satisfy, verify, expose e frame.
  • Azioni e stati: successioni, nodi di controllo, transizioni iniziali, regioni parallele, trigger ed effetti. Il Simulator esegue i flussi di azioni, comprese le esecuzioni Monte Carlo, ed esegue le macchine a stati con stimoli.
  • Variabilità, individui e time slice: una variante possiede le feature della sua variazione e una scelta deve essere una delle varianti del suo punto; uno snapshot o un time slice possiede le feature della sua occorrenza.

Controllato, con un limite da indicare

AreaLimite da comunicare agli studenti
Casi di analisiUn 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.
VariabilitàVariazioni, varianti e configurazioni vengono controllate e valutate, ma le pagine di Holarch non elencano ancora tutte le combinazioni valide. Un punto di variazione senza una scelta ha un valore sconosciuto, quindi un’asserzione su di esso non è né soddisfatta né violata.
Metadati ed estensioni del linguaggioLe parole chiave definite dall’utente funzionano tramite metadati semantici. Gli altri metadati definiti dall’utente non hanno significato oltre ai loro valori. La libreria standard è di sola lettura.
KerMLIl KerML della libreria standard viene letto, ma i file .kerml non vengono importati e i modelli scritti in KerML non vengono controllati.
Scambio SysML v2 JSONI tipi di elemento che Holarch non interpreta vengono conservati come importati e riscritti invariati all’esportazione; non hanno testo e non si possono modificare.
Systems Modeling APIAltri strumenti leggono il modello ed eseguono commit nei rami delle richieste di modifica; un approvatore li applica in Holarch. Non ci sono commit su main, tag o merge.

Conservato, non interpretato

Holarch conserva questi elementi esattamente come scritti, nel testo e nelle esportazioni. 0 diagnostiche non dice nulla sulla loro correttezza.

  • Rappresentazioni testuali in altri linguaggi (rep language "Python" e simili): il corpo viene conservato come testo e mai eseguito. I corpi in SysML e KerML vengono controllati.
  • Il testo di un requisito: il testo doc è l’enunciato che il lettore vede; il controllo valuta il require constraint, non le parole. Nel sottosistema di potenza di EO-1, portando il valore richiesto a 30 W il testo doc continua a dire 28 W finché qualcuno non lo modifica. È un buon esercizio.
  • I valori dei metadati definiti dall’utente diversi dai metadati semantici.

Come usarlo in un corso

  • Dire «lo strumento lo ha controllato» solo per le aree controllate. Per esempio, 0 diagnostiche significa che le unità sono coerenti e che il requisito è rispettato con i valori correnti. Non significa che il testo del requisito concordi con il suo vincolo, né che un corpo scritto in un altro linguaggio sia corretto.
  • Valutare i costrutti conservati leggendoli, non in base al numero di diagnostiche.
  • 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».
  • La parte B di A6 si basa su questa sezione: gli studenti vedono la valutazione segnalare il requisito modificato, correggono il progetto e annotano cosa è stato controllato e cosa solo conservato.

Soluzioni

I docenti possono richiedere le note con le soluzioni (rilievi attesi, risposte di esempio ed errori frequenti per A1–A6) tramite l’assistenza: contattateci con l’argomento Instructor, il corso e l’istituto. Le note non sono pubblicate, quindi gli studenti non possono scaricare le risposte.

Licenza e attribuzione

Queste esercitazioni sono distribuite con licenza Creative Commons Attribuzione 4.0 Internazionale (CC BY 4.0). È consentito copiarle, distribuirle e adattarle, a condizione di riconoscerne adeguatamente la paternità, fornire un link alla licenza e indicare se sono state apportate modifiche. Attribuzione: "Class assignments on the EO-1 reference model, Holarch, CC BY 4.0". I file del modello EO-1 mantengono la propria riga di attribuzione.

La licenza copre solo i testi delle esercitazioni. Il software Holarch non è coperto da essa.

Pubblicato da Holarch