tau-tau Analysis

Précisions sur le Fiteur

version 0.0 - 4 novembre 2000

Arguments :
• Il s'agit des arguments d'appel à ttbb0x(..). Ils sont nombreux et peu cohérents entre eux.
• Ils sont partiellement décrits au début de ttbb07 ou de ttbb09.
  
• Ils seront re-organisés dans la version suivante.

Fonctionnement :
• Il existe différents modes de minimisation, ils sont définis par le kphys. Selon le choix ainsi operé les variables et les mesures ont des ordonancements spécifiques (voir ttjk0x(..) ).
  Ces informations sont réunies dans le common /tcjk0x/.
  Ces informations servent aussi (test positif/négatif) comme clefs de gestion du programme.
• Un ennui est que les queues SDTOUT et STDERR ne sont pas synchronisées. En principe des CALL FLUSH améliorent les choses. Ce problème n'est pas maitrisé, la sortie normale (SDTOUT) ne présente pas de sucessions incohérentes des sorties (programme executé sur un seul processeur) mais elle se mélange avec STDERR.
• Dans mon environnement, le déroulement du programme est géré par un script-perl. Il fonctionne sur risc et linux et pourrait fonctionner sur sun.

Libraries :
Chacune des libraries contient un script-perl qui assure la compilation et la création des libraries à partir des subroutines présentes (voir lib, lip, lig).
• Lib1 - contient les subroutines utilisées à partir d'un fichier local (exemple ttout19).
• Lib2 - contient la plupart des autres subroutines.
• LIC4 - contient les TYPEs gradient.

Conventions d'écriture du code :
• Les arguments d'une subroutine sont souvent soulignés par les commentaires :
  ! == valeur fournie a la subroutine
  * == valeur fournie en retour par la subroutine
  !* == valeur échangée dans les 2 sens
  ^ == argument inutilisé
  Exemple :

      CALL ttm319(idrive, xxI, xxS, chS(isol), kaS(isol), ifS(isol), iecr2)
      !           !       !    *    *          *          *
    

  Les variables iecr sont fournies à peu pres à toutes les subroutines.
• Les ordres fortran sont écrits en majuscules.
• Rarement les variables comportent des majuscules. Toutefois, à la fin des mots, elles représentent des variables associées. Par exemple ci-dessus le S représente une Solution Sortie du minimiseur.
  Ou alors, dans l'exemple suivant, la casse est en relation avec la nature tensorielle des variables : aa est un tenseur de composante covariante i et de composante contravariante K ; il est écrit aaiK(ivar,kmes) .
• La plupart des commentaires commencent en colonne 40.
• Un commentaire xxxx, signale un point douteux, à examiner.
• Un common est rempli dans une seule subroutine (il y a une exeption) et utilisé ailleurs.
• toutes les subroutines contiennent :

          IMPLICIT LOGICAL (L)
          IMPLICIT DOUBLE PRECISION (A-H,O-Q,S-Z)
       

Conventions d'écriture (ordres WRITE) :
• l'ecriture est declanchée par le parametre iecr != 0
  Si iecr = 1 - on peut, en principe suivre l'elaboration des grandeurs physiques et parametres annexes au cours du deroulement du programme.
  Si iecr = 2 - on dispose d'éléments décrivant le fonctionnement interne des subroutines (très verbeux).
• Dans les subroutines, les variables iecr sont des copies de l'argument (qui est iecrr ou iecrx) ; on peut donc changer dans une subroutine la valeur de iecr sans induire des changements à l'extérieur de cette subroutine.
• Les erreurs de logiques qui sont détectées induisent un WRITE commencent par la chaine "Err",
  Il peut s'agir de "Erreur", de "Err.", de "Error", ...
  Les erreurs de mesure sont désignées par des minuscules ("erreur" ...).
• L'entrée dans la subroutine "ttnom" est reperée par "@ > ttnom"
  La sortie est reperée par "@ < ttnom"
  Il peut apparaitre aussi (avant "@ > ttnom") une ligne :
  "@ - ttnom (initialisation)", ou encore ici ou là "@ - ttnom (suite)".

Représentation de certains vecteurs :
• x3a vecteur d'un espace x à 3 dimensions, définissant le point A
• p3c vecteur d'un espace p à 3 dimensions, définissant la 3-impulsion C
• p4c vecteur d'espace-temps à 4 dimensions, définissant la 4-impulsion C (px py pz E)
• p5c comme ci-dessus mais avec la masse en plus (px py pz E m)

Debugging Il existe a priori 3 modes de debugging prévus :
• Utilisation des "iecr". Ils sont initialisables dans "ttparx(..)", variables iecrlu, necrlu.
• Utilisation de la variable laa de ttbb0x(..). mise à true elle entraine une sortie ascii où sont enregistrées les valeurs entrées dans le fiteur. Ces sorties peuvent être re-utilisées par une version extérieure du fiteur aux fins d'analyse rapides.
• Extraction des subroutines suspectes et utilisation de celles-ci dans un programme "banc-test" écrit tout spécialement à cet usage. Un exemple en est donné en "../TEST".