DBZONO(1)            UTILITAIRE RPN                 DBZONO(1)

NOM
    dbzono - Deballeur de diagnostics zonaux. Les vecteurs 
             d'accumulation ecrits durant l'integration sont
             separes par variables pour les bandes specifiees.

USAGE
    dbzono -ISZONAL noutzon -OMZONAL zonfile -ECHOZ non -DATE 

DESCRIPTION
    dbzono est un programme d'interface qui lit un fichier standard
    NOUTZON et produit le fichier ZONFILE. Celui-ci est requis pour
    le tracage de variables par bandes de latitude (GRAPHZN).

    Les arguments:

    -ISZONAL nom du fichier standard d'entree
    -OMZONAL nom du fichier standard de sortie
    -ECHOZ   des diagnostics sont imprimes ou non durant l'execution 
    -DATE    oprun/oui/non (facultatif)
    
    Le fichier standard noutzon n'est plus requis apres l'execution
    de dbzono. Toutes les informations requises pour les moyennes par
    variables et bandes de latitude sont ecrites dans zonfile.

    Quoiqu'il puisse traiter d'autre genre de moyenne(i.e. par regions)
    dbzono a ete concu specifiquement pour GRAPHZN.

CONTENU DE NOUTZON
    Une integration avec diagnostics zonaux aura produit un fichier 
    contenant des enregistrements de controle et des enregistrements
    d'extraction. A chaque NPTEMPS, une table d'information est remise
    a jour. Cette table contient les dimensions de la grille, le pas
    de temps, le nombre de bandes, le nombre de pas pour l'experience
    et une cle de controle requise pour une integration par clone.

    Le fichier contient aussi la liste des variables a extraire,
    les poids relatifs de chaque points de grille par rapport a la
    surface du domaine et son rang (sa position dans le vecteur 
    d'accumulation). Cette information est ecrite une fois seulement
    au debut de l'integration. De plus, des enregistrements contiennent
    les niveaux du modele et la position relative des bandes. Ces
    informations constituent les axes pour le logiciel de graphisme.

    Les accumulateurs dans lesquels les variables du modele sont
    moyennees ou echantilonnees sont ecrits dans un enregistrement dit
    d'extraction. Le carre des moyennes peut aussi etre calcule.
    Ces enregistrements seront sauves en meme temps.

CONTENU DE ZONFILE
    La moyenne pour chaque variable se fait sur des periodes specifiees
    et il peut y en avoir plusieurs selon la duree de l'integration.
    Par exemple, pour une integration de 48 heures on peut vouloir
    sauver les moyennes a toutes les 12 heures ou 24 heures.
    Le fichier de sortie contient donc ces moyennes pour chaques
    periodes. Les enregistrements qui contiennent plusieurs niveaux 
    peuvent etre visualiser avec REC. Ce fichier est conforme a ce qui
    est requis pour GRAPHZN, le trace des variables par bandes.

INFORMATION ADDITIONELLE
    Le deballeur peut manipuler un fichier provenant d'une integration
    sur MIPS (32 bits) ou sur NEC (64bits/32bits)  

    Le contenu du fichier NOUTZON est ecrit de sorte qu'il puisse etre
    lu a partir d'un serveur. La compaction est a 32 bits et la table
    d'information contient seulement des entiers. La liste des 
    variables est ecrite en format R4A. Les vecteurs d'accumulation 
    sont ecrits en format IEEE.

    Les routines requises: BSORT,DEBALZN,LITZON,OUTFLD,ZONFIN,WRITLZN
                           DIFUVD8,QQEXIT,R4STRG

EXEMPLES
    Lors de l'execution de DBZONO, le premier enregistrement qui est 
    lu est la table d'information. Cette table apparait comme suit:

    LITZON - table de controle
    ==========================
    NDELTAT=          24
     DELTAT=        1800
       MODE=           3
         NI=         128
         NJ=          64
         NK=          21
       NBIN=          64
      SOMNK=         107
     LATMIN=         -90
    ==========================

    Ces parametres ont ete prealablement definis avant l'integration.
    et ecrit dans un enregistrement de controle.
    On a sauve les diagnostics a tous les 24 pas de 1800 secondes, soit
    aux 12 heures. Les moyennes et le carre des moyennes sont sauves
    (MODE=3). Il y a 64 bandes de latitude et la position finale de la 
    derniere variable extraite est a 107 dans le vecteur d'accumulation
    Il y 128 par 64 points de grille dans l'horizontale et 21 niveauxi
    dans la verticale.

    La lecture des deux enregistrements suivant nous retourne les 
    niveaux et la position relative des bandes de latitude.
    Les niveaux intermediaires seront calcules s'il n'ont pas ete
    ecrit dans le fichier.

    Suite a la lecture de l'enregistrement de controle des variables,
    la liste des variables extraites sera ecrite de meme que les 
    proprietes de cette variable, i.e. s'il s'agit d'une variable
    echantillonee ou moyennee et sa position relative dans le vecteur
    d'accumulation.
  
    LITZON - liste des variables
    ============================
    .TS.           1           2
    +VE.           0           3
    .UU>           1          24
    .VV>           1          45
    .SS.           1          66
    .TT.           1          87
    .TT.           1         108
    ============================
     ETIKEX=    SEFEXP27

    Meme si la variable comporte 4 caracteres, seul les trois premiers
    sont utilises. La deuxieme colonne indique s'il s'agit d'une
    variable echantillonee(1) ou moyennee(0). Le caractere . ou
    + dans le nom de la variable indique la meme chose. La troisieme
    colonne indique s'il s'agit d'une tranche verticale ou non, c'est
    l'indicateur de position des niveaux verticaux correspondant a
    cette variable dans la tranche d'extraction.
    Il y a deux variables de plus dans la liste ou l'etiquette de
    l'experience a ete encodee. Dans l'exemple, l'etiquette indique
    qu'il s'agit d'une integration du modele globale.
 
    Avec ces informations, il est possible de lire les accumulateurs et
    de les scinder par variables pour chaque periode sauvegardee.