Changes between Version 4 and Version 5 of Users/SetupNewConfiguration/OPABAT

Timestamp:

2017-03-10T09:31:55+01:00 (7 years ago)

Author:

cbricaud

Comment:

--

Users/SetupNewConfiguration/OPABAT

@@ -129 +129 @@
 The file of control is to express in floating value between 0. and float(jpk), to see program batwri.[[BR]]
 
-
-
+== Manual file improvement ==
+
+
+The realization of a bathymetry file in an automatic way is not fully satisfactory for the reasons which we indicated in introduction. It is thus necessary to check the coherence of the results visually, to correct and sometimes modify after validation by a simulation with the model. The manual correction is not easy and several methods were tried in the past. The systematic checking is tiresome and it must be limited to the principal thresholds as soon as the field comprises more than 10000 points of grid. The use of IDL allows us :[[BR]]
+
+    -To post bathymetry.[[BR]]
+    -To select a under-field on which one wishes to make checks or modifications.[[BR]]
+    -To modify and save.[[BR]]
+    -To index islands if necessary.[[BR]]
+
+The utility was developed using software IDL and was used on the machine rhodes.idris.fr of the IDRIS.
+The whole of IDL procedures are called IDL_OPABAT and use files made up at the first step.[[BR]]
+
+    -BATINI, procedure initializing dimensions, to modify.[[BR]]
+    -BATEXP, reading of the files, pretreatment of the file so necessary, selection of a under-field, posting.[[BR]]
+    -BATMOD, work, modification level by level.[[BR]]
+    -BATSAV, save, indentation of the islands.[[BR]]
+
+
+== Example ==
+
+
+
+{{{
+rhodes-rrup448: idl
+
+IDL Version 5.1 (IRIX mipseb). Research Systems, Inc.
+Installation number: 12072-0.
+Licensed for use by: IDRIS/CNRS
+For basic information, enter "IDLInfo" at the IDL> prompt.
+}}}
+
+
+We execute step by step the following parts:[[BR]]
+
+    - @batini : re-initialization of array size
+    - batexp : construction d un zoomreading of the files, removal of the ponds (see A3), construction of a zoom[[BR]]
+    - batmod: work on the zoom of bathymetry, level by level[[BR]]
+    - batsav : handing-over of the islands to -n (see A2A2) and save of a file of bathymetry[[BR]]
+
+
+== Initialization part ==
+
+
+{{{
+IDL> @batini
+
+PROCEDURE IDL pour la BATHYMETRIE CLIPPER
+=========================================
+
+% Compiled module: LOADCT.
+% LOADCT: Loading table Arc en Ciel / Phase
+
+fin de l initialisation
+
+Vous pouvez faire appel a d autres procedures :
+@batini : Reinitialisation des dimensions et tableaux communs
+batexp : lecture des fichiers, suppression des mares
+et construction d'un zoom
+batmod : travail sur le zoom de la bathymetrie, niveau par niveau
+batsav : remise des iles a -n et sauvegarde d un fichier bathy
+}}}
+
+
+== Launching reading procedures ==
+
+
+{{{
+
+IDL> batexp
+
+% Compiled module: BATEXP.
+
+Lecture des fichiers, noms par défaut : global.bin, global.bat
+
+-> -> -> -> -> -> voulez-vous :
+lire les bathymetries initiales , y or n(implicit)?
+
+:y
+
+lecture des bathymetries initiales
+
+% Compiled module: BATLEC.
+
+bathymetrie haute resolution nom = global.bin, y(implicit) or n?
+
+:y
+
+haute resolution lue
+
+% Compiled module: BATLEC2.
+
+bathymetrie basse resolution nom = global.bat, y(implicit) or n?
+
+: n
+
+------>> rentrez un nom de fichier ?
+: bathy_ebauche
+
+OK lecture bathy_ebauche
+basse resolution lue
+}}}
+
+Possible treatments:[[BR]]
+
+For more information on the channels, refer to the appendix A3[[BR]]
+
+
+{{{
+-> -> -> -> -> -> voulez-vous :
+traiter les mares et chenaux, y or n(implicit)?
+
+:n
+}}}
+
+Selection of a under-field by clicking the mouse on a zone[[BR]]
+
+
+
+{{{
+-> -> -> -> -> -> voulez-vous :
+positionner le zoom , y or n(implicit)?
+
+: y
+
+% Compiled module: BATCLIC.
+
+-> -> -> -> positionner et cliquer la souris
+}}}
+
+
+
+{{{
+-> -> -> -> -> -> le zoom vous convient-il, y(implicit) or n?
+: y
+
+reduction et zoom pour pave 1320 1164
+
+% Compiled module: BATZOOM.
+}}}
+
+
+Posting if desired the file of bathymetry and file of control with a higher resolution:[[BR]]
+
+
+
+{{{
+-> -> -> -> -> -> voulez-vous :
+
+affichez le zoom de la basse resolution, y or n(implicit)?
+
+:y
+
+affichage
+}}}
+
+
+
+{{{
+-> -> -> -> -> -> voulez-vous :
+
+afficher le zoom de la basse resolution avec chenaux, y or n(implicit)?
+}}}
+
+
+For more information on the channels please refer to appendix A2:[[BR]]
+
+
+
+{{{
+n
+
+-> -> -> -> -> -> voulez-vous :
+
+affichez le zoom de la haute resolution, y or n(implicit)?
+
+:y
+
+affichage
+}}}
+
+
+{{{
+
+Fin de la procedure BATEXP
+}}}
+
+
+
+== Launching the working procedure ==
+
+
+{{{
+IDL> batmod
+
+% Compiled module: BATMOD.
+
+% LOADCT: Loading table Arc en Ciel / Phase
+
+entrez le niveau?
+}}}
+
+One selected a level expressed in model level[[BR]]
+
+
+{{{
+20
+
+on va visualiser le niveau 20
+
+On peut changer de niveau en cliquant un bouton de la souris
+
+-> -> -> -> -> -> positionner et cliquer la souris
+
+bouton gauche -> informations
+
+milieu -> modifier
+
+droite -> sortir
+}}}
+
+Action with the mouse
+
+{{{
+-> -> -> -> changement de niveau de 0 a jpk ou n?
+
+: 25
+}}}
+
+The under-field is posted with a pallet of colors corresponding to the two levels directly above (hot colors) or below (cold colors) the level selected (yellow color), in isolignes black contours of the file of control :[[BR]]
+
+
+Possibly, we can modify the levels posted.[[BR]]
+
+Two modes can be selected via the mouse :[[BR]]
+
+
+    - An indicative mode, while clicking on the mouse, we post the level of an area and the maximum and minimum values of the file of control in this area.[[BR]]
+
+
+Action with the mouse[[BR]]
+
+
+{{{
+pt ( 124, 120) BR= 25.5000
+
+Haute resolution min 24.6479 moy 25.9379 max 26.6315
+}}}
+
+Action with the mouse[[BR]]
+
+{{{
+pt ( 125, 120) BR= 25.5000
+
+Haute resolution min 25.8304 moy 26.6145 max 27.2046
+}}}
+
+A modification mode, where, with the mouse, we increase or decrease by a model level, example: passage from 24 to 25 for the item (123, 120) :[[BR]]
+
+{{{
+bouton gauche --> monter (combler) new jk=jk-1
+
+milieu --> descendre (creuser) new jk=jk+1
+
+droite --> sortir
+}}}
+
+Action with the mouse[[BR]]
+
+{{pt ( 123, 120) BR= 24.5000
+
+Haute resolution min 23.5273 moy 24.9224 max 26.0350{
+
+}}}
+
+Action with the mouse
+
+{{{
+--> descendu de 24.5000 a 25.5000
+
+pt ( 123, 120) BR= 25.5000
+
+Haute resolution min 23.5273 moy 24.9224 max 26.0350
+}}}
+
+Action with the mouse[[BR]]
+
+
+{{{
+--> monte de 25.5000 a 24.5000
+}}}
+
+Exit of the procedure and save the modifications in the under-field[[BR]]
+
+Action with the mouse[[BR]]
+
+
+{{{
+-> -> -> -> changement de niveau de 0 a jpk ou n?
+
+: n
+
+sortir
+}}}
+
+== Safeguard ==
+
+
+{{{
+Voulez-vous mettre a jour le tableau BATHY
+
+en prenant en compte les corrections faite sur ce ZOOM ?
+
+y or n ?
+
+:y
+
+sauvegarde
+
+% Compiled module: BATSAV.
+}}}
+
+
+We can number the islands before saving. (further informations, see appendix A3)[[BR]]
+
+{{{
+-> -> -> -> remplissage des iles, y ou n(implicit)?
+
+Sauvegarde de bathy
+
+------>> rentrez un nom de fichier ?
+
+: nouvelle_bathy
+
+procedure terminee:
+
+Vous pouvez faire appel a d autres procedures :
+
+@batini : Reinitialisation des dimensions et tableaux communs
+
+batexp : lecture des fichiers, suppression des mares
+
+et construction d un zoom
+
+batmod : travail sur le zoom de la bathymetrie, niveau par niveau
+
+batsav : remise des iles a -n et sauvegarde d un fichier bathy
+
+-> -> -> -> -> -> voulez-vous :
+
+affichez le zoom de la nouvelle bathy, y or n(implicit)?
+
+: n
+
+Vous pouvez faire appel a d autres procedures …
+
+IDL>
+}}}
+
+A call of the procedures can be reiterated as many times as wanted to make posting and correction of under-field then leave IDL.
+
+
+
+== Appendix ==
+
+== A1: Mouth of the rivers ==
+
+
+An additional procedure RUNOFF is under development for, starting from a first file of outline and layout of the coasts, to correct the localization and the distribution (on one or more points of grid) the mouth of the rivers.
+
+
+
+== A2: Channels removal ==
+
+
+The outline file of bathymetry created automatically using FORTRAN programs involves the appearance in the file of ponds (major isolated points) or of channels (deep corridors). Initially a subroutine made it possible to fill them. It seemed more relevant to defer this algorithm in procedure BATEXP of IDL to make it possible to the user to operate a choice on the way of correcting them.
+
+{{{
+-> -> -> -> -> -> voulez-vous :
+
+traiter les mares et cheneaux, y or n(implicit)?
+
+: y
+
+-> -> -> -> -> -> voulez-vous :
+
+supprimer les points ocean quasi-isoles , y or n(implicit) ?
+
+: y
+
+affichage des points isoles, passage numero : 1
+
+nombre de points isoles trouves : 5
+
+continuer la suppression ? , y or n(implicit)?
+
+: y
+
+affichage des points isoles, passage numero : 2
+
+: y
+
+nombre de points isoles trouves : 2
+
+continuer la suppression ? , y or n(implicit)?
+
+: n
+
+affichage des points isoles supprimes
+
+nombre de points retouches EN TOUT sur 3 iterations : 8
+
+enregistrer ces suppressions sur bathy? , y(implicit) or n?
+
+: y
+
+suppression enregistree
+
+-> -> -> -> -> -> voulez-vous :
+
+elargissement des cheneaux, y or n(implicit) ?
+
+: y
+
+affichage des cheneaux, passage numero : 1
+
+probleme chenal 140 102 entre continent/iles ! 18 0 0
+
+nombre de points cheneaux trouves N-S : 0
+
+nombre de points cheneaux trouves E-W : 1
+
+continuer la correction ? , y or n(implicit)?
+
+affichage des points cheneaux corriges
+
+nombre de points N-S EN TOUT sur 1 iterations : 0
+
+nombre de points E-W EN TOUT sur 1 iterations : 1
+
+enregistrer ces modifications sur bathy? , y(implicit) or n?
+
+modification enregistree
+}}}
+
+
+== A3: Islands classification ==
+
+When the field has islands, for example fourteen for model ORCA, the corresponding areas are initially put at 0 by the programs and procedures, corresponding to continent. In the file of bathymetry of model OPA, these islands are numbered with negative values. Once bathymetry to finalize, one can thus carry out this operation starting from procedure BATSAV. This algorithm rises from programs worked out by Anne-Marie Tréguier (LPO).
+
+
+{{{IDL> batsav
+
+-> -> -> -> remplissage des iles, y ou n(implicit)?
+
+: y
+
+Remplissage des iles
+
+-> -> -> -> -> -> positionner et cliquer la souris
+
+si probleme : droite --> sortir
+
+-1 est valeur par defaut de l ile, OK, y or n ?
+
+
+
+}}}
+
+