[2038] | 1 | MODULE trcnam |
---|
| 2 | !!====================================================================== |
---|
| 3 | !! *** MODULE trcnam *** |
---|
| 4 | !! TOP : Read and print options for the passive tracer run (namelist) |
---|
| 5 | !!====================================================================== |
---|
| 6 | !! History : - ! 1996-11 (M.A. Foujols, M. Levy) original code |
---|
| 7 | !! - ! 1998-04 (M.A Foujols, L. Bopp) ahtrb0 for isopycnal mixing |
---|
| 8 | !! - ! 1999-10 (M.A. Foujols, M. Levy) separation of sms |
---|
| 9 | !! - ! 2000-07 (A. Estublier) add TVD and MUSCL : Tests on ndttrc |
---|
| 10 | !! - ! 2000-11 (M.A Foujols, E Kestenare) trcrat, ahtrc0 and aeivtr0 |
---|
| 11 | !! - ! 2001-01 (E Kestenare) suppress ndttrc=1 for CEN2 and TVD schemes |
---|
| 12 | !! 1.0 ! 2005-03 (O. Aumont, A. El Moussaoui) F90 |
---|
| 13 | !!---------------------------------------------------------------------- |
---|
| 14 | #if defined key_top |
---|
| 15 | !!---------------------------------------------------------------------- |
---|
| 16 | !! 'key_top' TOP models |
---|
| 17 | !!---------------------------------------------------------------------- |
---|
| 18 | !! trc_nam : Read and print options for the passive tracer run (namelist) |
---|
| 19 | !!---------------------------------------------------------------------- |
---|
[3294] | 20 | USE oce_trc ! shared variables between ocean and passive tracers |
---|
| 21 | USE trc ! passive tracers common variables |
---|
[4990] | 22 | USE trd_oce |
---|
| 23 | USE trdtrc_oce |
---|
[3294] | 24 | USE iom ! I/O manager |
---|
[2038] | 25 | |
---|
| 26 | IMPLICIT NONE |
---|
| 27 | PRIVATE |
---|
| 28 | |
---|
[4152] | 29 | PUBLIC trc_nam_run ! called in trcini |
---|
[2038] | 30 | PUBLIC trc_nam ! called in trcini |
---|
| 31 | |
---|
[7097] | 32 | TYPE(PTRACER), DIMENSION(jpmaxtrc), PUBLIC :: sn_tracer ! type of tracer for saving if not key_iomput |
---|
| 33 | |
---|
[2038] | 34 | !!---------------------------------------------------------------------- |
---|
[2287] | 35 | !! NEMO/TOP 3.3 , NEMO Consortium (2010) |
---|
[5341] | 36 | !! $Id$ |
---|
[2287] | 37 | !! Software governed by the CeCILL licence (NEMOGCM/NEMO_CeCILL.txt) |
---|
[2038] | 38 | !!---------------------------------------------------------------------- |
---|
| 39 | CONTAINS |
---|
| 40 | |
---|
| 41 | SUBROUTINE trc_nam |
---|
| 42 | !!--------------------------------------------------------------------- |
---|
| 43 | !! *** ROUTINE trc_nam *** |
---|
| 44 | !! |
---|
| 45 | !! ** Purpose : READ and PRINT options for the passive tracer run (namelist) |
---|
| 46 | !! |
---|
| 47 | !! ** Method : - read passive tracer namelist |
---|
| 48 | !! - read namelist of each defined SMS model |
---|
[3680] | 49 | !! ( (PISCES, CFC, MY_TRC ) |
---|
[2038] | 50 | !!--------------------------------------------------------------------- |
---|
[4154] | 51 | INTEGER :: jn ! dummy loop indice |
---|
[7068] | 52 | ! |
---|
| 53 | IF( .NOT.lk_offline ) CALL trc_nam_run ! Parameters of the run |
---|
[5836] | 54 | ! |
---|
[7041] | 55 | CALL trc_nam_trc ! passive tracer informations |
---|
[5836] | 56 | ! |
---|
| 57 | IF( ln_rsttr ) ln_trcdta = .FALSE. ! restart : no need of clim data |
---|
[4152] | 58 | ! |
---|
[5836] | 59 | IF( ln_trcdmp .OR. ln_trcdmp_clo ) ln_trcdta = .TRUE. ! damping : need to have clim data |
---|
| 60 | ! |
---|
[2038] | 61 | |
---|
[5836] | 62 | IF(lwp) THEN ! control print |
---|
[3294] | 63 | IF( ln_rsttr ) THEN |
---|
| 64 | WRITE(numout,*) |
---|
[4148] | 65 | WRITE(numout,*) ' Read a restart file for passive tracer : ', TRIM( cn_trcrst_in ) |
---|
[3294] | 66 | WRITE(numout,*) |
---|
| 67 | ENDIF |
---|
[4148] | 68 | IF( ln_trcdta .AND. .NOT.ln_rsttr ) THEN |
---|
| 69 | WRITE(numout,*) |
---|
| 70 | WRITE(numout,*) ' Some of the passive tracers are initialised from climatologies ' |
---|
| 71 | WRITE(numout,*) |
---|
| 72 | ENDIF |
---|
| 73 | IF( .NOT.ln_trcdta ) THEN |
---|
| 74 | WRITE(numout,*) |
---|
| 75 | WRITE(numout,*) ' All the passive tracers are initialised with constant values ' |
---|
| 76 | WRITE(numout,*) |
---|
| 77 | ENDIF |
---|
[3294] | 78 | ENDIF |
---|
[7097] | 79 | ! |
---|
| 80 | rdttrc = rdt * FLOAT( nn_dttrc ) ! passive tracer time-step |
---|
| 81 | ! |
---|
| 82 | IF(lwp) THEN ! control print |
---|
[4152] | 83 | WRITE(numout,*) |
---|
[6140] | 84 | WRITE(numout,*) ' Passive Tracer time step rdttrc = ', rdttrc |
---|
[4152] | 85 | WRITE(numout,*) |
---|
| 86 | ENDIF |
---|
[7097] | 87 | ! |
---|
[7041] | 88 | IF( l_trdtrc ) CALL trc_nam_trd ! Passive tracer trends |
---|
[2038] | 89 | ! |
---|
| 90 | END SUBROUTINE trc_nam |
---|
| 91 | |
---|
[5836] | 92 | |
---|
[4152] | 93 | SUBROUTINE trc_nam_run |
---|
| 94 | !!--------------------------------------------------------------------- |
---|
| 95 | !! *** ROUTINE trc_nam *** |
---|
| 96 | !! |
---|
| 97 | !! ** Purpose : read options for the passive tracer run (namelist) |
---|
| 98 | !! |
---|
| 99 | !!--------------------------------------------------------------------- |
---|
[7068] | 100 | NAMELIST/namtrc_run/ nn_dttrc, ln_rsttr, nn_rsttr, ln_top_euler, & |
---|
[5341] | 101 | & cn_trcrst_indir, cn_trcrst_outdir, cn_trcrst_in, cn_trcrst_out |
---|
[5836] | 102 | ! |
---|
[4154] | 103 | INTEGER :: ios ! Local integer output status for namelist read |
---|
[4152] | 104 | !!--------------------------------------------------------------------- |
---|
[5836] | 105 | ! |
---|
[6140] | 106 | IF(lwp) WRITE(numout,*) 'trc_nam_run : read the passive tracer namelists' |
---|
[4152] | 107 | IF(lwp) WRITE(numout,*) '~~~~~~~' |
---|
| 108 | |
---|
[4290] | 109 | CALL ctl_opn( numnat_ref, 'namelist_top_ref' , 'OLD' , 'FORMATTED', 'SEQUENTIAL', -1, numout, .FALSE. ) |
---|
| 110 | CALL ctl_opn( numnat_cfg, 'namelist_top_cfg' , 'OLD' , 'FORMATTED', 'SEQUENTIAL', -1, numout, .FALSE. ) |
---|
[4624] | 111 | IF(lwm) CALL ctl_opn( numont, 'output.namelist.top', 'UNKNOWN', 'FORMATTED', 'SEQUENTIAL', -1, numout, .FALSE., 1 ) |
---|
[4152] | 112 | |
---|
| 113 | REWIND( numnat_ref ) ! Namelist namtrc in reference namelist : Passive tracer variables |
---|
| 114 | READ ( numnat_ref, namtrc_run, IOSTAT = ios, ERR = 901) |
---|
| 115 | 901 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtrc in reference namelist', lwp ) |
---|
| 116 | |
---|
| 117 | REWIND( numnat_cfg ) ! Namelist namtrc in configuration namelist : Passive tracer variables |
---|
| 118 | READ ( numnat_cfg, namtrc_run, IOSTAT = ios, ERR = 902 ) |
---|
| 119 | 902 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtrc in configuration namelist', lwp ) |
---|
[4624] | 120 | IF(lwm) WRITE ( numont, namtrc_run ) |
---|
[4152] | 121 | |
---|
| 122 | ! computes the first time step of tracer model |
---|
| 123 | nittrc000 = nit000 + nn_dttrc - 1 |
---|
| 124 | |
---|
| 125 | IF(lwp) THEN ! control print |
---|
| 126 | WRITE(numout,*) |
---|
[4159] | 127 | WRITE(numout,*) ' Namelist : namtrc_run' |
---|
[4152] | 128 | WRITE(numout,*) ' time step freq. for passive tracer nn_dttrc = ', nn_dttrc |
---|
| 129 | WRITE(numout,*) ' restart for passive tracer ln_rsttr = ', ln_rsttr |
---|
| 130 | WRITE(numout,*) ' control of time step for passive tracer nn_rsttr = ', nn_rsttr |
---|
| 131 | WRITE(numout,*) ' first time step for pass. trac. nittrc000 = ', nittrc000 |
---|
[4159] | 132 | WRITE(numout,*) ' Use euler integration for TRC (y/n) ln_top_euler = ', ln_top_euler |
---|
[4152] | 133 | WRITE(numout,*) ' ' |
---|
| 134 | ENDIF |
---|
| 135 | ! |
---|
| 136 | END SUBROUTINE trc_nam_run |
---|
| 137 | |
---|
[7041] | 138 | SUBROUTINE trc_nam_trc |
---|
| 139 | !!--------------------------------------------------------------------- |
---|
| 140 | !! *** ROUTINE trc_nam *** |
---|
| 141 | !! |
---|
| 142 | !! ** Purpose : read options for the passive tracer run (namelist) |
---|
| 143 | !! |
---|
| 144 | !!--------------------------------------------------------------------- |
---|
[7097] | 145 | INTEGER :: ios, ierr, icfc ! Local integer output status for namelist read |
---|
[7041] | 146 | !! |
---|
[7068] | 147 | NAMELIST/namtrc/jptra, ln_pisces, ln_my_trc, ln_age, ln_cfc11, ln_cfc12, ln_c14, & |
---|
| 148 | & sn_tracer, ln_trcdta, ln_trcdmp, ln_trcdmp_clo |
---|
[7041] | 149 | !!--------------------------------------------------------------------- |
---|
[7097] | 150 | ! Dummy settings to fill tracers data structure |
---|
| 151 | ! ! name ! title ! unit ! init ! sbc ! cbc ! obc ! |
---|
| 152 | sn_tracer = PTRACER( 'NONAME' , 'NOTITLE' , 'NOUNIT' , .false. , .false. , .false. , .false.) |
---|
| 153 | ! |
---|
[7041] | 154 | IF(lwp) WRITE(numout,*) |
---|
| 155 | IF(lwp) WRITE(numout,*) 'trc_nam_trc : read the passive tracer namelists' |
---|
| 156 | IF(lwp) WRITE(numout,*) '~~~~~~~' |
---|
[5836] | 157 | |
---|
[7041] | 158 | REWIND( numnat_ref ) ! Namelist namtrc in reference namelist : Passive tracer variables |
---|
| 159 | READ ( numnat_ref, namtrc, IOSTAT = ios, ERR = 901) |
---|
| 160 | 901 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtrc in reference namelist', lwp ) |
---|
| 161 | |
---|
| 162 | REWIND( numnat_cfg ) ! Namelist namtrc in configuration namelist : Passive tracer variables |
---|
| 163 | READ ( numnat_cfg, namtrc, IOSTAT = ios, ERR = 902 ) |
---|
| 164 | 902 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtrc in configuration namelist', lwp ) |
---|
| 165 | IF(lwm) WRITE ( numont, namtrc ) |
---|
| 166 | |
---|
[7097] | 167 | ! Control settings |
---|
| 168 | IF( ln_pisces .AND. ln_my_trc ) CALL ctl_stop( 'Choose only ONE BGC model - PISCES or MY_TRC' ) |
---|
| 169 | IF( .NOT. ln_pisces .AND. .NOT. ln_my_trc ) jptra = 0 |
---|
[7041] | 170 | ll_cfc = ln_cfc11 .OR. ln_cfc12 |
---|
| 171 | ! |
---|
[7068] | 172 | jp_pisces = 0 ; jp_pcs0 = 0 ; jp_pcs1 = 0 |
---|
| 173 | jp_my_trc = 0 ; jp_myt0 = 0 ; jp_myt1 = 0 |
---|
| 174 | jp_cfc = 0 ; jp_cfc0 = 0 ; jp_cfc1 = 0 |
---|
| 175 | jp_age = 0 ; jp_c14 = 0 |
---|
[7097] | 176 | ! |
---|
[7068] | 177 | IF( ln_pisces ) THEN |
---|
| 178 | jp_pisces = jptra |
---|
| 179 | jp_pcs0 = 1 |
---|
| 180 | jp_pcs1 = jp_pisces |
---|
| 181 | ENDIF |
---|
| 182 | IF( ln_my_trc ) THEN |
---|
| 183 | jp_my_trc = jptra |
---|
| 184 | jp_myt0 = 1 |
---|
| 185 | jp_myt1 = jp_my_trc |
---|
| 186 | ENDIF |
---|
| 187 | ! |
---|
| 188 | jp_bgc = jptra |
---|
| 189 | ! |
---|
| 190 | IF( ln_age ) THEN |
---|
| 191 | jptra = jptra + 1 |
---|
| 192 | jp_age = jptra |
---|
| 193 | ENDIF |
---|
| 194 | IF( ln_cfc11 ) jp_cfc = jp_cfc + 1 |
---|
| 195 | IF( ln_cfc12 ) jp_cfc = jp_cfc + 1 |
---|
| 196 | IF( ll_cfc ) THEN |
---|
| 197 | jptra = jptra + jp_cfc |
---|
| 198 | jp_cfc0 = jptra - jp_cfc + 1 |
---|
| 199 | jp_cfc1 = jptra |
---|
| 200 | ENDIF |
---|
| 201 | IF( ln_c14 ) THEN |
---|
| 202 | jptra = jptra + 1 |
---|
| 203 | jp_c14 = jptra |
---|
| 204 | ENDIF |
---|
[7097] | 205 | ! |
---|
| 206 | IF( jptra == 0 ) CALL ctl_stop( 'All TOP tracers disabled: change namtrc setting or check if key_top is active' ) |
---|
| 207 | ! |
---|
[7041] | 208 | IF(lwp) THEN ! control print |
---|
| 209 | WRITE(numout,*) |
---|
| 210 | WRITE(numout,*) ' Namelist : namtrc' |
---|
[7068] | 211 | WRITE(numout,*) ' Total number of passive tracers jptra = ', jptra |
---|
| 212 | WRITE(numout,*) ' Simulating PISCES model ln_pisces = ', ln_pisces |
---|
[7097] | 213 | WRITE(numout,*) ' Simulating MY_TRC model ln_my_trc = ', ln_my_trc |
---|
[7041] | 214 | WRITE(numout,*) ' Simulating water mass age ln_age = ', ln_age |
---|
| 215 | WRITE(numout,*) ' Simulating CFC11 passive tracer ln_cfc11 = ', ln_cfc11 |
---|
| 216 | WRITE(numout,*) ' Simulating CFC12 passive tracer ln_cfc12 = ', ln_cfc12 |
---|
| 217 | WRITE(numout,*) ' Simulating C14 passive tracer ln_c14 = ', ln_c14 |
---|
| 218 | WRITE(numout,*) ' Read inputs data from file (y/n) ln_trcdta = ', ln_trcdta |
---|
| 219 | WRITE(numout,*) ' Damping of passive tracer (y/n) ln_trcdmp = ', ln_trcdmp |
---|
| 220 | WRITE(numout,*) ' Restoring of tracer on closed seas ln_trcdmp_clo = ', ln_trcdmp_clo |
---|
[7097] | 221 | WRITE(numout,*) ' Total number of BGC-like tracers jp_bgc = ', jp_bgc |
---|
[7041] | 222 | WRITE(numout,*) ' ' |
---|
[7068] | 223 | WRITE(numout,*) ' ' |
---|
| 224 | ENDIF |
---|
| 225 | ! |
---|
[7103] | 226 | IF( ll_cfc .OR. ln_c14 ) THEN |
---|
[7041] | 227 | ! ! Open namelist files |
---|
| 228 | CALL ctl_opn( numtrc_ref, 'namelist_trc_ref' , 'OLD', 'FORMATTED', 'SEQUENTIAL', -1, numout, .FALSE. ) |
---|
| 229 | CALL ctl_opn( numtrc_cfg, 'namelist_trc_cfg' , 'OLD', 'FORMATTED', 'SEQUENTIAL', -1, numout, .FALSE. ) |
---|
| 230 | IF(lwm) CALL ctl_opn( numonr, 'output.namelist.trc', 'UNKNOWN', 'FORMATTED', 'SEQUENTIAL', -1, numout, .FALSE. ) |
---|
| 231 | ! |
---|
| 232 | ENDIF |
---|
| 233 | |
---|
| 234 | END SUBROUTINE trc_nam_trc |
---|
| 235 | |
---|
| 236 | SUBROUTINE trc_nam_trd |
---|
[4152] | 237 | !!--------------------------------------------------------------------- |
---|
| 238 | !! *** ROUTINE trc_nam_dia *** |
---|
| 239 | !! |
---|
| 240 | !! ** Purpose : read options for the passive tracer diagnostics |
---|
| 241 | !! |
---|
| 242 | !! ** Method : - read passive tracer namelist |
---|
| 243 | !! - read namelist of each defined SMS model |
---|
| 244 | !! ( (PISCES, CFC, MY_TRC ) |
---|
| 245 | !!--------------------------------------------------------------------- |
---|
[7041] | 246 | |
---|
| 247 | #if defined key_trdmxl_trc || defined key_trdtrc |
---|
[5836] | 248 | INTEGER :: ios ! Local integer output status for namelist read |
---|
[4152] | 249 | INTEGER :: ierr |
---|
[5836] | 250 | !! |
---|
[4152] | 251 | NAMELIST/namtrc_trd/ nn_trd_trc, nn_ctls_trc, rn_ucf_trc, & |
---|
[4990] | 252 | & ln_trdmxl_trc_restart, ln_trdmxl_trc_instant, & |
---|
[4152] | 253 | & cn_trdrst_trc_in, cn_trdrst_trc_out, ln_trdtrc |
---|
| 254 | !!--------------------------------------------------------------------- |
---|
| 255 | |
---|
| 256 | IF(lwp) WRITE(numout,*) |
---|
[7041] | 257 | IF(lwp) WRITE(numout,*) 'trc_nam_trd : read the passive tracer diagnostics options' |
---|
[4152] | 258 | IF(lwp) WRITE(numout,*) '~~~~~~~' |
---|
| 259 | |
---|
[7041] | 260 | ! |
---|
| 261 | ALLOCATE( ln_trdtrc(jptra) ) |
---|
| 262 | ! |
---|
| 263 | REWIND( numnat_ref ) ! Namelist namtrc_trd in reference namelist : Passive tracer trends |
---|
| 264 | READ ( numnat_ref, namtrc_trd, IOSTAT = ios, ERR = 905) |
---|
| 265 | 905 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtrc_trd in reference namelist', lwp ) |
---|
[4152] | 266 | |
---|
[7041] | 267 | REWIND( numnat_cfg ) ! Namelist namtrc_trd in configuration namelist : Passive tracer trends |
---|
| 268 | READ ( numnat_cfg, namtrc_trd, IOSTAT = ios, ERR = 906 ) |
---|
| 269 | 906 IF( ios /= 0 ) CALL ctl_nam ( ios , 'namtrc_trd in configuration namelist', lwp ) |
---|
| 270 | IF(lwm) WRITE ( numont, namtrc_trd ) |
---|
[4152] | 271 | |
---|
| 272 | IF(lwp) THEN |
---|
| 273 | WRITE(numout,*) |
---|
[7041] | 274 | WRITE(numout,*) ' trd_mxl_trc_init : read namelist namtrc_trd ' |
---|
| 275 | WRITE(numout,*) ' ~~~~~~~~~~~~~~~~ ' |
---|
| 276 | WRITE(numout,*) ' * frequency of trends diagnostics nn_trd_trc = ', nn_trd_trc |
---|
| 277 | WRITE(numout,*) ' * control surface type nn_ctls_trc = ', nn_ctls_trc |
---|
| 278 | WRITE(numout,*) ' * restart for ML diagnostics ln_trdmxl_trc_restart = ', ln_trdmxl_trc_restart |
---|
| 279 | WRITE(numout,*) ' * flag to diagnose trends of ' |
---|
| 280 | WRITE(numout,*) ' instantantaneous or mean ML T/S ln_trdmxl_trc_instant = ', ln_trdmxl_trc_instant |
---|
| 281 | WRITE(numout,*) ' * unit conversion factor rn_ucf_trc = ', rn_ucf_trc |
---|
| 282 | DO jn = 1, jptra |
---|
| 283 | IF( ln_trdtrc(jn) ) WRITE(numout,*) ' compute ML trends for tracer number :', jn |
---|
| 284 | END DO |
---|
[4152] | 285 | ENDIF |
---|
[7041] | 286 | #endif |
---|
[4152] | 287 | ! |
---|
[7041] | 288 | END SUBROUTINE trc_nam_trd |
---|
[4152] | 289 | |
---|
[2038] | 290 | #else |
---|
| 291 | !!---------------------------------------------------------------------- |
---|
| 292 | !! Dummy module : No passive tracer |
---|
| 293 | !!---------------------------------------------------------------------- |
---|
| 294 | CONTAINS |
---|
| 295 | SUBROUTINE trc_nam ! Empty routine |
---|
| 296 | END SUBROUTINE trc_nam |
---|
[4152] | 297 | SUBROUTINE trc_nam_run ! Empty routine |
---|
| 298 | END SUBROUTINE trc_nam_run |
---|
[2038] | 299 | #endif |
---|
| 300 | |
---|
[2104] | 301 | !!---------------------------------------------------------------------- |
---|
[2287] | 302 | !! NEMO/TOP 3.3 , NEMO Consortium (2010) |
---|
[5341] | 303 | !! $Id$ |
---|
[2287] | 304 | !! Software governed by the CeCILL licence (NEMOGCM/NEMO_CeCILL.txt) |
---|
[2038] | 305 | !!====================================================================== |
---|
[5656] | 306 | END MODULE trcnam |
---|