DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


Panneau latéral

Traductions de cette page?:

Découvrir DokuWiki

Options avancées

Pour les entreprises

Notre Communautée


Suivez-nous sur Facebook, Twitter et les autres résaux sociaux.

Notre politique de confidentialité

fr:syntax

Ceci est une ancienne révision du document !


TopicsTools

Principe de fonctionnement

TopicsTools est un applicatif de la suite des outils généraux Tools.
Il qui permet d'avoir une vue d'ensemble de l'architecture de la simu à travers ses échanges inter modèles.

Interface

L'interface de TopicsTools est la suivante :

<imgcaption TopicsTools_MainView|TopicsTools main view></imgcaption>

A partir de cette interface, on initialise les différentes vues via l'action Open, disponible via :

  • le bouton “Browse”
  • le menue File/Open
  • le raccourci Ctrl + o

Il suffit de cibler un répertoire workspace d'une simulation et les différentes vues s'initialisent.
Il est possbible de passer d'une vue à l'autre par :

  • Les boutons de la barre d'action de la fenêtre principale
  • Le menu Views

Vue des échanges

<imgcaption TopicsTools_RelationshipsView|TopicsTools relationshpis view></imgcaption>

Cette vue permet de visualiser les échanges entre les typenames (lignes) et les modèles (colonnes).
Dans les cases on trouvent les informations suivantes :

  • Une case “R” indique que le typename de la ligne est consommé par le modèle de la colonnes
  • Une case “W” indique que le typename de la ligne est produit par le modèle de la colonne
  • Un tooltip indique la ralation entre le type et le modèle, ainsi que le fichier topic contenant le typename

Quand on sélectionne un typename, la ligne est entièrement sélectionnée, ainsi que tous les modèles (colonnes) avec lesquels le typename est en relation.

Vue Topic/Modèle

<imgcaption TopicsTools_SplitView|TopicsTools split view></imgcaption>

Cette vue se découpe en 2 parties :

  • Celle du haut liste l'ensemble des fichier topic
  • Celle du bas liste l'ensemble des modèles

Quand on double clique sur un fichier topic, on peut voir les informations sur les typenames déclarés : <imgcaption TopicsTools_TopicView|TopicsTools topic view></imgcaption>

Pour chacun des typename, on peut voir en vert les modèles consomateurs et en bleu, le (il est unique normalement) modèle producteur.

Lorsque l'on double clique sur un modèle, s'affiche les information sur les typename avec lesquels il est en relation :

  • Read : les typename en lecture
  • Write : les typenames en écriture

<imgcaption TopicsTools_ModelView|TopicsTools model view></imgcaption>

Vue de contôle

Cette vue permet de contrôler l'intégrité de la simulation dans son ensemble, et des configuration en particulier.
<imgcaption TopicsTools_CheckView|TopicsTools check view></imgcaption>

Elle se décompose en 4 sous vues :

  • La vue multi production

<imgcaption TopicsTools_MultiProd|TopicsTools multi productions></imgcaption>

Elle permet de vérifier qu'aucun typename ne soit produit par 2 modèles différents.
La production d'un typename doit être unique au sein d'une simulation !

  • La vue orphelins

<imgcaption TopicsTools_Orphans|TopicsTools orphans></imgcaption>

Cette vue liste les éventuels orphelins :

  • En lecture : typename lu mais produit par aucun modèle
  • En écriture : typename produit par un modèle mais consommé par personne
  • la vue des statistiques

<imgcaption TopicsTools_Stats|TopicsTools stats></imgcaption>

Cette vue donne des informations sur la simulation, comme :

  • Les nombres de typenames, modèles, fichier de topics
  • les modèles les plus & moins consommateur et producteur de typename
  • la vue d'intégrité des échanges

<imgcaption TopicsTools_Exchanges|TopicsTools exchanges></imgcaption>

On y retrouve les éventuels problèmes d'échange de chaquee configuration de la simulation.
Il apparait les problèmes de configuration au niveau configuration :

  • Un modèle A a besoin en entrée ds sortie d'un modèle B, mais B n'est pas inclus dans la configuration.

Dans ce cas, B risque d'avoir un comportement instable à l'exécution.

Vue des dépendances de synchronisation

Dans un simuation, certains modèles, pour passer la phase de synchronisation, ont besoin que d'autres modèles aient eux même passé cette phase.
C'est la dépendance de synchronisation.
Cette dernière n'est pas décrit dans le fichier de simulation, mais dans le code de synchronisation de ces derniers.
Cette vue permet de lister ces dépendences de synchronisation. <imgcaption TopicsTools_Dependencies|TopicsTools dependencies></imgcaption>

Attention, pour que cette vue restitue les bonnes informations, il est imépratif que certaines règles de codage / formalisme, soit respectées dans le code du modèle :

  • Les dépendance de synchronisation doivent être décrite dans des fonctions membres (pas forcément celle du modèle) ayant pour nom “synchronize”
  • Le flag de synchonization des modèle amonts doit forcément s'appeler “initialized”
  • Ce flag est forcément testé dans un ligne comportant un “if”
  • La fonction “synchronize” doit être “propre” en terme de { & }n c'est à dire pas de scope en commentaires, code mort
fr/syntax.1477290774.txt.gz · Dernière modification: 2016-10-24 08:32 par 92.153.192.104