Holarch

SysML v2

Metadati di simulazione nei progetti SysML v2

La libreria di metadati HolarchSimulation: come un modello SysML v2 riporta durate, probabilità di diramazione, numeri di iterazioni, risorse, costi e impostazioni delle macchine a stati per il Simulatore, e come scriverli e spostarli.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Valore nominale e distribuzione
    2. Quali impostazioni prevalgono
    3. Due simulatori
  3. Come usarlo
    1. Quando e perché
    2. Impostare una durata, una probabilità o un numero di iterazioni
    3. Scrivere le annotazioni nel testo
    4. Spostare le impostazioni precedenti nel modello
    5. Simulare una macchina a stati
    6. Esempio guidato: la demo Hybrid Car
    7. Suggerimenti e buone pratiche
    8. Errori comuni
    9. Come si collega
  4. Annotazioni
    1. Distribuzioni
    2. Input correlati
    3. Probabilità e conteggi
    4. Risorse e costi
    5. Annotazioni che richiedono il motore SysML
  5. Messaggi
  6. Limiti
  7. Correlati

Panoramica

In un progetto SysML v2 le impostazioni del Simulatore fanno parte del modello. Sono annotazioni di metadati del package di libreria HolarchSimulation, che ogni progetto SysML v2 carica. Un modello che le usa resta SysML v2 valido: gli altri strumenti leggono le annotazioni come normali metadati, e solo il Simulatore dà loro un significato.

Un'annotazione si trova all'interno dell'elemento che annota oppure nomina quell'elemento con about:

succession toCruise first shift if speed > 30 then cruise {
  @HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }

Concetti

Valore nominale e distribuzione

La durata di un passo è il suo attributo duration (o un attributo tipizzato DurationValue o TimeValue). Il suo valore è la durata nominale che vedono gli altri strumenti e la valutazione di Holarch. Un'annotazione di distribuzione su quell'attributo fa invece estrarre la durata al Simulatore:

action cruise {
  attribute duration : ISQ::DurationValue = 1 [min] {
    @HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
  }
}

Quali impostazioni prevalgono

  • Un'annotazione di distribuzione prevale sul valore proprio dell'attributo.
  • Una guardia, una condizione if o una condizione di ciclo che il modello può valutare decide da sola. Una Probability o un LoopCount vengono usati solo quando non può (un LoopCount conta sempre i passaggi).
  • Le impostazioni fatte prima che le impostazioni di simulazione passassero nel modello sono conservate come dati di Holarch accanto al modello. Prevalgono ancora, quindi le esecuzioni danno gli stessi risultati, finché non le si sposta all'interno (vedere Spostare le impostazioni precedenti nel modello).

Due simulatori

La pagina del Simulatore mostra quale simulatore esegue il modello, a destra delle impostazioni: Motore SysML (il simulatore dell'Holarch Language Engine) o Simulatore JavaScript. Entrambi leggono le stesse annotazioni. Le macchine a stati, gli stimoli, le risorse da Resource, Consumes, Produces e Seizes, i costi da Cost e le altre annotazioni elencate in Annotazioni che richiedono il motore SysML vengono eseguite solo con il motore SysML.

Come usarlo

Quando e perché

Scrivere le impostazioni di simulazione nel modello quando il modello è il riferimento del progetto: i numeri viaggiano con i file .sysml, compaiono nelle revisioni del testo e vengono versionati con il resto del modello. Usarle mentre si analizza uno scenario operativo (sequenze temporali, quote delle diramazioni, uso delle risorse) e prima di verificare un requisito rispetto a uno studio Monte Carlo.

Impostare una durata, una probabilità o un numero di iterazioni

  1. Selezionare il passo, la successione, la decisione, il ciclo o l'azione if in una Action Flow View, nel Browser o nell'Editor.
  2. Nella sezione Simulazione dell'ispettore, impostare Durata (un valore fisso o una distribuzione), Probabilità (%), Iterazioni o Probabilità di then (%).
  3. Holarch scrive l'annotazione nel modello: Durata imposta il valore dell'attributo sulla media e aggiunge l'annotazione di distribuzione (oppure scrive attribute duration : ISQ::DurationValue quando il passo non ne ha una); Probabilità (%) scrive Probability; Iterazioni scrive LoopCount. Ogni modifica si può annullare con un solo annullamento e compare subito nel testo.
  4. Svuotare un campo per rimuoverne l'annotazione.

Holarch controlla ogni modifica con il controllo SysML prima di scriverla. Una modifica che aggiungerebbe un errore non viene scritta, e un messaggio indica il problema.

Scrivere le annotazioni nel testo

  1. Aprire l'Editor.
  2. Aggiungere l'annotazione all'interno del corpo dell'elemento, come @HolarchSimulation::Kind { field = value; }, oppure dopo di esso, come metadata HolarchSimulation::Kind about element { … }.
  3. Per Consumes, Produces e Seizes, nominare prima il passo e poi la risorsa: metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.

Spostare le impostazioni precedenti nel modello

I progetti le cui impostazioni di simulazione sono state fatte prima che passassero nel modello mostrano Alcune impostazioni di simulazione di questo progetto sono dati di Holarch, non parte del modello. sopra le impostazioni del Simulatore.

  1. Fare clic su Sposta impostazioni di simulazione nel modello….
  2. L'anteprima elenca ogni impostazione e l'annotazione che la sostituisce.
  3. Fare clic su Sposta nel modello. Tutte le impostazioni vengono spostate, e un solo annullamento revoca tutto; le esecuzioni danno gli stessi risultati.

Simulare una macchina a stati

Le macchine a stati vengono eseguite con il motore SysML.

  1. Aprire Comportamento → Simulatore e scegliere come Radice una definizione di stato, oppure una parte che esibisce stati.
  2. Facoltativo: in Esegui insieme a, scegliere un'azione di scenario che invia segnali alla parte, come TestDrive della demo.
  3. In Stimoli, fare clic su + Aggiungi stimolo e impostare A (tempo e unità), Segnale e A (una macchina, oppure Ogni macchina che lo accetta).
  4. Premere ▶ Riproduci, ⏭ Passo o ⏩ Esegui fino alla fine. Macchina a stati durante l'esecuzione illumina gli stati attivi e contrassegna la transizione scattata; la scheda Stati mostra Stati nel tempo e Transizioni scattate.
  5. In Monte Carlo, la scheda Stati mostra Tempo nello stato e Conteggi delle transizioni. Verifica rispetto a un requisito… offre come output il tempo nello stato di ogni stato e la sua quota dell'esecuzione.

In una Vista di transizione di stato, ▶ Simula apre una barra con ▶ Riproduci, ⏭ Passo, ⏩ Esegui fino alla fine, Reimposta e Apri nel simulatore. L'esecuzione usa gli stimoli salvati nel Simulatore per quella definizione di stato.

Esempio guidato: la demo Hybrid Car

La demo Hybrid Car (Gestisci progetti → File di progetto ▾ → Nuovo progetto demo) usa la libreria:

  • DriveCycle: la successione toCruise dopo shift ha Probability 70; il ramo else prende il restante 30 %. cruise dura nominalmente 1 min, estratto da una distribuzione Triangular (45 s, 1 min, 2 min).
  • DrivenCar: la batteria del gruppo propulsore è una Resource di 62 Wh; drive ne Consumes 1,5 Wh e ha un Cost di 0,4 USD per uso.
  • PowertrainStates: la transizione startElectric ha Probability 80 per la sua guardia; accept when charge < 15 passa a hybrid quando la carica scende; accept after 30 [min] termina la ricarica.
  • TestDrive: uno scenario che invia StartRequest, attende un'ora, poi invia StopRequest e PlugIn a demoCar. Eseguire Demo Car insieme a Test Drive per vedere il gruppo propulsore cambiare stato.

La demo si controlla con 0 diagnostiche.

Suggerimenti e buone pratiche

  • Mantenere significativo il valore nominale: impostarlo sul valore atteso della distribuzione, come fa l'ispettore.
  • Dare un nome alle successioni annotate (succession toCruise first …), così l'annotazione è facile da trovare nel testo.
  • Preferire condizioni che il modello può valutare alle probabilità; usare Probability per ciò che il modello non descrive.

Errori comuni

  • Una probabilità non ha effetto: la guardia può essere valutata, quindi decide lei. L'ispettore riporta “Vale true: sempre preso.” o “Vale false: mai preso.”
  • Le probabilità dei rami non sommano al 100 %: i rami senza una Probability si dividono ciò che resta; quando quelle indicate superano il 100 %, l'avviso riporta “Branch probabilities add up to N %. Change them to total 100 %.”
  • Un'annotazione di durata sul passo stesso: le distribuzioni vanno sull'attributo di durata, non sull'azione.

Come si collega

Annotazioni

Distribuzioni

Mettere una distribuzione su un attributo di durata. I campi di posizione e di scala accettano una grandezza con un'unità (45 [s], 2 [min]); i campi di forma accettano un numero.

AnnotazioneCampiSignificato
Normalemean, sdDistribuzione normale.
Triangolarelow, mode, highTriangolare, con low ≤ mode ≤ high.
Uniformelow, highUniforme tra low e high.
ExponentialmeanEsponenziale con la media indicata.
Gammashape, scaleGamma; la media è shape × scale.
LogNormalmedian, sigmaIl logaritmo è normale intorno al logaritmo della mediana.
Weibullscale, shapeWeibull.
Betaalpha, beta, scaleBeta su 0..1, moltiplicata per scale.
Poissonmean, scaleUn conteggio con la media indicata, moltiplicato per scale.
Binomialtrials, p, scaleSuccessi in un numero di prove, moltiplicati per scale.

Le durate estratte sotto zero vengono estratte di nuovo.

Input correlati

Senza una correlazione, ogni valore estratto da una distribuzione è indipendente dagli altri. Correlation fa muovere due valori insieme:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
AnnotazioneSuSignificato
Correlation coefficientabout a, b: due attributi, ciascuno con una distribuzioneLa correlazione di rango (Spearman) dei loro valori, da -1 a 1. 0 indica indipendenza, 1 li ordina sempre allo stesso modo, -1 in modo opposto.
  • Ogni attributo mantiene la propria distribuzione. Il simulatore unisce tutte le coppie in un'unica matrice di correlazione (una copula gaussiana): l'n-esimo valore estratto per un attributo in un'esecuzione va con l'n-esimo valore di ogni attributo con cui è correlato.
  • I coefficienti di un gruppo di attributi correlati devono essere compatibili: a fortemente con b, b fortemente con c, ma a opposto a c è impossibile. Il controllo segnala un gruppo del genere; indebolire uno dei coefficienti.
  • Durate e quantità (Consumes, Produces, Seizes) si correlano allo stesso modo. Un'esecuzione con lo stesso seed dà gli stessi valori.
  • Nel Simulatore, in modalità Monte Carlo con il motore SysML, Input correlati elenca le coppie della radice. Scegliere due attributi e un coefficiente e fare clic su + Aggiungi correlazione, cambiare un coefficiente, oppure fare clic su × per rimuoverne una; un solo annullamento revoca ogni modifica. Dopo uno studio, Raggiunto mostra la correlazione di rango dei valori estratti dalle esecuzioni.
  • ChargeStop della demo Hybrid Car correla l'attesa di un caricatore libero con il tempo di ricarica (0,6).

Probabilità e conteggi

AnnotazioneSuSignificato
Probability percentUna successione in uscita da una decisioneIl peso del ramo. I rami che non ne hanno uno si dividono ciò che resta di 100.
Un'azione ifLa probabilità del ramo then quando la condizione non può essere valutata.
Un'azione di cicloLa probabilità di ripetere dopo ogni passaggio.
Una transizioneLa probabilità che la sua guardia sia soddisfatta quando la guardia non può essere valutata.
LoopCount countUn'azione di cicloIl numero di passaggi; ha la precedenza sulle condizioni del ciclo.
LoopExitUna successione verso done nel corpo di un cicloTermina l'intero ciclo, non solo il passaggio.

Risorse e costi

AnnotazioneSuSignificato
Resource initial, minimum, maximum, unitUn uso di parte o di itemUna riserva di una quantità. Se l'uso dichiara attribute level : Real, il simulatore lo mantiene uguale alla quantità, così le guardie possono leggerlo.
Consumes amountabout step, poolPrelevata all'inizio del passo.
Produces amountabout step, poolAggiunta alla fine del passo.
Seizes amountabout step, poolPrelevata all'inizio del passo e restituita alla fine.
Utilization amountUn uso di azione performQuanto della parte esecutrice occupa il passo.
Cost amount, rate, unit, labelUn passo o una parte esecutriceUn costo per uso (CostRate::perUse) o per ora (CostRate::perHour).

Annotazioni che richiedono il motore SysML

AnnotazioneSignificato
Transfer latency, capacity, perSu una connessione o un'interfaccia: ritarda gli item e i segnali inviati attraverso di essa.
Size sizeSu un item: la sua dimensione per i ritardi di trasferimento.
Timeout limitSu un join: interrompe i rami non completati quando il limite scade.
NotBefore timeSu un passo: non inizia prima di questo tempo di esecuzione.
ForkTargets, JoinSourcesSu una transizione in ingresso o in uscita da uno stato parallelo: i sottostati in cui si entra, o i sottostati che devono essere attivi.
History deepSu uno stato composito: rientrando si riprende il sottostato attivo al momento dell'uscita.
HostHook key, pointsRiservato a Holarch: l'esecuzione si mette in pausa per un input nei punti elencati.

Il simulatore JavaScript legge Probability, LoopCount e le distribuzioni.

Messaggi

MessaggioSignificato
Alcune impostazioni di simulazione di questo progetto sono dati di Holarch, non parte del modello.Le impostazioni precedenti sono ancora memorizzate accanto al modello. Fare clic su Sposta impostazioni di simulazione nel modello….
Dati di Holarch di prima che le impostazioni di simulazione passassero nel modello; prevalgono sul modello.Mostrato nella sezione Simulazione dell'ispettore. Modificare il campo per scriverlo nel modello, oppure spostare tutte le impostazioni dal Simulatore.
Nessuna durata nel modello. Impostarne una qui (scrive attribute duration : ISQ::DurationValue), oppure scriverla nel testo.Il passo non ha un attributo di durata.
@Normal: sd must be greater than zero. Change sd. (e messaggi simili per altre distribuzioni e parametri)Un parametro di distribuzione manca o è fuori intervallo. Con il motore SysML, il controllo del modello lo segnala nell'Editor e il Simulatore si rifiuta di eseguire finché non viene corretto.
@Normal: sd has another unit dimension than …Un parametro di posizione o di scala ha unità diverse da quelle dell'attributo, per esempio metri su una durata.
@LoopCount does not apply to a part …L'annotazione si trova su un tipo di elemento a cui non si applica. Spostarla o eliminarla.
metadata Consumes … about needs an action and a part or item annotated @Resource.Gli elementi dopo about sono errati per numero o tipo.
A probability of N % is outside 0 to 100.Inserire una percentuale da 0 a 100.
The branch probabilities of this decision add up to N %; the simulator scales them to 100 %.Un avviso: ogni ramo ha un peso e i pesi non sommano a 100.
A correlation needs two different attributes …, … is not an attribute … o … has no distribution, so nothing is drawn to correlate …Una Correlation nomina due volte lo stesso attributo, qualcosa che non è un attributo, oppure un attributo senza distribuzione.
The coefficient N is outside -1 to 1. o The correlation has no coefficient.Inserire un coefficiente da -1 a 1.
“a” and “b” are already correlated; the first correlation is used. …Un avviso: una seconda Correlation della stessa coppia viene ignorata. Rimuovere una delle due.
The correlations of … contradict each other: no joint distribution has them …I coefficienti di un gruppo non possono stare insieme (la matrice non è semidefinita positiva). Indebolirne uno. Il Simulatore si rifiuta di eseguire finché non viene corretto.
Deadlock at <time>: N steps wait for something that never comes.Mostrato sopra i risultati con il motore SysML, con ogni passo in attesa. Un accept senza mittente, un item mai prodotto o una risorsa mai rilasciata interrompono l'esecuzione.

Limiti

  • Le durate si scrivono in secondi, minuti, ore o giorni (SI::s, SI::min, SI::h, SI::d). I millisecondi si scrivono come secondi; settimane, mesi e anni come giorni.
  • Macchine a stati, stimoli ed Esegui insieme a richiedono il motore SysML.
  • Gli input correlati richiedono il motore SysML; il simulatore JavaScript estrae ogni valore in modo indipendente. In un gruppo si possono correlare al massimo 200 attributi.
  • Il controllo dei coefficienti contraddittori copre le correlazioni scritte in un unico namespace; il Simulatore controlla tutte le correlazioni dell'esecuzione.

SysML® e OMG® sono marchi registrati di Object Management Group, Inc. negli Stati Uniti e in altri paesi.