source: LMDZ6/trunk/libf/dyn3d_common/infotrac.F90 @ 4190

Last change on this file since 4190 was 4190, checked in by dcugnet, 2 years ago

Fix for INCA and old "traceur.def" files

  • Property copyright set to
    Name of program: LMDZ
    Creation date: 1984
    Version: LMDZ5
    License: CeCILL version 2
    Holder: Laboratoire de m\'et\'eorologie dynamique, CNRS, UMR 8539
    See the license file in the root directory
  • Property svn:keywords set to Id
File size: 34.6 KB
Line 
1!$Id: infotrac.F90 4190 2022-06-29 17:40:35Z dcugnet $
2!
3MODULE infotrac
4
5   USE       strings_mod, ONLY: msg, find, strIdx,  strFind, strParse, dispTable, int2str,  reduceExpr, &
6                          cat, fmsg, test, strTail, strHead, strStack, strReduce, bool2str, maxlen, testFile
7   USE readTracFiles_mod, ONLY: trac_type, readTracersFiles, addPhase, indexUpdate,  nphases, ancestor,  &
8                                isot_type, old2newName,      delPhase,               getKey_init, tran0, &
9                                keys_type, initIsotopes,     getPhase, known_phases, getKey, setGeneration
10   IMPLICIT NONE
11
12   PRIVATE
13
14   !=== FOR TRACERS:
15   PUBLIC :: infotrac_init                                 !--- Initialization of the tracers
16   PUBLIC :: tracers, type_trac, types_trac                !--- Full tracers database, tracers type keyword
17   PUBLIC :: nqtot,   nbtr,   nqo,   nqCO2,   nqtottr      !--- Main dimensions
18   PUBLIC :: conv_flg, pbl_flg                             !--- Convection & boundary layer activation keys
19
20   !=== FOR ISOTOPES: General
21   PUBLIC :: isotopes,  nbIso                              !--- Derived type, full isotopes families database + nb of families
22   PUBLIC :: isoSelect, ixIso                              !--- Isotopes family selection tool + selected family index
23   !=== FOR ISOTOPES: Specific to water
24   PUBLIC :: iH2O, tnat, alpha_ideal                       !--- H2O isotopes index, natural abundance, fractionning coeff.
25   PUBLIC :: min_qParent, min_qMass, min_ratio             !--- Min. values for various isotopic quantities
26   !=== FOR ISOTOPES: Depending on the selected isotopes family
27   PUBLIC :: isotope, isoKeys                              !--- Selected isotopes database + associated keys (cf. getKey)
28   PUBLIC :: isoName, isoZone, isoPhas                     !--- Isotopes and tagging zones names, phases
29   PUBLIC :: niso,    nzone,   nphas,   ntiso              !---  " " numbers + isotopes & tagging tracers number
30   PUBLIC :: itZonIso                                      !--- idx "it" (in "isoName(1:niso)") = function(tagging idx, isotope idx)
31   PUBLIC :: iqIsoPha                                      !--- idx "iq" (in "qx") = function(isotope idx, phase idx) + aliases
32   PUBLIC :: isoCheck                                      !--- Run isotopes checking routines
33   !=== FOR BOTH TRACERS AND ISOTOPES
34   PUBLIC :: getKey                                        !--- Get a key from "tracers" or "isotope"
35
36   INTERFACE isoSelect; MODULE PROCEDURE isoSelectByIndex, isoSelectByName; END INTERFACE isoSelect
37
38!=== CONVENTIONS FOR TRACERS NUMBERS:
39!  |--------------------+-----------------------+-----------------+---------------+----------------------------|
40!  | water in different |    water tagging      |  water isotopes | other tracers | additional tracers moments |
41!  | phases: H2O_[gls]  |      isotopes         |                 |               |  for higher order schemes  |
42!  |--------------------+-----------------------+-----------------+---------------+----------------------------|
43!  |                    |                       |                 |               |                            |
44!  |<--     nqo      -->|<-- nqo*niso* nzone -->|<-- nqo*niso  -->|<--  nbtr   -->|<--        (nmom)        -->|         
45!  |                    |                                         |                                            |
46!  |                    |<-- nqo*niso*(nzone+1)  =   nqo*ntiso -->|<--    nqtottr = nbtr + nmom             -->|
47!  |                                                                              = nqtot - nqo*(ntiso+1)      |
48!  |                                                                                                           |
49!  |<--                        nqtrue  =  nbtr + nqo*(ntiso+1)                 -->|                            |
50!  |                                                                                                           |
51!  |<--                        nqtot   =  nqtrue + nmom                                                     -->|
52!  |                                                                                                           |
53!  |-----------------------------------------------------------------------------------------------------------|
54!  NOTES FOR THIS TABLE:
55!  * Used "niso", "nzone" and "ntiso" are components of "isotopes(ip)" for water (isotopes(ip)%parent == 'H2O'),
56!    since water is so far the sole tracers family, except passive CO2, removed from the main tracers table.
57!  * For water, "nqo" is equal to the more general field "isotopes(ip)%nphas".
58!  * "niso", "nzone", "ntiso", "nphas" are defined for other isotopic tracers families, if any.
59!
60!=== DERIVED TYPE EMBEDDING MOST OF THE TRACERS-RELATED QUANTITIES (LENGTH: nqtot)
61!    Each entry is accessible using "%" sign.
62!  |-------------+------------------------------------------------------+-------------+------------------------+
63!  |  entry      | Meaning                                              | Former name | Possible values        |
64!  |-------------+------------------------------------------------------+-------------+------------------------+
65!  | name        | Name (short)                                         | tname       |                        |
66!  | gen0Name    | Name of the 1st generation ancestor                  | /           |                        |
67!  | parent      | Name of the parent                                   | /           |                        |
68!  | longName    | Long name (with adv. scheme suffix) for outputs      | ttext       |                        |
69!  | type        | Type (so far: tracer or tag)                         | /           | tracer,tag             |
70!  | phase       | Phases list ("g"as / "l"iquid / "s"olid)             | /           | [g][l][s]              |
71!  | component   | Name(s) of the merged/cumulated section(s)           | /           | coma-separated names   |
72!  | iadv        | Advection scheme number                              | iadv        | 1-20,30 exc. 3-9,15,19 |
73!  | iGeneration | Generation (>=1)                                     | /           |                        |
74!  | isAdvected  | advected tracers flag (.TRUE. if iadv >= 0)          | /           | nqtrue  .TRUE. values  |
75!  | isInPhysics | tracers not extracted from the main table in physics | /           | nqtottr .TRUE. values  |
76!  | iqParent    | Index of the parent tracer                           | iqpere      | 1:nqtot                |
77!  | iqDescen    | Indexes of the childs       (all generations)        | iqfils      | 1:nqtot                |
78!  | nqDescen    | Number of the descendants   (all generations)        | nqdesc      | 1:nqtot                |
79!  | nqChilds    | Number of childs            (1st generation only)    | nqfils      | 1:nqtot                |
80!  | iso_iGroup  | Isotopes group index in isotopes(:)                  | /           | 1:nbIso                |
81!  | iso_iName   | Isotope  name  index in isotopes(iso_iGroup)%trac(:) | iso_indnum  | 1:niso                 |
82!  | iso_iZone   | Isotope  zone  index in isotopes(iso_iGroup)%zone(:) | zone_num    | 1:nzone                |
83!  | iso_iPhas   | Isotope  phase index in isotopes(iso_iGroup)%phas(:) | phase_num   | 1:nphas                |
84!  | keys        | key/val pairs accessible with "getKey" routine       | /           |                        |
85!  +-------------+------------------------------------------------------+-------------+------------------------+
86!
87!=== DERIVED TYPE EMBEDDING MOST OF THE ISOTOPES-RELATED QUANTITIES (LENGTH: nbIso, NUMBER OF ISOTOPES FAMILIES)
88!    Each entry is accessible using "%" sign.
89!  |-----------------+--------------------------------------------------+--------------------+-----------------+
90!  |  entry | length | Meaning                                          |    Former name     | Possible values |
91!  |-----------------+--------------------------------------------------+--------------------+-----------------+
92!  | parent          | Parent tracer (isotopes family name)             |                    |                 |
93!  | keys   | niso   | Isotopes keys/values pairs list + number         |                    |                 |
94!  | trac   | ntiso  | Isotopes + tagging tracers list + number         | / | ntraciso       |                 |
95!  | zone   | nzone  | Geographic tagging zones   list + number         | / | ntraceurs_zone |                 |
96!  | phase  | nphas  | Phases                     list + number         |                    | [g][l][s], 1:3  |
97!  | iqIsoPha        | Index in "qx"           = f(name(1:ntiso)),phas) | iqiso              | 1:nqtot         |
98!  | itZonIso        | Index in "trac(1:ntiso)"= f(zone, name(1:niso))  | index_trac         | 1:ntiso         |
99!  +-----------------+--------------------------------------------------+--------------------+-----------------+
100
101   REAL, PARAMETER :: min_qParent = 1.e-30, min_qMass = 1.e-18, min_ratio = 1.e-16 ! MVals et CRisi
102
103   !=== DIMENSIONS OF THE TRACERS TABLES AND OTHER SCALAR VARIABLES
104   INTEGER,                 SAVE :: nqtot,  &                   !--- Tracers nb in dynamics (incl. higher moments + H2O)
105                                    nbtr,   &                   !--- Tracers nb in physics  (excl. higher moments + H2O)
106                                    nqo,    &                   !--- Number of water phases
107                                    nbIso,  &                   !--- Number of available isotopes family
108                                    nqtottr, &                  !--- Number of tracers passed to phytrac (TO BE DELETED ?)
109                                    nqCO2                       !--- Number of tracers of CO2  (ThL)
110   CHARACTER(LEN=maxlen),   SAVE :: type_trac                   !--- Keyword for tracers type(s)
111   CHARACTER(LEN=maxlen),   SAVE, ALLOCATABLE :: types_trac(:)  !--- Keyword for tracers type(s), parsed version
112
113   !=== DERIVED TYPES EMBEDDING MOST INFORMATIONS ABOUT TRACERS AND ISOTOPES FAMILIES
114   TYPE(trac_type), TARGET, SAVE, ALLOCATABLE ::  tracers(:)    !=== TRACERS DESCRIPTORS VECTOR
115   TYPE(isot_type), TARGET, SAVE, ALLOCATABLE :: isotopes(:)    !=== ISOTOPES PARAMETERS VECTOR
116
117   !=== ALIASES FOR CURRENTLY SELECTED ISOTOPES FAMILY OF VARIABLES EMBEDDED IN THE VECTOR "isotopes"
118   TYPE(isot_type),         SAVE, POINTER :: isotope            !--- CURRENTLY SELECTED ISOTOPES FAMILY DESCRIPTOR
119   INTEGER,                 SAVE          :: ixIso, iH2O        !--- Index of the selected isotopes family and H2O family
120   LOGICAL,                 SAVE          :: isoCheck           !--- Flag to trigger the checking routines
121   TYPE(keys_type),         SAVE, POINTER :: isoKeys(:)         !--- ONE SET OF KEYS FOR EACH ISOTOPE (LISTED IN isoName)
122   CHARACTER(LEN=maxlen),   SAVE, POINTER :: isoName(:),   &    !--- ISOTOPES NAMES FOR THE CURRENTLY SELECTED FAMILY
123                                             isoZone(:),   &    !--- TAGGING ZONES  FOR THE CURRENTLY SELECTED FAMILY
124                                             isoPhas            !--- USED PHASES    FOR THE CURRENTLY SELECTED FAMILY
125   INTEGER,                 SAVE          ::  niso, nzone, &    !--- NUMBER OF ISOTOPES, TAGGING ZONES AND PHASES
126                                             nphas, ntiso       !--- NUMBER OF PHASES AND ISOTOPES + ISOTOPIC TAGGING TRACERS
127   INTEGER,                 SAVE, POINTER ::itZonIso(:,:), &    !--- INDEX IN "isoTrac" AS f(tagging zone idx,  isotope idx)
128                                            iqIsoPha(:,:)       !--- INDEX IN "qx"      AS f(isotopic tracer idx, phase idx)
129
130   !=== VARIABLES FOR ISOTOPES INITIALIZATION AND FOR INCA
131   REAL,                SAVE, ALLOCATABLE ::     tnat(:), &     !--- Natural relative abundance of water isotope        (niso)
132                                          alpha_ideal(:)        !--- Ideal fractionning coefficient (for initial state) (niso)
133   INTEGER,             SAVE, ALLOCATABLE :: conv_flg(:), &     !--- Convection     activation ; needed for INCA        (nbtr)
134                                              pbl_flg(:)        !--- Boundary layer activation ; needed for INCA        (nbtr)
135
136CONTAINS
137
138SUBROUTINE infotrac_init
139   USE control_mod, ONLY: planet_type, config_inca
140#ifdef REPROBUS
141   USE CHEM_REP,    ONLY: Init_chem_rep_trac
142#endif
143   IMPLICIT NONE
144!==============================================================================================================================
145!
146!   Auteur:  P. Le Van /L. Fairhead/F.Hourdin
147!   -------
148!
149!   Modifications:
150!   --------------
151!   05/94: F.Forget      Modif special traceur
152!   02/02: M-A Filiberti Lecture de traceur.def
153!   01/22: D. Cugnet     Nouveaux tracer.def et tracer_*.def + encapsulation (types trac_type et isot_type)
154!
155!   Objet:
156!   ------
157!   GCM LMD nouvelle grille
158!
159!==============================================================================================================================
160!   ... modification de l'integration de q ( 26/04/94 ) ....
161!------------------------------------------------------------------------------------------------------------------------------
162! Declarations:
163   INCLUDE "dimensions.h"
164   INCLUDE "iniprint.h"
165
166!------------------------------------------------------------------------------------------------------------------------------
167! Local variables
168   INTEGER, ALLOCATABLE :: hadv(:), vadv(:)                          !--- Horizontal/vertical transport scheme number
169#ifdef INCA
170   INTEGER, ALLOCATABLE :: had (:), hadv_inca(:), conv_flg_inca(:), &!--- Variables specific to INCA
171                           vad (:), vadv_inca(:),  pbl_flg_inca(:)
172   CHARACTER(LEN=8), ALLOCATABLE :: solsym_inca(:)                   !--- Tracers names for INCA
173   INTEGER :: nqINCA
174#endif
175   CHARACTER(LEN=2)      ::   suff(9)                                !--- Suffixes for schemes of order 3 or 4 (Prather)
176   CHARACTER(LEN=3)      :: descrq(30)                               !--- Advection scheme description tags
177   CHARACTER(LEN=maxlen) :: msg1                                     !--- String for messages
178   INTEGER :: fType                                                  !--- Tracers description file type ; 0: none
179                                                                     !--- 1/2/3: "traceur.def"/"tracer.def"/"tracer_*.def"
180   INTEGER :: nqtrue                                                 !--- Tracers nb from tracer.def (no higher order moments)
181   INTEGER :: iad                                                    !--- Advection scheme number
182   INTEGER :: ic, ip, np, iq, jq, it, nt, im, nm, ix, iz, nz, k      !--- Indexes and temporary variables
183   LOGICAL :: lerr, ll
184   CHARACTER(LEN=1) :: p
185   TYPE(trac_type), ALLOCATABLE, TARGET :: ttr(:)
186   TYPE(trac_type), POINTER             :: t1, t(:)
187   TYPE(isot_type), POINTER             :: iso
188
189   CHARACTER(LEN=maxlen), ALLOCATABLE :: tnom_0(:), tnom_transp(:)   !--- Tracer short name + transporting fluid name
190   CHARACTER(LEN=maxlen)              :: tchaine
191   INTEGER :: ierr
192
193   CHARACTER(LEN=*), PARAMETER :: modname="infotrac_init"
194!------------------------------------------------------------------------------------------------------------------------------
195! Initialization :
196!------------------------------------------------------------------------------------------------------------------------------
197   suff          = ['x ','y ','z ','xx','xy','xz','yy','yz','zz']
198   descrq( 1: 2) = ['LMV','BAK']
199   descrq(10:20) = ['VL1','VLP','FH1','FH2','VLH','   ','PPM','PPS','PPP','   ','SLP']
200   descrq(30)    =  'PRA'
201   
202   CALL msg('type_trac = "'//TRIM(type_trac)//'"', modname)
203   IF(strParse(type_trac, '|', types_trac, n=nt)) CALL abort_gcm(modname,'can''t parse "type_trac = '//TRIM(type_trac)//'"',1)
204
205   !---------------------------------------------------------------------------------------------------------------------------
206   DO it = 1, nt                                                          !--- nt>1=> "type_trac": coma-separated keywords list
207   !---------------------------------------------------------------------------------------------------------------------------
208      !--- MESSAGE ABOUT THE CHOSEN CONFIGURATION
209      msg1 = 'For type_trac = "'//TRIM(types_trac(it))//'":'
210      SELECT CASE(types_trac(it))
211         CASE('inca'); CALL msg(TRIM(msg1)//' coupling with INCA chemistry model, config_inca='//config_inca, modname)
212         CASE('inco'); CALL msg(TRIM(msg1)//' coupling jointly with INCA and CO2 cycle',  modname)
213         CASE('repr'); CALL msg(TRIM(msg1)//' coupling with REPROBUS chemistry model',    modname)
214         CASE('co2i'); CALL msg(TRIM(msg1)//' you have chosen to run with CO2 cycle',     modname)
215         CASE('coag'); CALL msg(TRIM(msg1)//' tracers are treated for COAGULATION tests', modname)
216         CASE('lmdz'); CALL msg(TRIM(msg1)//' tracers are treated in LMDZ only',          modname)
217         CASE DEFAULT; CALL abort_gcm(modname,'type_trac='//TRIM(types_trac(it))//' not possible yet.',1)
218      END SELECT
219
220      !--- COHERENCE TEST BETWEEN "type_trac" AND "config_inca"
221      IF(ANY(['inca', 'inco'] == types_trac(it)) .AND. ALL(['aero', 'aeNP', 'chem'] /= config_inca)) &
222         CALL abort_gcm(modname, 'Incoherence between type_trac and config_inca. Please modify "run.def"',1)
223
224      !--- COHERENCE TEST BETWEEN "type_trac" AND PREPROCESSING KEYS
225      SELECT CASE(types_trac(it))
226         CASE('inca', 'inco')
227#ifndef INCA
228            CALL abort_gcm(modname, 'You must add cpp key INCA and compile with INCA code', 1)
229#endif
230         CASE('repr')
231#ifndef REPROBUS
232            CALL abort_gcm(modname, 'You must add cpp key REPROBUS and compile with REPROBUS code', 1)
233#endif
234         CASE('coag')
235#ifndef CPP_StratAer
236            CALL abort_gcm(modname, 'You must add cpp key StratAer and compile with StratAer code', 1)
237#endif
238      END SELECT
239
240   !---------------------------------------------------------------------------------------------------------------------------
241   END DO
242   !---------------------------------------------------------------------------------------------------------------------------
243
244   !--- DISABLE "config_inca" OPTION FOR A RUN WITHOUT "INCA" IF IT DIFFERS FROM "none"
245   IF(fmsg('Setting config_inca="none" as you do not couple with INCA model', &
246         modname, ALL(types_trac /= 'inca') .AND. ALL(types_trac /= 'inco') .AND. config_inca /= 'none')) config_inca = 'none'
247
248   nqCO2 = 0; IF(ANY(types_trac == 'inco')) nqCO2 = 1
249
250!==============================================================================================================================
251! 1) Get the numbers of: true (first order only) tracers "nqtrue", water tracers "nqo" (vapor/liquid/solid)
252!==============================================================================================================================
253   IF(readTracersFiles(type_trac, fType, tracers)) CALL abort_gcm(modname, 'problem with tracers file(s)',1)
254   IF(fType == 0) CALL abort_gcm(modname, 'Missing tracers file: "traceur.def", "tracer.def" or "tracer_<keyword>.def file.',1)
255   !---------------------------------------------------------------------------------------------------------------------------
256   IF(fType == 1 .AND. ANY(['inca','inco'] == type_trac)) THEN       !=== FOUND OLD STYLE INCA "traceur.def" (single type_trac)
257   !---------------------------------------------------------------------------------------------------------------------------
258#ifdef INCA
259      nqo = SIZE(tracers)
260      IF(nqCO2==1 .AND. nqo==4) nqo = 3                              !--- Force nqo to 3 (ThL)
261      CALL Init_chem_inca_trac(nqINCA)                               !--- Get nqINCA from INCA
262      nbtr = nqINCA + nqCO2                                          !--- Number of tracers passed to phytrac
263      nqtrue = nbtr + nqo                                            !--- Total number of "true" tracers
264      IF(ALL([2,3] /= nqo)) CALL abort_gcm(modname, 'Only 2 or 3 water phases allowed ; found nqo='//TRIM(int2str(nqo)), 1)
265      ALLOCATE(hadv(nqtrue), hadv_inca(nqINCA), conv_flg_inca(nqINCA), solsym_inca(nqINCA))
266      ALLOCATE(vadv(nqtrue), vadv_inca(nqINCA),  pbl_flg_inca(nqINCA))
267      CALL init_transport(solsym_inca, conv_flg_inca, pbl_flg_inca, hadv_inca, vadv_inca)
268      ALLOCATE(ttr(nqtrue))
269      ttr(1:nqo+nqCO2)                    = tracers
270      ttr(1    :      nqo   )%component   = 'lmdz'
271      ttr(1+nqo:nqCO2+nqo   )%component   = 'co2i'
272      ttr(1+nqo+nqCO2:nqtrue)%component   = 'inca'
273      ttr(1+nqo      :nqtrue)%name        = [('CO2     ', k=1, nqCO2), solsym_inca]
274      ttr(1+nqo+nqCO2:nqtrue)%parent      = tran0
275      ttr(1+nqo+nqCO2:nqtrue)%phase       = 'g'
276      lerr = getKey('hadv', had, ky=tracers(:)%keys)
277      lerr = getKey('vadv', vad, ky=tracers(:)%keys)
278      hadv(1:nqo) = had(:); hadv(nqo+1:nqtrue) = hadv_inca
279      vadv(1:nqo) = vad(:); vadv(nqo+1:nqtrue) = vadv_inca
280      CALL MOVE_ALLOC(FROM=ttr, TO=tracers)
281      CALL setGeneration(tracers)                                    !--- SET FIELDS %iGeneration, %gen0Name
282      DEALLOCATE(had, hadv_inca, vad, vadv_inca, conv_flg_inca, pbl_flg_inca, solsym_inca)
283#endif
284   !---------------------------------------------------------------------------------------------------------------------------
285   ELSE                                                              !=== FOUND NEW STYLE TRACERS CONFIGURATION FILE(S)
286   !---------------------------------------------------------------------------------------------------------------------------
287      nqo    =        COUNT(delPhase(tracers(:)%name)     == 'H2O' &
288                               .AND. tracers(:)%component == 'lmdz') !--- Number of water phases
289      nqtrue = SIZE(tracers)                                         !--- Total number of "true" tracers
290      nbtr   = nqtrue-COUNT(delPhase(tracers(:)%gen0Name) == 'H2O' &
291                               .AND. tracers(:)%component == 'lmdz') !--- Number of tracers passed to phytrac
292#ifdef INCA
293      nqINCA = COUNT(tracers(:)%component == 'inca')
294#endif
295      lerr = getKey('hadv', hadv, ky=tracers(:)%keys)
296      lerr = getKey('vadv', vadv, ky=tracers(:)%keys)
297   !---------------------------------------------------------------------------------------------------------------------------
298   END IF
299   !---------------------------------------------------------------------------------------------------------------------------
300
301   CALL getKey_init(tracers)
302
303   !--- Transfert the number of tracers to Reprobus
304#ifdef REPROBUS
305   CALL Init_chem_rep_trac(nbtr, nqo, tracers(:)%name)
306#endif
307
308!==============================================================================================================================
309! 2) Calculate nqtot, number of tracers needed (greater if advection schemes 20 or 30 have been chosen).
310!==============================================================================================================================
311   DO iq = 1, nqtrue
312      IF( hadv(iq)<20 .OR. (ANY(hadv(iq)==[20,30]) .AND. hadv(iq)==vadv(iq)) ) CYCLE
313      WRITE(msg1,'("The choice hadv=",i0,", vadv=",i0,a)')hadv(iq),vadv(iq),' for "'//TRIM(tracers(iq)%name)//'" is not available'
314      CALL abort_gcm(modname, TRIM(msg1), 1)
315   END DO
316   nqtot =    COUNT( hadv< 20 .AND. vadv< 20 ) &                     !--- No additional tracer
317         +  4*COUNT( hadv==20 .AND. vadv==20 ) &                     !--- 3  additional tracers
318         + 10*COUNT( hadv==30 .AND. vadv==30 )                       !--- 9  additional tracers
319
320   !--- More tracers due to the choice of advection scheme => assign total number of tracers
321   IF( nqtot /= nqtrue ) THEN
322      CALL msg('The choice of advection scheme for one or more tracers makes it necessary to add tracers')
323      CALL msg('The number of true tracers is '//TRIM(int2str(nqtrue)))
324      CALL msg('The total number of tracers needed is '//TRIM(int2str(nqtot)))
325   END IF
326
327!==============================================================================================================================
328! 3) Determine the advection scheme choice for water and tracers "iadv" and the fields long name, isAdvected.
329!     iadv = 1    "LMDZ-specific humidity transport" (for H2O vapour)          LMV
330!     iadv = 2    backward                           (for H2O liquid)          BAK
331!     iadv = 14   Van-Leer + specific humidity, modified by Francis Codron     VLH
332!     iadv = 10   Van-Leer (chosen for vapour and liquid water)                VL1
333!     iadv = 11   Van-Leer for hadv and PPM version (Monotonic) for vadv       VLP
334!     iadv = 12   Frederic Hourdin I                                           FH1
335!     iadv = 13   Frederic Hourdin II                                          FH2
336!     iadv = 16   Monotonic         PPM (Collela & Woodward 1984)              PPM
337!     iadv = 17   Semi-monotonic    PPM (overshoots allowed)                   PPS
338!     iadv = 18   Definite positive PPM (overshoots and undershoots allowed)   PPP
339!     iadv = 20   Slopes                                                       SLP
340!     iadv = 30   Prather                                                      PRA
341!
342!        In array q(ij,l,iq) : iq = 1/2[/3]    for vapour/liquid[/ice] water
343!        And optionaly:        iq = 3[4],nqtot for other tracers
344!==============================================================================================================================
345   ALLOCATE(ttr(nqtot))
346   jq = nqtrue+1; tracers(:)%iadv = -1
347   DO iq = 1, nqtrue
348      t1 => tracers(iq)
349
350      !--- VERIFY THE CHOICE OF ADVECTION SCHEME
351      iad = -1
352      IF(hadv(iq)     ==    vadv(iq)    ) iad = hadv(iq)
353      IF(hadv(iq)==10 .AND. vadv(iq)==16) iad = 11
354      WRITE(msg1,'("Bad choice of advection scheme for ",a,": hadv = ",i0,", vadv = ",i0)')TRIM(t1%name), hadv(iq), vadv(iq)
355      IF(iad == -1) CALL abort_gcm(modname, msg1, 1)
356
357      !--- SET FIELDS %longName, %iadv, %isAdvected, %isInPhysics
358      t1%longName   = t1%name; IF(iad > 0) t1%longName=TRIM(t1%name)//descrq(iad)
359      t1%iadv       = iad
360      t1%isAdvected = iad >= 0
361      t1%isInPhysics= delPhase(t1%gen0Name) /= 'H2O' &
362                          .OR. t1%component /= 'lmdz' !=== OTHER EXCEPTIONS TO BE ADDED: CO2i, SURSATURATED WATER CLOUD...
363      ttr(iq)       = t1
364
365      !--- DEFINE THE HIGHER ORDER TRACERS, IF ANY
366      nm = 0
367      IF(iad == 20) nm = 3                                           !--- 2nd order scheme
368      IF(iad == 30) nm = 9                                           !--- 3rd order scheme
369      IF(nm == 0) CYCLE                                              !--- No higher moments
370      ttr(jq+1:jq+nm)             = t1
371      ttr(jq+1:jq+nm)%name        = [(TRIM(t1%name)    //'-'//TRIM(suff(im)), im=1, nm) ]
372      ttr(jq+1:jq+nm)%parent      = [(TRIM(t1%parent)  //'-'//TRIM(suff(im)), im=1, nm) ]
373      ttr(jq+1:jq+nm)%longName    = [(TRIM(t1%longName)//'-'//TRIM(suff(im)), im=1, nm) ]
374      ttr(jq+1:jq+nm)%iadv        = [(-iad,    im=1, nm) ]
375      ttr(jq+1:jq+nm)%isAdvected  = [(.FALSE., im=1, nm) ]
376      jq = jq + nm
377   END DO
378   DEALLOCATE(hadv, vadv)
379   CALL MOVE_ALLOC(FROM=ttr, TO=tracers)
380
381   !--- SET FIELDS %iqParent, %nqChilds, %iGeneration, %iqDescen, %nqDescen
382   CALL indexUpdate(tracers)
383
384   !=== TEST ADVECTION SCHEME
385   DO iq=1,nqtot ; t1 => tracers(iq); iad = t1%iadv
386
387      !--- ONLY TESTED VALUES FOR TRACERS FOR NOW:               iadv = 14, 10 (and 0 for non-transported tracers)
388      IF(ALL([10,14,0] /= iad)) &
389         CALL abort_gcm(modname, 'Not tested for iadv='//TRIM(int2str(iad))//' ; 10 or 14 only are allowed !', 1)
390
391      !--- ONLY TESTED VALUES FOR PARENTS HAVING CHILDS FOR NOW: iadv = 14, 10 (PARENTS: TRACERS OF GENERATION 1)
392      IF(ALL([10,14] /= iad) .AND. t1%iGeneration == 1 .AND. ANY(tracers(:)%iGeneration > 1)) &
393         CALL abort_gcm(modname, 'iadv='//TRIM(int2str(iad))//' not implemented for parents ; 10 or 14 only are allowed !', 1)
394
395      !--- ONLY TESTED VALUES FOR CHILDS FOR NOW:                iadv = 10     (CHILDS:  TRACERS OF GENERATION GREATER THAN 1)
396      IF(fmsg('WARNING ! iadv='//TRIM(int2str(iad))//' not implemented for childs. Setting iadv=10 for "'//TRIM(t1%name)//'"',&
397         modname, iad /= 10 .AND. t1%iGeneration > 1)) t1%iadv = 10
398
399      !--- ONLY VALID SCHEME NUMBER FOR WATER VAPOUR:            iadv = 14
400      ll = t1%name /= addPhase('H2O','g')
401      IF(fmsg('WARNING ! iadv=14 is valid for water vapour only. Setting iadv=10 for "'//TRIM(t1%name)//'".', &
402         modname, iad == 14 .AND. ll))                 t1%iadv = 10
403   END DO
404
405   niso = 0; nzone=0; nphas=nqo; ntiso = 0; isoCheck=.FALSE.
406   CALL initIsotopes(tracers, isotopes)
407   nbIso = SIZE(isotopes)
408   nqtottr = nqtot - COUNT(tracers%gen0Name == 'H2O' .AND. tracers%component == 'lmdz')
409   IF(nbIso/=0) THEN                        !--- ISOTOPES FOUND
410
411      !=== READ PHYSICAL PARAMETERS FROM "isotopes_params.def" FILE SPECIFIC TO WATER ISOTOPES
412      !    DONE HERE, AND NOT ONLY IN "infotrac_phy", BECAUSE SOME PHYSICAL PARAMS ARE NEEDED FOR RESTARTS (tnat, alpha_ideal)
413      CALL getKey_init(tracers, isotopes)
414      IF(isoSelect('H2O')) RETURN           !--- Select water isotopes ; finished if no water isotopes
415      iH2O = ixIso                          !--- Keep track of water family index
416      IF(getKey('tnat' , tnat,        isoName(1:niso))) CALL abort_gcm(modname, 'can''t read "tnat"', 1)
417      IF(getKey('alpha', alpha_ideal, isoName(1:niso))) CALL abort_gcm(modname, 'can''t read "alpha_ideal"', 1)
418
419      !=== MAKE SURE THE MEMBERS OF AN ISOTOPES FAMILY ARE PRESENT IN THE SAME PHASES
420      DO ix = 1, nbIso
421         iso => isotopes(ix)
422         !--- Check whether each isotope and tagging isotopic tracer is present in the same number of phases
423         DO it = 1, iso%ntiso
424            np = SUM([(COUNT(tracers(:)%name == addPhase(iso%trac(it), iso%phase(ip:ip))), ip=1, iso%nphas)])
425            IF(np == iso%nphas) CYCLE
426            WRITE(msg1,'("Found ",i0," phases for ",a," instead of ",i0)')np, TRIM(iso%trac(it)), iso%nphas
427            CALL abort_gcm(modname, msg1, 1)
428         END DO
429         DO it = 1, iso%niso
430            nz = SUM([(COUNT(iso%trac == TRIM(iso%trac(it))//'_'//iso%zone(iz)), iz=1, iso%nzone)])
431            IF(nz == iso%nzone) CYCLE
432            WRITE(msg1,'("Found ",i0," tagging zones for ",a," instead of ",i0)')nz, TRIM(iso%trac(it)), iso%nzone
433            CALL abort_gcm(modname, msg1, 1)
434         END DO
435      END DO
436   END IF
437
438   !--- Convection / boundary layer activation for all tracers
439   ALLOCATE(conv_flg(nbtr)); conv_flg(1:nbtr) = 1
440   ALLOCATE( pbl_flg(nbtr));  pbl_flg(1:nbtr) = 1
441
442   !--- Note: nqtottr can differ from nbtr when nmom/=0
443!   IF(COUNT(tracers%iso_iName == 0) - COUNT(delPhase(tracers%name) == 'H2O' .AND. tracers%component == 'lmdz') /= nqtottr) &
444!      CALL abort_gcm('infotrac_init', 'pb dans le calcul de nqtottr', 1)
445
446   !=== DISPLAY THE RESULTS
447   CALL msg('nqo    = '//TRIM(int2str(nqo)),    modname)
448   CALL msg('nbtr   = '//TRIM(int2str(nbtr)),   modname)
449   CALL msg('nqtrue = '//TRIM(int2str(nqtrue)), modname)
450   CALL msg('nqtot  = '//TRIM(int2str(nqtot)),  modname)
451   CALL msg('niso   = '//TRIM(int2str(niso)),   modname)
452   CALL msg('ntiso  = '//TRIM(int2str(ntiso)),  modname)
453#ifdef INCA
454   CALL msg('nqCO2  = '//TRIM(int2str(nqCO2)),  modname)
455   CALL msg('nqINCA = '//TRIM(int2str(nqINCA)), modname)
456#endif
457   t => tracers
458   CALL msg('Information stored in infotrac :', modname)
459   IF(dispTable('isssssssssiiiiiiiii', &
460      ['iq    ', 'name  ', 'lName ', 'gen0N ', 'parent', 'type  ', 'phase ', 'compon', 'isAdv ', 'isPhy ', &
461       'iadv  ', 'iGen  ', 'iqPar ', 'nqDes ', 'nqChld', 'iGroup', 'iName ', 'iZone ', 'iPhase'],          &
462      cat(t%name, t%longName, t%gen0Name, t%parent, t%type, t%phase, t%component, bool2str(t%isAdvected),  &
463                                                                                  bool2str(t%isInPhysics)),&
464      cat([(iq, iq=1, nqtot)], t%iadv, t%iGeneration, t%iqParent, t%nqDescen, t%nqChilds, t%iso_iGroup,    &
465                                                    t%iso_iName, t%iso_iZone, t%iso_iPhase), sub=modname)) &
466      CALL abort_gcm(modname, "problem with the tracers table content", 1)
467   IF(niso > 0) THEN
468      CALL msg('Where, for isotopes family "'//TRIM(isotope%parent)//'":', modname)
469      CALL msg('  isoKeys = '//strStack(isoKeys%name), modname)
470      CALL msg('  isoName = '//strStack(isoName),      modname)
471      CALL msg('  isoZone = '//strStack(isoZone),      modname)
472      CALL msg('  isoPhas = '//TRIM(isoPhas),          modname)
473   ELSE
474      CALL msg('No isotopes identified.', modname)
475   END IF
476   CALL msg('end', modname)
477
478END SUBROUTINE infotrac_init
479
480
481!==============================================================================================================================
482!=== THE ROUTINE isoSelect IS USED TO SWITCH FROM AN ISOTOPE FAMILY TO ANOTHER: ISOTOPES DEPENDENT PARAMETERS ARE UPDATED
483!     Single generic "isoSelect" routine, using the predefined index of the parent (fast version) or its name (first call).
484!==============================================================================================================================
485LOGICAL FUNCTION isoSelectByName(iName, lVerbose) RESULT(lerr)
486   IMPLICIT NONE
487   CHARACTER(LEN=*),  INTENT(IN)  :: iName
488   LOGICAL, OPTIONAL, INTENT(IN) :: lVerbose
489   INTEGER :: iIso
490   LOGICAL :: lV
491   lV = .FALSE.; IF(PRESENT(lVerbose)) lV = lVerbose
492   iIso = strIdx(isotopes(:)%parent, iName)
493   lerr = iIso == 0
494   IF(lerr) THEN
495      niso = 0; ntiso = 0; nzone=0; nphas=nqo; isoCheck=.FALSE.
496      CALL msg('no isotope family named "'//TRIM(iName)//'"', ll=lV)
497      RETURN
498   END IF
499   lerr = isoSelectByIndex(iIso, lV)
500END FUNCTION isoSelectByName
501!==============================================================================================================================
502LOGICAL FUNCTION isoSelectByIndex(iIso, lVerbose) RESULT(lerr)
503   IMPLICIT NONE
504   INTEGER,           INTENT(IN) :: iIso
505   LOGICAL, OPTIONAL, INTENT(IN) :: lVerbose
506   LOGICAL :: lv
507   lv = .FALSE.; IF(PRESENT(lVerbose)) lv = lVerbose
508   lerr = .FALSE.
509   IF(iIso == ixIso) RETURN                                          !--- Nothing to do if the index is already OK
510   lerr = iIso<=0 .OR. iIso>nbIso
511   CALL msg('Inconsistent isotopes family index '//TRIM(int2str(iIso))//': should be > 0 and <= '//TRIM(int2str(nbIso))//'"',&
512            ll=lerr .AND. lV)
513   IF(lerr) RETURN
514   ixIso = iIso                                                      !--- Update currently selected family index
515   isotope  => isotopes(ixIso)                                       !--- Select corresponding component
516   isoKeys  => isotope%keys;     niso     = isotope%niso
517   isoName  => isotope%trac;     ntiso    = isotope%ntiso
518   isoZone  => isotope%zone;     nzone    = isotope%nzone
519   isoPhas  => isotope%phase;    nphas    = isotope%nphas
520   itZonIso => isotope%itZonIso; isoCheck = isotope%check
521   iqIsoPha => isotope%iqIsoPha
522END FUNCTION isoSelectByIndex
523!==============================================================================================================================
524
525END MODULE infotrac
Note: See TracBrowser for help on using the repository browser.