Comportement
Simulation
Exécutez un flux Action en simulation à événements discrets ou en étude de Monte-Carlo, lisez les résultats de temps, de coût, de ressources et d'utilisation, scriptez les décisions et enregistrez un résultat de vérification pour une exigence.
Sur cette page
Vue d'ensemble
Le simulateur exécute le flux d'une Action en temps simulé, exactement comme le dessine son diagramme d'Action. Il a deux modes :
- Événements discrets : une exécution chronométrée que vous pouvez suivre, parcourir pas à pas et dans laquelle vous répondez aux décisions. Elle montre quelles actions s'exécutent et quand, ce qu'elles attendent, comment les ressources montent et descendent, quels assets sont occupés et ce que coûte l'exécution.
- Monte Carlo : de nombreuses exécutions indépendantes avec des durées et des décisions tirées au hasard. Il montre la dispersion du temps total et du coût total, les percentiles, une courbe de probabilité cumulée, les chemins de décision pris et la probabilité de respecter un seuil.
Le simulateur lit le modèle et ne le modifie jamais pendant l'exécution. Il écrit dans le projet de trois façons : les paramètres d'une action racine (enregistrés à mesure que vous les modifiez), un enregistrement pour chaque exécution terminée, et Consigner le résultat….
Concepts
Ce que lit le simulateur
Le simulateur prend dans le modèle tout ce dont il a besoin. Configurez ces éléments dans le diagramme d'Action et dans les attributs des entités avant de lancer l'exécution.
| Élément du modèle | Provenance | Ce que la simulation en fait |
|---|---|---|
| Flux | Le diagramme d'Action de l'Action racine : séquence, Parallel, SYNC, OR, LOOP et EXIT | Exécute les éléments dans l'ordre. Les branches s'exécutent en parallèle, ou l'une d'elles est choisie. |
| Durée | L'attribut Durée de chaque Action (un nombre ou une distribution, avec une unité) | Le temps que prend l'action. Une action décomposée dure aussi longtemps que son flux enfant. |
| Décomposition | Actions enfants dotées de leur propre flux | Exécute le flux enfant au lieu de la durée propre du parent |
| Déclencheurs | Input/Outputs qu'une action receives (attribut de relation Déclencheur, activé sauf s'il vaut false) | L'action attend que chaque I/O déclencheur ait été généré |
| Génération des I/O | Input/Outputs qu'une action generates | Mis à disposition à la fin de l'action, après l'éventuel délai du Conduit |
| Délai du Conduit | Le Conduit qui transfers l'I/O : Latence plus Taille ÷ Capacité | Retarde la livraison de l'I/O |
| Resources | Relations consumes, seizes et produces vers des Resources, avec une Quantité (1 par défaut) | Consommée et saisie au début. Les quantités saisies sont libérées à la fin. Produite à la fin. |
| Capacité des Assets | performed by avec une Quantité, et la Multiplicité de l'asset sous son parent | L'action attend que l'asset ait de la capacité libre |
| Temps d'occupation des Assets | Chaque Asset qui exécute une action (performed by) | Occupation (%) et graphiques d'utilisation |
| Coûts | Entités Cost incurred by une Action ou un Asset exécutant | Ajoutées au coût total cumulé |
| Calendar | L'attribut Début de la racine et de chaque Action | Utilisé uniquement dans Dates calendaires |
| Scripts | Le script de simulation de l'action ou de la construction | Des hooks qui définissent des durées, choisissent des branches, vous posent des questions et suivent des valeurs |
Les temps sont conservés en secondes et affichés dans l'unité la plus lisible (ms, s, min, h, jours, mois ou années).
Les règles détaillées des durées, décisions, ressources, assets, coûts et graines figurent dans Règles de simulation ci-dessous.
Mode d'emploi
Quand et pourquoi
Simulez une fois que le flux fonctionnel existe et que ses actions ont des durées, des exécutants et des ressources. C'est généralement après l'analyse fonctionnelle, pendant l'allocation et les compromis d'architecture.
Une simulation répond aux questions suivantes :
- Combien de temps dure l'opération, et dans quelle mesure ce temps varie-t-il ?
- Quelles actions sont sur le chemin critique ? Où attendent-elles, des données, des ressources ou de la capacité d'asset ?
- Les ressources comme la charge de la batterie ou le stockage de données restent-elles dans leurs limites ?
- Quels assets sont surchargés ?
- Quelle est la probabilité qu'une exigence de performance (temps, coût, niveau d'une ressource) soit respectée ? Cela devient un résultat de vérification par analyse lié à l'exigence.
Lancer une simulation à événements discrets
- Ouvrez le diagramme d'Action de l'opération.
- Choisissez ▶ Simuler ▾ → Événements discrets.
Le simulateur s'ouvre avec cette Action comme Action racine.
Autres accès : Comportement → Simulateur dans le rail de navigation (il s'ouvre sur une Action dont les paramètres du simulateur sont enregistrés, sinon sur la première Action dotée d'un flux ; choisissez une autre Action racine si nécessaire), ou Ouvrir dans ▾ → Simulateur d'une Action. Choisir une autre Action racine à la souris l'ouvre aussitôt ; au clavier, choisissez-la et appuyez sur Enter (ou cliquez sur Ouvrir).
- Vérifiez les paramètres : cliquez sur Paramètres dans la barre du haut (son info-bulle liste les paramètres actuels). Les principaux paramètres sont Décisions, Vitesse, Faire varier les durées fixes avec ± %, Graine aléatoire et Dates calendaires (voir Paramètres).
- Appuyez sur ▶ Lecture.
L'horloge tourne et Actions dans le temps (onglet Chronologie) s'allonge. Action Diagram en cours d'exécution colore chaque action en vert pendant qu'elle s'exécute, en orange pendant qu'elle attend et en gris lorsqu'elle est terminée.
- Appuyez sur ⏸ Pause pour arrêter et inspecter.
- Appuyez sur ⏭ Pas pour avancer jusqu'à l'événement suivant, ou sur ⏩ Exécuter jusqu'à la fin pour terminer sans animation.
- Lorsqu'une boîte de dialogue intitulée Saisie pour … apparaît, choisissez le chemin ou saisissez la valeur.
- Cliquez sur OK.
L'exécution reprend comme avant : lecture, pas à pas ou exécution jusqu'à la fin.
- Lisez les résultats à la fin de l'exécution :
- Statut : Terminé à 100 %, Blocage ou Arrêté. Après un blocage, il indique quand l'exécution s'est arrêtée et ce qu'attend chaque action en attente, par exemple Arrêté à 0 ms : F1 Separate and Detumble attend ADCS Sensor Data, qu'aucune action antérieure ne produit. Cliquez sur le nom d'une action pour l'inspecter ;
- Temps total et Coût total ;
- les panneaux des ressources et de l'utilisation ;
- la Console, pour les avertissements.
- Cliquez sur n'importe quelle barre ou n'importe quel élément de graphique pour obtenir des détails.
L'entité s'ouvre dans l'inspecteur, avec la fréquence et la durée de son exécution pendant cette exécution. Ouvrir dans ▾ → Vue de l'élément ouvre sa page.
- Appuyez sur ⟲ Réinitialiser pour effacer l'exécution et recommencer.
Lancer une étude Monte Carlo
- Basculez l'en-tête sur Monte Carlo. Depuis le diagramme d'Action, choisissez plutôt ▶ Simuler ▾ → Monte Carlo.
- Réglez Exécutions (1 à 20 000 ; 100 par défaut).
- Réglez Faire varier les durées fixes si vous voulez une dispersion sur les durées fixes.
- Saisissez une Graine aléatoire si l'étude doit être reproductible.
- Appuyez sur ▶ Exécuter Monte Carlo.
Si certains OR ou LOOP n'ont ni probabilité ni nombre, la boîte de dialogue Décisions non spécifiées les liste.
- Dans cette boîte de dialogue, cliquez sur Utiliser des probabilités égales pour continuer. Ou cliquez sur Annuler et définissez-les dans le diagramme d'Action.
Vous voyez une barre de progression et le texte en cours
k / n · mean … · mean cost …. Cliquez sur Annuler pour arrêter ; le message indique « Exécution Monte Carlo arrêtée ».Une fois l'étude terminée, le texte indique le nombre de simulations et le temps écoulé.
- Lisez Exécutions terminées, puis l'onglet Distribution (Statistiques, Distribution des durées, Probabilité cumulée (courbe en S)) et Combinaisons de branches dans l'onglet Facteurs.
Si des exécutions se sont bloquées ou ont échoué, un encadré rouge en donne le nombre et P(échec) avec son intervalle de confiance à 95 %.
- Pour voir pourquoi une exécution a échoué, ouvrez Exécutions en échec et cliquez sur Afficher l'exécution.
L'exécution est rejouée en mode Événements discrets avec sa propre graine.
- Cliquez sur Retour aux résultats Monte Carlo pour revenir.
Contrôler une exigence et consigner le résultat
Utilisez ceci après une étude Monte Carlo pour transformer les résultats en résultat de vérification.
- Cliquez sur Contrôler par rapport à une exigence….
- Choisissez la Sortie : Temps total, Coût total, la quantité minimale ou finale de chaque Resource, ou une variable globale numérique d'un script (Global : …).
- Définissez le seuil de l'une de ces deux façons :
- À partir d'une Measure : choisissez une Measure et un Utiliser (Seuil ou Objectif). Les champs se remplissent à partir de la Measure (voir ci-dessous).
- À la main : définissez Critère (≤ au plus ou ≥ au moins), Valeur et Unités, et choisissez la Requirement.
- Définissez Probabilité requise (%) (90 par défaut).
Vous voyez le tableau des résultats :
- Critère et Exécutions ;
- Moyenne (IC à 95 %) et P5 / P50 / P95 ;
- P(satisfait), avec son intervalle de confiance à 95 % ;
- Marge (moyenne vs seuil) ;
- Résultat : Réussite ou Échec.
- Cliquez sur Consigner le résultat….
L'aperçu Consigner le résultat liste les modifications qu'il va effectuer :
- La Valeur projetée (ou la Valeur) de la Measure est définie sur la moyenne.
- Un Test Case vérifie l'exigence. Il s'agit d'un nouveau cas nommé « Simulation check: <output> <criterion> », ou d'un cas existant que vous choisissez. Son Statut devient Passed ou Failed, et son Résultat réel reçoit le texte du résultat.
- Décochez toute ligne que vous voulez ignorer.
- Cliquez sur Appliquer.
Une seule annulation défait le tout.
Lorsque vous choisissez une Measure à l'étape 3, elle remplit les champs comme suit :
- Sa valeur remplit Valeur et Unités.
- Son Sens d'amélioration détermine le critère : Negative donne ≤, Positive donne ≥.
- La Requirement qu'elle specifies remplit Requirement.
Exécutions enregistrées
Chaque exécution terminée est enregistrée pour vous ; il n'y a pas d'étape d'enregistrement.
- Une exécution Événements discrets est enregistrée lorsqu'elle se termine (achevée, bloquée ou arrêtée). Une étude Monte Carlo est enregistrée lorsque toutes ses exécutions sont terminées ; une étude annulée n'est pas enregistrée.
- L'enregistrement est un Artifact étiqueté Simulation Run, avec un fichier
.sim. Son nom est « <root> run <date> seed <n> », par exemple « Perform Delivery Mission run 2026-10-14 09.30 seed 48213 », ou « <root> Monte Carlo <date> seed <n> » pour une étude. Sa description résume le résultat. - Une exécution sans Graine aléatoire en reçoit une, de sorte que le nom indique comment la reproduire : saisissez cette graine et relancez.
- Le message « Enregistré sous <name>. » renvoie vers l'enregistrement.
- Les rejeux d'une exécution Monte Carlo et les enregistrements ouverts ne sont pas enregistrés de nouveau. Les lecteurs ne peuvent pas enregistrer d'enregistrements.
- Supprimez les enregistrements dont vous n'avez pas besoin dans la base de données (filtrez par l'étiquette Simulation Run).
Les projets plus anciens utilisent le nom d'étiquette Simulation Output ; il devient Simulation Run à l'ouverture du projet, et les imports acceptent l'un ou l'autre nom.
Pour rouvrir des résultats enregistrés :
- Ouvrez Résultats enregistrés ▾ dans l'en-tête de la page.
- Choisissez le résultat.
Un bandeau indique « Affichage des résultats enregistrés : … ». Son lien Exécuter de nouveau sur le modèle actuel exécute le modèle actuel dans le même mode.
Exemple complet : la passe d'imagerie de CubeSat EO-1
Le projet de démonstration contient l'opération OPS Run Nominal Imaging Pass. Il contient aussi l'exigence 6.5 Planning Cycle Time : « The mission shall complete each planning cycle, from target list uplink to product delivery, within 100 minutes. » Créez la démo avec Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration.
Le flux d'OPS :
- Trois étapes en séquence :
- OPS.1 Transmit Imaging Plan (triangulaire de 4 à 9 minutes, pic à 6 ; Ground Station) ;
- OPS.2 Receive Imaging Plan (1 minute) ;
- OPS.3 Load Command Schedule (2 minutes).
- Un Parallel : OPS.4 Rotate to Target (normale, 3 ± 0,5 minute) et OPS.5 Prepare Camera (5 minutes). Les deux sont déclenchées par l'I/O Command Schedule que génère OPS.3.
- Une LOOP Each target, 4 itérations : OPS.6 Capture Image Strip (normale, 40 ± 6 secondes), puis OPS.7 Encode and Store Image (uniforme de 20 à 40 secondes).
- Un OR Contact in view? :
- Yes (75 %) exécute OPS.8 Transmit Image Data (normale, 8 ± 1,5 minute) ;
- No (25 %) exécute OPS.9 Hold Data Onboard.
- Un Parallel : OPS.10 Recharge Battery in Sunlight (35 minutes) sur une branche. Sur l'autre, OPS.11 Receive Downlink (9 minutes) suivie de OPS.12 Process Image Products (normale, 45 ± 10 minutes).
Les ressources :
- Battery Charge (62 Wh au départ, minimum 23, maximum 77). OPS.4 à OPS.8 la consomment. OPS.10 la produit (+30 Wh).
- Data Storage (1,5 Go au départ). Elle gagne 2,5 Go à chaque OPS.7 et perd 8 Go dans OPS.8.
La démo a des paramètres enregistrés pour OPS : graine 42, et 200 itérations Monte Carlo avec une variation uniforme de ±10 % sur les durées fixes.
Exécutez-la :
- Ouvrez Comportement → Simulateur.
- Choisissez OPS Run Nominal Imaging Pass comme Action racine et gardez Événements discrets.
- Appuyez sur ⏩ Exécuter jusqu'à la fin.
Vous voyez :
- Actions dans le temps montre OPS.4 et OPS.5 côte à côte, et quatre itérations numérotées d'OPS.6 et d'OPS.7 (
#2,#3,#4). - La longue branche OPS.11 → OPS.12 détermine l'heure de fin.
- Dans l'onglet Resources, Niveaux des Resources dans le temps montre Battery Charge qui baisse par paliers pendant l'imagerie et remonte pendant OPS.10.
- Coût total indique « Aucun coût », car la démo n'a pas d'entités Cost.
- Actions dans le temps montre OPS.4 et OPS.5 côte à côte, et quatre itérations numérotées d'OPS.6 et d'OPS.7 (
- Passez à Monte Carlo.
- Appuyez sur ▶ Exécuter Monte Carlo (200 exécutions).
Combinaisons de branches (onglet Facteurs) montre environ les trois quarts des exécutions sur Yes.
- Cliquez sur Contrôler par rapport à une exigence… et gardez Temps total.
- Choisissez la Measure MOE-7 Planning Cycle Time et Utiliser Seuil.
La valeur devient 100, les unités Minutes, le critère ≤ et la Requirement 6.5 Planning Cycle Time.
- Gardez 90 % et lisez P(satisfait) et le verdict.
- Cliquez sur Consigner le résultat…, puis sur Appliquer.
La valeur projetée de MOE-7 reçoit la moyenne. Un Test Case qui vérifie 6.5 reçoit le statut Passed ou Failed. La RVTM liste désormais ce Test Case en regard de 6.5.
Conseils et bonnes pratiques
- Donnez une durée à chaque action feuille. Une action sans durée ne prend aucun temps et disparaît de l'axe du temps.
- Utilisez des distributions pour les durées dont vous n'êtes pas sûr. N'utilisez Faire varier les durées fixes que comme contrôle rapide de sensibilité.
- Avant Monte Carlo, définissez les probabilités de chaque OR et les itérations de chaque LOOP. Sinon, chaque exécution choisit au hasard, et les résultats le signalent.
- Définissez une Graine aléatoire avant de consigner un résultat de vérification, afin que le résultat puisse être reproduit. La graine figure dans le texte consigné.
- Exécutez suffisamment d'itérations. Lorsque la probabilité requise se trouve dans l'intervalle de confiance, le contrôle indique « Exécutez davantage d'itérations pour un verdict plus sûr. »
- Les paramètres sont enregistrés avec l'action racine à mesure que vous les modifiez, et accompagnent donc le projet.
Erreurs courantes
| Symptôme | Cause | Correction |
|---|---|---|
| Statut affiche Blocage ; la console indique « en attente de l'I/O … (jamais générée) » | Une action reçoit comme déclencheur une I/O que rien ne génère sur le chemin emprunté (par exemple après un OR) | Générez l'I/O sur chaque chemin, ou réglez Déclencheur sur false sur la relation receives |
| Blocage « en attente de … (jamais disponible) » | Une Resource ne remonte jamais au-dessus de la quantité dont une action a besoin, ou la capacité d'un asset est inférieure à la quantité d'une action | Augmentez la quantité initiale, ajoutez une action productrice, ou vérifiez les quantités et la multiplicité |
| Chaque exécution a le même temps total | Toutes les durées sont fixes et la variation est Aucune | Utilisez des distributions, ou réglez Faire varier les durées fixes |
| « Simulation interrompue : trop d'étapes (vérifiez les nombres de LOOP ou une décomposition récursive). » | Une LOOP s'exécute bien trop souvent, ou une action se trouve dans sa propre décomposition | Réduisez le nombre de la LOOP ou corrigez la décomposition |
| La console affiche « Erreur de script dans … » | Un script a levé une exception | Ouvrez le script de l'action (Modifier le script… dans l'inspecteur du diagramme d'Action) et corrigez la ligne indiquée |
| Utilisation des Assets est vide | Aucune action n'est performed by un Asset | Reliez les actions à leurs Assets exécutants |
Liens avec le reste
- Alimenté par : le flux du diagramme d'Action, ainsi que les attributs et relations de ses actions, I/O, ressources, conduits, assets et coûts. Le flux construit dans l'analyse fonctionnelle est le même flux.
- Alimente :
- les Measures (Valeur projetée ou Valeur) ;
- les Test Cases qui vérifient des exigences, et donc la RVTM et le Centre de test ;
- les Artifacts contenant des résultats enregistrés ;
- les plannings MS Project XML et les rapports CSV.
Règles de simulation
Cette section explique précisément comment le simulateur traite les durées, les décisions, les ressources, les assets, les coûts et les nombres aléatoires.
Durées et distributions
- Une Durée est une valeur et une unité : Milliseconds, Seconds, Minutes, Hours, Days, Weeks, Months ou Years. Une valeur sans unité est lue en heures.
- La valeur est un nombre fixe ou une distribution, comme
=norm.dist(40, 6)ou=triang.dist(4, 9, 6). - Les distributions sont échantillonnées à chaque exécution.
- Les durées négatives tirées sont tirées à nouveau. Une distribution normale se comporte donc comme si elle était tronquée à 0.
- Dix distributions sont disponibles : bêta, binomiale, exponentielle, gamma, log-normale, normale, Poisson, triangulaire, uniforme et Weibull. Voir Types d'attributs et distributions.
- Une durée de
=script()appelle le hookduration()de l'action à chaque exécution. Saisissez=script()dans la valeur de la durée ; le hook renvoie la durée dans l'unité de la durée (une absence de nombre compte pour 0).
Faire varier les durées fixes est un paramètre qui ajoute une dispersion aux nombres fixes uniquement. Les distributions ne sont jamais modifiées davantage.
- Uniforme ±% échantillonne uniformément dans ± le pourcentage.
- Triangulaire ±% échantillonne une distribution triangulaire dont le pic est la valeur fixe.
Constructions de contrôle
| Construction | Comportement en simulation |
|---|---|
| Parallèle (sans entité) | Démarre toutes les branches à la fois. Continue lorsque toutes les branches ont terminé. |
| SYNC | Comme Parallel. Sa Durée est un délai. Lorsqu'il expire, les branches non terminées sont arrêtées (leurs barres de Gantt deviennent rouges, « arrêtée par expiration du délai du SYNC ») et le flux continue. |
| OR | Prend exactement une branche, choisie selon le Type de décision (ci-dessous) |
| LOOP | Contrôle son Répéter tant que avant chaque passage, et exécute de nouveau le corps tant que la condition est vraie |
| EXIT | Termine la LOOP englobante. Au premier niveau, il termine le flux. |
Types de décision du OR :
- Probabilité : chaque branche a une probabilité (%). Les branches laissées vides se partagent à parts égales ce qui reste de 100 %. Si toutes les probabilités valent 0, chaque branche est également probable.
- Quantité de ressource : chaque branche compare la quantité actuelle de la Resource choisie (
==,!=,>,<,>=,<=). La première branche dont la condition est vraie est prise, sinon la branche marquée else. - Script : le
onEnd()de la construction renvoie le nom de la branche à prendre (ou son indice). Un nom inconnu consigne un avertissement, et une branche aléatoire est prise. - Aucun (demander pendant l'exécution, ou aléatoire) : lorsque Décisions est réglé sur Demander (sans script), une boîte de dialogue demande quel chemin prendre. Sinon, une branche est choisie au hasard.
Conditions de continuation d'une LOOP :
- Itérations : un nombre fixe de passages (au moins 1).
- Probabilité : avant chaque passage, continuer avec cette probabilité (%).
- Quantité de ressource : continuer tant que la quantité de la Resource satisfait la comparaison.
- Script :
onEnd()est appelé avant chaque passage.trueexécute de nouveau le corps,falsearrête, et un nombre définit combien de passages supplémentaires exécuter. - Aucun (demander pendant l'exécution, ou aléatoire) : en mode question, une boîte de dialogue demande Combien d'itérations ? (3 par défaut). Sinon, elle exécute 0, 1 ou 2 passages au hasard.
Resources
Une Resource a une Quantité initiale, une Quantité minimale, une Quantité maximale et des Unités. La quantité initiale est ramenée entre le minimum et le maximum.
- consumes : la quantité est prise au démarrage de l'action et n'est pas restituée.
- seizes : la quantité est prise au démarrage de l'action et libérée à sa fin.
- produces : la quantité est ajoutée à la fin de l'action. Les quantités au-delà du maximum sont plafonnées.
Une action attend lorsqu'elle a besoin de plus que ce qui est disponible. « Non disponible » signifie que la quantité descendrait sous la quantité minimale, ou sous 0 lorsqu'aucun minimum n'est défini. L'action attend que d'autres actions libèrent ou produisent suffisamment. Sa barre de Gantt affiche une attente hachurée violette.
Assets et utilisation
- Chaque Asset qui exécute une action (performed by) est occupé pendant l'exécution de l'action.
- Occupation (%) est la part du temps simulé pendant laquelle au moins une de ses actions s'est exécutée.
Pour modéliser la capacité, définissez une Quantité sur la relation performed by.
- La capacité de l'asset est la borne supérieure de la Multiplicité de la relation decomposed by de son parent. Par exemple,
0..2donne 2. - Une action attend tant que l'asset n'a pas de capacité libre (attente hachurée orange).
- Sans multiplicité, la capacité est illimitée.
Coûts
- Une entité Cost a une Quantité, un Taux et des Unités.
- Avec le taux Par heure, la quantité est multipliée par la durée de l'action en heures. Sinon, elle est facturée une seule fois, à la fin de l'action.
- Un Cost incurred by un Asset exécutant est facturé pour chaque action que l'Asset exécute. Il est multiplié par la quantité de performed by (1 si non définie).
- Les unités du premier Cost trouvé servent de libellé à chaque montant de coût.
Nombres aléatoires et graines
- Graine aléatoire rend une exécution reproductible. Laissez-la vide pour obtenir une nouvelle séquence aléatoire à chaque fois.
- Dans Monte Carlo, chaque exécution tire sa propre graine à partir de la graine de l'étude. Vous pouvez donc rejouer n'importe quelle exécution en mode Événements discrets avec Rejouer dans l'onglet Exécutions (ou Afficher l'exécution pour une exécution en échec).
Math.random()dans les scripts utilise le même générateur initialisé par la graine.
La page du simulateur
En-tête de page et barre d'exécution
La barre sous l'en-tête de la page contient, de gauche à droite, l'Action racine, les commandes d'exécution du mode (ci-dessous), Paramètres et le sélecteur de mode. Avant la première exécution, la page affiche une ligne d'explication et le diagramme d'Action ; les cartes de résumé (Statut, Temps total, Coût total, ou celles de Monte Carlo) apparaissent avec la première exécution.
- Action racine : l'action dont le flux s'exécute. La liste affiche chaque Action dotée d'un flux d'action. Une action qui n'en a pas apparaît comme « (aucun flux) ». Choisir une autre racine rouvre la page pour celle-ci.
- Événements discrets / Monte Carlo : le mode. Changer de mode conserve les paramètres de chaque mode.
- En-tête de page : Résultats enregistrés ▾ (les exécutions enregistrées, ou « Aucune exécution enregistrée pour l'instant. Chaque exécution terminée est enregistrée ici. ») et Ouvrir l'Action Diagram.
Paramètres
Paramètres affiche ou masque les paramètres d'exécution sous la barre (masqués au départ ; le choix est mémorisé dans ce navigateur). Son info-bulle liste les paramètres actuels, par exemple « décisions automatiques, vitesse 100×, durées fixes, graine 42 ».
| Réglage | Mode | Valeurs | Par défaut |
|---|---|---|---|
| Exécutions | Monte-Carlo | 1 à 20 000 | 100 |
| Décisions | Événements discrets | Automatique (sans script), Demander (sans script) | Automatique (sans script) |
| Vitesse | Événements discrets | 1×, 10×, 100×, 1 000×, 10 000×, 100 000× (secondes simulées par seconde réelle) | 100× |
| Faire varier les durées fixes | Les deux (conservé séparément pour chaque mode) | Aucune, Uniforme ±%, Triangulaire ±% | Aucun |
| ± % | Les deux | 0 à 100 | 10 |
| Graine aléatoire | Les deux | Un nombre, ou vide pour une graine aléatoire | vide |
| Dates calendaires | Événements discrets | Démarrer l'horloge à la date Start de l'Action racine ; les Actions dotées d'un Start l'attendent | désactivés |
| Démarrer en pause (pas à pas) | Événements discrets | Crée l'exécution à l'ouverture de la page, prête pour ⏭ Pas | désactivés |
- Les paramètres sont enregistrés avec l'action racine dans le projet à mesure que vous les modifiez, et s'appliquent à toute personne qui l'ouvre. Chaque modification peut être défaite par une seule annulation. Ils sont aussi mémorisés dans ce navigateur pour les autres actions racines.
- Rétablir les valeurs par défaut (après « Les paramètres sont enregistrés avec cette Action. ») rétablit les valeurs par défaut et efface les choix d'entités des graphiques.
- Les lecteurs peuvent modifier les paramètres pour leurs propres exécutions ; ils ne sont pas enregistrés dans le projet.
Commandes Événements discrets
- ▶ Lecture / ⏸ Pause : animent l'exécution à la vitesse choisie. Les longues périodes sans événement sont franchies d'un coup.
- ⏭ Pas : avance jusqu'à l'événement suivant.
- ⏩ Exécuter jusqu'à la fin : exécute jusqu'à la fin sans animation. S'arrête quand même pour les questions.
- ⟲ Réinitialiser : abandonne l'exécution.
- Horloge : le temps simulé actuel (une date et une heure dans Dates calendaires).
Commandes Monte Carlo
- ▶ Exécuter Monte Carlo, Annuler, la barre de progression et le texte de progression.
- Contrôler par rapport à une exigence… (activé après une étude comportant des exécutions terminées).
- Toute exécution peut être rejouée ou téléchargée sous forme de planning MS Project depuis l'onglet Exécutions.
Notes au-dessus des panneaux
Les avis qui demandent votre attention, comme l'affichage de résultats enregistrés, restent visibles lorsque les paramètres sont masqués.
- « Variation uniforme de ±n % ajoutée aux durées fixes. » (ou triangulaire) lorsque la variation est activée.
- « Probabilités égales utilisées pour n constructions non spécifiées : … » après Utiliser des probabilités égales.
- L'encadré des exécutions en échec (Monte Carlo) et le bandeau de rejeu « Rejeu de l'exécution Monte Carlo n (blocage ou erreur) avec la graine s et les paramètres de l'étude. »
Panneaux
Les résultats occupent une disposition fixe : un bandeau de résumé en haut et des onglets en dessous. Chaque onglet contient deux colonnes de panneaux ; les panneaux larges (le diagramme, le Gantt, le journal des événements, Statistiques et Exécutions) occupent les deux. Avant une exécution, chaque panneau affiche sa description. L'onglet ouvert est mémorisé dans ce navigateur.
Menu des panneaux
Chaque panneau a un titre et un menu ⋯ :
- Télécharger les données… ouvre la boîte de dialogue Exporter avec les données du panneau : des fichiers CSV avec toutes les colonnes et, pour Actions dans le temps, aussi Planning (MS Project XML). Le nom du fichier est « <root> <panel title> ».
- Télécharger l'image… ouvre la boîte de dialogue Exporter avec <panel title> (PNG) (avec Arrière-plan transparent et Échelle) et <panel title> (SVG). Les images utilisent les couleurs du thème clair.
- Choisir les entités… (graphiques des coûts, des ressources et des assets) ouvre Choisir les entités : filtrez la liste par nom ou par numéro, cochez des entités (Toutes, Aucune) et cliquez sur Appliquer. Si aucune n'est cochée, le graphique affiche toutes les entités. Les graphiques des coûts ajoutent Afficher le total. Les couleurs suivent la palette du graphique dans l'ordre de la liste. Le choix est enregistré avec l'action racine.
Cliquez sur une entité dans un graphique, dans la liste Statut ou dans le journal des événements pour l'ouvrir dans l'inspecteur, avec sa fréquence et sa durée d'exécution.
Onglets Événements discrets
Bandeau de résumé : Statut, Temps total et Coût total.
| Onglet | Panneau | Montre | Données |
|---|---|---|---|
| — | Statut | Les actions en cours d'exécution avec leur progression. Jaune : en attente d'un Input/Output ; violet : d'une Resource ; orange : de capacité d'Asset. À la fin : Terminé à 100 %, Blocage ou Arrêté, avec le nombre d'exécutions d'actions et le temps total | — |
| — | Temps total | L'horloge de simulation (une date dans Dates calendaires, avec le temps écoulé) | — |
| — | Coût total | Le coût total cumulé et le nombre d'entités chiffrées | — |
| Chronologie | Action Diagram en cours d'exécution | Le diagramme d'Action racine, en lecture seule, avec les actions colorées pendant leur exécution (vert), leur attente (orange) et une fois terminées (gris) | — |
| Chronologie | Actions dans le temps | Un Gantt des actions exécutées ; les parties hachurées sont des attentes ; les actions décomposées sont des accolades sur lesquelles vous cliquez pour les replier (▸/▾) ; les exécutions répétées sont numérotées #2, #3 ; les barres rouges ont été arrêtées par l'expiration du délai d'un SYNC ; une ligne rouge en pointillés marque l'horloge. Outils : +, − (zoom), Réinitialiser, Masquer les flèches des lignes / Afficher les flèches des lignes, Masquer les couleurs des lignes / Afficher les couleurs des lignes | Chronologie (CSV), Planning (MS Project XML) |
| Coût | Coût dans le temps | Coût cumulé par entité choisie, plus le total | Coût dans le temps (CSV) |
| Coût | Coût par entité | Coût total par entité choisie (graphique à barres) | Coût par élément (CSV) |
| Resources | Niveaux des Resources dans le temps | Quantités des Resources choisies dans le temps | Niveaux des Resources dans le temps (CSV) |
| Resources | Quantités des Resources | Quantité initiale, minimale, maximale, finale, consommée et produite par Resource | Modifications des Resources (CSV) |
| Resources | Temps d'occupation des Assets | Occupation (%) par Asset exécutant, et unités utilisées (ou actions en cours) dans le temps | Utilisation des Assets (CSV) |
| Journal | Console | Sortie de print(), erreurs de script (avec numéros de ligne), avertissements et blocages | Console (CSV) |
| Journal | Journal des événements | Chaque événement du moteur : start, end, wait, resume, io, transfer, resource, decision, loop, exit, sync, killed, cost, deadlock, error | Journal des événements (CSV) |
| Journal | Variables de script | Variables globales de script (globals.put) avec leur valeur actuelle ; développez une valeur pour voir son historique | Valeurs globales (CSV) |
Pendant la lecture d'une exécution, seuls le bandeau de résumé et l'onglet ouvert sont redessinés ; les autres onglets se mettent à jour lorsque vous les ouvrez ou à la fin de l'exécution.
Onglets Monte Carlo
Bandeau de résumé : Exécutions terminées.
| Onglet | Panneau | Montre | Données |
|---|---|---|---|
| — | Exécutions terminées | Simulations terminées ; moyenne et écart-type de la durée et du coût. Les exécutions bloquées ou en erreur sont comptées à part et exclues | Synthèse Monte Carlo (CSV) |
| Distribution | Statistiques | Moyenne, IC à 95 % de la moyenne, écart-type, minimum, P5, médiane (P50), P95 et maximum de la durée, du coût et de chaque variable globale numérique de script (exécutions terminées uniquement) | — |
| Distribution | Distribution des durées | Histogramme de la durée totale par exécution | Durées des exécutions (CSV) |
| Distribution | Distribution des coûts | Histogramme du coût total par exécution (« Aucune exécution n'a eu de coûts. » en l'absence de coûts) | Coûts des exécutions (CSV) |
| Distribution | Probabilité cumulée (courbe en S) | La distribution cumulée d'une sortie choisie, avec un champ x et la lecture P(X ≤ x) | — |
| Facteurs | Temps par Action | Durées cumulées des actions sur toutes les exécutions | Durées des actions (CSV) |
| Facteurs | Coût par Action | Coût cumulé par action ou par asset sur toutes les exécutions | Coûts des actions (CSV) |
| Facteurs | Combinaisons de branches | Chaque combinaison de branches OR, avec Exécutions et Part | Combinaisons de branches (CSV) |
| Resources | Niveaux des Resources | Quantité minimale, maximale et finale moyenne par Resource | Resources sur l'ensemble des exécutions (CSV) |
| Resources | Temps d'occupation des Assets | Occupation (%) moyenne par Asset exécutant (un graphique à barres avec moins de trois assets) | Utilisation des Assets sur les exécutions (CSV) |
| Exécutions | Exécutions | Chaque exécution avec Exécution, Graine, Résultat (Completed, Deadlock, Error), Durée et Coût. Cliquez sur un en-tête de colonne pour trier (à nouveau pour inverser). P10, P50 et P90 sélectionnent l'exécution située à ce point de la distribution des durées et la mettent en évidence. Rejouer la relance en mode Événements discrets avec sa graine ; MS Project la télécharge sous forme de planning MS Project XML, « <root> run <n>.xml ». Les 500 premières exécutions sont listées | Exécutions (CSV) (chaque exécution : graine, résultat, durée, coût, chemin, variables globales) |
Les messages de console de chaque exécution ne sont pas conservés dans une étude ; Rejouer une exécution permet de les voir.
Scripts
Les scripts sont des hooks JavaScript sur les Actions, OR, SYNC et LOOP. Utilisez-les lorsque le diagramme seul ne peut pas exprimer un comportement, comme une décision fondée sur le niveau d'une ressource.
Pour écrire un script :
- Dans le diagramme d'Action, sélectionnez l'élément.
- Dans l'inspecteur, cliquez sur Modifier le script… (pour une action), ou sur Modifier le script… / Ajouter un script… dans les panneaux OR, SYNC et LOOP.
La boîte de dialogue de l'éditeur s'ouvre, par exemple Script : Capture Image Strip ou Script OR : ….
- Cliquez sur Ajouter onStart(), Ajouter prompt(), Ajouter onEnd() ou Ajouter duration() pour insérer un hook vide.
- Écrivez le code. Tab insère deux espaces.
- Cliquez sur Enregistrer (ou sur Annuler).
Hooks
| Hook | Appelé | Valeur renvoyée |
|---|---|---|
onStart() | Au démarrage de l'action ou de la construction | — |
prompt(p) | Après onStart, pour construire une boîte de dialogue de saisie | — (remplir p) |
onEnd(response) | À la fin d'une action ; pour un OR lorsqu'il décide ; pour une LOOP avant chaque passage | OR : le nom ou l'indice de la branche. LOOP : true pour continuer, false pour arrêter, ou un nombre de passages supplémentaires |
duration() | Lorsque la durée de l'action vaut =script() | La durée dans l'unité de la durée |
response contient les réponses de la boîte de dialogue, indexées par nom de saisie.
Avec Automatique (sans script), et dans Monte Carlo, la question n'est pas affichée. Les valeurs par défaut sont utilisées à la place : la valeur d'un nombre ou 0, la valeur d'une case à cocher, ou le premier choix.
Constructeur de questions
p.setTitle(text): le titre de la boîte de dialogue (par défaut « Saisie pour <name> »).p.addEnumInput(title, name, choices, default): une liste de choix.p.addTextInput(title, name, default),p.addBigtitleTextInput(title, name, default)(multiligne),p.addNumberInput(title, name, default),p.addBooleanInput(title, name, default)(case à cocher).
La boîte de dialogue indique « Simulation en pause à <time>. » et se ferme avec OK.
Disponible dans les scripts
print(x, …): écrit dans la console. Les objets s'affichent en JSON.globals.put(key, value),globals.get(key): des valeurs suivies dans le temps dans les variables de script. Les variables globales numériques deviennent des sorties Monte Carlo (Global : key) dans Statistiques, la courbe en S et Contrôler par rapport à une exigence….Sim.getEntityById(id),Sim.getEntityByGlobalId(id),Sim.getEntityByName(name),Sim.getEntityByNumber(number),Sim.getEntitiesByName(name),Sim.getEntitiesByNumber(number): renvoient des enveloppes d'entités.- Propriétés :
id,name,number,description,className. - Méthodes :
getId(),getGlobalId(),getName(),getNumber(),getDescription(),getAttribute(name)(par nom d'attribut, sans tenir compte de la casse) etattributes().get(name).
- Propriétés :
Sim.getIOValueById(id),Sim.getIOValueByGlobalId(id),Sim.getIOValueByName(name),Sim.getIOValueByNumber(number): l'attribut Valeur d'un Input/Output.Sim.getAmount(name),Sim.getAmountById(id),Sim.getAmountByGlobalId(id): la quantité actuelle d'une Resource.Sim.getResourceByName(name)renvoie{id, name, amount, units}.Sim.setResourceById(id, value),Sim.setResourceByGlobalId(id, value),Sim.setResourceByName(name, value): définissent la quantité d'une Resource (consigné comme modification par script).Sim.getCurrentTime()(millisecondes depuis le début) etSim.getCurrentCost().
Chaque script est compilé une fois par exécution, si bien que les variables de premier niveau conservent leurs valeurs d'un passage de boucle à l'autre. Le modèle est en lecture seule pour les scripts, sauf pour les quantités des ressources.
Exemple : choisir une branche d'après la charge de la batterie
function onEnd() {
const wh = Sim.getAmount('Battery Charge');
globals.put('Battery at decision', wh);
return wh > 40 ? 'Yes' : 'No';
}
Placez ceci sur le OR Contact in view? avec le Type de décision Script. Les noms des branches doivent être Yes et No.
Bac à sable et confiance
- Chaque exécution a lieu dans un bac à sable séparé avec une copie du modèle en lecture seule. Les scripts n'ont accès ni à la page, ni aux autres projets, ni aux fichiers, ni au stockage du navigateur, ni au réseau.
- Un appel de script qui dure plus de 8 secondes arrête l'exécution : « Le script de <name> a duré plus de 8 s et a été arrêté. Vérifiez qu'il ne contient pas de boucle sans fin. »
- Les scripts que vous écrivez ou approuvez dans ce navigateur sont considérés comme fiables.
Une exécution peut inclure des scripts venus d'ailleurs, comme un fichier importé ou les modifications d'un autre membre. Avant une telle exécution, Holarch vous demande de les approuver. La question apparaît avant ▶ Lecture, ⏭ Pas, ⏩ Exécuter jusqu'à la fin et ▶ Exécuter Monte Carlo.
- Lancez l'exécution.
La boîte de dialogue Exécuter des scripts d'un autre auteur ? indique combien de scripts il y a. Elle précise que les scripts s'exécutent dans un bac à sable sans accès à vos projets, à vos fichiers ni au réseau.
- Ouvrez Afficher les scripts pour les examiner.
- Cliquez sur Exécuter les scripts pour les exécuter, ou sur Annuler.
Une fois que vous avez cliqué sur Exécuter les scripts, ces scripts sont considérés comme fiables dans ce navigateur.
Clavier et souris
| Action | Effet |
|---|---|
| Cliquer sur une barre de Gantt, un point de graphique, une cellule de carte proportionnelle ou une ligne de statut | Ouvre l'entité dans l'inspecteur |
| Cliquer sur le libellé d'une ligne de Gantt décomposée | Replie ou déplie ses enfants |
| Tab dans l'éditeur de script | Insère deux espaces |
Messages
| Message | Signification et correction |
|---|---|
| « Aucune Action à simuler » / « Donnez des Actions enfants à une Action et dessinez leur flux dans son Action Diagram. » | Le projet n'a aucune Action dotée d'un flux |
| « Erreur de simulation » avec des détails | L'exécution n'a pas pu démarrer ou le bac à sable a échoué ; lisez les détails |
| « L'Action racine n'existe plus. Choisissez une autre Action racine. » | La racine a été supprimée |
| « Erreur de script dans <name> (<hook>) : <message> » | Un script a levé une exception ; l'exécution s'arrête. La console indique le numéro de ligne |
| « <name> : le script a renvoyé “x”, qui ne correspond à aucune branche ; branche choisie au hasard. » | Un script de OR a renvoyé un nom de branche inconnu |
| « <name> : plus de 10000 itérations — vérifiez la condition de la LOOP. » | Une LOOP ne s'arrête jamais |
| Boucles sans fin (avant une exécution) | Aucun EXIT ne peut terminer une boucle qui se répète à 100 % (Action.19). Corrigez-la, ou choisissez Exécuter quand même. |
| « Une hiérarchie infinie existe (A → B → A). Retirez l'un de ces liens de décomposition dans le diagramme. » | Une action est décomposée en elle-même |
| « Simulation interrompue : trop d'étapes (vérifiez les nombres de LOOP ou une décomposition récursive). » | Plus de 20 000 exécutions d'actions dans une exécution |
| « Simulation interrompue : limite d'événements atteinte. » | Plus de 500 000 événements dans une exécution |
| « Blocage : <action> en attente de l'I/O <name> (jamais générée) » | Une I/O déclencheur n'a jamais été générée |
| « Blocage : <action> en attente de <amount> <resource> (jamais disponible) » / « en attente de capacité d'Asset : … » | Une ressource ou une capacité n'est jamais devenue disponible |
| « L'Asset <name> a plus d'un parent ; le premier est utilisé pour sa capacité. » | La capacité de l'asset provient de la multiplicité du premier parent |
| « <I/O> est transporté par plusieurs Conduits ; le simulateur a utilisé <conduit>. » | Seul le délai du premier Conduit s'applique |
| « Les scripts de simulation n'ont pas accès au réseau (Sim.httpGet, httpPost et httpPut ne sont pas disponibles). » | Les scripts ne peuvent pas appeler le réseau |
| « Aucune entité trouvée avec le nom : <name> » / « Aucune ressource trouvée avec l'identifiant : <id> » | Une recherche Sim n'a rien trouvé |
| « Les scripts de simulation ne peuvent pas compiler de code pendant l'exécution. » / « Les scripts de simulation ne peuvent pas utiliser import(). » | Un script a tenté de créer ou de charger du code |
| « Le script de <name> a duré plus de 8 s et a été arrêté. Vérifiez qu'il ne contient pas de boucle sans fin. » | Chien de garde des scripts |
| « La simulation ne répondait plus et a été arrêtée. » | Le bac à sable a cessé de répondre en dehors d'un script |
| « Exécution Monte Carlo arrêtée » | Vous avez cliqué sur Annuler |
| « n exécutions sur N ont échoué (d bloquées, e en erreur). P(échec) = … » | Les exécutions en échec sont exclues des statistiques ; utilisez Afficher l'exécution |
| « Aucune exécution terminée. Lancez d'abord Monte Carlo. » | Contrôler par rapport à une exigence… nécessite des exécutions terminées |
| « Saisissez une valeur de seuil, ou choisissez une Measure. » / « Saisissez d'abord une valeur de seuil. » | Le contrôle n'a pas de valeur |
| « <Measure> n'a pas de valeur de seuil numérique. Saisissez le seuil. » | Le seuil ou l'objectif de la Measure n'est pas un nombre |
| « Choisissez une Measure ou une Requirement pour consigner le résultat. » | Consigner le résultat… nécessite une cible |
| « Sélectionnez au moins une modification. » | Toutes les lignes de Consigner le résultat sont décochées |
| « Résultat enregistré » | La Measure et le Test Case ont été mis à jour |
| « La probabilité requise se trouve dans l'intervalle de confiance. Exécutez davantage d'itérations pour un verdict plus sûr. » | Le verdict pourrait changer avec davantage d'exécutions |
| « Impossible de lire les résultats enregistrés : <reason>. Relancez la simulation. » | Le fichier .sim enregistré est absent ou non valide ; cliquez sur Exécuter de nouveau |
| « Ce panneau concerne l'autre mode de simulation. » | Un panneau de l'autre mode |
| « Lecture seule : demandez un accès en modification à un propriétaire. » | Les lecteurs peuvent lancer des simulations, mais ne peuvent pas enregistrer de paramètres, de résultats ni de contrôles consignés |
Limites
- Monte Carlo : de 1 à 20 000 itérations par étude.
- Une exécution : au plus 20 000 exécutions d'actions, 500 000 événements et 10 000 passages d'une même LOOP.
- Appels de script : 8 secondes chacun.
- Tableau des exécutions en échec : les 50 premières exécutions en échec sont listées. Exécutions ⋯ → Télécharger les données… → Exécutions (CSV) liste toutes les exécutions.
- Onglet Exécutions : les 500 premières exécutions sont listées ; Exécutions (CSV) les contient toutes.
- Les statistiques Monte Carlo n'utilisent que les exécutions terminées.
- Seul le premier Conduit qui transfère une I/O détermine son délai ; seul le premier parent détermine la capacité d'un asset.
Voir aussi
- Guide : La simulation Monte Carlo en ingénierie système, des estimations ponctuelles aux probabilités.
- Diagrammes d'Action : construire le flux, les constructions, les I/O, les ressources et les scripts.
- Analyse fonctionnelle : dériver les fonctions et le flux à partir des exigences.
- Simulateur, Scripts de simulation et Simuler et contrôler par rapport à une exigence dans l'Aide.
- Types d'attributs et distributions et Mettre en place la vérification, exécuter la suite et produire la RVTM.