Changeset 14303 for NEMO/trunk/doc/latex/NEMO/subfiles/chap_misc.tex
- Timestamp:
- 2021-01-14T18:26:35+01:00 (3 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
NEMO/trunk/doc/latex/NEMO/subfiles/chap_misc.tex
r14257 r14303 14 14 Release & Author(s) & Modifications \\ 15 15 \hline 16 {\em X.X} & {\em Pierre Mathiot} & {update of the closed sea section} 16 17 {\em 4.0} & {\em ...} & {\em ...} \\ 17 18 {\em 3.6} & {\em ...} & {\em ...} \\ … … 107 108 \end{figure} 108 109 109 \begin{figure}[!tbp]110 \centering111 \includegraphics[width=0.66\textwidth]{MISC_closea_mask_example}112 \caption[Mask fields for the \protect\mdl{closea} module]{113 Example of mask fields for the \protect\mdl{closea} module.114 \textit{Left}: a closea\_mask field;115 \textit{Right}: a closea\_mask\_rnf field.116 In this example, if \protect\np{ln_closea}{ln\_closea} is set to \forcode{.true.},117 the mean freshwater flux over each of the American Great Lakes will be set to zero,118 and the total residual for all the lakes, if negative, will be put into119 the St Laurence Seaway in the area shown.}120 \label{fig:MISC_closea_mask_example}121 \end{figure}122 123 110 %% ================================================================================================= 124 111 \section[Closed seas (\textit{closea.F90})]{Closed seas (\protect\mdl{closea})} 125 112 \label{sec:MISC_closea} 113 114 \begin{listing} 115 \nlst{namclo} 116 \caption{\forcode{&namclo}} 117 \label{lst:namclo} 118 \end{listing} 126 119 127 120 Some configurations include inland seas and lakes as ocean … … 136 129 to zero and put the residual flux into the ocean. 137 130 138 Prior to \NEMO\ 4 the locations of inland seas and lakes was set via 139 hardcoded indices for various ORCA configurations. From \NEMO\ 4 onwards 140 the inland seas and lakes are defined using mask fields in the 141 domain configuration file. The options are as follows. 142 143 \begin{enumerate} 144 \item {{\bfseries No ``closea\_mask'' field is included in domain configuration 145 file.} In this case the closea module does nothing.} 146 147 \item {{\bfseries A field called closea\_mask is included in the domain 148 configuration file and ln\_closea=.false. in namelist namcfg.} In this 149 case the inland seas defined by the closea\_mask field are filled in 150 (turned to land points) at run time. That is every point in 151 closea\_mask that is nonzero is set to be a land point.} 152 153 \item {{\bfseries A field called closea\_mask is included in the domain 154 configuration file and ln\_closea=.true. in namelist namcfg.} Each 155 inland sea or group of inland seas is set to a positive integer value 156 in the closea\_mask field (see \autoref{fig:MISC_closea_mask_example} 157 for an example). The net surface flux over each inland sea or group of 131 The inland seas and lakes are defined using mask fields in the 132 domain configuration file. Special treatment of the closed sea (redistribution of net freshwater or mask those), are defined in \autoref{lst:namclo} and 133 can be trigger by \np{ln_closea}{ln\_closea}\forcode{=.true.} in namelist namcfg. 134 135 The options available are the following: 136 \begin{description} 137 \item[\np{ln_maskcs}{ln\_maskcs}\forcode{ = .true.}] All the closed seas are masked using \textit{mask\_opensea} variable. 138 \item[\np{ln_maskcs}{ln\_maskcs}\forcode{ = .false.}] The net surface flux over each inland sea or group of 158 139 inland seas is set to zero each timestep and the residual flux is 159 distributed over the global ocean (ie. all ocean points where 160 closea\_mask is zero).} 161 162 \item {{\bfseries Fields called closea\_mask and closea\_mask\_rnf are 163 included in the domain configuration file and ln\_closea=.true. in 164 namelist namcfg.} This option works as for option 3, except that if 165 the net surface flux over an inland sea is negative (net 166 precipitation) it is put into the ocean at specified runoff points. A 167 net positive surface flux (net evaporation) is still spread over the 168 global ocean. The mapping from inland seas to runoff points is defined 169 by the closea\_mask\_rnf field. Each mapping is defined by a positive 170 integer value for the inland sea(s) and the corresponding runoff 171 points. An example is given in 172 \autoref{fig:MISC_closea_mask_example}. If no mapping is provided for a 173 particular inland sea then the residual is spread over the global 174 ocean.} 175 176 \item {{\bfseries Fields called closea\_mask and closea\_mask\_emp are 177 included in the domain configuration file and ln\_closea=.true. in 178 namelist namcfg.} This option works the same as option 4 except that 179 the nonzero net surface flux is sent to the ocean at the specified 180 runoff points regardless of whether it is positive or negative. The 181 mapping from inland seas to runoff points in this case is defined by 182 the closea\_mask\_emp field.} 183 \end{enumerate} 184 185 There is a python routine to create the closea\_mask fields and append 186 them to the domain configuration file in the utils/tools/DOMAINcfg directory. 140 distributed over a target area. 141 \end{description} 142 143 When \np{ln_maskcs}{ln\_maskcs}\forcode{ = .false.}, 144 3 options are available for the redistribution (set up of these options is done in the tool DOMAINcfg): 145 \begin{description}[font=$\bullet$ ] 146 \item[ glo]: The residual flux is redistributed globally. 147 \item[ emp]: The residual flux is redistributed as emp in a river outflow. 148 \item[ rnf]: The residual flux is redistributed as rnf in a river outflow if negative. If there is a net evaporation, the residual flux is redistributed globally. 149 \end{description} 150 151 For each case, 2 masks are needed (\autoref{fig:MISC_closea_mask_example}): 152 \begin{description} 153 \item $\bullet$ one describing the 'sources' (ie the closed seas concerned by each options) called \textit{mask\_csglo}, \textit{mask\_csrnf}, \textit{mask\_csemp}. 154 \item $\bullet$ one describing each group of inland seas (the Great Lakes for example) and the target area (river outflow or world ocean) for each group of inland seas (St Laurence for the Great Lakes for example) called 155 \textit{mask\_csgrpglo}, \textit{mask\_csgrprnf}, \textit{mask\_csgrpemp}. 156 \end{description} 157 158 \begin{figure}[!tbp] 159 \centering 160 \includegraphics[width=0.66\textwidth]{MISC_closea_mask_example} 161 \caption[Mask fields for the \protect\mdl{closea} module]{ 162 Example of mask fields for the \protect\mdl{closea} module. 163 \textit{Left}: a \textit{mask\_csrnf} field; 164 \textit{Right}: a \textit{mask\_csgrprnf} field. 165 In this example, if \protect\np{ln_closea}{ln\_closea} is set to \forcode{.true.}, 166 the mean freshwater flux over each of the American Great Lakes will be set to zero, 167 and the total residual for all the lakes, if negative, will be put into 168 the St Laurence Seaway in the area shown.} 169 \label{fig:MISC_closea_mask_example} 170 \end{figure} 171 172 Closed sea not defined (because too small, issue in the bathymetry definition ...) are defined in \textit{mask\_csundef}. 173 These points can be masked using the namelist option \np{ln_mask_csundef}{ln\_mask\_csundef}\forcode{= .true.} or used to correct the bathymetry input file.\\ 174 175 The masks needed for the closed sea can be created using the DOMAINcfg tool in the utils/tools/DOMAINcfg directory. 176 See \autoref{sec:clocfg} for details on the usage of definition of the closed sea masks. 187 177 188 178 %% =================================================================================================
Note: See TracChangeset
for help on using the changeset viewer.