Changes between Version 14 and Version 15 of Working Groups/TOP/TOP-User Quick Guide


Ignore:
Timestamp:
2018-01-17T12:00:41+01:00 (3 years ago)
Author:
lovato
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Working Groups/TOP/TOP-User Quick Guide

    v14 v15  
    150150Two main types of data structure are used within TOP interface to initialize tracer properties (1) and to provide related initial and boundary conditions (2). 
    151151 
    152  1. TOP tracers initialization : sn_tracer (namtrc) 
    153  
    154 Beside providing name and metadata for tracers, here are also defined the use of initial (sn_tracer%llinit) and boundary (sn_tracer%llsbc,sn_tracer%llcbc, sn_tracer%llobc) conditions. 
     152'''1. TOP tracers initialization''' : sn_tracer (namtrc) 
     153 
     154Beside providing name and metadata for tracers, here are also defined the use of initial (sn_tracer%llinit) and boundary (sn_tracer%llsbc, sn_tracer%llcbc, sn_tracer%llobc) conditions. 
    155155 
    156156In the following, an example of the full structure definition is given for two idealized tracer both with initial conditions given and the first with surface boundary forcing prescribes, while the second has surface and coastal forcing: 
    157157 
    158  
    159 {{{ 
    160 !                          !    name   !           title of the field            !   units    ! initial data ! sbc ! cbc ! obc ! 
    161 sn_tracer(1)  = 'TRC1' , 'Tracer  1 Concentration                 ',   ' - '    ,  .true., .true., .false., .true. 
    162 sn_tracer(2)  = 'TRC2 ' , 'Tracer 2  Concentration                 ',   ' - '    ,  .true., .true., .true., .false. 
    163 }}} 
    164  
    165  
     158{{{ 
     159!             !    name   !           title of the field            !   units    ! initial data ! sbc   !   cbc  !   obc  ! 
     160sn_tracer(1)  = 'TRC1'    , 'Tracer 1 Concentration                ',   ' - '    ,  .true.      , .true., .false., .true. 
     161sn_tracer(2)  = 'TRC2 '   , 'Tracer 2 Concentration                ',   ' - '    ,  .true.      , .true., .true. , .false. 
     162}}} 
    166163As tracers in BGC models are increasingly growing, the same structure can be written also in a more compact and readable way: 
    167164 
    168  
    169 {{{ 
    170 !                          !    name   !           title of the field            !   units    ! initial data ! 
    171 sn_tracer(1)  = 'TRC1' , 'Tracer  1 Concentration                 ',   ' - '    ,   .true. 
    172 sn_tracer(2)  = 'TRC2 ' , 'Tracer 2  Concentration                 ',   ' - '    ,   .true. 
     165{{{ 
     166!             !    name   !           title of the field            !   units    ! initial data ! 
     167sn_tracer(1)  = 'TRC1'    , 'Tracer 1 Concentration                ',   ' - '    ,   .true. 
     168sn_tracer(2)  = 'TRC2 '   , 'Tracer 2 Concentration                ',   ' - '    ,   .true. 
    173169! sbc 
    174170sn_tracer(1)%llsbc = .true. 
     
    177173sn_tracer(2)%llcbc = .true. 
    178174}}} 
    179  
    180  
    181 The data structure is internally initialized by code with dummy names and all initialization/forcing logical fields set to .false. . 
    182  
    183  2. SBC structure to read input fields : sn_trcdta (namtrc_dta), sn_trcsbc sn_trccbc sn_trcobc (namtrc_bc) 
     175The data structure is internally initialized by code with dummy names and all initialization/forcing logical fields set to .false. . 
     176 
     177'''2. SBC structure to read input fields''' : sn_trcdta (namtrc_dta), sn_trcsbc/sn_trccbc/sn_trcobc (namtrc_bc) 
    184178 
    185179This data structure is based on the general one defined for NEMO core in the SBC component (see details in User Manual SBC Chapter on Input Data specification). 
    186180 
    187 The following example show the data structure in the case of a single tracer with initial conditions contained in the file named tracer_1_data.nc (.nc is implicitly assumed), with a doublef intial value, and located in the usr/work/model/inputdata/ folder: 
    188  
    189  
    190 {{{ 
    191 !          !  file name  ! frequency (hours) ! variable  ! time interp. !  clim  ! 'yearly'/ ! weights  ! rotation ! land/sea mask ! 
    192 !          !             !  (if <0  months)  !   name    !   (logical)  !  (T/F) ! 'monthly' ! filename ! pairing  ! filename      ! 
    193   sn_trcdta(1)  = !'' tracer_1_data'        ,        -12        ,  'TRC1'     ,    .false.   , .true. , 'yearly'  , !''        , !''    , !'' 
     181The following example show the data structure in the case of a single tracer with initial conditions contained in the file named tracer_1_data.nc (.nc is implicitly assumed in namelist filename), with a doubled initial value, and located in the usr/work/model/inputdata/ folder: 
     182 
     183{{{ 
     184!               !  file name             ! frequency (hours) ! variable  ! time interp. !  clim  ! 'yearly'/ ! weights  ! rotation ! land/sea mask ! 
     185!               !                        !  (if <0  months)  !   name    !   (logical)  !  (T/F) ! 'monthly' ! filename ! pairing  ! filename      ! 
     186  sn_trcdta(1)  = 'tracer_1_data'        ,        -12        ,  'TRC1'   ,    .false.   , .true. , 'yearly'  , ''       , ''       , '' 
    194187  rf_trfac(1) = 2.0 
    195188  cn_dir = “usr/work/model/inputdata/” 
    196189}}} 
    197  
    198  
    199190The Lateral Open Boundaries conditions are applied to the segments defined for the physical core of NEMO (see BDY description in the User Manual). 
    200191 
    201  
    202  
     192=== namelist_trc === 
     193Here below the description of namelist_trc_ref used to handle Carbon tracers modules, namely CFC and C14.  
     194 
     195|||| &namcfc     !   CFC || 
     196|| ndate_beg || datedeb1 || 
     197|| nyear_res || iannee1 || 
     198|| clname || Name of formatted file with annual hemisperic CFCs concentration in the atmosphere (ppt) || 
     199|||| &namc14_typ     !  C14 - type of C14 tracer, default values of C14/C and pco2 || 
     200|| kc14typ || Type of C14 tracer (0=equilibrium; 1=bomb transient; 2=past transient) || 
     201|| rc14at || Default value for atmospheric C14/C (used for equil run) || 
     202|| pco2at || Default value for atmospheric pcO2 [atm] (used for equil run) || 
     203|| rc14init || Default value for initialization of ocean C14/C (when no restart) || 
     204|||| &namc14_sbc     !  C14 - surface BC || 
     205|| ln_chemh || Use (T) or not (F) Chemical enhancement in piston velocity || 
     206|| xkwind || Coefficient for gas exchange velocity || 
     207|| xdicsur || Reference DIC surface concentration (mol/m3) || 
     208|||| &namc14_fcg     !  files & dates || 
     209|| cfileco2 || Name of formatted file with atmospheric co2 - Bomb || 
     210|| cfilec14 || Name of formatted file with atmospheric c14 - Bomb || 
     211|| tyrc14_beg || starting year of experiment - Bomb ||