source: NEMO/branches/2019/dev_r10984_HPC-13_IRRMANN_BDY_optimization/src/OCE/BDY/bdy_oce.F90 @ 11071

Last change on this file since 11071 was 11071, checked in by girrmann, 2 years ago

dev_r10984_HPC-13 : step 2, remove unneeded communications, see #2285

  • Property svn:keywords set to Id
File size: 11.2 KB
Line 
1MODULE bdy_oce
2   !!======================================================================
3   !!                       ***  MODULE bdy_oce   ***
4   !! Unstructured Open Boundary Cond. :   define related variables
5   !!======================================================================
6   !! History :  1.0  !  2001-05  (J. Chanut, A. Sellar)  Original code
7   !!            3.0  !  2008-04  (NEMO team)  add in the reference version     
8   !!            3.3  !  2010-09  (D. Storkey) add ice boundary conditions
9   !!            3.4  !  2011     (D. Storkey) rewrite in preparation for OBC-BDY merge
10   !!            3.6  !  2014-01  (C. Rousset) add ice boundary conditions for new model
11   !!            4.0  !  2018     (C. Rousset) SI3 compatibility
12   !!----------------------------------------------------------------------
13   USE par_oce         ! ocean parameters
14
15   IMPLICIT NONE
16   PUBLIC
17
18   INTEGER, PUBLIC, PARAMETER ::   jp_bdy  = 10       !: Maximum number of bdy sets
19   INTEGER, PUBLIC, PARAMETER ::   jpbgrd  = 3        !: Number of horizontal grid types used  (T, U, V)
20
21   TYPE, PUBLIC ::   OBC_INDEX    !: Indices and weights which define the open boundary
22      INTEGER ,          DIMENSION(jpbgrd) ::  nblen
23      INTEGER ,          DIMENSION(jpbgrd) ::  nblenrim
24      INTEGER , POINTER, DIMENSION(:,:)    ::  nbi
25      INTEGER , POINTER, DIMENSION(:,:)    ::  nbj
26      INTEGER , POINTER, DIMENSION(:,:)    ::  nbr
27      INTEGER , POINTER, DIMENSION(:,:)    ::  nbmap
28      INTEGER , POINTER, DIMENSION(:,:)    ::  ntreat
29      REAL(wp), POINTER, DIMENSION(:,:)    ::  nbw
30      REAL(wp), POINTER, DIMENSION(:,:)    ::  nbd
31      REAL(wp), POINTER, DIMENSION(:,:)    ::  nbdout
32      REAL(wp), POINTER, DIMENSION(:,:)    ::  flagu
33      REAL(wp), POINTER, DIMENSION(:,:)    ::  flagv
34   END TYPE OBC_INDEX
35
36   !! Logicals in OBC_DATA structure are true if the chosen algorithm requires this
37   !! field as external data. If true the data can come from external files
38   !! or model initial conditions. If false then no "external" data array
39   !! is required for this field.
40
41   TYPE, PUBLIC ::   OBC_DATA     !: Storage for external data
42      INTEGER          , DIMENSION(2)   ::  nread
43      LOGICAL                           ::  ll_ssh
44      LOGICAL                           ::  ll_u2d
45      LOGICAL                           ::  ll_v2d
46      LOGICAL                           ::  ll_u3d
47      LOGICAL                           ::  ll_v3d
48      LOGICAL                           ::  ll_tem
49      LOGICAL                           ::  ll_sal
50      LOGICAL                           ::  ll_fvl
51      REAL(wp), POINTER, DIMENSION(:)   ::  ssh
52      REAL(wp), POINTER, DIMENSION(:)   ::  u2d
53      REAL(wp), POINTER, DIMENSION(:)   ::  v2d
54      REAL(wp), POINTER, DIMENSION(:,:) ::  u3d
55      REAL(wp), POINTER, DIMENSION(:,:) ::  v3d
56      REAL(wp), POINTER, DIMENSION(:,:) ::  tem
57      REAL(wp), POINTER, DIMENSION(:,:) ::  sal
58#if defined key_si3
59      LOGICAL                           ::   ll_a_i
60      LOGICAL                           ::   ll_h_i
61      LOGICAL                           ::   ll_h_s
62      REAL(wp), POINTER, DIMENSION(:,:) ::   a_i    !: now ice leads fraction climatology
63      REAL(wp), POINTER, DIMENSION(:,:) ::   h_i    !: Now ice  thickness climatology
64      REAL(wp), POINTER, DIMENSION(:,:) ::   h_s    !: now snow thickness
65#endif
66#if defined key_top
67      CHARACTER(LEN=20)                   :: cn_obc  !: type of boundary condition to apply
68      REAL(wp)                            :: rn_fac  !: multiplicative scaling factor
69      REAL(wp), POINTER, DIMENSION(:,:)   :: trc     !: now field of the tracer
70      LOGICAL                             :: dmp     !: obc damping term
71#endif
72   END TYPE OBC_DATA
73
74   !!----------------------------------------------------------------------
75   !! Namelist variables
76   !!----------------------------------------------------------------------
77   LOGICAL, PUBLIC            ::   ln_bdy                   !: Unstructured Ocean Boundary Condition
78
79   CHARACTER(len=80), DIMENSION(jp_bdy) ::   cn_coords_file !: Name of bdy coordinates file
80   CHARACTER(len=80)                    ::   cn_mask_file   !: Name of bdy mask file
81   !
82   LOGICAL, DIMENSION(jp_bdy) ::   ln_coords_file           !: =T read bdy coordinates from file;
83   !                                                        !: =F read bdy coordinates from namelist
84   LOGICAL                    ::   ln_mask_file             !: =T read bdymask from file
85   LOGICAL                    ::   ln_vol                   !: =T volume correction             
86   !
87   INTEGER                    ::   nb_bdy                   !: number of open boundary sets
88   INTEGER, DIMENSION(jp_bdy) ::   nb_jpk_bdy               !: number of levels in the bdy data (set < 0 if consistent with planned run)
89   INTEGER, DIMENSION(jp_bdy) ::   nn_rimwidth              !: boundary rim width for Flow Relaxation Scheme
90   INTEGER                    ::   nn_volctl                !: = 0 the total volume will have the variability of the surface Flux E-P
91   !                                                        !  = 1 the volume will be constant during all the integration.
92   CHARACTER(len=20), DIMENSION(jp_bdy) ::   cn_dyn2d       ! Choice of boundary condition for barotropic variables (U,V,SSH)
93   INTEGER, DIMENSION(jp_bdy)           ::   nn_dyn2d_dta   !: = 0 use the initial state as bdy dta ;
94                                                            !: = 1 read it in a NetCDF file
95                                                            !: = 2 read tidal harmonic forcing from a NetCDF file
96                                                            !: = 3 read external data AND tidal harmonic forcing from NetCDF files
97   CHARACTER(len=20), DIMENSION(jp_bdy) ::   cn_dyn3d       ! Choice of boundary condition for baroclinic velocities
98   INTEGER, DIMENSION(jp_bdy)           ::   nn_dyn3d_dta   !: = 0 use the initial state as bdy dta ;
99                                                            !: = 1 read it in a NetCDF file
100   CHARACTER(len=20), DIMENSION(jp_bdy) ::   cn_tra         ! Choice of boundary condition for active tracers (T and S)
101   INTEGER, DIMENSION(jp_bdy)           ::   nn_tra_dta     !: = 0 use the initial state as bdy dta ;
102                                                            !: = 1 read it in a NetCDF file
103   LOGICAL , DIMENSION(jp_bdy) ::   ln_tra_dmp              !: =T Tracer damping
104   LOGICAL , DIMENSION(jp_bdy) ::   ln_dyn3d_dmp            !: =T Baroclinic velocity damping
105   REAL(wp), DIMENSION(jp_bdy) ::   rn_time_dmp             !: Damping time scale in days
106   REAL(wp), DIMENSION(jp_bdy) ::   rn_time_dmp_out         !: Damping time scale in days at radiation outflow points
107
108   CHARACTER(len=20), DIMENSION(jp_bdy) ::   cn_ice         ! Choice of boundary condition for sea ice variables
109   INTEGER , DIMENSION(jp_bdy)          ::   nn_ice_dta     !: = 0 use the initial state as bdy dta ;
110                                                            !: = 1 read it in a NetCDF file
111   REAL(wp), DIMENSION(jp_bdy) ::   rn_ice_tem              !: choice of the temperature of incoming sea ice
112   REAL(wp), DIMENSION(jp_bdy) ::   rn_ice_sal              !: choice of the salinity    of incoming sea ice
113   REAL(wp), DIMENSION(jp_bdy) ::   rn_ice_age              !: choice of the age         of incoming sea ice
114   !
115   
116   !!----------------------------------------------------------------------
117   !! Global variables
118   !!----------------------------------------------------------------------
119   REAL(wp), ALLOCATABLE, SAVE, DIMENSION(:,:), TARGET ::   bdytmask   !: Mask defining computational domain at T-points
120   REAL(wp), ALLOCATABLE, SAVE, DIMENSION(:,:), TARGET ::   bdyumask   !: Mask defining computational domain at U-points
121   REAL(wp), ALLOCATABLE, SAVE, DIMENSION(:,:), TARGET ::   bdyvmask   !: Mask defining computational domain at V-points
122
123   REAL(wp)                                    ::   bdysurftot !: Lateral surface of unstructured open boundary
124
125   !!----------------------------------------------------------------------
126   !! open boundary data variables
127   !!----------------------------------------------------------------------
128
129   INTEGER,  DIMENSION(jp_bdy)                     ::   nn_dta            !: =0 => *all* data is set to initial conditions
130                                                                          !: =1 => some data to be read in from data files
131   REAL(wp), ALLOCATABLE, DIMENSION(:,:,:), TARGET ::   dta_global        !: workspace for reading in global data arrays (unstr.  bdy)
132   REAL(wp), ALLOCATABLE, DIMENSION(:,:,:), TARGET ::   dta_global_z      !: workspace for reading in global depth arrays (unstr.  bdy)
133   REAL(wp), ALLOCATABLE, DIMENSION(:,:,:), TARGET ::   dta_global_dz     !: workspace for reading in global depth arrays (unstr.  bdy)
134   REAL(wp), ALLOCATABLE, DIMENSION(:,:,:), TARGET ::   dta_global2       !: workspace for reading in global data arrays (struct. bdy)
135   REAL(wp), ALLOCATABLE, DIMENSION(:,:,:), TARGET ::   dta_global2_z     !: workspace for reading in global depth arrays (struct. bdy)
136   REAL(wp), ALLOCATABLE, DIMENSION(:,:,:), TARGET ::   dta_global2_dz    !: workspace for reading in global depth arrays (struct. bdy)
137!$AGRIF_DO_NOT_TREAT
138   TYPE(OBC_INDEX), DIMENSION(jp_bdy), TARGET      ::   idx_bdy           !: bdy indices (local process)
139   TYPE(OBC_DATA) , DIMENSION(jp_bdy), TARGET      ::   dta_bdy           !: bdy external data (local process)
140!$AGRIF_END_DO_NOT_TREAT
141   LOGICAL, ALLOCATABLE, DIMENSION(:,:,:) ::   lsend_bdy      !: mark needed communication for given boundary, grid and neighbour
142   LOGICAL, ALLOCATABLE, DIMENSION(:,:,:) ::   lrecv_bdy      !:  when searching in any direction
143   LOGICAL, ALLOCATABLE, DIMENSION(:,:,:) ::   lsend_bdyint   !: mark needed communication for given boundary, grid and neighbour
144   LOGICAL, ALLOCATABLE, DIMENSION(:,:,:) ::   lrecv_bdyint   !:  when searching towards the interior of the computational domain
145   LOGICAL, ALLOCATABLE, DIMENSION(:,:,:) ::   lsend_bdyext   !: mark needed communication for given boundary, grid and neighbour
146   LOGICAL, ALLOCATABLE, DIMENSION(:,:,:) ::   lrecv_bdyext   !:  when searching towards the exterior of the computational domain
147   !!----------------------------------------------------------------------
148   !! NEMO/OCE 4.0 , NEMO Consortium (2018)
149   !! $Id$
150   !! Software governed by the CeCILL license (see ./LICENSE)
151   !!----------------------------------------------------------------------
152CONTAINS
153
154   FUNCTION bdy_oce_alloc()
155      !!----------------------------------------------------------------------
156      USE lib_mpp, ONLY: ctl_stop, mpp_sum
157      !
158      INTEGER :: bdy_oce_alloc
159      !!----------------------------------------------------------------------
160      !
161      ALLOCATE( bdytmask(jpi,jpj) , bdyumask(jpi,jpj), bdyvmask(jpi,jpj),     & 
162         &      STAT=bdy_oce_alloc )
163      !
164      ! Initialize masks
165      bdytmask(:,:) = 1._wp
166      bdyumask(:,:) = 1._wp
167      bdyvmask(:,:) = 1._wp
168      !
169      CALL mpp_sum ( 'bdy_oce', bdy_oce_alloc )
170      IF( bdy_oce_alloc /= 0 )   CALL ctl_stop( 'STOP', 'bdy_oce_alloc: failed to allocate arrays.' )
171      !
172   END FUNCTION bdy_oce_alloc
173
174   !!======================================================================
175END MODULE bdy_oce
176
Note: See TracBrowser for help on using the repository browser.