Holarch

SysML v2

Bien démarrer avec les projets SysML v2

Choisissez entre un projet LML et un projet SysML v2, créez un projet SysML v2 ou une démo, écrivez un premier modèle et repérez-vous dans l'application.

Utilisation →

Sur cette page
  1. Vue d'ensemble
  2. Concepts
    1. Deux types de projets
    2. Le modèle et le texte ne font qu'un
    3. Données du modèle et données Holarch
    4. Définitions et usages
  3. Mode d'emploi
    1. Choisir un type de projet
    2. Créer un projet SysML v2
    3. Ouvrir la démo Hybrid Car
    4. Ouvrir la démo Hybrid Car Battery Pack
    5. Ouvrir la démo Earth Observation Satellite
    6. Écrire votre premier modèle
    7. S'orienter
  4. Exemple détaillé : explorer la Hybrid Car
  5. Conseils et erreurs courantes
  6. Le rail dans les projets SysML v2
  7. Mode simple
    1. L'activer ou le désactiver
    2. Ce qu'il affiche
    3. Tout afficher
  8. Accueil
  9. Demander à l'IA
  10. Pas encore disponible
  11. Messages
  12. Limites
  13. Pages associées

Vue d'ensemble

Holarch prend en charge les projets SysML v2. Un projet SysML v2 contient un modèle, écrit dans la notation textuelle SysML v2 et fondé sur la spécification OMG SysML v2.

Vous écrivez le modèle sous forme de texte dans l'Éditeur. Holarch conserve le même modèle sous forme d'éléments : packages, définitions, usages et relations. Le Navigateur, les vues et les pages du cycle de vie (exigences, vérification, interfaces, risques, planification) affichent tous ces mêmes éléments.

Cette page explique les deux types de projets, comment démarrer un projet SysML v2 et où se trouvent les choses. Le langage lui-même est décrit dans Notation textuelle SysML v2. L'éditeur et le navigateur sont décrits dans L'éditeur de texte et le navigateur.

Concepts

Deux types de projets

Chaque projet Holarch est soit un projet LML, soit un projet SysML v2. Vous choisissez le type lors de la création du projet. Il reste fixe : un projet ne change de type que par une copie convertie (voir Convertir entre LML et SysML v2).

LMLSysML v2
À quoi il sertModéliser un système dans le Lifecycle Modeling Language : exigences, fonctions, architecture physique, interfaces, tests, risques et calendrier. Holarch vérifie votre travail à chaque étape.Construire un modèle dans le langage SysML v2, sous forme de texte, avec les concepts standard de SysML v2 : packages, définitions et usages, ports, connexions, actions, états et exigences.
Comment construire le modèleLa base de données, des formulaires et plus de 30 types de diagrammes.Du texte dans l'éditeur, plus les vues et les pages du cycle de vie, qui écrivent dans le même texte.
Ce que vous pouvez échangerImports Word, Excel, CSV, ReqIF et XMI ; exports Word, Excel et de diagrammes ; fichiers de projet.Texte SysML v2 (.sysml) et JSON SysML v2 (voir Échanger des modèles SysML v2) ; imports SysML v1 depuis XMI et des fichiers Cameo ou MagicDraw .mdzip (voir Importer des modèles SysML v1) ; fichiers de projet.

En cas de doute, choisissez LML. Il dispose de toutes les pages et de tous les diagrammes de Holarch, et convient aux personnes qui découvrent le MBSE. Choisissez SysML v2 lorsque votre équipe modélise déjà en SysML v2 ou échange des modèles avec des outils SysML v2.

Le modèle et le texte ne font qu'un

Un projet SysML v2 ne contient aucun fichier. Le modèle est un ensemble d'éléments, et l'éditeur affiche un document texte par package de premier niveau. Lorsque le texte est analysé sans erreur, Holarch l'applique au modèle. Lorsque vous modifiez le modèle ailleurs (une vue, un tableau, l'inspecteur), le texte change avec lui. Voir Le texte et les vues restent synchronisés.

Données du modèle et données Holarch

Certaines informations font partie du texte SysML ; d'autres sont conservées par Holarch à côté du modèle.

  • Dans le texte : noms des éléments, noms courts (numéros d'exigences), documentation, types, multiplicités, valeurs, et relations telles que satisfy, verify, perform et connect.
  • À côté du modèle (données Holarch) : statut et approbations des exigences, résultats de vérification, étiquettes, personnes assignées, échéances, commentaires de discussion, dispositions des vues, paramètres du simulateur, budgets, risques, décisions et tâches. Ces données sont liées aux éléments du modèle par leur identité, de sorte que les liens survivent aux renommages et aux déplacements.

Les données Holarch ne sont pas écrites dans le texte SysML et ne font pas partie d'un export .sysml.

Définitions et usages

La plupart des mots-clés SysML v2 existent sous deux formes. Une définition (part def Wheel;) décrit un type de chose. Un usage (part frontWheel : Wheel;) est une utilisation d'une définition à l'intérieur d'un autre élément. Le même schéma vaut pour port def/port, action def/action et requirement def/requirement. Notation textuelle SysML v2 l'explique en détail.

Mode d'emploi

Choisir un type de projet

Choisissez le type avant de créer le projet.

  1. Choisissez LML pour utiliser la méthode Holarch complète : la base de données, les diagrammes LML et des contrôles guidés à chaque étape.
  2. Choisissez SysML v2 lorsque le modèle doit être du texte SysML v2, par exemple pour l'échanger avec un autre outil SysML v2.
  3. Pour essayer d'abord SysML v2, ouvrez la démo Hybrid Car (deux procédures plus loin) au lieu d'un projet vierge.

Créer un projet SysML v2

  1. Ouvrez Gérer les projets et cliquez sur + Nouveau projet.
  2. Sous Comment allez-vous modéliser ce système ?, choisissez SysML v2.
  3. Saisissez un nom et cliquez sur Créer le projet.

Le projet s'ouvre sur l'Accueil. La pastille SysML v2 s'affiche à côté du nom du projet dans la barre supérieure et dans Gérer les projets. Un nouveau modèle est vide : Prochaines actions sur l'Accueil indique Écrire le premier package dans l'éditeur.

Ouvrir la démo Hybrid Car

La démo Hybrid Car est un modèle SysML v2 complet à explorer et à modifier.

  1. Ouvrez Gérer les projets.
  2. Cliquez sur Fichiers de projet ▾ → Nouveau projet de démonstration → Hybrid Car (SysML v2).

Holarch crée le projet Hybrid Car (SysML v2 demo) et l'ouvre sur l'Accueil. Cliquez sur Éditeur dans le rail pour lire le texte. Le modèle comporte six packages de premier niveau : Vehicles, VehicleRequirements, VehicleBehavior, VehicleViews, HolarchFrameworks et HybridCarArchitecture. Chacun est un document de la liste Packages de l'éditeur.

La démo est votre propre copie. Modifiez-la librement, ou créez-la à nouveau pour repartir de zéro.

Pour ouvrir la démo à partir d'un lien, utilisez https://app.holarch.app/#/?demo=hybrid. Le lien construit la démo et l'ouvre ; sur l'application hébergée, elle s'ouvre après votre connexion.

Ouvrir la démo Hybrid Car Battery Pack

La démo Hybrid Car Battery Pack représente la batterie de traction de la voiture telle que son fournisseur la modélise, dans un projet distinct. Si la démo Hybrid Car figure aussi dans vos projets, créée avant ou après, trois exigences de la batterie sont liées aux exigences de batterie de la voiture (BP-1 à VR-3, BP-2 à VR-6, BP-3 à VR-5), de sorte que Gérer les projets → Carte de programme montre comment les deux projets sont reliés. Ces liens de démonstration fonctionnent avec toutes les offres.

  1. Ouvrez Gérer les projets.
  2. Cliquez sur Fichiers de projet ▾ → Nouveau projet de démonstration → Hybrid Car Battery Pack (SysML v2).

À essayer :

  • Valeurs calculées : dans l'éditeur, Pack::mass additionne les modules (12 cellules et un boîtier chacun), le système de gestion de la batterie, le boîtier de jonction, le refroidissement et l'enveloppe : 43 kg pour une limite de 48 kg, donc massMargin vaut 5 kg. Pack::capacity additionne les 120 cellules : 1,44 kWh pour 1,4 kWh requis. Sélectionnez un attribut pour voir sa valeur dans l'inspecteur.
  • Vue paramétrique : ouvrez packParametrics. Les contrôles de capacité, de masse, de temps de charge et d'équilibrage des cellules sont chacun liés aux valeurs de la batterie et sont satisfaits.
  • RVTM : la capacité et la masse sont Réussies, l'acceptation de charge est Échouée (l'essai de charge à chaud a duré 34 minutes pour 30) et l'équilibrage des cellules n'a pas encore été exécuté. Chaque cas de vérification calcule son verdict à partir du modèle.
  • Simulateur : le simulateur s'ouvre sur pack avec Hot Day Charge. Cliquez sur Exécuter jusqu'à la fin, puis sur États : la charge passe à mi-puissance lorsque les cellules surchauffent et reprend une fois qu'elles ont refroidi. Choisissez Cell Over Voltage Fault sous Exécuter avec pour voir un arrêt de protection et la réinitialisation de service.

Ouvrir la démo Earth Observation Satellite

La démo Earth Observation Satellite est un modèle plus vaste : la mission EO-2, un satellite d'imagerie 12U avec son segment sol, en environ 3 000 lignes réparties sur 14 packages. Les données propres à Holarch sont renseignées par-dessus le modèle, de sorte que chaque page a quelque chose à montrer.

  1. Ouvrez Gérer les projets.
  2. Cliquez sur Fichiers de projet ▾ → Nouveau projet de démonstration → Satellite d'observation de la Terre (SysML v2).

Holarch crée le projet Earth Observation Satellite (SysML v2 demo) et ouvre l'Accueil. La démo compte 1 549 éléments, plus que les 1 000 éléments par projet de l'offre Free : avec l'offre Free, son entrée de menu est désactivée et indique Nécessite l'offre Individual (1 549 éléments). Le lien https://app.holarch.app/#/?demo=eosat la construit aussi. À essayer :

  • Documents : ouvrez EO-2 System Requirements Specification. Ses sections contiennent les exigences de EORequirements, des valeurs à jour et une matrice de vérification.
  • Budgets : la masse de l'imageur dépasse son allocation de 4,0 kg ; le TPM Imager Mass montre la tendance.
  • Liens à revoir et TBD/TBR : exigences modifiées et valeurs ouvertes à résoudre.
  • Simulateur : exécutez le passage d'imagerie depuis la vue imagingPassFlow.
  • Références : comparez la référence PDR Data Freeze avec le modèle actuel.
  • Vues : les modes du véhicule spatial, les vues d'interconnexion et la séquence de programmation des prises de vue.

Écrire votre premier modèle

Cette procédure construit un petit modèle de drone avec ce texte :

package Drone {
    private import ISQ::*;
    private import SI::*;

    part def Battery {
        attribute mass : MassValue = 0.4 [kg];
    }
    part def Quadcopter {
        part battery : Battery;
    }
}
  1. Ouvrez Modèle → Éditeur, cliquez sur + Nouveau package, saisissez Drone et confirmez. L'éditeur ouvre le texte du nouveau package.
  2. Saisissez les imports et les membres entre les accolades du package, comme ci-dessus.
  3. Arrêtez de taper. Après une courte pause, la ligne d'état sous le texte indique Appliqué. Le modèle contient désormais le package, les deux définitions de parties, l'attribut et la partie, et une seule annulation défait le tout.
  4. Ouvrez Modèle → Navigateur et dépliez Drone pour voir les mêmes éléments sous forme d'arborescence.

Si une ligne contient une erreur, la ligne d'état indique Non appliqué : corrigez la ligne N. Le modèle conserve son dernier état valide jusqu'à ce que le texte soit à nouveau analysé sans erreur. Voir Erreurs et brouillons.

S'orienter

Les projets SysML v2 conservent le rail du cycle de vie de Holarch. Chaque groupe travaille sur le modèle SysML v2.

  1. Commencez par l'Accueil pour voir ce qui demande votre attention, les groupes du cycle de vie et les prochaines actions.
  2. Utilisez Modèle → Éditeur pour écrire du texte et Modèle → Navigateur pour voir l'arborescence.
  3. Utilisez Besoins et exigences et Vérification pour les exigences, les cas de vérification et la traçabilité.
  4. Utilisez Comportement, Architecture et Interfaces pour les vues et les pages d'analyse.
  5. Ouvrez l'outil Diagrammes en bas du rail pour voir toutes les vues.
  6. Appuyez sur ⌘K / Ctrl+K pour trouver n'importe quel élément par son nom, son nom court, son nom qualifié (Vehicles::Car) ou le texte de sa documentation.
  7. Vous découvrez SysML v2 ? Activez le mode simple pour voir d'abord les éléments les plus utilisés.

Exemple détaillé : explorer la Hybrid Car

Ce parcours utilise la démo Hybrid Car.

  1. Créez la démo (voir Ouvrir la démo Hybrid Car). Elle s'ouvre sur l'Accueil. Ouvrez Modèle → Éditeur et choisissez Vehicles dans la liste Packages.
  2. Trouvez part def Car. Elle comporte les parties body, powertrain, frontAxle, rearAxle et spare : Wheel [0..1].
  3. Cliquez sur Powertrain dans part powertrain : Powertrain; en maintenant ⌘ / Ctrl. Le curseur saute à part def Powertrain, avec ses parties tank, engine, motor, battery, transmission et controller, et des interfaces telles que interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;.
  4. Pointez sur MassValue dans attribute mass : MassValue;. Une carte affiche son genre et son nom qualifié issu de la bibliothèque standard.
  5. Ouvrez Modèle → Navigateur. Saisissez sedan dans Filtrer par nom. L'arborescence affiche sedan sous fleet dans Vehicles. Sélectionnez-le : l'inspecteur affiche Kind part, Typed by Car et le nom qualifié Vehicles::fleet::sedan.
  6. Ouvrez l'Accueil. La carte Cycle de vie de Besoins et exigences compte les exigences du modèle ; À traiter affiche les liens à revoir, les TBD en retard et les risques élevés du modèle.
  7. Ouvrez Besoins et exigences → Exigences. Les lignes comprennent VR-1.1 sedanMass, un usage d'exigence dont le numéro est son nom court <'VR-1.1'>.
  8. Ouvrez l'outil Diagrammes et ouvrez driveCycleFlow, la vue de flux d'actions de DriveCycle. Renommez-y une action et revenez à l'éditeur : VehicleBehavior affiche le nouveau nom.

Conseils et erreurs courantes

  • Partez de la démo. Copier des motifs du texte de la Hybrid Car est le moyen le plus rapide d'apprendre la notation.
  • Importez les unités. 5 [kg] nécessite que SI soit visible (et MassValue nécessite ISQ). Ajoutez private import ISQ::*; et private import SI::*; au package.
  • Gardez un seul modèle par projet. Divisez un grand modèle en plusieurs packages de premier niveau ; chacun est un document distinct dans l'éditeur.
  • Choisir le mauvais type. Le type ne peut pas être changé sur place. Créez une copie convertie depuis Gérer les projets (⋯ → Créer une copie LML… ou Créer une copie SysML v2…).
  • S'attendre à trouver le statut dans le texte. Le statut des exigences, les résultats de vérification et les étiquettes sont des données Holarch. Ils n'apparaissent ni dans le texte ni dans un export .sysml.

Le rail dans les projets SysML v2

GroupePages
AccueilÀ traiter, Cycle de vie, Prochaines actions et les autres panneaux de l'Accueil
Besoins et exigencesDocuments, Exigences, Qualité, TBD/TBR, Liens à revoir, Approbations, Matrice de conformité*
ModèleÉditeur, Navigateur, Importer et exporter
ComportementAnalyse fonctionnelle, Flux d'actions, FFBD, Machines à états, Séquences, Simulateur
ArchitectureParties, Vues générales, Vues d'interconnexion, Hiérarchie, Budgets et TPM
InterfacesRegistre des interfaces, ICD, Diagrammes N², Éléments et E/S
VérificationRVTM, Cas de vérification, Dérogations et dispenses*, Matrice de traçabilité, Couverture du programme, Contrôles du modèle
Sécurité et fiabilité†Registre des dangers, AMDEC, Arbres de défaillances, Diagrammes de fiabilité
Risques, problèmes et décisionsRegistre des risques, Diagrammes de risques, Études de compromis, Décisions, Problèmes et actions
OffreMon travail, Processus IS, Gestion de projet, Graphiques, Tableaux blancs, Présentations
Contrôle et revuesDemandes de modification, Références et versions, Bibliothèques, Revues, Activité
Cadres d'architectureDoDAF, UAF

* Avec le programme formel activé. † Avec le programme Sécurité et fiabilité activé. Les deux s'activent dans Préférences du projet → Fonctions de programme.

Les outils du bas du rail sont les mêmes que dans les projets LML : Base de données, Diagrammes, Corbeille, Paramètres et Aide. Dans les projets SysML v2, Paramètres liste aussi la Bibliothèque standard. Les pages qui ne s'appliquent pas aux projets SysML v2 ne sont pas affichées.

Les pages sont décrites dans Vues SysML v2, Exigences et vérification dans les projets SysML v2, Évaluation, unités et analyse dans les projets SysML v2 et Fonctions de Holarch dans les projets SysML v2.

Mode simple

Le mode simple s'adresse aux personnes qui découvrent SysML v2. Il affiche les éléments par lesquels commencent la plupart des modèles, explique chacun en une phrase et masque le reste jusqu'à ce que vous le demandiez. Il ne change que ce que vous voyez : le modèle, son texte et chaque export restent identiques.

L'activer ou le désactiver

  • Préférences → SysML v2 → Mode simple.
  • Mode simple dans l'en-tête de page de Modèle → Navigateur (enfoncé lorsqu'il est activé).
  • ⌘K / Ctrl+K → Activer le mode simple ou Désactiver le mode simple.

Il est désactivé par défaut. Le réglage appartient à votre compte : il vous suit sur tout ordinateur où vous vous connectez, et le réglage du compte s'applique lorsque vous vous connectez. Réinitialiser les préférences ne le modifie pas.

La première fois que vous ouvrez un projet SysML v2, une note sous la barre du haut indique Vous découvrez SysML v2 ? Activez le mode simple pour voir d'abord les éléments les plus utilisés. Cliquez sur Activer pour activer le mode simple, ou sur × pour fermer la note. Les deux réponses sont conservées avec votre compte, et la note ne s'affiche plus. Tant que vous n'y répondez pas, elle s'affiche à chaque ouverture d'un projet SysML v2. Elle ne s'affiche pas lorsque le mode simple est déjà activé.

Ce qu'il affiche

Douze concepts, ceux que la démo Hybrid Car et les tutoriels utilisent le plus : package, partie, attribut, port, connexion et interface, action, flux et succession, état, transition, exigence, satisfy et vérification.

OùEn mode simpleMasqués jusqu'à Tout afficher
Vue générale, panneau AjouterPackage, Définition de part, Part, Définition de port, Port, Attribut, Définition d'interface, Définition d'action, Action, Définition d'exigence, Exigence, Cas de vérificationDéfinition d'attribut, Définition d'item, Définition d'énumération
Diagramme en araignée, panneau AjouterPackage, Définition de part, Part, Définition de port, Port, Attribut, Définition d'action, Action, État, Définition d'exigence, Exigence, Cas de vérificationDéfinition d'item, Item, Définition d'attribut, Cas d'utilisation
Vue d'interconnexion, panneau AjouterPart, PortItem
Vue des transitions d'état, panneau AjouterÉtat initial, État final, État, Action d'entrée, Action do, Action de sortieÉtat parallèle, Région
Vue de flux d'Action, panneau Ajouter et + Action ▾Action, Fork, Join, Décision, Merge, CouloirAccepter, Envoyer, Boucle, Terminer
Éditeur, Insérer ▾Package, Définition de part, Part, Attribut, Définition de port, Port, Interface, Connexion, Définition d'action, Action, Succession, Flux, Définition d'état, État, État initial, Transition, Définition d'exigence, Exigence, Satisfaire, Définition de vérification, VérifierTous les autres extraits qui conviennent à la position du curseur
Modèle → NavigateurPackages, définitions, usages, connexions, flux, transitions, exigences, satisfy et verifyImports, alias, expositions, commentaires, documentation, métadonnées, packages de bibliothèque, connecteurs de liaison, éléments de niveau KerML, et les lignes de déclencheur et d'effet d'une transition

Pointez sur un élément d'un panneau Ajouter, ou sur le type d'une ligne du Navigateur, pour lire une explication de cet élément en une phrase.

Les vues des exigences, des cas d'utilisation, paramétrique, de séquence, des packages et géométrique, ainsi que les panneaux Hiérarchie, Arborescence, IDEF0 et FFBD, gardent tous leurs éléments : chacun porte sur le type qu'il ajoute. + Nouveau diagramme, les tableaux, la recherche, l'inspecteur et la saisie dans l'éditeur (avec complétion) ne sont pas filtrés.

Tout afficher

  • Panneaux Ajouter : Tout afficher (n de plus) sous les éléments ; Afficher moins les masque de nouveau.
  • + Action ▾ : Tout afficher… à la fin rouvre le menu avec tous les types.
  • Insérer ▾ : cochez Tout afficher dans son en-tête.
  • Navigateur : cochez Tout afficher dans la barre de filtre.

Tout afficher dure jusqu'à ce que vous rechargiez la page ou basculiez le mode simple, et le mode simple reste activé entre-temps. Dans le Navigateur, un élément que vous ouvrez depuis ailleurs (par exemple avec Afficher dans le navigateur dans l'inspecteur) est toujours affiché, avec ses propriétaires, même lorsque son type est masqué.

Accueil

Accueil est la même page que dans les projets LML (voir Accueil) : À traiter (liens à examiner, TBD en retard, tests en échec, dépassements de TPM, risques élevés, contrôles du modèle, état de l'enregistrement), une carte Cycle de vie par groupe du rail, et les panneaux tels que Prochaines actions, Jalon du processus IS et Jalons. Les nombres proviennent du modèle SysML v2 et des données Holarch associées. ✦ Rédiger la synthèse du projet n'est pas proposé dans les projets SysML v2.

  • Les groupes du rail affichent les mêmes badges de problèmes, et la page de présentation de chaque groupe liste ce qui est à traiter et ses chiffres.
  • + Ajouter un panneau → Contenu du modèle affiche Packages (avec le nombre de packages de premier niveau), Définitions, Usages, Relations et Exigences (n non satisfaites · n non vérifiées), éléments mal placés lorsque des éléments ont perdu leur propriétaire, et Modifications récentes : les dernières modifications du modèle (créé, modifié, déplacé, supprimé ou restauré) avec le type de l'élément et l'heure.

Demander à l'IA

Demander à l'IA répond aux questions sur le langage SysML v2 et sur l'utilisation de Holarch, à partir de l'Aide et de la documentation. Avec les offres Individual et Team, et avec votre propre clé d'IA ou celle de votre organisation, elle répond aussi aux questions sur le modèle ouvert et propose des modifications, qui s'ouvrent pour revue avant de s'appliquer. Voir Demander à l'IA.

Pas encore disponible

  • Commits sur main, tags et fusions via la Systems Modeling API : les autres outils commitent dans des branches de demande de modification, qu'un approbateur applique dans Holarch (voir L'API et MCP dans les projets SysML v2).
  • Modifier le langage : la bibliothèque standard est en lecture seule.

Notation textuelle SysML v2 liste en détail le langage pris en charge.

Messages

MessageSignification
Le modèle est videLe projet n'a aucun élément. Cliquez sur + Nouveau package, puis écrivez ses membres dans l'éditeur.
Non appliqué : corrigez la ligne N.Le texte comporte une erreur à la ligne N. Le modèle conserve son dernier état valide jusqu'à ce que le texte soit analysé sans erreur.
Lecture seule : demandez à un propriétaire l'accès en modification.Vous avez un accès en lecture au projet. Le texte et les pages sont en lecture seule.
Ce projet nécessite une version plus récente de Holarch.Une version plus récente de Holarch a enregistré le projet, et cette page est plus ancienne. Le projet s'ouvre en lecture seule, et la bannière en haut en explique la raison. Cliquez sur Recharger dans la bannière pour obtenir la nouvelle version.

Limites

  • Le type de projet est fixé à la création.
  • Un seul modèle par projet.
  • Un document texte de plus de 8 Mo n'est pas contrôlé ; divisez-le en plusieurs packages.

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