Holarch

Comportamento

Simulazione

Eseguire un flusso di Action come simulazione a eventi discreti o come studio Monte Carlo, leggere i risultati di tempo, costo, risorse e utilizzo, scrivere script per le decisioni e registrare un risultato di verifica rispetto a un requisito.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Che cosa legge il Simulatore
  3. Come usarlo
    1. Quando e perché
    2. Eseguire una simulazione a eventi discreti
    3. Eseguire uno studio Monte Carlo
    4. Verificare un requisito e registrarne il risultato
    5. Esecuzioni salvate
    6. Esempio pratico: il passaggio di acquisizione immagini di CubeSat EO-1
    7. Suggerimenti e buone pratiche
    8. Errori comuni
    9. Come si collega
  4. Regole di simulazione
    1. Durate e distribuzioni
    2. Costrutti di controllo
    3. Resource
    4. Asset e utilizzo
    5. Costi
    6. Numeri casuali e seed
  5. La pagina Simulatore
    1. Intestazione della pagina e barra di esecuzione
    2. Impostazioni
    3. Controlli degli eventi discreti
    4. Controlli Monte Carlo
    5. Note sopra i pannelli
  6. Pannelli
    1. Menu del pannello
    2. Schede degli eventi discreti
    3. Schede Monte Carlo
  7. Script
    1. Hook
    2. Costruttore di prompt
    3. Disponibili negli script
    4. Esempio: decidere un ramo dalla carica della batteria
    5. Sandbox e attendibilità
  8. Tastiera e mouse
  9. Messaggi
  10. Limiti
  11. Correlati

Panoramica

Il Simulatore esegue il flusso di una Action nel tempo simulato, esattamente come lo disegna il suo Diagramma di Action. Ha due modalità:

  • Eventi discreti: un'esecuzione temporizzata che si può osservare, avanzare passo per passo e in cui si rispondono alle decisioni. Mostra quali azioni vengono eseguite e quando, che cosa attendono, come salgono e scendono le risorse, quali asset sono occupati e quanto costa l'esecuzione.
  • Monte Carlo: molte esecuzioni indipendenti con durate e decisioni campionate. Mostra la dispersione del tempo e del costo totali, i percentili, una curva di probabilità cumulativa, i percorsi decisionali seguiti e la probabilità di rispettare una soglia.

Il Simulatore legge il modello e non lo modifica mai durante l'esecuzione. Scrive nel progetto in tre modi: le impostazioni di una Action radice (salvate man mano che si cambiano), un record di esecuzione per ogni esecuzione terminata, e Registra risultato….

Concetti

Che cosa legge il Simulatore

Il Simulatore prende dal modello tutto ciò di cui ha bisogno. Configurare questi elementi nel Diagramma di Action e negli attributi delle entità prima di eseguire.

Elemento del modelloDa dove provieneChe cosa ne fa la simulazione
FlussoIl Diagramma di Action della Action radice: sequenza, Parallelo, SYNC, OR, LOOP ed EXITEsegue gli elementi in ordine. I rami vengono eseguiti in parallelo, o ne viene scelto uno.
DurataL'attributo Duration di ogni Action (un numero o una distribuzione, con un'unità)Il tempo che l'azione richiede. Un'azione scomposta dura quanto il suo flusso figlio.
ScomposizioneAction figlie con un proprio flussoEsegue il flusso figlio al posto della durata propria del padre
TriggerGli Input/Output che un'azione receives (attributo di relazione Trigger, attivo a meno che non sia impostato a false)L'azione attende finché ogni I/O di trigger non è stato generato
Generazione di I/OGli Input/Output che un'azione generatesResi disponibili quando l'azione termina, dopo l'eventuale ritardo del Conduit
Ritardo del ConduitIl Conduit che transfers l'I/O: Latency più Size ÷ CapacityRitarda la consegna dell'I/O
ResourceRelazioni consumes, seizes e produces verso le Resource, con un Amount (predefinito 1)Consumate e trattenute all'inizio. Le quantità trattenute vengono rilasciate alla fine. Prodotte alla fine.
Capacità dell'Assetperformed by con un Amount, e la Multiplicity dell'asset sotto il suo padreL'azione attende finché l'asset non ha capacità libera
Tempo di occupazione dell'AssetOgni Asset che esegue un'azione (performed by)Grafici di occupazione (%) e di utilizzo
CostiEntità Cost incurred by una Action o un Asset esecutoreAggiunti al costo totale progressivo
CalendarL'attributo Start della radice e di ogni ActionUsato solo in Date di calendario
ScriptLo script di simulazione dell'azione o del costruttoHook che impostano le durate, decidono i rami, pongono domande e tengono traccia dei valori

I tempi sono memorizzati in secondi e mostrati nell'unità più leggibile (ms, sec, min, hr, days, months o years).

Le regole dettagliate per durate, decisioni, risorse, asset, costi e seed si trovano in Regole di simulazione sotto.

Come usarlo

Quando e perché

Simulare quando il flusso funzionale esiste e le sue azioni hanno durate, esecutori e risorse. Di solito è dopo l'analisi funzionale, durante l'allocazione e i trade-off di architettura.

Una simulazione risponde a:

  • Quanto dura l'operazione, e quanto varia il tempo?
  • Quali azioni sono sul percorso critico? Dove attendono dati, risorse o capacità degli asset?
  • Le risorse come la carica della batteria o l'archiviazione dati restano entro i limiti?
  • Quali asset sono sovraccarichi?
  • Qual è la probabilità che un requisito prestazionale (tempo, costo, un livello di risorsa) sia soddisfatto? Questo diventa un risultato di verifica per analisi collegato al requisito.

Eseguire una simulazione a eventi discreti

  1. Aprire il Diagramma di Action dell'operazione.
  2. Scegliere ▶ Simula ▾ → Eventi discreti.

    Il Simulatore si apre con quella Action come Action radice.

    Altri modi di accesso: Comportamento → Simulatore nella barra di navigazione (si apre su una Action le cui impostazioni del Simulatore sono salvate, altrimenti sulla prima Action con un flusso; scegliere un'altra Action radice se necessario), oppure Apri in ▾ → Simulatore di una Action. Scegliendo un'altra Action radice con il mouse si apre subito; da tastiera, sceglierla e premere Enter (o fare clic su Apri).

  3. Controllare le impostazioni: fare clic su Impostazioni nella barra in alto (il suo suggerimento elenca quelle correnti). Le impostazioni principali sono Decisioni, Velocità, Varia le durate fisse con ± %, Seed casuale e Date di calendario (vedere Impostazioni).
  4. Premere ▶ Riproduci.

    L'orologio avanza e Azioni nel tempo (scheda Timeline) cresce. Diagramma di Action durante l'esecuzione colora ogni azione di verde mentre è in esecuzione, di arancione mentre attende e di grigio quando è terminata.

  5. Premere ⏸ Pausa per fermarsi ed esaminare.
  6. Premere ⏭ Passo per avanzare all'evento successivo, o ⏩ Esegui fino alla fine per terminare senza animazione.
  7. Quando compare una finestra intitolata Input per …, scegliere il percorso o inserire il valore.
  8. Fare clic su OK.

    L'esecuzione prosegue come prima: in riproduzione, passo per passo o fino alla fine.

  9. Leggere i risultati al termine dell'esecuzione:
    • Stato: 100% completato, Deadlock o Interrotta. Dopo un deadlock indica quando l'esecuzione si è fermata e che cosa attende ogni azione in attesa, per esempio Interrotta a 0 ms: F1 Separate and Detumble attende ADCS Sensor Data, che nessuna azione precedente produce. Fare clic sul nome di un'azione per esaminarla;
    • Tempo totale e Costo totale;
    • i pannelli delle risorse e dell'utilizzo;
    • la Console, per gli avvisi.
  10. Fare clic su qualsiasi barra o elemento di grafico per i dettagli.

    L'entità si apre nell'ispettore, con quante volte e per quanto tempo è stata eseguita in questa esecuzione. Apri in ▾ → Vista elemento ne apre la pagina.

  11. Premere ⟲ Reimposta per cancellare l'esecuzione e ricominciare.

Eseguire uno studio Monte Carlo

  1. Passare l'intestazione a Monte Carlo. Dal Diagramma di Action, scegliere invece ▶ Simula ▾ → Monte Carlo.
  2. Impostare Esecuzioni (da 1 a 20.000; predefinito 100).
  3. Impostare Varia le durate fisse se si desidera dispersione sulle durate fisse.
  4. Inserire un Seed casuale se lo studio deve essere ripetibile.
  5. Premere ▶ Esegui Monte Carlo.

    Se alcuni OR o LOOP non hanno probabilità o conteggio, la finestra Decisioni non specificate li elenca.

  6. In quella finestra, fare clic su Usa probabilità uguali per continuare. Oppure fare clic su Annulla e impostarli nel Diagramma di Action.

    Compaiono una barra di avanzamento e il testo progressivo k / n · mean … · mean cost …. Fare clic su Annulla per fermare; il messaggio riporta “Esecuzione Monte Carlo interrotta”.

    Al termine dello studio, il testo mostra il numero di simulazioni e il tempo trascorso.

  7. Leggere Esecuzioni completate, poi la scheda Distribuzione (Statistiche, Distribuzione delle durate, Probabilità cumulativa (curva S)) e Combinazioni di rami nella scheda Fattori.

    Se alcune esecuzioni sono andate in deadlock o non sono riuscite, un riquadro rosso indica il conteggio e P(fallimento) con il suo intervallo di confidenza al 95%.

  8. Per vedere perché un'esecuzione non è riuscita, aprire Esecuzioni non riuscite e fare clic su Visualizza esecuzione.

    L'esecuzione viene riprodotta in modalità Eventi discreti con il proprio seed.

  9. Fare clic su Torna ai risultati Monte Carlo per tornare.

Verificare un requisito e registrarne il risultato

Usarlo dopo uno studio Monte Carlo per trasformare i risultati in un risultato di verifica.

  1. Fare clic su Verifica rispetto a un requisito….
  2. Scegliere l'Output: Tempo totale, Costo totale, la quantità minima o finale di ogni Resource, o una variabile globale numerica dello script (Globale: …).
  3. Impostare la soglia in uno dei due modi:
    • Da una Measure: scegliere una Measure e un Usa (Soglia o Obiettivo). I campi vengono compilati dalla Measure (vedere sotto).
    • A mano: impostare Criterio (≤ al massimo o ≥ almeno), Valore e Unità, e scegliere il Requisito.
  4. Impostare Probabilità richiesta (%) (predefinita 90).

    Compare la tabella dei risultati:

    • Criterio ed Esecuzioni;
    • Media (IC 95%) e P5 / P50 / P95;
    • P(conforme), con il suo intervallo di confidenza al 95%;
    • Margine (media rispetto alla soglia);
    • Risultato: Superato o Fallito.
  5. Fare clic su Registra risultato….

    L'anteprima Registra risultato elenca le modifiche che apporterà:

    • Il Projected Value (o Value) della Measure viene impostato sulla media.
    • Un Test Case verifica il requisito. È uno nuovo chiamato “Simulation check: <output> <criterio>”, o uno esistente a scelta. Il suo Status diventa Passed o Failed, e il suo Actual Result viene impostato sul testo del risultato.
  6. Deselezionare le righe da saltare.
  7. Fare clic su Applica.

    Un solo Annulla riporta tutto indietro.

Quando si sceglie una Measure al passo 3, questa compila i campi come segue:

  • Il suo valore compila Valore e Unità.
  • La sua Improvement Direction sceglie il criterio: Negative dà ≤, Positive dà ≥.
  • Il Requirement che specifies compila Requisito.

Esecuzioni salvate

Ogni esecuzione terminata viene salvata automaticamente; non c'è un passaggio di salvataggio.

  • Un'esecuzione a eventi discreti viene salvata quando termina (completata, in deadlock o interrotta). Uno studio Monte Carlo viene salvato quando tutte le sue esecuzioni sono terminate; uno studio annullato non viene salvato.
  • Il record è un Artifact con l'etichetta Simulation Run, con un file .sim. Il suo nome è “<radice> run <data> seed <n>”, per esempio “Perform Delivery Mission run 2026-10-14 09.30 seed 48213”, o “<radice> Monte Carlo <data> seed <n>” per uno studio. La sua descrizione riassume il risultato.
  • Un'esecuzione senza Seed casuale ne riceve uno, così il nome indica come ripeterla: inserire quel seed ed eseguire di nuovo.
  • Il messaggio “Salvato come <nome>.” rimanda al record.
  • Le riproduzioni di un'esecuzione Monte Carlo e i record aperti non vengono salvati di nuovo. I lettori non possono salvare record.
  • Eliminare i record non necessari nel Database (filtrare per l'etichetta Simulation Run).

I progetti meno recenti usano il nome di etichetta Simulation Output; diventa Simulation Run all'apertura del progetto, e le importazioni accettano entrambi i nomi.

Per riaprire i risultati salvati:

  1. Aprire Risultati salvati ▾ nell'intestazione della pagina.
  2. Scegliere il risultato.

    Un banner riporta “Visualizzazione dei risultati salvati: …”. Il suo link Esegui di nuovo sul modello corrente esegue il modello corrente nella stessa modalità.

Esempio pratico: il passaggio di acquisizione immagini di CubeSat EO-1

Il progetto demo contiene l'operazione OPS Run Nominal Imaging Pass. Contiene anche il requisito 6.5 Planning Cycle Time: “The mission shall complete each planning cycle, from target list uplink to product delivery, within 100 minutes.” Creare la demo con Gestisci progetti → File di progetto ▾ → Nuovo progetto demo.

Il flusso di OPS:

  1. Tre passi in sequenza:
    • OPS.1 Transmit Imaging Plan (triangolare da 4 a 9 minuti, picco 6; Ground Station);
    • OPS.2 Receive Imaging Plan (1 minuto);
    • OPS.3 Load Command Schedule (2 minuti).
  2. Un Parallelo: OPS.4 Rotate to Target (normale, 3 ± 0,5 minuti) e OPS.5 Prepare Camera (5 minuti). Entrambe sono attivate dall'I/O Command Schedule generato da OPS.3.
  3. Un LOOP Each target, 4 iterazioni: OPS.6 Capture Image Strip (normale, 40 ± 6 secondi), poi OPS.7 Encode and Store Image (uniforme da 20 a 40 secondi).
  4. Un OR Contact in view?:
    • Yes (75%) esegue OPS.8 Transmit Image Data (normale, 8 ± 1,5 minuti);
    • No (25%) esegue OPS.9 Hold Data Onboard.
  5. Un Parallelo: OPS.10 Recharge Battery in Sunlight (35 minuti) su un ramo. Sull'altro, OPS.11 Receive Downlink (9 minuti) seguita da OPS.12 Process Image Products (normale, 45 ± 10 minuti).

Le risorse:

  • Battery Charge (62 Wh iniziali, 23 minimo, 77 massimo). Da OPS.4 a OPS.8 la consumano. OPS.10 la produce (+30 Wh).
  • Data Storage (1,5 GB iniziali). Guadagna 2,5 GB per ogni OPS.7 e perde 8 GB in OPS.8.

La demo ha impostazioni salvate per OPS: seed 42, e 200 iterazioni Monte Carlo con variazione uniforme di ±10% sulle durate fisse.

Eseguirla:

  1. Aprire Comportamento → Simulatore.
  2. Scegliere OPS Run Nominal Imaging Pass come Action radice e mantenere Eventi discreti.
  3. Premere ⏩ Esegui fino alla fine.

    Si vede:

    • Azioni nel tempo mostra OPS.4 e OPS.5 affiancate, e quattro iterazioni numerate di OPS.6 e OPS.7 (#2, #3, #4).
    • Il lungo ramo OPS.11 → OPS.12 determina l'ora di fine.
    • Nella scheda Resource, Livelli delle Resource nel tempo mostra Battery Charge che scende a gradini durante l'acquisizione delle immagini e si riprende durante OPS.10.
    • Costo totale riporta “Nessun costo”, perché la demo non ha entità Cost.
  4. Passare a Monte Carlo.
  5. Premere ▶ Esegui Monte Carlo (200 esecuzioni).

    Combinazioni di rami (scheda Fattori) mostra circa tre quarti delle esecuzioni su Yes.

  6. Fare clic su Verifica rispetto a un requisito… e mantenere Tempo totale.
  7. Scegliere la Measure MOE-7 Planning Cycle Time e Usa Soglia.

    Il valore diventa 100, le unità Minutes, il criterio ≤ e il requisito 6.5 Planning Cycle Time.

  8. Mantenere 90% e leggere P(conforme) e il verdetto.
  9. Fare clic su Registra risultato…, poi su Applica.

    Il Projected Value di MOE-7 riceve la media. Un Test Case che verifica 6.5 riceve lo Status Passed o Failed. La RVTM elenca ora quel Test Case rispetto a 6.5.

Suggerimenti e buone pratiche

  • Assegnare una Duration a ogni azione foglia. Un'azione senza Duration non richiede tempo e scompare sull'asse temporale.
  • Usare distribuzioni per le durate incerte. Usare Varia le durate fisse solo come rapido controllo di sensibilità.
  • Prima del Monte Carlo, impostare le probabilità su ogni OR e le iterazioni su ogni LOOP. Altrimenti ogni esecuzione sceglie a caso, e i risultati lo segnalano.
  • Impostare un Seed casuale prima di registrare un risultato di verifica, così il risultato può essere riprodotto. Il seed è incluso nel testo registrato.
  • Eseguire abbastanza iterazioni. Quando la probabilità richiesta cade all'interno dell'intervallo di confidenza, la verifica dice “Eseguire più iterazioni per un verdetto più solido.”
  • Le impostazioni vengono salvate con la Action radice man mano che si cambiano, così viaggiano con il progetto.

Errori comuni

SintomoCausaCorrezione
Stato mostra Deadlock; la Console dice “waiting for I/O … (never generated)”Un'azione riceve come trigger un I/O che nulla genera sul percorso seguito (per esempio dopo un OR)Generare l'I/O su ogni percorso, o impostare Trigger a false sulla relazione receives
Deadlock “waiting for … (never available)”Una Resource non torna mai sopra la quantità di cui un'azione ha bisogno, o la capacità di un asset è inferiore all'Amount di un'azioneAumentare l'Initial Amount, aggiungere un'azione che produce, o controllare gli Amount e la Multiplicity
Ogni esecuzione ha lo stesso tempo totaleTutte le durate sono fisse e la variazione è NessunaUsare distribuzioni, o impostare Varia le durate fisse
“Simulazione interrotta: troppi passi (controllare i conteggi dei LOOP o una scomposizione ricorsiva).”Un LOOP viene eseguito troppe volte, o un'azione si trova all'interno della propria scomposizioneRidurre il conteggio del LOOP o correggere la scomposizione
La Console mostra “Script error in …”Uno script ha generato un'eccezioneAprire lo script dell'azione (Modifica script… nell'ispettore del Diagramma di Action) e correggere la riga indicata
Asset Utilization è vuotoNessuna azione è performed by un AssetMettere in relazione le azioni con i loro Asset esecutori

Come si collega

  • Alimentato da: il flusso del Diagramma di Action, e gli attributi e le relazioni delle sue azioni, I/O, risorse, conduit, asset e costi. Il flusso costruito nell'Analisi funzionale è lo stesso flusso.
  • Alimenta:
    • Measure (Projected Value o Value);
    • Test Case che verificano requisiti, e quindi la RVTM e il Centro test;
    • Artifact con risultati salvati;
    • Pianificazioni MS Project XML e report CSV.

Regole di simulazione

Questa sezione spiega esattamente come il Simulatore tratta durate, decisioni, risorse, asset, costi e numeri casuali.

Durate e distribuzioni

  • Una Duration è un valore e un'unità: Milliseconds, Seconds, Minutes, Hours, Days, Weeks, Months o Years. Un valore senza unità viene letto in ore.
  • Il valore è un numero fisso o una distribuzione, come =norm.dist(40, 6) o =triang.dist(4, 9, 6).
  • Le distribuzioni vengono campionate a ogni esecuzione.
  • Le durate negative campionate vengono estratte di nuovo. Una distribuzione normale si comporta quindi come se fosse troncata a 0.
  • Sono disponibili dieci distribuzioni: beta, binomiale, esponenziale, gamma, log-normale, normale, Poisson, triangolare, uniforme e Weibull. Vedere Tipi di attributo e distribuzioni.
  • Una Duration di =script() chiama l'hook duration() dell'azione a ogni esecuzione. Digitare =script() nel valore di Duration; l'hook restituisce la durata nell'unità della Duration (nessun numero conta come 0).

Varia le durate fisse è un'impostazione che aggiunge dispersione solo ai numeri fissi. Le distribuzioni non vengono mai variate ulteriormente.

  • Uniforme ±% campiona in modo uniforme entro ± la percentuale.
  • Triangolare ±% campiona un triangolo con il picco sul valore fisso.

Costrutti di controllo

CostruttoComportamento in simulazione
Parallelo (senza entità)Avvia tutti i rami insieme. Prosegue quando tutti i rami terminano.
SYNCCome Parallelo. La sua Duration è un timeout. Alla scadenza, i rami non terminati vengono arrestati (le loro barre Gantt diventano rosse, “stopped by SYNC timed out”) e il flusso prosegue.
ORPrende esattamente un ramo, scelto in base al Tipo di decisione (sotto)
LOOPVerifica il suo Ripeti finché prima di ogni passaggio, ed esegue di nuovo il corpo finché vale
EXITTermina il LOOP che lo contiene. Al livello superiore termina il flusso.

Tipi di decisione dell'OR:

  • Probabilità: ogni ramo ha una probabilità (%). I rami lasciati vuoti si dividono in parti uguali ciò che resta del 100%. Se ogni probabilità è 0, ogni ramo è ugualmente probabile.
  • Quantità di risorsa: ogni ramo confronta la quantità corrente della Resource scelta (==, !=, >, <, >=, <=). Viene preso il primo ramo la cui condizione vale, altrimenti il ramo contrassegnato else.
  • Script: l'onEnd() del costrutto restituisce il nome del ramo da prendere (o il suo indice). Un nome sconosciuto registra un avviso, e viene preso un ramo a caso.
  • Nessuno (chiedere durante l'esecuzione, o casuale): con Decisioni impostato su Chiedi (in assenza di script), una finestra chiede quale percorso prendere. Altrimenti viene scelto un ramo a caso.

Condizioni di continuazione del LOOP:

  • Iterazioni: un numero fisso di passaggi (almeno 1).
  • Probabilità: prima di ogni passaggio, continuare con questa probabilità (%).
  • Quantità di risorsa: continuare finché la quantità della Resource soddisfa il confronto.
  • Script: onEnd() viene chiamato prima di ogni passaggio. true esegue di nuovo il corpo, false si ferma, e un numero imposta quanti altri passaggi eseguire.
  • Nessuno (chiedere durante l'esecuzione, o casuale): in modalità prompt, una finestra chiede Quante iterazioni? (predefinito 3). Altrimenti esegue 0, 1 o 2 passaggi a caso.

Resource

Una Resource ha Initial Amount, Minimum Amount, Maximum Amount e Units. La quantità iniziale viene limitata tra il minimo e il massimo.

  • consumes: la quantità viene prelevata quando l'azione inizia e non viene restituita.
  • seizes: la quantità viene prelevata quando l'azione inizia e rilasciata quando termina.
  • produces: la quantità viene aggiunta quando l'azione termina. Le quantità oltre il massimo vengono limitate.

Un'azione attende quando le serve più di quanto è disponibile. “Non disponibile” significa che la quantità scenderebbe sotto il Minimum Amount, o sotto 0 quando non è impostato un minimo. L'azione attende finché altre azioni non rilasciano o producono abbastanza. La sua barra Gantt mostra un'attesa tratteggiata viola.

Asset e utilizzo

  • Ogni Asset che esegue un'azione (performed by) è occupato mentre l'azione è in esecuzione.
  • Occupazione (%) è la quota del tempo simulato in cui almeno una delle sue azioni era in esecuzione.

Per modellare la capacità, impostare un Amount sulla relazione performed by.

  • La capacità dell'asset è il limite superiore della Multiplicity sulla relazione decomposed by del suo padre. Per esempio, 0..2 dà 2.
  • Un'azione attende finché l'asset non ha capacità libera (attesa tratteggiata arancione).
  • Senza Multiplicity, la capacità è illimitata.

Costi

  • Un'entità Cost ha Amount, Rate e Units.
  • Con Rate Per Hour, la quantità viene moltiplicata per la durata dell'azione in ore. Altrimenti viene addebitata una volta, quando l'azione termina.
  • Un Cost incurred by un Asset esecutore viene addebitato per ogni azione che l'Asset esegue. Viene moltiplicato per l'Amount di performed by (1 se non impostato).
  • Le unità del primo Cost trovato etichettano ogni valore di costo.

Numeri casuali e seed

  • Seed casuale rende un'esecuzione ripetibile. Lasciarlo vuoto per una nuova sequenza casuale ogni volta.
  • In Monte Carlo, ogni esecuzione estrae il proprio seed dal seed dello studio. È quindi possibile riprodurre una singola esecuzione in modalità Eventi discreti con Riproduci di nuovo nella scheda Esecuzioni (o Visualizza esecuzione per un'esecuzione non riuscita).
  • Math.random() negli script usa lo stesso generatore con seme.

La pagina Simulatore

Intestazione della pagina e barra di esecuzione

La barra sotto l'intestazione della pagina contiene, da sinistra a destra, l'Action radice, i controlli di esecuzione della modalità (sotto), Impostazioni e il selettore di modalità. Prima della prima esecuzione la pagina mostra una riga di spiegazione e il Diagramma di Action; le schede di riepilogo (Stato, Tempo totale, Costo totale, o quelle Monte Carlo) compaiono con la prima esecuzione.

  • Action radice: l'azione il cui flusso viene eseguito. L'elenco mostra ogni Action con un flusso di azioni. Un'azione senza flusso compare come “(nessun flusso)”. Scegliendo un'altra radice la pagina si riapre per essa.
  • Eventi discreti / Monte Carlo: la modalità. Il cambio mantiene le impostazioni di ciascuna modalità.
  • Intestazione della pagina: Risultati salvati ▾ (le esecuzioni salvate, o “Nessuna esecuzione salvata. Ogni esecuzione terminata viene salvata qui.”) e Apri Diagramma di Action.

Impostazioni

Impostazioni mostra o nasconde le impostazioni di esecuzione sotto la barra (inizialmente nascoste; la scelta viene ricordata in questo browser). Il suo suggerimento elenca le impostazioni correnti, per esempio “decisioni automatiche, velocità 100×, durate fisse, seed 42”.

ImpostazioneModalitàValoriPredefinito
EsecuzioniMonte CarloDa 1 a 20.000100
DecisioniEventi discretiAutomatico (in assenza di script), Chiedi (in assenza di script)Automatico (in assenza di script)
VelocitàEventi discreti1×, 10×, 100×, 1.000×, 10.000×, 100.000× (secondi simulati per secondo reale)100×
Varia le durate fisseEntrambe (conservate separatamente per modalità)Nessuna, Uniforme ±%, Triangolare ±%Nessuno
± %EntrambeDa 0 a 10010
Seed casualeEntrambeUn numero, o vuoto per un valore casualevuoto
Date di calendarioEventi discretiAvvia l'orologio alla data Start della Action radice; le Action con uno Start la attendonodisattivati
Avvia in pausa (passo per passo)Eventi discretiCrea l'esecuzione all'apertura della pagina, pronta per ⏭ Passodisattivati
  • Le impostazioni vengono salvate con la Action radice nel progetto man mano che si cambiano e valgono per chiunque lo apra. Ogni modifica si può annullare con un solo annullamento. Vengono anche ricordate in questo browser per altre Action radice.
  • Ripristina predefiniti (dopo “Le impostazioni vengono salvate con questa Action.”) ripristina i valori predefiniti e cancella le scelte di entità dei grafici.
  • I lettori possono cambiare le impostazioni per le proprie esecuzioni; non vengono salvate nel progetto.

Controlli degli eventi discreti

  • ▶ Riproduci / ⏸ Pausa: animano l'esecuzione alla velocità scelta. I lunghi tratti senza eventi vengono saltati subito.
  • ⏭ Passo: avanza all'evento successivo.
  • ⏩ Esegui fino alla fine: esegue fino alla fine senza animazione. Si ferma comunque per le richieste di input.
  • ⟲ Reimposta: scarta l'esecuzione.
  • Orologio: il tempo simulato corrente (una data e un'ora in Date di calendario).

Controlli Monte Carlo

  • ▶ Esegui Monte Carlo, Annulla, la barra di avanzamento e il testo di avanzamento.
  • Verifica rispetto a un requisito… (abilitato dopo uno studio con esecuzioni completate).
  • Qualsiasi esecuzione può essere riprodotta di nuovo o scaricata come pianificazione MS Project dalla scheda Esecuzioni.

Note sopra i pannelli

Gli avvisi che richiedono attenzione, come la visualizzazione di risultati salvati, restano visibili anche con le impostazioni nascoste.

  • “±n% uniform variation added to fixed durations.” (o triangolare) quando la variazione è attiva.
  • “Equal probabilities used for n unspecified constructs: …” dopo Usa probabilità uguali.
  • Il riquadro delle esecuzioni non riuscite (Monte Carlo) e il banner di riproduzione “Riproduzione dell'esecuzione Monte Carlo n (deadlock o errore) con seed s e le impostazioni dello studio.”

Pannelli

I risultati sono disposti in un layout fisso: una striscia di riepilogo in alto e le schede sotto. Ogni scheda contiene due colonne di pannelli; i pannelli larghi (il diagramma, il Gantt, il registro eventi, Statistiche ed Esecuzioni) occupano entrambe. Prima di un'esecuzione, ogni pannello mostra la propria descrizione. La scheda aperta viene ricordata in questo browser.

Menu del pannello

Ogni pannello ha un titolo e un menu ⋯:

  • Scarica dati… apre la finestra Esporta con i dati del pannello: file CSV con tutte le colonne e, per Azioni nel tempo, anche Pianificazione (MS Project XML). Il nome del file è “<root> <panel title>”.
  • Scarica immagine… apre la finestra Esporta con <panel title> (PNG) (con Sfondo trasparente e Scala) e <panel title> (SVG). Le immagini usano i colori del tema chiaro.
  • Scegli entità… (grafici di costi, risorse e asset) apre Scegli entità: filtrare l'elenco per nome o numero, spuntare le entità (Tutte, Nessuna) e fare clic su Applica. Se non ne è spuntata nessuna, il grafico mostra tutte le entità. I grafici dei costi aggiungono Mostra il totale. I colori seguono la tavolozza del grafico nell'ordine dell'elenco. La scelta viene salvata con la Action radice.

Fare clic su un'entità in un grafico, nell'elenco Stato o nel Registro eventi per aprirla nell'ispettore, con quante volte è stata eseguita e per quanto tempo.

Schede degli eventi discreti

Striscia di riepilogo: Stato, Tempo totale e Costo totale.

SchedaPannelloMostraDati
—StatoLe azioni in esecuzione ora, con l'avanzamento. Giallo: in attesa di un Input/Output; viola: di una Resource; arancione: di capacità di un Asset. Alla fine: 100% completato, Deadlock o Interrotta, con il numero di esecuzioni di azioni e il tempo totale—
—Tempo totaleL'orologio della simulazione (una data in Date di calendario, con il tempo trascorso)—
—Costo totaleIl costo totale progressivo e il numero di entità con costi—
TimelineDiagramma di Action durante l'esecuzioneIl Diagramma di Action radice, in sola lettura, con le azioni colorate mentre vengono eseguite (verde), attendono (arancione) e terminano (grigio)—
TimelineAzioni nel tempoUn Gantt delle azioni eseguite; le parti tratteggiate sono attese; le azioni scomposte sono parentesi su cui fare clic per comprimerle (▸/▾); le esecuzioni ripetute sono numerate #2, #3; le barre rosse sono state interrotte da un timeout di SYNC; una linea rossa tratteggiata indica l'orologio. Strumenti: +, − (zoom), Reimposta, Nascondi frecce delle linee / Mostra frecce delle linee, Nascondi colori delle linee / Mostra colori delle lineeCronologia (CSV), Pianificazione (MS Project XML)
CostoCosto nel tempoCosto cumulativo per ogni entità scelta, più il totaleCosto nel tempo (CSV)
CostoCosto per entitàCosto totale per ogni entità scelta (grafico a barre)Costo per elemento (CSV)
ResourceLivelli delle Resource nel tempoQuantità delle Resource scelte nel tempoLivelli delle Resource nel tempo (CSV)
ResourceQuantità delle ResourceIniziale, Minimo, Massimo, Finale, Consumato e Prodotto per ogni ResourceVariazioni delle Resource (CSV)
ResourceTempo di occupazione dell'AssetOccupato (%) per ogni Asset esecutore e unità in uso (o azioni in esecuzione) nel tempoUso degli Asset (CSV)
RegistroConsoleOutput di print(), errori degli script (con numeri di riga), avvisi e deadlockConsole (CSV)
RegistroRegistro eventiOgni evento del motore: start, end, wait, resume, io, transfer, resource, decision, loop, exit, sync, killed, cost, deadlock, errorRegistro eventi (CSV)
RegistroVariabili degli scriptVariabili globali degli script (globals.put) con il loro valore corrente; espandere un valore per vederne la cronologiaValori globali (CSV)

Durante la riproduzione di un'esecuzione vengono ridisegnate solo la striscia di riepilogo e la scheda aperta; le altre schede si aggiornano quando le si apre o quando l'esecuzione termina.

Schede Monte Carlo

Striscia di riepilogo: Esecuzioni completate.

SchedaPannelloMostraDati
—Esecuzioni completateSimulazioni completate; media e deviazione standard di durata e costo. Le esecuzioni in deadlock o con errori vengono contate a parte ed escluseRiepilogo Monte Carlo (CSV)
DistribuzioneStatisticheMedia, IC 95% della media, deviazione standard, minimo, P5, mediana (P50), P95 e massimo di durata, costo e ogni variabile globale numerica degli script (solo esecuzioni completate)—
DistribuzioneDistribuzione della durataIstogramma della durata totale per esecuzioneDurate delle esecuzioni (CSV)
DistribuzioneDistribuzione del costoIstogramma del costo totale per esecuzione (“Nessuna esecuzione ha avuto costi.” in assenza di costi)Costi delle esecuzioni (CSV)
DistribuzioneProbabilità cumulativa (curva a S)La distribuzione cumulativa di un output scelto, con un campo x e la lettura P(X ≤ x)—
FattoriTempo per ActionDurate delle azioni combinate su tutte le esecuzioniDurate delle azioni (CSV)
FattoriCosto per ActionCosto combinato per azione o asset su tutte le esecuzioniCosti delle azioni (CSV)
FattoriCombinazioni di ramiOgni combinazione di rami OR, con Esecuzioni e QuotaCombinazioni di rami (CSV)
ResourceLivelli delle ResourceQuantità minima, massima e finale media per ogni ResourceResource tra le esecuzioni (CSV)
ResourceTempo di occupazione dell'AssetOccupato (%) medio per ogni Asset esecutore (un grafico a barre con meno di tre asset)Uso degli Asset tra le esecuzioni (CSV)
EsecuzioniEsecuzioniOgni esecuzione con Esegui, Seed, Esito (Completata, Deadlock, Errore), Durata e Costo. Fare clic su un'intestazione di colonna per ordinare (di nuovo per invertire). P10, P50 e P90 scelgono l'esecuzione in quel punto della distribuzione della durata e la evidenziano. Riproduci di nuovo esegue di nuovo un'esecuzione in modalità Eventi discreti con il suo seed; MS Project la scarica come pianificazione MS Project XML, “<root> run <n>.xml”. Vengono elencate le prime 500 esecuzioniEsecuzioni (CSV) (ogni esecuzione: seed, esito, durata, costo, percorso, variabili globali)

I messaggi della console per singola esecuzione non vengono conservati in uno studio; usare Riproduci di nuovo su un'esecuzione per vederli.

Script

Gli script sono hook JavaScript su Action, OR, SYNC e LOOP. Usarli quando il diagramma da solo non può esprimere un comportamento, come una decisione basata sul livello di una risorsa.

Per scrivere uno script:

  1. Nel Diagramma di Action, selezionare l'elemento.
  2. Nell'ispettore, fare clic su Modifica script… (per un'azione), oppure su Modifica script… / Aggiungi script… nei pannelli OR, SYNC e LOOP.

    Si apre la finestra dell'editor, per esempio Script: Capture Image Strip o Script OR: ….

  3. Fare clic su Aggiungi onStart(), Aggiungi prompt(), Aggiungi onEnd() o Aggiungi duration() per inserire un hook vuoto.
  4. Scrivere il codice. Tab inserisce due spazi.
  5. Fare clic su Salva (o Annulla).

Hook

HookChiamatoValore restituito
onStart()All'avvio dell'azione o del costrutto—
prompt(p)Dopo onStart, per costruire una finestra di input— (compilare p)
onEnd(response)Al termine di un'azione; per un OR quando decide; per un LOOP prima di ogni passaggioOR: il nome o l'indice del ramo. LOOP: true per continuare, false per fermarsi, oppure un numero di passaggi ulteriori
duration()Quando la Duration dell'azione è =script()La durata nell'unità della Duration

response contiene le risposte della finestra di input, indicizzate per nome dell'input.

Con Automatico (in assenza di script), e in Monte Carlo, la finestra di input non viene mostrata. Si usano invece i valori predefiniti: il valore di un numero o 0, il valore di una casella di controllo, oppure la prima scelta.

Costruttore di prompt

  • p.setTitle(text): il titolo della finestra (predefinito “Input per <name>”).
  • p.addEnumInput(title, name, choices, default): un elenco di scelte.
  • p.addTextInput(title, name, default), p.addBigtitleTextInput(title, name, default) (su più righe), p.addNumberInput(title, name, default), p.addBooleanInput(title, name, default) (casella di controllo).

La finestra riporta “Simulazione in pausa a <time>.” e si chiude con OK.

Disponibili negli script

  • print(x, …): scrive nella Console. Gli oggetti vengono stampati come JSON.
  • globals.put(key, value), globals.get(key): valori tracciati nel tempo in Variabili degli script. Le variabili globali numeriche diventano output Monte Carlo (Globale: key) in Statistiche, nella curva a S e in Verifica rispetto a un requisito….
  • Sim.getEntityById(id), Sim.getEntityByGlobalId(id), Sim.getEntityByName(name), Sim.getEntityByNumber(number), Sim.getEntitiesByName(name), Sim.getEntitiesByNumber(number): restituiscono wrapper di entità.
    • Proprietà: id, name, number, description, className.
    • Metodi: getId(), getGlobalId(), getName(), getNumber(), getDescription(), getAttribute(name) (per nome di attributo, senza distinzione tra maiuscole e minuscole) e attributes().get(name).
  • Sim.getIOValueById(id), Sim.getIOValueByGlobalId(id), Sim.getIOValueByName(name), Sim.getIOValueByNumber(number): l'attributo Value di un Input/Output.
  • Sim.getAmount(name), Sim.getAmountById(id), Sim.getAmountByGlobalId(id): la quantità corrente di una Resource. Sim.getResourceByName(name) restituisce {id, name, amount, units}.
  • Sim.setResourceById(id, value), Sim.setResourceByGlobalId(id, value), Sim.setResourceByName(name, value): impostano la quantità di una Resource (registrata come modifica da script).
  • Sim.getCurrentTime() (millisecondi dall'inizio) e Sim.getCurrentCost().

Ogni script viene compilato una volta per esecuzione, quindi le variabili di primo livello mantengono i propri valori tra i passaggi di un ciclo. Per gli script il modello è in sola lettura, tranne le quantità delle risorse.

Esempio: decidere un ramo dalla carica della batteria

function onEnd() {
  const wh = Sim.getAmount('Battery Charge');
  globals.put('Battery at decision', wh);
  return wh > 40 ? 'Yes' : 'No';
}

Inserirlo sull'OR Contact in view? con Tipo di decisione Script. I nomi dei rami devono essere Yes e No.

Sandbox e attendibilità

  • Ogni esecuzione avviene in una sandbox separata con una copia in sola lettura del modello. Gli script non hanno accesso alla pagina, ad altri progetti, ai file, all'archiviazione del browser o alla rete.
  • Una chiamata di script che dura più di 8 secondi interrompe l'esecuzione: “The script of <name> ran longer than 8 s and was stopped. Check it for an endless loop.”
  • Gli script scritti o approvati in questo browser sono attendibili.

Un'esecuzione può includere script provenienti da altrove, come un file importato o le modifiche di un altro membro. Prima di un'esecuzione di questo tipo, Holarch chiede di approvarli. La domanda compare prima di ▶ Riproduci, ⏭ Passo, ⏩ Esegui fino alla fine e ▶ Esegui Monte Carlo.

  1. Avviare l'esecuzione.

    La finestra Eseguire script di un altro autore? indica quanti script ci sono. Spiega che gli script vengono eseguiti in una sandbox senza accesso ai progetti, ai file o alla rete.

  2. Aprire Mostra gli script per esaminarli.
  3. Fare clic su Esegui script per eseguirli, oppure su Annulla.

Dopo aver fatto clic su Esegui script, quegli script restano attendibili da quel momento in questo browser.

Tastiera e mouse

AzioneEffetto
Fare clic su una barra del Gantt, un punto di un grafico, una cella della mappa ad albero o una riga di statoApre l'entità nell'ispettore
Fare clic sull'etichetta di una riga scomposta del GanttComprime o espande i suoi figli
Tab nell'editor degli scriptInserisce due spazi

Messaggi

MessaggioSignificato e soluzione
“Nessuna Action da simulare” / “Assegnare a un'Action delle Action figlie e disegnarne il flusso nel suo Diagramma di Action.”Il progetto non ha alcuna Action con un flusso
“Errore di simulazione” con i dettagliNon è stato possibile avviare l'esecuzione o la sandbox non ha funzionato; leggere i dettagli
“The root Action no longer exists. Choose another root Action.” (La Action radice non esiste più. Scegliere un'altra Action radice.)La radice è stata eliminata
“Script error in <name> (<hook>): <message>”Uno script ha generato un errore; l'esecuzione si ferma. La Console mostra il numero di riga
“<name>: script returned “x”, which matches no branch; picked at random.”Uno script OR ha restituito un nome di ramo sconosciuto
“<name>: more than 10000 iterations — check the LOOP condition.”Un LOOP non si ferma mai
Cicli che non terminano mai (prima di un'esecuzione)Nessun EXIT può terminare un ciclo che si ripete al 100 % (Action.19). Correggerlo, oppure scegliere Esegui comunque.
“An infinite hierarchy exists (A → B → A). Remove one of these decomposition links in the diagram.”Un'azione è scomposta in sé stessa
“Simulazione interrotta: troppi passi (controllare i conteggi dei LOOP o una scomposizione ricorsiva).”Più di 20.000 esecuzioni di azioni in un'esecuzione
“Simulation aborted: event limit reached.”Più di 500.000 eventi in un'esecuzione
“Deadlock: <action> waiting for I/O <name> (never generated)”Un I/O di trigger non è mai stato generato
“Deadlock: <action> waiting for <amount> <resource> (never available)” / “waiting for Asset capacity: …”Una risorsa o una capacità non è mai diventata disponibile
“Asset <name> has more than one parent; using the first for its capacity.”La capacità dell'asset deriva dalla Multiplicity del primo padre
“<I/O> is carried by several Conduits; the simulator used <conduit>.”Si applica solo il ritardo del primo Conduit
“Simulation scripts have no network access (Sim.httpGet, httpPost and httpPut are not available).”Gli script non possono accedere alla rete
“No entity was found with name: <name>” / “No resource was found with id: <id>”Una ricerca Sim non ha trovato nulla
“Simulation scripts cannot compile code at run time.” / “Simulation scripts cannot use import().”Uno script ha tentato di creare o caricare codice
“The script of <name> ran longer than 8 s and was stopped. Check it for an endless loop.”Watchdog degli script
“The simulation stopped responding and was stopped.”La sandbox ha smesso di rispondere al di fuori di uno script
“Esecuzione Monte Carlo interrotta”È stato fatto clic su Annulla
“n di N esecuzioni non riuscite (d in deadlock, e con errori). P(insuccesso) = …”Le esecuzioni non riuscite sono escluse dalle statistiche; usare Visualizza esecuzione
“Nessuna esecuzione completata. Eseguire prima Monte Carlo.”Verifica rispetto a un requisito… richiede esecuzioni completate
“Inserire un valore di soglia o scegliere una Measure.” / “Inserire prima un valore di soglia.”Il controllo non ha un valore
“<Measure> has no numeric Threshold Value. Enter the threshold.”La soglia o l'obiettivo della Measure non è un numero
“Scegliere una Measure o un Requirement per registrare il risultato.”Registra risultato… richiede una destinazione
“Selezionare almeno una modifica.”Tutte le righe di Registra risultato sono deselezionate
“Risultato registrato”La Measure e il Test Case sono stati aggiornati
“La probabilità richiesta rientra nell'intervallo di confidenza. Eseguire più iterazioni per un verdetto più solido.”Il verdetto potrebbe cambiare con più esecuzioni
“Impossibile leggere i risultati salvati: <reason>. Eseguire di nuovo la simulazione.”Il file .sim salvato manca o non è valido; fare clic su Esegui di nuovo
“Questo pannello è per l'altra modalità di simulazione.”Un pannello dell'altra modalità
“Sola visualizzazione: chiedere a un proprietario l'accesso in modifica.”I lettori possono eseguire simulazioni ma non possono salvare impostazioni, risultati o verifiche registrate

Limiti

  • Monte Carlo: da 1 a 20.000 iterazioni per studio.
  • Un'esecuzione: al massimo 20.000 esecuzioni di azioni, 500.000 eventi e 10.000 passaggi di un LOOP.
  • Chiamate di script: 8 secondi ciascuna.
  • Tabella delle esecuzioni non riuscite: vengono elencate le prime 50 esecuzioni non riuscite. Esecuzioni ⋯ → Scarica dati… → Esecuzioni (CSV) elenca tutte le esecuzioni.
  • Scheda Esecuzioni: vengono elencate le prime 500 esecuzioni; Esecuzioni (CSV) le contiene tutte.
  • Le statistiche Monte Carlo usano solo le esecuzioni completate.
  • Solo il primo Conduit che trasferisce un I/O ne imposta il ritardo; solo il primo padre imposta la capacità di un asset.