Holarch

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.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Valeur nominale et distribution
    2. Quels réglages l'emportent
    3. Deux simulateurs
  3. Mode d'emploi
    1. Quand et pourquoi
    2. Définir une durée, une probabilité ou un nombre de passages de boucle
    3. Écrire des annotations dans le texte
    4. Déplacer les anciens réglages dans le modèle
    5. Simuler une machine à états
    6. Exemple commenté : la démo Hybrid Car
    7. Conseils et bonnes pratiques
    8. Erreurs courantes
    9. Liens avec le reste
  4. Annotations
    1. Distributions
    2. Entrées corrélées
    3. Probabilités et nombres
    4. Ressources et coûts
    5. Annotations qui nécessitent le moteur SysML
  5. Messages
  6. Limites
  7. Voir aussi

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 if ou 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

  1. Sélectionnez l'étape, la succession, la décision, la boucle ou l'action if dans une vue de flux d'Action, dans le Navigateur ou dans l'éditeur.
  2. Dans la section Simulation de l'inspecteur, définissez Durée (une valeur fixe ou une distribution), Probabilité (%), Itérations ou Probabilité de then (%).
  3. 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::DurationValue lorsque 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.
  4. 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

  1. Ouvrez l'éditeur.
  2. 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 forme metadata HolarchSimulation::Kind about element { … }.
  3. 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.

  1. Cliquez sur Déplacer les paramètres de simulation dans le modèle….
  2. L'aperçu liste chaque réglage et l'annotation qui le remplace.
  3. 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.

  1. Ouvrez Comportement → Simulateur et choisissez comme Racine une définition d'état, ou une part qui présente des états.
  2. Facultatif : sous Exécuter avec, choisissez une action de scénario qui envoie des signaux à la part, par exemple TestDrive dans la démo.
  3. 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).
  4. 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.
  5. 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 toCruise après shift a une Probability de 70 ; la branche else prend les 30 % restants. cruise dure 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 ; drive en Consumes 1,5 Wh et a un Cost de 0,4 USD par utilisation.
  • PowertrainStates : la transition startElectric a une Probability de 80 pour sa garde ; accept when charge < 15 passe 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 envoie StopRequest et PlugIn à 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

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.

AnnotationChampsSignification
Normalemean, sdLoi normale.
Triangulairelow, mode, highTriangulaire, avec low ≤ mode ≤ high.
Uniformelow, highUniforme entre low et high.
ExponentialmeanExponentielle de moyenne donnée.
Gammashape, scaleGamma ; la moyenne vaut shape × scale.
LogNormalmedian, sigmaLe logarithme suit une loi normale autour du logarithme de la médiane.
Weibullscale, shapeWeibull.
Betaalpha, beta, scaleBêta sur 0..1, multipliée par scale.
Poissonmean, scaleUn nombre de moyenne donnée, multiplié par scale.
Binomialtrials, p, scaleNombre 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; }
AnnotationSurSignification
Correlation coefficientabout a, b : deux attributs, chacun avec une distributionLa 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.
  • ChargeStop dans 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

AnnotationSurSignification
Probability percentUne succession sortant d'une décisionLe poids de la branche. Les branches qui n'en ont pas se partagent le reste de 100.
Une action ifLa probabilité de la branche then lorsque la condition ne peut pas être évaluée.
Une action de boucleLa probabilité de répéter après chaque passage.
Une transitionLa probabilité que sa garde soit vraie lorsque la garde ne peut pas être évaluée.
LoopCount countUne action de boucleLe nombre de passages ; il prime sur les conditions de la boucle.
LoopExitUne succession vers done dans le corps d'une boucleTermine toute la boucle, pas seulement le passage.

Ressources et coûts

AnnotationSurSignification
Resource initial, minimum, maximum, unitUn usage de part ou d'itemUne 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 amountabout step, poolPrélevé au début de l'étape.
Produces amountabout step, poolAjouté à la fin de l'étape.
Seizes amountabout step, poolPrélevé au début de l'étape et restitué à la fin.
Utilization amountUn usage d'action performLa part de la capacité de la part exécutante qu'occupe l'étape.
Cost amount, rate, unit, labelUne étape ou une part exécutanteUn coût par utilisation (CostRate::perUse) ou par heure (CostRate::perHour).

Annotations qui nécessitent le moteur SysML

AnnotationSignification
Transfer latency, capacity, perSur une connexion ou une interface : retarde les items et les signaux envoyés par son intermédiaire.
Size sizeSur un item : sa taille pour les délais de transfert.
Timeout limitSur un join : arrête les branches non terminées lorsque la limite expire.
NotBefore timeSur une étape : elle ne démarre pas avant ce temps d'exécution.
ForkTargets, JoinSourcesSur 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 deepSur un état composite : y revenir reprend le sous-état actif au moment où il a été quitté.
HostHook key, pointsRé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

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

SysML® et OMG® sont des marques déposées d'Object Management Group, Inc. aux États-Unis et dans d'autres pays.