SysML v2
Métadonnées de simulation dans les projets SysML v2
La bibliothèque de métadonnées HolarchSimulation : comment un modèle SysML v2 porte les durées, probabilités de branche, nombres d'itérations, ressources, coûts et réglages de machines à états pour le simulateur, et comment les écrire et les déplacer.
Vue d'ensemble
Dans un projet SysML v2, les réglages du simulateur font partie du modèle. Ce sont des annotations de métadonnées du package de bibliothèque HolarchSimulation, que chaque projet SysML v2 charge. Un modèle qui les utilise reste du SysML v2 valide : les autres outils lisent les annotations comme des métadonnées ordinaires, et seul le simulateur leur donne un sens.
Une annotation se trouve soit à l'intérieur de l'élément qu'elle annote, soit nomme cet élément avec 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"; }
Concepts
Valeur nominale et distribution
La durée d'une étape est son attribut duration (ou un attribut typé DurationValue ou TimeValue). Sa valeur est la durée nominale que voient les autres outils et l'évaluation de Holarch. Une annotation de distribution sur cet attribut fait plutôt tirer la durée au sort par le simulateur :
action cruise {
attribute duration : ISQ::DurationValue = 1 [min] {
@HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
}
}
Quels réglages l'emportent
- Une annotation de distribution l'emporte sur la valeur propre de l'attribut.
- Une garde, une condition
ifou une condition de boucle que le modèle peut évaluer décide d'elle-même. Une Probability ou un LoopCount n'est utilisé que lorsqu'il ne le peut pas (un LoopCount compte toujours les passages). - Les réglages faits avant que les paramètres de simulation ne soient déplacés dans le modèle sont conservés comme données Holarch à côté du modèle. Ils l'emportent toujours, de sorte que les exécutions donnent les mêmes résultats, jusqu'à ce que vous les déplaciez (voir Déplacer les anciens réglages dans le modèle).
Deux simulateurs
La page du simulateur indique, à droite des réglages, quel simulateur exécute le modèle : Moteur SysML (le simulateur du Holarch Language Engine) ou Simulateur JavaScript. Les deux lisent les mêmes annotations. Les machines à états, les stimuli, les ressources issues de Resource, Consumes, Produces et Seizes, les coûts issus de Cost, et les autres annotations décrites sous Annotations qui nécessitent le moteur SysML ne s'exécutent qu'avec le moteur SysML.
Mode d'emploi
Quand et pourquoi
Écrivez les réglages de simulation dans le modèle lorsque le modèle est la référence de la conception : les nombres voyagent avec les fichiers .sysml, apparaissent dans les revues du texte et sont versionnés avec le reste du modèle. Utilisez-les pendant l'analyse d'un scénario opérationnel (chronologies, répartition des branches, utilisation des ressources) et avant de contrôler une exigence par rapport à une étude de Monte-Carlo.
Définir une durée, une probabilité ou un nombre de passages de boucle
- Sélectionnez l'étape, la succession, la décision, la boucle ou l'action
ifdans une vue de flux d'Action, dans le Navigateur ou dans l'éditeur. - Dans la section Simulation de l'inspecteur, définissez Durée (une valeur fixe ou une distribution), Probabilité (%), Itérations ou Probabilité de then (%).
- Holarch écrit l'annotation dans le modèle : Durée fixe la valeur de l'attribut à la moyenne et ajoute l'annotation de distribution (ou écrit
attribute duration : ISQ::DurationValuelorsque l'étape n'en a pas) ; Probabilité (%) écrit Probability ; Itérations écrit LoopCount. Chaque modification peut être défaite par une seule annulation et apparaît immédiatement dans le texte. - Videz un champ pour retirer son annotation.
Holarch contrôle chaque modification avec le vérificateur SysML avant de l'écrire. Une modification qui ajouterait une erreur n'est pas écrite, et un message indique le problème.
Écrire des annotations dans le texte
- Ouvrez l'éditeur.
- Ajoutez l'annotation à l'intérieur du corps de l'élément, sous la forme
@HolarchSimulation::Kind { field = value; }, ou après lui, sous la formemetadata HolarchSimulation::Kind about element { … }. - Pour Consumes, Produces et Seizes, nommez d'abord l'étape, puis la ressource :
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.
Déplacer les anciens réglages dans le modèle
Les projets dont les réglages de simulation ont été faits avant leur déplacement dans le modèle affichent Certains réglages de simulation de ce projet sont des données Holarch et ne font pas partie du modèle. au-dessus des réglages du simulateur.
- Cliquez sur Déplacer les paramètres de simulation dans le modèle….
- L'aperçu liste chaque réglage et l'annotation qui le remplace.
- Cliquez sur Déplacer dans le modèle. Tous les réglages sont déplacés, et une seule annulation défait le tout ; les exécutions donnent les mêmes résultats.
Simuler une machine à états
Les machines à états s'exécutent avec le moteur SysML.
- Ouvrez Comportement → Simulateur et choisissez comme Racine une définition d'état, ou une part qui présente des états.
- Facultatif : sous Exécuter avec, choisissez une action de scénario qui envoie des signaux à la part, par exemple TestDrive dans la démo.
- Sous Stimuli, cliquez sur + Ajouter un stimulus et définissez À (instant et unité), Signal et Vers (une machine, ou Toutes les machines qui l'acceptent).
- Appuyez sur ▶ Lecture, ⏭ Pas ou ⏩ Exécuter jusqu'à la fin. Machine à états en cours d'exécution allume les états actifs et marque la transition déclenchée ; l'onglet États affiche États au fil du temps et Transitions déclenchées.
- En Monte-Carlo, l'onglet États affiche Temps dans l'état et Nombre de transitions. Contrôler par rapport à une exigence… propose comme sorties le temps passé dans chaque état et sa part de l'exécution.
Dans une vue des transitions d'état, ▶ Simuler ouvre une barre avec ▶ Lecture, ⏭ Pas, ⏩ Exécuter jusqu'à la fin, Réinitialiser et Ouvrir dans le simulateur. L'exécution utilise les stimuli enregistrés dans le simulateur pour cette définition d'état.
Exemple commenté : la démo Hybrid Car
La démo Hybrid Car (Gérer les projets → Fichiers de projet ▾ → Nouveau projet de démonstration) utilise la bibliothèque :
- DriveCycle : la succession
toCruiseaprèsshifta une Probability de 70 ; la brancheelseprend les 30 % restants.cruisedure 1 min en nominal, tiré d'une distribution Triangular (45 s, 1 min, 2 min). - DrivenCar : la batterie du groupe motopropulseur est une Resource de 62 Wh ;
driveen Consumes 1,5 Wh et a un Cost de 0,4 USD par utilisation. - PowertrainStates : la transition
startElectrica une Probability de 80 pour sa garde ;accept when charge < 15passe en mode hybride lorsque la charge baisse ;accept after 30 [min]met fin à la recharge. - TestDrive : un scénario qui envoie
StartRequest, attend une heure, puis envoieStopRequestetPlugInàdemoCar. Exécutez Demo Car avec Test Drive pour voir le groupe motopropulseur changer d'état.
La démo se contrôle avec 0 diagnostic.
Conseils et bonnes pratiques
- Gardez une valeur nominale significative : fixez-la à l'espérance de la distribution, comme le fait l'inspecteur.
- Nommez les successions que vous annotez (
succession toCruise first …), afin que l'annotation soit facile à trouver dans le texte. - Préférez les conditions que le modèle peut évaluer aux probabilités ; utilisez Probability pour ce que le modèle ne décrit pas.
Erreurs courantes
- Une probabilité n'a aucun effet : la garde peut être évaluée ; c'est donc elle qui décide. L'inspecteur indique « S'évalue à vrai : toujours prise. » ou « S'évalue à faux : jamais prise. »
- Les probabilités des branches ne totalisent pas 100 % : les branches sans Probability se partagent le reste ; lorsque celles qui sont données dépassent 100 %, l'avertissement indique « Les probabilités des branches totalisent N %. Modifiez-les pour totaliser 100 %. »
- Une annotation de durée sur l'étape elle-même : les distributions se placent sur l'attribut de durée, pas sur l'action.
Liens avec le reste
- Évaluation, unités et analyse dans les projets SysML v2 : comment le simulateur lit les étapes, les successions et les durées.
- Simulation : la page du simulateur, ses panneaux et les statistiques de Monte-Carlo.
- Notation textuelle SysML v2 : les métadonnées et
aboutdans le texte.
Annotations
Distributions
Placez une distribution sur un attribut de durée. Les champs de position et d'échelle prennent une grandeur avec unité (45 [s], 2 [min]) ; les champs de forme prennent un nombre.
| Annotation | Champs | Signification |
|---|---|---|
| Normale | mean, sd | Loi normale. |
| Triangulaire | low, mode, high | Triangulaire, avec low ≤ mode ≤ high. |
| Uniforme | low, high | Uniforme entre low et high. |
| Exponential | mean | Exponentielle de moyenne donnée. |
| Gamma | shape, scale | Gamma ; la moyenne vaut shape × scale. |
| LogNormal | median, sigma | Le logarithme suit une loi normale autour du logarithme de la médiane. |
| Weibull | scale, shape | Weibull. |
| Beta | alpha, beta, scale | Bêta sur 0..1, multipliée par scale. |
| Poisson | mean, scale | Un nombre de moyenne donnée, multiplié par scale. |
| Binomial | trials, p, scale | Nombre de succès sur un nombre d'essais, multiplié par scale. |
Les durées tirées en dessous de zéro sont tirées de nouveau.
Entrées corrélées
Sans corrélation, chaque valeur tirée d'une distribution est indépendante des autres. Correlation fait varier deux d'entre elles ensemble :
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| Annotation | Sur | Signification |
|---|---|---|
Correlation coefficient | about a, b : deux attributs, chacun avec une distribution | La corrélation de rang (Spearman) de leurs valeurs, de -1 à 1. 0 signifie indépendantes, 1 les classe toujours de la même façon, -1 à l'opposé. |
- Chaque attribut garde sa propre distribution. Le simulateur réunit toutes les paires en une seule matrice de corrélation (une copule gaussienne) : la n-ième valeur tirée pour un attribut lors d'une exécution va avec la n-ième valeur de chaque attribut auquel il est corrélé.
- Les coefficients d'un groupe d'attributs corrélés doivent être compatibles : a fortement lié à b, b fortement lié à c, mais a opposé à c est impossible. Le contrôle signale un tel groupe ; affaiblissez l'un des coefficients.
- Les durées et les quantités (Consumes, Produces, Seizes) se corrèlent de la même façon. Une exécution avec la même graine donne les mêmes valeurs.
- Dans le simulateur, en mode Monte-Carlo avec le moteur SysML, Entrées corrélées liste les paires de la racine. Choisissez deux attributs et un coefficient et cliquez sur + Ajouter une corrélation, modifiez un coefficient, ou cliquez sur × pour en retirer une ; une seule annulation défait chaque modification. Après une étude, Atteint affiche la corrélation de rang des valeurs tirées par les exécutions.
ChargeStopdans la démo Hybrid Car corrèle l'attente d'un chargeur libre avec la durée de recharge (0,6).
Probabilités et nombres
| Annotation | Sur | Signification |
|---|---|---|
Probability percent | Une succession sortant d'une décision | Le poids de la branche. Les branches qui n'en ont pas se partagent le reste de 100. |
Une action if | La probabilité de la branche then lorsque la condition ne peut pas être évaluée. | |
| Une action de boucle | La probabilité de répéter après chaque passage. | |
| Une transition | La probabilité que sa garde soit vraie lorsque la garde ne peut pas être évaluée. | |
LoopCount count | Une action de boucle | Le nombre de passages ; il prime sur les conditions de la boucle. |
| LoopExit | Une succession vers done dans le corps d'une boucle | Termine toute la boucle, pas seulement le passage. |
Ressources et coûts
| Annotation | Sur | Signification |
|---|---|---|
Resource initial, minimum, maximum, unit | Un usage de part ou d'item | Une réserve d'une quantité. Si l'usage déclare attribute level : Real, le simulateur le maintient égal à la quantité, afin que les gardes puissent le lire. |
Consumes amount | about step, pool | Prélevé au début de l'étape. |
Produces amount | about step, pool | Ajouté à la fin de l'étape. |
Seizes amount | about step, pool | Prélevé au début de l'étape et restitué à la fin. |
Utilization amount | Un usage d'action perform | La part de la capacité de la part exécutante qu'occupe l'étape. |
Cost amount, rate, unit, label | Une étape ou une part exécutante | Un coût par utilisation (CostRate::perUse) ou par heure (CostRate::perHour). |
Annotations qui nécessitent le moteur SysML
| Annotation | Signification |
|---|---|
Transfer latency, capacity, per | Sur une connexion ou une interface : retarde les items et les signaux envoyés par son intermédiaire. |
Size size | Sur un item : sa taille pour les délais de transfert. |
Timeout limit | Sur un join : arrête les branches non terminées lorsque la limite expire. |
NotBefore time | Sur une étape : elle ne démarre pas avant ce temps d'exécution. |
| ForkTargets, JoinSources | Sur une transition entrant dans un état parallèle ou en sortant : les sous-états dans lesquels on entre, ou les sous-états qui doivent être actifs. |
History deep | Sur un état composite : y revenir reprend le sous-état actif au moment où il a été quitté. |
HostHook key, points | Réservé à Holarch : l'exécution se met en pause pour une saisie aux points listés. |
Le simulateur JavaScript lit Probability, LoopCount et les distributions.
Messages
| Message | Signification |
|---|---|
| Certains réglages de simulation de ce projet sont des données Holarch et ne font pas partie du modèle. | Des réglages plus anciens sont encore stockés à côté du modèle. Cliquez sur Déplacer les paramètres de simulation dans le modèle…. |
| Données Holarch datant d'avant le déplacement des paramètres de simulation dans le modèle ; elles l'emportent sur le modèle. | Affiché dans la section Simulation de l'inspecteur. Modifiez le champ pour l'écrire dans le modèle, ou déplacez tous les réglages depuis le simulateur. |
| Aucune durée dans le modèle. Définissez-en une ici (cela écrit attribute duration : ISQ::DurationValue), ou écrivez-la dans le texte. | L'étape n'a pas d'attribut de durée. |
| @Normal: sd must be greater than zero. Change sd. (sd doit être supérieur à zéro ; et messages semblables pour les autres distributions et paramètres) | Un paramètre de distribution manque ou est hors limites. Avec le moteur SysML, le contrôle du modèle le signale dans l'éditeur et le simulateur refuse de s'exécuter tant qu'il n'est pas corrigé. |
| @Normal: sd has another unit dimension than … (sd a une autre dimension d'unité que …) | Un paramètre de position ou d'échelle a d'autres unités que l'attribut, par exemple des mètres sur une durée. |
| @LoopCount does not apply to a part … (ne s'applique pas à une part) | L'annotation se trouve sur un type d'élément auquel elle ne s'applique pas. Déplacez-la ou supprimez-la. |
| metadata Consumes … about needs an action and a part or item annotated @Resource. (nécessite une action et une part ou un item annoté @Resource) | Les éléments après about ne sont pas du bon nombre ou du bon type. |
| A probability of N % is outside 0 to 100. (une probabilité de N % est hors de l'intervalle 0 à 100) | Saisissez un pourcentage de 0 à 100. |
| The branch probabilities of this decision add up to N %; the simulator scales them to 100 %. (les probabilités des branches totalisent N % ; le simulateur les ramène à 100 %) | Un avertissement : chaque branche a un poids et leur total n'est pas 100. |
| A correlation needs two different attributes …, … is not an attribute … ou … has no distribution, so nothing is drawn to correlate … (une corrélation nécessite deux attributs différents ; n'est pas un attribut ; n'a pas de distribution) | Une Correlation nomme deux fois le même attribut, quelque chose qui n'est pas un attribut, ou un attribut sans distribution. |
| The coefficient N is outside -1 to 1. ou The correlation has no coefficient. (coefficient hors de -1 à 1 ; corrélation sans coefficient) | Saisissez un coefficient de -1 à 1. |
| “a” and “b” are already correlated; the first correlation is used. … (a et b sont déjà corrélés ; la première corrélation est utilisée) | Un avertissement : une seconde Correlation de la même paire est ignorée. Retirez l'une des deux. |
| The correlations of … contradict each other: no joint distribution has them … (les corrélations se contredisent : aucune distribution conjointe ne les possède) | Les coefficients d'un groupe ne peuvent pas coexister (la matrice n'est pas semi-définie positive). Affaiblissez-en un. Le simulateur refuse de s'exécuter tant que ce n'est pas corrigé. |
| Blocage à <time> : N étapes attendent quelque chose qui n'arrive jamais. | Affiché au-dessus des résultats avec le moteur SysML, avec chaque étape en attente. Un accept sans émetteur, un item jamais produit ou une ressource jamais libérée arrête l'exécution. |
Limites
- Les durées s'écrivent en secondes, minutes, heures ou jours (
SI::s,SI::min,SI::h,SI::d). Les millisecondes s'écrivent en secondes ; les semaines, les mois et les années en jours. - Les machines à états, les stimuli et Exécuter avec nécessitent le moteur SysML.
- Les entrées corrélées nécessitent le moteur SysML ; le simulateur JavaScript tire chaque valeur de façon indépendante. Au plus 200 attributs peuvent être corrélés dans un même groupe.
- Le contrôle des coefficients contradictoires couvre les corrélations écrites dans un même espace de noms ; le simulateur contrôle toutes les corrélations de l'exécution.
Voir aussi
SysML® et OMG® sont des marques déposées d'Object Management Group, Inc. aux États-Unis et dans d'autres pays.